forge-cc 1.0.0 → 1.0.2

package/dist/spec/interview.d.ts

@@ -1,142 +0,0 @@
-/**
- * Interview state tracker and coverage analyzer for spec generation.
- *
- * Pure logic — no side effects, no I/O. All state is passed in and returned.
- * The LLM (via the /forge:spec skill) drives question generation using scan
- * results, prior answers, and coverage analysis. This module tracks state,
- * analyzes coverage gaps, and provides structured summaries for PRD generation.
- *
- * **Rendering contract:** {@link InterviewQuestion} objects are designed to be
- * rendered via Claude Code's **AskUserQuestion** tool with structured
- * multiple-choice options — they must NEVER be printed as numbered text in
- * chat. The caller (the /forge:spec skill) is responsible for converting each
- * question's `text` and `context` fields into an AskUserQuestion call with
- * 2-4 predefined options derived from scan context, plus an "Other" escape
- * hatch for free-text input.
- */
-import type { ScanAllResult } from "./scanner.js";
-/** PRD sections in priority order */
-export declare const PRD_SECTIONS: readonly ["problem_and_goals", "user_stories", "technical_approach", "scope", "milestones"];
-export type PRDSection = (typeof PRD_SECTIONS)[number];
-/** Human-readable labels for each section */
-export declare const SECTION_LABELS: Record<PRDSection, string>;
-/**
- * A single interview question.
- *
- * **Rendering:** Must be presented to the user via Claude Code's
- * AskUserQuestion tool with 2-4 multiple-choice options — NEVER as numbered
- * text in chat output. The `text` field becomes the AskUserQuestion question
- * string, and the `context` field provides scan-derived framing that informs
- * option generation.
- */
-export interface InterviewQuestion {
-    id: string;
-    section: PRDSection;
-    /** The question to present via AskUserQuestion */
-    text: string;
-    /** Recommendation or observation from the codebase scan that motivates
-     *  this question and informs the multiple-choice options */
-    context: string;
-    /** Follow-up depth — 0 = top-level, 1+ = follow-up */
-    depth: number;
-}
-/** A recorded answer to a question */
-export interface InterviewAnswer {
-    questionId: string;
-    section: PRDSection;
-    answer: string;
-    timestamp: number;
-}
-/** Coverage level for a section */
-export type CoverageLevel = "none" | "thin" | "moderate" | "thorough";
-/** Completeness status for a single section */
-export interface SectionStatus {
-    section: PRDSection;
-    answeredCount: number;
-    totalWords: number;
-    coverageLevel: CoverageLevel;
-    hasGaps: boolean;
-}
-/** Full interview state — serializable, passed in/out of every function */
-export interface InterviewState {
-    projectName: string;
-    scanResults: ScanAllResult;
-    questions: InterviewQuestion[];
-    answers: InterviewAnswer[];
-    /** Counter used to generate unique question IDs */
-    nextQuestionId: number;
-    /** Tracks which sections the engine has asked top-level questions for */
-    askedSections: PRDSection[];
-    /** Number of answers recorded since the last PRD draft update */
-    answersSinceLastDraft: number;
-}
-/** Structured summary of gathered info for PRD generation */
-export interface InterviewSummary {
-    projectName: string;
-    sections: Record<PRDSection, {
-        label: string;
-        answers: Array<{
-            question: string;
-            answer: string;
-        }>;
-        coverageLevel: CoverageLevel;
-    }>;
-    scanResults: ScanAllResult;
-}
-/** Per-section coverage detail */
-export interface SectionCoverage {
-    section: PRDSection;
-    label: string;
-    answeredCount: number;
-    totalWords: number;
-    coverageLevel: CoverageLevel;
-    /** All subtopics for this section */
-    topics: string[];
-    /** Topics that appear in answers (simple substring match) */
-    mentionedTopics: string[];
-    /** topics − mentionedTopics */
-    uncoveredTopics: string[];
-}
-/** Full coverage analysis across all sections */
-export interface CoverageAnalysis {
-    sections: SectionCoverage[];
-    overallLevel: CoverageLevel;
-    hasGaps: boolean;
-}
-export declare const SECTION_TOPICS: Record<PRDSection, string[]>;
-/**
- * Initialize a new interview with codebase context.
- * The scan results inform the recommendations attached to questions.
- */
-export declare function createInterview(projectName: string, scanResults: ScanAllResult): InterviewState;
-/**
- * Register a question the LLM asked, for summary/tracking purposes.
- * The LLM drives question generation — this just records what was asked.
- */
-export declare function addQuestion(state: InterviewState, section: PRDSection, text: string, context: string, depth?: number): InterviewState;
-/**
- * Record the user's answer and return updated state.
- */
-export declare function recordAnswer(state: InterviewState, questionId: string, answer: string): InterviewState;
-/**
- * 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 declare function shouldUpdateDraft(state: InterviewState): boolean;
-/**
- * Reset the draft update counter (call after updating the PRD draft).
- */
-export declare function markDraftUpdated(state: InterviewState): InterviewState;
-/**
- * Get the completeness status for all sections.
- */
-export declare function getSectionStatuses(state: InterviewState): SectionStatus[];
-/**
- * Get detailed coverage analysis for all sections, including topic-level detail.
- * This is the primary tool for the LLM to decide what to ask next.
- */
-export declare function getCoverageAnalysis(state: InterviewState): CoverageAnalysis;
-/**
- * Build a structured summary of everything gathered, for PRD generation.
- */
-export declare function getInterviewSummary(state: InterviewState): InterviewSummary;

package/dist/spec/interview.js

@@ -1,287 +0,0 @@
-/**
- * Interview state tracker and coverage analyzer for spec generation.
- *
- * Pure logic — no side effects, no I/O. All state is passed in and returned.
- * The LLM (via the /forge:spec skill) drives question generation using scan
- * results, prior answers, and coverage analysis. This module tracks state,
- * analyzes coverage gaps, and provides structured summaries for PRD generation.
- *
- * **Rendering contract:** {@link InterviewQuestion} objects are designed to be
- * rendered via Claude Code's **AskUserQuestion** tool with structured
- * multiple-choice options — they must NEVER be printed as numbered text in
- * chat. The caller (the /forge:spec skill) is responsible for converting each
- * question's `text` and `context` fields into an AskUserQuestion call with
- * 2-4 predefined options derived from scan context, plus an "Other" escape
- * hatch for free-text input.
- */
-// ---------------------------------------------------------------------------
-// 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",
-};
-// ---------------------------------------------------------------------------
-// Section Topics — subtopic checklists the LLM uses for coverage analysis
-// ---------------------------------------------------------------------------
-export const SECTION_TOPICS = {
-    problem_and_goals: [
-        "core problem",
-        "desired outcome",
-        "success criteria",
-        "impact/urgency",
-        "current workarounds",
-        "who feels the pain",
-    ],
-    user_stories: [
-        "primary users",
-        "user workflows step-by-step",
-        "secondary users",
-        "edge cases",
-        "permissions/roles",
-        "error states",
-    ],
-    technical_approach: [
-        "architecture pattern",
-        "data model/schema",
-        "APIs/integrations",
-        "auth/security",
-        "performance requirements",
-        "error handling",
-        "existing code to leverage",
-    ],
-    scope: [
-        "in scope boundaries",
-        "out of scope",
-        "sacred files/areas",
-        "constraints",
-        "future phases explicitly deferred",
-    ],
-    milestones: [
-        "breakdown into chunks",
-        "dependencies between milestones",
-        "sizing (fits in one agent context?)",
-        "verification criteria",
-        "delivery order",
-        "risk areas",
-    ],
-};
-// ---------------------------------------------------------------------------
-// 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 Registration (LLM registers questions it asks for tracking)
-// ---------------------------------------------------------------------------
-/**
- * Register a question the LLM asked, for summary/tracking purposes.
- * The LLM drives question generation — this just records what was asked.
- */
-export function addQuestion(state, section, text, context, depth = 0) {
-    const question = {
-        id: `q${state.nextQuestionId}`,
-        section,
-        text,
-        context,
-        depth,
-    };
-    return {
-        ...state,
-        questions: [...state.questions, question],
-        nextQuestionId: state.nextQuestionId + 1,
-        askedSections: [
-            ...new Set([...state.askedSections, section]),
-        ],
-    };
-}
-// ---------------------------------------------------------------------------
-// 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,
-    };
-}
-// ---------------------------------------------------------------------------
-// Section Statuses
-// ---------------------------------------------------------------------------
-/**
- * Compute the coverage level for a section based on answer count, word count,
- * and topic coverage.
- */
-function computeCoverageLevel(answeredCount, totalWords, topics, mentionedTopics) {
-    if (answeredCount === 0)
-        return "none";
-    if (answeredCount === 1 || totalWords < 50)
-        return "thin";
-    const mostTopicsMentioned = topics.length === 0 || mentionedTopics.length >= topics.length * 0.6;
-    if (answeredCount >= 4 || (totalWords >= 200 && mostTopicsMentioned)) {
-        return "thorough";
-    }
-    if (answeredCount >= 2 && totalWords >= 50)
-        return "moderate";
-    return "thin";
-}
-/**
- * Find which SECTION_TOPICS appear in the section's answers (simple substring match).
- */
-function findMentionedTopics(answers, topics) {
-    const combined = answers.join(" ").toLowerCase();
-    return topics.filter((topic) => combined.includes(topic.toLowerCase()));
-}
-/**
- * Get the completeness status for all sections.
- */
-export function getSectionStatuses(state) {
-    return PRD_SECTIONS.map((section) => {
-        const sectionAnswers = state.answers.filter((a) => a.section === section);
-        const answeredCount = sectionAnswers.length;
-        const totalWords = sectionAnswers.reduce((sum, a) => sum + a.answer.split(/\s+/).filter(Boolean).length, 0);
-        const topics = SECTION_TOPICS[section];
-        const mentionedTopics = findMentionedTopics(sectionAnswers.map((a) => a.answer), topics);
-        const uncoveredTopics = topics.filter((t) => !mentionedTopics.includes(t));
-        const coverageLevel = computeCoverageLevel(answeredCount, totalWords, topics, mentionedTopics);
-        return {
-            section,
-            answeredCount,
-            totalWords,
-            coverageLevel,
-            hasGaps: uncoveredTopics.length > 0,
-        };
-    });
-}
-// ---------------------------------------------------------------------------
-// Coverage Analysis
-// ---------------------------------------------------------------------------
-/**
- * Get detailed coverage analysis for all sections, including topic-level detail.
- * This is the primary tool for the LLM to decide what to ask next.
- */
-export function getCoverageAnalysis(state) {
-    const sections = PRD_SECTIONS.map((section) => {
-        const sectionAnswers = state.answers.filter((a) => a.section === section);
-        const answeredCount = sectionAnswers.length;
-        const totalWords = sectionAnswers.reduce((sum, a) => sum + a.answer.split(/\s+/).filter(Boolean).length, 0);
-        const topics = SECTION_TOPICS[section];
-        const mentionedTopics = findMentionedTopics(sectionAnswers.map((a) => a.answer), topics);
-        const uncoveredTopics = topics.filter((t) => !mentionedTopics.includes(t));
-        const coverageLevel = computeCoverageLevel(answeredCount, totalWords, topics, mentionedTopics);
-        return {
-            section,
-            label: SECTION_LABELS[section],
-            answeredCount,
-            totalWords,
-            coverageLevel,
-            topics,
-            mentionedTopics,
-            uncoveredTopics,
-        };
-    });
-    const levels = sections.map((s) => s.coverageLevel);
-    const hasGaps = sections.some((s) => s.uncoveredTopics.length > 0);
-    let overallLevel;
-    if (levels.every((l) => l === "thorough")) {
-        overallLevel = "thorough";
-    }
-    else if (levels.every((l) => l === "thorough" || l === "moderate")) {
-        overallLevel = "moderate";
-    }
-    else if (levels.some((l) => l !== "none")) {
-        overallLevel = "thin";
-    }
-    else {
-        overallLevel = "none";
-    }
-    return { sections, overallLevel, hasGaps };
-}
-// ---------------------------------------------------------------------------
-// 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,
-                };
-            }),
-            coverageLevel: status.coverageLevel,
-        };
-    }
-    return {
-        projectName: state.projectName,
-        sections,
-        scanResults: state.scanResults,
-    };
-}
-//# sourceMappingURL=interview.js.map

package/dist/spec/interview.js.map

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

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

@@ -1,48 +0,0 @@
-/**
- * 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

@@ -1,125 +0,0 @@
-/**
- * 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

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