lean-spec 0.2.5-dev.20251124045153 → 0.2.5-dev.20251124054130

package/dist/cli.js

@@ -1,4 +1,4 @@
-import { analyzeCommand, archiveCommand, backfillCommand, boardCommand, checkCommand, compactCommand, createCommand, depsCommand, filesCommand, ganttCommand, initCommand, linkCommand, listCommand, mcpCommand, migrateCommand, openCommand, searchCommand, splitCommand, statsCommand, templatesCommand, timelineCommand, tokensCommand, uiCommand, unlinkCommand, updateCommand, validateCommand, viewCommand } from './chunk-IGNO4GX2.js';
+import { analyzeCommand, archiveCommand, backfillCommand, boardCommand, checkCommand, compactCommand, createCommand, depsCommand, examplesCommand, filesCommand, ganttCommand, initCommand, linkCommand, listCommand, mcpCommand, migrateCommand, openCommand, searchCommand, splitCommand, statsCommand, templatesCommand, timelineCommand, tokensCommand, uiCommand, unlinkCommand, updateCommand, validateCommand, viewCommand } from './chunk-6FKLWECL.js';
 import './chunk-LVD7ZAVZ.js';
 import { Command } from 'commander';
 import { readFileSync } from 'fs';
@@ -15,6 +15,7 @@ function registerCommands(program2) {
   program2.addCommand(compactCommand());
   program2.addCommand(createCommand());
   program2.addCommand(depsCommand());
+  program2.addCommand(examplesCommand());
   program2.addCommand(filesCommand());
   program2.addCommand(ganttCommand());
   program2.addCommand(initCommand());
@@ -51,6 +52,7 @@ Command Groups:
     archive <spec>                Move spec to archived/
     backfill [specs...]           Backfill timestamps from git history
     create <name>                 Create new spec
+    examples                      List example projects for tutorials
     init                          Initialize LeanSpec in current directory
     link <spec>                   Add relationships between specs
     migrate <input-path>          Migrate specs from other SDD tools
@@ -91,6 +93,9 @@ Command Groups:
 Examples:
   $ lean-spec init
   $ lean-spec init -y
+  $ lean-spec init --example dark-theme
+  $ lean-spec init --example dashboard-widgets --name my-demo
+  $ lean-spec examples
   $ lean-spec create my-feature --priority high
   $ lean-spec list --status in-progress
   $ lean-spec view 042

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/commands/registry.ts","../src/cli.ts"],"names":["program"],"mappings":"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","file":"cli.js","sourcesContent":["import { Command } from 'commander';\nimport {\n  analyzeCommand,\n  archiveCommand,\n  backfillCommand,\n  boardCommand,\n  checkCommand,\n  compactCommand,\n  createCommand,\n  depsCommand,\n  filesCommand,\n  ganttCommand,\n  initCommand,\n  linkCommand,\n  listCommand,\n  mcpCommand,\n  migrateCommand,\n  openCommand,\n  searchCommand,\n  splitCommand,\n  statsCommand,\n  templatesCommand,\n  timelineCommand,\n  tokensCommand,\n  uiCommand,\n  unlinkCommand,\n  updateCommand,\n  validateCommand,\n  viewCommand,\n} from './index.js';\n\n/**\n * Register all commands in alphabetical order\n */\nexport function registerCommands(program: Command): void {\n  // Alphabetically sorted command registration\n  program.addCommand(analyzeCommand());\n  program.addCommand(archiveCommand());\n  program.addCommand(backfillCommand());\n  program.addCommand(boardCommand());\n  program.addCommand(checkCommand());\n  program.addCommand(compactCommand());\n  program.addCommand(createCommand());\n  program.addCommand(depsCommand());\n  program.addCommand(filesCommand());\n  program.addCommand(ganttCommand());\n  program.addCommand(initCommand());\n  program.addCommand(linkCommand());\n  program.addCommand(listCommand());\n  program.addCommand(mcpCommand());\n  program.addCommand(migrateCommand());\n  program.addCommand(openCommand());\n  program.addCommand(searchCommand());\n  program.addCommand(splitCommand());\n  program.addCommand(statsCommand());\n  program.addCommand(templatesCommand());\n  program.addCommand(timelineCommand());\n  program.addCommand(tokensCommand());\n  program.addCommand(uiCommand());\n  program.addCommand(unlinkCommand());\n  program.addCommand(updateCommand());\n  program.addCommand(validateCommand());\n  program.addCommand(viewCommand());\n}\n","import { Command } from 'commander';\nimport { readFileSync } from 'fs';\nimport { fileURLToPath } from 'url';\nimport { dirname, join } from 'path';\nimport { registerCommands } from './commands/registry.js';\n\n// Get version from package.json\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\nconst packageJson = JSON.parse(\n  readFileSync(join(__dirname, '../package.json'), 'utf-8')\n);\n\nconst program = new Command();\n\nprogram\n  .name('lean-spec')\n  .description('Manage LeanSpec documents')\n  .version(packageJson.version);\n\n// Add custom help text with grouped commands\nprogram.addHelpText('after', `\nCommand Groups:\n\n  Core Workflow:\n    archive <spec>                Move spec to archived/\n    backfill [specs...]           Backfill timestamps from git history\n    create <name>                 Create new spec\n    init                          Initialize LeanSpec in current directory\n    link <spec>                   Add relationships between specs\n    migrate <input-path>          Migrate specs from other SDD tools\n    unlink <spec>                 Remove relationships between specs\n    update <spec>                 Update spec metadata\n    \n  Discovery & Search:\n    files <spec>                  List files in a spec\n    list                          List all specs\n    open <spec>                   Open spec in editor\n    search <query>                Full-text search with metadata filters\n    view <spec>                   View spec content\n    \n  Project Analytics:\n    board                         Show Kanban-style board view\n    deps <spec>                   Show dependency graph for a spec\n    gantt                         Show timeline with dependencies\n    stats                         Show aggregate statistics\n    timeline                      Show creation/completion over time\n    \n  Quality & Optimization:\n    analyze <spec>                Analyze spec complexity and structure\n    check                         Check for sequence conflicts\n    tokens [spec]                 Count tokens for LLM context management\n    validate [specs...]           Validate specs for quality issues\n    \n  Advanced Editing:\n    compact <spec>                Remove specified line ranges from spec\n    split <spec>                  Split spec into multiple files\n    \n  Configuration:\n    templates                     Manage spec templates\n    \n  Integration:\n    mcp                           Start MCP server for AI assistants\n    ui                            Start local web UI for spec management\n\nExamples:\n  $ lean-spec init\n  $ lean-spec init -y\n  $ lean-spec create my-feature --priority high\n  $ lean-spec list --status in-progress\n  $ lean-spec view 042\n  $ lean-spec link 085 --depends-on 042,035\n  $ lean-spec link 085 --related 082\n  $ lean-spec unlink 085 --depends-on 042\n  $ lean-spec deps 085\n  $ lean-spec backfill --dry-run\n  $ lean-spec migrate ./docs/adr\n  $ lean-spec migrate ./docs/rfcs --with copilot\n  $ lean-spec board --tag backend\n  $ lean-spec search \"authentication\"\n  $ lean-spec validate\n  $ lean-spec tokens 059\n  $ lean-spec analyze 045 --json\n  $ lean-spec split 045 --output README.md:1-150 --output DESIGN.md:151-end\n  $ lean-spec ui\n  $ lean-spec ui --port 3001 --no-open\n  $ lean-spec ui --specs ./docs/specs --dry-run\n`);\n\n// Register all commands (alphabetically ordered)\nregisterCommands(program);\n\n// Parse and execute\nprogram.parse();\n"]}
+{"version":3,"sources":["../src/commands/registry.ts","../src/cli.ts"],"names":["program"],"mappings":"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","file":"cli.js","sourcesContent":["import { Command } from 'commander';\nimport {\n  analyzeCommand,\n  archiveCommand,\n  backfillCommand,\n  boardCommand,\n  checkCommand,\n  compactCommand,\n  createCommand,\n  depsCommand,\n  examplesCommand,\n  filesCommand,\n  ganttCommand,\n  initCommand,\n  linkCommand,\n  listCommand,\n  mcpCommand,\n  migrateCommand,\n  openCommand,\n  searchCommand,\n  splitCommand,\n  statsCommand,\n  templatesCommand,\n  timelineCommand,\n  tokensCommand,\n  uiCommand,\n  unlinkCommand,\n  updateCommand,\n  validateCommand,\n  viewCommand,\n} from './index.js';\n\n/**\n * Register all commands in alphabetical order\n */\nexport function registerCommands(program: Command): void {\n  // Alphabetically sorted command registration\n  program.addCommand(analyzeCommand());\n  program.addCommand(archiveCommand());\n  program.addCommand(backfillCommand());\n  program.addCommand(boardCommand());\n  program.addCommand(checkCommand());\n  program.addCommand(compactCommand());\n  program.addCommand(createCommand());\n  program.addCommand(depsCommand());\n  program.addCommand(examplesCommand());\n  program.addCommand(filesCommand());\n  program.addCommand(ganttCommand());\n  program.addCommand(initCommand());\n  program.addCommand(linkCommand());\n  program.addCommand(listCommand());\n  program.addCommand(mcpCommand());\n  program.addCommand(migrateCommand());\n  program.addCommand(openCommand());\n  program.addCommand(searchCommand());\n  program.addCommand(splitCommand());\n  program.addCommand(statsCommand());\n  program.addCommand(templatesCommand());\n  program.addCommand(timelineCommand());\n  program.addCommand(tokensCommand());\n  program.addCommand(uiCommand());\n  program.addCommand(unlinkCommand());\n  program.addCommand(updateCommand());\n  program.addCommand(validateCommand());\n  program.addCommand(viewCommand());\n}\n","import { Command } from 'commander';\nimport { readFileSync } from 'fs';\nimport { fileURLToPath } from 'url';\nimport { dirname, join } from 'path';\nimport { registerCommands } from './commands/registry.js';\n\n// Get version from package.json\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\nconst packageJson = JSON.parse(\n  readFileSync(join(__dirname, '../package.json'), 'utf-8')\n);\n\nconst program = new Command();\n\nprogram\n  .name('lean-spec')\n  .description('Manage LeanSpec documents')\n  .version(packageJson.version);\n\n// Add custom help text with grouped commands\nprogram.addHelpText('after', `\nCommand Groups:\n\n  Core Workflow:\n    archive <spec>                Move spec to archived/\n    backfill [specs...]           Backfill timestamps from git history\n    create <name>                 Create new spec\n    examples                      List example projects for tutorials\n    init                          Initialize LeanSpec in current directory\n    link <spec>                   Add relationships between specs\n    migrate <input-path>          Migrate specs from other SDD tools\n    unlink <spec>                 Remove relationships between specs\n    update <spec>                 Update spec metadata\n    \n  Discovery & Search:\n    files <spec>                  List files in a spec\n    list                          List all specs\n    open <spec>                   Open spec in editor\n    search <query>                Full-text search with metadata filters\n    view <spec>                   View spec content\n    \n  Project Analytics:\n    board                         Show Kanban-style board view\n    deps <spec>                   Show dependency graph for a spec\n    gantt                         Show timeline with dependencies\n    stats                         Show aggregate statistics\n    timeline                      Show creation/completion over time\n    \n  Quality & Optimization:\n    analyze <spec>                Analyze spec complexity and structure\n    check                         Check for sequence conflicts\n    tokens [spec]                 Count tokens for LLM context management\n    validate [specs...]           Validate specs for quality issues\n    \n  Advanced Editing:\n    compact <spec>                Remove specified line ranges from spec\n    split <spec>                  Split spec into multiple files\n    \n  Configuration:\n    templates                     Manage spec templates\n    \n  Integration:\n    mcp                           Start MCP server for AI assistants\n    ui                            Start local web UI for spec management\n\nExamples:\n  $ lean-spec init\n  $ lean-spec init -y\n  $ lean-spec init --example dark-theme\n  $ lean-spec init --example dashboard-widgets --name my-demo\n  $ lean-spec examples\n  $ lean-spec create my-feature --priority high\n  $ lean-spec list --status in-progress\n  $ lean-spec view 042\n  $ lean-spec link 085 --depends-on 042,035\n  $ lean-spec link 085 --related 082\n  $ lean-spec unlink 085 --depends-on 042\n  $ lean-spec deps 085\n  $ lean-spec backfill --dry-run\n  $ lean-spec migrate ./docs/adr\n  $ lean-spec migrate ./docs/rfcs --with copilot\n  $ lean-spec board --tag backend\n  $ lean-spec search \"authentication\"\n  $ lean-spec validate\n  $ lean-spec tokens 059\n  $ lean-spec analyze 045 --json\n  $ lean-spec split 045 --output README.md:1-150 --output DESIGN.md:151-end\n  $ lean-spec ui\n  $ lean-spec ui --port 3001 --no-open\n  $ lean-spec ui --specs ./docs/specs --dry-run\n`);\n\n// Register all commands (alphabetically ordered)\nregisterCommands(program);\n\n// Parse and execute\nprogram.parse();\n"]}

package/dist/mcp-server.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-export { createMcpServer } from './chunk-IGNO4GX2.js';
+export { createMcpServer } from './chunk-6FKLWECL.js';
 import './chunk-LVD7ZAVZ.js';
 //# sourceMappingURL=mcp-server.js.map
 //# sourceMappingURL=mcp-server.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lean-spec",
-  "version": "0.2.5-dev.20251124045153",
+  "version": "0.2.5-dev.20251124054130",
   "description": "Specification-driven development made simple",
   "type": "module",
   "bin": {

package/templates/examples/api-refactor/README.md

@@ -0,0 +1,81 @@
+# API Refactor Demo
+
+> **Tutorial**: [Refactoring with Specs](https://leanspec.dev/docs/tutorials/refactoring-specs)
+
+## Scenario
+
+You're maintaining a Node.js application that started simple but has grown messy. The app integrates with multiple external services (weather API, currency converter, timezone lookup), but all the HTTP logic is tangled together in the main application code.
+
+You want to extract a reusable API client module that:
+- Centralizes HTTP request handling
+- Provides a clean interface for service calls
+- Handles errors consistently
+- Makes the code easier to test and maintain
+
+## What's Here
+
+A monolithic Node.js app with:
+- Weather lookup feature (calls external API)
+- Currency conversion (calls external API)
+- Timezone lookup (calls external API)
+- All HTTP logic mixed into business logic (tight coupling)
+- No error handling abstraction
+- Hard to test individual parts
+
+**Files:**
+- `src/app.js` - Main application with all features
+- `src/services/weatherService.js` - Weather API calls (tightly coupled)
+- `src/services/currencyService.js` - Currency API calls (tightly coupled)
+- `src/services/timezoneService.js` - Timezone API calls (tightly coupled)
+
+## Getting Started
+
+```bash
+# Install dependencies
+npm install
+
+# Run the app
+npm start
+
+# Try the features:
+# - Weather: Get weather for a city
+# - Currency: Convert between currencies
+# - Timezone: Look up timezone info
+```
+
+## Your Mission
+
+Refactor the HTTP logic into a clean, reusable API client. Follow the tutorial and ask your AI assistant:
+
+> "Help me refactor this app using LeanSpec. I want to extract a reusable API client module that centralizes all the HTTP logic."
+
+The AI will guide you through:
+1. Creating a refactoring spec
+2. Designing the API client interface
+3. Extracting the HTTP logic step by step
+4. Updating services to use the new client
+5. Verifying everything still works
+
+## Current Problems
+
+- **Duplicated code**: Each service reimplements HTTP requests
+- **No error handling**: Errors handled inconsistently
+- **Hard to test**: Can't mock HTTP calls easily
+- **Tight coupling**: Business logic mixed with HTTP details
+- **No retry logic**: Network failures aren't handled
+
+These are perfect opportunities to practice refactoring with specs!
+
+## Expected Result
+
+After refactoring, you should have:
+```
+src/
+  app.js (unchanged interface)
+  client/
+    apiClient.js (new - centralized HTTP logic)
+  services/
+    weatherService.js (simplified - uses apiClient)
+    currencyService.js (simplified - uses apiClient)
+    timezoneService.js (simplified - uses apiClient)
+```

package/templates/examples/api-refactor/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "api-refactor-demo",
+  "version": "1.0.0",
+  "description": "Monolithic Node.js app for LeanSpec Tutorial 3",
+  "type": "module",
+  "scripts": {
+    "start": "node src/app.js",
+    "dev": "node --watch src/app.js"
+  },
+  "keywords": ["leanspec", "tutorial", "demo"],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "node-fetch": "^3.3.2"
+  }
+}

package/templates/examples/api-refactor/src/app.js

@@ -0,0 +1,40 @@
+import { getWeather } from './services/weatherService.js';
+import { convertCurrency } from './services/currencyService.js';
+import { getTimezone } from './services/timezoneService.js';
+
+console.log('=== Multi-Service App Demo ===\n');
+
+// Demo 1: Weather lookup
+console.log('1. Weather Lookup:');
+try {
+  const weather = await getWeather('London');
+  console.log(`   ${weather.city}: ${weather.temp}°C, ${weather.condition}`);
+} catch (error) {
+  console.log(`   Error: ${error.message}`);
+}
+
+console.log('');
+
+// Demo 2: Currency conversion
+console.log('2. Currency Conversion:');
+try {
+  const result = await convertCurrency(100, 'USD', 'EUR');
+  console.log(`   ${result.amount} ${result.from} = ${result.converted} ${result.to}`);
+} catch (error) {
+  console.log(`   Error: ${error.message}`);
+}
+
+console.log('');
+
+// Demo 3: Timezone lookup
+console.log('3. Timezone Lookup:');
+try {
+  const timezone = await getTimezone('America/New_York');
+  console.log(`   ${timezone.name}: ${timezone.offset} (${timezone.abbreviation})`);
+} catch (error) {
+  console.log(`   Error: ${error.message}`);
+}
+
+console.log('');
+console.log('Notice: All services work, but they all duplicate HTTP logic!');
+console.log('Your task: Extract a reusable API client module.');

package/templates/examples/api-refactor/src/services/currencyService.js

@@ -0,0 +1,43 @@
+import fetch from 'node-fetch';
+
+/**
+ * Convert currency
+ * 
+ * PROBLEM: Duplicates HTTP logic from weatherService
+ * - Same fetch boilerplate
+ * - Same error handling pattern
+ * - Same JSON parsing
+ * - Should be using a shared HTTP client!
+ */
+export async function convertCurrency(amount, from, to) {
+  // Mock API endpoint (replace with real API in production)
+  const url = `https://api.exchangerate.host/convert?from=${from}&to=${to}&amount=${amount}`;
+  
+  try {
+    const response = await fetch(url);
+    
+    if (!response.ok) {
+      throw new Error(`Currency API error: ${response.status}`);
+    }
+    
+    const data = await response.json();
+    
+    // Business logic: Transform API response to our format
+    return {
+      amount,
+      from,
+      to,
+      converted: data.result || (amount * 0.85).toFixed(2),
+      rate: data.info?.rate || 0.85,
+    };
+  } catch (error) {
+    // For demo, return mock data on error
+    return {
+      amount,
+      from,
+      to,
+      converted: (amount * 0.85).toFixed(2),
+      rate: 0.85,
+    };
+  }
+}

package/templates/examples/api-refactor/src/services/timezoneService.js

@@ -0,0 +1,41 @@
+import fetch from 'node-fetch';
+
+/**
+ * Get timezone information
+ * 
+ * PROBLEM: Yet another copy of the same HTTP logic!
+ * - Third time we're writing fetch + error handling + JSON parsing
+ * - Violates DRY principle
+ * - Makes testing hard (need to mock fetch in 3 places)
+ * - Changes to HTTP logic need updates in 3 files
+ */
+export async function getTimezone(zone) {
+  // Mock API endpoint (replace with real API in production)
+  const url = `http://worldtimeapi.org/api/timezone/${zone}`;
+  
+  try {
+    const response = await fetch(url);
+    
+    if (!response.ok) {
+      throw new Error(`Timezone API error: ${response.status}`);
+    }
+    
+    const data = await response.json();
+    
+    // Business logic: Transform API response to our format
+    return {
+      name: data.timezone || zone,
+      offset: data.utc_offset || '-05:00',
+      abbreviation: data.abbreviation || 'EST',
+      datetime: data.datetime || new Date().toISOString(),
+    };
+  } catch (error) {
+    // For demo, return mock data on error
+    return {
+      name: zone,
+      offset: '-05:00',
+      abbreviation: 'EST',
+      datetime: new Date().toISOString(),
+    };
+  }
+}

package/templates/examples/api-refactor/src/services/weatherService.js

@@ -0,0 +1,42 @@
+import fetch from 'node-fetch';
+
+/**
+ * Get weather for a city
+ * 
+ * PROBLEM: This function has HTTP logic mixed with business logic
+ * - Manual fetch calls
+ * - Manual error handling
+ * - Manual JSON parsing
+ * - No retry logic
+ * - Hard to test (can't mock HTTP)
+ */
+export async function getWeather(city) {
+  // Mock API endpoint (replace with real API in production)
+  const url = `https://api.weatherapi.com/v1/current.json?key=mock&q=${city}`;
+  
+  try {
+    const response = await fetch(url);
+    
+    if (!response.ok) {
+      throw new Error(`Weather API error: ${response.status}`);
+    }
+    
+    const data = await response.json();
+    
+    // Business logic: Transform API response to our format
+    return {
+      city: data.location?.name || city,
+      temp: data.current?.temp_c || Math.floor(Math.random() * 30),
+      condition: data.current?.condition?.text || 'Sunny',
+      humidity: data.current?.humidity || Math.floor(Math.random() * 100),
+    };
+  } catch (error) {
+    // For demo, return mock data on error
+    return {
+      city,
+      temp: Math.floor(Math.random() * 30),
+      condition: 'Sunny (mock data)',
+      humidity: Math.floor(Math.random() * 100),
+    };
+  }
+}

package/templates/examples/dark-theme/README.md

@@ -0,0 +1,55 @@
+# Dark Theme Demo
+
+> **Tutorial**: [Adding Dark Theme Support](https://leanspec.dev/docs/tutorials/adding-dark-theme)
+
+## Scenario
+
+You're building a personal task manager web app. The app works great, but users keep requesting a dark mode option for late-night productivity sessions. Currently, the app only has a bright light theme that can strain eyes in low-light environments.
+
+## What's Here
+
+A minimal single-page task manager with:
+- Task creation and listing interface
+- Simple Express.js server serving static files
+- Clean light theme CSS
+- No dark mode support (yet!)
+
+**Files:**
+- `src/server.js` - Express server for static files
+- `src/public/index.html` - Task manager interface
+- `src/public/style.css` - Current light theme styles
+- `src/public/app.js` - Task management logic
+
+## Getting Started
+
+```bash
+# Install dependencies
+npm install
+
+# Start the server
+npm start
+
+# Open in your browser:
+# http://localhost:3000
+```
+
+## Your Mission
+
+Add dark theme support with automatic switching based on system preferences. Follow the tutorial and ask your AI assistant:
+
+> "Help me add dark theme support to this app using LeanSpec. It should automatically switch based on the user's system theme preference."
+
+The AI will guide you through:
+1. Creating a spec for dark theme support
+2. Designing the CSS for dark mode
+3. Implementing system preference detection
+4. Testing the theme switching
+
+## Current Limitations
+
+- Only light theme available
+- No manual theme toggle
+- Colors may not be fully accessible
+- No theme persistence
+
+These are perfect opportunities to practice spec-driven development!

package/templates/examples/dark-theme/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "dark-theme-demo",
+  "version": "1.0.0",
+  "description": "Simple web app for LeanSpec Dark Theme Tutorial",
+  "type": "module",
+  "scripts": {
+    "start": "node src/server.js",
+    "dev": "node --watch src/server.js"
+  },
+  "keywords": ["leanspec", "tutorial", "demo"],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "express": "^4.18.2"
+  }
+}

package/templates/examples/dark-theme/src/public/app.js

@@ -0,0 +1,92 @@
+// Task Manager - Simple task tracking
+let tasks = [];
+let taskIdCounter = 1;
+
+const taskInput = document.getElementById('taskInput');
+const addButton = document.getElementById('addButton');
+const taskList = document.getElementById('taskList');
+const taskCount = document.getElementById('taskCount');
+
+// Add task on button click
+addButton.addEventListener('click', addTask);
+
+// Add task on Enter key
+taskInput.addEventListener('keypress', (e) => {
+  if (e.key === 'Enter') {
+    addTask();
+  }
+});
+
+function addTask() {
+  const text = taskInput.value.trim();
+  
+  if (!text) {
+    return;
+  }
+
+  const task = {
+    id: taskIdCounter++,
+    text: text,
+    completed: false
+  };
+
+  tasks.push(task);
+  taskInput.value = '';
+  
+  renderTasks();
+}
+
+function toggleTask(id) {
+  const task = tasks.find(t => t.id === id);
+  if (task) {
+    task.completed = !task.completed;
+    renderTasks();
+  }
+}
+
+function deleteTask(id) {
+  tasks = tasks.filter(t => t.id !== id);
+  renderTasks();
+}
+
+function renderTasks() {
+  // Clear list
+  taskList.innerHTML = '';
+
+  // Show empty state if no tasks
+  if (tasks.length === 0) {
+    taskList.innerHTML = '<div class="empty-state">No tasks yet. Add one above to get started!</div>';
+    taskCount.textContent = '0 tasks';
+    return;
+  }
+
+  // Render each task
+  tasks.forEach(task => {
+    const li = document.createElement('li');
+    li.className = `task-item ${task.completed ? 'completed' : ''}`;
+    
+    li.innerHTML = `
+      <div class="task-content">
+        <input type="checkbox" class="task-checkbox" ${task.completed ? 'checked' : ''} 
+               onchange="toggleTask(${task.id})">
+        <span class="task-text">${escapeHtml(task.text)}</span>
+      </div>
+      <button class="delete-button" onclick="deleteTask(${task.id})">Delete</button>
+    `;
+    
+    taskList.appendChild(li);
+  });
+
+  // Update count
+  const remaining = tasks.filter(t => !t.completed).length;
+  taskCount.textContent = `${remaining} task${remaining !== 1 ? 's' : ''} remaining`;
+}
+
+function escapeHtml(text) {
+  const div = document.createElement('div');
+  div.textContent = text;
+  return div.innerHTML;
+}
+
+// Initial render
+renderTasks();

package/templates/examples/dark-theme/src/public/index.html

@@ -0,0 +1,38 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Task Manager</title>
+  <link rel="stylesheet" href="style.css">
+</head>
+<body>
+  <div class="container">
+    <header>
+      <h1>My Tasks</h1>
+      <p class="subtitle">Stay organized, stay productive</p>
+    </header>
+
+    <main>
+      <div class="task-input">
+        <input type="text" id="taskInput" placeholder="What needs to be done?" />
+        <button id="addButton">Add Task</button>
+      </div>
+
+      <div class="task-list">
+        <ul id="taskList"></ul>
+      </div>
+
+      <div class="stats">
+        <span id="taskCount">0 tasks</span>
+      </div>
+    </main>
+
+    <footer>
+      <p>Built with ❤️ • Try adding dark theme support!</p>
+    </footer>
+  </div>
+
+  <script src="app.js"></script>
+</body>
+</html>