@deftai/directive 0.80.0 → 0.82.0

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

@@ -72,6 +72,11 @@ export const SUBCOMMAND_ROUTES = {
     "policy:enforce-branches": ["policy", "enforce-branches"],
     "policy:allow-direct-commits": ["policy", "allow-direct-commits"],
     "policy:enable-value-feedback": ["policy", "enable-value-feedback"],
+    "product-signal:status": ["product-signal", "status"],
+    "product-signal:enable": ["product-signal", "enable"],
+    "product-signal:consent": ["product-signal", "consent"],
+    "product-signal:submit": ["product-signal", "submit"],
+    "product-signal:bootstrap-sink": ["product-signal", "bootstrap-sink"],
     "vbrief:reconcile-graph": ["vbrief-reconcile", "graph"],
     "vbrief:reconcile-labels": ["vbrief-reconcile", "labels"],
     "vbrief:reconcile-umbrellas": ["vbrief-reconcile", "umbrellas"],
@@ -79,6 +84,7 @@ export const SUBCOMMAND_ROUTES = {
     "slice:list": ["slice", "list"],
     "github-body:issue-create": ["github-body", "issue-create"],
     "github-body:issue-edit": ["github-body", "issue-edit"],
+    "github-body:issue-fetch": ["github-body", "issue-fetch"],
     "github-body:comment-create": ["github-body", "comment-create"],
     "github-body:comment-edit": ["github-body", "comment-edit"],
     "github-body:pr-edit": ["github-body", "pr-edit"],

package/dist/dispatch.d.ts

@@ -10,15 +10,17 @@ 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", "pr-closing-keywords", "pr-merge-readiness", "pr-monitor", "pr-protected-issues", "pr-wait-mergeable", "pr-watch", "preflight-cache", "preflight-gh", "probe-session", "release", "release-e2e", "release-publish", "release-rollback", "scope-lifecycle", "lifecycle-event", "session-start", "plan-sequence", "slice", "subagent-monitor", "toolchain-check", "triage-actions", "triage-bootstrap", "triage-bulk", "triage-classify", "triage-help", "triage-queue", "triage-reconcile", "triage-refresh", "triage-scope", "triage-scope-drift", "triage-smoketest", "triage-subscribe", "triage-summary", "triage-welcome", "ts-check-lane", "vbrief-activate", "vbrief-build", "vbrief-preflight", "vbrief-reconcile", "vbrief-validate", "vbrief-validation", "verify-branch", "verify-encoding", "verify-forward-coverage", "verify-hooks-installed", "verify-investigation", "verify-judgment-gates", "verify-no-task-runtime", "validate-links", "validate-strategy-output", "verify-biome-config", "verify-bridge-drift", "verify-capacity", "verify-content-manifest", "verify-contract-drift", "verify-cursor-tier1", "verify-go-freeze", "verify-scm-boundary", "verify-session-ritual", "verify-plan-sequence", "verify-stubs", "verify-xbrief-drift", "rule-ownership-lint", "verify-story-ready", "verify-review-monitor", "review-monitor-register", "verify-tools", "verify-wip-cap", "verify-agents-md-budget", "verify-agents-md-advisory", "verify-eval-health-relocation", "verify-eval-triggers-relocation", "eval-health", "eval-run", "eval-report", "eval-triggers"];
+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", "pr-closing-keywords", "pr-merge-readiness", "pr-monitor", "pr-protected-issues", "pr-wait-mergeable", "pr-watch", "preflight-cache", "preflight-gh", "probe-session", "release", "release-e2e", "release-publish", "release-rollback", "scope-lifecycle", "lifecycle-event", "session-start", "plan-sequence", "slice", "subagent-monitor", "toolchain-check", "triage-actions", "triage-bootstrap", "triage-bulk", "triage-classify", "triage-help", "triage-queue", "triage-reconcile", "triage-refresh", "triage-scope", "triage-scope-drift", "triage-smoketest", "triage-subscribe", "triage-summary", "triage-welcome", "ts-check-lane", "vbrief-activate", "vbrief-build", "vbrief-preflight", "vbrief-reconcile", "vbrief-validate", "vbrief-validation", "verify-branch", "verify-encoding", "verify-forward-coverage", "verify-hooks-installed", "verify-investigation", "verify-judgment-gates", "verify-no-task-runtime", "validate-links", "validate-strategy-output", "verify-biome-config", "verify-bridge-drift", "verify-capacity", "verify-content-manifest", "verify-skill-external-fetch-gate", "verify-contract-drift", "verify-cursor-tier1", "verify-go-freeze", "verify-scm-boundary", "verify-session-ritual", "verify-plan-sequence", "verify-stubs", "verify-xbrief-drift", "rule-ownership-lint", "verify-story-ready", "verify-review-monitor", "review-monitor-register", "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"];
 /** Core-only CLI entrypoints without a packages/cli wrapper. */
-export declare const CORE_MODULE_VERBS: readonly ["scm", "github-auth-modes", "github-body", "issue-emit", "issue-ingest", "issue-sync-from-xbrief", "reconcile-issues", "swarm-launch", "swarm-complete-cohort", "swarm-finalize-cohort", "swarm-readiness", "swarm-routing-verify", "swarm-routing-set", "swarm-verify-review-clean", "swarm-worktrees", "framework-commands", "pack-render", "packs-slice", "prd-render", "export-spec", "project-render", "roadmap-render", "spec-render", "spec-validate", "code-structure-validate", "pack-migrate-skills", "pack-migrate-rules", "pack-migrate-strategies", "pack-migrate-patterns", "pack-migrate-swarm-spec", "policy-set", "setup-ghx", "scope-undo", "scope-demote", "scope-decompose", "changelog-resolve-unreleased", "architecture-preflight-sor", "feedback-file", "value-readback"];
+export declare const CORE_MODULE_VERBS: readonly ["scm", "github-auth-modes", "github-body", "issue-emit", "issue-ingest", "issue-sync-from-xbrief", "reconcile-issues", "swarm-launch", "swarm-complete-cohort", "swarm-finalize-cohort", "swarm-readiness", "swarm-routing-verify", "swarm-routing-set", "swarm-verify-review-clean", "swarm-worktrees", "framework-commands", "pack-render", "packs-slice", "prd-render", "export-spec", "project-render", "roadmap-render", "spec-render", "spec-validate", "code-structure-validate", "pack-migrate-skills", "pack-migrate-rules", "pack-migrate-strategies", "pack-migrate-patterns", "pack-migrate-swarm-spec", "policy-set", "setup-ghx", "scope-undo", "scope-demote", "scope-decompose", "changelog-resolve-unreleased", "architecture-preflight-sor", "feedback-file", "value-readback", "product-signal"];
 /** Colon aliases for triage-actions (mirrors cli-router SUBCOMMAND_ROUTES). */
 export declare const TRIAGE_ACTION_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
 /** Colon aliases for policy subcommands (mirrors cli-router SUBCOMMAND_ROUTES). */
 export declare const POLICY_ACTION_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
 /** Colon aliases for plan-sequence subcommands (#2402). */
 export declare const PLAN_SEQUENCE_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
+/** Colon aliases for product-signal subcommands (#2693). */
+export declare const PRODUCT_SIGNAL_ALIAS_SUBCOMMANDS: Readonly<Record<string, string>>;
 /** Task-style aliases (framework_commands / Taskfile names). */
 export declare const VERB_ALIASES: Readonly<Record<string, string>>;
 /** Pinned ghx version (display only) — keep in lockstep with .github/workflows/ci.yml env.GHX_VERSION. */

package/dist/dispatch.js

@@ -102,6 +102,7 @@ export const CLI_MODULE_VERBS = [
     "verify-bridge-drift",
     "verify-capacity",
     "verify-content-manifest",
+    "verify-skill-external-fetch-gate",
     "verify-contract-drift",
     "verify-cursor-tier1",
     "verify-go-freeze",
@@ -116,6 +117,7 @@ export const CLI_MODULE_VERBS = [
     "review-monitor-register",
     "verify-tools",
     "verify-wip-cap",
+    "verify-orphan-active",
     "verify-agents-md-budget",
     "verify-agents-md-advisory",
     "verify-eval-health-relocation",
@@ -166,6 +168,7 @@ export const CORE_MODULE_VERBS = [
     "architecture-preflight-sor",
     "feedback-file",
     "value-readback",
+    "product-signal",
 ];
 /** Colon aliases for triage-actions (mirrors cli-router SUBCOMMAND_ROUTES). */
 export const TRIAGE_ACTION_ALIAS_SUBCOMMANDS = {
@@ -195,6 +198,15 @@ export const PLAN_SEQUENCE_ALIAS_SUBCOMMANDS = {
     "plan-sequence:advance": "advance",
 };
 const PLAN_SEQUENCE_COLON_ALIASES = Object.fromEntries(Object.keys(PLAN_SEQUENCE_ALIAS_SUBCOMMANDS).map((alias) => [alias, "plan-sequence"]));
+/** Colon aliases for product-signal subcommands (#2693). */
+export const PRODUCT_SIGNAL_ALIAS_SUBCOMMANDS = {
+    "product-signal:status": "status",
+    "product-signal:enable": "enable",
+    "product-signal:consent": "consent",
+    "product-signal:submit": "submit",
+    "product-signal:bootstrap-sink": "bootstrap-sink",
+};
+const PRODUCT_SIGNAL_COLON_ALIASES = Object.fromEntries(Object.keys(PRODUCT_SIGNAL_ALIAS_SUBCOMMANDS).map((alias) => [alias, "product-signal"]));
 /** Task-style aliases (framework_commands / Taskfile names). */
 export const VERB_ALIASES = {
     "hook:dispatch": "hook-dispatch",
@@ -204,6 +216,7 @@ export const VERB_ALIASES = {
     "verify:branch": "verify-branch",
     "verify:vbrief-conformance": "vbrief-validate",
     "verify:wip-cap": "verify-wip-cap",
+    "verify:orphan-active": "verify-orphan-active",
     "verify:agents-md-budget": "verify-agents-md-budget",
     "verify:agents-md-advisory": "verify-agents-md-advisory",
     "verify:eval-health-relocation": "verify-eval-health-relocation",
@@ -227,6 +240,7 @@ export const VERB_ALIASES = {
     "rule:ownership-lint": "rule-ownership-lint",
     "verify:biome-config": "verify-biome-config",
     "verify:content-manifest": "verify-content-manifest",
+    "verify:skill-external-fetch-gate": "verify-skill-external-fetch-gate",
     "verify:contract-drift": "verify-contract-drift",
     "verify:cursor-tier1": "verify-cursor-tier1",
     "verify:go-freeze": "verify-go-freeze",
@@ -248,6 +262,7 @@ export const VERB_ALIASES = {
     "triage:scope": "triage-scope",
     ...TRIAGE_ACTION_COLON_ALIASES,
     ...POLICY_ACTION_COLON_ALIASES,
+    ...PRODUCT_SIGNAL_COLON_ALIASES,
     "agents:refresh": "agents-refresh",
     "migrate:preflight": "migrate-preflight",
     "migrate:xbrief": "migrate-xbrief",
@@ -283,6 +298,7 @@ const SUBDIR_CLI_STEMS = {
     "rule-ownership-lint": "verify-source-cli/rule-ownership-lint",
     "verify-biome-config": "verify-source-cli/verify-biome-config",
     "verify-content-manifest": "verify-source-cli/verify-content-manifest",
+    "verify-skill-external-fetch-gate": "verify-source-cli/verify-skill-external-fetch-gate",
     "verify-contract-drift": "verify-source-cli/verify-contract-drift",
     "verify-cursor-tier1": "verify-source-cli/verify-cursor-tier1",
     "verify-scm-boundary": "verify-source-cli/verify-scm-boundary",
@@ -2348,6 +2364,10 @@ async function loadCoreModuleHandler(verb, io) {
             const { mainEntry } = await import("@deftai/directive-core/dist/value/readback.js");
             return mainEntry;
         }
+        case "product-signal": {
+            const { mainEntry } = await import("@deftai/directive-core/dist/product-signal/submit.js");
+            return mainEntry;
+        }
         default:
             throw new Error(`unknown core verb: ${verb}`);
     }
@@ -2558,6 +2578,7 @@ export async function dispatch(argv, io = defaultIo()) {
         const triageSubcommand = verb !== undefined ? TRIAGE_ACTION_ALIAS_SUBCOMMANDS[verb] : undefined;
         const policySubcommand = verb !== undefined ? POLICY_ACTION_ALIAS_SUBCOMMANDS[verb] : undefined;
         const planSequenceSubcommand = verb !== undefined ? PLAN_SEQUENCE_ALIAS_SUBCOMMANDS[verb] : undefined;
+        const productSignalSubcommand = verb !== undefined ? PRODUCT_SIGNAL_ALIAS_SUBCOMMANDS[verb] : undefined;
         const handlerArgv = canonical === "framework-commands" && verb !== undefined && verb !== canonical
             ? [verb, ...rest]
             : triageSubcommand !== undefined && canonical === "triage-actions"
@@ -2566,7 +2587,9 @@ export async function dispatch(argv, io = defaultIo()) {
                     ? [policySubcommand, ...rest]
                     : planSequenceSubcommand !== undefined && canonical === "plan-sequence"
                         ? [planSequenceSubcommand, ...rest]
-                        : rest;
+                        : productSignalSubcommand !== undefined && canonical === "product-signal"
+                            ? [productSignalSubcommand, ...rest]
+                            : rest;
         return await invokeHandler(handler, handlerArgv);
     }
     catch (err) {

package/dist/hook-dispatch.js

@@ -57,14 +57,55 @@ export function parseArgs(argv) {
         return { error: "--event is required" };
     return parsed;
 }
+const UTF8_BOM = "\uFEFF";
+const APPLY_PATCH_BEGIN_MARKER = "*** Begin Patch";
+/** Single-file Add/Update only — other *** … File: ops must fail closed (#2738 Greptile). */
+const APPLY_PATCH_MUTATION_LINE_RE = /^\*\*\* (Add File|Update File|Delete File|Move File|Rename File): (.+)$/gm;
+function stripUtf8Bom(raw) {
+    return raw.startsWith(UTF8_BOM) ? raw.slice(UTF8_BOM.length) : raw;
+}
+function trySynthesizeFreeFormApplyPatch(normalized) {
+    if (!normalized.includes(APPLY_PATCH_BEGIN_MARKER))
+        return null;
+    const mutations = [];
+    for (const match of normalized.matchAll(APPLY_PATCH_MUTATION_LINE_RE)) {
+        const op = match[1];
+        const path = match[2]?.trim();
+        if (op === undefined || !path)
+            continue;
+        mutations.push({ op, path });
+    }
+    if (mutations.length !== 1)
+        return null;
+    const sole = mutations[0];
+    if (sole === undefined || (sole.op !== "Add File" && sole.op !== "Update File"))
+        return null;
+    return {
+        payload: {
+            tool_name: "ApplyPatch",
+            tool_input: {
+                path: sole.path,
+                patch: normalized,
+            },
+        },
+        context: {},
+    };
+}
 export function parsePayload(raw) {
     if (raw.trim().length === 0) {
         return { payload: {}, context: { stdinEmpty: true } };
     }
+    const normalized = stripUtf8Bom(raw);
+    if (normalized.trim().length === 0) {
+        return { payload: {}, context: { stdinEmpty: true } };
+    }
     try {
-        return { payload: JSON.parse(raw), context: {} };
+        return { payload: JSON.parse(normalized), context: {} };
     }
     catch {
+        const synthesized = trySynthesizeFreeFormApplyPatch(normalized);
+        if (synthesized !== null)
+            return synthesized;
         // tool.before is installed only on direct-write matchers, so an unreadable
         // payload becomes a missing-tool denial rather than a fail-open crash.
         return { payload: {}, context: { parseFailed: true } };

package/dist/verify-orphan-active.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+interface ParsedArgs {
+    projectRoot: string;
+    repo: string | null;
+    quiet: boolean;
+    skipGh: boolean;
+    error?: string;
+}
+/** Parse verify-orphan-active 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-orphan-active.d.ts.map

package/dist/verify-orphan-active.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { evaluate } from "@deftai/directive-core/orphan-active";
+/** Parse verify-orphan-active CLI args. */
+export function parseArgs(argv) {
+    const parsed = {
+        projectRoot: ".",
+        repo: 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 {
+            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_orphan_active: ${args.error}\n`);
+        return 2;
+    }
+    const projectRoot = resolve(args.projectRoot);
+    const result = evaluate(projectRoot, {
+        quiet: args.quiet,
+        repo: args.repo,
+        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-orphan-active.js.map

package/dist/verify-source-cli/verify-skill-external-fetch-gate.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+interface ParsedArgs {
+    projectRoot: string | null;
+    error?: string;
+}
+/** Parse verify-skill-external-fetch-gate CLI args (#1936). */
+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-skill-external-fetch-gate.d.ts.map

package/dist/verify-source-cli/verify-skill-external-fetch-gate.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { evaluateSkillExternalFetchGate } from "@deftai/directive-core/verify-source";
+/** Parse verify-skill-external-fetch-gate CLI args (#1936). */
+export function parseArgs(argv) {
+    const parsed = { projectRoot: null };
+    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 {
+            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_skill_external_fetch_gate: ${args.error}\n`);
+        return 2;
+    }
+    const result = evaluateSkillExternalFetchGate(resolve(args.projectRoot ?? "."));
+    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-skill-external-fetch-gate.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive",
-  "version": "0.80.0",
+  "version": "0.82.0",
   "description": "Directive CLI — npm install path for the Deft Directive framework.",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,8 +31,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-core": "^0.80.0",
-    "@deftai/directive-content": "^0.80.0"
+    "@deftai/directive-core": "^0.82.0",
+    "@deftai/directive-content": "^0.82.0"
   },
   "scripts": {
     "build": "tsc -b"