@sudocode-ai/integration-speckit 0.1.14

package/dist/writer/spec-writer.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Spec Writer for Spec-Kit Integration
+ *
+ * Updates spec.md and plan.md content while preserving document structure.
+ * Handles title updates in headers and status line updates.
+ */
+/**
+ * Updates to apply to a spec file
+ */
+export interface SpecUpdates {
+    /** New title (will update # header) */
+    title?: string;
+    /** New status (will update **Status**: line) */
+    status?: string;
+    /** New content (will replace everything after frontmatter/header) */
+    content?: string;
+}
+/**
+ * Result of a spec update operation
+ */
+export interface SpecUpdateResult {
+    success: boolean;
+    error?: string;
+    changes: {
+        title?: {
+            from: string;
+            to: string;
+        };
+        status?: {
+            from: string;
+            to: string;
+        };
+        content?: boolean;
+    };
+}
+/**
+ * Update spec content while preserving document structure
+ *
+ * @param specFilePath - Absolute path to the spec.md or plan.md file
+ * @param updates - Updates to apply (title, status, content)
+ * @returns Result of the update operation
+ *
+ * @example
+ * // Update just the status
+ * updateSpecContent("/project/.specify/specs/001-auth/spec.md", {
+ *   status: "In Progress"
+ * });
+ *
+ * // Update title and status
+ * updateSpecContent("/project/.specify/specs/001-auth/spec.md", {
+ *   title: "Authentication System",
+ *   status: "Complete"
+ * });
+ */
+export declare function updateSpecContent(specFilePath: string, updates: SpecUpdates): SpecUpdateResult;
+/**
+ * Get the current title from a spec file
+ *
+ * @param specFilePath - Absolute path to the spec file
+ * @returns The title or null if not found
+ */
+export declare function getSpecTitle(specFilePath: string): string | null;
+/**
+ * Get the current status from a spec file
+ *
+ * @param specFilePath - Absolute path to the spec file
+ * @returns The status or null if not found
+ */
+export declare function getSpecStatus(specFilePath: string): string | null;
+//# sourceMappingURL=spec-writer.d.ts.map

package/dist/writer/spec-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-writer.d.ts","sourceRoot":"","sources":["../../src/writer/spec-writer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,KAAK,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QACrC,MAAM,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QACtC,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AA6BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,WAAW,GACnB,gBAAgB,CAsGlB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWhE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWjE"}

package/dist/writer/spec-writer.js

@@ -0,0 +1,261 @@
+/**
+ * Spec Writer for Spec-Kit Integration
+ *
+ * Updates spec.md and plan.md content while preserving document structure.
+ * Handles title updates in headers and status line updates.
+ */
+import { readFileSync, writeFileSync, existsSync, renameSync } from "fs";
+import { dirname } from "path";
+import { mkdirSync } from "fs";
+/**
+ * Regex patterns for spec-kit markdown structure
+ */
+const TITLE_REGEX = /^#\s+(.+)$/;
+const STATUS_REGEX = /^\*\*Status\*\*:\s*(.*)$/i;
+const METADATA_LINE_REGEX = /^\*\*[^*]+\*\*:/;
+/**
+ * Update spec content while preserving document structure
+ *
+ * @param specFilePath - Absolute path to the spec.md or plan.md file
+ * @param updates - Updates to apply (title, status, content)
+ * @returns Result of the update operation
+ *
+ * @example
+ * // Update just the status
+ * updateSpecContent("/project/.specify/specs/001-auth/spec.md", {
+ *   status: "In Progress"
+ * });
+ *
+ * // Update title and status
+ * updateSpecContent("/project/.specify/specs/001-auth/spec.md", {
+ *   title: "Authentication System",
+ *   status: "Complete"
+ * });
+ */
+export function updateSpecContent(specFilePath, updates) {
+    const result = {
+        success: false,
+        changes: {},
+    };
+    // Validate inputs
+    if (!specFilePath) {
+        result.error = "Spec file path is required";
+        return result;
+    }
+    if (!updates.title && !updates.status && updates.content === undefined) {
+        result.error = "At least one update (title, status, or content) is required";
+        return result;
+    }
+    // Check if file exists
+    if (!existsSync(specFilePath)) {
+        result.error = `Spec file not found: ${specFilePath}`;
+        return result;
+    }
+    try {
+        // Parse the file
+        const parsed = parseSpecFile(specFilePath);
+        const lines = [...parsed.lines];
+        // Apply title update
+        if (updates.title !== undefined && updates.title !== parsed.currentTitle) {
+            if (parsed.titleLineIndex !== null) {
+                lines[parsed.titleLineIndex] = `# ${updates.title}`;
+                result.changes.title = {
+                    from: parsed.currentTitle || "",
+                    to: updates.title,
+                };
+            }
+            else {
+                // No title found, prepend one
+                lines.unshift(`# ${updates.title}`, "");
+                result.changes.title = {
+                    from: "",
+                    to: updates.title,
+                };
+            }
+        }
+        // Apply status update
+        if (updates.status !== undefined && updates.status !== parsed.currentStatus) {
+            if (parsed.statusLineIndex !== null) {
+                lines[parsed.statusLineIndex] = `**Status**: ${updates.status}`;
+                result.changes.status = {
+                    from: parsed.currentStatus || "",
+                    to: updates.status,
+                };
+            }
+            else {
+                // No status found, insert after title or at start
+                const insertIndex = parsed.titleLineIndex !== null ? parsed.titleLineIndex + 1 : 0;
+                // Make sure there's a blank line before status if inserting after title
+                if (parsed.titleLineIndex !== null && lines[insertIndex]?.trim() !== "") {
+                    lines.splice(insertIndex, 0, "");
+                }
+                lines.splice(insertIndex + 1, 0, `**Status**: ${updates.status}`);
+                result.changes.status = {
+                    from: "",
+                    to: updates.status,
+                };
+            }
+        }
+        // Apply content update
+        if (updates.content !== undefined) {
+            // Recalculate content start after possible line shifts
+            const recalculated = recalculateContentStart(lines);
+            // Remove everything from content start
+            lines.splice(recalculated.contentStartIndex);
+            // Add new content with proper spacing
+            if (recalculated.contentStartIndex > 0 && !lines[lines.length - 1]?.trim()) {
+                // Already has blank line
+            }
+            else {
+                lines.push("");
+            }
+            // Add the new content
+            lines.push(updates.content);
+            result.changes.content = true;
+        }
+        // Write the updated content atomically
+        const updatedContent = lines.join("\n");
+        writeFileAtomic(specFilePath, updatedContent);
+        result.success = true;
+        return result;
+    }
+    catch (error) {
+        result.error = `Failed to update spec: ${error instanceof Error ? error.message : String(error)}`;
+        return result;
+    }
+}
+/**
+ * Get the current title from a spec file
+ *
+ * @param specFilePath - Absolute path to the spec file
+ * @returns The title or null if not found
+ */
+export function getSpecTitle(specFilePath) {
+    if (!existsSync(specFilePath)) {
+        return null;
+    }
+    try {
+        const parsed = parseSpecFile(specFilePath);
+        return parsed.currentTitle;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get the current status from a spec file
+ *
+ * @param specFilePath - Absolute path to the spec file
+ * @returns The status or null if not found
+ */
+export function getSpecStatus(specFilePath) {
+    if (!existsSync(specFilePath)) {
+        return null;
+    }
+    try {
+        const parsed = parseSpecFile(specFilePath);
+        return parsed.currentStatus;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse a spec-kit markdown file to extract structure
+ */
+function parseSpecFile(filePath) {
+    const raw = readFileSync(filePath, "utf-8");
+    const lines = raw.split("\n");
+    let titleLineIndex = null;
+    let currentTitle = null;
+    let statusLineIndex = null;
+    let currentStatus = null;
+    let contentStartIndex = 0;
+    let foundFirstContent = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Look for title (# header)
+        if (titleLineIndex === null) {
+            const titleMatch = line.match(TITLE_REGEX);
+            if (titleMatch) {
+                titleLineIndex = i;
+                currentTitle = titleMatch[1].trim();
+                continue;
+            }
+        }
+        // Look for status line
+        if (statusLineIndex === null) {
+            const statusMatch = line.match(STATUS_REGEX);
+            if (statusMatch) {
+                statusLineIndex = i;
+                currentStatus = statusMatch[1].trim();
+                continue;
+            }
+        }
+        // Track metadata section (lines starting with **Key**:)
+        if (METADATA_LINE_REGEX.test(line)) {
+            continue;
+        }
+        // Track where content starts (first non-empty, non-metadata line after title)
+        if (!foundFirstContent && titleLineIndex !== null && line.trim() !== "") {
+            // Skip if this is still in metadata section
+            if (!METADATA_LINE_REGEX.test(line)) {
+                contentStartIndex = i;
+                foundFirstContent = true;
+            }
+        }
+    }
+    // If no content found, start after metadata
+    if (!foundFirstContent) {
+        contentStartIndex = lines.length;
+    }
+    return {
+        raw,
+        lines,
+        titleLineIndex,
+        currentTitle,
+        statusLineIndex,
+        currentStatus,
+        contentStartIndex,
+    };
+}
+/**
+ * Recalculate content start index after modifications
+ */
+function recalculateContentStart(lines) {
+    let titleLineIndex = null;
+    let lastMetadataIndex = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Find title
+        if (titleLineIndex === null && TITLE_REGEX.test(line)) {
+            titleLineIndex = i;
+        }
+        // Track metadata lines
+        if (METADATA_LINE_REGEX.test(line)) {
+            lastMetadataIndex = i;
+        }
+    }
+    // Content starts after the last metadata line (or after title if no metadata)
+    // Skip any blank lines too
+    let contentStartIndex = Math.max(titleLineIndex !== null ? titleLineIndex + 1 : 0, lastMetadataIndex + 1);
+    // Skip blank lines after metadata
+    while (contentStartIndex < lines.length && lines[contentStartIndex]?.trim() === "") {
+        contentStartIndex++;
+    }
+    return { contentStartIndex };
+}
+/**
+ * Write file atomically using temp file + rename pattern
+ */
+function writeFileAtomic(filePath, content) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const tempPath = `${filePath}.tmp.${Date.now()}`;
+    writeFileSync(tempPath, content, "utf-8");
+    // Rename is atomic on most file systems
+    renameSync(tempPath, filePath);
+}
+//# sourceMappingURL=spec-writer.js.map

package/dist/writer/spec-writer.js.map

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

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

@@ -0,0 +1,47 @@
+/**
+ * Tasks Writer for Spec-Kit Integration
+ *
+ * Updates task checkbox status in tasks.md files.
+ * Tasks are formatted as: `- [ ] T001: Task description` or `- [x] T001: Task description`
+ */
+/**
+ * Result of a task status update operation
+ */
+export interface TaskUpdateResult {
+    success: boolean;
+    error?: string;
+    previousStatus?: boolean;
+    newStatus?: boolean;
+}
+/**
+ * Update a task's checkbox status in a tasks.md file
+ *
+ * @param tasksFilePath - Absolute path to the tasks.md file
+ * @param taskId - Task identifier (e.g., "T001")
+ * @param completed - Whether the task should be marked as completed
+ * @returns Result of the update operation
+ *
+ * @example
+ * updateTaskStatus("/project/.specify/specs/001-auth/tasks.md", "T001", true);
+ * // Changes `- [ ] T001: Setup auth` to `- [x] T001: Setup auth`
+ *
+ * updateTaskStatus("/project/.specify/specs/001-auth/tasks.md", "T001", false);
+ * // Changes `- [x] T001: Setup auth` to `- [ ] T001: Setup auth`
+ */
+export declare function updateTaskStatus(tasksFilePath: string, taskId: string, completed: boolean): TaskUpdateResult;
+/**
+ * Get the current status of a task
+ *
+ * @param tasksFilePath - Absolute path to the tasks.md file
+ * @param taskId - Task identifier (e.g., "T001")
+ * @returns The task's completion status, or null if not found
+ */
+export declare function getTaskStatus(tasksFilePath: string, taskId: string): boolean | null;
+/**
+ * Get all tasks and their statuses from a tasks.md file
+ *
+ * @param tasksFilePath - Absolute path to the tasks.md file
+ * @returns Map of task IDs to their completion status
+ */
+export declare function getAllTaskStatuses(tasksFilePath: string): Map<string, boolean>;
+//# sourceMappingURL=tasks-writer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-writer.d.ts","sourceRoot":"","sources":["../../src/writer/tasks-writer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAaD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,OAAO,GACjB,gBAAgB,CAiElB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,GAAG,IAAI,CAoBhB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,GACpB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBtB"}

package/dist/writer/tasks-writer.js

@@ -0,0 +1,161 @@
+/**
+ * Tasks Writer for Spec-Kit Integration
+ *
+ * Updates task checkbox status in tasks.md files.
+ * Tasks are formatted as: `- [ ] T001: Task description` or `- [x] T001: Task description`
+ */
+import { readFileSync, writeFileSync, existsSync, renameSync } from "fs";
+import { dirname } from "path";
+import { mkdirSync } from "fs";
+/**
+ * Regex pattern to match task lines in tasks.md
+ * Matches: `- [ ] T001: description` or `- [x] T001: description`
+ * Captures:
+ * - Group 1: Leading whitespace and bullet
+ * - Group 2: Checkbox state (space or x)
+ * - Group 3: Task ID (e.g., T001)
+ * - Group 4: Rest of line (description)
+ */
+const TASK_LINE_REGEX = /^(\s*-\s*)\[([ xX])\]\s*(T\d+)(.*)$/;
+/**
+ * Update a task's checkbox status in a tasks.md file
+ *
+ * @param tasksFilePath - Absolute path to the tasks.md file
+ * @param taskId - Task identifier (e.g., "T001")
+ * @param completed - Whether the task should be marked as completed
+ * @returns Result of the update operation
+ *
+ * @example
+ * updateTaskStatus("/project/.specify/specs/001-auth/tasks.md", "T001", true);
+ * // Changes `- [ ] T001: Setup auth` to `- [x] T001: Setup auth`
+ *
+ * updateTaskStatus("/project/.specify/specs/001-auth/tasks.md", "T001", false);
+ * // Changes `- [x] T001: Setup auth` to `- [ ] T001: Setup auth`
+ */
+export function updateTaskStatus(tasksFilePath, taskId, completed) {
+    // Validate inputs
+    if (!tasksFilePath) {
+        return { success: false, error: "Tasks file path is required" };
+    }
+    if (!taskId || !/^T\d+$/.test(taskId)) {
+        return {
+            success: false,
+            error: `Invalid task ID format: ${taskId}. Expected format: T001, T002, etc.`,
+        };
+    }
+    // Check if file exists
+    if (!existsSync(tasksFilePath)) {
+        return { success: false, error: `Tasks file not found: ${tasksFilePath}` };
+    }
+    try {
+        // Read the file
+        const content = readFileSync(tasksFilePath, "utf-8");
+        const lines = content.split("\n");
+        let taskFound = false;
+        let previousStatus;
+        const newCheckbox = completed ? "x" : " ";
+        // Process each line
+        const updatedLines = lines.map((line) => {
+            const match = line.match(TASK_LINE_REGEX);
+            if (match && match[3] === taskId) {
+                taskFound = true;
+                const [, prefix, currentCheckbox, id, rest] = match;
+                previousStatus = currentCheckbox.toLowerCase() === "x";
+                // Return updated line with new checkbox state
+                return `${prefix}[${newCheckbox}] ${id}${rest}`;
+            }
+            return line;
+        });
+        if (!taskFound) {
+            return {
+                success: false,
+                error: `Task ${taskId} not found in ${tasksFilePath}`,
+            };
+        }
+        // Write the updated content atomically
+        const updatedContent = updatedLines.join("\n");
+        writeFileAtomic(tasksFilePath, updatedContent);
+        return {
+            success: true,
+            previousStatus,
+            newStatus: completed,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `Failed to update task status: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+/**
+ * Get the current status of a task
+ *
+ * @param tasksFilePath - Absolute path to the tasks.md file
+ * @param taskId - Task identifier (e.g., "T001")
+ * @returns The task's completion status, or null if not found
+ */
+export function getTaskStatus(tasksFilePath, taskId) {
+    if (!existsSync(tasksFilePath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(tasksFilePath, "utf-8");
+        const lines = content.split("\n");
+        for (const line of lines) {
+            const match = line.match(TASK_LINE_REGEX);
+            if (match && match[3] === taskId) {
+                return match[2].toLowerCase() === "x";
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get all tasks and their statuses from a tasks.md file
+ *
+ * @param tasksFilePath - Absolute path to the tasks.md file
+ * @returns Map of task IDs to their completion status
+ */
+export function getAllTaskStatuses(tasksFilePath) {
+    const statuses = new Map();
+    if (!existsSync(tasksFilePath)) {
+        return statuses;
+    }
+    try {
+        const content = readFileSync(tasksFilePath, "utf-8");
+        const lines = content.split("\n");
+        for (const line of lines) {
+            const match = line.match(TASK_LINE_REGEX);
+            if (match) {
+                const taskId = match[3];
+                const isCompleted = match[2].toLowerCase() === "x";
+                statuses.set(taskId, isCompleted);
+            }
+        }
+    }
+    catch {
+        // Return empty map on error
+    }
+    return statuses;
+}
+/**
+ * Write file atomically using temp file + rename pattern
+ *
+ * @param filePath - Target file path
+ * @param content - Content to write
+ */
+function writeFileAtomic(filePath, content) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const tempPath = `${filePath}.tmp.${Date.now()}`;
+    writeFileSync(tempPath, content, "utf-8");
+    // Rename is atomic on most file systems
+    renameSync(tempPath, filePath);
+}
+//# sourceMappingURL=tasks-writer.js.map

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

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@sudocode-ai/integration-speckit",
+  "version": "0.1.14",
+  "description": "Spec-kit integration plugin for sudocode",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest --run",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "sudocode",
+    "integration",
+    "spec-kit",
+    "plugin"
+  ],
+  "author": "sudocode-ai",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "chokidar": "^4.0.3"
+  },
+  "peerDependencies": {
+    "@sudocode-ai/types": "^0.1.14"
+  },
+  "devDependencies": {
+    "@sudocode-ai/types": "*",
+    "@types/node": "^22.10.2",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  }
+}