Skip to content

docs(j5): fleet visibility acceptance contract (FV1–FV10, DV6) - #107

Closed
Jacksondr5 wants to merge 4 commits into
j5/mainfrom
docs/fleet-visibility-contract
Closed

Jacksondr5 wants to merge 4 commits into
j5/mainfrom
docs/fleet-visibility-contract

Conversation

@Jacksondr5

Copy link
Copy Markdown
Owner

Posted by an AI agent on Jackson's behalf

Records the product rulings Jackson made with the Product lead on 2026-09-04 for the next outcome, at-a-glance fleet visibility (issue #28's anchor). Product only; no build decomposition, no design.

What it records:

  • The Fleet page contract in docs/j5/product/features/sidebar-and-roster.md (§The roster): one Squadron at a time, four measured facts per agent (status, owes/awaiting asks, last activity, measured failures), silence notices deliberately not shown, the badge never counting what the inbox bell counts, unknowns explicit with freshness stated, stable ordering, the orphan-display answer, and one absorbing server read as the only data dependency (the old A5/A10 tickets are not prerequisites).
  • Override DV6 in docs/j5/product/dogfood-v0.md: the sidebar is unchanged in v0; the provenance membership rule (SB5) is set aside as an accepted UI gap until Crews or a settled human-contact-spectrum story.
  • Session record docs/j5/worklog/fleet-visibility-session-2026-09-04.md with rulings FV1–FV10, corrected stale statements, ten acceptance scenarios, and what remains for the coordinator and Architecture.

Docs only; vp fmt run on the three files.

Model: Claude Fable 5.1, harness: Claude Code via J5 Code (Product seat).

…rios

Jackson's rulings 2026-09-04 with Product: the Fleet page is one
Squadron at a time, four measured facts per agent, no silence notices,
badge excludes what the inbox counts, sidebar unchanged in v0 (SB5 set
aside as DV6), one absorbing read instead of A5/A10 as prerequisites.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Sep 5, 2026 •

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Essentials

Run ID: 83130e4c-2edb-4592-91a4-6e9cb2b7045c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Comment @coderabbitai help to get the list of available commands.

@github-actions github-actions Bot added vouch:trusted PR author is trusted by repo permissions or the VOUCHED list. size:L 100-499 effective changed lines (test files excluded in mixed PRs). labels Sep 5, 2026
Jacksondr5 and others added 3 commits September 4, 2026 20:36
…t-mode Squadron list, agents-only, status vocabulary, delivery alarms)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…he stale ledger-recency open item

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@Jacksondr5

Copy link
Copy Markdown
Owner Author

Posted by an AI agent on Jackson's behalf. Superseded by #110, which folds this contract into the Fleet page and sidebar definition (docs/j5/product/features/fleet-page.md, AC1–AC26) and moves the session record to docs/j5/worklog/2026-09-04-fleet-visibility-session.md. The DV6 override lives in the dogfood v0 plan's narrowing table there.

@Jacksondr5 Jacksondr5 closed this Sep 11, 2026
Jacksondr5 added a commit that referenced this pull request Sep 14, 2026
Rewrites sidebar-and-roster as the Fleet page and sidebar definition
(AC1–AC26, scenarios, History mapping SB1–SB7, FV1–FV11 and DV6),
moves the 2026-09-04 fleet-visibility session record to its date-first
name with a pointer to the definition, re-keys the dogfood plan's
narrowing table by criterion, and gives the glossary's Fleet page,
Squadron scope, orphan and delivery alarm terms their owners. Supersedes
PR #107.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Jacksondr5 added a commit that referenced this pull request Sep 14, 2026
* docs(j5): how the J5 docs are organized — five kinds, lifetimes, two identifier kinds

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs(j5): glossary rewritten as index + owned distinctions; casing rule made unambiguous

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs(j5): cite principles by name — headings un-numbered, every numeric citation rewritten

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs(j5): Squadron rewritten as a definition; naming session moved to a record; glossary review fixes; shared example fleet

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs(j5): A2A definition, substrate and agent-tools as definitions; communication-graph draft to a record; A2A plan to plans/

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs(j5): steering after the upstream integration — two independent policies, truthful-steer guard, stop wins over restart continuation; Astra delivery guidance removed

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs(j5): inbox, thread rendering and archive flow as definitions; Replied everywhere; a person receives asks only and never opens one

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs(j5): A2A definition — a person receives asks only and never opens one (repairs edits missed against the staged text)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs(j5): Roles, Crews, Memos, Playbooks, Spawning Guide, Shared Squadrons as definitions — the design-review register dissolved into them

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs(j5): dogfood plan consolidated under plans/; decision log, design review and backlog become records; principles' cases point at definitions by name; GitHub milestones carry the backlog

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs(j5): problems, use cases, fleet vision, cross-device and the PR pane as definitions; the posted PR-pane brief kept as a record

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs(j5): mechanical sweep — records renamed date-first with frontmatter, research stamped as_of, runbooks under runbooks/, process classified, README rewritten

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs(j5): fold the Fleet page contract into a definition

Rewrites sidebar-and-roster as the Fleet page and sidebar definition
(AC1–AC26, scenarios, History mapping SB1–SB7, FV1–FV11 and DV6),
moves the 2026-09-04 fleet-visibility session record to its date-first
name with a pointer to the definition, re-keys the dogfood plan's
narrowing table by criterion, and gives the glossary's Fleet page,
Squadron scope, orphan and delivery alarm terms their owners. Supersedes
PR #107.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* docs(j5): rebase onto main and absorb the landed lifecycle, join, and cross-environment changes

Rebased onto j5/main. Folds main's five doc changes into the rewritten
definitions in their own shape: list_squadrons and join_squadron in the
agent tools and substrate definitions and as Squadron AC14; reversible
archive, unarchive and separate deletion in the archive-flow and tools
definitions; the cross-environment merge (#125) as cross-device
AC7–AC10 and inbox criteria, with build status in the dogfood plan.
Records #126 and #127 as landed in the A2A plan. Moves the Squadron
Scope section into the Definition and the plan per the conventions.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* fix(server): pin the send_message description to the definition's new shape

The EnvelopeFormatter test reads the send_message description out of
docs/j5/product/a2a/agent-tools.md and compares it byte-for-byte with
the runtime string; the docs rewrite changed the heading and label the
parser looked for. Update the parser to the definition shape, drop the
stale "or a reply" toward a person from the runtime string (a person
never opens an ask, so there is nothing to reply to; the channel itself
went in #127), and hold the definition's description to the shipped
string. The regarding sentence returns with #111.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:L 100-499 effective changed lines (test files excluded in mixed PRs). vouch:trusted PR author is trusted by repo permissions or the VOUCHED list.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant