aw-spec-cli 0.1.2 → 0.1.4

package/dist/commands/update.js

@@ -0,0 +1,142 @@
+import { Command } from 'commander';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { resolveAssetsPath } from '../utils/paths.js';
+import { readManifest, updateManifest } from '../utils/manifest.js';
+import { buildUpdatePlan, applyUpdatePlan } from '../utils/update-engine.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const AGENT_FOLDER_MAP = {
+    claude: '.claude',
+    antigravity: '.agents',
+    kilocode: '.kilocode',
+};
+const ALWAYS_COPY = ['.aw-spec', 'docs'];
+export const updateCommand = new Command('update')
+    .description('Update an existing AppWeaver Spec project with latest assets from registry')
+    .argument('[directory]', 'Target directory (default: current directory)', '.')
+    .option('-a, --agent <agent>', 'Agent to use: claude, antigravity, kilocode (detected from manifest if not specified)')
+    .option('-y, --yes', 'Skip prompts and apply non-conflicting updates automatically')
+    .option('--dry-run', 'Show what would be updated without making changes')
+    .action(async (directory, options) => {
+    const targetDir = directory === '.' ? process.cwd() : directory;
+    const manifestPath = path.join(targetDir, '.aw-spec', 'manifest.json');
+    console.log(`\n🔄 Checking for updates in: ${targetDir}\n`);
+    // Load existing manifest
+    const manifest = await readManifest(manifestPath);
+    if (!manifest) {
+        console.log(chalk.red('✗ No manifest found. This project was not initialized with aw-spec or is from an older version.'));
+        console.log(chalk.yellow('  Run `aw-spec init` to initialize a new project.'));
+        process.exit(1);
+    }
+    console.log(chalk.gray(`  Current version: ${manifest.version}`));
+    console.log(chalk.gray(`  Last updated: ${manifest.updatedAt}`));
+    console.log(chalk.gray(`  Tracked files: ${Object.keys(manifest.files).length}`));
+    // Determine agent from manifest or options
+    let agent = options.agent;
+    if (agent === 'prompt') {
+        // Try to detect from init-options.json
+        const initOptionsPath = path.join(targetDir, '.aw-spec', 'init-options.json');
+        if (await fs.pathExists(initOptionsPath)) {
+            try {
+                const initOptions = await fs.readJSON(initOptionsPath);
+                if (initOptions.ai && ['claude', 'antigravity', 'kilocode'].includes(initOptions.ai)) {
+                    agent = initOptions.ai;
+                    console.log(chalk.gray(`  Detected agent from init-options: ${agent}`));
+                }
+            }
+            catch {
+                // Ignore parse errors
+            }
+        }
+    }
+    // If still not determined, prompt
+    if (agent === 'prompt') {
+        if (options.yes) {
+            agent = 'claude';
+        }
+        else {
+            const { selectedAgent } = await inquirer.prompt([
+                {
+                    type: 'list',
+                    name: 'selectedAgent',
+                    message: 'Which agent skills should be updated?',
+                    choices: [
+                        { name: 'Claude Code (.claude/skills)', value: 'claude' },
+                        { name: 'Antigravity (.agents/skills)', value: 'antigravity' },
+                        { name: 'KiloCode (.kilocode/skills)', value: 'kilocode' },
+                    ],
+                    default: 'claude',
+                },
+            ]);
+            agent = selectedAgent;
+        }
+    }
+    const agentFolder = AGENT_FOLDER_MAP[agent];
+    // Resolve new assets from registry
+    const assetsPath = await resolveAssetsPath();
+    console.log(chalk.gray(`  Source assets: ${assetsPath}`));
+    if (options.dryRun) {
+        console.log('\n📋 Dry run - checking for updates...\n');
+    }
+    // Build update plan
+    console.log(chalk.bold('\n📊 Analyzing changes...\n'));
+    const plan = await buildUpdatePlan(manifest.files, targetDir, assetsPath);
+    // Print summary
+    console.log(chalk.bold('\n📋 Update Plan:'));
+    console.log(chalk.green(`  Update: ${plan.summary.update}`));
+    console.log(chalk.blue(`  Add: ${plan.summary.add}`));
+    console.log(chalk.yellow(`  Preserve: ${plan.summary.preserve}`));
+    console.log(chalk.red(`  Skip (conflicts): ${plan.summary.skip}`));
+    console.log(chalk.gray(`  Remove: ${plan.summary.remove}`));
+    if (plan.summary.skip > 0) {
+        console.log(chalk.yellow('\n⚠️  Conflicts detected - these files have both user and upstream changes:'));
+        for (const file of plan.files.filter(f => f.disposition === 'skip')) {
+            console.log(chalk.yellow(`  ⚠ ${file.relPath} - ${file.reason}`));
+        }
+        console.log(chalk.yellow('\n  These files will be skipped. Resolve manually after update.'));
+    }
+    if (plan.summary.preserve > 0) {
+        console.log(chalk.blue('\nℹ️  User-modified files preserved:'));
+        for (const file of plan.files.filter(f => f.disposition === 'preserve')) {
+            console.log(chalk.blue(`  ⊘ ${file.relPath} - ${file.reason}`));
+        }
+    }
+    if (options.dryRun) {
+        console.log(chalk.bold('\n🔍 Dry run complete - no changes made.'));
+        return;
+    }
+    // Confirm before applying if not --yes
+    if (!options.yes && (plan.summary.update > 0 || plan.summary.add > 0 || plan.summary.remove > 0)) {
+        const { confirm } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'confirm',
+                message: 'Apply these updates?',
+                default: true,
+            },
+        ]);
+        if (!confirm) {
+            console.log(chalk.gray('\nUpdate cancelled.'));
+            return;
+        }
+    }
+    // Apply update plan
+    console.log(chalk.bold('\n📦 Applying updates...\n'));
+    await applyUpdatePlan(plan, targetDir, assetsPath, {
+        onProgress: (msg) => console.log(msg),
+    });
+    // Update manifest with new state
+    console.log(chalk.bold('\n📝 Updating manifest...'));
+    const newManifest = await updateManifest(manifestPath, targetDir, manifest.version);
+    console.log(chalk.green(`  ✓ Manifest updated (${Object.keys(newManifest.files).length} files tracked)`));
+    console.log(chalk.bold('\n✅ Update complete!'));
+    console.log('\nNext steps:');
+    console.log('  aw-spec doctor    # Verify the installation');
+    if (plan.summary.skip > 0) {
+        console.log(chalk.yellow('  Review skipped files and resolve conflicts manually'));
+    }
+});
+//# 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/dist/index.js

@@ -2,6 +2,7 @@
 import { program } from 'commander';
 import { initCommand } from './commands/init.js';
 import { doctorCommand } from './commands/doctor.js';
+import { updateCommand } from './commands/update.js';
 import fs from 'fs-extra';
 import path from 'path';
 import { fileURLToPath } from 'url';
@@ -12,6 +13,7 @@ program
     .description('AppWeaver Spec-Driven Development CLI')
     .version(packageJson.version)
     .addCommand(initCommand)
+    .addCommand(updateCommand)
     .addCommand(doctorCommand);
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAElF,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,uCAAuC,CAAC;KACpD,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;KAC5B,UAAU,CAAC,WAAW,CAAC;KACvB,UAAU,CAAC,aAAa,CAAC,CAAC;AAE7B,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAElF,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,uCAAuC,CAAC;KACpD,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;KAC5B,UAAU,CAAC,WAAW,CAAC;KACvB,UAAU,CAAC,aAAa,CAAC;KACzB,UAAU,CAAC,aAAa,CAAC,CAAC;AAE7B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/utils/manifest.d.ts

@@ -0,0 +1,31 @@
+export interface Manifest {
+    version: string;
+    files: Record<string, string>;
+    updatedAt: string;
+}
+export interface ManifestOptions {
+    manifestPath: string;
+}
+/**
+ * Compute SHA256 hash of a file
+ */
+export declare function computeFileHash(filePath: string): Promise<string>;
+/**
+ * Read manifest from disk, returns null if not found
+ */
+export declare function readManifest(manifestPath: string): Promise<Manifest | null>;
+/**
+ * Write manifest to disk
+ */
+export declare function writeManifest(manifestPath: string, manifest: Manifest): Promise<void>;
+/**
+ * Create a new manifest from a source directory
+ * Walks the directory and computes hashes for all files
+ */
+export declare function createManifest(sourceRoot: string, targetRoot: string, version: string): Promise<Manifest>;
+/**
+ * Update manifest with new hashes from target directory
+ * Used after successful update to record new state
+ */
+export declare function updateManifest(manifestPath: string, targetRoot: string, version: string): Promise<Manifest>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/utils/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/utils/manifest.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKvE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAUjF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3F;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,QAAQ,CAAC,CAyBnB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,QAAQ,CAAC,CA4BnB"}

package/dist/utils/manifest.js

@@ -0,0 +1,91 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { createHash } from 'crypto';
+/**
+ * Compute SHA256 hash of a file
+ */
+export async function computeFileHash(filePath) {
+    const content = await fs.readFile(filePath);
+    const hash = createHash('sha256');
+    hash.update(content);
+    return hash.digest('hex');
+}
+/**
+ * Read manifest from disk, returns null if not found
+ */
+export async function readManifest(manifestPath) {
+    if (!(await fs.pathExists(manifestPath))) {
+        return null;
+    }
+    try {
+        const manifest = await fs.readJSON(manifestPath);
+        return manifest;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write manifest to disk
+ */
+export async function writeManifest(manifestPath, manifest) {
+    await fs.ensureDir(path.dirname(manifestPath));
+    await fs.writeJSON(manifestPath, manifest, { spaces: 2 });
+}
+/**
+ * Create a new manifest from a source directory
+ * Walks the directory and computes hashes for all files
+ */
+export async function createManifest(sourceRoot, targetRoot, version) {
+    const files = {};
+    async function walk(dir, baseSource) {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            const relPath = path.relative(baseSource, fullPath);
+            if (entry.isDirectory()) {
+                await walk(fullPath, baseSource);
+            }
+            else if (entry.isFile()) {
+                const hash = await computeFileHash(fullPath);
+                files[relPath] = hash;
+            }
+        }
+    }
+    await walk(sourceRoot, sourceRoot);
+    return {
+        version,
+        files,
+        updatedAt: new Date().toISOString(),
+    };
+}
+/**
+ * Update manifest with new hashes from target directory
+ * Used after successful update to record new state
+ */
+export async function updateManifest(manifestPath, targetRoot, version) {
+    const files = {};
+    async function walk(dir, baseTarget) {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            const relPath = path.relative(baseTarget, fullPath);
+            if (entry.isDirectory()) {
+                await walk(fullPath, baseTarget);
+            }
+            else if (entry.isFile()) {
+                const hash = await computeFileHash(fullPath);
+                files[relPath] = hash;
+            }
+        }
+    }
+    await walk(targetRoot, targetRoot);
+    const manifest = {
+        version,
+        files,
+        updatedAt: new Date().toISOString(),
+    };
+    await writeManifest(manifestPath, manifest);
+    return manifest;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/utils/manifest.js.map

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

package/dist/utils/update-engine.d.ts

@@ -0,0 +1,52 @@
+export type Disposition = 'update' | 'preserve' | 'skip' | 'remove' | 'add';
+export interface FileDisposition {
+    relPath: string;
+    disposition: Disposition;
+    reason: string;
+    manifestHash?: string;
+    currentHash?: string;
+    sourceHash?: string;
+}
+export interface UpdatePlan {
+    files: FileDisposition[];
+    summary: {
+        update: number;
+        preserve: number;
+        skip: number;
+        remove: number;
+        add: number;
+    };
+}
+/**
+ * Compare three states and determine disposition for a single file
+ *
+ * Three-way comparison logic:
+ * - manifestHash: hash from original manifest (what we installed)
+ * - currentHash: hash of file currently on disk (user's version)
+ * - sourceHash: hash of file in new source (registry version)
+ *
+ * Cases:
+ * 1. All three same → no-op (not in plan)
+ * 2. manifest === current !== source → UPDATE (upstream changed, user didn't touch)
+ * 3. manifest !== current === source → PRESERVE (user changed, upstream same - but this is weird)
+ * 4. manifest === source !== current → PRESERVE (user changed, upstream didn't)
+ * 5. All three different → SKIP (conflict - both changed)
+ * 6. manifest exists, current missing, source exists → UPDATE (user deleted, restore from source)
+ * 7. manifest exists, current exists, source missing → REMOVE (upstream deleted)
+ * 8. manifest missing, current exists, source exists → SKIP (file added by user, also in new source - conflict)
+ * 9. manifest missing, current exists, source missing → PRESERVE (user added, not in upstream)
+ * 10. manifest missing, current missing, source exists → ADD (new file in upstream)
+ */
+export declare function computeDisposition(relPath: string, manifestHash: string | undefined, currentHash: string | undefined, sourceHash: string | undefined): FileDisposition;
+/**
+ * Build update plan by comparing manifest, current target, and new source
+ */
+export declare function buildUpdatePlan(manifest: Record<string, string>, targetRoot: string, sourceRoot: string): Promise<UpdatePlan>;
+/**
+ * Apply update plan to target directory
+ */
+export declare function applyUpdatePlan(plan: UpdatePlan, targetRoot: string, sourceRoot: string, options?: {
+    dryRun?: boolean;
+    onProgress?: (msg: string) => void;
+}): Promise<void>;
+//# sourceMappingURL=update-engine.d.ts.map

package/dist/utils/update-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-engine.d.ts","sourceRoot":"","sources":["../../src/utils/update-engine.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,eAAe,CAqEjB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC,CAyFrB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAO,GACrE,OAAO,CAAC,IAAI,CAAC,CAkCf"}

package/dist/utils/update-engine.js

@@ -0,0 +1,203 @@
+import { computeFileHash } from './manifest.js';
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * Compare three states and determine disposition for a single file
+ *
+ * Three-way comparison logic:
+ * - manifestHash: hash from original manifest (what we installed)
+ * - currentHash: hash of file currently on disk (user's version)
+ * - sourceHash: hash of file in new source (registry version)
+ *
+ * Cases:
+ * 1. All three same → no-op (not in plan)
+ * 2. manifest === current !== source → UPDATE (upstream changed, user didn't touch)
+ * 3. manifest !== current === source → PRESERVE (user changed, upstream same - but this is weird)
+ * 4. manifest === source !== current → PRESERVE (user changed, upstream didn't)
+ * 5. All three different → SKIP (conflict - both changed)
+ * 6. manifest exists, current missing, source exists → UPDATE (user deleted, restore from source)
+ * 7. manifest exists, current exists, source missing → REMOVE (upstream deleted)
+ * 8. manifest missing, current exists, source exists → SKIP (file added by user, also in new source - conflict)
+ * 9. manifest missing, current exists, source missing → PRESERVE (user added, not in upstream)
+ * 10. manifest missing, current missing, source exists → ADD (new file in upstream)
+ */
+export function computeDisposition(relPath, manifestHash, currentHash, sourceHash) {
+    // Case: file exists in all three
+    if (manifestHash && currentHash && sourceHash) {
+        if (manifestHash === currentHash && currentHash === sourceHash) {
+            // All same - no change needed (caller should filter these out)
+            return { relPath, disposition: 'update', reason: 'No changes (all identical)', manifestHash, currentHash, sourceHash };
+        }
+        if (manifestHash === currentHash && manifestHash !== sourceHash) {
+            // User didn't touch, upstream changed
+            return { relPath, disposition: 'update', reason: 'Upstream changed, user unmodified', manifestHash, currentHash, sourceHash };
+        }
+        if (manifestHash !== currentHash && manifestHash === sourceHash) {
+            // User changed, upstream didn't
+            return { relPath, disposition: 'preserve', reason: 'User modified, upstream unchanged', manifestHash, currentHash, sourceHash };
+        }
+        if (manifestHash === sourceHash && currentHash !== sourceHash) {
+            // Same as above - user changed, upstream same
+            return { relPath, disposition: 'preserve', reason: 'User modified, upstream unchanged', manifestHash, currentHash, sourceHash };
+        }
+        if (manifestHash !== currentHash && currentHash === sourceHash) {
+            // User changed to match upstream (e.g. user anticipated change)
+            return { relPath, disposition: 'preserve', reason: 'User version matches upstream', manifestHash, currentHash, sourceHash };
+        }
+        // All three different
+        return { relPath, disposition: 'skip', reason: 'Conflict: both user and upstream modified', manifestHash, currentHash, sourceHash };
+    }
+    // Case: manifest exists, current missing (user deleted)
+    if (manifestHash && !currentHash && sourceHash) {
+        return { relPath, disposition: 'update', reason: 'User deleted, restoring from upstream', manifestHash, currentHash, sourceHash };
+    }
+    // Case: manifest exists, current exists, source missing (upstream deleted)
+    if (manifestHash && currentHash && !sourceHash) {
+        return { relPath, disposition: 'remove', reason: 'Upstream removed file', manifestHash, currentHash, sourceHash };
+    }
+    // Case: manifest missing, current exists, source exists (user added, also in new upstream)
+    if (!manifestHash && currentHash && sourceHash) {
+        if (currentHash === sourceHash) {
+            // User added same content as upstream - treat as add
+            return { relPath, disposition: 'add', reason: 'New file in upstream (matches user)', manifestHash, currentHash, sourceHash };
+        }
+        // Different content - conflict
+        return { relPath, disposition: 'skip', reason: 'Conflict: user added file, upstream also added different version', manifestHash, currentHash, sourceHash };
+    }
+    // Case: manifest missing, current exists, source missing (user added, not in upstream)
+    if (!manifestHash && currentHash && !sourceHash) {
+        return { relPath, disposition: 'preserve', reason: 'User added file, not in upstream', manifestHash, currentHash, sourceHash };
+    }
+    // Case: manifest missing, current missing, source exists (new file in upstream)
+    if (!manifestHash && !currentHash && sourceHash) {
+        return { relPath, disposition: 'add', reason: 'New file in upstream', manifestHash, currentHash, sourceHash };
+    }
+    // Case: manifest exists, current missing, source missing (file was in manifest but deleted everywhere)
+    if (manifestHash && !currentHash && !sourceHash) {
+        return { relPath, disposition: 'remove', reason: 'File removed from upstream', manifestHash, currentHash, sourceHash };
+    }
+    // Should not reach here
+    return { relPath, disposition: 'skip', reason: 'Unknown state', manifestHash, currentHash, sourceHash };
+}
+/**
+ * Build update plan by comparing manifest, current target, and new source
+ */
+export async function buildUpdatePlan(manifest, targetRoot, sourceRoot) {
+    const files = [];
+    // Collect all unique relative paths from all three sources
+    const allPaths = new Set();
+    // From manifest
+    for (const relPath of Object.keys(manifest)) {
+        allPaths.add(relPath);
+    }
+    // From target (current)
+    async function walkTarget(dir, base) {
+        try {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                const relPath = path.relative(base, fullPath);
+                if (entry.isDirectory()) {
+                    await walkTarget(fullPath, base);
+                }
+                else if (entry.isFile()) {
+                    allPaths.add(relPath);
+                }
+            }
+        }
+        catch {
+            // Directory might not exist
+        }
+    }
+    await walkTarget(targetRoot, targetRoot);
+    // From source (new)
+    async function walkSource(dir, base) {
+        try {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                const relPath = path.relative(base, fullPath);
+                if (entry.isDirectory()) {
+                    await walkSource(fullPath, base);
+                }
+                else if (entry.isFile()) {
+                    allPaths.add(relPath);
+                }
+            }
+        }
+        catch {
+            // Directory might not exist
+        }
+    }
+    await walkSource(sourceRoot, sourceRoot);
+    // Compute disposition for each path
+    for (const relPath of allPaths) {
+        const manifestHash = manifest[relPath];
+        // Get current hash
+        let currentHash;
+        const currentPath = path.join(targetRoot, relPath);
+        if (await fs.pathExists(currentPath)) {
+            currentHash = await computeFileHash(currentPath);
+        }
+        // Get source hash
+        let sourceHash;
+        const sourcePath = path.join(sourceRoot, relPath);
+        if (await fs.pathExists(sourcePath)) {
+            sourceHash = await computeFileHash(sourcePath);
+        }
+        const disposition = computeDisposition(relPath, manifestHash, currentHash, sourceHash);
+        // Only include files that need action (not 'no-op')
+        if (disposition.disposition !== 'update' || disposition.reason !== 'No changes (all identical)') {
+            files.push(disposition);
+        }
+    }
+    // Sort for consistent output: update, add, preserve, skip, remove
+    const order = { update: 0, add: 1, preserve: 2, skip: 3, remove: 4 };
+    files.sort((a, b) => order[a.disposition] - order[b.disposition]);
+    // Build summary
+    const summary = {
+        update: files.filter(f => f.disposition === 'update').length,
+        preserve: files.filter(f => f.disposition === 'preserve').length,
+        skip: files.filter(f => f.disposition === 'skip').length,
+        remove: files.filter(f => f.disposition === 'remove').length,
+        add: files.filter(f => f.disposition === 'add').length,
+    };
+    return { files, summary };
+}
+/**
+ * Apply update plan to target directory
+ */
+export async function applyUpdatePlan(plan, targetRoot, sourceRoot, options = {}) {
+    const { dryRun = false, onProgress = () => { } } = options;
+    for (const file of plan.files) {
+        const targetPath = path.join(targetRoot, file.relPath);
+        const sourcePath = path.join(sourceRoot, file.relPath);
+        switch (file.disposition) {
+            case 'update':
+            case 'add': {
+                onProgress(`  ✓ ${file.relPath} (${file.disposition})`);
+                if (!dryRun) {
+                    await fs.ensureDir(path.dirname(targetPath));
+                    await fs.copy(sourcePath, targetPath, { overwrite: true });
+                }
+                break;
+            }
+            case 'remove': {
+                onProgress(`  ✗ ${file.relPath} (remove)`);
+                if (!dryRun) {
+                    await fs.remove(targetPath);
+                }
+                break;
+            }
+            case 'preserve': {
+                onProgress(`  ⊘ ${file.relPath} (preserved - user modified)`);
+                break;
+            }
+            case 'skip': {
+                onProgress(`  ⚠ ${file.relPath} (skipped - conflict: ${file.reason})`);
+                break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=update-engine.js.map

package/dist/utils/update-engine.js.map

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

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "aw-spec-cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "AppWeaver Spec-Driven Development CLI - scaffolds projects with vertical slices, DDD, CQRS, and agent skills",
   "type": "module",
   "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js"
+  },
   "bin": {
-    "aw-spec": "dist/index.js"
+    "aw-spec": "./dist/index.js"
   },
   "files": [
     "dist",

package/assets/docs/requirement-spec.txt

@@ -1,15 +0,0 @@
-/aw-spec-specify MedicinalProduct/RegisterMedicinalProduct
-
-Allow an authorized user to register a new medicinal product in the registry.
-
-On registration the user provides: product name, generic name, NDC, dosage form, strength, route of administration, manufacturer, one or more active ingredients with details, one or more packaging configurations and one or more ATC classification codes.
-
-The system validates the submission (required attributes, duplicate NDC, valid dosage form and route of administration) and creates the product in the Draft state. A successful registration is auditable and emits a registration event.
-
-Acceptance:
-- A valid submission creates a Draft MedicinalProduct and returns its identifier.
-- A malformed or duplicate NDC is rejected with a clear validation error.
-- A product missing a required attribute, an active ingredient, or a packaging configuration is rejected.
-- The creation is recorded in the audit trail.
-
-==============================================================================================