@hongmaple0820/scale-engine 0.12.3 → 0.14.0

package/dist/workflow/WorkflowArtifactWriter.js

@@ -0,0 +1,241 @@
+// SCALE Engine — Workflow Artifact Writer
+// 将工作流各阶段结果写入标准化 JSON 文件，供 Gate 系统验证
+// 设计参考：工作流优化方案 — "内容 + 执行 + 检查" 三者闭环
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { logger } from '../core/logger.js';
+// ============================================================================
+// Artifact Writer
+// ============================================================================
+export class WorkflowArtifactWriter {
+    constructor(scaleDir = '.scale') {
+        this.stateDir = join(scaleDir, 'state');
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Ensure directory
+    // ─────────────────────────────────────────────────────────────
+    ensureDir() {
+        if (!existsSync(this.stateDir)) {
+            mkdirSync(this.stateDir, { recursive: true });
+        }
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Explore Artifact
+    // ─────────────────────────────────────────────────────────────
+    /** Write explore result to .scale/state/explore.json */
+    writeExploreResult(result) {
+        this.ensureDir();
+        const filePath = join(this.stateDir, 'explore.json');
+        writeFileSync(filePath, JSON.stringify(result, null, 2), 'utf-8');
+        this.updateCurrentState({
+            phase: 'explore',
+            exploredFiles: result.files,
+            fileCount: result.fileCount,
+            mainContradiction: result.mainContradiction,
+        });
+        logger.info({ files: result.fileCount, contradiction: result.mainContradiction }, 'Explore artifact written');
+    }
+    /** Read explore artifact from .scale/state/explore.json */
+    readExploreResult() {
+        return this.readJson(join(this.stateDir, 'explore.json'));
+    }
+    /** Check if explore artifact exists and is valid */
+    hasValidExploreResult(minFiles = 3) {
+        const artifact = this.readExploreResult();
+        if (!artifact)
+            return false;
+        return artifact.fileCount >= minFiles && artifact.mainContradiction.length > 0;
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Plan Artifact
+    // ─────────────────────────────────────────────────────────────
+    /** Write plan result to .scale/state/plan-{planId}.json */
+    writePlanResult(result) {
+        this.ensureDir();
+        const filePath = join(this.stateDir, `plan-${result.planId}.json`);
+        writeFileSync(filePath, JSON.stringify(result, null, 2), 'utf-8');
+        this.updateCurrentState({
+            phase: 'plan',
+            lastSpecId: result.specId || undefined,
+            lastPlanId: result.planId,
+        });
+        logger.info({ planId: result.planId, verdict: result.verdict }, 'Plan artifact written');
+    }
+    /** Read plan artifact by ID */
+    readPlanResult(planId) {
+        return this.readJson(join(this.stateDir, `plan-${planId}.json`));
+    }
+    /** Read the most recent plan artifact */
+    readLatestPlanResult() {
+        const planFiles = this.listFiles('plan-');
+        if (planFiles.length === 0)
+            return null;
+        // Sort by timestamp in filename, take latest
+        const sorted = planFiles.sort().reverse();
+        return this.readJson(join(this.stateDir, sorted[0]));
+    }
+    /** Check if a valid plan artifact exists */
+    hasValidPlanResult() {
+        const artifact = this.readLatestPlanResult();
+        if (!artifact)
+            return false;
+        return artifact.hasBoundaryAnalysis && artifact.hasRollbackStrategy;
+    }
+    // ─────────────────────────────────────────────────────────────
+    // TDD Evidence
+    // ─────────────────────────────────────────────────────────────
+    /** Write TDD evidence to .scale/state/tdd-{taskId}.json */
+    writeTDDEvidence(evidence) {
+        this.ensureDir();
+        const filePath = join(this.stateDir, `tdd-${evidence.taskId}.json`);
+        writeFileSync(filePath, JSON.stringify(evidence, null, 2), 'utf-8');
+        this.updateCurrentState({
+            phase: 'verify',
+            lastTaskId: evidence.taskId,
+        });
+        logger.info({ taskId: evidence.taskId }, 'TDD evidence written');
+    }
+    /** Read TDD evidence by task ID */
+    readTDDEvidence(taskId) {
+        return this.readJson(join(this.stateDir, `tdd-${taskId}.json`));
+    }
+    /** Read the most recent TDD evidence */
+    readLatestTDDEvidence() {
+        const tddFiles = this.listFiles('tdd-');
+        if (tddFiles.length === 0)
+            return null;
+        const sorted = tddFiles.sort().reverse();
+        return this.readJson(join(this.stateDir, sorted[0]));
+    }
+    /** Check if valid TDD evidence exists for a task */
+    hasValidTDDEvidence(taskId) {
+        const artifact = taskId
+            ? this.readTDDEvidence(taskId)
+            : this.readLatestTDDEvidence();
+        if (!artifact)
+            return false;
+        return artifact.red && artifact.green && artifact.refactor && artifact.testFirst;
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Checkpoint
+    // ─────────────────────────────────────────────────────────────
+    /** Write checkpoint to .scale/state/checkpoint.json */
+    writeCheckpoint(data) {
+        this.ensureDir();
+        const filePath = join(this.stateDir, 'checkpoint.json');
+        writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf-8');
+        if (this.isWorkflowPhase(data.phase)) {
+            this.updateCurrentState({ phase: data.phase });
+        }
+        logger.info({ phase: data.phase }, 'Checkpoint written');
+    }
+    /** Read checkpoint */
+    readCheckpoint() {
+        return this.readJson(join(this.stateDir, 'checkpoint.json'));
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Generic Helpers
+    // ─────────────────────────────────────────────────────────────
+    /** Clear all artifacts (for testing or reset) */
+    clearAll() {
+        if (!existsSync(this.stateDir))
+            return;
+        const files = readdirSync(this.stateDir);
+        for (const file of files) {
+            if (file.endsWith('.json')) {
+                unlinkSync(join(this.stateDir, file));
+            }
+        }
+        logger.info('All workflow artifacts cleared');
+    }
+    /** Get state directory path */
+    getStateDir() { return this.stateDir; }
+    /** Write authoritative workflow state to .scale/state/current.json */
+    writeCurrentState(state) {
+        this.ensureDir();
+        const normalized = this.normalizeState(state);
+        writeFileSync(join(this.stateDir, 'current.json'), JSON.stringify(normalized, null, 2), 'utf-8');
+    }
+    /** Read authoritative workflow state from .scale/state/current.json */
+    readCurrentState() {
+        return this.readJson(join(this.stateDir, 'current.json'));
+    }
+    /** Merge a patch into .scale/state/current.json. */
+    updateCurrentState(patch) {
+        const current = this.readCurrentState();
+        const next = this.normalizeState({
+            ...(current ?? this.createDefaultState()),
+            ...patch,
+            updatedAt: patch.updatedAt ?? new Date().toISOString(),
+        });
+        this.writeCurrentState(next);
+        return next;
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Private Helpers
+    // ─────────────────────────────────────────────────────────────
+    readJson(filePath) {
+        if (!existsSync(filePath))
+            return null;
+        try {
+            const content = readFileSync(filePath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (e) {
+            logger.warn({ path: filePath, error: e.message }, 'Failed to read artifact');
+            return null;
+        }
+    }
+    listFiles(prefix) {
+        if (!existsSync(this.stateDir))
+            return [];
+        return readdirSync(this.stateDir)
+            .filter(f => f.startsWith(prefix) && f.endsWith('.json'));
+    }
+    createDefaultState() {
+        return {
+            schemaVersion: 1,
+            taskId: `task-${Date.now()}`,
+            level: 'M',
+            phase: 'define',
+            exploredFiles: [],
+            fileCount: 0,
+            mainContradiction: '',
+            completedGates: [],
+            openTasks: [],
+            filesModified: [],
+            updatedAt: new Date().toISOString(),
+        };
+    }
+    normalizeState(state) {
+        return {
+            schemaVersion: 1,
+            taskId: state.taskId || `task-${Date.now()}`,
+            level: state.level ?? 'M',
+            phase: state.phase ?? 'define',
+            artifactsDir: state.artifactsDir,
+            exploredFiles: state.exploredFiles ?? [],
+            fileCount: state.fileCount ?? state.exploredFiles?.length ?? 0,
+            mainContradiction: state.mainContradiction ?? '',
+            completedGates: state.completedGates ?? [],
+            openTasks: state.openTasks ?? [],
+            filesModified: state.filesModified ?? [],
+            skillIntents: state.skillIntents ?? [],
+            skillRoutingMode: state.skillRoutingMode,
+            skillPlanRequired: state.skillPlanRequired,
+            skillPlanPath: state.skillPlanPath,
+            requiredSkills: state.requiredSkills ?? [],
+            recommendedSkills: state.recommendedSkills ?? [],
+            requiredSkillArtifacts: state.requiredSkillArtifacts ?? [],
+            requiredSkillVerification: state.requiredSkillVerification ?? [],
+            lastSpecId: state.lastSpecId,
+            lastPlanId: state.lastPlanId,
+            lastTaskId: state.lastTaskId,
+            updatedAt: state.updatedAt ?? new Date().toISOString(),
+        };
+    }
+    isWorkflowPhase(phase) {
+        return ['define', 'explore', 'plan', 'build', 'verify', 'review', 'ship', 'done'].includes(phase);
+    }
+}
+//# sourceMappingURL=WorkflowArtifactWriter.js.map

package/dist/workflow/WorkflowArtifactWriter.js.map

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

package/dist/workflow/WorkflowEngine.d.ts

@@ -9,12 +9,31 @@ import { SocraticQuestioner } from './cognitive/SocraticQuestioner.js';
 import { RalphEngine, PRDManager } from './execution/RalphEngine.js';
 import { UltraworkEngine } from './execution/UltraworkEngine.js';
 import { KarpathyEvaluator } from './quality/KarpathyEvaluator.js';
-import type { PRDDocument, UserStory, TaskDefinition, SocraticSession } from './types.js';
+import { WorkflowArtifactWriter } from './WorkflowArtifactWriter.js';
+import type { PRDDocument, UserStory, TaskDefinition, GateStage, SocraticSession, KarpathyCheck } from './types.js';
 export interface WorkflowEngineConfig {
     eventBus: IEventBus;
     capabilityRegistry?: ICapabilityRegistry;
     skillRegistry?: ISkillRegistry;
     verificationCommands?: VerificationCommandConfig;
+    scaleDir?: string;
+}
+export interface ExploreOptions {
+    files?: string[];
+    mainContradiction?: string;
+    persistArtifact?: boolean;
+    runGate?: boolean;
+}
+export interface PlanOptions {
+    planId?: string;
+    specId?: string;
+    rollbackStrategy?: string;
+    modules?: string[];
+    persistArtifact?: boolean;
+    runGate?: boolean;
+}
+export interface VerifyOptions extends VerificationCommandConfig {
+    gates?: GateStage[];
 }
 export declare class WorkflowEngine {
     private eventBus;
@@ -29,24 +48,25 @@ export declare class WorkflowEngine {
     private prdManager;
     private modelRouter;
     private karpathyEvaluator;
+    private artifactWriter;
     constructor(config: WorkflowEngineConfig);
-    explore(requirement: string): Promise<{
+    explore(requirement: string, options?: ExploreOptions): Promise<{
         ambiguityScore: number;
         gateResult: unknown;
         socraticSession?: SocraticSession;
     }>;
     refineRequirement(session: SocraticSession, questionId: string, answer: string): SocraticSession;
     getNextQuestion(session: SocraticSession): import('./types.js').SocraticQuestion | null;
-    plan(requirement: string): Promise<unknown>;
+    plan(requirement: string, options?: PlanOptions): Promise<unknown>;
     build(tasks: TaskDefinition[]): Promise<Map<string, unknown>>;
-    verify(commandOverrides?: VerificationCommandConfig): Promise<import('./types.js').GateResult[]>;
+    verify(commandOverrides?: VerifyOptions): Promise<import('./types.js').GateResult[]>;
     executePRD(title: string, stories: UserStory[]): Promise<PRDDocument>;
     checkKarpathy(context: {
         hypothesesListed: boolean;
         hasExtraFeatures: boolean;
         changesTraceable: boolean;
         hasVerifiableGoal: boolean;
-    }): unknown;
+    }): KarpathyCheck[];
     generateDeliveryReport(): string;
     executeSkill(skillId: string, input: Record<string, unknown>): Promise<unknown>;
     executeMCPCapability(toolName: string, input: Record<string, unknown>): Promise<unknown>;
@@ -59,4 +79,5 @@ export declare class WorkflowEngine {
     getUltraworkEngine(): UltraworkEngine;
     getPRDManager(): PRDManager;
     getKarpathyEvaluator(): KarpathyEvaluator;
+    getArtifactWriter(): WorkflowArtifactWriter;
 }

package/dist/workflow/WorkflowEngine.js

@@ -7,13 +7,17 @@ import { SocraticQuestioner } from './cognitive/SocraticQuestioner.js';
 import { RalphEngine, PRDManager } from './execution/RalphEngine.js';
 import { UltraworkEngine, ModelRouter } from './execution/UltraworkEngine.js';
 import { KarpathyEvaluator } from './quality/KarpathyEvaluator.js';
+import { WorkflowArtifactWriter } from './WorkflowArtifactWriter.js';
 export class WorkflowEngine {
     constructor(config) {
         this.eventBus = config.eventBus;
         this.capabilityRegistry = config.capabilityRegistry;
         this.skillRegistry = config.skillRegistry;
+        // Initialize artifact writer (shared with GateSystem)
+        const scaleDir = config.scaleDir ?? '.scale';
+        this.artifactWriter = new WorkflowArtifactWriter(scaleDir);
         // Initialize workflow modules
-        this.gateSystem = new GateSystem(this.eventBus, config.verificationCommands);
+        this.gateSystem = new GateSystem(this.eventBus, config.verificationCommands, this.artifactWriter);
         this.ambiguityScorer = new AmbiguityScorer();
         this.consensusPlanner = new ConsensusPlanner(this.eventBus);
         this.socraticQuestioner = new SocraticQuestioner(this.eventBus);
@@ -24,9 +28,7 @@ export class WorkflowEngine {
         this.karpathyEvaluator = new KarpathyEvaluator();
     }
     // Phase 1: Exploration with Gate G1
-    async explore(requirement) {
-        // G1: Exploration gate
-        const gateResult = await this.gateSystem.executeGate('G1');
+    async explore(requirement, options = {}) {
         // Analyze requirement ambiguity
         const ambiguityResult = this.ambiguityScorer.analyzeRequirement(requirement);
         // If ambiguity > 20%, start Socratic session
@@ -34,6 +36,19 @@ export class WorkflowEngine {
         if (ambiguityResult.requiresQuestioning) {
             socraticSession = this.socraticQuestioner.startSession(requirement, ambiguityResult);
         }
+        const files = options.files ?? [];
+        const mainContradiction = options.mainContradiction ?? '';
+        if (options.persistArtifact !== false) {
+            this.artifactWriter.writeExploreResult({
+                timestamp: new Date().toISOString(),
+                files,
+                fileCount: files.length,
+                mainContradiction,
+                ambiguityScore: ambiguityResult.totalScore,
+                socraticCompleted: !ambiguityResult.requiresQuestioning
+            });
+        }
+        const gateResult = options.runGate === false ? undefined : await this.gateSystem.executeGate('G1');
         return {
             ambiguityScore: ambiguityResult.totalScore,
             gateResult,
@@ -60,11 +75,24 @@ export class WorkflowEngine {
         return this.socraticQuestioner.askNextQuestion(session);
     }
     // Phase 2: Planning with Consensus
-    async plan(requirement) {
+    async plan(requirement, options = {}) {
         // Run consensus planner
         const consensusResult = await this.consensusPlanner.execute(requirement);
-        // G2: Planning gate (if L-level task)
-        if (consensusResult.viableOptions.length > 1) {
+        const planId = options.planId ?? `engine-${Date.now()}`;
+        if (options.persistArtifact !== false) {
+            this.artifactWriter.writePlanResult({
+                timestamp: new Date().toISOString(),
+                planId,
+                specId: options.specId ?? '',
+                hasBoundaryAnalysis: consensusResult.viableOptions.length > 1,
+                hasExceptionHandling: consensusResult.preMortem?.rootCauses?.length > 0,
+                hasRollbackStrategy: Boolean(options.rollbackStrategy),
+                modules: options.modules ?? [],
+                consensusRounds: consensusResult.iterationCount,
+                verdict: consensusResult.verdict
+            });
+        }
+        if (options.runGate !== false && consensusResult.viableOptions.length > 1) {
             await this.gateSystem.executeGate('G2');
         }
         return consensusResult;
@@ -77,9 +105,9 @@ export class WorkflowEngine {
     // Phase 4: Verify with build and quality gates
     async verify(commandOverrides) {
         if (commandOverrides) {
-            this.gateSystem = new GateSystem(this.eventBus, commandOverrides);
+            this.gateSystem = new GateSystem(this.eventBus, commandOverrides, this.artifactWriter);
         }
-        const results = await this.gateSystem.executeAll(['G3', 'G0', 'G4', 'G5', 'G6', 'G7']);
+        const results = await this.gateSystem.executeAll(commandOverrides?.gates ?? ['G3', 'G0', 'G4', 'G5', 'G6', 'G7']);
         return results;
     }
     // Phase 5: PRD-driven execution with Ralph
@@ -147,5 +175,6 @@ export class WorkflowEngine {
     getUltraworkEngine() { return this.ultraworkEngine; }
     getPRDManager() { return this.prdManager; }
     getKarpathyEvaluator() { return this.karpathyEvaluator; }
+    getArtifactWriter() { return this.artifactWriter; }
 }
 //# sourceMappingURL=WorkflowEngine.js.map

package/dist/workflow/WorkflowEngine.js.map

@@ -1 +1 @@
-{"version":3,"file":"WorkflowEngine.js","sourceRoot":"","sources":["../../src/workflow/WorkflowEngine.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,oBAAoB;AAKpB,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AACtE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAE7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAUlE,MAAM,OAAO,cAAc;IAgBzB,YAAY,MAA4B;QACtC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;QAC/B,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAA;QACnD,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAA;QAEzC,8BAA8B;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,oBAAoB,CAAC,CAAA;QAC5E,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,EAAE,CAAA;QAC5C,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC3D,IAAI,CAAC,kBAAkB,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC/D,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACjD,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACzD,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,EAAE,CAAA;QAClC,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,EAAE,CAAA;QACpC,IAAI,CAAC,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAA;IAClD,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,OAAO,CAAC,WAAmB;QAC/B,uBAAuB;QACvB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QAE1D,gCAAgC;QAChC,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAA;QAE5E,6CAA6C;QAC7C,IAAI,eAAe,GAAgC,SAAS,CAAA;QAC5D,IAAI,eAAe,CAAC,mBAAmB,EAAE,CAAC;YACxC,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,WAAW,EAAE,eAAe,CAAC,CAAA;QACtF,CAAC;QAED,OAAO;YACL,cAAc,EAAE,eAAe,CAAC,UAAU;YAC1C,UAAU;YACV,eAAe;SAChB,CAAA;IACH,CAAC;IAED,uCAAuC;IACvC,iBAAiB,CAAC,OAAwB,EAAE,UAAkB,EAAE,MAAc;QAC5E,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,CAAA;QAC3E,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;QAElE,2CAA2C;QAC3C,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAA;YAC3E,OAAO,CAAC,MAAM,GAAG,SAAS,CAAA;YAC1B,uCAAuC;YACvC,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;gBAC3B,OAAO,CAAC,cAAc,CAAC,UAAU,GAAG,QAAQ,CAAC,YAAY,CAAA;YAC3D,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,mCAAmC;IACnC,eAAe,CAAC,OAAwB;QACtC,OAAO,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IACzD,CAAC;IAED,mCAAmC;IACnC,KAAK,CAAC,IAAI,CAAC,WAAmB;QAC5B,wBAAwB;QACxB,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAExE,sCAAsC;QACtC,IAAI,eAAe,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QACzC,CAAC;QAED,OAAO,eAAe,CAAA;IACxB,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,KAAK,CAAC,KAAuB;QACjC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QACpC,OAAO,MAAM,IAAI,CAAC,eAAe,CAAC,eAAe,EAAE,CAAA;IACrD,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,MAAM,CAAC,gBAA4C;QACvD,IAAI,gBAAgB,EAAE,CAAC;YACrB,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAA;QACnE,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;QACtF,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,OAAoB;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QACrD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC5B,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAA;IACrC,CAAC;IAED,4BAA4B;IAC5B,aAAa,CAAC,OAKb;QACC,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IACpD,CAAC;IAED,kCAAkC;IAClC,sBAAsB;QACpB,OAAO,IAAI,CAAC,WAAW,CAAC,sBAAsB,EAAE,CAAA;IAClD,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,KAA8B;QAChE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;QAClD,CAAC;QACD,0CAA0C;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAA;QAChD,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAA;IAChD,CAAC;IAED,yBAAyB;IACzB,KAAK,CAAC,oBAAoB,CAAC,QAAgB,EAAE,KAA8B;QACzE,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;QACvD,CAAC;QACD,kCAAkC;QAClC,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,CAAA;YACpD,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;YACjE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;QACnD,CAAC;QACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,CAAA;YAClD,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;YAC/D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;QAClD,CAAC;QACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAA;YAC5C,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;YACzD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;QAC/C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAA;IAClD,CAAC;IAED,mCAAmC;IACnC,UAAU,CAAC,QAAgB;QACzB,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IACzC,CAAC;IAED,iCAAiC;IACjC,QAAQ,KAAiB,OAAO,IAAI,CAAC,UAAU,CAAA,CAAC,CAAC;IACjD,kBAAkB,KAAsB,OAAO,IAAI,CAAC,eAAe,CAAA,CAAC,CAAC;IACrE,mBAAmB,KAAuB,OAAO,IAAI,CAAC,gBAAgB,CAAA,CAAC,CAAC;IACxE,qBAAqB,KAAyB,OAAO,IAAI,CAAC,kBAAkB,CAAA,CAAC,CAAC;IAC9E,cAAc,KAAkB,OAAO,IAAI,CAAC,WAAW,CAAA,CAAC,CAAC;IACzD,kBAAkB,KAAsB,OAAO,IAAI,CAAC,eAAe,CAAA,CAAC,CAAC;IACrE,aAAa,KAAiB,OAAO,IAAI,CAAC,UAAU,CAAA,CAAC,CAAC;IACtD,oBAAoB,KAAwB,OAAO,IAAI,CAAC,iBAAiB,CAAA,CAAC,CAAC;CAC5E"}
+{"version":3,"file":"WorkflowEngine.js","sourceRoot":"","sources":["../../src/workflow/WorkflowEngine.ts"],"names":[],"mappings":"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"}

package/dist/workflow/WorkspaceLifecycle.d.ts

@@ -0,0 +1,51 @@
+export type WorkspaceRepositoryKind = 'root' | 'submodule' | 'nested-repo';
+export interface WorkspaceRepositoryStatus {
+    kind: WorkspaceRepositoryKind;
+    path: string;
+    relativePath: string;
+    branch: string | null;
+    head: string | null;
+    upstream: string | null;
+    ahead: number;
+    behind: number;
+    gitDir: string | null;
+    gitCommonDir: string | null;
+    isLinkedWorktree: boolean;
+    isSubmodule: boolean;
+    superproject: string | null;
+    clean: boolean;
+    staged: number;
+    unstaged: number;
+    untracked: number;
+}
+export interface WorkspaceFinishDecision {
+    canCleanup: boolean;
+    blockers: string[];
+    warnings: string[];
+    nextActions: string[];
+}
+export interface WorkspaceLifecycleReport {
+    root: WorkspaceRepositoryStatus;
+    childRepositories: WorkspaceRepositoryStatus[];
+    finish: WorkspaceFinishDecision;
+}
+export interface WorkspaceLifecycleOptions {
+    projectDir?: string;
+}
+export interface WorkspaceCleanupOptions extends WorkspaceLifecycleOptions {
+    apply?: boolean;
+    confirm?: string;
+}
+export interface WorkspaceCleanupResult {
+    mode: 'dry-run' | 'apply';
+    canApply: boolean;
+    applied: boolean;
+    targetPath: string;
+    confirmationToken: string | null;
+    blockers: string[];
+    warnings: string[];
+    commands: string[];
+    report: WorkspaceLifecycleReport;
+}
+export declare function inspectWorkspaceLifecycle(options?: WorkspaceLifecycleOptions): Promise<WorkspaceLifecycleReport>;
+export declare function cleanupWorkspaceLifecycle(options?: WorkspaceCleanupOptions): Promise<WorkspaceCleanupResult>;