@deftai/directive 0.104.0 → 0.105.0

package/dist/verify-orphan-active.js

@@ -2,11 +2,20 @@
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { evaluate } from "@deftai/directive-core/orphan-active";
+function parseIssueNumber(raw) {
+    const trimmed = raw.startsWith("#") ? raw.slice(1) : raw;
+    if (!/^\d+$/.test(trimmed)) {
+        return null;
+    }
+    const value = Number(trimmed);
+    return Number.isInteger(value) && value > 0 ? value : null;
+}
 /** Parse verify-orphan-active CLI args. */
 export function parseArgs(argv) {
     const parsed = {
         projectRoot: ".",
         repo: null,
+        issue: null,
         quiet: false,
         skipGh: false,
     };
@@ -40,6 +49,26 @@ export function parseArgs(argv) {
         else if (arg?.startsWith("--repo=")) {
             parsed.repo = arg.slice("--repo=".length);
         }
+        else if (arg === "--issue") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --issue: expected one argument" };
+            }
+            const issue = parseIssueNumber(value);
+            if (issue === null) {
+                return { ...parsed, error: `argument --issue: expected a positive integer, got ${value}` };
+            }
+            parsed.issue = issue;
+            i += 1;
+        }
+        else if (arg?.startsWith("--issue=")) {
+            const value = arg.slice("--issue=".length);
+            const issue = parseIssueNumber(value);
+            if (issue === null) {
+                return { ...parsed, error: `argument --issue: expected a positive integer, got ${value}` };
+            }
+            parsed.issue = issue;
+        }
         else {
             return { ...parsed, error: `unrecognized argument: ${arg}` };
         }
@@ -58,6 +87,7 @@ export function run(argv) {
         quiet: args.quiet,
         repo: args.repo,
         skipGh: args.skipGh,
+        issue: args.issue,
     });
     if (result.message.length > 0) {
         if (result.stream === "stdout") {

package/dist/verify-session-ritual.d.ts

@@ -1,5 +1,11 @@
 #!/usr/bin/env node
-import { type DirectivePosture } from "@deftai/directive-core/session";
+import { type DirectivePosture, type VerifyResult } from "@deftai/directive-core/session";
+export interface VerifySessionRitualRunDeps {
+    readonly verifySessionRitual?: (projectRoot: string, options: {
+        tier: "quick" | "gated";
+        posture?: DirectivePosture;
+    }) => VerifyResult;
+}
 interface ParsedArgs {
     projectRoot: string;
     tier: "quick" | "gated";
@@ -9,7 +15,9 @@ interface ParsedArgs {
 }
 /** Parse verify-session-ritual CLI args, mirroring scripts/verify_session_ritual.py. */
 export declare function parseArgs(argv: string[]): ParsedArgs;
+/** True when the ritual failure is the gated cache_fresh step (#3506 / #3507). */
+export declare function isCacheFreshFailureMessage(message: string): boolean;
 /** Run the gate and return the process exit code. */
-export declare function run(argv: string[]): number;
+export declare function run(argv: string[], deps?: VerifySessionRitualRunDeps): number;
 export {};
 //# sourceMappingURL=verify-session-ritual.d.ts.map

package/dist/verify-session-ritual.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { emitBypassWarning, emitVerifyJson, verifySessionRitual, } from "@deftai/directive-core/session";
+import { emitBypassWarning, emitVerifyJson, formatCacheFreshDeferSoftPath, formatRitualRecoveryInstruction, verifySessionRitual, } from "@deftai/directive-core/session";
 function parsePosture(value) {
     if (value === "read-only")
         return "read-only";
@@ -86,15 +86,20 @@ export function parseArgs(argv) {
     }
     return parsed;
 }
+/** True when the ritual failure is the gated cache_fresh step (#3506 / #3507). */
+export function isCacheFreshFailureMessage(message) {
+    return message.includes("cache_fresh") || message.includes("cache-fresh");
+}
 /** Run the gate and return the process exit code. */
-export function run(argv) {
+export function run(argv, deps = {}) {
     const args = parseArgs(argv);
     if (args.error !== undefined) {
         process.stderr.write(`verify_session_ritual: ${args.error}\n`);
         return 2;
     }
     const projectRoot = resolve(args.projectRoot);
-    const result = verifySessionRitual(projectRoot, {
+    const verify = deps.verifySessionRitual ?? verifySessionRitual;
+    const result = verify(projectRoot, {
         tier: args.tier,
         posture: args.posture ?? undefined,
     });
@@ -108,6 +113,14 @@ export function run(argv) {
             process.stdout.write(`${result.message}\n`);
         }
     }
+    else if (result.code === 1) {
+        const recovery = formatRitualRecoveryInstruction(result.recoveryTier ?? "cold");
+        const lines = [result.message, recovery];
+        if (isCacheFreshFailureMessage(result.message)) {
+            lines.push(formatCacheFreshDeferSoftPath());
+        }
+        process.stderr.write(`${lines.join("\n")}\n`);
+    }
     else {
         process.stderr.write(`${result.message}\n`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive",
-  "version": "0.104.0",
+  "version": "0.105.0",
   "description": "Directive CLI — npm install path for the Deft Directive framework.",
   "license": "MIT",
   "homepage": "https://deftai.github.io/directive/",
@@ -34,8 +34,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-core": "^0.104.0",
-    "@deftai/directive-content": "^0.104.0"
+    "@deftai/directive-core": "^0.105.0",
+    "@deftai/directive-content": "^0.105.0"
   },
   "scripts": {
     "build": "tsc -b"