forge-cc 0.1.0

package/dist/spec/interview.js

@@ -0,0 +1,342 @@
+/**
+ * Adaptive interview engine for spec generation.
+ *
+ * Pure logic — no side effects, no I/O. All state is passed in and returned.
+ * The interview leads with recommendations derived from codebase scan results,
+ * follows interesting threads based on user responses, and determines when
+ * enough info has been gathered for each PRD section.
+ */
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+/** PRD sections in priority order */
+export const PRD_SECTIONS = [
+    "problem_and_goals",
+    "user_stories",
+    "technical_approach",
+    "scope",
+    "milestones",
+];
+/** Human-readable labels for each section */
+export const SECTION_LABELS = {
+    problem_and_goals: "Problem & Goals",
+    user_stories: "User Stories",
+    technical_approach: "Technical Approach",
+    scope: "Scope",
+    milestones: "Milestones",
+};
+// ---------------------------------------------------------------------------
+// Minimum answer thresholds per section
+// ---------------------------------------------------------------------------
+const MIN_ANSWERS = {
+    problem_and_goals: 2,
+    user_stories: 2,
+    technical_approach: 1,
+    scope: 1,
+    milestones: 1,
+};
+// ---------------------------------------------------------------------------
+// Interview Creation
+// ---------------------------------------------------------------------------
+/**
+ * Initialize a new interview with codebase context.
+ * The scan results inform the recommendations attached to questions.
+ */
+export function createInterview(projectName, scanResults) {
+    return {
+        projectName,
+        scanResults,
+        questions: [],
+        answers: [],
+        nextQuestionId: 1,
+        askedSections: [],
+        answersSinceLastDraft: 0,
+    };
+}
+// ---------------------------------------------------------------------------
+// Question Generation
+// ---------------------------------------------------------------------------
+/**
+ * Generate 1-3 next questions based on current state.
+ * Prioritizes sections with the most gaps, leads with recommendations.
+ * Returns questions and the updated state (with new questions appended).
+ */
+export function generateNextQuestions(state) {
+    const statuses = getSectionStatuses(state);
+    const pendingFollowUp = findFollowUpOpportunities(state);
+    const newQuestions = [];
+    let nextId = state.nextQuestionId;
+    // Priority 1: Follow up on interesting threads (max 1 follow-up per batch)
+    if (pendingFollowUp.length > 0 && newQuestions.length < 3) {
+        const followUp = pendingFollowUp[0];
+        newQuestions.push({
+            id: `q${nextId++}`,
+            section: followUp.section,
+            text: followUp.text,
+            context: followUp.context,
+            depth: followUp.depth,
+        });
+    }
+    // Priority 2: Ask about incomplete sections in priority order
+    for (const section of PRD_SECTIONS) {
+        if (newQuestions.length >= 3)
+            break;
+        const status = statuses.find((s) => s.section === section);
+        if (status?.isComplete)
+            continue;
+        // Skip if we already have a question for this section in this batch
+        if (newQuestions.some((q) => q.section === section))
+            continue;
+        const question = generateSectionQuestion(state, section, nextId);
+        if (question) {
+            newQuestions.push(question);
+            nextId++;
+        }
+    }
+    // If we generated nothing (everything complete), return empty
+    if (newQuestions.length === 0) {
+        return { questions: [], state };
+    }
+    const updatedState = {
+        ...state,
+        questions: [...state.questions, ...newQuestions],
+        nextQuestionId: nextId,
+        askedSections: [
+            ...new Set([
+                ...state.askedSections,
+                ...newQuestions.map((q) => q.section),
+            ]),
+        ],
+    };
+    return { questions: newQuestions, state: updatedState };
+}
+// ---------------------------------------------------------------------------
+// Answer Recording
+// ---------------------------------------------------------------------------
+/**
+ * Record the user's answer and return updated state.
+ */
+export function recordAnswer(state, questionId, answer) {
+    const question = state.questions.find((q) => q.id === questionId);
+    if (!question) {
+        throw new Error(`Question not found: ${questionId}`);
+    }
+    const newAnswer = {
+        questionId,
+        section: question.section,
+        answer,
+        timestamp: Date.now(),
+    };
+    return {
+        ...state,
+        answers: [...state.answers, newAnswer],
+        answersSinceLastDraft: state.answersSinceLastDraft + 1,
+    };
+}
+// ---------------------------------------------------------------------------
+// Draft Update Check
+// ---------------------------------------------------------------------------
+/**
+ * Returns true every 2-3 answers (triggers at 2, then every 3).
+ * The caller is responsible for resetting the counter after updating the draft.
+ */
+export function shouldUpdateDraft(state) {
+    return state.answersSinceLastDraft >= 2;
+}
+/**
+ * Reset the draft update counter (call after updating the PRD draft).
+ */
+export function markDraftUpdated(state) {
+    return {
+        ...state,
+        answersSinceLastDraft: 0,
+    };
+}
+// ---------------------------------------------------------------------------
+// Completeness Check
+// ---------------------------------------------------------------------------
+/**
+ * Returns true when all sections have met their minimum answer thresholds.
+ */
+export function isComplete(state) {
+    return getSectionStatuses(state).every((s) => s.isComplete);
+}
+// ---------------------------------------------------------------------------
+// Section Statuses
+// ---------------------------------------------------------------------------
+/**
+ * Get the completeness status for all sections.
+ */
+export function getSectionStatuses(state) {
+    return PRD_SECTIONS.map((section) => {
+        const answeredCount = state.answers.filter((a) => a.section === section).length;
+        const minRequired = MIN_ANSWERS[section];
+        return {
+            section,
+            answeredCount,
+            minRequired,
+            isComplete: answeredCount >= minRequired,
+        };
+    });
+}
+// ---------------------------------------------------------------------------
+// Interview Summary
+// ---------------------------------------------------------------------------
+/**
+ * Build a structured summary of everything gathered, for PRD generation.
+ */
+export function getInterviewSummary(state) {
+    const statuses = getSectionStatuses(state);
+    const sections = {};
+    for (const section of PRD_SECTIONS) {
+        const sectionAnswers = state.answers.filter((a) => a.section === section);
+        const status = statuses.find((s) => s.section === section);
+        sections[section] = {
+            label: SECTION_LABELS[section],
+            answers: sectionAnswers.map((a) => {
+                const question = state.questions.find((q) => q.id === a.questionId);
+                return {
+                    question: question?.text ?? "(unknown question)",
+                    answer: a.answer,
+                };
+            }),
+            isComplete: status.isComplete,
+        };
+    }
+    return {
+        projectName: state.projectName,
+        sections,
+        scanResults: state.scanResults,
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Generate a question for a specific section based on codebase context.
+ * Returns null if no meaningful question can be generated.
+ */
+function generateSectionQuestion(state, section, nextId) {
+    const answeredCount = state.answers.filter((a) => a.section === section).length;
+    const scan = state.scanResults;
+    const q = (text, context) => ({
+        id: `q${nextId}`,
+        section,
+        text,
+        context,
+        depth: 0,
+    });
+    switch (section) {
+        case "problem_and_goals": {
+            if (answeredCount === 0) {
+                const fw = scan.structure.frameworks.length > 0 ? scan.structure.frameworks.join(", ") : null;
+                return q("What problem does this project solve? What's the desired outcome when it's done?", `I found a ${scan.structure.language} project${fw ? ` using ${fw}` : ""}. Help me understand what you're building and why.`);
+            }
+            return q("How will you know this project is successful? What does 'done' look like?", "I want to define clear success criteria for the PRD.");
+        }
+        case "user_stories": {
+            if (answeredCount === 0) {
+                const pageRoutes = scan.routes.routes.filter((r) => r.type === "page");
+                const apiRoutes = scan.routes.routes.filter((r) => r.type === "api");
+                const hasRoutes = pageRoutes.length > 0;
+                const hasAPI = apiRoutes.length > 0;
+                const routeContext = hasRoutes
+                    ? `I see ${pageRoutes.length} page(s) and ${apiRoutes.length} API route(s).`
+                    : hasAPI
+                        ? `I see ${apiRoutes.length} API route(s) but no pages.`
+                        : "I don't see existing routes yet.";
+                return q("Who are the primary users of this feature? What do they need to accomplish?", `${routeContext} Understanding the users will help me structure milestones around their journeys.`);
+            }
+            return q("Are there secondary users or admin workflows to consider?", "Capturing all user types early prevents scope creep later.");
+        }
+        case "technical_approach": {
+            const fw = scan.structure.frameworks;
+            const fwLabel = fw.length > 0 ? fw.join(", ") : null;
+            const models = scan.dataAPIs.dataModels;
+            const hasDB = models.length > 0;
+            const dbLabel = hasDB
+                ? models.slice(0, 3).map((m) => m.name).join(", ")
+                : "";
+            if (answeredCount === 0) {
+                return q("Are there specific technical decisions already made? Any constraints on architecture, APIs, or data storage?", `Current stack: ${scan.structure.language}${fwLabel ? `/${fwLabel}` : ""}${hasDB ? `, data models: [${dbLabel}]` : ""}. I'll build the technical approach around existing decisions.`);
+            }
+            return null; // One answer usually sufficient for technical approach
+        }
+        case "scope": {
+            const configFiles = scan.structure.configFiles;
+            if (answeredCount === 0) {
+                return q("What's explicitly OUT of scope? Are there any sacred files or areas of the codebase that should not be touched?", configFiles.length > 0
+                    ? `Key config files I found: ${configFiles.slice(0, 8).join(", ")}. Knowing what's off-limits helps me write safer milestones.`
+                    : "Defining boundaries early prevents scope creep.");
+            }
+            return null;
+        }
+        case "milestones": {
+            if (answeredCount === 0) {
+                return q("How would you break this work into deliverable chunks? Any natural phases or dependencies between pieces?", "I'll structure Linear milestones around your phasing. Each milestone should be independently shippable.");
+            }
+            return null;
+        }
+    }
+}
+/**
+ * Find opportunities for follow-up questions based on recent answers.
+ * Looks for keywords/patterns that suggest deeper exploration would be valuable.
+ */
+function findFollowUpOpportunities(state) {
+    const opportunities = [];
+    // Only consider the last 3 answers for follow-ups
+    const recentAnswers = state.answers.slice(-3);
+    for (const answer of recentAnswers) {
+        const question = state.questions.find((q) => q.id === answer.questionId);
+        if (!question)
+            continue;
+        // Don't follow up on follow-ups beyond depth 2
+        if (question.depth >= 2)
+            continue;
+        // Don't generate follow-ups for questions we've already followed up on
+        const hasFollowUp = state.questions.some((q) => q.depth > question.depth &&
+            q.section === question.section &&
+            state.questions.indexOf(q) > state.questions.indexOf(question));
+        if (hasFollowUp)
+            continue;
+        const lower = answer.answer.toLowerCase();
+        // Detect mentions of migration/breaking changes — worth digging into
+        if ((lower.includes("migrat") || lower.includes("breaking")) &&
+            question.section !== "scope") {
+            opportunities.push({
+                section: "scope",
+                text: "You mentioned migration/breaking changes. What existing data or APIs need to be preserved? Any backward compatibility requirements?",
+                context: `Based on your answer about ${SECTION_LABELS[question.section]}.`,
+                depth: question.depth + 1,
+            });
+        }
+        // Detect mentions of multiple user types — worth expanding user stories
+        if ((lower.includes("admin") ||
+            lower.includes("different user") ||
+            lower.includes("roles")) &&
+            answer.section === "user_stories") {
+            opportunities.push({
+                section: "user_stories",
+                text: "You mentioned different user types/roles. Can you walk me through the key workflow for each type?",
+                context: "Multiple user types often need separate milestone planning.",
+                depth: question.depth + 1,
+            });
+        }
+        // Detect mentions of external services — worth clarifying integration scope
+        if ((lower.includes("api") ||
+            lower.includes("third-party") ||
+            lower.includes("external") ||
+            lower.includes("integration")) &&
+            answer.section === "technical_approach") {
+            opportunities.push({
+                section: "technical_approach",
+                text: "You mentioned external integrations. Which services are critical path vs nice-to-have? Any rate limits or auth concerns?",
+                context: "External dependencies often need their own milestone.",
+                depth: question.depth + 1,
+            });
+        }
+    }
+    return opportunities;
+}
+//# sourceMappingURL=interview.js.map

package/dist/spec/interview.js.map

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

package/dist/spec/linear-sync.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Syncs a PRD to Linear: creates milestones, issues (one per user story),
+ * and transitions the project to "Planned".
+ */
+import { LinearClient } from "../linear/client.js";
+import type { LinearMilestone, LinearIssue } from "../linear/client.js";
+import type { PRDData } from "./templates.js";
+export interface SyncedMilestone {
+    prdNumber: number;
+    name: string;
+    linearMilestone: LinearMilestone;
+    issues: SyncedIssue[];
+}
+export interface SyncedIssue {
+    userStoryId: string;
+    title: string;
+    linearIssue: LinearIssue;
+}
+export interface IssueError {
+    userStoryId: string;
+    title: string;
+    error: string;
+}
+export interface MilestoneError {
+    prdNumber: number;
+    name: string;
+    error: string;
+}
+export interface SyncResult {
+    projectId: string;
+    milestonesCreated: number;
+    issuesCreated: number;
+    milestones: SyncedMilestone[];
+    errors: {
+        milestones: MilestoneError[];
+        issues: IssueError[];
+    };
+}
+/**
+ * Sync a PRD to Linear:
+ * 1. Create milestones (one per PRD milestone)
+ * 2. Create issues under each milestone (one per user story)
+ * 3. Transition project to "Planned"
+ *
+ * Handles partial failures — if a milestone or issue fails to create,
+ * the error is captured and the sync continues with the rest.
+ */
+export declare function syncPRDToLinear(prdData: PRDData, projectId: string, teamId: string, client: LinearClient): Promise<SyncResult>;

package/dist/spec/linear-sync.js

@@ -0,0 +1,125 @@
+/**
+ * Syncs a PRD to Linear: creates milestones, issues (one per user story),
+ * and transitions the project to "Planned".
+ */
+import { createProjectMilestone } from "../linear/milestones.js";
+import { createMilestoneIssue } from "../linear/issues.js";
+import { transitionProject } from "../linear/projects.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Build issue descriptions from user stories, including acceptance criteria.
+ */
+function buildIssueDescription(story) {
+    const lines = [story.description];
+    if (story.acceptanceCriteria.length > 0) {
+        lines.push("", "## Acceptance Criteria");
+        for (const criterion of story.acceptanceCriteria) {
+            lines.push(`- [ ] ${criterion}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Resolve which user stories belong to a milestone.
+ * Each milestone's `waves` contain agents with tasks — we map all
+ * user stories to the milestone based on the PRD structure.
+ * Since milestones don't have explicit userStory references in the schema,
+ * we distribute stories evenly across milestones, or assign all to the
+ * first milestone if there's only one.
+ */
+function assignStoriesToMilestones(milestones, stories) {
+    const map = new Map();
+    if (milestones.length === 0)
+        return map;
+    // Initialize all milestones with empty arrays
+    for (const m of milestones) {
+        map.set(m.number, []);
+    }
+    // Distribute stories across milestones round-robin
+    for (let i = 0; i < stories.length; i++) {
+        const milestoneIdx = i % milestones.length;
+        const milestoneNumber = milestones[milestoneIdx].number;
+        map.get(milestoneNumber).push(stories[i]);
+    }
+    return map;
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+/**
+ * Sync a PRD to Linear:
+ * 1. Create milestones (one per PRD milestone)
+ * 2. Create issues under each milestone (one per user story)
+ * 3. Transition project to "Planned"
+ *
+ * Handles partial failures — if a milestone or issue fails to create,
+ * the error is captured and the sync continues with the rest.
+ */
+export async function syncPRDToLinear(prdData, projectId, teamId, client) {
+    const result = {
+        projectId,
+        milestonesCreated: 0,
+        issuesCreated: 0,
+        milestones: [],
+        errors: {
+            milestones: [],
+            issues: [],
+        },
+    };
+    const storyMap = assignStoriesToMilestones(prdData.milestones, prdData.userStories);
+    // 1. Create milestones and their issues
+    for (const milestone of prdData.milestones) {
+        let linearMilestone;
+        try {
+            linearMilestone = await createProjectMilestone(client, projectId, `M${milestone.number}: ${milestone.name}`, milestone.goal);
+        }
+        catch (err) {
+            result.errors.milestones.push({
+                prdNumber: milestone.number,
+                name: milestone.name,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            continue; // Skip issues for this milestone
+        }
+        result.milestonesCreated++;
+        const syncedMilestone = {
+            prdNumber: milestone.number,
+            name: milestone.name,
+            linearMilestone,
+            issues: [],
+        };
+        // Create issues for user stories assigned to this milestone
+        const stories = storyMap.get(milestone.number) ?? [];
+        for (const story of stories) {
+            try {
+                const linearIssue = await createMilestoneIssue(client, {
+                    title: `${story.id}: ${story.title}`,
+                    description: buildIssueDescription(story),
+                    teamId,
+                    projectId,
+                    milestoneId: linearMilestone.id,
+                });
+                syncedMilestone.issues.push({
+                    userStoryId: story.id,
+                    title: story.title,
+                    linearIssue,
+                });
+                result.issuesCreated++;
+            }
+            catch (err) {
+                result.errors.issues.push({
+                    userStoryId: story.id,
+                    title: story.title,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        result.milestones.push(syncedMilestone);
+    }
+    // 2. Transition project to "Planned"
+    await transitionProject(client, projectId, "Planned");
+    return result;
+}
+//# sourceMappingURL=linear-sync.js.map

package/dist/spec/linear-sync.js.map

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

package/dist/spec/scanner.d.ts

@@ -0,0 +1,45 @@
+export interface StructureScanResult {
+    projectName: string;
+    frameworks: string[];
+    language: "typescript" | "javascript" | "unknown";
+    packageManager: "npm" | "yarn" | "pnpm" | "bun" | "unknown";
+    configFiles: string[];
+    topLevelDirs: string[];
+    entryPoints: string[];
+}
+export interface RouteInfo {
+    path: string;
+    file: string;
+    type: "page" | "api" | "layout" | "component" | "middleware";
+}
+export interface RoutesScanResult {
+    framework: string | null;
+    routeDir: string | null;
+    routes: RouteInfo[];
+    components: string[];
+}
+export interface APIEndpoint {
+    method: string;
+    path: string;
+    file: string;
+}
+export interface DataModel {
+    name: string;
+    file: string;
+    source: "prisma" | "drizzle" | "mongoose" | "typeorm" | "sql" | "unknown";
+}
+export interface DataAPIsScanResult {
+    apiEndpoints: APIEndpoint[];
+    dataModels: DataModel[];
+    externalServices: string[];
+    databaseType: string | null;
+}
+export interface ScanAllResult {
+    structure: StructureScanResult;
+    routes: RoutesScanResult;
+    dataAPIs: DataAPIsScanResult;
+}
+export declare function scanStructure(projectDir: string): Promise<StructureScanResult>;
+export declare function scanRoutes(projectDir: string): Promise<RoutesScanResult>;
+export declare function scanDataAPIs(projectDir: string): Promise<DataAPIsScanResult>;
+export declare function scanAll(projectDir: string): Promise<ScanAllResult>;