Skip to content

feat(app-shell): the console dock binds its build thread to the current authorable app (objectui#10926) - #10950

Merged
objectstack-fleet[bot] merged 7 commits into
mainfrom
claude/issue-10926-dock-binds-app
Sep 28, 2026
Merged

objectstack-fleet[bot] merged 7 commits into
mainfrom
claude/issue-10926-dock-binds-app

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #10926
Clause-②: no

The console's assistant dock now binds its build thread to the current app, per the maintainer ruling 「绑定当前应用(推荐)」 (epic session, 2026-09-28). The ADR amendment that records the ruling is its own governed draft PR, #10947. This PR has code, tests and a changeset only.

What changed

  • layout/ChatDock.tsx, the dock's default body (ChatDockConversation):
    • When the resolved agent is build and the current app's package is authorable, the dock passes that package as editPackageId. That makes its scope chatConversationScope({ appId: PKG, product: 'build' }), which is app:PKG:build: the key the Studio copilot and /ai/build?package=PKG resolve.
    • "Authorable" is the A1.b switcher's own predicate, isPlatformBuiltinApp (the com.objectstack.* prefix). There is no second resolver.
    • ChatPane receives editPackageId, so the chip, the edit-mode empty state and context.packageId name the app.
    • ask, a built-in app and no app keep the product-only key.
    • The dock runs the same A1.b migration read the ?package= entry runs (legacyScope + adoptLegacy). Without it, a dock that resolves first would mint a fresh app:PKG:build thread, and the full page's adoption of a product-only thread bound to PKG could then never happen.
    • The pane receives only a scope-matched conversation, the same gate AiChatPage uses. Moving between apps now changes the scope while the dock stays mounted.
    • The panel and the mobile sheet pass the bound package to onMaximize.
  • layout/ConsoleLayout.tsx:
    • Hands the dock activeApp?._packageId (both presentations).
    • openDockFullPage(boundPackageId) navigates to /ai/build?package=PKG with the Studio door's one-shot opt-out (objectstack:ai-full-page-requested). Without the opt-out, a thread that built the app would bounce straight to Studio on arrival (objectui#5799).
    • With no bound package it navigates to /ai, unchanged.
  • console/ai/AiChatPage.tsx: the adopt predicate becomes the exported isThreadBoundToPackage(messages, packageId), so the full page and the dock share one predicate. adoptLegacyBuildThread calls it, and its behaviour is unchanged. No other region of the file is touched.
  • hooks/chatScope.ts: module doc only (names the dock as a third app:X:build surface).
  • .changeset/10926-dock-binds-build-thread-to-app.md: @object-ui/app-shell minor.

No new package-entry export and no new public prop. ChatDockPanel and ChatDockMobileSheet are not exported from the package entry; isThreadBoundToPackage is a module export of AiChatPage.tsx, like its neighbour deriveBoundPackageId. No locale key moves.

Deviation: one file outside the claim's declared surface

The claim's file surface did not list layout/ConsoleLayout.tsx. It came from the dispatch assumption that "editPackageId is read in chatScope.ts and layout/ChatDock.tsx". Measured on base af2221d, ChatDock.tsx never read editPackageId and passed appId: undefined. The current app (activeApp) and the maximize navigation (openDockFullPage) live only in ConsoleLayout.tsx. The ruling cannot be delivered without touching that file, short of a second current-app resolver, which the dispatch ruled out.

What was touched there: two appPackageId prop lines and the maximize target. PR #10924 (landed) changed a different hunk of the same file, the FAB line. main was merged twice (7e8b3c0, then 5c94589), both cleanly.

Tests (head 8d4efd6)

New layout/__tests__/ChatDock.appBinding-10926.test.tsx renders the real dock body, the real ChatPane, the real useChatConversation and, for the sharing pin, the real AiChatPage, over a fetch stub. It has 11 tests:

  • The chip and the empty state read the app label, and context.packageId is the app's package.
  • The key is app:app.crm:build, and the product-only key stays empty.
  • The dock and /ai/build?package=X settle on the same conversation id.
  • A thread already keyed by another app:X:build surface is resumed.
  • ask stays ambient.
  • A com.objectstack.* app and no app keep build.
  • A product-only thread bound to X is adopted, and its key is left in place. One bound elsewhere is not adopted.
  • Switching apps never pairs the old thread with the new package.
  • Both maximize paths carry the bound package.

New layout/__tests__/ConsoleLayout.dockBinding-10926.test.tsx has 3 tests: the package reaches the rail and the sheet, a bound maximize goes to /ai/build?package=app.crm with the opt-out, and an unbound maximize goes to /ai with no opt-out.

Runs, from the repo root through the shared verify lock:

  • pnpm exec vitest run --maxWorkers=2 over layout/__tests__/, console/ai/__tests__/, console/__tests__/, views/studio-design/__tests__/, chrome/, hooks/__tests__/{chatScope,useChatConversation,surfaceAgent} and two src/__tests__ pins: Test Files 102 passed (102), Tests 750 passed (750), exit 0.
  • pnpm --filter @object-ui/app-shell type-check (tsc --noEmit && tsc -p tsconfig.test.json): exit 0. Both new test files are in the test program (--listFilesOnly).
  • The dependency closure was built first (turbo run build --filter=@object-ui/app-shell^...): 28/28 successful.

Not run locally: the full 844-file app-shell suite. CI runs it.

Ablations. Each was committed first, then mutated through ablation-replace.mjs with the counts expected before running. After each, the restore was proven: blob equals HEAD and git diff HEAD is empty. No dist is involved, because the subjects are imported by relative path.

  1. Binding disabled (anchor product === 'build' && appPackageId → product === 'ablated' && appPackageId): expected 8 failed / 3 passed, observed 8 failed / 3 passed. The ask, built-in and no-app cases stay green. A first attempt was refused by the tool because the replacement contained the anchor, so nothing ran.
  2. Scope-match gate removed (const scopeMatched = conversationScope === scope; → const scopeMatched = true;): expected 1 failed / 10 passed, observed 1 failed / 10 passed (the app-switch pin).
  3. Bound maximize branch removed in ConsoleLayout (if (!boundPackageId) { → if (boundPackageId === boundPackageId) {): expected 1 failed / 2 passed, observed 1 failed / 2 passed.

Gates (head 8d4efd6, exit codes)

  • node scripts/check-changeset-presence.mjs: 0
  • node scripts/check-changeset-no-major.mjs: 0
  • node scripts/check-governed-queue-guard.mjs --test over the 7 changed paths: 0, NOT GOVERNED
  • check:new-line-citations: 0
  • check:control-bytes: 0
  • check:vi-mock-specifiers, check:vi-mock-inherit, check:vi-mock-override-shape: 0 each
  • check:changeset-claims, check:pending-changeset-literals: 0 each
  • check:i18n-keys, check:test-path-roots, check:unreferenced-sources, check:self-import, check:phantom-deps: 0 each
  • eslint --no-inline-config on the 6 changed TS/TSX files: exit 0, 0 errors. This narrowing is a measurement, not a skip:
    • The population is eslint.config.js's **/*.{ts,tsx} block.
    • The file count comes from --format json: 6.
    • No parserOptions.project or projectService is configured, and the repo's one custom rule reads no files. So the diff cannot move the verdict of an untouched file.
    • Against the base versions of the same files (fed through --stdin-filename), the diff adds one react-refresh/only-export-components warning, for the new exported predicate. The file already has 12 of that class, and there is no warning ratchet.

Acceptance notes

  • sys_metadata. The ruling's authorable test is isPlatformBuiltinApp, which does not exclude the DB-authored sys_metadata pseudo-package that appRoute.ts's studioPackageId refuses. An app carrying that _packageId would bind to app:sys_metadata:build, as the A1.b switcher already lists it. Not measured whether any app list item carries it. Carrier: none; noted here only.
  • Thread per app. Each authorable app a maker opens with the dock expanded mints its own build conversation on first open, as the Studio copilot does per package. The rows are listed in the /ai sidebar.
  • Bare /ai/build is untouched. It still resolves the product-only key, and the code did not require changing it.

Generated by Claude Code

…nt authorable app

Inside an app whose package is not a com.objectstack.* built-in, a dock
resolved to the build agent passes the app's package as editPackageId, so
its scope is app:PKG:build (the key the Studio copilot and
/ai/build?package=PKG resolve), the chip / empty state / context.packageId
name the app, and Maximize opens /ai/build?package=PKG. ask and app-less
contexts keep the product-only key. The dock runs the same A1.b migration
read as the full page (predicate extracted as isThreadBoundToPackage) and
hands its pane only a scope-matched conversation, as the full page does.

Claude-Session: https://claude.ai/code/session_015AUunPkX7UTkCH9e7AdZo1
Co-authored-by: Claude <noreply@anthropic.com>
The real dock body, ChatPane, useChatConversation and full-page
AiChatPage over a fetch stub: the chip, empty state and context.packageId
name the app; the dock and /ai/build?package=X resolve one thread; the
Studio copilot's key is resumed; ask, a built-in app and no app keep the
product-only key; the bound legacy thread is adopted and an unrelated one
is not; an app switch never pairs the old thread with the new package;
both maximize paths carry the bound package.

Claude-Session: https://claude.ai/code/session_015AUunPkX7UTkCH9e7AdZo1
Co-authored-by: Claude <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

changeset-claim-re-read

⚠️ 1 pending changeset(s) describe a file this change touches

Their bodies publish verbatim into the CHANGELOG at the next release, so this is a request to re-read them against your diff — addressed here because you are the one seat that can answer it without re-deriving anything.

⛔ Nothing here blocks, and nothing here is a verdict on your change. This gate exits 0, is not a required context, and judges name resolution, never meaning: it asked whether a pending body names a file you touched. "Is this sentence still true?" is the one question it will not answer, and the one you are being asked to answer.

.changeset/6169-chatbot-authoring-face-type.md

  • names packages/app-shell/src/console/ai/AiChatPage.tsx → packages/app-shell/src/console/ai/AiChatPage.tsx — edited by this change

    • showTimestamp, userAvatarUrl, userAvatarFallback, assistantAvatarUrl, assistantAvatarFallback, maxHeight — display fields. - autoResponse, autoResponseText, autoResponseDelay — the local auto-response (demo/playground) fields, already live via a real consumer (packages/app-shell/src/console/ai/AiChatPage.tsx). - onSend — the send-callback, now typed on the published authoring face rather than against the plugin's internal runtime message type. Its messages element is the authoring ChatMessage widened by the three runtime-only approval states a chat runtime hands back (objectui#10018).

Read the paragraph, not the line: both false halves of the objectui#8617 claim sat in one paragraph, and correcting either alone would have left it asserting the same wrong thing.

If a claim did go false, correct the body. That is precedented and prose-only, frontmatter untouched; check-changeset-overwrite.mjs will report the correction as its own case 2 ("correcting a declaration on purpose … legitimate"), which is the intended shape — one gate asks for the read, the other records the write.

Not covered, stated so nobody reads this as more: a born-false claim that spells no line address at all (objectui#9495 coordinated one by ORDINAL — "a grep finds that member first" — and deciding that means reading what the sentence means), a claim spelled as a symbol or a package rather than a backticked file name, and a file named ambiguously.

Compared the checked-out tree with 5c94589f0 (merge-base with origin/main): 6 file(s) changed outside .changeset/, read against 1684 pending declaration(s) that publish a body (2284 pending in total). · run

@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 330 chunks) 3102.9 KB 3104.5 KB
Main entry chunk (gzip) 149.7 KB 350 KB
Entry file index-Cx3rEF4B.js —
Status PASS —

The eager closure is every chunk the entry reaches through static imports — what the browser fetches and parses before the app renders. The entry chunk on its own is a small fraction of it.


📦 Bundle Size Report

Package Size Gzipped
app-shell (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 16.58KB 6.17KB
app-shell (runtime-config.js) 20.68KB 7.36KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.06KB 3.86KB
auth (ActiveOrganizationStorage.js) 27.95KB 10.04KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 40.22KB 10.61KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.15KB 5.39KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.70KB 2.23KB
auth (SocialSignInButtons.js) 9.61KB 3.89KB
auth (UserMenu.js) 3.39KB 1.21KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 40.70KB 10.94KB
auth (createAuthenticatedFetch.js) 8.52KB 3.45KB
auth (index.js) 3.63KB 1.64KB
auth (invitation-status.js) 1.22KB 0.70KB
auth (org-roles.js) 6.66KB 2.78KB
auth (phone-identifier.js) 1.11KB 0.66KB
auth (types.js) 0.59KB 0.35KB
auth (useAuth.js) 5.30KB 1.02KB
auth (useWorkspaceAdminStatus.js) 11.08KB 4.58KB
collaboration (CommentThread.js) 27.13KB 7.95KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.49KB 2.64KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.68KB 0.73KB
collaboration (useCollaborationTranslation.js) 6.05KB 2.52KB
collaboration (useCommentSearch.js) 1.98KB 0.88KB
collaboration (useConflictResolution.js) 7.75KB 1.86KB
collaboration (useMentionNotifications.js) 1.81KB 0.68KB
collaboration (usePresence.js) 6.33KB 1.84KB
collaboration (useRealtimeSubscription.js) 7.91KB 2.01KB
components (index.js) 557.59KB 133.60KB
core (index.js) 9.93KB 3.94KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 227.61KB 63.16KB
fields (index.js) 261.01KB 66.28KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (builtinAggregateLabels.js) 0.86KB 0.49KB
i18n (currency.js) 2.59KB 1.22KB
i18n (fallbackInterpolation.js) 6.25KB 2.77KB
i18n (i18n.js) 8.87KB 3.64KB
i18n (index.js) 5.24KB 2.27KB
i18n (pickLocalized.js) 9.86KB 3.95KB
i18n (provider.js) 39.40KB 12.91KB
i18n (translateFn.js) 0.20KB 0.18KB
i18n (useDisplayLocale.js) 3.52KB 1.76KB
i18n (useObjectLabel.js) 34.34KB 9.17KB
i18n (useSafeTranslation.js) 5.60KB 2.33KB
layout (index.js) 39.32KB 11.09KB
mobile (MobileProvider.js) 0.92KB 0.49KB
mobile (ResponsiveContainer.js) 0.94KB 0.38KB
mobile (breakpoints.js) 1.51KB 0.70KB
mobile (createOfflineDataSource.js) 5.61KB 1.75KB
mobile (index.js) 1.99KB 0.87KB
mobile (offlineQueue.js) 3.91KB 1.35KB
mobile (pwa.js) 0.97KB 0.49KB
mobile (serviceWorker.js) 1.48KB 0.62KB
mobile (serviceWorkerSource.js) 3.41KB 1.48KB
mobile (useBreakpoint.js) 1.54KB 0.65KB
mobile (useGesture.js) 6.96KB 1.98KB
mobile (useOfflineSync.js) 1.99KB 0.72KB
mobile (usePullToRefresh.js) 6.62KB 2.45KB
mobile (useResponsive.js) 0.72KB 0.42KB
mobile (useSpecGesture.js) 5.52KB 2.10KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 13.52KB 4.88KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.24KB 2.16KB
permissions (discardProofCache.js) 1.04KB 0.55KB
permissions (evaluator.js) 8.33KB 3.07KB
permissions (index.js) 0.93KB 0.41KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.53KB
permissions (usePermissions.js) 4.83KB 2.27KB
plugin-ai (index.js) 16.01KB 3.93KB
plugin-calendar (index.js) 51.96KB 14.83KB
plugin-charts (index.js) 84.09KB 22.93KB
plugin-chatbot (index.js) 197.72KB 46.92KB
plugin-dashboard (index.js) 137.82KB 36.70KB
plugin-designer (index.js) 215.78KB 44.42KB
plugin-detail (index.js) 233.51KB 61.80KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 161.21KB 41.41KB
plugin-gantt (index.js) 170.35KB 42.19KB
plugin-grid (index.js) 228.33KB 62.59KB
plugin-kanban (index.js) 48.43KB 15.11KB
plugin-list (index.js) 115.86KB 28.64KB
plugin-map (index.js) 22.90KB 7.62KB
plugin-markdown (index.js) 13.88KB 4.80KB
plugin-report (index.js) 44.17KB 12.20KB
plugin-timeline (index.js) 31.15KB 9.14KB
plugin-tree (index.js) 11.21KB 3.89KB
plugin-view (index.js) 89.15KB 22.35KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.90KB 0.85KB
providers (UploadProvider.js) 11.81KB 3.58KB
providers (index.js) 0.45KB 0.23KB
providers (types.js) 0.01KB 0.04KB
react-runtime (index.js) 5.62KB 2.34KB
react (LazyPluginLoader.js) 4.47KB 1.63KB
react (SchemaRenderer.js) 119.16KB 39.05KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 4.03KB 1.86KB
react (schema-input.js) 4.25KB 2.04KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (body-dialect.js) 4.78KB 2.09KB
sdui-parser (codegen.js) 7.50KB 3.05KB
sdui-parser (dashboard-widget-options.js) 3.08KB 1.30KB
sdui-parser (index.js) 6.16KB 2.71KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (kanban-quick-add.js) 3.89KB 1.87KB
sdui-parser (parse.js) 25.28KB 7.80KB
sdui-parser (provenance.js) 3.84KB 1.90KB
sdui-parser (types.js) 0.28KB 0.23KB
sdui-parser (validate.js) 18.27KB 6.22KB
types (ai.js) 4.39KB 2.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 3.83KB 1.49KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (complex.js) 2.93KB 1.49KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
types (data-display.js) 3.75KB 1.85KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 1.85KB 0.85KB
types (disclosure.js) 0.20KB 0.18KB
types (error-code.js) 1.54KB 0.88KB
types (expression.js) 0.20KB 0.18KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 0.20KB 0.18KB
types (form.js) 0.20KB 0.18KB
types (http-inflight.js) 8.87KB 3.73KB
types (http-retry.js) 4.32KB 2.02KB
types (icon-key-migration.js) 4.26KB 1.63KB
types (index.js) 4.74KB 2.26KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 5.00KB 2.39KB
types (navigation.js) 0.20KB 0.18KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 2.52KB 1.31KB
types (plugin-scope.js) 0.20KB 0.18KB
types (record-components.js) 0.20KB 0.19KB
types (record-semantics.js) 1.28KB 0.67KB
types (registry.js) 0.20KB 0.18KB
types (reports.js) 0.20KB 0.18KB
types (select-option.js) 0.20KB 0.19KB
types (spec-report.js) 5.05KB 1.93KB
types (spec-ui-namespace.js) 0.20KB 0.19KB
types (strict-authoring-face.js) 17.15KB 6.32KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.27KB 2.87KB
types (ui-action.js) 8.11KB 3.32KB
types (views.js) 0.20KB 0.18KB
types (widget.js) 0.20KB 0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@objectstack-fleet

Copy link
Copy Markdown
Contributor Author

Contract review

Served-tier: CONTRACT_REVIEW_TIER
Head-sha: 8d4efd6e40145042e55d30b057fddd3af522aef9
Local-runs: none

Inputs read: card #10926 (body + comments 5866972381 claim, 5868024803 dev report, 5868060731 file-surface supplement), PR #10950 body, file list and the net diff origin/main...8d4efd6 (merge-base = origin/main 5c94589; 7 files, +710/−39), the 43 check-runs on the head, docs/adr/0057-console-ai-chat-one-conversation-docked.md on origin/main, and the Amendment A2 text on PR #10947's branch (4a66540). Gate verdicts on the head: 43 check-runs completed, 40 success, 3 skipped (dependabot, Test (coverage), Test (coverage shard)), 0 failed. The Governed Surface Queue Guard is green and the code PR touches no governed path.

① Derived judgments

Each behaviour or surface the diff implies, judged against the maintainer ruling 「绑定当前应用(推荐)」 as presented on the card and against Amendment A2:

  1. Thread key inside an authorable app — right. ChatDockConversation derives editPackageId = appPackageId exactly when chatProductOfAgent(activeAgent) === 'build' and !isPlatformBuiltinApp({ _packageId: appPackageId }), and keys chatConversationScope({ appId: editPackageId, product }), which is app:PKG:build. That is the key StudioAiCopilot (chatConversationScope({ appId: packageId, product })) and the full page's ?package= entry already resolve, so the three surfaces share one thread. Matches ruling term 1 and A2 "Key". Reuses editPackageId / chatConversationScope; no new resolver.
  2. Authorable predicate — right. The predicate is the A1.b switcher's own isPlatformBuiltinApp (the com.objectstack. prefix), imported, not re-implemented. Matches A2 "Authorable ... There is no second resolver".
  3. Chip, empty state, agent context — right. The dock now hands ChatPane editPackageId. On main ChatPane already turns that into the chip label (the app matched by _packageId in the metadata list), the edit-mode empty state (Editing "{{app}}") and body.context.packageId. Matches ruling term 2. Pre-existing fallbacks are unchanged: the chip shows the raw package id and the empty state the generic edit title when the app is not in the list.
  4. Legacy-thread adoption — right. legacyScope: editPackageId ? product : undefined plus adoptLegacy through the shared isThreadBoundToPackage. The hook runs that read only when nothing is cached under app:PKG:build, writes only the new key and leaves the product-only key intact, so the ambient build thread stays reachable in the /ai sidebar (ruling term 5) and is adopted only when its own history is bound to PKG (A2 "The product-only thread"). The AiChatPage refactor is behaviour-preserving: Boolean(editPackageId) became editPackageId !== undefined, and the page's editPackageId is searchParams.get('package')?.trim() || undefined, never an empty string.
  5. Maximize target — right. ConsoleLayout.openDockFullPage(boundPackageId?) navigates a bound thread to /ai/build?package=PKG after setting the one-shot objectstack:ai-full-page-requested opt-out (the same door StudioAiCopilot sets and AiChatPage's built-moment transition consumes), and an unbound thread to /ai as before, remembering the return location in both branches. The panel's button now calls onMaximize(boundPackageId) explicitly (the previous onClick={onMaximize} would have passed the click event as the first argument once the signature widened); the mobile sheet's deferred maximize carries the same value. Studio's openFullPage (() => void) stays assignable to the widened callback and, with a children body, receives undefined. Matches ruling term 3 and A2 "Maximize".
  6. Outside an authorable app — unchanged, right. ask yields editPackageId undefined and the key ask (ambient, no packageId in context, no chip); a com.objectstack.* app and no app yield the key build; bare /ai/build is untouched because AiChatPage's editPackageId derivation did not change. Matches ruling term 4, card Acceptance 3, and the half of A1.b that A2 keeps.
  7. Scope-matched pane gate — right, beyond the ruling's terms but required. scopeMatched = conversationScope === scope hands the pane undefined/empty until the hook re-resolves after an app switch, the same AI handoff: second handoff's auto-send doesn't fire into an existing (hydrating) build conversation #2450 gate the full page uses; without it a mounted pane would pair the previous app's thread with the new package while the dock stays mounted. Pinned by the app-switch test.
  8. Public surface. ChatDockPanelProps / ChatDockMobileSheetProps gain optional appPackageId and their onMaximize widens to (boundPackageId?: string) => void; isThreadBoundToPackage becomes a module export of AiChatPage.tsx. None of these reach the package entry: src/index.ts exports nothing from layout/ChatDock (checked layout/index.ts too) and re-exports only AiChatPage, DefaultAiChatPage and hydratedMessagesToChatMessages from AiChatPage.tsx. ConsoleLayout is exported and its props are unchanged. chatScope.ts changes documentation only. No locale key moves.
  9. Tests against the card's pin list. The card asks for pins on the chip text inside an app, the scope key, thread sharing with /ai/build?package=, and ask staying ambient. ChatDock.appBinding-10926.test.tsx carries each of them over the real dock body, ChatPane, useChatConversation and (for the sharing pin) the real AiChatPage, plus the built-in/no-app, adopt/no-adopt, app-switch and both maximize paths; ConsoleLayout.dockBinding-10926.test.tsx pins the package hand-off to both presentations and both maximize targets. The test shards on the head are green.

Changeset prose (.changeset/10926-dock-binds-build-thread-to-app.md), each factual sentence against the diff:

  • "binds its build conversation to the app you are in" — true (item 1).
  • "Inside an app whose package is not a com.objectstack.* platform built-in, a dock whose agent resolves to build now keys its conversation app:PKG:build — the key the Studio copilot and /ai/build?package=PKG already use — so the three show one thread." — true (items 1, 2).
  • "The dock's header chip and empty state name the app instead of reading "New app"" — true (item 3).
  • "each build request carries the app's package as context.packageId" — true (ChatPane spreads packageId: editPackageId into body.context).
  • "The dock's "Open full page" button opens /ai/build?package=PKG for such a thread." — true; "Open full page" is the console.ai.dock.maximize default (item 5).
  • "Unchanged: an ask dock keeps its app-less thread; inside a com.objectstack.* app, or with no current app, a build dock keeps the product-only thread; and bare /ai/build still resolves that product-only thread." — true (item 6).
  • "The product-only thread is never cleared — it stays listed in the /ai sidebar, and a dock entering an app adopts it only when its own history is bound to that app (the same check the ?package= entry already applies)." — true (item 4).

No sentence overstates the diff. The opt-out on maximize is not mentioned, which is an omission, not an error.

② Semver level

'@object-ui/app-shell': minor. The diff publishes a new behaviour in the shipped ConsoleLayout (the dock binds its build thread; the maximize target follows) with no new entry export, no removal and no rename, so minor is the right level for a feature; objectui's fixed-group rule forbids major in any case, and the Changeset Bump Policy, Changeset Declaration and Changeset Claim Re-read check-runs are green. The claim (5866972381, the newest Claim: comment; 5868060731 is a file-surface supplement, not a claim) declares Clause-②: no, and the PR body repeats Clause-②: no: nothing an author can write is removed or narrowed, so no arm and no ADR-0087 marker is owed. Changeset, claim and diff agree.

③ Boundary flags

  1. Claim surface breached by layout/ConsoleLayout.tsx and its test (dev deviation 1). Answered: the claim said stop on breach, the dev instead declared it in the report, and the seat's supplement 5868060731 corrected the surface in the open and measured that no other open PR touches the file. What was touched there is the two appPackageId prop lines and openDockFullPage; fix(app-shell, plugins): hosted-console UX defects from the 2026-09-28 cloud E2E (six of seven) #10924's FAB hunk merged cleanly (merge-base is origin/main, PR mergeable state clean). No further action.
  2. The dock runs the A1.b migration read (dev deviation 2), which the ruling's presented terms do not name. Answered: Amendment A2's decision text records it verbatim ("The dock runs the same A1.b migration read the ?package= entry runs"), so the code matches the recorded decision as it stands on PR docs(adr): ADR-0057 Amendment A2 — the dock binds its build thread to the current app (objectui#10926) #10947's branch. If that clause changes before docs(adr): ADR-0057 Amendment A2 — the dock binds its build thread to the current app (objectui#10926) #10947 lands, this item needs re-review.
  3. Commit trailers (dev deviation 3): the five non-merge commits carry Claude-Session: and a model-free Co-authored-by: Claude line rather than the harness's model-named form. I could not locate the objectui AGENTS.md rule the dev cites by keyword. A commit-message matter with no bearing on the diff; noted for the seat, not weighed.
  4. Zone 2 line reading (dev deviation 4): confirmed by content, the A1.b clause sits where the claim said; no line citation appears in the ADR text.
  5. open_questions: none filed; nothing to answer.
  6. sys_metadata pseudo-package (dev out-of-scope finding, PR Acceptance note 1). isPlatformBuiltinApp is a prefix test and admits _packageId === 'sys_metadata', which appRoute.ts's studioPackageId refuses for the Studio bridge; an app list item carrying it would bind the dock to app:sys_metadata:build. Against the recorded decision the code is right, because A2 mandates that exact predicate and forbids a second resolver, and the gap is shared with the A1.b switcher already on main. Escalated, not decided: it has no carrier. It needs a follow-up card (or a one-line clause in the amendment) to say whether sys_metadata is authorable for the build agent; whether any /meta/app item carries it is unmeasured. Not blocking.
  7. Thread per app (PR Acceptance note 2): each authorable app mints its own build thread on first dock open. A2 "Consequences" records exactly this; answered.
  8. Bare /ai/build untouched (PR Acceptance note 3): confirmed by the diff; answered.
  9. Observed, not introduced here: inside the dock the bound chip is still ChatPane's switcher, so picking another app in its menu navigates the console to /ai/build?package=Y and leaves the app page. main already mounted that chip in the dock for makers; noted only.
  10. Landing order relative to ADR amendment PR docs(adr): ADR-0057 Amendment A2 — the dock binds its build thread to the current app (objectui#10926) #10947 — flagged, not decided. The seat intends to hold this code until the amendment merges. (a) Amendment first: main's ADR never forbids a behaviour main's code ships; nothing in this PR cites the amendment textually, so no dependency breaks. (b) Code first: between the two merges the A1.b clause on main ("dock/FAB and bare /ai/build keep resolving through it") contradicts shipped code. (c) Independently: the amendment reads correctly whichever lands first ("Implemented under objectui#10926"), but this PR's Fixes #10926 closes the card while the governed half (Part of #10926) may still be open. The code carries no technical dependency on docs(adr): ADR-0057 Amendment A2 — the dock binds its build thread to the current app (objectui#10926) #10947; the order is the seat's and the maintainer's call.

Implemented-by: claude/issue-10926-dock-binds-app
Reviewed-by: session_015AUunPkX7UTkCH9e7AdZo1

VERDICT: PASS


Generated by Claude Code

@objectstack-fleet
objectstack-fleet Bot marked this pull request as ready for review September 28, 2026 12:21
@objectstack-fleet
objectstack-fleet Bot added this pull request to the merge queue Sep 28, 2026
Merged via the queue into main with commit fe56394 Sep 28, 2026
45 checks passed
@objectstack-fleet
objectstack-fleet Bot deleted the claude/issue-10926-dock-binds-app branch September 28, 2026 12:37
akarma-synetal pushed a commit to akarma-synetal/objectui that referenced this pull request Oct 7, 2026
… bare apiMethods-card number (objectui#10803, batch 7) (objectstack-ai#10962)

Part of objectstack-ai#10803
Clause-②: no

Dispatched implementation of the `domain:ui` seat objectstack-ai#1 claim (comment
`5867587761`) on objectui#10803, batch 7, session
`https://claude.ai/code/session_01DuWo5bdP9SdVebamn99GGk`. Citations
only: no sentence's claim moves, and every edited pending changeset's
frontmatter is byte-identical. The only runtime text that moves is two
console warnings, one in `@object-ui/app-shell` and one in
`@object-ui/plugin-detail`, which lose their dead pointer and nothing
else (amendment `5860244997`, Q1 = A; `patch` changeset). No test pins
any changed text: the literal-anchor sweep below finds no specific
anchor, so no test file is edited.

This batch carries release `5866922219`'s two lists:
- the **30 `objectstack#N` citations that answer 404**, in the card's
two classes (pending changeset prose and non-test `packages/*/src`);
- the **28 bare `objectstack-ai#3391` lines in 10 files** that mean objectstack's
apiMethods whitelist card, which batch 6 fixed at 2 other sites.

## Why `Part of`, not a closing line

Both lists read **0** after this batch (**Census**). The brief's rule
was a closing line if the card's lists all read 0. They do, but reading
the sentences found **10 more lines in the same two classes that cite a
dead objectstack number written bare**, three numbers in all
(**Acceptance notes** 1). Triage item 3 puts a dead number found later
in these classes on this card, so the card is not finished. Whether it
carries them as a batch 8 or closes is the seat's call.

## Premise, re-measured on `origin/main` `3b469c8ea` (the branch point)

- **Every distinct `objectstack#N` in the two in-scope classes.** 372
numbers (the one objectstack issue URL in these classes names 6227,
which is among them). Each was read once with REST `GET
/repos/objectstack-ai/objectstack/issues/N`:
  - 341 answer 200;
- 1 answers 301: objectstack#14026, transferred to objectui#10102, which
batch 6 re-qualified;
  - **30 answer 404**, exactly the 30 batch 6 listed.
- **The 30, read again.** A second `issues/N` read of each answers 404
(30 of 30), and `pulls/N` answers 404 for all 30. Lit controls in the
same run: objectstack#3391, objectstack-ai#3720 and objectstack-ai#3546 answer 200 as issues, and
`pulls/13267` answers 200.
- **objectstack-ai#3391 and objectstack-ai#3546, both repositories.**
- objectui#3391 is the record-header api-action placeholder card,
unrelated.
- objectstack#3391 is the apiMethods whitelist contract card: "UI 操作按钮与
apiMethods 白名单一致性契约落地". Its body names the effective operation set,
`/me/permissions`, the 405 import refusal and export derived from list,
which is what each of the 28 sentences says.
  - objectui#3546 is the missing-i18n-keys card, unrelated.
- objectstack#3546 is "detail/form 面的 edit/delete 按钮接入服务端 effective
操作集", the inline-edit gate the two paired lines describe.
- **objectstack history.** Read from a full, not shallow, treeless clone
of objectstack `main` (`git rev-parse --is-shallow-repository`: false).
- Every objectstack sha this PR cites is an ancestor of objectstack
`main` (`git merge-base --is-ancestor`, exit 0): the 24 this PR adds to
the tree, the 3 its edited sentences already cited (`c459da6bc`,
`89448a52b`, `9bd4344e4`), and the 7 this body names besides.
  - `git rev-parse --short=9` returns the same 9 characters for each.
- Control legs in the same clone: the head of the open PR
objectstack#20421 (`a22b90fc0`) answers exit 1; the known ancestor
`51789064` answers exit 0.
- **The one objectui sha.** `7a197e7c5` is an ancestor of the branch
point, exit 0. Control legs: the head of PR objectui#10945 answers exit
1, and `5f789538d` answers exit 0. This checkout is not shallow.
- **A cross-check, not the method.** objectstack's own sweep of dead
tracker citations in its tree (objectstack#19123's landing `66e266c93`,
its stages `21ab41041`, `5cf58eb16` and `0d7ed5a37`, and `f415bcf18`)
anchored eight of these numbers in its own files. For each of the eight
(objectstack-ai#5970, objectstack-ai#6483, objectstack-ai#9934, objectstack-ai#10485, objectstack-ai#11330, objectstack-ai#11846, #12868 and #17147) it
chose the same commit this PR cites.
- Every edited changeset is pending: it is present in `.changeset/` on
`main`.

## Census (the enumeration pin for this batch)

The 30 numbers (REF = a commit or tree):

```
git grep -nE 'objectstack#(5970|5976|6038|6124|6281|6331|6450|6483|6515|9933|9934|10354|10485|10695|11330|11507|11513|11658|11703|11753|11846|12009|12868|13117|13670|16126|17147|17762|17987|18012)([^0-9]|$)' REF -- '.changeset/*.md' 'packages/*/src/**' ':!**/__tests__/**' ':!**/*.test.*' ':!**/*.spec.*' ':!**/test/**' ':!**/tests/**' | wc -l
```

The bare `objectstack-ai#3391`, with the same pathspec:

```
git grep -nE '(^|[^0-9A-Za-z_#/])objectstack-ai#3391([^0-9]|$)' REF -- '.changeset/*.md' 'packages/*/src/**' ':!**/__tests__/**' ':!**/*.test.*' ':!**/*.spec.*' ':!**/test/**' ':!**/tests/**' | wc -l
```

| REF | the 30 | bare `objectstack-ai#3391` |
|:--|:--|:--|
| `3b469c8ea` (branch point) | **82**: 26 changeset lines in 24 files,
56 src lines in 39 files | **28** in 10 files |
| `c292a6400` (this head) | **0** | **0** |
| this head merged with `main` `5c94589f0` (`git merge-tree
--write-tree`, clean, tree `bba27eece`) | **0** | **0** |
| `5c94589f0` (`main` alone) | 82 | 28 |

- Lit controls on the same instruments at this head: live
objectstack#10856 reads 4 lines (4 at the branch point);
`objectstack#3391` reads 32 lines, against 3 at the branch point (28
re-qualified here, and this PR's sweep changeset names it once).
- **Out of scope, as it stands** (whole tree at this head, unfiltered):
- the 30 numbers: 84 test lines in 47 files, 1 scripts line, 2 lines in
2 `apps/console` files, 2 package READMEs (`auth`, `react`), 11 lines of
published `CHANGELOG.md` history in 8 files; 0 `.github`, 0 governed, 0
`content/docs`;
- bare `objectstack-ai#3391`: 12 test lines in 9 files and 23 `CHANGELOG.md` lines in
8 files.

## Citation form

- **An objectstack commit** is written the way batch 6 wrote its
stand-ins: objectstack and the 9-character backticked sha of the commit
on objectstack `main` that landed the change the sentence rests on.
- **A dead card beside its own dead pull request** collapses to that
pull request's squash commit (objectstack-ai#5970 with PR objectstack-ai#6450, objectstack-ai#10485 with PR
objectstack-ai#10695).
- **A dead number beside the live landing it already names** is dropped:
objectstack-ai#11846 beside PR objectstack#12718, #16126 beside PR objectstack#16920,
#12868 beside objectstack `c459da6bc`, and objectstack-ai#12009 beside objectstack
`89448a52b` (**Special cases** 3).
- **A ruling the dead card carried** is cited by its date, with the
commit that executed or recorded it, as batches 3 to 6 did for objectui
rulings.
- **One sentence cites this repository's commit**, `7a197e7c5`, because
the change it names landed here (objectstack-ai#6331).
- **Runtime text carries no sha.** In the two console warnings the dead
pointer is dropped (**Special cases** 8).
- **The bare `objectstack-ai#3391`** becomes `objectstack#3391`, and on the two lines
that write `objectstack-ai#3391/objectstack-ai#3546`, `objectstack#3391/objectstack#3546`.

## Mapping, the 30 numbers

Lines / files are the branch-point census for that number (a line naming
two of them counts under both).

| dead number | resolution | what that commit carries | lines / files |
|:--|:--|:--|:--|
| objectstack-ai#5970 | objectstack `97e7e3caa` | "unify ActionSchema.visible/disabled
on one condition shape (objectstack-ai#6450)", body "(objectstack-ai#5970)": `visible` gains the
boolean arm | 2 / 1 |
| objectstack-ai#6450 (PR) | the same `97e7e3caa`, its squash | as above; the card /
PR pair collapses | 2 / 1 |
| objectstack-ai#5976 (PR) | objectstack `795b6e1aa`, its squash | "5 值子集改名
`HttpMethodSubset`" | 1 / 1 |
| objectstack-ai#6038 | objectstack `7618ee814` | "key a container's default `list`
`_views` name by the runtime identity": leg 2 of 3 of the
objectstack#5164 ruling, the `packages/lint` half | 1 / 1 |
| objectstack-ai#6124 (PR) | objectstack `b3c1f3cd5`, its squash | "key `_views`
translations by the runtime view identity"; "The extractor now ASKS the
composer for the key" | 1 / 1 |
| objectstack-ai#6281 (PR) | objectstack `85ec26d28`, its squash, 2026-08-07 | "SDUI
props — enforce or remove (objectstack-ai#5775) (objectstack-ai#6281)": the shared
`PageContainerProps`, whose single key is `children`, for `page:section`
/ `page:footer` / `page:sidebar`, which were `EmptyProps` | 1 / 1 |
| objectstack-ai#6331 | objectui `7a197e7c5` | this repository's "SchemaForm reads the
canonical `visibleWhen`, reviving every metadata-form predicate
(objectstack#6331)" | 1 / 1 |
| objectstack-ai#6483 | objectstack `ee58392e1` | "ADR-0005 白名单强制 … (objectstack-ai#6483)"; its diff
carries the sentence the comment quotes, "Runtime-created sets … ride
`allowRuntimeCreate` (still `true`) and keep working" | 1 / 1 |
| objectstack-ai#6515 (PR) | objectstack `2fdb36eb9`, its squash | "SpecifierSchema
gains a closed `valueDomain` enum": "`bcp47_locale` is deliberately not
in the vocabulary", because `localization.locale`'s options ARE the
shipped catalogs | 1 / 1 |
| objectstack-ai#9933 | objectstack `d5552ca13` | "admit columnState as an explicitly
runtime-only view-overlay key" (subject ending "(objectstack-ai#9996)"; "(objectstack-ai#9933)" is
on the message's first body line), on the overlay faces including
`viewItemWireFields` | 3 / 3 |
| objectstack-ai#9934 | objectstack `79c46da90` | "producer-side user-facing marking
for hook refusal messages — userMessage channel (objectstack-ai#9934)":
`ApiErrorSchema.userMessage`, the contract half of the objectui#5210
split | 10 / 9 |
| objectstack-ai#10354 (PR) | objectstack `9e04c3e35`, its squash | "let the publish
door state the package it is promoting"; its changeset and code comment
carry the key-presence / `no_draft` warning `ResourceEditPage.tsx`
points at | 4 / 3 |
| objectstack-ai#10485 | objectstack `35ad101bc` | "retire the `themes` carrier key
and ThemeSchema (objectstack-ai#10485, ADR-0049) (objectstack-ai#10695)": "Ruled B (退役授权面,
2026-08-21)", "delete ui/theme.zod.ts whole" | 15 / 13 |
| objectstack-ai#10695 (PR) | the same `35ad101bc`, its squash | as above; the card /
PR pair collapses | 6 / 6 |
| objectstack-ai#11330 | objectstack `a9ee98992` | "manifest.runtime trust-tier text
states publish-gate-only enforcement truthfully", the trust-tier half
(**Special cases** 2) | 1 / 1 |
| objectstack-ai#11507 | objectstack `88b9d749a` | "declare sys_activity.type as an
open, author-extensible vocabulary": "Maintainer ruling 2026-08-24,
direction 4" | 13 / 9 |
| objectstack-ai#11513 | objectstack `e170b0ae5` | "lock package-declared permission
sets at the save door; clone to customize", quoting the 2026-08-24
ruling 「同意 第一步(创业阶段,Salesforce 式)」 | 3 / 3 |
| objectstack-ai#11658 | objectstack `1a6a19c31` | "open RecordActivityProps.types to
author-contributed activity kinds"; its message names objectstack-ai#11658 as the card
it settles, and it executes the 2026-08-24 ruling | 1 / 1 |
| objectstack-ai#11703 | objectstack `5cb62d88b` | "make clone_permission_set carry
all five copied facets"; its message names objectstack-ai#11703 as the card it
settles: the silent-grant-loss shape | 1 / 1 |
| objectstack-ai#11753 | "the 2026-08-25 ruling whose spec half is objectstack
`0e4e51b0a`" | `ActionParamSchema.carryOver`, whose changeset reads
"(objectstack-ai#11753 ruling, spec half; objectstack-ai#11992)" and "The maintainer's 2026-08-25
ruling on objectstack-ai#11753" | 2 / 2 |
| objectstack-ai#11846 | objectstack `0c2334f6c`; dropped beside PR objectstack#12718
| "retire preview mode — the RuntimeMode 'preview' value and the whole
PreviewModeConfig block (#12718)" | 3 / 3 |
| objectstack-ai#12009 | dropped beside objectstack `89448a52b` | the card of the
`AUTH_SSO_PROVIDER_SCHEMA` removal, whose landing the line already cites
(**Special cases** 3) | 1 / 1 |
| #12868 | dropped beside objectstack `c459da6bc` | the line already
cites the commit that executed the ruling; objectstack's own `f415bcf18`
anchors #12868 to the same `c459da6bc` | 1 / 1 |
| #13117 (PR) | objectstack `225e7690f`, its squash | "Readiness read
for the Phase-2 members … global:search and global:notifications both
have shipped platform data sources, so per the ruling both STAY
declared" | 1 / 1 |
| #13670 | "maintainer ruling 2026-08-31, option 2, recorded in
objectstack `8c6a7fc0b`" | "The #13670 ruling settled the question:
text's intended evaluation channel is `content` alone" | 1 / 1 |
| #16126 | dropped beside PR objectstack#16920 | PR objectstack#16920
(200) names #16126 in its body as the card it settles; merged 2026-09-08
as `859ded3ec` | 2 / 2 |
| #17147 | objectstack `aaacf1d5c` | "the install-time granted
permission set is REGISTERED at load and refuses nothing — say so, and
pin the measurement (#17147)", the measurement on `9bd4344e4` | 2 / 2 |
| #17762 | objectstack `4342c9923` | "guard three data lookups against
Object.prototype fall-through"; its message names #17762 as a card it
settles, `classifyFilterToken` among the three lookups | 1 / 1 |
| #17987 | objectstack `e233db9db` | "declare element-level `navigation`
on object-kanban / object-calendar …"; its message names #17987 as the
card it settles, and its Downstream note: objectui#8652 waits on it,
unlock criterion a released, installable `@objectstack/spec` (**Special
cases** 1) | 2 / 2 |
| #18012 | objectstack `176b03582` | "`$between` requires two non-blank
endpoints (#18012)": "Ruling executed: decision batch objectstack-ai#146 item 5,
**letter A**" | 3 / 3 |

The 28 `objectstack-ai#3391` lines, all now `objectstack#3391`: `ObjectDataPage.tsx`
(3) and `ObjectView.tsx` (2) in app-shell; `managedBy.ts` (5);
`MePermissionsProvider.tsx` (2), `PermissionContext.ts`,
`PermissionProvider.tsx`; `fieldWriteGate.ts`; `ImportWizard.tsx` (6),
`ObjectGrid.tsx` (4); `ListView.tsx` (3). Each was read: every one names
the server's effective API operation set, `/me/permissions`
`apiOperations`, or the 405 import refusal.

## Special cases (the judgement calls)

1. **#17987, two sentences.**
- `ObjectTree.tsx`: "blocked on objectstack#17987, whose unlock
criterion is a released `@objectstack/spec` carrying the declaration
being installable here" becomes "blocked on objectstack `e233db9db`,
whose unlock criterion …". That commit's Downstream note states the same
criterion.
- `ObjectCalendar.tsx`: "that card is `pm:blocked` on objectstack#17987"
becomes "that card waits on objectstack `e233db9db`". The label word is
not kept, because objectui#8652's label reads `pm:on-hold` today
(measured); "waits on" is the phrase `e233db9db`'s own note uses for
that card.
2. **objectstack-ai#11330.** "it is objectstack#11330's half of the same panel"
becomes "it is the trust-tier half of the same panel, which objectstack
`a9ee98992` settled separately". `aaacf1d5c`'s message calls objectstack-ai#11330 "the
sibling half of this very sentence", ruled the same way on 2026-08-30,
and `a9ee98992` (2026-08-30) is that half's landing.
3. **objectstack-ai#12009 collapses into the sha beside it.** objectui#6910's body and
ruling comment `5534414562` name "objectstack#12009 / PR #13413"
together as the one `AUTH_SSO_PROVIDER_SCHEMA` precedent, a card and its
pull request. Batch 6 replaced PR #13413 with its squash `89448a52b`, so
the card goes the way of batch 3's objectstack-ai#5401 / objectstack-ai#5505 pair.
4. **objectstack-ai#11753, two sites.** The card carried the ruling, and `0e4e51b0a`
is its spec half. Both sites keep "ruling" as the antecedent that
`ActionParamDialog.tsx`'s next paragraph ("The ruling's point …") reads.
5. **objectstack-ai#10354 in `ResourceEditPage.tsx`.** "since objectstack#10354
`doPublish` states" gains a comma, "since objectstack `9e04c3e35`,
`doPublish` states", so two adjacent code spans do not read as one.
6. **objectstack-ai#11507 in the 8137 changeset.** "objectstack#11658 executing the
maintainer's 2026-08-24 ruling on objectstack#11507" becomes
"objectstack `1a6a19c31` executing the maintainer's 2026-08-24 ruling":
the executing commit is named, and the ruling is cited by its date.
7. **Line breaks moved** where the stand-in is longer or shorter:
`ActionRunner.ts` (two sites), `ActionParamDialog.tsx`, `theme.ts`,
`theme.zod.ts` (two sites), `index.zod.ts` and the metadata-admin
`i18n.ts` comment, where "ruling on" became "ruling of 2026-08-24,".
8. **The runtime strings.** Only the listed text moves.

| file | member | before | after |
|:--|:--|:--|:--|
| `app-shell/src/layout/activityItemType.ts` | the `console.warn` in
`warnUnmappedActivityType` | "… `sys_activity.type` is author-extensible
(objectstack#11507, ruled 2026-08-24) and is not validated on write …" |
"… `sys_activity.type` is author-extensible (ruled 2026-08-24) and is
not validated on write …" |
| `plugin-detail/src/renderers/recordActivityFeed.ts` | the `warnOnce`
message in `warnUnknownActivityType` | "… `sys_activity.type` is
author-extensible (objectstack#11507, ruled 2026-08-24) and is not
validated on write …" | "… `sys_activity.type` is author-extensible
(ruled 2026-08-24) and is not validated on write …" |

No test, doc or changeset quotes either message with the pointer: the
census reads 0 in `.changeset/`, and the anchor sweep finds no test
literal that drops.
9. **`objectstack-ai#3391/objectstack-ai#3546`.** On the two lines that pair them (`managedBy.ts`,
`ObjectGrid.tsx`), both halves are qualified, as batch 6 qualified both
halves of "#13337/#13086". The other bare `objectstack-ai#3546` lines are not in this
batch's lists and are left (**Acceptance notes** 2).

## The literal-anchor sweep (both test-pin classes, ruling `5861900779`)

- **Instrument.** Every string, template and regex literal in all 4073
tracked test and script files (106544 distinct literals), read with the
TypeScript scanner.
- **Candidate filter.** A literal is a candidate if it matches the
diff's removed lines with two lines of context, raw or
comment-flattened: 1983.
- **Test.** Does its occurrence count DROP between `3b469c8ea` and
`c292a6400` in any of the 74 changed files, raw or comment-flattened?
136 do.
- **Every one is generic:** digits, punctuation, single words ("object",
"blocked", "locked"), character classes, and two regexes that read no
changed file: `/objectui#\d+|objectstack#\d+/` in
`registry-inputs-spec-parity`, which asserts over its own ledger's
reasons, and the older spelling of the three submitRedirect tests'
ruling matcher, quoted in their own doc comments (the live
`CITES_ITS_RULING` asserts over their own refusal text). None is a
changed phrase, a dead number or a changed warning.

## Held

**By the serial rule: nothing.** Open PRs were mapped at branch time (9
open) and again after the push, before this PR opened (11 open). The
second mapping came after the push, not before it; the same three files
were shared both times.

Three open PRs share a file with this PR:
- _Both PRs below have merged since this PR opened (objectui#10945 as
`06a96e948`, objectui#10908 as `b45d463a9`). The trial merge with
today's `main` is clean, and both censuses read 0 on it (contract review
`5870922323`), so nothing is owed. The two rows are kept as the record
at the time._
- **objectui#10945, `RecordDetailView.tsx`.** The blob at its merge-base
equals the branch point's. Its hunks are the imports and one block far
below; this PR's one changed line in that file is far from both.
- **objectui#10908, `types/src/zod/index.zod.ts`.** Its one insertion is
in the export list, far below this PR's two changed comment lines.
- **objectui#10278, `plugin-grid/src/ObjectGrid.tsx`.** The file drifted
between its merge-base and the branch point, so this PR's four changed
lines were mapped onto its merge-base by a line alignment: the nearest
of its hunks is more than 150 lines from any of them.

Trial merges with this head (`git merge-tree --write-tree`):
- clean for objectui#10952, objectstack-ai#10950, objectstack-ai#10949, objectstack-ai#10947, objectstack-ai#10945, objectstack-ai#10944,
objectstack-ai#10930, objectstack-ai#10908 and objectstack-ai#10777;
- objectui#10278 conflicts in `ObjectGrid.tsx`, `plugin-grid/README.md`
and `content/docs/plugins/plugin-grid.mdx`, and conflicts in the same
three files against `main` alone;
- objectui#5400 (Version Packages) regenerates and is not a hold.

`.changeset/9954-read-rate-banner.md` is held by this seat's
objectui#10913 dispatch (PR objectui#10949) and is untouched here. It
carries none of this batch's numbers.

## Changesets

- `.changeset/10803-dead-citation-sweep-seventh-batch.md`, EMPTY
frontmatter. It covers the comment-only edits in 17 released packages;
no published behaviour changes through them. It points at the second
file for the runtime text.
- `.changeset/10803-seventh-batch-runtime-strings.md`,
`'@object-ui/app-shell': patch` and `'@object-ui/plugin-detail': patch`:
the two warnings lose their pointer. What renders, and when and how
often each warning fires, are unchanged.

## Proof of prose-only (C4), against `3b469c8ea`

- **Source.** Each of the 48 touched `.ts` / `.tsx` files was parsed at
`3b469c8ea` and at this head with TypeScript 6.0.3's `createSourceFile`,
and re-printed by `createPrinter({ removeComments: true })`.
  - 46 of 48 prints are identical.
- `activityItemType.ts` and `recordActivityFeed.ts` are equal once the
one listed substitution each (**Special cases** 8) is applied to the
base print, each matched once.
  - 0 parse diagnostics.
- Lit controls on the same instrument: editing a string literal moves
the print; re-spacing a comment does not.
- **Changesets.** The frontmatter block of every one of the 24 edited
changesets is byte-identical at `3b469c8ea` and this head (24 of 24,
md5). The overwrite gate below agrees.
- **Scope of the diff:** 74 files, +157 / −115: 24 edited and 2 new
changesets, and 48 non-test source files in 17 released packages. No
test file.

## Gates, on this head `c292a6400`

Each line is the gate's own verdict and exit code, captured by
redirect-then-`$?`.

- `node scripts/check-changeset-presence.mjs`, exit 0: "48 source
file(s) of 17 released package(s) changed, and this change declares 2
changeset(s): .changeset/10803-dead-citation-sweep-seventh-batch.md,
.changeset/10803-seventh-batch-runtime-strings.md."
- `pnpm changeset:check`, exit 0: "All workspace packages are in the
changeset fixed group." / "No changeset declares a `major` bump."
- `node scripts/check-changeset-overwrite.mjs` (report-only), exit 0: "2
changeset(s) added, 24 modified, 0 deleted". `declared at base` equals
`declares now` for each of the 24.
- `pnpm check:changeset-claims` (report-only), exit 0:
- "Every one of those 1 address(es) either names the tree it was read
from, or points at a line this change does not move";
- "Every package declared across those 22 body(ies) is either not
negated …";
- the standing notice "87 pending changeset(s) describe a file this
change touches". Read against the diff: a pending changeset quoting a
replaced pointer would itself carry a dead number and sit in the census,
which reads 0.
- `pnpm check:control-bytes`, exit 0: "check-control-bytes: OK (scanned
9229 tracked text file(s); skipped 85 binary)." A `grep -P` control-byte
self-scan of the 74 files finds none.
- `pnpm check:new-line-citations`, exit 0: "VERDICT
new-cross-file-line-citations: 0 new citation(s), enforcement
report-only -> exit 0".
- `pnpm check:pending-changeset-literals`, exit 0: "No test source names
a pending changeset."
- Also run over the touched comments:
- `pnpm check:spec-symbols`, exit 0: "spec member citations: 1421
sources + 184 documentation pages; nothing cites a key its spec symbol
does not declare.";
  - `pnpm check:installed-pin-claims`, exit 0 ("OK");
- `pnpm check:comment-mask-corpus`, exit 0 (1 disagreeing file, within
the ceiling objectui#7882 holds open);
- `node scripts/check-hand-rolled-comment-mask.mjs`, exit 0 ("OK every
carrier is a DEBT entry, and every DEBT entry still carries one.");
- `pnpm check:handler-key-reads`, exit 0 ("every judged read is a
declared member of it").
- The governed-surface predicate over the 74 paths, exit 0: "NOT
GOVERNED — 74 path(s) checked against 5 governed surface(s); none
matched." Lit control `AGENTS.md`: exit 3.

**Tests and type-check**, through the shared verify lock, on
`c292a6400`. Each is `VERDICT command-exit 0`.
- `scripts/__tests__/`, the whole directory, whose whole-tree scanners
read the touched files and changesets: `Test Files 177 passed | 2
skipped (179)`, `Tests 5332 passed | 2 skipped (5334)`. The two skipped
files are the network-escape fixtures that run only as a child.
- `packages/types/`, `core/`, `react/`, `i18n/`, `providers/`,
`permissions/` and `data-objectstack/`, whole packages, in one run:
`Test Files 704 passed (704)`, `Tests 13170 passed | 13 skipped
(13183)`.
- The eight touched plugin packages (calendar, designer, detail, form,
grid, kanban, list, tree): `Test Files 787 passed | 1 skipped (788)`,
`Tests 7521 passed | 27 skipped (7548)`.
- `packages/components/`: `Test Files 324 passed | 1 skipped (325)`,
`Tests 3148 passed | 24 skipped (3172)`.
- `packages/app-shell/`: `Test Files 854 passed | 1 skipped (855)`,
`Tests 8789 passed | 9 skipped (8798)`.
- Type-check: `turbo run build` of the 28-package dependency closure
(`Tasks: 28 successful, 28 total`), then `pnpm
--workspace-concurrency=2` with the 17 package filters `run type-check`:
17 script echoes, 17 `Done`. A first attempt before the build exited 2
on an unbuilt dependency (`Cannot find module '@object-ui/types'`) and
measured nothing.
- No red leg: the sweep found no anchor to move, so there is no pin
whose old copy should fail.

CI on `c292a6400`: 43 check-runs, 40 success, 3 skipped, 0 failed; `Spec
Main Shape Gate` success.

## Acceptance notes

1. **Dead objectstack numbers written bare: 10 more lines in the same
two classes.** A bare number resolves to this repository, where each of
these is a live, unrelated card, so no `objectstack#` census sees them.
- **Measurement.** The bare-number instrument of PRs objectui#10875 /
objectstack-ai#10892 / objectstack-ai#10914 reads 965 distinct numbers at this head. The 916 between
100 and 25000 were each read once as objectstack issues: 877 answer 200
and 39 answer 404. Reading the sentences of those 39, three mean an
objectstack card or pull request (below); the other 36 cite objectui
cards or objectui pull requests.
- **objectstack-ai#9934**, 7 lines in 7 files:
`.changeset/7980-agent-key-envelope-read.md`, and in app-shell
`index.ts`, `apiErrorEnvelope.ts` (2), `PackageFormDialog.tsx`,
`StudioDesignSurface.tsx` and `packages-io.ts`. All mean the
`userMessage` channel, objectstack `79c46da90`.
- **"PR objectstack-ai#6281"**, 2 lines in `containers.tsx`, beside objectstack#5775.
The landing is objectstack `85ec26d28`.
- **"objectstack PR objectstack-ai#8452"**, 1 line in `useRecordCrudVerdicts.ts`. The
landing is objectstack `27358d517` ("add batch recordIds to
security/explain (objectstack-ai#8326) (objectstack-ai#8452)").
- None of them sits in a sentence this PR edits, so they are outside
this batch's lists and left. Carrier: this card, triage item 3.
2. **The rest of the bare `objectstack-ai#3546` population.** Five more comment lines
write objectstack#3546 as a bare `objectstack-ai#3546` (`RecordDetailView.tsx` 2,
`RelatedRecordActionsBridge.tsx`, `record-details.tsx`,
`fieldWriteGate.ts`), and one writes it as `objectui#3546`
(`plugin-detail`'s `index.tsx`). Each names the server's effective API
operation set on a detail or form surface. It is live-but-wrong, not a
404, like the `objectstack-ai#3391` class this batch closed. Carrier: none.
3. **A stale label in a comment.** The `ObjectCalendar.tsx` sentence
said objectui#8652 is `pm:blocked`; that card reads `pm:on-hold` today.
**Special cases** 1 says how the repaired sentence avoids the label.
4. **Filenames are not citations.**
`.changeset/17147-plugin-disclosure-not-enforced.md` carries one of the
30 numbers in its name; it stays, as in PRs objectui#10707, objectstack-ai#10797,
objectstack-ai#10854, objectstack-ai#10869, objectstack-ai#10875, objectstack-ai#10892 and objectstack-ai#10914.

---
_Generated by [Claude
Code](https://claude.ai/code/session_01DuWo5bdP9SdVebamn99GGk)_

_Tests block completed by the `domain:ui` seat objectstack-ai#1 from the dev report
`5870507620` (the suites that finished after this PR opened), and three
figures corrected after contract review `5870922323` (the objectstack-ai#9933 and
objectstack-ai#6515 quotes, and the Held rows); no code claim moved._

Co-authored-by: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Bind the in-app assistant dock's build thread to the current app (reverses ADR-0057 A1.b per maintainer ruling)

2 participants