@productbrain/cli 0.1.0-beta.85 → 0.1.0-beta.88

package/dist/lib/method-registry.js

@@ -0,0 +1,53 @@
+/**
+ * method-registry.ts — load pb method registry (WP-310 E4).
+ * Chain-first with bundled fallback. Used during handshake when manifest is present.
+ */
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { fileURLToPath } from 'url';
+// From dist/lib/method-registry.js → ../../templates/ (two levels up: lib → dist → package root)
+// The templates/ directory lives at the package root alongside dist/, not inside dist/.
+// This mirrors the pattern in commands/handshake.ts which also uses __dirname, '..', '..', 'templates'.
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const BUNDLED_REGISTRY_PATH = join(__dirname, '..', '..', 'templates', 'method-registry.json');
+const FRESHNESS_DAYS = 7;
+function loadBundled() {
+    const raw = readFileSync(BUNDLED_REGISTRY_PATH, 'utf8');
+    return JSON.parse(raw);
+}
+function isStaleFn(generatedAt) {
+    const generated = new Date(generatedAt).getTime();
+    const now = Date.now();
+    return now - generated > FRESHNESS_DAYS * 24 * 60 * 60 * 1000;
+}
+/**
+ * Load the pb method registry.
+ *
+ * @param methodSource - from manifest.method_source: 'chain' | 'bundled' | undefined
+ * @param chainFetch   - function that calls a Chain API endpoint (kernelCall signature)
+ *
+ * Resolution order:
+ *   - 'bundled' → skip Chain, load bundled JSON
+ *   - 'chain' or undefined → try Chain first; on error fall through to bundled
+ */
+export async function loadMethodRegistry(methodSource, chainFetch) {
+    // Explicitly bundled — skip Chain attempt
+    if (methodSource === 'bundled') {
+        const registry = loadBundled();
+        return { registry, source: 'bundled', stale: isStaleFn(registry.generatedAt) };
+    }
+    // method_source: 'chain' or undefined — try Chain first
+    try {
+        const data = await chainFetch('chain.getMethodRegistry', {});
+        if (data && typeof data === 'object' && 'methods' in data) {
+            return { registry: data, source: 'chain', stale: false };
+        }
+    }
+    catch {
+        // Chain unreachable or returned unexpected shape — fall through to bundled
+    }
+    // Bundled fallback
+    const registry = loadBundled();
+    return { registry, source: 'bundled', stale: isStaleFn(registry.generatedAt) };
+}
+//# sourceMappingURL=method-registry.js.map

package/dist/lib/method-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-registry.js","sourceRoot":"","sources":["../../src/lib/method-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAqBpC,iGAAiG;AACjG,wFAAwF;AACxF,wGAAwG;AACxG,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,qBAAqB,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,CAAC,CAAC;AAC/F,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB,SAAS,WAAW;IAClB,MAAM,GAAG,GAAG,YAAY,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;AAC3C,CAAC;AAED,SAAS,SAAS,CAAC,WAAmB;IACpC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO,GAAG,GAAG,SAAS,GAAG,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAChE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,YAA6C,EAC7C,UAA2E;IAE3E,0CAA0C;IAC1C,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;IACjF,CAAC;IAED,wDAAwD;IACxD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;QAC7D,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;YAC1D,OAAO,EAAE,QAAQ,EAAE,IAAsB,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC7E,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;IAC7E,CAAC;IAED,mBAAmB;IACnB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;AACjF,CAAC"}

package/dist/surfaces/registry.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Surface Capability Registry — WP-310 S0 (FEAT-959)
+ *
+ * Static typed record of per-surface capabilities consumed by E1–E4.
+ * INS-740: Cursor and Copilot had confirmed double-fire risk with Claude Code hooks.
+ * Their hookEvents arrays MUST be empty in v1. Only 'claude' gets hook events by default.
+ */
+export type SurfaceName = 'claude' | 'cursor' | 'copilot' | 'codex';
+export interface SurfaceCapability {
+    rulesFormat: 'markdown' | 'mdc';
+    skillsFormat: 'markdown' | 'none';
+    /** Hook events to project. Empty array = no default hook writes (INS-740 double-fire risk). */
+    hookEvents: string[];
+    /** Path to the surface's personal config file. */
+    hookFilePath: string;
+    personalConfigMechanism: 'settings_json' | 'none';
+    supportsAgentsMd: boolean;
+}
+export declare const SURFACE_REGISTRY: Record<SurfaceName, SurfaceCapability>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/surfaces/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/surfaces/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,UAAU,GAAG,KAAK,CAAC;IAChC,YAAY,EAAE,UAAU,GAAG,MAAM,CAAC;IAClC,+FAA+F;IAC/F,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB,EAAE,eAAe,GAAG,MAAM,CAAC;IAClD,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAiCnE,CAAC"}

package/dist/surfaces/registry.js

@@ -0,0 +1,42 @@
+/**
+ * Surface Capability Registry — WP-310 S0 (FEAT-959)
+ *
+ * Static typed record of per-surface capabilities consumed by E1–E4.
+ * INS-740: Cursor and Copilot had confirmed double-fire risk with Claude Code hooks.
+ * Their hookEvents arrays MUST be empty in v1. Only 'claude' gets hook events by default.
+ */
+export const SURFACE_REGISTRY = {
+    claude: {
+        rulesFormat: 'markdown',
+        skillsFormat: 'markdown',
+        hookEvents: ['SessionStart', 'Stop', 'PreCompact'],
+        hookFilePath: '.claude/settings.json',
+        personalConfigMechanism: 'settings_json',
+        supportsAgentsMd: false,
+    },
+    cursor: {
+        rulesFormat: 'mdc',
+        skillsFormat: 'markdown',
+        hookEvents: [], // empty per INS-740 — no default Cursor hook writes
+        hookFilePath: '.cursor/settings.json',
+        personalConfigMechanism: 'none',
+        supportsAgentsMd: false,
+    },
+    copilot: {
+        rulesFormat: 'markdown',
+        skillsFormat: 'none',
+        hookEvents: [], // empty per INS-740
+        hookFilePath: '.github/copilot-instructions.md',
+        personalConfigMechanism: 'none',
+        supportsAgentsMd: false,
+    },
+    codex: {
+        rulesFormat: 'markdown',
+        skillsFormat: 'markdown',
+        hookEvents: [],
+        hookFilePath: 'AGENTS.md',
+        personalConfigMechanism: 'none',
+        supportsAgentsMd: true,
+    },
+};
+//# sourceMappingURL=registry.js.map

package/dist/surfaces/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/surfaces/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,MAAM,CAAC,MAAM,gBAAgB,GAA2C;IACtE,MAAM,EAAE;QACN,WAAW,EAAE,UAAU;QACvB,YAAY,EAAE,UAAU;QACxB,UAAU,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,CAAC;QAClD,YAAY,EAAE,uBAAuB;QACrC,uBAAuB,EAAE,eAAe;QACxC,gBAAgB,EAAE,KAAK;KACxB;IACD,MAAM,EAAE;QACN,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,UAAU;QACxB,UAAU,EAAE,EAAE,EAAE,oDAAoD;QACpE,YAAY,EAAE,uBAAuB;QACrC,uBAAuB,EAAE,MAAM;QAC/B,gBAAgB,EAAE,KAAK;KACxB;IACD,OAAO,EAAE;QACP,WAAW,EAAE,UAAU;QACvB,YAAY,EAAE,MAAM;QACpB,UAAU,EAAE,EAAE,EAAE,oBAAoB;QACpC,YAAY,EAAE,iCAAiC;QAC/C,uBAAuB,EAAE,MAAM;QAC/B,gBAAgB,EAAE,KAAK;KACxB;IACD,KAAK,EAAE;QACL,WAAW,EAAE,UAAU;QACvB,YAAY,EAAE,UAAU;QACxB,UAAU,EAAE,EAAE;QACd,YAAY,EAAE,WAAW;QACzB,uBAAuB,EAAE,MAAM;QAC/B,gBAAgB,EAAE,IAAI;KACvB;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productbrain/cli",
-  "version": "0.1.0-beta.85",
+  "version": "0.1.0-beta.88",
   "description": "Product Brain — Chain knowledge and write-back CLI",
   "type": "module",
   "bin": {

package/templates/method-registry.json

@@ -0,0 +1,16 @@
+{
+  "version": "1.0",
+  "generatedAt": "2026-04-18T00:00:00.000Z",
+  "methods": [
+    { "name": "session start", "usage": "pb session start", "description": "Open a tracked write session before making changes to the Chain." },
+    { "name": "session close", "usage": "pb session close", "description": "Close the current session and prompt for captures." },
+    { "name": "capture", "usage": "pb capture \"TYPE: text\"", "description": "Capture a decision (DEC), tension (TEN), insight (INS), or experiment (EXP) as a draft entry." },
+    { "name": "orient", "usage": "pb orient --task \"<task>\"", "description": "Get task-relevant governance and context before implementation." },
+    { "name": "get", "usage": "pb get <ID>", "description": "Get a full Chain entry by ID (BET, DEC, STD, BR, TEN, etc.)." },
+    { "name": "search", "usage": "pb search <query>", "description": "Search entries across the Chain." },
+    { "name": "handshake", "usage": "pb handshake", "description": "Refresh generated context files from Chain governance." },
+    { "name": "handshake --init", "usage": "pb handshake --init", "description": "Set up Claude Code integration (hooks, permissions, trust level)." },
+    { "name": "update", "usage": "pb update <ID> -f \"field=value\"", "description": "Update a Chain entry field." },
+    { "name": "context", "usage": "pb context <ID>", "description": "Get constellation context for a Chain entry." }
+  ]
+}