@productbrain/cli 0.1.0-beta.30 → 0.1.0-beta.32

package/dist/lib/glossary.js

@@ -0,0 +1,53 @@
+/**
+ * glossary.ts — Key CLI terms and their definitions.
+ *
+ * Provides a static glossary of Product Brain CLI terminology,
+ * plus a formatter for TTY output.
+ *
+ * WP-302 Slice 4.
+ */
+import { bold, dim } from './style.js';
+export const GLOSSARY = [
+    {
+        term: 'workspace',
+        definition: 'Your product knowledge space. One workspace = one product.',
+    },
+    {
+        term: 'entry',
+        definition: 'A unit of product knowledge (bet, decision, tension, standard, etc.).',
+    },
+    {
+        term: 'collection',
+        definition: 'A group of related entries (work-packages, decisions, tensions, etc.).',
+    },
+    {
+        term: 'relation',
+        definition: 'A typed link between entries (part_of, depends_on, addresses, etc.).',
+    },
+    {
+        term: 'session',
+        definition: 'A tracked write session. Required before creating or updating entries.',
+    },
+    {
+        term: 'capture',
+        definition: 'Create a new entry on the Chain via pb capture.',
+    },
+    {
+        term: 'profile',
+        definition: 'A named workspace configuration with API key and endpoint.',
+    },
+];
+/**
+ * Format the glossary for TTY output.
+ * Returns a multi-line string with bold terms and dimmed definitions.
+ */
+export function formatGlossary() {
+    const lines = [];
+    const maxTermLen = Math.max(...GLOSSARY.map((g) => g.term.length));
+    for (const entry of GLOSSARY) {
+        const paddedTerm = entry.term.padEnd(maxTermLen);
+        lines.push(`  ${bold(paddedTerm)}  ${dim(entry.definition)}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=glossary.js.map

package/dist/lib/glossary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.js","sourceRoot":"","sources":["../../src/lib/glossary.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAOvC,MAAM,CAAC,MAAM,QAAQ,GAAoB;IACvC;QACE,IAAI,EAAE,WAAW;QACjB,UAAU,EAAE,4DAA4D;KACzE;IACD;QACE,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,uEAAuE;KACpF;IACD;QACE,IAAI,EAAE,YAAY;QAClB,UAAU,EAAE,wEAAwE;KACrF;IACD;QACE,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,sEAAsE;KACnF;IACD;QACE,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,wEAAwE;KACrF;IACD;QACE,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,iDAAiD;KAC9D;IACD;QACE,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,4DAA4D;KACzE;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAEnE,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/lib/profiles.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Profile storage and resolution — multi-workspace support for the Product Brain CLI.
+ * WP-302 Slice 2: Workspace Profiles + Config Refactor.
+ *
+ * Profile directory: ~/.config/productbrain/profiles/
+ * Active profile tracked in: ~/.config/productbrain/active-profile
+ * Resolution order: PB_PROFILE env > active-profile file > "default" > legacy .env
+ */
+declare const HOME_CONFIG_DIR: string;
+declare const PROFILES_DIR: string;
+declare const ACTIVE_PROFILE_PATH: string;
+declare const LEGACY_ENV_PATH: string;
+export interface ProfileConfig {
+    apiKey: string;
+    siteUrl?: string;
+}
+/** List all profile names (sorted). */
+export declare function listProfiles(): string[];
+/** Get the active profile name. */
+export declare function getActiveProfile(): string | null;
+/** Create a new profile. */
+export declare function createProfile(name: string, apiKey: string, siteUrl?: string): void;
+/** Switch the active profile. */
+export declare function useProfile(name: string): void;
+/** Delete a profile. Cannot delete the last profile or the active profile. */
+export declare function deleteProfile(name: string): void;
+/**
+ * Resolve config from the active profile.
+ * Resolution order: PB_PROFILE env > active-profile file > "default" > legacy .env
+ * Returns null if no profile or config is available.
+ */
+export declare function resolveProfileConfig(): ProfileConfig | null;
+export { PROFILES_DIR, ACTIVE_PROFILE_PATH, LEGACY_ENV_PATH, HOME_CONFIG_DIR };
+//# sourceMappingURL=profiles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/lib/profiles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,QAAA,MAAM,eAAe,QAAgD,CAAC;AACtE,QAAA,MAAM,YAAY,QAAuC,CAAC;AAC1D,QAAA,MAAM,mBAAmB,QAA6C,CAAC;AACvE,QAAA,MAAM,eAAe,QAAmC,CAAC;AAKzD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAoDD,uCAAuC;AACvC,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAOvC;AAED,mCAAmC;AACnC,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAWhD;AAED,4BAA4B;AAC5B,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAwBlF;AAED,iCAAiC;AACjC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAS7C;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAmBhD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,GAAG,IAAI,CAgC3D;AAGD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC"}

package/dist/lib/profiles.js

@@ -0,0 +1,173 @@
+/**
+ * Profile storage and resolution — multi-workspace support for the Product Brain CLI.
+ * WP-302 Slice 2: Workspace Profiles + Config Refactor.
+ *
+ * Profile directory: ~/.config/productbrain/profiles/
+ * Active profile tracked in: ~/.config/productbrain/active-profile
+ * Resolution order: PB_PROFILE env > active-profile file > "default" > legacy .env
+ */
+import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync, readdirSync } from 'fs';
+import { resolve } from 'path';
+import { homedir } from 'os';
+import { CLIError, ErrorCode } from './errors.js';
+const HOME_CONFIG_DIR = resolve(homedir(), '.config', 'productbrain');
+const PROFILES_DIR = resolve(HOME_CONFIG_DIR, 'profiles');
+const ACTIVE_PROFILE_PATH = resolve(HOME_CONFIG_DIR, 'active-profile');
+const LEGACY_ENV_PATH = resolve(HOME_CONFIG_DIR, '.env');
+/** Profile name validation: lowercase alphanumeric + hyphens, 1-32 chars. */
+const PROFILE_NAME_RE = /^[a-z0-9][a-z0-9-]{0,31}$/;
+function validateProfileName(name) {
+    if (!PROFILE_NAME_RE.test(name)) {
+        throw new CLIError(`Invalid profile name "${name}". Must be 1-32 chars, lowercase alphanumeric + hyphens, starting with alphanumeric.`, { code: ErrorCode.PROFILE_NAME_INVALID, category: 'profile' });
+    }
+}
+function profilePath(name) {
+    return resolve(PROFILES_DIR, `${name}.env`);
+}
+function parseEnvFile(content) {
+    const vars = {};
+    for (const line of content.split('\n')) {
+        const m = line.match(/^([^#=]+)=(.*)$/);
+        if (m) {
+            vars[m[1].trim()] = m[2].trim().replace(/^["']|["']$/g, '');
+        }
+    }
+    return vars;
+}
+function readProfileFile(path) {
+    if (!existsSync(path))
+        return null;
+    const vars = parseEnvFile(readFileSync(path, 'utf8'));
+    const apiKey = vars['PRODUCTBRAIN_API_KEY'] || '';
+    if (!apiKey)
+        return null;
+    return {
+        apiKey,
+        siteUrl: vars['CONVEX_SITE_URL'] || undefined,
+    };
+}
+/**
+ * Auto-migrate legacy ~/.config/productbrain/.env to profiles/default.env.
+ * Only runs if legacy file exists AND no profiles directory exists.
+ */
+function autoMigrate() {
+    if (existsSync(PROFILES_DIR))
+        return false;
+    if (!existsSync(LEGACY_ENV_PATH))
+        return false;
+    mkdirSync(PROFILES_DIR, { recursive: true });
+    const content = readFileSync(LEGACY_ENV_PATH, 'utf8');
+    writeFileSync(profilePath('default'), content, { mode: 0o600 });
+    writeFileSync(ACTIVE_PROFILE_PATH, 'default', { mode: 0o600 });
+    return true;
+}
+/** List all profile names (sorted). */
+export function listProfiles() {
+    autoMigrate();
+    if (!existsSync(PROFILES_DIR))
+        return [];
+    return readdirSync(PROFILES_DIR)
+        .filter((f) => f.endsWith('.env'))
+        .map((f) => f.replace(/\.env$/, ''))
+        .sort();
+}
+/** Get the active profile name. */
+export function getActiveProfile() {
+    // PB_PROFILE env var takes precedence
+    const envProfile = process.env.PB_PROFILE?.trim();
+    if (envProfile)
+        return envProfile;
+    if (existsSync(ACTIVE_PROFILE_PATH)) {
+        const name = readFileSync(ACTIVE_PROFILE_PATH, 'utf8').trim();
+        if (name)
+            return name;
+    }
+    return null;
+}
+/** Create a new profile. */
+export function createProfile(name, apiKey, siteUrl) {
+    validateProfileName(name);
+    if (existsSync(profilePath(name))) {
+        throw new CLIError(`Profile "${name}" already exists.`, { code: ErrorCode.PROFILE_ALREADY_EXISTS, category: 'profile' });
+    }
+    mkdirSync(PROFILES_DIR, { recursive: true });
+    const lines = [
+        `# Product Brain CLI profile: ${name}`,
+        `PRODUCTBRAIN_API_KEY=${apiKey}`,
+    ];
+    if (siteUrl) {
+        lines.push(`CONVEX_SITE_URL=${siteUrl}`);
+    }
+    lines.push('');
+    writeFileSync(profilePath(name), lines.join('\n'), { mode: 0o600 });
+    // If this is the first profile, make it active
+    if (!existsSync(ACTIVE_PROFILE_PATH)) {
+        writeFileSync(ACTIVE_PROFILE_PATH, name, { mode: 0o600 });
+    }
+}
+/** Switch the active profile. */
+export function useProfile(name) {
+    validateProfileName(name);
+    if (!existsSync(profilePath(name))) {
+        throw new CLIError(`Profile "${name}" does not exist.`, { code: ErrorCode.PROFILE_NOT_FOUND, category: 'profile' });
+    }
+    mkdirSync(HOME_CONFIG_DIR, { recursive: true });
+    writeFileSync(ACTIVE_PROFILE_PATH, name, { mode: 0o600 });
+}
+/** Delete a profile. Cannot delete the last profile or the active profile. */
+export function deleteProfile(name) {
+    validateProfileName(name);
+    const path = profilePath(name);
+    if (!existsSync(path)) {
+        throw new CLIError(`Profile "${name}" does not exist.`, { code: ErrorCode.PROFILE_NOT_FOUND, category: 'profile' });
+    }
+    const profiles = listProfiles();
+    if (profiles.length <= 1) {
+        throw new CLIError(`Cannot delete the last profile "${name}".`, { code: ErrorCode.PROFILE_IS_LAST, category: 'profile' });
+    }
+    const active = getActiveProfile();
+    if (active === name) {
+        throw new CLIError(`Cannot delete the active profile "${name}". Switch to another profile first.`, { code: ErrorCode.PROFILE_IS_ACTIVE, category: 'profile', guidance: 'Run `pb profile use <other-profile>` first.' });
+    }
+    unlinkSync(path);
+}
+/**
+ * Resolve config from the active profile.
+ * Resolution order: PB_PROFILE env > active-profile file > "default" > legacy .env
+ * Returns null if no profile or config is available.
+ */
+export function resolveProfileConfig() {
+    autoMigrate();
+    // 1. Check PB_PROFILE env var
+    const envProfile = process.env.PB_PROFILE?.trim();
+    if (envProfile) {
+        const config = readProfileFile(profilePath(envProfile));
+        if (config)
+            return config;
+    }
+    // 2. Check active-profile file
+    if (existsSync(ACTIVE_PROFILE_PATH)) {
+        const name = readFileSync(ACTIVE_PROFILE_PATH, 'utf8').trim();
+        if (name) {
+            const config = readProfileFile(profilePath(name));
+            if (config)
+                return config;
+        }
+    }
+    // 3. Check "default" profile
+    {
+        const config = readProfileFile(profilePath('default'));
+        if (config)
+            return config;
+    }
+    // 4. Fall back to legacy .env
+    {
+        const config = readProfileFile(LEGACY_ENV_PATH);
+        if (config)
+            return config;
+    }
+    return null;
+}
+// Exported for testing
+export { PROFILES_DIR, ACTIVE_PROFILE_PATH, LEGACY_ENV_PATH, HOME_CONFIG_DIR };
+//# sourceMappingURL=profiles.js.map

package/dist/lib/profiles.js.map

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

package/dist/lib/runner.d.ts

@@ -14,6 +14,8 @@ 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 declare function setQuietMode(quiet: boolean): void;
+export declare function isQuietMode(): boolean;
 export interface RunCliCommandOptions<T> {
     /** The async function that performs the MCP call and returns data. */
     fn: () => Promise<T>;

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

@@ -1 +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"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/lib/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,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;AASD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEjD;AAED,wBAAgB,WAAW,IAAI,OAAO,CAIrC;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,CAkCtF"}

package/dist/lib/runner.js

@@ -11,6 +11,7 @@
  * Chain: DEC-299 (JSON-default), STD-65 (agent responses: structured, parseable, minimal)
  */
 import { stripConvexInternals } from './strip.js';
+import { CLIError } from './errors.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.
@@ -31,6 +32,21 @@ export function isJsonMode() {
     // auto: non-TTY (piped) → JSON, TTY → human
     return !process.stdout.isTTY;
 }
+/**
+ * Quiet mode — suppresses non-essential output (banners, hints, progress).
+ * Only the essential result (data line or error) is shown.
+ * WP-302 Slice 1.
+ */
+let quietMode = false;
+export function setQuietMode(quiet) {
+    quietMode = quiet;
+}
+export function isQuietMode() {
+    // JSON mode is inherently quiet — no decorative output needed
+    if (isJsonMode())
+        return true;
+    return quietMode;
+}
 /**
  * Execute a CLI command with unified output handling.
  *
@@ -52,12 +68,25 @@ export async function runCliCommand(options) {
         }
     }
     catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        if (json) {
-            process.stderr.write(JSON.stringify({ error: message }) + '\n');
+        if (err instanceof CLIError) {
+            if (json) {
+                process.stderr.write(JSON.stringify(err.toJSON()) + '\n');
+            }
+            else {
+                process.stderr.write(err.message + '\n');
+                if (err.guidance) {
+                    process.stderr.write(err.guidance + '\n');
+                }
+            }
         }
         else {
-            process.stderr.write(message + '\n');
+            const message = err instanceof Error ? err.message : String(err);
+            if (json) {
+                process.stderr.write(JSON.stringify({ error: message, code: 'INTERNAL', category: 'internal' }) + '\n');
+            }
+            else {
+                process.stderr.write(message + '\n');
+            }
         }
         process.exit(1);
     }

package/dist/lib/runner.js.map

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

package/dist/lib/style.d.ts

@@ -0,0 +1,65 @@
+/**
+ * CLI voice and style — centralized output formatting for Product Brain CLI.
+ * WP-302 Slice 1: Brand Voice + --quiet.
+ *
+ * Design: "instrument panel" — clear status, clear next action.
+ * Tone: confident, concise, helpful. Not chatty. Not corporate.
+ *
+ * All color output respects NO_COLOR env (https://no-color.org/) and TTY detection.
+ * Quiet mode suppresses banners, hints, and progress — only essential results show.
+ */
+/** Returns true if the terminal supports color output. */
+export declare function supportsColor(): boolean;
+export declare const green: (s: string) => string;
+export declare const red: (s: string) => string;
+export declare const yellow: (s: string) => string;
+export declare const cyan: (s: string) => string;
+export declare const dim: (s: string) => string;
+export declare const bold: (s: string) => string;
+export declare const icons: {
+    readonly pass: "✓";
+    readonly fail: "✗";
+    readonly warn: "⚠";
+    readonly arrow: "→";
+    readonly dot: "·";
+};
+export declare const copy: {
+    readonly captured: "Captured.";
+    readonly promoted: "Promoted.";
+    readonly linked: "Linked.";
+    readonly updated: "Updated.";
+    readonly sessionStarted: "Session started.";
+    readonly sessionClosed: "Session closed.";
+    readonly noSession: "No active session. Run `pb session start` first.";
+    readonly sessionRequired: "Write access requires a tracked session (DEC-9).";
+    readonly notFound: "Not found.";
+    readonly authFailed: "Authentication failed.";
+    readonly nextOrient: "Next: pb orient -b";
+    readonly nextCapture: "Next: pb capture \"...\"";
+    readonly nextGet: (entryId: string) => string;
+    readonly nextFields: (collection: string) => string;
+};
+/**
+ * Print a command banner. Suppressed in quiet mode.
+ * Example: "Product Brain — Doctor"
+ */
+export declare function banner(title: string): void;
+/**
+ * Print an actionable hint line. Suppressed in quiet mode.
+ * Example: "  Hint: Run `pb orient -b` to see your workspace."
+ */
+export declare function hint(text: string): void;
+/**
+ * Print a progress line (e.g. "Classifying..."). Suppressed in quiet mode.
+ */
+export declare function progress(text: string): void;
+/**
+ * Format a section heading — bold cyan text.
+ */
+export declare function heading(text: string): string;
+/**
+ * Format a check result line for doctor-style output.
+ * Uses colored icons for pass/fail/warn.
+ */
+export declare function formatCheck(status: 'pass' | 'fail' | 'warn', label: string, detail: string): string;
+//# sourceMappingURL=style.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../src/lib/style.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,0DAA0D;AAC1D,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAMD,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,KAAG,MAAuD,CAAC;AAC1F,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,KAAG,MAAuD,CAAC;AACxF,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,KAAG,MAAuD,CAAC;AAC3F,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,KAAG,MAAuD,CAAC;AACzF,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,KAAG,MAAsD,CAAC;AACvF,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,KAAG,MAAsD,CAAC;AAMxF,eAAO,MAAM,KAAK;;;;;;CAMR,CAAC;AAMX,eAAO,MAAM,IAAI;;;;;;;;;;;;;gCAkBI,MAAM;sCACA,MAAM;CACvB,CAAC;AAMX;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG1C;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGvC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG3C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CASnG"}

package/dist/lib/style.js

@@ -0,0 +1,108 @@
+/**
+ * CLI voice and style — centralized output formatting for Product Brain CLI.
+ * WP-302 Slice 1: Brand Voice + --quiet.
+ *
+ * Design: "instrument panel" — clear status, clear next action.
+ * Tone: confident, concise, helpful. Not chatty. Not corporate.
+ *
+ * All color output respects NO_COLOR env (https://no-color.org/) and TTY detection.
+ * Quiet mode suppresses banners, hints, and progress — only essential results show.
+ */
+import { isQuietMode } from './runner.js';
+// ---------------------------------------------------------------------------
+// Color support detection
+// ---------------------------------------------------------------------------
+/** Returns true if the terminal supports color output. */
+export function supportsColor() {
+    return Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
+}
+// ---------------------------------------------------------------------------
+// Color helpers — degrade gracefully when NO_COLOR is set or not a TTY
+// ---------------------------------------------------------------------------
+export const green = (s) => (supportsColor() ? `\x1b[32m${s}\x1b[0m` : s);
+export const red = (s) => (supportsColor() ? `\x1b[31m${s}\x1b[0m` : s);
+export const yellow = (s) => (supportsColor() ? `\x1b[33m${s}\x1b[0m` : s);
+export const cyan = (s) => (supportsColor() ? `\x1b[36m${s}\x1b[0m` : s);
+export const dim = (s) => (supportsColor() ? `\x1b[2m${s}\x1b[0m` : s);
+export const bold = (s) => (supportsColor() ? `\x1b[1m${s}\x1b[0m` : s);
+// ---------------------------------------------------------------------------
+// Status icons
+// ---------------------------------------------------------------------------
+export const icons = {
+    pass: '\u2713', // checkmark
+    fail: '\u2717', // x
+    warn: '\u26A0', // warning triangle
+    arrow: '\u2192', // right arrow
+    dot: '\u00B7', // middle dot
+};
+// ---------------------------------------------------------------------------
+// Copy constants — instrument panel voice
+// ---------------------------------------------------------------------------
+export const copy = {
+    // Success preambles
+    captured: 'Captured.',
+    promoted: 'Promoted.',
+    linked: 'Linked.',
+    updated: 'Updated.',
+    sessionStarted: 'Session started.',
+    sessionClosed: 'Session closed.',
+    // Error preambles
+    noSession: 'No active session. Run `pb session start` first.',
+    sessionRequired: 'Write access requires a tracked session (DEC-9).',
+    notFound: 'Not found.',
+    authFailed: 'Authentication failed.',
+    // Next-step prompts
+    nextOrient: 'Next: pb orient -b',
+    nextCapture: 'Next: pb capture "..."',
+    nextGet: (entryId) => `View: pb get ${entryId}`,
+    nextFields: (collection) => `Fields: pb fields ${collection}`,
+};
+// ---------------------------------------------------------------------------
+// Structured output helpers
+// ---------------------------------------------------------------------------
+/**
+ * Print a command banner. Suppressed in quiet mode.
+ * Example: "Product Brain — Doctor"
+ */
+export function banner(title) {
+    if (isQuietMode())
+        return;
+    process.stdout.write(`\n${bold(`Product Brain — ${title}`)}\n\n`);
+}
+/**
+ * Print an actionable hint line. Suppressed in quiet mode.
+ * Example: "  Hint: Run `pb orient -b` to see your workspace."
+ */
+export function hint(text) {
+    if (isQuietMode())
+        return;
+    process.stdout.write(`  ${dim(text)}\n`);
+}
+/**
+ * Print a progress line (e.g. "Classifying..."). Suppressed in quiet mode.
+ */
+export function progress(text) {
+    if (isQuietMode())
+        return;
+    process.stdout.write(`${text}\n`);
+}
+/**
+ * Format a section heading — bold cyan text.
+ */
+export function heading(text) {
+    return bold(cyan(text));
+}
+/**
+ * Format a check result line for doctor-style output.
+ * Uses colored icons for pass/fail/warn.
+ */
+export function formatCheck(status, label, detail) {
+    const icon = status === 'pass'
+        ? green(icons.pass)
+        : status === 'fail'
+            ? red(icons.fail)
+            : yellow(icons.warn);
+    const paddedLabel = label.padEnd(16);
+    return `${icon} ${paddedLabel}${detail}`;
+}
+//# sourceMappingURL=style.js.map

package/dist/lib/style.js.map

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

package/dist/lib/style.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for CLI style module — WP-302 Slice 1.
+ * Verifies color helpers respect NO_COLOR, quiet mode suppresses banners,
+ * and copy constants are non-empty strings.
+ */
+export {};
+//# sourceMappingURL=style.test.d.ts.map

package/dist/lib/style.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.test.d.ts","sourceRoot":"","sources":["../../src/lib/style.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}