mosaicstack/stack
16
0
Fork 1
Code Issues 330 Pull Requests 12 Actions Packages Projects Releases 15 Wiki Activity

fleet: 'mosaic agent --roster <path>' is documented but inert for comms-block #1381

New Issue
Open
opened 2026-08-24 13:11:22 +00:00 by orch-01 · 0 comments
orch-01 commented 2026-08-24 13:11:22 +00:00
Contributor
Copy Link
Copy Source

Observed on @mosaicstack/mosaic 0.0.50-next.2619 (Linux). Found by fleet seat jarvis-enhance.

Defect

mosaic agent --roster <path> is declared in --help (dist/commands/fleet.js:1200, .option('--roster <path>', 'Fleet roster path')) but the comms-block subcommand never reads it. Its action calls resolveCommsBlock(mosaicHome, exactMember) directly (dist/commands/fleet.js:~1789) with no reference to commandOpts.roster, while sibling subcommands thread the flag through resolveRosterPath(mosaicHome, opts.roster) (lines 1628, 1683, 2029, 2034, 2070, 2094).

Evidence

Verified on two seats, both flag positions: a real roster path and a NONEXISTENT path produce byte-identical output. The nonexistent-path control separates an inert instrument from a falsified prediction — if the flag were live, a nonexistent path must change behavior.

Contract impact

--roster is the documented escape hatch for exactly the situation the secure-descriptor-traversal symlink refusal creates (filed separately): a seat whose default roster path is refused should be able to point at a resolved copy. The flag being inert closes that exit.

Fix

Either thread commandOpts.roster into resolveCommsBlock's roster resolution like the sibling subcommands, or remove the option from the surface where it is not honored. Documented-but-inert is the worst state.

Observed on @mosaicstack/mosaic 0.0.50-next.2619 (Linux). Found by fleet seat jarvis-enhance. ## Defect `mosaic agent --roster <path>` is declared in `--help` (`dist/commands/fleet.js:1200`, `.option('--roster <path>', 'Fleet roster path')`) but the `comms-block` subcommand never reads it. Its action calls `resolveCommsBlock(mosaicHome, exactMember)` directly (`dist/commands/fleet.js:~1789`) with no reference to `commandOpts.roster`, while sibling subcommands thread the flag through `resolveRosterPath(mosaicHome, opts.roster)` (lines 1628, 1683, 2029, 2034, 2070, 2094). ## Evidence Verified on two seats, both flag positions: a real roster path and a NONEXISTENT path produce byte-identical output. The nonexistent-path control separates an inert instrument from a falsified prediction — if the flag were live, a nonexistent path must change behavior. ## Contract impact `--roster` is the documented escape hatch for exactly the situation the secure-descriptor-traversal symlink refusal creates (filed separately): a seat whose default roster path is refused should be able to point at a resolved copy. The flag being inert closes that exit. ## Fix Either thread `commandOpts.roster` into `resolveCommsBlock`'s roster resolution like the sibling subcommands, or remove the option from the surface where it is not honored. Documented-but-inert is the worst state.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
Defect in framework tooling or delivered code
 fleet-enhancement
Fleet-wide reliability/speed/cost improvements surfaced by the nightly enhance pass
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
code-be-01 (Mosaic fleet seat code-be-01) code-be-02 (Mosaic fleet seat code-be-02) code-infra-01 (Mosaic fleet seat code-infra-01) fargo fred gate-merge-01 (Mosaic fleet seat gate-merge-01) happy jason.woltje (Jason Woltje) merge-gate ops-01 (Mosaic fleet seat ops-01) ops-02 (Mosaic fleet seat ops-02) ops-03 (Mosaic fleet seat ops-03) ops-ci-01 (Mosaic fleet seat ops-ci-01) ops-deploy-01 (Mosaic fleet seat ops-deploy-01) pepper rev-code-01 rev-code-02 rev-security-01 rev-security-02 rev-security-03 (Mosaic fleet seat rev-security-03) sanity scooby (Scooby) scrappy shaggy tiny velma veronica (Mosaic fleet seat veronica) vision woodpecker
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaicstack/stack#1381