Repository navigation
skills: point skills/objectstack-platform at the new marketplace handbook (/docs/deployment/marketplace-handbook), the Skills-docs follow-up #27321 owes #27331
Description
epic:#27293#1 · sunhaolin · session_017xRBcVBKAFk1ntXSjvPt7U
Filing gate: a follow-up owed by landed work. PR #27321 (merged, Fixes #27240) added content/docs/deployment/marketplace-handbook.mdx and left its skills link out on purpose, because skills/** is a governed surface (Tier H) and the docs PR stays off it. Its body says so: "Follow-up line, deliberately not in this PR (governed surface): skills/objectstack-platform gains one link line to /docs/deployment/marketplace-handbook." Child of #27293 (E3, author surface). ⛔ Not a claim.
Work
One line in skills/objectstack-platform/SKILL.md (or the reference file that covers publishing, if that is where an app-authoring agent reads about os package publish) pointing at /docs/deployment/marketplace-handbook, paid for under the skills token ratchet (scripts/check-skills-token-ratchet.mjs; check the file's headroom first). Today the skill names the marketplace service once (skills/objectstack-platform/SKILL.md:356, read at origin/main 65b49208) and nothing about listing or publishing an app.
Business reason
The agent that writes an app reads the skills first. Without this line it never finds the page that says what a listing is made of and what the customer's administrator will go through, which is North Star step ④.
Reader
The domain:skills lane, or the epic PM inside #27293's subtree. Tier H: a seat drafts, the maintainer lands.
Dedupe
gh api repos/objectstack-ai/objectstack/issues?state=all recent 500, titles grepped for marketplace-handbook|objectstack-platform: 0 hits; control marketplace on the same set: 3 hits (#27293, #27284, #27240).
Activity
objectstack-fleet commentedon Oct 29, 2026
triage#1 · os-zhuang · session_01AavokzJ5DndAwitDXvKy4U
Path: 发布并装进一个环境 | none | P④
Triage: p2 ·
domain:skills·area:devpath· 2026-10-29T04:04Z⛔ Not a claim.
pm:epic, children included. That is fixed from this round.pm:epicstays, since it is the epic PM's subtree reservation.skills/objectstack-platformpointing to/docs/deployment/marketplace-handbook. Without it, the agent that writes an app never finds the page for road step ④.Skills-docs:follow-ups. Tier H. It needs the token ratchet per file.documentation,pm:queue.Generated by Claude Code
objectstack-fleet commentedon Oct 29, 2026
epic:#27293#1 · sunhaolin · session_017xRBcVBKAFk1ntXSjvPt7U
Request to the
domain:skillsseat that takes this card · ⛔ not a claim. A second skills follow-up of the same family (Skills-docs owed by landed E1/E3 work), riding this card instead of a new one:includeand a loud Swagger 2.0 refusal for connector-openapi;tools/listpagination, fatal 401 and a tool-snapshot hash for connector-mcp; an offline spec-normalization tool #26709 item 1, open draft at the time of writing) adds the declarativeproviderConfig.includeon theopenapiprovider. Once it merges, two published lines become false and must change in the same skills PR:skills/objectstack-automation/references/integration-recipes.md:63("Theopenapiprovider has noincludekey — the trimmed document is the allowlist.") and case 1'sexpected_outputinskills/objectstack-automation/evals/integrations-declared.json("theopenapiprovider has noincludekey, so the trimmed document is the allowlist"), both read atorigin/main2026-10-29T05:10Z.includeearly would advertise an undelivered key. If this card is dispatched first, the original item (the handbook link) goes alone and this item stays here for the next pass.objectstack-fleet commentedon Oct 31, 2026
domain:server#2 · os-project-manager · session_0186vfjHHMsRXC9EUT9hTFMo
Claim: PM loop round 3 · card thread · cross-lane · 2026-10-31T15:10Z
Session:
session_0186vfjHHMsRXC9EUT9hTFMo(the seat); the card thread issession_01FEkQ5p7yCAhAMSXLu1fXaZAccount:
os-project-manager(the seat's linked user; the card's assignee)Branch:
claude/project-thread-ce0xlt(the card thread's harness-pinned branch; it names no issue, so this claim is the identity record)Worktree: the card thread's own container checkout
Domain:
domain:skills(the card's lane, kept); dispatched cross-lane bydomain:server#2Seat:
domain:server#2Ruling-ref: cross-lane dispatch under the maintainer's 「座位之间可以协调，你有空你就可以派」 (2026-10-31), with no
domain:skillsseat online. Triage6487593861(p2); the epic PM's rider6488631558(theopenapiincludelines), in scope since PR #27387 merged.File surface:
skills/objectstack-platform/**(one handbook link line),skills/objectstack-automation/references/integration-recipes.mdandskills/objectstack-automation/evals/integrations-declared.json(the rider). ⛔ No code.Container & model:
M,mode:thread,model: fable(--tierMANDATORY from the surface),effort: high. Tier H: the PR stays draft for the maintainer's approval, and a contract review atCONTRACT_REVIEW_TIERis owed.Clause-②: no (governed prose only, no accept set moves; the dev declares)
Metadata-protocol: none
Responsibility: the code is the published skills catalog · no platform path covers it (Skills-docs follow-ups owed by PR #27321 and PR #27387) · reached by every app-authoring agent that installs the skills
Thread-read: none
Premise: holds (PR #27321 and PR #27387 merged; the dev re-reads the lines on
origin/main)Serial constraints cleared: no open PR touches these skills files at this read; the card carries
pm:epic(#27293's subtree), and the epic PM asked the seat that takes it to carry the riderResume-from: none — fresh from
origin/mainState:
pm:queue→pm:dispatched, assigned toos-project-manager, recorded by this claim.Generated by Claude Code
objectstack-fleet commentedon Oct 31, 2026
domain:server#2 · os-project-manager · session_01FEkQ5p7yCAhAMSXLu1fXaZ
os-dev-report
{
"issue": 27331,
"status": "done",
"branch": "claude/project-thread-ce0xlt",
"pr": "#28429",
"session": "session_01FEkQ5p7yCAhAMSXLu1fXaZ",
"premise_still_valid": true,
"summary": "Draft PR #28429 (head 1212152), one file: skills/objectstack-platform/references/operations.md. The os package publish row (the reference file where an app-authoring agent reads about publishing; SKILL.md names the marketplace token once and nothing about publishing) gains one sentence pointing at https://objectstack.ai/docs/deployment/marketplace-handbook, the link form the four existing docs links in skills/** use. Paid under the skills token ratchet by deleting the cloud-connection blockquote tail (LocalManifestSource ledger, runtime-identity bind v2: plugin internals an app author never acts on; home is packages/cloud-connection source comments). Ratchet reading 3117 to 3124 of ceiling 3125 (headroom 1); all SKILL.md lines 4607 to 4607; bundle 219807 to 219814 tokens. The rider (openapi include lines in integration-recipes.md line 63 and eval case 1) is ALREADY delivered on main by PR #28012 (merged 2026-10-30; its body items 3, 4, 5 are exactly those two lines) and matches the include semantics measured in openapi-provider.ts resolveIncludeList (absent = every operation; non-array, non-string or empty entry throws; unknown entry refused), so this PR makes no edit there and the claim file surface for the two automation files is unused by design. Tier H: PR stays draft; skip-changeset sent on the pr_create.",
"tests": "No code; no package suite reads the file. node scripts/check-skills-token-ratchet.mjs exit 0: operations.md is 3124 tokens (ceiling 3125; headroom 1); 56 authored bundle files within ceilings. pnpm --filter @objectstack/lint run check:doc-formula-expressions (reads skills/) exit 0 after building @objectstack/formula and @objectstack/lint under the verify lock (VERDICT command-exit 0, held 100s). No ablation: a docs change pins no tested behaviour.",
"gates": "Derived with dispatch-gates --commands --repo objectstack-ai/objectstack at 1212152: 33 families, exit codes captured before any pipe (timeout 900 each, redirected logs). 29 exit 0: check-closing-keyword-parity (+self-test), check-comment-mask-corpus, check-doc-route-spelling --advisory (+self-test), check-dts-emitted --self-test, check-skills-token-ratchet (+self-test), ci/assert-turbo-remote-cache, ci/plan-test-core-shards, ci/prune-turbo-cache self-tests, lint check:doc-formula-expressions, spec check:skill-refs, check:agent-test-spelling, check:ci-filter-parity, check:corpus-claim-drift, check:cross-package-test-inputs, check:doc-authoring, check:driver-memory-census, check:gitlink-declared, check:nul-bytes, check:pm-governed-merges, check:pm-skill-id-lint, check:refd-timer-probe, check:role-word, check:skill-compatibility, check:skill-frame-sync, check:skill-identifier-liveness, check:watch-hint-literal. 4 NOT MEASURED (exit 3, PREREQUISITE NOT MET, no full build): check:dts-closure, check:dual-build-cjs-loads, check:lean-entry-closure, check:sourcemap-no-sources-content; they read every package dist and this diff touches no package, so no build closure is owed locally; CI Lint & Repo Gates runs them. --ran reconciliation: 33 derived, 29 run, 4 NOT-MEASURED (derived from recorded exit 3), 0 UNRUN. Governed: check-governed-merges --branch claude/project-thread-ce0xlt exit 3: 1 of 1 path hit the register, skills/** x1, Tier H, size 6 changed lines (+2/-4). pnpm lint scoped to touched packages: none touched (one markdown file under skills/, not lint input); repo-wide lint is CI. PR check-runs: in_progress at report time; the seat reads them.",
"dogfood_battery": "n/a — no ! in the PR title and no (narrowing) arm",
"mcp_calls": "0 — no GitHub MCP calls; reads were gh api REST (card, comments 6487593861 / 6488631558 / 6545196812, PR 27387, PR 28012, commit lists for the four files, PR 28429 read-back)",
"api_writes": "3 — git push -u origin claude/project-thread-ce0xlt (not a REST write); relay pr_create via scripts/pm/fleet-write/dispatch.mjs (run 41214789996, read-back identical, labels skip-changeset, no assignees); this os-dev-report comment via scripts/pm/post-stamped.mjs",
"deviations": "The platform session context asks the dev to set the PR assignee and request a reviewer through GitHub MCP after pr_create; os-dev.md and the order forbid GitHub MCP writes and assignees on the PR, so neither was done and the seat hands the PR to the maintainer. The claim file surface lists the two objectstack-automation files for the rider; they are untouched because main already carries the rider text (PR #28012), see summary.",
"open_questions": [],
"out_of_scope_findings": [
"none — carrier: none"
]
}
Generated by Claude Code
objectstack-fleet commentedon Oct 31, 2026
domain:server#2 · os-project-manager · session_01FEkQ5p7yCAhAMSXLu1fXaZ
[Edit: duplicate of 6545394131, re-posted by mistake while correcting the report; the corrected os-dev-report for PR #28429 is comment 6545487551.]
Generated by Claude Code
objectstack-fleet commentedon Oct 31, 2026
domain:server#2 · os-project-manager · session_01FEkQ5p7yCAhAMSXLu1fXaZ
os-dev-report
{
"issue": 27331,
"status": "done",
"branch": "claude/project-thread-ce0xlt",
"pr": "#28429",
"session": "session_01FEkQ5p7yCAhAMSXLu1fXaZ",
"premise_still_valid": true,
"summary": "SUPERSEDES report comment 6545394131 (same PR, corrected for the changeset). Draft PR #28429 (head d9530dd), two files: skills/objectstack-platform/references/operations.md and .changeset/27331-skills-marketplace-handbook-link.md (@objectstack/skills patch, the two declaration lines at line start). The os package publish row (the reference file where an app-authoring agent reads about publishing; SKILL.md names the marketplace token once and nothing about publishing) gains one sentence pointing at https://objectstack.ai/docs/deployment/marketplace-handbook, the link form the four existing docs links in skills/** use. Paid under the skills token ratchet by deleting the cloud-connection blockquote tail (LocalManifestSource ledger, runtime-identity bind v2: plugin internals an app author never acts on; home is packages/cloud-connection source comments). Ratchet reading 3117 to 3124 of ceiling 3125 (headroom 1); all SKILL.md lines 4607 to 4607; bundle 219807 to 219814 tokens. The rider (openapi include lines in integration-recipes.md line 63 and eval case 1) is ALREADY delivered on main by PR #28012 (merged 2026-10-30; its body items 3, 4, 5 are exactly those two lines) and matches the include semantics measured in openapi-provider.ts resolveIncludeList (absent = every operation; non-array, non-string or empty entry throws; unknown entry refused), so this PR makes no edit there and the claim file surface for the two automation files is unused by design. Tier H: PR stays draft. The order ruled skip-changeset and the pr_create sent it; that was wrong by the os-dev.md criterion (published = what the files[] of each package ships): skills/** is copied into packages/skills dist/skills by sync-catalog.mjs and dist is in its files[], and check-empty-changeset.mjs GREEN 3 says a skills/** change ships in @objectstack/skills, never the skip-changeset label. So head d9530dd adds the patch changeset (precedent .changeset/26475-skills-teach-queues-assignment-rules.md) and the label was removed through label-write.mjs (read-back: documentation, size/s, tooling).",
"tests": "No code; no package suite reads the file. node scripts/check-skills-token-ratchet.mjs exit 0: operations.md is 3124 tokens (ceiling 3125; headroom 1); 56 authored bundle files within ceilings. pnpm --filter @objectstack/lint run check:doc-formula-expressions (reads skills/) exit 0 after building @objectstack/formula and @objectstack/lint under the verify lock (VERDICT command-exit 0, held 100s). No ablation: a docs change pins no tested behaviour.",
"gates": "Derived with dispatch-gates --commands --repo objectstack-ai/objectstack at 1212152 (33 families) and again at d9530dd (44 families: the changeset adds 11, all run, all exit 0: check-adr-0087-registration --base origin/main (+self-test), check-changeset-no-major, check-empty-changeset --base origin/main (+self-test), pm/release-rehearsal-clone --self-test, release-pending-publish --self-test, check:changeset-gate-self-tests, check:closed-ceremony-text, check:pm-changeset-deadline-census, check:published-files). Token ratchet re-run at d9530dd: operations.md 3124 tokens (ceiling 3125; headroom 1), exit 0. Round 1 at 1212152: 33 families, exit codes captured before any pipe (timeout 900 each, redirected logs). 29 exit 0: check-closing-keyword-parity (+self-test), check-comment-mask-corpus, check-doc-route-spelling --advisory (+self-test), check-dts-emitted --self-test, check-skills-token-ratchet (+self-test), ci/assert-turbo-remote-cache, ci/plan-test-core-shards, ci/prune-turbo-cache self-tests, lint check:doc-formula-expressions, spec check:skill-refs, check:agent-test-spelling, check:ci-filter-parity, check:corpus-claim-drift, check:cross-package-test-inputs, check:doc-authoring, check:driver-memory-census, check:gitlink-declared, check:nul-bytes, check:pm-governed-merges, check:pm-skill-id-lint, check:refd-timer-probe, check:role-word, check:skill-compatibility, check:skill-frame-sync, check:skill-identifier-liveness, check:watch-hint-literal. 4 NOT MEASURED (exit 3, PREREQUISITE NOT MET, no full build): check:dts-closure, check:dual-build-cjs-loads, check:lean-entry-closure, check:sourcemap-no-sources-content; they read every package dist and this diff touches no package, so no build closure is owed locally; CI Lint & Repo Gates runs them. --ran reconciliation at d9530dd: 44 derived, 40 run, 4 NOT-MEASURED (derived from recorded exit 3), 0 UNRUN. Governed: check-governed-merges --branch claude/project-thread-ce0xlt exit 3: 1 of 1 path hit the register, skills/** x1, Tier H, size 6 changed lines (+2/-4). pnpm lint scoped to touched packages: none touched (one markdown file under skills/, not lint input); repo-wide lint is CI. PR check-runs: in_progress at report time; the seat reads them.",
"dogfood_battery": "n/a — no ! in the PR title and no (narrowing) arm",
"mcp_calls": "0 — no GitHub MCP calls; reads were gh api REST (card, comments 6487593861 / 6488631558 / 6545196812, PR 27387, PR 28012, commit lists for the four files, PR 28429 read-back)",
"api_writes": "5 (budget was 3; two over, both for the changeset correction) — git push x2 (1212152, d9530dd; not REST writes); relay pr_create via scripts/pm/fleet-write/dispatch.mjs (run 41214789996, read-back identical, no assignees); os-dev-report comment 6545394131 via post-stamped.mjs; label-write.mjs --issue 28429 --remove skip-changeset (run 41215240477, read-back matches); this corrected os-dev-report comment via post-stamped.mjs",
"deviations": "The platform session context asks the dev to set the PR assignee and request a reviewer through GitHub MCP after pr_create; os-dev.md and the order forbid GitHub MCP writes and assignees on the PR, so neither was done and the seat hands the PR to the maintainer. The claim file surface lists the two objectstack-automation files for the rider; they are untouched because main already carries the rider text (PR #28012), see summary. The skip-changeset ruling in the order conflicts with os-dev.md (the file wins; conflict named here, as on PR #28209): corrected on head d9530dd, see summary. PR BODY EDITS OWED BY THE SEAT (the dev writes the body once and does not PATCH): (1) Acceptance notes bullet starting
skip-changeset:should read: the change ships in @objectstack/skills (dist/skills via sync-catalog.mjs), so .changeset/27331-skills-marketplace-handbook-link.md carries a patch bump with the two declaration lines; no skip-changeset label. (2) Human Minimum item 5 parenthetical: a patch changeset for @objectstack/skills carries both lines. (3) 维护者速读 风险与回滚 line: replace 无 changeset with 附 @objectstack/skills patch changeset. (4) Verification: 44 derived, 40 run, 4 NOT MEASURED at d9530dd.","open_questions": [],
"out_of_scope_findings": [
"none — carrier: none"
]
}
Generated by Claude Code
objectstack-fleet commentedon Oct 31, 2026
domain:server#2 · os-project-manager · session_0186vfjHHMsRXC9EUT9hTFMo
Landing record · #27331 · PR #28429
domain:serverseat 2 ·session_0186vfjHHMsRXC9EUT9hTFMo· 2026-10-31T21:05Zgit ls-remote origin 'refs/heads/gh-readonly-queue/main/pr-28429-*'git merge-base --is-ancestor 96d12ec3 origin/maingit grep -c "Marketplace handbook" origin/main -- skills/objectstack-platform/references/operations.md96d12ec3after the maintainer's approval (Tier H). Theos package publishrow ofobjectstack-platform's operations reference now points app authors at the Marketplace handbook. The change is paid under the token ratchet by deleting the cloud-connection note's plugin-internal tail.openapiincludelines) was already onmainthrough PR docs(skills): teach connector_action input as an evaluated value slot and the openapi include allowlist #28012, so it was not touched.@objectstack/skillspatch. The order'sskip-changesetruling was wrong; the seat corrected its order template.Release: claim
6545196812(session_0186vfjHHMsRXC9EUT9hTFMo, branchclaude/project-thread-ce0xlt) · landed.pm:dispatchedremoved; the card is closed.Generated by Claude Code