@deftai/directive 0.110.0 → 0.111.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", "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", "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

@@ -8,6 +8,7 @@ import { existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, readSync
 import { homedir, tmpdir } from "node:os";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { engineInfo, userConfig } from "@deftai/directive-core";
+import { interceptHelp } from "@deftai/directive-core/dist/triage/help/index.js";
 import { parseInitArgv, runInitDepositCli } from "@deftai/directive-core/init-deposit";
 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";
@@ -138,6 +139,7 @@ export const CLI_MODULE_VERBS = [
     "verify-plan-sequence",
     "verify-stubs",
     "verify-xbrief-drift",
+    "verify-spec-prd-fresh",
     "rule-ownership-lint",
     "verify-story-ready",
     "verify-review-monitor",
@@ -350,6 +352,7 @@ export const VERB_ALIASES = {
     "verify:bridge-drift": "verify-bridge-drift",
     "verify:scm-boundary": "verify-scm-boundary",
     "verify:xbrief-drift": "verify-xbrief-drift",
+    "verify:spec-prd-fresh": "verify-spec-prd-fresh",
     "verify:capacity": "verify-capacity",
     "verify:session-ritual": "verify-session-ritual",
     "verify:plan-sequence": "verify-plan-sequence",
@@ -432,6 +435,7 @@ const SUBDIR_CLI_STEMS = {
     "verify-openclaw-tier1": "verify-source-cli/verify-openclaw-tier1",
     "verify-scm-boundary": "verify-source-cli/verify-scm-boundary",
     "verify-xbrief-drift": "verify-source-cli/verify-xbrief-drift",
+    "verify-spec-prd-fresh": "verify-source-cli/verify-spec-prd-fresh",
     "verify-go-freeze": "gates-cli/verify-go-freeze",
     "verify-bridge-drift": "gates-cli/verify-bridge-drift",
     "validate-links": "content-validate-cli/validate-links",
@@ -556,12 +560,20 @@ function parseCodeStructureArgs(argv) {
     const paths = [];
     let json = false;
     let strict = false;
+    let enforce = false;
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
         if (arg === "--project-root") {
             const v = argv[i + 1];
             if (v === undefined)
-                return { projectRoot, paths, json, strict, error: "missing --project-root value" };
+                return {
+                    projectRoot,
+                    paths,
+                    json,
+                    strict,
+                    enforce,
+                    error: "missing --project-root value",
+                };
             projectRoot = v;
             i += 1;
         }
@@ -571,7 +583,7 @@ function parseCodeStructureArgs(argv) {
         else if (arg === "--path") {
             const v = argv[i + 1];
             if (v === undefined)
-                return { projectRoot, paths, json, strict, error: "missing --path value" };
+                return { projectRoot, paths, json, strict, enforce, error: "missing --path value" };
             paths.push(v);
             i += 1;
         }
@@ -584,11 +596,24 @@ function parseCodeStructureArgs(argv) {
         else if (arg === "--strict") {
             strict = true;
         }
+        else if (arg === "--enforce") {
+            enforce = true;
+        }
+        else if (arg !== undefined && !arg.startsWith("-")) {
+            paths.push(arg);
+        }
         else {
-            return { projectRoot, paths, json, strict, error: `unrecognized argument: ${arg}` };
+            return {
+                projectRoot,
+                paths,
+                json,
+                strict,
+                enforce,
+                error: `unrecognized argument: ${arg}`,
+            };
         }
     }
-    return { projectRoot, paths, json, strict };
+    return { projectRoot, paths, json, strict, enforce };
 }
 // ===========================================================================
 // Native pack-migrate handlers (#2022 Phase 1).
@@ -2474,6 +2499,7 @@ async function loadCoreModuleHandler(verb, io) {
                     paths: parsed.paths.length > 0 ? parsed.paths : undefined,
                     json: parsed.json,
                     strict: parsed.strict,
+                    enforce: parsed.enforce,
                 });
                 if (result.stdout)
                     io.writeOut(result.stdout);
@@ -2819,7 +2845,6 @@ export async function dispatch(argv, io = defaultIo()) {
         return 1;
     }
     try {
-        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 authzSubcommand = verb !== undefined ? AUTHZ_ACTION_ALIAS_SUBCOMMANDS[verb] : undefined;
@@ -2849,6 +2874,13 @@ export async function dispatch(argv, io = defaultIo()) {
                                         : vbriefValidateSubcommand !== undefined
                                             ? [vbriefValidateSubcommand, ...rest]
                                             : rest;
+        const helpRc = interceptHelp(canonical.replaceAll("-", "_"), handlerArgv, {
+            write: io.writeOut,
+        });
+        if (helpRc !== null) {
+            return helpRc;
+        }
+        const handler = await loadHandler(canonical, io);
         return await invokeHandler(handler, handlerArgv);
     }
     catch (err) {

package/dist/session-start.js

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

package/dist/verify-source-cli/verify-spec-prd-fresh.d.ts

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

package/dist/verify-source-cli/verify-spec-prd-fresh.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { fileURLToPath } from "node:url";
+import { runSpecPrdFreshCli } from "@deftai/directive-core/verify-source";
+export function run(argv) {
+    const result = runSpecPrdFreshCli(argv);
+    if (result.stdout.length > 0)
+        process.stdout.write(result.stdout);
+    if (result.stderr.length > 0)
+        process.stderr.write(result.stderr);
+    return result.exitCode;
+}
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+    process.exit(run(process.argv.slice(2)));
+}
+//# sourceMappingURL=verify-spec-prd-fresh.js.map

package/package.json

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