@deftai/directive 0.113.2 → 0.115.0

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", "occupancy-release", "occupancy-heartbeat", "occupancy-grant", "plan-sequence", "slice", "subagent-monitor", "toolchain-check", "triage-actions", "triage-bootstrap", "triage-bulk", "triage-classify", "triage-strip-withdrawn", "triage-evaluate", "triage-help", "triage-queue", "triage-reconcile", "triage-refresh", "triage-scope", "triage-scope-drift", "triage-smoketest", "triage-subscribe", "triage-summary", "triage-welcome", "ts-check-lane", "vbrief-activate", "vbrief-build", "vbrief-preflight", "vbrief-reconcile", "vbrief-validate", "vbrief-validation", "xbrief-create", "xbrief-verify", "verify-branch", "verify-encoding", "verify-forward-coverage", "verify-test-boundary", "verify-scope-provenance", "verify-consumer-check-contract", "verify-hooks-installed", "verify-investigation", "verify-judgment-gates", "verify-no-task-runtime", "validate-links", "validate-strategy-output", "verify-biome-config", "verify-bridge-drift", "verify-capacity", "verify-contained-writes", "verify-telemetry-coverage", "verify-content-manifest", "verify-deposit-closure", "verify-consumer-hard-stops", "verify-closing-keywords", "verify-skill-external-fetch-gate", "verify-semantic-single-source", "verify-contract-drift", "verify-cursor-tier1", "verify-openclaw-tier1", "verify-go-freeze", "verify-scm-boundary", "verify-session-ritual", "verify-plan-sequence", "verify-stubs", "verify-xbrief-drift", "verify-spec-prd-fresh", "rule-ownership-lint", "verify-story-ready", "verify-review-monitor", "verify-l4-owner", "verify-subagent-alive", "review-monitor-register", "review-monitor-release", "verify-tools", "verify-wip-cap", "verify-orphan-active", "verify-pr-closeout-attestable", "verify-lifecycle-visible", "verify-completed-tracked", "verify-completed-write-guard", "verify-literal-ac", "verify-ac", "verify-agents-md-budget", "verify-agents-md-advisory", "verify-eval-health-relocation", "verify-eval-triggers-relocation", "eval-health", "eval-run", "eval-report", "eval-triggers"];
+export declare const CLI_MODULE_VERBS: readonly ["agents-refresh", "cache", "check", "capacity-backfill", "capacity-show", "codebase-default-extractor", "codebase-map", "codebase-map-fresh", "codebase-projection-registry", "codebase-provider", "doctor", "install-upgrade", "install-uninstall", "migrate-preflight", "migrate-xbrief", "migrate-category-b", "framework-check-updates", "hook-dispatch", "umbrella-current-shape", "changelog-check", "change-init", "commit-lint", "coverage-hotspots", "policy", "authz", "escalation-cli", "pr-closing-keywords", "pr-merge-readiness", "pr-monitor", "pr-protected-issues", "pr-wait-mergeable", "pr-watch", "pr-finish-loop", "directive-finish-loop", "preflight-cache", "preflight-gh", "probe-session", "release", "release-e2e", "release-publish", "release-rollback", "scope-lifecycle", "scope-record-approved-scope", "scm-sync-default", "lifecycle-event", "lifecycle-stats", "session-start", "session-ready", "occupancy-steal", "occupancy-release", "occupancy-heartbeat", "occupancy-grant", "plan-sequence", "slice", "subagent-monitor", "toolchain-check", "triage-actions", "triage-bootstrap", "triage-bulk", "triage-classify", "triage-strip-withdrawn", "triage-evaluate", "triage-help", "triage-queue", "triage-reconcile", "triage-refresh", "triage-scope", "triage-scope-drift", "triage-smoketest", "triage-subscribe", "triage-summary", "triage-welcome", "ts-check-lane", "vbrief-activate", "vbrief-build", "vbrief-preflight", "vbrief-reconcile", "vbrief-validate", "vbrief-validation", "xbrief-create", "xbrief-verify", "verify-branch", "verify-encoding", "verify-forward-coverage", "verify-test-boundary", "verify-scope-provenance", "verify-consumer-check-contract", "verify-hooks-installed", "verify-investigation", "verify-judgment-gates", "verify-no-task-runtime", "validate-links", "validate-strategy-output", "verify-biome-config", "verify-bridge-drift", "verify-capacity", "verify-contained-writes", "verify-telemetry-coverage", "verify-content-manifest", "verify-deposit-closure", "verify-consumer-hard-stops", "verify-closing-keywords", "verify-skill-external-fetch-gate", "verify-semantic-single-source", "verify-contract-drift", "verify-cursor-tier1", "verify-openclaw-tier1", "verify-go-freeze", "verify-scm-boundary", "verify-session-ritual", "verify-plan-sequence", "verify-stubs", "verify-xbrief-drift", "verify-spec-prd-fresh", "rule-ownership-lint", "verify-story-ready", "verify-review-monitor", "verify-l4-owner", "verify-subagent-alive", "verify-subagent-steer", "review-monitor-register", "review-monitor-release", "verify-tools", "verify-wip-cap", "verify-orphan-active", "verify-pr-closeout-attestable", "verify-lifecycle-visible", "verify-completed-tracked", "verify-completed-write-guard", "verify-literal-ac", "verify-ac", "verify-agents-md-budget", "verify-agents-md-advisory", "verify-eval-health-relocation", "verify-eval-triggers-relocation", "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). */

package/dist/dispatch.js

@@ -145,6 +145,7 @@ export const CLI_MODULE_VERBS = [
     "verify-review-monitor",
     "verify-l4-owner",
     "verify-subagent-alive",
+    "verify-subagent-steer",
     "review-monitor-register",
     "review-monitor-release",
     "verify-tools",
@@ -325,6 +326,7 @@ export const VERB_ALIASES = {
     "verify:review-monitor": "verify-review-monitor",
     "verify:l4-owner": "verify-l4-owner",
     "verify:subagent-alive": "verify-subagent-alive",
+    "verify:subagent-steer": "verify-subagent-steer",
     "agent:monitor": "subagent-monitor",
     "review-monitor:register": "review-monitor-register",
     "review-monitor:release": "review-monitor-release",

package/dist/verify-subagent-steer.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+export declare const SUBAGENT_STEER_HELP = "verify:subagent-steer \u2014 parent-visible unread steer flag (#4286)\n\nUsage:\n  task verify:subagent-steer -- [options]\n\nOptions:\n  --steer-dir PATH    Inbox directory (default: .deft-scratch/subagent-steer)\n  --agent ID          Agent whose inbox to inspect (repeatable; default: all)\n  --json              Machine-readable output\n\nExit codes:\n  0  No unread unexpired steer\n  1  STEER_PENDING \u2014 unread inbox; not REDISPATCH_OK / takeover\n  2  Config error (invalid args, steer path is not a directory)\n";
+export interface VerifySubagentSteerArgs {
+    steerDir: string | null;
+    agentIds: string[];
+    emitJson: boolean;
+    help: boolean;
+    error?: string;
+}
+export declare function parseVerifySubagentSteerArgs(argv: readonly string[]): VerifySubagentSteerArgs;
+export interface SubagentSteerVerdict {
+    exitCode: number;
+    redispatchOk: false;
+    message: string;
+    json?: Record<string, unknown>;
+}
+export declare function evaluateSubagentSteerGate(args: VerifySubagentSteerArgs, cwd?: string): SubagentSteerVerdict;
+export declare function run(argv: readonly string[]): number;
+//# sourceMappingURL=verify-subagent-steer.d.ts.map

package/dist/verify-subagent-steer.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+/**
+ * Parent-visible unread steer flag (#4286). Exit 1 is STEER_PENDING.
+ * Never prints REDISPATCH_OK — unread steer is not missing heartbeat.
+ */
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { defaultSteerDir, EXIT_STEER_CONFIG, EXIT_STEER_OK, EXIT_STEER_PENDING, renderSteerPendingText, steerPendingConfigError, sweepSteerPending, } from "@deftai/directive-core/orchestration";
+export const SUBAGENT_STEER_HELP = `verify:subagent-steer — parent-visible unread steer flag (#4286)
+
+Usage:
+  task verify:subagent-steer -- [options]
+
+Options:
+  --steer-dir PATH    Inbox directory (default: .deft-scratch/subagent-steer)
+  --agent ID          Agent whose inbox to inspect (repeatable; default: all)
+  --json              Machine-readable output
+
+Exit codes:
+  0  No unread unexpired steer
+  1  STEER_PENDING — unread inbox; not REDISPATCH_OK / takeover
+  2  Config error (invalid args, steer path is not a directory)
+`;
+export function parseVerifySubagentSteerArgs(argv) {
+    const acc = {
+        steerDir: null,
+        agentIds: [],
+        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 === "--steer-dir") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...acc, error: "argument --steer-dir: expected one argument" };
+            }
+            acc.steerDir = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--steer-dir=")) {
+            acc.steerDir = arg.slice("--steer-dir=".length);
+        }
+        else if (arg === "--agent") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...acc, error: "argument --agent: expected one argument" };
+            }
+            acc.agentIds.push(value);
+            i += 1;
+        }
+        else if (arg?.startsWith("--agent=")) {
+            acc.agentIds.push(arg.slice("--agent=".length));
+        }
+        else if (arg?.startsWith("-")) {
+            return { ...acc, error: `unrecognized argument: ${arg}` };
+        }
+        else {
+            return { ...acc, error: `unrecognized argument: ${arg}` };
+        }
+    }
+    return acc;
+}
+export function evaluateSubagentSteerGate(args, cwd = process.cwd()) {
+    if (args.error !== undefined) {
+        return {
+            exitCode: EXIT_STEER_CONFIG,
+            redispatchOk: false,
+            message: `verify_subagent_steer: ${args.error}`,
+        };
+    }
+    const steerDir = resolve(cwd, args.steerDir ?? defaultSteerDir(cwd));
+    const sweep = sweepSteerPending(steerDir, {
+        agentIds: args.agentIds.length > 0 ? args.agentIds : undefined,
+    });
+    const configError = steerPendingConfigError(sweep);
+    const pending = sweep.pending.length > 0 || sweep.parse_failures.length > 0;
+    if (args.emitJson) {
+        return {
+            exitCode: configError ? EXIT_STEER_CONFIG : pending ? EXIT_STEER_PENDING : EXIT_STEER_OK,
+            redispatchOk: false,
+            message: "",
+            json: {
+                all_ok: !pending && !configError,
+                steer_pending: pending,
+                redispatch_ok: false,
+                pending_agents: sweep.pending.map((p) => p.agent_id),
+                pending: sweep.pending,
+                parse_failures: sweep.parse_failures,
+                sweep_errors: sweep.sweep_errors,
+            },
+        };
+    }
+    if (configError) {
+        return {
+            exitCode: EXIT_STEER_CONFIG,
+            redispatchOk: false,
+            message: renderSteerPendingText(sweep),
+        };
+    }
+    return {
+        exitCode: pending ? EXIT_STEER_PENDING : EXIT_STEER_OK,
+        redispatchOk: false,
+        message: renderSteerPendingText(sweep),
+    };
+}
+export function run(argv) {
+    const args = parseVerifySubagentSteerArgs(argv);
+    if (args.help) {
+        process.stdout.write(SUBAGENT_STEER_HELP);
+        return EXIT_STEER_OK;
+    }
+    const verdict = evaluateSubagentSteerGate(args);
+    if (args.emitJson && verdict.json !== undefined) {
+        process.stdout.write(`${JSON.stringify(verdict.json, null, 2)}\n`);
+    }
+    else if (verdict.message.length > 0) {
+        if (verdict.exitCode === EXIT_STEER_OK) {
+            process.stdout.write(`${verdict.message}\n`);
+        }
+        else {
+            process.stderr.write(`${verdict.message}\n`);
+        }
+    }
+    return verdict.exitCode;
+}
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+    process.exit(run(process.argv.slice(2)));
+}
+//# sourceMappingURL=verify-subagent-steer.js.map

package/package.json

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