@rasensio/aidlc 0.2.0 → 0.3.0

package/README.md

@@ -189,6 +189,7 @@ Phase applicability depends on the cycle scope: Full (all phases), Standard (Req
 
 | Command | Purpose |
 |---------|---------|
+| `aidlc update` | Update CLI and refresh project skills |
 | `aidlc setup` | Interactive setup or update of project configuration |
 | `aidlc discover` | Scan codebase, generate style and architecture context |
 | `aidlc init --platform <id>` | Install skills for a target AI platform |
@@ -229,6 +230,27 @@ orchestrator:               # optional, only for bare-endpoint mode
 
 Without this file, AIDLC defaults to Micro scope (Implementation + Testing only).
 
+## Changelog
+
+### 0.3.0
+
+**First Activation (brownfield auto-discovery)**
+
+- New skill: `02-first-activation.md` — when AIDLC is installed in an existing project, the AI now automatically scans the codebase on first chat interaction. It detects languages, frameworks, conventions, and directory structure, then asks the user about extra context folders (specs, roadmap, design docs, etc.) before writing context docs to `.aidlc/context/`. No terminal round-trip needed after `aidlc init`.
+
+**`aidlc update` command**
+
+- Self-update: detects which package manager installed AIDLC (npm, pnpm, yarn, bun), checks the npm registry for a newer version, and updates the global CLI.
+- Project refresh: re-runs the install plan for each configured platform, updating skill shims and steering files to match the latest CLI version. Only files whose content changed are rewritten.
+- `--self-only` — update just the CLI, skip project files
+- `--project-only` — refresh project files from the currently installed CLI
+- `--rediscover` — also regenerate `.aidlc/context/` docs (skipped by default to preserve manual edits)
+- `--dry-run` — preview all changes without writing
+
+**Getting-started skill update**
+
+- The getting-started skill now defers to first-activation when `.aidlc/context/` doesn't exist yet, ensuring discovery runs before lifecycle guidance kicks in.
+
 ## Contributing
 
 ### Build and Test

package/dist/cli.js

@@ -19,6 +19,7 @@ import { registerSetup } from './commands/setup.js';
 import { registerAddAction } from './commands/add-action.js';
 import { registerDocs } from './commands/docs.js';
 import { registerReview } from './commands/review.js';
+import { registerUpdate } from './commands/update.js';
 const program = new Command();
 program
     .name('aidlc')
@@ -35,5 +36,6 @@ registerSetup(program);
 registerAddAction(program);
 registerDocs(program);
 registerReview(program);
+registerUpdate(program);
 program.parse();
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,oCAAoC,CAAC;KACjD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAC1B,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAC1B,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAC3B,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,cAAc,CAAC,OAAO,CAAC,CAAC;AAExB,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,oCAAoC,CAAC;KACjD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAC1B,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAC1B,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAC3B,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,cAAc,CAAC,OAAO,CAAC,CAAC;AAExB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/update.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `aidlc update` command — update the CLI and refresh project skills.
+ *
+ * Behavior:
+ * 1. Self-update: detect the package manager that installed AIDLC globally,
+ *    check the npm registry for the latest version, and update if needed.
+ * 2. Project refresh: if inside a project with `.aidlc/config.yaml`, re-run
+ *    `init` for each configured platform to refresh skill shims and steering.
+ * 3. Optionally re-run discovery to regenerate context docs (--rediscover).
+ *
+ * Options:
+ *   --self-only       Only update the CLI, skip project refresh
+ *   --project-only    Only refresh project files from the current CLI
+ *   --rediscover      Also regenerate context docs (.aidlc/context/)
+ *   --dry-run         Show what would change without writing
+ *
+ * Requirements: 17.1
+ *
+ * @module
+ */
+import { Command } from 'commander';
+/**
+ * Register the `aidlc update` command on the given commander program.
+ */
+export declare function registerUpdate(program: Command): void;
+//# sourceMappingURL=update.d.ts.map

package/dist/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoYpC;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4BrD"}

package/dist/commands/update.js

@@ -0,0 +1,427 @@
+/**
+ * `aidlc update` command — update the CLI and refresh project skills.
+ *
+ * Behavior:
+ * 1. Self-update: detect the package manager that installed AIDLC globally,
+ *    check the npm registry for the latest version, and update if needed.
+ * 2. Project refresh: if inside a project with `.aidlc/config.yaml`, re-run
+ *    `init` for each configured platform to refresh skill shims and steering.
+ * 3. Optionally re-run discovery to regenerate context docs (--rediscover).
+ *
+ * Options:
+ *   --self-only       Only update the CLI, skip project refresh
+ *   --project-only    Only refresh project files from the current CLI
+ *   --rediscover      Also regenerate context docs (.aidlc/context/)
+ *   --dry-run         Show what would change without writing
+ *
+ * Requirements: 17.1
+ *
+ * @module
+ */
+import { Command } from 'commander';
+import { execSync } from 'node:child_process';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parse as parseYaml } from 'yaml';
+import { loadSkills, loadGuidanceLayers } from '../compile/loaders.js';
+import { adapters } from '../compile/adapters/index.js';
+import { executePlan, dryRunPlan } from '../compile/install-plan.js';
+import { scanCodebase, writeContextDocs } from '../discover/scanner.js';
+/**
+ * Detect which package manager installed this CLI globally.
+ *
+ * Strategy:
+ * 1. Check the resolved binary path for clues (pnpm, yarn, bun store paths)
+ * 2. Check npm_execpath env var (set by npm/pnpm/yarn when running scripts)
+ * 3. Check if the binary lives in a known global path pattern
+ * 4. Default to npm
+ */
+function detectPackageManager() {
+    const execPath = process.env.npm_execpath ?? '';
+    const binPath = process.argv[1] ?? '';
+    // Check npm_execpath for pnpm/yarn/bun indicators
+    if (execPath.includes('pnpm'))
+        return 'pnpm';
+    if (execPath.includes('yarn'))
+        return 'yarn';
+    if (execPath.includes('bun'))
+        return 'bun';
+    // Check the binary install path
+    if (binPath.includes('pnpm'))
+        return 'pnpm';
+    if (binPath.includes('.yarn'))
+        return 'yarn';
+    if (binPath.includes('.bun'))
+        return 'bun';
+    // Try to detect from global node_modules path
+    const thisFile = fileURLToPath(import.meta.url);
+    if (thisFile.includes('/pnpm/'))
+        return 'pnpm';
+    if (thisFile.includes('/.yarn/'))
+        return 'yarn';
+    return 'npm';
+}
+/**
+ * Build the global update command for a given package manager.
+ */
+function buildUpdateCommand(pm, packageName) {
+    switch (pm) {
+        case 'pnpm':
+            return `pnpm update -g ${packageName}`;
+        case 'yarn':
+            return `yarn global upgrade ${packageName}`;
+        case 'bun':
+            return `bun update -g ${packageName}`;
+        case 'npm':
+        default:
+            return `npm update -g ${packageName}`;
+    }
+}
+// ---------------------------------------------------------------------------
+// Version checking
+// ---------------------------------------------------------------------------
+/**
+ * Get the currently installed version from package.json.
+ */
+function getCurrentVersion() {
+    const packageRoot = getPackageRoot();
+    const pkgPath = join(packageRoot, 'package.json');
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        return pkg.version;
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/**
+ * Get the package name from package.json.
+ */
+function getPackageName() {
+    const packageRoot = getPackageRoot();
+    const pkgPath = join(packageRoot, 'package.json');
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        return pkg.name;
+    }
+    catch {
+        return '@rasensio/aidlc';
+    }
+}
+/**
+ * Fetch the latest version from the npm registry.
+ * Returns null if the registry is unreachable.
+ */
+function fetchLatestVersion(packageName) {
+    try {
+        const output = execSync(`npm view ${packageName} dist-tags.latest`, {
+            encoding: 'utf8',
+            timeout: 15_000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return output.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Simple semver comparison: returns true if `a` < `b`.
+ */
+function isOlderThan(a, b) {
+    const partsA = a.split('.').map(Number);
+    const partsB = b.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const numA = partsA[i] ?? 0;
+        const numB = partsB[i] ?? 0;
+        if (numA < numB)
+            return true;
+        if (numA > numB)
+            return false;
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the package root directory.
+ */
+function getPackageRoot() {
+    const thisFile = fileURLToPath(import.meta.url);
+    return resolve(thisFile, '..', '..', '..');
+}
+/**
+ * Load the project's .aidlc/config.yaml to get configured platforms.
+ */
+function loadProjectConfig(projectRoot) {
+    const configPath = join(projectRoot, '.aidlc', 'config.yaml');
+    if (!existsSync(configPath))
+        return null;
+    try {
+        const raw = readFileSync(configPath, 'utf8');
+        const parsed = parseYaml(raw);
+        if (typeof parsed !== 'object' || parsed === null)
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load a capability map for a platform from the package's capabilities/ dir.
+ */
+function loadCapabilityMap(platform, packageRoot) {
+    const filePath = join(packageRoot, 'capabilities', `${platform}.yaml`);
+    if (!existsSync(filePath))
+        return null;
+    try {
+        const raw = readFileSync(filePath, 'utf8');
+        const parsed = parseYaml(raw);
+        if (typeof parsed !== 'object' || parsed === null)
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Build the ProjectContext for a given project root.
+ */
+function buildProjectContext(projectRoot) {
+    const contextDir = join(projectRoot, '.aidlc', 'context');
+    const guidanceDir = join(projectRoot, '.aidlc', 'guidance');
+    const contextDocs = {};
+    if (existsSync(contextDir)) {
+        try {
+            for (const entry of readdirSync(contextDir)) {
+                const name = entry.replace(/\.[^.]+$/, '');
+                contextDocs[name] = entry;
+            }
+        }
+        catch {
+            // proceed with empty
+        }
+    }
+    const guidanceLayers = {};
+    if (existsSync(guidanceDir)) {
+        const loaded = loadGuidanceLayers(guidanceDir);
+        for (const layer of loaded.layers) {
+            guidanceLayers[layer.name] = `${layer.name}.md`;
+        }
+    }
+    return { root: projectRoot, contextDocs, guidanceLayers };
+}
+/**
+ * Perform the CLI self-update.
+ */
+function selfUpdate(dryRun) {
+    const currentVersion = getCurrentVersion();
+    const packageName = getPackageName();
+    process.stderr.write('Checking for updates...\n');
+    const latestVersion = fetchLatestVersion(packageName);
+    if (latestVersion === null) {
+        return {
+            updated: false,
+            from: currentVersion,
+            to: null,
+            skipped: true,
+            reason: 'unable to reach npm registry',
+        };
+    }
+    if (!isOlderThan(currentVersion, latestVersion)) {
+        return {
+            updated: false,
+            from: currentVersion,
+            to: latestVersion,
+            skipped: true,
+            reason: 'already up to date',
+        };
+    }
+    const pm = detectPackageManager();
+    const cmd = buildUpdateCommand(pm, packageName);
+    if (dryRun) {
+        process.stdout.write(`Would run: ${cmd}\n`);
+        process.stdout.write(`  ${currentVersion} → ${latestVersion}\n`);
+        return { updated: false, from: currentVersion, to: latestVersion, skipped: false };
+    }
+    process.stderr.write(`Updating CLI via ${pm}...\n`);
+    process.stderr.write(`  ${currentVersion} → ${latestVersion}\n`);
+    try {
+        execSync(cmd, { stdio: 'inherit', timeout: 60_000 });
+        return { updated: true, from: currentVersion, to: latestVersion, skipped: false };
+    }
+    catch {
+        process.stderr.write(`warning: update command failed: ${cmd}\n`);
+        process.stderr.write('You may need to run it manually with elevated permissions.\n');
+        return {
+            updated: false,
+            from: currentVersion,
+            to: latestVersion,
+            skipped: true,
+            reason: 'update command failed (may require sudo)',
+        };
+    }
+}
+/**
+ * Refresh project skills by re-running the install plan for each configured platform.
+ */
+function refreshProject(projectRoot, dryRun) {
+    const config = loadProjectConfig(projectRoot);
+    if (!config) {
+        process.stderr.write('No .aidlc/config.yaml found — skipping project refresh.\n');
+        process.stderr.write('Run `aidlc setup` first to configure this project.\n');
+        return { filesWritten: [], filesSkipped: [], warnings: [], platforms: [] };
+    }
+    const platforms = config.platforms ?? [];
+    if (platforms.length === 0) {
+        process.stderr.write('No platforms configured — skipping project refresh.\n');
+        return { filesWritten: [], filesSkipped: [], warnings: [], platforms: [] };
+    }
+    const packageRoot = getPackageRoot();
+    const skillsDir = join(packageRoot, 'skills');
+    const skills = loadSkills(skillsDir);
+    const allWritten = [];
+    const allSkipped = [];
+    const allWarnings = [];
+    for (const platform of platforms) {
+        const adapter = adapters.get(platform);
+        if (!adapter) {
+            allWarnings.push(`unknown platform '${platform}' in config — skipped`);
+            continue;
+        }
+        const caps = loadCapabilityMap(platform, packageRoot);
+        const ctx = buildProjectContext(projectRoot);
+        const plan = adapter.plan(skills, caps, ctx);
+        allWarnings.push(...plan.warnings);
+        if (dryRun) {
+            const report = dryRunPlan(plan, projectRoot);
+            allWritten.push(...report.filesWritten);
+            allSkipped.push(...report.filesSkipped);
+        }
+        else {
+            const report = executePlan(plan, projectRoot);
+            allWritten.push(...report.filesWritten);
+            allSkipped.push(...report.filesSkipped);
+        }
+    }
+    return { filesWritten: allWritten, filesSkipped: allSkipped, warnings: allWarnings, platforms };
+}
+/**
+ * Re-run codebase discovery to regenerate .aidlc/context/ docs.
+ */
+function rediscover(projectRoot, dryRun) {
+    if (dryRun) {
+        process.stdout.write('Would regenerate .aidlc/context/ docs\n');
+        return { docsWritten: ['.aidlc/context/style-guide.md', '.aidlc/context/architecture.md'] };
+    }
+    const result = scanCodebase(projectRoot);
+    const docPaths = writeContextDocs(projectRoot, result);
+    return { docsWritten: docPaths };
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+/**
+ * Register the `aidlc update` command on the given commander program.
+ */
+export function registerUpdate(program) {
+    program
+        .command('update')
+        .description('Update the AIDLC CLI and refresh project skills')
+        .option('--self-only', 'Only update the CLI globally, skip project file refresh')
+        .option('--project-only', 'Only refresh project files from the currently installed CLI')
+        .option('--rediscover', 'Also regenerate context docs in .aidlc/context/')
+        .option('--dry-run', 'Show what would change without writing anything')
+        .addHelpText('after', `
+Examples:
+  aidlc update                 Update CLI + refresh project skills
+  aidlc update --self-only     Just update the global CLI package
+  aidlc update --project-only  Just refresh .kiro/skills/ from current CLI
+  aidlc update --rediscover    Also regenerate .aidlc/context/ docs
+  aidlc update --dry-run       Preview changes without applying them
+
+How it works:
+  1. Detects your package manager (npm, pnpm, yarn, bun)
+  2. Checks the npm registry for a newer version
+  3. Updates the CLI if a newer version is available
+  4. Re-runs the install plan for each configured platform
+     to refresh skill shims and steering files
+  5. Skips .aidlc/context/ docs unless --rediscover is passed
+     (context docs may have been manually edited)
+`)
+        .action((opts) => {
+        runUpdate(opts);
+    });
+}
+// ---------------------------------------------------------------------------
+// Core logic
+// ---------------------------------------------------------------------------
+function runUpdate(opts) {
+    const projectRoot = process.cwd();
+    const dryRun = opts.dryRun ?? false;
+    if (dryRun) {
+        process.stdout.write('Dry run — no changes will be made.\n\n');
+    }
+    // --- Self-update ---
+    if (!opts.projectOnly) {
+        const selfResult = selfUpdate(dryRun);
+        if (selfResult.skipped) {
+            process.stdout.write(`CLI: ${selfResult.from} (${selfResult.reason})\n`);
+        }
+        else if (selfResult.updated) {
+            process.stdout.write(`CLI: ${selfResult.from} → ${selfResult.to}\n`);
+        }
+        else if (dryRun && selfResult.to) {
+            process.stdout.write(`CLI: would update ${selfResult.from} → ${selfResult.to}\n`);
+        }
+        process.stdout.write('\n');
+    }
+    // --- Project refresh ---
+    if (!opts.selfOnly) {
+        process.stderr.write('Refreshing project skills...\n');
+        const refreshResult = refreshProject(projectRoot, dryRun);
+        for (const w of refreshResult.warnings) {
+            process.stderr.write(`  warning: ${w}\n`);
+        }
+        if (refreshResult.filesWritten.length > 0) {
+            const verb = dryRun ? 'Would update' : 'Updated';
+            process.stdout.write(`${verb}:\n`);
+            for (const f of refreshResult.filesWritten) {
+                process.stdout.write(`  + ${f}\n`);
+            }
+        }
+        if (refreshResult.filesSkipped.length > 0) {
+            process.stdout.write(`Unchanged:\n`);
+            for (const f of refreshResult.filesSkipped) {
+                process.stdout.write(`  = ${f}\n`);
+            }
+        }
+        if (refreshResult.platforms.length > 0) {
+            process.stdout.write(`\nProject: ${refreshResult.filesWritten.length} file(s) ${dryRun ? 'would be ' : ''}updated, ` +
+                `${refreshResult.filesSkipped.length} unchanged ` +
+                `(${refreshResult.platforms.join(', ')})\n`);
+        }
+    }
+    // --- Rediscover ---
+    if (opts.rediscover) {
+        process.stdout.write('\n');
+        process.stderr.write('Regenerating context docs...\n');
+        const discoverResult = rediscover(projectRoot, dryRun);
+        const verb = dryRun ? 'Would write' : 'Wrote';
+        for (const doc of discoverResult.docsWritten) {
+            process.stdout.write(`  ${verb}: ${doc}\n`);
+        }
+    }
+    // --- Final summary ---
+    if (dryRun) {
+        process.stdout.write('\nNo changes were made (--dry-run).\n');
+    }
+    else {
+        process.stdout.write('\nDone.\n');
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rasensio/aidlc",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "AI Development Lifecycle Framework — structured lifecycle guidance for AI coding agents across platforms",
   "type": "module",
   "main": "dist/cli.js",

package/skills/01-getting-started.md

@@ -7,6 +7,10 @@ trigger: When the user asks how to get started, how to use the framework, or ask
 ---
 # Getting Started with AIDLC
 
+## Pre-condition: First Activation
+
+Before responding with this skill, check whether `.aidlc/context/` exists and contains at least one `.md` file. If it does NOT, defer to the **aidlc-first-activation** skill instead — it will scan the project, build context docs, and then hand control back to the user's original request. Do not proceed with getting-started guidance until first-activation has completed.
+
 ## When to Activate
 
 Respond using this skill when the user asks any of the following:

package/skills/02-first-activation.md

@@ -0,0 +1,158 @@
+---
+name: aidlc-first-activation
+description: Auto-discovers a brownfield project on first activation — scans codebase, asks about extra context folders, writes context docs
+phase: ideation
+priority: 98
+trigger: When AIDLC is installed but `.aidlc/context/` does not exist or contains no files
+---
+# First Activation — Project Discovery
+
+## Purpose
+
+When AIDLC is freshly installed in an existing (brownfield) project, this skill runs once to build project context automatically. It replaces the need for the user to run `aidlc discover` from the terminal.
+
+## Activation Condition
+
+Activate this skill **before any other AIDLC skill** when ALL of the following are true:
+
+1. AIDLC skills are installed (`.aidlc/skills/` exists)
+2. The context directory is missing or empty (`.aidlc/context/` does not exist, or contains no `.md` files)
+3. The user has just sent a message (any message — they may be asking to fix a bug, add a feature, etc.)
+
+If `.aidlc/context/` already contains at least one `.md` file, skip this skill entirely and proceed with the user's request using the appropriate skill.
+
+## Behavior
+
+### Step 1: Acknowledge and Scan
+
+Tell the user briefly that you're indexing the project for the first time. Keep it short — don't block them with a wall of text.
+
+Example: *"First time here — let me scan the project quickly so I have context."*
+
+Then perform a lightweight scan:
+
+1. **Read manifest files** at the project root: `package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, `pom.xml`, `build.gradle`, `Gemfile`, or equivalent.
+2. **List top-level directories** to understand the project structure.
+3. **Sample 3-5 source files** from the primary source directory to detect:
+   - Indentation style (tabs, 2-space, 4-space)
+   - Naming convention (camelCase, snake_case, PascalCase)
+   - Import style (grouped vs ungrouped)
+4. **Identify the tech stack**: language(s), frameworks, test runner, build tool, linter.
+
+### Step 2: Ask About Extra Context Folders
+
+After scanning, ask the user:
+
+> "I've got the basics — [summarize: language, framework, structure in one line].
+>
+> Beyond the source code, are there any folders I should be aware of for ongoing context? For example: specs, roadmap, architecture decisions, API schemas, design docs, etc."
+
+Wait for the user's answer. Common examples:
+- `specs/`, `docs/`, `roadmap/`, `architecture/`, `adr/`, `design/`, `api/`
+- The user might also point to specific files like `ARCHITECTURE.md` or `openapi.yaml`
+
+If the user says "no" or "that's it," proceed without extra folders.
+
+### Step 3: Read Extra Context
+
+For each folder or file the user mentions:
+1. List its contents (non-recursive, top level only for folders)
+2. Read key files (prefer: index files, READMEs, YAML/JSON schemas, markdown docs)
+3. Summarize what you found — don't copy entire documents verbatim
+
+Cap this step: read at most 10 files total from extra context folders. If there's more, note what was skipped and tell the user they can point you at specific files later.
+
+### Step 4: Write Context Documents
+
+Create `.aidlc/context/` and write:
+
+#### `style-guide.md`
+```markdown
+---
+generated_by: aidlc-first-activation
+generated_at: <ISO 8601 UTC>
+---
+# Style Guide
+
+## Languages
+<table of languages with approximate file counts>
+
+## Conventions
+- Indentation: <detected>
+- Naming: <detected>
+- Import style: <detected>
+
+## Frameworks & Tools
+<list of detected frameworks, test runners, build tools>
+```
+
+#### `architecture.md`
+```markdown
+---
+generated_by: aidlc-first-activation
+generated_at: <ISO 8601 UTC>
+---
+# Architecture Overview
+
+## Tech Stack
+<primary languages and frameworks>
+
+## Directory Structure
+<role mapping of top-level directories>
+
+## Entry Points
+<detected entry points>
+
+## Configuration
+<config approach: env vars, YAML, etc.>
+```
+
+#### `project-knowledge.md` (only if the user provided extra folders)
+```markdown
+---
+generated_by: aidlc-first-activation
+generated_at: <ISO 8601 UTC>
+source_paths:
+  - <path1>
+  - <path2>
+---
+# Project Knowledge
+
+## Sources
+<list of folders/files the user pointed to>
+
+## Summary
+
+### <Folder/File 1 Name>
+<2-5 sentence summary of what's in there and what's relevant>
+
+### <Folder/File 2 Name>
+<2-5 sentence summary>
+
+## Key References
+<specific files worth reading in full when working on related areas>
+```
+
+### Step 5: Confirm and Continue
+
+After writing the context docs, briefly confirm:
+
+> "Done — indexed the project. Context saved to `.aidlc/context/`. Now, back to your request..."
+
+Then **immediately proceed** with whatever the user originally asked. Do not make them repeat themselves. Their original message is still the active task — discovery was a transparent preamble.
+
+## Important Notes
+
+- **This skill runs exactly once per project.** After context docs are written, it never triggers again.
+- **Don't over-scan.** This is a lightweight pass, not a full AST analysis. 3-5 sampled files is enough for style detection.
+- **Don't block the user.** The scan should feel like a 10-second preamble, not a separate workflow. If the project is huge, just scan what you can quickly and note gaps.
+- **Respect .gitignore patterns.** Don't scan `node_modules/`, `dist/`, `build/`, `.git/`, etc.
+- **Extra context is optional.** If the user says "nah, just the code" — that's fine. Skip `project-knowledge.md`.
+- **The user's original request takes priority.** Discovery enables better answers but must not derail the conversation.
+
+## Exit Criteria
+
+- `.aidlc/context/style-guide.md` exists with detected conventions
+- `.aidlc/context/architecture.md` exists with structure overview
+- `.aidlc/context/project-knowledge.md` exists (if extra folders were provided)
+- The user's original request is being addressed (not abandoned)