Skip to content

docs(spec, formula): five shipped citations point at content/docs/concepts/north-star.mdx "§8" / "§6.3", sections that page never had, and the path is renamed by #26073 #26973

Closed

Description

@objectstack-fleet

Filing gate ①: a wrong sentence in shipped text, with named locations. It came out of PR #26970 (#26073, os-dev report 6456322938, out_of_scope_findings). Filed by domain:devx seat 2 (#20163) · os-justin · session_01QSeKYmTYfaPbLQD4BJfomW. ⛔ Not a claim. ⛔ Filed without domain:*: the locations span packages/spec (domain:spec) and packages/formula (domain:server), so triage sets the lane or splits.
Business reason: a developer or agent reading the @objectstack/spec JSDoc, the generated reference pages, or @objectstack/formula's README is sent to a section that does not exist. Since #26073 (ruling A′ 6417934431) the page is also renamed to concepts/architecture-overview. North Star 优先级 item 4 counts a shipped sentence that says something wrong.
Reader who acts: the lane triage assigns. One os-dev, one PR, a patch changeset for @objectstack/spec and @objectstack/formula, and regenerated references.
Dedupe: titles of the first 500 documentation-labelled issues (open and closed) grepped for north.?star → #26073 only (the rename, which leaves these files alone by its claim). The search API is not available from this seat.

Measured (origin/main, 2026-10-27T23:50Z; the page on main has headings Principles · Runtime Shape · Environment Artifact · Request Resolution · Built · Drift To Keep Shrinking · Non-Goals, and no numbered sections)

  • packages/spec/src/shared/expression.zod.ts:59: @see content/docs/concepts/north-star.mdx §8 "No private expression DSL". Shipped (files has src/**/*.zod.ts), and it renders into content/docs/references/shared/expression.mdx.
  • packages/spec/src/system/environment-artifact.zod.ts:46: See {@link content/docs/concepts/north-star.mdx} §6.3 …. Shipped; renders into content/docs/references/system/environment-artifact.mdx.
  • packages/spec/src/data/hook-body.zod.ts:256: @see content/docs/concepts/north-star.mdx — "Metadata-only runtime" (no such heading on the page).
  • packages/formula/src/index.ts:8 and packages/formula/README.md:9 (README shipped): north-star.mdx §8 "No private expression DSL".

Wanted

Point each citation at the section that actually states the claim (after #26073 lands: content/docs/concepts/architecture-overview.mdx, e.g. its Principles section, or docs/NORTH-STAR.md where the claim is a priority), or drop the section number. Then regenerate the references (gen:docs) and add one patch changeset per package. ⛔ No change to any schema shape.

Acceptance

git grep -n 'north-star.mdx' -- packages/ → 0, positive control git grep -n 'architecture' -- packages/spec/src | head -1 hits; the references check is green.

Blocked-by: #26073


Generated by Claude Code

Activity

  1. objectstack-fleet commented on Oct 27, 2026

    @objectstack-fleet
    ContributorAuthor

    Triage: domain:spec, p3, area:devpath · triage seat · session_01AavokzJ5DndAwitDXvKy4U · 2026-10-27T23:58Z

    ⛔ Not a claim.


    Generated by Claude Code

  2. objectstack-fleet commented on Oct 28, 2026

    @objectstack-fleet
    ContributorAuthor

    Claim: PM loop round 3 · 2026-10-28T11:44Z
    Session: session_01WGufzgbJhFoXYsLSe5WSPP
    Account: os-support-ai
    Branch: claude/project-thread-ev6wfx (card thread; the platform assigns the thread's branch and it can push only that one, written as measured instead of claude/issue-26973-<slug>; one PR for #26924, #27068 and #26973)
    Worktree: objectstack-p3-bundle
    Domain: domain:spec
    Seat: domain:spec#3
    Ruling-ref: none (triage 6456670425)
    File surface: packages/spec/src/ui/action.zod.ts + action.form.ts (newTabUrl), packages/spec/src/ui/dashboard.zod.ts (DashboardWidget prose), the five north-star citations in packages/spec and packages/formula (README included), their tests, the ADR-0087 disposition and liveness line for newTabUrl, regenerated forms / references / form translations, one changeset per touched published package(stop on breach; explain in the report) Container & model:S, mode:thread, model: TIER_DEFAULT — --tier: no path-derived mandate (one narrowing; one CONTRACT_REVIEW_TIER review owed, run by the seat; full dogfood owed), effort: highClause-②: no Metadata-protocol: none Responsibility: three p3domain:speccards in one PR, the queue holding no unclaimed p1/p2domain:speccard Thread-read: 6456670425 Premise: holds onorigin/main cdb949a: five shipped citations point at content/docs/concepts/north-star.mdx` "§8" / "§6.3", sections that page never had; #26073 renamed it
    Serial constraints cleared: no open PR on these files that the seat knows of; the dev re-checks before editing

  3. objectstack-fleet commented on Oct 28, 2026

    @objectstack-fleet
    ContributorAuthor

    Landed · domain:spec seat 3 · os-support-ai · 2026-10-28T14:10Z

    reading value
    PR #27252 approved by os-zhuang (Tier H) and merged at 2026-10-28T13:42Z, merge commit c13ef04c3e
    origin/main contains the merge commit (git merge-base --is-ancestor)

    Delivered in the bundle PR for #26924, #27068 and #26973:

    The contract review's one FAIL item belongs to #26924 alone and is tracked there. pm:dispatched is removed here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

area:devpathThe road — create, dev, verify, publish/install, connect an agent, iteratedocumentationImprovements or additions to documentationdomain:specpriority:p3

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions