rhachet-roles-bhrain 0.7.4 → 0.7.5

package/dist/contract/cli/reflect.d.ts

@@ -0,0 +1,8 @@
+/**
+ * .what = cli entrypoint for reflect skill
+ * .why = enables shell invocation via package-level import
+ *
+ * .note = this is a SKILL entrypoint, not a public api
+ *         brain packages are imported here because skill users have them installed
+ */
+export declare const reflect: () => Promise<void>;

package/dist/contract/cli/reflect.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reflect = void 0;
+const rhachet_1 = require("rhachet");
+const rhachet_brains_anthropic_1 = require("rhachet-brains-anthropic");
+const rhachet_brains_openai_1 = require("rhachet-brains-openai");
+const rhachet_brains_xai_1 = require("rhachet-brains-xai");
+const stepReflect_1 = require("../../domain.operations/reflect/stepReflect");
+/**
+ * .what = default brain for reflect skill
+ * .why = anthropic/claude/sonnet-4 is effective for rule extraction and synthesis
+ */
+const DEFAULT_BRAIN = 'anthropic/claude/sonnet-4';
+/**
+ * .what = loads all available brain atoms from installed packages
+ * .why = enables enumeration of available brains for lookup
+ */
+const loadAllAtoms = () => {
+    return [
+        ...(0, rhachet_brains_xai_1.getBrainAtomsByXAI)(),
+        ...(0, rhachet_brains_anthropic_1.getBrainAtomsByAnthropic)(),
+        ...(0, rhachet_brains_openai_1.getBrainAtomsByOpenAI)(),
+    ];
+};
+/**
+ * .what = loads all available brain repls from installed packages
+ * .why = enables enumeration of available brains for lookup
+ */
+const loadAllRepls = () => {
+    return [...(0, rhachet_brains_anthropic_1.getBrainReplsByAnthropic)(), ...(0, rhachet_brains_openai_1.getBrainReplsByOpenAI)()];
+};
+/**
+ * .what = prints help message with available brains
+ * .why = enables users to discover available brain options
+ */
+const printHelp = (input) => {
+    const brainsInWords = (0, rhachet_1.getAvailableBrainsInWords)({
+        atoms: input.atoms,
+        repls: input.repls,
+        choice: '',
+    });
+    console.log(`
+reflect - extract rules from feedback and propose to target
+
+usage:
+  reflect.sh [options]
+
+options:
+  --source <path>     source directory with feedback files (required)
+  --target <path>     target directory for rules (required)
+  --mode <mode>       reflect mode: push or pull (default: pull)
+  --force             create target directory if it does not exist
+  --brain <slug>      brain to use for reflection (default: ${DEFAULT_BRAIN})
+  --help              show this help message
+
+${brainsInWords}
+`.trim());
+};
+/**
+ * .what = checks if help flag is present in args
+ * .why = enables early exit for help display
+ */
+const hasHelpFlag = (argv) => {
+    return argv.includes('--help') || argv.includes('-h');
+};
+/**
+ * .what = detects if node was invoked via `node -e "code"` (eval mode)
+ * .why = in eval mode, argv has no entrypoint path: [node, firstArg, ...]
+ *        in normal mode, argv has entrypoint path: [node, file.js, firstArg, ...]
+ *        we skip different counts to slice argv correctly
+ */
+const isNodeEvalMode = (argv) => {
+    // in eval mode, argv[1] is the first user arg (e.g., --source), not an entrypoint path
+    // entrypoint paths end with .js, .ts, .mjs, etc. and don't start with --
+    const secondArg = argv[1];
+    if (!secondArg)
+        return false;
+    const looksLikeEntrypointPath = /\.(js|ts|mjs|cjs)$/.test(secondArg) || !secondArg.startsWith('--');
+    return !looksLikeEntrypointPath;
+};
+/**
+ * .what = parses cli args into options object
+ * .why = simple arg parser without external dependencies
+ */
+const parseArgs = (argv) => {
+    // skip node binary (always argv[0]) and entrypoint path (only in normal mode)
+    const skipCount = isNodeEvalMode(argv) ? 1 : 2;
+    const args = argv.slice(skipCount).filter((arg) => arg !== '--');
+    const options = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg)
+            continue;
+        if (arg.startsWith('--')) {
+            const key = arg.slice(2);
+            // handle boolean flags
+            if (key === 'force') {
+                options[key] = true;
+                continue;
+            }
+            const value = args[i + 1];
+            if (value && !value.startsWith('--')) {
+                options[key] = value;
+                i++;
+            }
+        }
+    }
+    return {
+        source: options.source,
+        target: options.target,
+        mode: options.mode ?? 'pull',
+        force: options.force ?? false,
+        brain: options.brain ?? DEFAULT_BRAIN,
+    };
+};
+/**
+ * .what = cli entrypoint for reflect skill
+ * .why = enables shell invocation via package-level import
+ *
+ * .note = this is a SKILL entrypoint, not a public api
+ *         brain packages are imported here because skill users have them installed
+ */
+const reflect = async () => {
+    // load brains early for help display
+    const atoms = loadAllAtoms();
+    const repls = loadAllRepls();
+    // handle --help flag
+    if (hasHelpFlag(process.argv)) {
+        printHelp({ atoms, repls });
+        return;
+    }
+    // parse args and create brain context
+    const options = parseArgs(process.argv);
+    const brain = (0, rhachet_1.genContextBrain)({
+        atoms,
+        repls,
+        choice: options.brain,
+    });
+    // invoke stepReflect
+    await (0, stepReflect_1.stepReflect)({
+        source: options.source,
+        target: options.target,
+        mode: options.mode,
+        force: options.force,
+    }, { brain });
+};
+exports.reflect = reflect;
+//# sourceMappingURL=reflect.js.map

package/dist/contract/cli/reflect.js.map

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

package/dist/{domain.roles/reviewer/skills/review.cli.d.ts → contract/cli/review.d.ts}

@@ -1,6 +1,6 @@
 /**
  * .what = cli entrypoint for review skill
- * .why = enables shell invocation via review.sh
+ * .why = enables shell invocation via package-level import
  *
  * .note = this is a SKILL entrypoint, not a public api
  *         brain packages are imported here because skill users have them installed

package/dist/{domain.roles/reviewer/skills/review.cli.js → contract/cli/review.js}

@@ -5,7 +5,7 @@ const rhachet_1 = require("rhachet");
 const rhachet_brains_anthropic_1 = require("rhachet-brains-anthropic");
 const rhachet_brains_openai_1 = require("rhachet-brains-openai");
 const rhachet_brains_xai_1 = require("rhachet-brains-xai");
-const stepReview_1 = require("../../../domain.operations/review/stepReview");
+const stepReview_1 = require("../../domain.operations/review/stepReview");
 /**
  * .what = default brain for review skill
  * .why = xai/grok/code-fast-1 is fast, cheap, and effective for code review
@@ -83,7 +83,7 @@ const isNodeEvalMode = (argv) => {
 };
 /**
  * .what = parses cli args into options object
- * .why = simple arg parse without external dependencies
+ * .why = simple arg parser without external dependencies
  */
 const parseArgs = (argv) => {
     // skip node binary (always argv[0]) and script path (only in normal mode)
@@ -125,7 +125,7 @@ const parseArgs = (argv) => {
 };
 /**
  * .what = cli entrypoint for review skill
- * .why = enables shell invocation via review.sh
+ * .why = enables shell invocation via package-level import
  *
  * .note = this is a SKILL entrypoint, not a public api
  *         brain packages are imported here because skill users have them installed
@@ -158,4 +158,4 @@ const review = async () => {
     }, { brain });
 };
 exports.review = review;
-//# sourceMappingURL=review.cli.js.map
+//# sourceMappingURL=review.js.map

package/dist/contract/cli/review.js.map

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

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

@@ -19,4 +19,4 @@
 
 set -euo pipefail
 
-exec npx tsx -e "import('rhachet-roles-bhrain').then(m => m.cli.reflect())" -- "$@"
+exec node -e "import('rhachet-roles-bhrain').then(m => m.cli.reflect())" -- "$@"

package/dist/domain.roles/reviewer/skills/review.sh

@@ -17,5 +17,4 @@
 ######################################################################
 set -euo pipefail
 
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-exec node -e "import('$SCRIPT_DIR/review.cli.js').then(m => m.review())" -- "$@"
+exec node -e "import('rhachet-roles-bhrain').then(m => m.cli.review())" -- "$@"

package/dist/index.d.ts

@@ -3,3 +3,7 @@ export type { StepReflectResult } from './domain.operations/reflect/stepReflect'
 export { stepReflect } from './domain.operations/reflect/stepReflect';
 export type { StepReviewResult } from './domain.operations/review/stepReview';
 export { stepReview } from './domain.operations/review/stepReview';
+export declare const cli: {
+    review: () => Promise<void>;
+    reflect: () => Promise<void>;
+};

package/dist/index.js

@@ -14,11 +14,18 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.stepReview = exports.stepReflect = void 0;
+exports.cli = exports.stepReview = exports.stepReflect = void 0;
 __exportStar(require("./contract/sdk"), exports);
 // domain operations for consumers who provide their own brain context
 var stepReflect_1 = require("./domain.operations/reflect/stepReflect");
 Object.defineProperty(exports, "stepReflect", { enumerable: true, get: function () { return stepReflect_1.stepReflect; } });
 var stepReview_1 = require("./domain.operations/review/stepReview");
 Object.defineProperty(exports, "stepReview", { enumerable: true, get: function () { return stepReview_1.stepReview; } });
+const reflect_1 = require("./contract/cli/reflect");
+// cli entry points for portable skill dispatch
+const review_1 = require("./contract/cli/review");
+exports.cli = {
+    review: review_1.review,
+    reflect: reflect_1.reflect,
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oDAAkC;AAElC,sEAAsE;AACtE,0EAAyE;AAAhE,0GAAA,WAAW,OAAA;AAEpB,uEAAsE;AAA7D,wGAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oDAAkC;AAElC,sEAAsE;AACtE,0EAAyE;AAAhE,0GAAA,WAAW,OAAA;AAEpB,uEAAsE;AAA7D,wGAAA,UAAU,OAAA;AAEnB,uDAAoD;AACpD,+CAA+C;AAC/C,qDAAkD;AAErC,QAAA,GAAG,GAAG;IACjB,MAAM,EAAN,eAAM;IACN,OAAO,EAAP,iBAAO;CACR,CAAC"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "rhachet-roles-bhrain",
   "author": "ehmpathy",
   "description": "reliable thought concept navigation roles, briefs, and skills, via rhachet",
-  "version": "0.7.4",
+  "version": "0.7.5",
   "repository": "ehmpathy/rhachet-roles-bhrain",
   "homepage": "https://github.com/ehmpathy/rhachet-roles-bhrain",
   "keywords": [

package/dist/domain.roles/reviewer/skills/review.cli.js.map

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

package/dist/domain.roles/reviewer/skills/review.cli.ts

@@ -1,197 +0,0 @@
-import {
-  type BrainAtom,
-  type BrainRepl,
-  genContextBrain,
-  getAvailableBrainsInWords,
-} from 'rhachet';
-import {
-  getBrainAtomsByAnthropic,
-  getBrainReplsByAnthropic,
-} from 'rhachet-brains-anthropic';
-import {
-  getBrainAtomsByOpenAI,
-  getBrainReplsByOpenAI,
-} from 'rhachet-brains-openai';
-import { getBrainAtomsByXAI } from 'rhachet-brains-xai';
-
-import { stepReview } from '@src/domain.operations/review/stepReview';
-
-/**
- * .what = default brain for review skill
- * .why = xai/grok/code-fast-1 is fast, cheap, and effective for code review
- */
-const DEFAULT_BRAIN = 'xai/grok/code-fast-1';
-
-/**
- * .what = loads all available brain atoms from installed packages
- * .why = enables enumeration of available brains for lookup
- */
-const loadAllAtoms = (): BrainAtom[] => {
-  return [
-    ...getBrainAtomsByXAI(),
-    ...getBrainAtomsByAnthropic(),
-    ...getBrainAtomsByOpenAI(),
-  ];
-};
-
-/**
- * .what = loads all available brain repls from installed packages
- * .why = enables enumeration of available brains for lookup
- */
-const loadAllRepls = (): BrainRepl[] => {
-  return [...getBrainReplsByAnthropic(), ...getBrainReplsByOpenAI()];
-};
-
-/**
- * .what = prints help message with available brains
- * .why = enables users to discover available brain options
- */
-const printHelp = (input: { atoms: BrainAtom[]; repls: BrainRepl[] }): void => {
-  const brainsInWords = getAvailableBrainsInWords({
-    atoms: input.atoms,
-    repls: input.repls,
-    choice: '',
-  });
-
-  console.log(
-    `
-review - code review against rules
-
-usage:
-  review.sh [options]
-
-options:
-  --rules <globs>     glob pattern(s) for rule files (required)
-  --paths <globs>     glob pattern(s) for target files
-  --diffs <range>     diff range: uptil-main, uptil-commit, uptil-staged
-  --refs <globs>      glob pattern(s) for reference files (can repeat)
-  --output <path>     output file path for the review (required)
-  --mode <mode>       review mode: push or pull (default: push)
-  --goal <goal>       review goal: exhaustive or representative (default: representative)
-  --brain <slug>      brain to use for review (default: ${DEFAULT_BRAIN})
-  --help              show this help message
-
-${brainsInWords}
-`.trim(),
-  );
-};
-
-/**
- * .what = checks if help flag is present in args
- * .why = enables early exit for help display
- */
-const hasHelpFlag = (argv: string[]): boolean => {
-  return argv.includes('--help') || argv.includes('-h');
-};
-
-/**
- * .what = detects if node was invoked via `node -e "code"` (eval mode)
- * .why = in eval mode, argv has no script path: [node, firstArg, ...]
- *        in normal mode, argv has script path: [node, script.js, firstArg, ...]
- *        we need to skip different counts when slicing argv
- */
-const isNodeEvalMode = (argv: string[]): boolean => {
-  // in eval mode, argv[1] is the first user arg (e.g., --rules), not a script path
-  // script paths end with .js, .ts, .mjs, etc. and don't start with --
-  const secondArg = argv[1];
-  if (!secondArg) return false;
-  const looksLikeScriptPath =
-    /\.(js|ts|mjs|cjs)$/.test(secondArg) || !secondArg.startsWith('--');
-  return !looksLikeScriptPath;
-};
-
-/**
- * .what = parses cli args into options object
- * .why = simple arg parse without external dependencies
- */
-const parseArgs = (
-  argv: string[],
-): {
-  rules: string;
-  diffs: string | undefined;
-  paths: string | undefined;
-  refs: string[] | undefined;
-  output: string;
-  mode: 'push' | 'pull';
-  goal: 'exhaustive' | 'representative';
-  brain: string;
-} => {
-  // skip node binary (always argv[0]) and script path (only in normal mode)
-  const skipCount = isNodeEvalMode(argv) ? 1 : 2;
-  const args = argv.slice(skipCount).filter((arg) => arg !== '--');
-  const options: Record<string, string | string[]> = {};
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (!arg) continue;
-
-    if (arg.startsWith('--')) {
-      const key = arg.slice(2);
-      const value = args[i + 1];
-
-      // handle --refs which can be specified multiple times
-      if (key === 'refs') {
-        if (!options.refs) options.refs = [];
-        if (value && !value.startsWith('--')) {
-          (options.refs as string[]).push(value);
-          i++;
-        }
-      } else if (value && !value.startsWith('--')) {
-        options[key] = value;
-        i++;
-      }
-    }
-  }
-
-  return {
-    rules: options.rules as string,
-    diffs: options.diffs as string | undefined,
-    paths: options.paths as string | undefined,
-    refs: options.refs as string[] | undefined,
-    output: options.output as string,
-    mode: (options.mode as 'push' | 'pull') ?? 'push',
-    goal: (options.goal as 'exhaustive' | 'representative') ?? 'representative',
-    brain: (options.brain as string) ?? DEFAULT_BRAIN,
-  };
-};
-
-/**
- * .what = cli entrypoint for review skill
- * .why = enables shell invocation via review.sh
- *
- * .note = this is a SKILL entrypoint, not a public api
- *         brain packages are imported here because skill users have them installed
- */
-export const review = async (): Promise<void> => {
-  // load brains early for help display
-  const atoms = loadAllAtoms();
-  const repls = loadAllRepls();
-
-  // handle --help flag
-  if (hasHelpFlag(process.argv)) {
-    printHelp({ atoms, repls });
-    return;
-  }
-
-  // parse args and create brain context
-  const options = parseArgs(process.argv);
-  const brain = genContextBrain({
-    atoms,
-    repls,
-    choice: options.brain,
-  });
-
-  // invoke stepReview
-  await stepReview(
-    {
-      rules: options.rules,
-      diffs: options.diffs,
-      paths: options.paths,
-      refs: options.refs,
-      output: options.output,
-      mode: options.mode,
-      goal: options.goal,
-    },
-    { brain },
-  );
-};