@unbrained/pm-cli 2026.5.14 → 2026.5.24

package/dist/cli/commands/plan.d.ts

@@ -0,0 +1,121 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+import type { DependencyKind, PlanDecision, PlanDiscovery, PlanHarness, PlanMode, PlanStep, PlanStepStatus, PlanValidationCheck } from "../../types/index.js";
+export declare const PLAN_SUBCOMMANDS: readonly ["create", "show", "add-step", "update-step", "complete-step", "block-step", "reorder-step", "remove-step", "link", "unlink", "decision", "discovery", "validation", "resume", "approve", "materialize"];
+export type PlanSubcommand = (typeof PLAN_SUBCOMMANDS)[number];
+export declare const PLAN_SHOW_DEPTH_VALUES: readonly ["brief", "standard", "deep"];
+export type PlanShowDepth = (typeof PLAN_SHOW_DEPTH_VALUES)[number];
+export interface PlanCommandOptions {
+    title?: string;
+    description?: string;
+    scope?: string;
+    parent?: string;
+    related?: string | string[];
+    blocks?: string | string[];
+    blockedBy?: string | string[];
+    harness?: string;
+    mode?: string;
+    resumeContext?: string;
+    tags?: string;
+    priority?: string;
+    body?: string;
+    claim?: boolean;
+    fromSearch?: string;
+    stepTitle?: string;
+    stepBody?: string;
+    stepOwner?: string;
+    stepStatus?: string;
+    stepEvidence?: string;
+    stepBlockedReason?: string;
+    stepReplacement?: string;
+    dependsOn?: string | string[];
+    link?: string | string[];
+    linkKind?: string;
+    linkNote?: string;
+    promoteToItemDep?: boolean;
+    allowMultipleActive?: boolean;
+    file?: string | string[];
+    test?: string | string[];
+    doc?: string | string[];
+    decisionText?: string;
+    decision?: string;
+    decisionRationale?: string;
+    decisionEvidence?: string;
+    discoveryText?: string;
+    discovery?: string;
+    validationText?: string;
+    validation?: string;
+    validationCommand?: string;
+    validationExpected?: string;
+    depth?: string;
+    fields?: string;
+    steps?: string;
+    materializeType?: string;
+    materializeParent?: string;
+    materializeTags?: string;
+    author?: string;
+    message?: string;
+    force?: boolean;
+}
+export interface PlanCommandResult {
+    action: PlanSubcommand;
+    plan: PlanResultPlan;
+    step?: PlanStep;
+    current_step?: PlanStep | undefined;
+    next_actions?: string[];
+    materialized?: {
+        id: string;
+        type: string;
+        from_step: string;
+    }[];
+    warnings: string[];
+    generated_at: string;
+}
+export interface PlanResultPlan {
+    id: string;
+    title: string;
+    status: string;
+    mode: PlanMode;
+    scope?: string;
+    harness?: PlanHarness;
+    parent?: string;
+    resume_context?: string;
+    steps_summary: PlanStepSummary;
+    current_step?: {
+        id: string;
+        order: number;
+        title: string;
+        status: PlanStepStatus;
+    } | undefined;
+    blocked_steps?: {
+        id: string;
+        order: number;
+        title: string;
+        blocked_reason?: string;
+    }[];
+    steps?: PlanStep[];
+    decisions?: PlanDecision[];
+    discoveries?: PlanDiscovery[];
+    validation?: PlanValidationCheck[];
+    linked_items?: {
+        id: string;
+        kind: DependencyKind;
+    }[];
+}
+export interface PlanStepSummary {
+    total: number;
+    pending: number;
+    in_progress: number;
+    blocked: number;
+    completed: number;
+    skipped: number;
+    superseded: number;
+}
+export interface PlanDispatchInput {
+    subcommand: PlanSubcommand;
+    id?: string;
+    stepRef?: string;
+    reorderTo?: number;
+    options: PlanCommandOptions;
+    global: GlobalOptions;
+}
+export declare function runPlan(input: PlanDispatchInput): Promise<PlanCommandResult>;