@productbrain/cli 0.1.0-beta.95 → 0.1.0-beta.951

package/dist/setup/__tests__/state-machine.test.js

@@ -0,0 +1,341 @@
+/**
+ * WP-431 S2 — pure resolver tests for the pb-setup state machine.
+ *
+ * 20-cell matrix: 5 phases × 2 roles × 2 surface capabilities. Several cells
+ * degenerate (a joiner cannot be in Phase 1 or Phase 3 by definition); those
+ * are tested explicitly to assert the expected redirection.
+ */
+import { describe, expect, it } from 'vitest';
+import { resolveSetupState, } from '../state-machine.js';
+function baseInput(overrides = {}) {
+    return {
+        manifest: { surfaces: [] },
+        assetCounts: { totalAssets: 0, totalUnimported: 0, hasMore: false },
+        catalogAdoptionCount: 0,
+        confirmedEntryCount: 0,
+        entriesAcrossCollections: 0,
+        retrievalDemoConfirmed: false,
+        workspaceMaterialized: false,
+        userActivated: false,
+        surfaceCapability: 'cli',
+        ...overrides,
+    };
+}
+function creatorAtPhase(target, surface) {
+    const cli = surface === 'cli';
+    switch (target) {
+        case 1:
+            return baseInput({ surfaceCapability: surface });
+        case 2:
+            return baseInput({
+                surfaceCapability: surface,
+                manifest: { surfaces: cli ? ['claude'] : ['mcp-only'] },
+                assetCounts: { totalAssets: 5, totalUnimported: 3, hasMore: false },
+            });
+        case 3:
+            return baseInput({
+                surfaceCapability: surface,
+                manifest: { surfaces: cli ? ['claude'] : ['mcp-only'] },
+                assetCounts: { totalAssets: 5, totalUnimported: 0, hasMore: false },
+                catalogAdoptionCount: 0,
+            });
+        case 4:
+            return baseInput({
+                surfaceCapability: surface,
+                manifest: { surfaces: cli ? ['claude'] : ['mcp-only'] },
+                assetCounts: { totalAssets: 5, totalUnimported: 0, hasMore: false },
+                catalogAdoptionCount: 1,
+                confirmedEntryCount: 4,
+                entriesAcrossCollections: 1,
+                retrievalDemoConfirmed: false,
+            });
+        case 5:
+            return baseInput({
+                surfaceCapability: surface,
+                manifest: { surfaces: cli ? ['claude'] : ['mcp-only'] },
+                assetCounts: { totalAssets: 5, totalUnimported: 0, hasMore: false },
+                catalogAdoptionCount: 1,
+                confirmedEntryCount: 12,
+                entriesAcrossCollections: 3,
+                retrievalDemoConfirmed: true,
+            });
+    }
+}
+function joinerInput(surface, overrides = {}) {
+    return baseInput({
+        surfaceCapability: surface,
+        workspaceMaterialized: true,
+        manifest: { surfaces: surface === 'cli' ? ['claude'] : ['mcp-only'] },
+        assetCounts: { totalAssets: 0, totalUnimported: 0, hasMore: false },
+        ...overrides,
+    });
+}
+function expectReason(out) {
+    expect(out.reasonForPhase).toBeTruthy();
+    expect(out.reasonForPhase.length).toBeGreaterThan(10);
+    expect(out.reasonForPhase.toLowerCase()).not.toContain('tbd');
+}
+describe('resolveSetupState — 20-cell matrix (5 phases × 2 roles × 2 surface capabilities)', () => {
+    // ── Creator + cli (5 cells) ─────────────────────────────────────────────
+    it('creator + cli + Phase 1: manifest empty', () => {
+        const out = resolveSetupState(creatorAtPhase(1, 'cli'));
+        expect(out.phase).toBe(1);
+        expect(out.role).toBe('creator');
+        expect(out.isComplete).toBe(false);
+        expectReason(out);
+    });
+    it('creator + cli + Phase 2: manifest set, unimported assets present', () => {
+        const out = resolveSetupState(creatorAtPhase(2, 'cli'));
+        expect(out.phase).toBe(2);
+        expect(out.role).toBe('creator');
+        expectReason(out);
+    });
+    it('creator + cli + Phase 3: P2 done, no catalog adoption yet', () => {
+        const out = resolveSetupState(creatorAtPhase(3, 'cli'));
+        expect(out.phase).toBe(3);
+        expect(out.role).toBe('creator');
+        expectReason(out);
+    });
+    it('creator + cli + Phase 4: capture loop in progress', () => {
+        const out = resolveSetupState(creatorAtPhase(4, 'cli'));
+        expect(out.phase).toBe(4);
+        expect(out.role).toBe('creator');
+        expectReason(out);
+    });
+    it('creator + cli + Phase 5: all P4 conditions met, awaiting activation', () => {
+        const out = resolveSetupState(creatorAtPhase(5, 'cli'));
+        expect(out.phase).toBe(5);
+        expect(out.role).toBe('creator');
+        expectReason(out);
+    });
+    // ── Creator + chat-only (5 cells; Phase 1 + Phase 2 are degenerate — chat-only skips them) ─────
+    it('creator + chat-only + Phase 1 (degenerate): chat-only skips P1 → Phase 3 entry', () => {
+        const out = resolveSetupState(baseInput({ surfaceCapability: 'chat-only' }));
+        // Manifest empty + chat-only means surfaceSkipsP1P2 satisfies P1 done; jumps past P2.
+        expect(out.phase).toBe(3);
+        expect(out.role).toBe('creator');
+        expectReason(out);
+    });
+    it('creator + chat-only + Phase 2 (degenerate): chat-only never enters P2 → Phase 3', () => {
+        const out = resolveSetupState(baseInput({
+            surfaceCapability: 'chat-only',
+            manifest: { surfaces: ['mcp-only'] },
+            // unimported set, but chat-only must still skip P2
+            assetCounts: { totalAssets: 5, totalUnimported: 3, hasMore: false },
+        }));
+        expect(out.phase).toBe(3);
+        expectReason(out);
+    });
+    it('creator + chat-only + Phase 3', () => {
+        const out = resolveSetupState(creatorAtPhase(3, 'chat-only'));
+        expect(out.phase).toBe(3);
+        expect(out.role).toBe('creator');
+        expectReason(out);
+    });
+    it('creator + chat-only + Phase 4', () => {
+        const out = resolveSetupState(creatorAtPhase(4, 'chat-only'));
+        expect(out.phase).toBe(4);
+        expect(out.role).toBe('creator');
+        expectReason(out);
+    });
+    it('creator + chat-only + Phase 5', () => {
+        const out = resolveSetupState(creatorAtPhase(5, 'chat-only'));
+        expect(out.phase).toBe(5);
+        expect(out.role).toBe('creator');
+        expectReason(out);
+    });
+    // ── Joiner + cli (5 cells; Phase 1 + Phase 3 are degenerate — joiners skip both) ────────
+    it('joiner + cli + Phase 1 (degenerate): joiner skips P1 → Phase 2 (with local content)', () => {
+        const out = resolveSetupState(joinerInput('cli', {
+            assetCounts: { totalAssets: 3, totalUnimported: 3, hasMore: false },
+        }));
+        expect(out.phase).toBe(2);
+        expect(out.role).toBe('joiner');
+        expectReason(out);
+    });
+    it('joiner + cli + Phase 2: joiner with their own local content', () => {
+        const out = resolveSetupState(joinerInput('cli', {
+            assetCounts: { totalAssets: 5, totalUnimported: 2, hasMore: false },
+        }));
+        expect(out.phase).toBe(2);
+        expect(out.role).toBe('joiner');
+        expectReason(out);
+    });
+    it('joiner + cli + Phase 3 (degenerate): joiner skips P3 → jumps to Phase 4', () => {
+        const out = resolveSetupState(joinerInput('cli', {
+            assetCounts: { totalAssets: 0, totalUnimported: 0, hasMore: false },
+            catalogAdoptionCount: 0,
+            confirmedEntryCount: 2,
+        }));
+        expect(out.phase).toBe(4);
+        expect(out.role).toBe('joiner');
+        expectReason(out);
+    });
+    it('joiner + cli + Phase 4: joiner in capture loop', () => {
+        const out = resolveSetupState(joinerInput('cli', {
+            confirmedEntryCount: 5,
+            entriesAcrossCollections: 2,
+            retrievalDemoConfirmed: false,
+        }));
+        expect(out.phase).toBe(4);
+        expect(out.role).toBe('joiner');
+        expectReason(out);
+    });
+    it('joiner + cli + Phase 5: joiner ready to activate', () => {
+        const out = resolveSetupState(joinerInput('cli', {
+            confirmedEntryCount: 11,
+            entriesAcrossCollections: 3,
+            retrievalDemoConfirmed: true,
+        }));
+        expect(out.phase).toBe(5);
+        expect(out.role).toBe('joiner');
+        expectReason(out);
+    });
+    // ── Joiner + chat-only (5 cells; Phases 1, 2, 3 all degenerate) ────────────
+    it('joiner + chat-only + Phase 1 (degenerate): jumps to Phase 4', () => {
+        const out = resolveSetupState(joinerInput('chat-only'));
+        expect(out.phase).toBe(4);
+        expect(out.role).toBe('joiner');
+        expectReason(out);
+    });
+    it('joiner + chat-only + Phase 2 (degenerate): joiner+chat-only never enters P2', () => {
+        const out = resolveSetupState(joinerInput('chat-only', {
+            assetCounts: { totalAssets: 5, totalUnimported: 3, hasMore: false },
+        }));
+        expect(out.phase).toBe(4);
+        expect(out.role).toBe('joiner');
+        expectReason(out);
+    });
+    it('joiner + chat-only + Phase 3 (degenerate): jumps to Phase 4', () => {
+        const out = resolveSetupState(joinerInput('chat-only', {
+            catalogAdoptionCount: 0,
+        }));
+        expect(out.phase).toBe(4);
+        expect(out.role).toBe('joiner');
+        expectReason(out);
+    });
+    it('joiner + chat-only + Phase 4', () => {
+        const out = resolveSetupState(joinerInput('chat-only', {
+            confirmedEntryCount: 6,
+            entriesAcrossCollections: 2,
+            retrievalDemoConfirmed: false,
+        }));
+        expect(out.phase).toBe(4);
+        expect(out.role).toBe('joiner');
+        expectReason(out);
+    });
+    it('joiner + chat-only + Phase 5', () => {
+        const out = resolveSetupState(joinerInput('chat-only', {
+            confirmedEntryCount: 10,
+            entriesAcrossCollections: 2,
+            retrievalDemoConfirmed: true,
+        }));
+        expect(out.phase).toBe(5);
+        expect(out.role).toBe('joiner');
+        expectReason(out);
+    });
+});
+describe('resolveSetupState — DEC-994 soft-gate diversity nudge', () => {
+    it('confirmedEntryCount=10 + entriesAcrossCollections=1 → P4 with diversity nudge', () => {
+        const out = resolveSetupState(baseInput({
+            manifest: { surfaces: ['claude'] },
+            catalogAdoptionCount: 1,
+            confirmedEntryCount: 10,
+            entriesAcrossCollections: 1,
+            retrievalDemoConfirmed: true,
+        }));
+        expect(out.phase).toBe(4);
+        expect(out.expectedAction).toContain("they're all in one collection");
+        expect(out.expectedAction).toContain('different collection');
+    });
+    it('confirmedEntryCount=11 + entriesAcrossCollections=2 + retrievalDemoConfirmed=false → P4 retrieval nudge', () => {
+        const out = resolveSetupState(baseInput({
+            manifest: { surfaces: ['claude'] },
+            catalogAdoptionCount: 1,
+            confirmedEntryCount: 11,
+            entriesAcrossCollections: 2,
+            retrievalDemoConfirmed: false,
+        }));
+        expect(out.phase).toBe(4);
+        expect(out.expectedAction.toLowerCase()).toContain('retrieval');
+    });
+});
+describe('resolveSetupState — settings sub-state', () => {
+    it('userActivated=true → phase=settings (post-activation re-run)', () => {
+        const out = resolveSetupState(baseInput({
+            manifest: { surfaces: ['claude'] },
+            userActivated: true,
+            confirmedEntryCount: 12,
+            entriesAcrossCollections: 3,
+            retrievalDemoConfirmed: true,
+        }));
+        expect(out.phase).toBe('settings');
+        expect(out.isComplete).toBe(true);
+        expect(out.expectedAction).toContain('Settings menu');
+    });
+    it('settings sub-state: workspaceMaterialized + userActivated → role=creator (re-running their own activation)', () => {
+        // Per DEC-988: joiner = workspaceMaterialized AND !userActivated. After activation
+        // the user is no longer in joiner mode for further re-runs.
+        const out = resolveSetupState(baseInput({
+            workspaceMaterialized: true,
+            userActivated: true,
+        }));
+        expect(out.phase).toBe('settings');
+        expect(out.role).toBe('creator');
+    });
+});
+describe('resolveSetupState — re-run mid-flow returns the resumed phase verbatim', () => {
+    it('partial Phase 3 progress (no catalog adoption) → still Phase 3, no special re-run handling', () => {
+        const out = resolveSetupState(baseInput({
+            manifest: { surfaces: ['claude'] },
+            assetCounts: { totalAssets: 0, totalUnimported: 0, hasMore: false },
+            catalogAdoptionCount: 0,
+            confirmedEntryCount: 2,
+        }));
+        expect(out.phase).toBe(3);
+        // resumedPhase semantics belong to the skill body; resolver returns the bare phase.
+    });
+    it('partial Phase 4 progress (5 entries) → Phase 4, expectedAction is generic capture loop', () => {
+        const out = resolveSetupState(baseInput({
+            manifest: { surfaces: ['claude'] },
+            catalogAdoptionCount: 1,
+            confirmedEntryCount: 5,
+            entriesAcrossCollections: 1,
+        }));
+        expect(out.phase).toBe(4);
+        expect(out.expectedAction).toContain('pb capture');
+    });
+});
+describe('resolveSetupState — surfaceCapability passthrough (WP-431 S3 review fix #1)', () => {
+    it('surfaceCapability=cli flows through every cell', () => {
+        const out = resolveSetupState(baseInput({ surfaceCapability: 'cli' }));
+        expect(out.surfaceCapability).toBe('cli');
+    });
+    it('surfaceCapability=chat-only flows through every cell', () => {
+        const out = resolveSetupState(baseInput({ surfaceCapability: 'chat-only' }));
+        expect(out.surfaceCapability).toBe('chat-only');
+    });
+    it('settings sub-state carries surfaceCapability through verbatim', () => {
+        const out = resolveSetupState(baseInput({
+            surfaceCapability: 'chat-only',
+            userActivated: true,
+        }));
+        expect(out.phase).toBe('settings');
+        expect(out.surfaceCapability).toBe('chat-only');
+    });
+});
+describe('resolveSetupState — role detection', () => {
+    it('workspaceMaterialized=false → creator', () => {
+        const out = resolveSetupState(baseInput({ workspaceMaterialized: false }));
+        expect(out.role).toBe('creator');
+    });
+    it('workspaceMaterialized=true AND userActivated=false → joiner', () => {
+        const out = resolveSetupState(baseInput({ workspaceMaterialized: true, userActivated: false }));
+        expect(out.role).toBe('joiner');
+    });
+    it('workspaceMaterialized=true AND userActivated=true → creator (post-activation, joiner mode released)', () => {
+        const out = resolveSetupState(baseInput({ workspaceMaterialized: true, userActivated: true }));
+        expect(out.role).toBe('creator');
+    });
+});
+//# sourceMappingURL=state-machine.test.js.map

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

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

package/dist/setup/detect-surfaces.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 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 { type SurfaceName } from '../surfaces/registry.js';
+/**
+ * Run every adapter's `detect` against `repoRoot` and return the names of
+ * surfaces that resolved truthy, in registry order.
+ */
+export declare function detectSurfaces(repoRoot: string): Promise<SurfaceName[]>;
+/**
+ * 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 declare function unionSurfaces(existing: string[], detected: string[]): string[];
+//# sourceMappingURL=detect-surfaces.d.ts.map

package/dist/setup/detect-surfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-surfaces.d.ts","sourceRoot":"","sources":["../../src/setup/detect-surfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE7E;;;GAGG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAQ7E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAK9E"}

package/dist/setup/detect-surfaces.js

@@ -0,0 +1,39 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,17 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,153 @@
+/**
+ * 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

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