@try-works/dsh-tool-mode 0.0.0-stage → 0.5.44

package/node_modules/@try-works/tool-mode-recipes/lib/cli.d.ts

@@ -0,0 +1,61 @@
+/**
+ * The recipe authoring CLI (RCP-08).
+ *
+ * Three commands, each a required new tool rather than an existing npm/DSH
+ * command: `validate` checks a draft against BOTH authorities (the published
+ * `harness-model-recipe.schema.json` shipped beside this module AND the code
+ * validator `parseRecipe`), `describe` prints the effective bounds an operator
+ * reads before deciding, and `pack` builds a declarative-extension package
+ * (manifest + recipes, NO executable code) consumable by the extension install
+ * path.
+ *
+ * Guardrails built in rather than documented:
+ *
+ * - The schema is read from THIS PACKAGE'S SHIPPED FILE, resolved relative to
+ *   the module (so a packed install validates against the packed artifact, not
+ *   some source checkout).
+ * - Packing validates the exact production artifact and runs NO lifecycle
+ *   scripts: the output is written directly (directory + a store-method zip),
+ *   never through `npm pack`.
+ * - Nothing here runs inference, installs or activates anything, or touches
+ *   the network (RCP-08's creation rules).
+ * - Exit codes are a contract: 0 valid, 1 invalid (every refusal named),
+ *   2 usage or IO failure.
+ *
+ * RCP-09 (agent-assisted creation with an authoring grant) is enforced here when the
+ * deployment configures `DSH_TOOL_MODE_AUTHORING_TOKEN` (required `--authoring-grant`)
+ * or `DSH_TOOL_MODE_AUTHORING_ROOT` (target containment). The live helper is also here:
+ * it requires explicit consent and an operator-supplied executor profile, and narrows
+ * the broker limits to the profile's figures.
+ *
+ * @module @try-works/tool-mode-recipes/cli
+ */
+import { type RecipeManifest } from './recipe-format.ts';
+/** Where the CLI writes. Injected so a test can capture output. */
+export interface RecipeCliIo {
+    out(line: string): void;
+    err(line: string): void;
+}
+/** The two-verdict validation of one recipe document. */
+export interface RecipeVerdict {
+    /** The published-schema verdict. */
+    readonly schemaOk: boolean;
+    /** Rendered schema violations, one per refusal. */
+    readonly schemaViolations: readonly string[];
+    /** The code-validator verdict. */
+    readonly codeOk: boolean;
+    /** The code validator's rendered refusals. */
+    readonly codeViolations: readonly string[];
+    /** The parsed recipe, when the code validator admits the document. */
+    readonly recipe?: RecipeManifest;
+}
+/** Validate one decoded document against BOTH authorities (RCP-02, RCP-08). */
+export declare function judgeRecipe(document: unknown): RecipeVerdict;
+/**
+ * Run one CLI invocation.
+ * @param argv - arguments after the executable name.
+ * @param io - the output sinks.
+ * @returns a promise of the process exit code.
+ */
+export declare function runRecipeCli(argv: readonly string[], io: RecipeCliIo): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/node_modules/@try-works/tool-mode-recipes/lib/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAoBH,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAA;AAe3B,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AA8BD,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CACjC;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,aAAa,CAW5D;AA+ED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAS5F"}