rhachet-roles-bhrain 0.2.0 → 0.5.1

package/dist/domain.operations/reflect/validateTargetDirectory.js

@@ -0,0 +1,59 @@
+"use strict";
+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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTargetDirectory = void 0;
+const fs = __importStar(require("fs/promises"));
+const helpful_errors_1 = require("helpful-errors");
+/**
+ * .what = validates target directory exists or creates with --force
+ * .why = fail fast on invalid target before expensive operations
+ */
+const validateTargetDirectory = async (input) => {
+    // check if directory exists
+    try {
+        const stat = await fs.stat(input.target);
+        if (!stat.isDirectory())
+            throw new helpful_errors_1.BadRequestError('target path exists but is not a directory', {
+                target: input.target,
+            });
+        return { created: false };
+    }
+    catch (error) {
+        // if not a BadRequestError, directory doesn't exist
+        if (error instanceof helpful_errors_1.BadRequestError)
+            throw error;
+        // directory doesn't exist - check if we should create it
+        if (!input.force)
+            throw new helpful_errors_1.BadRequestError('target directory does not exist. use --force to create it.', {
+                target: input.target,
+                hint: 'add --force flag to create the target directory',
+            });
+        // create directory with --force
+        await fs.mkdir(input.target, { recursive: true });
+        return { created: true };
+    }
+};
+exports.validateTargetDirectory = validateTargetDirectory;
+//# sourceMappingURL=validateTargetDirectory.js.map

package/dist/domain.operations/reflect/validateTargetDirectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateTargetDirectory.js","sourceRoot":"","sources":["../../../src/domain.operations/reflect/validateTargetDirectory.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAAkC;AAClC,mDAAiD;AAEjD;;;GAGG;AACI,MAAM,uBAAuB,GAAG,KAAK,EAAE,KAG7C,EAEE,EAAE;IACH,4BAA4B;IAC5B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YACrB,MAAM,IAAI,gCAAe,CAAC,2CAA2C,EAAE;gBACrE,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;QACL,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,oDAAoD;QACpD,IAAI,KAAK,YAAY,gCAAe;YAAE,MAAM,KAAK,CAAC;QAElD,yDAAyD;QACzD,IAAI,CAAC,KAAK,CAAC,KAAK;YACd,MAAM,IAAI,gCAAe,CACvB,4DAA4D,EAC5D;gBACE,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,IAAI,EAAE,iDAAiD;aACxD,CACF,CAAC;QAEJ,gCAAgC;QAChC,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC,CAAC;AAhCW,QAAA,uBAAuB,2BAgClC"}

package/dist/domain.operations/review/compileReviewPrompt.d.ts

@@ -0,0 +1,22 @@
+/**
+ * .what = compiles the review prompt from rules and target files
+ * .why = prepares the prompt for brain invocation with token safeguards
+ */
+export declare const compileReviewPrompt: (input: {
+    rules: Array<{
+        path: string;
+        content: string;
+    }>;
+    targets: Array<{
+        path: string;
+        content: string;
+    }>;
+    mode: 'soft' | 'hard';
+    contextWindowSize?: number;
+}) => {
+    prompt: string;
+    tokenEstimate: number;
+    contextWindowPercent: number;
+    costEstimate: number;
+    warnings: string[];
+};

package/dist/domain.operations/review/compileReviewPrompt.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileReviewPrompt = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const estimateTokenCount_1 = require("./estimateTokenCount");
+/**
+ * .what = compiles the review prompt from rules and target files
+ * .why = prepares the prompt for brain invocation with token safeguards
+ */
+const compileReviewPrompt = (input) => {
+    // default context window size for claude
+    const contextWindow = input.contextWindowSize ?? 200000;
+    const warnings = [];
+    // build rules section (always include content for rules)
+    const rulesSection = input.rules
+        .map((rule) => `### ${rule.path}\n\n${rule.content}`)
+        .join('\n\n---\n\n');
+    // build target section based on mode
+    const targetSection = (() => {
+        if (input.mode === 'soft') {
+            // soft mode: paths only, instruct brain to open files
+            const pathList = input.targets.map((t) => `- ${t.path}`).join('\n');
+            return `the following files are in scope for review. please open and read them as needed:\n\n${pathList}`;
+        }
+        // hard mode: inject contents
+        return input.targets
+            .map((target) => `### ${target.path}\n\n\`\`\`\n${target.content}\n\`\`\``)
+            .join('\n\n---\n\n');
+    })();
+    // build full prompt
+    const prompt = `# review task
+
+you are a reviewer. apply the rules below to the target files.
+
+## rules
+
+<rules>
+${rulesSection}
+</rules>
+
+## target
+
+<target>
+${targetSection}
+</target>
+
+## output format
+
+emit your review as a JSON object with the following structure:
+
+\`\`\`json
+{
+  "issues": [
+    {
+      "type": "blocker" | "nitpick",
+      "message": "description of the issue",
+      "file": "path/to/file.ts",
+      "line": 42
+    }
+  ]
+}
+\`\`\`
+
+emit blockers first, then nitpicks. if no issues found, emit an empty issues array.
+`;
+    // estimate tokens
+    const tokenEstimate = (0, estimateTokenCount_1.estimateTokenCount)({ content: prompt });
+    const contextWindowPercent = (tokenEstimate / contextWindow) * 100;
+    // check thresholds (only in hard mode - soft mode is inherently lighter)
+    if (input.mode === 'hard') {
+        // failfast if >75%
+        if (contextWindowPercent > 75) {
+            throw new helpful_errors_1.BadRequestError(`prompt exceeds 75% of context window (${contextWindowPercent.toFixed(1)}% of ${contextWindow} tokens). ` +
+                `reduce scope or use --soft mode to avoid quality degradation.`, { tokenEstimate, contextWindowPercent, contextWindow });
+        }
+        // warn if >60%
+        if (contextWindowPercent > 60) {
+            warnings.push(`potential quality degradation: prompt uses ${contextWindowPercent.toFixed(1)}% of context window`);
+        }
+    }
+    // estimate cost (claude: ~$3/1M input tokens, ~$15/1M output tokens)
+    // assume output is ~10% of input for reviews
+    const inputCost = (tokenEstimate / 1000000) * 3;
+    const outputCost = ((tokenEstimate * 0.1) / 1000000) * 15;
+    const costEstimate = Math.round((inputCost + outputCost) * 1000) / 1000;
+    return {
+        prompt,
+        tokenEstimate,
+        contextWindowPercent: Math.round(contextWindowPercent * 10) / 10,
+        costEstimate,
+        warnings,
+    };
+};
+exports.compileReviewPrompt = compileReviewPrompt;
+//# sourceMappingURL=compileReviewPrompt.js.map

package/dist/domain.operations/review/compileReviewPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compileReviewPrompt.js","sourceRoot":"","sources":["../../../src/domain.operations/review/compileReviewPrompt.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAEjD,6DAA0D;AAE1D;;;GAGG;AACI,MAAM,mBAAmB,GAAG,CAAC,KAKnC,EAMC,EAAE;IACF,yCAAyC;IACzC,MAAM,aAAa,GAAG,KAAK,CAAC,iBAAiB,IAAI,MAAM,CAAC;IACxD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,yDAAyD;IACzD,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK;SAC7B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;SACpD,IAAI,CAAC,aAAa,CAAC,CAAC;IAEvB,qCAAqC;IACrC,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE;QAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,sDAAsD;YACtD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpE,OAAO,wFAAwF,QAAQ,EAAE,CAAC;QAC5G,CAAC;QAED,6BAA6B;QAC7B,OAAO,KAAK,CAAC,OAAO;aACjB,GAAG,CACF,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,MAAM,CAAC,IAAI,eAAe,MAAM,CAAC,OAAO,UAAU,CACtE;aACA,IAAI,CAAC,aAAa,CAAC,CAAC;IACzB,CAAC,CAAC,EAAE,CAAC;IAEL,oBAAoB;IACpB,MAAM,MAAM,GAAG;;;;;;;EAOf,YAAY;;;;;;EAMZ,aAAa;;;;;;;;;;;;;;;;;;;;;CAqBd,CAAC;IAEA,kBAAkB;IAClB,MAAM,aAAa,GAAG,IAAA,uCAAkB,EAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9D,MAAM,oBAAoB,GAAG,CAAC,aAAa,GAAG,aAAa,CAAC,GAAG,GAAG,CAAC;IAEnE,yEAAyE;IACzE,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,mBAAmB;QACnB,IAAI,oBAAoB,GAAG,EAAE,EAAE,CAAC;YAC9B,MAAM,IAAI,gCAAe,CACvB,yCAAyC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,aAAa,YAAY;gBACvG,+DAA+D,EACjE,EAAE,aAAa,EAAE,oBAAoB,EAAE,aAAa,EAAE,CACvD,CAAC;QACJ,CAAC;QAED,eAAe;QACf,IAAI,oBAAoB,GAAG,EAAE,EAAE,CAAC;YAC9B,QAAQ,CAAC,IAAI,CACX,8CAA8C,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CACnG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,6CAA6C;IAC7C,MAAM,SAAS,GAAG,CAAC,aAAa,GAAG,OAAS,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,CAAC,CAAC,aAAa,GAAG,GAAG,CAAC,GAAG,OAAS,CAAC,GAAG,EAAE,CAAC;IAC5D,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAExE,OAAO;QACL,MAAM;QACN,aAAa;QACb,oBAAoB,EAAE,IAAI,CAAC,KAAK,CAAC,oBAAoB,GAAG,EAAE,CAAC,GAAG,EAAE;QAChE,YAAY;QACZ,QAAQ;KACT,CAAC;AACJ,CAAC,CAAC;AA9GW,QAAA,mBAAmB,uBA8G9B"}

package/dist/domain.operations/review/enumFilesFromDiffs.d.ts

@@ -0,0 +1,8 @@
+/**
+ * .what = enumerates files changed in a git diff range
+ * .why = supports --diffs input for reviewing changed files
+ */
+export declare const enumFilesFromDiffs: (input: {
+    range: 'uptil-main' | 'uptil-commit' | 'uptil-staged';
+    cwd?: string;
+}) => Promise<string[]>;

package/dist/domain.operations/review/enumFilesFromDiffs.js

@@ -0,0 +1,74 @@
+"use strict";
+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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enumFilesFromDiffs = void 0;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs/promises"));
+const helpful_errors_1 = require("helpful-errors");
+const path = __importStar(require("path"));
+/**
+ * .what = enumerates files changed in a git diff range
+ * .why = supports --diffs input for reviewing changed files
+ */
+const enumFilesFromDiffs = async (input) => {
+    const cwd = input.cwd ?? process.cwd();
+    // build git command based on range
+    const gitCommand = (() => {
+        if (input.range === 'uptil-main') {
+            return 'git diff main --name-only';
+        }
+        if (input.range === 'uptil-commit') {
+            return 'git diff HEAD --name-only';
+        }
+        if (input.range === 'uptil-staged') {
+            return 'git diff --staged --name-only';
+        }
+        throw new helpful_errors_1.UnexpectedCodePathError('invalid range', { range: input.range });
+    })();
+    // execute git command
+    const output = (0, child_process_1.execSync)(gitCommand, {
+        cwd,
+        encoding: 'utf-8',
+    });
+    // parse output into file paths
+    const paths = output
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+    // filter to only include files (exclude directories and symlinks to directories)
+    const files = await Promise.all(paths.map(async (filePath) => {
+        try {
+            const stat = await fs.stat(path.join(cwd, filePath));
+            return stat.isFile() ? filePath : null;
+        }
+        catch {
+            return null;
+        }
+    }));
+    // return sorted, deduplicated file paths
+    return [...new Set(files.filter((f) => f !== null))].sort();
+};
+exports.enumFilesFromDiffs = enumFilesFromDiffs;
+//# sourceMappingURL=enumFilesFromDiffs.js.map

package/dist/domain.operations/review/enumFilesFromDiffs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enumFilesFromDiffs.js","sourceRoot":"","sources":["../../../src/domain.operations/review/enumFilesFromDiffs.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,iDAAyC;AACzC,gDAAkC;AAClC,mDAAyD;AACzD,2CAA6B;AAE7B;;;GAGG;AACI,MAAM,kBAAkB,GAAG,KAAK,EAAE,KAGxC,EAAqB,EAAE;IACtB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEvC,mCAAmC;IACnC,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE;QACvB,IAAI,KAAK,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;YACjC,OAAO,2BAA2B,CAAC;QACrC,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;YACnC,OAAO,2BAA2B,CAAC;QACrC,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;YACnC,OAAO,+BAA+B,CAAC;QACzC,CAAC;QACD,MAAM,IAAI,wCAAuB,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC,CAAC,EAAE,CAAC;IAEL,sBAAsB;IACtB,MAAM,MAAM,GAAG,IAAA,wBAAQ,EAAC,UAAU,EAAE;QAClC,GAAG;QACH,QAAQ,EAAE,OAAO;KAClB,CAAC,CAAC;IAEH,+BAA+B;IAC/B,MAAM,KAAK,GAAG,MAAM;SACjB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAErC,iFAAiF;IACjF,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IAEF,yCAAyC;IACzC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3E,CAAC,CAAC;AA9CW,QAAA,kBAAkB,sBA8C7B"}

package/dist/domain.operations/review/enumFilesFromGlob.d.ts

@@ -0,0 +1,8 @@
+/**
+ * .what = enumerates files matching a glob pattern
+ * .why = supports --rules and --paths inputs for file discovery
+ */
+export declare const enumFilesFromGlob: (input: {
+    glob: string | string[];
+    cwd?: string;
+}) => Promise<string[]>;

package/dist/domain.operations/review/enumFilesFromGlob.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enumFilesFromGlob = void 0;
+const fast_glob_1 = __importDefault(require("fast-glob"));
+/**
+ * .what = enumerates files matching a glob pattern
+ * .why = supports --rules and --paths inputs for file discovery
+ */
+const enumFilesFromGlob = async (input) => {
+    // normalize to array
+    const patterns = Array.isArray(input.glob) ? input.glob : [input.glob];
+    // separate positive and negative patterns
+    const positivePatterns = patterns.filter((p) => !p.startsWith('!'));
+    const negativePatterns = patterns
+        .filter((p) => p.startsWith('!'))
+        .map((p) => p.slice(1)); // remove ! prefix for ignore
+    // enumerate files
+    const files = await (0, fast_glob_1.default)(positivePatterns, {
+        cwd: input.cwd,
+        ignore: negativePatterns,
+        onlyFiles: true,
+        dot: true, // include dotfiles
+    });
+    // return sorted, deduplicated paths
+    return [...new Set(files)].sort();
+};
+exports.enumFilesFromGlob = enumFilesFromGlob;
+//# sourceMappingURL=enumFilesFromGlob.js.map

package/dist/domain.operations/review/enumFilesFromGlob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enumFilesFromGlob.js","sourceRoot":"","sources":["../../../src/domain.operations/review/enumFilesFromGlob.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA2B;AAE3B;;;GAGG;AACI,MAAM,iBAAiB,GAAG,KAAK,EAAE,KAGvC,EAAqB,EAAE;IACtB,qBAAqB;IACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEvE,0CAA0C;IAC1C,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,MAAM,gBAAgB,GAAG,QAAQ;SAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,6BAA6B;IAExD,kBAAkB;IAClB,MAAM,KAAK,GAAG,MAAM,IAAA,mBAAE,EAAC,gBAAgB,EAAE;QACvC,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,gBAAgB;QACxB,SAAS,EAAE,IAAI;QACf,GAAG,EAAE,IAAI,EAAE,mBAAmB;KAC/B,CAAC,CAAC;IAEH,oCAAoC;IACpC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACpC,CAAC,CAAC;AAvBW,QAAA,iBAAiB,qBAuB5B"}

package/dist/domain.operations/review/estimateTokenCount.d.ts

@@ -0,0 +1,9 @@
+/**
+ * .what = estimates the token count of a string using a heuristic
+ * .why = enables context window calculations without external dependencies
+ *
+ * .note = uses ~4 chars per token heuristic which aligns with typical LLM tokenizers
+ */
+export declare const estimateTokenCount: (input: {
+    content: string;
+}) => number;

package/dist/domain.operations/review/estimateTokenCount.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.estimateTokenCount = void 0;
+/**
+ * .what = estimates the token count of a string using a heuristic
+ * .why = enables context window calculations without external dependencies
+ *
+ * .note = uses ~4 chars per token heuristic which aligns with typical LLM tokenizers
+ */
+const estimateTokenCount = (input) => {
+    // handle empty content
+    if (!input.content)
+        return 0;
+    // estimate tokens using chars/4 heuristic (common for english text + code)
+    const charCount = input.content.length;
+    const estimatedTokens = Math.ceil(charCount / 4);
+    return estimatedTokens;
+};
+exports.estimateTokenCount = estimateTokenCount;
+//# sourceMappingURL=estimateTokenCount.js.map

package/dist/domain.operations/review/estimateTokenCount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimateTokenCount.js","sourceRoot":"","sources":["../../../src/domain.operations/review/estimateTokenCount.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACI,MAAM,kBAAkB,GAAG,CAAC,KAA0B,EAAU,EAAE;IACvE,uBAAuB;IACvB,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,CAAC,CAAC;IAE7B,2EAA2E;IAC3E,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;IACvC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAEjD,OAAO,eAAe,CAAC;AACzB,CAAC,CAAC;AATW,QAAA,kBAAkB,sBAS7B"}

package/dist/domain.operations/review/formatReviewOutput.d.ts

@@ -0,0 +1,14 @@
+/**
+ * .what = formats brain response into review markdown
+ * .why = ensures consistent, machine-parseable review output
+ */
+export declare const formatReviewOutput: (input: {
+    response: {
+        issues: Array<{
+            type: 'blocker' | 'nitpick';
+            message: string;
+            file?: string;
+            line?: number;
+        }>;
+    };
+}) => string;

package/dist/domain.operations/review/formatReviewOutput.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatReviewOutput = void 0;
+/**
+ * .what = formats brain response into review markdown
+ * .why = ensures consistent, machine-parseable review output
+ */
+const formatReviewOutput = (input) => {
+    // handle empty or missing issues
+    const issues = input.response?.issues ?? [];
+    if (!issues.length) {
+        return '# review complete\n\nno issues found.\n';
+    }
+    // separate blockers and nitpicks
+    const blockers = issues.filter((f) => f.type === 'blocker');
+    const nitpicks = issues.filter((f) => f.type === 'nitpick');
+    // build output with blockers first (per template)
+    const sections = [];
+    // emit blockers
+    blockers.forEach((issue, index) => {
+        const header = `# blocker.${index + 1}`;
+        const location = issue.file
+            ? issue.line
+                ? `\n\n**location**: ${issue.file}:${issue.line}`
+                : `\n\n**location**: ${issue.file}`
+            : '';
+        sections.push(`${header}${location}\n\n${issue.message}`);
+    });
+    // emit nitpicks
+    nitpicks.forEach((issue, index) => {
+        const header = `# nitpick.${index + 1}`;
+        const location = issue.file
+            ? issue.line
+                ? `\n\n**location**: ${issue.file}:${issue.line}`
+                : `\n\n**location**: ${issue.file}`
+            : '';
+        sections.push(`${header}${location}\n\n${issue.message}`);
+    });
+    return sections.join('\n\n---\n\n') + '\n';
+};
+exports.formatReviewOutput = formatReviewOutput;
+//# sourceMappingURL=formatReviewOutput.js.map

package/dist/domain.operations/review/formatReviewOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatReviewOutput.js","sourceRoot":"","sources":["../../../src/domain.operations/review/formatReviewOutput.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACI,MAAM,kBAAkB,GAAG,CAAC,KASlC,EAAU,EAAE;IACX,iCAAiC;IACjC,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,yCAAyC,CAAC;IACnD,CAAC;IAED,iCAAiC;IACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAE5D,kDAAkD;IAClD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,gBAAgB;IAChB,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,aAAa,KAAK,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI;YACzB,CAAC,CAAC,KAAK,CAAC,IAAI;gBACV,CAAC,CAAC,qBAAqB,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE;gBACjD,CAAC,CAAC,qBAAqB,KAAK,CAAC,IAAI,EAAE;YACrC,CAAC,CAAC,EAAE,CAAC;QACP,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,QAAQ,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,gBAAgB;IAChB,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,aAAa,KAAK,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI;YACzB,CAAC,CAAC,KAAK,CAAC,IAAI;gBACV,CAAC,CAAC,qBAAqB,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE;gBACjD,CAAC,CAAC,qBAAqB,KAAK,CAAC,IAAI,EAAE;YACrC,CAAC,CAAC,EAAE,CAAC;QACP,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,QAAQ,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;AAC7C,CAAC,CAAC;AA9CW,QAAA,kBAAkB,sBA8C7B"}

package/dist/domain.operations/review/genTokenBreakdownMarkdown.d.ts

@@ -0,0 +1,19 @@
+import type { TokenBreakdownEntry } from './genTokenBreakdownReport';
+/**
+ * .what = generates a markdown tree view of token breakdown
+ * .why = enables easy visual comprehension of token distribution
+ */
+export declare const genTokenBreakdownMarkdown: (input: {
+    all: {
+        entries: TokenBreakdownEntry[];
+        total: number;
+    };
+    rules: {
+        entries: TokenBreakdownEntry[];
+        total: number;
+    };
+    targets: {
+        entries: TokenBreakdownEntry[];
+        total: number;
+    };
+}) => string;

package/dist/domain.operations/review/genTokenBreakdownMarkdown.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genTokenBreakdownMarkdown = void 0;
+/**
+ * .what = generates a markdown tree view of token breakdown
+ * .why = enables easy visual comprehension of token distribution
+ */
+const genTokenBreakdownMarkdown = (input) => {
+    const lines = [];
+    lines.push('# token breakdown');
+    lines.push('');
+    lines.push(`total: ${formatTokens(input.all.total)} tokens`);
+    lines.push('');
+    // render blended all section
+    lines.push('## all');
+    lines.push('');
+    lines.push('```');
+    lines.push(...renderTree(input.all.entries, input.all.total));
+    lines.push('```');
+    lines.push('');
+    // render rules section
+    lines.push('## rules');
+    lines.push('');
+    lines.push(`total: ${formatTokens(input.rules.total)} tokens`);
+    lines.push('');
+    lines.push('```');
+    lines.push(...renderTree(input.rules.entries, input.all.total));
+    lines.push('```');
+    lines.push('');
+    // render targets section
+    lines.push('## targets');
+    lines.push('');
+    lines.push(`total: ${formatTokens(input.targets.total)} tokens`);
+    lines.push('');
+    lines.push('```');
+    lines.push(...renderTree(input.targets.entries, input.all.total));
+    lines.push('```');
+    return lines.join('\n');
+};
+exports.genTokenBreakdownMarkdown = genTokenBreakdownMarkdown;
+/**
+ * .what = formats token count for display
+ * .why = human-readable numbers
+ */
+const formatTokens = (tokens) => {
+    if (tokens >= 1000000)
+        return `${(tokens / 1000000).toFixed(1)}M`;
+    if (tokens >= 1000)
+        return `${(tokens / 1000).toFixed(1)}k`;
+    return `${tokens}`;
+};
+/**
+ * .what = renders entries as a tree structure
+ * .why = visual hierarchy of token consumption
+ */
+const renderTree = (entries, grandTotal) => {
+    // build tree structure
+    const root = {
+        name: '',
+        tokens: 0,
+        children: new Map(),
+        isFile: false,
+    };
+    for (const entry of entries) {
+        if (entry.type !== 'FILE')
+            continue;
+        const parts = entry.path.split('/');
+        let current = root;
+        for (let i = 0; i < parts.length; i++) {
+            const part = parts[i];
+            const isLast = i === parts.length - 1;
+            if (!current.children.has(part)) {
+                current.children.set(part, {
+                    name: part,
+                    tokens: 0,
+                    children: new Map(),
+                    isFile: isLast,
+                });
+            }
+            const child = current.children.get(part);
+            child.tokens += entry.tokens;
+            current = child;
+        }
+    }
+    // render tree recursively
+    const lines = [];
+    renderNode(root, '', true, grandTotal, lines);
+    return lines;
+};
+/**
+ * .what = recursively renders a tree node
+ * .why = builds visual tree output
+ */
+const renderNode = (node, prefix, isRoot, grandTotal, lines) => {
+    // sort children by tokens desc
+    const children = Array.from(node.children.values()).sort((a, b) => b.tokens - a.tokens);
+    for (let i = 0; i < children.length; i++) {
+        const child = children[i];
+        const isLast = i === children.length - 1;
+        const branch = isLast ? '└─' : '├─';
+        const childPrefix = isLast ? '   ' : '│  ';
+        const pct = ((child.tokens / grandTotal) * 100).toFixed(1);
+        const suffix = child.isFile ? '' : '/';
+        lines.push(`${prefix}${branch} ${child.name}${suffix} (${formatTokens(child.tokens)}, ${pct}%)`);
+        if (!child.isFile && child.children.size > 0) {
+            renderNode(child, prefix + childPrefix, false, grandTotal, lines);
+        }
+    }
+};
+//# sourceMappingURL=genTokenBreakdownMarkdown.js.map

package/dist/domain.operations/review/genTokenBreakdownMarkdown.js.map

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

package/dist/domain.operations/review/genTokenBreakdownReport.d.ts

@@ -0,0 +1,24 @@
+/**
+ * .what = content entry for token breakdown
+ * .why = enables analysis of which files consume most tokens
+ */
+export interface TokenBreakdownEntry {
+    path: string;
+    type: 'FILE' | 'DIRECTORY';
+    tokens: number;
+    tokensHuman: string;
+    tokensScale: string;
+}
+/**
+ * .what = generates token breakdown report grouped by directory
+ * .why = helps identify which files/dirs consume most context window
+ */
+export declare const genTokenBreakdownReport: (input: {
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+}) => {
+    entries: TokenBreakdownEntry[];
+    total: number;
+};

package/dist/domain.operations/review/genTokenBreakdownReport.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genTokenBreakdownReport = void 0;
+const estimateTokenCount_1 = require("./estimateTokenCount");
+/**
+ * .what = formats token count for human readability
+ * .why = makes large numbers easier to scan
+ */
+const formatTokens = (tokens) => {
+    if (tokens >= 1000000)
+        return `${(tokens / 1000000).toFixed(1)}M`;
+    if (tokens >= 1000)
+        return `${(tokens / 1000).toFixed(1)}k`;
+    return `${tokens}`;
+};
+/**
+ * .what = rounds to hundredths for percentage display
+ * .why = consistent precision in scale values
+ */
+const roundToHundredths = (num) => Math.round(num * 100) / 100;
+/**
+ * .what = generates token breakdown report grouped by directory
+ * .why = helps identify which files/dirs consume most context window
+ */
+const genTokenBreakdownReport = (input) => {
+    // calculate tokens per file
+    const fileEntries = input.files.map((file) => {
+        const tokens = (0, estimateTokenCount_1.estimateTokenCount)({ content: file.content });
+        return {
+            path: file.path,
+            type: 'FILE',
+            tokens,
+        };
+    });
+    // build directory token sums
+    const dirTokens = new Map();
+    for (const file of fileEntries) {
+        const parts = file.path.split('/');
+        let current = '';
+        for (let i = 0; i < parts.length - 1; i++) {
+            current = current ? `${current}/${parts[i]}` : parts[i];
+            dirTokens.set(current, (dirTokens.get(current) ?? 0) + file.tokens);
+        }
+    }
+    // create directory entries
+    const dirEntries = Array.from(dirTokens.entries()).map(([path, tokens]) => ({
+        path,
+        type: 'DIRECTORY',
+        tokens,
+    }));
+    // combine and sort by tokens descending
+    const allEntries = [...fileEntries, ...dirEntries].sort((a, b) => b.tokens - a.tokens);
+    // calculate total
+    const total = fileEntries.reduce((sum, f) => sum + f.tokens, 0);
+    // add human-readable fields
+    const entries = allEntries.map((entry) => ({
+        ...entry,
+        tokensHuman: formatTokens(entry.tokens),
+        tokensScale: `${roundToHundredths((entry.tokens / total) * 100)}%`,
+    }));
+    return { entries, total };
+};
+exports.genTokenBreakdownReport = genTokenBreakdownReport;
+//# sourceMappingURL=genTokenBreakdownReport.js.map