rhachet 1.7.1 → 1.8.0

package/dist/contract/cli/invoke.js

@@ -8,6 +8,7 @@ const rhachet_artifact_git_1 = require("rhachet-artifact-git");
 const assureUniqueRoles_1 = require("../../logic/invoke/assureUniqueRoles");
 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");
 /**
@@ -47,6 +48,7 @@ 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, invokeChoose_1.invokeChoose)({ program });
     (0, invokeAsk_1.invokeAsk)({ program, config: { path: configPath }, registries });
     // invoke it
     await program.parseAsync(input.args, { from: 'user' }).catch((error) => {

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/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":"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"}

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

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

package/dist/domain/objects/index.js

@@ -34,4 +34,5 @@ __exportStar(require("./RoleSkill"), exports);
 __exportStar(require("./RoleSkillArgGetter"), exports);
 __exportStar(require("./RoleTrait"), exports);
 __exportStar(require("./Template"), exports);
+__exportStar(require("./InvokeOpts"), 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"}
+{"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"}

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/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.1",
+  "version": "1.8.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",