@popoverai/dotrequirements 0.11.0 → 0.12.0

package/dist/cli.js

@@ -10,6 +10,14 @@ import { mcpSetupCommand } from './commands/mcp-setup.js';
 import { loginCommand } from './commands/login.js';
 import { logoutCommand } from './commands/logout.js';
 import { loadEnvFile } from './utils/env.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+// Read version from package.json
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+const VERSION = packageJson.version;
 // Load environment variables from .env.local if it exists
 loadEnvFile();
 /**
@@ -36,7 +44,7 @@ const program = new Command();
 program
     .name('dotrequirements')
     .description('Requirements tracking CLI with test harness and MCP server')
-    .version('0.1.0');
+    .version(VERSION);
 program
     .command('init')
     .description('Initialize a new dotrequirements project')

package/dist/commands/init.js

@@ -165,7 +165,8 @@ async function createNewProjectFlow(cwd, envPath, options) {
         return;
     }
     // Reload env file so newly written credentials are available to subsequent commands
-    loadEnvFile(cwd);
+    // Use force=true to overwrite any previously cached values
+    loadEnvFile(cwd, true);
     // 4. Create .requirements/ directory
     await createRequirementsDirectory(cwd, projectId);
     // 5. Update .gitignore
@@ -242,7 +243,8 @@ async function connectExistingProjectFlow(cwd, envPath) {
         return;
     }
     // Reload env file so newly written credentials are available to pullCommand
-    loadEnvFile(cwd);
+    // Use force=true to overwrite any previously cached values
+    loadEnvFile(cwd, true);
     // Create .requirements/ directory
     await createRequirementsDirectory(cwd, projectId);
     // Update .gitignore

package/dist/commands/mcp-setup.js

@@ -106,6 +106,7 @@ export async function mcpSetupCommand() {
         message: 'Which AI assistant are you using?',
         choices: [
             { title: 'Claude Code', value: 'claude-code' },
+            { title: 'Claude Desktop', value: 'claude-desktop' },
             { title: 'Cursor', value: 'cursor' },
             { title: 'Google Antigravity', value: 'antigravity' },
             { title: 'OpenAI Codex', value: 'codex' },
@@ -122,6 +123,9 @@ export async function mcpSetupCommand() {
         case 'claude-code':
             await setupClaudeCode();
             break;
+        case 'claude-desktop':
+            await setupClaudeDesktop();
+            break;
         case 'cursor':
             await setupCursor();
             break;
@@ -174,6 +178,78 @@ async function setupClaudeCode() {
         await installAllSkills('claude-code');
     }
 }
+async function setupClaudeDesktop() {
+    console.log('\n📦 Configuring MCP for Claude Desktop...\n');
+    // Determine config path based on OS
+    const platform = process.platform;
+    let configPath;
+    let configDir;
+    if (platform === 'darwin') {
+        configDir = join(homedir(), 'Library', 'Application Support', 'Claude');
+        configPath = join(configDir, 'claude_desktop_config.json');
+    }
+    else if (platform === 'win32') {
+        const appData = process.env.APPDATA || join(homedir(), 'AppData', 'Roaming');
+        configDir = join(appData, 'Claude');
+        configPath = join(configDir, 'claude_desktop_config.json');
+    }
+    else {
+        console.error('❌ Claude Desktop is only supported on macOS and Windows.');
+        console.log('\nFor Linux, please manually configure the MCP server.');
+        return;
+    }
+    const mcpServerConfig = {
+        command: 'npx',
+        args: ['-y', '@popoverai/dotrequirements', 'mcp'],
+        env: {
+            REQUIREMENTS_DIR: process.cwd(),
+        },
+    };
+    try {
+        if (!existsSync(configDir)) {
+            console.log('Creating Claude Desktop config directory...');
+            mkdirSync(configDir, { recursive: true });
+        }
+        let config = {};
+        if (existsSync(configPath)) {
+            try {
+                const existingContent = readFileSync(configPath, 'utf-8');
+                if (existingContent.trim()) {
+                    config = JSON.parse(existingContent);
+                }
+            }
+            catch (parseError) {
+                console.log('⚠️  Existing config file is invalid, creating fresh config...');
+                config = {};
+            }
+        }
+        if (!config.mcpServers) {
+            config.mcpServers = {};
+        }
+        config.mcpServers['dotrequirements'] = mcpServerConfig;
+        writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+        console.log(`✅ MCP configured successfully!`);
+        console.log(`   Config file: ${configPath}`);
+        console.log(`   REQUIREMENTS_DIR: ${process.cwd()}\n`);
+        console.log('⚠️  Important: Quit and restart Claude Desktop for changes to take effect.');
+        console.log('              (Cmd+Q on macOS, not just close the window)\n');
+        console.log('You can now ask Claude Desktop to help write requirements!\n');
+        // Claude Desktop doesn't use skills like Claude Code, so we skip that step
+    }
+    catch (error) {
+        console.error('❌ Failed to configure MCP automatically.');
+        console.log(`\nError: ${error instanceof Error ? error.message : String(error)}`);
+        console.log('\nYou can manually edit the config file at:');
+        console.log(`  ${configPath}\n`);
+        console.log('Add the following configuration:');
+        const manualConfig = {
+            mcpServers: {
+                dotrequirements: mcpServerConfig,
+            },
+        };
+        console.log(JSON.stringify(manualConfig, null, 2));
+    }
+}
 async function setupCursor() {
     console.log('\n📦 Configuring MCP for Cursor (project-specific)...\n');
     const configPath = join(process.cwd(), '.cursor', 'mcp.json');

package/dist/commands/pull.js

@@ -151,14 +151,17 @@ function extractDocumentIdFromFile(filePath) {
         const content = fs.readFileSync(filePath, 'utf-8');
         // Match document.id in YAML frontmatter - handles both inline and nested formats
         // Inline: document: { id: "abc123", ... }
-        // Nested:
+        // Nested (id: can appear at any position within the indented document block):
         //   document:
+        //     title: Some Title
+        //     defaultPrefix: REQ
         //     id: abc123
         const inlineMatch = content.match(/document:\s*\{[^}]*id:\s*["']?([^"',}\s]+)/);
         if (inlineMatch) {
             return inlineMatch[1];
         }
-        const nestedMatch = content.match(/document:\s*\n\s+id:\s*["']?([^"'\s\n]+)/);
+        // Match id: anywhere within the document block (allows other properties before it)
+        const nestedMatch = content.match(/document:\s*\n(?:[ \t]+[^\n]*\n)*?[ \t]+id:\s*["']?([^"'\s\n]+)/);
         if (nestedMatch) {
             return nestedMatch[1];
         }

package/dist/mcp/index.js

@@ -9,6 +9,14 @@ import { glob } from 'glob';
 import { loadConvexConfig, getRequirementCoverage as queryRequirementCoverage, getProjectCoverage as queryProjectCoverage, } from './convexClient.js';
 import { discoverProjects, resolveProject, } from '../utils/project-discovery.js';
 import { isLocalOnlyProject, CLOUD_FEATURES_REQUIRE_AUTH_MESSAGE } from '../utils/local-project.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+// Read version from package.json
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../../package.json'), 'utf-8'));
+const VERSION = packageJson.version;
 // Get project paths from environment variables
 // Supports both PROJ_* pattern (Antigravity) and REQUIREMENTS_DIR fallback
 function getProjectPathsFromEnv() {
@@ -331,7 +339,7 @@ const prompts = [
 // Create server
 const server = new Server({
     name: 'dotrequirements',
-    version: '0.1.0',
+    version: VERSION,
 }, {
     capabilities: {
         tools: {},

package/dist/utils/env.d.ts

@@ -1,8 +1,10 @@
 /**
  * Load environment variables from .env.local file
- * Merges with existing process.env (process.env takes precedence)
+ * Merges with existing process.env (process.env takes precedence by default)
+ * @param cwd - Directory containing .env.local (defaults to process.cwd())
+ * @param force - If true, overwrite existing process.env values (used when reloading after init)
  */
-export declare function loadEnvFile(cwd?: string): void;
+export declare function loadEnvFile(cwd?: string, force?: boolean): void;
 /**
  * Get project credentials from environment
  * Returns undefined if not found

package/dist/utils/env.js

@@ -2,9 +2,11 @@ import * as fs from 'fs';
 import * as path from 'path';
 /**
  * Load environment variables from .env.local file
- * Merges with existing process.env (process.env takes precedence)
+ * Merges with existing process.env (process.env takes precedence by default)
+ * @param cwd - Directory containing .env.local (defaults to process.cwd())
+ * @param force - If true, overwrite existing process.env values (used when reloading after init)
  */
-export function loadEnvFile(cwd = process.cwd()) {
+export function loadEnvFile(cwd = process.cwd(), force = false) {
     const envPath = path.join(cwd, '.env.local');
     if (!fs.existsSync(envPath)) {
         return;
@@ -22,8 +24,8 @@ export function loadEnvFile(cwd = process.cwd()) {
             if (match) {
                 const key = match[1].trim();
                 const value = match[2].trim();
-                // Only set if not already in process.env
-                if (!process.env[key]) {
+                // Set if force=true, or if not already in process.env
+                if (force || !process.env[key]) {
                     process.env[key] = value;
                 }
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@popoverai/dotrequirements",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Requirements tracking CLI, test harness, and MCP server",
   "type": "module",
   "bin": {