@deftai/directive 0.126.2 → 0.127.0

package/dist/verify-plan-sequence.js

@@ -1,138 +0,0 @@
-#!/usr/bin/env node
-/**
- * verify:plan-sequence (#2402) — fail closed unless target matches current entry.
- */
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { collectTerminalLifecycleOrigins, inspectMissingSequenceKind, missingSequenceKindPayload, readPlanSequence, verifyPlanTarget, } from "@deftai/directive-core/plan-sequence";
-const KINDS = [
-    "pr",
-    "issue",
-    "story",
-    "task",
-    "phase",
-    "checklist",
-    "review",
-];
-const USAGE = "usage: verify:plan-sequence -- --target-kind <kind> --target <id-or-title>";
-export function parseArgs(argv) {
-    const parsed = {
-        projectRoot: ".",
-        targetKind: null,
-        target: null,
-        emitJson: false,
-    };
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i];
-        if (arg === undefined || arg === "--")
-            continue;
-        if (arg === "--help" || arg === "-h") {
-            return { ...parsed, help: true };
-        }
-        if (arg === "--json") {
-            parsed.emitJson = true;
-        }
-        else if (arg === "--project-root") {
-            const value = argv[++i];
-            if (value === undefined || value === "--") {
-                return { ...parsed, error: "--project-root requires a value" };
-            }
-            parsed.projectRoot = value;
-        }
-        else if (arg.startsWith("--project-root=")) {
-            parsed.projectRoot = arg.slice("--project-root=".length);
-        }
-        else if (arg === "--target-kind") {
-            const value = argv[++i];
-            if (value === undefined || value === "--" || !KINDS.includes(value)) {
-                return { ...parsed, error: `--target-kind must be one of ${KINDS.join("|")}` };
-            }
-            parsed.targetKind = value;
-        }
-        else if (arg.startsWith("--target-kind=")) {
-            const value = arg.slice("--target-kind=".length);
-            if (value === "--" || !KINDS.includes(value)) {
-                return { ...parsed, error: `--target-kind must be one of ${KINDS.join("|")}` };
-            }
-            parsed.targetKind = value;
-        }
-        else if (arg === "--target") {
-            const value = argv[++i];
-            if (value === undefined || value === "--") {
-                return { ...parsed, error: "--target requires a value" };
-            }
-            parsed.target = value;
-        }
-        else if (arg.startsWith("--target=")) {
-            const value = arg.slice("--target=".length);
-            if (value.length === 0 || value === "--") {
-                return { ...parsed, error: "--target requires a value" };
-            }
-            parsed.target = value;
-        }
-        else if (arg.startsWith("-")) {
-            return { ...parsed, error: `unknown flag: ${arg}` };
-        }
-    }
-    if (parsed.help)
-        return parsed;
-    if (parsed.targetKind === null || parsed.target === null) {
-        return {
-            ...parsed,
-            error: USAGE,
-        };
-    }
-    return parsed;
-}
-export function main(argv = process.argv.slice(2)) {
-    const parsed = parseArgs(argv);
-    if (parsed.help) {
-        process.stdout.write(`${USAGE}\n`);
-        return 0;
-    }
-    if (parsed.error || parsed.targetKind === null || parsed.target === null) {
-        process.stderr.write(`${parsed.error ?? "usage error"}\n`);
-        return 2;
-    }
-    const root = resolve(parsed.projectRoot);
-    const missingKind = inspectMissingSequenceKind(root);
-    if (missingKind !== null) {
-        if (parsed.emitJson) {
-            process.stdout.write(`${JSON.stringify(missingSequenceKindPayload(missingKind), null, 2)}\n`);
-        }
-        else {
-            process.stderr.write(`${missingKind.message}\n`);
-        }
-        return 1;
-    }
-    const seq = readPlanSequence(root);
-    // No sequence: allow (caller may have explicit operator approval); warn on stderr.
-    if (seq === null) {
-        if (parsed.emitJson) {
-            process.stdout.write(`${JSON.stringify({ ok: true, skipped: true, reason: "no-active-sequence" }, null, 2)}\n`);
-        }
-        else {
-            process.stdout.write("OK verify:plan-sequence skipped (no active ordered-plan sequence)\n");
-        }
-        return 0;
-    }
-    const result = verifyPlanTarget(seq, {
-        targetKind: parsed.targetKind,
-        target: parsed.target,
-        terminalOrigins: collectTerminalLifecycleOrigins(root),
-    });
-    if (parsed.emitJson) {
-        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-    }
-    else if (result.ok) {
-        process.stdout.write(`OK verify:plan-sequence matched ${result.entry.kind}:${result.entry.id} (index=${result.index})\n`);
-    }
-    else {
-        process.stderr.write(`${result.message}\n`);
-    }
-    return result.ok ? 0 : 1;
-}
-if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
-    process.exit(main());
-}
-//# sourceMappingURL=verify-plan-sequence.js.map

package/dist/verify-pr-closeout-attestable.d.ts

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

package/dist/verify-pr-closeout-attestable.js

@@ -1,114 +0,0 @@
-#!/usr/bin/env node
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { evaluate } from "@deftai/directive-core/pr-closeout-attestable";
-function parsePrNumber(raw) {
-    const trimmed = raw.startsWith("#") ? raw.slice(1) : raw;
-    if (!/^\d+$/.test(trimmed)) {
-        return null;
-    }
-    const value = Number(trimmed);
-    return Number.isInteger(value) && value > 0 ? value : null;
-}
-/** Parse verify-pr-closeout-attestable CLI args. */
-export function parseArgs(argv) {
-    const parsed = {
-        projectRoot: ".",
-        repo: null,
-        pr: null,
-        quiet: false,
-        onePrUnitId: null,
-    };
-    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 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 === "--pr") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --pr: expected one argument" };
-            }
-            const pr = parsePrNumber(value);
-            if (pr === null) {
-                return { ...parsed, error: `argument --pr: expected a positive integer, got ${value}` };
-            }
-            parsed.pr = pr;
-            i += 1;
-        }
-        else if (arg?.startsWith("--pr=")) {
-            const value = arg.slice("--pr=".length);
-            const pr = parsePrNumber(value);
-            if (pr === null) {
-                return { ...parsed, error: `argument --pr: expected a positive integer, got ${value}` };
-            }
-            parsed.pr = pr;
-        }
-        else if (arg === "--one-pr-unit") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --one-pr-unit: expected one argument" };
-            }
-            parsed.onePrUnitId = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--one-pr-unit=")) {
-            parsed.onePrUnitId = arg.slice("--one-pr-unit=".length);
-        }
-        else {
-            return { ...parsed, error: `unrecognized argument: ${arg}` };
-        }
-    }
-    if (parsed.pr === null) {
-        return { ...parsed, error: "argument --pr is required" };
-    }
-    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_pr_closeout_attestable: ${args.error}\n`);
-        return 2;
-    }
-    const result = evaluate(resolve(args.projectRoot), args.pr, {
-        repo: args.repo,
-        quiet: args.quiet,
-        onePrUnitId: args.onePrUnitId,
-    });
-    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-pr-closeout-attestable.js.map

package/dist/verify-presentation-ceiling.d.ts

@@ -1,11 +0,0 @@
-#!/usr/bin/env node
-interface ParsedArgs {
-    projectRoot: string;
-    baseRef: string | null;
-    quiet: boolean;
-    error?: string;
-}
-export declare function parseArgs(argv: string[]): ParsedArgs;
-export declare function run(argv: string[]): number;
-export {};
-//# sourceMappingURL=verify-presentation-ceiling.d.ts.map

package/dist/verify-presentation-ceiling.js

@@ -1,71 +0,0 @@
-#!/usr/bin/env node
-/**
- * CLI for verify:presentation-ceiling (#5056).
- */
-import { resolve } from "node:path";
-import { presentationCeiling } from "@deftai/directive-core";
-import { isDirectEntrypoint } from "./entrypoint.js";
-export function parseArgs(argv) {
-    const parsed = {
-        projectRoot: ".",
-        baseRef: null,
-        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 if (arg === "--base-ref") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --base-ref: expected one argument" };
-            }
-            parsed.baseRef = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--base-ref=")) {
-            parsed.baseRef = arg.slice("--base-ref=".length);
-        }
-        else {
-            return { ...parsed, error: `unrecognized argument: ${arg}` };
-        }
-    }
-    return parsed;
-}
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`verify_presentation_ceiling: ${args.error}\n`);
-        return 2;
-    }
-    const projectRoot = resolve(args.projectRoot);
-    const result = presentationCeiling.evaluatePresentationCeiling(projectRoot, {
-        baseRef: args.baseRef,
-        quiet: args.quiet,
-    });
-    if (result.exitCode === 0) {
-        if (!args.quiet) {
-            process.stdout.write(`${result.message}\n`);
-        }
-    }
-    else {
-        process.stderr.write(`${result.message}\n`);
-    }
-    return result.exitCode;
-}
-if (isDirectEntrypoint(import.meta.url)) {
-    process.exit(run(process.argv.slice(2)));
-}
-//# sourceMappingURL=verify-presentation-ceiling.js.map

package/dist/verify-presentation-coverage.d.ts

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-interface ParsedArgs {
-    projectRoot: string;
-    originRef?: string;
-    staged: boolean;
-    quiet: boolean;
-    json: boolean;
-    planId?: string;
-    error?: string;
-}
-export declare function parseArgs(argv: string[]): ParsedArgs;
-export declare function run(argv: string[]): number;
-export {};
-//# sourceMappingURL=verify-presentation-coverage.d.ts.map

package/dist/verify-presentation-coverage.js

@@ -1,90 +0,0 @@
-#!/usr/bin/env node
-/**
- * CLI for verify:presentation-coverage (#5079).
- */
-import { resolve } from "node:path";
-import { presentationCoverage } from "@deftai/directive-core";
-import { isDirectEntrypoint } from "./entrypoint.js";
-export function parseArgs(argv) {
-    const parsed = { projectRoot: ".", staged: false, quiet: false, json: false };
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i];
-        if (arg === "--json") {
-            parsed.json = true;
-        }
-        else if (arg === "--plan-id") {
-            const value = argv[i + 1];
-            if (value === undefined || value.startsWith("--"))
-                return { ...parsed, error: "argument --plan-id: expected one argument" };
-            parsed.planId = value;
-            i += 1;
-        }
-        else if (arg === "--quiet") {
-            parsed.quiet = true;
-        }
-        else if (arg === "--staged") {
-            parsed.staged = true;
-        }
-        else if (arg === "--project-root") {
-            const value = argv[i + 1];
-            if (value === undefined || value.startsWith("--")) {
-                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 === "--origin-ref") {
-            const value = argv[i + 1];
-            if (value === undefined || value.startsWith("--")) {
-                return { ...parsed, error: "argument --origin-ref: expected one argument" };
-            }
-            parsed.originRef = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--origin-ref=")) {
-            parsed.originRef = arg.slice("--origin-ref=".length);
-        }
-        else if (arg === "--base-ref") {
-            return {
-                ...parsed,
-                error: "unrecognized argument: --base-ref (baseline is the computed merge base; use --origin-ref to name the origin default)",
-            };
-        }
-        else {
-            return { ...parsed, error: `unrecognized argument: ${arg}` };
-        }
-    }
-    return parsed;
-}
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`verify_presentation_coverage: ${args.error}\n`);
-        return 2;
-    }
-    const result = presentationCoverage.evaluatePresentationCoverage({
-        projectRoot: resolve(args.projectRoot),
-        originRef: args.originRef,
-        staged: args.staged,
-        quiet: args.quiet,
-        planId: args.planId,
-    });
-    if (args.json) {
-        process.stdout.write(`${JSON.stringify(result)}\n`);
-        return result.code;
-    }
-    if (!args.quiet && 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 (isDirectEntrypoint(import.meta.url)) {
-    process.exit(run(process.argv.slice(2)));
-}
-//# sourceMappingURL=verify-presentation-coverage.js.map

package/dist/verify-review-monitor.d.ts

@@ -1,32 +0,0 @@
-#!/usr/bin/env node
-import { type ReviewMonitorCallSite } from "@deftai/directive-core/review-monitor";
-interface ParsedArgs {
-    pr: number | null;
-    projectRoot: string;
-    repo: string | null;
-    headSha: string | null;
-    callSite: ReviewMonitorCallSite;
-    approach3: boolean;
-    approach3Warned: boolean;
-    emitJson: boolean;
-    /** When true, also run the #4882 merge-path arm observer (attested flags). */
-    mergePathArm: boolean;
-    liveWait: boolean;
-    explicitFinish: boolean;
-    /**
-     * Product mint-gate BLOCKED — refuse --explicit-finish write (#5690).
-     * Pass-through to writeMergePathExplicitFinishAttestation.mintGateBlocked.
-     */
-    mintGateBlocked: boolean;
-    /** Optional attestation reason; mint markers also refuse the write (#5690). */
-    reason: string | null;
-    stickyLease: boolean;
-    /** DeliveryAttemptRecord.startedAt for Approach 1 arm-startup halt (#5278 P3). */
-    dispatchStartedAt: string | null;
-    help: boolean;
-    error?: string;
-}
-export declare function parseVerifyReviewMonitorArgs(argv: readonly string[]): ParsedArgs;
-export declare function run(argv: readonly string[]): number;
-export {};
-//# sourceMappingURL=verify-review-monitor.d.ts.map