@productbrain/cli 0.1.0-beta.7278 → 0.1.0-beta.7288

package/dist/commands/setup-resolver.d.ts

@@ -1,58 +0,0 @@
-/**
- * WP-336 E2 (CLI side): Dual-mode setup asset resolver for `pb handshake`.
- *
- * SetupMode:
- *   local — reads skills/rules from .productbrain/ (current builder behavior, default).
- *   chain — calls the Convex API (setup.getActiveSurface) and returns Chain-backed assets.
- *
- * The env var PB_SETUP_MODE controls which path runs:
- *   unset or 'local' → local mode (no network call, fully offline-safe)
- *   'chain'          → chain mode (requires authenticated kernelCall, user workspace)
- *
- * Chain: WP-336 (Agent Surface Foundation), DEC-619 (setup_receipt infrastructure)
- */
-export type SetupMode = 'local' | 'chain';
-/**
- * Unified asset shape returned by resolveSetupAssets.
- *
- * Local mode:   assetKind derived from .productbrain/ directory (skills/ → 'skill', rules/ → 'rule').
- * Chain mode:   assetKind comes from the entry's data.assetKind field (seeded by WP-336 E3 seed).
- *
- * The `body` field is the raw Markdown content that gets written to adapter files.
- * The `source` field is informational — used for reporting/telemetry, not for write decisions.
- */
-export interface SetupAsset {
-    assetKind: 'skill' | 'rule' | 'hook';
-    displayName: string;
-    body: string;
-    source: 'seeded' | 'authored' | 'imported';
-}
-/**
- * Wire shape returned by the Convex getActiveSurface query.
- * Must match the return type of convex/setup.ts:getActiveSurface.
- */
-export interface GetActiveSurfaceResult {
-    assetId: string;
-    assetKind: string;
-    displayName: string;
-    shortDescription: string;
-    body: string;
-    version: number;
-    source: string;
-}
-/**
- * Returns the active SetupMode.
- * Reads PB_SETUP_MODE from process.env.
- * Unknown values default to 'local' (fail-open for forward compat).
- */
-export declare function getSetupMode(): SetupMode;
-/**
- * Resolve setup assets for the current mode.
- *
- * @param mode      - 'local' | 'chain', from getSetupMode()
- * @param kernelCall - authenticated kernelCall function (from packages/cli/src/lib/client.ts)
- *                    Only called in chain mode.
- * @param cwd       - current working directory (for .productbrain/ path resolution)
- */
-export declare function resolveSetupAssets(mode: SetupMode, kernelCall: <T>(fn: string, args: Record<string, unknown>) => Promise<T>, cwd: string): Promise<SetupAsset[]>;
-//# sourceMappingURL=setup-resolver.d.ts.map

package/dist/commands/setup-resolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup-resolver.d.ts","sourceRoot":"","sources":["../../src/commands/setup-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1C;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAIxC;AA6HD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EACxE,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,EAAE,CAAC,CAQvB"}

package/dist/commands/setup-resolver.js

@@ -1,150 +0,0 @@
-/**
- * WP-336 E2 (CLI side): Dual-mode setup asset resolver for `pb handshake`.
- *
- * SetupMode:
- *   local — reads skills/rules from .productbrain/ (current builder behavior, default).
- *   chain — calls the Convex API (setup.getActiveSurface) and returns Chain-backed assets.
- *
- * The env var PB_SETUP_MODE controls which path runs:
- *   unset or 'local' → local mode (no network call, fully offline-safe)
- *   'chain'          → chain mode (requires authenticated kernelCall, user workspace)
- *
- * Chain: WP-336 (Agent Surface Foundation), DEC-619 (setup_receipt infrastructure)
- */
-import { existsSync, readdirSync, readFileSync } from 'fs';
-import { join, basename } from 'path';
-// ── Mode resolution ───────────────────────────────────────────────────────────
-/**
- * Returns the active SetupMode.
- * Reads PB_SETUP_MODE from process.env.
- * Unknown values default to 'local' (fail-open for forward compat).
- */
-export function getSetupMode() {
-    const raw = process.env.PB_SETUP_MODE;
-    if (raw === 'chain')
-        return 'chain';
-    return 'local';
-}
-// ── Local mode ────────────────────────────────────────────────────────────────
-/**
- * Read a single Markdown file from a .productbrain/ sub-directory.
- * Returns the file body after stripping a minimal YAML frontmatter block
- * (lines between opening and closing ---). If no frontmatter is found,
- * returns the full file content unchanged.
- *
- * We intentionally keep this light — the local mode is a contract test pass-through
- * that verifies parity with the existing handshake.ts lines 443–507 pipeline.
- */
-function stripFrontmatter(raw) {
-    const lines = raw.split('\n');
-    if (lines[0]?.trim() !== '---')
-        return raw;
-    const closeIdx = lines.indexOf('---', 1);
-    if (closeIdx === -1)
-        return raw;
-    return lines.slice(closeIdx + 1).join('\n').trimStart();
-}
-/**
- * Read skills from .productbrain/skills/ and map them to SetupAsset[].
- * Mirrors the shape produced by readCanonicalSkills() in portable-knowledge.ts.
- * Does NOT apply level/stage filtering — that remains in the handshake pipeline.
- */
-function readLocalSkillAssets(pbDir) {
-    const skillsDir = join(pbDir, 'skills');
-    if (!existsSync(skillsDir))
-        return [];
-    const files = readdirSync(skillsDir).filter((f) => f.endsWith('.md'));
-    return files.map((file) => {
-        const raw = readFileSync(join(skillsDir, file), 'utf8');
-        const displayName = basename(file, '.md');
-        return {
-            assetKind: 'skill',
-            displayName,
-            body: stripFrontmatter(raw),
-            source: 'authored',
-        };
-    });
-}
-/**
- * Read rules from .productbrain/rules/ and map them to SetupAsset[].
- * Mirrors the shape produced by readCanonicalRules() in portable-knowledge.ts.
- */
-function readLocalRuleAssets(pbDir) {
-    const rulesDir = join(pbDir, 'rules');
-    if (!existsSync(rulesDir))
-        return [];
-    const files = readdirSync(rulesDir).filter((f) => f.endsWith('.md'));
-    return files.map((file) => {
-        const raw = readFileSync(join(rulesDir, file), 'utf8');
-        const displayName = basename(file, '.md');
-        return {
-            assetKind: 'rule',
-            displayName,
-            body: stripFrontmatter(raw),
-            source: 'authored',
-        };
-    });
-}
-/**
- * Local mode: return skills + rules from .productbrain/.
- *
- * This is the identity pass-through — the assets returned here are the same
- * files that handshake.ts lines 443–507 already read via readCanonicalSkills()
- * and readCanonicalRules(). The resolver does NOT replace those calls; it is a
- * parallel view used for contract testing and mode-switching.
- */
-function resolveLocalAssets(pbDir) {
-    return [
-        ...readLocalSkillAssets(pbDir),
-        ...readLocalRuleAssets(pbDir),
-    ];
-}
-// ── Chain mode ────────────────────────────────────────────────────────────────
-/**
- * Map a raw GetActiveSurfaceResult to a typed SetupAsset.
- * Falls back gracefully on unexpected assetKind values.
- */
-function mapChainAsset(raw) {
-    const assetKind = raw.assetKind === 'rule' ? 'rule'
-        : raw.assetKind === 'hook' ? 'hook'
-            : 'skill'; // default — skill is the safe fallback
-    const source = raw.source === 'authored' ? 'authored'
-        : raw.source === 'imported' ? 'imported'
-            : 'seeded';
-    return {
-        assetKind,
-        displayName: raw.displayName,
-        body: raw.body,
-        source,
-    };
-}
-/**
- * Chain mode: call setup.getActiveSurface via the AKI gateway and return assets.
- *
- * workspaceId is injected server-side by the gateway (BR-18).
- * personId is injected server-side by injectSessionAuth — the CLI does not pass it.
- *
- * @param kernelCall - the authenticated kernelCall function from the handshake flow
- */
-async function resolveChainAssets(kernelCall) {
-    const results = await kernelCall('setup.getActiveSurface', {});
-    return results.map(mapChainAsset);
-}
-// ── Public API ────────────────────────────────────────────────────────────────
-/**
- * Resolve setup assets for the current mode.
- *
- * @param mode      - 'local' | 'chain', from getSetupMode()
- * @param kernelCall - authenticated kernelCall function (from packages/cli/src/lib/client.ts)
- *                    Only called in chain mode.
- * @param cwd       - current working directory (for .productbrain/ path resolution)
- */
-export async function resolveSetupAssets(mode, kernelCall, cwd) {
-    if (mode === 'chain') {
-        return resolveChainAssets(kernelCall);
-    }
-    // local mode — read from .productbrain/ (synchronous, no network)
-    const pbDir = join(cwd, '.productbrain');
-    return resolveLocalAssets(pbDir);
-}
-//# sourceMappingURL=setup-resolver.js.map

package/dist/commands/setup-resolver.js.map

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

package/dist/commands/setup-state.d.ts

@@ -1,42 +0,0 @@
-/**
- * `pb setup-state` — WP-431 S3.
- *
- * Calls the Convex `getPbSetupState` query and emits the result as compact JSON
- * on stdout. Machine-readable always — the skill body parses this.
- *
- * Auth & userId injection (STD-234 perimeter):
- *   The HTTP gateway derives `workspaceId` and `userId` from the API key and
- *   passes them server-side; the CLI does not need to know the user's id.
- *   Defense-in-depth equality check happens inside the query handler.
- *
- * Exit codes (CLI convention):
- *   0  success — JSON written to stdout
- *   2  auth/permission — AUTH_* / AUTHZ_* error class
- *   3  network — host unreachable / fetch failed
- *   1  other (validation / internal)
- */
-export interface RunSetupStateOptions {
-    /** Pre-fetched state — used by `pb setup` to avoid a duplicate gateway round-trip. */
-    preloaded?: SetupStateResult;
-}
-export interface SetupStateResult {
-    phase: number | 'settings';
-    role: 'creator' | 'joiner';
-    expectedAction: string;
-    reasonForPhase: string;
-    isComplete: boolean;
-    /**
-     * WP-431 S3 review fix #1: structural surfaceCapability passthrough.
-     * Mirrors the resolver output (PbSetupStateOutput.surfaceCapability).
-     */
-    surfaceCapability: 'cli' | 'chat-only';
-}
-export declare function fetchSetupState(): Promise<SetupStateResult>;
-export declare function runSetupState(opts?: RunSetupStateOptions): Promise<void>;
-/**
- * Map a setup-state failure to the documented exit-code contract.
- * Always re-throws (typed `never`) so the global handler in index.ts can format
- * the message; we route through CLIError so JSON mode reports `code` cleanly.
- */
-export declare function handleSetupError(err: unknown): never;
-//# sourceMappingURL=setup-state.d.ts.map

package/dist/commands/setup-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup-state.d.ts","sourceRoot":"","sources":["../../src/commands/setup-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,MAAM,WAAW,oBAAoB;IACnC,sFAAsF;IACtF,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC;IAC3B,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,iBAAiB,EAAE,KAAK,GAAG,WAAW,CAAC;CACxC;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAEjE;AAED,wBAAsB,aAAa,CAAC,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAiCpD"}

package/dist/commands/setup-state.js

@@ -1,93 +0,0 @@
-/**
- * `pb setup-state` — WP-431 S3.
- *
- * Calls the Convex `getPbSetupState` query and emits the result as compact JSON
- * on stdout. Machine-readable always — the skill body parses this.
- *
- * Auth & userId injection (STD-234 perimeter):
- *   The HTTP gateway derives `workspaceId` and `userId` from the API key and
- *   passes them server-side; the CLI does not need to know the user's id.
- *   Defense-in-depth equality check happens inside the query handler.
- *
- * Exit codes (CLI convention):
- *   0  success — JSON written to stdout
- *   2  auth/permission — AUTH_* / AUTHZ_* error class
- *   3  network — host unreachable / fetch failed
- *   1  other (validation / internal)
- */
-import { kernelCall, McpError } from '../lib/client.js';
-import { CLIError, ErrorCode } from '../lib/errors.js';
-export async function fetchSetupState() {
-    return await kernelCall('setup.getPbSetupState', {});
-}
-export async function runSetupState(opts = {}) {
-    let result;
-    try {
-        result = opts.preloaded ?? (await fetchSetupState());
-    }
-    catch (err) {
-        handleSetupError(err);
-    }
-    process.stdout.write(JSON.stringify(result) + '\n');
-}
-/**
- * Map a setup-state failure to the documented exit-code contract.
- * Always re-throws (typed `never`) so the global handler in index.ts can format
- * the message; we route through CLIError so JSON mode reports `code` cleanly.
- */
-export function handleSetupError(err) {
-    if (err instanceof McpError) {
-        const code = err.code;
-        if (code && (code.startsWith('AUTH') || code.startsWith('AUTHZ'))) {
-            const wrapped = new CLIError(err.message, {
-                code: ErrorCode.AUTH_DENIED,
-                category: 'auth',
-                guidance: 'Run `pb login` to refresh your API key, or check workspace membership.',
-            });
-            writeJsonError(wrapped);
-            process.exit(2);
-        }
-        writeJsonError(err);
-        process.exit(1);
-    }
-    if (err instanceof CLIError && err.category === 'network') {
-        writeJsonError(err);
-        process.exit(3);
-    }
-    if (err instanceof CLIError && err.category === 'auth') {
-        writeJsonError(err);
-        process.exit(2);
-    }
-    if (err instanceof CLIError) {
-        writeJsonError(err);
-        process.exit(1);
-    }
-    const wrapped = new CLIError(err instanceof Error ? err.message : String(err), {
-        code: ErrorCode.INTERNAL,
-        category: 'internal',
-    });
-    writeJsonError(wrapped);
-    process.exit(1);
-}
-/**
- * Write a structured JSON error to stderr. WP-431 S3 review (Boy Scout #2):
- * route every shape through CLIError.toJSON() so the stderr envelope is
- * identical to every other CLI command (no per-call ad-hoc shapes).
- */
-function writeJsonError(err) {
-    const cliErr = toCLIError(err);
-    process.stderr.write(JSON.stringify(cliErr.toJSON()) + '\n');
-}
-function toCLIError(err) {
-    if (err instanceof CLIError)
-        return err;
-    if (err instanceof Error) {
-        const code = err.code;
-        const errorCode = code && Object.values(ErrorCode).includes(code)
-            ? code
-            : ErrorCode.INTERNAL;
-        return new CLIError(err.message, { code: errorCode, category: 'internal' });
-    }
-    return new CLIError(String(err), { code: ErrorCode.INTERNAL, category: 'internal' });
-}
-//# sourceMappingURL=setup-state.js.map

package/dist/commands/setup-state.js.map

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

package/dist/commands/setup.d.ts

@@ -1,23 +0,0 @@
-/**
- * `pb setup` — WP-431 S3 canonical entry point (DEC-995).
- *
- * Flow:
- *   1. Auto-detect surface markers and union-merge into `manifest.surfaces` (S3 #1).
- *      Phase-1 users land here with empty surfaces; this single auto-detect lifts
- *      them to Phase 2 without requiring a separate `pb setup-detect-surfaces` run.
- *   2. Read pb-setup state via the Convex query (`setup.getPbSetupState`).
- *   3. Record invocation receipt — first-write-wins per DEC-996, idempotent.
- *   4. Emit the resolved state JSON on stdout for the skill body to consume.
- *
- * `pb start` (session-start alias) is unchanged and keeps the same call path it
- * had before this slice.
- *
- * Legacy `pb setup` (WP-301) — guided onboarding via @clack/prompts — is removed
- * from the canonical entry per DEC-995. The login flow remains reachable via
- * `pb login`.
- */
-export interface RunSetupOptions {
-    cwd?: string;
-}
-export declare function runSetup(opts?: RunSetupOptions): Promise<void>;
-//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,QAAQ,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BxE"}

package/dist/commands/setup.js

@@ -1,69 +0,0 @@
-/**
- * `pb setup` — WP-431 S3 canonical entry point (DEC-995).
- *
- * Flow:
- *   1. Auto-detect surface markers and union-merge into `manifest.surfaces` (S3 #1).
- *      Phase-1 users land here with empty surfaces; this single auto-detect lifts
- *      them to Phase 2 without requiring a separate `pb setup-detect-surfaces` run.
- *   2. Read pb-setup state via the Convex query (`setup.getPbSetupState`).
- *   3. Record invocation receipt — first-write-wins per DEC-996, idempotent.
- *   4. Emit the resolved state JSON on stdout for the skill body to consume.
- *
- * `pb start` (session-start alias) is unchanged and keeps the same call path it
- * had before this slice.
- *
- * Legacy `pb setup` (WP-301) — guided onboarding via @clack/prompts — is removed
- * from the canonical entry per DEC-995. The login flow remains reachable via
- * `pb login`.
- */
-import { runSetupDetectSurfaces, formatDetectSurfacesSummary } from './setup-detect-surfaces.js';
-import { fetchSetupState, handleSetupError } from './setup-state.js';
-import { kernelCall } from '../lib/client.js';
-export async function runSetup(opts = {}) {
-    const cwd = opts.cwd ?? process.cwd();
-    const isTty = Boolean(process.stdout.isTTY);
-    let initialState;
-    try {
-        initialState = await fetchSetupState();
-    }
-    catch (err) {
-        handleSetupError(err);
-    }
-    // Always record invocation — first-write-wins per DEC-996.
-    await recordInvocationBestEffort(initialState);
-    let finalState = initialState;
-    if (initialState.phase === 1) {
-        const detect = await runSetupDetectSurfaces({ cwd });
-        if (isTty) {
-            process.stderr.write(formatDetectSurfacesSummary(detect) + '\n');
-        }
-        if (detect.manifestUpdated) {
-            try {
-                finalState = await fetchSetupState();
-            }
-            catch (err) {
-                handleSetupError(err);
-            }
-        }
-    }
-    process.stdout.write(JSON.stringify(finalState) + '\n');
-}
-async function recordInvocationBestEffort(state) {
-    // WP-431 S3 review fix #1: surfaceCapability is now a structural field on the
-    // resolver output (PbSetupStateOutput.surfaceCapability) — read it directly
-    // rather than string-grepping reasonForPhase strings the producer never
-    // emits. The pre-fix `inferSurfaceCapability` always returned 'cli' for
-    // chat-only users, silently breaking OBJ-32 dual-threshold telemetry.
-    const surfaceCapability = state.surfaceCapability;
-    try {
-        await kernelCall('setup.recordSetupInvocation', { surfaceCapability });
-    }
-    catch (err) {
-        // Best-effort — invocation receipt is telemetry, never block the state
-        // read. WP-431 S3 review (Boy Scout #1): log to stderr so a silent failure
-        // doesn't strand OBJ-32 dual-threshold attribution.
-        const message = err instanceof Error ? err.message : String(err);
-        process.stderr.write(`[pb setup] invocation attribution failed: ${message}\n`);
-    }
-}
-//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACjG,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAyB,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAM9C,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB,EAAE;IACvD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5C,IAAI,YAA8B,CAAC;IACnC,IAAI,CAAC;QACH,YAAY,GAAG,MAAM,eAAe,EAAE,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,2DAA2D;IAC3D,MAAM,0BAA0B,CAAC,YAAY,CAAC,CAAC;IAE/C,IAAI,UAAU,GAAG,YAAY,CAAC;IAC9B,IAAI,YAAY,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACrD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,UAAU,GAAG,MAAM,eAAe,EAAE,CAAC;YACvC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,KAAK,UAAU,0BAA0B,CAAC,KAAuB;IAC/D,8EAA8E;IAC9E,4EAA4E;IAC5E,wEAAwE;IACxE,wEAAwE;IACxE,sEAAsE;IACtE,MAAM,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,UAAU,CAA0D,6BAA6B,EAAE,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAClI,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,uEAAuE;QACvE,2EAA2E;QAC3E,oDAAoD;QACpD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6CAA6C,OAAO,IAAI,CAAC,CAAC;IACjF,CAAC;AACH,CAAC"}

package/dist/setup/__tests__/coach-traces.test.d.ts

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

package/dist/setup/__tests__/coach-traces.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"coach-traces.test.d.ts","sourceRoot":"","sources":["../../../src/setup/__tests__/coach-traces.test.ts"],"names":[],"mappings":""}

package/dist/setup/__tests__/coach-traces.test.js

@@ -1,189 +0,0 @@
-/**
- * Cross-model coach validation harness — WP-431 S4 (doneWhen #16).
- *
- * Mock harness chosen for cross-model validation per TEN-1962 — deterministic,
- * runs in CI without API keys. Live trace via dev-only Cursor Desktop documented
- * separately if needed. The harness does NOT call any model; it simulates the
- * criteria-progression loop encoded in `.productbrain/skills/pb-setup.md`
- * Phase 3 and asserts convergence within 3 turns OR correct fallback to the
- * FLO-72 Path C wizard (DEC-991).
- *
- * The fixture set covers cross-model behaviour by encoding three response
- * shapes that any reasonable instruction-following model produces — the user's
- * answer is the variable, the agent's response loop is the constant. The
- * skill body is the universal SSOT (DEC-997); this harness exercises it.
- */
-import { describe, expect, it } from 'vitest';
-/**
- * Criteria check (verbatim from `.productbrain/skills/pb-setup.md` Phase 3):
- *   "answer mentions a verb + a thing they do regularly".
- *
- * The criteria predicate keeps the test honest: it deterministically maps a
- * user utterance to met/not-met. The tokeniser is intentionally simple — the
- * skill text says "verb + thing", and that's what we look for.
- */
-const VERB_HINTS = [
-    'ship',
-    'shipping',
-    'fix',
-    'fixing',
-    'write',
-    'writing',
-    'review',
-    'reviewing',
-    'build',
-    'building',
-    'integrate',
-    'integrating',
-    'design',
-    'designing',
-    'debug',
-    'debugging',
-    'refactor',
-    'refactoring',
-    'document',
-    'documenting',
-];
-const THING_HINTS = [
-    'feature',
-    'features',
-    'bug',
-    'bugs',
-    'copy',
-    'integration',
-    'integrations',
-    'review',
-    'reviews',
-    'issue',
-    'issues',
-    'doc',
-    'docs',
-    'api',
-    'apis',
-    'endpoint',
-    'endpoints',
-    'workflow',
-    'workflows',
-    'page',
-    'pages',
-    'rule',
-    'rules',
-];
-function meetsCriteria(answer) {
-    const lower = answer.toLowerCase();
-    const hasVerb = VERB_HINTS.some((v) => new RegExp(`\\b${v}\\b`).test(lower));
-    const hasThing = THING_HINTS.some((t) => new RegExp(`\\b${t}\\b`).test(lower));
-    return hasVerb && hasThing;
-}
-/**
- * Run the coach loop encoded in pb-setup.md against a scripted user.
- *
- * Loop (verbatim from the skill):
- *   1. Ask the open question.
- *   2. If answer meets criteria -> progress.
- *   3. If vague, ask one follow-up.
- *   4. If 2 follow-ups don't yield, fall back to wizard (DEC-991).
- *
- * Convergence target (doneWhen #16): within 3 turns. Three turns means: the
- * open question + at most two follow-ups. After the third turn without
- * criteria-met, the agent MUST fall back to the wizard.
- */
-function runCoachLoop(turns) {
-    const trace = [];
-    let followUps = 0;
-    for (let i = 0; i < turns.length; i++) {
-        const turn = turns[i];
-        const met = meetsCriteria(turn.user);
-        trace.push({ turn: i + 1, user: turn.user, met });
-        if (met) {
-            return {
-                state: 'criteria-met',
-                turnsUsed: i + 1,
-                finalAnswer: turn.user,
-                trace,
-            };
-        }
-        followUps += 1;
-        if (followUps >= 2) {
-            // Skill behaviour: "if 2 follow-ups don't yield, suggest a default
-            // catalog and let them pick (DEC-991 fallback path)".
-            return {
-                state: 'wizard-fallback',
-                turnsUsed: i + 1,
-                finalAnswer: turn.user,
-                trace,
-            };
-        }
-    }
-    // Out of scripted turns without convergence — treat as wizard-fallback so
-    // the test surfaces a faulty fixture rather than silently passing.
-    return {
-        state: 'wizard-fallback',
-        turnsUsed: turns.length,
-        finalAnswer: turns[turns.length - 1]?.user ?? '',
-        trace,
-    };
-}
-describe('Phase 3 coach loop — cross-model trace harness (TEN-1962)', () => {
-    it('Scenario A — happy path (specific answer, 1 turn)', () => {
-        const turns = [
-            { user: 'Mostly shipping new features for our SvelteKit app.' },
-        ];
-        const outcome = runCoachLoop(turns);
-        expect(outcome.state).toBe('criteria-met');
-        expect(outcome.turnsUsed).toBe(1);
-        expect(outcome.turnsUsed).toBeLessThanOrEqual(3);
-    });
-    it('Scenario B — vague then specific (follow-up, 2 turns)', () => {
-        const turns = [
-            { user: 'I dunno, various stuff.' },
-            { user: 'Last week I spent the most time fixing customer bugs.' },
-        ];
-        const outcome = runCoachLoop(turns);
-        expect(outcome.state).toBe('criteria-met');
-        expect(outcome.turnsUsed).toBe(2);
-        expect(outcome.turnsUsed).toBeLessThanOrEqual(3);
-    });
-    it('Scenario C — 2 vague turns triggers wizard fallback (DEC-991 path)', () => {
-        const turns = [
-            { user: 'Just code, you know how it is.' },
-            { user: 'Stuff. Things. The usual.' },
-        ];
-        const outcome = runCoachLoop(turns);
-        expect(outcome.state).toBe('wizard-fallback');
-        expect(outcome.turnsUsed).toBe(2);
-        // Convergence to a deterministic outcome (criteria-met OR wizard) within
-        // the 3-turn budget defends OBJ-32 generalisation across surfaces.
-        expect(outcome.turnsUsed).toBeLessThanOrEqual(3);
-    });
-    it('Scenario D — marketing copy answer (non-engineering domain, criteria still met)', () => {
-        const turns = [
-            { user: 'I write marketing copy and review pages from the design team.' },
-        ];
-        const outcome = runCoachLoop(turns);
-        expect(outcome.state).toBe('criteria-met');
-        expect(outcome.turnsUsed).toBe(1);
-    });
-    it('Scenario E — every fixture converges within the 3-turn budget', () => {
-        // Roll-up assertion across all scenarios so a future fixture addition that
-        // exceeds the budget surfaces here as a single named failure.
-        const fixtures = [
-            [{ user: 'Mostly shipping new features for our SvelteKit app.' }],
-            [
-                { user: 'I dunno, various stuff.' },
-                { user: 'Last week I spent the most time fixing customer bugs.' },
-            ],
-            [
-                { user: 'Just code, you know how it is.' },
-                { user: 'Stuff. Things. The usual.' },
-            ],
-            [{ user: 'I write marketing copy and review pages from the design team.' }],
-        ];
-        for (const turns of fixtures) {
-            const outcome = runCoachLoop(turns);
-            expect(outcome.turnsUsed).toBeLessThanOrEqual(3);
-            expect(['criteria-met', 'wizard-fallback']).toContain(outcome.state);
-        }
-    });
-});
-//# sourceMappingURL=coach-traces.test.js.map