Skip to content

fix(spec): cross-repo liveness re-audit — 16 props dead→live (objectui authoring UI)#1956

Merged
os-zhuang merged 2 commits into
mainfrom
chore/liveness-crossrepo-reaudit
Jun 16, 2026
Merged

fix(spec): cross-repo liveness re-audit — 16 props dead→live (objectui authoring UI)#1956
os-zhuang merged 2 commits into
mainfrom
chore/liveness-crossrepo-reaudit

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Corrects the liveness ledgers + the dead-surface plan after finding the 2026-06 audits missed objectui's metadata-admin authoring UI (they only checked framework runtime + end-user renderers).

What

A cross-repo re-audit — reading the actual consumer code in both framework and ../objectui (not grep-guessing) — found 16 props the ledgers called dead are actually objectui-live, reclassified dead→live with verified evidence:

Type props objectui consumer (read)
tool category, requiresConfirmation, active, builtIn ToolPreview.tsx:99-103
action execute, shortcut, bulkEnabled, disabled ActionPreview.tsx:154-169
skill triggerPhrases, permissions SkillPreview.tsx:44,48
flow status, active, nodes.boundaryConfig FlowPreview.tsx:105, flow-node-config.ts:480
agent knowledge AgentPreview.tsx:69
role parent RolePreview.tsx:30
permission isProfile PermissionPreview.tsx:92

(Plus the 9 field props already fixed in #1947.) Each verified by opening the file and seeing the read.

Why it matters

Pruning these would have broken the authoring UI / detail rendering. The dead-surface plan (#1939) recommended pruning several — it's now flagged invalidated at the top; only ~42 props are confirmed dead in BOTH repos (the real prune candidates, dominated by 24 object-level props with NoExcessObjectKeys cross-package coupling).

Method note

The first attempt used a multi-agent workflow that went runaway (~633 agents vs 10 launched) — stopped and discarded. Automated grep proved unreliable here (false +/−). So this was done by directly reading the per-type metadata-admin preview/inspector files. The monthly re-audit cron was already updated to include ../objectui.

Gate green. Builds on #1947 (field). The merged prunes #1945/#1946 were re-verified against objectui — safe.

🤖 Generated with Claude Code

os-zhuang and others added 2 commits June 16, 2026 16:42
…ui authoring UI)

Cross-repo re-audit (reading the actual consumer code in framework AND objectui)
corrects 16 props the audit wrongly marked dead — they are LIVE via objectui's
metadata-admin authoring UI (which the 2026-06 audit never checked):

- agent.knowledge        objectui AgentPreview.tsx:69
- role.parent            objectui RolePreview.tsx:30
- permission.isProfile   objectui PermissionPreview.tsx:92
- flow.status, flow.active   objectui FlowPreview.tsx:105
- flow.nodes.boundaryConfig  objectui inspectors/flow-node-config.ts:480
- tool.category/requiresConfirmation/active/builtIn  objectui ToolPreview.tsx:99-103
- skill.triggerPhrases/permissions  objectui SkillPreview.tsx:44,48
- action.execute/shortcut/bulkEnabled/disabled  objectui ActionPreview.tsx:154-169

Each verified by opening the file and seeing the read (not a name match).
The remaining ~42 dead props are confirmed dead in BOTH repos (real prune
candidates; object-level dominates). Gate green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
… cross-repo correction

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 16, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
spec Ready Ready Preview, Comment Jun 16, 2026 8:46am

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation tooling size/l labels Jun 16, 2026
@github-actions

Copy link
Copy Markdown
Contributor

📓 Docs Drift Check

This PR changes 1 package(s): @objectstack/spec.

89 hand-written doc(s) reference the affected code and may need an implementation-accuracy re-verification:

  • content/docs/concepts/architecture.mdx (via @objectstack/spec)
  • content/docs/concepts/cloud-artifact-api.mdx (via packages/spec)
  • content/docs/concepts/cluster-semantics.mdx (via @objectstack/spec)
  • content/docs/concepts/design-principles.mdx (via packages/spec)
  • content/docs/concepts/implementation-status.mdx (via @objectstack/spec)
  • content/docs/concepts/index.mdx (via @objectstack/spec)
  • content/docs/concepts/metadata-driven.mdx (via @objectstack/spec)
  • content/docs/concepts/metadata-lifecycle.mdx (via packages/spec)
  • content/docs/concepts/north-star.mdx (via packages/spec)
  • content/docs/concepts/packages.mdx (via @objectstack/spec)
  • content/docs/concepts/setup-app.mdx (via @objectstack/spec)
  • content/docs/concepts/skills.mdx (via @objectstack/spec)
  • content/docs/concepts/webhook-delivery.mdx (via @objectstack/spec)
  • content/docs/getting-started/architecture.mdx (via @objectstack/spec)
  • content/docs/getting-started/cli.mdx (via @objectstack/spec)
  • content/docs/getting-started/core-concepts.mdx (via @objectstack/spec)
  • content/docs/getting-started/examples.mdx (via @objectstack/spec)
  • content/docs/getting-started/quick-start.mdx (via @objectstack/spec)
  • content/docs/guides/adding-a-metadata-type.mdx (via @objectstack/spec)
  • content/docs/guides/ai-capabilities.mdx (via @objectstack/spec)
  • content/docs/guides/airtable-dashboard-analysis.mdx (via @objectstack/spec)
  • content/docs/guides/analytics-datasets.mdx (via @objectstack/spec)
  • content/docs/guides/api-reference.mdx (via @objectstack/spec)
  • content/docs/guides/business-logic.mdx (via @objectstack/spec)
  • content/docs/guides/cheatsheets/backward-compatibility.mdx (via @objectstack/spec)
  • content/docs/guides/cheatsheets/error-catalog.mdx (via @objectstack/spec)
  • content/docs/guides/cheatsheets/field-type-gallery.mdx (via @objectstack/spec)
  • content/docs/guides/cheatsheets/field-validation-rules.mdx (via @objectstack/spec)
  • content/docs/guides/cheatsheets/permissions-matrix.mdx (via @objectstack/spec)
  • content/docs/guides/cheatsheets/protocol-diagram.mdx (via packages/spec)
  • content/docs/guides/cheatsheets/query-cheat-sheet.mdx (via @objectstack/spec)
  • content/docs/guides/cheatsheets/quick-reference.mdx (via @objectstack/spec)
  • content/docs/guides/client-sdk.mdx (via @objectstack/spec)
  • content/docs/guides/common-patterns.mdx (via @objectstack/spec)
  • content/docs/guides/contracts/auth-service.mdx (via packages/spec)
  • content/docs/guides/contracts/cache-service.mdx (via packages/spec)
  • content/docs/guides/contracts/data-engine.mdx (via @objectstack/spec)
  • content/docs/guides/contracts/index.mdx (via @objectstack/spec)
  • content/docs/guides/contracts/metadata-service.mdx (via packages/spec)
  • content/docs/guides/contracts/storage-service.mdx (via packages/spec)
  • content/docs/guides/data-modeling.mdx (via @objectstack/spec)
  • content/docs/guides/deployment-vercel.mdx (via @objectstack/spec)
  • content/docs/guides/driver-configuration.mdx (via @objectstack/spec)
  • content/docs/guides/error-handling-client.mdx (via @objectstack/spec)
  • content/docs/guides/error-handling-server.mdx (via @objectstack/spec)
  • content/docs/guides/formula.mdx (via @objectstack/spec)
  • content/docs/guides/hook-bodies.mdx (via packages/spec)
  • content/docs/guides/kernel-services.mdx (via @objectstack/spec)
  • content/docs/guides/metadata/dashboard.mdx (via @objectstack/spec)
  • content/docs/guides/metadata/field.mdx (via @objectstack/spec)
  • content/docs/guides/metadata/flow.mdx (via @objectstack/spec)
  • content/docs/guides/metadata/index.mdx (via @objectstack/spec)
  • content/docs/guides/metadata/object.mdx (via @objectstack/spec)
  • content/docs/guides/metadata/validation.mdx (via @objectstack/spec)
  • content/docs/guides/metadata/workflow.mdx (via @objectstack/spec)
  • content/docs/guides/packages.mdx (via @objectstack/spec)
  • content/docs/guides/plugin-development.mdx (via @objectstack/spec)
  • content/docs/guides/plugins.mdx (via @objectstack/spec)
  • content/docs/guides/project-scoping.mdx (via @objectstack/spec)
  • content/docs/guides/public-forms.mdx (via @objectstack/spec)
  • content/docs/guides/runtime-services/email-service.mdx (via packages/spec)
  • content/docs/guides/runtime-services/index.mdx (via packages/spec)
  • content/docs/guides/runtime-services/queue-service.mdx (via packages/spec)
  • content/docs/guides/runtime-services/sharing-service.mdx (via packages/spec)
  • content/docs/guides/runtime-services/storage-service.mdx (via packages/spec)
  • content/docs/guides/security.mdx (via @objectstack/spec)
  • content/docs/guides/seed-data.mdx (via @objectstack/spec)
  • content/docs/guides/skills.mdx (via @objectstack/spec)
  • content/docs/guides/standards.mdx (via @objectstack/spec)
  • content/docs/guides/troubleshooting.mdx (via @objectstack/spec)
  • content/docs/protocol/knowledge.mdx (via @objectstack/spec)
  • content/docs/protocol/objectos/config-resolution.mdx (via @objectstack/spec)
  • content/docs/protocol/objectos/i18n-standard.mdx (via @objectstack/spec)
  • content/docs/protocol/objectos/lifecycle.mdx (via @objectstack/spec)
  • content/docs/protocol/objectos/plugin-spec.mdx (via @objectstack/spec)
  • content/docs/protocol/objectos/runtime-capabilities.mdx (via @objectstack/spec)
  • content/docs/protocol/objectql/index.mdx (via packages/spec)
  • content/docs/protocol/objectql/query-syntax.mdx (via @objectstack/spec)
  • content/docs/protocol/objectql/schema.mdx (via @objectstack/spec)
  • content/docs/protocol/objectql/security.mdx (via packages/spec)
  • content/docs/protocol/objectql/state-machine.mdx (via @objectstack/spec)
  • content/docs/protocol/objectui/actions.mdx (via @objectstack/spec)
  • content/docs/protocol/objectui/concept.mdx (via @objectstack/spec)
  • content/docs/protocol/objectui/index.mdx (via @objectstack/spec)
  • content/docs/protocol/objectui/layout-dsl.mdx (via packages/spec)
  • content/docs/protocol/objectui/record-alert.mdx (via @objectstack/spec)
  • content/docs/protocol/objectui/widget-contract.mdx (via @objectstack/spec)
  • content/docs/releases/index.mdx (via @objectstack/spec)
  • content/docs/releases/v9.mdx (via @objectstack/spec)

Advisory only. To re-verify, run the docs-accuracy-audit workflow scoped to these files:
node scripts/docs-audit/affected-docs.mjs origin/main → pass the list as args.docs.

@os-zhuang
os-zhuang merged commit f0acd0c into main Jun 16, 2026
15 checks passed
@os-zhuang
os-zhuang deleted the chore/liveness-crossrepo-reaudit branch June 16, 2026 09:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/l tooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant