rhachet 1.5.0 → 1.6.0

package/dist/contract/sdk.d.ts

@@ -16,3 +16,4 @@ export { getStitch } from '../logic/thread/getStitch';
 export { enrollThread } from '../logic/role/enrollThread';
 export { genRoleSkill } from '../logic/role/genRoleSkill';
 export { genContextStitchTrail } from '../logic/context/genContextStitchTrail';
+export { getTemplatePathByCallerPath } from '../logic/template/getTemplatePathByCallerPath';

package/dist/contract/sdk.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.genContextStitchTrail = exports.genRoleSkill = exports.enrollThread = exports.getStitch = exports.genStepImagineViaTemplate = exports.useTemplate = exports.getTemplateVarsFromRoleInherit = exports.getTemplateValFromArtifacts = exports.genTemplate = exports.asStitcherFlat = exports.asStitcher = exports.enweaveOneStitcher = exports.genStitchRoute = exports.genStitchFanout = exports.genStitchCycle = exports.genStitchChoice = void 0;
+exports.getTemplatePathByCallerPath = exports.genContextStitchTrail = exports.genRoleSkill = exports.enrollThread = exports.getStitch = exports.genStepImagineViaTemplate = exports.useTemplate = exports.getTemplateVarsFromRoleInherit = exports.getTemplateValFromArtifacts = exports.genTemplate = exports.asStitcherFlat = exports.asStitcher = exports.enweaveOneStitcher = exports.genStitchRoute = exports.genStitchFanout = exports.genStitchCycle = exports.genStitchChoice = void 0;
 __exportStar(require("../domain/objects"), exports);
 var genStitchChoice_1 = require("../logic/weave/compose/genStitchChoice");
 Object.defineProperty(exports, "genStitchChoice", { enumerable: true, get: function () { return genStitchChoice_1.genStitchChoice; } });
@@ -48,4 +48,6 @@ var genRoleSkill_1 = require("../logic/role/genRoleSkill");
 Object.defineProperty(exports, "genRoleSkill", { enumerable: true, get: function () { return genRoleSkill_1.genRoleSkill; } });
 var genContextStitchTrail_1 = require("../logic/context/genContextStitchTrail");
 Object.defineProperty(exports, "genContextStitchTrail", { enumerable: true, get: function () { return genContextStitchTrail_1.genContextStitchTrail; } });
+var getTemplatePathByCallerPath_1 = require("../logic/template/getTemplatePathByCallerPath");
+Object.defineProperty(exports, "getTemplatePathByCallerPath", { enumerable: true, get: function () { return getTemplatePathByCallerPath_1.getTemplatePathByCallerPath; } });
 //# sourceMappingURL=sdk.js.map

package/dist/contract/sdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../src/contract/sdk.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oDAAkC;AAElC,0EAAyE;AAAhE,kHAAA,eAAe,OAAA;AACxB,wEAAuE;AAA9D,gHAAA,cAAc,OAAA;AACvB,0EAAyE;AAAhE,kHAAA,eAAe,OAAA;AACxB,wEAAuE;AAA9D,gHAAA,cAAc,OAAA;AAEvB,wEAAuE;AAA9D,wHAAA,kBAAkB,OAAA;AAE3B,gEAA+D;AAAtD,wGAAA,UAAU,OAAA;AACnB,wEAAuE;AAA9D,gHAAA,cAAc,OAAA;AAEvB,6DAA4D;AAAnD,0GAAA,WAAW,OAAA;AACpB,6FAA4F;AAAnF,0IAAA,2BAA2B,OAAA;AACpC,mGAAkG;AAAzF,gJAAA,8BAA8B,OAAA;AACvC,6DAA4D;AAAnD,0GAAA,WAAW,OAAA;AACpB,yFAAwF;AAA/E,sIAAA,yBAAyB,OAAA;AAGlC,uDAAsD;AAA7C,sGAAA,SAAS,OAAA;AAClB,2DAA0D;AAAjD,4GAAA,YAAY,OAAA;AAErB,2DAA0D;AAAjD,4GAAA,YAAY,OAAA;AACrB,gFAA+E;AAAtE,8HAAA,qBAAqB,OAAA"}
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../src/contract/sdk.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oDAAkC;AAElC,0EAAyE;AAAhE,kHAAA,eAAe,OAAA;AACxB,wEAAuE;AAA9D,gHAAA,cAAc,OAAA;AACvB,0EAAyE;AAAhE,kHAAA,eAAe,OAAA;AACxB,wEAAuE;AAA9D,gHAAA,cAAc,OAAA;AAEvB,wEAAuE;AAA9D,wHAAA,kBAAkB,OAAA;AAE3B,gEAA+D;AAAtD,wGAAA,UAAU,OAAA;AACnB,wEAAuE;AAA9D,gHAAA,cAAc,OAAA;AAEvB,6DAA4D;AAAnD,0GAAA,WAAW,OAAA;AACpB,6FAA4F;AAAnF,0IAAA,2BAA2B,OAAA;AACpC,mGAAkG;AAAzF,gJAAA,8BAA8B,OAAA;AACvC,6DAA4D;AAAnD,0GAAA,WAAW,OAAA;AACpB,yFAAwF;AAA/E,sIAAA,yBAAyB,OAAA;AAGlC,uDAAsD;AAA7C,sGAAA,SAAS,OAAA;AAClB,2DAA0D;AAAjD,4GAAA,YAAY,OAAA;AAErB,2DAA0D;AAAjD,4GAAA,YAAY,OAAA;AACrB,gFAA+E;AAAtE,8HAAA,qBAAqB,OAAA;AAC9B,6FAA4F;AAAnF,0IAAA,2BAA2B,OAAA"}

package/dist/logic/template/getTemplatePathByCallerPath.d.ts

@@ -0,0 +1,29 @@
+import { PickOne } from 'type-fns';
+/**
+ * .what = get the path of the file of the caller of this procedure
+ * .why =
+ *   - automatically and reliably lookup the caller path
+ */
+export declare const getCallerFilePath: (input?: {
+    /**
+     * .what = the distance of the caller to this fn
+     * .why = if you compose this fn within another before your target caller, the depth may shift (e.g., for each wrapper, +1, w/ start at 1)
+     */
+    depth: number;
+}) => string | null;
+/**
+ * .what = get the expected path of the template file for a given caller file
+ * .why =
+ *   - template files are typically collocated with their caller file, simply replacing the extension with `.template.md`
+ *   - this automates that replacement
+ */
+export declare const getTemplatePathByCallerPath: (input: PickOne<{
+    /**
+     * .what = choice to self declare the caller path
+     */
+    path: string;
+    /**
+     * .what = choice to auto detect the caller path
+     */
+    auto: true;
+}>) => string;

package/dist/logic/template/getTemplatePathByCallerPath.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTemplatePathByCallerPath = exports.getCallerFilePath = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const path_1 = __importDefault(require("path"));
+/**
+ * .what = get the path of the file of the caller of this procedure
+ * .why =
+ *   - automatically and reliably lookup the caller path
+ */
+const getCallerFilePath = (input = { depth: 1 }) => {
+    const originalPrepare = Error.prepareStackTrace;
+    try {
+        Error.prepareStackTrace = (_, stack) => stack;
+        const err = new Error();
+        const stack = err.stack;
+        // stack[0] is this fn, stack[1] is the caller of this fn
+        const caller = stack[input.depth]; // note: if wrapped, might need depth = 2; e.g., [0]=getCallerFile, [1]=wrapper, [2]=caller
+        if (!caller)
+            return null;
+        const callerFileName = caller.getFileName();
+        return callerFileName ? path_1.default.resolve(callerFileName) : null;
+    }
+    finally {
+        Error.prepareStackTrace = originalPrepare;
+    }
+};
+exports.getCallerFilePath = getCallerFilePath;
+/**
+ * .what = get the expected path of the template file for a given caller file
+ * .why =
+ *   - template files are typically collocated with their caller file, simply replacing the extension with `.template.md`
+ *   - this automates that replacement
+ */
+const getTemplatePathByCallerPath = (input) => {
+    // grab the path; support "auto" for auto detection
+    const path = input.auto === true
+        ? (0, exports.getCallerFilePath)({ depth: 2 }) ??
+            helpful_errors_1.UnexpectedCodePathError.throw('should have been able to get caller file path')
+        : input.path;
+    // parse dir, name, and ext separately
+    const { dir, name } = path_1.default.parse(path);
+    // join with a new extension, universally
+    return path_1.default.join(dir, `${name}.template.md`);
+};
+exports.getTemplatePathByCallerPath = getTemplatePathByCallerPath;
+//# sourceMappingURL=getTemplatePathByCallerPath.js.map

package/dist/logic/template/getTemplatePathByCallerPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTemplatePathByCallerPath.js","sourceRoot":"","sources":["../../../src/logic/template/getTemplatePathByCallerPath.ts"],"names":[],"mappings":";;;;;;AAAA,mDAAyD;AACzD,gDAA2B;AAG3B;;;;GAIG;AACI,MAAM,iBAAiB,GAAG,CAC/B,QAMI,EAAE,KAAK,EAAE,CAAC,EAAE,EACD,EAAE;IACjB,MAAM,eAAe,GAAG,KAAK,CAAC,iBAAiB,CAAC;IAChD,IAAI,CAAC;QACH,KAAK,CAAC,iBAAiB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;QAC9C,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAqC,CAAC;QAExD,yDAAyD;QACzD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,2FAA2F;QAC9H,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAC5C,OAAO,cAAc,CAAC,CAAC,CAAC,cAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,iBAAiB,GAAG,eAAe,CAAC;IAC5C,CAAC;AACH,CAAC,CAAC;AAvBW,QAAA,iBAAiB,qBAuB5B;AAEF;;;;;GAKG;AACI,MAAM,2BAA2B,GAAG,CACzC,KAUE,EACM,EAAE;IACV,mDAAmD;IACnD,MAAM,IAAI,GACR,KAAK,CAAC,IAAI,KAAK,IAAI;QACjB,CAAC,CAAC,IAAA,yBAAiB,EAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YAC/B,wCAAuB,CAAC,KAAK,CAC3B,+CAA+C,CAChD;QACH,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IAEjB,sCAAsC;IACtC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,cAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE1C,yCAAyC;IACzC,OAAO,cAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,cAAc,CAAC,CAAC;AAClD,CAAC,CAAC;AA3BW,QAAA,2BAA2B,+BA2BtC"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "rhachet",
   "author": "ehmpathy",
   "description": "A framework for reliable, thorough thought. Weave threads of thought via stitches.",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "repository": "ehmpathy/rhachet",
   "homepage": "https://github.com/ehmpathy/rhachet",
   "keywords": [