@deftai/directive 0.116.0 → 0.118.0

package/dist/dispatch.d.ts

@@ -10,9 +10,9 @@ export interface DispatchIo {
     writeErr: (text: string) => void;
 }
 /** CLI modules in packages/cli/src (excluding parity harnesses and bin/index). */
-export declare const CLI_MODULE_VERBS: readonly ["agents-refresh", "cache", "check", "capacity-backfill", "capacity-show", "codebase-default-extractor", "codebase-map", "codebase-map-fresh", "codebase-projection-registry", "codebase-provider", "doctor", "install-upgrade", "install-uninstall", "migrate-preflight", "migrate-xbrief", "migrate-category-b", "framework-check-updates", "hook-dispatch", "umbrella-current-shape", "changelog-check", "change-init", "commit-lint", "coverage-hotspots", "policy", "authz", "escalation-cli", "pr-closing-keywords", "pr-merge-readiness", "pr-monitor", "pr-protected-issues", "pr-wait-mergeable", "pr-watch", "pr-finish-loop", "directive-finish-loop", "preflight-cache", "preflight-gh", "probe-session", "release", "release-e2e", "release-publish", "release-rollback", "scope-lifecycle", "scope-record-approved-scope", "scm-sync-default", "lifecycle-event", "lifecycle-stats", "session-start", "session-ready", "occupancy-steal", "occupancy-release", "occupancy-heartbeat", "occupancy-grant", "plan-sequence", "slice", "subagent-monitor", "toolchain-check", "triage-actions", "triage-bootstrap", "triage-bulk", "triage-classify", "triage-strip-withdrawn", "triage-evaluate", "triage-help", "triage-queue", "triage-reconcile", "triage-refresh", "triage-scope", "triage-scope-drift", "triage-smoketest", "triage-subscribe", "triage-summary", "triage-welcome", "ts-check-lane", "vbrief-activate", "vbrief-build", "vbrief-preflight", "vbrief-reconcile", "vbrief-validate", "vbrief-validation", "xbrief-create", "xbrief-verify", "verify-branch", "verify-encoding", "verify-forward-coverage", "verify-test-boundary", "verify-scope-provenance", "verify-consumer-check-contract", "verify-hooks-installed", "verify-investigation", "verify-judgment-gates", "verify-no-task-runtime", "validate-links", "validate-strategy-output", "verify-biome-config", "verify-bridge-drift", "verify-capacity", "verify-contained-writes", "verify-telemetry-coverage", "verify-content-manifest", "verify-deposit-closure", "verify-consumer-hard-stops", "verify-closing-keywords", "verify-skill-external-fetch-gate", "verify-semantic-single-source", "verify-contract-drift", "verify-cursor-tier1", "verify-openclaw-tier1", "verify-go-freeze", "verify-scm-boundary", "verify-session-ritual", "verify-plan-sequence", "verify-stubs", "verify-xbrief-drift", "verify-spec-prd-fresh", "rule-ownership-lint", "verify-story-ready", "verify-review-monitor", "verify-l4-owner", "verify-subagent-alive", "verify-subagent-steer", "review-monitor-register", "review-monitor-release", "verify-tools", "verify-wip-cap", "verify-orphan-active", "verify-pr-closeout-attestable", "verify-lifecycle-visible", "verify-completed-tracked", "verify-completed-write-guard", "verify-literal-ac", "verify-ac", "verify-agents-md-budget", "verify-agents-md-advisory", "verify-eval-health-relocation", "verify-eval-triggers-relocation", "eval-health", "eval-run", "eval-report", "eval-triggers"];
+export declare const CLI_MODULE_VERBS: readonly ["agents-refresh", "cache", "check", "capacity-backfill", "capacity-show", "codebase-default-extractor", "codebase-map", "codebase-map-fresh", "codebase-projection-registry", "codebase-provider", "doctor", "install-upgrade", "install-uninstall", "migrate-preflight", "migrate-xbrief", "migrate-category-b", "framework-check-updates", "hook-dispatch", "umbrella-current-shape", "changelog-check", "change-init", "commit-lint", "coverage-hotspots", "policy", "authz", "escalation-cli", "pr-closing-keywords", "pr-merge-readiness", "pr-monitor", "pr-protected-issues", "pr-wait-mergeable", "pr-watch", "pr-finish-loop", "directive-finish-loop", "preflight-cache", "preflight-gh", "probe-session", "release", "release-e2e", "release-publish", "release-rollback", "scope-lifecycle", "scope-record-approved-scope", "scm-sync-default", "lifecycle-event", "lifecycle-stats", "session-start", "session-ready", "occupancy-steal", "occupancy-release", "occupancy-heartbeat", "occupancy-grant", "plan-sequence", "slice", "subagent-monitor", "toolchain-check", "triage-actions", "triage-bootstrap", "triage-bulk", "triage-classify", "triage-strip-withdrawn", "triage-evaluate", "triage-help", "triage-queue", "triage-reconcile", "triage-refresh", "triage-scope", "triage-scope-drift", "triage-smoketest", "triage-subscribe", "triage-summary", "triage-welcome", "ts-check-lane", "vbrief-activate", "vbrief-build", "vbrief-preflight", "vbrief-reconcile", "vbrief-validate", "vbrief-validation", "xbrief-create", "xbrief-verify", "verify-branch", "verify-encoding", "verify-forward-coverage", "verify-test-boundary", "verify-scope-provenance", "verify-consumer-check-contract", "verify-hooks-installed", "verify-investigation", "verify-judgment-gates", "verify-no-task-runtime", "validate-links", "validate-strategy-output", "verify-biome-config", "verify-bridge-drift", "verify-capacity", "verify-contained-writes", "verify-telemetry-coverage", "verify-content-manifest", "verify-deposit-closure", "verify-consumer-hard-stops", "verify-closing-keywords", "verify-skill-external-fetch-gate", "verify-semantic-single-source", "verify-contract-drift", "verify-cursor-tier1", "verify-openclaw-tier1", "verify-go-freeze", "verify-scm-boundary", "verify-session-ritual", "verify-plan-sequence", "verify-stubs", "verify-xbrief-drift", "verify-spec-prd-fresh", "rule-ownership-lint", "verify-story-ready", "verify-review-monitor", "verify-l4-owner", "verify-subagent-alive", "verify-subagent-steer", "review-monitor-register", "review-monitor-release", "verify-tools", "verify-wip-cap", "verify-orphan-active", "verify-pr-closeout-attestable", "verify-lifecycle-visible", "verify-completed-tracked", "verify-completed-write-guard", "verify-literal-ac", "verify-ac", "verify-agents-md-budget", "verify-agents-md-advisory", "verify-eval-health-relocation", "verify-eval-triggers-relocation", "verify-evaluator-surface", "verify-consumer-test-lane", "eval-health", "eval-run", "eval-report", "eval-triggers"];
 /** Core-only CLI entrypoints without a packages/cli wrapper. */
-export declare const CORE_MODULE_VERBS: readonly ["scm", "scm-readiness", "github-auth-modes", "github-body", "issue-emit", "issue-ingest", "issue-sync-from-xbrief", "reconcile-issues", "swarm-launch", "swarm-complete-cohort", "swarm-finalize-cohort", "swarm-pre-dispatch", "swarm-readiness", "swarm-routing-verify", "swarm-routing-set", "swarm-verify-review-clean", "swarm-worktrees", "framework-commands", "pack-render", "packs-slice", "prd-render", "export-spec", "project-render", "roadmap-render", "rule-map", "spec-render", "spec-validate", "code-structure-validate", "pack-migrate-skills", "pack-migrate-rules", "pack-migrate-strategies", "pack-migrate-patterns", "pack-migrate-swarm-spec", "policy-set", "setup-ghx", "scope-undo", "scope-demote", "scope-decompose", "changelog-resolve-unreleased", "architecture-preflight-sor", "feedback-file", "value-readback", "product-signal", "freshness-report", "decision-write", "decision-list"];
+export declare const CORE_MODULE_VERBS: readonly ["scm", "scm-readiness", "github-auth-modes", "github-body", "issue-emit", "issue-ingest", "issue-sync-from-xbrief", "reconcile-issues", "swarm-launch", "swarm-complete-cohort", "swarm-finalize-cohort", "swarm-pre-dispatch", "swarm-readiness", "swarm-routing-verify", "swarm-routing-set", "swarm-verify-review-clean", "swarm-worktrees", "framework-commands", "pack-render", "packs-slice", "prd-render", "export-spec", "project-render", "roadmap-render", "rule-map", "spec-render", "spec-validate", "code-structure-validate", "pack-migrate-skills", "pack-migrate-rules", "pack-migrate-strategies", "pack-migrate-patterns", "pack-migrate-swarm-spec", "policy-set", "setup-ghx", "scope-undo", "scope-demote", "scope-decompose", "changelog-resolve-unreleased", "architecture-preflight-sor", "feedback-file", "value-readback", "product-signal", "freshness-report", "decision-write", "decision-list", "docs-impact"];
 /** Colon aliases for triage-actions (mirrors cli-router SUBCOMMAND_ROUTES). */
 export declare const TRIAGE_ACTION_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
 /** Colon aliases for policy subcommands (mirrors cli-router SUBCOMMAND_ROUTES). */

package/dist/dispatch.js

@@ -161,6 +161,8 @@ export const CLI_MODULE_VERBS = [
     "verify-agents-md-advisory",
     "verify-eval-health-relocation",
     "verify-eval-triggers-relocation",
+    "verify-evaluator-surface",
+    "verify-consumer-test-lane",
     "eval-health",
     "eval-run",
     "eval-report",
@@ -214,6 +216,7 @@ export const CORE_MODULE_VERBS = [
     "freshness-report",
     "decision-write",
     "decision-list",
+    "docs-impact",
 ];
 /** Colon aliases for triage-actions (mirrors cli-router SUBCOMMAND_ROUTES). */
 export const TRIAGE_ACTION_ALIAS_SUBCOMMANDS = {
@@ -309,6 +312,8 @@ export const VERB_ALIASES = {
     "verify:agents-md-advisory": "verify-agents-md-advisory",
     "verify:eval-health-relocation": "verify-eval-health-relocation",
     "verify:eval-triggers-relocation": "verify-eval-triggers-relocation",
+    "verify:evaluator-surface": "verify-evaluator-surface",
+    "verify:consumer-test-lane": "verify-consumer-test-lane",
     "verify:hooks-installed": "verify-hooks-installed",
     "verify:no-task-runtime": "verify-no-task-runtime",
     "vbrief:validate": "vbrief-validate",
@@ -345,6 +350,7 @@ export const VERB_ALIASES = {
     "verify:deposit-closure": "verify-deposit-closure",
     "verify:consumer-hard-stops": "verify-consumer-hard-stops",
     "verify:closing-keywords": "verify-closing-keywords",
+    "verify:docs-impact": "docs-impact",
     "verify:skill-external-fetch-gate": "verify-skill-external-fetch-gate",
     "verify:semantic-single-source": "verify-semantic-single-source",
     "verify:contract-drift": "verify-contract-drift",
@@ -2568,6 +2574,10 @@ async function loadCoreModuleHandler(verb, io) {
             const { listMainEntry } = await import("@deftai/directive-core/dist/decision/index.js");
             return listMainEntry;
         }
+        case "docs-impact": {
+            const { docsImpactMain } = await import("@deftai/directive-core/dist/docs/docs-impact.js");
+            return (argv) => docsImpactMain(argv);
+        }
         default:
             throw new Error(`unknown core verb: ${verb}`);
     }

package/dist/hook-dispatch.js

@@ -2,7 +2,7 @@
 import { readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { decideHook, hookPayloadTopLevelKeys, isHookEvent, isHookHost, normalizeHookProjectRoot, parseHookStdin, projectRootFromHookPayload, renderHostDecision, } from "@deftai/directive-core/hooks";
+import { decideHook, hookPayloadTopLevelKeys, isHookEvent, isHookHost, mergeHookDispatchEnviron, normalizeHookProjectRoot, parseHookStdin, projectRootFromHookPayload, renderHostDecision, } from "@deftai/directive-core/hooks";
 /**
  * How long to re-poll stdin after an empty first read before concluding the host
  * sent nothing (#2864). Keeps well under Cursor's deposited `timeout: 5` while
@@ -144,12 +144,14 @@ export function run(argv, seams = {}) {
     const cwd = (seams.cwd ?? process.cwd)();
     const { payload, context: payloadContext } = parsePayload(rawStdin);
     const projectRoot = normalizeHookProjectRoot(args.projectRoot ? resolve(args.projectRoot) : projectRootFromHookPayload(payload, cwd));
+    const environ = mergeHookDispatchEnviron(payload);
     const decision = decideHook({
         host: args.host,
         event: args.event,
         projectRoot,
         payload,
         payloadContext,
+        ...(environ !== undefined ? { environ } : {}),
     });
     const rendered = renderHostDecision(args.host, decision);
     if (rendered.length > 0)

package/dist/init-cli/help.js

@@ -14,6 +14,7 @@ export function printUpdateHelp(io) {
         "  --json                      Machine-readable summary on stdout\n" +
         "  --yes, --non-interactive  Run without prompts\n" +
         "  --dry-run, --plan           Classify and print the refresh plan without writing\n" +
+        "  --allow-dirty-no-stage      Apply on a dirty tree without automatic git add\n" +
         "  -h, --help                  Show this help\n");
 }
 export function printInitHelp(io) {

package/dist/init-cli/update.js

@@ -1,22 +1,31 @@
-import { parseUpdateArgv, runRefreshDepositCli } from "@deftai/directive-core/init-deposit";
+import { parseUpdateArgv, runRefreshDepositCli, UnknownUpdateFlagError, } from "@deftai/directive-core/init-deposit";
 import { CANONICAL_UPDATE_ARGV, UPDATE_DRY_RUN_FLAGS } from "./constants.js";
 import { argvWantsHelp, printUpdateHelp } from "./help.js";
 /** True when the user argv asked for a classify-only dry-run (`--dry-run`/`--plan`). */
 export function isUpdateDryRun(argv) {
     const flags = UPDATE_DRY_RUN_FLAGS;
-    return argv.some((arg) => flags.includes(arg));
+    return argv.some((arg) => flags.includes(arg) || arg === "/dry-run" || arg === "/plan");
 }
 export function runUpdate(argv, io) {
     if (argvWantsHelp(argv)) {
         printUpdateHelp(io);
         return Promise.resolve(0);
     }
-    const args = parseUpdateArgv(CANONICAL_UPDATE_ARGV, argv);
-    return runRefreshDepositCli({
-        ...args,
-        dryRun: isUpdateDryRun(argv),
-        writeOut: io.writeOut,
-        writeErr: io.writeErr,
-    });
+    try {
+        const args = parseUpdateArgv(CANONICAL_UPDATE_ARGV, argv);
+        return runRefreshDepositCli({
+            ...args,
+            dryRun: isUpdateDryRun(argv),
+            writeOut: io.writeOut,
+            writeErr: io.writeErr,
+        });
+    }
+    catch (cause) {
+        if (cause instanceof UnknownUpdateFlagError) {
+            io.writeErr(`directive update: ${cause.message}\n`);
+            return Promise.resolve(2);
+        }
+        throw cause;
+    }
 }
 //# sourceMappingURL=update.js.map

package/dist/occupancy-grant.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { resolve } from "node:path";
 import { grantOccupancyMembership, OCCUPANCY_JOIN_PROTOCOLS, revokeOccupancyMembership, } from "@deftai/directive-core/session";
+import { occupancyUnrecognizedArgument } from "./occupancy-unrecognized.js";
 const VALUE_FLAGS = [
     "--project-root",
     "--session-id",
@@ -36,7 +37,7 @@ export function parseArgs(argv) {
             return {
                 ...parsed,
                 revoke: argv.includes("--revoke"),
-                error: `unrecognized argument: ${arg}`,
+                error: occupancyUnrecognizedArgument(arg),
             };
         }
         const read = readValue(argv, i, flag);

package/dist/occupancy-heartbeat.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { resolve } from "node:path";
 import { heartbeatOccupancy } from "@deftai/directive-core/session";
+import { occupancyUnrecognizedArgument } from "./occupancy-unrecognized.js";
 export function parseArgs(argv) {
     const parsed = { projectRoot: "." };
     for (let i = 0; i < argv.length; i += 1) {
@@ -40,7 +41,7 @@ export function parseArgs(argv) {
             parsed.sessionId = sessionId;
         }
         else {
-            return { ...parsed, error: `unrecognized argument: ${arg}` };
+            return { ...parsed, error: occupancyUnrecognizedArgument(arg) };
         }
     }
     return parsed;

package/dist/occupancy-release.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { resolve } from "node:path";
 import { releaseOccupancy } from "@deftai/directive-core/session";
+import { occupancyUnrecognizedArgument } from "./occupancy-unrecognized.js";
 export function parseArgs(argv) {
     const parsed = { projectRoot: "." };
     for (let i = 0; i < argv.length; i += 1) {
@@ -40,7 +41,7 @@ export function parseArgs(argv) {
             parsed.sessionId = sessionId;
         }
         else {
-            return { ...parsed, error: `unrecognized argument: ${arg}` };
+            return { ...parsed, error: occupancyUnrecognizedArgument(arg) };
         }
     }
     return parsed;

package/dist/occupancy-steal.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { resolve } from "node:path";
 import { stealOccupancy } from "@deftai/directive-core/session";
+import { occupancyUnrecognizedArgument } from "./occupancy-unrecognized.js";
 export function parseArgs(argv) {
     const parsed = { projectRoot: ".", confirm: false, occupant: null };
     for (let i = 0; i < argv.length; i += 1) {
@@ -58,7 +59,7 @@ export function parseArgs(argv) {
             parsed.sessionId = sessionId;
         }
         else {
-            return { ...parsed, error: `unrecognized argument: ${arg}` };
+            return { ...parsed, error: occupancyUnrecognizedArgument(arg) };
         }
     }
     return parsed;

package/dist/occupancy-unrecognized.d.ts

@@ -0,0 +1,3 @@
+/** Occupancy-namespace parse: unknown flags name the help surface (#4411). */
+export declare function occupancyUnrecognizedArgument(arg: string | undefined): string;
+//# sourceMappingURL=occupancy-unrecognized.d.ts.map

package/dist/occupancy-unrecognized.js

@@ -0,0 +1,5 @@
+/** Occupancy-namespace parse: unknown flags name the help surface (#4411). */
+export function occupancyUnrecognizedArgument(arg) {
+    return `unrecognized argument: ${arg}. See \`deft help\` or \`deft commands\`.`;
+}
+//# sourceMappingURL=occupancy-unrecognized.js.map

package/dist/render-cli/prd-render-cli.js

@@ -30,7 +30,7 @@ export function runPrdRenderCli(argv) {
     const parsedArgs = parsePrdArgv(remaining);
     prdRenderMain({
         ...parsedArgs,
-        projectRoot: parsedArgs.spec === undefined ? projectRoot : undefined,
+        projectRoot: projectRoot ?? parsedArgs.projectRoot,
     });
     return 0;
 }

package/dist/session-start.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { type CeremonyDepth, type CeremonyDialInputs } from "@deftai/directive-core/policy";
-import { type SessionCeremonyTier } from "@deftai/directive-core/session";
+import { type PrimaryClaimException, type SessionCeremonyTier } from "@deftai/directive-core/session";
 export interface ParsedSessionStartArgs {
     projectRoot: string;
     deferValues: string[];
@@ -36,6 +36,11 @@ export interface ParsedSessionStartArgs {
     steal: boolean;
     confirm: boolean;
     occupant: string | null;
+    /**
+     * Trusted primary-claim exception from CLI argv (#4266). Closed enum;
+     * unknown values fail closed (exit 2).
+     */
+    primaryClaimException: PrimaryClaimException | null;
     /** #3611: explicit lifecycle owner injected by a host hook bridge. */
     sessionId: string | null;
     error?: string;

package/dist/session-start.js

@@ -2,7 +2,7 @@
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { CEREMONY_DEPTHS, normalizeCeremonyModelTier, normalizeCeremonyProjectShape, normalizeCeremonyTaskSize, selectCeremonyDepth, } from "@deftai/directive-core/policy";
-import { COLD_CEREMONY_TIER, parseDeferrals, READ_ONLY_POSTURE, REARM_CEREMONY_TIER, resolveProductionHostEffortDescriptor, ritualStatePath, runSessionStart, SESSION_CEREMONY_TIERS, } from "@deftai/directive-core/session";
+import { COLD_CEREMONY_TIER, PRIMARY_CLAIM_EXCEPTIONS, parseDeferrals, READ_ONLY_POSTURE, REARM_CEREMONY_TIER, resolveProductionHostEffortDescriptor, ritualStatePath, runSessionStart, SESSION_CEREMONY_TIERS, } from "@deftai/directive-core/session";
 function parseCeremonyDepth(raw) {
     const value = raw.trim().toLowerCase();
     if (CEREMONY_DEPTHS.includes(value)) {
@@ -17,6 +17,14 @@ function parseCeremonyTier(raw) {
     }
     return null;
 }
+const PRIMARY_CLAIM_EXCEPTION_HELP = PRIMARY_CLAIM_EXCEPTIONS.join("|");
+function parsePrimaryClaimException(raw) {
+    const value = raw.trim();
+    if (PRIMARY_CLAIM_EXCEPTIONS.includes(value)) {
+        return value;
+    }
+    return null;
+}
 /** Parse session:start CLI args, mirroring scripts/session_start.py. */
 export function parseArgs(argv) {
     const parsed = {
@@ -34,6 +42,7 @@ export function parseArgs(argv) {
         steal: false,
         confirm: false,
         occupant: null,
+        primaryClaimException: null,
         sessionId: null,
     };
     const dialInputs = {};
@@ -291,6 +300,41 @@ export function parseArgs(argv) {
         else if (arg === "--steal") {
             parsed.steal = true;
         }
+        else if (arg === "--primary-claim-exception") {
+            const value = argv[i + 1];
+            if (value === undefined || value.startsWith("--")) {
+                return {
+                    ...parsed,
+                    error: `argument --primary-claim-exception: expected one argument (${PRIMARY_CLAIM_EXCEPTION_HELP})`,
+                };
+            }
+            const exception = parsePrimaryClaimException(value);
+            if (exception === null) {
+                return {
+                    ...parsed,
+                    error: `argument --primary-claim-exception: expected ${PRIMARY_CLAIM_EXCEPTION_HELP}, got ${JSON.stringify(value)}`,
+                };
+            }
+            parsed.primaryClaimException = exception;
+            i += 1;
+        }
+        else if (arg?.startsWith("--primary-claim-exception=")) {
+            const value = arg.slice("--primary-claim-exception=".length);
+            if (value.length === 0 || value.startsWith("--")) {
+                return {
+                    ...parsed,
+                    error: `argument --primary-claim-exception: expected one argument (${PRIMARY_CLAIM_EXCEPTION_HELP})`,
+                };
+            }
+            const exception = parsePrimaryClaimException(value);
+            if (exception === null) {
+                return {
+                    ...parsed,
+                    error: `argument --primary-claim-exception: expected ${PRIMARY_CLAIM_EXCEPTION_HELP}, got ${JSON.stringify(value)}`,
+                };
+            }
+            parsed.primaryClaimException = exception;
+        }
         else if (arg === "--confirm") {
             parsed.confirm = true;
         }
@@ -393,6 +437,7 @@ export function run(argv) {
             steal: args.steal ? true : undefined,
             confirm: args.confirm ? true : undefined,
             occupant: args.occupant ?? undefined,
+            primaryClaimException: args.primaryClaimException ?? undefined,
             sessionId: args.sessionId ?? undefined,
             ...(args.ceremonyDepthOverride !== null
                 ? {

package/dist/verify-consumer-test-lane.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+interface ParsedArgs {
+    projectRoot: string;
+    quiet: boolean;
+    error?: string;
+}
+/** Parse verify-consumer-test-lane CLI args. */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+/** Run the gate and return the process exit code. */
+export declare function run(argv: string[]): Promise<number>;
+export {};
+//# sourceMappingURL=verify-consumer-test-lane.d.ts.map

package/dist/verify-consumer-test-lane.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { evaluate } from "@deftai/directive-core/consumer-test-lane";
+/** Parse verify-consumer-test-lane CLI args. */
+export function parseArgs(argv) {
+    const parsed = {
+        projectRoot: ".",
+        quiet: false,
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--quiet") {
+            parsed.quiet = true;
+        }
+        else if (arg === "--project-root") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --project-root: expected one argument" };
+            }
+            parsed.projectRoot = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--project-root=")) {
+            parsed.projectRoot = arg.slice("--project-root=".length);
+        }
+        else {
+            return { ...parsed, error: `unrecognized argument: ${arg}` };
+        }
+    }
+    return parsed;
+}
+/** Run the gate and return the process exit code. */
+export async function run(argv) {
+    const args = parseArgs(argv);
+    if (args.error !== undefined) {
+        process.stderr.write(`verify_consumer_test_lane: ${args.error}\n`);
+        return 2;
+    }
+    const result = await evaluate({
+        projectRoot: resolve(args.projectRoot),
+        quiet: args.quiet,
+    });
+    if (result.message.length > 0) {
+        if (result.stream === "stdout") {
+            process.stdout.write(`${result.message}\n`);
+        }
+        else if (result.stream === "stderr") {
+            process.stderr.write(`${result.message}\n`);
+        }
+    }
+    return result.code;
+}
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+    void run(process.argv.slice(2)).then((code) => process.exit(code));
+}
+//# sourceMappingURL=verify-consumer-test-lane.js.map

package/dist/verify-evaluator-surface.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+interface ParsedArgs {
+    projectRoot: string;
+    baseRef?: string;
+    staged: boolean;
+    quiet: boolean;
+    paths: string[];
+    error?: string;
+}
+/** Parse verify-evaluator-surface CLI args. */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+/** Run the gate and return the process exit code. */
+export declare function run(argv: string[]): number;
+export {};
+//# sourceMappingURL=verify-evaluator-surface.d.ts.map

package/dist/verify-evaluator-surface.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { evaluate } from "@deftai/directive-core/evaluator-surface";
+/** Parse verify-evaluator-surface CLI args. */
+export function parseArgs(argv) {
+    const parsed = {
+        projectRoot: ".",
+        staged: false,
+        quiet: false,
+        paths: [],
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--quiet") {
+            parsed.quiet = true;
+        }
+        else if (arg === "--staged") {
+            parsed.staged = true;
+        }
+        else if (arg === "--project-root") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --project-root: expected one argument" };
+            }
+            parsed.projectRoot = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--project-root=")) {
+            parsed.projectRoot = arg.slice("--project-root=".length);
+        }
+        else if (arg === "--base-ref") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --base-ref: expected one argument" };
+            }
+            parsed.baseRef = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--base-ref=")) {
+            parsed.baseRef = arg.slice("--base-ref=".length);
+        }
+        else if (arg === "--path") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --path: expected one argument" };
+            }
+            parsed.paths.push(value);
+            i += 1;
+        }
+        else if (arg?.startsWith("--path=")) {
+            parsed.paths.push(arg.slice("--path=".length));
+        }
+        else {
+            return { ...parsed, error: `unrecognized argument: ${arg}` };
+        }
+    }
+    return parsed;
+}
+/** Run the gate and return the process exit code. */
+export function run(argv) {
+    const args = parseArgs(argv);
+    if (args.error !== undefined) {
+        process.stderr.write(`verify_evaluator_surface: ${args.error}\n`);
+        return 2;
+    }
+    const result = evaluate({
+        projectRoot: resolve(args.projectRoot),
+        baseRef: args.baseRef,
+        staged: args.staged,
+        quiet: args.quiet,
+        paths: args.paths.length > 0 ? args.paths : undefined,
+    });
+    if (result.message.length > 0) {
+        if (result.stream === "stdout") {
+            process.stdout.write(`${result.message}\n`);
+        }
+        else if (result.stream === "stderr") {
+            process.stderr.write(`${result.message}\n`);
+        }
+    }
+    return result.code;
+}
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+    process.exit(run(process.argv.slice(2)));
+}
+//# sourceMappingURL=verify-evaluator-surface.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive",
-  "version": "0.116.0",
+  "version": "0.118.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.116.0",
-    "@deftai/directive-content": "^0.116.0"
+    "@deftai/directive-core": "^0.118.0",
+    "@deftai/directive-content": "^0.118.0"
   },
   "scripts": {
     "build": "tsc -b"