@deftai/directive 0.105.0 → 0.106.0

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

@@ -83,6 +83,7 @@ export const SUBCOMMAND_ROUTES = {
     "policy:allow-direct-commits": ["policy", "allow-direct-commits"],
     "policy:allow-bot-merge": ["policy", "allow-bot-merge"],
     "policy:enable-value-feedback": ["policy", "enable-value-feedback"],
+    "policy:disable-host-hooks": ["policy", "disable-host-hooks"],
     "policy:set-ceremony-dial": ["policy", "set-ceremony-dial"],
     "policy:clear-value-feedback": ["policy", "clear-value-feedback"],
     "authz:show": ["authz", "show"],

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", "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", "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", "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-skill-external-fetch-gate", "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", "rule-ownership-lint", "verify-story-ready", "verify-review-monitor", "verify-l4-owner", "verify-subagent-alive", "review-monitor-register", "review-monitor-release", "verify-tools", "verify-wip-cap", "verify-orphan-active", "verify-completed-tracked", "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", "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", "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-skill-external-fetch-gate", "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", "rule-ownership-lint", "verify-story-ready", "verify-review-monitor", "verify-l4-owner", "verify-subagent-alive", "review-monitor-register", "review-monitor-release", "verify-tools", "verify-wip-cap", "verify-orphan-active", "verify-lifecycle-visible", "verify-completed-tracked", "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"];
 /** 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"];
 /** Colon aliases for triage-actions (mirrors cli-router SUBCOMMAND_ROUTES). */
@@ -177,6 +177,12 @@ export declare function printCommandsList(io?: DispatchIo): void;
  * (#2172). Preserves the init/update/doctor first-run guidance from #2273.
  */
 export declare function printHelp(io?: DispatchIo): void;
+/**
+ * Unknown-colon-verb remediation (#3439 / #2652).
+ * Agent-facing spelling is `deft <verb>` (works on consumer CLI and source).
+ * Bare `task <verb>` is not consumer-runnable on include-only Taskfiles.
+ */
+export declare function unknownColonVerbHint(verb: string): string;
 /** Dispatch argv to a registered verb; returns the handler exit code. */
 export declare function dispatch(argv: string[], io?: DispatchIo): Promise<number>;
 /** Test seam: reset lazy handler cache between cases. */

package/dist/dispatch.js

@@ -10,7 +10,7 @@ import { basename, dirname, isAbsolute, join, relative, resolve } from "node:pat
 import { engineInfo, userConfig } from "@deftai/directive-core";
 import { assertWriteTargetSafe } from "@deftai/directive-core/dist/fs/projection-containment.js";
 import { parseInitArgv, runInitDepositCli } from "@deftai/directive-core/init-deposit";
-import { appendAuditLog, disclosureLine, migrateLegacyPolicyKey, PLAN_POLICY_KEY, policyColonInvocation, policySetInvocation, projectDefinitionPath, resolvePolicy, resolveWipCap, setPolicy, } from "@deftai/directive-core/policy";
+import { appendAuditLog, disclosureLine, migrateLegacyPolicyKey, PLAN_POLICY_KEY, POLICY_AUDIT_NOOP_STDOUT, policyColonInvocation, policySetInvocation, projectDefinitionPath, resolvePolicy, resolveWipCap, setPolicy, stampChangedToken, } from "@deftai/directive-core/policy";
 import { defaultWhich } from "@deftai/directive-core/scm";
 import { KNOWN_SUBAGENT_BACKEND_IDS, probeSubagentBackends, resolveSwarmSubagentBackend, } from "@deftai/directive-core/swarm";
 import { atomicWriteProjectDefinition } from "@deftai/directive-core/vbrief-build";
@@ -140,6 +140,7 @@ export const CLI_MODULE_VERBS = [
     "verify-tools",
     "verify-wip-cap",
     "verify-orphan-active",
+    "verify-lifecycle-visible",
     "verify-completed-tracked",
     "verify-literal-ac",
     "verify-ac",
@@ -220,6 +221,7 @@ export const POLICY_ACTION_ALIAS_SUBCOMMANDS = {
     "policy:allow-direct-commits": "allow-direct-commits",
     "policy:allow-bot-merge": "allow-bot-merge",
     "policy:enable-value-feedback": "enable-value-feedback",
+    "policy:disable-host-hooks": "disable-host-hooks",
     "policy:set-ceremony-dial": "set-ceremony-dial",
     "policy:clear-value-feedback": "clear-value-feedback",
     "policy:disable-directive": "disable-directive",
@@ -282,6 +284,7 @@ export const VERB_ALIASES = {
     "verify:vbrief-conformance": "vbrief-validate",
     "verify:wip-cap": "verify-wip-cap",
     "verify:orphan-active": "verify-orphan-active",
+    "verify:lifecycle-visible": "verify-lifecycle-visible",
     "verify:completed-tracked": "verify-completed-tracked",
     "verify:literal-ac": "verify-literal-ac",
     "verify:literal-acceptance": "verify-literal-ac",
@@ -2122,7 +2125,7 @@ function loadProjectDefinitionForWrite(projectRoot) {
         throw new PolicySetError("PROJECT-DEFINITION 'plan' is not an object", "config");
     }
     const planObj = plan;
-    migrateLegacyPolicyKey(planObj);
+    const legacyMigrated = migrateLegacyPolicyKey(planObj);
     let policy = planObj[PLAN_POLICY_KEY];
     if (policy === undefined) {
         policy = {};
@@ -2131,31 +2134,31 @@ function loadProjectDefinitionForWrite(projectRoot) {
     if (typeof policy !== "object" || policy === null || Array.isArray(policy)) {
         throw new PolicySetError("plan.policy is not an object", "config");
     }
-    return { path, data, policyBlock: policy };
+    return { path, data, policyBlock: policy, legacyMigrated };
 }
 /** Write plan.policy.wipCap in place + append the audit row (mirrors set_wip_cap). */
 function writeWipCap(projectRoot, cap, actor, note) {
-    const { path, data, policyBlock } = loadProjectDefinitionForWrite(projectRoot);
+    const { path, data, policyBlock, legacyMigrated } = loadProjectDefinitionForWrite(projectRoot);
     const previous = policyBlock.wipCap;
     policyBlock.wipCap = cap;
-    assertWriteTargetSafe(projectRoot, path);
-    atomicWriteProjectDefinition(path, data);
-    const changed = previous !== cap;
+    const changed = previous !== cap || legacyMigrated;
     const parts = [`actor=${actor}`, `wipCap=${cap}`, `previous=${pyRepr(previous)}`];
     if (note)
         parts.push(`note=${sanitizeNote(note)}`);
-    const auditEntry = parts.join(" ");
-    appendAuditLog(projectRoot, auditEntry);
+    const auditEntry = stampChangedToken(parts.join(" "), changed);
+    if (changed) {
+        assertWriteTargetSafe(projectRoot, path);
+        atomicWriteProjectDefinition(path, data);
+    }
+    appendAuditLog(projectRoot, auditEntry, changed);
     return { changed, auditEntry };
 }
 /** Write plan.policy.swarmSubagentBackend in place + append the audit row. */
 function writeSubagentBackend(projectRoot, backendId, actor, note) {
-    const { path, data, policyBlock } = loadProjectDefinitionForWrite(projectRoot);
+    const { path, data, policyBlock, legacyMigrated } = loadProjectDefinitionForWrite(projectRoot);
     const previous = policyBlock.swarmSubagentBackend;
     policyBlock.swarmSubagentBackend = backendId;
-    assertWriteTargetSafe(projectRoot, path);
-    atomicWriteProjectDefinition(path, data);
-    const changed = previous !== backendId;
+    const changed = previous !== backendId || legacyMigrated;
     const parts = [
         `actor=${actor}`,
         `swarmSubagentBackend=${backendId}`,
@@ -2163,8 +2166,12 @@ function writeSubagentBackend(projectRoot, backendId, actor, note) {
     ];
     if (note)
         parts.push(`note=${sanitizeNote(note)}`);
-    const auditEntry = parts.join(" ");
-    appendAuditLog(projectRoot, auditEntry);
+    const auditEntry = stampChangedToken(parts.join(" "), changed);
+    if (changed) {
+        assertWriteTargetSafe(projectRoot, path);
+        atomicWriteProjectDefinition(path, data);
+    }
+    appendAuditLog(projectRoot, auditEntry, changed);
     return { changed, auditEntry };
 }
 /** Serialise the probe output for `subagent-backends --format json`. */
@@ -2229,7 +2236,7 @@ function applyBranchPolicy(args, io) {
         io.writeOut(`  audit: meta/policy-changes.log :: ${result.auditEntry}\n`);
     }
     else {
-        io.writeOut("  no-op: value already matched (audit entry still appended for trail).\n");
+        io.writeOut(`${POLICY_AUDIT_NOOP_STDOUT}\n`);
     }
     io.writeOut(`${disclosureLine(resolvePolicy(args.projectRoot))}\n`);
     return 0;
@@ -2258,7 +2265,7 @@ function applyWipCap(args, io) {
         io.writeOut(`  audit: meta/policy-changes.log :: ${res.auditEntry}\n`);
     }
     else {
-        io.writeOut("  no-op: value already matched (audit entry still appended for trail).\n");
+        io.writeOut(`${POLICY_AUDIT_NOOP_STDOUT}\n`);
     }
     const result = resolveWipCap(args.projectRoot);
     io.writeOut(`[deft policy] plan.policy.wipCap=${result.cap} (source: ${result.source}).\n`);
@@ -2278,7 +2285,7 @@ function applySubagentBackend(args, io) {
         io.writeOut(`  audit: meta/policy-changes.log :: ${res.auditEntry}\n`);
     }
     else {
-        io.writeOut("  no-op: value already matched (audit entry still appended for trail).\n");
+        io.writeOut(`${POLICY_AUDIT_NOOP_STDOUT}\n`);
     }
     const result = resolveSwarmSubagentBackend(args.projectRoot);
     io.writeOut(`[deft policy] plan.policy.swarmSubagentBackend=${pyRepr(result.backend_id)} ` +
@@ -2720,6 +2727,23 @@ async function invokeHandler(handler, argv) {
     return typeof code === "number" ? code : 0;
 }
 const CLI_PACKAGE = "@deftai/directive";
+const PLAN_SEQUENCE_VERBS = "set|current|clear|advance";
+/**
+ * Unknown-colon-verb remediation (#3439 / #2652).
+ * Agent-facing spelling is `deft <verb>` (works on consumer CLI and source).
+ * Bare `task <verb>` is not consumer-runnable on include-only Taskfiles.
+ */
+export function unknownColonVerbHint(verb) {
+    if (verb.startsWith("plan-sequence:") && !(verb in PLAN_SEQUENCE_ALIAS_SUBCOMMANDS)) {
+        return (`hint: plan-sequence verbs are ${PLAN_SEQUENCE_VERBS} ` +
+            `(e.g. \`deft plan-sequence:current\`). '${verb}' is not a verb. ` +
+            `Do not run bare \`task ${verb}\` -- consumer include-only Taskfiles cannot resolve it.\n`);
+    }
+    const hyphen = verb.replaceAll(":", "-");
+    return (`hint: try \`deft ${verb}\` (CLI) or \`task deft:${verb}\` (consumer Taskfile). ` +
+        `Bare \`task ${verb}\` does not exist on include-only deposits. ` +
+        `Hyphen stem: ${hyphen}.\n`);
+}
 function versionBanner() {
     const info = engineInfo();
     return `${CLI_PACKAGE} (engine: ${info.name}@${info.version})\n`;
@@ -2743,8 +2767,7 @@ export async function dispatch(argv, io = defaultIo()) {
     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`);
+            io.writeErr(unknownColonVerbHint(verb));
         }
         return 1;
     }

package/dist/human-presence-mint.d.ts

@@ -27,6 +27,15 @@ export interface HumanPresenceMintSeams {
     readonly readInteractiveConfirm?: () => string | null;
 }
 export declare function looksLikeAgentShell(environ: NodeJS.ProcessEnv): boolean;
+/** Platform controlling-terminal path (`CONIN$` on win32, `/dev/tty` elsewhere). */
+export declare function controllingTerminalPath(platform?: NodeJS.Platform): string;
+/**
+ * Open flag for the platform controlling-terminal device (#3596).
+ *
+ * Windows `CONIN$` generally requires read/write (`r+`); `r` (O_RDONLY) fails
+ * in a real interactive console and made operator mint unreachable on win32.
+ */
+export declare function controllingTerminalOpenFlag(platform?: NodeJS.Platform): "r" | "r+";
 export declare function resolveHumanPresenceMintSeams(seams?: HumanPresenceMintSeams): Required<HumanPresenceMintSeams>;
 /** Active UAT campaign id, or null when no lease is active. */
 export declare function activeUatCampaignId(projectRoot: string): string | null;

package/dist/human-presence-mint.js

@@ -67,10 +67,22 @@ export function looksLikeAgentShell(environ) {
 function defaultIsTty() {
     return process.stdin.isTTY === true && process.stdout.isTTY === true;
 }
+/** Platform controlling-terminal path (`CONIN$` on win32, `/dev/tty` elsewhere). */
+export function controllingTerminalPath(platform = process.platform) {
+    return platform === "win32" ? "CONIN$" : "/dev/tty";
+}
+/**
+ * Open flag for the platform controlling-terminal device (#3596).
+ *
+ * Windows `CONIN$` generally requires read/write (`r+`); `r` (O_RDONLY) fails
+ * in a real interactive console and made operator mint unreachable on win32.
+ */
+export function controllingTerminalOpenFlag(platform = process.platform) {
+    return platform === "win32" ? "r+" : "r";
+}
 function defaultHasControllingTerminal() {
     try {
-        const path = process.platform === "win32" ? "CONIN$" : "/dev/tty";
-        const fd = openSync(path, "r");
+        const fd = openSync(controllingTerminalPath(), controllingTerminalOpenFlag());
         closeSync(fd);
         return true;
     }
@@ -83,8 +95,7 @@ function defaultReadInteractiveConfirm() {
     // so agent-controlled stdin alone cannot supply the confirm phrase (#3110).
     let fd = null;
     try {
-        const path = process.platform === "win32" ? "CONIN$" : "/dev/tty";
-        fd = openSync(path, "r");
+        fd = openSync(controllingTerminalPath(), controllingTerminalOpenFlag());
         const buf = Buffer.alloc(256);
         const n = readSync(fd, buf, 0, buf.length, null);
         if (n <= 0)

package/dist/plan-sequence.d.ts

@@ -1,3 +1,13 @@
 #!/usr/bin/env node
+interface Parsed {
+    projectRoot: string;
+    action: "set" | "current" | "clear" | "advance" | null;
+    file: string | null;
+    jsonInline: string | null;
+    emitJson: boolean;
+    error?: string;
+}
+export declare function parseArgs(argv: string[]): Parsed;
 export declare function main(argv?: string[]): number;
+export {};
 //# sourceMappingURL=plan-sequence.d.ts.map

package/dist/plan-sequence.js

@@ -6,7 +6,7 @@ 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) {
+export function parseArgs(argv) {
     const parsed = {
         projectRoot: ".",
         action: null,
@@ -19,6 +19,8 @@ function parseArgs(argv) {
         const arg = argv[i];
         if (arg === undefined)
             continue;
+        if (arg === "--")
+            continue;
         if (arg === "--json") {
             parsed.emitJson = true;
         }

package/dist/policy.d.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { type CeremonyDepth } from "@deftai/directive-core/policy";
+import { type CeremonyDepth, type HookHost } from "@deftai/directive-core/policy";
 interface ShowArgs {
     format: "text" | "json";
     changedOnly: boolean;
@@ -8,10 +8,11 @@ interface ShowArgs {
     error?: string;
 }
 interface SetArgs {
-    cmd: "show" | "enforce-branches" | "allow-direct-commits" | "allow-bot-merge" | "enable-value-feedback" | "clear-value-feedback" | "set-ceremony-dial" | "disable-directive" | "enable-directive" | "resolve";
+    cmd: "show" | "enforce-branches" | "allow-direct-commits" | "allow-bot-merge" | "enable-value-feedback" | "clear-value-feedback" | "set-ceremony-dial" | "disable-host-hooks" | "disable-directive" | "enable-directive" | "resolve";
     confirm: boolean;
     actor: string;
     note: string;
+    host?: HookHost;
     projectRoot: string;
     format: "text" | "json";
     changedOnly: boolean;

package/dist/policy.js

@@ -6,7 +6,7 @@
 import { existsSync } from "node:fs";
 import { resolve as pathResolve, relative } from "node:path";
 import { fileURLToPath } from "node:url";
-import { ALLOW_BOT_MERGE_CAPABILITY_COST, CEREMONY_DEPTHS, clearValueFeedback, createNoDeftDirectiveFlag, describeShadowedPlanExtension, detectNoDeftDirective, detectShadowedPlanExtensions, disclosureLine, enableValueFeedback, FIELD_VALUE_FEEDBACK, FIELD_VALUE_FEEDBACK_CLI_ALIAS, formatValueFeedbackStatusLine, humanMergeDisclosureLine, inspectAllPolicies, inspectOnePolicy, loadProjectDefinition, NO_DEFT_DIRECTIVE_DISABLED_MESSAGE, NO_DEFT_DIRECTIVE_FLAG_NAME, NO_DEFT_DIRECTIVE_INCONSISTENT_MESSAGE, policyColonInvocation, projectDefinitionPath, pythonListRepr, pythonStringRepr, registeredPolicyNames, removeNoDeftDirectiveFlag, renderJson, renderText, resolveHumanMergePolicy, resolvePolicy, resolveValueFeedback, setCeremonyDial, setPolicy, setRequireHumanMerge, } from "@deftai/directive-core/policy";
+import { ALLOW_BOT_MERGE_CAPABILITY_COST, CEREMONY_DEPTHS, clearValueFeedback, createNoDeftDirectiveFlag, describeShadowedPlanExtension, detectNoDeftDirective, detectShadowedPlanExtensions, disableHostHooks, disclosureLine, enableValueFeedback, FIELD_VALUE_FEEDBACK, FIELD_VALUE_FEEDBACK_CLI_ALIAS, formatValueFeedbackStatusLine, humanMergeDisclosureLine, inspectAllPolicies, inspectOnePolicy, loadProjectDefinition, NO_DEFT_DIRECTIVE_DISABLED_MESSAGE, NO_DEFT_DIRECTIVE_FLAG_NAME, NO_DEFT_DIRECTIVE_INCONSISTENT_MESSAGE, POLICY_AUDIT_NOOP_STDOUT, parseHookHost, policyColonInvocation, projectDefinitionPath, pythonListRepr, pythonStringRepr, registeredPolicyNames, removeNoDeftDirectiveFlag, renderJson, renderText, resolveHumanMergePolicy, resolvePolicy, resolveValueFeedback, setCeremonyDial, setPolicy, setRequireHumanMerge, } from "@deftai/directive-core/policy";
 const CAPABILITY_COST_DISCLOSURE = "\u26a0 Capability-cost disclosure -- enabling direct commits to the default " +
     "branch turns OFF the deft branch-protection policy.\n" +
     "  \u2022 Pre-commit + pre-push hooks will no longer block default-branch " +
@@ -114,7 +114,7 @@ export function parseShowArgs(argv) {
 /** Parse argv for the policy CLI (show + set subcommands). */
 export function parseArgs(argv) {
     if (argv.length === 0) {
-        const usage = "usage: policy [show|enforce-branches|allow-direct-commits|allow-bot-merge|enable-value-feedback|clear-value-feedback|set-ceremony-dial|disable-directive|enable-directive|resolve] ...";
+        const usage = "usage: policy [show|enforce-branches|allow-direct-commits|allow-bot-merge|enable-value-feedback|clear-value-feedback|set-ceremony-dial|disable-host-hooks|disable-directive|enable-directive|resolve] ...";
         return makeSetError(usage);
     }
     const cmd = argv[0];
@@ -152,6 +152,7 @@ export function parseArgs(argv) {
         cmd === "enable-value-feedback" ||
         cmd === "clear-value-feedback" ||
         cmd === "set-ceremony-dial" ||
+        cmd === "disable-host-hooks" ||
         cmd === "disable-directive" ||
         cmd === "enable-directive") {
         let confirm = false;
@@ -167,11 +168,14 @@ export function parseArgs(argv) {
                             ? policyColonInvocation("clear-value-feedback")
                             : cmd === "set-ceremony-dial"
                                 ? policyColonInvocation("set-ceremony-dial")
-                                : cmd === "disable-directive"
-                                    ? policyColonInvocation("disable-directive")
-                                    : policyColonInvocation("enable-directive");
+                                : cmd === "disable-host-hooks"
+                                    ? policyColonInvocation("disable-host-hooks")
+                                    : cmd === "disable-directive"
+                                        ? policyColonInvocation("disable-directive")
+                                        : policyColonInvocation("enable-directive");
         let note = "";
         let projectRoot = ".";
+        let host;
         let ceremonyOverride;
         let ceremonyEnabled;
         for (let i = 1; i < argv.length; i += 1) {
@@ -253,10 +257,32 @@ export function parseArgs(argv) {
                 }
                 ceremonyEnabled = v === "true";
             }
+            else if (cmd === "disable-host-hooks" && arg === "--host") {
+                const v = argv[i + 1];
+                const parsedHost = parseHookHost(v);
+                if (parsedHost === null) {
+                    return makeSetError("argument --host: expected claude|cursor|grok|codex");
+                }
+                host = parsedHost;
+                i += 1;
+            }
+            else if (cmd === "disable-host-hooks" && arg?.startsWith("--host=")) {
+                const parsedHost = parseHookHost(arg.slice("--host=".length));
+                if (parsedHost === null) {
+                    return makeSetError("argument --host: expected claude|cursor|grok|codex");
+                }
+                host = parsedHost;
+            }
+            else if (arg === "--") {
+                continue;
+            }
             else {
                 return makeSetError(`unrecognized argument: ${arg}`);
             }
         }
+        if (cmd === "disable-host-hooks" && host === undefined) {
+            return makeSetError("disable-host-hooks requires --host claude|cursor|grok|codex");
+        }
         return {
             cmd,
             confirm,
@@ -266,6 +292,7 @@ export function parseArgs(argv) {
             format: "text",
             changedOnly: false,
             field: null,
+            host,
             ceremonyOverride,
             ceremonyEnabled,
         };
@@ -352,6 +379,21 @@ function runEnableValueFeedback(args) {
     process.stdout.write(result.stdout);
     return result.exitCode;
 }
+function runDisableHostHooks(args) {
+    const host = args.host;
+    if (host === undefined) {
+        process.stderr.write("policy: disable-host-hooks requires --host claude|cursor|grok|codex\n");
+        return 2;
+    }
+    const result = disableHostHooks(pathResolve(args.projectRoot), {
+        host,
+        confirm: args.confirm,
+        actor: args.actor,
+        note: args.note,
+    });
+    process.stdout.write(result.stdout);
+    return result.exitCode;
+}
 function runSet(args) {
     const projectRoot = pathResolve(args.projectRoot);
     if (args.cmd === "allow-direct-commits" && !args.confirm) {
@@ -373,7 +415,7 @@ function runSet(args) {
             process.stdout.write(`  audit: meta/policy-changes.log :: ${auditEntry}\n`);
         }
         else {
-            process.stdout.write("  no-op: value already matched (audit entry still appended for trail).\n");
+            process.stdout.write(`${POLICY_AUDIT_NOOP_STDOUT}\n`);
         }
         process.stdout.write(`${disclosureLine(resolvePolicy(projectRoot))}\n`);
         return 0;
@@ -454,7 +496,7 @@ function runAllowBotMerge(args) {
             process.stdout.write(`  audit: meta/policy-changes.log :: ${auditEntry}\n`);
         }
         else {
-            process.stdout.write("  no-op: value already matched (audit entry still appended for trail).\n");
+            process.stdout.write(`${POLICY_AUDIT_NOOP_STDOUT}\n`);
         }
         const line = humanMergeDisclosureLine(resolveHumanMergePolicy(projectRoot));
         if (line !== null) {
@@ -504,6 +546,9 @@ export function run(argv) {
     if (args.cmd === "enable-value-feedback") {
         return runEnableValueFeedback(args);
     }
+    if (args.cmd === "disable-host-hooks") {
+        return runDisableHostHooks(args);
+    }
     if (args.cmd === "clear-value-feedback") {
         return runClearValueFeedback(args);
     }

package/dist/preflight-cache.d.ts

@@ -7,6 +7,8 @@ interface ParsedArgs {
     forIssue?: number;
     allowStale?: boolean;
     allowMissingBootstrap?: boolean;
+    skipDriftProbe?: boolean;
+    workSelection?: boolean;
     quiet?: boolean;
     error?: string;
 }

package/dist/preflight-cache.js

@@ -58,6 +58,12 @@ export function parseArgs(argv) {
         else if (arg === "--allow-missing-bootstrap") {
             parsed.allowMissingBootstrap = true;
         }
+        else if (arg === "--skip-drift-probe") {
+            parsed.skipDriftProbe = true;
+        }
+        else if (arg === "--work-selection") {
+            parsed.workSelection = true;
+        }
         else if (arg === "--quiet") {
             parsed.quiet = true;
         }
@@ -81,6 +87,7 @@ export function run(argv) {
         forIssue: args.forIssue ?? null,
         allowStale: args.allowStale ?? false,
         allowMissingBootstrap: args.allowMissingBootstrap ?? false,
+        skipDriftProbe: (args.skipDriftProbe ?? false) && !args.workSelection,
     });
     const quiet = args.quiet ?? false;
     if (result.code === 0) {

package/dist/triage-actions.js

@@ -21,6 +21,8 @@ export function parseArgs(argv) {
     parsed.cmd = argv[0];
     for (let i = 1; i < argv.length; i += 1) {
         const arg = argv[i];
+        if (arg === "--")
+            continue;
         if (arg === "--issue") {
             const value = argv[i + 1];
             if (value === undefined)

package/dist/triage-queue.js

@@ -88,7 +88,7 @@ export function parseArgs(argv) {
     };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
-        if (arg === "queue") {
+        if (arg === "queue" || arg === "--") {
             continue;
         }
         if (arg === "--include-blocked") {
@@ -197,6 +197,9 @@ export function parseShowArgs(argv) {
     }
     for (let i = start; i < argv.length; i += 1) {
         const arg = argv[i];
+        if (arg === "--") {
+            continue;
+        }
         const commonHit = parseCommonFlag(arg, argv, i, parsed);
         if (commonHit !== null) {
             if (commonHit.error !== undefined) {

package/dist/verify-forward-coverage.d.ts

@@ -5,6 +5,10 @@ interface ParsedArgs {
     projectRoot: string;
     allowList: string | null;
     quiet: boolean;
+    enforce: boolean;
+    coverageReport: string | null;
+    coverageDir: string | null;
+    help?: boolean;
     error?: string;
 }
 /** Parse the verify-forward-coverage CLI args, mirroring the verify-encoding surface. */

package/dist/verify-forward-coverage.js

@@ -2,6 +2,20 @@
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { evaluateForwardCoverage } from "@deftai/directive-core";
+const HELP_TEXT = "Usage: verify-forward-coverage [--project-root <path>] [--staged|--head] [--allow-list <path>]\n" +
+    "                               [--coverage-dir <path>] [--coverage-report <path>]\n" +
+    "                               [--enforce] [--quiet]\n" +
+    "  Fail-closed new-source-file existence (#1310) plus warn-first diff coverage of\n" +
+    "  added/modified branches (#3514). The 90% per-diff threshold is not the 75\n" +
+    "  global floor. Missing coverage reports skip the diff half.\n" +
+    "  --enforce: fail closed when uncovered changed branches are below 90%.\n";
+function takeValue(argv, i, flag) {
+    const value = argv[i + 1];
+    if (value === undefined) {
+        return { error: `argument ${flag}: expected one argument` };
+    }
+    return { value, next: i + 1 };
+}
 /** Parse the verify-forward-coverage CLI args, mirroring the verify-encoding surface. */
 export function parseArgs(argv) {
     const parsed = {
@@ -9,6 +23,9 @@ export function parseArgs(argv) {
         projectRoot: ".",
         allowList: null,
         quiet: false,
+        enforce: false,
+        coverageReport: null,
+        coverageDir: null,
     };
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
@@ -21,48 +38,97 @@ export function parseArgs(argv) {
         else if (arg === "--quiet") {
             parsed.quiet = true;
         }
+        else if (arg === "--enforce") {
+            parsed.enforce = true;
+        }
+        else if (arg === "--help" || arg === "-h") {
+            return { ...parsed, help: true };
+        }
         else if (arg === "--project-root") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --project-root: expected one argument" };
+            const taken = takeValue(argv, i, "--project-root");
+            if ("error" in taken) {
+                return { ...parsed, error: taken.error };
             }
-            parsed.projectRoot = value;
-            i += 1;
+            parsed.projectRoot = taken.value;
+            i = taken.next;
         }
         else if (arg?.startsWith("--project-root=")) {
             parsed.projectRoot = arg.slice("--project-root=".length);
         }
         else if (arg === "--allow-list") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --allow-list: expected one argument" };
+            const taken = takeValue(argv, i, "--allow-list");
+            if ("error" in taken) {
+                return { ...parsed, error: taken.error };
             }
-            parsed.allowList = value;
-            i += 1;
+            parsed.allowList = taken.value;
+            i = taken.next;
         }
         else if (arg?.startsWith("--allow-list=")) {
             parsed.allowList = arg.slice("--allow-list=".length);
         }
+        else if (arg === "--coverage-report") {
+            const taken = takeValue(argv, i, "--coverage-report");
+            if ("error" in taken) {
+                return { ...parsed, error: taken.error };
+            }
+            parsed.coverageReport = taken.value;
+            i = taken.next;
+        }
+        else if (arg?.startsWith("--coverage-report=")) {
+            parsed.coverageReport = arg.slice("--coverage-report=".length);
+        }
+        else if (arg === "--coverage-dir") {
+            const taken = takeValue(argv, i, "--coverage-dir");
+            if ("error" in taken) {
+                return { ...parsed, error: taken.error };
+            }
+            parsed.coverageDir = taken.value;
+            i = taken.next;
+        }
+        else if (arg?.startsWith("--coverage-dir=")) {
+            parsed.coverageDir = arg.slice("--coverage-dir=".length);
+        }
         else {
             return { ...parsed, error: `unrecognized argument: ${arg}` };
         }
     }
     return parsed;
 }
+function resolveCoverageReport(args) {
+    if (args.coverageReport !== null) {
+        return resolve(args.coverageReport);
+    }
+    if (args.coverageDir !== null) {
+        return resolve(args.coverageDir, "coverage-final.json");
+    }
+    return undefined;
+}
 /** Run the gate and return the process exit code (argv parse error -> 2). */
 export function run(argv) {
     const args = parseArgs(argv);
+    if (args.help === true) {
+        process.stdout.write(HELP_TEXT);
+        return 0;
+    }
     if (args.error !== undefined) {
         process.stderr.write(`verify_forward_coverage: ${args.error}\n`);
         return 2;
     }
     const projectRoot = resolve(args.projectRoot);
     const allowListPath = args.allowList !== null ? resolve(args.allowList) : null;
-    const result = evaluateForwardCoverage(projectRoot, { mode: args.mode, allowListPath });
+    const result = evaluateForwardCoverage(projectRoot, {
+        mode: args.mode,
+        allowListPath,
+        enforceDiffCoverage: args.enforce,
+        coverageReportPath: resolveCoverageReport(args),
+    });
     if (result.exitCode === 0) {
         if (!args.quiet) {
             process.stdout.write(`${result.message}\n`);
         }
+        else if (result.message.includes("ADVISORY")) {
+            process.stdout.write(`${result.message}\n`);
+        }
     }
     else {
         process.stderr.write(`${result.message}\n`);

package/dist/verify-lifecycle-visible.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+interface ParsedArgs {
+    projectRoot: string;
+    enforce: boolean;
+    help?: boolean;
+    error?: string;
+}
+/** Parse verify-lifecycle-visible CLI args (#3505). */
+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-lifecycle-visible.d.ts.map

package/dist/verify-lifecycle-visible.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+/**
+ * CLI for task verify:lifecycle-visible (#3505).
+ * Warn-only by default; pass --enforce to fail closed.
+ */
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { evaluateLifecycleVisible } from "@deftai/directive-core/lifecycle-visible";
+/** Parse verify-lifecycle-visible CLI args (#3505). */
+export function parseArgs(argv) {
+    const parsed = { projectRoot: ".", enforce: false };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        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 === "--enforce") {
+            parsed.enforce = true;
+        }
+        else if (arg === "--help" || arg === "-h") {
+            return { ...parsed, help: true };
+        }
+        else {
+            return { ...parsed, error: `unrecognized argument: ${arg}` };
+        }
+    }
+    return parsed;
+}
+const HELP_TEXT = "Usage: verify-lifecycle-visible [--project-root <path>] [--enforce]\n" +
+    "  Detect ignore/exclude/skip-worktree flags that hide xbrief/vbrief lifecycle roots (#3505).\n" +
+    "  Default: warn-only (exit 0 with advisory report).\n" +
+    "  --enforce: fail closed (exit 1) when a lifecycle root is hidden.\n" +
+    "  Not part of task check — per-clone property, wired from session:start.\n";
+/** Run the gate and return the process exit code. */
+export function run(argv) {
+    const args = parseArgs(argv);
+    if (args.help === true) {
+        process.stdout.write(HELP_TEXT);
+        return 0;
+    }
+    if (args.error !== undefined) {
+        process.stderr.write(`verify_lifecycle_visible: ${args.error}\n`);
+        return 2;
+    }
+    const result = evaluateLifecycleVisible({
+        projectRoot: resolve(args.projectRoot),
+        enforce: args.enforce,
+    });
+    if (result.stream === "stdout") {
+        process.stdout.write(`${result.message}\n`);
+    }
+    else {
+        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-lifecycle-visible.js.map

package/package.json

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