rhachet-roles-ehmpathy 1.2.0 → 1.4.0

package/dist/.test/genContextStitchTrail.d.ts

@@ -1,2 +1 @@
-import { ContextStitchTrail } from 'rhachet';
-export declare const genContextStitchTrail: () => ContextStitchTrail;
+export { genContextStitchTrail } from 'rhachet';

package/dist/.test/genContextStitchTrail.js

@@ -1,8 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.genContextStitchTrail = void 0;
-const genContextStitchTrail = () => ({
-    stitch: { trail: [] },
-});
-exports.genContextStitchTrail = genContextStitchTrail;
+var rhachet_1 = require("rhachet");
+Object.defineProperty(exports, "genContextStitchTrail", { enumerable: true, get: function () { return rhachet_1.genContextStitchTrail; } });
 //# sourceMappingURL=genContextStitchTrail.js.map

package/dist/.test/genContextStitchTrail.js.map

@@ -1 +1 @@
-{"version":3,"file":"genContextStitchTrail.js","sourceRoot":"","sources":["../../src/.test/genContextStitchTrail.ts"],"names":[],"mappings":";;;AAEO,MAAM,qBAAqB,GAAG,GAAuB,EAAE,CAAC,CAAC;IAC9D,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;CACtB,CAAC,CAAC;AAFU,QAAA,qBAAqB,yBAE/B"}
+{"version":3,"file":"genContextStitchTrail.js","sourceRoot":"","sources":["../../src/.test/genContextStitchTrail.ts"],"names":[],"mappings":";;;AAAA,mCAAgD;AAAvC,gHAAA,qBAAqB,OAAA"}

package/dist/logic/artifact/genStepArtDel.d.ts

@@ -0,0 +1,17 @@
+import { GStitcher, StitchStepCompute, Threads, RoleContext } from 'rhachet';
+import { Artifact } from 'rhachet-artifact';
+import { GitFile } from 'rhachet-artifact-git';
+/**
+ * .what = creates a compute step that deletes the contents of an artifact
+ * .why  = allows composer routes to purge the state of any artifact
+ */
+export declare const genStepArtDel: <TStitchee extends string, TArtee extends string, TThreads extends Threads<{ [K in TStitchee]: RoleContext<K, {
+    art: { [P in TArtee]: Artifact<typeof GitFile, string>; };
+}>; }>>({ stitchee, artee, mode, ...input }: {
+    stitchee: TStitchee;
+    artee: TArtee;
+    mode?: 'delete';
+    condition?: ({ threads }: {
+        threads: TThreads;
+    }) => 'SKIP' | 'EXEC';
+}) => StitchStepCompute<GStitcher<TThreads, import("simple-log-methods").ContextLogTrail & import("rhachet").ContextStitchTrail, "SKIP" | "EXEC">>;

package/dist/logic/artifact/genStepArtDel.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genStepArtDel = void 0;
+const rhachet_1 = require("rhachet");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+/**
+ * .what = creates a compute step that deletes the contents of an artifact
+ * .why  = allows composer routes to purge the state of any artifact
+ */
+const genStepArtDel = ({ stitchee, artee, mode = 'delete', ...input }) => new rhachet_1.StitchStepCompute({
+    form: 'COMPUTE',
+    readme: null,
+    slug: `[${stitchee}]<artifact:del>[${artee}]`,
+    stitchee,
+    invoke: async ({ threads }) => {
+        const thread = threads[stitchee];
+        const artifact = thread.context.stash.art[artee];
+        // evaluate the condition, if one exists
+        const decision = input.condition?.({ threads }) ?? 'EXEC';
+        if (decision === 'SKIP')
+            return { input: { mode, artifact }, output: 'SKIP' };
+        // otherwise, execute the delete
+        await artifact.del();
+        console.log(`🎨️  art.${mode}ed, impacted ${artifact.ref.uri.replace(await (0, rhachet_artifact_git_1.getGitRepoRoot)({ from: process.cwd() }), '')}\n`);
+        return { input: { mode, artifact }, output: 'EXEC' };
+    },
+});
+exports.genStepArtDel = genStepArtDel;
+//# sourceMappingURL=genStepArtDel.js.map

package/dist/logic/artifact/genStepArtDel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genStepArtDel.js","sourceRoot":"","sources":["../../../src/logic/artifact/genStepArtDel.ts"],"names":[],"mappings":";;;AAAA,qCAMiB;AAEjB,+DAA+D;AAE/D;;;GAGG;AACI,MAAM,aAAa,GAAG,CAa3B,EACA,QAAQ,EACR,KAAK,EACL,IAAI,GAAG,QAAQ,EACf,GAAG,KAAK,EAMT,EAAE,EAAE,CACH,IAAI,2BAAiB,CAEnB;IACA,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,IAAI,QAAQ,mBAAmB,KAAK,GAAG;IAC7C,QAAQ;IACR,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAS9B,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEjD,wCAAwC;QACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,MAAM,CAAC;QAC1D,IAAI,QAAQ,KAAK,MAAM;YACrB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAEvD,gCAAgC;QAChC,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CACT,YAAY,IAAI,gBAAgB,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CACtD,MAAM,IAAA,qCAAc,EAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,EAC7C,EAAE,CACH,IAAI,CACN,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACvD,CAAC;CACF,CAAC,CAAC;AA3DQ,QAAA,aAAa,iBA2DrB"}

package/dist/logic/artifact/genStepGrabCallerFeedbackToArtifact.js

@@ -23,6 +23,15 @@ const genStepGrabCallerFeedbackToArtifact = ({ stitchee, artee, }) => new rhache
             .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([
             {

package/dist/logic/artifact/genStepGrabCallerFeedbackToArtifact.js.map

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

package/dist/logic/artifact/setSkillOutputSrc.d.ts

@@ -0,0 +1,32 @@
+import { 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/logic/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 node_path_1 = require("node:path");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const type_fns_1 = require("type-fns");
+/**
+ * .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/logic/artifact/setSkillOutputSrc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setSkillOutputSrc.js","sourceRoot":"","sources":["../../../src/logic/artifact/setSkillOutputSrc.ts"],"names":[],"mappings":";;;AAAA,yCAAoC;AAEpC,+DAA0D;AAC1D,uCAA2C;AAE3C;;;;GAIG;AACI,MAAM,iBAAiB,GAAG,KAAK,EAAE,KAGvC,EAAE,EAAE,CACH,MAAM,IAAA,yCAAkB,EACtB;IACE,GAAG,EAAE,IAAA,6BAAqB,EAAC;QACzB,MAAM,EAAE,IAAA,+BAAuB,EAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;QAClD,SAAS,EAAE,MAAM;KAClB,CAAC;CACH,EACD,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC,GAAG,CAAC;IACJ,OAAO,EAAE,+BAA+B,CAAC,KAAK,CAAC;CAChD,CAAC,CAAC;AAdQ,QAAA,iBAAiB,qBAczB;AAEL;;GAEG;AACH,MAAM,+BAA+B,GAAG,CAAC,KAGxC,EAAE,EAAE;IACH,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC;IACtD,MAAM,MAAM,GAAG,IAAA,+BAAuB,EAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE1D,sBAAsB;IACtB,MAAM,QAAQ,GAAG;QACf;;;EAGF,KAAK,CAAC,IAAI,CAAC,GAAG;;;;KAIX,CAAC,IAAI,EAAE;QACR;qBACiB,KAAK,CAAC,QAAQ;KAC9B,CAAC,IAAI,EAAE;QACR,QAAQ;YACN,CAAC,CAAC;eACO,QAAQ;KAClB,CAAC,IAAI,EAAE;YACN,CAAC,CAAC,IAAI;QACR;kBACc,MAAM;KACnB,CAAC,IAAI,EAAE;QACR,KAAK,CAAC,IAAI,CAAC,UAAU;YACnB,CAAC,CAAC;kBACU,KAAK,CAAC,IAAI,CAAC,UAAU;KAClC,CAAC,IAAI,EAAE;YACN,CAAC,CAAC,IAAI;QACR,GAAG,MAAM,CAAC,OAAO,CACf,IAAA,eAAI,EAAC,KAAK,CAAC,IAAI,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAC9D,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACrB;MACA,GAAG,KAAK,KAAK;KACd,CAAC,IAAI,EAAE,CACP;QACD;;KAEC,CAAC,IAAI,EAAE;KACT,CAAC,MAAM,CAAC,oBAAS,CAAC,CAAC;IACpB,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF;;GAEG;AACI,MAAM,qBAAqB,GAAG,CAAC,MAAc,EAAiB,EAAE;IACrE,MAAM,GAAG,GAAG,IAAA,mBAAO,EAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,GAAG,IAAI,IAAI,CAAC;AACrB,CAAC,CAAC;AAHW,QAAA,qBAAqB,yBAGhC;AAEF;;;;GAIG;AACI,MAAM,uBAAuB,GAAG,CAAC,MAAc,EAAU,EAAE;IAChE,MAAM,GAAG,GAAG,IAAA,6BAAqB,EAAC,MAAM,CAAC,CAAC;IAE1C,mDAAmD;IACnD,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;QAC7B,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAE5D,mDAAmD;IACnD,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC,CAAC;AATW,QAAA,uBAAuB,2BASlC;AAEF;;;;GAIG;AACI,MAAM,qBAAqB,GAAG,CAAC,EACpC,MAAM,EACN,SAAS,GAIV,EAAU,EAAE;IACX,MAAM,GAAG,GAAG,IAAA,6BAAqB,EAAC,MAAM,CAAC,CAAC;IAE1C,qDAAqD;IACrD,IAAI,CAAC,GAAG;QAAE,OAAO,MAAM,GAAG,SAAS,CAAC;IAEpC,mCAAmC;IACnC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;AAClD,CAAC,CAAC;AAdW,QAAA,qBAAqB,yBAchC"}

package/dist/logic/context/genStitchStreamToDisk.d.ts

@@ -0,0 +1,13 @@
+import { 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/logic/context/genStitchStreamToDisk.js

@@ -0,0 +1,73 @@
+"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
+    .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/logic/context/genStitchStreamToDisk.js.map

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

package/dist/logic/roles/bhrain/.briefs/cognition/cog021.metaphor.galactic_spacetravel.[article].md

@@ -0,0 +1,42 @@
+# 🌌 .brief: llms as spaceships in the concept universe
+
+## 🪐 concept universe
+- **concept space = galaxy**
+  - the center is the **root concept**, a dense singularity.
+  - **radial outward** = instantiations (concrete stars, planets, moons).
+  - **angular shells** = abstraction layers (orbits around the core).
+- **concepts have gravity**
+  - dense, common, or familiar concepts exert strong pull.
+  - vague or imprecise addresses can get you **sucked into a local maximum** (orbiting around a nearby but wrong star).
+
+---
+
+## 🚀 llms as spaceships
+- **llms = thought-spaceships**
+  - engines capable of near-instant jumps across the conceptual galaxy.
+  - their raw power is speed, not direction.
+- **we = pilots**
+  - we chart the course and set the destination.
+  - piloting skill = crafting precise addresses that avoid gravitational traps.
+- **questions = navigation coordinates**
+  - granular input that encodes the target star system.
+  - precision determines whether you land on the right planet or drift to a gravitational neighbor.
+
+---
+
+## ⚠️ challenges of navigation
+1. **destination clarity**
+   - you must know *where in the galaxy you want to go*.
+   - without a clear conceptual map, your spaceship will default to the nearest strong pull.
+
+2. **address precision**
+   - the coordinate (question) must be exact.
+   - imprecise questions lead to being trapped in nearby but irrelevant orbits.
+   - precision cuts through gravitational noise to hit the right star.
+
+---
+
+## 🎯 pilot’s insight
+- **llms provide propulsion; humans provide navigation.**
+- the art is not in moving (llms do that instantly) but in **deciding where to go** and **formulating coordinates to arrive there.**
+- mastery = galactic cartography (understanding the shape of the universe) + piloting discipline (asking precise, gravitationally-aware questions).

package/dist/logic/roles/bhrain/.briefs/cognition/cog021.metaphor.galactic_spacetravel.[lesson].md

@@ -0,0 +1,60 @@
+# 🌌 .brief.lesson: piloting llms as spaceships in the concept universe
+
+## 💡 concept
+to use llms well, imagine them as **spaceships** traveling at lightspeed through a **conceptual galaxy**.
+the galaxy contains infinite **concepts** arranged in spheres of abstraction. each concept exerts **gravity**, pulling you in if your navigation is imprecise.
+your role as pilot is to chart the destination and give the ship accurate coordinates (questions).
+
+---
+
+## 📚 materials
+- **map of the galaxy** → the mental model of concept space (root at center, abstractions in shells, instantiations outward).
+- **spaceship (llm)** → fast, powerful engine but directionless without guidance.
+- **pilot’s controls (questions/prompts)** → the interface for steering.
+- **gravity awareness** → recognition that common or vague concepts will suck you into nearby orbits unless coordinates are exact.
+
+---
+
+## 🛠️ practice steps
+1. **orient the galaxy**
+   - sketch your concept in its root form.
+   - note layers of abstraction (outer shells) and concrete instances (radial outward).
+
+2. **define the destination**
+   - decide: are you heading to the core (abstract) or to an outer planet (specific case)?
+   - example: "justice" (core abstraction) vs. "traffic law fine in california" (outer instantiation).
+
+3. **set coordinates (formulate question)**
+   - express the question with the right precision.
+   - avoid vague inputs that leave gravity to decide the landing.
+
+4. **observe gravitational drift**
+   - check if the answer pulled you toward a nearby, high-gravity concept.
+   - if so, refine the coordinates.
+
+5. **refine and relaunch**
+   - adjust the wording of the question to escape local maxima.
+   - iterate until you land on the intended star system.
+
+---
+
+## 🎯 examples
+- **vague address** → "tell me about painting"
+  - gravity pulls to broad art history.
+
+- **precise coordinates** → "explain preparation steps for interior wall painting in a rental apartment"
+  - lands directly on the desired planet.
+
+- **mislanding correction**
+  - q: "how to fix leaks?" → sucked into plumbing.
+  - refine: "how to fix leaks in asphalt driveway sealant" → lands on the right surface.
+
+---
+
+## 🧭 pilot’s takeaway
+- **llms are engines** → they can take you anywhere, instantly.
+- **questions are star coordinates** → your precision determines the arrival point.
+- **concepts exert gravity** → imprecision will trap you in strong but wrong orbits.
+- **piloting skill = clarity + precision** → knowing where you want to go and addressing it sharply.
+
+---

package/dist/logic/roles/bhrain/.briefs/grammar/gerunds.1.why.common.[article].md

@@ -0,0 +1,32 @@
+# 🧩 why gerunds are so common
+
+## 🏗️ structural reasons
+- **nominalization shortcut**
+  instead of inventing a whole new noun, you can just attach *-ing* and turn an action into a subject/object
+  *e.g., “running is fun” vs. needing a special word like “race”*.
+- **versatility in syntax**
+  gerunds can function as subjects, objects, or complements without breaking grammar rules. this makes them handy “lego blocks” in sentence-building.
+
+---
+
+## 🔄 cognitive & communicative reasons
+- **focus on process, not just event**
+  gerunds highlight the *ongoingness* or *essence* of an action, not a single instance.
+  *e.g., “i like swimming” emphasizes the general activity, not one swim*.
+- **concept compression**
+  they condense complex actions into manageable noun-like units, letting us package experiences as “things” that can be talked about, compared, and reasoned with.
+
+---
+
+## 🌍 historical reasons
+- **natural evolution of english**
+  english lost many inflections over time. the *-ing* ending became multifunctional (present participle *and* gerund), making it easy to spread.
+- **cross-linguistic parallels**
+  most languages have some way of turning verbs into nouns (latin’s *-ndus*, spanish *-ar → -ando*, etc.). gerunds are english’s efficient version of that broader need.
+
+---
+
+## 📊 why “so common” in practice
+- they appear in **everyday talk** (*liking, doing, going*).
+- they’re needed for **abstract concepts** (*thinking, learning, understanding*).
+- they often replace **formal nouns** (*“procrastinating”* instead of *“procrastination”*).

package/dist/logic/roles/bhrain/.briefs/grammar/gerunds.1.why.term_smells.[article].md

@@ -0,0 +1,36 @@
+# 🧩 why gerunds can be "term smells"
+
+## 🚩 what is a "term smell"
+a **term smell** is like a code smell: a sign that a term may not be well-formed, clear, or fully thought through. it doesn’t always mean the term is wrong, but it hints at a lack of conceptual distillation.
+
+---
+
+## 🧩 why gerunds raise suspicion
+- **process disguised as essence**
+  gerunds often point to *doing* rather than a distilled *thing*.
+  *e.g., “learning” as a noun refers to the act, but what we might mean is “knowledge” (the distilled outcome).*
+
+- **vagueness of scope**
+  gerunds blur whether we mean one instance (*a running race*), the general process (*running in general*), or an abstract quality (*endurance*). this ambiguity can signal sloppy conceptualization.
+
+- **placeholder convenience**
+  gerunds are easy to generate. instead of carefully naming the core concept, we default to *-ing*.
+  *e.g., “networking” instead of specifying “relationships,” “contacts,” or “repute.”*
+
+---
+
+## 🌀 signs of insufficient distillation
+- the term **describes activity** but doesn’t identify the **underlying resource, structure, or outcome**.
+  *“teaching” vs. “education,” “building” vs. “structure,” “thinking” vs. “thought.”*
+
+- the term **feels broad or leaky**, covering multiple senses at once.
+  *“writing” could mean the act, the system, the product, or the skill.*
+
+- the term **fails test of substitution**: if we try to define it without the *-ing* form, we get sharper distinctions.
+  *“planning” → could resolve to “plan” (artifact), “process of coordination” (activity), or “strategy” (essence).*
+
+---
+
+## 📌 takeaway
+gerunds are common because they’re convenient.
+they’re **term smells** because convenience can mask lack of distillation — using the *doing* form instead of naming the **essence** of what’s really meant.

package/dist/logic/roles/bhrain/.briefs/grammar/gerunds.1.why.term_smells.detection.[lesson].md

@@ -0,0 +1,73 @@
+# 🧩 .brief.lesson: `gerund smell test`
+
+## 💡 concept
+a **gerund smell test** helps detect when a concept named with *-ing* is really a sign of insufficient distillation. it forces us to sharpen fuzzy process-terms into precise nouns that capture the essence.
+
+---
+
+## 🎯 purpose
+- prevent sloppy terminology by avoiding “process-as-thing” placeholders.
+- guide thinkers toward more distilled, essential names.
+- improve clarity and transferability of concepts in writing, design, or theory.
+
+---
+
+## 🧪 the smell test
+
+### 1. substitution test
+> can the gerund be replaced with a sharper noun?
+
+- *“learning” → knowledge*
+- *“building” → structure*
+- *“teaching” → education*
+- *“thinking” → thought*
+
+if the substitution makes meaning clearer, the gerund is a smell.
+
+---
+
+### 2. scope clarity test
+> does the gerund blur multiple senses?
+
+- *“writing”* could mean:
+  - the act (scribbling on paper)
+  - the product (a text)
+  - the system (written language)
+  - the skill (literacy)
+
+if it leaks across senses, the gerund is a smell.
+
+---
+
+### 3. outcome test
+> does the gerund describe activity instead of the result?
+
+- *“planning”* → could resolve into:
+  - **plan** (artifact)
+  - **strategy** (essence)
+  - **coordination** (process with defined outcome)
+
+if the activity is masking a clearer outcome, the gerund is a smell.
+
+---
+
+### 4. convenience test
+> is the gerund just the easiest way out?
+
+- *“networking”* → a shortcut for “relationships,” “contacts,” or “repute.”
+if the term looks like it was coined because *-ing* was handy, it’s a smell.
+
+---
+
+## 📚 practice exercise
+take common gerunds and refine them:
+- **thinking** → thought, cognition, reason
+- **doing** → action, execution, behavior
+- **training** → instruction, discipline, practice
+- **meeting** → gathering, session, council
+
+---
+
+## 📌 takeaway
+if a term ends in *-ing*, run it through the **gerund smell test**.
+if it fails even one check, distill it to its essence. clarity improves, concepts sharpen, and your system of terms becomes more robust.

package/dist/logic/roles/bhrain/.briefs/grammar/gerunds.2.tactic.eliminate.[article].md

@@ -0,0 +1,55 @@
+# 🧩 .brief.article: `eliminate gerunds in prose`
+
+## 🌟 introduction
+the removal of gerunds (*-ing* forms used as nouns) is a deliberate tactic to sharpen language. gerunds often act as **term smells** — signs that the concept has not been distilled to its essence. by replacement with precise nouns, prose becomes clearer, more direct, and more transferable.
+
+---
+
+## 🎯 purpose of the tactic
+- **distill essence**: shift from description of activity to naming of outcome, resource, or structure.
+- **remove ambiguity**: avoid blurred meanings (e.g., *“text”* vs. the act of inscription).
+- **increase precision**: force the author to clarify whether they mean *plan*, *strategy*, *education*, *knowledge*, etc.
+- **discipline thought**: strengthen conceptual rigor by avoiding convenient but vague shortcuts.
+
+---
+
+## 🔍 how the tactic works
+1. **scan text for gerund forms** (*-ing words that function as nouns*).
+   - examples: *thought, plan, structure, network* as replacements.
+2. **apply the smell test**: substitution, scope, outcome, and convenience.
+3. **replace with distilled nouns** that capture the core meaning.
+   - *thought* instead of “thinking”
+   - *plan / strategy / coordination* instead of “planning”
+   - *relationships / contacts / repute* instead of “networking”
+
+---
+
+## 📚 examples
+
+### before
+- *“effective planning is key to success.”*
+### after
+- *“an effective plan is key to success.”*
+- *“strategy is key to success.”*
+
+---
+
+### before
+- *“her teaching inspired the students.”*
+### after
+- *“her instruction inspired the students.”*
+- *“her education work inspired the students.”*
+
+---
+
+### before
+- *“thinking shapes culture.”*
+### after
+- *“thought shapes culture.”*
+- *“reason shapes culture.”*
+
+---
+
+## 📌 takeaway
+the **tactic of gerund removal** forces every concept to pass through the fire of distillation. fuzzy process-terms yield to sharper essences, ambiguity reduces, and conceptual clarity strengthens.
+in disciplined prose, *every gerund is guilty until proven otherwise*.