rhachet-roles-ehmpathy 1.13.0 → 1.13.2

package/dist/logic/roles/bhrain/khue.triage/stepTriage.integration.test.js

@@ -1,143 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const uni_time_1 = require("@ehmpathy/uni-time");
-const rhachet_1 = require("rhachet");
-const rhachet_artifact_git_1 = require("rhachet-artifact-git");
-const test_fns_1 = require("test-fns");
-const genContextLogTrail_1 = require("../../../../.test/genContextLogTrail");
-const genContextStitchTrail_1 = require("../../../../.test/genContextStitchTrail");
-const getContextOpenAI_1 = require("../../../../.test/getContextOpenAI");
-const getBhrainBrief_1 = require("../getBhrainBrief");
-const stepTriage_1 = require("./stepTriage");
-jest.setTimeout((0, uni_time_1.toMilliseconds)({ minutes: 5 }));
-describe('stepTriage', () => {
-    const context = {
-        ...(0, genContextLogTrail_1.genContextLogTrail)(),
-        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
-        ...(0, getContextOpenAI_1.getContextOpenAI)(),
-    };
-    const route = stepTriage_1.stepTriage;
-    const artifacts = {
-        caller: {
-            feedback: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepTriage/caller.feedback.md' }, { versions: true }),
-            'foci.goal.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({
-                uri: __dirname + '/.temp/stepTriage/caller.foci.goal.concept.md',
-            }, { versions: true }),
-            'foci.goal.context': (0, rhachet_artifact_git_1.genArtifactGitFile)({
-                uri: __dirname + '/.temp/stepTriage/caller.foci.goal.context.md',
-            }, { versions: true }),
-            'foci.input.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({
-                uri: __dirname + '/.temp/stepTriage/caller.foci.input.concept.md',
-            }, { versions: true }),
-        },
-        thinker: {
-            'focus.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepTriage/thinker.focus.concept.md' }, { versions: true }),
-            'focus.context': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepTriage/thinker.focus.context.md' }, { versions: true }),
-        },
-    };
-    (0, test_fns_1.given)('we want to triage diverged jokes', () => {
-        const inputConceptFewJokes = `
-[
-    "Why did the chicken cross the road? To get to the other side!",
-    "Why don't scientists trust atoms? Because they make up everything!",
-    "What do you call fake spaghetti? An impasta!",
-    "Why was the math book sad? Because it had too many problems.",
-    "How do you organize a space party? You planet!",
-    "What did one wall say to the other wall? I'll meet you at the corner!",
-    "Why can’t your nose be 12 inches long? Because then it would be a foot!",
-    "What do you call cheese that isn't yours? Nacho cheese!",
-    "What did the janitor say when he jumped out of the closet? Supplies!",
-    "Why did the scarecrow win an award? Because he was outstanding in his field!",
-    "Why couldn’t the bicycle stand up by itself? It was two tired.",
-    "What do you get when you cross a snowman with a vampire? Frostbite.",
-    "How does a penguin build its house? Igloos it together!",
-    "Why did the golfer bring two pairs of pants? In case he got a hole in one!",
-    "What do you call a bear with no teeth? A gummy bear!",
-    "What do you call a fish with no eye? Fsh!",
-    "Why did the tomato turn red? Because it saw the salad dressing!",
-    "What do you get if you put a radio in the fridge? Cool music.",
-    "Why did the picture go to jail? Because it was framed!",
-    "Why don't skeletons fight each other? They don't have the guts.",
-    "What do you call a boomerang that won’t come back? A stick."
-]
-      `.trim();
-        const inputConceptOneJoke = `
-"Why did the chicken cross the road? To get to the other side!",
-      `.trim();
-        beforeEach(async () => {
-            await artifacts.caller.feedback.set({ content: '' });
-            await artifacts.thinker['focus.context'].set({
-                content: ['psychology', 'evolution', 'ecology'].join('\n'),
-            });
-            await artifacts.thinker['focus.concept'].set({
-                content: [].join('\n'),
-            });
-            await artifacts.caller['foci.goal.concept'].set({
-                content: 'triage by expected quantity of laughter',
-            });
-        });
-        const enthread = () => (0, test_fns_1.usePrep)(async () => ({
-            caller: await (0, rhachet_1.enrollThread)({
-                role: 'caller',
-                stash: {
-                    art: {
-                        'foci.goal.concept': artifacts.caller['foci.goal.concept'],
-                        'foci.goal.context': artifacts.caller['foci.goal.context'],
-                        'foci.input.concept': artifacts.caller['foci.input.concept'],
-                        feedback: artifacts.caller.feedback,
-                    },
-                    refs: [],
-                },
-            }),
-            thinker: await (0, rhachet_1.enrollThread)({
-                role: 'thinker',
-                stash: {
-                    art: {
-                        'focus.context': artifacts.thinker['focus.context'],
-                        'focus.concept': artifacts.thinker['focus.concept'],
-                    },
-                    briefs: [],
-                },
-                inherit: {
-                    traits: (0, getBhrainBrief_1.getBhrainBriefs)(['trait.ocd.md']),
-                },
-            }),
-        }));
-        test_fns_1.when.only('multiple elements', () => {
-            beforeEach(async () => {
-                await artifacts.caller['foci.input.concept'].set({
-                    content: inputConceptFewJokes,
-                });
-            });
-            const goalThreads = enthread();
-            (0, test_fns_1.then)('outputs answers', async () => {
-                const result = await (0, rhachet_1.enweaveOneStitcher)({ stitcher: route, threads: goalThreads }, context);
-                console.log(JSON.stringify(result.stitch, null, 2));
-                console.log(artifacts);
-                console.log(artifacts.thinker['focus.concept']);
-                const { content } = await artifacts.thinker['focus.concept']
-                    .get()
-                    .expect('isPresent');
-                expect(content.toLowerCase()).toMatch(/knock[- ]knock|chicken|atom/i);
-            });
-        });
-        (0, test_fns_1.when)('only 1 element', () => {
-            beforeEach(async () => {
-                await artifacts.caller['foci.input.concept'].set({
-                    content: inputConceptOneJoke,
-                });
-            });
-            const goalThreads = enthread();
-            (0, test_fns_1.then)('outputs BadRequestError', async () => {
-                const result = await (0, rhachet_1.enweaveOneStitcher)({ stitcher: route, threads: goalThreads }, context);
-                console.log(JSON.stringify(result.stitch, null, 2));
-                console.log(artifacts.thinker['focus.concept']);
-                const { content } = await artifacts.thinker['focus.concept']
-                    .get()
-                    .expect('isPresent');
-                expect(content).toContain('BadRequestError');
-            });
-        });
-    });
-});
-//# sourceMappingURL=stepTriage.integration.test.js.map

package/dist/logic/roles/bhrain/khue.triage/stepTriage.integration.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stepTriage.integration.test.js","sourceRoot":"","sources":["../../../../../src/logic/roles/bhrain/khue.triage/stepTriage.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/logic/roles/bhrain/khue.triage/stepTriage.template.md

@@ -1,128 +0,0 @@
-# 🗣️ prompt: `<triage>` — prioritize and sort concepts by guiding questions
-
-You are a **@[thinker]** performing the **prioritization tactic** `<triage>`.
-
----
-
-## 📜 contract
-For `<triage>` to work as intended:
-
-input = [seed][concepts]
-- a **list of concepts** (tasks, ideas, issues, or elements) to be triaged
-- the list may be long, unordered, and heterogeneous
-
-output = [prioritized][concepts]
-- the same concepts, but **sorted and grouped by priority grades derived from context**
-- **every placed concept must include a concise rationale** explaining *why* it belongs in that grade, referencing the guiding questions/criteria
-- if the input is not a list, simply output:
-  `"BadRequestError: input must be a list of concepts"`
-
-**why this contract exists:**
-- triage is a **question-driven process**; prioritization only makes sense relative to guiding criteria
-- a **context-dependent grading scale** keeps results faithful to domain constraints
-- attaching a **rationale** to each placement makes decisions transparent, reviewable, and improvable
-
----
-
-## ⚙️ method
-1. **anchor to the seed concepts**
-   - parse and restate the full set of concepts needing triage
-   - confirm the scope of assessment (what kinds of concepts are included)
-
-2. **establish criteria (via guiding questions)**
-   - identify the **key questions** that define the triage dimensions
-   - e.g., “which are most urgent?”, “which yield the highest impact?”, “which are prerequisites?”, “which are low-effort/high-gain?”
-
-3. **derive a grading scale from context**
-   - synthesize **grade names** from the criteria and environment (examples: `critical`, `urgent`, `near_term`, `strategic`, `defer`, etc.)
-   - prefer **3–5 distinct grades** that are mutually exclusive and collectively exhaustive for the current context
-   - order grades from highest to lowest priority
-
-4. **evaluate and sort with rationale**
-   - for each concept:
-     - place it under exactly one grade
-     - provide a **rationale**: a crisp, criteria-referenced explanation (impact, urgency, dependency, risk, effort, alignment)
-
-5. **review and refine**
-   - merge duplicates, clarify ambiguous items
-   - verify no concept is added/removed relative to the input
-   - ensure rationales are specific (avoid generic statements)
-
----
-
-## 📐 output format
-- Return **only** a JSON object of the shape:
-
-\`\`\`json
-{
-  "$grade": [
-    { "item": "<exact input concept>", "rationale": "<why this grade, tied to criteria>" }
-  ]
-}
-\`\`\`
-
-- **`$grade` keys** must be **derived from the context and guiding questions** (not hard-coded).
-- **Every array entry** must be an object with **`item`** and **`rationale`**.
-- **Only use items from the input list**; do **not** invent new concepts.
-- Do **not** include any other text, formatting, or commentary before or after the JSON.
-
----
-
-## 📚 briefs
-here are the .briefs you've studied for this skill and actively strive to leverage
-
-$.rhachet{skill.briefs}
-
----
-
-## 📥 inputs
-the following inputs define the semantic frame for `<triage>`:
-
----
-
-## 📎 references
-here are possibly relevant references you may need
-
-$.rhachet{references}
-
----
-
-### 🧘 @[focus.context]
-> the context in focus available for leverage
-
-\`\`\`md
-$.rhachet{focus.context}
-\`\`\`
-
----
-
-### 🫐 @[focus.concept]
-> the **inflight document of output** — the seed concepts being refined by `<triage>`
-> if this is empty, treat it as **no concepts** and start from scratch
-
-\`\`\`md
-$.rhachet{focus.concept}
-\`\`\`
-
----
-
-### 🎯 @[guide.goal]
-\`\`\`md
-$.rhachet{guide.goal}
-\`\`\`
-
----
-
-### 💬 @[guide.feedback]
-\`\`\`md
-$.rhachet{guide.feedback}
-\`\`\`
-
----
-
-### 🌱 [seed][concepts]
-\`\`\`md
-$.rhachet{seed.concepts}
-\`\`\`
-
-**note: if [seed][concepts] is not a list, simply return "BadRequestError: input must be a list of concepts"**

package/dist/logic/roles/coach/.briefs/claude.context-caching.md

@@ -1,76 +0,0 @@
-# 🧠 .brief: Claude Context Caching
-
-## .what
-Claude's context caching mechanism that reduces token costs by caching prompt prefixes
-
-## .how.it.works
-
-### cache key = exact prefix match
-- Claude caches content based on the **exact sequence of tokens from the start** of the conversation
-- a cache hit requires the **exact same prefix** to be present
-- cache is valid for ~5 minutes of inactivity
-
-### prefix-based matching
-```
-Turn 1: [system prompt] + [briefs: 30k tokens] → writes to cache
-Turn 2: [system prompt] + [briefs: 30k tokens] + [user msg] + [response] → cache hit ✅
-Turn 3: [system prompt] + [briefs: 30k tokens] + [history] + [new msg] → cache hit ✅
-```
-
-### when cache hits occur
-
-✅ **cache hit (free reads)** when:
-- the content appears at the **exact same position** in the context
-- everything before it is **identical** to the cached version
-- less than ~5 minutes of inactivity
-
-❌ **cache miss (full tokens charged)** when:
-- anything changed in the context **before** the cached content (even a single token)
-- the content moved to a different position in the conversation
-- more than ~5 minutes passed with no activity
-- new conversation started (different session)
-
-## .implications.for.briefs
-
-### sessionstart hooks
-when loading briefs via sessionstart hooks:
-
-1. **first boot**: full tokens cached (e.g., 30k tokens written to cache)
-2. **within same session**: cached if prefix matches (free reads)
-3. **new session**: full tokens charged again (new conversation = different prefix)
-
-### optimization strategies
-to maximize cache hits:
-
-1. **load briefs once per session** (sessionstart hook pattern)
-2. **keep them at consistent position** (ideally at the start)
-3. **avoid regenerating them** if content hasn't changed
-4. **batch related work** in same session to reuse cache
-
-## .key.insight
-
-the cache **does not move tokens around** or do LRU eviction - it's purely prefix-based matching
-
-this means:
-- you can't "refresh" cached content by using it again
-- cached content must appear in the exact same position to hit
-- any prefix changes invalidate the entire cache for that position
-
-## .cost.model
-
-### cache writes
-- **first use**: 25% of normal input token cost
-- **cache write**: happens on first occurrence of new content
-
-### cache reads
-- **cache hit**: 10% of normal input token cost
-- **cache miss**: 100% of normal input token cost (no cache benefit)
-
-### example: 30k token briefs
-- **first load**: ~7.5k tokens charged (25% write cost)
-- **subsequent hits**: ~3k tokens charged (10% read cost)
-- **cache miss**: 30k tokens charged (100% cost)
-
-## .sources
-- based on Anthropic's context caching documentation
-- observed behavior in production usage

package/dist/logic/roles/designer/.briefs/declarative-over-imperative.md

@@ -1,79 +0,0 @@
-## 🎨 `.brief.designer.declarative-vs-imperative`
-
-### 🧠 topic: declarative vs. imperative design
-**why we prefer declarative design for building systems and interfaces**
-
----
-
-### 🎯 goal
-empower the designer to create systems that are **easier to understand, maintain, and scale**, by focusing on **what should happen**, not **how to do it**.
-
----
-
-### 🗺 core distinction
-
-| style           | imperative                               | declarative                                      |
-|-----------------|-------------------------------------------|--------------------------------------------------|
-| mindset         | tell the system *how* to do it            | tell the system *what* you want                 |
-| metaphor        | step-by-step instructions                 | a blueprint or desired outcome                  |
-| example (UI)    | manually update DOM on events             | declare a component tree (e.g. React)           |
-| example (infra) | run shell scripts to create servers       | declare infrastructure state (e.g. Terraform)   |
-
----
-
-### ✅ why declarative is better
-
-- **easier to read** — you see the structure and intent at a glance
-- **easier to write** — fewer details to manage = fewer bugs
-- **easier to maintain** — updates ripple automatically via system logic
-- **easier to scale** — declarative patterns are composable and predictable
-- **easier to debug** — the system owns the "how", so you debug at a higher level
-
----
-
-### 🛠 what it enables
-
-- **reusability** — components can be reused without re-specifying every step
-- **tooling & automation** — systems can analyze, optimize, or transform declarative specs
-- **flexibility** — changes in the underlying mechanics don’t require changing the design spec
-
----
-
-### ⚙️ trade-off to accept
-
-> declarative systems often need an **interpreter** — something that translates the high-level design into low-level instructions.
-
-this adds a little more **upfront work** —
-but it’s worth it, because:
-
-- it creates a **framework that abstracts away technical.domain details**
-- it keeps designers and builders focused on **behavioral.domain details**, where real value lives
-
----
-
-### 🧠 core belief
-
-> technical.domain work only adds value to developers, not to real people.
-
-- developer use is temporary → system builders
-- real folk use is forever → system engagers
-
-so we design declaratively —
-to serve people, not pipelines.
-
----
-
-### 💬 analogy
-
-> imperative = writing down GPS directions step by step
-> declarative = dropping a pin and letting the GPS figure it out
-
----
-
-### 🧩 final synthesis
-
-> declarative design keeps your focus on **what the user should experience**,
-> not on **how the system should behave step-by-step**.
-
-this keeps your mental model aligned with the human experience —
-not the machine’s internals.

package/dist/logic/roles/designer/.briefs/declarative-over-imperative.stub.md

@@ -1,14 +0,0 @@
-todo: declare a brief that explains why we prefer to design systems w/ declarative instead of imperative
-
-e.g.,
-- easier to use
-- easier to read
-- easier to write
-- easier to maintain
-
-
-adds a little more upfront work in how to translate the declarations into imperative instructions, but its worth it, as that framework helps you abstract away the technical.domain details and keeps you in the behavioral.domain details instead, as desired
-
-remember: technical.domain work only adds value to developers, not to real people. we want to distribute value to real people
-- developer use is temporary -> system builders
-- real folk use is forever -> system engagers

package/dist/logic/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/logic/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/logic/roles/designer/outlineDistilisys/loopOutlineDistilisys.integration.test.d.ts

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

package/dist/logic/roles/designer/outlineDistilisys/loopOutlineDistilisys.integration.test.js

@@ -1,77 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const uni_time_1 = require("@ehmpathy/uni-time");
-const rhachet_1 = require("rhachet");
-const rhachet_artifact_git_1 = require("rhachet-artifact-git");
-const test_fns_1 = require("test-fns");
-const genContextLogTrail_1 = require("../../../../.test/genContextLogTrail");
-const genContextStitchTrail_1 = require("../../../../.test/genContextStitchTrail");
-const getContextOpenAI_1 = require("../../../../.test/getContextOpenAI");
-const loopOutlineDistilisys_1 = require("./loopOutlineDistilisys");
-jest.setTimeout((0, uni_time_1.toMilliseconds)({ minutes: 30 }));
-describe('loopOutlineDistilisys', () => {
-    const context = {
-        ...(0, genContextLogTrail_1.genContextLogTrail)(),
-        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
-        ...(0, getContextOpenAI_1.getContextOpenAI)(),
-    };
-    const route = loopOutlineDistilisys_1.loopOutlineDistilisys;
-    (0, test_fns_1.given)('we want to create the rhachet cli', () => {
-        const askText = `
-i need to outline a design for a npm typescript cli which calls an existingp rocedure within my repo
-
-the product spec is
-
-1. register the "roles" and "skills" that we can access (w/ readme's)
-2. invoke the roles and skills via cli (e.g., \`npx rhachet -r mechanic -s produce -t target/file/path -a "the ask to execute against\`)
-
-note
-- no dynamic registration. we'll register the skills and roles at devtime
-- at registration, each skill and role shoudl get a mini readme, declared at the registration point
-    `.trim();
-        const roadmapPriorArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
-            uri: __dirname + '/.test/rhachetCli.outline.roadmap.nofeedback.example.md',
-        }, { access: 'readonly' });
-        const distilisysArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
-            uri: __dirname +
-                '/.temp/loopOutlineDistilisys/rhachetCli.fromscratch.distilisys.md',
-        }, { versions: true });
-        const feedbackArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
-            uri: __dirname +
-                '/.temp/loopOutlineDistilisys/rhachetCli.fromscratch.feedback.md',
-        }, { versions: true });
-        beforeEach(async () => {
-            await distilisysArt.del();
-        });
-        (0, test_fns_1.when)('executed', () => {
-            const threads = (0, test_fns_1.usePrep)(async () => ({
-                designer: await (0, rhachet_1.enrollThread)({
-                    role: 'designer',
-                    stash: {
-                        art: {
-                            roadmap: roadmapPriorArt,
-                            distilisys: distilisysArt,
-                        },
-                    },
-                }),
-                caller: await (0, rhachet_1.enrollThread)({
-                    role: 'caller',
-                    stash: {
-                        ask: askText,
-                        art: {
-                            feedback: feedbackArt,
-                        },
-                    },
-                }),
-            }));
-            (0, test_fns_1.then)('updates the usecases artifact', async () => {
-                const outcome = await (0, rhachet_1.enweaveOneStitcher)({ stitcher: route, threads }, context);
-                console.log(JSON.stringify(outcome, null, 2));
-                const { content } = await distilisysArt.get().expect('isPresent');
-                expect(content).toMatch(/cli/i);
-                expect(content).toMatch(/role/i);
-            });
-        });
-    });
-});
-//# sourceMappingURL=loopOutlineDistilisys.integration.test.js.map

package/dist/logic/roles/designer/outlineDistilisys/loopOutlineDistilisys.integration.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"loopOutlineDistilisys.integration.test.js","sourceRoot":"","sources":["../../../../../src/logic/roles/designer/outlineDistilisys/loopOutlineDistilisys.integration.test.ts"],"names":[],"mappings":";;AAAA,iDAAoD;AACpD,qCAA2D;AAC3D,+DAA0D;AAC1D,uCAAsD;AAEtD,6EAA0E;AAC1E,mFAAgF;AAChF,yEAAsE;AACtE,mEAAgE;AAEhE,IAAI,CAAC,UAAU,CAAC,IAAA,yBAAc,EAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AAEjD,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,MAAM,OAAO,GAAG;QACd,GAAG,IAAA,uCAAkB,GAAE;QACvB,GAAG,IAAA,6CAAqB,GAAE;QAC1B,GAAG,IAAA,mCAAgB,GAAE;KACtB,CAAC;IACF,MAAM,KAAK,GAAG,6CAAqB,CAAC;IAEpC,IAAA,gBAAK,EAAC,mCAAmC,EAAE,GAAG,EAAE;QAC9C,MAAM,OAAO,GAAG;;;;;;;;;;;KAWf,CAAC,IAAI,EAAE,CAAC;QACT,MAAM,eAAe,GAAG,IAAA,yCAAkB,EACxC;YACE,GAAG,EACD,SAAS,GAAG,yDAAyD;SACxE,EACD,EAAE,MAAM,EAAE,UAAU,EAAE,CACvB,CAAC;QACF,MAAM,aAAa,GAAG,IAAA,yCAAkB,EACtC;YACE,GAAG,EACD,SAAS;gBACT,mEAAmE;SACtE,EACD,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;QACF,MAAM,WAAW,GAAG,IAAA,yCAAkB,EACpC;YACE,GAAG,EACD,SAAS;gBACT,iEAAiE;SACpE,EACD,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;QAEF,UAAU,CAAC,KAAK,IAAI,EAAE;YACpB,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,UAAU,EAAE,GAAG,EAAE;YACpB,MAAM,OAAO,GAAG,IAAA,kBAAO,EAAC,KAAK,IAAI,EAAE,CAAC,CAAC;gBACnC,QAAQ,EAAE,MAAM,IAAA,sBAAY,EAAC;oBAC3B,IAAI,EAAE,UAAU;oBAChB,KAAK,EAAE;wBACL,GAAG,EAAE;4BACH,OAAO,EAAE,eAAe;4BACxB,UAAU,EAAE,aAAa;yBAC1B;qBACF;iBACF,CAAC;gBACF,MAAM,EAAE,MAAM,IAAA,sBAAY,EAAC;oBACzB,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE;wBACL,GAAG,EAAE,OAAO;wBACZ,GAAG,EAAE;4BACH,QAAQ,EAAE,WAAW;yBACtB;qBACF;iBACF,CAAC;aACH,CAAC,CAAC,CAAC;YAEJ,IAAA,eAAI,EAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;gBAC/C,MAAM,OAAO,GAAG,MAAM,IAAA,4BAAkB,EACtC,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAC5B,OAAO,CACR,CAAC;gBAEF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBAE9C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBAClE,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAChC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/logic/roles/designer/outlineDistilisys/stepOutlineDistilisys.integration.test.d.ts

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