@popoverai/dotrequirements 0.17.1 → 0.18.0

package/README.md

@@ -227,7 +227,7 @@ await finalize({ showTestedList: true }); // Include tested requirements
 await finalize({ showSummary: false, showUntestedList: false }); // Quiet mode
 ```
 
-By default, only untested requirements are shown. See the [test harness docs](https://dotrequirements.io/tools/test-harness) for all options.
+By default, only untested requirements are shown. See the [test harness docs](https://docs.dotrequirements.io/tools/test-harness) for all options.
 
 ### Setup with Jest
 
@@ -474,7 +474,7 @@ Example MCP config for GitHub Actions:
 }
 ```
 
-See the [CI/CD Integration docs](https://dotrequirements.io/tools/ai/ci-cd) for complete examples.
+See the [CI/CD Integration docs](https://docs.dotrequirements.io/tools/ai/ci-cd) for complete examples.
 
 ---
 

package/dist/commands/init.js

@@ -5,6 +5,7 @@ import { ensureGitignore } from '../utils/gitignore.js';
 import { generateRequirementsReadme } from '../templates/requirements-readme.js';
 import { generateExampleRequirements } from '../templates/example-requirements.js';
 import { promptChoice, promptConfirm } from '../utils/prompts.js';
+import { mcpSetupCommand } from './mcp-setup.js';
 import { pullCommand } from './pull.js';
 import { executeOAuthFlow } from '../utils/oauth-flow.js';
 import { ConvexHttpClient } from 'convex/browser';
@@ -34,16 +35,24 @@ export async function initCommand(options = {}) {
             console.log('Initialization cancelled.');
             return;
         }
+        let initSucceeded;
         if (authChoice === 'no') {
             // INIT-3: Local-only workflow
-            await localOnlyFlow(cwd);
+            initSucceeded = await localOnlyFlow(cwd);
         }
         else {
             // INIT-17+: Authenticated workflow
-            await authenticatedFlow(cwd, options);
+            initSucceeded = await authenticatedFlow(cwd, options);
         }
         console.log('\nDocumentation: https://docs.dotrequirements.io/getting-started');
         console.log('By using this service, you agree to our Terms: https://app.dotrequirements.io/terms');
+        // Offer to configure AI assistant integration after successful init
+        if (initSucceeded) {
+            const setupMcp = await promptConfirm('\nConfigure AI assistant integration?', true);
+            if (setupMcp) {
+                await mcpSetupCommand();
+            }
+        }
     }
     catch (error) {
         console.error(`\n✗ Error: ${error instanceof Error ? error.message : String(error)}`);
@@ -57,6 +66,7 @@ export async function initCommand(options = {}) {
 }
 /**
  * INIT-3: Local-only workflow - creates folder structure without credentials
+ * Returns true if project was created successfully
  */
 async function localOnlyFlow(cwd) {
     console.log('\nInitializing local project...');
@@ -84,9 +94,11 @@ async function localOnlyFlow(cwd) {
     console.log('  1. Create requirements in .requirements/ directory');
     console.log('  2. Add the test harness to your test setup (see README)');
     console.log('  3. Run "dotrequirements link" to connect to cloud features');
+    return true;
 }
 /**
  * INIT-17, INIT-18, INIT-7, INIT-4, INIT-6: Authenticated workflow
+ * Returns true if project was created/connected successfully
  */
 async function authenticatedFlow(cwd, options) {
     // INIT-17: Inline OAuth (no persistent tokens)
@@ -100,7 +112,7 @@ async function authenticatedFlow(cwd, options) {
         // INIT-17.3: OAuth failed
         console.error('\nAuthentication failed:', error instanceof Error ? error.message : String(error));
         console.log('Please try again later.\n');
-        return;
+        return false;
     }
     // Set up authenticated client using the session token
     const client = new ConvexHttpClient(getConvexUrl());
@@ -110,13 +122,13 @@ async function authenticatedFlow(cwd, options) {
     if (selectedTeam === undefined) {
         // User cancelled
         console.log('Initialization cancelled.');
-        return;
+        return false;
     }
     // INIT-7: Choose between create and connect
     const projectChoice = await chooseProjectAction(client, selectedTeam.teamId);
     if (!projectChoice) {
         console.log('Initialization cancelled.');
-        return;
+        return false;
     }
     if (projectChoice === 'create') {
         await createNewProjectFlow(cwd, client, selectedTeam, options);
@@ -124,6 +136,7 @@ async function authenticatedFlow(cwd, options) {
     else {
         await connectExistingProjectFlow(cwd, client, selectedTeam);
     }
+    return true;
 }
 /**
  * INIT-18: Prompt user to select a team after OAuth

package/dist/commands/mcp.js

@@ -3,8 +3,9 @@
  * This allows AI assistants to query requirements data
  */
 export async function mcpCommand() {
-    // Import the MCP server - this starts it automatically
+    // Import and start the MCP server
     // The server handles stdio transport and runs until process termination
-    await import('../mcp/index.js');
+    const { main } = await import('../mcp/index.js');
+    await main();
 }
 //# sourceMappingURL=mcp.js.map

package/dist/mcp/index.d.ts

@@ -41,4 +41,5 @@ export declare const server: Server<{
         } | undefined;
     } | undefined;
 }>;
+export declare function main(): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.js

@@ -611,8 +611,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
     }
 });
-// Start server
-async function main() {
+// Start server (exported for CLI command to call directly)
+export async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error('dot•requirements MCP server running');

package/dist/templates/context-file-section.md

@@ -1,12 +1,12 @@
-## Requirements-First Development
+## Requirements-Driven Development
 
 This project uses dotrequirements for requirements tracking. Requirements live in `.requirements/*.requirements.md`.
 
 ### Workflow
 
-When adding new functionality (not bug fixes or refactoring):
+**ALWAYS follow this workflow when changing system behavior** (new features, bug fixes, any behavioral change). Only pure refactoring (same behavior, different code) may skip requirements.
 
-1. **Draft requirements** - Write in `.requirements/*.requirements.md`
+1. **Find or write requirements** - Check `.requirements/` for existing specs; write new ones if needed
 2. **Style-check** - Run `mcp__dotrequirements__style_check` on the file
 3. **Get approval** - Present requirements, wait for go-ahead
 4. **Implement** - Build the feature
@@ -18,16 +18,15 @@ When adding new functionality (not bug fixes or refactoring):
 
 ```dotrequirements
 REQ-ID: Short description of expected behavior
-  0. Given -> Precondition that must be true
-  1. When -> Action or trigger
-  2. Then -> Expected outcome
-    2.0. And -> Additional outcome detail
+  0. -> First criterion or condition
+  1. -> Second criterion
+    1.0. -> Nested detail under second criterion
 ```
 
 - First line: `KEY: description`
-- Criteria: `position. Label -> content` (Given/When/Then structure)
+- Criteria: `position. -> content` (optional label before the arrow)
 - Nesting: Indent with 2 spaces, use `x.y` position paths
-- Delimiter: `->` or the arrow character
+- Delimiter: `->` or `→`
 
 ### Test Usage
 

package/package.json

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