rhachet-roles-bhrain 0.3.0 → 0.5.2

package/dist/domain.operations/brain.replic.arch1/plugins/toolboxes/web/search.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import type { BrainArch1Context } from '../../../../../domain.objects/BrainArch1/BrainArch1Context';
+import { BrainArch1ToolDefinition } from '../../../../../domain.objects/BrainArch1/BrainArch1ToolDefinition';
+import { BrainArch1ToolResult } from '../../../../../domain.objects/BrainArch1/BrainArch1ToolResult';
+/**
+ * .what = zod schema for websearch tool input
+ * .why = enables type-safe validation and json schema generation
+ */
+export declare const schemaWebsearchInput: z.ZodObject<{
+    query: z.ZodString;
+    num_results: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    num_results?: number | undefined;
+}, {
+    query: string;
+    num_results?: number | undefined;
+}>;
+/**
+ * .what = tool definition for web search
+ * .why = enables the brain to search the web for information
+ */
+export declare const toolDefinitionSearch: BrainArch1ToolDefinition;
+/**
+ * .what = executes web search using Tavily API
+ * .why = provides reliable web search with proper API authentication
+ *
+ * .note = requires TAVILY_API_KEY in context.creds.tavily
+ */
+export declare const executeToolSearch: (input: {
+    callId: string;
+    args: {
+        query: string;
+        num_results?: number;
+    };
+}, context: BrainArch1Context) => Promise<BrainArch1ToolResult>;

package/dist/domain.operations/brain.replic.arch1/plugins/toolboxes/web/search.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeToolSearch = exports.toolDefinitionSearch = exports.schemaWebsearchInput = void 0;
+const zod_1 = require("zod");
+const BrainArch1ToolDefinition_1 = require("../../../../../domain.objects/BrainArch1/BrainArch1ToolDefinition");
+const BrainArch1ToolResult_1 = require("../../../../../domain.objects/BrainArch1/BrainArch1ToolResult");
+/**
+ * .what = zod schema for websearch tool input
+ * .why = enables type-safe validation and json schema generation
+ */
+exports.schemaWebsearchInput = zod_1.z.object({
+    query: zod_1.z.string().describe('The search query to look up'),
+    num_results: zod_1.z
+        .number()
+        .optional()
+        .describe('Number of results to return (default: 10, max: 20)'),
+});
+/**
+ * .what = tool definition for web search
+ * .why = enables the brain to search the web for information
+ */
+exports.toolDefinitionSearch = new BrainArch1ToolDefinition_1.BrainArch1ToolDefinition({
+    name: 'websearch',
+    description: 'Search the web for information. Returns search results with titles, URLs, and snippets. Use this to find current information, research topics, and gather sources for citations.',
+    schema: {
+        input: (0, BrainArch1ToolDefinition_1.toJsonSchema)(exports.schemaWebsearchInput),
+    },
+    strict: false,
+});
+/**
+ * .what = executes web search using Tavily API
+ * .why = provides reliable web search with proper API authentication
+ *
+ * .note = requires TAVILY_API_KEY in context.creds.tavily
+ */
+const executeToolSearch = async (input, context) => {
+    const { callId, args } = input;
+    const numResults = Math.min(args.num_results ?? 10, 20);
+    // check for api key
+    if (!context.creds.tavily.apiKey) {
+        return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+            callId,
+            success: false,
+            output: '',
+            error: 'TAVILY_API_KEY not configured',
+        });
+    }
+    try {
+        // call Tavily search API
+        const response = await fetch('https://api.tavily.com/search', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                api_key: context.creds.tavily.apiKey,
+                query: args.query,
+                max_results: numResults,
+                search_depth: 'basic',
+                include_answer: false,
+                include_raw_content: false,
+            }),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+                callId,
+                success: false,
+                output: '',
+                error: `tavily search failed: ${response.status} ${response.statusText} - ${errorText}`,
+            });
+        }
+        const data = (await response.json());
+        if (!data.results || data.results.length === 0) {
+            return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+                callId,
+                success: true,
+                output: `No results found for query: "${args.query}"`,
+                error: null,
+            });
+        }
+        // format results for the brain
+        const formattedResults = data.results
+            .map((r, i) => `[${i + 1}] ${r.title}\n    URL: ${r.url}\n    ${r.content}`)
+            .join('\n\n');
+        return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+            callId,
+            success: true,
+            output: `Found ${data.results.length} results for "${args.query}":\n\n${formattedResults}`,
+            error: null,
+        });
+    }
+    catch (error) {
+        return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+            callId,
+            success: false,
+            output: '',
+            error: `search failed: ${error instanceof Error ? error.message : String(error)}`,
+        });
+    }
+};
+exports.executeToolSearch = executeToolSearch;
+//# sourceMappingURL=search.js.map

package/dist/domain.operations/brain.replic.arch1/plugins/toolboxes/web/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../../../../src/domain.operations/brain.replic.arch1/plugins/toolboxes/web/search.ts"],"names":[],"mappings":"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"}

package/dist/domain.operations/brain.replic.arch1/tool/executeBrainArch1ToolCall.d.ts

@@ -0,0 +1,14 @@
+import type { BrainArch1Context } from '../../../domain.objects/BrainArch1/BrainArch1Context';
+import type { BrainArch1PermissionGuard } from '../../../domain.objects/BrainArch1/BrainArch1PermissionGuard';
+import type { BrainArch1Toolbox } from '../../../domain.objects/BrainArch1/BrainArch1Toolbox';
+import type { BrainArch1ToolCall } from '../../../domain.objects/BrainArch1/BrainArch1ToolCall';
+import { BrainArch1ToolResult } from '../../../domain.objects/BrainArch1/BrainArch1ToolResult';
+/**
+ * .what = executes a tool call against the merged toolboxes
+ * .why = provides unified tool execution with permission checking
+ */
+export declare const executeBrainArch1ToolCall: (input: {
+    call: BrainArch1ToolCall;
+    toolboxByToolName: Map<string, BrainArch1Toolbox>;
+    permissionGuard: BrainArch1PermissionGuard;
+}, context: BrainArch1Context) => Promise<BrainArch1ToolResult>;

package/dist/domain.operations/brain.replic.arch1/tool/executeBrainArch1ToolCall.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeBrainArch1ToolCall = void 0;
+const BrainArch1ToolResult_1 = require("../../../domain.objects/BrainArch1/BrainArch1ToolResult");
+/**
+ * .what = executes a tool call against the merged toolboxes
+ * .why = provides unified tool execution with permission checking
+ */
+const executeBrainArch1ToolCall = async (input, context) => {
+    // find the toolbox for this tool
+    const toolbox = input.toolboxByToolName.get(input.call.name);
+    if (!toolbox) {
+        const availableTools = Array.from(input.toolboxByToolName.keys());
+        return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+            callId: input.call.id,
+            success: false,
+            output: `tool "${input.call.name}" not found. available tools: ${availableTools.join(', ')}`,
+            error: `tool not found: ${input.call.name}`,
+        });
+    }
+    // check permission guard
+    const decision = await input.permissionGuard.check({ call: input.call }, context);
+    if (decision.verdict === 'deny') {
+        return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+            callId: input.call.id,
+            success: false,
+            output: `permission denied: ${decision.reason ?? 'no reason provided'}`,
+            error: 'permission denied',
+        });
+    }
+    // handle prompt verdict (for now, treat as deny with explanation)
+    if (decision.verdict === 'prompt') {
+        return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+            callId: input.call.id,
+            success: false,
+            output: `permission requires user approval: ${decision.reason ?? 'no reason provided'}`,
+            error: 'user approval required',
+        });
+    }
+    // execute the tool via its toolbox
+    const result = await toolbox.execute({ call: input.call }, context);
+    return result;
+};
+exports.executeBrainArch1ToolCall = executeBrainArch1ToolCall;
+//# sourceMappingURL=executeBrainArch1ToolCall.js.map

package/dist/domain.operations/brain.replic.arch1/tool/executeBrainArch1ToolCall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeBrainArch1ToolCall.js","sourceRoot":"","sources":["../../../../src/domain.operations/brain.replic.arch1/tool/executeBrainArch1ToolCall.ts"],"names":[],"mappings":";;;AAIA,8FAA2F;AAE3F;;;GAGG;AACI,MAAM,yBAAyB,GAAG,KAAK,EAC5C,KAIC,EACD,OAA0B,EACK,EAAE;IACjC,iCAAiC;IACjC,MAAM,OAAO,GAAG,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,OAAO,IAAI,2CAAoB,CAAC;YAC9B,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;YACrB,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,iCAAiC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC5F,KAAK,EAAE,mBAAmB,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;SAC5C,CAAC,CAAC;IACL,CAAC;IAED,yBAAyB;IACzB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,eAAe,CAAC,KAAK,CAChD,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EACpB,OAAO,CACR,CAAC;IACF,IAAI,QAAQ,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAChC,OAAO,IAAI,2CAAoB,CAAC;YAC9B,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;YACrB,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,sBAAsB,QAAQ,CAAC,MAAM,IAAI,oBAAoB,EAAE;YACvE,KAAK,EAAE,mBAAmB;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,kEAAkE;IAClE,IAAI,QAAQ,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,IAAI,2CAAoB,CAAC;YAC9B,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;YACrB,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,sCAAsC,QAAQ,CAAC,MAAM,IAAI,oBAAoB,EAAE;YACvF,KAAK,EAAE,wBAAwB;SAChC,CAAC,CAAC;IACL,CAAC;IAED,mCAAmC;IACnC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAEpE,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAhDW,QAAA,yBAAyB,6BAgDpC"}

package/dist/domain.operations/brain.replic.arch1/tool/mergeBrainArch1Toolboxes.d.ts

@@ -0,0 +1,19 @@
+import type { BrainArch1Toolbox } from '../../../domain.objects/BrainArch1/BrainArch1Toolbox';
+import type { BrainArch1ToolDefinition } from '../../../domain.objects/BrainArch1/BrainArch1ToolDefinition';
+/**
+ * .what = result of merging multiple tool boxes
+ * .why = provides both definitions for llm and lookup for execution
+ */
+export interface MergedBrainArch1Toolboxes {
+    definitions: BrainArch1ToolDefinition[];
+    toolboxByToolName: Map<string, BrainArch1Toolbox>;
+}
+/**
+ * .what = merges multiple tool boxes into a unified collection
+ * .why = enables brain to use tools from multiple sources with single interface
+ *
+ * .note = throws if duplicate tool names detected
+ */
+export declare const mergeBrainArch1Toolboxes: (input: {
+    toolboxes: BrainArch1Toolbox[];
+}) => MergedBrainArch1Toolboxes;

package/dist/domain.operations/brain.replic.arch1/tool/mergeBrainArch1Toolboxes.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeBrainArch1Toolboxes = void 0;
+const helpful_errors_1 = require("helpful-errors");
+/**
+ * .what = merges multiple tool boxes into a unified collection
+ * .why = enables brain to use tools from multiple sources with single interface
+ *
+ * .note = throws if duplicate tool names detected
+ */
+const mergeBrainArch1Toolboxes = (input) => {
+    const definitions = [];
+    const toolboxByToolName = new Map();
+    const seenToolNames = new Set();
+    // iterate through each toolbox
+    for (const toolbox of input.toolboxes) {
+        // iterate through each tool definition in the box
+        for (const definition of toolbox.definitions) {
+            // check for duplicate tool names
+            if (seenToolNames.has(definition.name)) {
+                throw new helpful_errors_1.BadRequestError('duplicate tool name across toolboxes', {
+                    toolName: definition.name,
+                    toolboxName: toolbox.name,
+                });
+            }
+            // register the tool
+            seenToolNames.add(definition.name);
+            definitions.push(definition);
+            toolboxByToolName.set(definition.name, toolbox);
+        }
+    }
+    return { definitions, toolboxByToolName };
+};
+exports.mergeBrainArch1Toolboxes = mergeBrainArch1Toolboxes;
+//# sourceMappingURL=mergeBrainArch1Toolboxes.js.map

package/dist/domain.operations/brain.replic.arch1/tool/mergeBrainArch1Toolboxes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeBrainArch1Toolboxes.js","sourceRoot":"","sources":["../../../../src/domain.operations/brain.replic.arch1/tool/mergeBrainArch1Toolboxes.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAcjD;;;;;GAKG;AACI,MAAM,wBAAwB,GAAG,CAAC,KAExC,EAA6B,EAAE;IAC9B,MAAM,WAAW,GAA+B,EAAE,CAAC;IACnD,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAA6B,CAAC;IAC/D,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IAExC,+BAA+B;IAC/B,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACtC,kDAAkD;QAClD,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAC7C,iCAAiC;YACjC,IAAI,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvC,MAAM,IAAI,gCAAe,CAAC,sCAAsC,EAAE;oBAChE,QAAQ,EAAE,UAAU,CAAC,IAAI;oBACzB,WAAW,EAAE,OAAO,CAAC,IAAI;iBAC1B,CAAC,CAAC;YACL,CAAC;YAED,oBAAoB;YACpB,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACnC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7B,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;AAC5C,CAAC,CAAC;AA3BW,QAAA,wBAAwB,4BA2BnC"}

package/dist/domain.operations/git/genGitHubFileUrl.d.ts

@@ -0,0 +1,9 @@
+/**
+ * .what = constructs github url for a file in a git repository
+ * .why = enables permanent citations with provenance track
+ */
+export declare const genGitHubFileUrl: (input: {
+    filePath: string;
+    cwd: string;
+    ref?: string;
+}) => string;

package/dist/domain.operations/git/genGitHubFileUrl.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genGitHubFileUrl = void 0;
+const child_process_1 = require("child_process");
+const getGitRemoteUrl_1 = require("./getGitRemoteUrl");
+/**
+ * .what = constructs github url for a file in a git repository
+ * .why = enables permanent citations with provenance track
+ */
+const genGitHubFileUrl = (input) => {
+    // get remote url and parse to github format
+    const remoteUrl = (0, getGitRemoteUrl_1.getGitRemoteUrl)({ cwd: input.cwd });
+    const githubBase = parseRemoteToGitHubUrl(remoteUrl);
+    // get current branch or commit if ref not specified
+    const ref = input.ref ??
+        (0, child_process_1.execSync)('git rev-parse HEAD', {
+            cwd: input.cwd,
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        }).trim();
+    // encode file path for url (handle special characters like brackets)
+    const encodedPath = encodeFilePath(input.filePath);
+    return `${githubBase}/blob/${ref}/${encodedPath}`;
+};
+exports.genGitHubFileUrl = genGitHubFileUrl;
+/**
+ * .what = parses git remote url to github https url
+ * .why = handles both ssh and https remote formats
+ */
+const parseRemoteToGitHubUrl = (remoteUrl) => {
+    // ssh format: git@github.com:org/repo.git
+    const sshMatch = remoteUrl.match(/git@github\.com:(.+?)(?:\.git)?$/);
+    if (sshMatch) {
+        return `https://github.com/${sshMatch[1]}`;
+    }
+    // https format: https://github.com/org/repo.git
+    const httpsMatch = remoteUrl.match(/https:\/\/github\.com\/(.+?)(?:\.git)?$/);
+    if (httpsMatch) {
+        return `https://github.com/${httpsMatch[1]}`;
+    }
+    // fallback: strip .git suffix if present
+    return remoteUrl.replace(/\.git$/, '');
+};
+/**
+ * .what = encodes file path for github url
+ * .why = handles special characters like brackets in filenames
+ */
+const encodeFilePath = (filePath) => {
+    // encode special characters that github expects encoded
+    return filePath
+        .split('/')
+        .map((segment) => segment.replace(/\[/g, '%5B').replace(/\]/g, '%5D').replace(/ /g, '%20'))
+        .join('/');
+};
+//# sourceMappingURL=genGitHubFileUrl.js.map

package/dist/domain.operations/git/genGitHubFileUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genGitHubFileUrl.js","sourceRoot":"","sources":["../../../src/domain.operations/git/genGitHubFileUrl.ts"],"names":[],"mappings":";;;AAAA,iDAAyC;AAEzC,uDAAoD;AAEpD;;;GAGG;AACI,MAAM,gBAAgB,GAAG,CAAC,KAIhC,EAAU,EAAE;IACX,4CAA4C;IAC5C,MAAM,SAAS,GAAG,IAAA,iCAAe,EAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAErD,oDAAoD;IACpD,MAAM,GAAG,GACP,KAAK,CAAC,GAAG;QACT,IAAA,wBAAQ,EAAC,oBAAoB,EAAE;YAC7B,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,MAAM;SACd,CAAC,CAAC,IAAI,EAAE,CAAC;IAEZ,qEAAqE;IACrE,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEnD,OAAO,GAAG,UAAU,SAAS,GAAG,IAAI,WAAW,EAAE,CAAC;AACpD,CAAC,CAAC;AAtBW,QAAA,gBAAgB,oBAsB3B;AAEF;;;GAGG;AACH,MAAM,sBAAsB,GAAG,CAAC,SAAiB,EAAU,EAAE;IAC3D,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACrE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,sBAAsB,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,CAAC;IAED,gDAAgD;IAChD,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC9E,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,sBAAsB,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,CAAC;IAED,yCAAyC;IACzC,OAAO,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAU,EAAE;IAClD,wDAAwD;IACxD,OAAO,QAAQ;SACZ,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACf,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CACzE;SACA,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC,CAAC"}

package/dist/domain.operations/git/getGitRemoteUrl.d.ts

@@ -0,0 +1,7 @@
+/**
+ * .what = extracts git remote origin url from repository
+ * .why = enables construction of github urls for citations
+ */
+export declare const getGitRemoteUrl: (input: {
+    cwd: string;
+}) => string;

package/dist/domain.operations/git/getGitRemoteUrl.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGitRemoteUrl = void 0;
+const child_process_1 = require("child_process");
+const helpful_errors_1 = require("helpful-errors");
+/**
+ * .what = extracts git remote origin url from repository
+ * .why = enables construction of github urls for citations
+ */
+const getGitRemoteUrl = (input) => {
+    // verify this is a git repository
+    try {
+        (0, child_process_1.execSync)('git rev-parse --git-dir', {
+            cwd: input.cwd,
+            stdio: 'pipe',
+        });
+    }
+    catch {
+        throw new helpful_errors_1.BadRequestError('directory is not a git repository', {
+            cwd: input.cwd,
+        });
+    }
+    // get remote origin url
+    try {
+        const result = (0, child_process_1.execSync)('git remote get-url origin', {
+            cwd: input.cwd,
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        });
+        return result.trim();
+    }
+    catch {
+        throw new helpful_errors_1.BadRequestError('git repository has no remote origin configured', {
+            cwd: input.cwd,
+            hint: 'run: git remote add origin <url>',
+        });
+    }
+};
+exports.getGitRemoteUrl = getGitRemoteUrl;
+//# sourceMappingURL=getGitRemoteUrl.js.map

package/dist/domain.operations/git/getGitRemoteUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getGitRemoteUrl.js","sourceRoot":"","sources":["../../../src/domain.operations/git/getGitRemoteUrl.ts"],"names":[],"mappings":";;;AAAA,iDAAyC;AACzC,mDAAiD;AAEjD;;;GAGG;AACI,MAAM,eAAe,GAAG,CAAC,KAAsB,EAAU,EAAE;IAChE,kCAAkC;IAClC,IAAI,CAAC;QACH,IAAA,wBAAQ,EAAC,yBAAyB,EAAE;YAClC,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,gCAAe,CAAC,mCAAmC,EAAE;YAC7D,GAAG,EAAE,KAAK,CAAC,GAAG;SACf,CAAC,CAAC;IACL,CAAC;IAED,wBAAwB;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,wBAAQ,EAAC,2BAA2B,EAAE;YACnD,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,gCAAe,CACvB,gDAAgD,EAChD;YACE,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,IAAI,EAAE,kCAAkC;SACzC,CACF,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AA9BW,QAAA,eAAe,mBA8B1B"}

package/dist/domain.operations/hooks/getInvokeHooks.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getInvokeHooks = void 0;
-const execTranslateDocOutputPath_1 = require("./execTranslateDocOutputPath");
+const execTranslateDocOutputPath_1 = require("../../domain.operations/hooks/execTranslateDocOutputPath");
 const getInvokeHooks = () => ({
     onInvokeAskInput: [
         (input) => {

package/dist/domain.operations/hooks/getInvokeHooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"getInvokeHooks.js","sourceRoot":"","sources":["../../../src/domain.operations/hooks/getInvokeHooks.ts"],"names":[],"mappings":";;;AAEA,6EAA0E;AAEnE,MAAM,cAAc,GAAG,GAAgB,EAAE,CAAC,CAAC;IAChD,gBAAgB,EAAE;QAChB,CAAC,KAAK,EAAE,EAAE;YACR,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC5B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,uDAA0B,EAAC,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,4BAA4B;KAC3F;CACF,CAAC,CAAC;AARU,QAAA,cAAc,kBAQxB"}
+{"version":3,"file":"getInvokeHooks.js","sourceRoot":"","sources":["../../../src/domain.operations/hooks/getInvokeHooks.ts"],"names":[],"mappings":";;;AAEA,wGAAqG;AAE9F,MAAM,cAAc,GAAG,GAAgB,EAAE,CAAC,CAAC;IAChD,gBAAgB,EAAE;QAChB,CAAC,KAAK,EAAE,EAAE;YACR,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC5B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,uDAA0B,EAAC,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,4BAA4B;KAC3F;CACF,CAAC,CAAC;AARU,QAAA,cAAc,kBAQxB"}

package/dist/domain.operations/reflect/createDraftDirectory.d.ts

@@ -0,0 +1,11 @@
+/**
+ * .what = creates draft directory structure for reflect output
+ * .why = organizes pure proposals, manifest, and blended sync output
+ */
+export declare const createDraftDirectory: (input: {
+    targetDir: string;
+}) => Promise<{
+    draftDir: string;
+    pureDir: string;
+    syncDir: string;
+}>;

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

@@ -0,0 +1,46 @@
+"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.createDraftDirectory = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+/**
+ * .what = creates draft directory structure for reflect output
+ * .why = organizes pure proposals, manifest, and blended sync output
+ */
+const createDraftDirectory = async (input) => {
+    // generate timestamp for unique draft directory
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    // create draft directory paths
+    const draftDir = path.join(input.targetDir, '.draft', `v${timestamp}`);
+    const pureDir = path.join(draftDir, 'pure');
+    const syncDir = path.join(draftDir, 'sync');
+    // create directories
+    await fs.mkdir(pureDir, { recursive: true });
+    await fs.mkdir(syncDir, { recursive: true });
+    return { draftDir, pureDir, syncDir };
+};
+exports.createDraftDirectory = createDraftDirectory;
+//# sourceMappingURL=createDraftDirectory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createDraftDirectory.js","sourceRoot":"","sources":["../../../src/domain.operations/reflect/createDraftDirectory.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAAkC;AAClC,2CAA6B;AAE7B;;;GAGG;AACI,MAAM,oBAAoB,GAAG,KAAK,EAAE,KAE1C,EAIE,EAAE;IACH,gDAAgD;IAChD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAEjE,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,SAAS,EAAE,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE5C,qBAAqB;IACrB,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACxC,CAAC,CAAC;AApBW,QAAA,oBAAoB,wBAoB/B"}

package/dist/domain.operations/reflect/enumFeedbackFiles.d.ts

@@ -0,0 +1,7 @@
+/**
+ * .what = enumerates feedback files matching [feedback].*.[given]* pattern
+ * .why = identifies all feedback to reflect upon in source directory
+ */
+export declare const enumFeedbackFiles: (input: {
+    directory: string;
+}) => Promise<string[]>;

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

@@ -0,0 +1,69 @@
+"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.enumFeedbackFiles = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+/**
+ * .what = enumerates feedback files matching [feedback].*.[given]* pattern
+ * .why = identifies all feedback to reflect upon in source directory
+ */
+const enumFeedbackFiles = async (input) => {
+    const feedbackFiles = [];
+    // recursive walk function
+    const walkDirectory = async (dir) => {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                // recurse into subdirectories
+                await walkDirectory(fullPath);
+            }
+            else if (entry.isFile()) {
+                // check if file matches feedback pattern
+                if (isFeedbackFile(entry.name)) {
+                    // return relative path from input directory
+                    feedbackFiles.push(path.relative(input.directory, fullPath));
+                }
+            }
+        }
+    };
+    await walkDirectory(input.directory);
+    // sort for deterministic output
+    return feedbackFiles.sort();
+};
+exports.enumFeedbackFiles = enumFeedbackFiles;
+/**
+ * .what = checks if filename matches [feedback].*.[given]* pattern
+ * .why = identifies feedback files by naming convention
+ */
+const isFeedbackFile = (filename) => {
+    // pattern: [feedback].*.[given]*
+    // e.g., [feedback].v1.[given].by_human.md
+    // e.g., execution.md.[feedback].v2.[given].by_human.md
+    const pattern = /\[feedback\]\..*\.\[given\]/i;
+    return pattern.test(filename);
+};
+//# sourceMappingURL=enumFeedbackFiles.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enumFeedbackFiles.js","sourceRoot":"","sources":["../../../src/domain.operations/reflect/enumFeedbackFiles.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAAkC;AAClC,2CAA6B;AAE7B;;;GAGG;AACI,MAAM,iBAAiB,GAAG,KAAK,EAAE,KAEvC,EAAqB,EAAE;IACtB,MAAM,aAAa,GAAa,EAAE,CAAC;IAEnC,0BAA0B;IAC1B,MAAM,aAAa,GAAG,KAAK,EAAE,GAAW,EAAiB,EAAE;QACzD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAE5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,8BAA8B;gBAC9B,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;YAChC,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,yCAAyC;gBACzC,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC/B,4CAA4C;oBAC5C,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAErC,gCAAgC;IAChC,OAAO,aAAa,CAAC,IAAI,EAAE,CAAC;AAC9B,CAAC,CAAC;AA7BW,QAAA,iBAAiB,qBA6B5B;AAEF;;;GAGG;AACH,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAW,EAAE;IACnD,iCAAiC;IACjC,0CAA0C;IAC1C,uDAAuD;IACvD,MAAM,OAAO,GAAG,8BAA8B,CAAC;IAC/C,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC,CAAC"}

package/dist/domain.operations/reflect/extractJsonFromResultText.d.ts

@@ -0,0 +1,7 @@
+/**
+ * .what = extracts JSON content from model response text
+ * .why = model may wrap JSON in markdown code blocks or inline backticks
+ */
+export declare const extractJsonFromResultText: (input: {
+    resultText: string;
+}) => string;

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

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractJsonFromResultText = void 0;
+/**
+ * .what = extracts JSON content from model response text
+ * .why = model may wrap JSON in markdown code blocks or inline backticks
+ */
+const extractJsonFromResultText = (input) => {
+    // try to extract from markdown code block first
+    const codeBlockMatch = input.resultText.match(/```(?:json)?\s*([\s\S]*?)```/);
+    if (codeBlockMatch) {
+        return codeBlockMatch[1].trim();
+    }
+    // strip inline backticks if present (model sometimes wraps JSON in single backticks)
+    const stripped = input.resultText.trim().replace(/^`|`$/g, '');
+    return stripped.trim();
+};
+exports.extractJsonFromResultText = extractJsonFromResultText;
+//# sourceMappingURL=extractJsonFromResultText.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractJsonFromResultText.js","sourceRoot":"","sources":["../../../src/domain.operations/reflect/extractJsonFromResultText.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACI,MAAM,yBAAyB,GAAG,CAAC,KAEzC,EAAU,EAAE;IACX,gDAAgD;IAChD,MAAM,cAAc,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC9E,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,cAAc,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;IACnC,CAAC;IAED,qFAAqF;IACrF,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAE/D,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC,CAAC;AAbW,QAAA,yBAAyB,6BAapC"}

package/dist/domain.operations/reflect/invokeClaudeCodeForReflect.d.ts

@@ -0,0 +1,46 @@
+/**
+ * .what = usage metrics from claude invocation
+ * .why = enables cost tracking and optimization
+ */
+export interface ReflectClaudeUsage {
+    input: number;
+    cacheWrite: number;
+    cacheRead: number;
+    output: number;
+}
+/**
+ * .what = result from step 1 claude invocation
+ * .why = contains proposed rules as structured JSON
+ */
+export interface ReflectStep1Response {
+    rules: Array<{
+        name: string;
+        content: string;
+    }>;
+}
+/**
+ * .what = result from step 2 claude invocation
+ * .why = contains manifest operations as JSON
+ */
+export interface ReflectStep2Response {
+    timestamp: string;
+    pureRules: Array<{
+        path: string;
+        operation: string;
+        syncPath?: string;
+        existingPath?: string;
+        reason?: string;
+    }>;
+}
+/**
+ * .what = invokes claude-code cli for reflect step
+ * .why = executes brain invocation via claude-code print mode
+ */
+export declare const invokeClaudeCodeForReflect: <T>(input: {
+    prompt: string;
+    cwd?: string;
+    rapid?: boolean;
+}) => Promise<{
+    response: T;
+    usage: ReflectClaudeUsage;
+}>;