jun-claude-code 0.6.2 → 0.6.4

package/dist/__tests__/metadata.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/metadata.test.js

@@ -0,0 +1,178 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const crypto = __importStar(require("crypto"));
+const metadata_1 = require("../metadata");
+function createTmpDir() {
+    return fs.mkdtempSync(path.join(os.tmpdir(), 'metadata-test-'));
+}
+function cleanupDir(dir) {
+    fs.rmSync(dir, { recursive: true, force: true });
+}
+function writeFile(dir, relativePath, content) {
+    const filePath = path.join(dir, relativePath);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, content, 'utf-8');
+}
+function hashContent(content) {
+    return crypto.createHash('sha256').update(Buffer.from(content)).digest('hex');
+}
+(0, vitest_1.describe)('metadata', () => {
+    let tmpDir;
+    (0, vitest_1.beforeEach)(() => {
+        tmpDir = createTmpDir();
+    });
+    (0, vitest_1.afterEach)(() => {
+        cleanupDir(tmpDir);
+    });
+    (0, vitest_1.describe)('getMetadataPath', () => {
+        (0, vitest_1.it)('should return correct path', () => {
+            (0, vitest_1.expect)((0, metadata_1.getMetadataPath)('/home/user/.claude')).toBe('/home/user/.claude/.jun-installed.json');
+        });
+    });
+    (0, vitest_1.describe)('loadMetadata', () => {
+        (0, vitest_1.it)('should return null when file does not exist', () => {
+            (0, vitest_1.expect)((0, metadata_1.loadMetadata)(tmpDir)).toBeNull();
+        });
+        (0, vitest_1.it)('should return null when file is invalid JSON', () => {
+            fs.writeFileSync(path.join(tmpDir, '.jun-installed.json'), 'not json', 'utf-8');
+            (0, vitest_1.expect)((0, metadata_1.loadMetadata)(tmpDir)).toBeNull();
+        });
+        (0, vitest_1.it)('should return metadata when valid', () => {
+            const meta = {
+                version: '1.0.0',
+                installedAt: '2025-01-01T00:00:00.000Z',
+                files: { 'agents/test.md': { hash: 'abc123' } },
+            };
+            fs.writeFileSync(path.join(tmpDir, '.jun-installed.json'), JSON.stringify(meta), 'utf-8');
+            (0, vitest_1.expect)((0, metadata_1.loadMetadata)(tmpDir)).toEqual(meta);
+        });
+    });
+    (0, vitest_1.describe)('saveMetadata', () => {
+        (0, vitest_1.it)('should write metadata as formatted JSON', () => {
+            const meta = {
+                version: '1.0.0',
+                installedAt: '2025-01-01T00:00:00.000Z',
+                files: { 'agents/test.md': { hash: 'abc123' } },
+            };
+            (0, metadata_1.saveMetadata)(tmpDir, meta);
+            const content = fs.readFileSync(path.join(tmpDir, '.jun-installed.json'), 'utf-8');
+            (0, vitest_1.expect)(JSON.parse(content)).toEqual(meta);
+            (0, vitest_1.expect)(content.endsWith('\n')).toBe(true);
+        });
+    });
+    (0, vitest_1.describe)('buildMetadata', () => {
+        (0, vitest_1.it)('should create metadata with correct hashes', () => {
+            const sourceDir = createTmpDir();
+            try {
+                writeFile(sourceDir, 'agents/test.md', 'hello');
+                writeFile(sourceDir, 'skills/Git/SKILL.md', 'world');
+                const meta = (0, metadata_1.buildMetadata)(['agents/test.md', 'skills/Git/SKILL.md'], sourceDir, '1.0.0');
+                (0, vitest_1.expect)(meta.version).toBe('1.0.0');
+                (0, vitest_1.expect)(meta.files['agents/test.md'].hash).toBe(hashContent('hello'));
+                (0, vitest_1.expect)(meta.files['skills/Git/SKILL.md'].hash).toBe(hashContent('world'));
+            }
+            finally {
+                cleanupDir(sourceDir);
+            }
+        });
+        (0, vitest_1.it)('should skip non-existent files', () => {
+            const sourceDir = createTmpDir();
+            try {
+                writeFile(sourceDir, 'agents/test.md', 'hello');
+                const meta = (0, metadata_1.buildMetadata)(['agents/test.md', 'agents/missing.md'], sourceDir, '1.0.0');
+                (0, vitest_1.expect)(Object.keys(meta.files)).toHaveLength(1);
+                (0, vitest_1.expect)(meta.files['agents/test.md']).toBeDefined();
+                (0, vitest_1.expect)(meta.files['agents/missing.md']).toBeUndefined();
+            }
+            finally {
+                cleanupDir(sourceDir);
+            }
+        });
+    });
+    (0, vitest_1.describe)('mergeMetadata', () => {
+        (0, vitest_1.it)('should create new metadata when existing is null', () => {
+            const sourceDir = createTmpDir();
+            try {
+                writeFile(sourceDir, 'agents/test.md', 'hello');
+                const meta = (0, metadata_1.mergeMetadata)(null, ['agents/test.md'], sourceDir, '1.0.0');
+                (0, vitest_1.expect)(meta.version).toBe('1.0.0');
+                (0, vitest_1.expect)(meta.files['agents/test.md'].hash).toBe(hashContent('hello'));
+            }
+            finally {
+                cleanupDir(sourceDir);
+            }
+        });
+        (0, vitest_1.it)('should preserve existing entries and add new ones', () => {
+            const sourceDir = createTmpDir();
+            try {
+                writeFile(sourceDir, 'agents/new.md', 'new content');
+                const existing = {
+                    version: '0.9.0',
+                    installedAt: '2025-01-01T00:00:00.000Z',
+                    files: { 'agents/old.md': { hash: 'oldhash' } },
+                };
+                const meta = (0, metadata_1.mergeMetadata)(existing, ['agents/new.md'], sourceDir, '1.0.0');
+                (0, vitest_1.expect)(meta.version).toBe('1.0.0');
+                (0, vitest_1.expect)(meta.files['agents/old.md'].hash).toBe('oldhash');
+                (0, vitest_1.expect)(meta.files['agents/new.md'].hash).toBe(hashContent('new content'));
+            }
+            finally {
+                cleanupDir(sourceDir);
+            }
+        });
+        (0, vitest_1.it)('should override existing entries for the same file', () => {
+            const sourceDir = createTmpDir();
+            try {
+                writeFile(sourceDir, 'agents/test.md', 'updated content');
+                const existing = {
+                    version: '0.9.0',
+                    installedAt: '2025-01-01T00:00:00.000Z',
+                    files: { 'agents/test.md': { hash: 'oldhash' } },
+                };
+                const meta = (0, metadata_1.mergeMetadata)(existing, ['agents/test.md'], sourceDir, '1.0.0');
+                (0, vitest_1.expect)(meta.files['agents/test.md'].hash).toBe(hashContent('updated content'));
+                (0, vitest_1.expect)(meta.files['agents/test.md'].hash).not.toBe('oldhash');
+            }
+            finally {
+                cleanupDir(sourceDir);
+            }
+        });
+    });
+});

package/dist/__tests__/update.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/update.test.js

@@ -0,0 +1,154 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const crypto = __importStar(require("crypto"));
+const update_1 = require("../update");
+function createTmpDir() {
+    return fs.mkdtempSync(path.join(os.tmpdir(), 'update-test-'));
+}
+function cleanupDir(dir) {
+    fs.rmSync(dir, { recursive: true, force: true });
+}
+function writeFile(dir, relativePath, content) {
+    const filePath = path.join(dir, relativePath);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, content, 'utf-8');
+}
+function hashContent(content) {
+    return crypto.createHash('sha256').update(Buffer.from(content)).digest('hex');
+}
+function createMetadata(files, version = '1.0.0') {
+    const fileEntries = {};
+    for (const [name, content] of Object.entries(files)) {
+        fileEntries[name] = { hash: hashContent(content) };
+    }
+    return {
+        version,
+        installedAt: '2025-01-01T00:00:00.000Z',
+        files: fileEntries,
+    };
+}
+(0, vitest_1.describe)('computeUpdateStatus', () => {
+    let sourceDir;
+    let destDir;
+    (0, vitest_1.beforeEach)(() => {
+        sourceDir = createTmpDir();
+        destDir = createTmpDir();
+    });
+    (0, vitest_1.afterEach)(() => {
+        cleanupDir(sourceDir);
+        cleanupDir(destDir);
+    });
+    (0, vitest_1.it)('should return new-file when no base and no current file exists', () => {
+        writeFile(sourceDir, 'agents/new.md', 'template content');
+        const status = (0, update_1.computeUpdateStatus)('agents/new.md', sourceDir, destDir, null);
+        (0, vitest_1.expect)(status).toBe('new-file');
+    });
+    (0, vitest_1.it)('should return new-file when base exists but user deleted file', () => {
+        writeFile(sourceDir, 'agents/deleted.md', 'template content');
+        const metadata = createMetadata({ 'agents/deleted.md': 'old content' });
+        const status = (0, update_1.computeUpdateStatus)('agents/deleted.md', sourceDir, destDir, metadata);
+        (0, vitest_1.expect)(status).toBe('new-file');
+    });
+    (0, vitest_1.it)('should return unchanged when no base but current matches new template', () => {
+        const content = 'same content';
+        writeFile(sourceDir, 'agents/test.md', content);
+        writeFile(destDir, 'agents/test.md', content);
+        const status = (0, update_1.computeUpdateStatus)('agents/test.md', sourceDir, destDir, null);
+        (0, vitest_1.expect)(status).toBe('unchanged');
+    });
+    (0, vitest_1.it)('should return user-modified for legacy file (no base, current differs from new)', () => {
+        writeFile(sourceDir, 'agents/test.md', 'new template');
+        writeFile(destDir, 'agents/test.md', 'user customized');
+        const status = (0, update_1.computeUpdateStatus)('agents/test.md', sourceDir, destDir, null);
+        (0, vitest_1.expect)(status).toBe('user-modified');
+    });
+    (0, vitest_1.it)('should return unchanged when all three hashes match', () => {
+        const content = 'same for all';
+        writeFile(sourceDir, 'agents/test.md', content);
+        writeFile(destDir, 'agents/test.md', content);
+        const metadata = createMetadata({ 'agents/test.md': content });
+        const status = (0, update_1.computeUpdateStatus)('agents/test.md', sourceDir, destDir, metadata);
+        (0, vitest_1.expect)(status).toBe('unchanged');
+    });
+    (0, vitest_1.it)('should return update-available when base==current but new is different', () => {
+        const originalContent = 'original';
+        const newContent = 'updated template';
+        writeFile(sourceDir, 'agents/test.md', newContent);
+        writeFile(destDir, 'agents/test.md', originalContent);
+        const metadata = createMetadata({ 'agents/test.md': originalContent });
+        const status = (0, update_1.computeUpdateStatus)('agents/test.md', sourceDir, destDir, metadata);
+        (0, vitest_1.expect)(status).toBe('update-available');
+    });
+    (0, vitest_1.it)('should return user-modified when base!=current but base==new', () => {
+        const originalContent = 'original';
+        const userContent = 'user changed this';
+        writeFile(sourceDir, 'agents/test.md', originalContent);
+        writeFile(destDir, 'agents/test.md', userContent);
+        const metadata = createMetadata({ 'agents/test.md': originalContent });
+        const status = (0, update_1.computeUpdateStatus)('agents/test.md', sourceDir, destDir, metadata);
+        (0, vitest_1.expect)(status).toBe('user-modified');
+    });
+    (0, vitest_1.it)('should return conflict when base!=current and base!=new', () => {
+        const originalContent = 'original';
+        const userContent = 'user changed this';
+        const newContent = 'template also changed';
+        writeFile(sourceDir, 'agents/test.md', newContent);
+        writeFile(destDir, 'agents/test.md', userContent);
+        const metadata = createMetadata({ 'agents/test.md': originalContent });
+        const status = (0, update_1.computeUpdateStatus)('agents/test.md', sourceDir, destDir, metadata);
+        (0, vitest_1.expect)(status).toBe('conflict');
+    });
+    (0, vitest_1.it)('should return unchanged when base!=current but current==new (user applied same change)', () => {
+        const originalContent = 'original';
+        const newContent = 'both changed to same';
+        writeFile(sourceDir, 'agents/test.md', newContent);
+        writeFile(destDir, 'agents/test.md', newContent);
+        const metadata = createMetadata({ 'agents/test.md': originalContent });
+        const status = (0, update_1.computeUpdateStatus)('agents/test.md', sourceDir, destDir, metadata);
+        // base != current, base != new → conflict (even though current == new)
+        (0, vitest_1.expect)(status).toBe('conflict');
+    });
+    (0, vitest_1.it)('should handle metadata with no entry for the file', () => {
+        writeFile(sourceDir, 'agents/new.md', 'template content');
+        const metadata = createMetadata({ 'agents/other.md': 'other content' });
+        const status = (0, update_1.computeUpdateStatus)('agents/new.md', sourceDir, destDir, metadata);
+        (0, vitest_1.expect)(status).toBe('new-file');
+    });
+});

package/dist/cli.js

@@ -105,6 +105,31 @@ program
         process.exit(1);
     }
 });
+program
+    .command('update')
+    .description('Update installed templates while preserving user customizations')
+    .option('-p, --project', 'Update project .claude/')
+    .option('-f, --force', 'Overwrite all including user-modified')
+    .option('-d, --dry-run', 'Preview changes without applying')
+    .action(async (options) => {
+    try {
+        const { updateClaudeFiles } = await Promise.resolve().then(() => __importStar(require('./update')));
+        await updateClaudeFiles({
+            dryRun: options.dryRun,
+            force: options.force,
+            project: options.project,
+        });
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error('Error:', error.message);
+        }
+        else {
+            console.error('An unexpected error occurred');
+        }
+        process.exit(1);
+    }
+});
 program
     .command('validate')
     .description('Validate template directory structure')

package/dist/copy.d.ts

@@ -3,6 +3,42 @@ export interface CopyOptions {
     force?: boolean;
     project?: boolean;
 }
+export type FileStatus = 'new' | 'changed' | 'unchanged';
+export interface CategorizedFiles {
+    agents: string[];
+    skills: string[];
+    others: string[];
+}
+export declare const EXCLUDE_ALWAYS: string[];
+export declare const EXCLUDE_FROM_PROJECT: string[];
+/**
+ * Calculate SHA-256 hash of a file
+ */
+export declare function getFileHash(filePath: string): string;
+/**
+ * Get all files recursively from a directory
+ */
+export declare function getAllFiles(dirPath: string, basePath?: string): string[];
+/**
+ * Ensure directory exists
+ */
+export declare function ensureDir(dirPath: string): void;
+/**
+ * Copy a single file
+ */
+export declare function copyFile(src: string, dest: string): void;
+/**
+ * Get the source templates/global directory path (from package installation)
+ */
+export declare function getSourceGlobalDir(): string;
+/**
+ * Get the destination .claude directory path (user's home)
+ */
+export declare function getDestClaudeDir(): string;
+/**
+ * Categorize files into agents, skills (top-level dirs), and others
+ */
+export declare function categorizeFiles(files: string[]): CategorizedFiles;
 /**
  * Merge settings.json from source into destination.
  * Hooks are merged per event key; duplicate hook entries (by deep equality) are skipped.

package/dist/copy.js

@@ -36,14 +36,32 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXCLUDE_FROM_PROJECT = exports.EXCLUDE_ALWAYS = void 0;
+exports.getFileHash = getFileHash;
+exports.getAllFiles = getAllFiles;
+exports.ensureDir = ensureDir;
+exports.copyFile = copyFile;
+exports.getSourceGlobalDir = getSourceGlobalDir;
+exports.getDestClaudeDir = getDestClaudeDir;
+exports.categorizeFiles = categorizeFiles;
 exports.mergeSettingsJson = mergeSettingsJson;
 exports.copyClaudeFiles = copyClaudeFiles;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const crypto = __importStar(require("crypto"));
 const chalk_1 = __importDefault(require("chalk"));
+const metadata_1 = require("./metadata");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const { MultiSelect } = require('enquirer');
+// Files to exclude from all copies (merge-handled separately)
+exports.EXCLUDE_ALWAYS = [
+    'settings.json',
+    'statusline-command.sh',
+];
+// Files to exclude only when installing to project
+exports.EXCLUDE_FROM_PROJECT = [
+    'hooks/_dedup.sh',
+];
 /**
  * Calculate SHA-256 hash of a file
  */
@@ -387,21 +405,12 @@ async function copyClaudeFiles(options = {}) {
         console.error(chalk_1.default.red('Error:'), 'Source templates/global directory not found');
         process.exit(1);
     }
-    // Files to exclude from all copies (merge-handled separately)
-    const EXCLUDE_ALWAYS = [
-        'settings.json',
-        'statusline-command.sh',
-    ];
-    // Files to exclude only when installing to project
-    const EXCLUDE_FROM_PROJECT = [
-        'hooks/_dedup.sh',
-    ];
     // Get all files to copy
     const allFiles = getAllFiles(sourceDir);
     const files = allFiles.filter((file) => {
-        if (EXCLUDE_ALWAYS.includes(file))
+        if (exports.EXCLUDE_ALWAYS.includes(file))
             return false;
-        if (project && EXCLUDE_FROM_PROJECT.includes(file))
+        if (project && exports.EXCLUDE_FROM_PROJECT.includes(file))
             return false;
         return true;
     });
@@ -524,6 +533,12 @@ async function copyClaudeFiles(options = {}) {
     const skippedCount = files.length - copiedCount;
     // Merge settings.json (hooks are merged, not overwritten)
     mergeSettingsJson(sourceDir, destDir, { project });
+    // Save installation metadata
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const currentVersion = require('../package.json').version;
+    const existingMeta = (0, metadata_1.loadMetadata)(destDir);
+    const updatedMeta = (0, metadata_1.mergeMetadata)(existingMeta, allFilesToCopy, sourceDir, currentVersion);
+    (0, metadata_1.saveMetadata)(destDir, updatedMeta);
     console.log();
     console.log(chalk_1.default.green(`Done! Copied ${copiedCount} files, skipped ${skippedCount} files.`));
 }

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export { copyClaudeFiles, CopyOptions } from './copy';
+export { updateClaudeFiles, UpdateOptions, UpdateFileStatus } from './update';
 export { initProject } from './init-project';
 export { initContext } from './init-context';

package/dist/index.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.initContext = exports.initProject = exports.copyClaudeFiles = void 0;
+exports.initContext = exports.initProject = exports.updateClaudeFiles = exports.copyClaudeFiles = void 0;
 var copy_1 = require("./copy");
 Object.defineProperty(exports, "copyClaudeFiles", { enumerable: true, get: function () { return copy_1.copyClaudeFiles; } });
+var update_1 = require("./update");
+Object.defineProperty(exports, "updateClaudeFiles", { enumerable: true, get: function () { return update_1.updateClaudeFiles; } });
 var init_project_1 = require("./init-project");
 Object.defineProperty(exports, "initProject", { enumerable: true, get: function () { return init_project_1.initProject; } });
 var init_context_1 = require("./init-context");

package/dist/metadata.d.ts

@@ -0,0 +1,29 @@
+export interface FileMetadata {
+    hash: string;
+}
+export interface InstalledMetadata {
+    version: string;
+    installedAt: string;
+    files: Record<string, FileMetadata>;
+}
+/**
+ * Get metadata file path for a destination directory
+ */
+export declare function getMetadataPath(destDir: string): string;
+/**
+ * Load installation metadata. Returns null if not found or invalid.
+ */
+export declare function loadMetadata(destDir: string): InstalledMetadata | null;
+/**
+ * Save installation metadata
+ */
+export declare function saveMetadata(destDir: string, metadata: InstalledMetadata): void;
+/**
+ * Build metadata from a list of files in the source directory
+ */
+export declare function buildMetadata(files: string[], sourceDir: string, version: string): InstalledMetadata;
+/**
+ * Merge new file entries into existing metadata.
+ * Existing entries are preserved; new entries override matching keys.
+ */
+export declare function mergeMetadata(existing: InstalledMetadata | null, newFiles: string[], sourceDir: string, version: string): InstalledMetadata;

package/dist/metadata.js

@@ -0,0 +1,112 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMetadataPath = getMetadataPath;
+exports.loadMetadata = loadMetadata;
+exports.saveMetadata = saveMetadata;
+exports.buildMetadata = buildMetadata;
+exports.mergeMetadata = mergeMetadata;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+const METADATA_FILENAME = '.jun-installed.json';
+/**
+ * Compute SHA-256 hash of a file
+ */
+function computeFileHash(filePath) {
+    const content = fs.readFileSync(filePath);
+    return crypto.createHash('sha256').update(content).digest('hex');
+}
+/**
+ * Get metadata file path for a destination directory
+ */
+function getMetadataPath(destDir) {
+    return path.join(destDir, METADATA_FILENAME);
+}
+/**
+ * Load installation metadata. Returns null if not found or invalid.
+ */
+function loadMetadata(destDir) {
+    const metaPath = getMetadataPath(destDir);
+    if (!fs.existsSync(metaPath))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save installation metadata
+ */
+function saveMetadata(destDir, metadata) {
+    const metaPath = getMetadataPath(destDir);
+    fs.writeFileSync(metaPath, JSON.stringify(metadata, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Build metadata from a list of files in the source directory
+ */
+function buildMetadata(files, sourceDir, version) {
+    const fileEntries = {};
+    for (const file of files) {
+        const filePath = path.join(sourceDir, file);
+        if (fs.existsSync(filePath)) {
+            fileEntries[file] = { hash: computeFileHash(filePath) };
+        }
+    }
+    return {
+        version,
+        installedAt: new Date().toISOString(),
+        files: fileEntries,
+    };
+}
+/**
+ * Merge new file entries into existing metadata.
+ * Existing entries are preserved; new entries override matching keys.
+ */
+function mergeMetadata(existing, newFiles, sourceDir, version) {
+    const newMeta = buildMetadata(newFiles, sourceDir, version);
+    if (!existing)
+        return newMeta;
+    return {
+        version,
+        installedAt: new Date().toISOString(),
+        files: {
+            ...existing.files,
+            ...newMeta.files,
+        },
+    };
+}

package/dist/update.d.ts

@@ -0,0 +1,16 @@
+import { InstalledMetadata } from './metadata';
+export type UpdateFileStatus = 'update-available' | 'user-modified' | 'conflict' | 'new-file' | 'unchanged' | 'removed-upstream';
+export interface UpdateOptions {
+    dryRun?: boolean;
+    force?: boolean;
+    project?: boolean;
+}
+/**
+ * Compute 3-way update status for a file.
+ * Compares base (from metadata), current (on disk), and new (from template).
+ */
+export declare function computeUpdateStatus(file: string, sourceDir: string, destDir: string, metadata: InstalledMetadata | null): UpdateFileStatus;
+/**
+ * Update installed templates while preserving user customizations
+ */
+export declare function updateClaudeFiles(options?: UpdateOptions): Promise<void>;