@deftai/directive 0.126.2 → 0.128.0

package/dist/verify-lifecycle-visible.js

@@ -1,68 +0,0 @@
-#!/usr/bin/env node
-/**
- * CLI for task verify:lifecycle-visible (#3505).
- * Warn-only by default; pass --enforce to fail closed.
- */
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { evaluateLifecycleVisible } from "@deftai/directive-core/lifecycle-visible";
-/** Parse verify-lifecycle-visible CLI args (#3505). */
-export function parseArgs(argv) {
-    const parsed = { projectRoot: ".", enforce: false };
-    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 if (arg === "--enforce") {
-            parsed.enforce = true;
-        }
-        else if (arg === "--help" || arg === "-h") {
-            return { ...parsed, help: true };
-        }
-        else {
-            return { ...parsed, error: `unrecognized argument: ${arg}` };
-        }
-    }
-    return parsed;
-}
-const HELP_TEXT = "Usage: verify-lifecycle-visible [--project-root <path>] [--enforce]\n" +
-    "  Detect ignore/exclude/skip-worktree flags that hide xbrief/vbrief lifecycle roots (#3505).\n" +
-    "  Default: warn-only (exit 0 with advisory report).\n" +
-    "  --enforce: fail closed (exit 1) when a lifecycle root is hidden.\n" +
-    "  Not part of task check — per-clone property, wired from session:start.\n";
-/** Run the gate and return the process exit code. */
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.help === true) {
-        process.stdout.write(HELP_TEXT);
-        return 0;
-    }
-    if (args.error !== undefined) {
-        process.stderr.write(`verify_lifecycle_visible: ${args.error}\n`);
-        return 2;
-    }
-    const result = evaluateLifecycleVisible({
-        projectRoot: resolve(args.projectRoot),
-        enforce: args.enforce,
-    });
-    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-lifecycle-visible.js.map

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

@@ -1,14 +0,0 @@
-#!/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

@@ -1,168 +0,0 @@
-#!/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,
-                })),
-                // Prose-derived captures demoted by structured acceptance commands (#3484).
-                advisory_rejected_count: resolved.advisoryRejected.length,
-                advisory_rejected: resolved.advisoryRejected.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-no-task-runtime.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export declare function run(): number;
-//# sourceMappingURL=verify-no-task-runtime.d.ts.map

package/dist/verify-no-task-runtime.js

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-import { fileURLToPath } from "node:url";
-import { formatScanResult, scan } from "@deftai/directive-core/verify-env";
-export function run() {
-    const findings = scan();
-    const result = formatScanResult(findings);
-    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());
-}
-//# sourceMappingURL=verify-no-task-runtime.js.map

package/dist/verify-observable-scope.d.ts

@@ -1,17 +0,0 @@
-#!/usr/bin/env node
-interface ParsedArgs {
-    projectRoot: string;
-    originRef?: string;
-    staged: boolean;
-    quiet: boolean;
-    planId?: string;
-    pr?: string;
-    repo?: string;
-    error?: string;
-}
-/** Parse verify-observable-scope 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-observable-scope.d.ts.map

package/dist/verify-observable-scope.js

@@ -1,110 +0,0 @@
-#!/usr/bin/env node
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { evaluateObservableScope } from "@deftai/directive-core/observable-scope";
-/** Parse verify-observable-scope CLI args. */
-export function parseArgs(argv) {
-    const parsed = { projectRoot: ".", staged: false, quiet: false };
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i];
-        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) {
-                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) {
-                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 === "--plan-id") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --plan-id: expected one argument" };
-            }
-            parsed.planId = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--plan-id=")) {
-            parsed.planId = arg.slice("--plan-id=".length);
-        }
-        else if (arg === "--pr") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --pr: expected one argument" };
-            }
-            parsed.pr = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--pr=")) {
-            parsed.pr = arg.slice("--pr=".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 === "--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;
-}
-/** 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_observable_scope: ${args.error}\n`);
-        return 2;
-    }
-    const result = evaluateObservableScope({
-        projectRoot: resolve(args.projectRoot),
-        originRef: args.originRef,
-        staged: args.staged,
-        quiet: args.quiet,
-        planId: args.planId,
-        pr: args.pr,
-        repo: args.repo,
-    });
-    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-observable-scope.js.map

package/dist/verify-operator-scope-limit.d.ts

@@ -1,17 +0,0 @@
-#!/usr/bin/env node
-interface ParsedArgs {
-    promptFile?: string;
-    prompt?: string;
-    surfacesFile?: string;
-    briefOut?: string;
-    artifactOut?: string;
-    projectRoot: string;
-    quiet: boolean;
-    error?: string;
-}
-/** Parse verify-operator-scope-limit CLI args. */
-export declare function parseArgs(argv: string[]): ParsedArgs;
-/** Run the gate and return the process exit code (0 clean/warn, 2 config). */
-export declare function run(argv: string[]): number;
-export {};
-//# sourceMappingURL=verify-operator-scope-limit.d.ts.map