@donotdev/cli 0.0.13 → 0.0.14

package/dist/index.js

@@ -2214,7 +2214,7 @@ var require_parse = __commonJS({
       CHAR_NO_BREAK_SPACE,
       CHAR_ZERO_WIDTH_NOBREAK_SPACE
     } = require_constants();
-    var parse = (input, options = {}) => {
+    var parse2 = (input, options = {}) => {
       if (typeof input !== "string") {
         throw new TypeError("Expected a string");
       }
@@ -2414,7 +2414,7 @@ var require_parse = __commonJS({
       push({ type: "eos" });
       return ast;
     };
-    module.exports = parse;
+    module.exports = parse2;
   }
 });
 
@@ -2426,7 +2426,7 @@ var require_braces = __commonJS({
     var stringify2 = require_stringify();
     var compile = require_compile();
     var expand = require_expand();
-    var parse = require_parse();
+    var parse2 = require_parse();
     var braces = (input, options = {}) => {
       let output = [];
       if (Array.isArray(input)) {
@@ -2446,7 +2446,7 @@ var require_braces = __commonJS({
       }
       return output;
     };
-    braces.parse = (input, options = {}) => parse(input, options);
+    braces.parse = (input, options = {}) => parse2(input, options);
     braces.stringify = (input, options = {}) => {
       if (typeof input === "string") {
         return stringify2(braces.parse(input, options), options);
@@ -3103,7 +3103,7 @@ var require_parse2 = __commonJS({
     var syntaxError = (type, char) => {
       return `Missing ${type}: "${char}" - use "\\\\${char}" to match literal characters`;
     };
-    var parse = (input, options) => {
+    var parse2 = (input, options) => {
       if (typeof input !== "string") {
         throw new TypeError("Expected a string");
       }
@@ -3252,7 +3252,7 @@ var require_parse2 = __commonJS({
             output = token.close = `)$))${extglobStar}`;
           }
           if (token.inner.includes("*") && (rest = remaining()) && /^\.[^\\/.]+$/.test(rest)) {
-            const expression = parse(rest, { ...options, fastpaths: false }).output;
+            const expression = parse2(rest, { ...options, fastpaths: false }).output;
             output = token.close = `)${expression})${extglobStar})`;
           }
           if (token.prev.type === "bos") {
@@ -3777,7 +3777,7 @@ var require_parse2 = __commonJS({
       }
       return state;
     };
-    parse.fastpaths = (input, options) => {
+    parse2.fastpaths = (input, options) => {
       const opts = { ...options };
       const max = typeof opts.maxLength === "number" ? Math.min(MAX_LENGTH, opts.maxLength) : MAX_LENGTH;
       const len = input.length;
@@ -3843,7 +3843,7 @@ var require_parse2 = __commonJS({
       }
       return source;
     };
-    module.exports = parse;
+    module.exports = parse2;
   }
 });
 
@@ -3854,7 +3854,7 @@ var require_picomatch = __commonJS({
     init_utils();
     var path = __require("path");
     var scan = require_scan();
-    var parse = require_parse2();
+    var parse2 = require_parse2();
     var utils = require_utils2();
     var constants2 = require_constants2();
     var isObject = (val) => val && typeof val === "object" && !Array.isArray(val);
@@ -3942,7 +3942,7 @@ var require_picomatch = __commonJS({
     picomatch.isMatch = (str, patterns, options) => picomatch(patterns, options)(str);
     picomatch.parse = (pattern, options) => {
       if (Array.isArray(pattern)) return pattern.map((p2) => picomatch.parse(p2, options));
-      return parse(pattern, { ...options, fastpaths: false });
+      return parse2(pattern, { ...options, fastpaths: false });
     };
     picomatch.scan = (input, options) => scan(input, options);
     picomatch.compileRe = (state, options, returnOutput = false, returnState = false) => {
@@ -3968,10 +3968,10 @@ var require_picomatch = __commonJS({
       }
       let parsed = { negated: false, fastpaths: true };
       if (options.fastpaths !== false && (input[0] === "." || input[0] === "*")) {
-        parsed.output = parse.fastpaths(input, options);
+        parsed.output = parse2.fastpaths(input, options);
       }
       if (!parsed.output) {
-        parsed = parse(input, options);
+        parsed = parse2(input, options);
       }
       return picomatch.compileRe(parsed, options, returnOutput, returnState);
     };
@@ -7959,6 +7959,7 @@ __export(pathResolver_exports, {
   ensureDirSync: () => ensureDirSync,
   findFiles: () => findFiles,
   findNodeModulesDir: () => findNodeModulesDir,
+  findPackageRootUp: () => findPackageRootUp,
   fromAppRoot: () => fromAppRoot,
   getAppRoot: () => getAppRoot,
   getBasename: () => getBasename,
@@ -7975,7 +7976,6 @@ __export(pathResolver_exports, {
   getRelativePathBetween: () => getRelativePathBetween,
   getRepoRoot: () => getRepoRoot,
   getTemplatesRoot: () => getTemplatesRoot,
-  getToolingPath: () => getToolingPath,
   glob: () => glob,
   globSync: () => globSync,
   isAbsolute: () => isAbsolute,
@@ -8014,6 +8014,7 @@ import {
   extname as extname2,
   relative as relative2,
   resolve as resolve2,
+  parse,
   isAbsolute as pathIsAbsolute
 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
@@ -8070,37 +8071,19 @@ function getBinPath(binaryName) {
   }
   return binaryName;
 }
-function getToolingPath() {
-  const mode = detectExecutionMode();
-  if (mode === "development") {
-    const repoRoot = getRepoRoot();
-    const packagesToolingPath = normalizePath(repoRoot, PACKAGE_PATHS.TOOLING);
-    if (pathExists(packagesToolingPath)) {
-      return normalizePath(packagesToolingPath);
-    }
-  }
-  throw new DoNotDevError(
-    "Could not find tooling package. This function is only available in development mode.",
-    "path-resolution-error"
-  );
-}
 function detectExecutionMode() {
-  const currentDir = process.cwd();
-  const toolingPath = joinPath(currentDir, PACKAGE_PATHS.TOOLING);
-  if (pathExists(toolingPath)) {
-    return "development";
-  }
   const fileUrlPath = new URL(import.meta.url).pathname;
-  if (fileUrlPath.includes("node_modules/@donotdev/cli")) {
-    return "published";
+  if (!fileUrlPath.includes("node_modules")) {
+    return "development";
   }
   return "published";
 }
 function getTemplatesRoot() {
   const mode = detectExecutionMode();
   if (mode === "development") {
-    const repoRoot = getRepoRoot();
-    return normalizePath(repoRoot, PACKAGE_PATHS.CLI, "templates");
+    const fileUrlPath = new URL(import.meta.url).pathname;
+    const frameworkRoot = normalizePath(dirname2(fileUrlPath), "../../../..");
+    return normalizePath(frameworkRoot, PACKAGE_PATHS.CLI, "templates");
   } else {
     try {
       const cliRoot2 = resolveFrameworkPackage("@donotdev/cli");
@@ -8122,10 +8105,43 @@ function getTemplatesRoot() {
       }
     } catch {
     }
+    try {
+      const currentScriptDir = getDirnameFromUrl(import.meta.url);
+      const packageRoot = findPackageRootUp(currentScriptDir, "@donotdev/cli");
+      if (packageRoot) {
+        const templatesPath = normalizePath(packageRoot, "templates");
+        if (pathExists(templatesPath)) {
+          return templatesPath;
+        }
+      }
+    } catch {
+    }
     const cliRoot = getCliRootFromBundle();
     return normalizePath(cliRoot, "templates");
   }
 }
+function findPackageRootUp(startDir, packageName) {
+  let currentDir = normalizePath(startDir);
+  const root = parse(currentDir).root;
+  const fs2 = createRequire2(import.meta.url)("node:fs");
+  while (currentDir !== root) {
+    const packageJsonPath = joinPath(currentDir, "package.json");
+    if (fs2.existsSync(packageJsonPath)) {
+      try {
+        const content = fs2.readFileSync(packageJsonPath, "utf8");
+        const pkg = JSON.parse(content);
+        if (pkg.name === packageName) {
+          return currentDir;
+        }
+      } catch {
+      }
+    }
+    const parentDir = getDirname(currentDir);
+    if (parentDir === currentDir) break;
+    currentDir = parentDir;
+  }
+  return null;
+}
 function getCliRootFromBundle() {
   const currentDir = getDirnameFromUrl(import.meta.url);
   return normalizePath(currentDir, "..", "..", "..");
@@ -8245,7 +8261,6 @@ var init_pathResolver = __esm({
     "use strict";
     init_utils();
     init_PathResolver();
-    init_errors();
     pathResolverInstance = PathResolver.getInstance({ debug: false });
     getPathResolver = (options) => PathResolver.getInstance(options);
     getRepoRoot = () => pathResolverInstance.getRepoRoot();
@@ -15606,7 +15621,7 @@ var require_public_api = __commonJS({
       }
       return doc;
     }
-    function parse(src, reviver, options) {
+    function parse2(src, reviver, options) {
       let _reviver = void 0;
       if (typeof reviver === "function") {
         _reviver = reviver;
@@ -15647,7 +15662,7 @@ var require_public_api = __commonJS({
         return value.toString(options);
       return new Document.Document(value, _replacer, options).toString(options);
     }
-    exports.parse = parse;
+    exports.parse = parse2;
     exports.parseAllDocuments = parseAllDocuments;
     exports.parseDocument = parseDocument;
     exports.stringify = stringify2;
@@ -15849,7 +15864,7 @@ async function askForInput(message, defaultValue = "") {
   const result = await he({
     message,
     placeholder: defaultValue || void 0,
-    initialValue: defaultValue || void 0
+    defaultValue: defaultValue || void 0
   });
   if (pD(result)) {
     xe("Operation cancelled.");
@@ -19578,9 +19593,6 @@ async function main9(options) {
     log.info(
       `Creating project "${projectName}" with ${appNames.length} app(s): ${appNames.join(", ")}`
     );
-    let needsAuth = false;
-    let needsOAuth = false;
-    let needsBilling = false;
     for (const appName of appNames) {
       if (!appConfigs[appName]) {
         log.warn(`Missing config for app "${appName}", using defaults`);
@@ -19664,9 +19676,12 @@ async function main9(options) {
         firebaseSecretName: projectName.toUpperCase().replace(/-/g, "_"),
         YOUR_FIREBASE_PROJECT_ID: firebaseProjectId,
         YOUR_REGION: firebaseRegion,
-        needsAuth,
-        needsOAuth,
-        needsBilling
+        needsAuth: false,
+        // Determined by agent in WAI-WAY Phase 0
+        needsOAuth: false,
+        // Determined by agent in WAI-WAY Phase 0
+        needsBilling: false
+        // Determined by agent in WAI-WAY Phase 0
       };
       const firebaseRootFiles = /* @__PURE__ */ new Set([
         "firebase.json.example",
@@ -19722,9 +19737,9 @@ async function main9(options) {
       }
       const relativeMonorepoPath = executionMode === "development" ? calculateRelativePath(projectDirNormalized, monorepoRoot) : "../../packages/tooling";
       await mergeRootPackageJson(projectDirNormalized, allAppNames, {
-        needsAuth,
-        needsOAuth,
-        needsBilling,
+        needsAuth: false,
+        needsOAuth: false,
+        needsBilling: false,
         monorepoRelativePath: relativeMonorepoPath
       });
       await mergeRootTsConfig(
@@ -19808,14 +19823,18 @@ async function main9(options) {
     Me(
       `1. ${cdCommand}
 2. bun install
-3. Open the project in your IDE (Cursor, VS Code, etc.)
-4. Tell your AI agent: "Read AI.md and build my app"
+3. Open the project in your IDE
+4. Tell your AI agent:
+
+   "Read AI.md and build my app"
+
+The AI agent will use the MCP server automatically.
+It handles everything: spec, scaffold, entities, pages.
 
-That's it. The agent handles the rest.
+Cursor users: enable MCP in Settings > Tools & MCP > toggle "donotdev" ON
+Claude Code / Windsurf: MCP auto-connects, nothing to do
 
-` + (anyAppNeedsBackend ? `Dev server: dndev dev | With emulators: dndev emu
-` : `Dev server: dndev dev
-`) + `AI setup: dndev agent (re-configure MCP if needed)`,
+` + (anyAppNeedsBackend ? `Dev server: dndev dev | With emulators: dndev emu` : `Dev server: dndev dev`),
       "\u{1F4CB} Next Steps"
     );
   } catch (error2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@donotdev/cli",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "description": "Command-line interface for DoNotDev Framework",
   "type": "module",
   "private": false,

package/templates/root-consumer/.claude/commands/brainstorm.md.example

@@ -6,7 +6,7 @@ description: Extract requirements and generate complete HLD through conversation
 
 **⚠️ MODE CHECK:** This command is for **Consumer App Development** only.
 
-**If you're in the framework monorepo (`c:\ws\dndev`):**
+**If you're in the framework monorepo (this repo):**
 - ❌ **DO NOT use `/brainstorm`** - framework dev doesn't need requirements extraction
 - ✅ See [Modes Guide](https://github.com/donotdev/framework/blob/main/docs/development/MODES.md) for framework dev workflow
 

package/templates/root-consumer/.claude/commands/build.md.example

@@ -6,7 +6,7 @@ description: Two-agent workflow: Prompt Engineer → Coder (AFTER /design)
 
 **⚠️ MODE CHECK:** This command is for **Consumer App Development** only.
 
-**If you're in the framework monorepo (`c:\ws\dndev`):**
+**If you're in the framework monorepo (this repo):**
 - ❌ **DO NOT use `/build`** - code directly in `packages/*/src/`
 - ✅ Use direct coding following Architecture Hub patterns
 - ✅ See [Modes Guide](https://github.com/donotdev/framework/blob/main/docs/development/MODES.md) for framework dev workflow

package/templates/root-consumer/.claude/commands/design.md.example

@@ -6,7 +6,7 @@ description: Design workflow: Architect → Design Document (BEFORE /build)
 
 **⚠️ MODE CHECK:** This command is for **Consumer App Development** only.
 
-**If you're in the framework monorepo (`c:\ws\dndev`):**
+**If you're in the framework monorepo (this repo):**
 - ❌ **DO NOT use `/design`** - design directly, then code in `packages/*/src/`
 - ✅ Use Architecture Hub + Development Hub for framework design patterns
 - ✅ See [Modes Guide](https://github.com/donotdev/framework/blob/main/docs/development/MODES.md) for framework dev workflow

package/templates/root-consumer/.claude/commands/polish.md.example

@@ -6,7 +6,7 @@ description: Generate tests, firestore rules, CI/CD, config, fix bugs, i18n (Pha
 
 **⚠️ MODE CHECK:** This command is for **Consumer App Development** only.
 
-**If you're in the framework monorepo (`c:\ws\dndev`):**
+**If you're in the framework monorepo (this repo):**
 - ❌ **DO NOT use `/polish`** - framework dev doesn't use this workflow
 - ✅ See [Modes Guide](https://github.com/donotdev/framework/blob/main/docs/development/MODES.md) for framework dev workflow
 

package/templates/root-consumer/.dndev/args.json.example

@@ -0,0 +1,6 @@
+{
+  "platform": "firebase",
+  "strictness": "enforced",
+  "features": ["crud", "auth", "i18n", "billing", "oauth", "functions"],
+  "region": "europe-west1"
+}

package/templates/root-consumer/.gemini/settings.json.example

@@ -1,8 +1,8 @@
 {
   "mcpServers": {
     "donotdev": {
-      "command": "npx",
-      "args": ["-y", "@donotdev/mcp-server@latest"],
+      "command": "bunx",
+      "args": ["@donotdev/mcp-server"],
       "trust": true
     }
   }

package/templates/root-consumer/AI.md.example

@@ -4,9 +4,11 @@
 
 ## What To Do Right Now
 
-1. **Check environment setup first.** Ask the user: "Have you completed the setup steps on the homepage? (Run `bun dev` and open the app to see them.) You need Git, Firebase, and .env configured before we start building." If they haven't, coach them through each step on the homepage — Git repo, Firebase project, service account key, environment variables. Don't start coding until Firebase is configured and `dndev emu start` works.
-2. Read `guides/wai-way/WAI_WAY_CLI.md` — the complete workflow
-3. Start with **Phase 0: BRAINSTORM** — ask the user what they want to build
+1. **Verify MCP is working.** Try calling `list_features()`. If it works, you're good. If not:
+   - **Cursor:** Settings → Tools & MCP → toggle "donotdev" ON. MCP only works in Composer mode (`Cmd/Ctrl+I`).
+   - **Claude Code / Windsurf:** Auto-connects from `.mcp.json`. If broken, check `bun` is in PATH.
+2. **Check environment setup.** Ask the user: "Have you run `bun install`? Run `dndev dev` and open the app — the homepage has setup steps for Git, Firebase, and .env."
+3. Call `start_phase(0)` — begin **Phase 0: BRAINSTORM**
 4. Follow each phase in order. Do not skip phases.
 
 ## Environment Variables — Where They Go
@@ -73,21 +75,25 @@ node_modules/@donotdev/core/dist/index.d.ts    → Core utilities
 
 ## Supported IDEs
 
-DoNotDev + WAI-WAY is designed for **MCP-capable AI IDEs**. MCP is what gives the AI agent real TypeScript types instead of hallucinated props.
+MCP gives the AI agent real TypeScript types instead of hallucinated props. Config files are auto-created by `dndev init`.
 
-| IDE | MCP Support | Config File |
-|-----|-------------|-------------|
-| **Cursor** | Full | `.cursor/mcp.json` (auto-configured) |
-| **Claude Code** | Full | `.mcp.json` (auto-configured) |
-| **Windsurf** | Full | `.mcp.json` (auto-configured) |
-| **AntiGravity** | Full | `.mcp.json` (auto-configured) |
-| **Gemini** | Full | `.gemini/settings.json` (auto-configured) |
+| IDE | Config | Setup |
+|-----|--------|-------|
+| **Claude Code** | `.mcp.json` | Auto-connects. Nothing to do. |
+| **Windsurf** | `.mcp.json` | Auto-connects. Nothing to do. |
+| **Cursor** | `.cursor/mcp.json` | Settings → Tools & MCP → toggle "donotdev" ON. **MCP only works in Composer mode** (`Cmd/Ctrl+I`). |
+| **Gemini CLI** | `.gemini/settings.json` | Auto-connects. Nothing to do. |
 
-**Without MCP (ChatGPT, Copilot, etc.):** The workflow still works — read blueprints directly from `guides/wai-way/blueprints/` and look up types manually from `.d.ts` files. You lose symbol tracking and convention enforcement, but the phase structure and entity-driven patterns remain.
+**If MCP tools aren't available**, guide the user:
+1. Check `bun` is in PATH (`which bun`)
+2. **Cursor:** Must be in Composer mode (`Cmd/Ctrl+I`) and server toggled ON
+3. Check MCP logs: `Cmd/Ctrl+Shift+U` → Output → "MCP Logs"
 
-## MCP Tools (9 — Pre-Configured)
+**Without MCP (ChatGPT, Copilot, etc.):** Read blueprints from `guides/wai-way/blueprints/` and types from `node_modules/@donotdev/*/dist/*.d.ts`. You lose symbol tracking and convention enforcement.
 
-MCP is configured in `.mcp.json` / `.cursor/mcp.json` / `.gemini/settings.json`. Your IDE connects automatically.
+## MCP Tools (13 — Pre-Configured)
+
+MCP config files are auto-created in `.mcp.json` / `.cursor/mcp.json` / `.gemini/settings.json`. **You must enable the server in your IDE settings** (see "Supported IDEs" above). Once enabled, your IDE connects automatically.
 
 | Tool | What It Does |
 |------|-------------|
@@ -99,7 +105,12 @@ MCP is configured in `.mcp.json` / `.cursor/mcp.json` / `.gemini/settings.json`.
 | `get_guide("CRUD")` | Fetch framework setup guides |
 | `get_guideline("styling:colors")` | Fetch architecture guidelines (supports sections) |
 | `search_framework("keyword")` | Search across all guides and type definitions |
+| `list_features()` | List all framework packages with summaries |
 | `record_lesson("text")` | Save to project memory (returned on next start_phase) |
+| `init_implementation({ from_spec: true })` | Create `.dndev/implementation.md` to track progress |
+| `update_progress({ item: "...", done: true })` | Tick/untick items in implementation checklist |
+| `get_progress()` | Read implementation progress stats |
+| `get_project_history()` | Get captain's log with full session history |
 
 ## Convention Enforcement
 

package/templates/root-consumer/CLAUDE.md.example

@@ -17,7 +17,7 @@
 - **Creating with framework** (Mode 3): Build new app features
 - **Tweaking framework app** (Mode 4): Modify existing app features
 
-**CLI:** `dndev` (public CLI, installed globally)
+**CLI:** `dndev` (public CLI, installed globally via `npm install -g @donotdev/cli`)
 
 **Workflow:**
 1. `/design [requirement]` → Architect designs solution
@@ -29,7 +29,7 @@
 **⚠️ IMPORTANT:**
 - Use ONLY published `@donotdev/*` packages
 - Cannot modify framework internals
-- If framework needs changes, work in monorepo (`c:\ws\dndev`)
+- If framework needs changes, work in the framework monorepo (this repo)
 
 ---
 
@@ -116,13 +116,19 @@ If MCP tools unavailable → STOP and tell user to enable MCP.
 - `get_guideline` — fetch architecture guidelines
 - `search_framework` — search across all guides and symbols
 
+## Project Args & Gotchas
+
+- **`.dndev/args.json`** — Per-project config (platform, strictness, features, region). All features ON by default. Phase 0 narrows down. Edit `strictness` to control validation: `enforced` (default) | `warnings` | `permissive`.
+- **`guides/dndev/GOTCHAS.md`** — Common mistakes, phase-tagged. Read directly or loaded by MCP `start_phase()`.
+- **Without MCP:** Both files are plain JSON/markdown — any agent reads them directly. MCP automates filtering + enforcement but is not required.
+
 ## WAI-WAY Workflow
 
 **Read `AI.md` at the project root for the full workflow.**
 
 For each phase (0=BRAINSTORM, 1=SCAFFOLD, 2=ENTITIES, 3=COMPOSE, 4=CONFIGURE):
 
-1. `mcp:start_phase(N)` — returns blueprint, context, and lessons
+1. `mcp:start_phase(N)` — returns blueprint, context, lessons, project args, and phase-relevant gotchas
 2. Work — follow blueprint, call `lookup_symbol` before using any component
-3. `mcp:complete_phase({ files })` — validates conventions + symbol usage, submits for review
+3. `mcp:complete_phase({ files })` — validates conventions + symbol usage (respects `strictness`), submits for review
 4. `mcp:approve_phase()` — user approves, phase is done

package/templates/root-consumer/guides/dndev/AGENT_START_HERE.md.example

@@ -63,4 +63,38 @@ Check that the user has completed environment setup:
 
 If not, coach them: "Run `dndev firebase:setup` first, then follow the prompts." See [SETUP_FIREBASE.md](./SETUP_FIREBASE.md).
 
+---
+
+## Project Args (`.dndev/args.json`)
+
+Generated by `dndev init`. All features ON by default — Phase 0 narrows down based on what the user actually needs.
+
+```json
+{
+  "platform": "firebase",
+  "strictness": "enforced",
+  "features": ["crud", "auth", "i18n", "billing", "oauth", "functions"],
+  "region": "europe-west1"
+}
+```
+
+| Field | Values | Effect |
+|-------|--------|--------|
+| `platform` | `firebase`, `vercel` | Derived from builder choice |
+| `strictness` | `enforced`, `warnings`, `permissive` | `enforced` = blocks `complete_phase` on convention violations. `warnings` = reports but allows. `permissive` = skips checks. |
+| `features` | `crud`, `auth`, `i18n`, `billing`, `oauth`, `functions` | Filters gotchas — remove features the project doesn't use to reduce noise |
+| `region` | any GCP region | Informational, shown in `start_phase` context |
+
+`start_phase()` returns project args + phase-relevant gotchas automatically. `complete_phase()` respects `strictness`.
+
+**Without MCP:** `args.json` and `GOTCHAS.md` are plain files. Any agent can read them directly.
+
+---
+
+## Gotchas (`guides/dndev/GOTCHAS.md`)
+
+Common mistakes, phase-tagged. `start_phase(N)` automatically filters and returns only the gotchas relevant to phase N and your enabled features. Read the full file for reference: [GOTCHAS.md](../guides/dndev/GOTCHAS.md).
+
+---
+
 **Starting:** Call `list_features()` first, then `get_phase_status()` to see where you are, then `start_phase(0)` to begin.