@deftai/directive 0.79.2 → 0.79.4

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

@@ -129,6 +129,14 @@ function routeNamespaceVerb(ns, verb, rest) {
     const subcommand = routeSubcommandKey(ns, verb, rest);
     if (subcommand !== null)
         return subcommand;
+    // PR stems (watch → pr-watch) must win over colon aliases like pr:watch (#2652),
+    // otherwise `directive pr watch` would dispatch the colon token and break PR_VERB_MAP.
+    if (ns === "pr") {
+        const prStem = PR_VERB_MAP[verb];
+        if (prStem !== undefined) {
+            return { kind: "dispatch", argv: [prStem, ...rest] };
+        }
+    }
     if (resolveCanonicalVerb(colonKey) !== null) {
         return { kind: "dispatch", argv: [colonKey, ...rest] };
     }
@@ -149,12 +157,6 @@ function routeNamespaceVerb(ns, verb, rest) {
         if (verb === "undo")
             return { kind: "dispatch", argv: ["scope-undo", ...rest] };
     }
-    if (ns === "pr") {
-        const prStem = PR_VERB_MAP[verb];
-        if (prStem !== undefined) {
-            return { kind: "dispatch", argv: [prStem, ...rest] };
-        }
-    }
     if (ns === "verify") {
         const verifyStem = VERIFY_VERB_MAP[verb];
         if (verifyStem !== undefined) {
@@ -179,6 +181,32 @@ function routeNamespaceVerb(ns, verb, rest) {
     }
     return null;
 }
+/** Split `namespace:verb` task keys (e.g. scope:promote) for namespace routing (#2654). */
+function tryColonNamespaceRoute(first, rest) {
+    // Registered colon aliases (policy:show, pr:watch, …) stay on the flat path.
+    if (resolveCanonicalVerb(first) !== null)
+        return null;
+    const colon = first.indexOf(":");
+    if (colon <= 0)
+        return null;
+    const ns = first.slice(0, colon);
+    const verb = first.slice(colon + 1);
+    if (verb.length === 0)
+        return null;
+    return routeNamespaceVerb(ns, verb, [...rest]);
+}
+/** Split `scope-<verb>` dash aliases (e.g. scope-promote) for namespace routing (#2654). */
+function tryScopeDashRoute(first, rest) {
+    if (resolveCanonicalVerb(first) !== null)
+        return null;
+    const prefix = "scope-";
+    if (!first.startsWith(prefix))
+        return null;
+    const verb = first.slice(prefix.length);
+    if (verb.length === 0)
+        return null;
+    return routeNamespaceVerb("scope", verb, [...rest]);
+}
 function routeThreeToken(ns, verb, subverb, rest) {
     if (ns === "scm" && verb === "issue") {
         return { kind: "dispatch", argv: ["scm", "issue", subverb, ...rest] };
@@ -214,6 +242,12 @@ export function routeArgv(argv) {
     const topLevel = routeTopLevel(first, argv.slice(1));
     if (topLevel !== null)
         return topLevel;
+    const colonRoute = tryColonNamespaceRoute(first, argv.slice(1));
+    if (colonRoute !== null)
+        return colonRoute;
+    const scopeDashRoute = tryScopeDashRoute(first, argv.slice(1));
+    if (scopeDashRoute !== null)
+        return scopeDashRoute;
     if (argv.length === 1 && resolveCanonicalVerb(first) !== null) {
         return { kind: "dispatch", argv: [first] };
     }

package/dist/coverage-hotspots.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+interface ParsedArgs {
+    projectRoot: string;
+    coverageDir: string | null;
+    minHeadroomPp: number | null;
+    baseRef: string | null;
+    pathFilter: string[];
+    useDiffPaths: boolean;
+    json: boolean;
+    quiet: boolean;
+    error?: string;
+}
+/** Parse coverage-hotspots CLI args. */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+/** Run coverage-hotspots and return the process exit code. */
+export declare function run(argv: string[]): number;
+export {};
+//# sourceMappingURL=coverage-hotspots.d.ts.map

package/dist/coverage-hotspots.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { evaluateCoverageHotspots, formatJsonReport } from "@deftai/directive-core";
+function parseNumber(raw) {
+    const value = Number.parseFloat(raw);
+    if (!Number.isFinite(value)) {
+        return null;
+    }
+    return value;
+}
+/** Parse coverage-hotspots CLI args. */
+export function parseArgs(argv) {
+    const parsed = {
+        projectRoot: ".",
+        coverageDir: null,
+        minHeadroomPp: null,
+        baseRef: null,
+        pathFilter: [],
+        useDiffPaths: true,
+        json: false,
+        quiet: false,
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--json") {
+            parsed.json = true;
+        }
+        else if (arg === "--quiet") {
+            parsed.quiet = true;
+        }
+        else if (arg === "--no-diff-filter") {
+            parsed.useDiffPaths = false;
+        }
+        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 === "--coverage-dir") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --coverage-dir: expected one argument" };
+            }
+            parsed.coverageDir = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--coverage-dir=")) {
+            parsed.coverageDir = arg.slice("--coverage-dir=".length);
+        }
+        else if (arg === "--min-headroom-pp") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --min-headroom-pp: expected one argument" };
+            }
+            const num = parseNumber(value);
+            if (num === null) {
+                return { ...parsed, error: "argument --min-headroom-pp: expected a number" };
+            }
+            parsed.minHeadroomPp = num;
+            i += 1;
+        }
+        else if (arg?.startsWith("--min-headroom-pp=")) {
+            const num = parseNumber(arg.slice("--min-headroom-pp=".length));
+            if (num === null) {
+                return { ...parsed, error: "argument --min-headroom-pp: expected a number" };
+            }
+            parsed.minHeadroomPp = num;
+        }
+        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" || arg === "--paths") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: `argument ${arg}: expected one argument` };
+            }
+            parsed.pathFilter.push(...value
+                .split(",")
+                .map((part) => part.trim())
+                .filter(Boolean));
+            parsed.useDiffPaths = false;
+            i += 1;
+        }
+        else if (arg?.startsWith("--path=") || arg?.startsWith("--paths=")) {
+            const prefix = arg.startsWith("--path=") ? "--path=" : "--paths=";
+            parsed.pathFilter.push(...arg
+                .slice(prefix.length)
+                .split(",")
+                .map((part) => part.trim())
+                .filter(Boolean));
+            parsed.useDiffPaths = false;
+        }
+        else {
+            return { ...parsed, error: `unrecognized argument: ${arg}` };
+        }
+    }
+    return parsed;
+}
+/** Run coverage-hotspots and return the process exit code. */
+export function run(argv) {
+    const args = parseArgs(argv);
+    if (args.error !== undefined) {
+        process.stderr.write(`coverage-hotspots: ${args.error}\n`);
+        return 2;
+    }
+    const projectRoot = resolve(args.projectRoot);
+    const result = evaluateCoverageHotspots({
+        projectRoot,
+        coverageDir: args.coverageDir ?? undefined,
+        minHeadroomPp: args.minHeadroomPp ?? undefined,
+        baseRef: args.baseRef,
+        pathFilter: args.pathFilter.length > 0 ? args.pathFilter : null,
+        useDiffPaths: args.useDiffPaths,
+    });
+    if (result.exitCode === 2 || result.report === null) {
+        process.stderr.write(`${result.message}\n`);
+        return result.exitCode;
+    }
+    const payload = args.json ? formatJsonReport(result.report) : result.message;
+    if (result.exitCode === 0) {
+        if (!args.quiet) {
+            process.stdout.write(payload);
+        }
+    }
+    else {
+        process.stderr.write(payload);
+    }
+    return result.exitCode;
+}
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+    process.exit(run(process.argv.slice(2)));
+}
+//# sourceMappingURL=coverage-hotspots.js.map

package/dist/dispatch.d.ts

@@ -10,7 +10,7 @@ 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", "policy", "pr-closing-keywords", "pr-merge-readiness", "pr-monitor", "pr-protected-issues", "pr-wait-mergeable", "pr-watch", "preflight-cache", "preflight-gh", "probe-session", "release", "release-e2e", "release-publish", "release-rollback", "scope-lifecycle", "lifecycle-event", "session-start", "plan-sequence", "slice", "subagent-monitor", "toolchain-check", "triage-actions", "triage-bootstrap", "triage-bulk", "triage-classify", "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", "verify-branch", "verify-encoding", "verify-forward-coverage", "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-content-manifest", "verify-contract-drift", "verify-cursor-tier1", "verify-go-freeze", "verify-scm-boundary", "verify-session-ritual", "verify-plan-sequence", "verify-stubs", "verify-xbrief-drift", "rule-ownership-lint", "verify-story-ready", "verify-tools", "verify-wip-cap", "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", "pr-closing-keywords", "pr-merge-readiness", "pr-monitor", "pr-protected-issues", "pr-wait-mergeable", "pr-watch", "preflight-cache", "preflight-gh", "probe-session", "release", "release-e2e", "release-publish", "release-rollback", "scope-lifecycle", "lifecycle-event", "session-start", "plan-sequence", "slice", "subagent-monitor", "toolchain-check", "triage-actions", "triage-bootstrap", "triage-bulk", "triage-classify", "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", "verify-branch", "verify-encoding", "verify-forward-coverage", "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-content-manifest", "verify-contract-drift", "verify-cursor-tier1", "verify-go-freeze", "verify-scm-boundary", "verify-session-ritual", "verify-plan-sequence", "verify-stubs", "verify-xbrief-drift", "rule-ownership-lint", "verify-story-ready", "verify-review-monitor", "review-monitor-register", "verify-tools", "verify-wip-cap", "verify-agents-md-budget", "verify-agents-md-advisory", "verify-eval-health-relocation", "verify-eval-triggers-relocation", "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", "github-auth-modes", "github-body", "issue-emit", "issue-ingest", "issue-sync-from-xbrief", "reconcile-issues", "swarm-launch", "swarm-complete-cohort", "swarm-finalize-cohort", "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", "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"];
 /** Colon aliases for triage-actions (mirrors cli-router SUBCOMMAND_ROUTES). */

package/dist/dispatch.js

@@ -46,6 +46,7 @@ export const CLI_MODULE_VERBS = [
     "changelog-check",
     "change-init",
     "commit-lint",
+    "coverage-hotspots",
     "policy",
     "pr-closing-keywords",
     "pr-merge-readiness",
@@ -111,6 +112,8 @@ export const CLI_MODULE_VERBS = [
     "verify-xbrief-drift",
     "rule-ownership-lint",
     "verify-story-ready",
+    "verify-review-monitor",
+    "review-monitor-register",
     "verify-tools",
     "verify-wip-cap",
     "verify-agents-md-budget",
@@ -197,6 +200,7 @@ export const VERB_ALIASES = {
     "hook:dispatch": "hook-dispatch",
     "verify:encoding": "verify-encoding",
     "verify:forward-coverage": "verify-forward-coverage",
+    "coverage:hotspots": "coverage-hotspots",
     "verify:branch": "verify-branch",
     "verify:vbrief-conformance": "vbrief-validate",
     "verify:wip-cap": "verify-wip-cap",
@@ -211,6 +215,8 @@ export const VERB_ALIASES = {
     "xbrief:preflight": "vbrief-preflight",
     "vbrief:activate": "vbrief-activate",
     "verify:story-ready": "verify-story-ready",
+    "verify:review-monitor": "verify-review-monitor",
+    "review-monitor:register": "review-monitor-register",
     "verify:tools": "verify-tools",
     "verify:investigation": "verify-investigation",
     "verify:judgment-gates": "verify-judgment-gates",
@@ -259,6 +265,7 @@ export const VERB_ALIASES = {
     "prd:render": "prd-render",
     "project:render": "project-render",
     "project:export-spec": "export-spec",
+    "pr:watch": "pr-watch",
     doctor: "doctor",
     "eval:health": "eval-health",
     "feedback:file": "feedback-file",
@@ -2540,6 +2547,10 @@ export async function dispatch(argv, io = defaultIo()) {
     const canonical = resolveCanonicalVerb(verb ?? "");
     if (canonical === null) {
         io.writeErr(`directive: unknown verb '${verb}'\n`);
+        if (verb?.includes(":")) {
+            io.writeErr(`hint: prefer \`task ${verb}\` (Taskfile) or the hyphen stem ` +
+                `(e.g. pr:watch → pr-watch / \`task pr:watch\`)\n`);
+        }
         return 1;
     }
     try {

package/dist/hook-dispatch.d.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { type HookEvent, type HookHost } from "@deftai/directive-core/hooks";
+import { type HookEvent, type HookHost, type HookPayloadContext } from "@deftai/directive-core/hooks";
 interface ParsedArgs {
     host?: HookHost;
     event?: HookEvent;
@@ -13,6 +13,11 @@ export interface HookDispatchCliSeams {
     readonly cwd?: () => string;
 }
 export declare function parseArgs(argv: readonly string[]): ParsedArgs;
+export interface ParsedPayload {
+    readonly payload: unknown;
+    readonly context: HookPayloadContext;
+}
+export declare function parsePayload(raw: string): ParsedPayload;
 export declare function run(argv: string[], seams?: HookDispatchCliSeams): number;
 export {};
 //# sourceMappingURL=hook-dispatch.d.ts.map

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, isHookEvent, isHookHost, projectRootFromHookPayload, renderHostDecision, } from "@deftai/directive-core/hooks";
+import { decideHook, hookPayloadTopLevelKeys, isHookEvent, isHookHost, projectRootFromHookPayload, renderHostDecision, } from "@deftai/directive-core/hooks";
 function takeValue(argv, index, flag) {
     const token = argv[index];
     const prefix = `${flag}=`;
@@ -57,16 +57,17 @@ export function parseArgs(argv) {
         return { error: "--event is required" };
     return parsed;
 }
-function parsePayload(raw) {
-    if (raw.trim().length === 0)
-        return {};
+export function parsePayload(raw) {
+    if (raw.trim().length === 0) {
+        return { payload: {}, context: { stdinEmpty: true } };
+    }
     try {
-        return JSON.parse(raw);
+        return { payload: JSON.parse(raw), context: {} };
     }
     catch {
         // tool.before is installed only on direct-write matchers, so an unreadable
         // payload becomes a missing-tool denial rather than a fail-open crash.
-        return {};
+        return { payload: {}, context: { parseFailed: true } };
     }
 }
 export function run(argv, seams = {}) {
@@ -79,7 +80,7 @@ export function run(argv, seams = {}) {
     }
     const readStdin = seams.readStdin ?? (() => readFileSync(0, "utf8"));
     const cwd = (seams.cwd ?? process.cwd)();
-    const payload = parsePayload(readStdin());
+    const { payload, context: payloadContext } = parsePayload(readStdin());
     const projectRoot = args.projectRoot
         ? resolve(args.projectRoot)
         : projectRootFromHookPayload(payload, cwd);
@@ -88,10 +89,18 @@ export function run(argv, seams = {}) {
         event: args.event,
         projectRoot,
         payload,
+        payloadContext,
     });
     const rendered = renderHostDecision(args.host, decision);
     if (rendered.length > 0)
         writeOut(`${rendered}\n`);
+    if (decision.code === "invalid-input" && args.host === "cursor") {
+        // Keys are already embedded in decision.message; stderr helps operators tailing logs.
+        const keys = hookPayloadTopLevelKeys(payload);
+        if (keys.length > 0) {
+            writeErr(`Directive hook diagnostic: payload top-level keys: ${keys.join(", ")}\n`);
+        }
+    }
     if (decision.code === "session-start-degraded")
         writeErr(`${decision.message}\n`);
     return 0;

package/dist/review-monitor-register.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { type PlatformPrimitive } from "@deftai/directive-core/review-monitor";
+interface ParsedArgs {
+    pr: number | null;
+    monitorAgentId: string | null;
+    platformPrimitive: PlatformPrimitive | null;
+    repo: string | null;
+    headSha: string | null;
+    projectRoot: string;
+    parentSessionId: string | null;
+    help: boolean;
+    error?: string;
+}
+export declare function parseRegisterArgs(argv: readonly string[]): ParsedArgs;
+export declare function run(argv: readonly string[]): number;
+export {};
+//# sourceMappingURL=review-monitor-register.d.ts.map

package/dist/review-monitor-register.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { REGISTER_HELP, registerReviewMonitor, } from "@deftai/directive-core/review-monitor";
+const PRIMITIVES = new Set(["start_agent", "spawn_subagent", "cursor-task"]);
+export function parseRegisterArgs(argv) {
+    const acc = {
+        pr: null,
+        monitorAgentId: null,
+        platformPrimitive: null,
+        repo: null,
+        headSha: null,
+        projectRoot: ".",
+        parentSessionId: null,
+        help: false,
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--help" || arg === "-h") {
+            return { ...acc, help: true };
+        }
+        if (arg === "--pr") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...acc, error: "argument --pr: expected one argument" };
+            }
+            const n = Number(value);
+            if (!Number.isInteger(n) || n <= 0) {
+                return { ...acc, error: `invalid --pr value: ${value}` };
+            }
+            acc.pr = n;
+            i += 1;
+        }
+        else if (arg?.startsWith("--pr=")) {
+            const n = Number(arg.slice("--pr=".length));
+            if (!Number.isInteger(n) || n <= 0) {
+                return { ...acc, error: `invalid --pr value: ${arg}` };
+            }
+            acc.pr = n;
+        }
+        else if (arg === "--monitor-agent-id") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...acc, error: "argument --monitor-agent-id: expected one argument" };
+            }
+            acc.monitorAgentId = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--monitor-agent-id=")) {
+            acc.monitorAgentId = arg.slice("--monitor-agent-id=".length);
+        }
+        else if (arg === "--platform-primitive") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...acc, error: "argument --platform-primitive: expected one argument" };
+            }
+            if (!PRIMITIVES.has(value)) {
+                return { ...acc, error: `invalid --platform-primitive: ${value}` };
+            }
+            acc.platformPrimitive = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--platform-primitive=")) {
+            const value = arg.slice("--platform-primitive=".length);
+            if (!PRIMITIVES.has(value)) {
+                return { ...acc, error: `invalid --platform-primitive: ${value}` };
+            }
+            acc.platformPrimitive = value;
+        }
+        else if (arg === "--repo") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...acc, error: "argument --repo: expected one argument" };
+            }
+            acc.repo = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--repo=")) {
+            acc.repo = arg.slice("--repo=".length);
+        }
+        else if (arg === "--head-sha") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...acc, error: "argument --head-sha: expected one argument" };
+            }
+            acc.headSha = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--head-sha=")) {
+            acc.headSha = arg.slice("--head-sha=".length);
+        }
+        else if (arg === "--project-root") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...acc, error: "argument --project-root: expected one argument" };
+            }
+            acc.projectRoot = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--project-root=")) {
+            acc.projectRoot = arg.slice("--project-root=".length);
+        }
+        else if (arg === "--parent-session-id") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...acc, error: "argument --parent-session-id: expected one argument" };
+            }
+            acc.parentSessionId = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--parent-session-id=")) {
+            acc.parentSessionId = arg.slice("--parent-session-id=".length);
+        }
+        else if (arg?.startsWith("-")) {
+            return { ...acc, error: `unrecognized argument: ${arg}` };
+        }
+        else {
+            return { ...acc, error: `unrecognized argument: ${arg}` };
+        }
+    }
+    return acc;
+}
+export function run(argv) {
+    const args = parseRegisterArgs(argv);
+    if (args.help) {
+        process.stdout.write(REGISTER_HELP);
+        return 0;
+    }
+    if (args.error !== undefined) {
+        process.stderr.write(`review_monitor_register: ${args.error}\n`);
+        return 2;
+    }
+    if (args.pr === null) {
+        process.stderr.write("review_monitor_register: --pr is required\n");
+        return 2;
+    }
+    if (args.monitorAgentId === null || args.monitorAgentId.trim().length === 0) {
+        process.stderr.write("review_monitor_register: --monitor-agent-id is required\n");
+        return 2;
+    }
+    if (args.platformPrimitive === null) {
+        process.stderr.write("review_monitor_register: --platform-primitive is required\n");
+        return 2;
+    }
+    try {
+        const { path, record } = registerReviewMonitor({
+            pr: args.pr,
+            repo: args.repo,
+            headSha: args.headSha,
+            platformPrimitive: args.platformPrimitive,
+            monitorAgentId: args.monitorAgentId,
+            projectRoot: resolve(args.projectRoot),
+            parentSessionId: args.parentSessionId,
+        });
+        process.stdout.write(`review_monitor_register: recorded PR #${record.pr} monitor ${record.monitor_agent_id} at ${path}\n`);
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`review_monitor_register: ${String(err.message ?? err)}\n`);
+        return 2;
+    }
+}
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+    process.exit(run(process.argv.slice(2)));
+}
+//# sourceMappingURL=review-monitor-register.js.map

package/dist/verify-review-monitor.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { type ReviewMonitorCallSite } from "@deftai/directive-core/review-monitor";
+interface ParsedArgs {
+    pr: number | null;
+    projectRoot: string;
+    repo: string | null;
+    headSha: string | null;
+    callSite: ReviewMonitorCallSite;
+    approach3: boolean;
+    approach3Warned: boolean;
+    emitJson: boolean;
+    help: boolean;
+    error?: string;
+}
+export declare function parseVerifyReviewMonitorArgs(argv: readonly string[]): ParsedArgs;
+export declare function run(argv: readonly string[]): number;
+export {};
+//# sourceMappingURL=verify-review-monitor.d.ts.map

package/dist/verify-review-monitor.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { evaluateReviewMonitorGate, REVIEW_MONITOR_HELP, verifyResultToJson, } from "@deftai/directive-core/review-monitor";
+const CALL_SITES = new Set([
+    "solo",
+    "swarm-phase5-6",
+    "swarm-phase6-cascade",
+    "unspecified",
+]);
+export function parseVerifyReviewMonitorArgs(argv) {
+    const acc = {
+        pr: null,
+        projectRoot: ".",
+        repo: null,
+        headSha: null,
+        callSite: "unspecified",
+        approach3: false,
+        approach3Warned: false,
+        emitJson: false,
+        help: false,
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--help" || arg === "-h") {
+            return { ...acc, help: true };
+        }
+        if (arg === "--json") {
+            acc.emitJson = true;
+        }
+        else if (arg === "--approach3") {
+            acc.approach3 = true;
+        }
+        else if (arg === "--approach3-warned") {
+            acc.approach3Warned = true;
+        }
+        else if (arg === "--pr") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...acc, error: "argument --pr: expected one argument" };
+            }
+            const n = Number(value);
+            if (!Number.isInteger(n) || n <= 0) {
+                return { ...acc, error: `invalid --pr value: ${value}` };
+            }
+            acc.pr = n;
+            i += 1;
+        }
+        else if (arg?.startsWith("--pr=")) {
+            const n = Number(arg.slice("--pr=".length));
+            if (!Number.isInteger(n) || n <= 0) {
+                return { ...acc, error: `invalid --pr value: ${arg}` };
+            }
+            acc.pr = n;
+        }
+        else if (arg === "--repo") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...acc, error: "argument --repo: expected one argument" };
+            }
+            acc.repo = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--repo=")) {
+            acc.repo = arg.slice("--repo=".length);
+        }
+        else if (arg === "--head-sha") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...acc, error: "argument --head-sha: expected one argument" };
+            }
+            acc.headSha = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--head-sha=")) {
+            acc.headSha = arg.slice("--head-sha=".length);
+        }
+        else if (arg === "--project-root") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...acc, error: "argument --project-root: expected one argument" };
+            }
+            acc.projectRoot = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--project-root=")) {
+            acc.projectRoot = arg.slice("--project-root=".length);
+        }
+        else if (arg === "--call-site") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...acc, error: "argument --call-site: expected one argument" };
+            }
+            if (!CALL_SITES.has(value)) {
+                return { ...acc, error: `invalid --call-site: ${value}` };
+            }
+            acc.callSite = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--call-site=")) {
+            const value = arg.slice("--call-site=".length);
+            if (!CALL_SITES.has(value)) {
+                return { ...acc, error: `invalid --call-site: ${value}` };
+            }
+            acc.callSite = value;
+        }
+        else if (arg?.startsWith("-")) {
+            return { ...acc, error: `unrecognized argument: ${arg}` };
+        }
+        else {
+            return { ...acc, error: `unrecognized argument: ${arg}` };
+        }
+    }
+    return acc;
+}
+export function run(argv) {
+    const args = parseVerifyReviewMonitorArgs(argv);
+    if (args.help) {
+        process.stdout.write(REVIEW_MONITOR_HELP);
+        return 0;
+    }
+    if (args.error !== undefined) {
+        process.stderr.write(`verify_review_monitor: ${args.error}\n`);
+        process.stderr.write("Try: task verify:review-monitor -- --help\n");
+        return 2;
+    }
+    if (args.pr === null) {
+        process.stderr.write("verify_review_monitor: --pr is required\n");
+        process.stderr.write("Try: task verify:review-monitor -- --help\n");
+        return 2;
+    }
+    const result = evaluateReviewMonitorGate({
+        pr: args.pr,
+        projectRoot: resolve(args.projectRoot),
+        repo: args.repo,
+        headSha: args.headSha,
+        callSite: args.callSite,
+        approach3: args.approach3,
+        approach3Warned: args.approach3Warned,
+        environ: process.env,
+    });
+    if (args.emitJson) {
+        process.stdout.write(`${JSON.stringify(verifyResultToJson(result), null, 2)}\n`);
+    }
+    else if (result.exitCode === 0) {
+        process.stdout.write(`${result.message}\n`);
+    }
+    else {
+        process.stderr.write(`${result.message}\n`);
+    }
+    return result.exitCode;
+}
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+    process.exit(run(process.argv.slice(2)));
+}
+//# sourceMappingURL=verify-review-monitor.js.map

package/dist/verify-session-ritual.js

@@ -19,6 +19,9 @@ export function parseArgs(argv) {
     };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
+        if (arg === "--") {
+            continue;
+        }
         if (arg === "--json") {
             parsed.emitJson = true;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive",
-  "version": "0.79.2",
+  "version": "0.79.4",
   "description": "Directive CLI — npm install path for the Deft Directive framework.",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,8 +31,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-core": "^0.79.2",
-    "@deftai/directive-content": "^0.79.2"
+    "@deftai/directive-core": "^0.79.4",
+    "@deftai/directive-content": "^0.79.4"
   },
   "scripts": {
     "build": "tsc -b"