@productbrain/cli 0.1.0-beta.1 → 0.1.0-beta.1000

package/dist/commands/audit.js

@@ -0,0 +1,215 @@
+/**
+ * pb audit <BET-ID> [BET-ID...] — automated STD-113 hygiene checker.
+ * BET-182 Slice 2: CLI command + auto-fix.
+ *
+ * Calls chain.auditBet via MCP, formats result for TTY or JSON,
+ * and exits with code based on verdict:
+ *   0 = pass, 1 = fail, 2 = warn, 3 = error
+ *
+ * Flags:
+ *   --phase shaping|handoff  — override phase detection
+ *   --gate gate-name         — run only specified gate(s), repeatable
+ *   --fix                    — auto-execute "exact" fixType fixes via pb update
+ *   --verbose                — show all gates including PASS detail
+ *
+ * Chain: BET-182, STD-113, STD-65 (structured output), STD-101
+ */
+import { getConfigOrGuide } from '../lib/config.js';
+import { kernelCall, kernelCallWithSession } from '../lib/client.js';
+import { isJsonMode } from '../lib/runner.js';
+import { readSession } from '../lib/session.js';
+import { stripConvexInternals } from '../lib/strip.js';
+import { formatAudit, formatBatchSummary } from '../formatters/audit.js';
+import { getOrFetchVocabCtx } from '../lib/workspaceVocabCache.js';
+import { replaceVocabTokens } from '../lib/canonicalRefs.js';
+// Exit codes
+const EXIT_PASS = 0;
+const EXIT_FAIL = 1;
+const EXIT_WARN = 2;
+const EXIT_ERROR = 3;
+function parseExactFixes(entryId, gates) {
+    const actions = [];
+    for (const gate of gates) {
+        if (gate.status !== 'fail' && gate.status !== 'warn')
+            continue;
+        if (gate.fixType !== 'exact' || !gate.fix)
+            continue;
+        // Parse "Set field '<key>' to '<value>'" pattern
+        const fieldMatch = gate.fix.match(/^Set field '([^']+)' to '([^']+)'$/);
+        if (fieldMatch) {
+            actions.push({
+                type: 'field',
+                entryId,
+                fieldKey: fieldMatch[1],
+                fieldValue: fieldMatch[2],
+            });
+        }
+    }
+    return actions;
+}
+async function executeFixActions(actions, json) {
+    let applied = 0;
+    for (const action of actions) {
+        if (action.type === 'field') {
+            try {
+                await kernelCallWithSession('chain.updateEntry', {
+                    entryId: action.entryId,
+                    data: { [action.fieldKey]: action.fieldValue },
+                    changeNote: `Auto-fix via pb audit: set ${action.fieldKey}`,
+                });
+                applied++;
+                if (!json) {
+                    process.stderr.write(`  Fixed: ${action.fieldKey} = ${action.fieldValue}\n`);
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (!json) {
+                    process.stderr.write(`  Fix failed (${action.fieldKey}): ${msg}\n`);
+                }
+            }
+        }
+    }
+    return applied;
+}
+// ─── Single audit ───────────────────────────────────────────────────────────
+async function auditOne(entryId, options) {
+    const { phase, gate: gateFilter, fix, verbose, vocabCtx } = options;
+    const json = isJsonMode();
+    // Build MCP args
+    const args = { entryId };
+    if (phase)
+        args.phase = phase;
+    let result;
+    try {
+        result = await kernelCall('chain.auditBet', args);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (json) {
+            process.stderr.write(JSON.stringify({ error: msg, entryId }) + '\n');
+        }
+        else {
+            process.stderr.write(`Error auditing ${entryId}: ${msg}\n`);
+        }
+        return { result: null, exitCode: EXIT_ERROR };
+    }
+    // --fix: auto-execute exact fixes, then rerun once
+    if (fix) {
+        const session = readSession();
+        if (!session) {
+            if (!json) {
+                process.stderr.write('--fix requires an active session. Run `pb session start` first.\n');
+            }
+            // Still show the result, just skip fixing
+        }
+        else {
+            const exactFixes = parseExactFixes(entryId, result.gates);
+            if (exactFixes.length > 0) {
+                if (!json)
+                    process.stderr.write(`\nAuto-fixing ${exactFixes.length} issue(s) on ${entryId}...\n`);
+                const applied = await executeFixActions(exactFixes, json);
+                if (applied > 0) {
+                    // Rerun audit once after fixes
+                    if (!json)
+                        process.stderr.write(`\nRe-auditing ${entryId} after ${applied} fix(es)...\n`);
+                    try {
+                        result = await kernelCall('chain.auditBet', args);
+                    }
+                    catch (err) {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        if (!json)
+                            process.stderr.write(`Re-audit failed: ${msg}\n`);
+                        // Use original result
+                    }
+                }
+            }
+        }
+    }
+    // WP-438 S1: resolve {{vocab:...}} tokens on each gate field flagged with
+    // tokens.* === true. Workspace vocab is fetched once per CLI invocation and
+    // passed through `options.vocabCtx`. Fail-open: when ctx is undefined the
+    // resolver falls back to the canonicalKey literal.
+    for (const gate of result.gates) {
+        if (gate.tokens?.detail)
+            gate.detail = replaceVocabTokens(gate.detail, vocabCtx);
+        if (gate.tokens?.fix && gate.fix)
+            gate.fix = replaceVocabTokens(gate.fix, vocabCtx);
+        if (gate.tokens?.hint && gate.hint)
+            gate.hint = replaceVocabTokens(gate.hint, vocabCtx);
+    }
+    // Output
+    if (json) {
+        // Apply gate filter for JSON output too
+        const output = { ...stripConvexInternals(result) };
+        if (gateFilter && gateFilter.length > 0) {
+            output.gates = result.gates.filter((g) => gateFilter.includes(g.gate));
+        }
+        process.stdout.write(JSON.stringify(output) + '\n');
+    }
+    else {
+        process.stdout.write(formatAudit(result, { verbose, gateFilter }) + '\n');
+    }
+    // Map verdict to exit code
+    const exitCode = result.verdict === 'pass' ? EXIT_PASS
+        : result.verdict === 'fail' ? EXIT_FAIL
+            : EXIT_WARN;
+    return { result, exitCode };
+}
+// ─── Entry point ────────────────────────────────────────────────────────────
+export async function runAudit(options) {
+    const config = await getConfigOrGuide(() => runAudit(options));
+    if (!config)
+        return;
+    const { entryIds, ...rest } = options;
+    // WP-438 S1: load workspace vocabulary once for the whole batch (PAT-230,
+    // DEC-1021). Cached for 5 min via the shared workspaceVocabCache. Fail-open.
+    const vocabCtx = await getOrFetchVocabCtx(config.apiKey, async () => {
+        const vocab = await kernelCall('chain.getVocabulary', {});
+        if (vocab?.collectionLabels || vocab?.collectionDefaults) {
+            return {
+                ...(vocab.collectionLabels ? { collectionLabels: vocab.collectionLabels } : {}),
+                ...(vocab.collectionDefaults ? { collectionDefaults: vocab.collectionDefaults } : {}),
+            };
+        }
+        return null;
+    });
+    const restWithVocab = { ...rest, vocabCtx };
+    if (entryIds.length === 1) {
+        // Single audit
+        const { exitCode } = await auditOne(entryIds[0], restWithVocab);
+        process.exit(exitCode);
+    }
+    // Batch mode: audit multiple bets sequentially
+    const json = isJsonMode();
+    const results = [];
+    let worstExit = EXIT_PASS;
+    for (const entryId of entryIds) {
+        const { result, exitCode } = await auditOne(entryId, restWithVocab);
+        if (result)
+            results.push(result);
+        if (exitCode > worstExit)
+            worstExit = exitCode;
+        // Separator between entries in TTY mode
+        if (!json && entryIds.indexOf(entryId) < entryIds.length - 1) {
+            process.stdout.write('\n---\n\n');
+        }
+    }
+    // Batch summary
+    if (results.length > 1) {
+        if (json) {
+            process.stdout.write(JSON.stringify({
+                batch: true,
+                count: results.length,
+                passed: results.filter((r) => r.verdict === 'pass').length,
+                failed: results.filter((r) => r.verdict === 'fail').length,
+                warned: results.filter((r) => r.verdict === 'warn').length,
+            }) + '\n');
+        }
+        else {
+            process.stdout.write(formatBatchSummary(results) + '\n');
+        }
+    }
+    process.exit(worstExit);
+}
+//# sourceMappingURL=audit.js.map

package/dist/commands/audit.js.map

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

package/dist/commands/authority-domains.d.ts

@@ -0,0 +1,146 @@
+type Metric = {
+    status: 'measured';
+    value: number;
+    measuredAt?: number;
+} | {
+    status: 'unmeasured';
+    reason?: string;
+    action?: string;
+};
+export interface AuthorityDomainReadinessResult {
+    state: string;
+    activeSource: string;
+    evidenceGap: string;
+    nextAction: string;
+    rootDomains: {
+        seededRootDomainCount: number;
+        missingRootDomains: string[];
+        missingRequiredDomainSlugs: string[];
+        legacyAliasCoverage: Record<string, boolean>;
+        graphAcyclic: boolean;
+        graphDepthValid: boolean;
+    };
+    proposals: {
+        pendingDomainTagCount: number;
+        ratifiedDomainTagCount: number;
+        rejectedDomainTagCount: number;
+        skippedDomainTagCount: number;
+        legacyUnauditedRelationCount: number;
+        invalidRelationCount: number;
+        auditedCoveragePercent: number;
+        proposeAbstainBreakdown?: {
+            decisionsAbstainedCount: number;
+            standardsAbstainedCount: number;
+            principlesAbstainedCount: number;
+            businessRulesAbstainedCount: number;
+            businessRulesEmptyDomainFallthroughCount: number;
+        };
+        eligibleGovernanceCount?: number;
+        intentionallyAbstainedCount?: number;
+        auditedEligibleCoveragePercent?: number;
+        eligibilityFloorMet?: boolean;
+        rejectionRateTrend?: number;
+        authorityDomainTrajectoryStatus?: string;
+    };
+    orient: {
+        orientFallbackCounts: Record<string, number>;
+        orientNonOverlapMetric: Metric;
+        primerByteDelta: Metric;
+        accuracySample: Metric;
+        benchmarkId?: string;
+        valueProof: {
+            state: string;
+            reason: string;
+        };
+    };
+    cutover: {
+        activated: boolean;
+        benchmarkId?: string;
+    };
+}
+export interface AuthorityDomainBenchmarkResult {
+    benchmarkId: string;
+    nonOverlapMetric: number;
+    primerByteDelta: number;
+    domainResolutionAccuracyPercent: number;
+    fallbackVisible: boolean;
+    valueProofState: string;
+}
+type DomainTagProposalEvidence = {
+    stagingEntryId?: string;
+    status?: string;
+    confidence: number;
+    sourceEntryId?: string;
+    sourceName: string;
+    sourceCollectionSlug?: string;
+    sourceCanonicalKey?: string | null;
+    domainEntryId?: string;
+    domainName: string;
+    proposedDomainSlug?: string;
+    reasoning?: string;
+    decisionRightReason?: string;
+    sourceSignals?: string[];
+    rejectedAlternatives?: Array<{
+        slug: string;
+        reason: string;
+    }>;
+    classifierVersion?: string | null;
+    reviewedByPersonId?: string | null;
+    reviewNote?: string | null;
+    fallbackTier?: string | null;
+};
+type ProposalRunResult = {
+    runId: string;
+    dryRun: boolean;
+    examined: number;
+    audited: number;
+    processed: number;
+    tagged: number;
+    fallbackEmitted: number;
+    skipped: number;
+    errors: number;
+    relationsCreated: number;
+    relationsAlreadyExisted: number;
+    preview?: DomainTagProposalEvidence[];
+    notes?: string[];
+};
+export declare function formatAuthorityDomainProposalRun(result: ProposalRunResult): string;
+export declare function runAuthorityDomainsReadiness(): Promise<void>;
+export declare function runAuthorityDomainsPropose(opts: {
+    dryRun?: boolean;
+    limit?: string;
+    mock?: boolean;
+}): Promise<void>;
+export declare function runAuthorityDomainsReview(opts: {
+    status?: string;
+    limit?: string;
+    sample?: string;
+    stratified?: boolean;
+}): Promise<void>;
+export declare function runAuthorityDomainsRecordSample(opts: {
+    sampleId: string;
+    runId?: string;
+    approved: string;
+    rejected: string;
+    corrected: string;
+}): Promise<void>;
+export declare function runAuthorityDomainsRatify(stagingEntryId: string, opts: {
+    note?: string;
+}): Promise<void>;
+export declare function runAuthorityDomainsReject(stagingEntryId: string, opts: {
+    reason?: string;
+}): Promise<void>;
+export declare function runAuthorityDomainsDiscardPending(opts: {
+    reason?: string;
+}): Promise<void>;
+export declare function runAuthorityDomainsBenchmark(): Promise<void>;
+export declare function runAuthorityDomainsActivateCutover(opts?: {
+    forcePreProduction?: boolean;
+    decId?: string;
+}): Promise<void>;
+export declare function runAuthorityDomainsDeactivateCutover(opts?: {
+    clerkUserId?: string;
+}): Promise<void>;
+export declare function runAuthorityDomainsPrincipleDistribution(): Promise<void>;
+export {};
+//# sourceMappingURL=authority-domains.d.ts.map

package/dist/commands/authority-domains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authority-domains.d.ts","sourceRoot":"","sources":["../../src/commands/authority-domains.ts"],"names":[],"mappings":"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"}

package/dist/commands/authority-domains.js

@@ -0,0 +1,283 @@
+import { getConfigOrGuide } from '../lib/config.js';
+import { kernelCall } from '../lib/client.js';
+import { runCliCommand } from '../lib/runner.js';
+import { bold, dim, heading } from '../lib/style.js';
+function formatMetric(metric, suffix = '') {
+    if (metric.status === 'measured')
+        return `${metric.value}${suffix}`;
+    return `unmeasured${metric.reason ? ` — ${metric.reason}` : ''}`;
+}
+function formatReadiness(result) {
+    const lines = [];
+    lines.push('');
+    lines.push(`${bold('Authority Domains')} ${dim('—')} ${bold(result.state)}`);
+    lines.push('');
+    lines.push(`Active source: ${result.activeSource}`);
+    lines.push(`Evidence gap: ${result.evidenceGap}`);
+    lines.push(`Action: ${result.nextAction}`);
+    lines.push('');
+    lines.push(heading('Seeds'));
+    lines.push(`  Roots seeded: ${result.rootDomains.seededRootDomainCount}`);
+    lines.push(`  Missing roots: ${result.rootDomains.missingRootDomains.join(', ') || 'none'}`);
+    lines.push(`  Missing required domains: ${result.rootDomains.missingRequiredDomainSlugs.join(', ') || 'none'}`);
+    lines.push(`  Graph valid: ${result.rootDomains.graphAcyclic && result.rootDomains.graphDepthValid ? 'yes' : 'no'}`);
+    lines.push('');
+    lines.push(heading('Evidence'));
+    lines.push(`  Coverage: ${result.proposals.auditedCoveragePercent}% audited`);
+    lines.push(`  Proposals: ${result.proposals.pendingDomainTagCount} pending, ${result.proposals.ratifiedDomainTagCount} ratified, ${result.proposals.rejectedDomainTagCount} rejected, ${result.proposals.skippedDomainTagCount} skipped`);
+    lines.push(`  Relations: ${result.proposals.legacyUnauditedRelationCount} legacy-unaudited, ${result.proposals.invalidRelationCount} invalid`);
+    lines.push(`  Non-overlap: ${formatMetric(result.orient.orientNonOverlapMetric, '%')}`);
+    lines.push(`  Primer byte delta: ${formatMetric(result.orient.primerByteDelta)}`);
+    lines.push(`  Accuracy sample: ${formatMetric(result.orient.accuracySample, '%')}`);
+    lines.push(`  Value proof: ${result.orient.valueProof.state}`);
+    if (result.orient.benchmarkId)
+        lines.push(`  Benchmark: ${result.orient.benchmarkId}`);
+    lines.push('');
+    lines.push(`Cutover activated: ${result.cutover.activated ? 'yes' : 'no'}`);
+    return lines.join('\n');
+}
+function formatBenchmark(result) {
+    return [
+        '',
+        `${bold('Authority Domain Benchmark')} ${dim('—')} ${bold(result.benchmarkId)}`,
+        '',
+        `Domain resolution accuracy: ${result.domainResolutionAccuracyPercent}%`,
+        `Non-overlap: ${result.nonOverlapMetric}%`,
+        `Primer byte delta: ${result.primerByteDelta}`,
+        `Fallback visible: ${result.fallbackVisible ? 'yes' : 'no'}`,
+        `Value proof: ${result.valueProofState}`,
+    ].join('\n');
+}
+function truncate(text, max = 220) {
+    return `${text.slice(0, max)}${text.length > max ? '...' : ''}`;
+}
+function formatDomainTagEvidence(row) {
+    const confidence = Number.isFinite(row.confidence) ? `${Math.round(row.confidence * 100)}%` : 'n/a';
+    const sourceLabel = row.sourceEntryId || row.sourceName;
+    const domainLabel = row.proposedDomainSlug ?? row.domainName;
+    const stateLabel = row.status ? `${row.status}, ${confidence}` : confidence;
+    const lead = row.stagingEntryId
+        ? `${row.stagingEntryId} — ${sourceLabel} -> ${domainLabel} (${stateLabel})`
+        : `${sourceLabel} -> ${domainLabel} (${stateLabel})`;
+    const lines = [lead];
+    lines.push(`  Source: ${row.sourceName} [${row.sourceCollectionSlug ?? 'unknown'}${row.sourceCanonicalKey ? `/${row.sourceCanonicalKey}` : ''}]`);
+    const reason = row.decisionRightReason ?? row.reasoning;
+    if (reason)
+        lines.push(`  Reason: ${truncate(reason)}`);
+    if (row.sourceSignals?.length)
+        lines.push(`  Signals: ${row.sourceSignals.slice(0, 3).join('; ')}`);
+    if (row.fallbackTier)
+        lines.push(`  Tier: ${row.fallbackTier}`);
+    if (row.rejectedAlternatives?.length) {
+        lines.push(`  Rejected: ${row.rejectedAlternatives.slice(0, 2).map((alt) => `${alt.slug} (${alt.reason})`).join('; ')}`);
+    }
+    if (row.reviewedByPersonId || row.reviewNote) {
+        lines.push(`  Review: ${row.reviewedByPersonId ?? 'unknown'}${row.reviewNote ? ` — ${row.reviewNote}` : ''}`);
+    }
+    return lines;
+}
+export function formatAuthorityDomainProposalRun(result) {
+    const lines = [
+        '',
+        `${bold('Authority Domain Proposal Run')} ${dim('—')} ${bold(result.runId)}`,
+        '',
+        `Dry run: ${result.dryRun ? 'yes' : 'no'}`,
+        `Examined: ${result.examined ?? 'n/a'}`,
+        `Audited (skip): ${result.audited ?? 'n/a'}`,
+        `Classified: ${result.processed}`,
+        `Tagged/proposed: ${result.tagged}`,
+        `Fallback emitted: ${result.fallbackEmitted ?? 0}`,
+        `Skipped: ${result.skipped}`,
+        `Errors: ${result.errors}`,
+        `Relations created: ${result.relationsCreated}`,
+        `Existing/duplicate: ${result.relationsAlreadyExisted}`,
+    ];
+    if (result.preview?.length) {
+        lines.push('');
+        lines.push(heading('Dry-run preview'));
+        lines.push(`  Showing ${result.preview.length} of ${result.tagged} candidate proposal(s). No staging rows or graph relations were written.`);
+        for (const [index, row] of result.preview.entries()) {
+            lines.push('');
+            lines.push(`${index + 1}. ${formatDomainTagEvidence(row).join('\n   ')}`);
+        }
+    }
+    if (result.notes?.length) {
+        lines.push('');
+        lines.push(...result.notes.map((note) => `Note: ${note}`));
+    }
+    return lines.join('\n');
+}
+export async function runAuthorityDomainsReadiness() {
+    const config = await getConfigOrGuide(() => runAuthorityDomainsReadiness());
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: () => kernelCall('authorityDomains.readiness', {}),
+        formatPretty: formatReadiness,
+    });
+}
+export async function runAuthorityDomainsPropose(opts) {
+    const config = await getConfigOrGuide(() => runAuthorityDomainsPropose(opts));
+    if (!config)
+        return;
+    const limit = opts.limit ? Number.parseInt(opts.limit, 10) : undefined;
+    await runCliCommand({
+        fn: () => kernelCall('authorityDomains.propose', {
+            dryRun: opts.dryRun ?? false,
+            ...(Number.isFinite(limit) ? { limit } : {}),
+            ...(opts.mock ? { mockLlm: true } : {}),
+        }),
+        formatPretty: formatAuthorityDomainProposalRun,
+    });
+}
+export async function runAuthorityDomainsReview(opts) {
+    const config = await getConfigOrGuide(() => runAuthorityDomainsReview(opts));
+    if (!config)
+        return;
+    const limit = opts.limit ? Number.parseInt(opts.limit, 10) : undefined;
+    const sample = opts.sample ? Number.parseInt(opts.sample, 10) : undefined;
+    await runCliCommand({
+        fn: () => kernelCall('authorityDomains.review', {
+            status: opts.status ?? 'pending',
+            ...(Number.isFinite(limit) ? { limit } : {}),
+            ...(Number.isFinite(sample) ? { sample } : {}),
+            ...(opts.stratified ? { stratified: true } : {}),
+        }),
+        formatPretty: (rows) => {
+            const lines = ['', `${bold('Authority Domain Proposals')} ${dim('—')} ${bold(String(rows.length))}`, ''];
+            if (rows.length === 0) {
+                lines.push('No proposals found.');
+                return lines.join('\n');
+            }
+            for (const row of rows)
+                lines.push(...formatDomainTagEvidence(row));
+            return lines.join('\n');
+        },
+    });
+}
+export async function runAuthorityDomainsRecordSample(opts) {
+    const config = await getConfigOrGuide(() => runAuthorityDomainsRecordSample(opts));
+    if (!config)
+        return;
+    const approvedCount = Number.parseInt(opts.approved, 10);
+    const rejectedCount = Number.parseInt(opts.rejected, 10);
+    const correctedCount = Number.parseInt(opts.corrected, 10);
+    await runCliCommand({
+        fn: () => kernelCall('authorityDomains.recordSample', {
+            sampleId: opts.sampleId,
+            ...(opts.runId ? { runId: opts.runId } : {}),
+            approvedCount,
+            rejectedCount,
+            correctedCount,
+            method: 'stratified',
+        }),
+        formatPretty: (result) => [
+            '',
+            `${bold('Authority Domain Sample')} ${dim('—')} ${bold(result.sampleId)}`,
+            '',
+            `Reviewed: ${result.sampleSize}`,
+            `Approved: ${result.approvedCount}`,
+            `Rejected: ${result.rejectedCount}`,
+            `Corrected: ${result.correctedCount}`,
+            `Accuracy: ${result.accuracyPercent}%`,
+            `Method: ${result.method}`,
+        ].join('\n'),
+    });
+}
+// Must match expectedReviewConfirmation in convex/authorityDomains.ts — duplicated because
+// CLI cannot import from convex/ (monorepo import boundary). Keep both in sync.
+function authorityDomainReviewConfirmation(stagingEntryId) {
+    return `review authority-domain proposal ${stagingEntryId}`;
+}
+export async function runAuthorityDomainsRatify(stagingEntryId, opts) {
+    const config = await getConfigOrGuide(() => runAuthorityDomainsRatify(stagingEntryId, opts));
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: () => kernelCall('authorityDomains.ratify', {
+            stagingEntryId,
+            authorityReviewConfirmation: authorityDomainReviewConfirmation(stagingEntryId),
+            ...(opts.note ? { reviewNote: opts.note } : {}),
+        }),
+        formatPretty: (result) => `\nRatified domain proposal. Relation: ${result.relationId}${result.alreadyExists ? ' (already existed)' : ''}`,
+    });
+}
+export async function runAuthorityDomainsReject(stagingEntryId, opts) {
+    const config = await getConfigOrGuide(() => runAuthorityDomainsReject(stagingEntryId, opts));
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: () => kernelCall('authorityDomains.reject', {
+            stagingEntryId,
+            authorityReviewConfirmation: authorityDomainReviewConfirmation(stagingEntryId),
+            ...(opts.reason ? { reviewNote: opts.reason } : {}),
+        }),
+        formatPretty: (result) => `\nRejected domain proposal: ${result.rejected ? 'yes' : 'no'}`,
+    });
+}
+// discardPending is an internal bulk operation — no per-proposal authorityReviewConfirmation required.
+export async function runAuthorityDomainsDiscardPending(opts) {
+    const config = await getConfigOrGuide(() => runAuthorityDomainsDiscardPending(opts));
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: () => kernelCall('authorityDomains.discardPending', {
+            // WP-354
+            reason: opts.reason ?? 'Discarded pending domain proposals after failed quality diagnosis.',
+        }),
+        formatPretty: (result) => `\nDiscarded pending authority-domain proposals: ${result.rejected}`,
+    });
+}
+export async function runAuthorityDomainsBenchmark() {
+    const config = await getConfigOrGuide(() => runAuthorityDomainsBenchmark());
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: () => kernelCall('authorityDomains.benchmark', {}),
+        formatPretty: formatBenchmark,
+    });
+}
+export async function runAuthorityDomainsActivateCutover(opts) {
+    const config = await getConfigOrGuide(() => runAuthorityDomainsActivateCutover(opts));
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: () => kernelCall('authorityDomains.activateCutover', {
+            ...(opts?.forcePreProduction ? { forcePreProduction: true } : {}),
+            ...(opts?.decId ? { decId: opts.decId } : {}),
+        }),
+        formatPretty: (result) => `\nAuthority-domain cutover activated: ${result.activated ? 'yes' : 'no'}${result.benchmarkId ? ` (${result.benchmarkId})` : ''}`,
+    });
+}
+export async function runAuthorityDomainsDeactivateCutover(opts) {
+    const config = await getConfigOrGuide(() => runAuthorityDomainsDeactivateCutover(opts));
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: () => kernelCall('authorityDomains.deactivateCutover', {
+            ...(opts?.clerkUserId ? { clerkUserId: opts.clerkUserId } : {}),
+        }),
+        formatPretty: (result) => `\nAuthority-domain cutover deactivated: ${result.deactivated ? 'yes' : 'no'}`,
+    });
+}
+export async function runAuthorityDomainsPrincipleDistribution() {
+    const config = await getConfigOrGuide(() => runAuthorityDomainsPrincipleDistribution());
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: () => kernelCall('authorityDomains.principleDistribution', {}),
+        formatPretty: (result) => [
+            '',
+            `${bold('Principles Governance Distribution')}`,
+            '',
+            `Total active principles: ${result.total}`,
+            `Governance-matched: ${result.matched}`,
+            `Governance match rate: ${(result.governanceMatchRate * 100).toFixed(1)}%`,
+            '',
+            result.governanceMatchRate >= 0.10
+                ? 'Gate PASS — principles fallback is enabled (governanceMatchRate >= 10%).'
+                : 'Gate FAIL — governanceMatchRate < 10%; principles fallback should be disabled. Capture DEC before proceeding.',
+        ].join('\n'),
+    });
+}
+//# sourceMappingURL=authority-domains.js.map