smartlisa 0.1.0

package/dist/src/core/prompts/feedback.js

@@ -0,0 +1,292 @@
+/**
+ * Feedback Prompts for Ralph Engine
+ *
+ * AI guidance templates for feedback, story status, and blocker management.
+ */
+import { enhanceWithContext } from "./context-helpers.js";
+export function getMarkStoryGuidance(state) {
+    const { storyId, newStatus, reason } = state;
+    let situation;
+    let instructions;
+    const commands = [];
+    switch (newStatus) {
+        case "done":
+            situation = `Story ${storyId} marked as done`;
+            instructions = [
+                "Celebrate the completion",
+                "Check board for next available stories",
+                "Consider if any dependent stories are now unblocked",
+            ];
+            commands.push({
+                command: "status board",
+                description: "Check kanban board",
+                when: "To see next available work",
+            });
+            break;
+        case "blocked":
+            situation = `Story ${storyId} marked as blocked: ${reason || "No reason given"}`;
+            instructions = [
+                "Record the blocker details in feedback",
+                "Look for workarounds or alternative approaches",
+                "Consider if this impacts other stories",
+                "Escalate if needed",
+            ];
+            commands.push({
+                command: "feedback add",
+                args: `--story ${storyId} --type blocker --message '<details>'`,
+                description: "Record blocker details",
+                when: "If not already recorded",
+            }, {
+                command: "status board",
+                description: "Check other available stories",
+                when: "To continue work elsewhere",
+            });
+            break;
+        case "in_progress":
+            situation = `Story ${storyId} is now in progress`;
+            instructions = [
+                "Start implementation",
+                "Refer to acceptance criteria as checklist",
+                "Check architecture for technical guidance",
+            ];
+            commands.push({
+                command: "status how",
+                args: storyId,
+                description: "Get implementation guidance",
+                when: "For detailed implementation checklist",
+            }, {
+                command: "status context",
+                args: storyId,
+                description: "View full context",
+                when: "For architecture and requirements",
+            });
+            break;
+        case "review":
+            situation = `Story ${storyId} submitted for review`;
+            instructions = [
+                "Verify all acceptance criteria are met",
+                "Run tests if applicable",
+                "Wait for review feedback",
+            ];
+            commands.push({
+                command: "feedback mark",
+                args: `${storyId} done`,
+                description: "Mark as done",
+                when: "When review passes",
+            });
+            break;
+        case "todo":
+            situation = `Story ${storyId} moved to todo`;
+            instructions = ["Story is ready to be picked up", "Check dependencies before starting"];
+            commands.push({
+                command: "feedback mark",
+                args: `${storyId} in_progress`,
+                description: "Start working",
+                when: "When ready to begin",
+            });
+            break;
+        default:
+            situation = `Story ${storyId} status changed to ${newStatus}`;
+            instructions = ["Continue with the workflow"];
+            commands.push({
+                command: "status board",
+                description: "Check kanban board",
+                when: "To see project status",
+            });
+    }
+    // Extract epic ID from story ID (e.g., "E1.S2" -> "E1")
+    const epicId = storyId.split(".")[0];
+    return enhanceWithContext({ situation, instructions, commands }, { target: { type: "story", id: storyId, epicId } });
+}
+export function getAddFeedbackGuidance(state) {
+    const { feedbackId, type, storyId, markedBlocked } = state;
+    let situation;
+    let instructions;
+    const commands = [];
+    switch (type) {
+        case "blocker":
+            situation = markedBlocked
+                ? `Blocker recorded (${feedbackId}) and story ${storyId} marked blocked`
+                : `Blocker recorded: ${feedbackId}`;
+            instructions = [
+                "Document what you tried and why it's blocked",
+                "Look for alternative approaches",
+                "Consider if other stories can proceed",
+                "Escalate if this blocks critical path",
+            ];
+            commands.push({
+                command: "status board",
+                description: "Find other stories to work on",
+                when: "To continue with unblocked work",
+            });
+            break;
+        case "gap":
+            situation = `Gap identified: ${feedbackId}`;
+            instructions = [
+                "This indicates missing requirements or unclear specs",
+                "Consider if planning needs revision",
+                "Clarify with stakeholders if needed",
+            ];
+            commands.push({
+                command: "plan epic",
+                args: storyId.split(".")[0],
+                description: "Review epic planning",
+                when: "If PRD needs updates",
+            });
+            break;
+        case "scope":
+            situation = `Scope concern recorded: ${feedbackId}`;
+            instructions = [
+                "Story may need to be split or rescoped",
+                "Review acceptance criteria for clarity",
+                "Consider breaking into smaller stories",
+            ];
+            break;
+        case "conflict":
+            situation = `Conflict detected: ${feedbackId}`;
+            instructions = [
+                "Resolve the conflict before proceeding",
+                "Check if architectural changes are needed",
+                "May need to update dependent stories",
+            ];
+            break;
+        case "question":
+            situation = `Question recorded: ${feedbackId}`;
+            instructions = [
+                "Get clarification before proceeding",
+                "Document the answer when received",
+                "Update requirements if needed",
+            ];
+            break;
+        default:
+            situation = `Feedback recorded: ${feedbackId}`;
+            instructions = ["Review and address the feedback"];
+    }
+    commands.push({
+        command: "feedback list",
+        description: "View all feedback",
+        when: "To see pending items",
+    });
+    // Extract epic ID from story ID (e.g., "E1.S2" -> "E1")
+    const epicId = storyId.split(".")[0];
+    return enhanceWithContext({ situation, instructions, commands }, { target: { type: "story", id: storyId, epicId } });
+}
+export function getListFeedbackGuidance(state) {
+    const { pendingCount, blockerCount, stuckCount, pendingItems, stuckItems } = state;
+    let situation;
+    const instructions = [];
+    const commands = [];
+    if (pendingCount === 0 && stuckCount === 0) {
+        situation = "No pending feedback or blockers";
+        instructions.push("Continue with implementation");
+        commands.push({
+            command: "status board",
+            description: "View available stories",
+            when: "To pick next work",
+        });
+        return { situation, instructions, commands };
+    }
+    situation =
+        blockerCount > 0
+            ? `${blockerCount} blockers and ${pendingCount - blockerCount} other feedback items`
+            : `${pendingCount} feedback items pending`;
+    if (stuckCount > 0) {
+        situation += `, ${stuckCount} stuck items need resolution`;
+    }
+    // Prioritize blockers
+    if (blockerCount > 0) {
+        instructions.push("Address blockers first - they're blocking progress");
+        const blockers = pendingItems.filter((f) => f.type === "blocker");
+        for (const blocker of blockers.slice(0, 3)) {
+            instructions.push(`  - ${blocker.id}: ${blocker.summary.slice(0, 50)}...`);
+        }
+    }
+    // Then stuck items
+    if (stuckCount > 0) {
+        instructions.push("Resolve stuck items - AI needs human input");
+        for (const stuck of stuckItems.slice(0, 2)) {
+            instructions.push(`  - ${stuck.id}: ${stuck.summary.slice(0, 50)}...`);
+            if (stuck.suggested_options && stuck.suggested_options.length > 0) {
+                instructions.push(`    Options: ${stuck.suggested_options.map((o) => o.label).join(", ")}`);
+            }
+        }
+    }
+    // Then other feedback
+    const nonBlockers = pendingItems.filter((f) => f.type !== "blocker");
+    if (nonBlockers.length > 0) {
+        instructions.push("Review other feedback when blockers are resolved");
+    }
+    commands.push({
+        command: "feedback resolve",
+        args: "<id>",
+        description: "Resolve a feedback item",
+        when: "After addressing the issue",
+    });
+    if (blockerCount > 0) {
+        const firstBlocker = pendingItems.find((f) => f.type === "blocker");
+        if (firstBlocker?.source.story_id) {
+            commands.push({
+                command: "feedback mark",
+                args: `${firstBlocker.source.story_id} todo`,
+                description: "Unblock the story",
+                when: "After resolving the blocker",
+            });
+        }
+    }
+    return { situation, instructions, commands };
+}
+export function getResolveFeedbackGuidance(state) {
+    const { feedbackId, storyId, wasBlocker } = state;
+    let situation = `Feedback ${feedbackId} resolved`;
+    const instructions = [];
+    const commands = [];
+    if (wasBlocker && storyId) {
+        situation += ` - story ${storyId} may be ready to unblock`;
+        instructions.push(`Story ${storyId} was blocked by this issue`);
+        instructions.push("Unblock the story if the issue is fully resolved");
+        commands.push({
+            command: "feedback mark",
+            args: `${storyId} todo`,
+            description: "Unblock the story",
+            when: "If blocker is fully resolved",
+        });
+    }
+    instructions.push("Check if other feedback items need attention");
+    commands.push({
+        command: "feedback list",
+        description: "View remaining feedback",
+        when: "To check for other items",
+    });
+    commands.push({
+        command: "status board",
+        description: "View kanban board",
+        when: "To continue with available work",
+    });
+    // Enhance with context if we have a story
+    if (storyId) {
+        const epicId = storyId.split(".")[0];
+        return enhanceWithContext({ situation, instructions, commands }, { target: { type: "story", id: storyId, epicId } });
+    }
+    return { situation, instructions, commands };
+}
+// ============================================================================
+// Dismiss Feedback Guidance
+// ============================================================================
+export function getDismissFeedbackGuidance(feedbackId) {
+    return {
+        situation: `Feedback ${feedbackId} dismissed`,
+        instructions: [
+            "Feedback has been dismissed but not resolved",
+            "Consider documenting why it was dismissed",
+            "Continue with other work",
+        ],
+        commands: [
+            {
+                command: "feedback list",
+                description: "View remaining feedback",
+                when: "To check for other items",
+            },
+        ],
+    };
+}
+//# sourceMappingURL=feedback.js.map

package/dist/src/core/prompts/feedback.js.map

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

package/dist/src/core/prompts/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Prompts Index for Ralph Engine
+ *
+ * Re-exports all prompt templates - the "prompt contract" for AI guidance.
+ */
+export * from "./discovery.js";
+export * from "./planning.js";
+export * from "./status.js";
+export * from "./feedback.js";
+export * from "./validate.js";
+export * from "./context-helpers.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC"}

package/dist/src/core/prompts/index.js

@@ -0,0 +1,12 @@
+/**
+ * Prompts Index for Ralph Engine
+ *
+ * Re-exports all prompt templates - the "prompt contract" for AI guidance.
+ */
+export * from "./discovery.js";
+export * from "./planning.js";
+export * from "./status.js";
+export * from "./feedback.js";
+export * from "./validate.js";
+export * from "./context-helpers.js";
+//# sourceMappingURL=index.js.map

package/dist/src/core/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC"}

package/dist/src/core/prompts/planning.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Planning Prompts for Ralph Engine
+ *
+ * AI guidance templates for milestone, epic, and story planning.
+ */
+import { AIGuidance } from "../types.js";
+import { DiscoveryContext, MilestoneIndex, Milestone, Epic, EpicContext, StoryContext, DerivedEpicStatus } from "../schemas.js";
+export declare function getMilestonesGuidance(context: DiscoveryContext | null, index: MilestoneIndex | null): AIGuidance;
+export declare function getEpicsGuidance(milestone: Milestone, epics: Array<{
+    epic: Epic;
+    status: DerivedEpicStatus;
+}>): AIGuidance;
+export declare function getEpicPlanningGuidance(ctx: EpicContext, nextStep: "prd" | "architecture" | "stories" | "complete"): AIGuidance;
+export declare function getStoriesGuidance(ctx: StoryContext): AIGuidance;
+//# sourceMappingURL=planning.d.ts.map

package/dist/src/core/prompts/planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../../../src/core/prompts/planning.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAqB,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAMvB,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,KAAK,EAAE,cAAc,GAAG,IAAI,GAC3B,UAAU,CA8CZ;AAMD,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC,GACtD,UAAU,CA2DZ;AAMD,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,KAAK,GAAG,cAAc,GAAG,SAAS,GAAG,UAAU,GACxD,UAAU,CAuIZ;AAMD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,UAAU,CA2ChE"}

package/dist/src/core/prompts/planning.js

@@ -0,0 +1,293 @@
+/**
+ * Planning Prompts for Ralph Engine
+ *
+ * AI guidance templates for milestone, epic, and story planning.
+ */
+// ============================================================================
+// Milestones Guidance
+// ============================================================================
+export function getMilestonesGuidance(context, index) {
+    if (!index || index.milestones.length === 0) {
+        return {
+            situation: "No milestones defined yet - ready to create milestone structure",
+            instructions: [
+                "Based on the discovery context, propose milestones that fit the project scope",
+                "Small projects might need 2 milestones; larger ones might need 5+",
+                "Each milestone should represent a meaningful, deliverable phase",
+                "Experienced default: ~3 milestones (Foundation, Core Features, Polish)",
+            ],
+            commands: [
+                {
+                    command: "plan addMilestone",
+                    args: "{ name: '<name>', description: '<desc>' }",
+                    description: "Add a milestone",
+                    when: "For each milestone in your proposal",
+                },
+            ],
+            context: {
+                projectProblem: context?.problem,
+                projectVision: context?.vision,
+            },
+        };
+    }
+    return {
+        situation: `${index.milestones.length} milestones defined - ready to plan epics`,
+        instructions: [
+            "Pick a milestone to work on (M1 recommended for new projects)",
+            "Add more milestones if needed, or proceed to epic planning",
+        ],
+        commands: [
+            {
+                command: "plan showEpics",
+                args: "{ milestoneId: 'M1' }",
+                description: "Plan epics for M1",
+                when: "To start epic planning",
+            },
+            {
+                command: "plan addMilestone",
+                args: "{ name: '<name>', description: '<desc>' }",
+                description: "Add another milestone",
+                when: "If more milestones are needed",
+            },
+        ],
+    };
+}
+// ============================================================================
+// Epics Guidance
+// ============================================================================
+export function getEpicsGuidance(milestone, epics) {
+    if (epics.length === 0) {
+        return {
+            situation: `Planning epics for ${milestone.id}: ${milestone.name}`,
+            instructions: [
+                `Propose epics for ${milestone.id} based on its scope and complexity`,
+                "Focused milestones might need 2 epics; complex ones might need 5+",
+                "Each epic should be a coherent, independently plannable piece of work",
+                "Experienced default: ~2-3 epics per milestone",
+                "Ask user to review the milestone scope and suggest epics",
+            ],
+            commands: [
+                {
+                    command: "plan addEpic",
+                    args: `{ milestoneId: '${milestone.id}', name: '<name>', description: '<desc>' }`,
+                    description: "Add an epic",
+                    when: "For each epic you propose",
+                },
+            ],
+            context: {
+                milestoneId: milestone.id,
+                milestoneName: milestone.name,
+                milestoneDescription: milestone.description,
+            },
+        };
+    }
+    const incompleteEpics = epics.filter((e) => e.status !== "done");
+    const nextEpic = incompleteEpics[0];
+    if (nextEpic) {
+        return {
+            situation: `${epics.length} epics in ${milestone.id}, ${incompleteEpics.length} incomplete`,
+            instructions: [
+                `Continue with ${nextEpic.epic.id}: ${nextEpic.epic.name}`,
+                `Status: ${nextEpic.status}`,
+            ],
+            commands: [
+                {
+                    command: "plan planEpic",
+                    args: `{ epicId: '${nextEpic.epic.id}' }`,
+                    description: `Plan ${nextEpic.epic.id}`,
+                    when: "To continue with this epic",
+                },
+                {
+                    command: "plan addEpic",
+                    args: `{ milestoneId: '${milestone.id}', name: '<name>', description: '<desc>' }`,
+                    description: "Add another epic",
+                    when: "If more epics are needed",
+                },
+            ],
+        };
+    }
+    return {
+        situation: `All epics in ${milestone.id} complete!`,
+        instructions: ["Move to the next milestone or validate the completed work"],
+        commands: [],
+    };
+}
+// ============================================================================
+// Epic Planning Guidance
+// ============================================================================
+export function getEpicPlanningGuidance(ctx, nextStep) {
+    if (nextStep === "prd") {
+        const instructions = [
+            "Generate a PRD for this epic based on discovery context",
+            "The PRD should include:",
+            "  - Overview section",
+            "  - Requirements (E1.R1, E1.R2, etc.) with acceptance criteria",
+            "  - Out of scope section",
+            "  - Dependencies section",
+        ];
+        // Add context about epic discovery
+        if (ctx.epicDiscovery && ctx.epicDiscovery.status !== "skipped") {
+            instructions.push("Reference epic discovery context:");
+            if (ctx.epicDiscovery.problem) {
+                instructions.push(`  - Problem: ${ctx.epicDiscovery.problem.slice(0, 60)}...`);
+            }
+            if (ctx.epicDiscovery.scope.length > 0) {
+                instructions.push(`  - Scope: ${ctx.epicDiscovery.scope.join("; ")}`);
+            }
+        }
+        const commands = [
+            {
+                command: "plan savePrd",
+                args: `{ epicId: '${ctx.epic.id}', content: '<markdown>' }`,
+                description: "Save PRD",
+                when: "After generating PRD content",
+            },
+        ];
+        // Suggest discovery if not done
+        if (!ctx.epicDiscovery || ctx.epicDiscovery.status === "not_started") {
+            commands.unshift({
+                command: "discover element",
+                args: `{ elementType: 'epic', elementId: '${ctx.epic.id}' }`,
+                description: "Run epic discovery first",
+                when: "To gather more context before PRD",
+            });
+        }
+        return {
+            situation: `${ctx.epic.id} ready for PRD generation`,
+            instructions,
+            commands,
+            context: {
+                epicId: ctx.epic.id,
+                epicName: ctx.epic.name,
+                epicDescription: ctx.epic.description,
+                milestoneId: ctx.milestone.id,
+                milestoneName: ctx.milestone.name,
+                projectProblem: ctx.project.discovery?.problem,
+                projectVision: ctx.project.discovery?.vision,
+                epicDiscovery: ctx.epicDiscovery
+                    ? {
+                        problem: ctx.epicDiscovery.problem,
+                        scope: ctx.epicDiscovery.scope,
+                        outOfScope: ctx.epicDiscovery.out_of_scope,
+                        successCriteria: ctx.epicDiscovery.success_criteria,
+                    }
+                    : null,
+                constraints: [
+                    ...(ctx.project.constraints?.constraints || []),
+                    ...(ctx.milestoneDiscovery?.constraints || []),
+                    ...(ctx.epicDiscovery?.constraints || []),
+                ],
+            },
+        };
+    }
+    if (nextStep === "architecture") {
+        const allConstraints = [
+            ...(ctx.project.constraints?.constraints || []),
+            ...(ctx.milestoneDiscovery?.constraints || []),
+            ...(ctx.epicDiscovery?.constraints || []),
+        ];
+        return {
+            situation: `${ctx.epic.id} PRD complete, ready for architecture`,
+            instructions: [
+                "Read the PRD and generate architecture",
+                "Include data models, APIs, component structure",
+                "Reference requirements (E1.R1 → E1.A1)",
+                allConstraints.length > 0
+                    ? `Consider ${allConstraints.length} constraints`
+                    : "Check for any constraints in context",
+            ],
+            commands: [
+                {
+                    command: "plan saveArchitecture",
+                    args: `{ epicId: '${ctx.epic.id}', content: '<markdown>' }`,
+                    description: "Save architecture",
+                    when: "After generating architecture content",
+                },
+            ],
+            context: {
+                epicId: ctx.epic.id,
+                constraints: allConstraints,
+                techStack: ctx.project.config?.stack,
+            },
+        };
+    }
+    if (nextStep === "stories") {
+        return {
+            situation: `${ctx.epic.id} architecture complete, ready for stories`,
+            instructions: [
+                "Generate stories that cover all requirements",
+                "Each story should have clear acceptance criteria",
+                "Link to requirements and architecture",
+                "Stories should be implementable in 1-3 days",
+            ],
+            commands: [
+                {
+                    command: "plan showStories",
+                    args: `{ epicId: '${ctx.epic.id}' }`,
+                    description: "Generate stories",
+                    when: "To start story generation",
+                },
+            ],
+        };
+    }
+    return {
+        situation: `${ctx.epic.id} all artifacts complete!`,
+        instructions: ["Run validation to check coverage and links"],
+        commands: [
+            {
+                command: "validate epic",
+                args: ctx.epic.id,
+                description: "Validate epic",
+                when: "To check requirements coverage",
+            },
+        ],
+    };
+}
+// ============================================================================
+// Stories Guidance
+// ============================================================================
+export function getStoriesGuidance(ctx) {
+    return {
+        situation: `Generating stories for ${ctx.epic.id}: ${ctx.epic.name}`,
+        instructions: [
+            "Read the PRD and architecture",
+            "Generate stories that cover all requirements",
+            "Each story should:",
+            "  - Have clear acceptance criteria",
+            "  - Link to requirements (E1.R1, E1.R2)",
+            "  - Link to architecture (E1.A1)",
+            "  - Be implementable in 1-3 days",
+            "Add stories one by one or save all at once",
+        ],
+        commands: [
+            {
+                command: "plan addStory",
+                args: `{ epicId: '${ctx.epic.id}', title: '<title>', description: '<desc>', requirements: ['R1','R2'], criteria: ['c1','c2'] }`,
+                description: "Add a story",
+                when: "For each story",
+            },
+            {
+                command: "plan saveStories",
+                args: `{ epicId: '${ctx.epic.id}', stories: [...] }`,
+                description: "Save all stories at once",
+                when: "If you have the full list ready",
+            },
+            {
+                command: "plan markStoriesComplete",
+                args: `{ epicId: '${ctx.epic.id}' }`,
+                description: "Mark stories complete",
+                when: "After all stories are added",
+            },
+        ],
+        context: {
+            epicId: ctx.epic.id,
+            requirements: ctx.requirements,
+            successCriteria: [
+                ...(ctx.project.discovery?.success_criteria || []),
+                ...(ctx.milestoneDiscovery?.success_criteria || []),
+                ...(ctx.epicDiscovery?.success_criteria || []),
+            ],
+        },
+    };
+}
+//# sourceMappingURL=planning.js.map