rhachet-roles-ehmpathy 1.0.0

package/dist/logic/roles/mechanic/getMechanicBrief.Options.codegen.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * .what = the options for the briefs available to role Mechanic
+ * .note = codegened via:
+ * ```sh
+ *  npx tsx src/contract/commands/codegenBriefOptions.ts
+ * ```
+ */
+const options = [
+    'style.compressed.md',
+    'style.compressed.prompt.md',
+    'style.names.treestruct.md',
+    'style.names.ubiqlang.md',
+    'style.words.lowercase.md',
+    'architecture/bounded-contexts.md',
+    'architecture/directional-dependencies.md',
+    'architecture/domain-driven-design.md',
+    'architecture/ubiqlang.md',
+    'codestyle/_mech.compressed.md',
+    'codestyle/_mech.compressed.prompt.md',
+    'codestyle/flow.failfast.md',
+    'codestyle/flow.idempotency.md',
+    'codestyle/flow.immutability.md',
+    'codestyle/flow.narratives.md',
+    'codestyle/flow.single-responsibility.md',
+    'codestyle/mech.args.input-context.md',
+    'codestyle/mech.arrowonly.md',
+    'codestyle/mech.clear-contracts.md',
+    'codestyle/mech.tests.given-when-then.md',
+    'codestyle/mech.what-why.md',
+    'codestyle/mech.what-why.v2.md',
+    'engineer/dependency-injection.md',
+];
+//# sourceMappingURL=getMechanicBrief.Options.codegen.js.map

package/dist/logic/roles/mechanic/getMechanicBrief.Options.codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMechanicBrief.Options.codegen.js","sourceRoot":"","sources":["../../../../src/logic/roles/mechanic/getMechanicBrief.Options.codegen.ts"],"names":[],"mappings":";;AAAA;;;;;;GAMG;AACH,MAAM,OAAO,GAAG;IACd,qBAAqB;IACrB,4BAA4B;IAC5B,2BAA2B;IAC3B,yBAAyB;IACzB,0BAA0B;IAC1B,kCAAkC;IAClC,0CAA0C;IAC1C,sCAAsC;IACtC,0BAA0B;IAC1B,+BAA+B;IAC/B,sCAAsC;IACtC,4BAA4B;IAC5B,+BAA+B;IAC/B,gCAAgC;IAChC,8BAA8B;IAC9B,yCAAyC;IACzC,sCAAsC;IACtC,6BAA6B;IAC7B,mCAAmC;IACnC,yCAAyC;IACzC,4BAA4B;IAC5B,+BAA+B;IAC/B,kCAAkC;CAC1B,CAAC"}

package/dist/logic/roles/mechanic/getMechanicBrief.d.ts

@@ -0,0 +1,13 @@
+import { Artifact } from 'rhachet-artifact';
+import { GitFile } from 'rhachet-artifact-git';
+import { BriefOptionMechanic } from './getMechanicBrief.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 getMechanicBrief: (key: BriefOptionMechanic) => 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 getMechanicBriefs: (keys: BriefOptionMechanic[]) => Artifact<typeof GitFile>[];

package/dist/logic/roles/mechanic/getMechanicBrief.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMechanicBriefs = exports.getMechanicBrief = 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 getMechanicBrief = (key) => {
+    return (0, rhachet_artifact_git_1.genArtifactGitFile)({
+        uri: `${__dirname}/.briefs/${key}`,
+    });
+};
+exports.getMechanicBrief = getMechanicBrief;
+/**
+ * .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 getMechanicBriefs = (keys) => keys.map(exports.getMechanicBrief);
+exports.getMechanicBriefs = getMechanicBriefs;
+//# sourceMappingURL=getMechanicBrief.js.map

package/dist/logic/roles/mechanic/getMechanicBrief.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMechanicBrief.js","sourceRoot":"","sources":["../../../../src/logic/roles/mechanic/getMechanicBrief.ts"],"names":[],"mappings":";;;AACA,+DAAmE;AAInE;;;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/logic/roles/mechanic/getMechanicRole.d.ts

@@ -0,0 +1,2 @@
+import { Role } from 'rhachet';
+export declare const ROLE_MECHANIC: import("domain-objects/dist/manipulation/immute/withImmute").WithImmute<Role>;

package/dist/logic/roles/mechanic/getMechanicRole.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_MECHANIC = void 0;
+const rhachet_1 = require("rhachet");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const genContextLogTrail_1 = require("../../../.test/genContextLogTrail");
+const genContextStitchTrail_1 = require("../../../.test/genContextStitchTrail");
+const getContextOpenAI_1 = require("../../../.test/getContextOpenAI");
+const getRefOrgPatterns_1 = require("./codediff/getRefOrgPatterns");
+const routeMechanicCodePropose_1 = require("./codediff/routeMechanicCodePropose");
+const getMechanicBrief_1 = require("./getMechanicBrief");
+exports.ROLE_MECHANIC = rhachet_1.Role.build({
+    slug: 'mechanic',
+    name: 'Mechanic',
+    purpose: 'write code',
+    readme: `
+## 🔧 Mechanic
+
+- **scale**: repo-level, implementation detail
+- **focus**: maintainability, observability, readability
+- **maximizes**: empathy for the 3am on-call engineer
+
+Used to write and revise the actual logic that runs the system.
+  `.trim(),
+    traits: [],
+    skills: [
+        rhachet_1.RoleSkill.build({
+            slug: 'upsert',
+            route: routeMechanicCodePropose_1.routeMechanicCodePropose,
+            // : {
+            //   target: {
+            //     char: 't',
+            //     desc: 'the target file or dir to upsert against',
+            //     shape: 'string',
+            //   },
+            // },
+            threads: {
+                lookup: {
+                    target: {
+                        source: 'process.argv',
+                        char: 't',
+                        desc: 'the target file or dir to upsert against',
+                        type: 'string',
+                    },
+                },
+                assess: (input) => typeof input.target === 'string',
+                instantiate: async (input) => {
+                    const targetArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.target });
+                    const claimsArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                        uri: input.target + '.rhachet.claims.md', // todo: namespace within a .rhachet directory
+                    });
+                    const feedbackArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                        uri: input.target + '.rhachet.feedback.md',
+                    });
+                    const feedbackCodestyleArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                        uri: input.target + '.rhachet.feedback.codestyle.md',
+                    });
+                    const judgementArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                        uri: input.target + '.rhachet.judgement.md',
+                    });
+                    return {
+                        artist: await (0, rhachet_1.enrollThread)({
+                            role: 'artist',
+                            stash: {
+                                ask: input.ask,
+                                art: { inflight: targetArt },
+                                org: {
+                                    patterns: (0, getRefOrgPatterns_1.getRefOrgPatterns)({ purpose: 'produce' }),
+                                },
+                                scene: { coderefs: [] },
+                            },
+                            inherit: {
+                                traits: [(0, getMechanicBrief_1.getMechanicBrief)('style.compressed.md')],
+                            },
+                        }),
+                        critic: await (0, rhachet_1.enrollThread)({
+                            role: 'critic',
+                            stash: {
+                                art: {
+                                    feedback: feedbackArt,
+                                    feedbackCodestyle: feedbackCodestyleArt,
+                                },
+                                org: {
+                                    patterns: (0, getRefOrgPatterns_1.getRefOrgPatterns)({ purpose: 'produce' }),
+                                },
+                            },
+                            inherit: {
+                                traits: [(0, getMechanicBrief_1.getMechanicBrief)('style.compressed.md')],
+                            },
+                        }),
+                        student: await (0, rhachet_1.enrollThread)({
+                            role: 'student',
+                            stash: { art: { claims: claimsArt } },
+                        }),
+                        judge: await (0, rhachet_1.enrollThread)({
+                            role: 'judge',
+                            stash: { art: { judgement: judgementArt } },
+                        }),
+                        mechanic: await (0, rhachet_1.enrollThread)({
+                            role: 'mechanic',
+                            stash: {},
+                        }),
+                    };
+                },
+            },
+            context: {
+                lookup: {
+                    apiKeyOpenai: {
+                        source: 'process.env',
+                        envar: 'PREP_OPENAI_KEY',
+                        desc: 'the openai key to use',
+                        type: 'string',
+                    },
+                },
+                assess: (input) => typeof input.apiKeyOpenai === 'string',
+                instantiate: (input) => {
+                    return {
+                        ...(0, getContextOpenAI_1.getContextOpenAI)(), // todo: use the input api key
+                        ...(0, genContextLogTrail_1.genContextLogTrail)(), // todo: passthrough ?
+                        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+                    };
+                },
+            },
+            readme: `
+### \`ask -r mechanic -s upsert\`
+
+you can ask the mechanic to upsert the code in a target file or dir
+- if it exists, it'll update
+- if it doesn't, it'll create
+
+
+\`\`\`sh
+npx rhachet ask -r mechanic -s upsert -t ./path/to/file.ts "your ask"
+\`\`\`
+
+\`\`\`sh
+npx rhachet ask \
+  --role mechanic \
+  --skill upsert \
+  --target ./path/to/file.ts \
+  "your ask"
+\`\`\`
+
+once it's self reviewed, it'll ask you for feedback
+
+\`\`\`sh
+? have notes? (Use arrow keys)
+❯ no notes
+  yes notes
+\`\`\`
+
+it'll loop until you tell it you have \`no notes\`
+    `.trim(),
+        }),
+    ],
+});
+//# sourceMappingURL=getMechanicRole.js.map

package/dist/logic/roles/mechanic/getMechanicRole.js.map

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

package/dist/logic/roles/mechanic/study/routeStudyAsk.d.ts

@@ -0,0 +1,19 @@
+import { GStitcher, Threads, RoleContext } from 'rhachet';
+import { Artifact } from 'rhachet-artifact';
+import { GitFile } from 'rhachet-artifact-git';
+import { ContextOpenAI } from '../../../../data/sdk/sdkOpenAi';
+type StitcherDesired = GStitcher<Threads<{
+    student: RoleContext<'student', {
+        ask: string;
+        art: {
+            claims: Artifact<typeof GitFile>;
+        };
+        scene: {
+            coderefs: Artifact<typeof GitFile>[];
+        };
+    }>;
+}>, ContextOpenAI & GStitcher['context'], {
+    content: string;
+}>;
+export declare const routeStudyAsk: import("rhachet").Stitcher<StitcherDesired>;
+export {};

package/dist/logic/roles/mechanic/study/routeStudyAsk.integration.test.d.ts

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

package/dist/logic/roles/mechanic/study/routeStudyAsk.integration.test.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const helpful_errors_1 = require("helpful-errors");
+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 getMechanicBrief_1 = require("../getMechanicBrief");
+const routeStudyAsk_1 = require("./routeStudyAsk");
+describe('routeStudyAsk ', () => {
+    const context = {
+        ...(0, genContextLogTrail_1.genContextLogTrail)(),
+        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+        ...(0, getContextOpenAI_1.getContextOpenAI)(),
+    };
+    const route = routeStudyAsk_1.routeStudyAsk;
+    (0, test_fns_1.given)('we want to multiply', () => {
+        const askText = 'stubout the ability to multiply';
+        const claimsArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname + '/.temp/multiply.claims.md',
+        });
+        const coderefArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname + '/.temp/multiply.coderef.md',
+        });
+        const coderefContent = 'export const add = (a: number, b: number) => a + b;';
+        beforeEach(async () => {
+            await claimsArt.del();
+            await coderefArt.set({ content: coderefContent });
+        });
+        (0, test_fns_1.when)('executed', () => {
+            const threads = (0, test_fns_1.usePrep)(async () => ({
+                student: await (0, rhachet_1.enrollThread)({
+                    role: 'student',
+                    stash: {
+                        ask: askText,
+                        art: { claims: claimsArt },
+                        scene: { coderefs: [coderefArt] },
+                    },
+                    inherit: {
+                        traits: [(0, getMechanicBrief_1.getMechanicBrief)('style.compressed.md')],
+                    },
+                }),
+            }));
+            (0, test_fns_1.then)('updates the claims artifact', async () => {
+                const outcome = await (0, rhachet_1.enweaveOneStitcher)({ stitcher: route, threads }, context);
+                console.log(JSON.stringify(outcome, null, 2));
+                const { content } = (await claimsArt.get()) ??
+                    helpful_errors_1.UnexpectedCodePathError.throw('expected file');
+                expect(content).toContain('multiply');
+            });
+        });
+    });
+    test_fns_1.given.only('we want to getSchedulableWindows for a crew', () => {
+        const askText = `
+    * .what = returns available time windows for appointment scheduling
+    * .why = enables customers to book with pros during valid, conflict-free slots
+
+background:
+- pro.crews set their schedule's availability
+- appointment windows are computed from the daily availability windows
+- each appointment window is 30min wide
+- neighbors and pros then book appointment windows from these availabilities
+- we only want to show windows that are
+`;
+        const claimsArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname + '/.temp/getSchedulableWindows.claims.md',
+        });
+        beforeEach(async () => {
+            await claimsArt.del();
+        });
+        (0, test_fns_1.when)('executed', () => {
+            const threads = (0, test_fns_1.usePrep)(async () => {
+                const student = await (0, rhachet_1.enrollThread)({
+                    role: 'student',
+                    stash: {
+                        ask: askText,
+                        art: { claims: claimsArt },
+                        scene: { coderefs: [] },
+                    },
+                    inherit: {
+                        traits: [(0, getMechanicBrief_1.getMechanicBrief)('style.compressed.md')],
+                    },
+                });
+                return {
+                    student,
+                };
+            });
+            (0, test_fns_1.then)('updates the claims artifact', async () => {
+                console.log({ threads });
+                const outcome = await (0, rhachet_1.enweaveOneStitcher)({ stitcher: route, threads }, context);
+                console.log(JSON.stringify(outcome, null, 2));
+            });
+        });
+    });
+});
+//# sourceMappingURL=routeStudyAsk.integration.test.js.map

package/dist/logic/roles/mechanic/study/routeStudyAsk.integration.test.js.map

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

package/dist/logic/roles/mechanic/study/routeStudyAsk.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.routeStudyAsk = void 0;
+const rhachet_1 = require("rhachet");
+const sdkOpenAi_1 = require("../../../../data/sdk/sdkOpenAi");
+const genStepArtSet_1 = require("../../../artifact/genStepArtSet");
+const template = (0, rhachet_1.genTemplate)({
+    ref: { uri: __dirname + '/routeStudyAsk.template.md' },
+    getVariables: async ({ threads }) => ({
+        ...(await (0, rhachet_1.getTemplateVarsFromRoleInherit)({ thread: threads.student })),
+        ask: threads.student.context.stash.ask,
+        scene: await (0, rhachet_1.getTemplateValFromArtifacts)({
+            artifacts: threads.student.context.stash.scene.coderefs,
+        }),
+    }),
+});
+const stepStudyAskImagine = (0, rhachet_1.genStepImagineViaTemplate)({
+    slug: '[student]<study>[ask]<imagine>',
+    stitchee: 'student',
+    readme: 'intent(imagines a codediff)',
+    template,
+    imagine: sdkOpenAi_1.sdkOpenAi.imagine,
+});
+const stepArtSet = (0, genStepArtSet_1.genStepArtSet)({ stitchee: 'student', artee: 'claims' });
+exports.routeStudyAsk = (0, rhachet_1.asStitcherFlat)((0, rhachet_1.genStitchRoute)({
+    slug: '[student]<study>[ask]',
+    readme: '@[student]<study>[ask] -> [[claim]]s',
+    sequence: [stepStudyAskImagine, stepArtSet],
+}));
+//# sourceMappingURL=routeStudyAsk.js.map

package/dist/logic/roles/mechanic/study/routeStudyAsk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeStudyAsk.js","sourceRoot":"","sources":["../../../../../src/logic/roles/mechanic/study/routeStudyAsk.ts"],"names":[],"mappings":";;;AAAA,qCAUiB;AAIjB,8DAA0E;AAC1E,mEAAgE;AAiBhE,MAAM,QAAQ,GAAG,IAAA,qBAAW,EAA6B;IACvD,GAAG,EAAE,EAAE,GAAG,EAAE,SAAS,GAAG,4BAA4B,EAAE;IACtD,YAAY,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACpC,GAAG,CAAC,MAAM,IAAA,wCAA8B,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG;QACtC,KAAK,EAAE,MAAM,IAAA,qCAA2B,EAAC;YACvC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ;SACxD,CAAC;KACH,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,IAAA,mCAAyB,EAAkB;IACrE,IAAI,EAAE,gCAAgC;IACtC,QAAQ,EAAE,SAAkB;IAC5B,MAAM,EAAE,6BAA6B;IACrC,QAAQ;IACR,OAAO,EAAE,qBAAS,CAAC,OAAO;CAC3B,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAE9D,QAAA,aAAa,GAAG,IAAA,wBAAc,EACzC,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,uBAAuB;IAC7B,MAAM,EAAE,sCAAsC;IAC9C,QAAQ,EAAE,CAAC,mBAAmB,EAAE,UAAU,CAAC;CAC5C,CAAC,CACH,CAAC"}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "rhachet-roles-ehmpathy",
+  "author": "ehmpathy",
+  "description": "empathetic software construction roles and skills, via rhachet",
+  "version": "1.0.0",
+  "repository": "ehmpathy/rhachet-roles-ehmpathy",
+  "homepage": "https://github.com/ehmpathy/rhachet-roles-ehmpathy",
+  "keywords": [
+    "rhachet",
+    "roles"
+  ],
+  "bugs": "https://github.com/ehmpathy/rhachet-roles-ehmpathy/issues",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "engines": {
+    "node": ">=8.0.0"
+  },
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "build:ts": "tsc -p ./tsconfig.build.json",
+    "commit:with-cli": "npx cz",
+    "fix:format:prettier": "prettier --write '**/*.ts' --config ./prettier.config.js",
+    "fix:format": "npm run fix:format:prettier",
+    "fix:lint": "eslint -c ./.eslintrc.js src/**/*.ts --fix",
+    "build:clean": "rm dist/ -rf",
+    "build:compile": "tsc -p ./tsconfig.build.json",
+    "build": "npm run build:clean && npm run build:compile",
+    "test:commits": "LAST_TAG=$(git describe --tags --abbrev=0 @^ 2> /dev/null || git rev-list --max-parents=0 HEAD) && npx commitlint --from $LAST_TAG --to HEAD --verbose",
+    "test:types": "tsc -p ./tsconfig.build.json --noEmit",
+    "test:format:prettier": "prettier --parser typescript --check 'src/**/*.ts' --config ./prettier.config.js",
+    "test:format": "npm run test:format:prettier",
+    "test:lint:deps": "npx depcheck -c ./depcheckrc.yml",
+    "test:lint:eslint": "eslint -c ./.eslintrc.js src/**/*.ts",
+    "test:lint": "npm run test:lint:eslint && npm run test:lint:deps",
+    "test:unit": "jest -c ./jest.unit.config.ts --forceExit --verbose --passWithNoTests $([ -z $THOROUGH ] && echo '--changedSince=main')",
+    "test:integration": "echo 'todo: release'",
+    "test:integration:hold": "jest -c ./jest.integration.config.ts --forceExit --verbose --passWithNoTests $([ -z $THOROUGH ] && echo '--changedSince=main')",
+    "test:acceptance:locally": "npm run build && LOCALLY=true jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests",
+    "test": "npm run test:commits && npm run test:types && npm run test:format && npm run test:lint && npm run test:unit && npm run test:integration && npm run test:acceptance:locally",
+    "test:acceptance": "npm run build && jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests",
+    "prepush": "npm run test && npm run build",
+    "prepublish": "npm run build",
+    "preversion": "npm run prepush",
+    "postversion": "git push origin HEAD --tags --no-verify",
+    "postinstall": "[ -d .git ] && npm run prepare:husky || exit 0",
+    "prepare:husky": "npx husky install && chmod ug+x .husky/*"
+  },
+  "dependencies": {
+    "@ehmpathy/as-command": "1.0.3",
+    "@ehmpathy/uni-time": "1.8.1",
+    "as-procedure": "1.1.7",
+    "fast-glob": "3.3.3",
+    "helpful-errors": "1.3.8",
+    "inquirer": "12.7.0",
+    "openai": "5.8.2",
+    "rhachet": "1.3.2",
+    "rhachet-artifact": "1.0.0",
+    "rhachet-artifact-git": "1.0.1",
+    "serde-fns": "1.2.0",
+    "type-fns": "1.19.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "19.3.0",
+    "@commitlint/config-conventional": "13.1.0",
+    "@trivago/prettier-plugin-sort-imports": "4.3.0",
+    "@tsconfig/node-lts-strictest": "18.12.1",
+    "@types/jest": "29.2.4",
+    "@typescript-eslint/eslint-plugin": "7.8.0",
+    "@typescript-eslint/parser": "7.8.0",
+    "core-js": "3.26.1",
+    "cz-conventional-changelog": "3.3.0",
+    "declapract": "0.12.0",
+    "declapract-typescript-ehmpathy": "0.39.5",
+    "depcheck": "1.4.3",
+    "eslint": "8.56.0",
+    "eslint-config-airbnb-typescript": "18.0.0",
+    "eslint-config-prettier": "8.5.0",
+    "eslint-plugin-import": "2.26.0",
+    "eslint-plugin-prettier": "4.2.1",
+    "husky": "8.0.3",
+    "jest": "29.3.1",
+    "prettier": "2.8.1",
+    "test-fns": "1.6.0",
+    "ts-jest": "29.1.3",
+    "ts-node": "10.9.2",
+    "typescript": "5.4.5"
+  },
+  "config": {
+    "commitizen": {
+      "path": "./node_modules/cz-conventional-changelog"
+    }
+  }
+}

package/readme.md

@@ -0,0 +1,110 @@
+# rhachet-roles-ehmpathy
+
+![test](https://github.com/ehmpathy/rhachet-roles-ehmpathy/workflows/test/badge.svg)
+![publish](https://github.com/ehmpathy/rhachet-roles-ehmpathy/workflows/publish/badge.svg)
+
+empathetic software construction roles and skills, via [rhachet](github.com/ehmpathy/rhachet)
+
+# purpose
+
+# install
+
+```sh
+npm install rhachet-roles-ehmpathy
+```
+
+# use
+
+## `readme --registry`
+```sh
+npx rhachet readme --registry ehmpathy
+```
+
+produces
+
+```md
+# 🤝 ehmpathy role registry
+
+This registry defines the four core roles used to craft empathetic, evolvable, and maintainable software.
+
+Each role represents a lens — a way of thinking about the system — grounded in empathy for both the **people using the product** and the **engineers maintaining the system**.
+
+All roles maximize:
+
+- clarity over cleverness
+- maintainability over magic
+- empathy over ego
+
+---
+
+## 🌱 Ecologist
+
+- **scale**: domain fundamentals, real-world systems
+- **focus**: what changes, what flows, what matters — ignoring software
+- **maximizes**: fidelity to the real world
+
+Used to understand the physics, incentives, and causal flows beneath the system.
+
+---
+
+## 🏛 Architect
+
+- **scale**: cross-repo, organizational boundaries
+- **focus**: bounded contexts, trust layers, language design
+- **maximizes**: ubiqlang, evolvability, decoupling
+
+Used to shape contracts and interfaces that survive change.
+
+---
+
+## 🎨 Designer
+
+- **scale**: feature-level, user-experience layer
+- **focus**: nudges, guardrails, pit-of-success defaults
+- **maximizes**: usability, ergonomics, reliability
+
+Used to sculpt workflows and interfaces that feel obvious and safe.
+
+---
+
+## 🔧 Mechanic
+
+- **scale**: repo-level, implementation detail
+- **focus**: maintainability, observability, readability
+- **maximizes**: empathy for the 3am on-call engineer
+
+Used to write and revise the actual logic that runs the system.
+```
+
+## `ask -r mechanic`
+
+the mechanic writes code within a repo
+
+### `ask -r mechanic -s upsert`
+
+you can ask the mechanic to upsert the code in a target file or dir
+- if it exists, it'll update
+- if it doesn't, it'll create
+
+
+```sh
+npx rhachet ask -r mechanic -s upsert -t ./path/to/file.ts "your ask"
+```
+
+```sh
+npx rhachet ask \
+  --role mechanic \
+  --skill upsert \
+  --target ./path/to/file.ts \
+  "your ask"
+```
+
+once it's self reviewed, it'll ask you for feedback
+
+```sh
+? have notes? (Use arrow keys)
+❯ no notes
+  yes notes
+```
+
+it'll loop until you tell it you have `no notes`