@deftai/directive 0.126.2 → 0.128.0

package/dist/verify-ac.js

@@ -1,439 +0,0 @@
-#!/usr/bin/env node
-/**
- * CLI: task verify:ac — product-first acceptance criteria gate (#3284).
- *
- * Runs plan.acceptance.commands (or #3267 literal ledger) verbatim.
- * Primary name for the product-first done-gate; verify:literal-ac remains
- * the #3267 mechanism alias.
- */
-import { spawnSync } from "node:child_process";
-import { existsSync, readdirSync, readFileSync } from "node:fs";
-import { join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { resolveSessionCompletedVerifyAcTarget } from "@deftai/directive-core/check";
-import { formatRejectedLedger, resolveLiteralAcceptanceDetailed, } from "@deftai/directive-core/literal-acceptance";
-import { emitVerifyAcTerminalOutcome, evaluateVerifyAcFromPath, readAdmittedSourceDigest, readAdmittedSourceSentences, readPlanAcceptance, resolveAcceptanceGateProfile, resolveSoftMissingAcTargets, } from "@deftai/directive-core/product-first-done-gate";
-/** Parse verify:ac CLI args. */
-export function parseArgs(argv) {
-    const parsed = {
-        projectRoot: ".",
-        xbriefPath: null,
-        quiet: false,
-        captureOnly: false,
-        softMissingXbrief: 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 === "--soft-missing-xbrief") {
-            parsed.softMissingXbrief = 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 listActiveXbriefs(projectRoot) {
-    // Greptile conf residual #3284: scan BOTH lifecycle roots (xbrief + read-accepted
-    // vbrief). Returning after the first non-empty root left the other unchecked.
-    const paths = [];
-    const dirs = [];
-    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"))
-                .sort();
-        }
-        catch {
-            continue;
-        }
-        if (names.length === 0)
-            continue;
-        dirs.push(active);
-        for (const n of names) {
-            paths.push(join(active, n));
-        }
-    }
-    if (paths.length === 0)
-        return { kind: "none" };
-    if (paths.length === 1) {
-        return { kind: "one", path: paths[0] };
-    }
-    return {
-        kind: "many",
-        paths,
-        dir: dirs.join(" + "),
-    };
-}
-/** Three-state exit: pass=0, fail=1, config=2. A printed pass must not leak 201. */
-export function clampVerifyAcExit(ok, code) {
-    if (ok)
-        return 0;
-    if (code === 2)
-        return 2;
-    return 1;
-}
-/**
- * Spec-path briefs persist the refused GitHub body under plan.metadata.issueBody
- * (#4524 / #5055), including empty string when the origin body was empty. Live
- * recovery must use the Bound-remedy harvest (Overview), not body-normative REST.
- */
-function planHasSpecPathRefusedBody(plan) {
-    const meta = asRecord(plan.metadata);
-    if (meta === null) {
-        return false;
-    }
-    return Object.hasOwn(meta, "issueBody") && typeof meta.issueBody === "string";
-}
-/**
- * Spec-path admitted source = Overview harvest remainder (#5055).
- * Fail closed when Overview is empty — do not fall through to the refused body.
- */
-function fetchSpecPathHarvest(plan) {
-    const narratives = asRecord(plan.narratives);
-    const overview = narratives?.Overview;
-    if (typeof overview === "string" && overview.trim().length > 0) {
-        return { ok: true, text: overview };
-    }
-    return {
-        ok: false,
-        reason: "Spec-path Bound-remedy harvest unavailable (Overview empty); refuse offline / restore from git",
-    };
-}
-/**
- * Live REST body for the origin issue (body-normative admitted source, #5055).
- * Fail closed on forge outage — do not skip.
- */
-function fetchOriginIssueBody(plan) {
-    const refs = Array.isArray(plan.references) ? plan.references : [];
-    let issueUrl = null;
-    for (const entry of refs) {
-        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
-            continue;
-        }
-        const row = entry;
-        if (row.type === "x-xbrief/github-issue" && typeof row.uri === "string") {
-            issueUrl = row.uri;
-            break;
-        }
-    }
-    if (issueUrl === null) {
-        return { ok: false, reason: "no github-issue reference on the brief for live REST" };
-    }
-    const match = issueUrl.match(/github\.com\/([^/]+)\/([^/]+)\/issues\/(\d+)/i);
-    if (match === null) {
-        return { ok: false, reason: `unparseable github-issue uri: ${issueUrl}` };
-    }
-    const owner = match[1] ?? "";
-    const repo = match[2] ?? "";
-    const number = match[3] ?? "";
-    const apiPath = `repos/${owner}/${repo}/issues/${number}`;
-    const proc = spawnSync("gh", ["api", apiPath, "--jq", ".body"], {
-        encoding: "utf8",
-        env: process.env,
-    });
-    if (proc.error) {
-        return { ok: false, reason: `forge outage: ${proc.error.message}` };
-    }
-    if (proc.status !== 0) {
-        const detail = `${proc.stderr ?? ""}${proc.stdout ?? ""}`.trim() || `gh api exited ${String(proc.status)}`;
-        return { ok: false, reason: `forge outage: ${detail}` };
-    }
-    return { ok: true, text: typeof proc.stdout === "string" ? proc.stdout : "" };
-}
-/**
- * Live admitted-source text for digest compare / missing-pin recovery (#5055).
- * Spec-path → Bound-remedy harvest; body-normative → origin issue body.
- */
-function fetchAdmittedSourceForPlan(plan) {
-    if (planHasSpecPathRefusedBody(plan)) {
-        return fetchSpecPathHarvest(plan);
-    }
-    return fetchOriginIssueBody(plan);
-}
-/** Evaluate one or many xBRIEF paths; return worst non-zero code (fail closed). */
-function evaluatePaths(paths, options) {
-    let worst = 0;
-    // One shared option profile per reader (#3497) — scope:complete resolves its own
-    // profile from the same table, so the two readers cannot drift apart again.
-    const profile = resolveAcceptanceGateProfile(options.softMissingXbrief ? "check" : "standalone");
-    for (const path of paths) {
-        if (!options.quiet && paths.length > 1) {
-            process.stdout.write(`verify:ac — evaluating ${path}\n`);
-        }
-        let fetchAdmittedSourceText;
-        try {
-            const raw = JSON.parse(readFileSync(path, "utf8"));
-            const root = asRecord(raw);
-            const plan = asRecord(root?.plan);
-            // Arm live admitted-source fetch when a pin is present (digest compare), a
-            // digest remains after pin delete (honor recorded digest), or Spec-path
-            // refused-body metadata marks harvest recovery (#5055). Spec-path callbacks
-            // return the Bound-remedy harvest, not the refused raw issue body. Body-
-            // normative both-deleted recovery prefers git HEAD / merge-base so
-            // pre-#5055 briefs without a pin are not suddenly floored by live REST.
-            if (plan !== null) {
-                const pin = readAdmittedSourceSentences(plan.acceptance);
-                const digest = readAdmittedSourceDigest(plan.acceptance);
-                if (pin !== null || digest !== null || planHasSpecPathRefusedBody(plan)) {
-                    fetchAdmittedSourceText = () => fetchAdmittedSourceForPlan(plan);
-                }
-            }
-        }
-        catch {
-            // Path evaluation still runs; unreadable brief is handled inside evaluateVerifyAcFromPath.
-        }
-        const result = evaluateVerifyAcFromPath(path, {
-            projectRoot: options.projectRoot,
-            quiet: options.quiet,
-            softMissingXbrief: options.softMissingXbrief,
-            checkIntegrated: profile.checkIntegrated,
-            captureFromNarratives: profile.captureFromNarratives,
-            reuseMode: profile.reuseMode,
-            env: process.env,
-            ...(fetchAdmittedSourceText !== undefined ? { fetchAdmittedSourceText } : {}),
-        });
-        if (result.message.length > 0) {
-            if (result.ok) {
-                process.stdout.write(`${result.message}\n`);
-            }
-            else {
-                process.stderr.write(`${result.message}\n`);
-            }
-        }
-        const code = clampVerifyAcExit(result.ok, result.code);
-        if (code !== 0 && (worst === 0 || code > worst)) {
-            // Prefer code 1 (fail) over 2 when both present — still non-zero.
-            worst = code;
-        }
-    }
-    return worst;
-}
-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_ac: ${args.error}\n`);
-        emitVerifyAcTerminalOutcome({
-            projectRoot: resolve(args.projectRoot),
-            env: process.env,
-            outcome: "config-error",
-        });
-        return 2;
-    }
-    const projectRoot = resolve(args.projectRoot);
-    let paths = [];
-    if (args.xbriefPath !== null) {
-        paths = [resolve(projectRoot, args.xbriefPath)];
-    }
-    else {
-        const found = listActiveXbriefs(projectRoot);
-        if (found.kind === "one") {
-            paths = [found.path];
-        }
-        else if (found.kind === "many") {
-            // #4285: soft-missing selects via DEFT_ACTIVE_SCOPE / explicit path
-            // (or fail closed). ALL-paths soft-missing is not the #3284 product bar.
-            // --capture-only still lists every active artifact (inventory, not run).
-            if (args.captureOnly) {
-                paths = [...found.paths];
-                if (!args.quiet) {
-                    process.stdout.write(`verify:ac capture-only multi-active: listing ${paths.length} scopes in ${found.dir}\n`);
-                }
-            }
-            else if (args.softMissingXbrief) {
-                const selected = resolveSoftMissingAcTargets(projectRoot, {
-                    env: process.env,
-                    scannedPaths: found.paths,
-                });
-                if (selected.kind === "one") {
-                    paths = [selected.path];
-                    if (!args.quiet) {
-                        process.stdout.write(`verify:ac soft-missing multi-active (#4285): selected ${selected.path}\n`);
-                    }
-                }
-                else {
-                    process.stderr.write(`${selected.kind === "need-pin" ? selected.message : "verify_ac: multi-active soft-missing needs a pin"}\n` +
-                        "  Usage: task verify:ac -- <path-to-active.xbrief.json>\n" +
-                        `  Or set DEFT_ACTIVE_SCOPE to the dispatched story under ${found.dir}\n` +
-                        "  Refs #4285 / #3284 product-first done-gate\n");
-                    emitVerifyAcTerminalOutcome({
-                        projectRoot,
-                        env: process.env,
-                        outcome: "config-error",
-                    });
-                    return 1;
-                }
-            }
-            else {
-                process.stderr.write(`verify_ac: ${found.paths.length} active scopes in ${found.dir}.\n` +
-                    "  Pass an explicit path, or set DEFT_ACTIVE_SCOPE with check composition (--soft-missing-xbrief).\n" +
-                    "  Usage: task verify:ac -- <path-to-active.xbrief.json>\n" +
-                    "  Refs #4285 / #3284 product-first done-gate\n");
-                emitVerifyAcTerminalOutcome({
-                    projectRoot,
-                    env: process.env,
-                    outcome: "config-error",
-                });
-                return 1;
-            }
-        }
-        else if (args.softMissingXbrief) {
-            const completed = resolveSessionCompletedVerifyAcTarget({
-                projectRoot,
-                env: process.env,
-            });
-            if (completed.kind === "target") {
-                paths = [completed.path];
-                if (!args.quiet) {
-                    process.stdout.write(`verify:ac targeting just-completed brief (#3357): ${completed.path}\n`);
-                }
-            }
-            else if (completed.kind === "cannot") {
-                process.stderr.write(`${completed.message}\n`);
-                emitVerifyAcTerminalOutcome({
-                    projectRoot,
-                    env: process.env,
-                    outcome: "config-error",
-                });
-                return 1;
-            }
-            else if (!args.quiet) {
-                process.stdout.write("verify:ac skipped (#3284 soft-missing): no active xBRIEF in xbrief/active/\n");
-            }
-            if (completed.kind === "none") {
-                emitVerifyAcTerminalOutcome({
-                    projectRoot,
-                    env: process.env,
-                    outcome: "soft-missing",
-                });
-                return 0;
-            }
-        }
-        else {
-            process.stderr.write("verify_ac: pass an xBRIEF path or ensure exactly one artifact in xbrief/active/\n" +
-                "  Usage: task verify:ac -- <path-to-active.xbrief.json>\n" +
-                "  Refs #3284 product-first done-gate (mechanism #3267)\n");
-            emitVerifyAcTerminalOutcome({
-                projectRoot,
-                env: process.env,
-                outcome: "config-error",
-            });
-            return 2;
-        }
-    }
-    if (args.captureOnly) {
-        // Capture-only: report each path (multi-active) as a list.
-        const reports = [];
-        for (const xbriefPath of paths) {
-            try {
-                const data = asRecord(JSON.parse(readFileSync(xbriefPath, "utf8")));
-                if (data === null) {
-                    process.stderr.write(`verify_ac: xBRIEF top-level is not an object: ${xbriefPath}\n`);
-                    return 2;
-                }
-                const plan = asRecord(data.plan);
-                if (plan === null) {
-                    process.stderr.write(`verify_ac: xBRIEF missing plan object: ${xbriefPath}\n`);
-                    return 2;
-                }
-                const acceptance = readPlanAcceptance(plan);
-                const resolved = resolveLiteralAcceptanceDetailed(plan, { captureFromNarratives: true });
-                // Executor reads plan.acceptance.commands when the #3267 ledger is empty (#3449).
-                const executorCommands = resolved.commands.length > 0
-                    ? resolved.commands
-                    : acceptance.commands.map((c) => ({
-                        command: c.command,
-                        source: "explicit",
-                        sourceSpan: "plan.acceptance.commands",
-                        cwd: c.cwd ?? null,
-                        expectedExitCode: c.expectedExitCode ?? 0,
-                    }));
-                reports.push({
-                    xbrief: xbriefPath,
-                    source_rung: acceptance.source_rung,
-                    none_stated: acceptance.none_stated,
-                    acceptance_commands: acceptance.commands,
-                    count: executorCommands.length,
-                    rejected_count: resolved.rejected.length,
-                    commands: executorCommands.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,
-                    })),
-                });
-                if (resolved.rejected.length > 0) {
-                    process.stderr.write(`${formatRejectedLedger(resolved.rejected)}\n`);
-                }
-            }
-            catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                process.stderr.write(`verify_ac: ${msg}\n`);
-                return 2;
-            }
-        }
-        process.stdout.write(`${JSON.stringify(reports.length === 1 ? reports[0] : { scopes: reports }, null, 2)}\n`);
-        return 0;
-    }
-    return evaluatePaths(paths, {
-        projectRoot,
-        quiet: args.quiet,
-        softMissingXbrief: args.softMissingXbrief,
-    });
-}
-if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
-    process.exit(run(process.argv.slice(2)));
-}
-//# sourceMappingURL=verify-ac.js.map

package/dist/verify-agents-md-advisory.d.ts

@@ -1,19 +0,0 @@
-#!/usr/bin/env node
-interface ParsedArgs {
-    projectRoot: string;
-    quiet: boolean;
-    enforce: boolean;
-    error?: string;
-}
-/** Parse verify-agents-md-advisory CLI args. */
-export declare function parseArgs(argv: string[]): ParsedArgs;
-/**
- * Run the advisory and return the process exit code.
- *
- * Default posture is advisory: the command ALWAYS exits 0 (it never
- * fail-closes a consumer build). The opt-in `--enforce` flag promotes an
- * over-budget unmanaged region to exit 1 for consumers who want a hard cap.
- */
-export declare function run(argv: string[]): number;
-export {};
-//# sourceMappingURL=verify-agents-md-advisory.d.ts.map

package/dist/verify-agents-md-advisory.js

@@ -1,65 +0,0 @@
-#!/usr/bin/env node
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { evaluate } from "@deftai/directive-core/agents-md-advisory";
-/** Parse verify-agents-md-advisory CLI args. */
-export function parseArgs(argv) {
-    const parsed = {
-        projectRoot: ".",
-        quiet: false,
-        enforce: false,
-    };
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i];
-        if (arg === "--quiet") {
-            parsed.quiet = true;
-        }
-        else if (arg === "--enforce") {
-            parsed.enforce = 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 {
-            return { ...parsed, error: `unrecognized argument: ${arg}` };
-        }
-    }
-    return parsed;
-}
-/**
- * Run the advisory and return the process exit code.
- *
- * Default posture is advisory: the command ALWAYS exits 0 (it never
- * fail-closes a consumer build). The opt-in `--enforce` flag promotes an
- * over-budget unmanaged region to exit 1 for consumers who want a hard cap.
- */
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`verify_agents_md_advisory: ${args.error}\n`);
-        return 2;
-    }
-    const projectRoot = resolve(args.projectRoot);
-    const result = evaluate(projectRoot, { quiet: args.quiet, enforce: args.enforce });
-    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-agents-md-advisory.js.map

package/dist/verify-agents-md-budget.d.ts

@@ -1,12 +0,0 @@
-#!/usr/bin/env node
-interface ParsedArgs {
-    projectRoot: string;
-    quiet: boolean;
-    error?: string;
-}
-/** Parse verify-agents-md-budget 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-agents-md-budget.d.ts.map

package/dist/verify-agents-md-budget.js

@@ -1,71 +0,0 @@
-#!/usr/bin/env node
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { evaluate } from "@deftai/directive-core/agents-md-budget";
-/** Parse verify-agents-md-budget CLI args. */
-export function parseArgs(argv) {
-    const parsed = {
-        projectRoot: ".",
-        quiet: false,
-    };
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i];
-        if (arg === "--quiet") {
-            parsed.quiet = 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 {
-            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_agents_md_budget: ${args.error}\n`);
-        return 2;
-    }
-    const projectRoot = resolve(args.projectRoot);
-    const result = evaluate(projectRoot, { quiet: args.quiet });
-    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`);
-        }
-    }
-    if (result.northStarMessage !== undefined && result.northStarMessage.length > 0) {
-        if (result.northStarStream === "stdout") {
-            process.stdout.write(`${result.northStarMessage}\n`);
-        }
-        else if (result.northStarStream === "stderr") {
-            process.stderr.write(`${result.northStarMessage}\n`);
-        }
-    }
-    else if (result.advisoryMessage !== undefined && result.advisoryMessage.length > 0) {
-        if (result.advisoryStream === "stdout") {
-            process.stdout.write(`${result.advisoryMessage}\n`);
-        }
-        else if (result.advisoryStream === "stderr") {
-            process.stderr.write(`${result.advisoryMessage}\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-agents-md-budget.js.map

package/dist/verify-branch.d.ts

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-interface ParsedArgs {
-    projectRoot: string;
-    allowMissingProjectDefinition: boolean;
-    defaultBranches: string[] | null;
-    quiet: boolean;
-    error?: string;
-}
-/** Parse verify-branch CLI args, mirroring the Python argparse surface. */
-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-branch.d.ts.map