@shrkcrft/cli 0.1.0-alpha.2 → 0.1.0-alpha.21

package/dist/commands/contract-gate.command.js

@@ -148,7 +148,11 @@ export const contractStatusCommand = {
     async run(args) {
         const contractFile = args.positional[0];
         if (!contractFile) {
-            process.stderr.write('Usage: shrk contract status <contract.json>\n');
+            // `contract status` inspects a SAVED contract file — it is not a zero-arg
+            // project-health command. Point at the canonical task form so the verb
+            // doesn't read as a broken status command.
+            process.stderr.write('Usage: shrk contract status <contract.json>   (inspect a saved contract file)\n');
+            process.stderr.write('To build/inspect a contract for a task, run:  shrk contract "<task>"\n');
             return 2;
         }
         const cwd = resolveCwd(args);

package/dist/commands/delegate.command.d.ts

@@ -0,0 +1,65 @@
+import { type IAiProvider } from '@shrkcrft/ai';
+import { type IDelegateRecipe } from '@shrkcrft/config';
+import { type IDroppedOp } from '@shrkcrft/generator';
+import { type ICommandHandler } from '../command-registry.js';
+export type DelegateRunStatus = 'no-provider' | 'generate-failed' | 'guardrail-refused' | 'package-error' | 'conflicts' | 'sign-failed' | 'no-verification' | 'generated' | 'applied' | 'apply-failed' | 'verify-failed';
+export interface IExecuteDelegateRunInput {
+    task: string;
+    recipe: IDelegateRecipe;
+    projectRoot: string;
+    /** Injectable for tests; `null` means no local LLM is reachable. */
+    provider: IAiProvider | null;
+    apply: boolean;
+    /** Where to write the signed plan. Default `.sharkcraft/delegate/<id>.plan.json`. */
+    planPath?: string;
+    /** Explicit HMAC secret. Falls back to `SHARKCRAFT_PLAN_SECRET`. */
+    planSecret?: string;
+    /** Validation report dir. Default `.sharkcraft/delegate/reports`. */
+    reportDir?: string;
+}
+export interface IExecuteDelegateRunResult {
+    status: DelegateRunStatus;
+    recipeId: string;
+    message: string;
+    planPath?: string;
+    ops?: number;
+    droppedOps?: readonly IDroppedOp[];
+    refused?: readonly string[];
+    conflicts?: readonly string[];
+    written?: readonly string[];
+    reverted?: boolean;
+    verification?: {
+        passed: boolean;
+        commandsFailed: readonly string[];
+    };
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+    retried?: boolean;
+    /** How many generate→verify attempts ran before this result (1-based). */
+    attempts?: number;
+    /** Compressed unified diff of what the edit changed (compact result hand-back). */
+    diff?: string;
+    /** CCR key when the diff was lossily compressed (recover via `shrk expand`). */
+    diffCcrKey?: string;
+}
+/**
+ * The in-scope files (current contents, compressed to signatures via the
+ * code-outline pass) handed to the LOCAL worker so it can pick the right
+ * targetPath, check idempotency, and find exact text to replace — instead of
+ * guessing. This goes in the WORKER's prompt, read locally, so it costs the
+ * orchestrator (Claude) NOTHING. Bounded to keep a small local model's context
+ * focused. Returns '' when there's nothing in scope / on any error.
+ */
+export declare function gatherRecipeContext(projectRoot: string, recipe: IDelegateRecipe): string;
+/**
+ * The testable orchestration core: a bounded GENERATE→VERIFY retry loop. On a
+ * retryable failure (parse / guardrail / bad-op / conflict / verification) the
+ * worker is re-prompted with the failure injected, up to `recipe.maxAttempts`,
+ * then the run escalates. A provider / signing / environment failure is NOT
+ * retried. Takes an already-resolved recipe + provider so tests inject a fake.
+ */
+export declare function executeDelegateRun(input: IExecuteDelegateRunInput): Promise<IExecuteDelegateRunResult>;
+export declare const delegateCommand: ICommandHandler;
+//# sourceMappingURL=delegate.command.d.ts.map

package/dist/commands/delegate.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.command.d.ts","sourceRoot":"","sources":["../../src/commands/delegate.command.ts"],"names":[],"mappings":"AAgBA,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAqB,KAAK,eAAe,EAA0B,MAAM,kBAAkB,CAAC;AASnG,OAAO,EAOL,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAMhC,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,GACf,WAAW,GACX,aAAa,GACb,iBAAiB,GACjB,WAAW,GACX,SAAS,GACT,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IACtE,KAAK,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAwBD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CAsBxF;AA6BD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,yBAAyB,CAAC,CA4BpC;AA2gBD,eAAO,MAAM,eAAe,EAAE,eAmB7B,CAAC"}