@donotdev/cli 0.0.17 → 0.0.19

package/templates/app-demo/src/pages/ShowcasePage.tsx.example

@@ -0,0 +1,91 @@
+import { useMemo, useState } from 'react';
+import { useNavigate } from 'react-router-dom';
+import { Component } from 'lucide-react';
+
+import {
+  Badge,
+  Card,
+  Grid,
+  Input,
+  Section,
+  Stack,
+  Tabs,
+} from '@donotdev/components';
+
+import {
+  COMPONENT_CONFIGS,
+  getCSSFamilies,
+} from './components/componentConfig';
+
+import type { PageMeta } from '@donotdev/core';
+import type { CSSFamily } from './components/ComponentsData';
+
+export const meta: PageMeta = {
+  icon: <Component />,
+  preset: 'admin',
+};
+
+export default function ShowcasePage() {
+  const navigate = useNavigate();
+  const [selectedTab, setSelectedTab] = useState<CSSFamily | 'all'>('all');
+  const [searchQuery, setSearchQuery] = useState('');
+
+  const componentsInTab = useMemo(() => {
+    return COMPONENT_CONFIGS.filter((config) => {
+      if (selectedTab !== 'all' && config.cssFamily !== selectedTab)
+        return false;
+      return (
+        searchQuery === '' ||
+        config.name.toLowerCase().includes(searchQuery.toLowerCase())
+      );
+    }).sort((a, b) => a.name.localeCompare(b.name));
+  }, [selectedTab, searchQuery]);
+
+  const cssFamilies = getCSSFamilies();
+
+  return (
+    <Stack gap="large">
+      <Stack direction="row" gap="medium" align="end" wrap="wrap">
+        <Input
+          placeholder="Filter components..."
+          value={searchQuery}
+          onChange={(e) => setSearchQuery(e.target.value)}
+        />
+      </Stack>
+
+      <Tabs
+        items={cssFamilies.map((family) => ({
+          value: family.id,
+          label: family.label,
+          content: null,
+        }))}
+        value={selectedTab}
+        onValueChange={(value) => setSelectedTab(value as CSSFamily | 'all')}
+      />
+
+      <Section
+        title={
+          cssFamilies.find((f) => f.id === selectedTab)?.label || 'Components'
+        }
+      >
+        <Grid cols={[1, 2, 3, 4]} gap="medium">
+          {componentsInTab.map((config) => (
+            <Card
+              key={config.id}
+              title={config.name}
+              clickable
+              onClick={() => navigate(`/showcase/${config.id}`)}
+            >
+              <Stack direction="row" justify="end">
+                <Badge variant="secondary">
+                  {cssFamilies.find((f) => f.id === config.cssFamily)?.label ||
+                    config.cssFamily}
+                </Badge>
+              </Stack>
+            </Card>
+          ))}
+        </Grid>
+      </Section>
+    </Stack>
+  );
+}

package/templates/app-demo/src/pages/legal/LegalPage.tsx.example

@@ -0,0 +1,14 @@
+import { Scale } from 'lucide-react';
+
+import { LegalNoticeTemplate } from '@donotdev/templates';
+
+import type { PageMeta } from '@donotdev/core';
+
+export const meta: PageMeta = {
+  icon: <Scale />,
+  hideFromMenu: true,
+};
+
+export default function LegalPage() {
+  return <LegalNoticeTemplate />;
+}

package/templates/app-demo/src/pages/legal/PrivacyPage.tsx.example

@@ -0,0 +1,14 @@
+import { Shield } from 'lucide-react';
+
+import { PrivacyPolicyTemplate } from '@donotdev/templates';
+
+import type { PageMeta } from '@donotdev/core';
+
+export const meta: PageMeta = {
+  icon: <Shield />,
+  hideFromMenu: true,
+};
+
+export default function PrivacyPage() {
+  return <PrivacyPolicyTemplate />;
+}

package/templates/app-demo/src/pages/legal/TermsPage.tsx.example

@@ -0,0 +1,14 @@
+import { FileText } from 'lucide-react';
+
+import { TermsOfServiceTemplate } from '@donotdev/templates';
+
+import type { PageMeta } from '@donotdev/core';
+
+export const meta: PageMeta = {
+  icon: <FileText />,
+  hideFromMenu: true,
+};
+
+export default function TermsPage() {
+  return <TermsOfServiceTemplate />;
+}

package/templates/app-demo/tsconfig.json.example

@@ -1,5 +1,5 @@
 {
-  "extends": "../../tsconfig.json",
+  "extends": "../../tsconfig.vite.json",
   "compilerOptions": {
     "baseUrl": ".",
     "types": ["node", "vite/client"]

package/templates/app-demo/vite.config.ts.example

@@ -1,53 +1,28 @@
 // apps/demo/vite.config.ts
-import react from '@vitejs/plugin-react';
-import { defineConfig } from 'vite';
-import tsconfigPaths from 'vite-tsconfig-paths';
-import autoprefixer from 'autoprefixer';
-// @ts-expect-error - postcss-import doesn't have type definitions
-import postcssImport from 'postcss-import';
-import postcssNesting from 'postcss-nesting';
-import { resolve as pathResolve } from 'node:path';
-import { createRequire } from 'node:module';
 
-const require = createRequire(import.meta.url);
+/**
+ * @fileoverview Vite build configuration for the demo app
+ * @description Configures Vite build tool with application settings, development server, HMR, and file watching options for the demo application.
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
 
-export default defineConfig({
-  plugins: [
-    react({
-      jsxRuntime: 'automatic',
-    }),
-    tsconfigPaths({
-      ignoreConfigErrors: true,
-    }),
-  ],
-  css: {
-    postcss: {
-      plugins: [
-        postcssImport({
-          resolve: (id: string, basedir: string) => {
-            // Handle package imports like '@donotdev/components/styles'
-            if (!id.startsWith('.')) {
-              try {
-                return require.resolve(id, { paths: [basedir] });
-              } catch {
-                // Fallback to relative resolution
-                return pathResolve(basedir, id);
-              }
-            }
-            // Relative imports
-            return pathResolve(basedir, id);
-          },
-        }),
-        postcssNesting,
-        autoprefixer,
-      ],
+import { defineViteConfig } from '@donotdev/core/vite';
+
+import { appConfig } from './src/config/app';
+
+// Features and SEO are now in app.ts (runtime config)
+// Only build-time configs (routes, themes, i18n, assets) go here
+export default defineViteConfig({
+  appConfig,
+  server: {
+    port: 3003,
+    https: false,
+
+    // HMR Configuration - Enabled for debugging
+    hmr: {
+      overlay: true, // Show error overlay in browser
     },
   },
-  optimizeDeps: {
-    include: ['react', 'react-dom', 'react/jsx-runtime'],
-  },
-  resolve: {
-    dedupe: ['react', 'react-dom'],
-    preserveSymlinks: false,
-  },
-});
+});

package/templates/app-expo/README.md.example

@@ -8,7 +8,7 @@ Mobile app built with DoNotDev Framework and Expo.
 
 - Node.js 20+ and Bun 1.3+
 - Expo Go app on your phone (for development)
-- Firebase project (run `dndev setup firebase`)
+- Provider configured (run `dndev coach` then `dndev setup`)
 
 ### Development
 

package/templates/app-expo/app/index.tsx.example

@@ -33,7 +33,7 @@ export default function HomePage() {
             <View>
               <Text level="h3">1. Backend Setup</Text>
               <Text level="small">
-                Run: dndev setup
+                Run: dndev coach → fill .env → dndev setup
               </Text>
             </View>
             

package/templates/app-vite/src/pages/HomePage.tsx.example

@@ -51,17 +51,15 @@ export default function HomePage() {
           />
 
           <Card
-            title="2. Firebase Setup"
+            title="2. Provider Setup"
             content={[
-              'Run: dndev setup firebase',
-              'This will:',
-              '  - Create or select a Firebase project',
-              '  - Create a web app if needed',
-              '  - Write Firebase config to your .env automatically',
-              '  - Update .firebaserc with your project ID',
-              'Then follow the prompts for the 2 manual steps:',
-              '  - Download service account key',
-              '  - Enable Auth + Firestore in Firebase Console',
+              'Run: dndev coach',
+              'This shows what to configure:',
+              '  - Which dashboard to visit',
+              '  - What to copy and where to paste it',
+              'Fill in your .env values, then run:',
+              '  dndev setup',
+              'Setup validates, automates, and health-checks.',
             ]}
           />
         </Grid>

package/templates/overlay-firebase/env.fragment.example

@@ -3,7 +3,7 @@
 # Firebase Configuration
 # =============================================================================
 # Get these values from your Firebase project settings
-# Run `dndev setup firebase` to auto-populate, or copy from Firebase Console
+# Run `dndev coach` to see where to get these, then `dndev setup` to validate
 VITE_FIREBASE_API_KEY=
 VITE_FIREBASE_PROJECT_ID=
 # Copy from Firebase Console. Framework uses APP_URL hostname in production automatically.

package/templates/overlay-firebase/env.fragment.expo.example

@@ -3,7 +3,7 @@
 # Firebase Configuration
 # =============================================================================
 # Get these values from your Firebase project settings
-# Run `dndev setup firebase` to auto-populate, or copy from Firebase Console
+# Run `dndev coach` to see where to get these, then `dndev setup` to validate
 EXPO_PUBLIC_FIREBASE_API_KEY=
 EXPO_PUBLIC_FIREBASE_PROJECT_ID=
 # Copy from Firebase Console. Framework uses APP_URL hostname in production automatically.

package/templates/overlay-firebase/env.fragment.nextjs.example

@@ -3,7 +3,7 @@
 # Firebase Configuration
 # =============================================================================
 # Get these values from your Firebase project settings
-# Run `dndev setup firebase` to auto-populate, or copy from Firebase Console
+# Run `dndev coach` to see where to get these, then `dndev setup` to validate
 NEXT_PUBLIC_FIREBASE_API_KEY=
 NEXT_PUBLIC_FIREBASE_PROJECT_ID=
 # Copy from Firebase Console. Framework uses APP_URL hostname in production automatically.

package/templates/overlay-supabase/env.fragment.example

@@ -6,7 +6,7 @@
 #   - Project URL: the https://xxx.supabase.co URL
 #   - Public key:  "Publishable key" (sb_publishable_...) or legacy "anon key" (eyJ...)
 #
-# Then run: dndev setup supabase
+# Then run: dndev setup
 # =============================================================================
 VITE_SUPABASE_URL=
 VITE_SUPABASE_PUBLIC_KEY=

package/templates/overlay-supabase/env.fragment.expo.example

@@ -6,7 +6,7 @@
 #   - Project URL: the https://xxx.supabase.co URL
 #   - Public key:  "Publishable key" (sb_publishable_...) or legacy "anon key" (eyJ...)
 #
-# Then run: dndev setup supabase
+# Then run: dndev setup
 # =============================================================================
 EXPO_PUBLIC_SUPABASE_URL=
 EXPO_PUBLIC_SUPABASE_PUBLIC_KEY=

package/templates/overlay-supabase/env.fragment.nextjs.example

@@ -6,7 +6,7 @@
 #   - Project URL: the https://xxx.supabase.co URL
 #   - Public key:  "Publishable key" (sb_publishable_...) or legacy "anon key" (eyJ...)
 #
-# Then run: dndev setup supabase
+# Then run: dndev setup
 # =============================================================================
 NEXT_PUBLIC_SUPABASE_URL=
 NEXT_PUBLIC_SUPABASE_PUBLIC_KEY=

package/templates/overlay-vercel/env.fragment.example

@@ -3,7 +3,7 @@
 # Firebase Configuration (data layer for Vercel-hosted app)
 # =============================================================================
 # Get these values from your Firebase project settings
-# Run `dndev setup firebase` to auto-populate, or copy from Firebase Console
+# Run `dndev coach` to see where to get these, then `dndev setup` to validate
 VITE_FIREBASE_API_KEY=
 VITE_FIREBASE_PROJECT_ID=
 # Copy from Firebase Console. Framework uses APP_URL hostname in production automatically.

package/templates/overlay-vercel/env.fragment.nextjs.example

@@ -3,7 +3,7 @@
 # Firebase Configuration (data layer for Vercel-hosted app)
 # =============================================================================
 # Get these values from your Firebase project settings
-# Run `dndev setup firebase` to auto-populate, or copy from Firebase Console
+# Run `dndev coach` to see where to get these, then `dndev setup` to validate
 NEXT_PUBLIC_FIREBASE_API_KEY=
 NEXT_PUBLIC_FIREBASE_PROJECT_ID=
 # Copy from Firebase Console. Framework uses APP_URL hostname in production automatically.

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

@@ -41,6 +41,14 @@ description: Extract requirements and generate complete HLD through conversation
 
 ## Process
 
+### Step 0: Start Phase (MANDATORY — DO THIS FIRST)
+
+**BEFORE asking any questions or doing any work**, call:
+```
+start_phase(0)
+```
+This activates Phase 0: BRAINSTORM and loads the blueprint, persona, context, and lessons learned from previous sessions. **Do NOT proceed without this call.**
+
 ### Step 1: Activate EXTRACTOR Agent
 
 **Deploy:** `/agents extractor` (BMAD EXTRACTOR persona)
@@ -87,7 +95,7 @@ EXTRACTOR generates `HLD.md` with:
 
 ---
 
-## Validation Gate
+## Validation Gate & Phase Completion (MANDATORY)
 
 **Before proceeding to `/design`:**
 - [ ] HLD is complete (no empty sections or TBDs)
@@ -97,6 +105,12 @@ EXTRACTOR generates `HLD.md` with:
 - [ ] Native vs custom analysis complete
 - [ ] User has validated HLD
 
+**When HLD is complete**, write the filled-out spec to `docs/HLD.md` (the template at `guides/wai-way/spec_template.md` stays untouched as reference). Then call:
+```
+complete_phase({ files: ["docs/HLD.md"], summary: "HLD complete — N entities, N pages, N features" })
+```
+Then wait for the user to call `approve_phase()` before moving to `/design`.
+
 **Quality Over Speed:** Take as long as needed. A complete HLD that takes 4 hours is better than an incomplete one that takes 20 minutes.
 
 ---

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

@@ -36,6 +36,14 @@ description: Two-agent workflow: Prompt Engineer → Coder (AFTER /design)
 
 ## Process
 
+### Step 0: Start Phase (MANDATORY — DO THIS FIRST)
+
+**BEFORE writing any code**, call:
+```
+start_phase(3)
+```
+This activates Phase 3: COMPOSE and loads the blueprint, persona, context, and lessons. **Do NOT write code without this call.**
+
 ### Step 1: Activate FORGER Agent
 
 **Deploy:** `/agents builder` (BMAD FORGER persona)
@@ -54,10 +62,19 @@ description: Two-agent workflow: Prompt Engineer → Coder (AFTER /design)
    - Phase 6: Integration (wire everything together)
 4. Use framework defaults ONLY (no styling, no customization)
 5. Hardcode all strings (no i18n yet)
-6. Validate each phase before proceeding
+6. Run `dndev tc` after every file change — type errors must be fixed immediately
+7. Validate each phase before proceeding
 
 **Output:** Working app (functional MVP, no styling)
 
+### Phase Completion (MANDATORY)
+
+When all pages are built and `dndev tc` passes, call:
+```
+complete_phase({ files: ["src/pages/...all page files..."], summary: "N pages composed, all type-checking" })
+```
+Wait for user to call `approve_phase()` before moving to `/polish`.
+
 ---
 
 ## Alternative: Two-Agent Workflow
@@ -79,10 +96,15 @@ For complex builds, you can use:
 - **Builder (FORGER):** Implements exactly what's in LLD, uses framework defaults only
 - **Framework defaults ONLY:** No styling, no customization (deferred to /polish)
 - **Hardcode strings:** No i18n yet (deferred to /polish)
-- **MCP required:** Use lookup_symbol for ALL components
 - **Phase by phase:** Complete each phase before proceeding
 - **User:** Reviews output, proceeds to /polish when functional
 
+## STOP — lookup_symbol Before Every Component (Repeated Here On Purpose)
+
+**STOP before writing ANY `@donotdev` import.** Call `lookup_symbol({ symbol: "Name" })` first. Do NOT guess props, hooks, or APIs. Do NOT proceed without verification. `complete_phase` will reject un-looked-up symbols.
+
+**Import convention:** Always `@donotdev/<package>` — never sub-paths. No `@donotdev/ui/routing`, no `@donotdev/components/card`. The only exceptions are `@donotdev/core/server`, `@donotdev/core/vite`, `@donotdev/core/next`, `@donotdev/core/functions`.
+
 ## Mode Detection
 
 **CRITICAL:** Check working mode first.

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

@@ -36,6 +36,21 @@ description: Design workflow: Architect → Design Document (BEFORE /build)
 
 ## Process
 
+### Step 0: Start Phase (MANDATORY — DO THIS FIRST)
+
+**BEFORE doing any design work**, call the appropriate phase:
+```
+start_phase(1)   # for SCAFFOLD (routes, page stubs)
+start_phase(2)   # for ENTITIES (data models, fields, access)
+```
+This loads the blueprint, persona, context, and lessons. **Do NOT proceed without this call.**
+
+When design work is complete, call:
+```
+complete_phase({ files: ["...affected files..."], summary: "Description of what was designed" })
+```
+Wait for user to call `approve_phase()` before moving on.
+
 ### Step 1: Architect Phase
 
 **Deploy:** `/agents architect` (WAI-WAY architect role)
@@ -102,6 +117,8 @@ UNRESOLVED:
 - **ALWAYS reference framework architecture** - stay aligned
 - **ALWAYS identify impacts** - what breaks if we change this?
 - **ALWAYS prepare for /build** - design should be actionable
+- **ALWAYS use `lookup_symbol`** when referencing @donotdev components in your design — verify the API exists before putting it in the plan
+- **Import convention:** Always `@donotdev/<package>` top-level, never sub-paths. The only exceptions are `@donotdev/core/server`, `@donotdev/core/vite`, `@donotdev/core/next`, `@donotdev/core/functions`
 
 ## Integration with WAI-WAY & BMAD
 

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

@@ -42,6 +42,14 @@ description: Generate tests, firestore rules, CI/CD, config, fix bugs, i18n (Pha
 
 ## Process
 
+### Step 0: Start Phase (MANDATORY — DO THIS FIRST)
+
+**BEFORE any polish work**, call:
+```
+start_phase(4)
+```
+This activates Phase 4: CONFIGURE and loads the blueprint, persona, context, and lessons. **Do NOT proceed without this call.**
+
 ### Step 1: Activate Polisher Agent
 
 **Deploy:** `/agents polisher` (Phase 4 Polisher persona)
@@ -112,6 +120,7 @@ Extract strings to `src/locales/`, replace with `useTranslation()`.
 ## Ship Readiness
 
 App is ready to ship when:
+- ✅ `dndev tc` passes
 - ✅ `bun test` passes
 - ✅ `firestore.rules` generated
 - ✅ `.github/workflows/ci.yml` created
@@ -121,6 +130,14 @@ App is ready to ship when:
 - ✅ Configuration complete
 - ✅ (Optional) i18n added
 
+## Phase Completion (MANDATORY)
+
+When all ship readiness checks pass, call:
+```
+complete_phase({ files: ["...all test/config files..."], summary: "Tests passing, config complete, ready to ship" })
+```
+Wait for user to call `approve_phase()`.
+
 ---
 
 ## Next Step

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

@@ -2,52 +2,83 @@
 
 > **You are building a DoNotDev app.** Read this file completely before doing anything else.
 
+## Welcome
+
+We'll build your app together in **5 structured phases**: brainstorm requirements, scaffold pages, define data, wire everything up, and polish for production. Each phase has a clear deliverable and validation gate. This isn't freeform coding — there's a proven methodology that produces solid, production-ready apps.
+
 ## What To Do Right Now
 
 1. **Verify MCP is working.** Call `list_features()`. If it fails, run `get_guide("AGENT_START_HERE")` for IDE-specific setup.
 2. Call `start_phase(0)` — begin **Phase 0: BRAINSTORM**
-3. Follow each phase in order. Do not skip phases.
+3. Follow each phase in order. **Do not skip phases. Do not work outside a phase.**
+
+## The 5 Phases — MANDATORY
 
-## The 5 Phases
+**ALL work MUST happen inside an active phase.** Call `start_phase(N)` BEFORE writing any code or documents. Call `complete_phase({ files })` BEFORE moving to the next phase. Working outside a phase is a violation — no exceptions.
 
-| Phase | Name | What Happens |
-|-------|------|-------------|
-| 0 | **BRAINSTORM** | Ask questions, understand requirements, produce validated spec |
-| 1 | **SCAFFOLD** | Create all routes and page stubs from spec |
-| 2 | **ENTITIES** | Define all data models (fields, access, visibility) |
-| 3 | **COMPOSE** | Build pages with framework components (hardcode strings) |
-| 4 | **CONFIGURE** | Config, test, polish, i18n. Run `/grill` and `/techdebt` before shipping |
+| Phase | Name | Slash Command | What Happens |
+|-------|------|---------------|-------------|
+| 0 | **BRAINSTORM** | `/brainstorm` | Ask questions, understand requirements, produce validated spec |
+| 1 | **SCAFFOLD** | `/design` | Create all routes and page stubs from spec |
+| 2 | **ENTITIES** | `/design` | Define all data models (fields, access, visibility) |
+| 3 | **COMPOSE** | `/build` | Build pages with framework components (hardcode strings) |
+| 4 | **CONFIGURE** | `/polish` | Config, test, polish, i18n. Run `/grill` and `/techdebt` before shipping |
 
-## Workflow Per Phase
+## Workflow Per Phase — NON-NEGOTIABLE
 
 ```
 start_phase(N)          → get blueprint + persona + context + lessons
   ↓
 work                    → follow blueprint, lookup_symbol for every component
   ↓
+dndev tc                → type-check MUST pass before completing phase
+  ↓
 complete_phase(files)   → validate conventions + symbol usage → submit for review
   ↓
-approve_phase()         → phase done, move to next
+approve_phase()         → user approves, move to next phase
 ```
 
-## Component Usage — Non-Negotiable
+**You MUST call `start_phase(N)` before ANY work in that phase.**
+**You MUST call `complete_phase({ files })` when the phase is done.**
+**You MUST run `dndev tc` after every code change and before every `complete_phase`.**
+Skipping these steps means the work is untracked, unvalidated, and unacceptable.
+
+## STOP — lookup_symbol Before ANY @donotdev Code
 
-**Never guess component props.** Call `lookup_symbol({ symbol: "ComponentName" })` before writing ANY `@donotdev` component. Every call is tracked — `complete_phase` flags components used without lookup.
+**STOP. Before writing ANY `@donotdev` import, call `lookup_symbol({ symbol: "Name" })`.** Do NOT guess. Do NOT proceed without it. `complete_phase` rejects un-looked-up symbols.
 
-Without MCP: read `.d.ts` files directly from `node_modules/@donotdev/*/dist/`.
+**Always import from `@donotdev/<package>` top-level** — never sub-paths. See `get_guide("SETUP_PAGES")` for conventions and patterns.
 
 ## CLI Commands
 
-`dndev` is an **installed CLI** (globally via `npm install -g @donotdev/cli`). Run it directly — **never** use `bunx dndev` or `npx dndev`.
+`dndev` is installed globally via `bun install -g` (no sudo needed) and also as a local devDependency. Run it directly — or use `bun run dev` / `bunx dndev` as fallback.
 
 | Command | What it does |
 |---------|-------------|
-| `dndev create-app` | Interactive wizard — creates a new app in the monorepo |
 | `dndev dev` | Start the dev server (Vite/Next.js via Turbo) |
-| `dndev emu start` | Start Firebase emulators |
+| `dndev dev:myapp` | Start dev server for a specific app |
+| `dndev build` | Build for production |
+| `dndev preview` | Preview production build |
+| `dndev emu` | Start dev with Firebase emulators |
+| `dndev tc` | **Type-check all packages — run after every code change** |
+| `dndev tc:myapp` | Type-check a specific app |
+| `dndev format` | Format code with Prettier |
 | `dndev deploy` | Deploy to production |
-| `dndev setup firebase` | Configure Firebase project + .env |
-| `dndev setup supabase` | Configure Supabase project + .env |
+| `dndev staging` | Deploy to staging/UAT |
+| `dndev coach` | Show what to configure before running setup |
+| `dndev setup` | Validate .env, automate provider setup, health check |
+| `dndev doctor` | Check project health (providers, .env) |
+| `dndev bump` | Update @donotdev packages to latest |
+| `dndev cacheout` | Clear build caches |
+| `dndev sync-secrets` | Sync env vars to Firebase/Vercel/GitHub |
+| `dndev make-admin` | Set a user as admin |
+| `dndev agent` | Configure MCP server for AI agents |
+| `dndev wai` | Output WAI-WAY activation prompt |
+| `dndev create-app` | Interactive wizard — creates a new app in the monorepo |
+
+Most commands support `:<app>` syntax: `dndev dev:web`, `dndev tc:admin`, `dndev build:public`.
+
+Run `dndev --help` for the full command list.
 
 `dndev create-app` is **interactive** — it prompts for builder (Vite/Next.js/Expo), backend (Firebase/Supabase/none), and features. There is no `--preset` flag.
 
@@ -56,6 +87,7 @@ Without MCP: read `.d.ts` files directly from `node_modules/@donotdev/*/dist/`.
 - **ESM only** — never `require()`
 - **RTL safe** — use `start`/`end`, never `left`/`right`
 - **Import order** — React → vendors → @donotdev → relative
+- **Import convention** — always `@donotdev/<pkg>` top-level, never sub-paths
 - **Framework-first** — if something's missing, say what and stop
 - **No .md file creation** — never create documentation/analysis/summary .md files unless explicitly asked. Session notes go in `.dndev/`
 - **Follow existing patterns** — the scaffolded files ARE your documentation
@@ -64,8 +96,9 @@ Without MCP: read `.d.ts` files directly from `node_modules/@donotdev/*/dist/`.
 
 Call `get_guide("AGENT_START_HERE")` for the full tool reference, IDE setup, env var guide, and fallback instructions.
 
-Key tools: `start_phase` · `complete_phase` · `approve_phase` · `lookup_symbol` · `get_guide` · `get_guideline` · `search_framework` · `list_features` · `record_lesson`
+Key tools: `start_phase` · `complete_phase` · `approve_phase` · `lookup_symbol` · `get_guide` · `get_guideline` · `search_framework` · `list_features` · `record_lesson` · `run_typecheck`
 
 ## Security Gate
 
-Before production: run `dn soc2`. See `get_guide("SOC2")` for details.
+Before production: run `dndev doctor` and `/grill`. See `get_guide("SOC2")` for details.
+Golden path: `dndev coach` → fill .env → `dndev setup` → `dndev doctor`.