rhachet 1.14.0 → 1.15.0

package/dist/contract/cli/invoke.js

@@ -14,6 +14,7 @@ const invokeInit_1 = require("./invokeInit");
 const invokeList_1 = require("./invokeList");
 const invokeReadme_1 = require("./invokeReadme");
 const invokeRoles_1 = require("./invokeRoles");
+const invokeRun_1 = require("./invokeRun");
 /**
  * .what = main entrypoint for CLI execution
  * .why =
@@ -25,7 +26,8 @@ const invokeRoles_1 = require("./invokeRoles");
  */
 const invoke = async (input) => {
     // treat init command specially - it's purpose is to run before configs exists
-    if (input.args.includes('init')) {
+    // note: only the bare 'init' command, not 'roles init' which requires config
+    if (input.args[0] === 'init') {
         const program = new commander_1.Command();
         program.name('rhachet');
         (0, invokeInit_1.invokeInit)({ program });
@@ -63,6 +65,7 @@ const invoke = async (input) => {
     (0, invokeReadme_1.invokeReadme)({ program, registries });
     (0, invokeList_1.invokeList)({ program, registries });
     (0, invokeRoles_1.invokeRoles)({ program, registries });
+    (0, invokeRun_1.invokeRun)({ program });
     (0, invokeChoose_1.invokeChoose)({ program });
     (0, invokeAsk_1.invokeAsk)({ program, config: { path: configPath }, registries, hooks });
     // invoke it

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

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

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

@@ -0,0 +1,8 @@
+import type { Command } from 'commander';
+/**
+ * .what = adds the "run" command to the CLI
+ * .why = discovers and executes skills from linked role directories
+ */
+export declare const invokeRun: ({ program }: {
+    program: Command;
+}) => void;

package/dist/contract/cli/invokeRun.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeRun = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const executeSkill_1 = require("../../domain.operations/invoke/executeSkill");
+const findUniqueSkillExecutable_1 = require("../../domain.operations/invoke/findUniqueSkillExecutable");
+/**
+ * .what = extracts all args after 'run' command from process.argv
+ * .why = captures full arg list for passthrough to skill
+ */
+const getRawArgsAfterRun = () => {
+    const argv = process.argv;
+    const runIdx = argv.indexOf('run');
+    if (runIdx === -1)
+        return [];
+    return argv.slice(runIdx + 1);
+};
+/**
+ * .what = adds the "run" command to the CLI
+ * .why = discovers and executes skills from linked role directories
+ */
+const invokeRun = ({ program }) => {
+    program
+        .command('run')
+        .description('run a skill from linked role directories')
+        .option('-s, --skill <slug>', 'the skill to execute')
+        .option('--repo <slug>', 'filter to specific repo')
+        .option('--role <slug>', 'filter to specific role')
+        .allowUnknownOption(true)
+        .allowExcessArguments(true)
+        .action(async (opts) => {
+        // validate skill is provided
+        if (!opts.skill)
+            helpful_errors_1.BadRequestError.throw('--skill is required (e.g., --skill init.claude)');
+        // find unique skill
+        const skill = (0, findUniqueSkillExecutable_1.findUniqueSkillExecutable)({
+            repoSlug: opts.repo,
+            roleSlug: opts.role,
+            skillSlug: opts.skill,
+        });
+        // log which skill will run
+        console.log(``);
+        console.log(`🌊 skill "${skill.slug}" from repo=${skill.repoSlug} role=${skill.roleSlug}`);
+        console.log(``);
+        // get all args after 'run' for passthrough
+        const rawArgs = getRawArgsAfterRun();
+        // execute with all args passed through
+        (0, executeSkill_1.executeSkill)({ skill, args: rawArgs });
+    });
+};
+exports.invokeRun = invokeRun;
+//# sourceMappingURL=invokeRun.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invokeRun.js","sourceRoot":"","sources":["../../../src/contract/cli/invokeRun.ts"],"names":[],"mappings":";;;AACA,mDAAiD;AAEjD,6EAA0E;AAC1E,uGAAoG;AAEpG;;;GAGG;AACH,MAAM,kBAAkB,GAAG,GAAa,EAAE;IACxC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,MAAM,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAChC,CAAC,CAAC;AAEF;;;GAGG;AACI,MAAM,SAAS,GAAG,CAAC,EAAE,OAAO,EAAwB,EAAQ,EAAE;IACnE,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,oBAAoB,EAAE,sBAAsB,CAAC;SACpD,MAAM,CAAC,eAAe,EAAE,yBAAyB,CAAC;SAClD,MAAM,CAAC,eAAe,EAAE,yBAAyB,CAAC;SAClD,kBAAkB,CAAC,IAAI,CAAC;SACxB,oBAAoB,CAAC,IAAI,CAAC;SAC1B,MAAM,CAAC,KAAK,EAAE,IAAsD,EAAE,EAAE;QACvE,6BAA6B;QAC7B,IAAI,CAAC,IAAI,CAAC,KAAK;YACb,gCAAe,CAAC,KAAK,CACnB,iDAAiD,CAClD,CAAC;QAEJ,oBAAoB;QACpB,MAAM,KAAK,GAAG,IAAA,qDAAyB,EAAC;YACtC,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,SAAS,EAAE,IAAI,CAAC,KAAK;SACtB,CAAC,CAAC;QAEH,2BAA2B;QAC3B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CACT,aAAa,KAAK,CAAC,IAAI,eAAe,KAAK,CAAC,QAAQ,SAAS,KAAK,CAAC,QAAQ,EAAE,CAC9E,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,2CAA2C;QAC3C,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;QAErC,uCAAuC;QACvC,IAAA,2BAAY,EAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AApCW,QAAA,SAAS,aAoCpB"}

package/dist/domain.objects/RoleSkillExecutable.d.ts

@@ -0,0 +1,29 @@
+import { DomainLiteral } from 'domain-objects';
+/**
+ * .what = represents a discovered executable skill file from a role directory
+ * .why = enables skill discovery and execution via `rhachet run --skill`
+ */
+export interface RoleSkillExecutable {
+    /**
+     * .what = skill identifier derived from filename
+     * .example = "init.bhuild", "git.worktree"
+     */
+    slug: string;
+    /**
+     * .what = absolute path to the executable file
+     */
+    path: string;
+    /**
+     * .what = the repo (registry) this skill belongs to
+     * .example = "ehmpathy", ".this"
+     */
+    repoSlug: string;
+    /**
+     * .what = the role this skill belongs to
+     * .example = "mechanic", "designer"
+     */
+    roleSlug: string;
+}
+export declare class RoleSkillExecutable extends DomainLiteral<RoleSkillExecutable> implements RoleSkillExecutable {
+    static unique: readonly ["repoSlug", "roleSlug", "slug"];
+}

package/dist/domain.objects/RoleSkillExecutable.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoleSkillExecutable = void 0;
+const domain_objects_1 = require("domain-objects");
+class RoleSkillExecutable extends domain_objects_1.DomainLiteral {
+}
+exports.RoleSkillExecutable = RoleSkillExecutable;
+RoleSkillExecutable.unique = ['repoSlug', 'roleSlug', 'slug'];
+//# sourceMappingURL=RoleSkillExecutable.js.map

package/dist/domain.objects/RoleSkillExecutable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoleSkillExecutable.js","sourceRoot":"","sources":["../../src/domain.objects/RoleSkillExecutable.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AA8B/C,MAAa,mBACX,SAAQ,8BAAkC;;AAD5C,kDAKC;AADe,0BAAM,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAU,CAAC"}

package/dist/domain.objects/index.d.ts

@@ -16,5 +16,6 @@ export * from './RoleContext';
 export * from './RoleRegistry';
 export * from './RoleSkill';
 export * from './RoleSkillArgGetter';
+export * from './RoleSkillExecutable';
 export * from './RoleTrait';
 export * from './Template';

package/dist/domain.objects/index.js

@@ -34,6 +34,7 @@ __exportStar(require("./RoleContext"), exports);
 __exportStar(require("./RoleRegistry"), exports);
 __exportStar(require("./RoleSkill"), exports);
 __exportStar(require("./RoleSkillArgGetter"), exports);
+__exportStar(require("./RoleSkillExecutable"), exports);
 __exportStar(require("./RoleTrait"), exports);
 __exportStar(require("./Template"), exports);
 //# sourceMappingURL=index.js.map

package/dist/domain.objects/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain.objects/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,iDAA+B;AAC/B,gDAA8B;AAC9B,6CAA2B;AAC3B,iDAA+B;AAC/B,gDAA8B;AAC9B,mDAAiC;AACjC,+CAA6B;AAC7B,gDAA8B;AAC9B,2CAAyB;AACzB,4CAA0B;AAE1B,2BAA2B;AAC3B,4BAA4B;AAE5B,gDAA8B;AAC9B,+CAA6B;AAC7B,yCAAuB;AACvB,gDAA8B;AAC9B,iDAA+B;AAC/B,8CAA4B;AAC5B,uDAAqC;AACrC,8CAA4B;AAC5B,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain.objects/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,iDAA+B;AAC/B,gDAA8B;AAC9B,6CAA2B;AAC3B,iDAA+B;AAC/B,gDAA8B;AAC9B,mDAAiC;AACjC,+CAA6B;AAC7B,gDAA8B;AAC9B,2CAAyB;AACzB,4CAA0B;AAE1B,2BAA2B;AAC3B,4BAA4B;AAE5B,gDAA8B;AAC9B,+CAA6B;AAC7B,yCAAuB;AACvB,gDAA8B;AAC9B,iDAA+B;AAC/B,8CAA4B;AAC5B,uDAAqC;AACrC,wDAAsC;AACtC,8CAA4B;AAC5B,6CAA2B"}

package/dist/domain.operations/invoke/discoverSkillExecutables.d.ts

@@ -0,0 +1,10 @@
+import { RoleSkillExecutable } from '../../domain.objects/RoleSkillExecutable';
+/**
+ * .what = discovers executable skill files from linked role directories
+ * .why = enables `rhachet run --skill` to find and execute skills
+ */
+export declare const discoverSkillExecutables: (input: {
+    repoSlug?: string;
+    roleSlug?: string;
+    skillSlug?: string;
+}) => RoleSkillExecutable[];

package/dist/domain.operations/invoke/discoverSkillExecutables.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverSkillExecutables = void 0;
+const RoleSkillExecutable_1 = require("../../domain.objects/RoleSkillExecutable");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * .what = recursively finds all executable files in a directory
+ * .why = skills can be nested in subdirectories (e.g., claude.hooks/)
+ */
+const getAllFilesFromDir = (dir) => {
+    // skip if directory does not exist
+    if (!(0, node_fs_1.existsSync)(dir))
+        return [];
+    const entries = (0, node_fs_1.readdirSync)(dir);
+    const files = [];
+    for (const entry of entries) {
+        const fullPath = (0, node_path_1.resolve)(dir, entry);
+        const stats = (0, node_fs_1.statSync)(fullPath);
+        if (stats.isDirectory()) {
+            files.push(...getAllFilesFromDir(fullPath));
+        }
+        else if (stats.isFile()) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+};
+/**
+ * .what = extracts skill slug from a filename
+ * .why = skill files may have .sh extension or be extensionless
+ */
+const extractSlugFromFilename = (filename) => {
+    // remove .sh extension if present
+    if (filename.endsWith('.sh'))
+        return filename.slice(0, -3);
+    return filename;
+};
+/**
+ * .what = discovers executable skill files from linked role directories
+ * .why = enables `rhachet run --skill` to find and execute skills
+ */
+const discoverSkillExecutables = (input) => {
+    const agentDir = (0, node_path_1.resolve)(process.cwd(), '.agent');
+    // skip if .agent directory does not exist
+    if (!(0, node_fs_1.existsSync)(agentDir))
+        return [];
+    // discover repo directories
+    const repoEntries = (0, node_fs_1.readdirSync)(agentDir).filter((entry) => entry.startsWith('repo='));
+    const skills = [];
+    for (const repoEntry of repoEntries) {
+        const repoSlug = repoEntry.replace('repo=', '');
+        // filter by repoSlug if specified
+        if (input.repoSlug && repoSlug !== input.repoSlug)
+            continue;
+        const repoDir = (0, node_path_1.resolve)(agentDir, repoEntry);
+        // discover role directories
+        const roleEntries = (0, node_fs_1.readdirSync)(repoDir).filter((entry) => entry.startsWith('role='));
+        for (const roleEntry of roleEntries) {
+            const roleSlug = roleEntry.replace('role=', '');
+            // filter by roleSlug if specified
+            if (input.roleSlug && roleSlug !== input.roleSlug)
+                continue;
+            const skillsDir = (0, node_path_1.resolve)(repoDir, roleEntry, 'skills');
+            // get all files from skills directory
+            const skillFiles = getAllFilesFromDir(skillsDir);
+            for (const skillPath of skillFiles) {
+                const filename = (0, node_path_1.basename)(skillPath);
+                const slug = extractSlugFromFilename(filename);
+                // filter by skillSlug if specified
+                if (input.skillSlug && slug !== input.skillSlug)
+                    continue;
+                skills.push(new RoleSkillExecutable_1.RoleSkillExecutable({
+                    slug,
+                    path: skillPath,
+                    repoSlug,
+                    roleSlug,
+                }));
+            }
+        }
+    }
+    return skills;
+};
+exports.discoverSkillExecutables = discoverSkillExecutables;
+//# sourceMappingURL=discoverSkillExecutables.js.map

package/dist/domain.operations/invoke/discoverSkillExecutables.js.map

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

package/dist/domain.operations/invoke/executeSkill.d.ts

@@ -0,0 +1,9 @@
+import type { RoleSkillExecutable } from '../../domain.objects/RoleSkillExecutable';
+/**
+ * .what = executes a skill script with passthrough args
+ * .why = runs the discovered skill with full arg passthrough
+ */
+export declare const executeSkill: (input: {
+    skill: RoleSkillExecutable;
+    args: string[];
+}) => void;

package/dist/domain.operations/invoke/executeSkill.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeSkill = void 0;
+const node_child_process_1 = require("node:child_process");
+/**
+ * .what = executes a skill script with passthrough args
+ * .why = runs the discovered skill with full arg passthrough
+ */
+const executeSkill = (input) => {
+    // build command with args
+    const command = [input.skill.path, ...input.args]
+        .map((arg) => {
+        // quote args with spaces
+        if (arg.includes(' '))
+            return `"${arg}"`;
+        return arg;
+    })
+        .join(' ');
+    // execute with inherited stdio
+    (0, node_child_process_1.execSync)(command, {
+        cwd: process.cwd(),
+        stdio: 'inherit',
+        shell: '/bin/bash',
+    });
+};
+exports.executeSkill = executeSkill;
+//# sourceMappingURL=executeSkill.js.map

package/dist/domain.operations/invoke/executeSkill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeSkill.js","sourceRoot":"","sources":["../../../src/domain.operations/invoke/executeSkill.ts"],"names":[],"mappings":";;;AAEA,2DAA8C;AAE9C;;;GAGG;AACI,MAAM,YAAY,GAAG,CAAC,KAG5B,EAAQ,EAAE;IACT,0BAA0B;IAC1B,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;SAC9C,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,yBAAyB;QACzB,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,GAAG,GAAG,CAAC;QACzC,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,+BAA+B;IAC/B,IAAA,6BAAQ,EAAC,OAAO,EAAE;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,WAAW;KACnB,CAAC,CAAC;AACL,CAAC,CAAC;AAnBW,QAAA,YAAY,gBAmBvB"}

package/dist/domain.operations/invoke/findUniqueSkillExecutable.d.ts

@@ -0,0 +1,10 @@
+import type { RoleSkillExecutable } from '../../domain.objects/RoleSkillExecutable';
+/**
+ * .what = finds exactly one skill executable by slug, with optional repo/role filters
+ * .why = ensures unambiguous skill resolution before execution
+ */
+export declare const findUniqueSkillExecutable: (input: {
+    repoSlug?: string;
+    roleSlug?: string;
+    skillSlug: string;
+}) => RoleSkillExecutable;

package/dist/domain.operations/invoke/findUniqueSkillExecutable.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findUniqueSkillExecutable = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const discoverSkillExecutables_1 = require("./discoverSkillExecutables");
+/**
+ * .what = finds exactly one skill executable by slug, with optional repo/role filters
+ * .why = ensures unambiguous skill resolution before execution
+ */
+const findUniqueSkillExecutable = (input) => {
+    // discover skills with filters
+    const matches = (0, discoverSkillExecutables_1.discoverSkillExecutables)({
+        repoSlug: input.repoSlug,
+        roleSlug: input.roleSlug,
+        skillSlug: input.skillSlug,
+    });
+    // handle no matches
+    if (matches.length === 0) {
+        const filters = [
+            input.repoSlug ? `--repo ${input.repoSlug}` : null,
+            input.roleSlug ? `--role ${input.roleSlug}` : null,
+        ]
+            .filter(Boolean)
+            .join(' ');
+        const hint = filters
+            ? `no skill "${input.skillSlug}" found with ${filters}`
+            : `no skill "${input.skillSlug}" found in any linked role`;
+        helpful_errors_1.BadRequestError.throw(hint, { input });
+    }
+    // handle multiple matches
+    if (matches.length > 1) {
+        const matchList = matches
+            .map((m) => `  - repo=${m.repoSlug} role=${m.roleSlug}`)
+            .join('\n');
+        helpful_errors_1.BadRequestError.throw(`multiple skills found for "${input.skillSlug}":\n${matchList}\n\nuse --repo and/or --role to disambiguate`, { input, matches });
+    }
+    // return unique match
+    return matches[0];
+};
+exports.findUniqueSkillExecutable = findUniqueSkillExecutable;
+//# sourceMappingURL=findUniqueSkillExecutable.js.map

package/dist/domain.operations/invoke/findUniqueSkillExecutable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findUniqueSkillExecutable.js","sourceRoot":"","sources":["../../../src/domain.operations/invoke/findUniqueSkillExecutable.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAIjD,yEAAsE;AAEtE;;;GAGG;AACI,MAAM,yBAAyB,GAAG,CAAC,KAIzC,EAAuB,EAAE;IACxB,+BAA+B;IAC/B,MAAM,OAAO,GAAG,IAAA,mDAAwB,EAAC;QACvC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;IAEH,oBAAoB;IACpB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG;YACd,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI;YAClD,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI;SACnD;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,GAAG,CAAC,CAAC;QAEb,MAAM,IAAI,GAAG,OAAO;YAClB,CAAC,CAAC,aAAa,KAAK,CAAC,SAAS,gBAAgB,OAAO,EAAE;YACvD,CAAC,CAAC,aAAa,KAAK,CAAC,SAAS,4BAA4B,CAAC;QAE7D,gCAAe,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,0BAA0B;IAC1B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,OAAO;aACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,QAAQ,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC;aACvD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,gCAAe,CAAC,KAAK,CACnB,8BAA8B,KAAK,CAAC,SAAS,OAAO,SAAS,8CAA8C,EAC3G,EAAE,KAAK,EAAE,OAAO,EAAE,CACnB,CAAC;IACJ,CAAC;IAED,sBAAsB;IACtB,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC;AACrB,CAAC,CAAC;AA1CW,QAAA,yBAAyB,6BA0CpC"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "rhachet",
   "author": "ehmpathy",
   "description": "A framework for reliable, thorough thought. Weave threads of thought via stitches.",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "repository": "ehmpathy/rhachet",
   "homepage": "https://github.com/ehmpathy/rhachet",
   "keywords": [