@deftai/directive 0.76.0 → 0.78.0

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

@@ -82,6 +82,10 @@ export const SUBCOMMAND_ROUTES = {
     "github-body:comment-create": ["github-body", "comment-create"],
     "github-body:comment-edit": ["github-body", "comment-edit"],
     "github-body:pr-edit": ["github-body", "pr-edit"],
+    "plan-sequence:set": ["plan-sequence", "set"],
+    "plan-sequence:current": ["plan-sequence", "current"],
+    "plan-sequence:clear": ["plan-sequence", "clear"],
+    "plan-sequence:advance": ["plan-sequence", "advance"],
 };
 function isMetaVerb(token) {
     return token === "--help" || token === "-h" || token === "--version" || token === "-V";

package/dist/dispatch.d.ts

@@ -10,13 +10,15 @@ 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", "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", "session-start", "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-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", "eval-health", "eval-run", "eval-report"];
+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", "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"];
 /** 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", "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). */
 export declare const TRIAGE_ACTION_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
 /** Colon aliases for policy subcommands (mirrors cli-router SUBCOMMAND_ROUTES). */
 export declare const POLICY_ACTION_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
+/** Colon aliases for plan-sequence subcommands (#2402). */
+export declare const PLAN_SEQUENCE_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
 /** Task-style aliases (framework_commands / Taskfile names). */
 export declare const VERB_ALIASES: Readonly<Record<string, string>>;
 /** Pinned ghx version (display only) — keep in lockstep with .github/workflows/ci.yml env.GHX_VERSION. */

package/dist/dispatch.js

@@ -41,6 +41,7 @@ export const CLI_MODULE_VERBS = [
     "migrate-xbrief",
     "migrate-category-b",
     "framework-check-updates",
+    "hook-dispatch",
     "umbrella-current-shape",
     "changelog-check",
     "change-init",
@@ -61,6 +62,7 @@ export const CLI_MODULE_VERBS = [
     "release-rollback",
     "scope-lifecycle",
     "session-start",
+    "plan-sequence",
     "slice",
     "subagent-monitor",
     "toolchain-check",
@@ -103,6 +105,7 @@ export const CLI_MODULE_VERBS = [
     "verify-go-freeze",
     "verify-scm-boundary",
     "verify-session-ritual",
+    "verify-plan-sequence",
     "verify-stubs",
     "verify-xbrief-drift",
     "rule-ownership-lint",
@@ -112,9 +115,11 @@ export const CLI_MODULE_VERBS = [
     "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 const CORE_MODULE_VERBS = [
@@ -177,8 +182,17 @@ export const POLICY_ACTION_ALIAS_SUBCOMMANDS = {
     "policy:enable-value-feedback": "enable-value-feedback",
 };
 const POLICY_ACTION_COLON_ALIASES = Object.fromEntries(Object.keys(POLICY_ACTION_ALIAS_SUBCOMMANDS).map((alias) => [alias, "policy"]));
+/** Colon aliases for plan-sequence subcommands (#2402). */
+export const PLAN_SEQUENCE_ALIAS_SUBCOMMANDS = {
+    "plan-sequence:set": "set",
+    "plan-sequence:current": "current",
+    "plan-sequence:clear": "clear",
+    "plan-sequence:advance": "advance",
+};
+const PLAN_SEQUENCE_COLON_ALIASES = Object.fromEntries(Object.keys(PLAN_SEQUENCE_ALIAS_SUBCOMMANDS).map((alias) => [alias, "plan-sequence"]));
 /** Task-style aliases (framework_commands / Taskfile names). */
 export const VERB_ALIASES = {
+    "hook:dispatch": "hook-dispatch",
     "verify:encoding": "verify-encoding",
     "verify:forward-coverage": "verify-forward-coverage",
     "verify:branch": "verify-branch",
@@ -187,6 +201,7 @@ export const VERB_ALIASES = {
     "verify:agents-md-budget": "verify-agents-md-budget",
     "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:hooks-installed": "verify-hooks-installed",
     "verify:no-task-runtime": "verify-no-task-runtime",
     "vbrief:validate": "vbrief-validate",
@@ -212,6 +227,8 @@ export const VERB_ALIASES = {
     "verify:xbrief-drift": "verify-xbrief-drift",
     "verify:capacity": "verify-capacity",
     "verify:session-ritual": "verify-session-ritual",
+    "verify:plan-sequence": "verify-plan-sequence",
+    ...PLAN_SEQUENCE_COLON_ALIASES,
     "verify-strategy-output": "validate-strategy-output",
     "validate:strategy-output": "validate-strategy-output",
     "verify:codebase-map-fresh": "codebase-map-fresh",
@@ -244,6 +261,7 @@ export const VERB_ALIASES = {
     "value:show": "value-readback",
     "triage:metrics": "value-readback",
     "eval:run": "eval-run",
+    "eval:triggers": "eval-triggers",
     "eval:report": "eval-report",
     build: "framework-commands",
     "setup:ghx": "setup-ghx",
@@ -2514,13 +2532,16 @@ export async function dispatch(argv, io = defaultIo()) {
         const handler = await loadHandler(canonical, io);
         const triageSubcommand = verb !== undefined ? TRIAGE_ACTION_ALIAS_SUBCOMMANDS[verb] : undefined;
         const policySubcommand = verb !== undefined ? POLICY_ACTION_ALIAS_SUBCOMMANDS[verb] : undefined;
+        const planSequenceSubcommand = verb !== undefined ? PLAN_SEQUENCE_ALIAS_SUBCOMMANDS[verb] : undefined;
         const handlerArgv = canonical === "framework-commands" && verb !== undefined && verb !== canonical
             ? [verb, ...rest]
             : triageSubcommand !== undefined && canonical === "triage-actions"
                 ? [triageSubcommand, ...rest]
                 : policySubcommand !== undefined && canonical === "policy"
                     ? [policySubcommand, ...rest]
-                    : rest;
+                    : planSequenceSubcommand !== undefined && canonical === "plan-sequence"
+                        ? [planSequenceSubcommand, ...rest]
+                        : rest;
         return await invokeHandler(handler, handlerArgv);
     }
     catch (err) {

package/dist/eval-triggers.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+interface ParsedArgs {
+    projectRoot: string;
+    json: boolean;
+    error?: string;
+}
+/** Parse eval-triggers CLI args. */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+/** Run eval:triggers (offline skill-pi-trigger-eval routing) and return exit code. */
+export declare function run(argv: string[]): number;
+export {};
+//# sourceMappingURL=eval-triggers.d.ts.map

package/dist/eval-triggers.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { runTriggerEval } from "@deftai/directive-core/eval/triggers";
+/** Parse eval-triggers CLI args. */
+export function parseArgs(argv) {
+    const parsed = {
+        projectRoot: ".",
+        json: false,
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--json") {
+            parsed.json = 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 eval:triggers (offline skill-pi-trigger-eval routing) and return exit code. */
+export function run(argv) {
+    const args = parseArgs(argv);
+    if (args.error !== undefined) {
+        process.stderr.write(`eval:triggers: ${args.error}\n`);
+        return 2;
+    }
+    const result = runTriggerEval({ projectRoot: resolve(args.projectRoot) });
+    if (result.report === null) {
+        process.stderr.write(`${result.message}\n`);
+        return result.code;
+    }
+    if (args.json) {
+        process.stdout.write(`${JSON.stringify(result.report, null, 2)}\n`);
+    }
+    else {
+        process.stdout.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=eval-triggers.js.map

package/dist/hook-dispatch.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { type HookEvent, type HookHost } from "@deftai/directive-core/hooks";
+interface ParsedArgs {
+    host?: HookHost;
+    event?: HookEvent;
+    projectRoot?: string;
+    error?: string;
+}
+export interface HookDispatchCliSeams {
+    readonly readStdin?: () => string;
+    readonly writeOut?: (text: string) => void;
+    readonly writeErr?: (text: string) => void;
+    readonly cwd?: () => string;
+}
+export declare function parseArgs(argv: readonly string[]): ParsedArgs;
+export declare function run(argv: string[], seams?: HookDispatchCliSeams): number;
+export {};
+//# sourceMappingURL=hook-dispatch.d.ts.map

package/dist/hook-dispatch.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+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";
+function takeValue(argv, index, flag) {
+    const token = argv[index];
+    const prefix = `${flag}=`;
+    if (token?.startsWith(prefix))
+        return { value: token.slice(prefix.length), next: index };
+    const value = argv[index + 1];
+    if (value === undefined)
+        return { next: index, error: `argument ${flag}: expected one argument` };
+    return { value, next: index + 1 };
+}
+export function parseArgs(argv) {
+    const parsed = {};
+    for (let i = 0; i < argv.length; i += 1) {
+        const token = argv[i];
+        if (token === "--host" || token?.startsWith("--host=")) {
+            const taken = takeValue(argv, i, "--host");
+            if (taken.error)
+                return { error: taken.error };
+            const value = taken.value ?? "";
+            if (!isHookHost(value)) {
+                return { error: `unsupported host: ${JSON.stringify(taken.value)}` };
+            }
+            parsed.host = value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--event" || token?.startsWith("--event=")) {
+            const taken = takeValue(argv, i, "--event");
+            if (taken.error)
+                return { error: taken.error };
+            const value = taken.value ?? "";
+            if (!isHookEvent(value)) {
+                return { error: `unsupported event: ${JSON.stringify(taken.value)}` };
+            }
+            parsed.event = value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--project-root" || token?.startsWith("--project-root=")) {
+            const taken = takeValue(argv, i, "--project-root");
+            if (taken.error)
+                return { error: taken.error };
+            parsed.projectRoot = taken.value;
+            i = taken.next;
+            continue;
+        }
+        return { error: `unrecognized argument: ${token}` };
+    }
+    if (parsed.host === undefined)
+        return { error: "--host is required" };
+    if (parsed.event === undefined)
+        return { error: "--event is required" };
+    return parsed;
+}
+function parsePayload(raw) {
+    if (raw.trim().length === 0)
+        return {};
+    try {
+        return JSON.parse(raw);
+    }
+    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 {};
+    }
+}
+export function run(argv, seams = {}) {
+    const args = parseArgs(argv);
+    const writeOut = seams.writeOut ?? ((text) => process.stdout.write(text));
+    const writeErr = seams.writeErr ?? ((text) => process.stderr.write(text));
+    if (args.error !== undefined || args.host === undefined || args.event === undefined) {
+        writeErr(`${args.error ?? "invalid hook-dispatch arguments"}\n`);
+        return 2;
+    }
+    const readStdin = seams.readStdin ?? (() => readFileSync(0, "utf8"));
+    const cwd = (seams.cwd ?? process.cwd)();
+    const payload = parsePayload(readStdin());
+    const projectRoot = args.projectRoot
+        ? resolve(args.projectRoot)
+        : projectRootFromHookPayload(payload, cwd);
+    const decision = decideHook({
+        host: args.host,
+        event: args.event,
+        projectRoot,
+        payload,
+    });
+    const rendered = renderHostDecision(args.host, decision);
+    if (rendered.length > 0)
+        writeOut(`${rendered}\n`);
+    if (decision.code === "session-start-degraded")
+        writeErr(`${decision.message}\n`);
+    return 0;
+}
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+    process.exit(run(process.argv.slice(2)));
+}
+//# sourceMappingURL=hook-dispatch.js.map

package/dist/plan-sequence.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function main(argv?: string[]): number;
+//# sourceMappingURL=plan-sequence.d.ts.map

package/dist/plan-sequence.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+/**
+ * plan-sequence CLI (#2402): set | current | clear | advance
+ */
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { advancePlanSequence, clearPlanSequence, createPlanSequence, parsePlanSequence, readPlanSequence, writePlanSequence, } from "@deftai/directive-core/plan-sequence";
+function parseArgs(argv) {
+    const parsed = {
+        projectRoot: ".",
+        action: null,
+        file: null,
+        jsonInline: null,
+        emitJson: false,
+    };
+    const positionals = [];
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === undefined)
+            continue;
+        if (arg === "--json") {
+            parsed.emitJson = true;
+        }
+        else if (arg === "--project-root") {
+            const value = argv[++i];
+            if (value === undefined) {
+                return { ...parsed, error: "--project-root requires a value" };
+            }
+            parsed.projectRoot = value;
+        }
+        else if (arg.startsWith("--project-root=")) {
+            parsed.projectRoot = arg.slice("--project-root=".length);
+        }
+        else if (arg === "--file") {
+            const value = argv[++i];
+            if (value === undefined) {
+                return { ...parsed, error: "--file requires a path" };
+            }
+            parsed.file = value;
+        }
+        else if (arg.startsWith("--file=")) {
+            parsed.file = arg.slice("--file=".length);
+        }
+        else if (arg === "--from-json") {
+            const value = argv[++i];
+            if (value === undefined) {
+                return { ...parsed, error: "--from-json requires a JSON string" };
+            }
+            parsed.jsonInline = value;
+        }
+        else if (arg.startsWith("-")) {
+            return { ...parsed, error: `unknown flag: ${arg}` };
+        }
+        else {
+            positionals.push(arg);
+        }
+    }
+    const action = positionals[0];
+    if (action === "set" || action === "current" || action === "clear" || action === "advance") {
+        parsed.action = action;
+    }
+    else if (action !== undefined) {
+        return { ...parsed, error: `unknown action: ${action} (set|current|clear|advance)` };
+    }
+    else {
+        parsed.error =
+            "usage: plan-sequence <set|current|clear|advance> [--file path] [--project-root path]";
+    }
+    return parsed;
+}
+function loadSetPayload(parsed, root) {
+    const text = parsed.file ? readFileSync(resolve(root, parsed.file), "utf8") : parsed.jsonInline;
+    if (text === null || text === undefined) {
+        throw new Error("plan-sequence set requires --file <path> or --from-json <json>");
+    }
+    const payload = JSON.parse(text);
+    if (typeof payload !== "object" || payload === null || Array.isArray(payload)) {
+        throw new Error("plan-sequence set: --file/--from-json must contain a JSON object");
+    }
+    const raw = payload;
+    if (typeof raw.current_index === "number" || raw.exhausted === true) {
+        return parsePlanSequence(raw);
+    }
+    return createPlanSequence({
+        sequence_id: String(raw.sequence_id),
+        sequence_kind: raw.sequence_kind,
+        entries: raw.entries,
+        authorized_by: String(raw.authorized_by ?? ""),
+        batching_allowed: raw.batching_allowed === true,
+        continuation_past_final: raw.continuation_past_final === true,
+    });
+}
+export function main(argv = process.argv.slice(2)) {
+    const parsed = parseArgs(argv);
+    if (parsed.error || parsed.action === null) {
+        process.stderr.write(`${parsed.error ?? "usage error"}\n`);
+        return 2;
+    }
+    const root = resolve(parsed.projectRoot);
+    try {
+        if (parsed.action === "set") {
+            const seq = loadSetPayload(parsed, root);
+            const path = writePlanSequence(root, seq);
+            if (parsed.emitJson) {
+                process.stdout.write(`${JSON.stringify({ ok: true, path, sequence: seq }, null, 2)}\n`);
+            }
+            else {
+                process.stdout.write(`OK plan-sequence set ${seq.sequence_id} (${seq.entries.length} entries, index=${seq.current_index})\n`);
+            }
+            return 0;
+        }
+        if (parsed.action === "current") {
+            const seq = readPlanSequence(root);
+            if (seq === null) {
+                process.stderr.write("No active ordered-plan sequence (.deft/plan-sequence.json missing).\n");
+                return 1;
+            }
+            if (parsed.emitJson) {
+                process.stdout.write(`${JSON.stringify(seq, null, 2)}\n`);
+            }
+            else {
+                const cur = seq.exhausted ? null : seq.entries[seq.current_index];
+                process.stdout.write(`sequence_id=${seq.sequence_id} kind=${seq.sequence_kind} index=${seq.current_index} exhausted=${String(seq.exhausted)}\n`);
+                if (cur) {
+                    const issue = cur.issue !== undefined ? ` (#${cur.issue})` : "";
+                    process.stdout.write(`current: ${cur.kind}:${cur.id}${issue}\n`);
+                }
+                else {
+                    process.stdout.write("current: (exhausted — fresh approval required)\n");
+                }
+            }
+            return 0;
+        }
+        if (parsed.action === "clear") {
+            const cleared = clearPlanSequence(root);
+            process.stdout.write(cleared ? "OK plan-sequence cleared\n" : "OK plan-sequence already absent\n");
+            return 0;
+        }
+        const seq = readPlanSequence(root);
+        if (seq === null) {
+            process.stderr.write("No active ordered-plan sequence to advance.\n");
+            return 1;
+        }
+        const next = advancePlanSequence(seq);
+        writePlanSequence(root, next);
+        if (parsed.emitJson) {
+            process.stdout.write(`${JSON.stringify(next, null, 2)}\n`);
+        }
+        else if (next.exhausted) {
+            process.stdout.write("OK advanced; sequence exhausted. Fresh operator approval required before another unit.\n");
+        }
+        else {
+            const cur = next.entries[next.current_index];
+            process.stdout.write(`OK advanced to index=${next.current_index} (${cur?.kind}:${cur?.id})\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`);
+        return 1;
+    }
+}
+if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+    process.exit(main());
+}
+//# sourceMappingURL=plan-sequence.js.map

package/dist/verify-eval-triggers-relocation.d.ts

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

package/dist/verify-eval-triggers-relocation.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { evaluate } from "@deftai/directive-core/eval-triggers-relocation";
+/** Parse verify-eval-triggers-relocation CLI args. */
+export function parseArgs(argv) {
+    const parsed = {
+        projectRoot: ".",
+        staged: false,
+        quiet: false,
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--staged") {
+            parsed.staged = true;
+        }
+        else if (arg === "--quiet") {
+            parsed.quiet = true;
+        }
+        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 === "--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 verify:eval-triggers-relocation and return exit code. */
+export function run(argv) {
+    const args = parseArgs(argv);
+    if (args.error !== undefined) {
+        process.stderr.write(`verify:eval-triggers-relocation: ${args.error}\n`);
+        return 2;
+    }
+    const result = evaluate({
+        projectRoot: resolve(args.projectRoot),
+        baseRef: args.baseRef,
+        staged: args.staged,
+        quiet: args.quiet,
+    });
+    if (result.message.length > 0) {
+        if (result.stream === "stderr") {
+            process.stderr.write(`${result.message}\n`);
+        }
+        else if (result.stream === "stdout") {
+            process.stdout.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-eval-triggers-relocation.js.map

package/dist/verify-hooks-installed.d.ts

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
+type HookScope = "git" | "agent" | "all";
 interface ParsedArgs {
     projectRoot: string;
     quiet: boolean;
+    scope: HookScope;
     error?: string;
 }
 export declare function parseArgs(argv: string[]): ParsedArgs;

package/dist/verify-hooks-installed.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { evaluate } from "@deftai/directive-core/verify-env";
+import { evaluate, evaluateAgentHooks } from "@deftai/directive-core/verify-env";
 export function parseArgs(argv) {
-    const parsed = { projectRoot: ".", quiet: false };
+    const parsed = { projectRoot: ".", quiet: false, scope: "git" };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
         if (arg === "--quiet")
@@ -19,6 +19,24 @@ export function parseArgs(argv) {
         else if (arg?.startsWith("--project-root=")) {
             parsed.projectRoot = arg.slice("--project-root=".length);
         }
+        else if (arg === "--scope") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --scope: expected one argument" };
+            }
+            if (value !== "git" && value !== "agent" && value !== "all") {
+                return { ...parsed, error: `argument --scope: invalid choice: '${value}'` };
+            }
+            parsed.scope = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--scope=")) {
+            const value = arg.slice("--scope=".length);
+            if (value !== "git" && value !== "agent" && value !== "all") {
+                return { ...parsed, error: `argument --scope: invalid choice: '${value}'` };
+            }
+            parsed.scope = value;
+        }
         else {
             return { ...parsed, error: `unrecognized arguments: ${arg}` };
         }
@@ -31,16 +49,22 @@ export function run(argv) {
         process.stderr.write(`${args.error}\n`);
         return 2;
     }
-    const result = evaluate(resolve(args.projectRoot));
+    const projectRoot = resolve(args.projectRoot);
+    const results = [
+        ...(args.scope === "git" || args.scope === "all" ? [evaluate(projectRoot)] : []),
+        ...(args.scope === "agent" || args.scope === "all" ? [evaluateAgentHooks(projectRoot)] : []),
+    ];
     if (!args.quiet) {
-        if (result.stream === "stdout") {
-            process.stdout.write(`${result.message}\n`);
-        }
-        else if (result.stream === "stderr") {
-            process.stderr.write(`${result.message}\n`);
+        for (const result of results) {
+            if (result.stream === "stdout") {
+                process.stdout.write(`${result.message}\n`);
+            }
+            else if (result.stream === "stderr") {
+                process.stderr.write(`${result.message}\n`);
+            }
         }
     }
-    return result.code;
+    return Math.max(...results.map((result) => result.code));
 }
 if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
     process.exit(run(process.argv.slice(2)));

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

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function main(argv?: string[]): number;
+//# sourceMappingURL=verify-plan-sequence.d.ts.map

package/dist/verify-plan-sequence.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+/**
+ * verify:plan-sequence (#2402) — fail closed unless target matches current entry.
+ */
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { readPlanSequence, verifyPlanTarget, } from "@deftai/directive-core/plan-sequence";
+const KINDS = [
+    "pr",
+    "issue",
+    "story",
+    "task",
+    "phase",
+    "checklist",
+    "review",
+];
+function parseArgs(argv) {
+    const parsed = {
+        projectRoot: ".",
+        targetKind: null,
+        target: null,
+        emitJson: false,
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === undefined)
+            continue;
+        if (arg === "--json") {
+            parsed.emitJson = true;
+        }
+        else if (arg === "--project-root") {
+            const value = argv[++i];
+            if (value === undefined)
+                return { ...parsed, error: "--project-root requires a value" };
+            parsed.projectRoot = value;
+        }
+        else if (arg.startsWith("--project-root=")) {
+            parsed.projectRoot = arg.slice("--project-root=".length);
+        }
+        else if (arg === "--target-kind") {
+            const value = argv[++i];
+            if (value === undefined || !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)) {
+                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)
+                return { ...parsed, error: "--target requires a value" };
+            parsed.target = value;
+        }
+        else if (arg.startsWith("--target=")) {
+            parsed.target = arg.slice("--target=".length);
+        }
+        else if (arg.startsWith("-")) {
+            return { ...parsed, error: `unknown flag: ${arg}` };
+        }
+    }
+    if (parsed.targetKind === null || parsed.target === null) {
+        return {
+            ...parsed,
+            error: "usage: verify:plan-sequence -- --target-kind <kind> --target <id-or-title>",
+        };
+    }
+    return parsed;
+}
+export function main(argv = process.argv.slice(2)) {
+    const parsed = parseArgs(argv);
+    if (parsed.error || parsed.targetKind === null || parsed.target === null) {
+        process.stderr.write(`${parsed.error ?? "usage error"}\n`);
+        return 2;
+    }
+    const seq = readPlanSequence(resolve(parsed.projectRoot));
+    // No sequence: allow (caller may have explicit operator approval); warn on stderr.
+    if (seq === null) {
+        if (parsed.emitJson) {
+            process.stdout.write(`${JSON.stringify({ ok: true, skipped: true, reason: "no-active-sequence" }, null, 2)}\n`);
+        }
+        else {
+            process.stdout.write("OK verify:plan-sequence skipped (no active ordered-plan sequence)\n");
+        }
+        return 0;
+    }
+    const result = verifyPlanTarget(seq, {
+        targetKind: parsed.targetKind,
+        target: parsed.target,
+    });
+    if (parsed.emitJson) {
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    }
+    else if (result.ok) {
+        process.stdout.write(`OK verify:plan-sequence matched ${result.entry.kind}:${result.entry.id} (index=${result.index})\n`);
+    }
+    else {
+        process.stderr.write(`${result.message}\n`);
+    }
+    return result.ok ? 0 : 1;
+}
+if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+    process.exit(main());
+}
+//# sourceMappingURL=verify-plan-sequence.js.map

package/package.json

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