@deftai/directive 0.126.2 → 0.128.0

package/dist/verify-operator-scope-limit.js

@@ -1,285 +0,0 @@
-#!/usr/bin/env node
-/**
- * Warn-first operator scope-limit check (#4545).
- *
- * Seeds a hard ceiling from an operator prompt (closed lexicon) and lists
- * shipped surfaces not traceable to a recorded requirement line. Warn-first:
- * untraceable surfaces print WARN and exit 0; config errors exit 2.
- *
- * Default path always persists a durable ceiling artifact (or merges into
- * --brief-out). Without --surfaces-file, runs a default app/actions inventory;
- * empty inventory warns that surfaces were not checked (does not silent-skip).
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { applyCeilingToBrief, evaluateUntraceableSurfaces, inventoryDefaultSurfaces, OPERATOR_SCOPE_CEILING_ARTIFACT_REL, SURFACES_NOT_CHECKED_REMEDIATION, seedOperatorScopeCeiling, UNTRACEABLE_SURFACE_REMEDIATION, } from "@deftai/directive-core/operator-scope-limit";
-/** Parse verify-operator-scope-limit CLI args. */
-export function parseArgs(argv) {
-    const parsed = { quiet: false, projectRoot: "." };
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i];
-        if (arg === "--quiet") {
-            parsed.quiet = true;
-        }
-        else if (arg === "--prompt-file") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --prompt-file: expected one argument" };
-            }
-            parsed.promptFile = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--prompt-file=")) {
-            parsed.promptFile = arg.slice("--prompt-file=".length);
-        }
-        else if (arg === "--prompt") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --prompt: expected one argument" };
-            }
-            parsed.prompt = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--prompt=")) {
-            parsed.prompt = arg.slice("--prompt=".length);
-        }
-        else if (arg === "--surfaces-file") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --surfaces-file: expected one argument" };
-            }
-            parsed.surfacesFile = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--surfaces-file=")) {
-            parsed.surfacesFile = arg.slice("--surfaces-file=".length);
-        }
-        else if (arg === "--brief-out") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --brief-out: expected one argument" };
-            }
-            parsed.briefOut = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--brief-out=")) {
-            parsed.briefOut = arg.slice("--brief-out=".length);
-        }
-        else if (arg === "--artifact-out") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --artifact-out: expected one argument" };
-            }
-            parsed.artifactOut = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--artifact-out=")) {
-            parsed.artifactOut = arg.slice("--artifact-out=".length);
-        }
-        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;
-}
-function loadPrompt(args) {
-    if (typeof args.prompt === "string") {
-        return { ok: true, prompt: args.prompt };
-    }
-    if (typeof args.promptFile === "string" && args.promptFile.length > 0) {
-        try {
-            return { ok: true, prompt: readFileSync(resolve(args.promptFile), "utf8") };
-        }
-        catch (err) {
-            return {
-                ok: false,
-                detail: `failed to read --prompt-file: ${err instanceof Error ? err.message : String(err)}`,
-            };
-        }
-    }
-    return {
-        ok: false,
-        detail: "required: --prompt <text> or --prompt-file <path>",
-    };
-}
-function loadSurfacesFile(surfacesFile) {
-    try {
-        const raw = readFileSync(resolve(surfacesFile), "utf8");
-        const parsed = JSON.parse(raw);
-        if (!Array.isArray(parsed)) {
-            return { ok: false, detail: "--surfaces-file must be a JSON array" };
-        }
-        const surfaces = [];
-        for (const entry of parsed) {
-            if (entry === null || typeof entry !== "object" || Array.isArray(entry)) {
-                return { ok: false, detail: "--surfaces-file entries must be objects" };
-            }
-            const obj = entry;
-            if ((obj.kind !== "server-action" && obj.kind !== "route" && obj.kind !== "page") ||
-                typeof obj.id !== "string" ||
-                obj.id.trim().length === 0) {
-                return {
-                    ok: false,
-                    detail: "--surfaces-file entries need kind (server-action|route|page) and id",
-                };
-            }
-            surfaces.push({
-                kind: obj.kind,
-                id: obj.id,
-                path: typeof obj.path === "string" ? obj.path : undefined,
-            });
-        }
-        return { ok: true, surfaces };
-    }
-    catch (err) {
-        return {
-            ok: false,
-            detail: `failed to read --surfaces-file: ${err instanceof Error ? err.message : String(err)}`,
-        };
-    }
-}
-function writeJsonFile(path, value) {
-    try {
-        mkdirSync(dirname(path), { recursive: true });
-        writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`, "utf8");
-        return { ok: true };
-    }
-    catch (err) {
-        return {
-            ok: false,
-            detail: `failed to write ${path}: ${err instanceof Error ? err.message : String(err)}`,
-        };
-    }
-}
-function loadExistingBrief(path) {
-    if (!existsSync(path))
-        return null;
-    try {
-        const raw = JSON.parse(readFileSync(path, "utf8"));
-        if (raw === null || typeof raw !== "object" || Array.isArray(raw))
-            return null;
-        return raw;
-    }
-    catch {
-        return null;
-    }
-}
-/** Persist ceiling: explicit outs, else default durable artifact under project root. */
-function persistCeiling(input) {
-    const { projectRoot, ceiling, artifactOut, briefOut } = input;
-    let durablePath = null;
-    if (typeof artifactOut === "string" && artifactOut.length > 0) {
-        const path = resolve(artifactOut);
-        const wrote = writeJsonFile(path, ceiling);
-        if (!wrote.ok)
-            return wrote;
-        durablePath = path;
-    }
-    if (typeof briefOut === "string" && briefOut.length > 0) {
-        const path = resolve(briefOut);
-        const existing = loadExistingBrief(path);
-        const base = existing ??
-            {
-                xBRIEFInfo: { version: "0.8" },
-                plan: { status: "draft", metadata: {} },
-            };
-        // Merge/add ceiling onto existing proposed/active brief — never replace scope.
-        const merged = applyCeilingToBrief(base, ceiling);
-        const wrote = writeJsonFile(path, merged);
-        if (!wrote.ok)
-            return wrote;
-        durablePath = path;
-    }
-    if (durablePath === null) {
-        const path = resolve(projectRoot, OPERATOR_SCOPE_CEILING_ARTIFACT_REL);
-        const wrote = writeJsonFile(path, ceiling);
-        if (!wrote.ok)
-            return wrote;
-        durablePath = path;
-    }
-    return { ok: true, durablePath };
-}
-/** Run the gate and return the process exit code (0 clean/warn, 2 config). */
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`verify_operator_scope_limit: ${args.error}\n`);
-        return 2;
-    }
-    const projectRoot = resolve(args.projectRoot);
-    const promptLoad = loadPrompt(args);
-    if (!promptLoad.ok) {
-        process.stderr.write(`verify_operator_scope_limit: ${promptLoad.detail}\n`);
-        return 2;
-    }
-    const seeded = seedOperatorScopeCeiling(promptLoad.prompt, null);
-    if (!seeded.ok) {
-        process.stderr.write(`verify_operator_scope_limit: ${seeded.detail}\n`);
-        // No phrase is a returned miss — still exit 2 so callers know ceiling was not recorded.
-        return 2;
-    }
-    const persisted = persistCeiling({
-        projectRoot,
-        ceiling: seeded.ceiling,
-        artifactOut: args.artifactOut,
-        briefOut: args.briefOut,
-    });
-    if (!persisted.ok) {
-        process.stderr.write(`verify_operator_scope_limit: ${persisted.detail}\n`);
-        return 2;
-    }
-    let surfaces = [];
-    let surfacesSource = "default-inventory";
-    if (typeof args.surfacesFile === "string" && args.surfacesFile.length > 0) {
-        const surfacesLoad = loadSurfacesFile(args.surfacesFile);
-        if (!surfacesLoad.ok) {
-            process.stderr.write(`verify_operator_scope_limit: ${surfacesLoad.detail}\n`);
-            return 2;
-        }
-        surfaces = surfacesLoad.surfaces;
-        surfacesSource = "surfaces-file";
-    }
-    else {
-        surfaces = inventoryDefaultSurfaces(projectRoot);
-        surfacesSource = "default-inventory";
-    }
-    if (surfaces.length === 0) {
-        if (!args.quiet) {
-            process.stdout.write(`operator-scope-limit WARN: surfaces were not checked ` +
-                `(source=${surfacesSource}; durable=${persisted.durablePath}; ` +
-                `phrase=${JSON.stringify(seeded.ceiling.matchedPhrase)}; ` +
-                `requirements=${seeded.ceiling.requirementLines.length}). ` +
-                `Remediation: ${SURFACES_NOT_CHECKED_REMEDIATION}\n`);
-        }
-        // Warn-first: missing inventory does not fail the process.
-        return 0;
-    }
-    const result = evaluateUntraceableSurfaces({
-        requirementLines: seeded.ceiling.requirementLines,
-        surfaces,
-    });
-    if (!args.quiet) {
-        process.stdout.write(`${result.message} (durable=${persisted.durablePath}; source=${surfacesSource})\n`);
-        if (result.severity === "warn") {
-            process.stdout.write(`Remediation: ${UNTRACEABLE_SURFACE_REMEDIATION}\n`);
-        }
-    }
-    // Warn-first: untraceable surfaces do not fail the process.
-    return 0;
-}
-if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
-    process.exit(run(process.argv.slice(2)));
-}
-//# sourceMappingURL=verify-operator-scope-limit.js.map

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

@@ -1,17 +0,0 @@
-#!/usr/bin/env node
-interface ParsedArgs {
-    projectRoot: string;
-    repo: string | null;
-    issue: number | null;
-    quiet: boolean;
-    skipGh: boolean;
-    changedOnly: boolean;
-    baseRef: string | null;
-    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

@@ -1,135 +0,0 @@
-#!/usr/bin/env node
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { evaluate } from "@deftai/directive-core/orphan-active";
-function parseIssueNumber(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-orphan-active CLI args. */
-export function parseArgs(argv) {
-    const parsed = {
-        projectRoot: ".",
-        repo: null,
-        issue: null,
-        quiet: false,
-        skipGh: false,
-        changedOnly: false,
-        baseRef: null,
-    };
-    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 === "--changed-only") {
-            parsed.changedOnly = true;
-        }
-        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 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 === "--issue") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --issue: expected one argument" };
-            }
-            const issue = parseIssueNumber(value);
-            if (issue === null) {
-                return { ...parsed, error: `argument --issue: expected a positive integer, got ${value}` };
-            }
-            parsed.issue = issue;
-            i += 1;
-        }
-        else if (arg?.startsWith("--issue=")) {
-            const value = arg.slice("--issue=".length);
-            const issue = parseIssueNumber(value);
-            if (issue === null) {
-                return { ...parsed, error: `argument --issue: expected a positive integer, got ${value}` };
-            }
-            parsed.issue = issue;
-        }
-        else {
-            return { ...parsed, error: `unrecognized argument: ${arg}` };
-        }
-    }
-    // The two scopes answer different questions; silently preferring one would
-    // hide which residue the run actually covered (#3893).
-    if (parsed.changedOnly && parsed.issue !== null) {
-        return {
-            ...parsed,
-            error: "--changed-only and --issue are mutually exclusive: --issue is the after-merge " +
-                "one-origin scan, --changed-only is the merge-gate candidate scan",
-        };
-    }
-    if (parsed.baseRef !== null && !parsed.changedOnly) {
-        return { ...parsed, error: "--base-ref requires --changed-only" };
-    }
-    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,
-        issue: args.issue,
-        changedOnly: args.changedOnly,
-        baseRef: args.baseRef,
-    });
-    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-ownership.d.ts

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-export interface VerifyOwnershipArgs {
-    projectRoot: string;
-    json: boolean;
-    owner: string | null;
-    error?: string;
-}
-export declare function parseArgs(argv: readonly string[]): VerifyOwnershipArgs;
-export declare function run(argv: readonly string[]): number;
-//# sourceMappingURL=verify-ownership.d.ts.map

package/dist/verify-ownership.js

@@ -1,90 +0,0 @@
-#!/usr/bin/env node
-/**
- * verify:ownership / verify-ownership (#1617)
- * Fail-closed check for WSL root-runtime ownership mismatch.
- */
-import { resolve } from "node:path";
-import { assertProtectedMutationOwnership, evaluateWslOwnershipGuard, ownershipGuardToDict, } from "@deftai/directive-core/platform";
-import { isDirectEntrypoint } from "./entrypoint.js";
-export function parseArgs(argv) {
-    const parsed = {
-        projectRoot: ".",
-        json: false,
-        owner: null,
-    };
-    for (let i = 0; i < argv.length; i += 1) {
-        const arg = argv[i];
-        if (arg === "--") {
-        }
-        else if (arg === "--json") {
-            parsed.json = 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 === "--owner") {
-            const value = argv[i + 1];
-            if (value === undefined) {
-                return { ...parsed, error: "argument --owner: expected uid:gid" };
-            }
-            parsed.owner = value;
-            i += 1;
-        }
-        else if (arg?.startsWith("--owner=")) {
-            parsed.owner = arg.slice("--owner=".length);
-        }
-        else if (arg === "--help" || arg === "-h") {
-            return { ...parsed, error: "__help__" };
-        }
-        else {
-            return { ...parsed, error: `unrecognized argument: ${arg}` };
-        }
-    }
-    return parsed;
-}
-const HELP = "usage: deft verify:ownership [--project-root PATH] [--owner uid:gid] [--json]\n" +
-    "Fail closed when WSL root runtime can create root-owned project files (#1617).\n" +
-    "Native Windows/macOS always pass. Mount-pinned DrvFs/9p without metadata passes.\n";
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error === "__help__") {
-        process.stdout.write(HELP);
-        return 0;
-    }
-    if (args.error !== undefined) {
-        process.stderr.write(`verify:ownership: ${args.error}\n`);
-        return 2;
-    }
-    const projectRoot = resolve(args.projectRoot);
-    const seams = { projectRoot, explicitOwner: args.owner };
-    const gate = assertProtectedMutationOwnership(seams);
-    if (args.json) {
-        process.stdout.write(`${JSON.stringify(ownershipGuardToDict(gate.verdict), null, 2)}\n`);
-    }
-    else {
-        process.stdout.write(`${gate.message}\n`);
-    }
-    if (!gate.ok)
-        return gate.exitCode;
-    // Also surface soft warn / override without failing when not blocked.
-    const soft = evaluateWslOwnershipGuard(seams);
-    if (soft.status === "warn" || soft.status === "exempt-override") {
-        if (!args.json) {
-            for (const line of soft.sessionWarnLines)
-                process.stderr.write(`${line}\n`);
-        }
-    }
-    return 0;
-}
-if (isDirectEntrypoint(import.meta.url)) {
-    process.exit(run(process.argv.slice(2)));
-}
-//# sourceMappingURL=verify-ownership.js.map

package/dist/verify-persisted-planning-narratives.d.ts

@@ -1,12 +0,0 @@
-#!/usr/bin/env node
-interface ParsedArgs {
-    projectRoot: string;
-    checkConjunct: boolean;
-    error?: string;
-}
-/** Parse verify:persisted-planning-narratives CLI args (#5176). */
-export declare function parseArgs(argv: string[]): ParsedArgs;
-/** Run the Prefer-A first-ship planning-narrative bar. */
-export declare function run(argv: string[]): number;
-export {};
-//# sourceMappingURL=verify-persisted-planning-narratives.d.ts.map

package/dist/verify-persisted-planning-narratives.js

@@ -1,82 +0,0 @@
-#!/usr/bin/env node
-/**
- * CLI for verify:persisted-planning-narratives (#5176 Prefer-A).
- *
- * Default mode is the unconditional setup Phase 2 bar. `--check-conjunct`
- * mirrors the in-process deft check Prefer-A gate (marker present/unreadable +
- * empty Overview/tech stack → refuse; missing PD / no marker → pass) so
- * Taskfile aggregates like check:merge / check:consumer cannot bypass it.
- */
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { checkRejectsEmptyPlanningNarratives, evaluateCheckPersistedPlanningNarratives, } from "@deftai/directive-core/check";
-import { evaluatePersistedPlanningNarratives } from "@deftai/directive-core/project";
-/** Parse verify:persisted-planning-narratives CLI args (#5176). */
-export function parseArgs(argv) {
-    const parsed = { projectRoot: ".", checkConjunct: 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 === "--check-conjunct") {
-            parsed.checkConjunct = true;
-        }
-        else if (arg === "--help" || arg === "-h") {
-            process.stdout.write("usage: verify:persisted-planning-narratives [--project-root PATH] [--check-conjunct]\n\n" +
-                "Fail closed when every tracked PROJECT-DEFINITION planning narrative\n" +
-                "(Overview + tech stack) is empty/whitespace (#5176 Prefer-A).\n" +
-                "Default: unconditional setup Phase 2 bar (missing PD → exit 2).\n" +
-                "--check-conjunct: Taskfile/check Prefer-A mirror (marker + empty →\n" +
-                "refuse; missing PD / no marker → pass). Reuse deft project:write-narratives.\n");
-            return parsed;
-        }
-        else {
-            return { ...parsed, error: `unrecognized argument: ${arg}` };
-        }
-    }
-    return parsed;
-}
-/** Run the Prefer-A first-ship planning-narrative bar. */
-export function run(argv) {
-    const args = parseArgs(argv);
-    if (args.error !== undefined) {
-        process.stderr.write(`verify:persisted-planning-narratives: ${args.error}\n`);
-        return 2;
-    }
-    const projectRoot = resolve(args.projectRoot);
-    if (args.checkConjunct) {
-        const planning = evaluateCheckPersistedPlanningNarratives(projectRoot);
-        if (checkRejectsEmptyPlanningNarratives(planning.narratives, planning.productMutation)) {
-            process.stderr.write(`${planning.narratives.message}\n`);
-            return 1;
-        }
-        if (planning.narratives.ok) {
-            process.stdout.write(`${planning.narratives.message}\n`);
-        }
-        else {
-            process.stdout.write("verify:persisted-planning-narratives --check-conjunct: pass " +
-                `(${planning.narratives.cause}; Prefer-A check conjunct does not refuse)\n`);
-        }
-        return 0;
-    }
-    const result = evaluatePersistedPlanningNarratives(projectRoot);
-    if (result.ok) {
-        process.stdout.write(`${result.message}\n`);
-        return 0;
-    }
-    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-persisted-planning-narratives.js.map

package/dist/verify-plan-sequence.d.ts

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-import { type PlanTargetKind } from "@deftai/directive-core/plan-sequence";
-export interface Parsed {
-    projectRoot: string;
-    targetKind: PlanTargetKind | null;
-    target: string | null;
-    emitJson: boolean;
-    /** Typed `--help` / `-h` (#4203); main() prints usage on stdout and exits 0. */
-    help?: boolean;
-    error?: string;
-}
-export declare function parseArgs(argv: string[]): Parsed;
-export declare function main(argv?: string[]): number;
-//# sourceMappingURL=verify-plan-sequence.d.ts.map