@a5c-ai/babysitter-sdk 0.0.186 → 0.0.187-staging.02141cfa

package/dist/breakpoints/evaluator.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Auto-approval evaluator.
+ *
+ * Precedence (highest wins):
+ *   1. never-auto-approve rule match
+ *   2. alwaysBreakOn profile tags
+ *   3. auto-approve rule match
+ *   4. autoApproveAfterN threshold (consecutive approvals from journal history)
+ *   5. prompt (default — no auto-approval)
+ */
+import type { BreakpointRule, AutoApprovalResult } from "./types";
+import type { BreakpointConfig } from "../profiles/types";
+export interface EvaluateAutoApprovalOptions {
+    breakpointId: string;
+    tags?: string[];
+    expert?: string;
+    rules: BreakpointRule[];
+    profileConfig?: BreakpointConfig;
+    /** Number of consecutive past approvals for this breakpointId. */
+    consecutiveApprovals?: number;
+    /** autoApproveAfterN from breakpoint definition (-1 = disabled). */
+    autoApproveAfterN?: number;
+}
+export declare function evaluateAutoApproval(options: EvaluateAutoApprovalOptions): AutoApprovalResult;
+//# sourceMappingURL=evaluator.d.ts.map

package/dist/breakpoints/evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../src/breakpoints/evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACjC,kEAAkE;IAClE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,kBAAkB,CAqE7F"}

package/dist/breakpoints/evaluator.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Auto-approval evaluator.
+ *
+ * Precedence (highest wins):
+ *   1. never-auto-approve rule match
+ *   2. alwaysBreakOn profile tags
+ *   3. auto-approve rule match
+ *   4. autoApproveAfterN threshold (consecutive approvals from journal history)
+ *   5. prompt (default — no auto-approval)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateAutoApproval = evaluateAutoApproval;
+const patterns_1 = require("./patterns");
+function evaluateAutoApproval(options) {
+    const { breakpointId, tags, expert, rules, profileConfig, consecutiveApprovals = 0, autoApproveAfterN = -1, } = options;
+    const attributes = { tags, expert };
+    // 1. Check never-auto-approve rules (highest precedence)
+    for (const rule of rules) {
+        if (rule.action !== "never-auto-approve")
+            continue;
+        const pattern = (0, patterns_1.parsePattern)(rule.pattern);
+        if ((0, patterns_1.matchPattern)(pattern, breakpointId, attributes)) {
+            return {
+                recommended: false,
+                reason: `Blocked by never-auto-approve rule: ${rule.id}`,
+                matchedRule: rule.id,
+                consecutiveApprovals,
+            };
+        }
+    }
+    // 2. Check alwaysBreakOn profile tags
+    if (profileConfig?.alwaysBreakOn && tags) {
+        for (const alwaysTag of profileConfig.alwaysBreakOn) {
+            if (tags.includes(alwaysTag)) {
+                return {
+                    recommended: false,
+                    reason: `Blocked by alwaysBreakOn tag: ${alwaysTag}`,
+                    consecutiveApprovals,
+                };
+            }
+        }
+    }
+    // 3. Check auto-approve rules
+    for (const rule of rules) {
+        if (rule.action !== "auto-approve")
+            continue;
+        const pattern = (0, patterns_1.parsePattern)(rule.pattern);
+        if ((0, patterns_1.matchPattern)(pattern, breakpointId, attributes)) {
+            return {
+                recommended: true,
+                reason: `Matched auto-approve rule: ${rule.id}`,
+                matchedRule: rule.id,
+                consecutiveApprovals,
+            };
+        }
+    }
+    // 4. Check autoApproveAfterN threshold
+    if (autoApproveAfterN > 0 && consecutiveApprovals >= autoApproveAfterN) {
+        return {
+            recommended: true,
+            reason: `Auto-approved after ${consecutiveApprovals} consecutive approvals (threshold: ${autoApproveAfterN})`,
+            consecutiveApprovals,
+        };
+    }
+    // 5. Default: prompt (no auto-approval)
+    return {
+        recommended: false,
+        reason: "No matching auto-approval rule",
+        consecutiveApprovals,
+    };
+}

package/dist/breakpoints/index.d.ts

@@ -0,0 +1,7 @@
+export type { BreakpointRule, BreakpointRuleAction, BreakpointRulesFile, AutoApprovalResult, BreakpointPattern, AttributePredicate, PredicateOp, } from "./types";
+export { BREAKPOINT_RULES_SCHEMA_VERSION } from "./types";
+export { parsePattern, matchPattern } from "./patterns";
+export { readRules, writeRules, addRule, removeRule, listRules } from "./rules";
+export { evaluateAutoApproval } from "./evaluator";
+export type { EvaluateAutoApprovalOptions } from "./evaluator";
+//# sourceMappingURL=index.d.ts.map

package/dist/breakpoints/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/breakpoints/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,+BAA+B,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC"}

package/dist/breakpoints/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateAutoApproval = exports.listRules = exports.removeRule = exports.addRule = exports.writeRules = exports.readRules = exports.matchPattern = exports.parsePattern = exports.BREAKPOINT_RULES_SCHEMA_VERSION = void 0;
+var types_1 = require("./types");
+Object.defineProperty(exports, "BREAKPOINT_RULES_SCHEMA_VERSION", { enumerable: true, get: function () { return types_1.BREAKPOINT_RULES_SCHEMA_VERSION; } });
+var patterns_1 = require("./patterns");
+Object.defineProperty(exports, "parsePattern", { enumerable: true, get: function () { return patterns_1.parsePattern; } });
+Object.defineProperty(exports, "matchPattern", { enumerable: true, get: function () { return patterns_1.matchPattern; } });
+var rules_1 = require("./rules");
+Object.defineProperty(exports, "readRules", { enumerable: true, get: function () { return rules_1.readRules; } });
+Object.defineProperty(exports, "writeRules", { enumerable: true, get: function () { return rules_1.writeRules; } });
+Object.defineProperty(exports, "addRule", { enumerable: true, get: function () { return rules_1.addRule; } });
+Object.defineProperty(exports, "removeRule", { enumerable: true, get: function () { return rules_1.removeRule; } });
+Object.defineProperty(exports, "listRules", { enumerable: true, get: function () { return rules_1.listRules; } });
+var evaluator_1 = require("./evaluator");
+Object.defineProperty(exports, "evaluateAutoApproval", { enumerable: true, get: function () { return evaluator_1.evaluateAutoApproval; } });

package/dist/breakpoints/patterns.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pattern parsing and matching for breakpoint auto-approval rules.
+ *
+ * Pattern syntax:
+ *   <id-glob>                          — e.g., "confirm.*"
+ *   <id-glob>(<predicate> [AND ...])   — e.g., "*.review(tags contains 'design')"
+ *
+ * Id-glob supports * as a wildcard matching any segment(s).
+ * Attribute predicates: "tags contains '<value>'" or "expert = '<value>'"
+ * Multiple predicates joined with AND.
+ */
+import type { BreakpointPattern } from "./types";
+/**
+ * Parse a pattern string into a structured BreakpointPattern.
+ */
+export declare function parsePattern(raw: string): BreakpointPattern;
+/**
+ * Match a breakpointId and attributes against a parsed pattern.
+ */
+export declare function matchPattern(pattern: BreakpointPattern, breakpointId: string, attributes: {
+    tags?: string[];
+    expert?: string;
+}): boolean;
+//# sourceMappingURL=patterns.d.ts.map

package/dist/breakpoints/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../src/breakpoints/patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAsB,iBAAiB,EAAe,MAAM,SAAS,CAAC;AAElF;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAsB3D;AAwBD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,iBAAiB,EAC1B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAYT"}

package/dist/breakpoints/patterns.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Pattern parsing and matching for breakpoint auto-approval rules.
+ *
+ * Pattern syntax:
+ *   <id-glob>                          — e.g., "confirm.*"
+ *   <id-glob>(<predicate> [AND ...])   — e.g., "*.review(tags contains 'design')"
+ *
+ * Id-glob supports * as a wildcard matching any segment(s).
+ * Attribute predicates: "tags contains '<value>'" or "expert = '<value>'"
+ * Multiple predicates joined with AND.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePattern = parsePattern;
+exports.matchPattern = matchPattern;
+/**
+ * Parse a pattern string into a structured BreakpointPattern.
+ */
+function parsePattern(raw) {
+    const trimmed = raw.trim();
+    const parenOpen = trimmed.indexOf("(");
+    if (parenOpen === -1) {
+        return { idGlob: trimmed, predicates: [] };
+    }
+    const parenClose = trimmed.lastIndexOf(")");
+    if (parenClose === -1 || parenClose <= parenOpen) {
+        throw new Error(`Invalid pattern: unmatched parenthesis in "${raw}"`);
+    }
+    const idGlob = trimmed.slice(0, parenOpen).trim();
+    const predicateStr = trimmed.slice(parenOpen + 1, parenClose).trim();
+    if (!predicateStr) {
+        return { idGlob, predicates: [] };
+    }
+    const predicates = parsePredicates(predicateStr);
+    return { idGlob, predicates };
+}
+function parsePredicates(str) {
+    // Split on " AND " (case-insensitive)
+    const parts = str.split(/\s+AND\s+/i);
+    return parts.map(parseSinglePredicate);
+}
+function parseSinglePredicate(str) {
+    const trimmed = str.trim();
+    // Match: attr contains 'value' or attr = 'value'
+    const match = trimmed.match(/^(\w+)\s+(contains|=)\s+'([^']*)'$/);
+    if (!match) {
+        throw new Error(`Invalid predicate: "${trimmed}". Expected: attr contains 'value' or attr = 'value'`);
+    }
+    return {
+        attr: match[1],
+        op: match[2],
+        value: match[3],
+    };
+}
+/**
+ * Match a breakpointId and attributes against a parsed pattern.
+ */
+function matchPattern(pattern, breakpointId, attributes) {
+    if (!matchGlob(pattern.idGlob, breakpointId)) {
+        return false;
+    }
+    for (const pred of pattern.predicates) {
+        if (!matchPredicate(pred, attributes)) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Simple glob matching with * wildcards.
+ * Each * matches zero or more characters (including dots).
+ */
+function matchGlob(glob, value) {
+    // Escape regex special chars except *, then replace * with .*
+    const escaped = glob.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+    const regexStr = "^" + escaped.replace(/\*/g, ".*") + "$";
+    return new RegExp(regexStr).test(value);
+}
+function matchPredicate(pred, attributes) {
+    if (pred.attr === "tags" && pred.op === "contains") {
+        return Array.isArray(attributes.tags) && attributes.tags.includes(pred.value);
+    }
+    if (pred.attr === "expert" && pred.op === "=") {
+        return attributes.expert === pred.value;
+    }
+    // Unknown attribute — no match
+    return false;
+}

package/dist/breakpoints/rules.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Rules CRUD for breakpoint auto-approval.
+ * Rules stored at ~/.a5c/breakpoint-approvals/rules.json with atomic writes.
+ */
+import type { BreakpointRule } from "./types";
+/**
+ * Read rules from the rules file. Returns empty array if file doesn't exist.
+ */
+export declare function readRules(rulesPath?: string): Promise<BreakpointRule[]>;
+/**
+ * Write rules to the rules file atomically.
+ */
+export declare function writeRules(rules: BreakpointRule[], rulesPath?: string): Promise<void>;
+/**
+ * Add a rule. Deduplicates by rule id.
+ */
+export declare function addRule(rule: BreakpointRule, rulesPath?: string): Promise<BreakpointRule[]>;
+/**
+ * Remove a rule by id. Returns the updated list.
+ */
+export declare function removeRule(ruleId: string, rulesPath?: string): Promise<BreakpointRule[]>;
+/**
+ * List all rules.
+ */
+export declare function listRules(rulesPath?: string): Promise<BreakpointRule[]>;
+//# sourceMappingURL=rules.d.ts.map

package/dist/breakpoints/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/breakpoints/rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,SAAS,CAAC;AAOnE;;GAEG;AACH,wBAAsB,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAe7E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS3F;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAMjG;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAK9F;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAE7E"}

package/dist/breakpoints/rules.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Rules CRUD for breakpoint auto-approval.
+ * Rules stored at ~/.a5c/breakpoint-approvals/rules.json with atomic writes.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readRules = readRules;
+exports.writeRules = writeRules;
+exports.addRule = addRule;
+exports.removeRule = removeRule;
+exports.listRules = listRules;
+const node_fs_1 = require("node:fs");
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const atomic_1 = require("../storage/atomic");
+const types_1 = require("./types");
+function defaultRulesPath() {
+    return path.join(os.homedir(), ".a5c", "breakpoint-approvals", "rules.json");
+}
+/**
+ * Read rules from the rules file. Returns empty array if file doesn't exist.
+ */
+async function readRules(rulesPath) {
+    const filePath = rulesPath ?? defaultRulesPath();
+    try {
+        const raw = await node_fs_1.promises.readFile(filePath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed.rules)) {
+            return [];
+        }
+        return parsed.rules;
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return [];
+        }
+        throw err;
+    }
+}
+/**
+ * Write rules to the rules file atomically.
+ */
+async function writeRules(rules, rulesPath) {
+    const filePath = rulesPath ?? defaultRulesPath();
+    const dir = path.dirname(filePath);
+    await node_fs_1.promises.mkdir(dir, { recursive: true });
+    const data = {
+        schemaVersion: types_1.BREAKPOINT_RULES_SCHEMA_VERSION,
+        rules,
+    };
+    await (0, atomic_1.writeFileAtomic)(filePath, JSON.stringify(data, null, 2) + "\n");
+}
+/**
+ * Add a rule. Deduplicates by rule id.
+ */
+async function addRule(rule, rulesPath) {
+    const existing = await readRules(rulesPath);
+    const filtered = existing.filter(r => r.id !== rule.id);
+    filtered.push(rule);
+    await writeRules(filtered, rulesPath);
+    return filtered;
+}
+/**
+ * Remove a rule by id. Returns the updated list.
+ */
+async function removeRule(ruleId, rulesPath) {
+    const existing = await readRules(rulesPath);
+    const filtered = existing.filter(r => r.id !== ruleId);
+    await writeRules(filtered, rulesPath);
+    return filtered;
+}
+/**
+ * List all rules.
+ */
+async function listRules(rulesPath) {
+    return readRules(rulesPath);
+}

package/dist/breakpoints/types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Breakpoint auto-approval types.
+ */
+export type BreakpointRuleAction = "auto-approve" | "never-auto-approve";
+export interface BreakpointRule {
+    /** Unique rule identifier (UUID or slug). */
+    id: string;
+    /** Pattern to match breakpointIds. Supports glob with attribute predicates. */
+    pattern: string;
+    /** Action to take when pattern matches. */
+    action: BreakpointRuleAction;
+    /** ISO timestamp when rule was created. */
+    createdAt: string;
+    /** Who created the rule (e.g., "user", "agent", "analyze-history"). */
+    createdBy: string;
+    /** Source context (e.g., "cli", "process:xyz"). */
+    source?: string;
+    /** Human-readable note about why this rule exists. */
+    note?: string;
+}
+export interface BreakpointRulesFile {
+    schemaVersion: string;
+    rules: BreakpointRule[];
+}
+export interface AutoApprovalResult {
+    /** Whether auto-approval is recommended. */
+    recommended: boolean;
+    /** Human-readable reason for the recommendation. */
+    reason: string;
+    /** ID of the matched rule, if any. */
+    matchedRule?: string;
+    /** Number of consecutive approvals for this breakpointId. */
+    consecutiveApprovals?: number;
+}
+export interface BreakpointPattern {
+    /** The id-glob portion (e.g., "confirm.*", "gate.prerequisites"). */
+    idGlob: string;
+    /** Attribute predicates (e.g., [{ attr: "tags", op: "contains", value: "design" }]). */
+    predicates: AttributePredicate[];
+}
+export type PredicateOp = "contains" | "=";
+export interface AttributePredicate {
+    attr: string;
+    op: PredicateOp;
+    value: string;
+}
+export declare const BREAKPOINT_RULES_SCHEMA_VERSION = "2026.01.breakpoint-rules-v1";
+//# sourceMappingURL=types.d.ts.map

package/dist/breakpoints/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/breakpoints/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,oBAAoB,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,MAAM,EAAE,oBAAoB,CAAC;IAC7B,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,WAAW,EAAE,OAAO,CAAC;IACrB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,wFAAwF;IACxF,UAAU,EAAE,kBAAkB,EAAE,CAAC;CAClC;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,GAAG,CAAC;AAE3C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,WAAW,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,+BAA+B,gCAAgC,CAAC"}

package/dist/breakpoints/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Breakpoint auto-approval types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BREAKPOINT_RULES_SCHEMA_VERSION = void 0;
+exports.BREAKPOINT_RULES_SCHEMA_VERSION = "2026.01.breakpoint-rules-v1";

package/dist/cli/commandRegistry.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Command registry for discoverability (GAP-UX-011).
+ * Provides search and contextual suggestions across all babysitter CLI commands.
+ */
+export interface CommandInfo {
+    name: string;
+    description: string;
+    aliases?: string[];
+    category: CommandCategory;
+    usage?: string;
+}
+export type CommandCategory = "run" | "task" | "session" | "harness" | "plugin" | "config" | "debug" | "help" | "tui";
+export interface RunContext {
+    hasRun?: boolean;
+    hasPendingEffects?: boolean;
+    runStatus?: string;
+}
+export declare const COMMAND_REGISTRY: CommandInfo[];
+/**
+ * Search commands by name, description, or alias. Case-insensitive fuzzy match.
+ */
+export declare function searchCommands(query: string): CommandInfo[];
+/**
+ * Suggest commands based on current run context.
+ */
+export declare function suggestCommands(context: RunContext): CommandInfo[];
+//# sourceMappingURL=commandRegistry.d.ts.map

package/dist/cli/commandRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandRegistry.d.ts","sourceRoot":"","sources":["../../src/cli/commandRegistry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,eAAe,GACvB,KAAK,GACL,MAAM,GACN,SAAS,GACT,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,GACN,KAAK,CAAC;AAEV,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,gBAAgB,EAAE,WAAW,EAoEzC,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAW3D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,WAAW,EAAE,CAuDlE"}

package/dist/cli/commandRegistry.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * Command registry for discoverability (GAP-UX-011).
+ * Provides search and contextual suggestions across all babysitter CLI commands.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMAND_REGISTRY = void 0;
+exports.searchCommands = searchCommands;
+exports.suggestCommands = suggestCommands;
+exports.COMMAND_REGISTRY = [
+    // Run commands
+    { name: "run:create", description: "Create a new run with process and inputs", category: "run", usage: "babysitter run:create --process-id <id> --entry <path>" },
+    { name: "run:iterate", description: "Execute one orchestration iteration", category: "run", usage: "babysitter run:iterate <runDir>" },
+    { name: "run:status", description: "Show run status, metadata, and pending effects", category: "run", aliases: ["status"], usage: "babysitter run:status <runDir>" },
+    { name: "run:events", description: "Show journal events for a run", category: "run", aliases: ["events"], usage: "babysitter run:events <runDir> --limit 50" },
+    { name: "run:rebuild-state", description: "Rebuild derived state cache from journal", category: "run", usage: "babysitter run:rebuild-state <runDir>" },
+    { name: "run:repair-journal", description: "Repair corrupted journal entries", category: "run", usage: "babysitter run:repair-journal <runDir>" },
+    { name: "run:execute-tasks", description: "Execute pending tasks in a run", category: "run" },
+    // Task commands
+    { name: "task:post", description: "Post an effect result (task, breakpoint, sleep)", category: "task", usage: "babysitter task:post <runDir> <effectId> --status ok --value-inline '{...}'" },
+    { name: "task:list", description: "List tasks/effects in a run", category: "task", aliases: ["tasks"], usage: "babysitter task:list <runDir> --pending" },
+    { name: "task:show", description: "Show task definition and result details", category: "task", usage: "babysitter task:show <runDir> <effectId>" },
+    // Session commands
+    { name: "session:init", description: "Initialize a new orchestration session", category: "session" },
+    { name: "session:associate", description: "Associate session with a run", category: "session" },
+    { name: "session:resume", description: "Resume an existing session", category: "session" },
+    { name: "session:state", description: "Show current session state", category: "session" },
+    { name: "session:update", description: "Update session state", category: "session" },
+    // Harness commands
+    { name: "harness:discover", description: "Discover installed harness CLIs", category: "harness", aliases: ["harness:list"] },
+    { name: "harness:invoke", description: "Invoke a harness CLI with a prompt", category: "harness" },
+    { name: "harness:create-run", description: "Create and run an orchestration session", category: "harness", aliases: ["harness:call"] },
+    { name: "harness:resume-run", description: "Resume an existing orchestration run", category: "harness", aliases: ["harness:resume"] },
+    { name: "harness:yolo", description: "Create run in non-interactive mode", category: "harness" },
+    { name: "harness:plan", description: "Create run, stop after planning phase", category: "harness" },
+    { name: "harness:observe", description: "Launch real-time observer dashboard", category: "harness", usage: "babysitter harness:observe [--workspace <dir>] [--tui]" },
+    { name: "tui:session", description: "Launch interactive session TUI (Ink-based)", category: "tui", usage: "babysitter tui:session [--run-id <id>] [--verbosity minimal|normal|verbose] [--workspace <dir>] [--harness <name>]" },
+    { name: "harness:doctor", description: "Diagnose run health issues", category: "harness" },
+    { name: "harness:retrospect", description: "Analyze past runs for insights", category: "harness" },
+    { name: "harness:cleanup", description: "Clean up old runs and artifacts", category: "harness" },
+    // Plugin commands
+    { name: "plugin:install", description: "Install a plugin", category: "plugin" },
+    { name: "plugin:uninstall", description: "Uninstall a plugin", category: "plugin" },
+    { name: "plugin:update", description: "Update a plugin", category: "plugin" },
+    { name: "plugin:list-installed", description: "List installed plugins", category: "plugin" },
+    { name: "plugin:list-plugins", description: "List available plugins from marketplace", category: "plugin" },
+    { name: "plugin:add-marketplace", description: "Add a plugin marketplace", category: "plugin" },
+    // Config commands
+    { name: "configure", description: "Configure babysitter settings", category: "config" },
+    { name: "compression:status", description: "Show compression layer status", category: "config" },
+    { name: "compression:toggle", description: "Toggle a compression layer on/off", category: "config" },
+    { name: "compression:set", description: "Set a compression config value", category: "config" },
+    { name: "compression:reset", description: "Reset compression config to defaults", category: "config" },
+    { name: "breakpoint:approve-rule", description: "Add breakpoint auto-approval rule", category: "config" },
+    { name: "breakpoint:list-rules", description: "List breakpoint auto-approval rules", category: "config" },
+    { name: "breakpoint:remove-rule", description: "Remove a breakpoint auto-approval rule", category: "config" },
+    { name: "tokens:stats", description: "Show token usage statistics", category: "config" },
+    { name: "profile:read", description: "Read user or project profile", category: "config" },
+    { name: "profile:write", description: "Write user or project profile", category: "config" },
+    // Debug commands
+    { name: "log", description: "Write structured log entry", category: "debug" },
+    { name: "hook:log", description: "Log hook execution", category: "debug" },
+    { name: "hook:run", description: "Execute a hook manually", category: "debug" },
+    { name: "health", description: "Show system health status", category: "debug" },
+    { name: "mcp:serve", description: "Start MCP server over stdio", category: "debug" },
+    // Help commands
+    { name: "help", description: "Show help for babysitter commands", category: "help" },
+    { name: "version", description: "Show babysitter SDK version", category: "help", aliases: ["-v", "--version"] },
+    { name: "instructions:babysit-skill", description: "Generate babysit skill instructions", category: "help" },
+    { name: "instructions:orchestrate", description: "Generate orchestration instructions", category: "help" },
+];
+/**
+ * Search commands by name, description, or alias. Case-insensitive fuzzy match.
+ */
+function searchCommands(query) {
+    if (!query || query.trim().length === 0)
+        return [];
+    const q = query.toLowerCase().trim();
+    return exports.COMMAND_REGISTRY.filter((cmd) => {
+        if (cmd.name.toLowerCase().includes(q))
+            return true;
+        if (cmd.description.toLowerCase().includes(q))
+            return true;
+        if (cmd.aliases?.some((a) => a.toLowerCase().includes(q)))
+            return true;
+        // Match category
+        if (cmd.category.toLowerCase().includes(q))
+            return true;
+        return false;
+    });
+}
+/**
+ * Suggest commands based on current run context.
+ */
+function suggestCommands(context) {
+    const suggestions = [];
+    if (!context.hasRun) {
+        // No active run — suggest creation
+        suggestions.push(...exports.COMMAND_REGISTRY.filter((c) => c.name === "run:create" || c.name === "harness:create-run" || c.name === "harness:discover"));
+        return suggestions;
+    }
+    if (context.hasPendingEffects) {
+        // Has pending effects — suggest posting results
+        suggestions.push(...exports.COMMAND_REGISTRY.filter((c) => c.name === "task:post" || c.name === "task:list" || c.name === "task:show"));
+    }
+    if (context.runStatus === "failed") {
+        // Failed run — suggest recovery
+        suggestions.push(...exports.COMMAND_REGISTRY.filter((c) => c.name === "run:rebuild-state" || c.name === "run:repair-journal" || c.name === "harness:doctor"));
+    }
+    if (context.runStatus === "completed") {
+        suggestions.push(...exports.COMMAND_REGISTRY.filter((c) => c.name === "run:events" || c.name === "harness:retrospect" || c.name === "tokens:stats"));
+    }
+    // Always suggest status and iterate for active runs
+    if (context.hasRun) {
+        suggestions.push(...exports.COMMAND_REGISTRY.filter((c) => c.name === "run:status" || c.name === "run:iterate"));
+    }
+    // Deduplicate
+    const seen = new Set();
+    return suggestions.filter((s) => {
+        if (seen.has(s.name))
+            return false;
+        seen.add(s.name);
+        return true;
+    });
+}

package/dist/cli/commands/breakpointRules.d.ts

@@ -0,0 +1,26 @@
+/**
+ * breakpoint:* commands — Manage breakpoint auto-approval rules.
+ *
+ * Commands:
+ *   breakpoint:approve-rule <pattern> [--action auto-approve|never-auto-approve] [--source <source>] [--note <note>] [--json]
+ *   breakpoint:remove-rule <ruleId> [--json]
+ *   breakpoint:list-rules [--json]
+ *   breakpoint:should-auto-approve <breakpointId> [--tags <csv>] [--expert <expert>] [--json]
+ *   breakpoint:history [--breakpoint-id <id>] [--runs-dir <dir>] [--limit <n>] [--json]
+ */
+export interface BreakpointCommandArgs {
+    subcommand: string;
+    pattern?: string;
+    ruleId?: string;
+    breakpointId?: string;
+    action?: string;
+    source?: string;
+    note?: string;
+    tags?: string;
+    expert?: string;
+    runsDir?: string;
+    limit?: number;
+    json: boolean;
+}
+export declare function handleBreakpointCommand(args: BreakpointCommandArgs): Promise<number>;
+//# sourceMappingURL=breakpointRules.d.ts.map

package/dist/cli/commands/breakpointRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breakpointRules.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/breakpointRules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB1F"}