nightshift-mcp 1.0.0

package/dist/ralph-manager.js

@@ -0,0 +1,399 @@
+import * as fs from "fs";
+import * as path from "path";
+import { execSync } from "child_process";
+/**
+ * Manages Ralph-style PRD and progress file operations
+ */
+export class RalphManager {
+    projectPath;
+    prdFile;
+    progressFile;
+    bugsFile;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+        this.prdFile = path.join(projectPath, "prd.json");
+        this.progressFile = path.join(projectPath, "progress.txt");
+        this.bugsFile = path.join(projectPath, "bugs.json");
+    }
+    /**
+     * Check if a PRD file exists
+     */
+    hasPRD() {
+        return fs.existsSync(this.prdFile);
+    }
+    /**
+     * Read and parse the PRD file
+     */
+    readPRD() {
+        if (!this.hasPRD()) {
+            return null;
+        }
+        try {
+            const content = fs.readFileSync(this.prdFile, "utf-8");
+            return JSON.parse(content);
+        }
+        catch (error) {
+            throw new Error(`Failed to parse PRD: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Write the PRD file
+     */
+    writePRD(prd) {
+        fs.writeFileSync(this.prdFile, JSON.stringify(prd, null, 2), "utf-8");
+    }
+    /**
+     * Get the next story to work on (highest priority with passes: false)
+     */
+    getNextStory() {
+        const prd = this.readPRD();
+        if (!prd)
+            return null;
+        const incompleteStories = prd.userStories
+            .filter((s) => !s.passes)
+            .sort((a, b) => a.priority - b.priority);
+        return incompleteStories[0] || null;
+    }
+    /**
+     * Get a specific story by ID
+     */
+    getStory(storyId) {
+        const prd = this.readPRD();
+        if (!prd)
+            return null;
+        return prd.userStories.find((s) => s.id === storyId) || null;
+    }
+    /**
+     * Get all incomplete stories
+     */
+    getIncompleteStories() {
+        const prd = this.readPRD();
+        if (!prd)
+            return [];
+        return prd.userStories
+            .filter((s) => !s.passes)
+            .sort((a, b) => a.priority - b.priority);
+    }
+    /**
+     * Get all complete stories
+     */
+    getCompleteStories() {
+        const prd = this.readPRD();
+        if (!prd)
+            return [];
+        return prd.userStories.filter((s) => s.passes);
+    }
+    /**
+     * Mark a story as complete (passes: true)
+     */
+    markStoryComplete(storyId, notes) {
+        const prd = this.readPRD();
+        if (!prd)
+            return null;
+        const story = prd.userStories.find((s) => s.id === storyId);
+        if (!story)
+            return null;
+        story.passes = true;
+        if (notes) {
+            story.notes = notes;
+        }
+        this.writePRD(prd);
+        return story;
+    }
+    /**
+     * Update a story's notes
+     */
+    updateStoryNotes(storyId, notes) {
+        const prd = this.readPRD();
+        if (!prd)
+            return null;
+        const story = prd.userStories.find((s) => s.id === storyId);
+        if (!story)
+            return null;
+        story.notes = notes;
+        this.writePRD(prd);
+        return story;
+    }
+    /**
+     * Check if all stories are complete
+     */
+    isAllComplete() {
+        const prd = this.readPRD();
+        if (!prd)
+            return false;
+        return prd.userStories.every((s) => s.passes);
+    }
+    /**
+     * Get completion summary
+     */
+    getCompletionSummary() {
+        const prd = this.readPRD();
+        if (!prd) {
+            return { total: 0, complete: 0, incomplete: 0, percentComplete: 0 };
+        }
+        const total = prd.userStories.length;
+        const complete = prd.userStories.filter((s) => s.passes).length;
+        const incomplete = total - complete;
+        const percentComplete = total > 0 ? Math.round((complete / total) * 100) : 0;
+        return { total, complete, incomplete, percentComplete };
+    }
+    /**
+     * Check if progress file exists
+     */
+    hasProgressFile() {
+        return fs.existsSync(this.progressFile);
+    }
+    /**
+     * Read the progress file
+     */
+    readProgress() {
+        if (!this.hasProgressFile()) {
+            return "";
+        }
+        return fs.readFileSync(this.progressFile, "utf-8");
+    }
+    /**
+     * Initialize the progress file
+     */
+    initProgressFile() {
+        if (this.hasProgressFile())
+            return;
+        const header = `# Ralph Progress Log
+Started: ${new Date().toISOString()}
+---
+
+## Codebase Patterns
+(Add reusable patterns discovered during development here)
+
+---
+
+`;
+        fs.writeFileSync(this.progressFile, header, "utf-8");
+    }
+    /**
+     * Append to the progress file
+     */
+    appendProgress(content) {
+        this.initProgressFile();
+        const timestamp = new Date().toISOString();
+        const entry = `\n## ${timestamp}\n${content}\n---\n`;
+        fs.appendFileSync(this.progressFile, entry, "utf-8");
+    }
+    /**
+     * Add a codebase pattern to the progress file
+     */
+    addCodebasePattern(pattern) {
+        if (!this.hasProgressFile()) {
+            this.initProgressFile();
+        }
+        const content = this.readProgress();
+        const patternSection = "## Codebase Patterns";
+        const idx = content.indexOf(patternSection);
+        if (idx === -1) {
+            // Pattern section doesn't exist, add it
+            this.initProgressFile();
+            return this.addCodebasePattern(pattern);
+        }
+        // Find the end of the patterns section (next ## or ---)
+        const afterSection = content.substring(idx + patternSection.length);
+        const endIdx = afterSection.search(/\n## |\n---/);
+        const patternsContent = endIdx === -1 ? afterSection : afterSection.substring(0, endIdx);
+        // Add new pattern
+        const newPattern = `- ${pattern}\n`;
+        const updatedContent = content.substring(0, idx + patternSection.length) +
+            patternsContent.trimEnd() +
+            "\n" +
+            newPattern +
+            (endIdx === -1 ? "" : afterSection.substring(endIdx));
+        fs.writeFileSync(this.progressFile, updatedContent, "utf-8");
+    }
+    /**
+     * Get file paths
+     */
+    getPRDPath() {
+        return this.prdFile;
+    }
+    getProgressPath() {
+        return this.progressFile;
+    }
+    // ============================================
+    // Bugs Management
+    // ============================================
+    /**
+     * Check if a bugs file exists
+     */
+    hasBugs() {
+        return fs.existsSync(this.bugsFile);
+    }
+    /**
+     * Read and parse the bugs file
+     */
+    readBugs() {
+        if (!this.hasBugs()) {
+            return null;
+        }
+        try {
+            const content = fs.readFileSync(this.bugsFile, "utf-8");
+            return JSON.parse(content);
+        }
+        catch (error) {
+            throw new Error(`Failed to parse bugs.json: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Write the bugs file
+     */
+    writeBugs(bugList) {
+        fs.writeFileSync(this.bugsFile, JSON.stringify(bugList, null, 2), "utf-8");
+    }
+    /**
+     * Get the next bug to fix (highest priority unfixed)
+     */
+    getNextBug() {
+        const bugList = this.readBugs();
+        if (!bugList)
+            return null;
+        const unfixed = bugList.bugs
+            .filter((b) => !b.fixed)
+            .sort((a, b) => a.priority - b.priority);
+        return unfixed[0] || null;
+    }
+    /**
+     * Get a specific bug by ID
+     */
+    getBug(bugId) {
+        const bugList = this.readBugs();
+        if (!bugList)
+            return null;
+        return bugList.bugs.find((b) => b.id === bugId) || null;
+    }
+    /**
+     * Get all unfixed bugs
+     */
+    getUnfixedBugs() {
+        const bugList = this.readBugs();
+        if (!bugList)
+            return [];
+        return bugList.bugs
+            .filter((b) => !b.fixed)
+            .sort((a, b) => a.priority - b.priority);
+    }
+    /**
+     * Mark a bug as fixed
+     */
+    markBugFixed(bugId, notes) {
+        const bugList = this.readBugs();
+        if (!bugList)
+            return null;
+        const bug = bugList.bugs.find((b) => b.id === bugId);
+        if (!bug)
+            return null;
+        bug.fixed = true;
+        if (notes) {
+            bug.notes = notes;
+        }
+        this.writeBugs(bugList);
+        return bug;
+    }
+    /**
+     * Get bugs completion summary
+     */
+    getBugsSummary() {
+        const bugList = this.readBugs();
+        if (!bugList) {
+            return { total: 0, fixed: 0, unfixed: 0, percentFixed: 0 };
+        }
+        const total = bugList.bugs.length;
+        const fixed = bugList.bugs.filter((b) => b.fixed).length;
+        const unfixed = total - fixed;
+        const percentFixed = total > 0 ? Math.round((fixed / total) * 100) : 0;
+        return { total, fixed, unfixed, percentFixed };
+    }
+    /**
+     * Check if all work is complete (stories + bugs)
+     */
+    isAllWorkComplete() {
+        const storiesComplete = this.isAllComplete();
+        const bugsSummary = this.getBugsSummary();
+        const bugsComplete = bugsSummary.total === 0 || bugsSummary.unfixed === 0;
+        return storiesComplete && bugsComplete;
+    }
+    getBugsPath() {
+        return this.bugsFile;
+    }
+    // ============================================
+    // Savepoints
+    // ============================================
+    /**
+     * Create a savepoint (git commit + tag)
+     * Returns the tag name if successful, null if failed
+     */
+    createSavepoint(label, message) {
+        const tag = `savepoint/${label}`;
+        const commitMessage = message || `savepoint: ${label}`;
+        try {
+            // Check if we're in a git repo
+            execSync("git rev-parse --git-dir", {
+                cwd: this.projectPath,
+                stdio: "pipe",
+            });
+            // Check if there are changes to commit
+            const status = execSync("git status --porcelain", {
+                cwd: this.projectPath,
+                encoding: "utf-8",
+            }).trim();
+            if (status) {
+                // Stage all changes and commit
+                execSync("git add -A", { cwd: this.projectPath, stdio: "pipe" });
+                execSync(`git commit -m "${commitMessage}"`, {
+                    cwd: this.projectPath,
+                    stdio: "pipe",
+                });
+            }
+            // Create the tag (force to overwrite if exists)
+            execSync(`git tag -f ${tag}`, { cwd: this.projectPath, stdio: "pipe" });
+            return { success: true, tag };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * List all savepoints
+     */
+    listSavepoints() {
+        try {
+            const output = execSync("git tag -l 'savepoint/*'", {
+                cwd: this.projectPath,
+                encoding: "utf-8",
+            });
+            return output.trim().split("\n").filter(Boolean);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Rollback to a savepoint
+     */
+    rollbackToSavepoint(tag) {
+        try {
+            const fullTag = tag.startsWith("savepoint/") ? tag : `savepoint/${tag}`;
+            execSync(`git reset --hard ${fullTag}`, {
+                cwd: this.projectPath,
+                stdio: "pipe",
+            });
+            return { success: true };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+}
+//# sourceMappingURL=ralph-manager.js.map

package/dist/ralph-manager.js.map

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

package/dist/tool-registry.d.ts

@@ -0,0 +1,130 @@
+import { z, type ZodObject, type ZodRawShape } from "zod";
+/**
+ * Context passed to tool handlers
+ */
+export interface ToolContext {
+    chatManager: any;
+    ralphManager: any;
+    workflowManager: any;
+    projectPath: string;
+}
+/**
+ * Result returned by tool handlers
+ */
+export interface ToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Summary of a tool for help/listing
+ */
+export interface ToolSummary {
+    name: string;
+    category: string;
+    description: string;
+}
+/**
+ * Full tool definition including schema and handler
+ * Uses 'any' for handler params to allow variance in tool definitions
+ */
+export interface ToolDefinition {
+    name: string;
+    category: string;
+    description: string;
+    fullDescription: string;
+    inputSchema: ZodObject<any>;
+    handler: (params: any, context: ToolContext) => Promise<ToolResult>;
+}
+/**
+ * Detailed schema info for help output
+ */
+export interface SchemaInfo {
+    name: string;
+    description: string;
+    fullDescription: string;
+    category: string;
+    parameters: Record<string, {
+        type: string;
+        description: string;
+        required: boolean;
+    }>;
+}
+/**
+ * Tool categories for organization
+ */
+export declare const TOOL_CATEGORIES: readonly ["chat", "prd", "workflow", "agents", "progress", "bugs", "savepoints", "utility"];
+export type ToolCategory = typeof TOOL_CATEGORIES[number];
+/**
+ * Registry for managing tool definitions
+ * Provides lazy loading of schemas and centralized execution
+ */
+export declare class ToolRegistry {
+    private tools;
+    private categoryIndex;
+    constructor();
+    /**
+     * Register a tool definition
+     */
+    register(tool: ToolDefinition): void;
+    /**
+     * Register multiple tools at once
+     */
+    registerAll(tools: ToolDefinition[]): void;
+    /**
+     * Get all registered tool names
+     */
+    getToolNames(): string[];
+    /**
+     * Get all categories
+     */
+    getCategories(): ToolCategory[];
+    /**
+     * Get tool count
+     */
+    getToolCount(): number;
+    /**
+     * Check if a tool exists
+     */
+    has(name: string): boolean;
+    /**
+     * Get a tool definition by name
+     */
+    get(name: string): ToolDefinition | undefined;
+    /**
+     * List tools with brief summaries, optionally filtered by category
+     */
+    listTools(category?: string): ToolSummary[];
+    /**
+     * Get detailed schema information for a tool
+     */
+    getSchema(toolName: string): SchemaInfo | null;
+    /**
+     * Get a human-readable type name from a Zod schema
+     */
+    private getZodTypeName;
+    /**
+     * Execute a tool by name with the given parameters
+     */
+    execute(toolName: string, params: Record<string, unknown>, context: ToolContext): Promise<ToolResult>;
+    /**
+     * Generate help text for all tools or a specific tool
+     */
+    generateHelp(action?: string, category?: string): string;
+}
+/**
+ * Helper to create a tool definition with proper typing
+ */
+export declare function defineTool<T extends ZodRawShape>(config: {
+    name: string;
+    category: ToolCategory;
+    description: string;
+    fullDescription: string;
+    inputSchema: ZodObject<T>;
+    handler: (params: z.infer<ZodObject<T>>, context: ToolContext) => Promise<ToolResult>;
+}): ToolDefinition;
+export declare const toolRegistry: ToolRegistry;
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/tool-registry.d.ts.map

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