pi-mission-control 0.0.0-dev

package/dist/state.d.ts

@@ -0,0 +1,265 @@
+/**
+ * State types and file helpers for mission-control
+ *
+ * Types for state.json, run.json, and file read/write operations.
+ * All tool mutations go through here.
+ */
+export type PhaseStatus = "pending" | "in_progress" | "done" | "removed";
+export type TaskStatus = "pending" | "in_progress" | "done" | "failed" | "removed";
+export type RunStatus = "in_progress" | "done" | "failed" | "paused";
+/**
+ * Volatile UI state - stored in .pi/mission-control/state.json
+ * Resets on every new pi session
+ */
+export interface State {
+    active_run_id: string | null;
+    current_phase: string;
+    current_status_message: string;
+}
+/**
+ * Task artifact paths
+ */
+export interface TaskPaths {
+    contract: string;
+    worker_output: string;
+    auditor_report: string;
+}
+/**
+ * Task definition - stored within Phase in run.json
+ */
+export interface Task {
+    id: string;
+    name: string;
+    status: TaskStatus;
+    started_at: string | null;
+    finish_at: string | null;
+    file: string;
+    paths: TaskPaths;
+}
+/**
+ * Phase definition - stored in run.json
+ */
+export interface Phase {
+    id: string;
+    name: string;
+    status: PhaseStatus;
+    started_at: string | null;
+    finish_at: string | null;
+    file: string;
+    tasks: Task[];
+}
+/**
+ * Artifact references in run.json
+ */
+export interface Artifacts {
+    requirements: string;
+    architecture: string;
+    validation: string;
+}
+/**
+ * Persistent run state - stored in .pi/mission-control/runs/<run-id>/run.json
+ */
+export interface Run {
+    run_id: string;
+    started_at: string;
+    finish_at: string | null;
+    status: RunStatus;
+    artifacts: Artifacts;
+    phases: Phase[];
+}
+export declare const defaultState: State;
+/**
+ * Get the project root (cwd)
+ */
+export declare function getProjectRoot(): string;
+/**
+ * Get the base mission-control directory path
+ */
+export declare function getMissionControlDir(): string;
+/**
+ * Get the state.json file path
+ */
+export declare function getStateFilePath(): string;
+/**
+ * Get the memory directory path
+ */
+export declare function getMemoryDir(): string;
+/**
+ * Get the long-term memory file path
+ */
+export declare function getLongTermMemoryPath(): string;
+/**
+ * Get the runs directory path
+ */
+export declare function getRunsDir(): string;
+/**
+ * Get a specific run directory path
+ */
+export declare function getRunDir(runId: string): string;
+/**
+ * Get the run.json file path for a specific run
+ */
+export declare function getRunFilePath(runId: string): string;
+/**
+ * Get the tasks directory path for a specific run
+ */
+export declare function getTasksDir(runId: string): string;
+/**
+ * Get a specific task directory path
+ */
+export declare function getTaskDir(runId: string, taskId: string): string;
+/**
+ * Ensure a directory exists (recursive)
+ */
+export declare function ensureDir(dirPath: string): void;
+/**
+ * Read and parse JSON file
+ */
+export declare function readJson<T>(filePath: string): T | null;
+/**
+ * Write JSON file (with pretty formatting)
+ */
+export declare function writeJson<T>(filePath: string, data: T): void;
+/**
+ * Read a text file
+ */
+export declare function readText(filePath: string): string | null;
+/**
+ * Write a text file
+ */
+export declare function writeText(filePath: string, content: string): void;
+/**
+ * Check if a file exists
+ */
+export declare function fileExists(filePath: string): boolean;
+/**
+ * Copy a file from source to destination (skip if exists when specified)
+ */
+export declare function copyFile(src: string, dest: string, skipIfExists?: boolean): boolean;
+/**
+ * Copy a directory recursively (skip existing files when specified)
+ * Returns count of files copied
+ */
+export declare function copyDir(src: string, dest: string, skipIfExists?: boolean): number;
+/**
+ * Read the current state.json
+ * Returns default state if file doesn't exist
+ */
+export declare function readState(): State;
+/**
+ * Write state.json
+ */
+export declare function writeState(state: State): void;
+/**
+ * Update specific fields in state.json
+ */
+export declare function updateState(updates: Partial<State>): State;
+/**
+ * Read a run.json file
+ */
+export declare function readRun(runId: string): Run | null;
+/**
+ * Write a run.json file
+ */
+export declare function writeRun(run: Run): void;
+/**
+ * Update specific fields in a run
+ */
+export declare function updateRun(runId: string, updates: Partial<Run>): Run | null;
+/**
+ * Get current ISO timestamp
+ */
+export declare function getTimestamp(): string;
+/**
+ * Generate a run ID from current timestamp
+ * Format: run-YYYYMMDD-HHmmss
+ */
+export declare function generateRunId(): string;
+/**
+ * Find a phase by ID in a run
+ */
+export declare function findPhase(run: Run, phaseId: string): Phase | undefined;
+/**
+ * Generate the next phase ID
+ */
+export declare function generatePhaseId(run: Run): string;
+/**
+ * Create a new phase
+ */
+export declare function createPhase(id: string, name: string, file: string): Phase;
+/**
+ * Add a phase to a run
+ */
+export declare function addPhaseToRun(run: Run, phase: Phase): Run;
+/**
+ * Update a phase in a run
+ */
+export declare function updatePhaseInRun(run: Run, phaseId: string, updates: Partial<Phase>): Run;
+/**
+ * Find a task by ID in a run (searches all phases)
+ */
+export declare function findTask(run: Run, taskId: string): {
+    phase: Phase;
+    task: Task;
+    phaseIndex: number;
+    taskIndex: number;
+} | null;
+/**
+ * Generate the next task ID for a phase
+ */
+export declare function generateTaskId(phase: Phase): string;
+/**
+ * Create a new task
+ */
+export declare function createTask(id: string, name: string, file: string): Task;
+/**
+ * Add a task to a phase within a run
+ */
+export declare function addTaskToRun(run: Run, phaseId: string, task: Task): Run;
+/**
+ * Update a task in a run
+ */
+export declare function updateTaskInRun(run: Run, taskId: string, updates: Partial<Task>): Run;
+/**
+ * Check if all tasks in a phase are done
+ */
+export declare function areAllTasksDone(phase: Phase): boolean;
+/**
+ * Check if all phases in a run are done
+ */
+export declare function areAllPhasesDone(run: Run): boolean;
+/**
+ * List all run IDs in the runs directory
+ */
+export declare function listRunIds(): string[];
+/**
+ * List all runs with their basic info
+ */
+export declare function listRuns(): Array<{
+    runId: string;
+    run: Run | null;
+}>;
+/**
+ * Check if mission-control has been scaffolded
+ */
+export declare function isScaffolded(): boolean;
+/**
+ * Create the initial run.json structure
+ */
+export declare function createInitialRun(runId: string): Run;
+/**
+ * Create the base mission-control directory structure
+ */
+export declare function createBaseStructure(): void;
+/**
+ * Create a new run directory structure
+ */
+export declare function createRunStructure(runId: string): void;
+/**
+ * Get the appropriate timestamp field to update based on status
+ */
+export declare function getTimestampForStatus(status: PhaseStatus | TaskStatus, currentStatus: PhaseStatus | TaskStatus): {
+    started_at?: string;
+    finish_at?: string;
+} | null;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"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"}