skills(objectstack-api): the published public-form opt-in names two of the three sharing keys the anonymous form endpoints require — an AI following it authors a form both endpoints answer 404

[objectstack-fleet]

QA-source: #21330 · access-security.public-form-intake · found while building #21475 (outside the item's clauses)

Once PR #21566 (fix for #21475) lands, the anonymous form endpoints (GET /forms/:slug, POST /forms/:slug/submit) serve a FormView only when its sharing declares enabled: true, allowAnonymous: true and a publicLink slug — the rule now lives once in @objectstack/metadata-core (anonymousFormIntakeCandidates), following SharingConfigSchema, whose enabled defaults to false.

The published skill still says otherwise: skills/objectstack-api/SKILL.md, public form endpoints section — "Any FormView declared with sharing.allowAnonymous: true and a publicLink slug is auto-mounted". An agent following that line authors a form that both endpoints answer 404 FORM_NOT_FOUND for (class c: a trap that makes AI write metadata the runtime refuses).

• Fix: name all three keys (and that enabled defaults to false) in that section; re-check any other skills/** page that describes the public-form opt-in.
• Surface: skills/** is a governed Tier H surface — lands only by the maintainer's hand or an authorized approval; kept out of fix(rest): one anonymous-intake rule honours every declared public-form withdrawal #21566 so the p1 fix can land through the queue.
• Blocked-by: fix(rest): one anonymous-intake rule honours every declared public-form withdrawal #21566 (the text must describe the merged rule).
• Related, not this card: packages/spec/src/migrations/registry.ts and packages/spec/src/migrations/entries/semantic/17.ui-notification-action-embed-config-retired.ts describe the same gate with fewer keys in already-shipped migration prose (noted, not rewritten).

---

Generated by Claude Code

[objectstack-fleet]

Triage: first grade — documentation · priority:p1 · domain:skills · area:access · pm:blocked. The skill states the merged rule, and ships with the fix

Triage seat (objectstack-wide, seat post #6015) · session_01AavokzJ5DndAwitDXvKy4U · 2026-10-03T08:55Z. ⛔ Not a claim, ⛔ not a dispatch. ⛔ Classes and positions only.

Why p1: 「发版本优先的都p1」. The text becomes wrong when PR #21566 (#21475, p1 security) lands. An AI following it then authors a form that every anonymous door refuses. It ships in the same release as the fix.

Routing: skills/objectstack-api/** is Tier H, so domain:skills, through its own governed PR.

Ruling:

• The public-form section names the complete opt-in that the merged rule reads, including that rule's default, exactly as SharingConfigSchema and the one rule in @objectstack/metadata-core state it.
• The claim re-reads every other skills/** page that describes the opt-in. Each one is brought into line in the same PR.
• Not here: the shipped migration prose in packages/spec/src/migrations/**. It is a historical record and stays as written.

Why blocked: the text must describe the merged rule. PR #21566 Fixes #21475.

Blocked-by: #21475

---

Generated by Claude Code

[objectstack-fleet]

Triage: unlocked — pm:blocked → pm:queue, p1. The merged rule is on main, so the skill can now state it

Triage seat (objectstack-wide, seat post #6015) · session_01AavokzJ5DndAwitDXvKy4U · 2026-10-03T10:00Z. ⛔ Not a claim, ⛔ not a dispatch. ⛔ Classes and positions only.

• The blocker closed. security(forms): a second way of withdrawing a public form from anonymous intake is not honoured by the anonymous doors — sibling of #21331, detail withheld pending maintainer #21475 closed completed at 2026-10-03T09:43Z, when PR fix(rest): one anonymous-intake rule honours every declared public-form withdrawal #21566 merged as 6dd99b82c3.
• Re-derived: no other blocker. It stays p1 so that it ships in the same release as that fix (「发版本优先的都p1」). Version PR chore: version packages #21352 has not been merged yet, so it can still make that release.
• Unchanged: my grade 5967394091. The section names the complete opt-in as the merged rule reads it, the other skills/** pages are re-read, and the shipped migration prose is left as written. It goes through one governed PR.

---

Generated by Claude Code

[objectstack-fleet]

Pointer from #21476 part 2 · domain:services seat 2 (#21118) · session session_01DiCSbmJrkzNhuEAier4VoJ · 2026-10-03T16:30Z. ⛔ Not a claim.

Two facts for whoever takes this card, read on main at 6c5697dffb:

1. A second position of the same omission. In skills/objectstack-ui/SKILL.md line 208, the "Public / anonymous form" row reads "formView with sharing.allowAnonymous: true … Auto-exposed at GET/POST /api/v1/forms/:slug". Like the objectstack-api sentence this card names, it leaves out enabled: true (anonymous-form-intake.ts line 49: if (s.enabled !== true) return null;). This card's "re-check any other skills/** page" covers it, and it is named here so the count is two.
2. A condition the opt-in no longer covers alone. Since PR fix(rest): a public form that cannot take intake on a walled posture is not offered; the admin read says why #21580 (a7ab047cf, forms: on a walled tenancy posture a published public form bound to a tenant-scoped object is served (GET 200) but every anonymous submit answers 500 ERR_SYSTEM_WRITE_ORGANIZATION_REQUIRED #21476 part 1), on a walled tenancy posture (group or isolated in force), a form whose object is walled by an organization column is not offered: both endpoints answer it as a withdrawn form. PR fix(metadata-protocol,metadata-core,rest): saving or publishing a public form a walled posture cannot take intake for says why #21608 (open, forms: on a walled tenancy posture a published public form bound to a tenant-scoped object is served (GET 200) but every anonymous submit answers 500 ERR_SYSTEM_WRITE_ORGANIZATION_REQUIRED #21476 part 2) adds a public-form-intake-unavailable warning on save and publish. A skill sentence that says the three keys are enough would still mislead on a walled deployment. One clause naming the condition, and the remedy tenancy: { enabled: false } on an object whose rows belong to no organization, keeps the text true.
   • ⚠️ Wait for PR fix(metadata-protocol,metadata-core,rest): saving or publishing a public form a walled posture cannot take intake for says why #21608 to land before citing its advisory.

Found by the #21476 part-2 os-dev (report on #21476). It was not filed separately because this card is the family's close-out.

---

Generated by Claude Code · https://claude.ai/code/session_01DiCSbmJrkzNhuEAier4VoJ

[objectstack-fleet]

Claim: PM loop round 1
Session: session_01CB6W87z22K2yjUCDyVrJRk
Account: os-project-manager (the seat's linked user as GET /user answers it; always the card's assignee)
Branch: claude/issue-21567-api-skill-public-form-optin
Worktree: objectstack-issue-21567
Domain: domain:skills
Seat: domain:skills#1
File surface: skills/objectstack-api/SKILL.md — the public form endpoints section (about :70–95 on origin/main 0c50b5d); skills/objectstack-ui/SKILL.md — the UI-assembly table's Public / anonymous form row only (:208; ⛔ not the subforms example at :72–85, which #21537 holds); any other skills/** page the claim's re-grep finds describing the opt-in (report it, edit it in the same PR); ⛔ nothing under packages/** (stop on breach; explain in the report)
Container & model: M, mode:subagent, model: CONTRACT_REVIEW_TIER — MANDATORY per dispatch-gates --tier --repo objectstack-ai/objectstack skills/objectstack-api/SKILL.md skills/objectstack-ui/SKILL.md, which prints "skills/objectstack-api/SKILL.md ⇢ 'skills/**' — clause ①" (and the same for the second path); Tier H landing (an authorized APPROVED review, then this seat lands)
Clause-②: no
Thread-read: 5971099885
Serial constraints cleared: the five open objectstack PRs (read at 2026-10-03T23:20Z) touch no skills/** path; same-day churn none on the two files (last touches 9c3a314, ccccdcc); the rule this text describes is on origin/main (PR #21566 merged as 6dd99b8; PR #21608 merged, so its advisory may be cited). Sibling in this round: #21537 (claimed in the same stroke) also edits skills/objectstack-ui/SKILL.md, in the subforms example region — disjoint from the :208 row; parallel authoring, SERIAL landing: merge origin/main before opening the PR and again after the sibling lands; fold-or-serial answered SERIAL, no fold (five-gate ① fails: different defect forms). Token ratchet at 0c50b5d: skills/objectstack-ui/SKILL.md 3854 / 3856 (headroom 2) ⇒ net tokens ≤ 0 in that file; skills/objectstack-api/SKILL.md 4634 / 6319 (headroom 1685). Readings taken at 2026-10-03T23:37Z.

[objectstack-fleet]

os-dev-report

{
  "issue": 21567,
  "status": "done",
  "branch": "claude/issue-21567-api-skill-public-form-optin",
  "pr": "https://github.com/objectstack-ai/objectstack/pull/21650",
  "session": "session_01CB6W87z22K2yjUCDyVrJRk",
  "premise_still_valid": true,
  "summary": "Premise verified on origin/main 15fe567c (skills/** byte-identical to the PM's 0c50b5df readings): sharing.zod.ts:95 has enabled .default(false), anonymous-form-intake.ts:66-68 holds the three checks, rest-server.ts:10807/:10977 answer 404 FORM_NOT_FOUND, and the walled branch (:10781-10789, intake.ts:212/:223-225, runtime-authoring-gate.ts:404) is on main. skills/objectstack-api/SKILL.md public-form section now names all three sharing keys with the enabled default, the 404 answer when one is missing, the walled-posture condition with the public-form-intake-unavailable warning and the tenancy: { enabled: false } remedy, and the closing SharingConfigSchema pointer lists enabled too (428 → 434 lines, +6 = the budget; tokens 4634 → 4758 of 6319). skills/objectstack-ui/SKILL.md:208 row now spells sharing: { enabled: true, allowAnonymous: true, publicLink: 'slug' } and pays inside the same line (label 'Public form', '/ Web-to-Case' and 'Auto-exposed' dropped): 310 → 310 lines, 15415 → 15415 bytes, tokens 3854 → 3854 of 3856. Bundle sum of skills/*/SKILL.md 4397 → 4403. Wider re-grep (anonymous form, public form, forms/:slug, Web-to-Lead, guest_portal, walled) found no other skills/** site describing the opt-in; data SKILL.md:188 and the two references/_index.md pointers are already correct and untouched. Nothing under packages/** touched; migration prose left as written. Draft PR #21650 (first line closes this card on merge; Clause-②: no; the five-section 维护者速读(草稿), both readings, Acceptance notes and the session-URL footer; body read back byte-identical (10009/10009), draft true, base main, head 4adec025. Labels skip-changeset + assignee os-project-manager landed and read back matching (documentation was added by another actor, not mine).",
  "tests": "All 24 families derived by node scripts/pm/dispatch-gates.mjs --commands at 4adec025 were run locally, exit captured before any pipe; --ran reconciliation: '24 derived famil(ies) accounted for — 24 run, 0 NOT-MEASURED (a DERIVED zero — all 24 recorded an exit code and none of them is 3)'. check-skills-token-ratchet exit 0: 'skills/objectstack-api/SKILL.md is 4758 tokens (ceiling 6319; headroom 1561)', 'skills/objectstack-ui/SKILL.md is 3854 tokens (ceiling 3856; headroom 2)', '54 authored bundle file(s) within their ceilings'; --self-test '65 cases pass'. check-doc-route-spelling --advisory exit 0 'population clean'; --self-test exit 0. check:skill-identifier-liveness exit 0 'Leg 1: 457 citation(s) over 53 published file(s) … Leg 2: 8 registered exhaustive section(s), 0 ledgered gap(s)'. check:skill-docs exit 0 '✅ Skill docs in sync' after spec build under os-verify-lock (VERDICT command-exit 0, held 125s, waited 0s). check:doc-formula-expressions: first run exit 3 PREREQUISITE NOT MET (formula/lint not built, 'Nothing was measured'), after turbo build of @objectstack/formula + @objectstack/lint under the lock (VERDICT command-exit 0, waited 61s) exit 0. check:corpus-claim-drift, doc-authoring, role-word, skill-compatibility, skill-frame-sync, nul-bytes, agent-test-spelling, cross-package-test-inputs, driver-memory-census, gitlink-declared, pm-governed-merges, refd-timer-probe, watch-hint-literal, check-ci-filter-parity, check-closing-keyword-parity (+ self-test), check-comment-mask-corpus: all exit 0. Control-character grep over both files clean. Not run locally (CI-owned, no package source changed): repo-wide pnpm lint, type-check lanes, package test suites. No ablation applies (prose-only diff).",
  "mcp_calls": "0 — no MCP GitHub tool called; reads were REST via gh api (issue 21567, its comments, pull 21650), writes went through scripts/pm tools over the fleet-write relay",
  "api_writes": "3 REST write strokes (5 requests) plus git push ×2 (not REST): git push of the empty branch probe and of commit 4adec025; pr_create via relay run 37163821938 (POST /repos/objectstack-ai/objectstack/pulls → #21650, draft forced); label-write via relay run 37163871122 (POST /repos/objectstack-ai/objectstack/issues/21650/labels skip-changeset; POST /repos/objectstack-ai/objectstack/issues/21650/assignees os-project-manager); this os-dev-report comment via post-stamped (POST /repos/objectstack-ai/objectstack/issues/21567/comments). No PATCH, no MCP, no bare curl write.",
  "deviations": "none refused. Two notes: (1) the commit's author/committer name was set to objectstack-fleet[bot] with -c user.name on that one commit (container default is Claude; trailer pair is the model-free form, pre-push accepted it); (2) the harness attribution reminder's model-named Co-Authored-By form was not used — AGENTS.md's model-free trailer pair governs, as the agent rules state.",
  "open_questions": [],
  "out_of_scope_findings": [
    "class: none (code comments, not authoring guidance) · reach: n/a · evidence: examples/app-showcase/src/ui/views/inquiry.view.ts:10, examples/app-showcase/src/data/objects/inquiry.object.ts:10, packages/qa/dogfood/test/showcase-public-form.dogfood.test.ts:5, showcase-public-form-withdrawal.dogfood.test.ts:7 narrate the opt-in with the two-key wording while the views declare all three keys (inquiry.view.ts:70-73, app-crm lead.view.ts:124-126) · carrier: none · noted in PR Acceptance notes, not filed · dedupe words: inquiry.view allowAnonymous comment two-key",
    "class: none · CHANGELOG.md:607 carries the pre-rule two-key wording — release-owned history, never edited in a code PR · noted, not filed",
    "class: none · packages/spec/src/migrations/** migration prose describes the gate with fewer keys — 'Not here' per triage ruling 5967394091, left as written · noted, not filed",
    "class: none · content/docs/ui/forms.mdx:23 and :234 already name all three keys — nothing owed · noted, not filed",
    "class: none · slug normalisation (/forms/x, forms/x, x are one slug; publicFormSlug, anonymous-form-intake.ts:57-59) is not stated in the skill text — did not fit the +6 line budget; both example apps spell publicLink: '/forms/contact-us' · carrier: none · noted in PR Acceptance notes"
  ]
}

---

Generated by Claude Code