@sudocode-ai/integration-speckit 0.1.14

package/dist/parser/supporting-docs.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Supporting Documents Parser for Spec-Kit Integration
+ *
+ * Parses supporting documents in spec-kit feature directories:
+ * - research.md - Research notes and findings
+ * - data-model.md - Data model definitions
+ * - contracts/*.json - API contracts and schemas
+ *
+ * These documents reference the plan and provide additional context.
+ */
+/**
+ * Types of supporting documents
+ */
+export type SupportingDocType = "research" | "data-model" | "contract" | "other";
+/**
+ * Parsed supporting document
+ */
+export interface ParsedSupportingDoc {
+    /** Document type */
+    type: SupportingDocType;
+    /** Document title (from # header or filename) */
+    title: string;
+    /** All metadata key-value pairs */
+    metadata: Map<string, string>;
+    /** Main content */
+    content: string;
+    /** Cross-references found in the content */
+    crossReferences: Array<{
+        id: string;
+        displayText?: string;
+    }>;
+    /** Source file path */
+    filePath: string;
+    /** File name without extension */
+    fileName: string;
+    /** File extension */
+    fileExtension: string;
+}
+/**
+ * Parsed contract document (JSON/YAML)
+ */
+export interface ParsedContract {
+    /** Contract name (from filename) */
+    name: string;
+    /** Parsed contract data */
+    data: Record<string, unknown>;
+    /** Source file path */
+    filePath: string;
+    /** File format (json, yaml, yml) */
+    format: "json" | "yaml";
+}
+/**
+ * Options for parsing supporting documents
+ */
+export interface ParseSupportingDocOptions {
+    /** Whether to include full content (default: true) */
+    includeContent?: boolean;
+    /** Whether to extract cross-references (default: true) */
+    extractReferences?: boolean;
+}
+/**
+ * Parse a research.md file
+ *
+ * @param filePath - Absolute path to the research.md file
+ * @param options - Parsing options
+ * @returns Parsed document or null
+ */
+export declare function parseResearch(filePath: string, options?: ParseSupportingDocOptions): ParsedSupportingDoc | null;
+/**
+ * Parse a data-model.md file
+ *
+ * @param filePath - Absolute path to the data-model.md file
+ * @param options - Parsing options
+ * @returns Parsed document or null
+ */
+export declare function parseDataModel(filePath: string, options?: ParseSupportingDocOptions): ParsedSupportingDoc | null;
+/**
+ * Parse any supporting markdown document
+ *
+ * @param filePath - Absolute path to the file
+ * @param type - Document type
+ * @param options - Parsing options
+ * @returns Parsed document or null
+ */
+export declare function parseSupportingDoc(filePath: string, type?: SupportingDocType, options?: ParseSupportingDocOptions): ParsedSupportingDoc | null;
+/**
+ * Parse a contract file (JSON or YAML)
+ *
+ * @param filePath - Absolute path to the contract file
+ * @returns Parsed contract or null
+ */
+export declare function parseContract(filePath: string): ParsedContract | null;
+/**
+ * Parse all contracts in a directory
+ *
+ * @param contractsDir - Path to the contracts directory
+ * @returns Array of parsed contracts
+ */
+export declare function parseContractsDirectory(contractsDir: string): ParsedContract[];
+/**
+ * Discover and parse all supporting documents in a feature directory
+ *
+ * @param featureDir - Path to the feature directory (e.g., .specify/specs/001-auth)
+ * @returns Object containing all parsed supporting documents
+ */
+export declare function discoverSupportingDocs(featureDir: string): {
+    research: ParsedSupportingDoc | null;
+    dataModel: ParsedSupportingDoc | null;
+    contracts: ParsedContract[];
+    other: ParsedSupportingDoc[];
+};
+/**
+ * Detect the type of a supporting document from its filename
+ *
+ * @param filePath - Path to the file
+ * @returns Document type
+ */
+export declare function detectDocType(filePath: string): SupportingDocType;
+//# sourceMappingURL=supporting-docs.d.ts.map

package/dist/parser/supporting-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supporting-docs.d.ts","sourceRoot":"","sources":["../../src/parser/supporting-docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,YAAY,GACZ,UAAU,GACV,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,IAAI,EAAE,iBAAiB,CAAC;IACxB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,eAAe,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,sDAAsD;IACtD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,yBAA8B,GACtC,mBAAmB,GAAG,IAAI,CAE5B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,yBAA8B,GACtC,mBAAmB,GAAG,IAAI,CAE5B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,iBAA2B,EACjC,OAAO,GAAE,yBAA8B,GACtC,mBAAmB,GAAG,IAAI,CA+C5B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAsCrE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,GACnB,cAAc,EAAE,CAgClB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG;IAC1D,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACrC,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACtC,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAC9B,CA6DA;AAuGD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAUjE"}

package/dist/parser/supporting-docs.js

@@ -0,0 +1,324 @@
+/**
+ * Supporting Documents Parser for Spec-Kit Integration
+ *
+ * Parses supporting documents in spec-kit feature directories:
+ * - research.md - Research notes and findings
+ * - data-model.md - Data model definitions
+ * - contracts/*.json - API contracts and schemas
+ *
+ * These documents reference the plan and provide additional context.
+ */
+import { readFileSync, existsSync, readdirSync, statSync } from "fs";
+import { join, basename, extname } from "path";
+import { extractMetadata, extractTitle, extractCrossReferences, findContentStartIndex, } from "./markdown-utils.js";
+/**
+ * Parse a research.md file
+ *
+ * @param filePath - Absolute path to the research.md file
+ * @param options - Parsing options
+ * @returns Parsed document or null
+ */
+export function parseResearch(filePath, options = {}) {
+    return parseSupportingDoc(filePath, "research", options);
+}
+/**
+ * Parse a data-model.md file
+ *
+ * @param filePath - Absolute path to the data-model.md file
+ * @param options - Parsing options
+ * @returns Parsed document or null
+ */
+export function parseDataModel(filePath, options = {}) {
+    return parseSupportingDoc(filePath, "data-model", options);
+}
+/**
+ * Parse any supporting markdown document
+ *
+ * @param filePath - Absolute path to the file
+ * @param type - Document type
+ * @param options - Parsing options
+ * @returns Parsed document or null
+ */
+export function parseSupportingDoc(filePath, type = "other", options = {}) {
+    const { includeContent = true, extractReferences = true } = options;
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const rawContent = readFileSync(filePath, "utf-8");
+        const lines = rawContent.split("\n");
+        const fileName = basename(filePath, extname(filePath));
+        const fileExtension = extname(filePath).slice(1); // Remove leading dot
+        // Extract title (use filename if no title in content)
+        const title = extractTitle(lines) || formatFileName(fileName);
+        // Extract metadata
+        const metadata = extractMetadata(lines);
+        // Extract main content
+        let content = "";
+        if (includeContent) {
+            const contentStartIndex = findContentStartIndex(lines);
+            content = lines.slice(contentStartIndex).join("\n").trim();
+        }
+        // Extract cross-references
+        let crossReferences = [];
+        if (extractReferences) {
+            crossReferences = extractCrossReferences(rawContent);
+        }
+        return {
+            type,
+            title,
+            metadata,
+            content,
+            crossReferences,
+            filePath,
+            fileName,
+            fileExtension,
+        };
+    }
+    catch (error) {
+        console.error(`[supporting-docs] Failed to parse ${filePath}:`, error);
+        return null;
+    }
+}
+/**
+ * Parse a contract file (JSON or YAML)
+ *
+ * @param filePath - Absolute path to the contract file
+ * @returns Parsed contract or null
+ */
+export function parseContract(filePath) {
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const ext = extname(filePath).toLowerCase();
+        const name = basename(filePath, ext);
+        const rawContent = readFileSync(filePath, "utf-8");
+        let data;
+        let format;
+        if (ext === ".json") {
+            data = JSON.parse(rawContent);
+            format = "json";
+        }
+        else if (ext === ".yaml" || ext === ".yml") {
+            // Simple YAML parsing (for basic structures)
+            // Note: For complex YAML, a proper library should be used
+            data = parseSimpleYaml(rawContent);
+            format = "yaml";
+        }
+        else {
+            return null; // Unsupported format
+        }
+        return {
+            name,
+            data,
+            filePath,
+            format,
+        };
+    }
+    catch (error) {
+        console.error(`[supporting-docs] Failed to parse contract ${filePath}:`, error);
+        return null;
+    }
+}
+/**
+ * Parse all contracts in a directory
+ *
+ * @param contractsDir - Path to the contracts directory
+ * @returns Array of parsed contracts
+ */
+export function parseContractsDirectory(contractsDir) {
+    if (!existsSync(contractsDir)) {
+        return [];
+    }
+    try {
+        const contracts = [];
+        const entries = readdirSync(contractsDir);
+        for (const entry of entries) {
+            const filePath = join(contractsDir, entry);
+            const stats = statSync(filePath);
+            if (stats.isFile()) {
+                const ext = extname(entry).toLowerCase();
+                if ([".json", ".yaml", ".yml"].includes(ext)) {
+                    const contract = parseContract(filePath);
+                    if (contract) {
+                        contracts.push(contract);
+                    }
+                }
+            }
+        }
+        return contracts;
+    }
+    catch (error) {
+        console.error(`[supporting-docs] Failed to parse contracts directory:`, error);
+        return [];
+    }
+}
+/**
+ * Discover and parse all supporting documents in a feature directory
+ *
+ * @param featureDir - Path to the feature directory (e.g., .specify/specs/001-auth)
+ * @returns Object containing all parsed supporting documents
+ */
+export function discoverSupportingDocs(featureDir) {
+    const result = {
+        research: null,
+        dataModel: null,
+        contracts: [],
+        other: [],
+    };
+    if (!existsSync(featureDir)) {
+        return result;
+    }
+    // Parse research.md
+    const researchPath = join(featureDir, "research.md");
+    if (existsSync(researchPath)) {
+        result.research = parseResearch(researchPath);
+    }
+    // Parse data-model.md
+    const dataModelPath = join(featureDir, "data-model.md");
+    if (existsSync(dataModelPath)) {
+        result.dataModel = parseDataModel(dataModelPath);
+    }
+    // Parse contracts directory
+    const contractsDir = join(featureDir, "contracts");
+    if (existsSync(contractsDir)) {
+        result.contracts = parseContractsDirectory(contractsDir);
+    }
+    // Look for other markdown files (exclude spec.md, plan.md, tasks.md)
+    try {
+        const entries = readdirSync(featureDir);
+        const knownFiles = [
+            "spec.md",
+            "plan.md",
+            "tasks.md",
+            "research.md",
+            "data-model.md",
+        ];
+        for (const entry of entries) {
+            const filePath = join(featureDir, entry);
+            const stats = statSync(filePath);
+            if (stats.isFile() &&
+                entry.endsWith(".md") &&
+                !knownFiles.includes(entry.toLowerCase())) {
+                const doc = parseSupportingDoc(filePath, "other");
+                if (doc) {
+                    result.other.push(doc);
+                }
+            }
+        }
+    }
+    catch {
+        // Ignore errors listing directory
+    }
+    return result;
+}
+/**
+ * Simple YAML parser for basic structures
+ * For complex YAML, a proper library like js-yaml should be used
+ */
+function parseSimpleYaml(content) {
+    const result = {};
+    const lines = content.split("\n");
+    let currentKey = "";
+    let currentIndent = 0;
+    const stack = [
+        { obj: result, indent: -1 },
+    ];
+    for (const line of lines) {
+        // Skip comments and empty lines
+        if (line.trim().startsWith("#") || line.trim() === "") {
+            continue;
+        }
+        // Calculate indentation
+        const match = line.match(/^(\s*)/);
+        const indent = match ? match[1].length : 0;
+        // Pop stack to find correct parent
+        while (stack.length > 1 && stack[stack.length - 1].indent >= indent) {
+            stack.pop();
+        }
+        const parent = stack[stack.length - 1].obj;
+        // Parse key-value
+        const kvMatch = line.trim().match(/^([^:]+):\s*(.*)$/);
+        if (kvMatch) {
+            const [, key, value] = kvMatch;
+            const trimmedKey = key.trim();
+            const trimmedValue = value.trim();
+            if (trimmedValue === "" || trimmedValue === "|" || trimmedValue === ">") {
+                // Start of nested object or multiline string
+                parent[trimmedKey] = {};
+                stack.push({
+                    obj: parent[trimmedKey],
+                    indent,
+                });
+                currentKey = trimmedKey;
+                currentIndent = indent;
+            }
+            else {
+                // Simple key-value
+                parent[trimmedKey] = parseYamlValue(trimmedValue);
+            }
+        }
+        else if (line.trim().startsWith("-")) {
+            // Array item
+            const itemValue = line.trim().slice(1).trim();
+            if (!Array.isArray(parent[currentKey])) {
+                parent[currentKey] = [];
+            }
+            parent[currentKey].push(parseYamlValue(itemValue));
+        }
+    }
+    return result;
+}
+/**
+ * Parse a simple YAML value
+ */
+function parseYamlValue(value) {
+    // Remove quotes
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+        return value.slice(1, -1);
+    }
+    // Boolean
+    if (value.toLowerCase() === "true")
+        return true;
+    if (value.toLowerCase() === "false")
+        return false;
+    // Null
+    if (value.toLowerCase() === "null" || value === "~")
+        return null;
+    // Number
+    if (/^-?\d+$/.test(value))
+        return parseInt(value, 10);
+    if (/^-?\d+\.\d+$/.test(value))
+        return parseFloat(value);
+    // String
+    return value;
+}
+/**
+ * Format a filename for display (convert kebab-case to Title Case)
+ */
+function formatFileName(fileName) {
+    return fileName
+        .split(/[-_]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join(" ");
+}
+/**
+ * Detect the type of a supporting document from its filename
+ *
+ * @param filePath - Path to the file
+ * @returns Document type
+ */
+export function detectDocType(filePath) {
+    const fileName = basename(filePath).toLowerCase();
+    if (fileName === "research.md")
+        return "research";
+    if (fileName === "data-model.md")
+        return "data-model";
+    if (filePath.includes("/contracts/") || filePath.includes("\\contracts\\")) {
+        return "contract";
+    }
+    return "other";
+}
+//# sourceMappingURL=supporting-docs.js.map

package/dist/parser/supporting-docs.js.map

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

package/dist/parser/tasks-parser.d.ts

@@ -0,0 +1,171 @@
+/**
+ * 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
+ */
+/**
+ * Parsed task from a tasks.md file
+ */
+export interface ParsedTask {
+    /** Task identifier (e.g., "T001") */
+    taskId: string;
+    /** Task description (cleaned of markers) */
+    description: string;
+    /** Whether the task is completed */
+    completed: boolean;
+    /** Whether the task can be done in parallel with others */
+    parallelizable: boolean;
+    /** User story reference if present (e.g., "1", "2") */
+    userStory: string | null;
+    /** Phase number if the task is in a phase section */
+    phase: number | null;
+    /** Phase name if available */
+    phaseName: string | null;
+    /** Line number in the source file (1-indexed) */
+    lineNumber: number;
+    /** Indentation level (for nested tasks) */
+    indentLevel: number;
+    /** Raw line from the file */
+    rawLine: string;
+}
+/**
+ * Parsed result from a tasks.md file
+ */
+export interface ParsedTasksFile {
+    /** Optional title from the file */
+    title: string | null;
+    /** All metadata key-value pairs */
+    metadata: Map<string, string>;
+    /** Array of parsed tasks */
+    tasks: ParsedTask[];
+    /** Map of phase number to phase name */
+    phases: Map<number, string>;
+    /** Source file path */
+    filePath: string;
+    /** Summary statistics */
+    stats: {
+        total: number;
+        completed: number;
+        incomplete: number;
+        parallelizable: number;
+    };
+}
+/**
+ * Options for parsing tasks files
+ */
+export interface ParseTasksOptions {
+    /** Filter to only include tasks in specific phases */
+    filterPhases?: number[];
+    /** Filter to only include incomplete tasks */
+    incompleteOnly?: boolean;
+    /** Filter to only include parallelizable tasks */
+    parallelizableOnly?: boolean;
+}
+/**
+ * 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 declare function parseTasks(filePath: string, options?: ParseTasksOptions): ParsedTasksFile | 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 declare function parseTasksContent(content: string, filePath?: string, options?: ParseTasksOptions): ParsedTasksFile | null;
+/**
+ * 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 declare function getAllTasks(filePath: string): ParsedTask[];
+/**
+ * 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 declare function getTaskById(filePath: string, taskId: string): ParsedTask | null;
+/**
+ * Get incomplete tasks ready for work (not blocked by dependencies)
+ *
+ * @param filePath - Path to the tasks file
+ * @returns Array of incomplete tasks
+ */
+export declare function getIncompleteTasks(filePath: string): ParsedTask[];
+/**
+ * Get tasks that can be worked on in parallel
+ *
+ * @param filePath - Path to the tasks file
+ * @returns Array of parallelizable incomplete tasks
+ */
+export declare function getParallelizableTasks(filePath: string): ParsedTask[];
+/**
+ * Get tasks grouped by phase
+ *
+ * @param filePath - Path to the tasks file
+ * @returns Map of phase number to tasks in that phase
+ */
+export declare function getTasksByPhase(filePath: string): Map<number, ParsedTask[]>;
+/**
+ * Get tasks grouped by user story
+ *
+ * @param filePath - Path to the tasks file
+ * @returns Map of user story ID to tasks
+ */
+export declare function getTasksByUserStory(filePath: string): Map<string | null, ParsedTask[]>;
+/**
+ * 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 declare function isTasksFile(filePath: string): boolean;
+/**
+ * Get task completion statistics
+ *
+ * @param filePath - Path to the tasks file
+ * @returns Statistics object or null
+ */
+export declare function getTaskStats(filePath: string): {
+    total: number;
+    completed: number;
+    incomplete: number;
+    parallelizable: number;
+    completionRate: number;
+} | null;
+//# sourceMappingURL=tasks-parser.d.ts.map

package/dist/parser/tasks-parser.d.ts.map

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