cli + create-objectstack: `os generate picklist` and the `src/picklists` scaffold wiring (os init / npm create), after the picklist runtime reader #19519 lands (split from #20825 item 1)

[objectstack-fleet]

Filed by the triage seat (objectstack-wide, seat post #6015, session_01AavokzJ5DndAwitDXvKy4U) as the carrier for #20825 item 1's generator half under answer B. ⛔ Not a claim, ⛔ not a dispatch. Graded here: enhancement · priority:p3 · domain:cli · area:devpath · pm:blocked.

Why it waits

A scaffolded, wired picklist validates and builds, and then serves nothing at runtime until #19519 (the runtime reader: resolving picklist into options) lands. Wiring every new os init / npm-create project to a kind with no runtime reader would be a declared capability the runtime does not honour. The generator row was written and reverted on #20825's branch (6ef78d3f29, then e16359a9fa), and that diff is the starting point.

Scope (measured by #20825's dev, os-dev-report 5922744843)

1. os generate picklist: the generator row in packages/cli.
2. Scaffold wiring: packages/create-objectstack's blank starter gets src/picklists/index.ts and its objectstack.config.ts entry, with a changeset. create-objectstack-wiring-parity.test.ts is the pin; it went 4 red with the row alone.
3. Docs: the generator rows in content/docs/deployment/cli.mdx and packages/cli/README.md.
4. Tier H: the "seven generator barrels" line in skills/objectstack-platform/SKILL.md. It is governed, so it needs the maintainer's approval on the PR.
5. The metadata summary (picklist kind: the os CLI compile / validate / lint path accepts *.picklist.ts, picklists and picklistExtensions, and os validate refuses a picklist that names no picklist (Scope 6 of #19518) #20825 addendum 5922965902): collectMetadataStats (packages/cli/src/utils/format.ts), which os validate / os build / os info print, gains a picklist row.

Not carried here

• The coarse outside-dependency trigger (picklist-reference-unverified) stays a recorded line, with no in-repo positive case.
• A dangling picklistExtensions[].extend is folded into picklist kind: the os CLI compile / validate / lint path accepts *.picklist.ts, picklists and picklistExtensions, and os validate refuses a picklist that names no picklist (Scope 6 of #19518) #20825 itself, as an item-2 sibling.

[objectstack-fleet]

Claim: PM loop round 1 of the domain:cli seat's session session_01VvcEokUG1tvVxkceYfR5XB (batch 3): priority:p3, the triage filing graded in the card body (answer B of #20825), unblocked by #19519's close (PR #21047), filling a free slot under the maintainer's 「并发保持3」. This claim is the code half, landed as Part of #21018
Session: session_01VvcEokUG1tvVxkceYfR5XB
Account: huangyiirene
Branch: claude/issue-21018-generate-picklist
Worktree: objectstack-issue-21018
Domain: domain:cli
Seat: domain:cli#1
File surface (scope items 1, 2, 3 and 5 of the card body; item 4 is excluded, see below):

• Item 1: packages/cli/src/commands/generate.ts, the picklist generator row, plus a pin beside the existing generate-*.pin.test.ts files.
  • The starting point is the row written and reverted on picklist kind: the os CLI compile / validate / lint path accepts *.picklist.ts, picklists and picklistExtensions, and os validate refuses a picklist that names no picklist (Scope 6 of #19518) #20825's branch (6ef78d3f29, then e16359a9fa), re-read against picklist metadata kind — runtime: resolve picklist → options when serving field metadata, validate writes against the resolved set, apply package-level extensions (phase 1 of objectstack#18164) #19519's landed runtime reader.
• Item 2: packages/create-objectstack/src/templates/blank/, the blank starter's src/picklists/index.ts and its objectstack.config.ts entry. packages/cli/test/create-objectstack-wiring-parity.test.ts is the pin.
• Item 3: the generator rows in content/docs/deployment/cli.mdx and packages/cli/README.md.
• Item 5: collectMetadataStats (packages/cli/src/utils/format.ts) gains a picklist row, printed by os validate / os build / os info, with a pin beside the existing format.*.test.ts files.
• Changesets for @objectstack/cli and create-objectstack, at the level the real diff takes.
• ⛔ Item 4 is not in this PR: the "seven generator barrels" line in skills/objectstack-platform/SKILL.md (:194 on db48028f1a) is a Tier H governed path, and a mixed diff is not split by proportion.
  • It follows as its own PR under a second claim, with Fixes #21018, after this half lands.
  • This PR's first line is Part of #21018.
• ⛔ Not here, per the card: the picklist-reference-unverified trigger, and the dangling picklistExtensions[].extend (folded into picklist kind: the os CLI compile / validate / lint path accepts *.picklist.ts, picklists and picklistExtensions, and os validate refuses a picklist that names no picklist (Scope 6 of #19518) #20825).
  (stop on a breach outside these; explain in the report)
  Container & model: M, mode:subagent, model: opus (dispatch-gates --tier: no path-derived mandate, floor sonnet · default opus · ceiling fable).
  Clause-②: yes (widening). os generate accepts a new kind, picklist. The dev re-reads it against the real diff.
  Thread-read: none
  Serial constraints cleared: #19519 is closed (PR #21047 merged). No open PR touches packages/cli/src/commands/generate.ts, packages/create-objectstack/src/**, packages/cli/src/utils/format.ts, content/docs/deployment/cli.mdx, packages/cli/README.md, packages/cli/test/create-objectstack-wiring-parity.test.ts or skills/objectstack-platform/SKILL.md (the file lists of all 14 open PRs were read in this act, main db48028f1a). The one hit is the Version Packages PR #20639 (packages/create-objectstack/CHANGELOG.md and package.json), which is release-owned and not touched here. In flight on this seat: #21114 (packages/cli/src/commands/start.ts, dev-restart.ts) and #21059 (packages/metadata-protocol/src/protocol.ts). Both are disjoint. area:devpath: #21114 is in flight on a disjoint surface.

---

Generated by Claude Code

[objectstack-fleet]

os-dev-report

{
  "issue": 21018,
  "status": "done",
  "branch": "claude/issue-21018-generate-picklist",
  "pr": "https://github.com/objectstack-ai/objectstack/pull/21167",
  "session": "session_01VvcEokUG1tvVxkceYfR5XB",
  "premise_still_valid": true,
  "summary": "Code half of #21018 (scope items 1, 2, 3, 5), opened as draft PR #21167 with Part of #21018. os generate picklist NAME writes src/picklists/NAME.picklist.ts via definePicklist, collected under the picklists stack key; os init derives the wiring from the roster, and the create-objectstack blank starter gains a byte-identical empty src/picklists barrel plus the config import and key. collectMetadataStats counts picklists and the Data: row of os validate / os build / os info prints it (stats.picklists also appears in the three --json payloads); cli.mdx and the cli README carry the generator row; minor changesets for @objectstack/cli and create-objectstack. Premise held: the runtime reader is on main as 88b484e00c (#21047), and a scaffold -> os g picklist -> select field -> os dev chain served the field with the list options and refused an off-list write (400 invalid_option naming the picklist). Item 4 (Tier H SKILL.md line) is not touched; its replacement text is in item4_line. Worktree and its node_modules removed after the PR opened.",
  "tests": "All on HEAD 5a535158c7 unless noted. (1) pnpm --filter @objectstack/cli exec vitest run --project unit --maxWorkers=2: 241 files passed + 2 failed at collection with \"packages/cli is not built\" (prerequisite, not a verdict); after pnpm --filter @objectstack/cli build those 2 files passed (29 tests). Total 243 files, 3456 passed, 29 skipped. (2) --project integration over the 8 integration files among the related tests (generate-picklist.pin, create-objectstack-stack-reach, generate-stack-reach, info-detail-package-fold, generate-refuses-name-outside-charset, generate-refuses-namespace-prefix, generate-refuses-retired-generator, schema-migrate.host-composition.integration): 8 files, 66 tests passed. (3) OS_TEST_TIERS=nightly over 6 related e2e files (generate-scaffolds-reach-stack, init-created-files-summary, scaffold-emission-policy, build-json-advisory-parity, build-json-undeclared-key-parity, validate-json-warning-parity): 6 files, 42 tests passed, incl. \"os g picklist exits 0 and reports no wiring to add\". (4) pnpm --filter create-objectstack exec vitest run: 16 files, 249 tests passed. (5) pnpm --filter @objectstack/cli typecheck exit 0 (tsc --noEmit and check:test-typecheck OK, ledger unchanged 3 files / 28 errors); pnpm --filter create-objectstack typecheck exit 0. (6) Pre-merge targeted run on e63b1dbd13: 10 files / 197 tests passed. Ablation on committed e63b1dbd13, each leg through scripts/ablation-replace.mjs (anchor x1 -> x0 proven on disk, restore proven blob == HEAD and git diff HEAD empty), relative src imports so no dist rebuild applies: generator row deleted (53-line anchor) -> generate-picklist.pin 3/5 red, wiring-parity 2 red (imports, stack keys), control generate-scaffold-validates 19/19 green; blank config picklists key deleted -> wiring-parity 1/22 red; collect line deleted -> metadata-stats-picklists 5 red + package-fold 4 red, controls green; print row deleted -> 2 red (Data: row pin, zero-row \"every metric collectMetadataStats counts is rendered\"), 27 green. Lint as proven narrowing on 5a535158c7: population read from eslint config (isPathIgnored/calculateConfigForFile) = all 8 touched .ts files linted, 4 md/mdx outside; eslint --no-inline-config --format json = 8 files, 0 errors, 0 warnings; invariance = no resolved config is type-aware (no parserOptions.project / projectService) and no lint config or baseline touched.",
  "mcp_calls": "0 — no MCP GitHub tool was called",
  "api_writes": "3 — all through the fleet-write relay (POST /repos/objectstack-ai/objectstack/dispatches, executed as objectstack-fleet[bot]): (1) pr_create -> POST /repos/objectstack-ai/objectstack/pulls (draft #21167, body read back 11264 bytes identical); (2) label-write assign -> POST /repos/objectstack-ai/objectstack/issues/21167/assignees (huangyiirene, read back matches); (3) this os-dev-report comment -> POST /repos/objectstack-ai/objectstack/issues/21018/comments. git push (6 pushes of the branch) is not a REST write.",
  "open_questions": [],
  "out_of_scope_findings": [
    "carrier: the item-4 follow-up PR (second claim, Tier H) · noted, not filed — two prose listings of the starter barrels now omit src/picklists: the Layout bullet in packages/create-objectstack/src/templates/blank/README.md (ships into every new project) and the tree in packages/create-objectstack/README.md; neither is pinned, both outside this claim's file surface; same roster sentence as the SKILL.md line"
  ],
  "gates": "dispatch-gates --repo objectstack-ai/objectstack --commands (no paths) on 5a535158c7 derived 96 families; all 96 run with exit codes captured before any pipe; final all 96 exit 0. Five first refused PREREQUISITE NOT MET (exit 3): spec check:skill-examples, check:dual-build-cjs-loads, check:i18n, check:i18n-coverage, check:i18n-walk-parity; rerun once their build inputs existed -> exit 0. --ran reconcile: \"96 derived famil(ies) accounted for — 96 run, 0 NOT-MEASURED\" (exit 0). CI on 5a535158c7 at report time: 34 check runs, 9 success, 3 skipped, 22 in_progress (not waited on).",
  "deviations": [
    "turbo 2.11.5 agent guidance: a turbo invocation inside pnpm check:type-check-debt wrote an 11-line block (an HTML comment marker pair) into the worktree AGENTS.md; reproduced once with pnpm exec turbo run build --filter=@objectstack/types --dry=json. Both times restored with git checkout HEAD -- AGENTS.md, git diff HEAD empty, never committed. Already fixed on main by fde553c509 (#21151, after this branch's merge base), so no finding.",
    "Two existing test fixtures that spell out every MetadataStats member (src/utils/format.metadata-stats-package-fold.test.ts, test/print-metadata-stats-zero-row.test.ts) gained picklists: 0; the interface change forces it (typecheck and toEqual). Two comments in generate.ts that counted the roster were reworded. Both inside item 1 / item 5 files or their direct fixtures.",
    "Item 2 measurement: the card's \"4 red with the row alone\" (row present, template absent) was not re-measured; measured instead row-absent (wiring-parity 2 red) and template-key-absent (1 red).",
    "origin/main merged once (70dae533c5, as instructed). origin/main has since moved to fde553c509 (4 commits, none touching this diff's surfaces); not re-merged.",
    "pnpm lint covered by the proven narrowing (three pieces of evidence in tests), not a full run.",
    "Commit trailers use the model-free pair from the dispatch, not the harness reminder's model-named Co-Authored-By line.",
    "Clause-② re-read against the real diff: unchanged, yes (widening) — a new os generate kind and a new stats.picklists key on three --json payloads; nothing narrowed."
  ],
  "files_changed": [
    ".changeset/21018-cli-generate-picklist.md",
    ".changeset/21018-create-objectstack-picklists-barrel.md",
    "content/docs/deployment/cli.mdx",
    "packages/cli/README.md",
    "packages/cli/src/commands/generate.ts",
    "packages/cli/src/commands/generate-picklist.pin.test.ts",
    "packages/cli/src/utils/format.ts",
    "packages/cli/src/utils/format.metadata-stats-picklists.test.ts",
    "packages/cli/src/utils/format.metadata-stats-package-fold.test.ts",
    "packages/cli/test/print-metadata-stats-zero-row.test.ts",
    "packages/create-objectstack/src/templates/blank/objectstack.config.ts",
    "packages/create-objectstack/src/templates/blank/src/picklists/index.ts"
  ],
  "repro": {
    "before": "origin/main 58a77dbde2: os generate picklist industry -> exit 1, \"Unknown type: picklist\", roster of 7; blank starter src = actions apps dashboards flows objects skills views (no picklists); hand-wired picklist + Field.select({ picklist }) -> os validate exit 0, \"Data: 1 Objects  3 Fields\" (no picklist count).",
    "after": "blank starter src gains picklists; os g picklist industry -> exit 0, \"Reaches the stack: objectstack.config.ts carries it in picklists as industry\"; with the field added os validate / os build / os info exit 0, \"Data: 1 Objects  3 Fields  1 Picklists\"; os info --json stats.picklists = 1; artifact carries picklists and the field picklist; os dev --fresh: GET /api/v1/meta/object/my_app_note 200 with fields.industry.options = [option_a, option_b] and picklist kept; GET /api/v1/meta/picklist/industry 200; POST valid 201; POST option_z 400 VALIDATION_FAILED invalid_option naming picklist industry; pre-change project: os g picklist region exit 0, \"Not wired\", prints the import and the defineStack key. collectMetadataStats line before/after: \"Data: 1 Objects  3 Fields\" -> \"Data: 1 Objects  3 Fields  1 Picklists\"."
  },
  "item4_line": {
    "file": "skills/objectstack-platform/SKILL.md (lines 194-195 on db48028f1a)",
    "current": [
      "  generic connector executors in `plugins:`; and the seven generator barrels",
      "  (`objects`, `views`, `actions`, `flows`, `dashboards`, `apps`, `skills`),"
    ],
    "proposed": [
      "  generic connector executors in `plugins:`; and the eight generator barrels",
      "  (`objects`, `views`, `actions`, `flows`, `dashboards`, `apps`, `skills`, `picklists`),"
    ],
    "note": "net zero lines; the same follow-up PR is the natural carrier for the two create-objectstack README listings"
  }
}

---

Generated by Claude Code

[objectstack-fleet]

ACCEPT (held): PR #21167 at 90d55b1e (the code half: os generate picklist, the blank starter's picklists barrel, the metadata-stats row). State change: pm:dispatched → pm:blocked on #20639, the release that publishes the picklists stack key

_{domain:cli seat · session_01VvcEokUG1tvVxkceYfR5XB · 2026-10-01T12:25Z}

Blocked-by: #20639

• Contract review of record: 5931398995 on the PR, CONTRACT_REVIEW_TIER, head 90d55b1e, PASS. It succeeds the FAIL 5930680827 on 5a535158.
  • What the records found:
    • Item 1: the generator emits a schema-valid definePicklist file under the registry's file pattern, reaches the picklists key the runtime reader (feat(objectql): resolve picklist references at runtime — served options, additive extensions, write validation, load-time refusal #21047) reads, and every enumeration of generator kinds derives from the one roster.
    • Item 2: the starter's empty barrel is byte-identical to os init's own rendering, and the wiring-parity pin holds the template and the roster together.
    • Item 3: the docs rows are accurate.
    • Item 5: the stats row counts picklist declarations, and a stack with none prints as before.
    • Semver: minor for both packages with Clause-②: yes (widening) is right.
  • The FAIL's three remedies are met:
    1. the PR body's Acceptance notes name the scaffold red and the repo-build scope of the repro;
    2. the hold is on record (5931049852);
    3. the two starter README listings now name src/picklists, in this PR (90d55b1e), not on the Tier H item-4 PR.
• Why it is held, not queued:
  • The non-required check Scaffold with repo dist is red. The scaffolded project installs the published @objectstack/spec 17.5.0, which predates the picklists stack key.
  • The key's changeset (addbbf0, .changeset/19518-picklist-kind.md) is still pending on main.
  • The gate is not red-by-design in its workflow's own terms, so the queue rule does not let the PR carry it. Landing now would leave it red on every later create-objectstack PR.
  • The record judges the PR landable as it stands once that one check turns green. All seven required contexts are green, and the merge-tree against main is clean.
• What unblocks it: the Version Packages PR chore: version packages #20639. Its head 718e74c744 has addbbf02ab as an ancestor and its @objectstack/spec 17.6.0 changelog lists it.
  • When chore: version packages #20639 merges and the release publishes, the seat re-runs Scaffold with repo dist once on this PR's head, then readies and arms it if green.
  • ⛔ The seat runs no release. The release is a maintainer action, so the card waits on chore: version packages #20639's own state.
• State: pm:dispatched → pm:blocked, in one label write with this comment.
  • The body's Blocked-by: line moves from picklist metadata kind — runtime: resolve picklist → options when serving field metadata, validate writes against the resolved set, apply package-level extensions (phase 1 of objectstack#18164) #19519 (closed, the runtime reader) to chore: version packages #20639.
  • The assignee stays: PR feat(cli,create-objectstack): os generate picklist, the src/picklists starter barrel, and a Picklists count in the metadata summary #21167 is this card's open work.
• Still owed after this PR lands: scope item 4, the Tier H skills/objectstack-platform/SKILL.md:194-195 line ("the eight generator barrels … picklists"). It goes in its own PR under a second claim, with Fixes #21018 and a human approval.

---

Generated by Claude Code