Skip to content

Commit 73d45a5

Browse files
docs(audits): archive the four unreferenced 2026-06 audits (minimum arm) (#26925)
<!-- claude-projects-attribution: {"github_login":"os-warren"} --> _Requested by **Warren** · [project thread](https://claude.ai/code/project/chan_01U5RdnAAmkSQmZbqh6FtqZ8?thread=cmsg_01U5RdnAAmkSQmZbqh6FtqZ8P78FdM2BxrU7649uyj3tXo)_ Refs #26257 — **minimum arm** (triage 6431037536, claim 6454039459). The card stays open: the **fuller arm** (the 14 `packages/spec`-cited 2026-06 files, their `liveness/*.json` `_note` paths and zod comments, a spec patch changeset and regenerated references) still needs a `domain:spec` review, and the 6 ADR-cited files stay in place under either arm. Clause-②: no Metadata-protocol: none ## 维护者速读 - 改了什么:把 4 份已无任何入链的 2026-06 审计文档用 `git mv` 移入 `docs/audits/archive/2026-06/`,并改好 README 索引三行与一份文档里的三个 ADR 相对链接。 - 为什么改:落实 #26075 裁决 A 的「已关闭审计归档」一半中的最小臂;只动无人引用的文件,零发布面。 - 风险与回滚:仅 docs,不发布;回滚即 revert 本 PR。无 ADR、无 `packages/spec` 改动,无删除。 - 先看:`docs/audits/README.md`(三行索引路径),`docs/audits/archive/2026-06/2026-06-ask-build-agent-development-assessment.md`(ADR 链接改为 `../../../adr/`)。 - 两分钟验证:`git grep -nE "2026-06-(ask-build-agent-development-assessment|datasetschema-property-liveness|pageschema-property-liveness|system-integration-property-liveness)" | grep -v archive/2026-06/` 预期零输出。 - 需要你做的:无,席位落地。 ## What changes - `git mv` (pure renames, 100% similarity for three) of `docs/audits/2026-06-{ask-build-agent-development-assessment,datasetschema-property-liveness,pageschema-property-liveness,system-integration-property-liveness}.md` into `docs/audits/archive/2026-06/`. - `docs/audits/README.md`: the three per-type index rows (page, dataset, system/integration) now name `archive/2026-06/…`. The README's existing lifecycle line already says closed audits move to `docs/audits/archive/`, so no new prose. - `archive/2026-06/2026-06-ask-build-agent-development-assessment.md`: its three relative ADR links (ADR-0040, 0063, 0064; five occurrences) are re-rooted from `../adr/` to `../../../adr/` so they still resolve from the deeper directory. Content otherwise unchanged. ## Tests Docs-only move; no code or tests touched. ## Acceptance notes - Re-measured on `origin/main` 5ce3404 before moving: the four bare filenames had no inbound reference anywhere in the tree except README rows L16, L19 and L28; `ask-build-agent-development-assessment` had none at all. Matches the claim's premise. - Not done here (out of the minimum arm): the 14 spec-cited and 6 ADR-cited 2026-06 files stay in `docs/audits/`. ## Verification <details><summary>Local gates on 907b582</summary> ``` pnpm check:doc-authoring :: exit 0 (439 files clean; 69 skill files clean; spec strings clean) pnpm check:adr-links :: exit 0 (907 relative link destinations under docs/adr/ resolve) relative-link resolver over docs/audits/README.md + docs/audits/archive/2026-06/*.md :: 9 links checked, 0 dead git grep for the four old paths outside archive/2026-06/ :: 0 hits ``` The lychee `Check Documentation Links` lane was not run locally (the binary download was refused in this container); CI runs it over `docs/**/*.md`. </details> ## Human Minimum - [x] 1. Schemas start as Zod; `packages/spec` holds no runtime logic. (not touched) - [x] 2. Every name I added uses the casing for its kind. - [x] 3. No formatter ran; `pnpm lint` not run locally (markdown-only diff), CI runs it. - [x] 4. One issue, one branch off an up-to-date `main`, one pull request. - [x] 5. A change that publishes carries a changeset — nothing publishes (`docs/**` is in no package's `files[]`), so `skip-changeset`. - [x] 6. `packages/spec` touched: n/a. - [x] 7. No hand edits to `content/docs/references/`, `packages/*/CHANGELOG.md` or `content/docs/releases/`. - [x] 8. Title, body and comments are in English (the 维护者速读 block is the os-dev contract's Chinese digest). 🤖 Generated with [Claude Code](https://claude.com/claude-code) --- _Generated by [Claude Code](https://claude.ai/code/session_01JQwxbZzDBLnRBSB3n3b113)_ Co-authored-by: Claude <noreply@anthropic.com>
1 parent 95aa781 commit 73d45a5

5 files changed

Lines changed: 6 additions & 6 deletions

‎docs/audits/README.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,10 +13,10 @@ Liveness is judged by **code consumption**, not browser observation (an unreacti
1313
| object | `2026-06-objectschema-property-liveness.md` | ~half dead |
1414
| view | `2026-06-viewschema-property-liveness.md` | list-family healthy; chart/form-variants broken |
1515
| app | `2026-06-appschema-property-liveness.md` | nav core healthy; aspirational tail |
16-
| page | `2026-06-pageschema-property-liveness.md` | drift breaks layouts |
16+
| page | `archive/2026-06/2026-06-pageschema-property-liveness.md` | drift breaks layouts |
1717
| dashboard | `2026-06-dashboardschema-property-liveness.md` | ADR-0021 half-done |
1818
| report | `2026-06-reportschema-property-liveness.md` | dataset live; chart dead |
19-
| dataset | `2026-06-datasetschema-property-liveness.md` | live; Studio under-covers |
19+
| dataset | `archive/2026-06/2026-06-datasetschema-property-liveness.md` | live; Studio under-covers |
2020
| action | `2026-06-actionschema-property-liveness.md` | disabled-CEL ignored; form/shortcut dead |
2121
| flow | `2026-06-flowschema-property-liveness.md` | enum out of sync; runAs unenforced |
2222
| agent | `2026-06-agentschema-property-liveness.md` | autonomy + access-control aspirational |
@@ -25,7 +25,7 @@ Liveness is judged by **code consumption**, not browser observation (an unreacti
2525
| hook | `2026-06-hookschema-property-liveness.md` | **healthy** (near-total) |
2626
| validation | `2026-06-validationschema-property-liveness.md` | **healthy** (all 6 types enforced) |
2727
| security/identity (role, permission, policy, sharing) | `2026-06-security-identity-property-liveness.md` | **policy 100% dead** |
28-
| system/integration (email/i18n/theme/job/webhook/portal) | `2026-06-system-integration-property-liveness.md` | email + portal dead |
28+
| system/integration (email/i18n/theme/job/webhook/portal) | `archive/2026-06/2026-06-system-integration-property-liveness.md` | email + portal dead |
2929

3030
## Cross-cutting patterns (in priority order)
3131

docs/audits/2026-06-ask-build-agent-development-assessment.md renamed to docs/audits/archive/2026-06/2026-06-ask-build-agent-development-assessment.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
**Type**: development assessment / landscape (NOT an ADR — this routes work, it does not decide).
44
**Scope**: every code touchpoint for the two kernel agents across `@objectstack/service-ai` (OSS `ask`), `@objectstack/service-ai-studio` (cloud `build`), `@objectstack/spec` (agent/skill/tool schemas), and `../objectui` (chat surface).
5-
**Frames**: [ADR-0040](../adr/0040-unified-assistant-and-agent-binding.md), [ADR-0063](../adr/0063-two-kernel-agents-skills-are-the-extension-primitive.md), [ADR-0064](../adr/0064-tool-scoping-to-agent.md).
5+
**Frames**: [ADR-0040](../../../adr/0040-unified-assistant-and-agent-binding.md), [ADR-0063](../../../adr/0063-two-kernel-agents-skills-are-the-extension-primitive.md), [ADR-0064](../../../adr/0064-tool-scoping-to-agent.md).
66
**Method**: four parallel read-only inventories. File:line references below are accurate as of this worktree.
77

88
> **Outcome (see §5):** D2 resolved to **two distinct agents bound by surface**; ADR-0040's unified-assistant core is reversed.
@@ -101,7 +101,7 @@ D2 resolved **against** the "one assistant, two tiers" option §4 floated. Ratio
101101

102102
**Resolution: two distinct agents (`ask` / `build`), bound by surface.** ADR-0040's unified-assistant core is reversed; "user never picks a roster" is kept but re-grounded as *surface binding*. See:
103103

104-
- **[ADR-0063](../adr/0063-two-kernel-agents-skills-are-the-extension-primitive.md)** (revised) — two agents bound by surface; skills-only third-party extension; `surface` affinity; naming; supersedes ADR-0040 core + §3.
105-
- **[ADR-0064](../adr/0064-tool-scoping-to-agent.md)** — tool scoping: an agent's tools = its skills' tools (resolves ADR-0040 §4).
104+
- **[ADR-0063](../../../adr/0063-two-kernel-agents-skills-are-the-extension-primitive.md)** (revised) — two agents bound by surface; skills-only third-party extension; `surface` affinity; naming; supersedes ADR-0040 core + §3.
105+
- **[ADR-0064](../../../adr/0064-tool-scoping-to-agent.md)** — tool scoping: an agent's tools = its skills' tools (resolves ADR-0040 §4).
106106

107107
Implementation (split personas, make `build` canonical, finish `ask` rename, withdraw tenant agents, `surface` field, surface-binding in objectui) is consolidated in the follow-up issue. D4 (guardrail floor) remains deferred.

docs/audits/2026-06-datasetschema-property-liveness.md renamed to docs/audits/archive/2026-06/2026-06-datasetschema-property-liveness.md

File renamed without changes.

docs/audits/2026-06-pageschema-property-liveness.md renamed to docs/audits/archive/2026-06/2026-06-pageschema-property-liveness.md

File renamed without changes.

docs/audits/2026-06-system-integration-property-liveness.md renamed to docs/audits/archive/2026-06/2026-06-system-integration-property-liveness.md

File renamed without changes.

0 commit comments

Comments
 (0)