mewkit 1.7.1 → 1.8.0

package/dist/core/merge-settings.js

@@ -0,0 +1,131 @@
+/**
+ * Append-only merge for .claude/settings.json.
+ * Adds new MeowKit hooks/permissions without modifying existing user entries.
+ * Backs up before merge, restores on failure.
+ */
+import { readFileSync, writeFileSync, copyFileSync, existsSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import * as log from "./core-logger.js";
+/**
+ * Merge template settings.json into existing user settings.json.
+ * Strategy: append-only — add new hooks/permissions, never modify existing.
+ * Returns true if merge succeeded, false if skipped or failed.
+ */
+export function mergeSettingsFile(templatePath, destPath, dryRun) {
+    if (!existsSync(templatePath)) {
+        log.debug("Template settings.json not found, skipping merge");
+        return false;
+    }
+    // If dest doesn't exist, just copy
+    if (!existsSync(destPath)) {
+        if (!dryRun) {
+            mkdirSync(dirname(destPath), { recursive: true });
+            copyFileSync(templatePath, destPath);
+        }
+        log.debug("settings.json: fresh copy (no existing file)");
+        return true;
+    }
+    if (dryRun) {
+        log.debug("settings.json: would merge (dry-run)");
+        return true;
+    }
+    // Read both files
+    let userSettings;
+    let templateSettings;
+    try {
+        userSettings = JSON.parse(readFileSync(destPath, "utf-8"));
+    }
+    catch {
+        log.warn("settings.json: invalid JSON in existing file, skipping merge");
+        return false;
+    }
+    try {
+        templateSettings = JSON.parse(readFileSync(templatePath, "utf-8"));
+    }
+    catch {
+        log.warn("settings.json: invalid JSON in template, skipping merge");
+        return false;
+    }
+    // Backup before merge
+    const backupPath = destPath + ".bak";
+    copyFileSync(destPath, backupPath);
+    try {
+        const merged = appendOnlyMerge(userSettings, templateSettings);
+        writeFileSync(destPath, JSON.stringify(merged, null, 2) + "\n", "utf-8");
+        log.debug("settings.json: merged successfully");
+        return true;
+    }
+    catch (err) {
+        // Restore backup on failure
+        copyFileSync(backupPath, destPath);
+        log.warn(`settings.json merge failed, restored backup: ${err instanceof Error ? err.message : String(err)}`);
+        return false;
+    }
+}
+/** Append-only merge: add new template entries to user settings without modifying existing */
+function appendOnlyMerge(user, template) {
+    const result = { ...user };
+    // Copy new top-level keys from template (e.g. statusLine) without overwriting existing
+    for (const key of Object.keys(template)) {
+        if (key !== "hooks" && key !== "permissions" && !(key in result)) {
+            result[key] = template[key];
+        }
+    }
+    // Merge hooks: add new hook matchers that don't exist in user's config
+    if (template.hooks) {
+        if (!result.hooks)
+            result.hooks = {};
+        for (const [event, templateMatchers] of Object.entries(template.hooks)) {
+            if (!result.hooks[event]) {
+                // Entire hook event is new — add it
+                result.hooks[event] = templateMatchers;
+                continue;
+            }
+            // Event exists — add only matchers with commands not already present
+            const userMatchers = result.hooks[event];
+            const userCommands = extractCommandStrings(userMatchers);
+            for (const templateMatcher of templateMatchers) {
+                const newHooks = templateMatcher.hooks.filter((h) => !userCommands.has(normalizeCommand(h.command)));
+                if (newHooks.length > 0) {
+                    // Find existing matcher with same matcher pattern, or create new
+                    const existingMatcher = userMatchers.find((m) => (m.matcher ?? "") === (templateMatcher.matcher ?? ""));
+                    if (existingMatcher) {
+                        existingMatcher.hooks.push(...newHooks);
+                    }
+                    else {
+                        userMatchers.push({ ...templateMatcher, hooks: newHooks });
+                    }
+                }
+            }
+        }
+    }
+    // Merge permissions.allow: union of arrays
+    if (template.permissions?.allow) {
+        if (!result.permissions)
+            result.permissions = {};
+        if (!result.permissions.allow)
+            result.permissions.allow = [];
+        const existingSet = new Set(result.permissions.allow);
+        for (const perm of template.permissions.allow) {
+            if (!existingSet.has(perm)) {
+                result.permissions.allow.push(perm);
+            }
+        }
+    }
+    return result;
+}
+/** Extract all command strings from hook matchers for deduplication */
+function extractCommandStrings(matchers) {
+    const commands = new Set();
+    for (const matcher of matchers) {
+        for (const hook of matcher.hooks) {
+            commands.add(normalizeCommand(hook.command));
+        }
+    }
+    return commands;
+}
+/** Normalize command string for comparison (trim whitespace, collapse spaces) */
+function normalizeCommand(cmd) {
+    return cmd.trim().replace(/\s+/g, " ");
+}
+//# sourceMappingURL=merge-settings.js.map

package/dist/core/merge-settings.js.map

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

package/dist/core/skills-dependencies.d.ts

@@ -0,0 +1,25 @@
+/** Skills dependency config — single source of truth for pip packages */
+export interface SkillsDependency {
+    /** pip package name (as passed to pip install) */
+    name: string;
+    /** Human-readable description for prompt display */
+    description: string;
+}
+/** Default pip packages installed into .claude/skills/.venv */
+export declare const DEFAULT_PIP_PACKAGES: readonly SkillsDependency[];
+/** Extract base package name, stripping version specifiers (e.g. "pillow>=10.0" → "pillow") */
+export declare function getBasePackageName(name: string): string;
+export declare function validatePackageName(name: string): boolean;
+/**
+ * Resolve pip packages to install.
+ * Walks per-skill requirements.txt files, merges and deduplicates.
+ * Falls back to DEFAULT_PIP_PACKAGES if no requirements files found.
+ */
+export declare function getRequirementsSource(projectDir: string): {
+    packages: readonly SkillsDependency[];
+    source: string;
+    rejected: string[];
+};
+/** Format packages for CLI display */
+export declare function formatPackageList(packages: readonly SkillsDependency[]): string;
+//# sourceMappingURL=skills-dependencies.d.ts.map

package/dist/core/skills-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-dependencies.d.ts","sourceRoot":"","sources":["../../src/core/skills-dependencies.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAKzE,MAAM,WAAW,gBAAgB;IAChC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,+DAA+D;AAC/D,eAAO,MAAM,oBAAoB,EAAE,SAAS,gBAAgB,EAIlD,CAAC;AAKX,+FAA+F;AAC/F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGzD;AAsCD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG;IAC1D,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB,CAyBA;AAED,sCAAsC;AACtC,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,CAO/E"}

package/dist/core/skills-dependencies.js

@@ -0,0 +1,100 @@
+/** Skills dependency config — single source of truth for pip packages */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+/** Default pip packages installed into .claude/skills/.venv */
+export const DEFAULT_PIP_PACKAGES = [
+    { name: "google-genai", description: "Gemini API client (mk:multimodal skill)" },
+    { name: "pillow", description: "Image processing (mk:multimodal)" },
+    { name: "python-dotenv", description: "Env var loading (optional — scripts have fallback)" },
+];
+/** Validate pip package name — rejects flags, URLs, shell-breaking chars */
+const SAFE_PKG_RE = /^[a-zA-Z0-9][a-zA-Z0-9._-]*(\[[a-zA-Z0-9,_-]*\])?(==|>=|<=|!=|~=|<|>)?[a-zA-Z0-9.*]*$/;
+/** Extract base package name, stripping version specifiers (e.g. "pillow>=10.0" → "pillow") */
+export function getBasePackageName(name) {
+    return (name.split(/[=<>!~]/)[0] ?? name).toLowerCase();
+}
+export function validatePackageName(name) {
+    if (!name || name.startsWith("-") || name.includes("://"))
+        return false;
+    return SAFE_PKG_RE.test(getBasePackageName(name));
+}
+// Collect per-skill requirements.txt files from .claude/skills/{skill}/scripts/
+function findRequirementsFiles(projectDir) {
+    const skillsDir = join(projectDir, ".claude", "skills");
+    if (!existsSync(skillsDir))
+        return [];
+    const found = [];
+    try {
+        for (const entry of readdirSync(skillsDir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const reqPath = join(skillsDir, entry.name, "scripts", "requirements.txt");
+            if (existsSync(reqPath))
+                found.push(reqPath);
+        }
+    }
+    catch {
+        /* skills dir not readable */
+    }
+    return found;
+}
+/** Parse a single requirements.txt, validating each line */
+function parseRequirementsFile(filePath) {
+    const content = readFileSync(filePath, "utf-8");
+    const lines = content
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l && !l.startsWith("#"));
+    const packages = [];
+    const rejected = [];
+    for (const line of lines) {
+        if (validatePackageName(line)) {
+            packages.push({ name: line, description: "" });
+        }
+        else {
+            rejected.push(line);
+        }
+    }
+    return { packages, rejected };
+}
+/**
+ * Resolve pip packages to install.
+ * Walks per-skill requirements.txt files, merges and deduplicates.
+ * Falls back to DEFAULT_PIP_PACKAGES if no requirements files found.
+ */
+export function getRequirementsSource(projectDir) {
+    const reqFiles = findRequirementsFiles(projectDir);
+    if (reqFiles.length > 0) {
+        const allPackages = [];
+        const allRejected = [];
+        const seen = new Set();
+        for (const filePath of reqFiles) {
+            const { packages, rejected } = parseRequirementsFile(filePath);
+            for (const pkg of packages) {
+                const baseName = getBasePackageName(pkg.name);
+                if (!seen.has(baseName)) {
+                    seen.add(baseName);
+                    allPackages.push(pkg);
+                }
+            }
+            allRejected.push(...rejected);
+        }
+        if (allRejected.length > 0) {
+            console.warn(`  Skipped ${allRejected.length} invalid line(s) across ${reqFiles.length} requirements file(s)`);
+        }
+        if (allPackages.length > 0) {
+            return { packages: allPackages, source: `${reqFiles.length} requirements.txt file(s)`, rejected: allRejected };
+        }
+    }
+    return { packages: DEFAULT_PIP_PACKAGES, source: "built-in defaults", rejected: [] };
+}
+/** Format packages for CLI display */
+export function formatPackageList(packages) {
+    return packages
+        .map((p) => {
+        const desc = p.description ? ` ${p.description}` : "";
+        return `  ${p.name.padEnd(18)}${desc}`;
+    })
+        .join("\n");
+}
+//# sourceMappingURL=skills-dependencies.js.map

package/dist/core/skills-dependencies.js.map

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

package/dist/core/smart-update-utils.d.ts

@@ -0,0 +1,10 @@
+/** Parse .meowkitignore once, return a matcher function */
+export declare function loadIgnorePatterns(targetDir: string): (relPath: string) => boolean;
+/** Recursively collect files from a directory */
+export declare function walkDir(dir: string, base: string): Array<{
+    relPath: string;
+    srcPath: string;
+}>;
+/** Copy a single file, creating parent dirs. Sets executable for hooks/scripts. */
+export declare function copyFile(src: string, dest: string, dryRun: boolean): void;
+//# sourceMappingURL=smart-update-utils.d.ts.map

package/dist/core/smart-update-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-update-utils.d.ts","sourceRoot":"","sources":["../../src/core/smart-update-utils.ts"],"names":[],"mappings":"AAMA,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAmBlF;AAED,iDAAiD;AACjD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB9F;AAED,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAazE"}

package/dist/core/smart-update-utils.js

@@ -0,0 +1,61 @@
+/**
+ * Helper utilities for smart-update: file copying, .meowkitignore parsing, directory walking.
+ */
+import { existsSync, readFileSync, readdirSync, statSync, mkdirSync, copyFileSync, chmodSync } from "node:fs";
+import { join, relative, dirname, basename } from "node:path";
+/** Parse .meowkitignore once, return a matcher function */
+export function loadIgnorePatterns(targetDir) {
+    const ignorePath = join(targetDir, ".meowkitignore");
+    if (!existsSync(ignorePath))
+        return () => false;
+    const patterns = readFileSync(ignorePath, "utf-8")
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l && !l.startsWith("#"));
+    if (patterns.length === 0)
+        return () => false;
+    return (relPath) => {
+        for (const p of patterns) {
+            if (relPath === p)
+                return true;
+            if (p.endsWith("/") && relPath.startsWith(p))
+                return true;
+            if (relPath.startsWith(p + "/"))
+                return true;
+        }
+        return false;
+    };
+}
+/** Recursively collect files from a directory */
+export function walkDir(dir, base) {
+    const results = [];
+    const SKIP = new Set(["__pycache__", "node_modules", ".DS_Store"]);
+    for (const entry of readdirSync(dir)) {
+        if (SKIP.has(entry) || entry.endsWith(".pyc") || entry.endsWith("_INDEX.md") || entry === "SKILLS_ATTRIBUTION.md")
+            continue;
+        const full = join(dir, entry);
+        const stat = statSync(full);
+        if (stat.isDirectory()) {
+            results.push(...walkDir(full, base));
+        }
+        else {
+            results.push({ relPath: relative(base, full), srcPath: full });
+        }
+    }
+    return results;
+}
+/** Copy a single file, creating parent dirs. Sets executable for hooks/scripts. */
+export function copyFile(src, dest, dryRun) {
+    if (dryRun)
+        return;
+    mkdirSync(dirname(dest), { recursive: true });
+    copyFileSync(src, dest);
+    // Use path.basename(path.dirname(...)) rather than splitting on "/" because
+    // Node's path returns platform separators (\ on Windows, / elsewhere).
+    const parent = basename(dirname(dest));
+    const ext = basename(dest).includes(".") ? "." + basename(dest).split(".").pop() : "";
+    if (ext === ".sh" || ext === ".cjs" || parent === "hooks" || parent === "bin") {
+        chmodSync(dest, 0o755);
+    }
+}
+//# sourceMappingURL=smart-update-utils.js.map

package/dist/core/smart-update-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-update-utils.js","sourceRoot":"","sources":["../../src/core/smart-update-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9G,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE9D,2DAA2D;AAC3D,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC;IAEhD,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC;SAChD,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAEzC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC;IAE9C,OAAO,CAAC,OAAe,EAAE,EAAE;QAC1B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YAC1B,IAAI,OAAO,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC/B,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC1D,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC9C,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC,CAAC;AACH,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,IAAY;IAChD,MAAM,OAAO,GAAgD,EAAE,CAAC;IAChE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC;IAEnE,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,KAAK,uBAAuB;YAChH,SAAS;QACV,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC;IACF,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,IAAY,EAAE,MAAe;IAClE,IAAI,MAAM;QAAE,OAAO;IAEnB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAExB,4EAA4E;IAC5E,uEAAuE;IACvE,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QAC/E,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACxB,CAAC;AACF,CAAC"}

package/dist/core/smart-update.d.ts

@@ -0,0 +1,18 @@
+import type { UserConfig } from "./substitute-placeholders.js";
+export interface UpdateStats {
+    updated: number;
+    skipped: number;
+    added: number;
+    userModified: string[];
+}
+/**
+ * Smart update from a downloaded release directory.
+ *
+ * @param config - User configuration (description, API keys, etc.)
+ * @param sourceDir - Path to extracted release (contains .claude/, tasks/, CLAUDE.md)
+ * @param targetDir - User's project directory
+ * @param dryRun - Preview only, no writes
+ * @param force - Overwrite all files, ignore user modifications
+ */
+export declare function smartUpdate(config: UserConfig, sourceDir: string, targetDir: string, dryRun: boolean, force?: boolean): Promise<UpdateStats>;
+//# sourceMappingURL=smart-update.d.ts.map

package/dist/core/smart-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-update.d.ts","sourceRoot":"","sources":["../../src/core/smart-update.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAK/D,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAChC,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,KAAK,UAAQ,GACX,OAAO,CAAC,WAAW,CAAC,CA6LtB"}

package/dist/core/smart-update.js

@@ -0,0 +1,177 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import * as log from "./core-logger.js";
+import { processTemplate } from "./substitute-placeholders.js";
+import { mergeSettingsFile } from "./merge-settings.js";
+import { readManifest, buildManifest, writeManifest, hashFile, classifyLayer } from "./compute-checksums.js";
+import { loadIgnorePatterns, walkDir, copyFile } from "./smart-update-utils.js";
+/**
+ * Smart update from a downloaded release directory.
+ *
+ * @param config - User configuration (description, API keys, etc.)
+ * @param sourceDir - Path to extracted release (contains .claude/, tasks/, CLAUDE.md)
+ * @param targetDir - User's project directory
+ * @param dryRun - Preview only, no writes
+ * @param force - Overwrite all files, ignore user modifications
+ */
+export async function smartUpdate(config, sourceDir, targetDir, dryRun, force = false) {
+    const oldManifest = force ? null : readManifest(join(targetDir, ".claude"));
+    const stats = { updated: 0, skipped: 0, added: 0, userModified: [] };
+    if (!oldManifest && existsSync(join(targetDir, ".claude"))) {
+        log.warn("No manifest found — will treat all existing files as unmodified.");
+    }
+    const oldChecksums = oldManifest?.checksums ?? {};
+    const isIgnored = loadIgnorePatterns(targetDir);
+    // Source .claude/ from downloaded release
+    const claudeSrc = join(sourceDir, ".claude");
+    if (!existsSync(claudeSrc)) {
+        log.error(`Release .claude/ not found at: ${claudeSrc}`);
+        process.exit(1);
+    }
+    // Walk .claude/ files from release
+    const claudeFiles = walkDir(claudeSrc, claudeSrc).map((f) => ({ ...f, relPath: `.claude/${f.relPath}` }));
+    for (const { relPath, srcPath } of claudeFiles) {
+        const destPath = join(targetDir, relPath);
+        const layer = classifyLayer(relPath);
+        if (isIgnored(relPath)) {
+            log.debug(`Ignored (protected): ${relPath}`);
+            stats.skipped++;
+            continue;
+        }
+        // settings.json uses append-only merge
+        if (relPath === ".claude/settings.json") {
+            mergeSettingsFile(srcPath, destPath, dryRun);
+            stats.updated++;
+            continue;
+        }
+        // User layer: never overwrite
+        if (layer === "user") {
+            if (existsSync(destPath)) {
+                log.debug(`Skipped (user layer): ${relPath}`);
+                stats.skipped++;
+            }
+            else {
+                copyFile(srcPath, destPath, dryRun);
+                stats.added++;
+            }
+            continue;
+        }
+        // New file → always add
+        if (!existsSync(destPath)) {
+            copyFile(srcPath, destPath, dryRun);
+            log.debug(`Added (new): ${relPath}`);
+            stats.added++;
+            continue;
+        }
+        // File exists — check if user modified it
+        const currentHash = hashFile(destPath);
+        const manifestEntry = oldChecksums[relPath];
+        if (manifestEntry && currentHash !== manifestEntry.sha256) {
+            log.debug(`Skipped (user-modified): ${relPath}`);
+            stats.userModified.push(relPath);
+            stats.skipped++;
+            continue;
+        }
+        // Safe to overwrite
+        copyFile(srcPath, destPath, dryRun);
+        stats.updated++;
+    }
+    // Copy tasks/ from release
+    const tasksSrc = join(sourceDir, "tasks");
+    if (existsSync(tasksSrc)) {
+        const taskFiles = walkDir(tasksSrc, tasksSrc).map((f) => ({ ...f, relPath: `tasks/${f.relPath}` }));
+        for (const { relPath, srcPath: tSrc } of taskFiles) {
+            const tDest = join(targetDir, relPath);
+            if (!existsSync(tDest)) {
+                copyFile(tSrc, tDest, dryRun);
+                stats.added++;
+            }
+        }
+        if (!dryRun) {
+            for (const dir of ["tasks/active", "tasks/completed", "tasks/backlog", "tasks/guidelines"]) {
+                mkdirSync(join(targetDir, dir), { recursive: true });
+            }
+        }
+    }
+    const claudeDir = join(targetDir, ".claude");
+    // CLAUDE.md at project root
+    const claudeMdSrc = join(sourceDir, "CLAUDE.md");
+    const claudeMdDest = join(targetDir, "CLAUDE.md");
+    if (existsSync(claudeMdSrc) && !existsSync(claudeMdDest)) {
+        processTemplate(claudeMdSrc, claudeMdDest, config, dryRun);
+        stats.added++;
+    }
+    // meowkit.config.json template (generated, not from release)
+    const configDest = join(claudeDir, "meowkit.config.json");
+    if (!existsSync(configDest)) {
+        if (!dryRun) {
+            mkdirSync(claudeDir, { recursive: true });
+            const configContent = JSON.stringify({
+                $schema: "https://meowkit.dev/schema/config.json",
+                version: "1.0.0",
+                project: { description: config.description || "" },
+                features: { costTracking: config.enableCostTracking, memory: config.enableMemory },
+            }, null, 2);
+            writeFileSync(configDest, configContent + "\n", "utf-8");
+        }
+        stats.added++;
+    }
+    // Write .env with API keys (single read-modify-write cycle)
+    const envPath = join(claudeDir, ".env");
+    const hasNewKeys = config.geminiApiKey || config.externalProviderKeys;
+    if (hasNewKeys) {
+        let envContent = existsSync(envPath)
+            ? readFileSync(envPath, "utf-8")
+            : "# MeowKit environment variables\n# Never commit this file to git.\n\n";
+        if (config.geminiApiKey && !envContent.includes("MEOWKIT_GEMINI_API_KEY=")) {
+            envContent += `MEOWKIT_GEMINI_API_KEY=${config.geminiApiKey}\n`;
+        }
+        // Legacy migration: if GEMINI_API_KEY exists but MEOWKIT_ doesn't, add it
+        if (!config.geminiApiKey &&
+            envContent.includes("GEMINI_API_KEY=") &&
+            !envContent.includes("MEOWKIT_GEMINI_API_KEY=")) {
+            const match = envContent.match(/^GEMINI_API_KEY=(.+)$/m);
+            if (match?.[1]?.trim()) {
+                envContent += `MEOWKIT_GEMINI_API_KEY=${match[1].trim()}\n`;
+            }
+        }
+        if (config.externalProviderKeys) {
+            for (const [envVar, value] of Object.entries(config.externalProviderKeys)) {
+                if (!envContent.includes(`${envVar}=`)) {
+                    envContent += `${envVar}=${value}\n`;
+                }
+            }
+        }
+        if (!dryRun) {
+            writeFileSync(envPath, envContent, "utf-8");
+        }
+        stats.added++;
+        // Ensure .gitignore covers .claude/.env (prevents accidental commits)
+        const gitignorePath = join(targetDir, ".gitignore");
+        if (!dryRun) {
+            let gitignoreContent = existsSync(gitignorePath) ? readFileSync(gitignorePath, "utf-8") : "";
+            if (!gitignoreContent.includes(".claude/.env")) {
+                gitignoreContent += "\n# MeowKit secrets\n.claude/.env\n";
+                writeFileSync(gitignorePath, gitignoreContent, "utf-8");
+            }
+        }
+    }
+    // Ensure memory + logs dirs exist
+    if (!dryRun) {
+        mkdirSync(join(targetDir, ".claude", "memory"), { recursive: true });
+        mkdirSync(join(targetDir, ".claude", "logs"), { recursive: true });
+    }
+    // Write manifest
+    if (!dryRun) {
+        const newManifest = buildManifest(claudeDir);
+        writeManifest(claudeDir, newManifest);
+    }
+    log.setData("update", {
+        updated: stats.updated,
+        skipped: stats.skipped,
+        added: stats.added,
+        userModified: stats.userModified,
+    });
+    return stats;
+}
+//# sourceMappingURL=smart-update.js.map

package/dist/core/smart-update.js.map

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

package/dist/core/substitute-placeholders.d.ts

@@ -0,0 +1,11 @@
+/** User configuration for template substitution */
+export interface UserConfig {
+    description: string;
+    enableCostTracking: boolean;
+    enableMemory: boolean;
+    geminiApiKey: string | null;
+    externalProviderKeys?: Record<string, string>;
+}
+/** Process a .template file: substitute placeholders, write to destPath */
+export declare function processTemplate(templatePath: string, destPath: string, config: UserConfig, dryRun: boolean): void;
+//# sourceMappingURL=substitute-placeholders.d.ts.map

package/dist/core/substitute-placeholders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"substitute-placeholders.d.ts","sourceRoot":"","sources":["../../src/core/substitute-placeholders.ts"],"names":[],"mappings":"AAIA,mDAAmD;AACnD,MAAM,WAAW,UAAU;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAcD,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAejH"}

package/dist/core/substitute-placeholders.js

@@ -0,0 +1,28 @@
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import pc from "picocolors";
+const PREFIX = "__MEOWKIT_";
+const SUFFIX = "__";
+/** Builds placeholder → value map from user config */
+function buildReplacements(config) {
+    return {
+        [`${PREFIX}DESCRIPTION${SUFFIX}`]: config.description || "",
+        [`${PREFIX}COST_TRACKING${SUFFIX}`]: String(config.enableCostTracking),
+        [`${PREFIX}MEMORY_ENABLED${SUFFIX}`]: String(config.enableMemory),
+    };
+}
+/** Process a .template file: substitute placeholders, write to destPath */
+export function processTemplate(templatePath, destPath, config, dryRun) {
+    if (dryRun) {
+        console.log(`  ${pc.dim("create")} ${destPath}`);
+        return;
+    }
+    let content = readFileSync(templatePath, "utf-8");
+    const replacements = buildReplacements(config);
+    for (const [key, value] of Object.entries(replacements)) {
+        content = content.replaceAll(key, value);
+    }
+    mkdirSync(dirname(destPath), { recursive: true });
+    writeFileSync(destPath, content, "utf-8");
+}
+//# sourceMappingURL=substitute-placeholders.js.map

package/dist/core/substitute-placeholders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"substitute-placeholders.js","sourceRoot":"","sources":["../../src/core/substitute-placeholders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,YAAY,CAAC;AAW5B,MAAM,MAAM,GAAG,YAAY,CAAC;AAC5B,MAAM,MAAM,GAAG,IAAI,CAAC;AAEpB,sDAAsD;AACtD,SAAS,iBAAiB,CAAC,MAAkB;IAC5C,OAAO;QACN,CAAC,GAAG,MAAM,cAAc,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;QAC3D,CAAC,GAAG,MAAM,gBAAgB,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC;QACtE,CAAC,GAAG,MAAM,iBAAiB,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;KACjE,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAAC,YAAoB,EAAE,QAAgB,EAAE,MAAkB,EAAE,MAAe;IAC1G,IAAI,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;QACjD,OAAO;IACR,CAAC;IAED,IAAI,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACzD,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/dist/core/validate-install.d.ts

@@ -0,0 +1,6 @@
+export interface ValidationResult {
+    valid: boolean;
+    issues: string[];
+}
+export declare function validate(targetDir: string): ValidationResult;
+//# sourceMappingURL=validate-install.d.ts.map

package/dist/core/validate-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-install.d.ts","sourceRoot":"","sources":["../../src/core/validate-install.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAsCD,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAiE5D"}