rhachet-roles-ehmpathy 1.15.12 → 1.15.13

package/dist/roles/designer/.briefs/pit-of-success.md

@@ -1,70 +0,0 @@
-## 🧠 `.brief.designer.pit-of-success`
-
-### 🧠 topic: the "pit of success"
-**why we design systems to naturally guide users toward the right outcome**
-
----
-
-### 🎯 goal
-build interfaces, flows, and defaults that make the **right path the easiest path** — where success isn’t just possible, it’s hard to miss.
-
----
-
-### 🕳 metaphor: pit of success
-
-> a system where users "fall into" the right outcome
-> — not by being perfect, but by following the path of least resistance.
-
-opposite of this is the **pit of despair**
-> where any slight move can throw you down into unexpected errors and wasted time.
-
----
-
-### ✅ why the "pit of success" matters
-
-- **reduces friction** — users don’t need deep understanding to get it right
-- **reduces support burden** — fewer errors, less need for rescue
-- **builds confidence** — users feel smart, not stupid
-- **supports scalability** — new users succeed without handholding
-- **encourages trust** — when success feels natural, users keep going
-
-> software should **make the right thing easy** and the wrong thing **hard or impossible**.
-
----
-
-### 🛠 tips to create it
-
-- **smart defaults** — sensible, safe choices pre-filled
-- **clear next steps** — obvious buttons, flows, and language
-- **constrained input** — prevent invalid states instead of reacting to them
-- **progressive disclosure** — complexity revealed only when needed
-- **stateful feedback** — show users what changed and why
-- **fail fast** — surface issues *immediately*, not after damage is done
-
----
-
-### 🧱 core design principle
-
-> success should be the **path of least resistance**
-> failure should require **active effort or deviation**
-
-we engineer **invisible safety rails**, not pop-up warning signs.
-
----
-
-### 🧠 behavioral insight
-
-users don’t read manuals — they feel their way forward.
-if success depends on correctness, users fail.
-if success depends on momentum, users win.
-
----
-
-### 🧩 final synthesis
-
-> software should **produce a pit of success** for the user:
-> the right path should feel obvious, safe, and rewarding —
-> and the wrong path should be hard to access or easy to recover from.
-
-design for **gravity** —
-so the system pulls people toward success, not traps them in failure.

package/dist/roles/designer/.briefs/pit-of-success.stub.md

@@ -1,3 +0,0 @@
-software should produce a pit-of-success for the user
-
-it should be hard to do the wrong thing

package/dist/roles/designer/getDesignerBrief.Options.codegen.d.ts

@@ -1,10 +0,0 @@
-/**
- * .what = the options for the briefs available to role Designer
- * .note = codegened via:
- * ```sh
- *  npx tsx src/contract/commands/codegenBriefOptions.ts
- * ```
- */
-declare const options: readonly ["declarative-over-imperative.md", "pit-of-success.md"];
-export type BriefOptionDesigner = (typeof options)[number];
-export {};

package/dist/roles/designer/getDesignerBrief.Options.codegen.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * .what = the options for the briefs available to role Designer
- * .note = codegened via:
- * ```sh
- *  npx tsx src/contract/commands/codegenBriefOptions.ts
- * ```
- */
-const options = [
-    'declarative-over-imperative.md',
-    'pit-of-success.md',
-];
-//# sourceMappingURL=getDesignerBrief.Options.codegen.js.map

package/dist/roles/designer/getDesignerBrief.Options.codegen.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"getDesignerBrief.Options.codegen.js","sourceRoot":"","sources":["../../../src/roles/designer/getDesignerBrief.Options.codegen.ts"],"names":[],"mappings":";;AAAA;;;;;;GAMG;AACH,MAAM,OAAO,GAAG;IACd,gCAAgC;IAChC,mBAAmB;CACX,CAAC"}

package/dist/roles/designer/getDesignerBrief.d.ts

@@ -1,13 +0,0 @@
-import type { Artifact } from 'rhachet-artifact';
-import { type GitFile } from 'rhachet-artifact-git';
-import type { BriefOptionDesigner } from './getDesignerBrief.Options.codegen';
-/**
- * .what = loads an artifact:brief distilled for the mechanic to reference, from the `.briefs` directory
- * .why = enables reusable knowledge downloads for mechanic contexts (e.g., matrix-movie style)
- */
-export declare const getDesignerBrief: (key: BriefOptionDesigner) => Artifact<typeof GitFile>;
-/**
- * .what = loads multiple artifact:brief distilled for the mechanic to reference, from the `.briefs` directory
- * .why = enables reusable knowledge downloads for mechanic contexts (e.g., matrix-movie style)
- */
-export declare const getDesignerBriefs: (keys: BriefOptionDesigner[]) => Artifact<typeof GitFile>[];

package/dist/roles/designer/getDesignerBrief.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDesignerBriefs = exports.getDesignerBrief = void 0;
-const rhachet_artifact_git_1 = require("rhachet-artifact-git");
-/**
- * .what = loads an artifact:brief distilled for the mechanic to reference, from the `.briefs` directory
- * .why = enables reusable knowledge downloads for mechanic contexts (e.g., matrix-movie style)
- */
-const getDesignerBrief = (key) => {
-    return (0, rhachet_artifact_git_1.genArtifactGitFile)({
-        uri: `${__dirname}/.briefs/${key}`,
-    });
-};
-exports.getDesignerBrief = getDesignerBrief;
-/**
- * .what = loads multiple artifact:brief distilled for the mechanic to reference, from the `.briefs` directory
- * .why = enables reusable knowledge downloads for mechanic contexts (e.g., matrix-movie style)
- */
-const getDesignerBriefs = (keys) => keys.map(exports.getDesignerBrief);
-exports.getDesignerBriefs = getDesignerBriefs;
-//# sourceMappingURL=getDesignerBrief.js.map

package/dist/roles/designer/getDesignerBrief.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"getDesignerBrief.js","sourceRoot":"","sources":["../../../src/roles/designer/getDesignerBrief.ts"],"names":[],"mappings":";;;AACA,+DAAwE;AAIxE;;;GAGG;AACI,MAAM,gBAAgB,GAAG,CAC9B,GAAwB,EACE,EAAE;IAC5B,OAAO,IAAA,yCAAkB,EAAC;QACxB,GAAG,EAAE,GAAG,SAAS,YAAY,GAAG,EAAE;KACnC,CAAC,CAAC;AACL,CAAC,CAAC;AANW,QAAA,gBAAgB,oBAM3B;AAEF;;;GAGG;AACI,MAAM,iBAAiB,GAAG,CAC/B,IAA2B,EACC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,wBAAgB,CAAC,CAAC;AAF/C,QAAA,iBAAiB,qBAE8B"}

package/dist/roles/designer/outlineDistilisys/loopOutlineDistilisys.d.ts

@@ -1,26 +0,0 @@
-import { type GStitcher, type RoleContext, type Threads } from 'rhachet';
-import type { Artifact } from 'rhachet-artifact';
-import type { GitFile } from 'rhachet-artifact-git';
-import type { ContextOpenAI } from '../../../access/sdk/sdkOpenAi';
-type StitcherDesired = GStitcher<Threads<{
-    designer: RoleContext<'designer', {
-        art: {
-            roadmap: Artifact<typeof GitFile>;
-            distilisys: Artifact<typeof GitFile>;
-        };
-    }>;
-    caller: RoleContext<'caller', {
-        ask: string;
-        art: {
-            feedback: Artifact<typeof GitFile>;
-        };
-    }>;
-}>, ContextOpenAI & GStitcher['context'], {
-    content: string;
-}>;
-/**
- * .what = loop until caller confirms no more notes
- * todo: generalize this loop wrapper onto any stitcher
- */
-export declare const loopOutlineDistilisys: import("rhachet").Stitcher<StitcherDesired>;
-export {};

package/dist/roles/designer/outlineDistilisys/loopOutlineDistilisys.js

@@ -1,53 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loopOutlineDistilisys = void 0;
-const rhachet_1 = require("rhachet");
-const genStepGrabCallerFeedbackToArtifact_1 = require("../../../domain.operations/artifact/genStepGrabCallerFeedbackToArtifact");
-const stepOutlineDistilisys_1 = require("./stepOutlineDistilisys");
-/**
- * .what = await feedback
- */
-const stepGetFeedback = (0, genStepGrabCallerFeedbackToArtifact_1.genStepGrabCallerFeedbackToArtifact)({
-    stitchee: 'designer',
-    artee: 'distilisys',
-});
-/**
- * .what = iteration of imagine + feedback
- */
-const routeImagineThenFeedback = (0, rhachet_1.asStitcher)((0, rhachet_1.genStitchRoute)({
-    slug: '[designer]<outline>[distilisys]<iterate>-><feedback>',
-    readme: '@[designer]<outline>[distilisys] then @[caller]<feedback>',
-    sequence: [stepOutlineDistilisys_1.stepOutlineDistilisys, stepGetFeedback],
-}));
-/**
- * .what = looks at feedback artifact to decide whether to repeat or halt
- */
-const stepDecideHasNotes = new rhachet_1.StitchStepCompute({
-    form: 'COMPUTE',
-    slug: `[caller]<feedback><hasNotes?>`,
-    stitchee: 'caller',
-    readme: 'checks if the last feedback was null (no notes)',
-    invoke: async ({ threads }) => {
-        const feedback = await threads.caller.context.stash.art.feedback.get();
-        return {
-            input: { feedback },
-            output: { choice: feedback ? 'repeat' : 'release' },
-        };
-    },
-});
-/**
- * .what = loop until caller confirms no more notes
- * todo: generalize this loop wrapper onto any stitcher
- */
-exports.loopOutlineDistilisys = (0, rhachet_1.asStitcherFlat)((0, rhachet_1.genStitchCycle)({
-    slug: '[designer]<outline>[distilisys]<🌀loop>',
-    readme: '@[designer]<outline> -> @[caller]<feedback> -> { notes? repeat, none?: <release>[distilisys] }',
-    repeatee: routeImagineThenFeedback,
-    decider: stepDecideHasNotes,
-    halter: {
-        threshold: {
-            repetitions: 10,
-        },
-    },
-}));
-//# sourceMappingURL=loopOutlineDistilisys.js.map

package/dist/roles/designer/outlineDistilisys/loopOutlineDistilisys.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"loopOutlineDistilisys.js","sourceRoot":"","sources":["../../../../src/roles/designer/outlineDistilisys/loopOutlineDistilisys.ts"],"names":[],"mappings":";;;AAAA,qCASiB;AAKjB,6HAA0H;AAE1H,mEAAgE;AA2BhE;;GAEG;AACH,MAAM,eAAe,GAAG,IAAA,yEAAmC,EAAC;IAC1D,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,YAAY;CACpB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,wBAAwB,GAAG,IAAA,oBAAU,EACzC,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,sDAAsD;IAC5D,MAAM,EAAE,2DAA2D;IACnE,QAAQ,EAAE,CAAC,6CAAqB,EAAE,eAAe,CAAC;CACnD,CAAC,CACH,CAAC;AAEF;;GAEG;AACH,MAAM,kBAAkB,GAAG,IAAI,2BAAiB,CAM9C;IACA,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,+BAA+B;IACrC,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,iDAAiD;IACzD,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QACvE,OAAO;YACL,KAAK,EAAE,EAAE,QAAQ,EAAE;YACnB,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE;SACpD,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH;;;GAGG;AACU,QAAA,qBAAqB,GAAG,IAAA,wBAAc,EACjD,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,yCAAyC;IAC/C,MAAM,EACJ,gGAAgG;IAClG,QAAQ,EAAE,wBAAwB;IAClC,OAAO,EAAE,kBAAkB;IAC3B,MAAM,EAAE;QACN,SAAS,EAAE;YACT,WAAW,EAAE,EAAE;SAChB;KACF;CACF,CAAC,CACH,CAAC"}

package/dist/roles/designer/outlineDistilisys/stepOutlineDistilisys.d.ts

@@ -1,22 +0,0 @@
-import { type GStitcher, type RoleContext, type Threads } from 'rhachet';
-import type { Artifact } from 'rhachet-artifact';
-import type { GitFile } from 'rhachet-artifact-git';
-import { type ContextOpenAI } from '../../../access/sdk/sdkOpenAi';
-type StitcherDesired = GStitcher<Threads<{
-    designer: RoleContext<'designer', {
-        art: {
-            roadmap: Artifact<typeof GitFile>;
-            distilisys: Artifact<typeof GitFile>;
-        };
-    }>;
-    caller: RoleContext<'caller', {
-        ask: string;
-        art: {
-            feedback: Artifact<typeof GitFile>;
-        };
-    }>;
-}>, ContextOpenAI & GStitcher['context'], {
-    content: string;
-}>;
-export declare const stepOutlineDistilisys: import("rhachet").Stitcher<StitcherDesired>;
-export {};

package/dist/roles/designer/outlineDistilisys/stepOutlineDistilisys.js

@@ -1,57 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.stepOutlineDistilisys = void 0;
-const rhachet_1 = require("rhachet");
-const sdkOpenAi_1 = require("../../../access/sdk/sdkOpenAi");
-const genStepArtSet_1 = require("../../../domain.operations/artifact/genStepArtSet");
-const getDesignerBrief_1 = require("../../../roles/designer/getDesignerBrief");
-const getEcologistBrief_1 = require("../../../roles/ecologist/getEcologistBrief");
-const getMechanicBrief_1 = require("../../../roles/mechanic/getMechanicBrief");
-const template = (0, rhachet_1.genTemplate)({
-    ref: { uri: __filename.replace('.ts', '.template.md') },
-    getVariables: async ({ threads }) => ({
-        ...(await (0, rhachet_1.getTemplateVarsFromRoleInherit)({ thread: threads.designer })),
-        ask: threads.caller.context.stash.ask,
-        briefs: await (0, rhachet_1.getTemplateValFromArtifacts)({
-            artifacts: [
-                // cool to see explicit "cross-train" scenes
-                ...(0, getEcologistBrief_1.getEcologistBriefs)(['distilisys/sys101.distilisys.grammar.md']),
-                ...(0, getDesignerBrief_1.getDesignerBriefs)(['declarative-over-imperative.md']),
-                ...(0, getMechanicBrief_1.getMechanicBriefs)([
-                    'architecture/ubiqlang.md',
-                    'style.names.treestruct.md',
-                    'architecture/directional-dependencies.md',
-                    'architecture/bounded-contexts.md',
-                ]),
-            ],
-        }),
-        brief: {
-            distilisys: await (0, rhachet_1.getTemplateValFromArtifacts)({
-                artifacts: [
-                    ...(0, getEcologistBrief_1.getEcologistBriefs)(['distilisys/sys101.distilisys.grammar.md']),
-                ],
-            }),
-        },
-        feedback: (await threads.caller.context.stash.art.feedback.get())?.content ?? '',
-        inflight: (await threads.designer.context.stash.art.distilisys.get())?.content ??
-            '',
-        roadmap: (await threads.designer.context.stash.art.roadmap.get())?.content ?? '',
-    }),
-});
-const stepImagine = (0, rhachet_1.genStepImagineViaTemplate)({
-    slug: '[designer]<outline>[distilisys]<imagine>',
-    stitchee: 'designer',
-    readme: 'intent(design an outline.distilisys for the ask)',
-    template,
-    imagine: sdkOpenAi_1.sdkOpenAi.imagine,
-});
-const stepArtSet = (0, genStepArtSet_1.genStepArtSet)({
-    stitchee: 'designer',
-    artee: 'distilisys',
-});
-exports.stepOutlineDistilisys = (0, rhachet_1.asStitcherFlat)((0, rhachet_1.genStitchRoute)({
-    slug: '[designer]<outline>[distilisys]',
-    readme: '@[designer]<outline>[distilisys] -> [distilisys]',
-    sequence: [stepImagine, stepArtSet],
-}));
-//# sourceMappingURL=stepOutlineDistilisys.js.map

package/dist/roles/designer/outlineDistilisys/stepOutlineDistilisys.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stepOutlineDistilisys.js","sourceRoot":"","sources":["../../../../src/roles/designer/outlineDistilisys/stepOutlineDistilisys.ts"],"names":[],"mappings":";;;AAAA,qCAUiB;AAIjB,yDAA0E;AAC1E,iFAA8E;AAC9E,2EAAyE;AACzE,8EAA4E;AAC5E,2EAAyE;AA2BzE,MAAM,QAAQ,GAAG,IAAA,qBAAW,EAA6B;IACvD,GAAG,EAAE,EAAE,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,EAAE;IACvD,YAAY,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACpC,GAAG,CAAC,MAAM,IAAA,wCAA8B,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG;QACrC,MAAM,EAAE,MAAM,IAAA,qCAA2B,EAAC;YACxC,SAAS,EAAE;gBACT,4CAA4C;gBAC5C,GAAG,IAAA,sCAAkB,EAAC,CAAC,yCAAyC,CAAC,CAAC;gBAClE,GAAG,IAAA,oCAAiB,EAAC,CAAC,gCAAgC,CAAC,CAAC;gBACxD,GAAG,IAAA,oCAAiB,EAAC;oBACnB,0BAA0B;oBAC1B,2BAA2B;oBAC3B,0CAA0C;oBAC1C,kCAAkC;iBACnC,CAAC;aACH;SACF,CAAC;QACF,KAAK,EAAE;YACL,UAAU,EAAE,MAAM,IAAA,qCAA2B,EAAC;gBAC5C,SAAS,EAAE;oBACT,GAAG,IAAA,sCAAkB,EAAC,CAAC,yCAAyC,CAAC,CAAC;iBACnE;aACF,CAAC;SACH;QACD,QAAQ,EACN,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE;QACxE,QAAQ,EACN,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO;YACpE,EAAE;QACJ,OAAO,EACL,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE;KAC1E,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,IAAA,mCAAyB,EAAkB;IAC7D,IAAI,EAAE,0CAA0C;IAChD,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,kDAAkD;IAC1D,QAAQ;IACR,OAAO,EAAE,qBAAS,CAAC,OAAO;CAC3B,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC;IAC/B,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,YAAY;CACpB,CAAC,CAAC;AAEU,QAAA,qBAAqB,GAAG,IAAA,wBAAc,EACjD,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,iCAAiC;IACvC,MAAM,EAAE,kDAAkD;IAC1D,QAAQ,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;CACpC,CAAC,CACH,CAAC"}

package/dist/roles/designer/outlineDistilisys/stepOutlineDistilisys.template.md

@@ -1,173 +0,0 @@
-@[ecologist]<distill><system> from roadmap
-
----
-
-.intent
-- extract the **underlying ecosystem** described by an implementation roadmap
-- map the roadmap into structured [resources], <mechanisms>, and {drivers}, and {drivers}, via distilisys language
-- treat the roadmap as describing the system that will exist — not the story of how it was built
-- if feedback is provided, revise or expand the diagram accordingly
-- **treat the roadmap as describing the system that will exist — not the story of how it was built**
-
-
-.mnemonic
-> don’t describe the construction site
-> describe the building once it’s open and running
-
-.illustrate
-- how will folks use it? -> what cascade of [resource] -> <mechanism> -> [resource] will that produce?
-- why will folks use it? -> what {drivers} propel them to do so?
-
-.required
-- distinguish ![system:maintainer] type actors -vs- @[system:user] type actors
-- focus primarily on @[system:users]. its ok to ignore ![system:maintainer]
-- we only care about how actors will <use>, <operate>, or <engage-with> the system
-- all terms must be exclusively camelCase, never PascalCase
-
----
-
-.format.example
-```md
-
-# 👤 @[actors]
-
-  - @[actorA] - who uses the system, why we care
-  - @[actorB] - who uses the system, why we care
-  - ![actorC] - who maintains the system, why we care
-  - ... // can be many
-
----
-
-# 📦 [resources]
-
-  - [resourceA] — what it is, why we care
-  - [resourceB] — ..
-  - ... // can be many
-
----
-
-# ⚙️ <mechanisms>
-
-  - <mechanismA> — what it does
-  - <mechanismB> — what it transforms or enables
-  - ... // can be many
-
----
-
-# ⚡ {drivers}
-
-  ## 💰 actor
-
-    - @[actorN]{+incentive:A} - some motivator; why does this actor engage with the system? and how is it relevant
-    - @[actorN]{+incentive:B} - some motivator; (e.g., {want:[time]++}, {want:[money]++}, {want:[status]++}, {want:[safety]++}, etc)
-    - @[actorY]{-decentive:A} - some dissuader, why does this actor disengage w/ the system? and how is it relevant
-    - ... // can be many
-
-  ## 🌪️ world
-
-    - &[causeZ]{+tailwind:effectA} — some accelerant / catalyst, why we care
-    - &[causeY]{+tailwind:effectB} —
-    - &[causeX]{-headwind:effectA} — some barrier / friction, why we care
-    - &[causeA]{-headwind:effectB} —
-    - ... // can be many
-    // note: there may also be none, if this is not a real-world system (e.g,. software only)
-
----
-
-## 🔁 system flows
-
-### {flow:slug-1}
-
-  summary:
-    @[actorA] applies <mechanismSummary1> against [resourceM] to produce [resourceN], because they want {+incentive:xyz}
-
-
-  distilisys:
-    ```sys
-    @[actorA]<mechanismSummary1>[resourceM] => [resourceN]
-
-    =
-
-      @[actorA][resorceX]
-        -> <mechanismC>
-        -> [resourceB]
-        -> <mechanismA>
-        -> ... // actually fill this out, to some terminal output
-
-          => {+incentive:xyz}
-    ```
-
-### {flow:slug-2}
-
-  summary:
-    @[actorB] applies <mechanismSummaryN> against [resourceY] to produce [resourceZ], because they wany {+incentive:123}, in spite of {-decentive:abc}
-
-  distilisys:
-    ```sys
-    @[actorB]<mechanismSummaryN>[resourceY] => [resourceZ]
-
-    =
-      @[actorB][ResourceY]
-      -> ... // actually fill this out
-      -> [resourceN]
-      -> <mechanismN>
-      -> ... // actually fill this out, to some terminal output
-
-        => {+decentive:123}
-        => {-decentive:abc}
-    ```
-
-### {flow.slug-n+...}
-
-```
-
-
----
-
-.tips
-- for api's, a common actor name is @[caller], if they dont have a more specific role
-- lookout for ![maintainer] actors like ![developers], if they're actually applicable.
-
----
-
-.rules
-- [resources] = any object, entity, material, or product that exists *within the produced system itself*
-- <mechanisms> = any behavior or flow that the system performs once constructed
-- {drivers} = forces that enable or resist the system’s intended behavior
-- use grouping to show dependencies or oppositional forces (e.g., tailwinds vs headwinds)
-- the output should **stand alone** as a structural diagram, separate from the roadmap steps
-
----
-
-.example.input = a decomposable roadmap with milestones for implementing a CLI system
-
-.example.output = a distilisys diagram that models the ecosystem of that implementation plan
-
----
-
-.brief.distilisys
-$.rhachet{brief.distilisys}
-
----
-
-.ask =
-```md
-$.rhachet{ask}
-```
-
-.roadmap =
-```md
-$.rhachet{roadmap}
-```
-
-.inflight? =
-```md
-$.rhachet{inflight}
-```
-
-.feedback? =
-```md
-$.rhachet{feedback}
-```
-
-.output = a `distilisys` diagram that models the structure and dynamics of the roadmap. if inflight is provided, EXCLUSIVELY FOCUS ON THE FEEDBACK

package/dist/roles/designer/outlineRoadmap/loopOutlineRoadmap.d.ts

@@ -1,26 +0,0 @@
-import { type GStitcher, type RoleContext, type Threads } from 'rhachet';
-import type { Artifact } from 'rhachet-artifact';
-import type { GitFile } from 'rhachet-artifact-git';
-import type { ContextOpenAI } from '../../../access/sdk/sdkOpenAi';
-type StitcherDesired = GStitcher<Threads<{
-    designer: RoleContext<'designer', {
-        ask: string;
-        art: {
-            roadmap: Artifact<typeof GitFile>;
-        };
-    }>;
-    caller: RoleContext<'caller', {
-        ask: string;
-        art: {
-            feedback: Artifact<typeof GitFile>;
-        };
-    }>;
-}>, ContextOpenAI & GStitcher['context'], {
-    content: string;
-}>;
-/**
- * .what = loop until caller confirms no more notes
- * todo: generalize this loop wrapper onto any stitcher
- */
-export declare const loopOutlineRoadmap: import("rhachet").Stitcher<StitcherDesired>;
-export {};

package/dist/roles/designer/outlineRoadmap/loopOutlineRoadmap.js

@@ -1,53 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loopOutlineRoadmap = void 0;
-const rhachet_1 = require("rhachet");
-const genStepGrabCallerFeedbackToArtifact_1 = require("../../../domain.operations/artifact/genStepGrabCallerFeedbackToArtifact");
-const stepOutlineRoadmap_1 = require("./stepOutlineRoadmap");
-/**
- * .what = await feedback
- */
-const stepGetFeedback = (0, genStepGrabCallerFeedbackToArtifact_1.genStepGrabCallerFeedbackToArtifact)({
-    stitchee: 'designer',
-    artee: 'roadmap',
-});
-/**
- * .what = iteration of imagine + feedback
- */
-const routeImagineThenFeedback = (0, rhachet_1.asStitcher)((0, rhachet_1.genStitchRoute)({
-    slug: '[designer]<outline>[roadmap]<iterate>-><feedback>',
-    readme: '@[designer]<outline>[roadmap] then @[caller]<feedback>',
-    sequence: [stepOutlineRoadmap_1.stepOutlineRoadmap, stepGetFeedback],
-}));
-/**
- * .what = looks at feedback artifact to decide whether to repeat or halt
- */
-const stepDecideHasNotes = new rhachet_1.StitchStepCompute({
-    form: 'COMPUTE',
-    slug: `[caller]<feedback><hasNotes?>`,
-    stitchee: 'caller',
-    readme: 'checks if the last feedback was null (no notes)',
-    invoke: async ({ threads }) => {
-        const feedback = await threads.caller.context.stash.art.feedback.get();
-        return {
-            input: { feedback },
-            output: { choice: feedback ? 'repeat' : 'release' },
-        };
-    },
-});
-/**
- * .what = loop until caller confirms no more notes
- * todo: generalize this loop wrapper onto any stitcher
- */
-exports.loopOutlineRoadmap = (0, rhachet_1.asStitcherFlat)((0, rhachet_1.genStitchCycle)({
-    slug: '[designer]<outline>[roadmap]<🌀loop>',
-    readme: '@[designer]<outline> -> @[caller]<feedback> -> { notes? repeat, none?: <release>[roadmap] }',
-    repeatee: routeImagineThenFeedback,
-    decider: stepDecideHasNotes,
-    halter: {
-        threshold: {
-            repetitions: 10,
-        },
-    },
-}));
-//# sourceMappingURL=loopOutlineRoadmap.js.map

package/dist/roles/designer/outlineRoadmap/loopOutlineRoadmap.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"loopOutlineRoadmap.js","sourceRoot":"","sources":["../../../../src/roles/designer/outlineRoadmap/loopOutlineRoadmap.ts"],"names":[],"mappings":";;;AAAA,qCASiB;AAKjB,6HAA0H;AAE1H,6DAA0D;AA6B1D;;GAEG;AACH,MAAM,eAAe,GAAG,IAAA,yEAAmC,EAAC;IAC1D,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,SAAS;CACjB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,wBAAwB,GAAG,IAAA,oBAAU,EACzC,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,mDAAmD;IACzD,MAAM,EAAE,wDAAwD;IAChE,QAAQ,EAAE,CAAC,uCAAkB,EAAE,eAAe,CAAC;CAChD,CAAC,CACH,CAAC;AAEF;;GAEG;AACH,MAAM,kBAAkB,GAAG,IAAI,2BAAiB,CAM9C;IACA,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,+BAA+B;IACrC,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,iDAAiD;IACzD,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QACvE,OAAO;YACL,KAAK,EAAE,EAAE,QAAQ,EAAE;YACnB,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE;SACpD,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH;;;GAGG;AACU,QAAA,kBAAkB,GAAG,IAAA,wBAAc,EAC9C,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,sCAAsC;IAC5C,MAAM,EACJ,6FAA6F;IAC/F,QAAQ,EAAE,wBAAwB;IAClC,OAAO,EAAE,kBAAkB;IAC3B,MAAM,EAAE;QACN,SAAS,EAAE;YACT,WAAW,EAAE,EAAE;SAChB;KACF;CACF,CAAC,CACH,CAAC"}

package/dist/roles/designer/outlineRoadmap/stepOutlineRoadmap.d.ts

@@ -1,22 +0,0 @@
-import { type GStitcher, type RoleContext, type Threads } from 'rhachet';
-import type { Artifact } from 'rhachet-artifact';
-import type { GitFile } from 'rhachet-artifact-git';
-import { type ContextOpenAI } from '../../../access/sdk/sdkOpenAi';
-type StitcherDesired = GStitcher<Threads<{
-    designer: RoleContext<'designer', {
-        ask: string;
-        art: {
-            roadmap: Artifact<typeof GitFile>;
-        };
-    }>;
-    caller: RoleContext<'caller', {
-        ask: string;
-        art: {
-            feedback: Artifact<typeof GitFile>;
-        };
-    }>;
-}>, ContextOpenAI & GStitcher['context'], {
-    content: string;
-}>;
-export declare const stepOutlineRoadmap: import("rhachet").Stitcher<StitcherDesired>;
-export {};

package/dist/roles/designer/outlineRoadmap/stepOutlineRoadmap.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.stepOutlineRoadmap = void 0;
-const rhachet_1 = require("rhachet");
-const sdkOpenAi_1 = require("../../../access/sdk/sdkOpenAi");
-const genStepArtSet_1 = require("../../../domain.operations/artifact/genStepArtSet");
-const getDesignerBrief_1 = require("../../../roles/designer/getDesignerBrief");
-const getEcologistBrief_1 = require("../../../roles/ecologist/getEcologistBrief");
-const getMechanicBrief_1 = require("../../../roles/mechanic/getMechanicBrief");
-const template = (0, rhachet_1.genTemplate)({
-    ref: { uri: __filename.replace('.ts', '.template.md') },
-    getVariables: async ({ threads }) => ({
-        ...(await (0, rhachet_1.getTemplateVarsFromRoleInherit)({ thread: threads.designer })),
-        ask: threads.designer.context.stash.ask,
-        briefs: await (0, rhachet_1.getTemplateValFromArtifacts)({
-            artifacts: [
-                // cool to see explicit "cross-train" scenes
-                ...(0, getEcologistBrief_1.getEcologistBriefs)(['distilisys/sys101.distilisys.grammar.md']),
-                ...(0, getDesignerBrief_1.getDesignerBriefs)(['declarative-over-imperative.md']),
-                ...(0, getMechanicBrief_1.getMechanicBriefs)([
-                    'architecture/ubiqlang.md',
-                    'style.names.treestruct.md',
-                    'architecture/directional-dependencies.md',
-                    'architecture/bounded-contexts.md',
-                ]),
-            ],
-        }),
-        feedback: (await threads.caller.context.stash.art.feedback.get())?.content ?? '',
-        inflight: (await threads.designer.context.stash.art.roadmap.get())?.content ?? '',
-    }),
-});
-const stepImagine = (0, rhachet_1.genStepImagineViaTemplate)({
-    slug: '[designer]<outline>[roadmap]<imagine>',
-    stitchee: 'designer',
-    readme: 'intent(design an outline.roadmap for the ask)',
-    template,
-    imagine: sdkOpenAi_1.sdkOpenAi.imagine,
-});
-const stepArtSet = (0, genStepArtSet_1.genStepArtSet)({
-    stitchee: 'designer',
-    artee: 'roadmap',
-});
-exports.stepOutlineRoadmap = (0, rhachet_1.asStitcherFlat)((0, rhachet_1.genStitchRoute)({
-    slug: '[designer]<outline>[roadmap]',
-    readme: '@[designer]<outline>[roadmap] -> [roadmap]',
-    sequence: [stepImagine, stepArtSet],
-}));
-//# sourceMappingURL=stepOutlineRoadmap.js.map

package/dist/roles/designer/outlineRoadmap/stepOutlineRoadmap.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stepOutlineRoadmap.js","sourceRoot":"","sources":["../../../../src/roles/designer/outlineRoadmap/stepOutlineRoadmap.ts"],"names":[],"mappings":";;;AAAA,qCAUiB;AAIjB,yDAA0E;AAC1E,iFAA8E;AAC9E,2EAAyE;AACzE,8EAA4E;AAC5E,2EAAyE;AA2BzE,MAAM,QAAQ,GAAG,IAAA,qBAAW,EAA6B;IACvD,GAAG,EAAE,EAAE,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,EAAE;IACvD,YAAY,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACpC,GAAG,CAAC,MAAM,IAAA,wCAA8B,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvE,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG;QACvC,MAAM,EAAE,MAAM,IAAA,qCAA2B,EAAC;YACxC,SAAS,EAAE;gBACT,4CAA4C;gBAC5C,GAAG,IAAA,sCAAkB,EAAC,CAAC,yCAAyC,CAAC,CAAC;gBAClE,GAAG,IAAA,oCAAiB,EAAC,CAAC,gCAAgC,CAAC,CAAC;gBACxD,GAAG,IAAA,oCAAiB,EAAC;oBACnB,0BAA0B;oBAC1B,2BAA2B;oBAC3B,0CAA0C;oBAC1C,kCAAkC;iBACnC,CAAC;aACH;SACF,CAAC;QACF,QAAQ,EACN,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE;QACxE,QAAQ,EACN,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE;KAC1E,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,IAAA,mCAAyB,EAAkB;IAC7D,IAAI,EAAE,uCAAuC;IAC7C,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,+CAA+C;IACvD,QAAQ;IACR,OAAO,EAAE,qBAAS,CAAC,OAAO;CAC3B,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC;IAC/B,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,SAAS;CACjB,CAAC,CAAC;AAEU,QAAA,kBAAkB,GAAG,IAAA,wBAAc,EAC9C,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,8BAA8B;IACpC,MAAM,EAAE,4CAA4C;IACpD,QAAQ,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;CACpC,CAAC,CACH,CAAC"}