@deftai/directive 0.111.0 → 0.112.0

package/dist/cli-router/route-argv.js

@@ -200,6 +200,9 @@ function routeNamespaceVerb(ns, verb, rest) {
     if (ns === "scm" && verb === "issue:design-critique-chip") {
         return { kind: "dispatch", argv: ["scm", "issue", "design-critique-chip", ...rest] };
     }
+    if (ns === "scm" && verb === "issue:work-claim") {
+        return { kind: "dispatch", argv: ["scm", "issue", "work-claim", ...rest] };
+    }
     if (ns === "issue" && verb === "ingest") {
         return { kind: "dispatch", argv: ["issue-ingest", ...rest] };
     }

package/dist/dispatch.js

@@ -2793,6 +2793,7 @@ export function printHelp(io = defaultIo()) {
         "     (pnpm: pnpm add -g @deftai/directive -- ensure PNPM_HOME is on PATH, run `pnpm setup` if needed)\n" +
         "  2. directive init\n" +
         "  3. directive doctor\n" +
+        "  4. directive toolchain:check --consumer\n" +
         "New clone where `directive` will not run? Read the Cold-start bootstrap block at the top of README.md.\n");
 }
 async function invokeHandler(handler, argv) {

package/dist/scope-record-approved-scope.d.ts

@@ -14,6 +14,8 @@ export interface ParsedArgs {
     confirm: boolean;
     /** Optional owner/name seed for preimage approvedRepos (#3385 R5). */
     repo: string;
+    /** Typed `--help` / `-h` (#4203); run() prints usage on stdout and exits 0. */
+    help?: boolean;
     error?: string;
 }
 /**

package/dist/scope-record-approved-scope.js

@@ -103,8 +103,11 @@ export function parseArgs(argv) {
     const positionals = [];
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
+        if (arg === "--") {
+            continue;
+        }
         if (arg === "--help" || arg === "-h") {
-            return { ...parsed, error: usage() };
+            return { ...parsed, help: true };
         }
         if (arg === "--quiet") {
             parsed.quiet = true;
@@ -114,7 +117,7 @@ export function parseArgs(argv) {
         }
         else if (arg === "--project-root") {
             const value = argv[i + 1];
-            if (value === undefined) {
+            if (value === undefined || value === "--") {
                 return { ...parsed, error: "argument --project-root: expected one argument" };
             }
             parsed.projectRoot = value;
@@ -125,29 +128,37 @@ export function parseArgs(argv) {
         }
         else if (arg === "--actor") {
             const value = argv[i + 1];
-            if (value === undefined) {
+            if (value === undefined || value === "--") {
                 return { ...parsed, error: "argument --actor: expected one argument" };
             }
             parsed.actor = value;
             i += 1;
         }
         else if (arg?.startsWith("--actor=")) {
-            parsed.actor = arg.slice("--actor=".length);
+            const value = arg.slice("--actor=".length);
+            if (value.length === 0 || value === "--") {
+                return { ...parsed, error: "argument --actor: expected one argument" };
+            }
+            parsed.actor = value;
         }
         else if (arg === "--kind") {
             const value = argv[i + 1];
-            if (value === undefined) {
+            if (value === undefined || value === "--") {
                 return { ...parsed, error: "argument --kind: expected one argument" };
             }
             parsed.kind = value;
             i += 1;
         }
         else if (arg?.startsWith("--kind=")) {
-            parsed.kind = arg.slice("--kind=".length);
+            const value = arg.slice("--kind=".length);
+            if (value.length === 0 || value === "--") {
+                return { ...parsed, error: "argument --kind: expected one argument" };
+            }
+            parsed.kind = value;
         }
         else if (arg === "--xbrief-rel-path") {
             const value = argv[i + 1];
-            if (value === undefined) {
+            if (value === undefined || value === "--") {
                 return { ...parsed, error: "argument --xbrief-rel-path: expected one argument" };
             }
             parsed.xbriefRelPath = value;
@@ -158,7 +169,7 @@ export function parseArgs(argv) {
         }
         else if (arg === "--repo") {
             const value = argv[i + 1];
-            if (value === undefined) {
+            if (value === undefined || value === "--") {
                 return { ...parsed, error: "argument --repo: expected one argument" };
             }
             parsed.repo = value;
@@ -174,6 +185,9 @@ export function parseArgs(argv) {
             positionals.push(arg);
         }
     }
+    if (parsed.help) {
+        return parsed;
+    }
     if (positionals.length === 0) {
         return { ...parsed, error: `missing xBRIEF path\n${usage()}` };
     }
@@ -191,6 +205,10 @@ export function parseArgs(argv) {
 }
 export function run(argv, seams = {}) {
     const args = parseArgs(argv);
+    if (args.help) {
+        process.stdout.write(`${usage()}\n`);
+        return 0;
+    }
     if (args.error !== undefined) {
         process.stderr.write(`scope_record_approved_scope: ${args.error}\n`);
         return 2;

package/dist/vbrief-preflight.d.ts

@@ -8,6 +8,6 @@ interface ParsedArgs {
 /** Parse vbrief-preflight / xbrief:preflight CLI args (#810 / #2449). */
 export declare function parseArgs(argv: string[]): ParsedArgs;
 /** Run the gate and return the process exit code (parse errors -> 2). */
-export declare function run(argv: string[]): number;
+export declare function run(argv: string[], scan?: (briefPath: string) => readonly string[]): number;
 export {};
 //# sourceMappingURL=vbrief-preflight.d.ts.map

package/dist/vbrief-preflight.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { fileURLToPath } from "node:url";
 import { emitJson, evaluate, PREFLIGHT_USAGE_HINT } from "@deftai/directive-core/preflight";
+import { scanWorkClaimForBriefPath } from "@deftai/directive-core/scm";
 const HELP_TEXT = `usage: xbrief:preflight [--vbrief-path PATH | PATH] [--json] [--help]
 
 Implementation-intent gate (#810): exits 0 only when the xBRIEF is in
@@ -88,7 +89,7 @@ export function parseArgs(argv) {
     return parsed;
 }
 /** Run the gate and return the process exit code (parse errors -> 2). */
-export function run(argv) {
+export function run(argv, scan = scanWorkClaimForBriefPath) {
     const args = parseArgs(argv);
     if (args.help) {
         process.stdout.write(HELP_TEXT);
@@ -100,14 +101,31 @@ export function run(argv) {
     }
     const vbriefPath = args.vbriefPath;
     const result = evaluate(vbriefPath);
+    let scanLines = [];
+    try {
+        scanLines = [...scan(vbriefPath)];
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        scanLines = [
+            `[deft work-claim] warning: scan failed (${message}). Warn is success; this is not a GitHub lock.`,
+        ];
+    }
     if (args.emitJson) {
-        process.stdout.write(`${emitJson(vbriefPath, result.exitCode, result.message)}\n`);
+        const message = scanLines.length > 0 ? `${result.message}\n${scanLines.join("\n")}` : result.message;
+        process.stdout.write(`${emitJson(vbriefPath, result.exitCode, message)}\n`);
     }
     else if (result.exitCode === 0) {
         process.stdout.write(`${result.message}\n`);
+        for (const line of scanLines) {
+            process.stdout.write(`${line}\n`);
+        }
     }
     else {
         process.stderr.write(`${result.message}\n`);
+        for (const line of scanLines) {
+            process.stderr.write(`${line}\n`);
+        }
     }
     return result.exitCode;
 }

package/dist/verify-plan-sequence.d.ts

@@ -1,3 +1,14 @@
 #!/usr/bin/env node
+import { type PlanTargetKind } from "@deftai/directive-core/plan-sequence";
+export interface Parsed {
+    projectRoot: string;
+    targetKind: PlanTargetKind | null;
+    target: string | null;
+    emitJson: boolean;
+    /** Typed `--help` / `-h` (#4203); main() prints usage on stdout and exits 0. */
+    help?: boolean;
+    error?: string;
+}
+export declare function parseArgs(argv: string[]): Parsed;
 export declare function main(argv?: string[]): number;
 //# sourceMappingURL=verify-plan-sequence.d.ts.map

package/dist/verify-plan-sequence.js

@@ -14,7 +14,8 @@ const KINDS = [
     "checklist",
     "review",
 ];
-function parseArgs(argv) {
+const USAGE = "usage: verify:plan-sequence -- --target-kind <kind> --target <id-or-title>";
+export function parseArgs(argv) {
     const parsed = {
         projectRoot: ".",
         targetKind: null,
@@ -23,15 +24,19 @@ function parseArgs(argv) {
     };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
-        if (arg === undefined)
+        if (arg === undefined || arg === "--")
             continue;
+        if (arg === "--help" || arg === "-h") {
+            return { ...parsed, help: true };
+        }
         if (arg === "--json") {
             parsed.emitJson = true;
         }
         else if (arg === "--project-root") {
             const value = argv[++i];
-            if (value === undefined)
+            if (value === undefined || value === "--") {
                 return { ...parsed, error: "--project-root requires a value" };
+            }
             parsed.projectRoot = value;
         }
         else if (arg.startsWith("--project-root=")) {
@@ -39,41 +44,52 @@ function parseArgs(argv) {
         }
         else if (arg === "--target-kind") {
             const value = argv[++i];
-            if (value === undefined || !KINDS.includes(value)) {
+            if (value === undefined || value === "--" || !KINDS.includes(value)) {
                 return { ...parsed, error: `--target-kind must be one of ${KINDS.join("|")}` };
             }
             parsed.targetKind = value;
         }
         else if (arg.startsWith("--target-kind=")) {
             const value = arg.slice("--target-kind=".length);
-            if (!KINDS.includes(value)) {
+            if (value === "--" || !KINDS.includes(value)) {
                 return { ...parsed, error: `--target-kind must be one of ${KINDS.join("|")}` };
             }
             parsed.targetKind = value;
         }
         else if (arg === "--target") {
             const value = argv[++i];
-            if (value === undefined)
+            if (value === undefined || value === "--") {
                 return { ...parsed, error: "--target requires a value" };
+            }
             parsed.target = value;
         }
         else if (arg.startsWith("--target=")) {
-            parsed.target = arg.slice("--target=".length);
+            const value = arg.slice("--target=".length);
+            if (value.length === 0 || value === "--") {
+                return { ...parsed, error: "--target requires a value" };
+            }
+            parsed.target = value;
         }
         else if (arg.startsWith("-")) {
             return { ...parsed, error: `unknown flag: ${arg}` };
         }
     }
+    if (parsed.help)
+        return parsed;
     if (parsed.targetKind === null || parsed.target === null) {
         return {
             ...parsed,
-            error: "usage: verify:plan-sequence -- --target-kind <kind> --target <id-or-title>",
+            error: USAGE,
         };
     }
     return parsed;
 }
 export function main(argv = process.argv.slice(2)) {
     const parsed = parseArgs(argv);
+    if (parsed.help) {
+        process.stdout.write(`${USAGE}\n`);
+        return 0;
+    }
     if (parsed.error || parsed.targetKind === null || parsed.target === null) {
         process.stderr.write(`${parsed.error ?? "usage error"}\n`);
         return 2;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive",
-  "version": "0.111.0",
+  "version": "0.112.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.111.0",
-    "@deftai/directive-content": "^0.111.0"
+    "@deftai/directive-core": "^0.112.0",
+    "@deftai/directive-content": "^0.112.0"
   },
   "scripts": {
     "build": "tsc -b"