@donotdev/cli 0.0.19 → 0.0.21

package/templates/app-dndev/src/config/app.ts.example

@@ -0,0 +1,103 @@
+/**
+ * @fileoverview Application Configuration
+ *
+ * THIS FILE IS YOUR MAIN CONFIGURATION. Update the values below.
+ *
+ * QUICK START:
+ * 1. Set APP_NAME and APP_SHORT_NAME
+ * 2. Choose your preset (see guide below)
+ * 3. Configure footer links
+ * 4. Run `bun dev` - everything else is automatic
+ */
+
+import type { AppConfig } from '@donotdev/core';
+
+// ============================================================================
+// APP IDENTITY - Update these values
+// ============================================================================
+
+export const APP_NAME = 'DoNotDev';
+export const APP_SHORT_NAME = 'DnDev';
+export const APP_DESCRIPTION = 'DoNotDev Development Environment';
+
+// ============================================================================
+// MAIN CONFIGURATION
+// ============================================================================
+
+export const appConfig: AppConfig = {
+  app: {
+    name: APP_NAME,
+    shortName: APP_SHORT_NAME,
+    description: APP_DESCRIPTION,
+    // Note: URL comes from VITE_APP_URL in .env, not here
+
+    // Footer legal links - remove any you don't need
+    footer: {
+      legalLinks: [
+        { path: '#cookie-settings', label: 'footer.legal.cookieSettings' },
+        { path: '/legal/privacy', label: 'footer.legal.privacyPolicy' },
+        { path: '/legal/terms', label: 'footer.legal.termsOfService' },
+        // { path: '/legal/notice', label: 'footer.legal.legalNotice' },
+      ],
+    },
+  },
+
+  // ==========================================================================
+  // PRESET GUIDE - Choose your layout
+  // ==========================================================================
+  //
+  // 'landing'  → Marketing site. Full-width sections, centered content, no sidebar.
+  //              Best for: Homepage, product pages, pricing, landing pages.
+  //
+  // 'admin'    → Dashboard app. Collapsible sidebar, header with user menu.
+  //              Best for: Admin panels, CRM, internal tools, CRUD apps.
+  //
+  // 'moolti'   → Multi-panel. Left sidebar nav, optional right context sidebar.
+  //              Best for: Complex apps with nested navigation, settings panels.
+  //
+  // 'docs'     → Documentation. Left sidebar TOC, right sidebar on-page nav.
+  //              Best for: Documentation sites, knowledge bases, help centers.
+  //
+  // 'blog'     → Blog layout. Wide content area, optional category sidebar.
+  //              Best for: Blog, news, articles, content-heavy sites.
+  //
+  // 'game'     → Fullscreen. Minimal chrome, focus on content area.
+  //              Best for: Games, immersive experiences, presentations.
+  //
+  // 'plain'    → No layout. Just your pages, you handle everything.
+  //              Best for: Custom layouts, embedded widgets, special cases.
+  //
+  preset: 'plain',
+
+  // ==========================================================================
+  // FEATURES - Uncomment to enable
+  // ==========================================================================
+  features: {
+    // debug: true, // Enable debug tools in development
+  },
+
+  // ==========================================================================
+  // AUTH CONFIG - Uncomment to customize
+  // ==========================================================================
+  // auth: {
+  //   authRoute: '/signin',        // Redirect when auth required
+  //   roleRoute: '/403',           // Redirect when role insufficient
+  //   tierRoute: '/pricing',       // Redirect when subscription required
+  //   profilePath: '/profile',     // Profile page path (undefined to hide)
+  //   authMenuItems: [             // Custom menu items for logged-in users
+  //     { path: '/dashboard', label: 'Dashboard' },
+  //   ],
+  // },
+
+  // ==========================================================================
+  // QUERY CACHE - Uncomment to enable auto-refetch
+  // ==========================================================================
+  // Default: Infinite cache (cost-optimized, manual refresh)
+  // Uncomment for auto-refetch behavior:
+  // query: {
+  //   staleTime: 1000 * 60 * 5,    // 5 minutes
+  //   refetchOnWindowFocus: true,
+  //   refetchOnReconnect: true,
+  // },
+};
+

package/templates/app-dndev/src/config/commands.ts.example

@@ -0,0 +1,171 @@
+/**
+ * @fileoverview Command registry — quick actions for the cockpit
+ *
+ * Consumer defaults map to scaffolded skills (.claude/commands/*.md.example)
+ * and `dndev` CLI commands.
+ *
+ * Override API:
+ *   setCommand('typecheck', 'dn tc');
+ *   addAction({ id: 'lint', ... });
+ *   removeAction('setup');
+ */
+
+import {
+  ClipboardList,
+  FileCode,
+  Flame,
+  Layers,
+  Lightbulb,
+  MonitorPlay,
+  Play,
+  Rocket,
+  Settings,
+  TestTube,
+  Wrench,
+} from 'lucide-react';
+
+import type { TabMode } from '../stores/dndevStore';
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export interface QuickAction {
+  /** Unique key */
+  id: string;
+  /** Lucide icon component */
+  icon: typeof FileCode;
+  /** Short label (1-2 words) */
+  label: string;
+  /** One-sentence description of what this does */
+  description: string;
+  /** Shell command or /skill to execute */
+  command: string;
+  /** Where to run: shell tab or ai-agent */
+  target: TabMode;
+}
+
+// ============================================================================
+// CONSUMER DEFAULTS — WAI-WAY skills + operational commands
+// ============================================================================
+
+const registry = new Map<string, QuickAction>([
+  // ---- WAI-WAY Phase Skills ----
+  ['brainstorm', {
+    id: 'brainstorm',
+    icon: Lightbulb,
+    label: 'Brainstorm',
+    description: 'Extract requirements, produce PRD/HLD/LLD.',
+    command: '/brainstorm',
+    target: 'ai-agent',
+  }],
+  ['design', {
+    id: 'design',
+    icon: Layers,
+    label: 'Design',
+    description: 'Architecture and design from validated specs.',
+    command: '/design',
+    target: 'ai-agent',
+  }],
+  ['build', {
+    id: 'build',
+    icon: Play,
+    label: 'Build',
+    description: 'Compose pages with framework components.',
+    command: '/build',
+    target: 'ai-agent',
+  }],
+  ['polish', {
+    id: 'polish',
+    icon: Wrench,
+    label: 'Polish',
+    description: 'Tests, security rules, CI/CD, production config.',
+    command: '/polish',
+    target: 'ai-agent',
+  }],
+
+  // ---- Review & Quality ----
+  ['grill', {
+    id: 'grill',
+    icon: Flame,
+    label: 'Grill',
+    description: 'Staff-engineer code review with security depth.',
+    command: '/grill',
+    target: 'ai-agent',
+  }],
+  ['techdebt', {
+    id: 'techdebt',
+    icon: ClipboardList,
+    label: 'Tech Debt',
+    description: 'End-of-session tech debt sweep.',
+    command: '/techdebt',
+    target: 'ai-agent',
+  }],
+
+  // ---- Operational Commands ----
+  ['typecheck', {
+    id: 'typecheck',
+    icon: FileCode,
+    label: 'Typecheck',
+    description: 'Validate TypeScript types across your project.',
+    command: 'dndev type-check',
+    target: 'shell',
+  }],
+  ['test', {
+    id: 'test',
+    icon: TestTube,
+    label: 'Tests',
+    description: 'Run your test suites and report failures.',
+    command: 'dndev test',
+    target: 'shell',
+  }],
+  ['dev', {
+    id: 'dev',
+    icon: MonitorPlay,
+    label: 'Dev',
+    description: 'Start the development server.',
+    command: 'dndev dev',
+    target: 'shell',
+  }],
+  ['deploy', {
+    id: 'deploy',
+    icon: Rocket,
+    label: 'Deploy',
+    description: 'Ship to production.',
+    command: 'dndev deploy',
+    target: 'shell',
+  }],
+  ['setup', {
+    id: 'setup',
+    icon: Settings,
+    label: 'Setup',
+    description: 'Configure environment and validate deps.',
+    command: 'dndev setup',
+    target: 'shell',
+  }],
+]);
+
+// ============================================================================
+// API
+// ============================================================================
+
+/** Get all registered actions */
+export function getActions(): QuickAction[] {
+  return [...registry.values()];
+}
+
+/** Override a default action's command */
+export function setCommand(id: string, command: string): void {
+  const action = registry.get(id);
+  if (action) action.command = command;
+}
+
+/** Add a custom action */
+export function addAction(action: QuickAction): void {
+  registry.set(action.id, action);
+}
+
+/** Remove an action */
+export function removeAction(id: string): void {
+  registry.delete(id);
+}

package/templates/app-dndev/src/config/legal.ts.example

@@ -0,0 +1,170 @@
+// src/config/legal.ts
+
+/**
+ * @fileoverview Legal Information Configuration
+ * @description Centralized legal information for Terms, Privacy, and Legal Notice pages
+ *
+ * IMPORTANT: Configure your actual legal information here.
+ * This file is used by all legal pages (Terms of Service, Privacy Policy, Legal Notice).
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ */
+
+import type { LegalConfig } from '@donotdev/core';
+
+/**
+ * Legal Configuration
+ *
+ * Fill in your actual company and legal information below.
+ * Remove any optional fields you don't need.
+ *
+ * For detailed documentation on each field, see the JSDoc in @donotdev/types or
+ * hover over any field in your IDE for inline documentation.
+ */
+export const legalConfig: LegalConfig = {
+	/**
+	 * Company/Publisher Information
+	 */
+	company: {
+		name: 'Your Company Name', // Required - Full legal name
+		shortName: 'YCN', // Optional - Abbreviation
+		legalStatus: 'LLC', // Optional - e.g., "LLC", "SARL", "SAS", "GmbH", "Ltd"
+		registrationNumber: '123456789', // Optional but recommended - e.g., SIRET (France), Company Number (UK), EIN (USA)
+		vatNumber: 'XX123456789', // Optional - VAT/Tax ID, required for EU businesses
+		shareCapital: '10,000 USD', // Optional - Required in some jurisdictions like France
+	},
+
+	/**
+	 * Contact Information
+	 */
+	contact: {
+		address: '123 Main Street, City, State/Province, Postal Code, Country', // Required - Registered office address
+		email: 'legal@yourcompany.com', // Required - Legal contact email
+		phone: '+1 (555) 123-4567', // Optional but recommended
+		supportEmail: 'support@yourcompany.com', // Required - Customer support email
+		privacyEmail: 'privacy@yourcompany.com', // Required - Privacy inquiries
+		dpoEmail: 'dpo@yourcompany.com', // Required for GDPR compliance if processing significant personal data
+	},
+
+	/**
+	 * Publication Director
+	 *
+	 * The person legally responsible for the website's content.
+	 * Required by law in France ("Directeur de la publication").
+	 */
+	director: {
+		name: 'John Doe', // Required - Full name of the responsible person
+		role: 'CEO', // Optional - Their title/role
+	},
+
+	/**
+	 * Hosting Provider
+	 *
+	 * Information about where your website is hosted.
+	 * Required by law in many jurisdictions including France.
+	 */
+	hosting: {
+		provider: 'Firebase Hosting by Google', // Required - Hosting service name
+		address: 'Google LLC, 1600 Amphitheatre Parkway, Mountain View, CA 94043, USA', // Optional - Hosting provider's address
+		contact: 'https://firebase.google.com/support', // Optional - Support URL or email
+	},
+
+	/**
+	 * Legal Jurisdiction
+	 *
+	 * Where your business operates and how disputes are resolved.
+	 */
+	jurisdiction: {
+		country: 'United States', // Required - Operating jurisdiction
+		arbitrationOrg: 'American Arbitration Association', // Optional - For dispute resolution
+		arbitrationLocation: 'New York, NY', // Optional - Where arbitration would occur
+	},
+
+	/**
+	 * Website Information
+	 */
+	website: {
+		url: 'https://yourcompany.com', // Required - Your main website URL
+	},
+
+	/**
+	 * Optional Sections Configuration
+	 *
+	 * Enable/disable specific sections in your legal pages.
+	 * Set to true to include, false to exclude.
+	 */
+	sections: {
+		// Terms of Service sections
+		terms: {
+			children: false, // Include children-specific provisions (COPPA)
+			international: true, // Include international users provisions
+			california: false, // Include California-specific provisions (CCPA)
+			eu: true, // Include EU-specific provisions
+		},
+		// Privacy Policy sections
+		privacy: {
+			children: false, // Include children's privacy provisions (COPPA)
+			international: true, // Include international data transfer provisions
+			california: false, // Include California privacy rights (CCPA)
+			eu: true, // Include EU privacy provisions (GDPR)
+		},
+		// Legal Notice sections
+		legalNotice: {
+			intellectualProperty: true, // Include IP notice
+			personalData: true, // Include link to Privacy Policy
+			cookies: true, // Include cookies reference
+		},
+	},
+} as const;
+
+/**
+ * Type-safe access to legal config
+ */
+export type AppLegalConfig = typeof legalConfig;
+
+/**
+ * QUICK START CHECKLIST:
+ *
+ * 1. Company Information:
+ *    - [ ] Update company.name with your legal entity name
+ *    - [ ] Set company.legalStatus (SARL, LLC, GmbH, etc.)
+ *    - [ ] Add company.registrationNumber (SIRET, EIN, Company Number)
+ *    - [ ] Add company.vatNumber if you're in the EU or have VAT obligations
+ *
+ * 2. Contact Information:
+ *    - [ ] Update contact.address with your registered office
+ *    - [ ] Set contact.email for legal notices
+ *    - [ ] Set contact.supportEmail for customer support
+ *    - [ ] Set contact.privacyEmail for GDPR/privacy requests
+ *    - [ ] Set contact.dpoEmail if you have a Data Protection Officer
+ *
+ * 3. Legal Responsibility:
+ *    - [ ] Update director.name (person responsible for content)
+ *    - [ ] Set director.role (CEO, Director, etc.)
+ *
+ * 4. Hosting:
+ *    - [ ] Verify hosting.provider is correct
+ *    - [ ] Update hosting.address and hosting.contact if needed
+ *
+ * 5. Jurisdiction:
+ *    - [ ] Set jurisdiction.country where you operate
+ *    - [ ] Configure arbitration details if needed
+ *
+ * 6. Optional Sections:
+ *    - [ ] Review and enable/disable sections based on your needs
+ *    - [ ] Enable sections.*.eu if you have EU users (GDPR)
+ *    - [ ] Enable sections.*.california if you have California users (CCPA)
+ *
+ * LEGAL COMPLIANCE NOTES:
+ *
+ * - France: All fields with "Required" are mandatory for French websites
+ * - EU/GDPR: contact.dpoEmail is required if you process significant personal data
+ * - USA/California: Enable California sections if you have California users
+ * - International: Enable international sections for global audience
+ *
+ * For more information, consult your legal advisor or refer to:
+ * - https://docs.dndev.com/legal/configuration (framework docs)
+ * - Your local business registration authority
+ * - GDPR guidance: https://gdpr.eu
+ */

package/templates/app-dndev/src/config/providers.ts.example

@@ -0,0 +1,7 @@
+// src/config/providers.ts — Provider bootstrap
+// Auto-generated by DoNotDev scaffolding. Edit freely.
+// When you add a backend (Firebase, Supabase), replace this file with the appropriate provider setup.
+// See: guides/dndev/SETUP_PROVIDERS.md
+
+// No backend configured — nothing to register.
+// To add a backend later, run: dndev create-app (in an existing project, it merges)

package/templates/app-dndev/src/globals.css.example

@@ -0,0 +1,10 @@
+/* apps/dndev/src/globals.css */
+@import '@donotdev/ui/dndev.css';
+@import '@xterm/xterm/css/xterm.css';
+
+@import './themes.css';
+
+/**
+ * Font choices (--font-family, --font-sans, etc.) belong in themes.css.
+ * Fonts (Inter, Space Grotesk, Playfair, Roboto) are bundled via @donotdev/ui; no external fetch, no public/fonts required.
+ */ 

package/templates/app-dndev/src/hooks/useDndevFile.ts.example

@@ -0,0 +1,144 @@
+/**
+ * @fileoverview Generic hook for reading .dndev/ and project files via the file API.
+ *
+ * Fetches `GET /api/dndev/file?path=<filePath>` on mount.
+ * Auto-reloads when the file changes on disk (via HMR WebSocket).
+ * Companion `writeDndevFile` posts content back to the generic write endpoint.
+ *
+ * HMR-safe: all module-level state stored in import.meta.hot.data
+ * to survive Vite module re-evaluations without duplicating handlers.
+ */
+
+import { useCallback, useEffect, useRef, useState } from 'react';
+
+// ============================================================================
+// HMR-SAFE listener registry
+// ============================================================================
+
+type ListenerMap = Map<string, Set<() => void>>;
+
+/**
+ * Get the shared listeners Map. Stored in import.meta.hot.data so it
+ * survives Vite HMR module re-evaluations.
+ */
+function getListeners(): ListenerMap {
+  if (import.meta.hot) {
+    if (!import.meta.hot.data.listeners) {
+      import.meta.hot.data.listeners = new Map<string, Set<() => void>>();
+    }
+    return import.meta.hot.data.listeners as ListenerMap;
+  }
+  return fallbackListeners;
+}
+
+/** Production fallback (no HMR) */
+const fallbackListeners: ListenerMap = new Map();
+
+// Register the HMR handler exactly once (flag in hot.data survives reloads)
+if (import.meta.hot && !import.meta.hot.data.dndevFileHmr) {
+  import.meta.hot.data.dndevFileHmr = true;
+  import.meta.hot.on('dndev:file-changed', (event: { path: string }) => {
+    const listeners = getListeners();
+    const cbs = listeners.get(event.path);
+    if (cbs) for (const cb of cbs) cb();
+  });
+}
+
+function registerHmrListener(filePath: string, callback: () => void): () => void {
+  const listeners = getListeners();
+  if (!listeners.has(filePath)) listeners.set(filePath, new Set());
+  listeners.get(filePath)!.add(callback);
+
+  return () => {
+    const current = getListeners();
+    current.get(filePath)?.delete(callback);
+    if (current.get(filePath)?.size === 0) current.delete(filePath);
+  };
+}
+
+// ============================================================================
+// HOOK
+// ============================================================================
+
+interface UseDndevFileResult<T> {
+  data: T | null;
+  loading: boolean;
+  error: string | null;
+  reload: () => Promise<void>;
+}
+
+export function useDndevFile<T>(
+  filePath: string | null,
+  parser: (raw: unknown) => T,
+  options?: { fallback?: T },
+): UseDndevFileResult<T> {
+  const fallbackRef = useRef(options?.fallback ?? null);
+  const parserRef = useRef(parser);
+  parserRef.current = parser;
+  const fetchingRef = useRef(false);
+
+  const [data, setData] = useState<T | null>(fallbackRef.current);
+  const [loading, setLoading] = useState(!!filePath);
+  const [error, setError] = useState<string | null>(null);
+
+  const reload = useCallback(async () => {
+    if (!filePath || fetchingRef.current) return;
+    fetchingRef.current = true;
+
+    try {
+      const res = await fetch(
+        `/api/dndev/file?path=${encodeURIComponent(filePath)}`,
+      );
+      if (res.ok) {
+        const json = await res.json();
+        setData(parserRef.current(json.content));
+        setError(null);
+      } else if (res.status === 404) {
+        setData(fallbackRef.current);
+        setError(null);
+      } else {
+        setError(`HTTP ${res.status}`);
+      }
+    } catch (err) {
+      setError(String(err));
+    }
+    fetchingRef.current = false;
+    setLoading(false);
+  }, [filePath]);
+
+  // Fetch on mount / filePath change
+  useEffect(() => {
+    if (!filePath) {
+      setData(fallbackRef.current);
+      setLoading(false);
+      return;
+    }
+    setLoading(true);
+    reload();
+  }, [filePath, reload]);
+
+  // HMR subscription
+  useEffect(() => {
+    if (!filePath) return;
+    return registerHmrListener(filePath, reload);
+  }, [filePath, reload]);
+
+  return { data, loading, error, reload };
+}
+
+// ============================================================================
+// WRITE HELPER
+// ============================================================================
+
+export async function writeDndevFile(filePath: string, content: unknown): Promise<boolean> {
+  try {
+    const res = await fetch(`/api/dndev/file?path=${encodeURIComponent(filePath)}`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ content }),
+    });
+    return res.ok;
+  } catch {
+    return false;
+  }
+}

package/templates/app-dndev/src/main.tsx.example

@@ -0,0 +1,21 @@
+import './globals.css';
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import { App } from './App';
+
+// ✅ SHELL LOADER: BaseStoresInitializer handles removal when stores are ready
+// (removed early removal - BaseStoresInitializer has the knowledge of when stores are ready)
+
+// Ensure the root element exists
+const rootElement = document.getElementById('root');
+if (!rootElement) {
+  throw new Error(
+    'Root element not found. Did you remove the root div from index.html?'
+  );
+}
+
+ReactDOM.createRoot(rootElement).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);