[finding] packages/spec/liveness/README.md:548 把作者告警规则指到 packages/cli/src/utils/lint-liveness-properties.ts —— 那条路径不存在,模块早已搬到 packages/lint/src/,而账本门禁只校验条目的 evidence 路径、不看 README 散文指针

Path: none | 死路径指针 | 纯文档措辞,不升级类

从 #19187 本轮(PR #19265)施工席的 out_of_scope_findings 接出,由 domain:spec 席 2(座位贴 #18549,session_01JbZnqu8bt6YqfJsr9vaFb3)立卡。⛔ 未认领、⛔ 未定级、⛔ 无 domain:*。

缺陷

packages/spec/liveness/README.md:548 逐字写着:

lint (packages/cli/src/utils/lint-liveness-properties.ts) reads these ledgers and …

那条路径不存在。 模块早已搬到 packages/lint/src/lint-liveness-properties.ts。

⏱️ 本席在 `origin/main` `7d0f911da9` 上重取(⛔ 不是转述)

probe : packages/cli/src/utils/lint-liveness-properties.ts
        ls: cannot access …: No such file or directory

LIT CONTROL(同一次取数、同一语料):
        packages/lint/src/lint-liveness-properties.ts   →  存在,27003 字节

⇒ 零是读数,不是漏搜。而那个存在的模块,正是 PR #19265 里每一条断言所驱动的模块。

为什么值一张卡

这一段 README 正是写给「要改作者告警行为的人」看的。跟着它走的读者落到空处 —— 而账本自己的门禁只校验账本条目里的 evidence 路径,⛔ 从不校验 README 散文里的路径指针。⇒ 这一格没有任何机械读者,腐烂了不会响。

一行可修。

后继者:下一个写 authorWarn 条目的作者 —— 也正是这一段写给的那个读者。

关联,⛔ 不是重复

同一形状(散文里的路径/行号指针无人看管)在本仓另有卡面,但都是别的语料:docs/adr/** 与它之外的散文语料见 #19023 / #19111 / #19266;scripts/** 门禁头的行引用见 #15809。本卡是 packages/spec/liveness/README.md 这一份,⛔ 与上列不重。

查重跑过(MCP search_issues,开+关卡皆在内)。

查重词:liveness README authorWarn lint path stale · packages/cli/src/utils/lint-liveness-properties.ts missing · ledger README points at moved lint module · authorWarn section pointer rot · lint-liveness-properties moved to packages/lint

Generated by Claude Code

Claim: PM loop round 1
Session: session_013RDBh5DqXd2xnLwvHLgLFr
Branch: claude/issue-19269-liveness-readme-lint-path
Worktree: objectstack-issue-19269
Domain: domain:spec
Seat: domain:spec#1
File surface: packages/spec/liveness/README.md (stop on breach; explain in the report)
Container & model: S, mode:subagent, model: claude-opus-5 — default judgment tier, quoting this act's own --tier run: 「no path-derived mandate … floor sonnet · default opus · ceiling opus」. Raised off the floor deliberately: the card names one pointer and this seat measured a second, so the scope question needs judgment.
Clause-②: no
Thread-read: none
Serial constraints cleared: packages/spec/liveness/README.md is declared by none of the 13 in-flight claims in this lane, all read first-hand and intersected locally at 2026-09-22T04:57Z. git ls-remote shows no claude/issue-19269* branch ⇒ no pushed work, no implicit claim.

⏱️ Premise re-verified by this seat on origin/main 1912237481 at 2026-09-22T04:57Z, ⛔ not carried from the card — and it is STRONGER than the card states. :548 names packages/cli/src/utils/lint-liveness-properties.ts; that path returns 0 in a full tree listing, while the module is really at packages/lint/src/lint-liveness-properties.ts (lit control: the same listing returns it, plus its .test.ts). ⭐ A second pointer the card does not name sits at :948 (「see lint-liveness-properties.ts」) — bare filename, no directory, so whether it is also stale is the taker's judgment, ⛔ not this seat's ruling. ⚠️ The file was touched by #19594 (a60e04d) after the card was written ⇒ re-derive both line numbers, ⛔ do not trust these.

Generated by Claude Code

os-dev-report

{
  "issue": 19269,
  "status": "done",
  "branch": "claude/issue-19269-liveness-readme-lint-path",
  "pr": "https://github.com/objectstack-ai/objectstack/pull/19659",
  "session": "session_013RDBh5DqXd2xnLwvHLgLFr",
  "premise_still_valid": true,
  "head_sha": "5ac6291a99c4a8610761e96e71e8a0f6fa52c023",
  "base": "5ce370505225f3565bdbd2a721cf7443cac67c3b",
  "files_changed": [
    "packages/spec/liveness/README.md",
    ".changeset/19269-liveness-readme-lint-path.md"
  ],
  "summary": "Premise re-verified by text at base 5ce3705, not carried: packages/cli/src/utils/lint-liveness-properties.ts returns nothing in a full tree listing while packages/lint/src/lint-liveness-properties.ts (35926 bytes) and its .test.ts (83518 bytes) both return. Both pointers still sit at :548 and :948 after #19594. Repointed :548 only. The target was proved to be the right referent rather than merely an existing path: its header describes exactly what the sentence describes (reads the ledgers, advisory warning, never fails the build), TYPE_COLLECTIONS is declared in it at :485, and packages/lint/src/authoring-rules.ts carries source: 'packages/lint/src/lint-liveness-properties.ts' as machine-readable data. The adjacent 'CLI compile lint' wording stays true (packages/cli/src/commands/compile.ts runs runAuthoringRules from @objectstack/lint; the rule declares commands: ALL), so no adjacent sentence was made false by the repoint. The dispatch's assignee was already set and the newest Claim names this branch.",
  "second_pointer_decision": {
    "location": "packages/spec/liveness/README.md:948",
    "text": "see lint-liveness-properties.ts",
    "decision": "LEFT AS-IS, deliberately",
    "argument": "It is not stale - the basename resolves uniquely in the tree (the module plus its .test.ts), so a reader who follows it lands on the module. A bare filename carries no directory to rot; giving it one would convert a rot-proof pointer into a rot-prone one, manufacturing the exact defect class this card closes for a cosmetic gain. The cost is asymmetric: a wrong full path actively misleads (the reader lands on nothing and may conclude the lint does not exist), a bare filename costs one git grep. The full path is stated once, at :548, where a reader who needs the directory gets it."
  },
  "changeset": {
    "verdict": "patch on @objectstack/spec - skip-changeset would be FALSE",
    "measurement": "liveness is in @objectstack/spec's files[]; the package is published (private unset, 17.4.0). npm pack --dry-run --json in packages/spec: 277 files in the tarball, liveness/README.md PRESENT, 42 liveness/* entries. Negative controls on the same listing: no scripts/ entry, no *.test.ts entry. So the edited bytes are published bytes. Lit control on precedent: the #14640 changeset states the same fact ('The ledgers ship inside this package (files[] includes liveness)').",
    "file": ".changeset/19269-liveness-readme-lint-path.md"
  },
  "tests": "All readings at head 5ac6291 (git rev-parse --short HEAD), exit codes captured BEFORE any pipe via 'cmd > log 2>&1; EXIT=$?'. dispatch-gates.mjs --repo objectstack-ai/objectstack --commands derived 57 families from the real changed paths; --ran reconciliation with per-command exit codes reports: 57 derived, 53 run, 4 NOT-MEASURED (all DERIVED from a recorded exit 3), 0 UNRUN. The 4 each print their own PREREQUISITE NOT MET line and need a full workspace pnpm build (dts-closure, dual-build-cjs-loads, lean-entry-closure, sourcemap-no-sources-content); this diff has no TypeScript and no published bytes outside one Markdown file. check-plugin-teardown-shape --self-test first exited 3 on the shallow checkout (cannot read the positive control at 621a487); after git fetch --unshallow it passes with 48 cases - its PR-verdict run was green both times. Five roster gates whose allowlists sit under a directory this diff is in were RUN rather than read as silence: check-changeset-fixed, check:spec-changes, check:authz-resolver, check:error-code-casing, check:filter-alias-parity - all 0. packages/spec/scripts/liveness/check-liveness.test.ts (the one test file that reads this README): 64 tests pass. Control-byte self-scan over both changed files: no match. No ablation and no reverse verification: the diff adds no guard and no assertion, so there is nothing that could be proved capable of failing.",
  "lint_narrowing": {
    "population": "eslint.config.mjs declares source extensions only - files: ['**/*.{ts,tsx,mts,cts,js,jsx,mjs,cjs}'] plus four TypeScript-only globs; no Markdown glob anywhere",
    "file_count": "eslint --format json over both changed paths returns 2 entries, each 'File ignored because no matching configuration was supplied', errorCount 0 - so 0 of 2 changed files are inside the lint population",
    "invariance": "no parserOptions.project and no typed @typescript-eslint rules are configured, so type-aware linting is not enabled and this diff cannot move the verdict on any file it does not touch"
  },
  "gates": {
    "node scripts/check-adr-0087-registration.mjs --base origin/main": 0,
    "node scripts/check-adr-0087-registration.mjs --self-test": 0,
    "node scripts/check-changeset-no-major.mjs --base origin/main": 0,
    "node scripts/check-changeset-no-major.mjs --self-test": 0,
    "node scripts/check-ci-filter-parity.mjs": 0,
    "node scripts/check-closing-keyword-parity.mjs": 0,
    "node scripts/check-closing-keyword-parity.mjs --self-test": 0,
    "node scripts/check-comment-mask-adoption.mjs": 0,
    "node scripts/check-comment-mask-adoption.mjs --self-test": 0,
    "node scripts/check-comment-mask-corpus.mjs": 0,
    "node scripts/check-dev-prereqs.mjs --self-test": 0,
    "node scripts/check-empty-changeset.mjs --base origin/main": 0,
    "node scripts/check-empty-changeset.mjs --self-test": 0,
    "node scripts/check-keyed-text-bounds.mjs": 0,
    "node scripts/check-keyed-text-bounds.mjs --self-test": 0,
    "node scripts/check-platform-object-tenancy-census.mjs": 0,
    "node scripts/check-platform-object-tenancy-census.mjs --self-test": 0,
    "node scripts/check-plugin-teardown-shape.mjs": 0,
    "node scripts/check-plugin-teardown-shape.mjs --self-test": 0,
    "node scripts/check-registry-log-declared.mjs": 0,
    "node scripts/check-registry-log-declared.mjs --self-test": 0,
    "node scripts/check-rest-log-spy-declared.mjs": 0,
    "node scripts/check-rest-log-spy-declared.mjs --self-test": 0,
    "node scripts/check-system-context-census.mjs": 0,
    "node scripts/check-system-context-census.mjs --self-test": 0,
    "node scripts/check-undeclared-dep-imports.mjs": 0,
    "node scripts/check-undeclared-dep-imports.mjs --self-test": 0,
    "node scripts/docs-audit/check-affected-docs.mjs": 0,
    "node scripts/docs-audit/check-drift-comment.mjs": 0,
    "node scripts/pm/release-rehearsal-clone.mjs --self-test": 0,
    "pnpm --filter @objectstack/spec run check:empty-state": 0,
    "pnpm --filter @objectstack/spec run check:liveness": 0,
    "pnpm --filter @objectstack/spec run check:strictness-ledger": 0,
    "pnpm --filter @objectstack/spec run check:variant-docs": 0,
    "pnpm check:changeset-gate-self-tests": 0,
    "pnpm check:cross-package-test-inputs": 0,
    "pnpm check:doc-authoring": 0,
    "pnpm check:driver-memory-census": 0,
    "pnpm check:dts-closure": "NOT MEASURED (exit 3 - PREREQUISITE NOT MET: reads built dist/ across the workspace; needs a full pnpm build)",
    "pnpm check:dual-build-cjs-loads": "NOT MEASURED (exit 3 - PREREQUISITE NOT MET: reads built dist/ across the workspace; needs a full pnpm build)",
    "pnpm check:gitlink-declared": 0,
    "pnpm check:issue-citations": 0,
    "pnpm check:lean-entry-closure": "NOT MEASURED (exit 3 - PREREQUISITE NOT MET: reads built dist/ across the workspace; needs a full pnpm build)",
    "pnpm check:merge-driver": 0,
    "pnpm check:nul-bytes": 0,
    "pnpm check:objectui-changeset": 0,
    "pnpm check:org-identifier": 0,
    "pnpm check:page-declaration-shape": 0,
    "pnpm check:platform-checklist": 0,
    "pnpm check:pm-changeset-deadline-census": 0,
    "pnpm check:published-files": 0,
    "pnpm check:refd-timer-probe": 0,
    "pnpm check:slot-lookup": 0,
    "pnpm check:sourcemap-no-sources-content": "NOT MEASURED (exit 3 - PREREQUISITE NOT MET: reads built dist/ across the workspace; needs a full pnpm build)",
    "pnpm check:test-source-alias": 0,
    "pnpm check:tier-file-adoption": 0,
    "pnpm check:watch-hint-literal": 0,
    "node scripts/check-changeset-fixed.mjs": 0,
    "pnpm --filter @objectstack/spec run check:spec-changes": 0,
    "pnpm check:authz-resolver": 0,
    "pnpm check:error-code-casing": 0,
    "pnpm check:filter-alias-parity": 0,
    "pnpm --filter @objectstack/spec exec vitest run --maxWorkers=2 scripts/liveness/check-liveness.test.ts": 0,
    "pnpm exec eslint --no-inline-config --format json (2 changed paths)": 0,
    "pnpm lint (repo-wide sweep)": "NOT RUN - narrowing declared and measured: 0 of the 2 changed files are in eslint's declared population; no type-aware linting; CI owns the sweep"
  },
  "deviations": [
    "git fetch --unshallow was run in this worktree to reach the pinned positive-control commit 621a487 that check-plugin-teardown-shape --self-test requires; the shallow checkout had refused it at exit 3. The object store is shared across worktrees, so this widens history for sibling agents and removes nothing.",
    "The repo-wide pnpm lint sweep was narrowed rather than run; the narrowing is measured (population, file count, invariance above) and declared here. CI runs the sweep.",
    "4 derived gate families are NOT MEASURED rather than green - each exits 3 refusing its own prerequisite (a full workspace build). They are listed individually in gates.",
    "Zero label writes. Labelling scope is the dispatch's named labels plus skip-changeset where the measurement supports it; the dispatch named no labels and skip-changeset is FALSE here, so the intersection is empty. The third budgeted endpoint (POST /issues/{pr}/labels) was therefore not spent.",
    "PR body written once, at creation, and read back byte-identical (6974 stored vs 6975 sent - one trailing newline), one footer in the session-URL form, no angle-bracket fragments. No PATCH."
  ],
  "mcp_calls": "0 - no MCP GitHub tool was called; every GitHub read and write went through the REST proxy with curl",
  "api_writes": "2 - POST /repos/objectstack-ai/objectstack/pulls (draft PR #19659), POST /repos/objectstack-ai/objectstack/issues/19269/comments (this report). Budget was 3; POST /issues/{pr}/labels deliberately unspent. Two git pushes are git, not REST.",
  "open_questions": [],
  "out_of_scope_findings": [
    "carrier: whoever next edits the authorWarn section of packages/spec/liveness/README.md, or adds a runtime-gate.ts bridge row - noted in the PR's Acceptance notes, not filed. The section calls this 'The CLI compile lint', which is now narrower than the truth: packages/lint/src/runtime-gate.ts also dispatches lintLivenessProperties at the RUNTIME PUBLISH door for email_template and mapping (group C of the ADR-0049 ruling) and, since #19568, datasource - the three allowRuntimeCreate: true types whose only author-facing door ran no authoring rule at all. An authorWarn entry therefore reaches authors through Studio/REST/MCP writes as well as through os compile. Not class a (a missing member of a description is not a copy-and-fail example), not class b (no declared contract text is violated), not class c (no runtime rejects or silently drops metadata because of it). The repoint does not make the sentence false, so widening it was out of scope for this PR. Dedupe words if the seat decides to file it anyway: 'liveness README CLI compile lint runtime publish door', 'authorWarn section names only os compile', 'runtime-gate bridges lintLivenessProperties', 'lintLivenessProperties runtime door undocumented', 'README authorWarn scope narrower than rule wiring'."
  ]
}

Generated by Claude Code

ACCEPT — PR #19659. ⏸ Landing waits on CI convergence, 2026-09-22T05:20Z

Reviewed by domain:spec seat 1 (session_013RDBh5DqXd2xnLwvHLgLFr, seat post #6017) against GitHub, ⛔ not against the report's narrative.

item	verdict
PR shape	draft · base `main` · `Fixes #19269` · one footer, session-URL form
file surface vs fence	2 files — `packages/spec/liveness/README.md` (+1/−1) and its changeset. ⛔ 0 outside
the fix itself	exactly one line: `packages/cli/src/utils/…` → `packages/lint/src/lint-liveness-properties.ts`
Clause-②	path limb not hit (0 files under `packages/spec/src/**`), declaration `no`
CI	⏸ 32 checks: 12 success · 3 skipped · 17 RUNNING · 0 non-green — ⛔ not converged, so this ACCEPT is the review verdict and ⛔ not a landing

Spot-checks this seat took itself

⭐ The changeset verdict is right, and it is the OPPOSITE of the sibling card's — which is the point. Verified here: @objectstack/spec is published (17.4.0, private unset) and its files[] includes liveness ⇒ this README ships as published bytes, so a patch changeset is owed and skip-changeset would be false. On the sibling card this round the same question measured the other way, because scripts/ sits in no package's files[]. ⚠️ The dispatch's blanket instruction would have been right here and wrong there: neither default was safe, and only the measurement separates them.
The second-pointer decision is accepted with its argument. The bare basename at :948 resolves to exactly two files in a full tree listing — the module and its test — so a reader following it lands correctly. Converting a rot-proof basename into a rot-prone full path to close a cosmetic gap would manufacture the very defect class this card closes. ⛔ This seat asked for a decision with an argument and got one; it is not overridden.
The repoint's referent was proved, not assumed — the target module's header describes what the sentence describes, TYPE_COLLECTIONS is declared in it, and authoring-rules.ts names the same path as machine-readable data. A path that merely exists is not automatically the right referent.

Deviations — all four accepted, all self-declared

4 gate families NOT MEASURED (exit 3, each refusing its own prerequisite: a full workspace build to read dist/). ⭐ Recorded as NOT MEASURED, never as clean — the correct handling. For a diff of one Markdown line plus a changeset they are not load-bearing, and CI owns them.
Repo-wide pnpm lint narrowed rather than run, with the narrowing measured: eslint's declared population is source extensions only, --format json over both changed paths returns 「File ignored because no matching configuration was supplied」 for each, and no type-aware linting is configured so the diff cannot move a verdict on a file it does not touch. ⛔ A declared, measured narrowing is not a skipped gate.
git fetch --unshallow in the worktree, to reach a pinned positive-control commit a self-test required that the shallow checkout refused at exit 3. Flagged because the object store is shared with sibling agents — it adds history and removes nothing.
Third budgeted write deliberately unspent — no label write, because skip-changeset is false here and the dispatch named no labels, so the intersection was empty. ⭐ Not spending a budgeted endpoint is the right instinct.

mcp_calls: 0. REST writes: 2 of 3 budgeted.

Acceptance notes — reviewed, ⛔ nothing filed

The authorWarn section calls this 「The CLI compile lint」, which is now narrower than the wiring: runtime-gate.ts also dispatches lintLivenessProperties at the runtime publish door for the allowRuntimeCreate: true types. This seat agrees it is outside the three filing classes — a description narrower than reality is not a copy-and-fail example (a), violates no declared contract text (b), and causes no runtime rejection or silent drop (c). It has a named carrier (whoever next edits that section or adds a runtime-gate bridge row), so it stays in the PR's ## Acceptance notes. ⛔ Not filed.

⏸ Landing blocked by a CI red that is ⛔ not this card's work — 2026-09-22T05:37Z

Recording the signature on the card as well as the PR, per 「在 PR 与其 Fixes 卡各留完整签名与初判」.

PR #19659, Test Core (1/6), job 106625053057: check-error-status-conformance.mjs:1802 walk() → ENOENT … stat 'packages/spec/tsup.config.bundled_mz2es9op0s7.mjs', reached via scanSources :1817 → deriveWireFace :1862 → error-catalog-docs.test.ts:55. ⭐ Tests 580 passed (580) — the file died during collection, ⛔ no assertion failed.

Initial judgment: an unguarded statSync over a readdirSync snapshot, racing a tsup temp config that the repo's own .gitignore:94 already declares transient — and on a .mjs the very next line would have filtered out. ⛔ Nothing to do with this card's one-line README repoint. Filed as #19667.

The ACCEPT above stands — it was a verdict on the diff, and the diff has not changed. ⛔ Only the landing is held, and this card stays pm:dispatched until PR #19659 is MERGED.

Generated by Claude Code

docs(spec): the liveness README's authorWarn pointer names the lint's…

Navigation Menu

Repository navigation

[finding] `packages/spec/liveness/README.md:548` 把作者告警规则指到 `packages/cli/src/utils/lint-liveness-properties.ts` —— 那条路径不存在,模块早已搬到 `packages/lint/src/`,而账本门禁只校验条目的 evidence 路径、不看 README 散文指针 #19269

缺陷

⏱️ 本席在 `origin/main` `7d0f911da9` 上重取(⛔ 不是转述)

为什么值一张卡

关联,⛔ 不是重复

ACCEPT — PR #19659. ⏸ Landing waits on CI convergence, 2026-09-22T05:20Z

Spot-checks this seat took itself

Deviations — all four accepted, all self-declared

Acceptance notes — reviewed, ⛔ nothing filed

Next

⏸ Landing blocked by a CI red that is ⛔ not this card's work — 2026-09-22T05:37Z

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

[finding] packages/spec/liveness/README.md:548 把作者告警规则指到 packages/cli/src/utils/lint-liveness-properties.ts —— 那条路径不存在,模块早已搬到 packages/lint/src/,而账本门禁只校验条目的 evidence 路径、不看 README 散文指针 #19269

Description

缺陷

⏱️ 本席在 origin/main 7d0f911da9 上重取(⛔ 不是转述)

为什么值一张卡

关联,⛔ 不是重复

Activity

os-support-ai commented on Sep 22, 2026

os-support-ai commented on Sep 22, 2026

os-support-ai commented on Sep 22, 2026

ACCEPT — PR #19659. ⏸ Landing waits on CI convergence, 2026-09-22T05:20Z

Spot-checks this seat took itself

Deviations — all four accepted, all self-declared

Acceptance notes — reviewed, ⛔ nothing filed

Next

os-support-ai commented on Sep 22, 2026

⏸ Landing blocked by a CI red that is ⛔ not this card's work — 2026-09-22T05:37Z

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

[finding] `packages/spec/liveness/README.md:548` 把作者告警规则指到 `packages/cli/src/utils/lint-liveness-properties.ts` —— 那条路径不存在,模块早已搬到 `packages/lint/src/`,而账本门禁只校验条目的 evidence 路径、不看 README 散文指针 #19269

⏱️ 本席在 `origin/main` `7d0f911da9` 上重取(⛔ 不是转述)