@sudocode-ai/integration-speckit 0.1.14

package/dist/parser/tasks-parser.js

@@ -0,0 +1,281 @@
+/**
+ * Tasks Parser for Spec-Kit Integration
+ *
+ * Parses tasks.md files from spec-kit and extracts individual tasks.
+ *
+ * Expected format:
+ * ```markdown
+ * # Tasks
+ *
+ * ## Phase 1: Foundation
+ *
+ * - [ ] T001 [P] Setup project structure
+ * - [ ] T002 [US1] Create user model
+ * - [x] T003: Completed task
+ *
+ * ## Phase 2: Implementation
+ *
+ * - [ ] T004 [P] [US2] Implement authentication
+ * ```
+ *
+ * Task format: `- [ ] T001 [P?] [US?] Description`
+ * - Checkbox: `[ ]` (incomplete) or `[x]` (complete)
+ * - Task ID: T followed by digits (T001, T002, etc.)
+ * - Parallelizable: Optional `[P]` marker
+ * - User Story: Optional `[US1]`, `[US2]`, etc.
+ * - Description: Rest of the line
+ */
+import { readFileSync, existsSync } from "fs";
+import { PATTERNS, extractMetadata, extractTitle, cleanTaskDescription, } from "./markdown-utils.js";
+/**
+ * Parse a tasks.md file and extract all tasks
+ *
+ * @param filePath - Absolute path to the tasks.md file
+ * @param options - Parsing options
+ * @returns Parsed tasks data or null if file doesn't exist
+ *
+ * @example
+ * const tasksFile = parseTasks("/project/.specify/specs/001-auth/tasks.md");
+ * console.log(tasksFile?.tasks.length); // 10
+ * console.log(tasksFile?.stats.completed); // 3
+ */
+export function parseTasks(filePath, options = {}) {
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        return parseTasksContent(content, filePath, options);
+    }
+    catch (error) {
+        console.error(`[tasks-parser] Failed to parse ${filePath}:`, error);
+        return null;
+    }
+}
+/**
+ * Parse tasks content from a string (for testing or in-memory parsing)
+ *
+ * @param content - Markdown content string
+ * @param filePath - Optional file path for reference
+ * @param options - Parsing options
+ * @returns Parsed tasks data or null
+ */
+export function parseTasksContent(content, filePath = "<string>", options = {}) {
+    const lines = content.split("\n");
+    const tasks = [];
+    const phases = new Map();
+    // Extract title and metadata
+    const title = extractTitle(lines);
+    const metadata = extractMetadata(lines);
+    // Track current phase
+    let currentPhase = null;
+    let currentPhaseName = null;
+    // Parse each line
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNumber = i + 1; // 1-indexed
+        // Check for phase header
+        const phaseMatch = line.match(PATTERNS.PHASE_HEADER);
+        if (phaseMatch) {
+            currentPhase = parseInt(phaseMatch[1], 10);
+            currentPhaseName = phaseMatch[2]?.trim() || null;
+            phases.set(currentPhase, currentPhaseName || `Phase ${currentPhase}`);
+            continue;
+        }
+        // Check for task line
+        const taskMatch = line.match(PATTERNS.TASK_LINE);
+        if (taskMatch) {
+            const task = parseTaskLine(line, taskMatch, lineNumber, currentPhase, currentPhaseName);
+            // Apply filters
+            if (shouldIncludeTask(task, options)) {
+                tasks.push(task);
+            }
+        }
+    }
+    // Calculate stats
+    const stats = {
+        total: tasks.length,
+        completed: tasks.filter((t) => t.completed).length,
+        incomplete: tasks.filter((t) => !t.completed).length,
+        parallelizable: tasks.filter((t) => t.parallelizable).length,
+    };
+    return {
+        title,
+        metadata,
+        tasks,
+        phases,
+        filePath,
+        stats,
+    };
+}
+/**
+ * Parse a single task line
+ */
+function parseTaskLine(line, match, lineNumber, phase, phaseName) {
+    const [, leadingSpace, checkbox, taskId, rest] = match;
+    // Calculate indent level (2 spaces = 1 level)
+    const indentLevel = Math.floor(leadingSpace.replace("-", "").length / 2);
+    // Check for parallelizable marker
+    const parallelizable = PATTERNS.PARALLELIZABLE.test(rest);
+    // Check for user story marker
+    const userStoryMatch = rest.match(PATTERNS.USER_STORY);
+    const userStory = userStoryMatch ? userStoryMatch[1] : null;
+    // Clean description
+    const description = cleanTaskDescription(rest);
+    return {
+        taskId,
+        description,
+        completed: checkbox.toLowerCase() === "x",
+        parallelizable,
+        userStory,
+        phase,
+        phaseName,
+        lineNumber,
+        indentLevel,
+        rawLine: line,
+    };
+}
+/**
+ * Check if a task should be included based on filters
+ */
+function shouldIncludeTask(task, options) {
+    // Phase filter
+    if (options.filterPhases && options.filterPhases.length > 0) {
+        if (task.phase === null || !options.filterPhases.includes(task.phase)) {
+            return false;
+        }
+    }
+    // Incomplete only filter
+    if (options.incompleteOnly && task.completed) {
+        return false;
+    }
+    // Parallelizable only filter
+    if (options.parallelizableOnly && !task.parallelizable) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Get all tasks from a file as a simple array
+ *
+ * @param filePath - Path to the tasks file
+ * @returns Array of parsed tasks or empty array
+ */
+export function getAllTasks(filePath) {
+    const result = parseTasks(filePath);
+    return result?.tasks || [];
+}
+/**
+ * Get a specific task by ID
+ *
+ * @param filePath - Path to the tasks file
+ * @param taskId - Task ID to find (e.g., "T001")
+ * @returns The task or null if not found
+ */
+export function getTaskById(filePath, taskId) {
+    const tasks = getAllTasks(filePath);
+    return tasks.find((t) => t.taskId === taskId) || null;
+}
+/**
+ * Get incomplete tasks ready for work (not blocked by dependencies)
+ *
+ * @param filePath - Path to the tasks file
+ * @returns Array of incomplete tasks
+ */
+export function getIncompleteTasks(filePath) {
+    const result = parseTasks(filePath, { incompleteOnly: true });
+    return result?.tasks || [];
+}
+/**
+ * Get tasks that can be worked on in parallel
+ *
+ * @param filePath - Path to the tasks file
+ * @returns Array of parallelizable incomplete tasks
+ */
+export function getParallelizableTasks(filePath) {
+    const result = parseTasks(filePath, {
+        incompleteOnly: true,
+        parallelizableOnly: true,
+    });
+    return result?.tasks || [];
+}
+/**
+ * Get tasks grouped by phase
+ *
+ * @param filePath - Path to the tasks file
+ * @returns Map of phase number to tasks in that phase
+ */
+export function getTasksByPhase(filePath) {
+    const result = parseTasks(filePath);
+    const byPhase = new Map();
+    if (!result)
+        return byPhase;
+    for (const task of result.tasks) {
+        const phase = task.phase ?? 0; // Default to phase 0 for tasks without phase
+        const phaseTasks = byPhase.get(phase) || [];
+        phaseTasks.push(task);
+        byPhase.set(phase, phaseTasks);
+    }
+    return byPhase;
+}
+/**
+ * Get tasks grouped by user story
+ *
+ * @param filePath - Path to the tasks file
+ * @returns Map of user story ID to tasks
+ */
+export function getTasksByUserStory(filePath) {
+    const result = parseTasks(filePath);
+    const byUserStory = new Map();
+    if (!result)
+        return byUserStory;
+    for (const task of result.tasks) {
+        const storyTasks = byUserStory.get(task.userStory) || [];
+        storyTasks.push(task);
+        byUserStory.set(task.userStory, storyTasks);
+    }
+    return byUserStory;
+}
+/**
+ * Check if a file appears to be a valid tasks.md file
+ *
+ * @param filePath - Path to check
+ * @returns true if the file looks like a tasks file
+ */
+export function isTasksFile(filePath) {
+    if (!existsSync(filePath)) {
+        return false;
+    }
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        const lines = content.split("\n").slice(0, 30); // Check first 30 lines
+        // Look for task-like lines
+        for (const line of lines) {
+            if (PATTERNS.TASK_LINE.test(line)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get task completion statistics
+ *
+ * @param filePath - Path to the tasks file
+ * @returns Statistics object or null
+ */
+export function getTaskStats(filePath) {
+    const result = parseTasks(filePath);
+    if (!result)
+        return null;
+    return {
+        ...result.stats,
+        completionRate: result.stats.total > 0
+            ? Math.round((result.stats.completed / result.stats.total) * 100)
+            : 0,
+    };
+}
+//# sourceMappingURL=tasks-parser.js.map

package/dist/parser/tasks-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-parser.js","sourceRoot":"","sources":["../../src/parser/tasks-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EACL,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,oBAAoB,GAErB,MAAM,qBAAqB,CAAC;AA+D7B;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,UAA6B,EAAE;IAE/B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,kCAAkC,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,WAAmB,UAAU,EAC7B,UAA6B,EAAE;IAE/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAwB,IAAI,GAAG,EAAE,CAAC;IAE9C,6BAA6B;IAC7B,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAExC,sBAAsB;IACtB,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,IAAI,gBAAgB,GAAkB,IAAI,CAAC;IAE3C,kBAAkB;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY;QAEtC,yBAAyB;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACrD,IAAI,UAAU,EAAE,CAAC;YACf,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3C,gBAAgB,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;YACjD,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,gBAAgB,IAAI,SAAS,YAAY,EAAE,CAAC,CAAC;YACtE,SAAS;QACX,CAAC;QAED,sBAAsB;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,IAAI,GAAG,aAAa,CACxB,IAAI,EACJ,SAAS,EACT,UAAU,EACV,YAAY,EACZ,gBAAgB,CACjB,CAAC;YAEF,gBAAgB;YAChB,IAAI,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;gBACrC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,MAAM,KAAK,GAAG;QACZ,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM;QAClD,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM;QACpD,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,MAAM;KAC7D,CAAC;IAEF,OAAO;QACL,KAAK;QACL,QAAQ;QACR,KAAK;QACL,MAAM;QACN,QAAQ;QACR,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACpB,IAAY,EACZ,KAAuB,EACvB,UAAkB,EAClB,KAAoB,EACpB,SAAwB;IAExB,MAAM,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IAEvD,8CAA8C;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEzE,kCAAkC;IAClC,MAAM,cAAc,GAAG,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE1D,8BAA8B;IAC9B,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE5D,oBAAoB;IACpB,MAAM,WAAW,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAE/C,OAAO;QACL,MAAM;QACN,WAAW;QACX,SAAS,EAAE,QAAQ,CAAC,WAAW,EAAE,KAAK,GAAG;QACzC,cAAc;QACd,SAAS;QACT,KAAK;QACL,SAAS;QACT,UAAU;QACV,WAAW;QACX,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACxB,IAAgB,EAChB,OAA0B;IAE1B,eAAe;IACf,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACtE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,IAAI,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6BAA6B;IAC7B,IAAI,OAAO,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QACvD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,MAAc;IAEd,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,OAAO,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE;QAClC,cAAc,EAAE,IAAI;QACpB,kBAAkB,EAAE,IAAI;KACzB,CAAC,CAAC;IACH,OAAO,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEhD,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC;IAE5B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,6CAA6C;QAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB;IAEhB,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,IAAI,GAAG,EAA+B,CAAC;IAE3D,IAAI,CAAC,MAAM;QAAE,OAAO,WAAW,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACzD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,uBAAuB;QAEvE,2BAA2B;QAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAO3C,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,OAAO;QACL,GAAG,MAAM,CAAC,KAAK;QACf,cAAc,EACZ,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC;YACpB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;YACjE,CAAC,CAAC,CAAC;KACR,CAAC;AACJ,CAAC"}

package/dist/relationship-mapper.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Relationship Mapping for Spec-Kit Integration
+ *
+ * Maps spec-kit file hierarchy to sudocode relationships.
+ *
+ * Spec-kit hierarchy:
+ * ```
+ * spec.md (root)
+ *   └── plan.md (implements spec.md)
+ *         ├── tasks (implement plan.md)
+ *         ├── research.md (references plan.md)
+ *         ├── data-model.md (references plan.md)
+ *         └── contracts/* (references plan.md)
+ * ```
+ *
+ * This creates a clear dependency graph:
+ * - plan implements spec (spec defines WHAT, plan defines HOW)
+ * - tasks implement plan (tasks are actionable work items from the plan)
+ * - supporting docs reference plan (research, data models, contracts support the plan)
+ */
+import type { RelationshipType, EntityType } from "@sudocode-ai/types";
+/**
+ * A relationship to be created in sudocode
+ */
+export interface MappedRelationship {
+    /** Source entity ID */
+    fromId: string;
+    /** Source entity type */
+    fromType: EntityType;
+    /** Target entity ID */
+    toId: string;
+    /** Target entity type */
+    toType: EntityType;
+    /** Relationship type */
+    relationshipType: RelationshipType;
+}
+/**
+ * Task information for relationship mapping
+ */
+export interface TaskInfo {
+    /** Task ID from tasks.md (e.g., "T001", "T002") */
+    taskId: string;
+    /** Optional: task dependencies (other task IDs this task depends on) */
+    dependsOn?: string[];
+}
+/**
+ * Supporting document information
+ */
+export interface SupportingDocInfo {
+    /** File type identifier (e.g., "research", "data-model", "contract-api-spec") */
+    fileType: string;
+    /** Entity type in sudocode */
+    entityType: EntityType;
+}
+/**
+ * Map all relationships for a spec-kit feature
+ *
+ * Creates the standard relationship hierarchy:
+ * 1. plan implements spec
+ * 2. each task implements plan
+ * 3. supporting docs reference plan
+ *
+ * @param featureNumber - Feature number (e.g., "001")
+ * @param prefix - Spec ID prefix (default: "sk")
+ * @param taskPrefix - Task issue ID prefix (default: "skt")
+ * @param tasks - Array of task information from tasks.md
+ * @param supportingDocs - Optional array of supporting documents to include
+ * @returns Array of relationships to create
+ *
+ * @example
+ * const relationships = mapFeatureRelationships("001", "sk", "skt", [
+ *   { taskId: "T001" },
+ *   { taskId: "T002", dependsOn: ["T001"] },
+ * ]);
+ * // Returns relationships:
+ * // - sk-001-plan implements sk-001-spec
+ * // - skt-001-T001 implements sk-001-plan
+ * // - skt-001-T002 implements sk-001-plan
+ * // - skt-001-T002 depends-on skt-001-T001
+ */
+export declare function mapFeatureRelationships(featureNumber: string, prefix?: string, taskPrefix?: string, tasks?: TaskInfo[], supportingDocs?: SupportingDocInfo[]): MappedRelationship[];
+/**
+ * Map relationships for task dependencies within a feature
+ *
+ * @param featureNumber - Feature number (e.g., "001")
+ * @param taskPrefix - Task issue ID prefix (default: "skt")
+ * @param tasks - Array of tasks with their dependencies
+ * @returns Array of depends-on relationships between tasks
+ *
+ * @example
+ * const deps = mapTaskDependencies("001", "skt", [
+ *   { taskId: "T001" },
+ *   { taskId: "T002", dependsOn: ["T001"] },
+ *   { taskId: "T003", dependsOn: ["T001", "T002"] },
+ * ]);
+ * // Returns:
+ * // - skt-001-T002 depends-on skt-001-T001
+ * // - skt-001-T003 depends-on skt-001-T001
+ * // - skt-001-T003 depends-on skt-001-T002
+ */
+export declare function mapTaskDependencies(featureNumber: string, taskPrefix: string | undefined, tasks: TaskInfo[]): MappedRelationship[];
+/**
+ * Map relationships for supporting documents in a feature
+ *
+ * @param featureNumber - Feature number (e.g., "001")
+ * @param prefix - Spec ID prefix (default: "sk")
+ * @param supportingDocs - Array of supporting document information
+ * @returns Array of reference relationships to the plan
+ *
+ * @example
+ * const refs = mapSupportingDocRelationships("001", "sk", [
+ *   { fileType: "research", entityType: "spec" },
+ *   { fileType: "data-model", entityType: "spec" },
+ *   { fileType: "contract-api-spec", entityType: "spec" },
+ * ]);
+ * // Returns:
+ * // - sk-001-research references sk-001-plan
+ * // - sk-001-data-model references sk-001-plan
+ * // - sk-001-contract-api-spec references sk-001-plan
+ */
+export declare function mapSupportingDocRelationships(featureNumber: string, prefix: string | undefined, supportingDocs: SupportingDocInfo[]): MappedRelationship[];
+/**
+ * Map the core spec->plan relationship for a feature
+ *
+ * @param featureNumber - Feature number (e.g., "001")
+ * @param prefix - Spec ID prefix (default: "sk")
+ * @returns The implements relationship from plan to spec
+ *
+ * @example
+ * const rel = mapPlanToSpecRelationship("001");
+ * // Returns: sk-001-plan implements sk-001-spec
+ */
+export declare function mapPlanToSpecRelationship(featureNumber: string, prefix?: string): MappedRelationship;
+/**
+ * Map a single task's relationship to its plan
+ *
+ * @param featureNumber - Feature number (e.g., "001")
+ * @param taskId - Task ID (e.g., "T001")
+ * @param prefix - Spec ID prefix (default: "sk")
+ * @param taskPrefix - Task issue ID prefix (default: "skt")
+ * @returns The implements relationship from task to plan
+ *
+ * @example
+ * const rel = mapTaskToPlanRelationship("001", "T001");
+ * // Returns: skt-001-T001 implements sk-001-plan
+ */
+export declare function mapTaskToPlanRelationship(featureNumber: string, taskId: string, prefix?: string, taskPrefix?: string): MappedRelationship;
+/**
+ * Determine the standard supporting doc types for a feature
+ *
+ * @returns Array of standard supporting document types
+ */
+export declare function getStandardSupportingDocTypes(): SupportingDocInfo[];
+/**
+ * Create a contract document info for relationship mapping
+ *
+ * @param contractName - Contract file name without extension (e.g., "api-spec")
+ * @returns Supporting doc info for the contract
+ *
+ * @example
+ * createContractDocInfo("api-spec")
+ * // Returns: { fileType: "contract-api-spec", entityType: "spec" }
+ */
+export declare function createContractDocInfo(contractName: string): SupportingDocInfo;
+//# sourceMappingURL=relationship-mapper.d.ts.map

package/dist/relationship-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-mapper.d.ts","sourceRoot":"","sources":["../src/relationship-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAOvE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,wBAAwB;IACxB,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,MAAa,EACrB,UAAU,GAAE,MAAc,EAC1B,KAAK,GAAE,QAAQ,EAAO,EACtB,cAAc,GAAE,iBAAiB,EAAO,GACvC,kBAAkB,EAAE,CA+DtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,YAAQ,EAC1B,KAAK,EAAE,QAAQ,EAAE,GAChB,kBAAkB,EAAE,CA6BtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,YAAO,EACrB,cAAc,EAAE,iBAAiB,EAAE,GAClC,kBAAkB,EAAE,CAgBtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,MAAa,GACpB,kBAAkB,CAQpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAa,EACrB,UAAU,GAAE,MAAc,GACzB,kBAAkB,CAQpB;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,iBAAiB,EAAE,CAKnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB,CAK7E"}