AGENTS.md Protocol Domains table still lists `Cloud | cloud/` after #16325 relocates the directory to `marketplace/`

[hotlong]

AGENTS.md → Protocol Domains table still carries the row

| `Cloud` | `cloud/` | Multi-tenant, deployment, environment |

#16325 (option B "cut by owner", director batch #62, maintainer 「同意」) removes packages/spec/src/cloud/ and the @objectstack/spec/cloud subpath: the cloud control plane's contracts leave the open-source spec, and the package & marketplace format moves to packages/spec/src/marketplace/, published as @objectstack/spec/marketplace. The moment that PR merges, the row names a directory that does not exist and omits the one that replaced it.

Why it is not fixed in the #16325 PR. AGENTS.md is a governed surface (Prime Directive #14): a mixed diff is governed whole on a single path hit, so the row would have converted a packages/spec contract PR into a human-merge-only one. Measured on d14c05ffc: no gate reads that table (git grep -ln "Multi-tenant, deployment, environment" hits only AGENTS.md itself; git grep -ln "Protocol Domains" -- scripts .github packages/spec/scripts hits nothing), so nothing goes red — the row just rots.

The edit. Replace the Cloud row with

| `Marketplace` | `marketplace/` | Package identity & versions, marketplace listing / publish / install format, template manifests |

keeping the table's alphabetical position (after Kernel). One line, docs-only, skip-changeset.

Blocked-by: #16325

[claude]

Triage (skills-lane self-grade — the card arrived in pm:queue with domain:skills but no priority and no type; AGENTS.md is the governed surface this lane owns): admitted — class (b): AGENTS.md's Protocol Domains table declares a directory (cloud/) that the tree no longer has and omits the one that replaced it. Verified on origin/main d79f2499 at 2026-09-12T10:06Z: #16325 closed completed 2026-09-10 (the Blocked-by: is satisfied); git ls-tree -d origin/main packages/spec/src/marketplace answers, packages/spec/src/cloud does not; packages/spec/package.json exports ./marketplace and not ./cloud; AGENTS.md :657 still reads 「| Cloud | cloud/ | Multi-tenant, deployment, environment |」 directly after Kernel (:656). Task · priority:p3 — one docs row, no gate reads the table (the card's own measurement), cost = a reader sent to a directory that is not there. Direction: replace the row with the card's Marketplace row at the same position (after Kernel, alphabetical), one line in, one line out (1075/1075); the dev verifies the row text against the marketplace directory's actual contents and shortens it if the description overstates. Landing: AGENTS.md only; governed ⇒ draft at the human terminal with the four-piece; default tier build, skills-seat contract-tier review; skip-changeset. Hot-file: AGENTS.md free at 2026-09-12T10:06Z (PR #17809 landed d79f2499; no open PR touches it — all 23 open PRs' file lists scanned). Skills seat, session session_01MCLBsUgfykL74aU716rzVK, 2026-09-12T10:06Z.

---

Generated by Claude Code

[claude]

Claim: PM loop round 1
Session: session_01MCLBsUgfykL74aU716rzVK (GitHub os-sales, skills seat), claimed at 2026-09-12T10:06Z
Branch: claude/issue-17370-agents-protocol-domains-marketplace-row
Worktree: objectstack-issue-17370
Domain: domain:skills (self-graded by this seat, 5645228299: p3 Task; direction recorded there stands)
File surface (region-declared): AGENTS.md — the Protocol Domains table (:644 ff.), the one row at :657 (Cloud / cloud/) replaced by the Marketplace / marketplace/ row at the same position; one line in, one line out (1075/1075); ⛔ nothing else in the file, ⛔ no other table row, ⛔ no change to packages/spec
Container & model: S, mode:subagent, model: opus — default tier (AGENTS.md); skills-seat review at the contract-review tier; governed (Prime Directive #14) ⇒ draft PR at the human terminal with the four-piece, ⛔ never flipped ready by the seat
Clause-②: no
Thread-read: 5645228299 (the grading comment, 2026-09-12T10:06Z)
Serial constraints cleared: AGENTS.md free at 2026-09-12T10:06Z — PR #17809 (#17104) MERGED 10:04Z d79f2499; all 23 open PRs' file lists scanned at 10:05Z, none touches AGENTS.md; no chain behind this card on the file; verify lock free; H17 index ∩ this face = ∅. Card-reference face: #16325 closed completed 2026-09-10T11:44Z (the Blocked-by: target — satisfied; the body line stays as the record); the tree: packages/spec/src/marketplace present, packages/spec/src/cloud absent, exports ./marketplace present / ./cloud absent on d79f2499. Read-only, ⛔ not touched.

---

Generated by Claude Code

[claude]

os-dev-report

{
  "issue": 17370,
  "status": "done",
  "branch": "claude/issue-17370-agents-protocol-domains-marketplace-row",
  "pr": "https://github.com/objectstack-ai/objectstack/pull/17838",
  "head_sha": "f68b096530702ae0426c45ee91296e8b12869ca7",
  "files": ["AGENTS.md"],
  "premise_still_valid": true,
  "summary": "A landed. AGENTS.md:657 `| `Cloud` | `cloud/` | Multi-tenant, deployment, environment |` replaced by `| `Marketplace` | `marketplace/` | Package, Version, Listing, Install, Template |` at the same alphabetical position (after `Kernel` at :656). One line in, one line out — 1075 lines before and after, so both AGENTS.md ratchet pins stay at headroom 0. The card's proposed description was accurate but 132 bytes as a row and out of register with its neighbours (which are bare comma-separated noun lists of the domain's principal schemas), so it was shortened to 81 bytes — one noun per real schema family, each traced to a module's top-level exports (Package→package.zod, Version→package-version.zod, Listing+Install→marketplace.zod, Template→template-manifest.zod; package-l10n folds under Package). B landed as a report with nothing to do: `git grep -n \"cloud/\" -- AGENTS.md` returned exactly one hit, line 657, the row being replaced; post-edit the file has zero `cloud/` and zero `spec/cloud` references. Assignee was `os-sales` (PM-set) on arrival and the newest `Claim:` (5645228681) names this branch — both verified, neither touched. PR is DRAFT on a governed surface; never flipped ready, never queued, auto-merge never armed. `skip-changeset` applied additively and read back. `size/xs` was added by the size-labeler (another actor) — left alone.",
  "tests": "No build or test family is owed: the diff touches no package, so the dependency-closure build is empty and no package's `pnpm test` / `pnpm typecheck` is in scope. Gates derived in the worktree with `node scripts/pm/dispatch-gates.mjs --commands --repo objectstack-ai/objectstack` (no paths; the tool took its own change set from merge base 51b024a16, three-dot). 14 families derived, 14 run, all exit 0 — each exit code captured with `cmd > log 2>&1; EXIT=$?` before any pipe: check-closing-keyword-parity.mjs :: 0; check-closing-keyword-parity.mjs --self-test :: 0; check-comment-mask-corpus.mjs :: 0; check:agent-test-spelling :: 0; check:docs-audit-scope :: 0; check:driver-memory-census :: 0; check:nul-bytes :: 0; check:pm-governed-merges :: 0; check:pm-governed-prose :: 0; check:pm-skill-id-lint :: 0; check:pm-skill-ratchet :: 0; check:refd-timer-probe :: 0; check:required-contexts :: 0; check:watch-hint-literal :: 0. Reconciled with `--ran` (exit codes recorded per family): '✓ dispatch-gates --ran: 14 derived famil(ies) accounted for — 14 run, 0 NOT-MEASURED (a DERIVED zero — all 14 recorded an exit code and none of them is 3).' The load-bearing verdict lines, printed by the ratchet itself: '✓ check-skill-line-ratchet: AGENTS.md: widest table row is 768 bytes (pin 768; headroom 0).' and '✓ check-skill-line-ratchet: AGENTS.md is 1075 lines (ceiling 1075; headroom 0).' Control-byte self-scan beyond check:nul-bytes: `grep -naP '[\\x00-\\x08\\x0b\\x0c\\x0e-\\x1f\\x7f]' AGENTS.md` exits 1 with zero output. All readings taken at f68b09653, the final commit. No ablation or reverse verification applies — this is a one-row docs edit that no gate reads (premise 3), so there is no guard to mutate. Changeset judgement measured, not assumed: of 76 tracked package manifests, zero published package names anything matching AGENTS in its `files[]`, against a positive control of 70 published packages that do name README ⇒ publishes nothing ⇒ skip-changeset.",
  "gates": [
    { "command": "node scripts/check-closing-keyword-parity.mjs", "exit": 0, "ran": true },
    { "command": "node scripts/check-closing-keyword-parity.mjs --self-test", "exit": 0, "ran": true },
    { "command": "node scripts/check-comment-mask-corpus.mjs", "exit": 0, "ran": true },
    { "command": "pnpm check:agent-test-spelling", "exit": 0, "ran": true },
    { "command": "pnpm check:docs-audit-scope", "exit": 0, "ran": true },
    { "command": "pnpm check:driver-memory-census", "exit": 0, "ran": true },
    { "command": "pnpm check:nul-bytes", "exit": 0, "ran": true },
    { "command": "pnpm check:pm-governed-merges", "exit": 0, "ran": true },
    { "command": "pnpm check:pm-governed-prose", "exit": 0, "ran": true },
    { "command": "pnpm check:pm-skill-id-lint", "exit": 0, "ran": true },
    { "command": "pnpm check:pm-skill-ratchet", "exit": 0, "ran": true },
    { "command": "pnpm check:refd-timer-probe", "exit": 0, "ran": true },
    { "command": "pnpm check:required-contexts", "exit": 0, "ran": true },
    { "command": "pnpm check:watch-hint-literal", "exit": 0, "ran": true }
  ],
  "mcp_calls": "0 — REST (repo-scoped probe returned HTTP 200) plus git for every read and write; no MCP GitHub call was made this run, including the duplicate check, which needed none: this card filed nothing.",
  "open_questions": [],
  "out_of_scope_findings": [
    "noted, not filed: the dispatch word's premise 1 misattributes the line-width constraint — it names 'AGENTS.md's own line-width rule, Prime Directive #8' wrapping at ~84-90 bytes. There is no such rule. Prime Directive #8 is North Star alignment, and AGENTS.md carries no line-width rule at all. The real 120-byte budget is MAX_LINE_BYTES in scripts/pm/check-skill-line-ratchet.mjs, and it EXEMPTS a markdown table row by shape (EXEMPTION_CLASSES.table). What actually binds a table row is that script's second ratchet, MAX_TABLE_ROW_BYTES, pinned for AGENTS.md at 768 bytes, shrink-only, headroom 0. This is an error in the dispatch text, not in the repo, so there is no repo defect to file and no class (a)/(b)/(c) card; it is reported here so the PM's dispatch template stops repeating it. Successor: the PM, in the next skills-lane dispatch that cites a width constraint. The dispatch's operative instruction (stay within the table's own widest row) was honoured regardless: the new row is 81 bytes against the table's widest 84 (the `UI` row at :649) and 687 under the enforced pin.",
    "noted, not filed: origin/main advanced from d79f2499 (the PM's 10:05Z premise snapshot) to 51b024a16 before this branch was cut, by two docs(pm) commits — #17828 (platform-readings.md) and #17823 (rest-channel.md). Neither touches AGENTS.md, so every premise was re-taken and re-verified at 51b024a16 rather than inherited. Open-PR count is 22 at this reading, not the 23 the PM scanned. Successor: none — the delta is already reflected in this PR's acceptance notes."
  ]
}

---

Generated by Claude Code

[claude]

ACCEPT — contract-tier review of PR #17838 (head f68b0965, report 5645291354) by the skills seat at 2026-09-12T10:21Z.

Scope against the claim (5645228681): one file, AGENTS.md, one row (+1/−1) at :657 — 「| Cloud | cloud/ | Multi-tenant, deployment, environment |」 → 「| Marketplace | marketplace/ | Package, Version, Listing, Install, Template |」 — at the same position after Kernel; 1075 lines before and after (re-measured on the head); both AGENTS.md ratchet pins at headroom 0 per the gate's verdict lines. Nothing else in the file; git grep "cloud/" on the head returns nothing. Commit trailers model-free, no card relation; the PR body carries Fixes #17370. Gates: 14 derived / 14 run / all exit 0, reconciled with --ran; skip-changeset measured (no published package lists AGENTS in files[], control: 70 list README).

Read on the diff, not the report: the description is shortened from the card's proposal to the table's own register — bare comma-separated noun lists of the domain's principal schemas — with each noun traced to a module's top-level exports (package.zod, package-version.zod, marketplace.zod ×2, template-manifest.zod; package-l10n folds under Package as the neighbouring rows fold their helpers). 81 bytes against the table's widest 84. Accepted: the card's text was a proposal (「the edit」) and the register rule governs.

Reading corrected by the dev, recorded here: the dispatch word's premise 1 said 「AGENTS.md's own line-width rule, Prime Directive #8, wraps at ~84–90 bytes」 — false: PD #8 is North Star alignment and AGENTS.md carries no line-width rule; the seat conflated an earlier dev's measurement of the file's typical wrap with a rule. What binds a table row is MAX_TABLE_ROW_BYTES in scripts/pm/check-skill-line-ratchet.mjs (768 for AGENTS.md, shrink-only) — prose lines are under MAX_LINE_BYTES = 120 and a | row is exempt from it by shape. The operative instruction (stay within the table's widest row) was honoured.

Governed surface (Prime Directive #14) ⇒ PR #17838 stays a draft at the human terminal: needs-user-decision on the PR, the seat's 维护者速读 comment, reviewers os-zhuang + hotlong requested; ⛔ the seat never flips it ready, never arms auto-merge. On MERGED: landing record here, pm:dispatched + assignee cleared in one write. Skills seat, session session_01MCLBsUgfykL74aU716rzVK, 2026-09-12T10:21Z.

---

Generated by Claude Code

[claude]

Landed — PR #17838 MERGED 2026-09-12T15:47:03Z as 030cc392b (merged by os-zhuang through the merge queue; queued 15:23Z after approval). Skills seat stay-behind record, session session_01MCLBsUgfykL74aU716rzVK (GitHub os-sales), 2026-09-12T15:48Z.

Verified on origin/main by git (not on the PR): the merge commit is an ancestor of origin/main and single-parent; AGENTS.md :657 now reads the Marketplace row of the Protocol Domains table (git grep -c 'Marketplace' origin/main -- AGENTS.md ≥ 1; the old Cloud row is gone from :655–:659); file length 1075 lines (ceiling 1075, no raise). ACCEPT 5645296196, 速读 5645296348.

Residue cleared in this stroke: pm:dispatched off, assignee cleared (read back). domain:skills and type stay (ownership, not state). GitHub closes the card on the Fixes keyword.

---

Generated by Claude Code