@productbrain/cli 0.1.0-beta.7273 → 0.1.0-beta.7286

package/dist/setup/detect-surfaces.js

@@ -1,39 +0,0 @@
-/**
- * WP-431 S3 — pure surface detection driven by the SURFACE_ADAPTERS registry.
- *
- * Each registered adapter exposes a `detect(repoRoot)` predicate (e.g. existence
- * of `.claude/`, `.cursor/`, `.github/copilot-instructions.md`, `.codex/` or
- * `AGENTS.md`). This module wraps that registry so callers stay in one place
- * if the adapter set grows.
- */
-import { SURFACE_ADAPTERS } from '../surfaces/registry.js';
-/**
- * Run every adapter's `detect` against `repoRoot` and return the names of
- * surfaces that resolved truthy, in registry order.
- */
-export async function detectSurfaces(repoRoot) {
-    const detected = [];
-    for (const name of Object.keys(SURFACE_ADAPTERS)) {
-        const adapter = SURFACE_ADAPTERS[name];
-        const result = await Promise.resolve(adapter.detect(repoRoot));
-        if (result)
-            detected.push(name);
-    }
-    return detected;
-}
-/**
- * Forward-only union (STD-235) — the merge never removes a surface that is
- * already declared in the manifest. Returns a sorted, de-duplicated list so
- * the writer is order-stable.
- */
-export function unionSurfaces(existing, detected) {
-    const set = new Set();
-    for (const s of existing)
-        if (typeof s === 'string' && s.length > 0)
-            set.add(s);
-    for (const s of detected)
-        if (typeof s === 'string' && s.length > 0)
-            set.add(s);
-    return [...set].sort();
-}
-//# sourceMappingURL=detect-surfaces.js.map

package/dist/setup/detect-surfaces.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"detect-surfaces.js","sourceRoot":"","sources":["../../src/setup/detect-surfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAoB,MAAM,yBAAyB,CAAC;AAE7E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAkB,EAAE,CAAC;QAClE,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/D,IAAI,MAAM;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,QAAkB,EAAE,QAAkB;IAClE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAChF,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAChF,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/setup/manifest-writer.d.ts

@@ -1,17 +0,0 @@
-/**
- * WP-431 S3 — atomic surfaces writer for `.productbrain/manifest.yaml`.
- *
- * Reads the existing manifest, replaces / inserts the `surfaces:` block, and
- * writes back via tmp + rename. Calls `assertSetupWritePath` (STD-234) before
- * touching disk so a path argument outside `.productbrain/` is refused.
- *
- * Forward-only (STD-235) is the caller's responsibility — this helper writes
- * exactly what it is given. `setup-detect-surfaces` is the union-merge author.
- */
-export interface WriteManifestSurfacesResult {
-    written: boolean;
-    path: string;
-}
-export declare function writeManifestSurfaces(repoRoot: string, surfaces: string[]): Promise<WriteManifestSurfacesResult>;
-export declare function readManifestSurfaces(repoRoot: string): string[];
-//# sourceMappingURL=manifest-writer.d.ts.map

package/dist/setup/manifest-writer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"manifest-writer.d.ts","sourceRoot":"","sources":["../../src/setup/manifest-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAqFD,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,2BAA2B,CAAC,CAqCtC;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAG/D"}

package/dist/setup/manifest-writer.js

@@ -1,153 +0,0 @@
-/**
- * WP-431 S3 — atomic surfaces writer for `.productbrain/manifest.yaml`.
- *
- * Reads the existing manifest, replaces / inserts the `surfaces:` block, and
- * writes back via tmp + rename. Calls `assertSetupWritePath` (STD-234) before
- * touching disk so a path argument outside `.productbrain/` is refused.
- *
- * Forward-only (STD-235) is the caller's responsibility — this helper writes
- * exactly what it is given. `setup-detect-surfaces` is the union-merge author.
- */
-import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, writeFileSync, unlinkSync } from 'fs';
-import { dirname, join, resolve } from 'path';
-import { assertSetupWritePath } from './perimeter.js';
-function canonicalRoot(repoRoot) {
-    try {
-        return realpathSync(repoRoot);
-    }
-    catch {
-        return resolve(repoRoot);
-    }
-}
-const MANIFEST_RELATIVE = '.productbrain/manifest.yaml';
-/**
- * Strip a `surfaces: …` block (with optional list items) from the manifest body,
- * preserving every other line verbatim. Stops on the next top-level key or EOF.
- *
- * Ad-hoc YAML parser (single-key replace only): js-yaml is not a dep of this
- * package, and round-tripping a full manifest through a YAML library would
- * lose comment-preserving fidelity anyway. This helper deliberately handles
- * exactly one shape — the top-level `surfaces:` block — and nothing else.
- */
-function stripSurfacesBlock(raw) {
-    const lines = raw.split('\n');
-    const out = [];
-    let inSurfaces = false;
-    for (const line of lines) {
-        if (inSurfaces) {
-            const isListItem = /^\s+-\s/.test(line);
-            const isBlank = line.trim() === '';
-            const isComment = line.trim().startsWith('#');
-            if (isListItem || isBlank || isComment) {
-                continue;
-            }
-            inSurfaces = false;
-        }
-        if (/^surfaces:\s*$/.test(line) || /^surfaces:\s*\[\]\s*$/.test(line)) {
-            inSurfaces = true;
-            continue;
-        }
-        if (/^surfaces:\s*\[.*\]\s*$/.test(line)) {
-            continue;
-        }
-        out.push(line);
-    }
-    let result = out.join('\n');
-    result = result.replace(/\n{3,}/g, '\n\n');
-    return result;
-}
-function serializeSurfacesBlock(surfaces) {
-    if (surfaces.length === 0)
-        return 'surfaces: []\n';
-    const sorted = [...surfaces].sort();
-    return ['surfaces:', ...sorted.map((s) => `  - ${s}`)].join('\n') + '\n';
-}
-function buildNewManifest(existing, surfaces) {
-    const stripped = stripSurfacesBlock(existing).trimEnd();
-    const block = serializeSurfacesBlock(surfaces);
-    if (stripped.length === 0) {
-        return block;
-    }
-    return `${stripped}\n${block}`;
-}
-function readSurfacesFromManifest(raw) {
-    const lines = raw.split('\n');
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        const inline = line.match(/^surfaces:\s*\[(.*)\]\s*$/);
-        if (inline) {
-            return inline[1]
-                .split(',')
-                .map((s) => s.trim().replace(/^['"]|['"]$/g, ''))
-                .filter((s) => s.length > 0);
-        }
-        if (/^surfaces:\s*$/.test(line)) {
-            const items = [];
-            for (let j = i + 1; j < lines.length; j++) {
-                const next = lines[j];
-                const m = next.match(/^\s+-\s+(.+?)\s*$/);
-                if (m) {
-                    items.push(m[1].replace(/^['"]|['"]$/g, ''));
-                    continue;
-                }
-                if (next.trim() === '' || next.trim().startsWith('#'))
-                    continue;
-                break;
-            }
-            return items;
-        }
-    }
-    return [];
-}
-export async function writeManifestSurfaces(repoRoot, surfaces) {
-    const canonicalRepo = canonicalRoot(repoRoot);
-    const absPath = resolve(canonicalRepo, MANIFEST_RELATIVE);
-    const existingSurfaces = surfacesFromDisk(absPath);
-    const existing = existsSync(absPath) ? readFileSync(absPath, 'utf8') : '';
-    const sortedDesired = [...surfaces].sort();
-    const sortedExisting = [...existingSurfaces].sort();
-    if (existsSync(absPath) &&
-        sortedDesired.length === sortedExisting.length &&
-        sortedDesired.every((s, i) => s === sortedExisting[i])) {
-        return { written: false, path: absPath };
-    }
-    // WP-431 S3 review fix #5: pass the canonical repo root explicitly. The
-    // perimeter helper now accepts a cwd override (no more process.chdir
-    // mutation around the call — concurrency-safe).
-    assertSetupWritePath(absPath, { surfaces }, { cwd: canonicalRepo });
-    const dir = dirname(absPath);
-    if (!existsSync(dir))
-        mkdirSync(dir, { recursive: true });
-    const next = buildNewManifest(existing.length === 0 ? 'version: "0.1"\n' : existing, sortedDesired);
-    const tmp = `${absPath}.tmp`;
-    writeFileSync(tmp, next);
-    try {
-        renameSync(tmp, absPath);
-    }
-    catch (err) {
-        try {
-            unlinkSync(tmp);
-        }
-        catch {
-            // best-effort cleanup
-        }
-        throw err;
-    }
-    return { written: true, path: absPath };
-}
-export function readManifestSurfaces(repoRoot) {
-    const absPath = join(repoRoot, MANIFEST_RELATIVE);
-    return surfacesFromDisk(absPath);
-}
-function surfacesFromDisk(absPath) {
-    if (!existsSync(absPath))
-        return [];
-    try {
-        const raw = readFileSync(absPath, 'utf8');
-        return readSurfacesFromManifest(raw);
-    }
-    catch {
-        return [];
-    }
-}
-//# sourceMappingURL=manifest-writer.js.map

package/dist/setup/manifest-writer.js.map

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

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

@@ -1,67 +0,0 @@
-/**
- * WP-431 S2 — pb-setup state machine (DEC-988, DEC-993, DEC-994).
- *
- * Pure resolver: given a snapshot of the workspace + per-user activation inputs,
- * returns the (phase, role, expectedAction) tuple the pb-setup skill consumes
- * to drive its install-to-activation flow. No I/O, no Convex imports — testable
- * in isolation.
- *
- * Phase grammar (DEC-988):
- *   1. Surface declaration  — manifest.surfaces empty → exit when >=1 surface.
- *   2. Local sync           — CLI surfaces only; exit when 0 unimported assets.
- *   3. Catalog adoption     — exit when >=1 catalog adoption (or skip).
- *   4. Capture loop         — exit when >=10 confirmed entries AND >=2 distinct
- *                              collections AND retrieval-demo confirmed (BR-141).
- *   5. Activation           — final receipt write; exit on userActivated=true.
- *   settings — post-activation re-run sub-state.
- *
- * Role detection (DEC-988):
- *   - joiner: workspaceMaterialized=true AND userActivated=false
- *   - creator: otherwise
- *
- * Surface capability (DEC-993):
- *   - chat-only surfaces (Cursor Desktop / Claude Desktop) skip Phases 1+2;
- *     manifest.surfaces is upstream-stamped with ['mcp-only'] so Phase 3 entry
- *     condition (P2 done OR surface-skipped) is satisfied either way.
- *
- * Soft-gate (DEC-994):
- *   - confirmedEntryCount >= 10 but entriesAcrossCollections < 2 → stay in P4
- *     and emit the diversity-nudge expectedAction.
- */
-export type SetupPhase = 1 | 2 | 3 | 4 | 5;
-export type SetupRole = 'creator' | 'joiner';
-export type SurfaceCapability = 'cli' | 'chat-only';
-export interface SetupStateInput {
-    manifest: {
-        surfaces: string[];
-    };
-    assetCounts: {
-        totalAssets: number;
-        totalUnimported: number;
-        hasMore: boolean;
-    };
-    catalogAdoptionCount: number;
-    confirmedEntryCount: number;
-    entriesAcrossCollections: number;
-    retrievalDemoConfirmed: boolean;
-    workspaceMaterialized: boolean;
-    userActivated: boolean;
-    surfaceCapability: SurfaceCapability;
-}
-export interface SetupStateOutput {
-    phase: SetupPhase | 'settings';
-    role: SetupRole;
-    expectedAction: string;
-    reasonForPhase: string;
-    isComplete: boolean;
-    /**
-     * WP-431 S3 review fix #1: surfaceCapability is surfaced as a structural
-     * field on the resolver output (was previously a string-grep on
-     * `reasonForPhase` strings the producer never emits — broken silently).
-     * The resolver passes the input value straight through; consumers
-     * (e.g. CLI `recordSetupInvocation`) read this directly.
-     */
-    surfaceCapability: SurfaceCapability;
-}
-export declare function resolveSetupState(input: SetupStateInput): SetupStateOutput;
-//# sourceMappingURL=state-machine.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../../src/setup/state-machine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC3C,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAC7C,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,WAAW,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACjC,WAAW,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAChF,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAAC;IACjC,sBAAsB,EAAE,OAAO,CAAC;IAChC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,GAAG,UAAU,CAAC;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB;;;;;;OAMG;IACH,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAqBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,CAoF1E"}

package/dist/setup/state-machine.js

@@ -1,124 +0,0 @@
-/**
- * WP-431 S2 — pb-setup state machine (DEC-988, DEC-993, DEC-994).
- *
- * Pure resolver: given a snapshot of the workspace + per-user activation inputs,
- * returns the (phase, role, expectedAction) tuple the pb-setup skill consumes
- * to drive its install-to-activation flow. No I/O, no Convex imports — testable
- * in isolation.
- *
- * Phase grammar (DEC-988):
- *   1. Surface declaration  — manifest.surfaces empty → exit when >=1 surface.
- *   2. Local sync           — CLI surfaces only; exit when 0 unimported assets.
- *   3. Catalog adoption     — exit when >=1 catalog adoption (or skip).
- *   4. Capture loop         — exit when >=10 confirmed entries AND >=2 distinct
- *                              collections AND retrieval-demo confirmed (BR-141).
- *   5. Activation           — final receipt write; exit on userActivated=true.
- *   settings — post-activation re-run sub-state.
- *
- * Role detection (DEC-988):
- *   - joiner: workspaceMaterialized=true AND userActivated=false
- *   - creator: otherwise
- *
- * Surface capability (DEC-993):
- *   - chat-only surfaces (Cursor Desktop / Claude Desktop) skip Phases 1+2;
- *     manifest.surfaces is upstream-stamped with ['mcp-only'] so Phase 3 entry
- *     condition (P2 done OR surface-skipped) is satisfied either way.
- *
- * Soft-gate (DEC-994):
- *   - confirmedEntryCount >= 10 but entriesAcrossCollections < 2 → stay in P4
- *     and emit the diversity-nudge expectedAction.
- */
-const ACTIONS = {
-    settings: 'User has activated. Settings menu: (1) add/remove surface, (2) re-import drift, (3) browse catalog updates.',
-    phase1: 'Run pb connect to declare a surface (claude, cursor, codex, copilot, mcp-only). The state machine advances when manifest.surfaces[] is non-empty.',
-    phase2: 'Run pb setup ingest (or pb setup migrate) to import the local .productbrain/ assets that have not yet been mirrored into Convex. Phase exits at totalUnimported=0.',
-    phase3: 'Browse the catalog and adopt at least one platform-seeded asset (skill / rule / hook), or skip explicitly. Phase exits at catalogAdoptionCount>=1 or on skip.',
-    phase4: 'Capture entries with pb capture and commit them. Demonstrate retrieval with pb get / pb orient on your own entry. Phase exits at confirmedEntryCount>=10 AND entriesAcrossCollections>=2 AND retrievalDemoConfirmed=true.',
-    phase4Diversity: "You have 10 entries but they're all in one collection. Try one entry in a different collection (decision/tension/insight/etc.) before activation.",
-    phase4Retrieval: 'You have 10+ entries across 2+ collections. Run pb get <ID> or pb orient on one of your own entries to confirm retrieval, then activate.',
-    phase5: 'Activate your workspace by calling setup.recordActivationReceipt. The receipt closes the install-to-activation flow.',
-};
-export function resolveSetupState(input) {
-    const role = computeRole(input);
-    if (input.userActivated) {
-        return {
-            phase: 'settings',
-            role,
-            expectedAction: ACTIONS.settings,
-            reasonForPhase: 'userActivated=true → settings sub-state (post-activation re-run).',
-            isComplete: true,
-            surfaceCapability: input.surfaceCapability,
-        };
-    }
-    const surfaceSkipsP1P2 = input.surfaceCapability === 'chat-only';
-    const isJoiner = role === 'joiner';
-    const p1Done = input.manifest.surfaces.length >= 1 || surfaceSkipsP1P2;
-    if (!p1Done && !isJoiner) {
-        return {
-            phase: 1,
-            role,
-            expectedAction: ACTIONS.phase1,
-            reasonForPhase: 'manifest.surfaces empty AND surfaceCapability=cli → Phase 1.',
-            isComplete: false,
-            surfaceCapability: input.surfaceCapability,
-        };
-    }
-    const p2Skipped = surfaceSkipsP1P2;
-    const p2Done = p2Skipped || input.assetCounts.totalUnimported === 0;
-    if (!p2Done) {
-        return {
-            phase: 2,
-            role,
-            expectedAction: ACTIONS.phase2,
-            reasonForPhase: `Phase 1 done; assetCounts.totalUnimported=${input.assetCounts.totalUnimported} > 0 → Phase 2.`,
-            isComplete: false,
-            surfaceCapability: input.surfaceCapability,
-        };
-    }
-    const p3Skipped = isJoiner;
-    const p3Done = p3Skipped || input.catalogAdoptionCount >= 1;
-    if (!p3Done) {
-        return {
-            phase: 3,
-            role,
-            expectedAction: ACTIONS.phase3,
-            reasonForPhase: `Phase 2 done${surfaceSkipsP1P2 ? ' (surface-skipped per DEC-993)' : ''}; catalogAdoptionCount=0 → Phase 3.`,
-            isComplete: false,
-            surfaceCapability: input.surfaceCapability,
-        };
-    }
-    const enoughEntries = input.confirmedEntryCount >= 10;
-    const enoughDiversity = input.entriesAcrossCollections >= 2;
-    const p4Done = enoughEntries && enoughDiversity && input.retrievalDemoConfirmed;
-    if (!p4Done) {
-        let action = ACTIONS.phase4;
-        if (enoughEntries && !enoughDiversity) {
-            action = ACTIONS.phase4Diversity;
-        }
-        else if (enoughEntries && enoughDiversity && !input.retrievalDemoConfirmed) {
-            action = ACTIONS.phase4Retrieval;
-        }
-        return {
-            phase: 4,
-            role,
-            expectedAction: action,
-            reasonForPhase: `Phase 3 done${p3Skipped ? ' (joiner skip)' : ''}; confirmedEntryCount=${input.confirmedEntryCount} (>=10? ${enoughEntries}), entriesAcrossCollections=${input.entriesAcrossCollections} (>=2? ${enoughDiversity}), retrievalDemoConfirmed=${input.retrievalDemoConfirmed} → Phase 4.`,
-            isComplete: false,
-            surfaceCapability: input.surfaceCapability,
-        };
-    }
-    return {
-        phase: 5,
-        role,
-        expectedAction: ACTIONS.phase5,
-        reasonForPhase: 'Phase 4 exit conditions met (>=10 entries, >=2 collections, retrieval demo confirmed); userActivated=false → Phase 5.',
-        isComplete: false,
-        surfaceCapability: input.surfaceCapability,
-    };
-}
-function computeRole(input) {
-    if (input.workspaceMaterialized && !input.userActivated)
-        return 'joiner';
-    return 'creator';
-}
-//# sourceMappingURL=state-machine.js.map

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

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