Skip to content

docs: document canonical command fields (refs #3022) - #3055

Merged
mblua merged 2 commits into
mainfrom
docs/3022-docs-policy
Oct 16, 2026
Merged

mblua merged 2 commits into
mainfrom
docs/3022-docs-policy

Conversation

@mblua

@mblua mblua commented Oct 16, 2026 •

Copy link
Copy Markdown
Owner

Documents the delivered baseCommand and profile-cell additionalArguments fields, strict legacy fallback, authoritative legacy-value retention and unchanged launch composition. The authored diff is limited to docs/reference/settings.md and docs/features/coding-agent-profiles.md; CLI --command and the combined launch Command wording stay intact.

The exact approved P04 replacement section was also appended to the separate shared guideline, preserving every previous byte. Shared policy SHA256: 91ea75420ad29c0b0407383bf3d0f5d2b032e8fedc6eb4a97ee3e83be1dce29c.

Validation: JSON examples parsed, source claims and historical fixture applicability verified, independent cold RustGrinch and ArchitectGrinch reviews PASS. Integrated main d0f91a3d5a33edadfd3b2c0e337654f4cd5acc6f locally into head 5103724de545591f90fd64e12bbdc80cbeb962fd (tree a41d9c6a829f92aed49cd7248cdaef05dd29668d); focused RustGrinch integration review PASS. Both authored documents, the shared policy and nine relevant source/test blobs are unchanged; the remaining tree matches the incoming target exactly. No local product tests/builds were rerun for this documentation-only change. All triggered and configured-required CI checks remain mandatory on the exact integrated head.

Original BASE 6f1ca43c06cb39a7caed941f1e640dc0bcde43de and the full provenance inventory are preserved: 17 inherited release paths plus two authored docs. Authored target-to-head diff check passes. Original-BASE-to-head diff check reports four preexisting Markdown two-space hard breaks in docs/releases/v0.45.0/release-plan.md:5–8; the user explicitly accepted that inherited local result and preserving those bytes. The nonzero result is recorded, with no CI waiver or unrelated release edit.

Evidence: D:/0_repos/AgentsCommander_iac/.ac/project-shared/parallel-room18-i3022/ — WRITER-candidate.md, WRITER-main-integration.md, document/source bindings, RUSTGRINCH-doc-verification.md, ARCHGRINCH-policy-verification.md, RUSTGRINCH-integration-verification.md, user-whitespace-disposition.md and the separate policy before/after/hash/diff receipt. Approved root v8 / P04 v2 and five-party consensus are unchanged; room19 owns epic integration/closure.

Closes #3022

@mblua mblua added the ci:full Run the full PR regression gates on this PR label Oct 16, 2026
@sonarqubecloud

Copy link
Copy Markdown

@mblua

mblua commented Oct 16, 2026

Copy link
Copy Markdown
Owner Author

Target drift triage after the native three-commits-behind notice (2026-10-16 18:53:20-03:00):

  • Validated head remains 5103724de545591f90fd64e12bbdc80cbeb962fd on the clean principal checkout, branch docs/3022-docs-policy.
  • Target advanced from d0f91a3d5a33edadfd3b2c0e337654f4cd5acc6f to 739162c65f31710d8b3d67803ebe8934e6e89189 through PR docs: refresh ecosystem README and quickstart (refs #3044) #3049; incoming commits are 3c087cdc6fbd4fcb1386aebf156a2f39faa5af41, 24028e9fcb142f1db5625f4609e395339c682fa6 and merge 739162c65f31710d8b3d67803ebe8934e6e89189.
  • The complete incoming path set is README.md and docs/quickstart.md. Both are documentation, with no overlap with the two authored P04 documents or shared policy, and no application, build input, dependency, lockfile, workflow or verification configuration change. Full incoming diff is captured separately as docs-only-target-drift.diff.

Disposition under git-landing-flow / Step 9.5: unrelated documentation delta; retain the current head and its CI. No branch integration, new commit, CI cancellation, repeated review or rerun is required by this delta. Required and triggered CI success remains bound to the exact current head; final target triage and protected PR merge checks remain mandatory before landing. The earlier release-input drift was integrated already and its narrow user-authorized inherited-whitespace disposition remains recorded separately.

@mblua

mblua commented Oct 16, 2026

Copy link
Copy Markdown
Owner Author

Final target drift disposition for head 5103724de545591f90fd64e12bbdc80cbeb962fd and current main c6cc9d0cdabe36b6a7f2faf366358fb7d102d9a7:

Room19 independently inspected the real delta and confirmed UNRELATED_TO_P04_DOCUMENTED_CONTRACTS_AND_EXAMPLES. PR #3049 changes README/quickstart documentation. PR #3053 replaces direct Arc<RwLock<AppSettings>> constructions with a factory containing that identical construction; settings.rs changes only the factory and two unrelated test constructions. The documented schema, selectors, legacy retention, launch behavior, authored files and examples are unchanged. No build input, lockfile, dependency or workflow changed in this target delta.

Complete incoming path list:

README.md
docs/quickstart.md
src-tauri/src/agent_update.rs
src-tauri/src/commands/ac_discovery.rs
src-tauri/src/commands/co_managed.rs
src-tauri/src/commands/config.rs
src-tauri/src/commands/entity_creation.rs
src-tauri/src/commands/pty.rs
src-tauri/src/commands/session.rs
src-tauri/src/commands/window.rs
src-tauri/src/config/sessions_persistence.rs
src-tauri/src/config/settings.rs
src-tauri/src/lib.rs
src-tauri/src/loops/delivery.rs
src-tauri/src/phone/mailbox.rs
src-tauri/src/pty/inject.rs
src-tauri/src/pty/remote_watcher.rs
src-tauri/src/pty/terminal_snapshot/acceptance_tests.rs
src-tauri/src/resource_monitor/watchdog.rs
src-tauri/src/session/auto_close.rs
src-tauri/src/update_check.rs
src-tauri/src/web/commands.rs
src-tauri/tests/pty_lifecycle_regression.rs
src-tauri/tests/pty_powershell_managed_native.rs
src-tauri/tests/wake_consumption_measure.rs

Apply the documented unrelated-delta landing path: reuse the verified successful CI on this unchanged head, without a branch update or another CI run. All 26 current check/status results are successful, including all 14 configured-required contexts; required check integration IDs and exact-head bindings are checked immediately before merge. Existing source-bound independent reviews and the user's narrow inherited-whitespace disposition remain valid.

Detailed receipts: D:/0_repos/AgentsCommander_iac/.ac/project-shared/parallel-room18-i3022/room19-p04-target-scope-disposition.json, room19-main-constructor-triage-observation.json, landing-constructors-drift.diff, exact-head-green-receipt.json and premerge snapshots. This disposition is limited to P04 and this exact target delta.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci:full Run the full PR regression gates on this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document canonical fields and retain-legacy replacement policy

1 participant