docs(m131): fleet console, memory, and run cost

[indykish]

Summary

• document the fleet detail console, source editing, memory forget, and run cost
• record the latest-200 event rollup bound and lifetime spend
• document optional If-Match protection for fleet and catalog edits
• add the Jul 16 changelog entry

Verification

• make test
• npx mintlify validate
• npx mintlify@4.2.698 broken-links
• changed-page markdown link checks
• gitleaks detect

Session notes

This Pull Request is stacked on #140 because the Fleet library page needs M130's catalog editing and draft/publish corrections before M131's stale-write guidance applies.

The aggregate make lint reaches the OpenAPI drift check and reports 13 operations already absent from docs.json on upstream main. The four-file M131 diff introduces none of those operations.

Greptile Summary

This PR documents M131's fleet detail console, adding source editing, memory forget, run cost, and stale-write protection (If-Match / 412) across four pages. The Jul 16 changelog entry, fleet overview, library, and memory pages are all mutually consistent.

• Fleet overview & library — adds UI-level stale-write behavior notes and the 200-event / 7-day cost rollup bound; both match the changelog's API reference exactly.
• Memory — adds dashboard forget UI and the DELETE API route with both the 204 success and UZ-MEM-004 absent-key responses, closing the gap noted in the prior review round.
• Changelog — new Jul 16, 2026 <Update> entry covers all four features with correct HTTP header casing (ETag) and consistent error codes throughout.

Confidence Score: 5/5

Documentation-only change; all four pages are internally consistent and no functional code is modified.

The changes are pure documentation. Error codes, API paths, and behavioral descriptions match across changelog, overview, library, and memory pages. Issues flagged in the prior review round (stale-write guidance in overview, UZ-MEM-004 in memory) are addressed. No cross-file contradictions or missing information found.

No files require special attention.

Important Files Changed

Filename	Overview
changelog.mdx	Adds Jul 16 Update entry documenting fleet console, memory forget, run cost, and stale-write protection; internally consistent and matches behavior described in the other changed pages
fleets/overview.mdx	Adds fleet detail console description, stale-write behavior note, and cost rollup bound; verified date bumped to 2026-07-16
fleets/library.mdx	Adds optimistic-concurrency protection note for catalog edits; verified date bumped to 2026-07-16
memory.mdx	Adds dashboard memory-forget UI description and DELETE API route with 204/UZ-MEM-004 response codes; verified date bumped to 2026-07-16

Sequence Diagram

%%{init: {'theme': 'neutral'}}%%
sequenceDiagram
    participant Op as Operator (Dashboard)
    participant API as agentsfleet API
    participant Fleet as Fleet

    Note over Op,Fleet: Source edit with stale-write protection
    Op->>API: "GET /fleets/{fleet_id}"
    API-->>Op: 200 + ETag: "v1"

    Op->>API: "PATCH /fleets/{fleet_id} (If-Match: "v1", new SKILL.md)"
    alt ETag matches
        API-->>Op: 200 (edit accepted)
        API->>Fleet: Next wake uses new source
    else ETag stale (another op saved first)
        API-->>Op: 412 UZ-AGT-014 + current ETag
        Op->>Op: Editor reloads current source
    end

    Note over Op,API: Memory forget
    Op->>API: "DELETE /fleets/{fleet_id}/memories/{key}"
    alt Key exists
        API-->>Op: 204
    else Key absent
        API-->>Op: UZ-MEM-004
    end

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
sequenceDiagram
    participant Op as Operator (Dashboard)
    participant API as agentsfleet API
    participant Fleet as Fleet

    Note over Op,Fleet: Source edit with stale-write protection
    Op->>API: "GET /fleets/{fleet_id}"
    API-->>Op: 200 + ETag: "v1"

    Op->>API: "PATCH /fleets/{fleet_id} (If-Match: "v1", new SKILL.md)"
    alt ETag matches
        API-->>Op: 200 (edit accepted)
        API->>Fleet: Next wake uses new source
    else ETag stale (another op saved first)
        API-->>Op: 412 UZ-AGT-014 + current ETag
        Op->>Op: Editor reloads current source
    end

    Note over Op,API: Memory forget
    Op->>API: "DELETE /fleets/{fleet_id}/memories/{key}"
    alt Key exists
        API-->>Op: 204
    else Key absent
        API-->>Op: UZ-MEM-004
    end

Loading

_{Reviews (2): Last reviewed commit: "docs(m131): clarify fleet concurrency an..." | Re-trigger Greptile}