@codebakers/cli 3.7.2 → 3.8.0

package/dist/lib/engineering-state.d.ts

@@ -0,0 +1,269 @@
+/**
+ * ENGINEERING STATE PERSISTENCE
+ *
+ * Manages the .codebakers/ folder structure for local state persistence.
+ * This keeps the project state in sync between local and server.
+ *
+ * Folder structure:
+ * .codebakers/
+ *   project.json       - Main project configuration and scope
+ *   state.json         - Current build state (phase, progress, etc.)
+ *   graph.json         - Dependency graph
+ *   decisions/         - Agent decision log
+ *     001-scoping.json
+ *     002-architecture.json
+ *   artifacts/         - Generated documents
+ *     prd.md
+ *     tech-spec.md
+ *     api-docs.md
+ *   messages/          - Agent communication log
+ *     session-xxx.json
+ *   snapshots/         - Rollback points
+ *     snap-001/
+ */
+export interface ProjectConfig {
+    id: string;
+    name: string;
+    description: string;
+    projectHash: string;
+    scope: ProjectScope;
+    stack: StackConfig;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ProjectScope {
+    targetAudience: 'consumers' | 'businesses' | 'internal' | 'developers';
+    isFullBusiness: boolean;
+    needsMarketing: boolean;
+    needsAnalytics: boolean;
+    needsTeamFeatures: boolean;
+    needsAdminDashboard: boolean;
+    platforms: ('web' | 'mobile' | 'api')[];
+    hasRealtime: boolean;
+    hasPayments: boolean;
+    hasAuth: boolean;
+    hasFileUploads: boolean;
+    compliance: {
+        hipaa: boolean;
+        pci: boolean;
+        gdpr: boolean;
+        soc2: boolean;
+        coppa: boolean;
+    };
+    expectedUsers: 'small' | 'medium' | 'large' | 'enterprise';
+    launchTimeline: 'asap' | 'weeks' | 'months' | 'flexible';
+}
+export interface StackConfig {
+    framework: string;
+    database: string;
+    orm: string;
+    auth: string;
+    ui: string;
+    payments?: string;
+}
+export interface BuildState {
+    sessionId: string | null;
+    currentPhase: EngineeringPhase;
+    currentAgent: AgentRole;
+    isRunning: boolean;
+    gates: Record<EngineeringPhase, GateStatus>;
+    overallProgress: number;
+    lastActivity: string;
+    pendingApprovals: string[];
+    blockers: string[];
+}
+export type EngineeringPhase = 'scoping' | 'requirements' | 'architecture' | 'design_review' | 'implementation' | 'code_review' | 'testing' | 'security_review' | 'documentation' | 'staging' | 'launch';
+export type AgentRole = 'orchestrator' | 'pm' | 'architect' | 'engineer' | 'qa' | 'security' | 'documentation' | 'devops';
+export interface GateStatus {
+    status: 'pending' | 'in_progress' | 'passed' | 'failed' | 'skipped';
+    passedAt?: string;
+    failedReason?: string;
+    approvedBy?: string;
+    artifacts?: string[];
+}
+export interface DependencyNode {
+    id: string;
+    type: 'schema' | 'api' | 'component' | 'service' | 'page' | 'util' | 'config';
+    name: string;
+    filePath: string;
+    createdAt: string;
+    modifiedAt: string;
+    createdByFeature?: string;
+}
+export interface DependencyEdge {
+    id: string;
+    sourceId: string;
+    targetId: string;
+    type: 'import' | 'api-call' | 'db-query' | 'event' | 'config';
+}
+export interface DependencyGraph {
+    nodes: DependencyNode[];
+    edges: DependencyEdge[];
+}
+export interface AgentDecision {
+    id: string;
+    timestamp: string;
+    agent: AgentRole;
+    phase: EngineeringPhase;
+    decision: string;
+    reasoning: string;
+    alternatives: string[];
+    confidence: number;
+    reversible: boolean;
+    impact: 'low' | 'medium' | 'high' | 'critical';
+}
+export interface AgentMessage {
+    id: string;
+    timestamp: string;
+    fromAgent: AgentRole | 'user';
+    toAgent: AgentRole | 'user' | 'all';
+    messageType: 'request' | 'response' | 'review' | 'approval' | 'rejection' | 'question' | 'update' | 'handoff';
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+export declare class EngineeringStateManager {
+    private cwd;
+    private stateDir;
+    constructor(cwd?: string);
+    /**
+     * Initialize the .codebakers folder structure
+     */
+    init(): void;
+    /**
+     * Check if project is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get project hash from current directory
+     */
+    getProjectHash(): string;
+    /**
+     * Create a new project configuration
+     */
+    createProject(name: string, description: string, scope?: Partial<ProjectScope>): ProjectConfig;
+    /**
+     * Get project configuration
+     */
+    getProject(): ProjectConfig | null;
+    /**
+     * Save project configuration
+     */
+    saveProject(project: ProjectConfig): void;
+    /**
+     * Update project scope
+     */
+    updateScope(scope: Partial<ProjectScope>): ProjectConfig | null;
+    /**
+     * Initialize build state
+     */
+    private initializeState;
+    /**
+     * Get build state
+     */
+    getState(): BuildState | null;
+    /**
+     * Save build state
+     */
+    saveState(state: BuildState): void;
+    /**
+     * Update current phase
+     */
+    setPhase(phase: EngineeringPhase, agent: AgentRole): void;
+    /**
+     * Pass a gate
+     */
+    passGate(phase: EngineeringPhase, artifacts?: string[], approvedBy?: string): void;
+    /**
+     * Fail a gate
+     */
+    failGate(phase: EngineeringPhase, reason: string): void;
+    /**
+     * Get dependency graph
+     */
+    getGraph(): DependencyGraph;
+    /**
+     * Save dependency graph
+     */
+    saveGraph(graph: DependencyGraph): void;
+    /**
+     * Add a node to the graph
+     */
+    addNode(node: Omit<DependencyNode, 'id' | 'createdAt' | 'modifiedAt'>): DependencyNode;
+    /**
+     * Add an edge to the graph
+     */
+    addEdge(edge: Omit<DependencyEdge, 'id'>): DependencyEdge;
+    /**
+     * Find nodes affected by a change
+     */
+    findAffectedNodes(nodeId: string): {
+        direct: DependencyNode[];
+        transitive: DependencyNode[];
+    };
+    /**
+     * Record a decision
+     */
+    recordDecision(decision: Omit<AgentDecision, 'id' | 'timestamp'>): AgentDecision;
+    /**
+     * Get all decisions
+     */
+    getDecisions(): AgentDecision[];
+    /**
+     * Save an artifact (PRD, tech spec, etc.)
+     */
+    saveArtifact(name: string, content: string): void;
+    /**
+     * Get an artifact
+     */
+    getArtifact(name: string): string | null;
+    /**
+     * List all artifacts
+     */
+    listArtifacts(): string[];
+    /**
+     * Record a message
+     */
+    recordMessage(message: Omit<AgentMessage, 'id' | 'timestamp'>): AgentMessage;
+    /**
+     * Get messages for current session
+     */
+    getMessages(): AgentMessage[];
+    /**
+     * Detect the tech stack from package.json
+     */
+    private detectStack;
+    /**
+     * Get a summary of current engineering state
+     */
+    getSummary(): {
+        project: ProjectConfig | null;
+        state: BuildState | null;
+        graphStats: {
+            nodes: number;
+            edges: number;
+        };
+        decisions: number;
+        artifacts: string[];
+    };
+}
+/**
+ * Get the state manager for current directory
+ */
+export declare function getStateManager(cwd?: string): EngineeringStateManager;
+/**
+ * Check if engineering project exists in current directory
+ */
+export declare function hasEngineeringProject(cwd?: string): boolean;
+/**
+ * Quick summary of current project state
+ */
+export declare function getProjectSummary(cwd?: string): {
+    project: ProjectConfig | null;
+    state: BuildState | null;
+    graphStats: {
+        nodes: number;
+        edges: number;
+    };
+    decisions: number;
+    artifacts: string[];
+};