@productbrain/cli 0.1.0-beta.20 → 0.1.0-beta.2065

package/dist/generators/manifest.js

@@ -0,0 +1,277 @@
+/**
+ * Manifest reader — reads .productbrain/manifest.yaml for adoption state.
+ * WP-310 E1: personal workspace layer — manifest-based filtering.
+ * WP-421 S1 (#35): extends Manifest with DEC-951 authority keys (`materialize`,
+ * `surfaces`, `lock`) and adds `readManifestStatus()` — a typed reader that
+ * returns the FULL UNION of legacy + new fields plus a `parseStatus`
+ * discriminator (DEC-955, DEC-963 "Authority mode parse semantics").
+ *
+ * No external YAML dependency is required; the manifest schema is
+ * simple enough to parse with a minimal line-by-line parser.
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+// ── Minimal YAML parser ────────────────────────────────────────────────
+//
+// Handles the subset of YAML used by manifest.yaml:
+//   - Top-level key: value pairs (strings, booleans)
+//   - Nested objects (one level deep, e.g. hooks.cursor: true)
+//   - Sequence lists under a key:
+//       adopted:
+//         - rule-a
+//         - rule-b
+//
+// Does NOT handle: multi-line strings, anchors, complex quoting, etc.
+function parseManifestYaml(raw) {
+    const result = {};
+    const lines = raw.split('\n');
+    let currentKey = null;
+    let currentArray = null;
+    let currentObject = null;
+    const commitCurrent = () => {
+        if (currentKey !== null) {
+            if (currentArray !== null) {
+                result[currentKey] = currentArray;
+            }
+            else if (currentObject !== null) {
+                result[currentKey] = currentObject;
+            }
+        }
+        currentKey = null;
+        currentArray = null;
+        currentObject = null;
+    };
+    for (let i = 0; i < lines.length; i++) {
+        const rawLine = lines[i];
+        const line = rawLine;
+        // Skip comments and blank lines
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        // Array item: "  - value"
+        const arrayItemMatch = line.match(/^(\s+)-\s+(.+)$/);
+        if (arrayItemMatch && currentKey !== null) {
+            const indent = arrayItemMatch[1].length;
+            const value = arrayItemMatch[2].trim().replace(/^['"]|['"]$/g, '');
+            if (indent >= 2) {
+                if (currentArray !== null) {
+                    currentArray.push(value);
+                    continue;
+                }
+            }
+        }
+        // Nested key-value: "  key: value"
+        const nestedKvMatch = line.match(/^(\s{2,})([a-zA-Z_][a-zA-Z0-9_-]*):\s*(.*)$/);
+        if (nestedKvMatch && currentKey !== null) {
+            if (currentObject === null) {
+                // Transition: previous currentArray (if any) is lost — nested objects start fresh
+                currentArray = null;
+                currentObject = {};
+            }
+            const nestedVal = nestedKvMatch[3].trim();
+            currentObject[nestedKvMatch[2]] = parseScalar(nestedVal);
+            continue;
+        }
+        // Top-level key: value
+        const kvMatch = line.match(/^([a-zA-Z_][a-zA-Z0-9_-]*):\s*(.*)$/);
+        if (kvMatch) {
+            commitCurrent();
+            const key = kvMatch[1];
+            const val = kvMatch[2].trim();
+            if (val === '') {
+                // Value will come on subsequent lines (array or object)
+                currentKey = key;
+                currentArray = null;
+                currentObject = null;
+                // Peek ahead using index — avoid indexOf which breaks on duplicate lines
+                const nextContent = lines.slice(i + 1).find((l) => l.trim() && !l.trim().startsWith('#'));
+                if (nextContent && nextContent.match(/^\s+-\s+/)) {
+                    currentArray = [];
+                }
+                else if (nextContent && nextContent.match(/^\s{2,}[a-zA-Z]/)) {
+                    currentObject = {};
+                }
+            }
+            else {
+                result[key] = parseScalar(val);
+            }
+            continue;
+        }
+    }
+    commitCurrent();
+    return result;
+}
+function parseScalar(val) {
+    const stripped = val.replace(/^['"]|['"]$/g, '');
+    if (stripped === 'true')
+        return true;
+    if (stripped === 'false')
+        return false;
+    if (stripped === 'null' || stripped === '~')
+        return null;
+    if (/^\d+$/.test(stripped))
+        return parseInt(stripped, 10);
+    return stripped;
+}
+// ── Public API ─────────────────────────────────────────────────────────
+/** Valid AuthorityMode values, derived once for runtime guards. */
+const VALID_AUTHORITY_MODES = new Set([
+    'off',
+    'observe',
+    'project',
+    'govern',
+]);
+/** Valid LockLevel values. */
+const VALID_LOCK_LEVELS = new Set([
+    'platform',
+    'workspace',
+    'personal',
+]);
+/**
+ * Validate a parsed manifest object against the union schema.
+ * Returns the typed Manifest on success, null on any shape violation.
+ *
+ * Shared between `readManifest()` and `readManifestStatus()` so legacy
+ * callers and the WP-421 typed reader agree on what counts as parseable.
+ */
+function validateManifestShape(parsed) {
+    // Require version to be a string; reject missing or non-string values
+    if (typeof parsed.version !== 'string')
+        return null;
+    // Validate array fields — scalar values (e.g. adopted: "rule-a") must be rejected
+    if (parsed.adopted !== undefined && !Array.isArray(parsed.adopted))
+        return null;
+    if (parsed.rejected !== undefined && !Array.isArray(parsed.rejected))
+        return null;
+    // Validate method_source if present — only 'chain' | 'bundled' are valid
+    if (parsed.method_source !== undefined &&
+        parsed.method_source !== 'chain' &&
+        parsed.method_source !== 'bundled')
+        return null;
+    // ── WP-421 S1 — DEC-951 keys ─────────────────────────────────────────
+    // materialize: optional; if present, must be a known AuthorityMode.
+    if (parsed.materialize !== undefined &&
+        !(typeof parsed.materialize === 'string' && VALID_AUTHORITY_MODES.has(parsed.materialize))) {
+        return null;
+    }
+    // surfaces: optional; if present, must be an array of strings.
+    if (parsed.surfaces !== undefined) {
+        if (!Array.isArray(parsed.surfaces))
+            return null;
+        if (!parsed.surfaces.every((s) => typeof s === 'string'))
+            return null;
+    }
+    // lock: optional; if present, must be a plain object whose values are valid LockLevels.
+    if (parsed.lock !== undefined) {
+        if (parsed.lock === null ||
+            typeof parsed.lock !== 'object' ||
+            Array.isArray(parsed.lock)) {
+            return null;
+        }
+        for (const value of Object.values(parsed.lock)) {
+            if (typeof value !== 'string' || !VALID_LOCK_LEVELS.has(value)) {
+                return null;
+            }
+        }
+    }
+    return parsed;
+}
+/**
+ * Read .productbrain/manifest.yaml.
+ * Returns null if the file is absent or unparseable (treat as no-op).
+ *
+ * Legacy reader — kept for callers that only need adoption-state filtering.
+ * WP-421 callers should prefer `readManifestStatus()` for typed authority
+ * mode + parse-status discriminator.
+ */
+export function readManifest(productbrainDir) {
+    const manifestPath = join(productbrainDir, 'manifest.yaml');
+    if (!existsSync(manifestPath))
+        return null;
+    try {
+        const raw = readFileSync(manifestPath, 'utf8');
+        const parsed = parseManifestYaml(raw);
+        return validateManifestShape(parsed);
+    }
+    catch {
+        return null; // malformed manifest = treat as absent
+    }
+}
+/**
+ * Read manifest with full WP-421 authority typing (#35).
+ *
+ * Returns the FULL UNION of legacy + DEC-951 keys plus a `parseStatus`
+ * discriminator. Defaults per DEC-955 / DEC-963:
+ *   - `.productbrain/` directory absent → mode='off', parseStatus='absent'
+ *   - Directory present, manifest absent → mode='observe', parseStatus='absent'
+ *   - Manifest present, no `materialize:` → mode='observe', parseStatus='ok'
+ *   - Manifest unparseable / fails shape validation → mode='observe',
+ *     parseStatus='unparseable' (NEVER 'project'/'govern' — fail closed).
+ *
+ * @param productbrainDir Absolute path to the `.productbrain/` directory.
+ *   The directory itself MAY be absent — caller passes the candidate path
+ *   regardless and this reader infers the mode from filesystem state.
+ */
+export function readManifestStatus(productbrainDir) {
+    // No `.productbrain/` directory at all → mode 'off' (DEC-955).
+    if (!existsSync(productbrainDir)) {
+        return { mode: 'off', surfaces: [], lock: {}, parseStatus: 'absent', manifest: null };
+    }
+    const manifestPath = join(productbrainDir, 'manifest.yaml');
+    // Directory present but no manifest file → mode 'observe', absent.
+    if (!existsSync(manifestPath)) {
+        return { mode: 'observe', surfaces: [], lock: {}, parseStatus: 'absent', manifest: null };
+    }
+    let raw;
+    try {
+        raw = readFileSync(manifestPath, 'utf8');
+    }
+    catch {
+        // I/O failure — treat as unparseable, fail closed to observe (DEC-963).
+        return { mode: 'observe', surfaces: [], lock: {}, parseStatus: 'unparseable', manifest: null };
+    }
+    let parsed;
+    try {
+        parsed = parseManifestYaml(raw);
+    }
+    catch {
+        return { mode: 'observe', surfaces: [], lock: {}, parseStatus: 'unparseable', manifest: null };
+    }
+    const validated = validateManifestShape(parsed);
+    if (validated === null) {
+        // Shape violation (e.g. invalid materialize value, malformed lock map).
+        // Fail closed to observe per DEC-963 — NEVER project/govern.
+        return { mode: 'observe', surfaces: [], lock: {}, parseStatus: 'unparseable', manifest: null };
+    }
+    return {
+        mode: validated.materialize ?? 'observe',
+        surfaces: validated.surfaces ?? [],
+        lock: validated.lock ?? {},
+        parseStatus: 'ok',
+        manifest: validated,
+    };
+}
+/**
+ * Filter a list of items by the manifest's adopted/rejected lists.
+ *
+ * Rules:
+ * - No manifest → return all items unchanged (no-op, preserves current behaviour).
+ * - rejected denylist applied first — excluded regardless of adopted.
+ * - adopted allowlist applied second — only items in the list pass (only when non-empty).
+ * - Empty adopted array → allowlist is inactive, all non-rejected items pass.
+ */
+export function filterByAdoptionState(items, manifest) {
+    if (!manifest)
+        return items;
+    const adopted = manifest.adopted ?? [];
+    const rejected = new Set(manifest.rejected ?? []);
+    // Apply rejected denylist first
+    let filtered = items.filter((item) => !rejected.has(item.name));
+    // Apply adopted allowlist (only when non-empty)
+    if (adopted.length > 0) {
+        const adoptedSet = new Set(adopted);
+        filtered = filtered.filter((item) => adoptedSet.has(item.name));
+    }
+    return filtered;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/generators/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/generators/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AA0E5B,0EAA0E;AAC1E,EAAE;AACF,oDAAoD;AACpD,qDAAqD;AACrD,+DAA+D;AAC/D,kCAAkC;AAClC,iBAAiB;AACjB,mBAAmB;AACnB,mBAAmB;AACnB,EAAE;AACF,sEAAsE;AAEtE,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,YAAY,GAAoB,IAAI,CAAC;IACzC,IAAI,aAAa,GAAmC,IAAI,CAAC;IAEzD,MAAM,aAAa,GAAG,GAAG,EAAE;QACzB,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;gBAC1B,MAAM,CAAC,UAAU,CAAC,GAAG,YAAY,CAAC;YACpC,CAAC;iBAAM,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;gBAClC,MAAM,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC;YACrC,CAAC;QACH,CAAC;QACD,UAAU,GAAG,IAAI,CAAC;QAClB,YAAY,GAAG,IAAI,CAAC;QACpB,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,OAAO,CAAC;QAErB,gCAAgC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAElD,0BAA0B;QAC1B,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrD,IAAI,cAAc,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACxC,MAAM,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YACnE,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;gBAChB,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;oBAC1B,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACzB,SAAS;gBACX,CAAC;YACH,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAChF,IAAI,aAAa,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACzC,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;gBAC3B,kFAAkF;gBAClF,YAAY,GAAG,IAAI,CAAC;gBACpB,aAAa,GAAG,EAAE,CAAC;YACrB,CAAC;YACD,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1C,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;YACzD,SAAS;QACX,CAAC;QAED,uBAAuB;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAClE,IAAI,OAAO,EAAE,CAAC;YACZ,aAAa,EAAE,CAAC;YAChB,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9B,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;gBACf,wDAAwD;gBACxD,UAAU,GAAG,GAAG,CAAC;gBACjB,YAAY,GAAG,IAAI,CAAC;gBACpB,aAAa,GAAG,IAAI,CAAC;gBACrB,yEAAyE;gBACzE,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC1F,IAAI,WAAW,IAAI,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;oBACjD,YAAY,GAAG,EAAE,CAAC;gBACpB,CAAC;qBAAM,IAAI,WAAW,IAAI,WAAW,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;oBAC/D,aAAa,GAAG,EAAE,CAAC;gBACrB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YACjC,CAAC;YACD,SAAS;QACX,CAAC;IACH,CAAC;IAED,aAAa,EAAE,CAAC;IAChB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACjD,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACzD,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC1D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,0EAA0E;AAE1E,mEAAmE;AACnE,MAAM,qBAAqB,GAA+B,IAAI,GAAG,CAAC;IAChE,KAAK;IACL,SAAS;IACT,SAAS;IACT,QAAQ;CACT,CAAC,CAAC;AAEH,8BAA8B;AAC9B,MAAM,iBAAiB,GAA2B,IAAI,GAAG,CAAC;IACxD,UAAU;IACV,WAAW;IACX,UAAU;CACX,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,SAAS,qBAAqB,CAAC,MAA+B;IAC5D,sEAAsE;IACtE,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACpD,kFAAkF;IAClF,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAChF,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAClF,yEAAyE;IACzE,IACE,MAAM,CAAC,aAAa,KAAK,SAAS;QAClC,MAAM,CAAC,aAAa,KAAK,OAAO;QAChC,MAAM,CAAC,aAAa,KAAK,SAAS;QAElC,OAAO,IAAI,CAAC;IACd,wEAAwE;IACxE,oEAAoE;IACpE,IACE,MAAM,CAAC,WAAW,KAAK,SAAS;QAChC,CAAC,CAAC,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,IAAI,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,WAA4B,CAAC,CAAC,EAC3G,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,+DAA+D;IAC/D,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;IACxE,CAAC;IACD,wFAAwF;IACxF,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,IACE,MAAM,CAAC,IAAI,KAAK,IAAI;YACpB,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;YAC/B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAC1B,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAA+B,CAAC,EAAE,CAAC;YAC1E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAkB,CAAC,EAAE,CAAC;gBAC5E,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAA6B,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,eAAuB;IAClD,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IAC5D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACtC,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,uCAAuC;IACtD,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAAC,eAAuB;IACxD,+DAA+D;IAC/D,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACxF,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IAC5D,mEAAmE;IACnE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5F,CAAC;IAED,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;QACxE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjG,CAAC;IAED,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjG,CAAC;IAED,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,wEAAwE;QACxE,6DAA6D;QAC7D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjG,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,WAAW,IAAI,SAAS;QACxC,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,EAAE;QAClC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,EAAE;QAC1B,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,SAAS;KACpB,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAU,EACV,QAAyB;IAEzB,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5B,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAElD,gCAAgC;IAChC,IAAI,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhE,gDAAgD;IAChD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QACpC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/generators/portable-knowledge.d.ts

@@ -2,6 +2,8 @@
  * Portable knowledge — reads canonical skills/rules from .productbrain/
  * and generates tool-specific copies for Cursor, Claude Code, etc.
  */
+import type { SurfaceProfile, TargetName } from './surface-profiles.js';
+export type { TargetName };
 export interface WhenConditions {
     when_stack?: string;
     when_minStage?: string;
@@ -16,19 +18,28 @@ export interface CanonicalSkill {
     targets?: string[];
     level?: string;
     conditions?: WhenConditions;
+    /** 'team' = default; 'local' = local surface files only, never committed. */
+    persist?: 'local' | 'team';
 }
 export interface CanonicalRule {
     name: string;
     description: string;
     scope?: string;
+    /**
+     * Path-scope glob for path-aware surfaces (e.g. "convex/**\/*.ts"). Drives the
+     * GitHub Copilot `.github/instructions/<name>.instructions.md` fan-out (applyTo frontmatter)
+     * and, in principle, nested CLAUDE.md/AGENTS.md placement. Absent = repo-wide only.
+     */
+    applyTo?: string;
     autoApply: boolean;
     body: string;
     sourcePath: string;
     targets?: string[];
     level?: string;
     conditions?: WhenConditions;
+    /** 'team' = default; 'local' = local surface files only, never committed. */
+    persist?: 'local' | 'team';
 }
-export type TargetName = 'cursor' | 'claude' | 'copilot' | 'codex';
 /** Returns true if the entry should be emitted to the given target. */
 export declare function shouldEmitToTarget(entry: CanonicalRule | CanonicalSkill, target: TargetName): boolean;
 export type HandshakeLevel = 'beginner' | 'intermediate' | 'expert';
@@ -69,6 +80,18 @@ export declare function evaluateConditions(conditions: WhenConditions, profile:
 };
 export declare function readCanonicalSkills(productbrainDir: string): CanonicalSkill[];
 export declare function readCanonicalRules(productbrainDir: string): CanonicalRule[];
+/**
+ * Read machine-local personal rules from .productbrain/.local/rules/.
+ * Returns [] when the directory is absent — no-op when personal layer is not set up.
+ * Every returned rule has persist: 'local' set, marking it as part of the personal layer.
+ */
+export declare function readPersonalLayer(productbrainDir: string): CanonicalRule[];
+/**
+ * Read machine-local personal skills from .productbrain/.local/skills/.
+ * Returns [] when the directory is absent — no-op when personal layer is not set up.
+ * Every returned skill has persist: 'local' set, marking it as part of the personal layer.
+ */
+export declare function readPersonalSkillsLayer(productbrainDir: string): CanonicalSkill[];
 /**
  * Strip transport-conditional sections from a skill body.
  *
@@ -86,17 +109,34 @@ export declare function stripTransportSections(body: string, target: TargetName)
  * Generate a Cursor SKILL.md from a canonical skill.
  * Cursor expects: name, description (with triggers embedded).
  */
-export declare function generateCursorSkill(skill: CanonicalSkill): string;
+export declare function generateCursorSkill(skill: CanonicalSkill, profile?: SurfaceProfile): string;
 /**
  * Generate a Cursor .mdc rule from a canonical rule.
  * Cursor expects: description, globs, alwaysApply.
  */
-export declare function generateCursorRule(rule: CanonicalRule): string;
+export declare function generateCursorRule(rule: CanonicalRule, profile?: SurfaceProfile): string;
+/**
+ * Apply batch-mode transformations to a skill body (DEC-283).
+ *
+ * Skills describe WHAT (intent). This generator produces HOW (batch-appropriate
+ * instructions). We transform interactive patterns without gutting the skill's
+ * logical structure and purpose.
+ *
+ * Transformations applied:
+ * 1. Strip sub-agent spawn patterns → inline steps
+ * 2. Strip user confirmation gates → autonomous proceed
+ * 3. Strip streaming/interactive references
+ * 4. Add batch governance header after first `#` heading
+ */
+export declare function applyBatchTransformations(body: string): string;
 /**
  * Generate a Codex skill projection from a canonical skill.
  * This is a repo-local markdown projection, not a separate authoring source.
+ *
+ * When profile.executionModel === 'batch', batch transformations are applied
+ * AFTER transport stripping and path replacement (DEC-283).
  */
-export declare function generateCodexSkill(skill: CanonicalSkill): string;
+export declare function generateCodexSkill(skill: CanonicalSkill, profile?: SurfaceProfile): string;
 /**
  * Generate a Codex skill index/router file.
  * AGENTS.md can point here so Codex has one obvious place to find available workflows.
@@ -116,10 +156,10 @@ export declare function validateCodexSkills(skills: CanonicalSkill[]): CodexVali
  * Generate a Claude Code .md rule from a canonical rule.
  * Claude Code expects: description, optional paths (array).
  */
-export declare function generateClaudeRule(rule: CanonicalRule): string;
+export declare function generateClaudeRule(rule: CanonicalRule, profile?: SurfaceProfile): string;
 /**
  * Generate a Claude Code skill-router.md — imperative skill activation rule.
  * Loaded automatically by Claude Code via .claude/rules/ with no paths (always active).
  */
-export declare function generateClaudeSkillRouter(skills: CanonicalSkill[]): string;
+export declare function generateClaudeSkillRouter(skills: CanonicalSkill[], profile?: SurfaceProfile): string;
 //# sourceMappingURL=portable-knowledge.d.ts.map

package/dist/generators/portable-knowledge.d.ts.map

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

package/dist/generators/portable-knowledge.js

@@ -222,6 +222,7 @@ export function readCanonicalRules(productbrainDir) {
         const name = fields.get('name') ?? basename(file, '.md');
         const description = fields.get('description') ?? '';
         const scope = fields.get('scope');
+        const applyTo = fields.get('applyTo');
         const autoApply = fields.get('autoApply') === 'true';
         const targets = arrayFields.get('targets');
         const level = fields.get('level');
@@ -236,10 +237,104 @@ export function readCanonicalRules(productbrainDir) {
         if (whenMinGovernance)
             conditions.when_minGovernance = whenMinGovernance;
         const hasConditions = Object.keys(conditions).length > 0;
-        rules.push({ name, description, scope, autoApply, body, sourcePath: filePath, targets: targets?.length ? targets : undefined, level: level || undefined, conditions: hasConditions ? conditions : undefined });
+        rules.push({ name, description, scope, applyTo: applyTo || undefined, autoApply, body, sourcePath: filePath, targets: targets?.length ? targets : undefined, level: level || undefined, conditions: hasConditions ? conditions : undefined });
     }
     return rules.sort((a, b) => a.name.localeCompare(b.name));
 }
+/**
+ * Read machine-local personal rules from .productbrain/.local/rules/.
+ * Returns [] when the directory is absent — no-op when personal layer is not set up.
+ * Every returned rule has persist: 'local' set, marking it as part of the personal layer.
+ */
+export function readPersonalLayer(productbrainDir) {
+    const localRulesDir = join(productbrainDir, '.local', 'rules');
+    if (!existsSync(localRulesDir))
+        return [];
+    const files = readdirSync(localRulesDir).filter((f) => f.endsWith('.md'));
+    const rules = [];
+    for (const file of files) {
+        const filePath = join(localRulesDir, file);
+        const raw = readFileSync(filePath, 'utf8');
+        const { fields, arrayFields, body } = parseFrontmatter(raw);
+        const name = fields.get('name') ?? basename(file, '.md');
+        const description = fields.get('description') ?? '';
+        const scope = fields.get('scope');
+        const applyTo = fields.get('applyTo');
+        const autoApply = fields.get('autoApply') === 'true';
+        const targets = arrayFields.get('targets');
+        const level = fields.get('level');
+        const conditions = {};
+        const whenStack = fields.get('when_stack');
+        const whenMinStage = fields.get('when_minStage');
+        const whenMinGovernance = fields.get('when_minGovernance');
+        if (whenStack)
+            conditions.when_stack = whenStack;
+        if (whenMinStage)
+            conditions.when_minStage = whenMinStage;
+        if (whenMinGovernance)
+            conditions.when_minGovernance = whenMinGovernance;
+        const hasConditions = Object.keys(conditions).length > 0;
+        rules.push({
+            name,
+            description,
+            scope,
+            applyTo: applyTo || undefined,
+            autoApply,
+            body,
+            sourcePath: filePath,
+            targets: targets?.length ? targets : undefined,
+            level: level || undefined,
+            conditions: hasConditions ? conditions : undefined,
+            persist: 'local',
+        });
+    }
+    return rules.sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Read machine-local personal skills from .productbrain/.local/skills/.
+ * Returns [] when the directory is absent — no-op when personal layer is not set up.
+ * Every returned skill has persist: 'local' set, marking it as part of the personal layer.
+ */
+export function readPersonalSkillsLayer(productbrainDir) {
+    const localSkillsDir = join(productbrainDir, '.local', 'skills');
+    if (!existsSync(localSkillsDir))
+        return [];
+    const files = readdirSync(localSkillsDir).filter((f) => f.endsWith('.md'));
+    const skills = [];
+    for (const file of files) {
+        const filePath = join(localSkillsDir, file);
+        const raw = readFileSync(filePath, 'utf8');
+        const { fields, arrayFields, body } = parseFrontmatter(raw);
+        const name = fields.get('name') ?? basename(file, '.md');
+        const description = fields.get('description') ?? '';
+        const triggers = arrayFields.get('triggers') ?? [];
+        const targets = arrayFields.get('targets');
+        const level = fields.get('level');
+        const conditions = {};
+        const whenStack = fields.get('when_stack');
+        const whenMinStage = fields.get('when_minStage');
+        const whenMinGovernance = fields.get('when_minGovernance');
+        if (whenStack)
+            conditions.when_stack = whenStack;
+        if (whenMinStage)
+            conditions.when_minStage = whenMinStage;
+        if (whenMinGovernance)
+            conditions.when_minGovernance = whenMinGovernance;
+        const hasConditions = Object.keys(conditions).length > 0;
+        skills.push({
+            name,
+            description,
+            triggers,
+            body,
+            sourcePath: filePath,
+            targets: targets?.length ? targets : undefined,
+            level: level || undefined,
+            conditions: hasConditions ? conditions : undefined,
+            persist: 'local',
+        });
+    }
+    return skills.sort((a, b) => a.name.localeCompare(b.name));
+}
 // ── Transport section stripping ───────────────────────────────────────
 /**
  * Strip transport-conditional sections from a skill body.
@@ -271,7 +366,7 @@ export function stripTransportSections(body, target) {
  * Generate a Cursor SKILL.md from a canonical skill.
  * Cursor expects: name, description (with triggers embedded).
  */
-export function generateCursorSkill(skill) {
+export function generateCursorSkill(skill, profile) {
     // Cursor puts trigger phrases in the description field
     const triggerLine = skill.triggers.length > 0
         ? `  Use when the user says ${skill.triggers.map((t) => `"${t}"`).join(', ')}.`
@@ -296,7 +391,7 @@ ${body}`;
  * Generate a Cursor .mdc rule from a canonical rule.
  * Cursor expects: description, globs, alwaysApply.
  */
-export function generateCursorRule(rule) {
+export function generateCursorRule(rule, profile) {
     // Replace canonical paths with Cursor paths in body
     const body = rule.body
         .replace(/\.productbrain\/rules\/(\S+)\.md/g, '.cursor/rules/$1.mdc')
@@ -311,17 +406,65 @@ alwaysApply: ${!rule.scope && rule.autoApply}
 ${body}`;
 }
 // ── Codex generators ───────────────────────────────────────────────────
+/**
+ * Apply batch-mode transformations to a skill body (DEC-283).
+ *
+ * Skills describe WHAT (intent). This generator produces HOW (batch-appropriate
+ * instructions). We transform interactive patterns without gutting the skill's
+ * logical structure and purpose.
+ *
+ * Transformations applied:
+ * 1. Strip sub-agent spawn patterns → inline steps
+ * 2. Strip user confirmation gates → autonomous proceed
+ * 3. Strip streaming/interactive references
+ * 4. Add batch governance header after first `#` heading
+ */
+export function applyBatchTransformations(body) {
+    // Split into fenced code blocks vs prose so transforms only apply to prose.
+    // Fenced blocks (``` or ~~~) may contain examples of interactive patterns
+    // that must be preserved verbatim.
+    const segments = body.split(/(^```[^\n]*\n[\s\S]*?^```\s*$|^~~~[^\n]*\n[\s\S]*?^~~~\s*$)/m);
+    let result = segments
+        .map((segment, i) => {
+        // Odd indices are fenced code blocks — pass through unchanged
+        if (i % 2 === 1)
+            return segment;
+        return applyProseTransformations(segment);
+    })
+        .join('');
+    // 4. Add batch governance header after the first `#` heading line
+    const batchHeader = '> Batch execution mode: This skill runs autonomously without interactive gates. Decisions are logged, not prompted.';
+    result = result.replace(/^(#\s+[^\n]+)(\n)/m, `$1$2\n${batchHeader}\n`);
+    return result;
+}
+/** Apply interactive-pattern transforms to a prose segment (not inside code fences). */
+function applyProseTransformations(text) {
+    let result = text;
+    // 1. Sub-agent spawn patterns — lines that dispatch to sub-agents or fresh conversations
+    result = result.replace(/^.*\b(spawn\s+(a\s+)?(sub-agent|build\s+sub-agent|review\s+sub-agent|judge|system\s+verification\s+agent)|Agent\s+tool\s+dispatch|fresh\s+conversation\s+handoff|open\s+a\s+(new|fresh)\s+(conversation|chat)|start\s+a\s+(new|fresh)\s+(conversation|chat))\b.*$/gim, 'Execute as inline steps within this session.');
+    // 2. User confirmation gates — lines that halt for human input
+    result = result.replace(/^.*\b(ask\s+the\s+(user|human)|wait\s+for\s+(user\s+)?input|present\s+gate\s+to\s+(the\s+)?user|stop\s+and\s+ask|pause\s+and\s+ask|get\s+user\s+confirmation|awaiting\s+your\s+feedback|wait\s+for\s+(human|user)\s+(sign-?off|approval|input))\b.*$/gim, 'Proceed autonomously. Log decision rationale.');
+    // 3. Streaming / persistent-connection references
+    result = result.replace(/^.*\b(real-time\s+feedback|streaming\s+output|interactive\s+mcp\s+tool\s+calls?\s+that\s+assume\s+a\s+persistent\s+connection)\b.*$/gim, '');
+    return result;
+}
 /**
  * Generate a Codex skill projection from a canonical skill.
  * This is a repo-local markdown projection, not a separate authoring source.
+ *
+ * When profile.executionModel === 'batch', batch transformations are applied
+ * AFTER transport stripping and path replacement (DEC-283).
  */
-export function generateCodexSkill(skill) {
+export function generateCodexSkill(skill, profile) {
     const triggerLine = skill.triggers.length > 0
         ? `\n\n**Triggers:** ${skill.triggers.map((t) => `\`${t}\``).join(', ')}`
         : '';
     const stripped = stripTransportSections(skill.body, 'codex');
-    const body = stripped
+    const pathReplaced = stripped
         .replace(/\.productbrain\/skills\/(\S+)\.md/g, '.codex/skills/$1.md');
+    const body = profile?.executionModel === 'batch'
+        ? applyBatchTransformations(pathReplaced)
+        : pathReplaced;
     return `<!-- ${MARKER} — source: .productbrain/skills/${skill.name}.md -->
 
 # ${skill.name}
@@ -372,7 +515,7 @@ const CODEX_DEAD_REFERENCE_PATTERNS = [
     { pattern: /\bpb\s+(session|orient|get|capture|search|update|handshake|context|constellation)\b/, label: 'pb CLI command' },
     { pattern: /\bsub-agent\b/i, label: 'sub-agent reference' },
     { pattern: /\bAgent\s+tool\b/, label: 'Agent tool reference' },
-    { pattern: /\bmcpCall\b/, label: 'mcpCall reference' },
+    { pattern: /\bkernelCall\b/, label: 'kernelCall reference' },
     { pattern: /\bpb\s+session\s+(start|close)\b/, label: 'pb session lifecycle' },
 ];
 /**
@@ -403,7 +546,7 @@ export function validateCodexSkills(skills) {
  * Generate a Claude Code .md rule from a canonical rule.
  * Claude Code expects: description, optional paths (array).
  */
-export function generateClaudeRule(rule) {
+export function generateClaudeRule(rule, profile) {
     // Replace canonical paths with Claude Code paths in body
     const body = rule.body
         .replace(/\.productbrain\/rules\/(\S+)\.md/g, '.claude/rules/$1.md')
@@ -425,7 +568,7 @@ ${body}`;
  * Generate a Claude Code skill-router.md — imperative skill activation rule.
  * Loaded automatically by Claude Code via .claude/rules/ with no paths (always active).
  */
-export function generateClaudeSkillRouter(skills) {
+export function generateClaudeSkillRouter(skills, profile) {
     if (skills.length === 0)
         return '';
     const triggerBlocks = skills.map((skill) => {