@eskoubar95/spec 0.1.0 → 0.1.3

package/dist/lib/prompts.js

@@ -1,8 +1,31 @@
 import inquirer from 'inquirer';
+import { normalizeProjectName } from './project-name.js';
+import { isRunningInCursor } from './cursor-detection.js';
+import { isExistingProject } from './detection.js';
 /**
  * Prompts the user for project initialization options
  */
 export async function promptInit() {
+    const cwd = process.cwd();
+    // Smart mode detection: Check if in Cursor + existing project
+    const inCursor = isRunningInCursor();
+    const isExisting = await isExistingProject(cwd);
+    if (inCursor && isExisting) {
+        // Auto-suggest install mode
+        const { shouldInstall } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'shouldInstall',
+                message: 'Detected you\'re in an existing project in Cursor. Install SDD to this project?',
+                default: true,
+            },
+        ]);
+        if (shouldInstall) {
+            // This will be handled by the init command
+            throw new Error('SWITCH_TO_INSTALL');
+        }
+    }
+    // Normal init flow
     const answers = await inquirer.prompt([
         {
             type: 'input',
@@ -18,6 +41,14 @@ export async function promptInit() {
                 }
                 return true;
             },
+            filter: (input) => {
+                // Normalize project name: convert spaces to hyphens, lowercase
+                return normalizeProjectName(input);
+            },
+            transformer: (input) => {
+                // Show normalized version while typing
+                return normalizeProjectName(input);
+            },
         },
         {
             type: 'list',
@@ -35,7 +66,90 @@ export async function promptInit() {
             message: 'Initialize git repository?',
             default: true,
         },
+        ...(isRunningInCursor() ? [] : [
+            {
+                type: 'confirm',
+                name: 'openInCursor',
+                message: 'Open in Cursor?',
+                default: true,
+            },
+        ]),
     ]);
     return answers;
 }
+/**
+ * Prompts the user for installation options
+ */
+export async function promptInstall(projectPath) {
+    const inCursor = isRunningInCursor();
+    const isExisting = await isExistingProject(projectPath);
+    // Auto-detect project path if in Cursor and current directory is a project
+    let finalProjectPath = projectPath;
+    if (inCursor && isExisting && projectPath === process.cwd()) {
+        // Use current directory automatically
+    }
+    else {
+        const { path: selectedPath } = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'path',
+                message: 'Project path:',
+                default: projectPath,
+                validate: (input) => {
+                    if (!input.trim()) {
+                        return 'Project path cannot be empty';
+                    }
+                    return true;
+                },
+            },
+        ]);
+        finalProjectPath = selectedPath;
+    }
+    // Check if .cursor folder exists
+    const { hasCursorFolder } = await import('./backup-cursor.js').then(m => m.checkCursorFolder(finalProjectPath));
+    const answers = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'backupStrategy',
+            message: hasCursorFolder ? 'Backup existing .cursor folder or merge?' : 'Backup strategy:',
+            choices: [
+                { name: 'Backup existing .cursor folder', value: 'backup' },
+                { name: 'Merge with existing', value: 'merge' },
+            ],
+            default: 'backup',
+            when: hasCursorFolder,
+        },
+        {
+            type: 'confirm',
+            name: 'installSpecFolders',
+            message: 'Install spec/ and work/ folders?',
+            default: true,
+        },
+        {
+            type: 'confirm',
+            name: 'createRootSpec',
+            message: 'Create spec/00-root-spec.md if missing?',
+            default: true,
+        },
+        {
+            type: 'confirm',
+            name: 'initializeDetection',
+            message: 'Initialize detection cache?',
+            default: true,
+        },
+        ...(isRunningInCursor() ? [] : [
+            {
+                type: 'confirm',
+                name: 'openInCursor',
+                message: 'Open in Cursor?',
+                default: true,
+            },
+        ]),
+    ]);
+    return {
+        ...answers,
+        projectPath: finalProjectPath,
+        backupStrategy: answers.backupStrategy || 'backup', // Default if not asked
+    };
+}
 //# sourceMappingURL=prompts.js.map

package/dist/lib/prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/lib/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAQhC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAc;QACjD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,6BAA6B;YACtC,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;gBAC1B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;oBAClB,OAAO,8BAA8B,CAAC;gBACxC,CAAC;gBACD,oCAAoC;gBACpC,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC/B,OAAO,0CAA0C,CAAC;gBACpD,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;SACF;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,YAAY;YACrB,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;gBACjC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;aACpC;YACD,OAAO,EAAE,OAAO;SACjB;QACD;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,4BAA4B;YACrC,OAAO,EAAE,IAAI;SACd;KACF,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/lib/prompts.ts"],"names":[],"mappings":"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"}

package/dist/lib/version-check.d.ts

@@ -0,0 +1,21 @@
+export interface VersionInfo {
+    currentVersion?: string;
+    latestVersion: string;
+    needsUpdate: boolean;
+}
+/**
+ * Gets the current package version from package.json
+ */
+export declare function getPackageVersion(): Promise<string>;
+/**
+ * Checks the current version and determines if an update is needed
+ * @param projectPath - Path to the project
+ */
+export declare function checkVersion(projectPath: string): Promise<VersionInfo>;
+/**
+ * Updates the version file in the project
+ * @param projectPath - Path to the project
+ * @param version - Version string to write
+ */
+export declare function updateVersionFile(projectPath: string, version: string): Promise<void>;
+//# sourceMappingURL=version-check.d.ts.map

package/dist/lib/version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../src/lib/version-check.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CASzD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAoB5E;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3F"}

package/dist/lib/version-check.js

@@ -0,0 +1,49 @@
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * Gets the current package version from package.json
+ */
+export async function getPackageVersion() {
+    const packageJsonPath = path.resolve(import.meta.url.replace('file://', ''), '../../../package.json');
+    try {
+        const packageJson = await fs.readJson(packageJsonPath);
+        return packageJson.version || '0.1.0';
+    }
+    catch {
+        return '0.1.0'; // Fallback
+    }
+}
+/**
+ * Checks the current version and determines if an update is needed
+ * @param projectPath - Path to the project
+ */
+export async function checkVersion(projectPath) {
+    const versionPath = path.join(projectPath, '.sdd', 'version');
+    const latestVersion = await getPackageVersion();
+    let currentVersion;
+    if (await fs.pathExists(versionPath)) {
+        try {
+            currentVersion = (await fs.readFile(versionPath, 'utf-8')).trim();
+        }
+        catch {
+            // Ignore read errors
+        }
+    }
+    const needsUpdate = currentVersion !== undefined && currentVersion !== latestVersion;
+    return {
+        currentVersion,
+        latestVersion,
+        needsUpdate,
+    };
+}
+/**
+ * Updates the version file in the project
+ * @param projectPath - Path to the project
+ * @param version - Version string to write
+ */
+export async function updateVersionFile(projectPath, version) {
+    const versionPath = path.join(projectPath, '.sdd', 'version');
+    await fs.ensureDir(path.dirname(versionPath));
+    await fs.writeFile(versionPath, version, 'utf-8');
+}
+//# sourceMappingURL=version-check.js.map

package/dist/lib/version-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.js","sourceRoot":"","sources":["../../src/lib/version-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAQxB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,uBAAuB,CAAC,CAAC;IAEtG,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QACvD,OAAO,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,CAAC,WAAW;IAC7B,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB;IACpD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9D,MAAM,aAAa,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAEhD,IAAI,cAAkC,CAAC;IACvC,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,cAAc,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,cAAc,KAAK,SAAS,IAAI,cAAc,KAAK,aAAa,CAAC;IAErF,OAAO;QACL,cAAc;QACd,aAAa;QACb,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,WAAmB,EAAE,OAAe;IAC1E,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9D,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAC9C,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC"}

package/dist/lib/workspace.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Opens a project in Cursor IDE
+ * @param projectPath - Path to the project to open
+ * @param skipIfAlreadyInCursor - Skip if already running in Cursor (default: true)
+ */
+export declare function openInCursor(projectPath: string, skipIfAlreadyInCursor?: boolean): Promise<void>;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/lib/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/lib/workspace.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,qBAAqB,GAAE,OAAc,GACpC,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/dist/lib/workspace.js

@@ -0,0 +1,38 @@
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { isRunningInCursor } from './cursor-detection.js';
+const execAsync = promisify(exec);
+/**
+ * Opens a project in Cursor IDE
+ * @param projectPath - Path to the project to open
+ * @param skipIfAlreadyInCursor - Skip if already running in Cursor (default: true)
+ */
+export async function openInCursor(projectPath, skipIfAlreadyInCursor = true) {
+    // Check if already in Cursor
+    if (skipIfAlreadyInCursor && isRunningInCursor()) {
+        console.log('\n✓ You are already in Cursor. No need to open the project.\n');
+        return;
+    }
+    // Check if cursor command is available
+    try {
+        await execAsync('which cursor');
+    }
+    catch {
+        console.log('\n⚠️  Cursor command not found in PATH.');
+        console.log('   Please open the project manually in Cursor IDE.');
+        console.log(`   Path: ${projectPath}\n`);
+        return;
+    }
+    // Open project in Cursor
+    try {
+        await execAsync(`cursor "${projectPath}"`);
+        console.log(`\n✓ Opening project in Cursor...\n`);
+    }
+    catch (error) {
+        console.error('\n❌ Error opening project in Cursor:');
+        console.error(`   ${error instanceof Error ? error.message : String(error)}`);
+        console.log(`\n   Please open the project manually in Cursor IDE.`);
+        console.log(`   Path: ${projectPath}\n`);
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/dist/lib/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/lib/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,wBAAiC,IAAI;IAErC,6BAA6B;IAC7B,IAAI,qBAAqB,IAAI,iBAAiB,EAAE,EAAE,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;QAC7E,OAAO;IACT,CAAC;IAED,uCAAuC;IACvC,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,cAAc,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,YAAY,WAAW,IAAI,CAAC,CAAC;QACzC,OAAO;IACT,CAAC;IAED,yBAAyB;IACzB,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,WAAW,WAAW,GAAG,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACtD,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9E,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,YAAY,WAAW,IAAI,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,32 @@
+export interface InitAnswers {
+    projectName: string;
+    taskMode: 'local' | 'linear';
+    gitInit: boolean;
+    openInCursor?: boolean;
+}
+export interface InstallAnswers {
+    projectPath: string;
+    backupStrategy: 'backup' | 'merge';
+    installSpecFolders: boolean;
+    createRootSpec: boolean;
+    initializeDetection: boolean;
+    openInCursor?: boolean;
+}
+export interface ProjectInfo {
+    hasCursorFolder: boolean;
+    hasCodebase: boolean;
+    projectType?: string;
+    techStack?: string[];
+}
+export interface DetectionResults {
+    projectType: string;
+    projectSize: 'small' | 'medium' | 'large' | 'enterprise';
+    technologies: string[];
+    phase?: 'initialization' | 'expansion' | 'maintenance' | 'migration' | 'legacy';
+}
+export interface VersionInfo {
+    currentVersion?: string;
+    latestVersion: string;
+    needsUpdate: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,QAAQ,GAAG,OAAO,CAAC;IACnC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;IACzD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,gBAAgB,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;CACjF;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eskoubar95/spec",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "private": false,
   "bin": {
     "spec": "dist/index.js"
@@ -27,4 +27,4 @@
     "@types/node": "^20.11.0",
     "typescript": "^5.3.3"
   }
-}
+}

package/template/.cursor/commands/_shared/activation.md

@@ -0,0 +1,220 @@
+---
+helper_id: activation
+load_when:
+  - always
+sections:
+  matching:
+    title: "Match detection results"
+    lines: [1, 50]
+  dependencies:
+    title: "Check rule dependencies"
+    lines: [51, 100]
+  activation:
+    title: "Activate matching rules"
+    lines: [101, 150]
+always_load: true
+---
+
+# Rule Activation Engine
+
+This engine activates relevant rules based on project detection results.
+
+## Purpose
+
+After project detection, this engine:
+- Matches detection results against rule metadata
+- Activates relevant rules based on activation conditions
+- Handles rule dependencies (requires field)
+- Outputs active rule list with categories
+
+## Activation Algorithm
+
+**Step 1: Always activate foundation rules**
+- `00-pos.mdc` - Project Operating System (always apply)
+- `01-sdd.mdc` - Spec-Driven Development (always apply)
+- `02-work-mode.mdc` - Work Mode (always apply)
+
+**Step 2: Match detection results against rule metadata**
+
+**2.1: Check for tech stack in spec (if available)**
+- Read tech stack from `spec/08-infrastructure.md` or `spec/02-architecture.md`
+- If tech stack found → use it as primary source for framework/tool detection
+- For each framework/tool in tech stack:
+  - Check if rule exists (e.g., `20-nextjs.mdc` for "Next.js")
+  - If rule exists → add to activation queue
+  - If rule doesn't exist → note for user guidance: "Framework [X] detected but no specific rule exists. Should I create a framework-specific rule, or use general patterns with Context7 documentation lookup?"
+
+**2.2: Match detection results against rule metadata**
+
+**Rule Metadata Cache Strategy:**
+
+1. **Check cache validity:**
+   - Check if `.sdd/rule-metadata-cache.json` exists
+   - Check if cache is valid (compare rule file modification times with cache timestamp)
+   - If cache valid → use cached metadata
+   - If cache invalid or missing → rebuild cache
+
+2. **Rebuild cache (if needed):**
+   - Scan all rule files in `.cursor/rules/`
+   - Extract metadata (activation conditions, requires, etc.)
+   - Store in `.sdd/rule-metadata-cache.json`:
+     ```json
+     {
+       "rules": {
+         "20-nextjs.mdc": {
+           "activation": {
+             "projectTypes": ["web-app"],
+             "technologies": ["nextjs"]
+           },
+           "requires": ["10-engineering"]
+         }
+       },
+       "last_updated": "2026-01-07T12:00:00Z",
+       "rule_files": {
+         "20-nextjs.mdc": {
+           "mtime": 1704633600000
+         }
+       }
+     }
+     ```
+
+3. **Match detection results against cached metadata:**
+   - For each rule in cache:
+     - Check if rule matches detection:
+       - `projectTypes` contains detected project type
+       - `projectSizes` contains detected project size
+       - `projectPhases` contains detected project phase
+       - `technologies` contains any detected technology (from package.json or spec tech stack)
+     - If match → add to activation queue
+
+**Cache Invalidation:**
+- Invalidate cache if any rule file is modified (compare mtime)
+- Invalidate cache if new rule files are added
+- Invalidate cache if rule files are deleted
+- Rebuild cache automatically when invalid
+
+**Step 3: Check rule dependencies**
+
+For each rule in activation queue:
+1. Check `requires` field
+2. If required rules not active → activate them first
+3. Handle circular dependencies (warn and break cycle)
+
+**Step 4: Activate matching rules**
+
+Activate rules in dependency order:
+1. Foundation rules (already active)
+2. Domain rules (10-engineering, 11-design, 12-business)
+3. Technology rules (20-nextjs, 21-api-design, 30-database, etc.)
+
+**Step 5: Output active rule list**
+
+```markdown
+**Active Rule Sets:**
+
+**Foundation (always active):**
+- 00-pos.mdc - Project Operating System
+- 01-sdd.mdc - Spec-Driven Development
+- 02-work-mode.mdc - Work Mode
+
+**Domain (context-based):**
+- 10-engineering.mdc - Engineering patterns
+- 11-design.mdc - Design patterns
+
+**Technology (auto-activated):**
+- 20-nextjs.mdc - Next.js patterns
+- 21-api-design.mdc - API design patterns
+- 30-database.mdc - Database patterns
+```
+
+## Rule Metadata Format
+
+Each rule file should include activation metadata:
+
+```markdown
+---
+title: [Rule Title]
+description: [Description]
+owner: sdd-system
+severity: warn
+globs: [File patterns - optional]
+alwaysApply: false
+activation:
+  projectTypes: [web-app, cli-tool, library, api-service, mobile-app, monorepo]
+  projectSizes: [small, medium, large, enterprise]
+  projectPhases: [initialization, expansion, maintenance, migration, legacy]
+  technologies: [nextjs, react, postgres, clerk, tailwindcss, jest]
+  requires: [10-engineering, 11-design]
+---
+```
+
+## Activation Logic Examples
+
+**Example 1: Next.js web app (medium, expansion)**
+- Foundation: 00-pos, 01-sdd, 02-work-mode
+- Domain: 10-engineering, 11-design
+- Technology: 20-nextjs, 21-api-design (if API routes exist), 30-database (if database detected)
+
+**Example 2: CLI tool (small, initialization)**
+- Foundation: 00-pos, 01-sdd, 02-work-mode
+- Domain: 10-engineering
+- Technology: 40-cli-patterns (if exists)
+
+**Example 3: Legacy Express API (large, maintenance)**
+- Foundation: 00-pos, 01-sdd, 02-work-mode
+- Domain: 10-engineering
+- Technology: 21-api-design, 30-database
+
+## User Override
+
+Users can override activation:
+- Manually activate/deactivate specific rules
+- Force activation of rules that didn't match
+- Disable auto-activation for specific rules
+
+## Rule Metadata Cache
+
+**Cache Location:** `.sdd/rule-metadata-cache.json`
+
+**Cache Structure:**
+```json
+{
+  "rules": {
+    "20-nextjs.mdc": {
+      "activation": {
+        "projectTypes": ["web-app"],
+        "projectSizes": ["small", "medium", "large"],
+        "projectPhases": ["initialization", "expansion"],
+        "technologies": ["nextjs", "react"]
+      },
+      "requires": ["10-engineering"]
+    }
+  },
+  "last_updated": "2026-01-07T12:00:00Z",
+  "rule_files": {
+    "20-nextjs.mdc": {
+      "mtime": 1704633600000
+    }
+  }
+}
+```
+
+**Cache Management:**
+- **Build cache:** Parse all rule files, extract metadata, store in cache
+- **Validate cache:** Compare rule file mtimes with cache mtimes
+- **Invalidate cache:** If any rule file modified, rebuild cache
+- **Use cache:** Read from cache instead of scanning all rule files
+
+**Benefits:**
+- Faster activation (read from cache instead of scanning all files)
+- Reduced token consumption (cache is small JSON file)
+- Automatic invalidation ensures cache stays current
+
+## Usage in Commands
+
+All SDD commands should:
+1. Run detection (or read from cache)
+2. Run activation engine (use rule metadata cache)
+3. Include active rule list in state assertion
+4. Apply active rules during execution
+