smartlisa 0.1.0

package/dist/src/core/state.d.ts

@@ -0,0 +1,156 @@
+/**
+ * State Manager
+ *
+ * High-level state management facade that delegates persistence
+ * to a StateAdapter. Provides domain-specific methods for reading
+ * and writing Ralph state, plus business logic for status derivation
+ * and context assembly.
+ */
+import { Project, DiscoveryContext, Constraints, DiscoveryHistory, ElementDiscovery, MilestoneIndex, Milestone, Epic, StoriesFile, Story, TaskQueue, StuckQueue, FeedbackQueue, Config, Coverage, Links, ValidationIssues, Lock, DerivedEpicStatus, DerivedMilestoneStatus, ProjectContext, MilestoneContext, EpicContext, StoryContext } from "./schemas.js";
+import { StateAdapter, RALPH_DIR } from "../adapters/state/index.js";
+export { RALPH_DIR };
+export declare const PATHS: {
+    readonly project: "project.json";
+    readonly config: "config.yaml";
+    readonly taskQueue: "task_queue.json";
+    readonly stuckQueue: "stuck_queue.json";
+    readonly feedbackQueue: "feedback_queue.json";
+    readonly lock: ".lock";
+    readonly discovery: {
+        readonly dir: "discovery";
+        readonly context: "discovery/context.json";
+        readonly constraints: "discovery/constraints.json";
+        readonly history: "discovery/history.json";
+    };
+    readonly milestones: {
+        readonly dir: "milestones";
+        readonly index: "milestones/index.json";
+    };
+    readonly epics: {
+        readonly dir: "epics";
+    };
+    readonly validation: {
+        readonly dir: "validation";
+        readonly coverage: "validation/coverage.json";
+        readonly links: "validation/links.json";
+        readonly issues: "validation/issues.json";
+    };
+};
+export declare class StateManager {
+    private adapter;
+    constructor(adapter?: StateAdapter);
+    /**
+     * Get the underlying adapter (for advanced use cases).
+     */
+    getAdapter(): StateAdapter;
+    isInitialized(): Promise<boolean>;
+    initialize(projectName?: string): Promise<Project>;
+    getPath(relativePath: string): string;
+    getEpicDir(epicId: string, slug: string): string;
+    getEpicPath(epicId: string, slug: string, file: string): string;
+    readProject(): Promise<Project | null>;
+    writeProject(project: Project): Promise<void>;
+    updateProject(updates: Partial<Project>): Promise<Project>;
+    readConfig(): Promise<Config | null>;
+    writeConfig(config: Config): Promise<void>;
+    readDiscoveryContext(): Promise<DiscoveryContext | null>;
+    writeDiscoveryContext(context: DiscoveryContext): Promise<void>;
+    readConstraints(): Promise<Constraints | null>;
+    writeConstraints(constraints: Constraints): Promise<void>;
+    readDiscoveryHistory(): Promise<DiscoveryHistory | null>;
+    writeDiscoveryHistory(history: DiscoveryHistory): Promise<void>;
+    readMilestoneIndex(): Promise<MilestoneIndex | null>;
+    writeMilestoneIndex(index: MilestoneIndex): Promise<void>;
+    listEpicDirs(): Promise<string[]>;
+    readEpic(epicId: string, slug: string): Promise<Epic | null>;
+    writeEpic(epic: Epic): Promise<void>;
+    readPrd(epicId: string, slug: string): Promise<string | null>;
+    writePrd(epicId: string, slug: string, content: string): Promise<void>;
+    readArchitecture(epicId: string, slug: string): Promise<string | null>;
+    writeArchitecture(epicId: string, slug: string, content: string): Promise<void>;
+    readStories(epicId: string, slug: string): Promise<StoriesFile | null>;
+    writeStories(epicId: string, slug: string, stories: StoriesFile): Promise<void>;
+    createEpicDir(epicId: string, slug: string): Promise<void>;
+    readEpicDiscovery(epicId: string, slug: string): Promise<ElementDiscovery | null>;
+    writeEpicDiscovery(epicId: string, slug: string, data: ElementDiscovery): Promise<void>;
+    getMilestoneDir(milestoneId: string): string;
+    readMilestoneDiscovery(milestoneId: string): Promise<ElementDiscovery | null>;
+    writeMilestoneDiscovery(milestoneId: string, data: ElementDiscovery): Promise<void>;
+    readTaskQueue(): Promise<TaskQueue | null>;
+    writeTaskQueue(queue: TaskQueue): Promise<void>;
+    readStuckQueue(): Promise<StuckQueue | null>;
+    writeStuckQueue(queue: StuckQueue): Promise<void>;
+    readFeedbackQueue(): Promise<FeedbackQueue | null>;
+    writeFeedbackQueue(queue: FeedbackQueue): Promise<void>;
+    readCoverage(): Promise<Coverage | null>;
+    writeCoverage(coverage: Coverage): Promise<void>;
+    readLinks(): Promise<Links | null>;
+    writeLinks(links: Links): Promise<void>;
+    readValidationIssues(): Promise<ValidationIssues | null>;
+    writeValidationIssues(issues: ValidationIssues): Promise<void>;
+    acquireLock(holder: "worker" | "user" | "system", task?: string): Promise<boolean>;
+    releaseLock(): Promise<void>;
+    readLock(): Promise<Lock | null>;
+    exists(relativePath: string): Promise<boolean>;
+    listDirectory(relativePath: string): Promise<string[]>;
+    /**
+     * Derive epic status from artifacts and stories.
+     * Status is computed, not stored.
+     */
+    deriveEpicStatus(epic: Epic, stories: Story[] | null): Promise<DerivedEpicStatus>;
+    /**
+     * Derive milestone status from epic statuses.
+     * Status is computed, not stored.
+     */
+    deriveMilestoneStatus(milestone: Milestone): Promise<DerivedMilestoneStatus>;
+    /**
+     * Get epic with derived status (convenience method).
+     */
+    getEpicWithStatus(epicId: string, slug: string): Promise<{
+        epic: Epic;
+        status: DerivedEpicStatus;
+    } | null>;
+    /**
+     * Get milestone with derived status (convenience method).
+     */
+    getMilestoneWithStatus(milestone: Milestone): Promise<{
+        milestone: Milestone;
+        status: DerivedMilestoneStatus;
+    }>;
+    /**
+     * Assemble project-level context.
+     * Used for milestone planning.
+     */
+    assembleProjectContext(): Promise<ProjectContext>;
+    /**
+     * Assemble milestone-level context.
+     * Used for epic generation within a milestone.
+     */
+    assembleMilestoneContext(milestoneId: string): Promise<MilestoneContext>;
+    /**
+     * Assemble epic-level context.
+     * Used for PRD and architecture generation.
+     */
+    assembleEpicContext(epicId: string): Promise<EpicContext>;
+    /**
+     * Assemble story-level context.
+     * Used for story generation. Requires PRD and architecture to exist.
+     */
+    assembleStoryContext(epicId: string): Promise<StoryContext>;
+    /**
+     * Helper: Extract requirements from PRD markdown.
+     * Looks for patterns like "### R1: Title" or "### E1.R1: Title"
+     */
+    private extractRequirementsFromPrd;
+}
+export declare function getStateManager(rootDir?: string): StateManager;
+/**
+ * Create a new StateManager with a custom adapter.
+ * Use this when you need a non-default adapter (e.g., for testing or future backends).
+ */
+export declare function createStateManager(adapter: StateAdapter): StateManager;
+/**
+ * Reset the singleton (useful for testing).
+ */
+export declare function resetStateManager(): void;
+//# sourceMappingURL=state.d.ts.map

package/dist/src/core/state.d.ts.map

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