rhachet-roles-bhrain 0.1.0

package/dist/domain.operations/artifact/genStepGrabCallerFeedbackToArtifact.js

@@ -0,0 +1,100 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genStepGrabCallerFeedbackToArtifact = void 0;
+const inquirer_1 = __importDefault(require("inquirer"));
+const rhachet_1 = require("rhachet");
+/**
+ * .what = creates a compute step where the static 'caller' gives feedback on another role's artifact
+ * .why  = enables human review or annotation flow to be dynamically targeted, but statically sourced
+ */
+const genStepGrabCallerFeedbackToArtifact = ({ stitchee, artee, }) => new rhachet_1.StitchStepCompute({
+    form: 'COMPUTE',
+    slug: `[caller]<feedback><capture>[${stitchee}.${artee}]`,
+    readme: `asks caller for feedback on ${stitchee}'s ${artee} and stores it in caller.art.feedback`,
+    stitchee: 'caller',
+    invoke: async ({ threads }) => {
+        // grab the artifact to review
+        const subjectThread = threads[stitchee];
+        const target = await subjectThread.context.stash.art[artee]
+            .get()
+            .expect('isPresent');
+        // show the reviewer what they're reviewing
+        console.log(`\n📝 feedback target: ${target.uri}\n`);
+        // if this is running in an isolated attempt thread, then the user has no way to supply feedback
+        if (process.env.RHACHET_ATTEMPT)
+            return {
+                input: target,
+                output: {
+                    feedback: null,
+                    reason: 'in isolated attempt thread, no way to receive feedback',
+                },
+            };
+        // prompt to see if they want to leave notes
+        const { hasNotes } = await inquirer_1.default.prompt([
+            {
+                type: 'list',
+                name: 'hasNotes',
+                message: 'have notes?',
+                choices: ['no notes', 'yes notes'],
+            },
+        ]);
+        // grab the feedback art
+        const callerThread = threads.caller;
+        const feedbackArt = callerThread.context.stash.art.feedback;
+        // exit early if they have nothing to add
+        if (hasNotes === 'no notes') {
+            await feedbackArt.del(); // purge old notes, if they existed
+            return {
+                input: target,
+                output: { feedback: null },
+            };
+        }
+        // grab feedback using inline input or open editor via ':edit'
+        const feedback = await (async () => {
+            // prompt inline first
+            const { fromInline } = await inquirer_1.default.prompt([
+                {
+                    type: 'input',
+                    name: 'fromInline',
+                    message: 'enter feedback (type ":edit" to open editor):',
+                },
+            ]);
+            const isEditorRequest = fromInline.trim() === ':edit';
+            if (!isEditorRequest) {
+                // return inline input directly (support \n)
+                return fromInline.replace(/\\n/g, '\n');
+            }
+            // fallback to editor if requested
+            const { fromEditor } = await inquirer_1.default.prompt([
+                {
+                    type: 'editor',
+                    name: 'fromEditor',
+                    message: 'enter feedback in editor:',
+                    default: '# write your feedback above this line\n',
+                },
+            ]);
+            return fromEditor;
+        })();
+        // write the feedback to caller.art.feedback
+        const updated = await feedbackArt.set({
+            content: feedback,
+        });
+        console.log('');
+        console.log(`🎙️  heard, saved to ${feedbackArt.ref.uri}`);
+        console.log('');
+        console.log(feedback);
+        console.log('');
+        console.log('🫡  on it!');
+        console.log('');
+        // return the feedback file
+        return {
+            input: target,
+            output: { feedback: updated },
+        };
+    },
+});
+exports.genStepGrabCallerFeedbackToArtifact = genStepGrabCallerFeedbackToArtifact;
+//# sourceMappingURL=genStepGrabCallerFeedbackToArtifact.js.map

package/dist/domain.operations/artifact/genStepGrabCallerFeedbackToArtifact.js.map

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

package/dist/domain.operations/artifact/genStepResetFeedback.d.ts

@@ -0,0 +1,12 @@
+import { type GStitcher, type RoleContext, StitchStepCompute, type Threads } from 'rhachet';
+import type { Artifact } from 'rhachet-artifact';
+import { type GitFile } from 'rhachet-artifact-git';
+export declare const stepResetFeedback: StitchStepCompute<GStitcher<Threads<{
+    caller: RoleContext<'caller', {
+        art: {
+            feedback: Artifact<typeof GitFile>;
+        };
+    }>;
+}>, import("as-procedure").ContextLogTrail & import("rhachet").ContextStitchTrail, {
+    feedback: null;
+}>>;

package/dist/domain.operations/artifact/genStepResetFeedback.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stepResetFeedback = void 0;
+const rhachet_1 = require("rhachet");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+/**
+ * .what = creates a compute step that clears out the caller.art.feedback file
+ * .why = ensures feedback state is reset before new input is gathered
+ */
+const genStepResetFeedback = (input) => new rhachet_1.StitchStepCompute({
+    form: 'COMPUTE',
+    slug: `[caller]<feedback><reset>`,
+    readme: `clears caller.art.feedback (resets it to null)`,
+    stitchee: 'caller',
+    invoke: async ({ threads }) => {
+        const callerThread = threads.caller;
+        const feedbackArt = callerThread.context.stash.art.feedback;
+        await feedbackArt.del();
+        console.log(`🧹 [feedback]<reset>: ${feedbackArt.ref.uri.replace(await (0, rhachet_artifact_git_1.getGitRepoRoot)({ from: process.cwd() }), '')}\n`);
+        return {
+            input: null,
+            output: { feedback: null },
+        };
+    },
+});
+exports.stepResetFeedback = genStepResetFeedback();
+//# sourceMappingURL=genStepResetFeedback.js.map

package/dist/domain.operations/artifact/genStepResetFeedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genStepResetFeedback.js","sourceRoot":"","sources":["../../../src/domain.operations/artifact/genStepResetFeedback.ts"],"names":[],"mappings":";;;AAAA,qCAMiB;AAEjB,+DAAoE;AAGpE;;;GAGG;AACH,MAAM,oBAAoB,GAAG,CAY3B,KAAa,EACb,EAAE,CACF,IAAI,2BAAiB,CAEnB;IACA,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,2BAA2B;IACjC,MAAM,EAAE,gDAAgD;IACxD,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,MAE5B,CAAC;QAEF,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;QAE5D,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC;QAExB,OAAO,CAAC,GAAG,CACT,yBAAyB,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAClD,MAAM,IAAA,qCAAc,EAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,EAC7C,EAAE,CACH,IAAI,CACN,CAAC;QAEF,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC3B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEQ,QAAA,iBAAiB,GAAG,oBAAoB,EAAE,CAAC"}

package/dist/domain.operations/artifact/genStepSwapArtifact.d.ts

@@ -0,0 +1,57 @@
+import { type GStitcher, type RoleContext, StitchStepCompute, type Threads } from 'rhachet';
+import type { Artifact } from 'rhachet-artifact';
+/**
+ * .what = a step which takes an getArteeFrom(@[$stitchee]) and sets it as @[$stitchee].[$artee]
+ * .why.cases =
+ *   - enables swap out of which artifact is in inflight between steps (e.g., <diverge> -> <collect>)
+ *   - enables swap out of which artifact is in upstream between flights (e.g., <diverge> -> <collect)
+ *
+ * !: do not use this directly. useGenStepSwapArtifact should be used directly instead for a pit-of-success
+ */
+export declare const genStepSwapArtifact: <TThreads extends Threads<any>, TFromStitchee extends keyof TThreads & string, TFromArtee extends keyof TThreads[TFromStitchee]["context"]["stash"]["art"] & string, TOntoStitchee extends keyof TThreads & string, TOntoArtee extends string>({ use: from, as: onto, }: {
+    use: {
+        stitchee: TFromStitchee;
+        artee: TFromArtee;
+    };
+    as: {
+        stitchee: TOntoStitchee;
+        artee: TOntoArtee;
+    };
+}) => StitchStepCompute<GStitcher<Threads<{ [K in TFromStitchee | TOntoStitchee]: RoleContext<K, {
+    art: K extends TFromStitchee ? K extends TOntoStitchee ? Record<string, unknown> & { [P in TFromArtee]: Artifact<any, string>; } & { [P_1 in TOntoArtee]: Artifact<any, string> | null; } : Record<string, unknown> & { [P_2 in TFromArtee]: Artifact<any, string>; } : K extends TOntoStitchee ? Record<string, unknown> & { [P_3 in TOntoArtee]: Artifact<any, string> | null; } : Record<string, unknown>;
+}>; }>, import("as-procedure").ContextLogTrail & import("rhachet").ContextStitchTrail, {
+    from: {
+        stitchee: TFromStitchee;
+        artee: TFromArtee;
+    } & {
+        artifact: Pick<Artifact<any>, 'ref'>;
+    };
+    onto: {
+        stitchee: TOntoStitchee;
+        artee: TOntoArtee;
+    };
+}>>;
+/**
+ *.what = prepares a pre-bound generator for `SwapArtifact` steps, using a specific `Threads<T>` context
+ * .why = enables inline, type-safe creation of `SwapArtifact` steps without repeating thread type declarations
+ *   - ensures that artifact keys (`use`, `as`) exist within the declared thread structure
+ *   - streamlines definition of multiple swaps in routes without type repetition
+ *
+ * @example
+ * const swapArt = useGenStepSwapArtifactFor<StitcherDesired['threads']>();
+ * swapArt({
+ *   // set @thinker[inflight] = @thinker.inflights.diverge
+ *   use: { stitchee: 'thinker', artee: 'inflights.diverge' },
+ *   as:  { stitchee: 'thinker', artee: 'inflight' },
+ * });
+ */
+export declare const useGenStepSwapArtifactFor: <TThreads extends Threads<any>>() => <TFromStitchee extends keyof TThreads & string, TFromArtee extends keyof TThreads[TFromStitchee]["context"]["stash"]["art"] & string, TOntoStitchee extends keyof TThreads & string, TOntoArtee extends string>(input: {
+    use: {
+        stitchee: TFromStitchee;
+        artee: TFromArtee;
+    };
+    as: {
+        stitchee: TOntoStitchee;
+        artee: TOntoArtee;
+    };
+}) => StitchStepCompute<GStitcher<TThreads, GStitcher['context'], any>>;

package/dist/domain.operations/artifact/genStepSwapArtifact.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useGenStepSwapArtifactFor = exports.genStepSwapArtifact = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const rhachet_1 = require("rhachet");
+/**
+ * .what = a step which takes an getArteeFrom(@[$stitchee]) and sets it as @[$stitchee].[$artee]
+ * .why.cases =
+ *   - enables swap out of which artifact is in inflight between steps (e.g., <diverge> -> <collect>)
+ *   - enables swap out of which artifact is in upstream between flights (e.g., <diverge> -> <collect)
+ *
+ * !: do not use this directly. useGenStepSwapArtifact should be used directly instead for a pit-of-success
+ */
+const genStepSwapArtifact = ({ use: from, as: onto, }) => new rhachet_1.StitchStepCompute({
+    form: 'COMPUTE',
+    slug: `[${onto.stitchee}]<artifact:swap>[${onto.artee}]`,
+    readme: `set @${onto.stitchee}.art.${onto.artee} = @${from.stitchee}.art.${from.artee}`,
+    stitchee: onto.stitchee,
+    invoke: async ({ threads }) => {
+        const fromThread = threads[from.stitchee];
+        const ontoThread = threads[onto.stitchee];
+        const artifact = fromThread.context.stash.art[from.artee] ??
+            helpful_errors_1.UnexpectedCodePathError.throw(`could not resolve artifact from @${from.stitchee}[art:${from.artee}]`, {
+                fromDef: from,
+                fromStash: fromThread.context.stash,
+            });
+        ontoThread.context.stash.art[onto.artee] = artifact;
+        return {
+            input: { from, onto },
+            output: {
+                from: {
+                    stitchee: from.stitchee,
+                    artee: from.artee,
+                    artifact: { ref: artifact.ref },
+                },
+                onto,
+            },
+        };
+    },
+});
+exports.genStepSwapArtifact = genStepSwapArtifact;
+/**
+ *.what = prepares a pre-bound generator for `SwapArtifact` steps, using a specific `Threads<T>` context
+ * .why = enables inline, type-safe creation of `SwapArtifact` steps without repeating thread type declarations
+ *   - ensures that artifact keys (`use`, `as`) exist within the declared thread structure
+ *   - streamlines definition of multiple swaps in routes without type repetition
+ *
+ * @example
+ * const swapArt = useGenStepSwapArtifactFor<StitcherDesired['threads']>();
+ * swapArt({
+ *   // set @thinker[inflight] = @thinker.inflights.diverge
+ *   use: { stitchee: 'thinker', artee: 'inflights.diverge' },
+ *   as:  { stitchee: 'thinker', artee: 'inflight' },
+ * });
+ */
+const useGenStepSwapArtifactFor = () => (input) => (0, exports.genStepSwapArtifact)(input);
+exports.useGenStepSwapArtifactFor = useGenStepSwapArtifactFor;
+//# sourceMappingURL=genStepSwapArtifact.js.map

package/dist/domain.operations/artifact/genStepSwapArtifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genStepSwapArtifact.js","sourceRoot":"","sources":["../../../src/domain.operations/artifact/genStepSwapArtifact.ts"],"names":[],"mappings":";;;AAAA,mDAAyD;AACzD,qCAMiB;AAGjB;;;;;;;GAOG;AACI,MAAM,mBAAmB,GAAG,CAOjC,EACA,GAAG,EAAE,IAAI,EACT,EAAE,EAAE,IAAI,GAIT,EAAE,EAAE,CACH,IAAI,2BAAiB,CA4BnB;IACA,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,oBAAoB,IAAI,CAAC,KAAK,GAAG;IACxD,MAAM,EAAE,QAAQ,IAAI,CAAC,QAAQ,QAAQ,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,QAAQ,QAAQ,IAAI,CAAC,KAAK,EAAE;IACvF,QAAQ,EAAE,IAAI,CAAC,QAAQ;IACvB,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAOvC,CAAC;QACF,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAOvC,CAAC;QAEF,MAAM,QAAQ,GACZ,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;YACxC,wCAAuB,CAAC,KAAK,CAC3B,oCAAoC,IAAI,CAAC,QAAQ,QAAQ,IAAI,CAAC,KAAK,GAAG,EACtE;gBACE,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK;aACpC,CACF,CAAC;QAEJ,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;QAEpD,OAAO;YACL,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;YACrB,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,QAAQ,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE;iBAChC;gBACD,IAAI;aACL;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAzFQ,QAAA,mBAAmB,uBAyF3B;AAEL;;;;;;;;;;;;;GAaG;AACI,MAAM,yBAAyB,GACpC,GAAkC,EAAE,CACpC,CAME,KAGD,EAAqE,EAAE,CACtE,IAAA,2BAAmB,EAMjB,KAAK,CAAQ,CAAC;AAlBP,QAAA,yBAAyB,6BAkBlB"}

package/dist/domain.operations/artifact/setSkillOutputSrc.d.ts

@@ -0,0 +1,32 @@
+import type { InvokeOpts } from 'rhachet';
+/**
+ * .what = saves an artifact of the .src that created an output file
+ * .why =
+ *   - a .src file helps callers trace the sequence that lead to some output. it makes outputs easier to repeat, since you always have the exact input at hand, for record
+ */
+export declare const setSkillOutputSrc: (input: {
+    skillUri: string;
+    opts: InvokeOpts<{
+        ask: string;
+        output: string;
+    }>;
+}) => Promise<import("rhachet-artifact-git").GitFile>;
+/**
+ * detect the trailing extension (with the dot), or null if none
+ */
+export declare const detectOutputExtension: (output: string) => string | null;
+/**
+ * .what = removes the attempt value, regardless of extension
+ * - if there's a real extension: strip ".iN" before it
+ * - if no real extension but ends with ".iN": strip it
+ */
+export declare const asOutputWithoutAttempts: (output: string) => string;
+/**
+ * .what = replaces the extension of an output file
+ * - if extension is real: replace it
+ * - if extension is ".iN": append new extension instead of replacing
+ */
+export declare const asOutputWithExtension: ({ output, extension, }: {
+    output: string;
+    extension: `.${string}`;
+}) => string;

package/dist/domain.operations/artifact/setSkillOutputSrc.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asOutputWithExtension = exports.asOutputWithoutAttempts = exports.detectOutputExtension = exports.setSkillOutputSrc = void 0;
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const type_fns_1 = require("type-fns");
+const node_path_1 = require("node:path");
+/**
+ * .what = saves an artifact of the .src that created an output file
+ * .why =
+ *   - a .src file helps callers trace the sequence that lead to some output. it makes outputs easier to repeat, since you always have the exact input at hand, for record
+ */
+const setSkillOutputSrc = async (input) => await (0, rhachet_artifact_git_1.genArtifactGitFile)({
+    uri: (0, exports.asOutputWithExtension)({
+        output: (0, exports.asOutputWithoutAttempts)(input.opts.output),
+        extension: '.src',
+    }),
+}, { versions: true }).set({
+    content: castInvokeOptsToSrcFileContents(input),
+});
+exports.setSkillOutputSrc = setSkillOutputSrc;
+/**
+ * .what = a procedure to cast from invoke opts into .src file contents
+ */
+const castInvokeOptsToSrcFileContents = (input) => {
+    // detect the attempt number
+    const attempts = process.env.RHACHET_ATTEMPTS ?? null;
+    const output = (0, exports.asOutputWithoutAttempts)(input.opts.output);
+    // rebuild the request
+    const sections = [
+        `
+ASK=$(cat <<'ASK_EOF'
+
+${input.opts.ask}
+
+ASK_EOF
+)
+    `.trim(),
+        `
+npx rhachet act -s ${input.skillUri} \\
+    `.trim(),
+        attempts
+            ? `
+  --attempts ${attempts} \\
+    `.trim()
+            : null,
+        `
+  --output     '${output}' \\
+    `.trim(),
+        input.opts.references
+            ? `
+  --references '${input.opts.references}' \\
+    `.trim()
+            : null,
+        ...Object.entries((0, type_fns_1.omit)(input.opts, ['attempts', 'ask', 'output', 'references'])).map(([key, value]) => `
+  --${key} '${value}' \\
+    `.trim()),
+        `
+  --ask "$ASK";
+    `.trim(),
+    ].filter(type_fns_1.isPresent);
+    return sections.join('\n');
+};
+/**
+ * detect the trailing extension (with the dot), or null if none
+ */
+const detectOutputExtension = (output) => {
+    const ext = (0, node_path_1.extname)(output);
+    return ext || null;
+};
+exports.detectOutputExtension = detectOutputExtension;
+/**
+ * .what = removes the attempt value, regardless of extension
+ * - if there's a real extension: strip ".iN" before it
+ * - if no real extension but ends with ".iN": strip it
+ */
+const asOutputWithoutAttempts = (output) => {
+    const ext = (0, exports.detectOutputExtension)(output);
+    // case: has real extension (like .md, .json, etc.)
+    if (ext && !/\.i\d+$/.test(ext))
+        return output.replace(new RegExp(`\\.i\\d+${ext}$`), ext);
+    // case: no extension, or extension is itself ".iN"
+    return output.replace(/\.i\d+$/, '');
+};
+exports.asOutputWithoutAttempts = asOutputWithoutAttempts;
+/**
+ * .what = replaces the extension of an output file
+ * - if extension is real: replace it
+ * - if extension is ".iN": append new extension instead of replacing
+ */
+const asOutputWithExtension = ({ output, extension, }) => {
+    const ext = (0, exports.detectOutputExtension)(output);
+    // if no original extension, just append this new one
+    if (!ext)
+        return output + extension;
+    // otherwise, replace the extension
+    return output.slice(0, -ext.length) + extension;
+};
+exports.asOutputWithExtension = asOutputWithExtension;
+//# sourceMappingURL=setSkillOutputSrc.js.map

package/dist/domain.operations/artifact/setSkillOutputSrc.js.map

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

package/dist/domain.operations/context/genStitchStreamToDisk.d.ts

@@ -0,0 +1,13 @@
+import { type ContextStitchTrail } from 'rhachet';
+/**
+ * .what = an event stream consumer which streams emitted events to disk
+ * .how =
+ *   - emits stitch set events observably to a standard .rhachet subdir, relative to the target dir
+ *   - transforms the events for maximum observability in their serialized format
+ */
+export declare const genStitchStreamToDisk: (input: {
+    /**
+     * .what = the directory relative to which to instantiate the .rhachet stream sink
+     */
+    dir: string;
+}) => Required<ContextStitchTrail['stitch']>['stream'];

package/dist/domain.operations/context/genStitchStreamToDisk.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genStitchStreamToDisk = void 0;
+const uni_time_1 = require("@ehmpathy/uni-time");
+const rhachet_1 = require("rhachet");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const simple_in_memory_cache_1 = require("simple-in-memory-cache");
+const type_fns_1 = require("type-fns");
+const with_simple_caching_1 = require("with-simple-caching");
+// todo: lift into string-fns or rhachet-artifact-git
+const sanitizeForFilename = (input) => input
+    // replace invalid characters
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: <explanation>
+    .replace(/[<>:"/\\|?*\x00-\x1F]/g, '_')
+    // collapse whitespace into underscore
+    .replace(/\s+/g, '_')
+    // remove trailing dots or spaces
+    .replace(/[. ]+$/, '')
+    // make sure reserved names aren’t returned bare
+    .replace(/^(con|prn|aux|nul|com\d|lpt\d)$/i, '_$1');
+// declare where the stream will be emitted to // todo: move via hook into rhachet to centralize; declaration of emitter != mount of emitter. ideally, log on mount
+const onMount = (0, with_simple_caching_1.withSimpleCaching)((input) => {
+    console.log(`🪡  stitch set event stream can be monitored at this dir: ${input.sinkSubdir}`);
+    console.log(); // newline
+}, { cache: (0, simple_in_memory_cache_1.createCache)() });
+/**
+ * .what = an event stream consumer which streams emitted events to disk
+ * .how =
+ *   - emits stitch set events observably to a standard .rhachet subdir, relative to the target dir
+ *   - transforms the events for maximum observability in their serialized format
+ */
+const genStitchStreamToDisk = (input) => {
+    // declare the directory into which the events will be streamed
+    const sinkSupdir = (0, rhachet_artifact_git_1.getArtifactObsDir)({ uri: `${input.dir}/stream` }); // e.g., src/domain/ -> src/domain/stream -> src/domain/.rhachet/stream
+    const invokedAt = sanitizeForFilename((0, uni_time_1.asUniDateTime)(new Date()));
+    const sinkSubdir = `${sinkSupdir}/i${invokedAt}`;
+    // declare how to sink emitted events to that directory
+    const emit = async (event) => {
+        // mock the onmount hook
+        onMount({ sinkSubdir });
+        // compose the event path prefix
+        const uriPrefix = [
+            sinkSubdir,
+            sanitizeForFilename([
+                'at',
+                event.occurredAt,
+                event.stitch.stitcher?.slug ?? '___',
+                event.stitch.stitcher?.form ?? '___',
+                event.stitch.uuid,
+            ]
+                .filter(type_fns_1.isPresent)
+                .join('.')),
+        ].join('/');
+        // always emit the raw event; // todo: do we ever need this? seems to takeup disk space too rapidly
+        await (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: `${uriPrefix}.event.json`,
+        }).set({ content: JSON.stringify(event, null, 2) });
+        // if its an imagine event, then also separately emit the input and output for observability, if input and output had standard deprompt stitch
+        if (event.stitch.stitcher?.form === rhachet_1.StitcherForm.IMAGINE) {
+            if (typeof event.stitch.input?.prompt === 'string')
+                await (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                    uri: `${uriPrefix}.prompt.input.md`,
+                }).set({ content: event.stitch.input.prompt });
+            if (typeof event.stitch.output?.content === 'string')
+                await (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                    uri: `${uriPrefix}.prompt.output.md`,
+                }).set({ content: event.stitch.output.content });
+        }
+    };
+    // return the stream with observable to disk emitter
+    return { emit };
+};
+exports.genStitchStreamToDisk = genStitchStreamToDisk;
+//# sourceMappingURL=genStitchStreamToDisk.js.map

package/dist/domain.operations/context/genStitchStreamToDisk.js.map

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

package/dist/domain.operations/hooks/decodeDocOutputPath.d.ts

@@ -0,0 +1,21 @@
+type DocVersions = {
+    variant: number | null;
+    instance: number | null;
+};
+type Decoded = {
+    prefix: string;
+    doctype: string;
+    versions: DocVersions;
+    extension: string | null;
+};
+/**
+ * parses a doc output path like:
+ *   ...persp_pro.v1i2.[stories].v1.i3.md
+ * into:
+ *   - doctype: "stories"
+ *   - prefix:  "...persp_pro.v1i2."
+ *   - versions: { variant: 1, instance: 3 }
+ *   - extension: "md"
+ */
+export declare const decodeDocOutputPath: (inputPath: string) => Decoded;
+export {};

package/dist/domain.operations/hooks/decodeDocOutputPath.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeDocOutputPath = void 0;
+const helpful_errors_1 = require("helpful-errors");
+/**
+ * parses a doc output path like:
+ *   ...persp_pro.v1i2.[stories].v1.i3.md
+ * into:
+ *   - doctype: "stories"
+ *   - prefix:  "...persp_pro.v1i2."
+ *   - versions: { variant: 1, instance: 3 }
+ *   - extension: "md"
+ */
+const decodeDocOutputPath = (inputPath) => {
+    // find the LAST [doctype], where [doctype] cant be before a `/`
+    const lastDoctypeMatch = inputPath.match(/^(.*)\[(\w+)\]([^/]*)$/i);
+    if (!lastDoctypeMatch) {
+        throw new helpful_errors_1.BadRequestError('could not find any [doctype] in referenced path', { path: inputPath });
+    }
+    const beforeAndDot = lastDoctypeMatch[1]; // should end with the dot before [doctype], e.g., "...v1i2."
+    const doctype = lastDoctypeMatch[2]; // inside the brackets
+    const after = lastDoctypeMatch[3] || ''; // tail after the closing ]
+    // ensure prefix ends exactly before the bracket (without dot suffix, if any)
+    const prefix = beforeAndDot.endsWith('.')
+        ? beforeAndDot.slice(0, -1)
+        : beforeAndDot;
+    // parse tail tokens after the closing bracket, e.g. ".v1.i3.md", "._.md", ".md", etc.
+    // we’ll split on '.' and ignore empties so ".v1.i3.md" -> ["v1","i3","md"]
+    const tokens = after.split('.').filter(Boolean);
+    let variant = null;
+    let instance = null;
+    let extension = null;
+    for (const t of tokens) {
+        if (/^v\d+$/i.test(t)) {
+            variant = parseInt(t.slice(1), 10);
+            continue;
+        }
+        if (/^i\d+$/i.test(t)) {
+            instance = parseInt(t.slice(1), 10);
+            continue;
+        }
+        if (t === '_') {
+            // explicit “no attempt” marker – ignore for versions; not an extension
+            continue;
+        }
+        // anything else we treat as the extension; if multiple remain, the last wins
+        extension = t;
+    }
+    return {
+        prefix,
+        doctype,
+        versions: { variant, instance },
+        extension,
+    };
+};
+exports.decodeDocOutputPath = decodeDocOutputPath;
+//# sourceMappingURL=decodeDocOutputPath.js.map

package/dist/domain.operations/hooks/decodeDocOutputPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeDocOutputPath.js","sourceRoot":"","sources":["../../../src/domain.operations/hooks/decodeDocOutputPath.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAUjD;;;;;;;;GAQG;AACI,MAAM,mBAAmB,GAAG,CAAC,SAAiB,EAAW,EAAE;IAChE,gEAAgE;IAChE,MAAM,gBAAgB,GAAG,SAAS,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACpE,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,IAAI,gCAAe,CACvB,iDAAiD,EACjD,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,gBAAgB,CAAC,CAAC,CAAE,CAAC,CAAC,6DAA6D;IACxG,MAAM,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAE,CAAC,CAAC,sBAAsB;IAC5D,MAAM,KAAK,GAAG,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,2BAA2B;IAEpE,6EAA6E;IAC7E,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC;QACvC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3B,CAAC,CAAC,YAAY,CAAC;IAEjB,sFAAsF;IACtF,2EAA2E;IAC3E,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEhD,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,SAAS,GAAkB,IAAI,CAAC;IAEpC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,SAAS;QACX,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YACd,uEAAuE;YACvE,SAAS;QACX,CAAC;QACD,6EAA6E;QAC7E,SAAS,GAAG,CAAC,CAAC;IAChB,CAAC;IAED,OAAO;QACL,MAAM;QACN,OAAO;QACP,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE;QAC/B,SAAS;KACV,CAAC;AACJ,CAAC,CAAC;AAlDW,QAAA,mBAAmB,uBAkD9B"}

package/dist/domain.operations/hooks/execTranslateDocOutputPath.d.ts

@@ -0,0 +1,20 @@
+import type { ContextLogTrail } from 'as-procedure';
+import type { InvokeOpts } from 'rhachet';
+/**
+ * .what = execute the translation of a doc output path
+ * .why =
+ *   - given @translate(references.1)
+ *   - then, want to apply a standard transformation onto it
+ * .how =
+ *   - .[doctype] replaced
+ *   - .vNiN trail markers preserved as prefix before .[doctype]
+ *   - .v1 always started with, to facilitate subsequent trails
+ *   - .rel(...) optionally re-roots the prefix directory relatively
+ */
+export declare const execTranslateDocOutputPath: (opts: InvokeOpts<{
+    ask: string;
+    config: string;
+}>, context?: ContextLogTrail) => InvokeOpts<{
+    ask: string;
+    config: string;
+}>;