mewkit 1.0.1 → 1.4.0

package/README.md

@@ -47,7 +47,7 @@ npx mewkit memory --clear       # Reset memory
 
 ## Related
 
-- [create-meowkit](https://www.npmjs.com/package/create-meowkit) — Scaffold CLI (`npm create meowkit@latest`)
+- [create-meowkit](https://www.npmjs.com/package/create-meowkit) — Scaffold CLI (deprecated; use `npx mewkit init`)
 - [GitHub](https://github.com/ngocsangyem/MeowKit)
 
 ## License

package/dist/commands/init.d.ts

@@ -0,0 +1,7 @@
+export interface InitArgs {
+    dryRun?: boolean;
+    force?: boolean;
+    beta?: boolean;
+}
+export declare function init(args: InitArgs): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAgFD,wBAAsB,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAmGxD"}

package/dist/commands/init.js

@@ -0,0 +1,176 @@
+import fs from "node:fs";
+import { join } from "node:path";
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import { fetchReleases, downloadRelease, cleanupDownload, smartUpdate, validate, } from "../core/index.js";
+/** Detect if this is a fresh install or an update */
+function detectMode(targetDir) {
+    return fs.existsSync(join(targetDir, ".claude")) ? "update" : "new";
+}
+/** Build @clack/prompts options from release list */
+function buildReleaseOptions(releases, beta) {
+    const latestStable = releases.find((r) => !r.isBeta);
+    const pool = beta ? releases : releases.filter((r) => !r.isBeta);
+    return pool.slice(0, 10).map((r) => ({
+        value: r.tag,
+        label: `${r.version}${r.isBeta ? pc.yellow(" (beta)") : ""}${r.tag === latestStable?.tag ? pc.green(" (latest)") : ""}`,
+        hint: r.publishedAt.split("T")[0],
+    }));
+}
+/** Cancel-safe wrapper: exits on Ctrl+C */
+function cancelCheck(value) {
+    if (p.isCancel(value)) {
+        p.cancel("Installation cancelled.");
+        process.exit(0);
+    }
+}
+/** Prompt the user for project description + optional Gemini API key */
+async function promptNewInstall() {
+    const description = await p.text({
+        message: "Describe your project (optional)",
+        placeholder: "Press Enter to skip",
+        validate() { return undefined; },
+    });
+    cancelCheck(description);
+    const addGeminiKey = await p.confirm({
+        message: "Add Gemini API key? (for image/video/audio analysis)",
+        initialValue: false,
+    });
+    cancelCheck(addGeminiKey);
+    let geminiApiKey = null;
+    if (addGeminiKey) {
+        const keyInput = await p.text({
+            message: "Enter your Gemini API key",
+            placeholder: "Get one at aistudio.google.com/apikey",
+            validate(value) {
+                if (!value || value.trim().length === 0)
+                    return "API key is required";
+                if (value.trim().length < 10)
+                    return "Key too short — check aistudio.google.com/apikey";
+                return undefined;
+            },
+        });
+        cancelCheck(keyInput);
+        geminiApiKey = typeof keyInput === "string" ? keyInput.trim() : null;
+        if (geminiApiKey)
+            p.log.success("Gemini API key will be saved to .claude/.env");
+    }
+    return {
+        description: typeof description === "string" ? description.trim() : "",
+        enableCostTracking: true,
+        enableMemory: true,
+        geminiApiKey,
+    };
+}
+/** Print install/update summary */
+function printSummary(stats, dryRun) {
+    console.log(`\n${pc.bold("Summary:")}`);
+    if (stats.added > 0)
+        console.log(`  ${pc.green("added")}     ${stats.added}`);
+    if (stats.updated > 0)
+        console.log(`  ${pc.cyan("updated")}   ${stats.updated}`);
+    if (stats.skipped > 0)
+        console.log(`  ${pc.dim("skipped")}   ${stats.skipped}`);
+    if (stats.userModified.length > 0) {
+        console.log(pc.yellow(`\n  ${stats.userModified.length} user-modified file(s) preserved:`));
+        stats.userModified.slice(0, 8).forEach((f) => console.log(`    ${pc.dim(f)}`));
+        if (stats.userModified.length > 8)
+            console.log(`    ${pc.dim(`...and ${stats.userModified.length - 8} more`)}`);
+    }
+    if (!dryRun) {
+        console.log(`\n${pc.bold("Next steps:")}`);
+        console.log(`  ${pc.dim("1.")} Run ${pc.bold("npx mewkit setup")} for guided configuration`);
+        console.log(`  ${pc.dim("2.")} Run ${pc.bold("npx mewkit doctor")} to verify your environment`);
+    }
+}
+export async function init(args) {
+    const targetDir = process.cwd();
+    const mode = detectMode(targetDir);
+    const dryRun = args.dryRun ?? false;
+    const force = args.force ?? false;
+    p.intro(pc.bgCyan(pc.black(" meowkit init ")));
+    if (dryRun)
+        p.log.warn("Dry-run mode — no files will be written.");
+    if (mode === "update")
+        p.log.info("Existing .claude/ detected — running in update mode.");
+    // Step 1: Fetch releases
+    const releaseSpinner = p.spinner();
+    releaseSpinner.start("Fetching available releases...");
+    let releases;
+    try {
+        releases = await fetchReleases();
+    }
+    catch (err) {
+        releaseSpinner.stop("Failed to fetch releases");
+        const msg = err instanceof Error ? err.message : String(err);
+        p.cancel(`Cannot fetch releases from GitHub: ${msg}`);
+        process.exit(1);
+    }
+    if (releases.length === 0) {
+        releaseSpinner.stop("No releases found");
+        p.cancel("No releases available on GitHub.");
+        process.exit(1);
+    }
+    releaseSpinner.stop(`Found ${releases.length} release(s)`);
+    // Step 2: Version picker
+    const options = buildReleaseOptions(releases, args.beta ?? false);
+    const latestStable = releases.find((r) => !r.isBeta);
+    const selected = await p.select({
+        message: "Select MeowKit version to install",
+        options,
+        initialValue: latestStable?.tag ?? releases[0].tag,
+    });
+    if (p.isCancel(selected)) {
+        p.cancel("Installation cancelled.");
+        process.exit(0);
+    }
+    const release = releases.find((r) => r.tag === selected);
+    // Step 3: Config prompts (new installs only)
+    let config;
+    if (mode === "new") {
+        config = await promptNewInstall();
+    }
+    else {
+        config = { description: "", enableCostTracking: true, enableMemory: true, geminiApiKey: null };
+    }
+    // Step 4: Download release
+    const downloadSpinner = p.spinner();
+    downloadSpinner.start(`Downloading v${release.version}...`);
+    let sourceDir;
+    try {
+        sourceDir = await downloadRelease(release);
+    }
+    catch (err) {
+        downloadSpinner.stop("Download failed");
+        const msg = err instanceof Error ? err.message : String(err);
+        p.cancel(`Failed to download release: ${msg}`);
+        process.exit(1);
+    }
+    downloadSpinner.stop(`Downloaded v${release.version}`);
+    try {
+        // Step 5: Apply via smart update
+        const updateSpinner = p.spinner();
+        updateSpinner.start("Applying files...");
+        const stats = await smartUpdate(config, sourceDir, targetDir, dryRun, force);
+        updateSpinner.stop(`Applied: ${stats.added} added, ${stats.updated} updated, ${stats.skipped} skipped`);
+        // Step 6: Validate (skip dry-run)
+        if (!dryRun) {
+            const validateSpinner = p.spinner();
+            validateSpinner.start("Validating installation...");
+            const result = validate(targetDir);
+            if (result.valid) {
+                validateSpinner.stop("Validation passed");
+            }
+            else {
+                validateSpinner.stop(`Validation: ${result.issues.length} issue(s) — run \`mewkit validate\` for details`);
+            }
+        }
+        // Step 7: Summary
+        printSummary(stats, dryRun);
+        p.outro(pc.green(mode === "new" ? "MeowKit installed!" : "MeowKit updated!"));
+    }
+    finally {
+        cleanupDownload(sourceDir);
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/upgrade.d.ts

@@ -1,8 +1,7 @@
-interface UpgradeArgs {
+export interface UpgradeArgs {
     check?: boolean;
     beta?: boolean;
     list?: boolean;
 }
 export declare function upgrade(args: UpgradeArgs): Promise<void>;
-export {};
 //# sourceMappingURL=upgrade.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAYA,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAgCD,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA0F9D"}
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAmID,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B9D"}

package/dist/commands/upgrade.js

@@ -1,108 +1,142 @@
-import { execSync } from "node:child_process";
+import fs from "node:fs";
+import { join } from "node:path";
 import pc from "picocolors";
+import { fetchReleases, downloadRelease, cleanupDownload, smartUpdate, } from "../core/index.js";
+/** Read installed version from .claude/metadata.json (instant, no npx) */
 function getLocalVersion() {
     try {
-        // Check version via npx — no global install required
-        const output = execSync("npx --yes create-meowkit --version 2>/dev/null", {
-            encoding: "utf-8",
-            timeout: 15000,
-        });
-        return output.trim() || null;
+        const raw = fs.readFileSync(join(process.cwd(), ".claude", "metadata.json"), "utf-8");
+        const meta = JSON.parse(raw);
+        return meta.version ?? null;
     }
     catch {
         return null;
     }
 }
-async function fetchVersion(tag) {
-    const response = await fetch(`https://registry.npmjs.org/create-meowkit/${tag}`);
-    if (!response.ok) {
-        throw new Error(`Failed to fetch ${tag} from npm registry: ${response.statusText}`);
-    }
-    const data = (await response.json());
-    return data.version;
+/** Format a date string as YYYY-MM-DD */
+function formatDate(iso) {
+    return iso.split("T")[0];
 }
-async function fetchRegistryInfo() {
-    const response = await fetch("https://registry.npmjs.org/create-meowkit");
-    if (!response.ok) {
-        throw new Error(`Failed to fetch from npm registry: ${response.statusText}`);
+/** Show available releases fetched from GitHub */
+async function listReleases(localVersion) {
+    console.log(pc.dim("Fetching available releases from GitHub..."));
+    const releases = await fetchReleases();
+    const stable = releases.filter((r) => !r.isBeta);
+    const beta = releases.filter((r) => r.isBeta);
+    console.log();
+    console.log(pc.bold("Channels:"));
+    console.log(`  ${pc.green("stable:")}  ${stable[0]?.version ?? "none"}`);
+    if (beta.length > 0) {
+        console.log(`  ${pc.yellow("beta:")}    ${beta[0]?.version ?? "none"}`);
+    }
+    console.log();
+    console.log(pc.bold("Recent releases:"));
+    for (const r of releases.slice(0, 10)) {
+        const installed = r.version === localVersion ? pc.cyan(" (installed)") : "";
+        const label = r.isBeta ? pc.yellow(" (beta)") : "";
+        console.log(`  ${r.version}${label}${installed}  ${pc.dim(formatDate(r.publishedAt))}`);
     }
-    return (await response.json());
 }
-export async function upgrade(args) {
-    const localVersion = getLocalVersion();
-    const isBeta = localVersion?.includes("-beta") || localVersion?.includes("-rc");
-    console.log(`${pc.bold("Current version:")} ${localVersion ? pc.cyan(localVersion) : pc.dim("not installed")}${isBeta ? pc.dim(" (beta)") : ""}`);
-    // List available versions
-    if (args.list) {
-        console.log(pc.dim("Fetching available versions..."));
-        try {
-            const info = await fetchRegistryInfo();
-            const tags = info["dist-tags"];
-            const versions = Object.keys(info.versions).reverse().slice(0, 10);
-            console.log();
-            console.log(pc.bold("Channels:"));
-            console.log(`  ${pc.green("stable:")}  ${tags.latest ?? "none"}`);
-            if (tags.beta) {
-                console.log(`  ${pc.yellow("beta:")}    ${tags.beta}`);
-            }
-            console.log();
-            console.log(pc.bold("Recent versions:"));
-            for (const v of versions) {
-                const marker = v === localVersion ? pc.cyan(" (installed)") : "";
-                console.log(`  ${v}${marker}`);
-            }
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            console.error(pc.red(`Failed to list versions: ${message}`));
-        }
+/** Compare local vs latest GitHub release */
+async function checkVersion(localVersion, useBeta) {
+    console.log(pc.dim("Checking for updates..."));
+    const releases = await fetchReleases();
+    const latestStable = releases.find((r) => !r.isBeta);
+    const latestBeta = releases.find((r) => r.isBeta);
+    console.log(`${pc.bold("Local version:")}   ${localVersion ? pc.cyan(localVersion) : pc.dim("not installed")}`);
+    if (latestStable) {
+        console.log(`${pc.bold("Latest stable:")}   ${pc.green(latestStable.version)}  ${pc.dim(formatDate(latestStable.publishedAt))}`);
+    }
+    if (latestBeta) {
+        console.log(`${pc.bold("Latest beta:")}     ${pc.yellow(latestBeta.version)}  ${pc.dim(formatDate(latestBeta.publishedAt))}`);
+    }
+    const compareTo = useBeta ? (latestBeta ?? latestStable) : latestStable;
+    if (!compareTo) {
+        console.log(pc.yellow("No releases found on GitHub."));
         return;
     }
-    // Check for updates
-    if (args.check) {
-        console.log(pc.dim("Checking for updates..."));
-        try {
-            const latest = await fetchVersion("latest");
-            console.log(`${pc.bold("Latest stable:")}  ${pc.green(latest)}`);
-            try {
-                const beta = await fetchVersion("beta");
-                console.log(`${pc.bold("Latest beta:")}    ${pc.yellow(beta)}`);
-            }
-            catch {
-                // No beta published yet — skip
-            }
-            if (localVersion === latest) {
-                console.log(pc.green("You are on the latest stable version."));
-            }
-            else {
-                console.log(pc.yellow(`Update available: ${localVersion ?? "none"} -> ${latest}`));
-                console.log(pc.dim("Run `npx mewkit upgrade` to install."));
-            }
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            console.error(pc.red(`Failed to check for updates: ${message}`));
-        }
+    if (localVersion === compareTo.version) {
+        console.log(pc.green("\nAlready up to date."));
+    }
+    else {
+        console.log(pc.yellow(`\nUpdate available: ${localVersion ?? "none"} → ${compareTo.version}`));
+        console.log(pc.dim("Run `npx mewkit upgrade` to install."));
+    }
+}
+/** Perform the upgrade: download latest release and apply via smart update */
+async function performUpgrade(localVersion, useBeta) {
+    console.log(pc.dim("Fetching latest release from GitHub..."));
+    const releases = await fetchReleases();
+    const latest = useBeta
+        ? (releases.find((r) => r.isBeta) ?? releases.find((r) => !r.isBeta))
+        : releases.find((r) => !r.isBeta);
+    if (!latest) {
+        console.error(pc.red("No releases found on GitHub."));
+        process.exit(1);
+    }
+    if (localVersion === latest.version) {
+        console.log(pc.green(`Already up to date (v${latest.version}).`));
         return;
     }
-    // Perform upgrade via npx (no global install)
-    const tag = args.beta ? "beta" : "latest";
-    const pkg = `create-meowkit@${tag}`;
-    console.log(pc.dim(`Running ${pkg} via npx...`));
+    console.log(`Upgrading: ${pc.dim(localVersion ?? "none")} → ${pc.cyan(latest.version)}`);
+    console.log(pc.dim(`Downloading v${latest.version}...`));
+    let sourceDir;
     try {
-        execSync(`npx --yes ${pkg}`, {
-            encoding: "utf-8",
-            stdio: "inherit",
-        });
-        const newVersion = getLocalVersion();
+        sourceDir = await downloadRelease(latest);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(pc.red(`Download failed: ${msg}`));
+        process.exit(1);
+    }
+    try {
+        const config = {
+            description: "",
+            enableCostTracking: true,
+            enableMemory: true,
+            geminiApiKey: null,
+        };
+        const stats = await smartUpdate(config, sourceDir, process.cwd(), /* dryRun */ false, /* force */ false);
         console.log();
         console.log(pc.green(pc.bold("Upgrade complete!")));
         console.log(`  ${pc.dim("Before:")} ${localVersion ?? "not installed"}`);
-        console.log(`  ${pc.dim("After:")}  ${newVersion ?? "unknown"}`);
+        console.log(`  ${pc.dim("After:")}  ${latest.version}`);
+        console.log();
+        console.log(`  ${pc.green("added")}   ${stats.added}`);
+        console.log(`  ${pc.cyan("updated")} ${stats.updated}`);
+        console.log(`  ${pc.dim("skipped")} ${stats.skipped}`);
+        if (stats.userModified.length > 0) {
+            console.log(pc.yellow(`\n  ${stats.userModified.length} user-modified file(s) preserved (use --force to overwrite).`));
+        }
+    }
+    finally {
+        cleanupDownload(sourceDir);
+    }
+}
+export async function upgrade(args) {
+    const localVersion = getLocalVersion();
+    const useBeta = args.beta ?? false;
+    if (localVersion) {
+        const isBeta = localVersion.includes("-beta") || localVersion.includes("-rc");
+        console.log(`${pc.bold("Current version:")} ${pc.cyan(localVersion)}${isBeta ? pc.dim(" (beta)") : ""}`);
+    }
+    else {
+        console.log(`${pc.bold("Current version:")} ${pc.dim("not installed")}`);
+    }
+    try {
+        if (args.list) {
+            await listReleases(localVersion);
+            return;
+        }
+        if (args.check) {
+            await checkVersion(localVersion, useBeta);
+            return;
+        }
+        await performUpgrade(localVersion, useBeta);
     }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(pc.red(`Upgrade failed: ${message}`));
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(pc.red(`upgrade failed: ${msg}`));
         process.exit(1);
     }
 }

package/dist/commands/upgrade.js.map

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

package/dist/core/compute-checksums.d.ts

@@ -0,0 +1,25 @@
+/** File layer determines update behavior */
+export type FileLayer = "core" | "skill" | "user";
+export interface ManifestEntry {
+    sha256: string;
+    layer: FileLayer;
+}
+export interface Manifest {
+    version: string;
+    generatedAt: string;
+    checksums: Record<string, ManifestEntry>;
+}
+/** Compute SHA-256 hash of a file */
+export declare function hashFile(filePath: string): string;
+/** Determine the layer of a file based on its path relative to the project root */
+export declare function classifyLayer(relativePath: string): FileLayer;
+/**
+ * Build a manifest by scanning all files in the .claude/ directory.
+ * All MeowKit files live inside .claude/ — no root-level scanning.
+ */
+export declare function buildManifest(claudeDir: string): Manifest;
+/** Write manifest to disk */
+export declare function writeManifest(targetDir: string, manifest: Manifest): void;
+/** Read existing manifest from disk. Returns null if not found or invalid. */
+export declare function readManifest(targetDir: string): Manifest | null;
+//# sourceMappingURL=compute-checksums.d.ts.map

package/dist/core/compute-checksums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-checksums.d.ts","sourceRoot":"","sources":["../../src/core/compute-checksums.ts"],"names":[],"mappings":"AAIA,4CAA4C;AAC5C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC1C;AAsBD,qCAAqC;AACrC,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAe7D;AA0BD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAkBzD;AAED,6BAA6B;AAC7B,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAGzE;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAQ/D"}

package/dist/core/compute-checksums.js

@@ -0,0 +1,105 @@
+import { createHash } from "node:crypto";
+import { readFileSync, writeFileSync, existsSync, readdirSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+const MANIFEST_FILENAME = "meowkit.manifest.json";
+/** Directories classified as "core" — overwritten on update if unchanged */
+const CORE_DIRS = new Set(["agents", "commands", "hooks", "modes", "rules", "scripts"]);
+/** Files classified as "user" — never overwritten */
+const USER_FILES = new Set([
+    "CLAUDE.md",
+    "meowkit.config.json",
+    ".env",
+    "env.example",
+    "mcp.json.example",
+    "mcp.json",
+    "gitignore.meowkit",
+    "meowkit.manifest.json",
+]);
+/** Directories classified as "user" — never overwritten */
+const USER_DIRS = new Set(["memory", "logs"]);
+/** Compute SHA-256 hash of a file */
+export function hashFile(filePath) {
+    const content = readFileSync(filePath);
+    return createHash("sha256").update(content).digest("hex");
+}
+/** Determine the layer of a file based on its path relative to the project root */
+export function classifyLayer(relativePath) {
+    // User-level files at project root
+    const basename = relativePath.split("/").pop() ?? "";
+    if (USER_FILES.has(basename) || USER_FILES.has(relativePath))
+        return "user";
+    // Check path segments for directory-based classification
+    const parts = relativePath.split("/");
+    const topDir = parts[0];
+    if (USER_DIRS.has(topDir))
+        return "user";
+    if (topDir === "skills")
+        return "skill";
+    if (CORE_DIRS.has(topDir))
+        return "core";
+    if (topDir === "settings.json")
+        return "core";
+    return "user";
+}
+/**
+ * Recursively collect all files in a directory, returning paths relative to baseDir.
+ * Skips __pycache__, node_modules, .DS_Store, .meowkit.manifest.json.
+ */
+function collectFiles(dir, baseDir) {
+    const files = [];
+    if (!existsSync(dir))
+        return files;
+    const SKIP = new Set(["__pycache__", "node_modules", ".DS_Store", MANIFEST_FILENAME]);
+    const entries = readdirSync(dir);
+    for (const entry of entries) {
+        if (SKIP.has(entry))
+            continue;
+        const fullPath = join(dir, entry);
+        const stat = statSync(fullPath);
+        if (stat.isDirectory()) {
+            files.push(...collectFiles(fullPath, baseDir));
+        }
+        else {
+            files.push(relative(baseDir, fullPath));
+        }
+    }
+    return files;
+}
+/**
+ * Build a manifest by scanning all files in the .claude/ directory.
+ * All MeowKit files live inside .claude/ — no root-level scanning.
+ */
+export function buildManifest(claudeDir) {
+    const checksums = {};
+    const files = collectFiles(claudeDir, claudeDir);
+    for (const relPath of files) {
+        const fullPath = join(claudeDir, relPath);
+        checksums[relPath] = {
+            sha256: hashFile(fullPath),
+            layer: classifyLayer(relPath),
+        };
+    }
+    return {
+        version: "0.1.0",
+        generatedAt: new Date().toISOString(),
+        checksums,
+    };
+}
+/** Write manifest to disk */
+export function writeManifest(targetDir, manifest) {
+    const path = join(targetDir, MANIFEST_FILENAME);
+    writeFileSync(path, JSON.stringify(manifest, null, 2) + "\n", "utf-8");
+}
+/** Read existing manifest from disk. Returns null if not found or invalid. */
+export function readManifest(targetDir) {
+    const path = join(targetDir, MANIFEST_FILENAME);
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=compute-checksums.js.map