@productbrain/cli 0.1.0-beta.55 → 0.1.0-beta.5504

package/dist/formatters/handshake.d.ts

@@ -5,6 +5,7 @@ import type { SearchResult } from './search.js';
 import type { RepoContext } from '../lib/repo-detect.js';
 import type { CodexValidationWarning } from '../generators/portable-knowledge.js';
 import type { ChainRulesStats } from '../generators/chain-rules.js';
+export type PreviewStatus = 'would-write' | 'would-update' | 'unchanged' | 'user-owned' | 'filtered' | 'would-augment' | 'needs-attention';
 export interface HandshakeReport {
     filesWritten: string[];
     filesSkipped: Array<{
@@ -19,6 +20,44 @@ export interface HandshakeReport {
     chainRulesStats?: ChainRulesStats;
     /** Governance function keys that had no matching entries (when --generate was used). */
     chainGaps?: string[];
+    /** Rules that passed the adopted allowlist filter (when manifest.yaml present). */
+    adoptedCount?: number;
+    /** Rules excluded by the rejected denylist (when manifest.yaml present). */
+    rejectedCount?: number;
+    /** Number of personal rules loaded from .productbrain/.local/rules/ (local only, never committed). */
+    personalRuleCount?: number;
+    /** Number of personal skills loaded from .productbrain/.local/skills/ (local only, never committed). */
+    personalSkillCount?: number;
+    /** Source the method registry was loaded from (present when manifest is set). */
+    /** Always 'bundled' — the Chain registry path was removed (TEN-2783). */
+    registrySource?: 'bundled';
+    /** true when registrySource is 'bundled' and the snapshot is older than 7 days. */
+    registryStale?: boolean;
+    /** true when running in preview mode (no files written — run with --apply to write). */
+    preview?: boolean;
+    /** Structured plan for preview mode output. */
+    previewPlan?: Array<{
+        path: string;
+        status: PreviewStatus;
+    }>;
+    /**
+     * Adapter paths that are user-owned (exist without the auto-gen MARKER) — handshake
+     * left them untouched. Relayed to the connect screen so it does not falsely report
+     * them as synced (TEN-2107). NEVER treated as drift: no warning, no TEN (TEN-2150).
+     */
+    userOwnedSkipped?: string[];
+    /** Count of PB-managed files whose marker + embedded hash trailer matched the body (clean). */
+    managedCleanCount?: number;
+    /** Tampered files refused in headless mode — present only in the headless refusal report. */
+    tamperedFiles?: Array<{
+        path: string;
+        expectedHash: string;
+        actualHash: string;
+    }>;
+    /** Tampered projection paths the user chose to ADOPT (captured as personal-scoped drafts). */
+    adoptedTamperedPaths?: string[];
+    /** Tampered projection paths the user chose to REVERT (overwritten with canonical content). */
+    revertedTamperedPaths?: string[];
 }
 export declare function formatHandshakeReport(report: HandshakeReport): string;
 //# sourceMappingURL=handshake.d.ts.map

package/dist/formatters/handshake.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../src/formatters/handshake.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,aAAa,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACzC,yEAAyE;IACzE,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAyErE"}
+{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../src/formatters/handshake.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,cAAc,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAE3I,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,aAAa,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACzC,yEAAyE;IACzE,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sGAAsG;IACtG,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wGAAwG;IACxG,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iFAAiF;IACjF,yEAAyE;IACzE,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,mFAAmF;IACnF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wFAAwF;IACxF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;IAC7D;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6FAA6F;IAC7F,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClF,8FAA8F;IAC9F,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,+FAA+F;IAC/F,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CA6MrE"}

package/dist/formatters/handshake.js

@@ -3,11 +3,68 @@
  */
 export function formatHandshakeReport(report) {
     const lines = [];
+    const name = report.repo.name ?? 'unknown';
+    const slug = report.repo.repoSlug ? ` (${report.repo.repoSlug})` : '';
+    if (report.preview && report.previewPlan) {
+        // Preview mode output
+        lines.push('pb handshake — preview (run with --apply to write)');
+        lines.push('');
+        lines.push(`Repo: ${name}${slug}`);
+        if (report.repo.detectedStack.length > 0) {
+            lines.push(`Stack: ${report.repo.detectedStack.join(', ')}`);
+        }
+        lines.push('');
+        lines.push('Plan:');
+        const statusSymbol = {
+            'would-write': '+',
+            'would-update': '↑',
+            'unchanged': '✓',
+            'user-owned': '○',
+            'filtered': '·',
+            'would-augment': '✚',
+            'needs-attention': '⚠',
+        };
+        const statusLabel = {
+            'would-write': 'would write',
+            'would-update': 'would update',
+            'unchanged': 'unchanged',
+            'user-owned': 'user-owned — left untouched (pb won\'t overwrite your file)',
+            'filtered': 'filtered by surface',
+            'would-augment': 'would augment — add a PB region; your content untouched',
+            'needs-attention': 'malformed PB region — left untouched; fix the pb:region sentinels',
+        };
+        for (const item of report.previewPlan) {
+            lines.push(`  ${statusSymbol[item.status]} ${item.path}  (${statusLabel[item.status]})`);
+        }
+        const wouldWrite = report.previewPlan.filter((i) => i.status === 'would-write' || i.status === 'would-update').length;
+        const unchanged = report.previewPlan.filter((i) => i.status === 'unchanged').length;
+        const userOwned = report.previewPlan.filter((i) => i.status === 'user-owned').length;
+        const filtered = report.previewPlan.filter((i) => i.status === 'filtered').length;
+        const wouldAugment = report.previewPlan.filter((i) => i.status === 'would-augment').length;
+        const needsAttention = report.previewPlan.filter((i) => i.status === 'needs-attention').length;
+        const summary = [];
+        if (wouldWrite > 0)
+            summary.push(`${wouldWrite} would write`);
+        if (unchanged > 0)
+            summary.push(`${unchanged} unchanged`);
+        if (userOwned > 0)
+            summary.push(`${userOwned} user-owned`);
+        if (filtered > 0)
+            summary.push(`${filtered} filtered`);
+        if (wouldAugment > 0)
+            summary.push(`${wouldAugment} would augment`);
+        if (needsAttention > 0)
+            summary.push(`${needsAttention} need attention`);
+        lines.push('');
+        lines.push(`  ${summary.join(', ')}`);
+        lines.push('');
+        lines.push('Run `pb handshake --apply` to write these files.');
+        return lines.join('\n');
+    }
+    // Apply / dry-run mode output (existing format)
     lines.push('pb handshake — context files generated');
     lines.push('');
     // Repo info
-    const name = report.repo.name ?? 'unknown';
-    const slug = report.repo.repoSlug ? ` (${report.repo.repoSlug})` : '';
     lines.push(`Repo: ${name}${slug}`);
     if (report.repo.detectedStack.length > 0) {
         lines.push(`Stack: ${report.repo.detectedStack.join(', ')}`);
@@ -60,8 +117,81 @@ export function formatHandshakeReport(report) {
         lines.push('  (These references may not work in Codex. Consider transport sections or targets.)');
         lines.push('');
     }
+    // Manifest adoption counts
+    if (report.adoptedCount !== undefined || report.rejectedCount !== undefined) {
+        const parts = [];
+        if (report.adoptedCount !== undefined)
+            parts.push(`${report.adoptedCount} adopted`);
+        if (report.rejectedCount !== undefined)
+            parts.push(`${report.rejectedCount} rejected`);
+        if (parts.length > 0) {
+            lines.push(`Manifest filter: ${parts.join(', ')}`);
+            lines.push('');
+        }
+    }
+    // Personal layer
+    const personalItems = [];
+    if (report.personalRuleCount !== undefined && report.personalRuleCount > 0) {
+        personalItems.push(`${report.personalRuleCount} rule(s)`);
+    }
+    if (report.personalSkillCount !== undefined && report.personalSkillCount > 0) {
+        personalItems.push(`${report.personalSkillCount} skill(s)`);
+    }
+    if (personalItems.length > 0) {
+        lines.push(`Personal layer (local only): ${personalItems.join(', ')}`);
+        lines.push('');
+    }
+    // Method registry (bundled-only since TEN-2783). The registry ships INSIDE the pb CLI package
+    // (templates/method-registry.json), so the only way to refresh it is to update the CLI — NOT
+    // `pb handshake`, which just re-reads the same bundled snapshot (that guidance was a dead-end
+    // left over from the removed Chain path). The staleness signal is kept as an "your CLI is old"
+    // nudge, now pointing at the real refresh path.
+    if (report.registrySource !== undefined) {
+        if (report.registryStale) {
+            lines.push('⚠ Method registry: bundled snapshot >7 days old — update the pb CLI to refresh (it ships with the package)');
+        }
+        else {
+            lines.push('✓ Method registry: bundled');
+        }
+        lines.push('');
+    }
+    // User-owned files (no auto-gen MARKER) are left untouched and already appear
+    // under "Skipped:" above. They are NOT drift: handshake never wrote them, so
+    // there is nothing to "sync" and no draft TEN is logged (TEN-2150). Relayed to
+    // the connect screen via report.userOwnedSkipped, not surfaced as a warning here.
+    // ── WP-421 S3 (doneWhen #17): drift report ────────────────────────────────
+    // Drift concerns PB-managed files only: PB-managed-clean / PB-managed-tampered
+    // (refused or resolved). user-owned files are benign skips (left untouched) and
+    // are NEVER drift — so they are not a bucket in this report (TEN-2150); they
+    // already appear under "Skipped:" above.
+    const cleanCount = report.managedCleanCount ?? 0;
+    const tamperedCount = (report.tamperedFiles?.length ?? 0)
+        + (report.adoptedTamperedPaths?.length ?? 0)
+        + (report.revertedTamperedPaths?.length ?? 0);
+    if (cleanCount > 0 || tamperedCount > 0) {
+        lines.push('Drift report (2 buckets):');
+        lines.push(`  PB-managed-clean:    ${cleanCount}`);
+        lines.push(`  PB-managed-tampered: ${tamperedCount}`);
+        if (report.tamperedFiles && report.tamperedFiles.length > 0) {
+            lines.push('  Tampered (refused — headless mode):');
+            for (const t of report.tamperedFiles) {
+                lines.push(`    ${t.path}  (expected ${t.expectedHash}, actual ${t.actualHash})`);
+            }
+        }
+        if (report.adoptedTamperedPaths && report.adoptedTamperedPaths.length > 0) {
+            lines.push('  Tampered (adopted as personal-scoped drafts):');
+            for (const p of report.adoptedTamperedPaths)
+                lines.push(`    ${p}`);
+        }
+        if (report.revertedTamperedPaths && report.revertedTamperedPaths.length > 0) {
+            lines.push('  Tampered (reverted to canonical):');
+            for (const p of report.revertedTamperedPaths)
+                lines.push(`    ${p}`);
+        }
+        lines.push('');
+    }
     lines.push('Tip: Add .productbrain/ to .gitignore (contains workspace-specific context).');
-    lines.push('     Adapter files (AGENTS.md, .codex/skills/, CLAUDE.md, .cursor/rules/, .claude/rules/, .github/) are safe to commit.');
+    lines.push('     Adapter files are local-only — never commit them. Regenerate on demand with `pb handshake --apply`.');
     lines.push('');
     lines.push('Run `pb handshake` again to refresh.');
     return lines.join('\n');

package/dist/formatters/handshake.js.map

@@ -1 +1 @@
-{"version":3,"file":"handshake.js","sourceRoot":"","sources":["../../src/formatters/handshake.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handshake.js","sourceRoot":"","sources":["../../src/formatters/handshake.ts"],"names":[],"mappings":"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"}

package/dist/formatters/orient.coherencyCheckTag.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=orient.coherencyCheckTag.test.d.ts.map

package/dist/formatters/orient.coherencyCheckTag.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orient.coherencyCheckTag.test.d.ts","sourceRoot":"","sources":["../../src/formatters/orient.coherencyCheckTag.test.ts"],"names":[],"mappings":""}

package/dist/formatters/orient.coherencyCheckTag.test.js

@@ -0,0 +1,22 @@
+/**
+ * TEN-2746 §2c part 3 — coherencyCheckTag's 'stale' branch (the CLI-visible surface for
+ * an active entry edited since its last successful contradiction check). Pins the two
+ * existing branches too, as a regression guard while adding the third.
+ */
+import { describe, expect, it } from 'vitest';
+import { coherencyCheckTag } from './orient.js';
+describe('coherencyCheckTag', () => {
+    it('renders "[not checked]" for not_checked', () => {
+        expect(coherencyCheckTag('not_checked')).toBe(' [not checked]');
+    });
+    it('renders "[check incomplete]" for check_incomplete', () => {
+        expect(coherencyCheckTag('check_incomplete')).toBe(' [check incomplete]');
+    });
+    it('renders "[stale — entry changed since last check]" for stale (TEN-2746)', () => {
+        expect(coherencyCheckTag('stale')).toBe(' [stale — entry changed since last check]');
+    });
+    it('renders empty string for undefined (fresh/never-checked-silently)', () => {
+        expect(coherencyCheckTag(undefined)).toBe('');
+    });
+});
+//# sourceMappingURL=orient.coherencyCheckTag.test.js.map

package/dist/formatters/orient.coherencyCheckTag.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orient.coherencyCheckTag.test.js","sourceRoot":"","sources":["../../src/formatters/orient.coherencyCheckTag.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/formatters/orient.d.ts

@@ -1,19 +1,76 @@
-/**
- * Orient formatter — full ARCH-25 sections for CLI display.
- * Chain: DEC-186 (CLI uses Convex view model with CLI-native formatting).
- */
+/** Orient formatter — full ARCH-25 sections for CLI display. Chain: DEC-186. WP-436 S2: vocabulary
+ *  labels resolved via getCollectionLabel (PAT-230, DEC-1021 Axis 2) — falls back to canonicalKey. */
+import { type WorkspaceVocabCtx } from '../lib/canonicalRefs.js';
+import { coherencyCheckTag } from './orientDegradation.js';
+import { formatShapeAdvisorySummaryLine, type OrientDirectionStrategyHighlight } from './orientDirection.js';
+export { coherencyCheckTag, formatShapeAdvisorySummaryLine };
+/** WP-465 slice ③ (DEC-1277 §4.1): structural mirror of the served OrientTaskAlignment payload
+ *  (TEN-2278: CLI can't import convex/); the CLI only renders wording/candidates/escape routes. */
+export interface TaskAlignmentView {
+    verdict: 'aligned' | 'misaligned' | 'cold-start' | 'unavailable' | 'abstain';
+    disposition: 'allow' | 'advisory';
+    coldStart: boolean;
+    matchedEntry: {
+        entryId: string | null;
+        name: string;
+    } | null;
+    matchSource: 'active_work_package' | 'task_context' | null;
+    activeWorkPackageCount: number;
+    candidates: Array<{
+        entryId: string;
+        name: string;
+        collectionSlug: string;
+        overlapRatio: number;
+    }>;
+    escapeRoutes: Array<{
+        kind: 'link' | 'draft-proposal' | 'record-divergence';
+        instruction: string;
+    }>;
+    citedRule: {
+        entryId: string | null;
+        name: string;
+    } | null;
+    wording: string;
+}
+export interface RetrievalMissView {
+    served: 'ok' | 'low' | 'miss';
+    kind: string | null;
+    confidence: number;
+    rubricVersion: string;
+}
 export interface OrientView {
     stage: string;
+    /** WP-381 S5: STD-221 budget envelope. JSON/piped output preserves this verbatim. */
+    _budget?: BudgetFlags;
+    /** WP-465 slice ③ (§4.1): top-level, budget-exempt — identical on CLI and MCP. */
+    taskAlignment?: TaskAlignmentView;
+    /** WP-621 S1: names which task preload(s), if any, fell back to a typed-empty default this run. */
+    degradedPreloads?: string[];
+    /** WP-582 B2: pre-rendered rituals one-liners (server-computed, TEN-2278). No-row = null/absent. */
+    directionLine?: string | null;
+    verdictAskLine?: string;
+    spineLine?: string | null;
+    /** D1 residue fix (named item c): data-driven — absent/null means nothing to disclose. */
+    atCapLine?: string | null;
+    /** Orient-fix: true only when the server's own getRitualsSurface call failed open this run. */
+    fetchFailed?: boolean;
+    retrievalMiss?: RetrievalMissView;
     strategicContext: {
         vision: string | null;
         purpose: string | null;
         activeBetCount: number;
-        currentBet: string | null;
+        activeWorkPackageCount: number;
+        /** WP-436 S4: canonical field — legacy currentBet dropped. */
+        currentWorkPackage: string | null;
         activeTensionCount: number;
         productAreas: string[];
         productAreaCount: number;
     };
-    activeBets: Array<{
+    /** WP-622 (grounding S2): metadata-driven strategy/principle highlights — never rendered by
+     *  the CLI before this slice; may be a floor-reduced top-K when the byte budget squeezed. */
+    strategyHighlights?: OrientDirectionStrategyHighlight[];
+    /** WP-436 S4: canonical field — legacy activeBets dropped. */
+    activeWorkPackages: Array<{
         entryId: string | null;
         name: string;
         collectionSlug: string | null;
@@ -24,9 +81,13 @@ export interface OrientView {
             entryId: string | null;
             name: string;
         }>;
+        /** WP-485 Slice 1: present only when latest contradiction-check is partial/unavailable
+         *  (TEN-2746 §2c added 'stale'); hand-mirrors orientView.ts (TEN-2278: no convex/ import). */
+        coherencyCheckStatus?: 'not_checked' | 'check_incomplete' | 'stale';
     }>;
     governance: {
         principles: Array<{
+            _id?: string;
             entryId: string | null;
             name: string;
             collectionSlug: string | null;
@@ -34,8 +95,17 @@ export interface OrientView {
             preview?: string;
             scoreFlags?: string[];
             origin?: 'human' | 'agent' | 'external';
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
+            why?: string;
+            whyQuality?: 'rationale' | 'missing' | 'restated';
+            possibleConflict?: {
+                kind: string;
+                label: string;
+            };
         }>;
         standards: Array<{
+            _id?: string;
             entryId: string | null;
             name: string;
             collectionSlug: string | null;
@@ -43,8 +113,17 @@ export interface OrientView {
             preview?: string;
             scoreFlags?: string[];
             origin?: 'human' | 'agent' | 'external';
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
+            why?: string;
+            whyQuality?: 'rationale' | 'missing' | 'restated';
+            possibleConflict?: {
+                kind: string;
+                label: string;
+            };
         }>;
         businessRules: Array<{
+            _id?: string;
             entryId: string | null;
             name: string;
             collectionSlug: string | null;
@@ -52,8 +131,24 @@ export interface OrientView {
             preview?: string;
             scoreFlags?: string[];
             origin?: 'human' | 'agent' | 'external';
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
+            why?: string;
+            whyQuality?: 'rationale' | 'missing' | 'restated';
+            possibleConflict?: {
+                kind: string;
+                label: string;
+            };
         }>;
     };
+    /** TEN-2449: server-selected brief rows (kernel brief policy), present only when
+     *  renderMode:'brief' — rendered exactly, not re-sliced, so M1 log and screen agree. */
+    governanceRendered?: Array<{
+        entryDocId: string;
+        entryId: string | null;
+        bucket: 'principles' | 'standards' | 'businessRules';
+        tier: number;
+    }>;
     tensions: Array<{
         entryId: string | null;
         name: string;
@@ -62,6 +157,10 @@ export interface OrientView {
         entryId: string | null;
         name: string;
         preview?: string;
+        provenance?: 'authoritative' | 'provisional' | 'floor';
+        anchoredBy?: string;
+        why?: string;
+        whyQuality?: 'rationale' | 'missing' | 'restated';
     }>;
     proposals: Array<{
         targetEntryName: string;
@@ -82,6 +181,10 @@ export interface OrientView {
             entryId: string | null;
             name: string;
             collectionSlug: string | null;
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
+            why?: string;
+            whyQuality?: 'rationale' | 'missing' | 'restated';
         }>;
         bindingGovernance: {
             principles: Array<{
@@ -89,20 +192,88 @@ export interface OrientView {
                 name: string;
                 collectionSlug: string | null;
                 preview?: string;
+                provenance?: 'authoritative' | 'provisional' | 'floor';
+                anchoredBy?: string;
+                why?: string;
+                whyQuality?: 'rationale' | 'missing' | 'restated';
+                possibleConflict?: {
+                    kind: string;
+                    label: string;
+                };
             }>;
             standards: Array<{
                 entryId: string | null;
                 name: string;
                 collectionSlug: string | null;
                 preview?: string;
+                provenance?: 'authoritative' | 'provisional' | 'floor';
+                anchoredBy?: string;
+                why?: string;
+                whyQuality?: 'rationale' | 'missing' | 'restated';
+                possibleConflict?: {
+                    kind: string;
+                    label: string;
+                };
             }>;
             businessRules: Array<{
                 entryId: string | null;
                 name: string;
                 collectionSlug: string | null;
                 preview?: string;
+                provenance?: 'authoritative' | 'provisional' | 'floor';
+                anchoredBy?: string;
+                why?: string;
+                whyQuality?: 'rationale' | 'missing' | 'restated';
+                possibleConflict?: {
+                    kind: string;
+                    label: string;
+                };
+            }>;
+            byCollection?: Array<{
+                collectionSlug: string | null;
+                collectionName: string | null;
+                canonicalKey: string | null;
+                entries: Array<{
+                    entryId: string | null;
+                    name: string;
+                    collectionSlug: string | null;
+                    preview?: string;
+                    provenance?: 'authoritative' | 'provisional' | 'floor';
+                    anchoredBy?: string;
+                    why?: string;
+                    whyQuality?: 'rationale' | 'missing' | 'restated';
+                    possibleConflict?: {
+                        kind: string;
+                        label: string;
+                    };
+                }>;
             }>;
         };
+        domainRetrieval?: {
+            state: string;
+            resolvedDomainSlug?: string;
+            fallbackReason?: string;
+            fallbackAction?: string;
+            evidenceGap?: string;
+            directRatifiedCount?: number;
+            inheritedRatifiedCount?: number;
+            orgFallbackCount?: number;
+            activeSource?: string;
+            legacyUnauditedCount?: number;
+            invalidRelationCount?: number;
+            nonOverlapMetric?: {
+                status: string;
+                value?: number;
+                reason?: string;
+                action?: string;
+            };
+            primerByteDelta?: {
+                status: string;
+                value?: number;
+                reason?: string;
+                action?: string;
+            };
+        };
         steeringContext: Array<{
             entryId: string | null;
             name: string;
@@ -132,6 +303,10 @@ export interface OrientView {
             entryId: string | null;
             name: string;
             collectionSlug: string | null;
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
+            why?: string;
+            whyQuality?: 'rationale' | 'missing' | 'restated';
         }>;
         context: Array<{
             entryId: string | null;
@@ -140,14 +315,26 @@ export interface OrientView {
             score: number;
             hop: number;
             origin?: 'human' | 'agent' | 'external';
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
+            why?: string;
+            whyQuality?: 'rationale' | 'missing' | 'restated';
         }>;
         totalFound: number;
         confidence: string;
+        /** STD-219 §4 (DEC-1147): set when taskContext is a truncation stub, not full grounding. */
+        isGroundingStub?: true;
+        groundingNote?: string;
     };
     plannedWork: {
         uncommittedDrafts: Array<{
             name: string;
             collection: string;
+            why?: string;
+            whyQuality?: 'rationale' | 'missing' | 'restated';
+            visibility?: string;
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
         }>;
         inProgressEntries: Array<{
             name: string;
@@ -197,9 +384,59 @@ export interface OrientView {
         collectionSlug: string;
         hint: string;
     }>;
+    /** WP-557: mirrors orient-shared.ts's ShapeAdvisorySummaryView (precision.ts's ShapeAdvisorySummary). */
+    shapeAdvisorySummary?: {
+        windowDays: number;
+        compoundTotal: number;
+        pendingCount: number;
+        pendingRate: number | null;
+        precisionAgent: number | null;
+        precisionAgentN: number;
+        precisionHuman: number | null;
+        precisionHumanN: number;
+        precisionHumanNote: string | null;
+        candidateRateBySource: Record<string, number | null>;
+        candidateCountBySource?: Record<string, number>;
+        scanTruncated: boolean;
+    };
 }
+export interface BudgetFlags {
+    advisory?: boolean;
+    warning?: boolean;
+    emergencyCapped?: boolean;
+    truncated?: boolean;
+    overflowed?: boolean;
+    breachTier?: 'none' | 'advisory' | 'warning' | 'emergency';
+    queryName?: string;
+    attribution?: {
+        feature?: string;
+        route?: string;
+    };
+}
+/** Phase 4 (DEC-1141): compact single-char provenance marker — ★ authoritative (ratified domain),
+ *  ~ provisional (live, not ratified), · floor (pre-Phase-2 legacy); empty when absent. */
+export declare function provenanceMark(p?: string): string;
+export declare function formatEntryList(items: Array<{
+    entryId: string | null;
+    name: string;
+    preview?: string;
+    provenance?: string;
+    anchoredBy?: string;
+    whyQuality?: 'rationale' | 'missing' | 'restated';
+    possibleConflict?: {
+        kind: string;
+        label: string;
+    };
+}>, max?: number): string[];
+/** WP-582 B2 (FEAT-1404): rituals one-liners, shared by formatOrient/formatOrientBrief.
+ *  direction/spine always render (fallback line); verdictAsk only when non-empty. Orient-fix:
+ *  `fetchFailed` mirrors the client-side "unavailable, retry" posture for a server-side degrade. */
+export declare function buildRitualsSurfaceLines(view: Pick<OrientView, 'directionLine' | 'verdictAskLine' | 'spineLine' | 'atCapLine' | 'fetchFailed'>): string[];
 /** Full orient output — all sections per ARCH-25. */
-export declare function formatOrient(view: OrientView): string;
+export declare function formatOrient(view: OrientView, vocabCtx?: WorkspaceVocabCtx): string;
+/** Codex variant — the SAME governance body `formatOrient` emits verbatim, wrapped with the
+ *  framing `.codex/task-context.md` relies on (HTML-comment stamp, title, footer). */
+export declare function formatOrientCodex(view: OrientView, task: string, vocabCtx?: WorkspaceVocabCtx): string;
 /** Compact view — stage, counts, top bets, tensions, planned work, recovery. */
-export declare function formatOrientBrief(view: OrientView): string;
+export declare function formatOrientBrief(view: OrientView, vocabCtx?: WorkspaceVocabCtx): string;
 //# sourceMappingURL=orient.d.ts.map