rhachet 1.7.2 → 1.9.0

package/dist/contract/cli/invoke.js

@@ -6,8 +6,10 @@ const helpful_errors_1 = require("helpful-errors");
 const node_path_1 = require("node:path");
 const rhachet_artifact_git_1 = require("rhachet-artifact-git");
 const assureUniqueRoles_1 = require("../../logic/invoke/assureUniqueRoles");
+const getInvokeHooksByOpts_1 = require("../../logic/invoke/getInvokeHooksByOpts");
 const getRegistriesByOpts_1 = require("../../logic/invoke/getRegistriesByOpts");
 const invokeAsk_1 = require("./invokeAsk");
+const invokeChoose_1 = require("./invokeChoose");
 const invokeList_1 = require("./invokeList");
 const invokeReadme_1 = require("./invokeReadme");
 /**
@@ -32,6 +34,9 @@ const invoke = async (input) => {
     const registries = await (0, getRegistriesByOpts_1.getRegistriesByOpts)({
         opts: { config: configPath },
     });
+    const hooks = await (0, getInvokeHooksByOpts_1.getInvokeHooksByOpts)({
+        opts: { config: configPath }, // todo: maybe, getConfigByOpts ? returns both?
+    });
     // failfast on duplicate roles // todo: update commands to allow registry based disambiguation
     await (0, assureUniqueRoles_1.assureUniqueRoles)(registries);
     // declare the cli program
@@ -47,7 +52,8 @@ const invoke = async (input) => {
         .option('-c, --config <path>', 'where to find the rhachet.use.ts config'); // tell commander that we expect the config input and not to complain about it
     (0, invokeReadme_1.invokeReadme)({ program, registries });
     (0, invokeList_1.invokeList)({ program, registries });
-    (0, invokeAsk_1.invokeAsk)({ program, config: { path: configPath }, registries });
+    (0, invokeChoose_1.invokeChoose)({ program });
+    (0, invokeAsk_1.invokeAsk)({ program, config: { path: configPath }, registries, hooks });
     // invoke it
     await program.parseAsync(input.args, { from: 'user' }).catch((error) => {
         if (error instanceof helpful_errors_1.BadRequestError) {

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

@@ -1 +1 @@
-{"version":3,"file":"invoke.js","sourceRoot":"","sources":["../../../src/contract/cli/invoke.ts"],"names":[],"mappings":";;;AAAA,yCAAoC;AACpC,mDAAiD;AACjD,yCAAoC;AACpC,+DAAsD;AAEtD,4EAAyE;AACzE,gFAA6E;AAC7E,2CAAwC;AACxC,6CAA0C;AAC1C,iDAA8C;AAE9C;;;;;;;;GAQG;AACI,MAAM,MAAM,GAAG,KAAK,EAAE,KAAyB,EAAiB,EAAE;IACvE,6BAA6B;IAC7B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAC9E,MAAM,kBAAkB,GACtB,SAAS,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACzC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAE;QAC5B,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE;IAC7B,MAAM,UAAU,GAAG,kBAAkB;QACnC,CAAC,CAAC,IAAA,mBAAO,EAAC,GAAG,EAAE,kBAAkB,CAAC;QAClC,CAAC,CAAC,IAAA,mBAAO,EAAC,MAAM,IAAA,qCAAc,EAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,MAAM,IAAA,yCAAmB,EAAC;QAC3C,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;KAC7B,CAAC,CAAC;IAEH,8FAA8F;IAC9F,MAAM,IAAA,qCAAiB,EAAC,UAAU,CAAC,CAAC;IAEpC,0BAA0B;IAC1B,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAC9B,OAAO,CAAC,eAAe,CAAC;QACtB,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;YAChB,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC,CAAC;IACH,OAAO;SACJ,IAAI,CAAC,SAAS,CAAC;SACf,WAAW,CACV,mFAAmF,CACpF;SACA,MAAM,CAAC,qBAAqB,EAAE,yCAAyC,CAAC,CAAC,CAAC,8EAA8E;IAC3J,IAAA,2BAAY,EAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IACtC,IAAA,uBAAU,EAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IACpC,IAAA,qBAAS,EAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IAEjE,YAAY;IACZ,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACrE,IAAI,KAAK,YAAY,gCAAe,EAAE,CAAC;YACrC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACpC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACtC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AA/CW,QAAA,MAAM,UA+CjB"}
+{"version":3,"file":"invoke.js","sourceRoot":"","sources":["../../../src/contract/cli/invoke.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,5 @@
 import { Command } from 'commander';
+import { InvokeHooks } from '../../domain/objects/InvokeHooks';
 import { RoleRegistry } from '../../domain/objects/RoleRegistry';
 /**
  * .what = adds the "ask" command to the CLI
@@ -10,4 +11,5 @@ export declare const invokeAsk: ({ program, registries, ...input }: {
         path: string;
     };
     registries: RoleRegistry[];
+    hooks: null | InvokeHooks;
 }) => void;

package/dist/contract/cli/invokeAsk.integration.test.js

@@ -18,6 +18,7 @@ describe('invokeAsk (integration)', () => {
             program,
             config: { path: configPath },
             registries: [example_echoRegistry_1.EXAMPLE_REGISTRY],
+            hooks: null,
         });
         (0, test_fns_1.when)('invoking a valid echo skill with ask input', () => {
             (0, test_fns_1.then)('it should execute the skill successfully', async () => {

package/dist/contract/cli/invokeAsk.integration.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"invokeAsk.integration.test.js","sourceRoot":"","sources":["../../../src/contract/cli/invokeAsk.integration.test.ts"],"names":[],"mappings":";;;;;AAAA,yCAAoC;AACpC,0DAA6B;AAC7B,uCAAuD;AAEvD,qDAA+D;AAC/D,4FAAqF;AACrF,2CAAwC;AAExC,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,IAAA,gBAAK,EACH,gEAAgE,EAChE,GAAG,EAAE;QACH,wEAAwE;QACxE,MAAM,UAAU,GAAG,mBAAI,CAAC,OAAO,CAC7B,kCAAsB,EACtB,2CAA2C,CAC5C,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;QAC9B,IAAA,qBAAS,EAAC;YACR,OAAO;YACP,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;YAC5B,UAAU,EAAE,CAAC,uCAAgB,CAAC;SAC/B,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,4CAA4C,EAAE,GAAG,EAAE;YACtD,IAAA,eAAI,EAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;gBAC1D,MAAM,IAAI,GAAG;oBACX,KAAK;oBACL,QAAQ;oBACR,QAAQ;oBACR,SAAS;oBACT,MAAM;oBACN,OAAO;oBACP,OAAO;iBACR,CAAC;gBACF,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,gCAAgC,EAAE,GAAG,EAAE;YAC1C,IAAA,eAAI,EAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;gBACrD,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;gBACrE,MAAM,KAAK,GAAG,MAAM,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAChC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAC3C,CAAC;gBACF,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YACrD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,+BAA+B,EAAE,GAAG,EAAE;YACzC,IAAA,eAAI,EAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;gBACtD,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;gBACnE,MAAM,KAAK,GAAG,MAAM,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAChC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAC3C,CAAC;gBACF,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;YACpD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,2CAA2C,EAAE,GAAG,EAAE;YACrD,IAAA,eAAI,EAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;gBAC1D,MAAM,IAAI,GAAG;oBACX,KAAK;oBACL,QAAQ;oBACR,QAAQ;oBACR,SAAS;oBACT,MAAM;oBACN,OAAO;oBACP,OAAO;oBACP,YAAY;oBACZ,GAAG;iBACJ,CAAC;gBACF,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC,CAAC,CAAC"}
+{"version":3,"file":"invokeAsk.integration.test.js","sourceRoot":"","sources":["../../../src/contract/cli/invokeAsk.integration.test.ts"],"names":[],"mappings":";;;;;AAAA,yCAAoC;AACpC,0DAA6B;AAC7B,uCAAuD;AAEvD,qDAA+D;AAC/D,4FAAqF;AACrF,2CAAwC;AAExC,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,IAAA,gBAAK,EACH,gEAAgE,EAChE,GAAG,EAAE;QACH,wEAAwE;QACxE,MAAM,UAAU,GAAG,mBAAI,CAAC,OAAO,CAC7B,kCAAsB,EACtB,2CAA2C,CAC5C,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;QAC9B,IAAA,qBAAS,EAAC;YACR,OAAO;YACP,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;YAC5B,UAAU,EAAE,CAAC,uCAAgB,CAAC;YAC9B,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,4CAA4C,EAAE,GAAG,EAAE;YACtD,IAAA,eAAI,EAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;gBAC1D,MAAM,IAAI,GAAG;oBACX,KAAK;oBACL,QAAQ;oBACR,QAAQ;oBACR,SAAS;oBACT,MAAM;oBACN,OAAO;oBACP,OAAO;iBACR,CAAC;gBACF,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,gCAAgC,EAAE,GAAG,EAAE;YAC1C,IAAA,eAAI,EAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;gBACrD,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;gBACrE,MAAM,KAAK,GAAG,MAAM,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAChC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAC3C,CAAC;gBACF,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YACrD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,+BAA+B,EAAE,GAAG,EAAE;YACzC,IAAA,eAAI,EAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;gBACtD,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;gBACnE,MAAM,KAAK,GAAG,MAAM,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAChC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAC3C,CAAC;gBACF,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;YACpD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,2CAA2C,EAAE,GAAG,EAAE;YACrD,IAAA,eAAI,EAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;gBAC1D,MAAM,IAAI,GAAG;oBACX,KAAK;oBACL,QAAQ;oBACR,QAAQ;oBACR,SAAS;oBACT,MAAM;oBACN,OAAO;oBACP,OAAO;oBACP,YAAY;oBACZ,GAAG;iBACJ,CAAC;gBACF,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/contract/cli/invokeAsk.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.invokeAsk = void 0;
 const helpful_errors_1 = require("helpful-errors");
 const assureFindRole_1 = require("../../logic/invoke/assureFindRole");
+const onInvokeAskInput_1 = require("../../logic/invoke/hooks/onInvokeAskInput");
 const performInCurrentThread_1 = require("../../logic/invoke/performInCurrentThread");
 const performInIsolatedThreads_1 = require("../../logic/invoke/performInIsolatedThreads");
 /**
@@ -48,11 +49,15 @@ const invokeAsk = ({ program, registries, ...input }) => {
                 helpful_errors_1.UnexpectedCodePathError.throw('ask was not declared', { opts }),
             config: input.config.path, // required for isolated child threads when used with attempts
         };
+        // apply the onInvokeAskHooks
+        const argvWithHooks = input.hooks
+            ? (0, onInvokeAskInput_1.onInvokeAskInput)({ opts: argvWithAsk, hooks: input.hooks })
+            : argvWithAsk;
         // if attempts were requested, perform the skill in isolated threads per attempt
         if (opts.attempts)
-            return await (0, performInIsolatedThreads_1.performInIsolatedThreads)({ opts: argvWithAsk });
+            return await (0, performInIsolatedThreads_1.performInIsolatedThreads)({ opts: argvWithHooks });
         // otherwise, perform in the main thread by default
-        return await (0, performInCurrentThread_1.performInCurrentThread)({ opts: argvWithAsk, registries });
+        return await (0, performInCurrentThread_1.performInCurrentThread)({ opts: argvWithHooks, registries });
     });
 };
 exports.invokeAsk = invokeAsk;

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

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

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

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+/**
+ * .what = adds the "choose" command to the CLI
+ * .why = allows users to choose a specific attempt file, archive its peer files, and clean up unrelated ones
+ */
+export declare const invokeChoose: ({ program }: {
+    program: Command;
+}) => void;

package/dist/contract/cli/invokeChoose.integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/contract/cli/invokeChoose.integration.test.js

@@ -0,0 +1,111 @@
+"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 });
+const commander_1 = require("commander");
+const promises_1 = require("node:fs/promises");
+const path = __importStar(require("node:path"));
+const test_fns_1 = require("test-fns");
+const invokeChoose_1 = require("./invokeChoose");
+// tiny fs helpers
+const exists = async (p) => (0, promises_1.stat)(p)
+    .then(() => true)
+    .catch(() => false);
+const read = async (p) => (await (0, promises_1.readFile)(p, 'utf8')).trim();
+describe('invokeChoose (integration)', () => {
+    (0, test_fns_1.given)('a fixture directory with peer files', () => {
+        const fixtureRoot = path.resolve(__dirname + '/.temp/invokeChoose/');
+        const peerPrefix = 'provider.scene_6.loyalty_build.v1i2.[stories]';
+        const choiceDir = path.join(fixtureRoot);
+        const archiveDir = path.join(fixtureRoot, '.archive');
+        const peerNames = [
+            `${peerPrefix}._.md`,
+            `${peerPrefix}.v1._.md`,
+            `${peerPrefix}.v1.md`,
+            `${peerPrefix}.v1.i1.md`,
+            `${peerPrefix}.v1.i2.md`,
+            `${peerPrefix}.v1.i3.md`,
+            `${peerPrefix}.choice.v1.i3.md`,
+            `${peerPrefix}.v1.src`,
+        ];
+        const peerChosen = peerNames[3]; // lets say we're choosing this one
+        const unrelated = 'random.txt'; // lets include a non peer too
+        const prepareTheScene = async () => {
+            // refresh the fixture
+            await (0, promises_1.rm)(fixtureRoot, { recursive: true, force: true });
+            await (0, promises_1.mkdir)(choiceDir, { recursive: true });
+            await (0, promises_1.mkdir)(archiveDir, { recursive: true });
+            // write peers with recognizable contents
+            await Promise.all(peerNames.map((name, index) => (0, promises_1.writeFile)(path.join(choiceDir, name), `content-${index}`)));
+            // an unrelated file that should remain untouched
+            await (0, promises_1.writeFile)(path.join(choiceDir, unrelated), 'unrelated-content');
+            console.log('🧹 fixture prepared', fixtureRoot);
+        };
+        beforeAll(async () => {
+            await prepareTheScene();
+        });
+        (0, test_fns_1.when)('invoking choose with a valid chosen attempt', () => {
+            // register command
+            const program = new commander_1.Command();
+            (0, invokeChoose_1.invokeChoose)({ program });
+            // declare the choice
+            const choicePath = path.join(choiceDir, peerChosen);
+            (0, test_fns_1.then)('it should succeed', async () => {
+                await program.parseAsync(['choose', '--choice', choicePath, '--archive', '@choice/.archive'], { from: 'user' });
+            });
+            (0, test_fns_1.then)('it should archive the peers', async () => {
+                for (const name of peerNames) {
+                    const archivedPath = path.join(archiveDir, path.basename(name));
+                    expect(await exists(archivedPath)).toBe(true);
+                }
+            });
+            (0, test_fns_1.then)('it should archive the peer choice with label', async () => {
+                // it should have been archived directly already
+                const choiceArchived = path.join(archiveDir, path.basename(peerChosen));
+                expect(await exists(choiceArchived)).toBe(true);
+                // it should ALSO have been archived with .choice label
+                const choiceArchivedLabeled = path.join(archiveDir, path
+                    .basename(peerChosen)
+                    .replace(`${peerPrefix}`, `${peerPrefix}.choice`));
+                expect(await exists(choiceArchivedLabeled)).toBe(true);
+                expect(await read(choiceArchivedLabeled)).toBe(await read(path.join(choiceDir, peerChosen)));
+            });
+            (0, test_fns_1.then)('it should keep only the .src and choice in the choice directory', async () => {
+                // chosen remains in place
+                expect(await exists(choicePath)).toBe(true);
+                // .src peers remain in place
+                expect(await exists(path.join(choiceDir, `${peerPrefix}.v1.src`))).toBe(true);
+                // non-source, non-chosen peers should be deleted from workdir
+                const shouldBeDeleted = peerNames.filter((p) => !p.endsWith('.src') && p !== peerChosen);
+                for (const name of shouldBeDeleted) {
+                    expect(await exists(path.join(choiceDir, name))).toBe(false);
+                }
+                // unrelated file should remain untouched
+                expect(await exists(path.join(choiceDir, unrelated))).toBe(true);
+                expect(await read(path.join(choiceDir, unrelated))).toBe('unrelated-content');
+            });
+        });
+    });
+});
+//# sourceMappingURL=invokeChoose.integration.test.js.map

package/dist/contract/cli/invokeChoose.integration.test.js.map

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

package/dist/contract/cli/invokeChoose.js

@@ -0,0 +1,111 @@
+"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;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeChoose = void 0;
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const fs = __importStar(require("fs"));
+const helpful_errors_1 = require("helpful-errors");
+const path = __importStar(require("path"));
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const getPeerQualifiersOfOutputChoice_1 = require("../../logic/invoke/getPeerQualifiersOfOutputChoice");
+/**
+ * .what = adds the "choose" command to the CLI
+ * .why = allows users to choose a specific attempt file, archive its peer files, and clean up unrelated ones
+ */
+const invokeChoose = ({ program }) => {
+    program
+        .command('choose')
+        .requiredOption('--choice <path>', 'path to chosen attempt file (relative)')
+        .requiredOption('--archive <dir>', 'directory where peers will be archived')
+        .description('select one attempt file, archive its peer files, and remove unrelated ones')
+        .action(async (opts) => {
+        // standardize the path declarations
+        const choicePath = path.resolve(opts.choice);
+        const choiceFile = path.basename(choicePath);
+        const choiceDir = path.dirname(choicePath);
+        // resolve archive dir:
+        // - if starts with "@choice/", make it relative to choiceDir
+        // - otherwise, resolve relative to cwd as normal
+        const archiveDir = opts.archive.startsWith('@choice/')
+            ? path.join(choiceDir, opts.archive.replace(/^@choice\//, ''))
+            : path.resolve(opts.archive);
+        // verify choice exists and is valid
+        if (!fs.existsSync(choicePath))
+            helpful_errors_1.BadRequestError.throw(`choice file not found: ${choicePath}`, { opts });
+        if (choiceFile.endsWith('.src'))
+            helpful_errors_1.BadRequestError.throw(`--choice cannot be a .src file`, { opts });
+        // grab the peer qualifiers
+        const peerQualifier = (0, getPeerQualifiersOfOutputChoice_1.getPeerQualifiersOfOutputChoice)(choiceFile);
+        if (!peerQualifier.prefix)
+            helpful_errors_1.BadRequestError.throw(`unrecognized file naming pattern: ${choiceFile}`);
+        // build glob patterns
+        const globPeersByExt = path.join(choiceDir, `${peerQualifier.prefix}*.${peerQualifier.extension}`);
+        const globPeersBySrc = path.join(choiceDir, `${peerQualifier.prefix}*.src`);
+        // collect all peer paths
+        const peerPaths = await (0, fast_glob_1.default)([globPeersByExt, globPeersBySrc], {
+            cwd: choiceDir,
+            onlyFiles: true,
+            dot: false,
+            absolute: true,
+        });
+        // copy peer files to archive dir; remove the non.source and the non.chosen
+        await Promise.all(peerPaths.map(async (peerPath) => {
+            // declare the .into and .from archive files
+            const peerDetected = (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: peerPath });
+            const peerArchived = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                uri: path.join(archiveDir, path.basename(peerPath)),
+            });
+            // grab the detected content
+            const peerContent = (await peerDetected.get())?.content ??
+                helpful_errors_1.UnexpectedCodePathError.throw('how could a peer detected by prefix not have contents?', {
+                    path,
+                    peerQualifier,
+                });
+            // move into archive
+            await peerArchived.set({
+                content: peerContent,
+            });
+            // label the choice file and archive that too
+            const isChosen = peerPath.endsWith(opts.choice); // equal to choice (overlap by suffix)
+            if (isChosen) {
+                const peerArchivedAsChoice = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                    uri: peerArchived.ref.uri.replace(peerQualifier.prefix, peerQualifier.prefix + '.choice'),
+                });
+                await peerArchivedAsChoice.set({ content: peerContent });
+            }
+            // drop if non source and non chosen .from files
+            const isSource = peerPath.endsWith('.src');
+            if (!isSource && !isChosen)
+                await peerDetected.del();
+        }));
+        console.log(``);
+        console.log(`🏆 choice assigned (${peerPaths.length} archived)`);
+    });
+};
+exports.invokeChoose = invokeChoose;
+//# sourceMappingURL=invokeChoose.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invokeChoose.js","sourceRoot":"","sources":["../../../src/contract/cli/invokeChoose.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,0DAA6B;AAC7B,uCAAyB;AACzB,mDAA0E;AAC1E,2CAA6B;AAC7B,+DAA0D;AAE1D,wGAAqG;AAErG;;;GAGG;AACI,MAAM,YAAY,GAAG,CAAC,EAAE,OAAO,EAAwB,EAAQ,EAAE;IACtE,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,cAAc,CAAC,iBAAiB,EAAE,wCAAwC,CAAC;SAC3E,cAAc,CAAC,iBAAiB,EAAE,wCAAwC,CAAC;SAC3E,WAAW,CACV,4EAA4E,CAC7E;SACA,MAAM,CAAC,KAAK,EAAE,IAAyC,EAAE,EAAE;QAC1D,oCAAoC;QACpC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE3C,uBAAuB;QACvB,6DAA6D;QAC7D,iDAAiD;QACjD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC;YACpD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;YAC9D,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE/B,oCAAoC;QACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;YAC5B,gCAAe,CAAC,KAAK,CAAC,0BAA0B,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1E,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC7B,gCAAe,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpE,2BAA2B;QAC3B,MAAM,aAAa,GAAG,IAAA,iEAA+B,EAAC,UAAU,CAAC,CAAC;QAClE,IAAI,CAAC,aAAa,CAAC,MAAM;YACvB,gCAAe,CAAC,KAAK,CACnB,qCAAqC,UAAU,EAAE,CAClD,CAAC;QAEJ,sBAAsB;QACtB,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAC9B,SAAS,EACT,GAAG,aAAa,CAAC,MAAM,KAAK,aAAa,CAAC,SAAS,EAAE,CACtD,CAAC;QACF,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAC9B,SAAS,EACT,GAAG,aAAa,CAAC,MAAM,OAAO,CAC/B,CAAC;QAEF,yBAAyB;QACzB,MAAM,SAAS,GAAG,MAAM,IAAA,mBAAI,EAAC,CAAC,cAAc,EAAE,cAAc,CAAC,EAAE;YAC7D,GAAG,EAAE,SAAS;YACd,SAAS,EAAE,IAAI;YACf,GAAG,EAAE,KAAK;YACV,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,2EAA2E;QAC3E,MAAM,OAAO,CAAC,GAAG,CACf,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YAC/B,4CAA4C;YAC5C,MAAM,YAAY,GAAG,IAAA,yCAAkB,EAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC3D,MAAM,YAAY,GAAG,IAAA,yCAAkB,EAAC;gBACtC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;aACpD,CAAC,CAAC;YAEH,4BAA4B;YAC5B,MAAM,WAAW,GACf,CAAC,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO;gBACnC,wCAAuB,CAAC,KAAK,CAC3B,wDAAwD,EACxD;oBACE,IAAI;oBACJ,aAAa;iBACd,CACF,CAAC;YAEJ,oBAAoB;YACpB,MAAM,YAAY,CAAC,GAAG,CAAC;gBACrB,OAAO,EAAE,WAAW;aACrB,CAAC,CAAC;YAEH,6CAA6C;YAC7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,sCAAsC;YACvF,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,oBAAoB,GAAG,IAAA,yCAAkB,EAAC;oBAC9C,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAC/B,aAAa,CAAC,MAAM,EACpB,aAAa,CAAC,MAAM,GAAG,SAAS,CACjC;iBACF,CAAC,CAAC;gBACH,MAAM,oBAAoB,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YAC3D,CAAC;YAED,gDAAgD;YAChD,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ;gBAAE,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC;QACvD,CAAC,CAAC,CACH,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,uBAAuB,SAAS,CAAC,MAAM,YAAY,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAlGW,QAAA,YAAY,gBAkGvB"}

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

@@ -0,0 +1,10 @@
+import { InvokeOpts } from '.';
+export interface InvokeHooks {
+    onInvokeAskInput: Array<(input: InvokeOpts<{
+        ask: string;
+        config: string;
+    }>) => InvokeOpts<{
+        ask: string;
+        config: string;
+    }>>;
+}

package/dist/domain/objects/InvokeHooks.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=InvokeHooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InvokeHooks.js","sourceRoot":"","sources":["../../../src/domain/objects/InvokeHooks.ts"],"names":[],"mappings":""}

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

@@ -17,3 +17,4 @@ export * from './RoleSkillArgGetter';
 export * from './RoleTrait';
 export * from './Template';
 export * from './InvokeOpts';
+export * from './InvokeHooks';

package/dist/domain/objects/index.js

@@ -35,4 +35,5 @@ __exportStar(require("./RoleSkillArgGetter"), exports);
 __exportStar(require("./RoleTrait"), exports);
 __exportStar(require("./Template"), exports);
 __exportStar(require("./InvokeOpts"), exports);
+__exportStar(require("./InvokeHooks"), 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;AAC1B,2BAA2B;AAC3B,4BAA4B;AAE5B,yCAAuB;AACvB,gDAA8B;AAC9B,iDAA+B;AAC/B,8CAA4B;AAC5B,uDAAqC;AACrC,8CAA4B;AAE5B,6CAA2B;AAC3B,+CAA6B"}
+{"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;AAC1B,2BAA2B;AAC3B,4BAA4B;AAE5B,yCAAuB;AACvB,gDAA8B;AAC9B,iDAA+B;AAC/B,8CAA4B;AAC5B,uDAAqC;AACrC,8CAA4B;AAE5B,6CAA2B;AAC3B,+CAA6B;AAC7B,gDAA8B"}

package/dist/logic/invoke/getInvokeHooksByOpts.d.ts

@@ -0,0 +1,13 @@
+import { InvokeHooks } from '../../domain/objects/InvokeHooks';
+import { InvokeOpts } from '../../domain/objects/InvokeOpts';
+/**
+ * .what = get invoke hooks from the invocation options declared
+ * .how =
+ *   - lookup the config based on the options
+ *   - grab the hooks from the config
+ */
+export declare const getInvokeHooksByOpts: (input: {
+    opts: InvokeOpts<{
+        config: string;
+    }>;
+}) => Promise<InvokeHooks | null>;

package/dist/logic/invoke/getInvokeHooksByOpts.js

@@ -0,0 +1,40 @@
+"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.getInvokeHooksByOpts = void 0;
+/**
+ * .what = get invoke hooks from the invocation options declared
+ * .how =
+ *   - lookup the config based on the options
+ *   - grab the hooks from the config
+ */
+const getInvokeHooksByOpts = async (input) => {
+    // import the config
+    const config = await Promise.resolve(`${input.opts.config}`).then(s => __importStar(require(s)));
+    // grab the registries
+    return (await config.getInvokeHooks?.()) ?? null;
+};
+exports.getInvokeHooksByOpts = getInvokeHooksByOpts;
+//# sourceMappingURL=getInvokeHooksByOpts.js.map

package/dist/logic/invoke/getInvokeHooksByOpts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getInvokeHooksByOpts.js","sourceRoot":"","sources":["../../../src/logic/invoke/getInvokeHooksByOpts.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAGA;;;;;GAKG;AACI,MAAM,oBAAoB,GAAG,KAAK,EAAE,KAE1C,EAA+B,EAAE;IAChC,oBAAoB;IACpB,MAAM,MAAM,GAAoD,yBAC9D,KAAK,CAAC,IAAI,CAAC,MAAM,uCAClB,CAAC;IAEF,sBAAsB;IACtB,OAAO,CAAC,MAAM,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC;AACnD,CAAC,CAAC;AAVW,QAAA,oBAAoB,wBAU/B"}

package/dist/logic/invoke/getPeerQualifiersOfOutputChoice.d.ts

@@ -0,0 +1,23 @@
+/**
+ * .what = extracts the peer prefix and extension from a chosen file
+ * .why = used to identify all peer files sharing the same base name
+ *
+ * supports trailing qualifier tokens (zero or more) before the final extension:
+ * - .v{number}
+ * - .i{number}
+ * - ._
+ * - .{word}  (e.g., .choice)
+ *
+ * examples (prefix ► extension):
+ * - foo.[stories]._.md                  ► foo.[stories] ► md
+ * - foo.[stories].v1._.md               ► foo.[stories] ► md
+ * - foo.[stories].v1.i3.md              ► foo.[stories] ► md
+ * - foo.[stories].choice.v1.i3.md       ► foo.[stories] ► md
+ * - foo.[stories].src                   ► foo.[stories] ► src
+ * - foo.[stories].v1.src                ► foo.[stories] ► src
+ * - foo.[notes].i2.txt                  ► foo.[notes]   ► txt
+ */
+export declare const getPeerQualifiersOfOutputChoice: (choice: string) => {
+    prefix: string;
+    extension: string;
+};

package/dist/logic/invoke/getPeerQualifiersOfOutputChoice.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPeerQualifiersOfOutputChoice = void 0;
+const helpful_errors_1 = require("helpful-errors");
+/**
+ * .what = extracts the peer prefix and extension from a chosen file
+ * .why = used to identify all peer files sharing the same base name
+ *
+ * supports trailing qualifier tokens (zero or more) before the final extension:
+ * - .v{number}
+ * - .i{number}
+ * - ._
+ * - .{word}  (e.g., .choice)
+ *
+ * examples (prefix ► extension):
+ * - foo.[stories]._.md                  ► foo.[stories] ► md
+ * - foo.[stories].v1._.md               ► foo.[stories] ► md
+ * - foo.[stories].v1.i3.md              ► foo.[stories] ► md
+ * - foo.[stories].choice.v1.i3.md       ► foo.[stories] ► md
+ * - foo.[stories].src                   ► foo.[stories] ► src
+ * - foo.[stories].v1.src                ► foo.[stories] ► src
+ * - foo.[notes].i2.txt                  ► foo.[notes]   ► txt
+ */
+const getPeerQualifiersOfOutputChoice = (choice) => {
+    // grab the last dotted segment as the extension
+    const extMatch = choice.match(/^(.+)\.([A-Za-z0-9]+)$/);
+    if (!extMatch)
+        helpful_errors_1.BadRequestError.throw(`unrecognized file naming pattern`, { choice });
+    // instantiate a mutable base
+    let base = extMatch[1] ??
+        helpful_errors_1.UnexpectedCodePathError.throw('how is there no base?', {
+            extMatch,
+            choice,
+        });
+    const extension = extMatch[2];
+    // strip trailing qualifier tokens like .v1, .i3, ._, .choice (in that order, repeatedly)
+    const QUALIFIER_RE = /\.(?:v\d+|i\d+|_|[a-z][a-z0-9_-]*)$/i;
+    while (QUALIFIER_RE.test(base)) {
+        base = base.replace(QUALIFIER_RE, '');
+    }
+    const prefix = base ??
+        helpful_errors_1.BadRequestError.throw('could not extract prefix from output choice', {
+            choice,
+        });
+    const ext = extension ??
+        helpful_errors_1.BadRequestError.throw('could not extract extension from output choice', {
+            choice,
+        });
+    return { prefix, extension: ext };
+};
+exports.getPeerQualifiersOfOutputChoice = getPeerQualifiersOfOutputChoice;
+//# sourceMappingURL=getPeerQualifiersOfOutputChoice.js.map

package/dist/logic/invoke/getPeerQualifiersOfOutputChoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPeerQualifiersOfOutputChoice.js","sourceRoot":"","sources":["../../../src/logic/invoke/getPeerQualifiersOfOutputChoice.ts"],"names":[],"mappings":";;;AAAA,mDAA0E;AAE1E;;;;;;;;;;;;;;;;;;GAkBG;AACI,MAAM,+BAA+B,GAAG,CAC7C,MAAc,EACyB,EAAE;IACzC,gDAAgD;IAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACxD,IAAI,CAAC,QAAQ;QACX,gCAAe,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAExE,6BAA6B;IAC7B,IAAI,IAAI,GACN,QAAQ,CAAC,CAAC,CAAC;QACX,wCAAuB,CAAC,KAAK,CAAC,uBAAuB,EAAE;YACrD,QAAQ;YACR,MAAM;SACP,CAAC,CAAC;IACL,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE9B,yFAAyF;IACzF,MAAM,YAAY,GAAG,sCAAsC,CAAC;IAC5D,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,MAAM,GACV,IAAI;QACJ,gCAAe,CAAC,KAAK,CAAC,6CAA6C,EAAE;YACnE,MAAM;SACP,CAAC,CAAC;IAEL,MAAM,GAAG,GACP,SAAS;QACT,gCAAe,CAAC,KAAK,CAAC,gDAAgD,EAAE;YACtE,MAAM;SACP,CAAC,CAAC;IAEL,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;AACpC,CAAC,CAAC;AApCW,QAAA,+BAA+B,mCAoC1C"}

package/dist/logic/invoke/getPeerQualifiersOfOutputChoice.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/logic/invoke/getPeerQualifiersOfOutputChoice.test.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const helpful_errors_1 = require("helpful-errors");
+const getPeerQualifiersOfOutputChoice_1 = require("./getPeerQualifiersOfOutputChoice");
+const validCases = [
+    {
+        peers: [
+            'provider.scene_6.loyalty_build.v1i2.[stories]._.md',
+            'provider.scene_6.loyalty_build.v1i2.[stories].v1._.md',
+            'provider.scene_6.loyalty_build.v1i2.[stories].v1.md',
+            'provider.scene_6.loyalty_build.v1i2.[stories].v1.i1.md',
+            'provider.scene_6.loyalty_build.v1i2.[stories].v1.i2.md',
+            'provider.scene_6.loyalty_build.v1i2.[stories].v1.i3.md',
+            'provider.scene_6.loyalty_build.v1i2.[stories].choice.v1.i3.md',
+            'provider.scene_6.loyalty_build.v1i2.[stories].choice.i5.md',
+        ],
+        output: {
+            prefix: 'provider.scene_6.loyalty_build.v1i2.[stories]',
+            extension: 'md',
+        },
+    },
+    {
+        peers: [
+            'provider.scene_6.loyalty_build.v1i2.[stories].src',
+            'provider.scene_6.loyalty_build.v1i2.[stories].v1.src',
+        ],
+        output: {
+            prefix: 'provider.scene_6.loyalty_build.v1i2.[stories]',
+            extension: 'src',
+        },
+    },
+    {
+        peers: [
+            'provider.scene_6.loyalty_build.v2i5.[notes].i1.txt',
+            'provider.scene_6.loyalty_build.v2i5.[notes].i2.txt',
+        ],
+        output: {
+            prefix: 'provider.scene_6.loyalty_build.v2i5.[notes]',
+            extension: 'txt',
+        },
+    },
+    {
+        peers: [
+            'provider.scene_6.loyalty_build.v1i0.[draft]._.md',
+            'provider.scene_6.loyalty_build.v1i0.[draft].i1.md',
+        ],
+        output: {
+            prefix: 'provider.scene_6.loyalty_build.v1i0.[draft]',
+            extension: 'md',
+        },
+    },
+];
+describe('getPeerQualifiersOfOutputChoice', () => {
+    validCases.forEach(({ peers, output }) => {
+        describe(`peers ${output.prefix}`, () => {
+            peers.forEach((choice) => {
+                test(`returns correct prefix and extension for choice "${choice}"`, () => {
+                    expect((0, getPeerQualifiersOfOutputChoice_1.getPeerQualifiersOfOutputChoice)(choice)).toEqual(output);
+                });
+            });
+        });
+    });
+    const invalidCases = [
+    // 'provider.scene_6.loyalty_build.v1i2.[stories]', // no extension
+    // 'provider.scene_6.loyalty_build.v1i2.[stories]', // no extension
+    // 'just_something_random', // completely malformed
+    // 'file.without.any.structure', // another malformed
+    ];
+    describe('invalid input cases', () => {
+        invalidCases.forEach((input) => {
+            test(`throws BadRequestError for "${input}"`, () => {
+                expect(() => (0, getPeerQualifiersOfOutputChoice_1.getPeerQualifiersOfOutputChoice)(input)).toThrow(helpful_errors_1.BadRequestError);
+            });
+        });
+    });
+});
+//# sourceMappingURL=getPeerQualifiersOfOutputChoice.test.js.map

package/dist/logic/invoke/getPeerQualifiersOfOutputChoice.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPeerQualifiersOfOutputChoice.test.js","sourceRoot":"","sources":["../../../src/logic/invoke/getPeerQualifiersOfOutputChoice.test.ts"],"names":[],"mappings":";;AAAA,mDAAiD;AAEjD,uFAAoF;AAEpF,MAAM,UAAU,GAGV;IACJ;QACE,KAAK,EAAE;YACL,oDAAoD;YACpD,uDAAuD;YACvD,qDAAqD;YACrD,wDAAwD;YACxD,wDAAwD;YACxD,wDAAwD;YACxD,+DAA+D;YAC/D,4DAA4D;SAC7D;QACD,MAAM,EAAE;YACN,MAAM,EAAE,+CAA+C;YACvD,SAAS,EAAE,IAAI;SAChB;KACF;IACD;QACE,KAAK,EAAE;YACL,mDAAmD;YACnD,sDAAsD;SACvD;QACD,MAAM,EAAE;YACN,MAAM,EAAE,+CAA+C;YACvD,SAAS,EAAE,KAAK;SACjB;KACF;IACD;QACE,KAAK,EAAE;YACL,oDAAoD;YACpD,oDAAoD;SACrD;QACD,MAAM,EAAE;YACN,MAAM,EAAE,6CAA6C;YACrD,SAAS,EAAE,KAAK;SACjB;KACF;IACD;QACE,KAAK,EAAE;YACL,kDAAkD;YAClD,mDAAmD;SACpD;QACD,MAAM,EAAE;YACN,MAAM,EAAE,6CAA6C;YACrD,SAAS,EAAE,IAAI;SAChB;KACF;CACF,CAAC;AAEF,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QACvC,QAAQ,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE;YACtC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;gBACvB,IAAI,CAAC,oDAAoD,MAAM,GAAG,EAAE,GAAG,EAAE;oBACvE,MAAM,CAAC,IAAA,iEAA+B,EAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClE,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAa;IAC7B,mEAAmE;IACnE,mEAAmE;IACnE,mDAAmD;IACnD,qDAAqD;KACtD,CAAC;IAEF,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC7B,IAAI,CAAC,+BAA+B,KAAK,GAAG,EAAE,GAAG,EAAE;gBACjD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,iEAA+B,EAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAC1D,gCAAe,CAChB,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/logic/invoke/hooks/onInvokeAskInput.d.ts

@@ -0,0 +1,15 @@
+import { InvokeOpts } from '../../../domain/objects';
+import { InvokeHooks } from '../../../domain/objects/InvokeHooks';
+/**
+ * .what = hooks to call onInvokeAskInput
+ */
+export declare const onInvokeAskInput: (input: {
+    opts: InvokeOpts<{
+        ask: string;
+        config: string;
+    }>;
+    hooks: InvokeHooks;
+}) => InvokeOpts<{
+    ask: string;
+    config: string;
+}>;

package/dist/logic/invoke/hooks/onInvokeAskInput.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onInvokeAskInput = void 0;
+/**
+ * .what = hooks to call onInvokeAskInput
+ */
+const onInvokeAskInput = (input) => {
+    // call each of the opts translators, one at a time
+    let after = input.opts;
+    for (const translate of input.hooks.onInvokeAskInput)
+        after = translate(after);
+    // then return the final translation
+    return after;
+};
+exports.onInvokeAskInput = onInvokeAskInput;
+//# sourceMappingURL=onInvokeAskInput.js.map

package/dist/logic/invoke/hooks/onInvokeAskInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onInvokeAskInput.js","sourceRoot":"","sources":["../../../../src/logic/invoke/hooks/onInvokeAskInput.ts"],"names":[],"mappings":";;;AAGA;;GAEG;AACI,MAAM,gBAAgB,GAAG,CAAC,KAGhC,EAA+C,EAAE;IAChD,mDAAmD;IACnD,IAAI,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC;IACvB,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,gBAAgB;QAClD,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAE3B,oCAAoC;IACpC,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAXW,QAAA,gBAAgB,oBAW3B"}

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.7.2",
+  "version": "1.9.0",
   "repository": "ehmpathy/rhachet",
   "homepage": "https://github.com/ehmpathy/rhachet",
   "keywords": [
@@ -57,6 +57,7 @@
     "chalk": "4.1.2",
     "commander": "14.0.0",
     "domain-objects": "0.25.2",
+    "fast-glob": "3.3.3",
     "flattie": "1.1.1",
     "helpful-errors": "1.3.8",
     "openai": "5.8.2",