rhachet-roles-bhrain 0.2.0 → 0.5.1

package/dist/roles/reviewer/getReviewerRole.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_REVIEWER = void 0;
+const rhachet_1 = require("rhachet");
+/**
+ * .what = reviewer role definition
+ * .why = enables code review against declared rules via brain invocation
+ */
+exports.ROLE_REVIEWER = rhachet_1.Role.build({
+    slug: 'reviewer',
+    name: 'Reviewer',
+    purpose: 'review artifacts against declared rules',
+    readme: `
+## 🔍 Reviewer
+
+- **scale**: repo-level, artifact quality
+- **focus**: rule compliance, best practices enforcement
+- **maximizes**: artifact quality and consistency
+
+used to review artifacts against declared rules and best practices.
+invokes claude-code brain to perform intelligent review.
+designed to be composed into review skills for other roles.
+
+### usage
+
+\`\`\`sh
+npx rhachet run --repo bhrain --skill review --mode hard --diffs uptil-main --paths '!pnpm-lock.yaml'
+\`\`\`
+
+produces
+
+\`\`\`
+🌊 skill "review" from repo=bhrain role=reviewer
+
+🔭 metrics.expected
+   ├─ files
+   │  ├─ rules: 60
+   │  └─ targets: 69
+   ├─ tokens
+   │  ├─ estimate: 73122
+   │  └─ context: 36.6%
+   └─ cost
+      └─ estimate: $0.3290
+
+🪵 logs
+   ├─ scope: .log/bhrain/review/2025-12-23T00-39-00-673Z/input.scope.json
+   ├─ metrics: .log/bhrain/review/2025-12-23T00-39-00-673Z/metrics.expected.json
+   └─ tokens: .log/bhrain/review/2025-12-23T00-39-00-673Z/tokens.expected.md
+
+🐢 let's review!
+   └─ elapsed: 85s ✓
+
+✨ metrics.realized
+   ├─ tokens
+   │  ├─ input: 2
+   │  ├─ cache.write: 144578
+   │  ├─ cache.read: 14316
+   │  └─ output: 1090
+   └─ cost
+      ├─ input: $0.0000
+      ├─ cache.write: $0.5422
+      ├─ cache.read: $0.0043
+      ├─ output: $0.0164
+      └─ total: $0.5629
+
+🌊 output
+   ├─ logs: .log/bhrain/review/2025-12-23T00-39-00-673Z
+   └─ review: .review/bhrain/v2025-12-23T00-39-00-645Z/[feedback].[given].by_robot.md
+\`\`\`
+  `.trim(),
+    traits: [],
+    skills: {
+        dirs: [{ uri: __dirname + '/skills' }],
+        refs: [],
+    },
+    briefs: {
+        dirs: [{ uri: __dirname + '/briefs' }],
+    },
+});
+//# sourceMappingURL=getReviewerRole.js.map

package/dist/roles/reviewer/getReviewerRole.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getReviewerRole.js","sourceRoot":"","sources":["../../../src/roles/reviewer/getReviewerRole.ts"],"names":[],"mappings":";;;AAAA,qCAA+B;AAE/B;;;GAGG;AACU,QAAA,aAAa,GAAS,cAAI,CAAC,KAAK,CAAC;IAC5C,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,yCAAyC;IAClD,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDP,CAAC,IAAI,EAAE;IACR,MAAM,EAAE,EAAE;IACV,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;QACtC,IAAI,EAAE,EAAE;KACT;IACD,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;KACvC;CACF,CAAC,CAAC"}

package/dist/roles/reviewer/skills/reflect/reflect.d.ts

@@ -0,0 +1,30 @@
+import type { ReviewerReflectMetrics } from '../../../../domain.objects/Reviewer/ReviewerReflectMetrics';
+/**
+ * .what = result of stepReflect execution
+ * .why = enables caller to inspect reflect outcome and artifacts
+ */
+export type StepReflectResult = {
+    draft: {
+        dir: string;
+        pureDir: string;
+        syncDir: string;
+    };
+    results: {
+        created: number;
+        updated: number;
+        appended: number;
+        omitted: number;
+    };
+    metrics: ReviewerReflectMetrics;
+};
+/**
+ * .what = extracts rules from feedback and proposes them to target
+ * .why = core orchestration flow for reviewer.reflect skill
+ */
+export declare const stepReflect: (input: {
+    source: string;
+    target: string;
+    mode?: 'soft' | 'hard';
+    force?: boolean;
+    rapid?: boolean;
+}) => Promise<StepReflectResult>;

package/dist/roles/reviewer/skills/reflect/reflect.js

@@ -0,0 +1,305 @@
+"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.stepReflect = void 0;
+const fs = __importStar(require("fs/promises"));
+const helpful_errors_1 = require("helpful-errors");
+const path = __importStar(require("path"));
+const getGitRemoteUrl_1 = require("../../../../domain.operations/git/getGitRemoteUrl");
+const createDraftDirectory_1 = require("../../../../domain.operations/reflect/createDraftDirectory");
+const invokeClaudeCodeForReflect_1 = require("../../../../domain.operations/reflect/invokeClaudeCodeForReflect");
+const computeMetricsExpected_1 = require("../../../../domain.operations/reflect/metrics/computeMetricsExpected");
+const computeMetricsRealized_1 = require("../../../../domain.operations/reflect/metrics/computeMetricsRealized");
+const writeLogArtifact_1 = require("../../../../domain.operations/reflect/metrics/writeLogArtifact");
+const compileCitationsMarkdown_1 = require("../../../../domain.operations/reflect/step1/compileCitationsMarkdown");
+const compileReflectStep1Prompt_1 = require("../../../../domain.operations/reflect/step1/compileReflectStep1Prompt");
+const compileReflectStep2Prompt_1 = require("../../../../domain.operations/reflect/step2/compileReflectStep2Prompt");
+const executeManifestOperations_1 = require("../../../../domain.operations/reflect/step2/executeManifestOperations");
+const parseManifestOperations_1 = require("../../../../domain.operations/reflect/step2/parseManifestOperations");
+const validateSourceDirectory_1 = require("../../../../domain.operations/reflect/validateSourceDirectory");
+const validateTargetDirectory_1 = require("../../../../domain.operations/reflect/validateTargetDirectory");
+/**
+ * .what = generates ISO timestamp for log directory naming
+ * .why = enables unique, sortable log directories
+ */
+const genLogTimestamp = () => {
+    return new Date().toISOString().replace(/[:.]/g, '-');
+};
+/**
+ * .what = simple spinner for CLI feedback
+ * .why = shows progress during long-running operations
+ */
+const withSpinner = async (input) => {
+    const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    const startTime = Date.now();
+    let i = 0;
+    // print title once
+    console.log(input.message);
+    // render only the elapsed time branch line
+    const render = (frame) => {
+        const elapsed = Math.floor((Date.now() - startTime) / 1000);
+        process.stdout.write(`\r   └─ elapsed: ${elapsed}s ${frame}  `);
+    };
+    render(frames[0]);
+    const interval = setInterval(() => {
+        i = (i + 1) % frames.length;
+        render(frames[i]);
+    }, 100);
+    try {
+        const result = await input.operation();
+        clearInterval(interval);
+        const elapsed = Math.floor((Date.now() - startTime) / 1000);
+        process.stdout.write(`\r   └─ elapsed: ${elapsed}s ✓\n\n`);
+        return result;
+    }
+    catch (error) {
+        clearInterval(interval);
+        const elapsed = Math.floor((Date.now() - startTime) / 1000);
+        process.stdout.write(`\r   └─ elapsed: ${elapsed}s ✗\n`);
+        throw error;
+    }
+};
+/**
+ * .what = extracts rules from feedback and proposes them to target
+ * .why = core orchestration flow for reviewer.reflect skill
+ */
+const stepReflect = async (input) => {
+    const mode = input.mode ?? 'soft';
+    const force = input.force ?? false;
+    const rapid = input.rapid ?? false;
+    // validate source directory and get feedback files
+    const { feedbackFiles } = await (0, validateSourceDirectory_1.validateSourceDirectory)({
+        source: input.source,
+    });
+    // validate target directory
+    await (0, validateTargetDirectory_1.validateTargetDirectory)({ target: input.target, force });
+    // get git remote url for citations
+    const remoteUrl = (0, getGitRemoteUrl_1.getGitRemoteUrl)({ cwd: input.source });
+    if (!remoteUrl) {
+        throw new helpful_errors_1.BadRequestError('source directory must be a git repository with remote origin', { source: input.source });
+    }
+    // create draft directory
+    const { draftDir, pureDir, syncDir } = await (0, createDraftDirectory_1.createDraftDirectory)({
+        targetDir: input.target,
+    });
+    // compile citations markdown
+    const citationsMarkdown = (0, compileCitationsMarkdown_1.compileCitationsMarkdown)({
+        feedbackFiles,
+        cwd: input.source,
+    });
+    // write citations.md to draft directory
+    await fs.writeFile(path.join(draftDir, 'citations.md'), citationsMarkdown, 'utf-8');
+    // compile step 1 prompt
+    const step1Prompt = await (0, compileReflectStep1Prompt_1.compileReflectStep1Prompt)({
+        feedbackFiles,
+        citationsMarkdown,
+        draftDir,
+        cwd: input.source,
+        mode,
+    });
+    // compute expected metrics
+    const step2PromptResult = await (0, compileReflectStep2Prompt_1.compileReflectStep2Prompt)({
+        targetDir: input.target,
+        draftDir,
+        pureDir,
+        mode,
+        rapid,
+    });
+    const expected = (0, computeMetricsExpected_1.computeMetricsExpected)({
+        step1PromptTokens: step1Prompt.tokenEstimate,
+        step2PromptTokens: step2PromptResult.tokenEstimate,
+    });
+    // emit metrics.expected
+    console.log(`
+🔭 metrics.expected
+   ├─ files
+   │  └─ feedback: ${feedbackFiles.length}
+   ├─ tokens
+   │  ├─ estimate: ${expected.tokens.toLocaleString()}
+   │  └─ context: ${expected.contextWindowPercent}%
+   └─ cost
+      └─ estimate: $${expected.cost.toFixed(4)}
+`.trim());
+    // step 1: propose pure rules
+    console.log('');
+    const step1Result = await withSpinner({
+        message: '⛏️  step 1: propose pure rules from feedback...',
+        operation: async () => {
+            // invoke claude-code with step 1 prompt
+            // model writes rules directly to pureDir via Write tool
+            const { response, usage } = await (0, invokeClaudeCodeForReflect_1.invokeClaudeCodeForReflect)({
+                prompt: step1Prompt.prompt,
+                cwd: input.source,
+                rapid,
+            });
+            // count rules written by enumerating pureDir
+            const pureFiles = await fs.readdir(pureDir).catch(() => []);
+            const rulesProposed = pureFiles.filter((f) => f.startsWith('rule.')).length;
+            return {
+                tokens: usage,
+                rulesProposed: rulesProposed || response.rules?.length || 0,
+            };
+        },
+    });
+    // re-compile step 2 prompt with actual pure rules
+    const step2PromptFinal = await (0, compileReflectStep2Prompt_1.compileReflectStep2Prompt)({
+        targetDir: input.target,
+        draftDir,
+        pureDir,
+        mode,
+        rapid,
+    });
+    // step 2: blend proposals with existing rules
+    const step2Result = await withSpinner({
+        message: '🪨 step 2: blend proposals with existing rules...',
+        operation: async () => {
+            // invoke claude-code with step 2 prompt
+            // note: model writes manifest.json directly via Write tool
+            const { usage } = await (0, invokeClaudeCodeForReflect_1.invokeClaudeCodeForReflect)({
+                prompt: step2PromptFinal.prompt,
+                cwd: input.target,
+                rapid,
+            });
+            // read the manifest written by the model
+            const manifestPath = path.join(draftDir, 'manifest.json');
+            const manifestContent = await fs.readFile(manifestPath, 'utf-8');
+            return {
+                tokens: usage,
+                manifestContent,
+            };
+        },
+    });
+    // parse manifest operations
+    const manifest = (0, parseManifestOperations_1.parseManifestOperations)({
+        content: step2Result.manifestContent,
+    });
+    // execute manifest operations
+    const blendResults = await (0, executeManifestOperations_1.executeManifestOperations)({
+        manifest,
+        pureDir,
+        syncDir,
+        targetDir: input.target,
+        log: console,
+    });
+    // compute realized metrics
+    const realized = (0, computeMetricsRealized_1.computeMetricsRealized)({
+        step1: { tokens: step1Result.tokens },
+        step2: { tokens: step2Result.tokens },
+    });
+    // build full metrics object
+    const metrics = {
+        files: {
+            feedbackCount: feedbackFiles.length,
+            rulesCount: blendResults.created + blendResults.updated + blendResults.appended,
+        },
+        expected,
+        realized,
+    };
+    // write log artifact
+    await (0, writeLogArtifact_1.writeLogArtifact)({
+        draftDir,
+        metrics,
+        results: blendResults,
+    });
+    // emit metrics.realized
+    console.log(`
+✨ metrics.realized
+   ├─ tokens
+   │  ├─ input: ${realized.total.tokens.input.toLocaleString()}
+   │  └─ output: ${realized.total.tokens.output.toLocaleString()}
+   └─ cost
+      └─ total: $${realized.total.cost.total.toFixed(4)}
+
+🌊 output
+   ├─ draft: ${draftDir.startsWith(process.cwd()) ? path.relative(process.cwd(), draftDir) : draftDir}
+   ├─ pure: ${pureDir.startsWith(process.cwd()) ? path.relative(process.cwd(), pureDir) : pureDir}
+   └─ sync: ${syncDir.startsWith(process.cwd()) ? path.relative(process.cwd(), syncDir) : syncDir}
+
+🪨 results
+   ├─ created: ${blendResults.created}
+   ├─ updated: ${blendResults.updated}
+   ├─ appended: ${blendResults.appended}
+   └─ omitted: ${blendResults.omitted}
+`.trim());
+    return {
+        draft: {
+            dir: draftDir,
+            pureDir,
+            syncDir,
+        },
+        results: blendResults,
+        metrics,
+    };
+};
+exports.stepReflect = stepReflect;
+/**
+ * .what = CLI entrypoint when run directly
+ * .why = enables ./reflect.sh to invoke this module
+ */
+if (require.main === module) {
+    // parse command line arguments
+    const args = process.argv.slice(2);
+    const parsed = {};
+    for (let i = 0; i < args.length; i += 2) {
+        const key = args[i]?.replace(/^--/, '');
+        const value = args[i + 1];
+        if (key && value)
+            parsed[key] = value;
+    }
+    // validate required arguments
+    if (!parsed.source) {
+        console.error('⛈️ error: --source is required');
+        process.exit(1);
+    }
+    if (!parsed.target) {
+        console.error('⛈️ error: --target is required');
+        process.exit(1);
+    }
+    // parse optional arguments
+    const mode = parsed.mode ?? 'soft';
+    const force = parsed.force === 'true';
+    const rapid = parsed.rapid === 'true';
+    // execute reflect
+    void (async () => {
+        try {
+            await (0, exports.stepReflect)({
+                source: parsed.source,
+                target: parsed.target,
+                mode,
+                force,
+                rapid,
+            });
+        }
+        catch (error) {
+            if (error instanceof helpful_errors_1.BadRequestError) {
+                console.error(`\n⛈️ error: ${error.message}`);
+                process.exit(1);
+            }
+            console.error('⛈️ unexpected error:', error);
+            process.exit(1);
+        }
+    })();
+}
+//# sourceMappingURL=reflect.js.map

package/dist/roles/reviewer/skills/reflect/reflect.js.map

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

package/dist/roles/reviewer/skills/reflect/reflect.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+######################################################################
+# .what = shell wrapper for reviewer.reflect skill
+#
+# .why  = enables direct invocation from command line
+#         - extracts rules from feedback files
+#         - proposes rules into target directory
+#         - blends proposals with existing rules
+#
+# usage:
+#   reflect.sh --source /path/to/feedback/repo --target /path/to/rules/dir
+#   reflect.sh --source . --target ./briefs/practices --mode hard
+#   reflect.sh --source . --target ./briefs/practices --force
+#
+# guarantee:
+#   - validates source directory exists and has feedback
+#   - validates target directory exists (or creates with --force)
+#   - creates draft directory with pure/, sync/, manifest.json
+#   - fail-fast on errors
+######################################################################
+
+set -euo pipefail
+
+# resolve script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# find repo root (go up until we find package.json)
+REPO_ROOT="$SCRIPT_DIR"
+while [[ ! -f "$REPO_ROOT/package.json" ]]; do
+  REPO_ROOT="$(dirname "$REPO_ROOT")"
+  if [[ "$REPO_ROOT" == "/" ]]; then
+    echo "⛈️ error: could not find package.json in parent directories"
+    exit 1
+  fi
+done
+
+# execute typescript skill via npx tsx
+exec npx tsx "$SCRIPT_DIR/reflect.ts" "$@"