@productbrain/cli 0.1.0-beta.1 → 0.1.0-beta.14

package/dist/lib/client.js

@@ -1,20 +1,125 @@
 /**
  * MCP HTTP client — POST to Convex gateway with Bearer auth.
+ *
+ * TEN-729: Detects sandbox-blocked fetch (Claude Code, Cursor, etc.) and
+ * provides an actionable error instead of the opaque "fetch failed".
+ *
+ * Sandbox proxy support: Node.js fetch (undici) ignores proxy env vars by
+ * default. We detect HTTPS_PROXY and configure a ProxyAgent so pb works in
+ * sandboxed environments (Claude Code, Cursor) without requiring
+ * NODE_OPTIONS="--use-env-proxy".
  */
 import { getConfig } from './config.js';
+import { readSession } from './session.js';
+/** Error thrown by mcpCall/mcpCallWithSession when the server returns a non-OK response. */
+export class McpError extends Error {
+    details;
+    code;
+    constructor(message, code, details) {
+        super(message);
+        this.name = 'McpError';
+        this.code = code;
+        this.details = details;
+    }
+}
+// Configure proxy at module load — runs once, before any fetch call.
+// Node.js fetch (undici) ignores HTTPS_PROXY env vars. We detect the proxy
+// and install a ProxyAgent as the global dispatcher so all fetch() calls
+// route through the sandbox proxy automatically.
+try {
+    const _proxy = process.env.https_proxy || process.env.HTTPS_PROXY;
+    if (_proxy) {
+        const { ProxyAgent, setGlobalDispatcher } = await import('undici');
+        setGlobalDispatcher(new ProxyAgent(_proxy));
+    }
+}
+catch {
+    // undici unavailable or proxy config failed — rethrowWithGuidance handles it.
+}
+/** Detect a sandbox/network-blocked fetch and re-throw with guidance. */
+function rethrowWithGuidance(err, siteUrl) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg === 'fetch failed' || msg.includes('ECONNREFUSED') || msg.includes('ENOTFOUND')) {
+        const host = new URL(siteUrl).hostname;
+        const proxy = process.env.https_proxy || process.env.HTTPS_PROXY;
+        // When a proxy is set, the sandbox is routing traffic through it.
+        // Node.js fetch (undici) does NOT respect proxy env vars by default.
+        // The fix is --use-env-proxy (Node 22.14+), not adding the host to the allowlist.
+        const proxyHint = proxy
+            ? `A proxy is configured (${proxy}) but Node.js fetch() is not using it.\n` +
+                `Fix: set NODE_OPTIONS="--use-env-proxy" in your environment,\n` +
+                `  or re-run with: NODE_OPTIONS="--use-env-proxy" pb <command>\n`
+            : `If you are running inside an AI code editor sandbox (Claude Code, Cursor, etc.),\n` +
+                `the sandbox may be blocking outbound connections.\n\n` +
+                `Fix: add "${host}" to your sandbox network allowlist.\n` +
+                `  • Claude Code: run /sandbox → add network host\n` +
+                `  • Or re-run: pb handshake --init (configures sandbox automatically)\n`;
+        throw new Error(`Could not reach ${host}.\n\n${proxyHint}`);
+    }
+    throw err;
+}
 export async function mcpCall(fn, args = {}) {
     const { apiKey, siteUrl } = getConfig();
-    const res = await fetch(`${siteUrl}/api/mcp`, {
-        method: 'POST',
-        headers: {
-            'Content-Type': 'application/json',
-            Authorization: `Bearer ${apiKey}`,
-        },
-        body: JSON.stringify({ fn, args }),
-    });
+    let res;
+    try {
+        res = await fetch(`${siteUrl}/api/mcp`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify({ fn, args }),
+        });
+    }
+    catch (err) {
+        rethrowWithGuidance(err, siteUrl);
+    }
     const json = (await res.json());
     if (!res.ok || json.error) {
-        throw new Error(json.error ?? res.statusText);
+        throw new McpError(json.error ?? res.statusText, json.code, json.details);
+    }
+    return json.data;
+}
+/**
+ * mcpCall variant that injects X-Agent-Session-Id header for write operations.
+ * All write commands (update, relate, unrelate, capture) should use this.
+ *
+ * After a successful write, fires a non-blocking `agent.touchSession` call to
+ * renew the session TTL — mirroring MCP server behavior (DEC-299, BET-181 Slice 1).
+ * The touch is fire-and-forget: it does not block the write response, and errors
+ * are silently swallowed. No touch is attempted if no session is active or if
+ * the write itself fails.
+ */
+export async function mcpCallWithSession(fn, args = {}) {
+    const { apiKey, siteUrl } = getConfig();
+    const session = readSession();
+    const headers = {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${apiKey}`,
+    };
+    if (session?.sessionId) {
+        headers['X-Agent-Session-Id'] = session.sessionId;
+    }
+    let res;
+    try {
+        res = await fetch(`${siteUrl}/api/mcp`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({ fn, args }),
+        });
+    }
+    catch (err) {
+        rethrowWithGuidance(err, siteUrl);
+    }
+    const json = (await res.json());
+    if (!res.ok || json.error) {
+        throw new McpError(json.error ?? res.statusText, json.code, json.details);
+    }
+    // Fire-and-forget session touch — best-effort, never blocks the write response.
+    // Only touch when a session is active. Uses mcpCall (not mcpCallWithSession) to
+    // avoid recursion.
+    if (session?.sessionId) {
+        mcpCall('agent.touchSession', { sessionId: session.sessionId }).catch(() => { });
     }
     return json.data;
 }

package/dist/lib/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,EAAU,EACV,OAAgC,EAAE;IAElC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,CAAC;IAExC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,UAAU,EAAE;QAC5C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,MAAM,EAAE;SAClC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;KACnC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAiC,CAAC;IAChE,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,CAAC,IAAS,CAAC;AACxB,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"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"}

package/dist/lib/config.d.ts

@@ -1,9 +1,26 @@
 /**
- * CLI config — reads PRODUCTBRAIN_API_KEY + CONVEX_SITE_URL from env / .env.mcp.
- * Mirrors scripts/test-orient.mjs pattern.
+ * CLI config — reads PRODUCTBRAIN_API_KEY + CONVEX_SITE_URL from:
+ * 1. Environment variables
+ * 2. ~/.config/productbrain/.env (works from any directory)
+ * 3. CWD .env.mcp / packages/mcp-server/.env.mcp / .env
+ *
+ * When key is missing and retry is provided (TTY), runs guided flow per docs/cli-unauthenticated-user-journey.md.
  */
+declare const HOME_CONFIG_DIR: string;
+declare const HOME_ENV_PATH: string;
 export declare function getConfig(): {
     apiKey: string;
     siteUrl: string;
 };
+export type Config = {
+    apiKey: string;
+    siteUrl: string;
+};
+/**
+ * Get config; if key is missing and stdin is a TTY, run guided flow (y/n → paste key → save → retry).
+ * @param retry Called after saving key so the original command runs in-process.
+ * @returns Config, or null if we ran retry (caller should return without running again).
+ */
+export declare function getConfigOrGuide(retry: () => Promise<void>): Promise<Config | null>;
+export { HOME_CONFIG_DIR, HOME_ENV_PATH };
 //# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2BH,wBAAgB,SAAS,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAiB/D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,QAAA,MAAM,eAAe,QAAgD,CAAC;AACtE,QAAA,MAAM,aAAa,QAAmC,CAAC;AA2FvD,wBAAgB,SAAS,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAe/D;AAED,MAAM,MAAM,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAczF;AAED,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC"}

package/dist/lib/config.js

@@ -1,36 +1,117 @@
 /**
- * CLI config — reads PRODUCTBRAIN_API_KEY + CONVEX_SITE_URL from env / .env.mcp.
- * Mirrors scripts/test-orient.mjs pattern.
+ * CLI config — reads PRODUCTBRAIN_API_KEY + CONVEX_SITE_URL from:
+ * 1. Environment variables
+ * 2. ~/.config/productbrain/.env (works from any directory)
+ * 3. CWD .env.mcp / packages/mcp-server/.env.mcp / .env
+ *
+ * When key is missing and retry is provided (TTY), runs guided flow per docs/cli-unauthenticated-user-journey.md.
  */
-import { readFileSync, existsSync } from 'fs';
+import { readFileSync, existsSync, mkdirSync, writeFileSync } from 'fs';
 import { resolve } from 'path';
-const ENV_PATHS = ['.env.mcp', 'packages/mcp-server/.env.mcp', '.env'];
+import { homedir } from 'os';
+import { createInterface } from 'readline';
+const DEFAULT_SITE_URL = 'https://trustworthy-kangaroo-277.convex.site';
+const HOME_CONFIG_DIR = resolve(homedir(), '.config', 'productbrain');
+const HOME_ENV_PATH = resolve(HOME_CONFIG_DIR, '.env');
+const CWD_ENV_PATHS = ['.env.mcp', 'packages/mcp-server/.env.mcp', '.env'];
+// Short error when not TTY (scripts/pipes must not hang)
+const NON_TTY_MESSAGE = 'No API key. Set PRODUCTBRAIN_API_KEY or run pb login.';
+function parseEnvContent(content) {
+    for (const line of content.split('\n')) {
+        const m = line.match(/^([^#=]+)=(.*)$/);
+        if (m && !process.env[m[1].trim()]) {
+            process.env[m[1].trim()] = m[2].trim().replace(/^["']|["']$/g, '');
+        }
+    }
+}
 function loadEnv() {
-    for (const p of ENV_PATHS) {
+    if (existsSync(HOME_ENV_PATH)) {
+        parseEnvContent(readFileSync(HOME_ENV_PATH, 'utf8'));
+    }
+    for (const p of CWD_ENV_PATHS) {
         const full = resolve(process.cwd(), p);
         if (existsSync(full)) {
-            const content = readFileSync(full, 'utf8');
-            for (const line of content.split('\n')) {
-                const m = line.match(/^([^#=]+)=(.*)$/);
-                if (m && !process.env[m[1].trim()]) {
-                    process.env[m[1].trim()] = m[2].trim().replace(/^["']|["']$/g, '');
-                }
-            }
+            parseEnvContent(readFileSync(full, 'utf8'));
             break;
         }
     }
 }
 loadEnv();
-const DEFAULT_SITE_URL = 'https://trustworthy-kangaroo-277.convex.site';
+function question(rl, prompt) {
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => resolve((answer ?? '').trim().toLowerCase()));
+    });
+}
+function questionRaw(rl, prompt) {
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => resolve((answer ?? '').trim()));
+    });
+}
+/**
+ * Guided flow when key is missing (TTY only). Per docs/cli-unauthenticated-user-journey.md.
+ * Returns true if we saved and ran retry; false if user said No (caller should exit).
+ */
+async function runGuidedFlow(retry) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    console.log('Do you have an API key from Product Brain? (y/n)');
+    console.log('  Get one: Product Brain app → Settings → API Keys');
+    const hasKey = await question(rl, '> ');
+    if (hasKey !== 'y' && hasKey !== 'yes') {
+        console.log('Get your key: Product Brain app → Settings → API Keys. Then run: pb login');
+        rl.close();
+        process.exit(0);
+    }
+    let apiKey = await questionRaw(rl, 'Paste your API key (pb_sk_...): ');
+    if (!apiKey || !apiKey.startsWith('pb_sk_')) {
+        console.log('Key must start with pb_sk_. Try again or run pb login.');
+        apiKey = await questionRaw(rl, 'Paste your API key (pb_sk_...): ');
+    }
+    rl.close();
+    if (!apiKey || !apiKey.startsWith('pb_sk_')) {
+        console.log('Get your key: Product Brain app → Settings → API Keys. Then run: pb login');
+        process.exit(0);
+    }
+    const content = [
+        `# Product Brain CLI — saved by guided setup`,
+        `PRODUCTBRAIN_API_KEY=${apiKey}`,
+        `CONVEX_SITE_URL=${DEFAULT_SITE_URL.replace(/\/$/, '')}`,
+        '',
+    ].join('\n');
+    mkdirSync(HOME_CONFIG_DIR, { recursive: true });
+    writeFileSync(HOME_ENV_PATH, content, { mode: 0o600 });
+    process.env.PRODUCTBRAIN_API_KEY = apiKey;
+    process.env.CONVEX_SITE_URL = DEFAULT_SITE_URL.replace(/\/$/, '');
+    console.log('Saved your key. Running your command…\n');
+    await retry();
+    return true;
+}
 export function getConfig() {
     const apiKey = process.env.PRODUCTBRAIN_API_KEY ?? '';
     const siteUrl = (process.env.CONVEX_SITE_URL ?? DEFAULT_SITE_URL).replace(/\/$/, '');
     if (!apiKey || !apiKey.startsWith('pb_sk_')) {
-        throw new Error('Missing PRODUCTBRAIN_API_KEY (pb_sk_*) — set it or add to .env.mcp');
+        throw new Error(NON_TTY_MESSAGE);
     }
     if (!siteUrl.startsWith('https://')) {
         throw new Error(`CONVEX_SITE_URL must use HTTPS (got "${siteUrl.slice(0, 30)}…"). API keys must not be sent over unencrypted connections.`);
     }
     return { apiKey, siteUrl };
 }
+/**
+ * Get config; if key is missing and stdin is a TTY, run guided flow (y/n → paste key → save → retry).
+ * @param retry Called after saving key so the original command runs in-process.
+ * @returns Config, or null if we ran retry (caller should return without running again).
+ */
+export async function getConfigOrGuide(retry) {
+    const apiKey = process.env.PRODUCTBRAIN_API_KEY ?? '';
+    const siteUrl = (process.env.CONVEX_SITE_URL ?? DEFAULT_SITE_URL).replace(/\/$/, '');
+    if (apiKey.startsWith('pb_sk_') && siteUrl.startsWith('https://')) {
+        return { apiKey, siteUrl };
+    }
+    if (!process.stdin.isTTY) {
+        throw new Error(NON_TTY_MESSAGE);
+    }
+    const didRetry = await runGuidedFlow(retry);
+    return didRetry ? null : null;
+}
+export { HOME_CONFIG_DIR, HOME_ENV_PATH };
 //# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,SAAS,GAAG,CAAC,UAAU,EAAE,8BAA8B,EAAE,MAAM,CAAC,CAAC;AAEvE,SAAS,OAAO;IACd,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QACvC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC3C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;gBACxC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;oBACnC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;gBACrE,CAAC;YACH,CAAC;YACD,MAAM;QACR,CAAC;IACH,CAAC;AACH,CAAC;AAED,OAAO,EAAE,CAAC;AAEV,MAAM,gBAAgB,GAAG,8CAA8C,CAAC;AAExE,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC;IACtD,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAErF,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,wCAAwC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,8DAA8D,CAC3H,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"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"}

package/dist/lib/repo-detect.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Local repo detection — reads filesystem signals to build a RepoContext.
+ * No API calls. Pure filesystem inspection.
+ */
+export interface RepoContext {
+    name: string | null;
+    description: string | null;
+    gitRemote: string | null;
+    repoSlug: string | null;
+    detectedStack: string[];
+    isMonorepo: boolean;
+}
+export declare function detectRepo(cwd?: string): RepoContext;
+//# sourceMappingURL=repo-detect.d.ts.map

package/dist/lib/repo-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-detect.d.ts","sourceRoot":"","sources":["../../src/lib/repo-detect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,UAAU,CAAC,GAAG,SAAgB,GAAG,WAAW,CAiD3D"}

package/dist/lib/repo-detect.js

@@ -0,0 +1,58 @@
+/**
+ * Local repo detection — reads filesystem signals to build a RepoContext.
+ * No API calls. Pure filesystem inspection.
+ */
+import { existsSync, readFileSync } from 'fs';
+import { resolve, basename } from 'path';
+import { execSync } from 'child_process';
+export function detectRepo(cwd = process.cwd()) {
+    const ctx = {
+        name: null,
+        description: null,
+        gitRemote: null,
+        repoSlug: null,
+        detectedStack: [],
+        isMonorepo: false,
+    };
+    // package.json
+    const pkgPath = resolve(cwd, 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+            ctx.name = pkg.name?.replace(/^@[^/]+\//, '') ?? null;
+            ctx.description = pkg.description ?? null;
+            if (pkg.workspaces)
+                ctx.isMonorepo = true;
+        }
+        catch { /* ignore parse errors */ }
+    }
+    // git remote
+    try {
+        const remote = execSync('git remote get-url origin', { cwd, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        ctx.gitRemote = remote;
+        // Extract owner/repo from SSH or HTTPS URL
+        const m = remote.match(/[:/]([^/]+\/[^/.]+?)(?:\.git)?$/);
+        if (m)
+            ctx.repoSlug = m[1];
+    }
+    catch { /* not a git repo or no remote */ }
+    // Stack detection
+    const checks = [
+        ['sveltekit', ['svelte.config.js', 'svelte.config.ts']],
+        ['convex', ['convex']],
+        ['typescript', ['tsconfig.json']],
+        ['nextjs', ['next.config.js', 'next.config.ts', 'next.config.mjs']],
+        ['vite', ['vite.config.ts', 'vite.config.js']],
+        ['react', ['src/App.tsx', 'src/App.jsx']],
+    ];
+    for (const [tech, paths] of checks) {
+        if (paths.some((p) => existsSync(resolve(cwd, p)))) {
+            ctx.detectedStack.push(tech);
+        }
+    }
+    // Fallback name from directory
+    if (!ctx.name)
+        ctx.name = basename(cwd);
+    return ctx;
+}
+//# sourceMappingURL=repo-detect.js.map

package/dist/lib/repo-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-detect.js","sourceRoot":"","sources":["../../src/lib/repo-detect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAWzC,MAAM,UAAU,UAAU,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAC5C,MAAM,GAAG,GAAgB;QACvB,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;QACd,aAAa,EAAE,EAAE;QACjB,UAAU,EAAE,KAAK;KAClB,CAAC;IAEF,eAAe;IACf,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;YACtD,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC;YACtD,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC;YAC1C,IAAI,GAAG,CAAC,UAAU;gBAAE,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC,CAAC,yBAAyB,CAAC,CAAC;IACvC,CAAC;IAED,aAAa;IACb,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,2BAA2B,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxH,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC;QACvB,2CAA2C;QAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAC1D,IAAI,CAAC;YAAE,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC,CAAC,iCAAiC,CAAC,CAAC;IAE7C,kBAAkB;IAClB,MAAM,MAAM,GAA8B;QACxC,CAAC,WAAW,EAAE,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;QACvD,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC;QACtB,CAAC,YAAY,EAAE,CAAC,eAAe,CAAC,CAAC;QACjC,CAAC,QAAQ,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;QACnE,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;QAC9C,CAAC,OAAO,EAAE,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;KAC1C,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAExC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/lib/runner.d.ts

@@ -0,0 +1,31 @@
+/**
+ * runCliCommand — shared command runner for the Product Brain CLI.
+ *
+ * Owns:
+ *   (a) TTY detection via process.stdout.isTTY
+ *   (b) JSON vs human output branching
+ *   (c) stripConvexInternals() application in JSON mode
+ *   (d) --json and --pretty explicit overrides that take precedence over auto-detection
+ *   (e) Error handling: JSON error object in JSON mode, formatted message in TTY mode
+ *
+ * Chain: DEC-299 (JSON-default), STD-65 (agent responses: structured, parseable, minimal)
+ */
+export declare function setOutputMode(mode: 'auto' | 'json' | 'pretty'): void;
+export declare function getOutputMode(): 'auto' | 'json' | 'pretty';
+/** Returns true if the current output mode resolves to JSON. */
+export declare function isJsonMode(): boolean;
+export interface RunCliCommandOptions<T> {
+    /** The async function that performs the MCP call and returns data. */
+    fn: () => Promise<T>;
+    /** Formats data for human-readable TTY output. */
+    formatPretty: (data: T) => string;
+}
+/**
+ * Execute a CLI command with unified output handling.
+ *
+ * - JSON mode: strip Convex internals, JSON.stringify to stdout
+ * - Pretty mode: call formatPretty callback, print result
+ * - Errors: JSON error object in JSON mode, plain message in pretty mode
+ */
+export declare function runCliCommand<T>(options: RunCliCommandOptions<T>): Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/lib/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/lib/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,CAEpE;AAED,wBAAgB,aAAa,IAAI,MAAM,GAAG,MAAM,GAAG,QAAQ,CAE1D;AAED,gEAAgE;AAChE,wBAAgB,UAAU,IAAI,OAAO,CAKpC;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,sEAAsE;IACtE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,kDAAkD;IAClD,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBtF"}

package/dist/lib/runner.js

@@ -0,0 +1,65 @@
+/**
+ * runCliCommand — shared command runner for the Product Brain CLI.
+ *
+ * Owns:
+ *   (a) TTY detection via process.stdout.isTTY
+ *   (b) JSON vs human output branching
+ *   (c) stripConvexInternals() application in JSON mode
+ *   (d) --json and --pretty explicit overrides that take precedence over auto-detection
+ *   (e) Error handling: JSON error object in JSON mode, formatted message in TTY mode
+ *
+ * Chain: DEC-299 (JSON-default), STD-65 (agent responses: structured, parseable, minimal)
+ */
+import { stripConvexInternals } from './strip.js';
+/**
+ * Global output mode — set by the CLI entry point when --json or --pretty flags are parsed.
+ * 'auto' = detect via TTY; 'json' = force JSON; 'pretty' = force human.
+ */
+let outputMode = 'auto';
+export function setOutputMode(mode) {
+    outputMode = mode;
+}
+export function getOutputMode() {
+    return outputMode;
+}
+/** Returns true if the current output mode resolves to JSON. */
+export function isJsonMode() {
+    if (outputMode === 'json')
+        return true;
+    if (outputMode === 'pretty')
+        return false;
+    // auto: non-TTY (piped) → JSON, TTY → human
+    return !process.stdout.isTTY;
+}
+/**
+ * Execute a CLI command with unified output handling.
+ *
+ * - JSON mode: strip Convex internals, JSON.stringify to stdout
+ * - Pretty mode: call formatPretty callback, print result
+ * - Errors: JSON error object in JSON mode, plain message in pretty mode
+ */
+export async function runCliCommand(options) {
+    const json = isJsonMode();
+    try {
+        const data = await options.fn();
+        if (json) {
+            const stripped = stripConvexInternals(data);
+            process.stdout.write(JSON.stringify(stripped) + '\n');
+        }
+        else {
+            const formatted = options.formatPretty(data);
+            process.stdout.write(formatted + '\n');
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (json) {
+            process.stderr.write(JSON.stringify({ error: message }) + '\n');
+        }
+        else {
+            process.stderr.write(message + '\n');
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/lib/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/lib/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD;;;GAGG;AACH,IAAI,UAAU,GAA+B,MAAM,CAAC;AAEpD,MAAM,UAAU,aAAa,CAAC,IAAgC;IAC5D,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,UAAU;IACxB,IAAI,UAAU,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,UAAU,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1C,4CAA4C;IAC5C,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;AAC/B,CAAC;AASD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAI,OAAgC;IACrE,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAE1B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,EAAE,EAAE,CAAC;QAEhC,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,QAAQ,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAEjE,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/lib/session.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Session state — persists active session ID between CLI invocations.
+ * Stored at .productbrain/session.json in the project root.
+ * Solves TEN-264 (option 1: explicit session token).
+ */
+export interface SessionState {
+    sessionId: string;
+    workspaceId: string;
+    workspaceName: string;
+    startedAt: string;
+    entriesCaptured: string[];
+}
+export declare function readSession(): SessionState | null;
+export declare function writeSession(state: SessionState): void;
+export declare function clearSession(): void;
+export declare function addCapturedEntry(entryId: string): void;
+//# sourceMappingURL=session.d.ts.map

package/dist/lib/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/lib/session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAUD,wBAAgB,WAAW,IAAI,YAAY,GAAG,IAAI,CAQjD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAItD;AAED,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKtD"}

package/dist/lib/session.js

@@ -0,0 +1,43 @@
+/**
+ * Session state — persists active session ID between CLI invocations.
+ * Stored at .productbrain/session.json in the project root.
+ * Solves TEN-264 (option 1: explicit session token).
+ */
+import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync } from 'fs';
+import { join } from 'path';
+function getSessionDir() {
+    return join(process.cwd(), '.productbrain');
+}
+function getSessionPath() {
+    return join(getSessionDir(), 'session.json');
+}
+export function readSession() {
+    const p = getSessionPath();
+    if (!existsSync(p))
+        return null;
+    try {
+        return JSON.parse(readFileSync(p, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function writeSession(state) {
+    const dir = getSessionDir();
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(getSessionPath(), JSON.stringify(state, null, 2));
+}
+export function clearSession() {
+    const p = getSessionPath();
+    if (existsSync(p))
+        unlinkSync(p);
+}
+export function addCapturedEntry(entryId) {
+    const session = readSession();
+    if (!session)
+        return;
+    session.entriesCaptured.push(entryId);
+    writeSession(session);
+}
+//# sourceMappingURL=session.js.map

package/dist/lib/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/lib/session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpF,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAU5B,SAAS,aAAa;IACpB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,cAAc;IACrB,OAAO,IAAI,CAAC,aAAa,EAAE,EAAE,cAAc,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,MAAM,CAAC,GAAG,cAAc,EAAE,CAAC;IAC3B,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAiB,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAmB;IAC9C,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,aAAa,CAAC,cAAc,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,CAAC,GAAG,cAAc,EAAE,CAAC;IAC3B,IAAI,UAAU,CAAC,CAAC,CAAC;QAAE,UAAU,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,YAAY,CAAC,OAAO,CAAC,CAAC;AACxB,CAAC"}

package/dist/lib/strip.d.ts

@@ -0,0 +1,11 @@
+/**
+ * stripConvexInternals — recursively removes Convex system fields from API responses.
+ *
+ * Strips `_id` and `_creationTime` (Convex internal fields, TEN-340).
+ * Preserves `entryId` (human-readable ID) and all other fields.
+ * Handles nested objects and arrays. Returns a new object (does not mutate).
+ *
+ * Chain: DEC-299 (JSON-default output), TEN-340 (Convex internal exposure)
+ */
+export declare function stripConvexInternals<T>(data: T): T;
+//# sourceMappingURL=strip.d.ts.map

package/dist/lib/strip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip.d.ts","sourceRoot":"","sources":["../../src/lib/strip.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAelD"}

package/dist/lib/strip.js

@@ -0,0 +1,26 @@
+/**
+ * stripConvexInternals — recursively removes Convex system fields from API responses.
+ *
+ * Strips `_id` and `_creationTime` (Convex internal fields, TEN-340).
+ * Preserves `entryId` (human-readable ID) and all other fields.
+ * Handles nested objects and arrays. Returns a new object (does not mutate).
+ *
+ * Chain: DEC-299 (JSON-default output), TEN-340 (Convex internal exposure)
+ */
+const STRIP_KEYS = new Set(['_id', '_creationTime']);
+export function stripConvexInternals(data) {
+    if (Array.isArray(data)) {
+        return data.map((item) => stripConvexInternals(item));
+    }
+    if (data !== null && typeof data === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(data)) {
+            if (STRIP_KEYS.has(key))
+                continue;
+            result[key] = stripConvexInternals(value);
+        }
+        return result;
+    }
+    return data;
+}
+//# sourceMappingURL=strip.js.map

package/dist/lib/strip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip.js","sourceRoot":"","sources":["../../src/lib/strip.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC;AAErD,MAAM,UAAU,oBAAoB,CAAI,IAAO;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAiB,CAAC;IACxE,CAAC;IAED,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,EAAE,CAAC;YAC3E,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAClC,MAAM,CAAC,GAAG,CAAC,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,MAAsB,CAAC;IAChC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}