[objectstack-fleet]

Fixes #26073
Clause-②: no
Metadata-protocol: none

维护者速读

• 改了什么:「北极星」从此只指 docs/NORTH-STAR.md。原架构页 concepts/north-star 改名为 concepts/architecture-overview(旧网址 308 永久跳转),删掉会过期的 Built、Drift To Keep Shrinking 两节。AGENTS.md(第 7 行与 Prime Directive 8)、ROADMAP、CONTRIBUTING、README 四处入口统一指向它。docs/NORTH-STAR.md 末尾加了一节英文摘要,中文原文一字未动。
• 为什么改:执行裁决 A′(6417934431,「同意」)。两份同名文件让读者有一半概率打开错的那份,而真正高于 AGENTS.md 的那份,英文贡献者读不了。
• 风险与回滚:只改文档,不碰任何发布包。站外指向旧网址的链接由 redirects 表兜底。回滚 = revert 本 PR。
• 先看:① docs/NORTH-STAR.md 末尾的英文摘要:是否忠实于中文原文、有没有新增规则;② AGENTS.md 第 7 行与 Prime Directive 8 的新措辞;③ content/docs/concepts/architecture-overview.mdx。
• 两分钟验证:git diff origin/main...HEAD -- docs/NORTH-STAR.md | grep -c '^-[^-]',应输出 0,即中文原文没有删改任何一行。
• 需要你做的:本 PR 是 Tier H(改了 AGENTS.md 和 docs/NORTH-STAR.md)。请审阅英文摘要与 PD8 的措辞,然后用 GOVERNED_APPROVERS 里的账号批准本 PR。

What changes

Ruling A′ (comment 6417934431), all three items:

1. The architecture page gets an honest name. content/docs/concepts/north-star.mdx is renamed to architecture-overview.mdx, with a new title and nav title. It keeps Principles, Runtime Shape, Environment Artifact, Request Resolution and Non-Goals. The Built and Drift To Keep Shrinking sections are removed. One sentence under the opening diagram now points readers to the North Star for goals and priority. content/docs/concepts/meta.json lists the new slug. apps/docs/redirects.mjs gains one entry, /docs/concepts/north-star → /docs/concepts/architecture-overview, so the old URL answers a permanent redirect.
2. One North Star. AGENTS.md line 7 and Prime Directive 8 now point at docs/NORTH-STAR.md. Prime Directive 8 is re-pointed at that file's 路上的功能点 ladder, graded by its 优先级, and no longer refers to "§7 Built / Drift / Missing". ROADMAP.md line 4 and CONTRIBUTING.md name docs/NORTH-STAR.md as the one North Star. The README Community line linked the site page and now links the file. The two hand-written site pages that linked the old slug now link the new one: content/docs/concepts/metadata-lifecycle.mdx (only the link line changed) and content/docs/data-modeling/formulas.mdx (two links).
3. English summary. docs/NORTH-STAR.md gains a ## English summary section under the Chinese text. It covers the four opening questions, the one measure (the road), and how to read the ladder, including how grading reads it. It says that the Chinese text governs. It carries no numbers, following that page's own 账本 rule, and it adds no rule. The Chinese original is untouched: 53 lines are added and none are removed.

scripts/docs-audit/handwritten-docs.json was regenerated by its generator (node scripts/docs-audit/check-audit-scope.mjs --write; +1 added, -1 removed).

No changeset (skip-changeset): every changed path is either private (apps/docs, the root package) or unpublished (docs, content/docs, scripts/).

Tests

This diff is docs-only, so it has no unit tests. Verification is the derived gate list, run on the final head 43cb2c7e83. See Verification.

Acceptance notes

• Re-derived "five site pages". Five pages on origin/main linked or named the old page. Two are hand-written and were moved: concepts/metadata-lifecycle.mdx L174 and data-modeling/formulas.mdx L29 and L695. Two are GENERATED and were left alone: references/shared/expression.mdx L55 and references/system/environment-artifact.mdx L45. One is RELEASE-OWNED and was left alone: releases/v17/17-6.mdx L1483, whose URL the new redirect covers.

• Generator sources of the two generated mentions, not edited here (as dispatched). These are plain-text paths, not links, so the redirect does not rescue them:

  • packages/spec/src/shared/expression.zod.ts:59, which renders as references/shared/expression.mdx, cites north-star.mdx §8 "No private expression DSL".
  • packages/spec/src/system/environment-artifact.zod.ts:46, which renders as references/system/environment-artifact.mdx, cites §6.3.

  The same kind of mention is in packages/spec/src/data/hook-body.zod.ts:256 ("Metadata-only runtime"), packages/formula/src/index.ts:8 and packages/formula/README.md:9 (the formula README is published). All five cite sections that were already missing from the page on base e4ba846f, because the page has no numbered sections and no such headings. They were stale before this PR, and the rename makes the file path dangling as well. Fixing them means choosing a new citation and spending a changeset plus gen:docs, which is outside this card. carrier: none.

• Release-owned history keeps the old path. Root CHANGELOG.md L1033 links content/docs/concepts/north-star.mdx, and it also mentions "§7 Missing in the North Star" at L1125. The rule for release-owned text is not to edit it.

• The card's confidence gap, measured. git grep concepts/north-star across README.md, ui/, apps/docs and the redirects ledger found one hit: README L270, a site link, now re-pointed to ./docs/NORTH-STAR.md. ui/ has one North Star reference, ui/ROADMAP.md:14, and it already points at docs/NORTH-STAR.md. apps/docs had no entry for the slug before this PR. Inbound links from outside the repository cannot be measured from here, and the permanent redirect covers them.

• AGENTS.md line 7 lost its (先做什么: goals, priority) parenthetical. pnpm check:pm-skill-ratchet holds AGENTS.md to 120 bytes per line, and the file sits at its 1112-line ceiling with zero headroom. A version that kept the parenthetical (152 B) went red, and wrapping it would add a line the ceiling does not allow. The line now reads "docs/NORTH-STAR.md, the North Star, outranks it; content/docs/concepts/architecture-overview.mdx = architecture." (116 B). What the North Star governs is still stated in Prime Directive 8 and in the summary.

• ROADMAP.md's "Last updated" date was left unchanged, because only the source-of-truth pointer moved.

Verification

Final head 43cb2c7e83 (after merging origin/main twice; no incoming commit touches this diff's files). node scripts/pm/dispatch-gates.mjs --commands --repo objectstack-ai/objectstack derived 69 commands. All 69 were run with the exit code captured before any pipe, and every one exited 0. --ran reconciled the list: 69 derived, 69 run, 0 NOT-MEASURED, 0 UNRUN ("a DERIVED zero — all 69 recorded an exit code and none of them is 3").

Gate readings named by the dispatch

• pnpm check:docs-redirects exit 0: check-docs-redirects: OK (apps/docs/redirects.mjs: 99 entries -- 96 page destination(s) resolved against content/docs, 3 wildcard destination(s) resolved to a directory, 0 outside the /docs route space, 105 chain probe(s) matched against every source).
• pnpm check:doc-authoring exit 0: doc authoring guard: 19557 customer-facing string(s) across 1495 spec sources clean
• pnpm check:pm-governed-prose exit 0: check-governed-prose: 2 instruction surface(s) name all 13 registered governed surfaces that govern objectstack
• pnpm check:doc-anchors exit 0: 628 internal #fragment link(s) across 432 source file(s) all resolve to a real heading
• pnpm check:docs-audit-scope exit 0 (with the handwritten-docs manifest regenerated).
• pnpm check:pm-skill-ratchet exit 0 on the final head. The first run (exit 1) flagged AGENTS.md L7 (152B), which was fixed in 2ee65f9627.
• Link check (lychee, check-links.yml): NOT MEASURED locally, reason: lychee is not installed in this container. The advisory CI lane runs over content/** and the root README.md.

Build-dependent gates

• pnpm check:docs-transcript-drift first answered PREREQUISITE NOT MET (exit 3, @objectstack/lint unbuilt). After pnpm --workspace-concurrency=2 --filter '@objectstack/lint...' build under the verify lock (VERDICT command-exit 0), it exited 0: 4 declared transcript value(s) across 426 page(s) under content/docs/ equal what the registry derives today.
• pnpm --filter @objectstack/spec run check:skill-examples first answered exit 3 (packages/client-react/dist unbuilt). After --filter '@objectstack/client-react...' build under the lock (VERDICT command-exit 0), it exited 0: 267 prose examples type-check across 3 surface(s).
• pnpm --filter @objectstack/spec run check:docs exit 0: 232 generated files in sync with packages/spec.

---

Generated by Claude Code

[github-actions]

📓 Docs Drift Check

Nothing in this diff resolved to a documentable surface (no symbol, route or SDK anchor derived from 0 changed package(s)), so this run has no opinion about the docs.

What this run could not see

• a page that states a rule by its inputs shares no identifier with the emitter that implements the rule, so an emitter-only diff cannot list it — not on this run and not on any run. Measured on fix(driver-sql): emit varchar(maxLength) for a text field a declared index keys on #11430: content/docs/protocol/objectql/types.mdx documents the text-family column mapping by the ObjectQL type names it maps FROM (text / textarea / html) while the diff changed createColumn; it went unlisted, and it was the page that diff falsified, in four places. No shared token exists to detect this on, so a rule your change carries has to be re-read by hand in the pages that restate it.
• a key NAME is not a key, so the hand re-read the line above prescribes can land on the wrong schema. The same spelling is authorable on one governed type and a [REMOVED] tombstone on another for each of active, aria, joins, objects, template, tools and version (censused on [finding] tools is a key on BOTH AgentSchema (tombstoned, dead) and SkillSchema (live, cloud-attested), so a name-based search attributes skill examples to the agent key — it produced a false stop-the-line alarm on PR #19059 #19093 over the liveness ledger's governed types, top-level keys); nothing in a search result distinguishes the two, so a grep hit on a LIVE example reads as evidence about the DEAD key. Measured on fix(spec): the agent.tools liveness row says dead — it claimed live on a key the schema tombstoned #19059: content/docs/ai/agents.mdx was reported as contradicting the agent.tools tombstone over its tools: example at :161, which is inside the defineSkill({ block opened at :155 — the page was already correct. Settle ownership by PARSING the value against both schemas, never by the name: that literal PASSES SkillSchema, and as an AgentSchema it FAILS at tools with the tombstone prescription. ⛔ These names are not the whole class — a key retired through a .strict() guidance map leaves no tombstone in the walked shape and none of them here (tool.category, live as AIToolDefinition.category).

Coarse fallback — 0 page(s) merely mention a changed package (the pre-#9192 predicate, kept for the deliberately-wide backstop): node scripts/docs-audit/affected-docs.mjs --json a8ee8a229aefdfdc144432ab6bca4b5fc6487fcf → packageMentionDocs.

[objectstack-fleet]

devx seat 2 · auto-merge paused, held for a red non-required check · 2026-10-27T23:50Z

os-zhuang's approval (review 5675963512, head 43cb2c7e83) is on record and stands; this hold is about one check, not the approval. Check Documentation Links (job 122537358057) is red on this head with exactly 2 errors, both file links to the renamed page:

• CHANGELOG.md L1033 → content/docs/concepts/north-star.mdx ("see north-star §8")
• content/docs/releases/v17/17-6.mdx L1482 → /docs/concepts/north-star

The check is not a required context, so auto-merge would land the PR with it red. lychee scans the whole repo, so main would then carry two dead links, and every later docs PR would go red. The site redirect added here does not help, because lychee resolves file paths. Both files are release-owned: content/docs/releases/** and the release CHANGELOG may only be corrected in a dedicated docs-only PR, so the fix does not go into this PR.

Next: the seat opens that dedicated PR. It points both links at the published URL https://objectstack.ai/docs/concepts/north-star, which the redirect in this PR forwards to architecture-overview, and which the offline link check excludes. That PR is green before and after this one lands. Once it merges, main is merged into this branch, the link check re-runs, the seat posts its ## 席位核对 record (the contract review is in progress), and auto-merge is re-armed. Nothing else on this PR changes.

---

Generated by Claude Code

[objectstack-fleet]

Contract review

Served-tier: CONTRACT_REVIEW_TIER
Head-sha: 43cb2c7e8375bdcddaf418570732440f18bc0933
Local-runs: none
Scope: AGENTS.md, docs/NORTH-STAR.md + content/docs/concepts/architecture-overview.mdx, apps/docs/redirects.mjs, content/docs/concepts/meta.json, scripts/pm/check-skill-line-ratchet.mjs, .claude/skills/pm-dispatch/SKILL.md, .github/workflows/check-links.yml, lychee.toml, .lycheeignore, CHANGELOG.md, content/docs/releases/v17/17-6.mdx

Read: card #26073 body and every comment (ruling 6417934431, claim 6455550175, os-dev-report 6456322938); PR #26970 body, file list (11 paths, +75/-46) and net diff against main at this head; the head's check-runs; the head commit read locally. The remainder of the diff (CONTRIBUTING.md, README.md, ROADMAP.md, the mdx rename body, meta.json, metadata-lifecycle.mdx, formulas.mdx, handwritten-docs.json) is the lane seat's ACCEPT at TIER_DEFAULT; the cited files above were read to judge the hits, not reviewed.

① Derived judgments

• Governed register: AGENTS.md and docs/NORTH-STAR.md are Tier H rows, so this PR lands only on an authorized APPROVED review by a GOVERNED_APPROVERS account; this record is the contract-tier review of record and no landing authority. Draft, head repo = base repo. Right.
• Check-runs on the head at review time: 30 success, 16 skipped, 1 in progress (Test Core (1/8)), 1 failure: Check Documentation Links. Every required context that ran is green (Governed Surface Queue Guard, the Lint · and Type Check · lanes; the UI set skipped by paths). The link-check red is advisory and it is THIS PR's: lychee (offline, --root-dir content, fallback extensions, per check-links.yml) reports exactly 2 errors, both "File not found" for the page this PR renames: CHANGELOG.md:1033 links content/docs/concepts/north-star.mdx, and content/docs/releases/v17/17-6.mdx:1482 links /docs/concepts/north-star. The PR body's judgment "whose URL the new redirect covers" is WRONG for this gate: apps/docs/redirects.mjs is a route redirect the site serves at request time; lychee resolves site routes against content/ on disk and never reads the ledger. Landed as is, this head puts an advisory red on main's merge ref for every later PR that touches content/** or README.md (AGENTS.md, Multi-agent discipline 7). See ④ must-fix.
• apps/docs/redirects.mjs +1 entry /docs/concepts/north-star → /docs/concepts/architecture-overview: the public docs-site URL change the ruling ordered, with its permanent redirect; check:docs-redirects green in Lint · docs & code guards. Right.
• content/docs/concepts/meta.json: north-star → architecture-overview in the explicit pages array (Documentation Guardrails, hand-written trees). Right. Observation, not a finding: the Concepts nav now lists architecture ("Protocol architecture — the four layers") beside architecture-overview; the slug is the ruling's own word, so two architecture pages are the ruling's accepted cost.
• scripts/docs-audit/handwritten-docs.json: one path swapped by its own generator; check:docs-audit-scope green. Right.
• Chinese integrity: the diff against the merge base for docs/NORTH-STAR.md has 0 removed lines; the English section starts after the 账本 paragraph, under a rule. Right.
• check:pm-governed-prose green: Prime Directive 14's register paragraph is untouched; docs/NORTH-STAR.md keeps its GOVERNED_SURFACES row and its CODEOWNERS line. Right.
• Commit trailers: both commits carry the model-free pair; author and committer are the shared identity. Right.
• Line budgets: check-skill-line-ratchet.mjs caps every ceilinged line at 120 bytes and holds AGENTS.md at 1112 lines; the head has 1112 lines and L7 is 116 bytes. Right.

② Semver level

skip-changeset is right: the root workspace (@objectstack/spec-monorepo) and apps/docs (@objectstack/docs) are private: true; content/docs/**, docs/**, scripts/** and the root Markdown files ship in no tarball (the published packages' files lists name their own README.md, never the root one). Check Changeset success. Clause-②: no on the PR body and in the claim: right, no packages/spec path moves and nothing an author can write changes. Metadata-protocol: none: right.

③ Boundary flags

• Deviation "AGENTS.md L7 lost its parenthetical": answered in ④; holds.
• Deviation "container restarted mid-sweep": the gates were re-run on the final head and the head's check-runs are the verdict; no action.
• Deviation "model-free commit trailers instead of the harness's model-named line": the correct reading of AGENTS.md (the pre-push hook refuses a model identifier); no action.
• open_questions: none declared, none found.
• Out-of-scope 1 (plain-text citations of north-star.mdx in packages/spec/src/shared/expression.zod.ts:59, packages/spec/src/system/environment-artifact.zod.ts:46, packages/spec/src/data/hook-body.zod.ts:256, packages/formula/src/index.ts:8, packages/formula/README.md:9, and the two generated pages they render): verified on the head, all seven still name the removed file. Escalated as the should-fix below: "carrier: none · noted, not filed" leaves a dangling path in a published README and on two site pages with no card to stanch it.
• Out-of-scope 2 (release-owned text keeps the old path): content/docs/releases/** is release-owned, right. The root CHANGELOG.md is NOT in the Documentation Guardrails table (only packages/*/CHANGELOG.md is), its own header says it is historical and no longer extended, and its L1033 is one of the two lines the link gate reds, so "release-owned, leave it" does not cover that file. Folded into the must-fix.

④ Design judgment

docs/NORTH-STAR.md, the English summary, against ruling 6417934431 item 3 and the Chinese text on this head. Required: the four opening questions, the one measure, how to read the ladder; adds nothing; the Chinese unedited. Compared sentence by sentence against L3 to L13 and L113 to L117:

• 我们是什么 (L3) ↔ "What we are": every clause present (the executable ontology and its seven kinds; AI writes, runtime runs, people and agents use, you own; startup stage; the four projections as today's surfaces). No addition, no drop.
• 给谁 (L5) ↔ "Who it is for": third-party developers, AI-first with a human accepting, the AI writes in the protocol and the human decides, end users are business staff through agents and the UI. Faithful.
• 做出来的是什么 (L7) ↔ "What gets built": the eleven capabilities in order, the AI-native definition with the community/enterprise split and the cloud repository, "missing any one, it is not this application", definition-not-checklist with the checklist pointer, hotcrm, the two user kinds today and tomorrow, "every step of the road must hold for both". Faithful.
• 什么算做好 (L9) ↔ "What counts as done": checklist items pass in one run, objectstack verify green, unverified is not done. Faithful.
• 唯一的度量 (L11) ↔ "The one measure: the road": the six steps, the weekly walk and run record, first broken step is P0, runs-but-wrong is P2, the promise-to-step map. Two presentation choices, neither a rule shift: the ① to ⑥ numbering is lifted from the ladder's own headings (L15, L26, L77, L86, L98, L107), and "四个承诺各由一步兑现" becomes "Each promise is kept by a step", dropping the count "four" (the Chinese map itself lists five entries and the page's 账本 rule says it carries no numbers), so nothing a reader grades by is lost.
• 路上的功能点 (L13) ↔ "How to read the ladder" bullets 1 and 2: one feature per line under the road's steps, top-down is the order, the table is the roadmap and editing it changes priority, the row grammar, one feature is one strip, exactly-one-row membership, 「清单项待写」, the id prefix rule. Faithful.
• 优先级 items 1 and 2 (L114, L115) ↔ bullet 3: safety first and not waiting for the road; a broken road step or checklist capability P0/P1, runs-but-wrong P2, off-road and off-checklist p3 or not done; change the table, never re-grade card by card. Faithful. Items 3 and 4 and the four closing paragraphs are not summarised and the summary says so by name: inside the ruling's stated coverage, a declared gap rather than a silent one.
• The one sentence with no Chinese source is the preamble: "The Chinese text above is the original and is what governs; this summary ... adds nothing to them." It states the summary's own non-authority, which the ruling's "the Chinese original is not edited" implies and AGENTS.md Communication (引用中文裁决时保持原文) already requires; it adds no rule to the ladder. Holds.
• Chinese unedited: 0 removed lines against the merge base, +53 after a rule under 账本. Holds.
• No instrument parses the file: a sweep of every *.mjs, *.mts, *.ts, *.js, *.yml and *.json on the head finds docs/NORTH-STAR.md only as a governed-register row, a CODEOWNERS line and prose pointers, so the · row grammar quoted in the summary cannot be misread as a ladder row by any gate. Holds.

AGENTS.md L7 and Prime Directive 8, against ruling item 2 and the cited files.

• L7 now reads "docs/NORTH-STAR.md, the North Star, outranks it; content/docs/concepts/architecture-overview.mdx = architecture." The hierarchy the ruling requires is NORTH-STAR above AGENTS.md above every other instruction file, with one referent for the word. The line states all three (the file, the name, "outranks it" right after "AGENTS.md wins"), and the mdx is named only as architecture, under its new name, which exists on the head. The dropped parenthetical "(先做什么: goals, priority)" said what the North Star governs, not where it sits; on the same head that content is carried by PD8 ("its 路上的功能点 ladder, graded by its 优先级") and by the summary's section titles, and the pm-dispatch ladder (.claude/skills/pm-dispatch/SKILL.md:41, 维护者裁决 > 北极星 > AGENTS.md) now resolves 北极星 to one file. The byte reason is real (the ratchet's 120-byte cap; 1112 lines at a 1112 ceiling, zero headroom). Holds.
• PD8 "Read docs/NORTH-STAR.md before structural changes. If a change doesn't advance a row of its 路上的功能点 ladder, graded by its 优先级 — it probably shouldn't ship." Against the file: the ladder is L13 to L111 and 优先级 is L113 to L117, so both referents exist, and the old "§7 Built / Drift / Missing" (sections the renamed page no longer carries) is gone. The hedge "probably" keeps 优先级 item 1 (safety, not waiting for the road) and 仪器为车队服务 (fleet instruments graded by the decision they change) from reading as off-ladder refusals. Holds.
• Prime Directive 14's register paragraph and the GOVERNED_SURFACES row for docs/NORTH-STAR.md are untouched; check:pm-governed-prose green. Holds.

Findings

• must-fix: the head's Check Documentation Links run is red because of this PR. The rename leaves CHANGELOG.md:1033 (content/docs/concepts/north-star.mdx) and content/docs/releases/v17/17-6.mdx:1482 (/docs/concepts/north-star) pointing at a file that no longer exists, and lychee does not read apps/docs/redirects.mjs. Land with that lane green on the head: fix the root CHANGELOG.md link in this PR (historical, not in the release-owned table); for the release-owned 17-6.mdx, either the dedicated docs-only amendment the Documentation Guardrails row names, sequenced so this head does not land red, or one .lycheeignore entry (ungoverned) naming that route. ⛔ Not "the redirect covers it": the check-run on this head has already refuted that.
• should-fix: file one card (Prime Directive 10: a dangling citation in a published README is a trap an author hits) for the seven plain-text citations of the removed content/docs/concepts/north-star.mdx: packages/formula/README.md:9 (ships in the tarball), packages/formula/src/index.ts:8, packages/spec/src/shared/expression.zod.ts:59, packages/spec/src/system/environment-artifact.zod.ts:46, packages/spec/src/data/hook-body.zod.ts:256, and the two generated pages content/docs/references/shared/expression.mdx:55 and content/docs/references/system/environment-artifact.mdx:45. They were stale before (the sections they cite never existed on the page) and this PR makes the path dangling as well; "carrier: none" is the wrong carrier.

Implemented-by: claude/issue-26073-north-star-one-referent
Reviewed-by: session_01QSeKYmTYfaPbLQD4BJfomW

VERDICT: FAIL

---

Generated by Claude Code

[objectstack-fleet]

Contract review

Served-tier: CONTRACT_REVIEW_TIER
Head-sha: 68ec6ba9be6dc951eadde84ce5a015cfca93375c
Local-runs: none
Scope: AGENTS.md, docs/NORTH-STAR.md + content/docs/concepts/architecture-overview.mdx, apps/docs/redirects.mjs, CHANGELOG.md, content/docs/releases/v17/17-6.mdx, .github/workflows/check-links.yml

Delta review of the record 6456495604 (FAIL on 43cb2c7e83): judged here is the delta 43cb2c7e83..68ec6ba9be and the head's check-runs; the full ①–④ reading of the hits files in that record stands for every line this head keeps byte-identical, and is not restated.

① Derived judgments

• The head is one merge commit, "Merge branch 'main' into claude/issue-26073-north-star-one-referent", parents 43cb2c7e83 (the reviewed head) and a8ee8a229a (main). The PR's file list is unchanged: the same 11 paths, +75/−46. Right.
• Hits files: the PR's own delta on AGENTS.md and docs/NORTH-STAR.md against its main parent is byte-identical to the delta reviewed on 43cb2c7e83 (both patches compared with index lines stripped), and main itself (912076f8..a8ee8a229a) changed neither file, so the merge brings no change to either beyond main's own, which is none. AGENTS.md is still 1112 lines at the 1112 ceiling, L7 still 116 bytes; docs/NORTH-STAR.md still has 0 removed lines against the main parent and the same +53. Right.
• The must-fix of 6456495604 was discharged on main, outside this PR: e79be7db59 (PR docs(releases): point two release-owned north-star links at the published URL #26992, sub-issue docs(releases): two release-owned links name the renamed concepts/north-star.mdx by file path — CHANGELOG.md L1033 and releases/v17/17-6.mdx L1482 — so PR #26970 reds Check Documentation Links (sub-issue of #26073) #26975) points CHANGELOG.md:1033 and content/docs/releases/v17/17-6.mdx:1482 at https://objectstack.ai/docs/concepts/north-star. Read on this head: both lines carry that URL. An external URL is EXCLUDED by the offline lychee lane (check-links.yml), so the two "File not found" errors that reddened 43cb2c7e83 cannot recur, and the URL itself is served by this PR's own apps/docs/redirects.mjs entry (/docs/concepts/north-star → /docs/concepts/architecture-overview, permanent) once this lands — the two halves are consistent: a release-owned page keeps a stable public URL, the redirect keeps it answering. Right.
• The should-fix of 6456495604 (seven plain-text citations of the removed north-star.mdx) is filed as 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. Carried, not re-judged.
• Check-runs on this head, read after every one completed: 45 runs, 32 success, 13 skipped (the UI set and the opt-in harnesses, by paths), 0 failure, 0 in progress. Check Documentation Links success — the lane that was red on 43cb2c7e83 is green on the head that carries e79be7db59. Every required context that ran is green: Governed Surface Queue Guard, the Lint · lanes (PM dispatch-gates, docs & code guards, repo & tooling gates, CI, release & engine gates, ESLint, the scoped lanes), the Type Check · lanes, Test Core (all eight shards), Build Docs. Right.
• The PR is no longer a draft. That flip was not this seat's and is not judged here; it changes nothing about the landing: AGENTS.md and docs/NORTH-STAR.md are Tier H rows, so this PR lands only on an authorized APPROVED review by a GOVERNED_APPROVERS account. This record is the contract-tier review of record and no landing authority.

② Semver level

Unchanged by the delta: skip-changeset right (root and apps/docs private; nothing published moves), Clause-②: no, Metadata-protocol: none; the Check Changeset lane is skipped on this merge head by its paths filter, and its success on 43cb2c7e83 covers the same 11-path diff.

③ Boundary flags

No new dev flag on this head: the merge carries no PR content change, no new deviation, no open_questions. The two out-of-scope findings of the report keep the dispositions in 6456495604, the second now closed by e79be7db59 and the first carried by #26973.

④ Design judgment

Both hits files are byte-identical to the reviewed head on every line this PR touches, and the code they cite on this head still holds what the earlier record checked: content/docs/concepts/architecture-overview.mdx exists under that name, the redirects entry is present, Prime Directive 14's register paragraph is untouched. The findings on 43cb2c7e83 were one must-fix (discharged on main, verified line by line above) and one should-fix (filed as #26973). No new finding.

Implemented-by: claude/issue-26073-north-star-one-referent
Reviewed-by: session_01QSeKYmTYfaPbLQD4BJfomW

VERDICT: PASS

---

Generated by Claude Code

[objectstack-fleet]

席位核对 — ACCEPT · domain:devx#2 · head 68ec6ba9be · 2026-10-28T01:27Z

维护者速读

• 改了什么：两份都叫「北极星」的文档收成一个。content/docs/concepts/north-star.mdx 改名为 architecture-overview（去掉会过时的 Built / Drift 两节，旧网址自动跳转）。AGENTS.md 第 7 行与第 8 条、ROADMAP、CONTRIBUTING、README 一律指向 docs/NORTH-STAR.md，并在它的中文原文之后加一节英文摘要（中文一字未改）。
• 为什么改：你裁的 A′（6417934431）。原来四处指向互相矛盾，新贡献者和席位读「先读北极星」有一半概率打开错的那份；英文读者也读不了最高优先级的文档。
• 风险与回滚：只改文档与指针，不发布任何包；回滚即 revert 本 PR。AGENTS.md 第 7 行为守 120 字节行宽，删掉了「(先做什么: goals, priority)」括注，层级本身不变（契约复核已判）。
• 先看：AGENTS.md 第 7 行与第 8 条，docs/NORTH-STAR.md 末尾的 English summary。
• 两分钟验证：打开 objectstack.ai/docs/concepts/north-star，应跳到 architecture-overview；grep -n NORTH-STAR AGENTS.md ROADMAP.md CONTRIBUTING.md 都指向同一份。
• 需要你做的：无。os-zhuang 已批准，本记录后席位重新挂 auto-merge。

席位意见：合入。达档契约复核：首轮 FAIL（6456495604），唯一的 must-fix 是链接检查。那两处历史链接已由专用 PR #26992 修好；本 PR 合入 main 后，增量复核 PASS（6458178489）。should-fix 已立卡 #26973。

Shape: ready (os-zhuang), → main. Fixes #26073. 11 files, +75/−46. Tier H (AGENTS.md, docs/NORTH-STAR.md). Assignee os-justin, label skip-changeset.

Approval: os-zhuang APPROVED (review 5675963512), an account in GOVERNED_APPROVERS. The repo's approval reading does not pin commit_id, so the approval stands across the main merge.

Seat's own read (prose surfaces at TIER_DEFAULT, checked line by line against the diff):

• content/docs/concepts/metadata-lifecycle.mdx L174 and content/docs/data-modeling/formulas.mdx (two links) now point at the new slug.
• README.md L270 now links ./docs/NORTH-STAR.md.
• ROADMAP.md:4 and CONTRIBUTING.md:114 name docs/NORTH-STAR.md.
• concepts/meta.json lists architecture-overview.
• apps/docs/redirects.mjs gains /docs/concepts/north-star → /docs/concepts/architecture-overview.
• The architecture page keeps Principles / Runtime Shape / Environment Artifact / Request Resolution / Non-Goals and drops Built / Drift, as ruled.

Gates: at head 68ec6ba9be, 45 check-runs: 32 success, 13 skipped, 0 failure. Success includes Lint & Repo Gates, TypeScript Type Check, Check Documentation Links, Governed Surface Queue Guard, and Test Core 8/8. All 13 skips are in the set check-expected-skips passed on #26962 / #26992. The dev's local union is 69 derived, 69 run, all exit 0.

Accepted deviation: AGENTS.md L7 drops its parenthetical to stay at 116 of 120 bytes. The contract review judged that the line still states the ruled hierarchy.

Out of scope:

• the stale north-star.mdx citations in shipped packages/spec / packages/formula → filed 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;
• the two release-history links → landed by docs(releases): point two release-owned north-star links at the published URL #26992 (docs(releases): two release-owned links name the renamed concepts/north-star.mdx by file path — CHANGELOG.md L1033 and releases/v17/17-6.mdx L1482 — so PR #26970 reds Check Documentation Links (sub-issue of #26073) #26975).

Landing: auto-merge is re-armed by the seat now. The approval is on record, so the seat lands it. Cross-lane note: 6457453183 on #26073. On merge, #26073 closes by Fixes.

---

Generated by Claude Code