@deftai/directive 0.99.0 → 0.100.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", "lifecycle-event", "lifecycle-stats", "session-start", "session-ready", "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-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-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", "lifecycle-event", "lifecycle-stats", "session-start", "session-ready", "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-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-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

@@ -137,6 +137,8 @@ export const CLI_MODULE_VERBS = [
     "verify-tools",
     "verify-wip-cap",
     "verify-orphan-active",
+    "verify-completed-tracked",
+    "verify-literal-ac",
     "verify-agents-md-budget",
     "verify-agents-md-advisory",
     "verify-eval-health-relocation",
@@ -279,6 +281,9 @@ export const VERB_ALIASES = {
     "verify:vbrief-conformance": "vbrief-validate",
     "verify:wip-cap": "verify-wip-cap",
     "verify:orphan-active": "verify-orphan-active",
+    "verify:completed-tracked": "verify-completed-tracked",
+    "verify:literal-ac": "verify-literal-ac",
+    "verify:literal-acceptance": "verify-literal-ac",
     "verify:agents-md-budget": "verify-agents-md-budget",
     "verify:agents-md-advisory": "verify-agents-md-advisory",
     "verify:eval-health-relocation": "verify-eval-health-relocation",

package/dist/session-start.d.ts

@@ -18,6 +18,15 @@ export interface ParsedSessionStartArgs {
      * Applied as resolve inputs via a one-shot config override in run().
      */
     ceremonyDepthOverride: CeremonyDepth | null;
+    /**
+     * #3266: host/CLI effort-budget cap fields for bank-the-pass guidance.
+     * Merged with DEFT_HOST_EFFORT_BUDGET JSON when present.
+     */
+    effortBudgetHost: {
+        maxTurns?: number;
+        maxBudget?: number;
+        hardBudget?: boolean;
+    };
     error?: string;
 }
 /** Parse session:start CLI args, mirroring scripts/session_start.py. */

package/dist/session-start.js

@@ -2,7 +2,7 @@
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { CEREMONY_DEPTHS, normalizeCeremonyModelTier, normalizeCeremonyProjectShape, normalizeCeremonyTaskSize, selectCeremonyDepth, } from "@deftai/directive-core/policy";
-import { COLD_CEREMONY_TIER, parseDeferrals, READ_ONLY_POSTURE, REARM_CEREMONY_TIER, ritualStatePath, runSessionStart, SESSION_CEREMONY_TIERS, } from "@deftai/directive-core/session";
+import { COLD_CEREMONY_TIER, parseDeferrals, READ_ONLY_POSTURE, REARM_CEREMONY_TIER, resolveProductionHostEffortDescriptor, ritualStatePath, runSessionStart, SESSION_CEREMONY_TIERS, } from "@deftai/directive-core/session";
 function parseCeremonyDepth(raw) {
     const value = raw.trim().toLowerCase();
     if (CEREMONY_DEPTHS.includes(value)) {
@@ -29,6 +29,7 @@ export function parseArgs(argv) {
         ceremonyTier: COLD_CEREMONY_TIER,
         ceremonyDialInputs: {},
         ceremonyDepthOverride: null,
+        effortBudgetHost: {},
     };
     const dialInputs = {};
     for (let i = 0; i < argv.length; i += 1) {
@@ -211,6 +212,62 @@ export function parseArgs(argv) {
             }
             parsed.ceremonyDepthOverride = depth;
         }
+        else if (arg === "--max-turns") {
+            // #3266: harness hard turn budget for bank-the-pass guidance
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --max-turns: expected one argument" };
+            }
+            const n = Number(value);
+            if (!Number.isFinite(n) || n < 0) {
+                return {
+                    ...parsed,
+                    error: `argument --max-turns: expected non-negative number, got ${JSON.stringify(value)}`,
+                };
+            }
+            parsed.effortBudgetHost.maxTurns = n;
+            i += 1;
+        }
+        else if (arg?.startsWith("--max-turns=")) {
+            const value = arg.slice("--max-turns=".length);
+            const n = Number(value);
+            if (!Number.isFinite(n) || n < 0) {
+                return {
+                    ...parsed,
+                    error: `argument --max-turns: expected non-negative number, got ${JSON.stringify(value)}`,
+                };
+            }
+            parsed.effortBudgetHost.maxTurns = n;
+        }
+        else if (arg === "--max-budget") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --max-budget: expected one argument" };
+            }
+            const n = Number(value);
+            if (!Number.isFinite(n) || n < 0) {
+                return {
+                    ...parsed,
+                    error: `argument --max-budget: expected non-negative number, got ${JSON.stringify(value)}`,
+                };
+            }
+            parsed.effortBudgetHost.maxBudget = n;
+            i += 1;
+        }
+        else if (arg?.startsWith("--max-budget=")) {
+            const value = arg.slice("--max-budget=".length);
+            const n = Number(value);
+            if (!Number.isFinite(n) || n < 0) {
+                return {
+                    ...parsed,
+                    error: `argument --max-budget: expected non-negative number, got ${JSON.stringify(value)}`,
+                };
+            }
+            parsed.effortBudgetHost.maxBudget = n;
+        }
+        else if (arg === "--hard-budget") {
+            parsed.effortBudgetHost.hardBudget = true;
+        }
         else {
             return { ...parsed, error: `unrecognized argument: ${arg}` };
         }
@@ -247,6 +304,19 @@ export function run(argv) {
         }
         return true;
     });
+    // #3266: production host adapter — native harness env + DEFT_HOST_EFFORT_BUDGET + CLI flags.
+    const hostDescriptor = {
+        ...resolveProductionHostEffortDescriptor(process.env),
+    };
+    if (args.effortBudgetHost.maxTurns !== undefined) {
+        hostDescriptor.maxTurns = args.effortBudgetHost.maxTurns;
+    }
+    if (args.effortBudgetHost.maxBudget !== undefined) {
+        hostDescriptor.maxBudget = args.effortBudgetHost.maxBudget;
+    }
+    if (args.effortBudgetHost.hardBudget === true) {
+        hostDescriptor.hardBudget = true;
+    }
     let result;
     try {
         // #3214: --ceremony-depth forces this session only (not persisted to policy).
@@ -257,6 +327,7 @@ export function run(argv) {
             allowOptionalNetwork: args.withNetwork ? true : undefined,
             ceremonyTier: args.ceremonyTier,
             ceremonyDialInputs: args.ceremonyDialInputs,
+            effortBudgetSeams: { hostDescriptor, environ: process.env },
             ...(args.ceremonyDepthOverride !== null
                 ? {
                     ceremonyDial: selectCeremonyDepth({

package/dist/verify-completed-tracked.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+interface ParsedArgs {
+    projectRoot: string;
+    repo: string | null;
+    tip: string | null;
+    quiet: boolean;
+    skipGh: boolean;
+    error?: string;
+}
+/** Parse verify-completed-tracked CLI args (#3264). */
+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-completed-tracked.d.ts.map

package/dist/verify-completed-tracked.js

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

package/dist/verify-literal-ac.d.ts

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

package/dist/verify-literal-ac.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+/**
+ * CLI: task verify:literal-ac — run stored literal acceptance commands verbatim (#3267).
+ */
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { evaluateLiteralAcceptanceFromPath, formatRejectedLedger, resolveLiteralAcceptanceDetailed, } from "@deftai/directive-core/literal-acceptance";
+/** Parse verify-literal-ac CLI args. */
+export function parseArgs(argv) {
+    const parsed = {
+        projectRoot: ".",
+        xbriefPath: null,
+        quiet: false,
+        captureOnly: false,
+    };
+    const positionals = [];
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--quiet") {
+            parsed.quiet = true;
+        }
+        else if (arg === "--capture-only") {
+            parsed.captureOnly = true;
+        }
+        else if (arg === "--project-root") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: "argument --project-root: expected one argument" };
+            }
+            parsed.projectRoot = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--project-root=")) {
+            parsed.projectRoot = arg.slice("--project-root=".length);
+        }
+        else if (arg === "--xbrief" || arg === "--vbrief") {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                return { ...parsed, error: `argument ${arg}: expected one argument` };
+            }
+            parsed.xbriefPath = value;
+            i += 1;
+        }
+        else if (arg?.startsWith("--xbrief=") || arg?.startsWith("--vbrief=")) {
+            parsed.xbriefPath = arg.slice(arg.indexOf("=") + 1);
+        }
+        else if (arg?.startsWith("-")) {
+            return { ...parsed, error: `unrecognized argument: ${arg}` };
+        }
+        else if (arg !== undefined) {
+            positionals.push(arg);
+        }
+    }
+    if (parsed.xbriefPath === null && positionals.length > 0) {
+        parsed.xbriefPath = positionals[0] ?? null;
+    }
+    return parsed;
+}
+function findActiveXbrief(projectRoot) {
+    for (const dirName of ["xbrief", "vbrief"]) {
+        const active = join(projectRoot, dirName, "active");
+        if (!existsSync(active))
+            continue;
+        let names = [];
+        try {
+            names = readdirSync(active).filter((n) => n.endsWith(".xbrief.json") || n.endsWith(".vbrief.json"));
+        }
+        catch {
+            continue;
+        }
+        if (names.length === 1) {
+            return join(active, names[0]);
+        }
+    }
+    return null;
+}
+function asRecord(value) {
+    if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+        return value;
+    }
+    return null;
+}
+/** Run the gate and return the process exit code. */
+export function run(argv) {
+    const args = parseArgs(argv);
+    if (args.error !== undefined) {
+        process.stderr.write(`verify_literal_ac: ${args.error}\n`);
+        return 2;
+    }
+    const projectRoot = resolve(args.projectRoot);
+    let xbriefPath = args.xbriefPath !== null ? resolve(projectRoot, args.xbriefPath) : null;
+    if (xbriefPath === null) {
+        xbriefPath = findActiveXbrief(projectRoot);
+    }
+    if (xbriefPath === null) {
+        process.stderr.write("verify_literal_ac: pass an xBRIEF path or ensure exactly one artifact in xbrief/active/\n" +
+            "  Usage: task verify:literal-ac -- <path-to-active.xbrief.json>\n" +
+            "  Refs #3267 literal acceptance-command verification\n");
+        return 2;
+    }
+    if (args.captureOnly) {
+        try {
+            const data = asRecord(JSON.parse(readFileSync(xbriefPath, "utf8")));
+            if (data === null) {
+                process.stderr.write("verify_literal_ac: xBRIEF top-level is not an object\n");
+                return 2;
+            }
+            const plan = asRecord(data.plan);
+            if (plan === null) {
+                process.stderr.write("verify_literal_ac: xBRIEF missing plan object\n");
+                return 2;
+            }
+            const resolved = resolveLiteralAcceptanceDetailed(plan, { captureFromNarratives: true });
+            const payload = {
+                xbrief: xbriefPath,
+                count: resolved.commands.length,
+                rejected_count: resolved.rejected.length,
+                commands: resolved.commands.map((c) => ({
+                    command: c.command,
+                    source: c.source,
+                    sourceSpan: c.sourceSpan ?? null,
+                    cwd: c.cwd ?? null,
+                    expectedExitCode: c.expectedExitCode ?? 0,
+                })),
+                rejected: resolved.rejected.map((r) => ({
+                    command: r.command,
+                    reason: r.reason,
+                    sourceSpan: r.sourceSpan ?? null,
+                })),
+            };
+            process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+            if (resolved.rejected.length > 0) {
+                process.stderr.write(`${formatRejectedLedger(resolved.rejected)}\n`);
+            }
+            return 0;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`verify_literal_ac: ${msg}\n`);
+            return 2;
+        }
+    }
+    const result = evaluateLiteralAcceptanceFromPath(xbriefPath, {
+        projectRoot,
+        quiet: args.quiet,
+    });
+    if (result.message.length > 0) {
+        if (result.ok) {
+            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-literal-ac.js.map

package/dist/verify-story-ready.js

@@ -148,6 +148,7 @@ export function run(argv) {
         allocationContext: allocationContextText,
         allowDirty: args.allowDirty,
         parsed,
+        projectRoot,
     });
     if (result.exitCode === 0 && !args.skipRouting) {
         const provider = resolveDispatchProvider(process.env);

package/package.json

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