@lumy-pack/syncpoint 0.0.2 → 0.0.4

package/README.md

@@ -313,12 +313,12 @@ npx @lumy-pack/syncpoint restore --dry-run
 
 ---
 
-### `syncpoint provision <template> [options]`
+### `syncpoint provision [template] [options]`
 
 Run template-based machine provisioning to install software and configure your system.
 
 **What it does:**
-1. Loads template YAML from `~/.syncpoint/templates/`
+1. Loads template YAML from `~/.syncpoint/templates/` (by name) or from a custom path (with `--file`)
 2. Validates template structure and security
 3. Checks for sudo requirement (prompts if needed)
 4. Executes steps sequentially with real-time progress
@@ -330,22 +330,38 @@ Run template-based machine provisioning to install software and configure your s
 
 | Option | Description |
 |--------|-------------|
+| `-f, --file <path>` | Path to template file (alternative to template name) |
 | `--dry-run` | Show execution plan without running commands |
 | `--skip-restore` | Skip automatic config restore after provisioning |
 
 **Usage:**
 
 ```bash
-# Run provisioning template
+# Run provisioning template by name
 npx @lumy-pack/syncpoint provision my-setup
 
+# Run template from custom path
+npx @lumy-pack/syncpoint provision --file ./my-template.yml
+
+# Use short flag with relative path
+npx @lumy-pack/syncpoint provision -f ~/templates/custom.yaml
+
 # Preview template execution
 npx @lumy-pack/syncpoint provision my-setup --dry-run
 
 # Provision without restoring configs
 npx @lumy-pack/syncpoint provision my-setup --skip-restore
+
+# Combine --file with other options
+npx @lumy-pack/syncpoint provision -f ./template.yml --dry-run --skip-restore
 ```
 
+**Path Resolution:**
+- Supports absolute paths: `/path/to/template.yml`
+- Supports relative paths: `./template.yml`, `../templates/setup.yaml`
+- Supports tilde expansion: `~/templates/custom.yml`
+- Must have `.yml` or `.yaml` extension
+
 **Security:**
 - Blocks dangerous remote script patterns (`curl | bash`, `wget | sh`)
 - Sanitizes error output to mask sensitive paths and credentials
@@ -616,14 +632,20 @@ steps:
 ### Running Templates
 
 ```bash
+# Run template by name (from ~/.syncpoint/templates/)
+npx @lumy-pack/syncpoint provision dev-setup
+
+# Run template from custom path
+npx @lumy-pack/syncpoint provision --file ./my-template.yml
+
 # Preview template execution
 npx @lumy-pack/syncpoint provision dev-setup --dry-run
 
-# Run template
-npx @lumy-pack/syncpoint provision dev-setup
-
 # Run and skip config restore
 npx @lumy-pack/syncpoint provision dev-setup --skip-restore
+
+# Combine custom path with options
+npx @lumy-pack/syncpoint provision -f ~/templates/setup.yaml --dry-run
 ```
 
 ---

package/assets/config.default.yml

@@ -25,6 +25,10 @@ backup:
   exclude:
     - "**/*.swp"
     - "**/.DS_Store"
+    - "**/.Trash/**"
+    - "**/Library/**"
+    - "**/.cache/**"
+    - "**/node_modules/**"
     # Example regex: "/\\.bak$/" (excludes all .bak files)
 
   # (Required) Backup archive filename pattern.

package/dist/cli.mjs

@@ -193,7 +193,7 @@ function generateFilename(pattern, options) {
 import { appendFile, mkdir as mkdir2 } from "fs/promises";
 import { join as join3 } from "path";
 import pc from "picocolors";
-var ANSI_RE = /\x1b\[[0-9;]*m/g;
+var ANSI_RE = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, "g");
 function stripAnsi(str) {
   return str.replace(ANSI_RE, "");
 }
@@ -334,7 +334,7 @@ function isValidPattern(pattern) {
 
 // src/core/metadata.ts
 import { createHash } from "crypto";
-import { lstat, readFile } from "fs/promises";
+import { lstat, readFile, readlink } from "fs/promises";
 
 // src/schemas/ajv.ts
 import Ajv from "ajv";
@@ -426,7 +426,7 @@ function validateMetadata(data) {
 }
 
 // src/version.ts
-var VERSION = "0.0.2";
+var VERSION = "0.0.4";
 
 // src/core/metadata.ts
 var METADATA_VERSION = "1.0.0";
@@ -477,7 +477,8 @@ async function collectFileInfo(absolutePath, logicalPath) {
   }
   let hash;
   if (lstats.isSymbolicLink()) {
-    hash = `sha256:${createHash("sha256").update(absolutePath).digest("hex")}`;
+    const linkTarget = await readlink(absolutePath);
+    hash = `sha256:${createHash("sha256").update(linkTarget).digest("hex")}`;
   } else {
     hash = await computeFileHash(absolutePath);
   }
@@ -538,7 +539,8 @@ async function extractArchive(archivePath, destDir) {
       const normalizedPath = normalize2(path);
       if (normalizedPath.includes("..")) return false;
       if (normalizedPath.startsWith("/")) return false;
-      if (entry.type === "SymbolicLink" || entry.type === "Link") return false;
+      if ("type" in entry && (entry.type === "SymbolicLink" || entry.type === "Link"))
+        return false;
       return true;
     }
   });
@@ -594,8 +596,18 @@ async function scanTargets(config) {
           dot: true,
           absolute: true,
           onlyFiles: true,
-          deep: 5
+          deep: 5,
           // Limit depth for performance
+          suppressErrors: true,
+          ignore: [
+            "**/.Trash/**",
+            "**/Library/**",
+            "**/.cache/**",
+            "**/node_modules/**",
+            ...config.backup.exclude.filter(
+              (p) => detectPatternType(p) === "glob"
+            )
+          ]
         });
         for (const match of allFiles) {
           if (regex.test(match) && !isExcluded(match)) {
@@ -615,8 +627,15 @@ async function scanTargets(config) {
       const matches = await fg(expanded, {
         dot: true,
         absolute: true,
-        ignore: globExcludes,
-        onlyFiles: true
+        ignore: [
+          "**/.Trash/**",
+          "**/Library/**",
+          "**/.cache/**",
+          "**/node_modules/**",
+          ...globExcludes
+        ],
+        onlyFiles: true,
+        suppressErrors: true
       });
       for (const match of matches) {
         if (!isExcluded(match)) {
@@ -640,9 +659,16 @@ async function scanTargets(config) {
         const matches = await fg(dirGlob, {
           dot: true,
           absolute: true,
-          ignore: globExcludes,
-          onlyFiles: true
+          ignore: [
+            "**/.Trash/**",
+            "**/Library/**",
+            "**/.cache/**",
+            "**/node_modules/**",
+            ...globExcludes
+          ],
+          onlyFiles: true,
           // Only include files, not subdirectories
+          suppressErrors: true
         });
         for (const match of matches) {
           if (!isExcluded(match)) {
@@ -699,7 +725,7 @@ async function createBackup(config, options = {}) {
     }
   }
   let allFiles = [...found];
-  if (config.scripts.includeInBackup) {
+  if (config.scripts?.includeInBackup) {
     const scripts = await collectScripts();
     allFiles = [...allFiles, ...scripts];
   }
@@ -947,10 +973,14 @@ var COMMANDS = {
       {
         name: "template",
         description: "Template name to execute",
-        required: true
+        required: false
       }
     ],
     options: [
+      {
+        flag: "-f, --file <path>",
+        description: "Path to template file (alternative to template name)"
+      },
       {
         flag: "--dry-run",
         description: "Show execution plan without running commands"
@@ -963,7 +993,9 @@ var COMMANDS = {
     examples: [
       "npx @lumy-pack/syncpoint provision dev-setup",
       "npx @lumy-pack/syncpoint provision dev-setup --dry-run",
-      "npx @lumy-pack/syncpoint provision dev-setup --skip-restore"
+      "npx @lumy-pack/syncpoint provision dev-setup --skip-restore",
+      "npx @lumy-pack/syncpoint provision --file ./my-template.yml",
+      "npx @lumy-pack/syncpoint provision -f ~/templates/custom.yaml --dry-run"
     ]
   },
   "create-template": {
@@ -1051,6 +1083,7 @@ var BackupView = ({ options }) => {
   const [error, setError] = useState(null);
   useEffect(() => {
     (async () => {
+      let progressInterval;
       try {
         const cfg = await loadConfig();
         setConfig(cfg);
@@ -1063,7 +1096,7 @@ var BackupView = ({ options }) => {
           return;
         }
         setPhase("compressing");
-        const progressInterval = setInterval(() => {
+        progressInterval = setInterval(() => {
           setProgress((prev) => {
             if (prev >= 90) return prev;
             return prev + 10;
@@ -1076,9 +1109,10 @@ var BackupView = ({ options }) => {
         setPhase("done");
         setTimeout(() => exit(), 100);
       } catch (err) {
+        if (progressInterval) clearInterval(progressInterval);
         setError(err instanceof Error ? err.message : String(err));
         setPhase("error");
-        exit();
+        setTimeout(() => exit(), 100);
       }
     })();
   }, []);
@@ -1132,7 +1166,7 @@ var BackupView = ({ options }) => {
       /* @__PURE__ */ jsxs2(Text2, { children: [
         "  ",
         "File: ",
-        result.metadata.config.filename
+        result.archivePath.split("/").pop()
       ] }),
       /* @__PURE__ */ jsxs2(Text2, { children: [
         "  ",
@@ -1169,8 +1203,8 @@ import { useState as useState2, useEffect as useEffect2 } from "react";
 import { Text as Text3, Box as Box2, useApp as useApp2 } from "ink";
 import Spinner from "ink-spinner";
 import { render as render2 } from "ink";
-import { join as join9 } from "path";
-import { writeFile as writeFile4 } from "fs/promises";
+import { join as join8 } from "path";
+import { writeFile as writeFile3 } from "fs/promises";
 
 // src/schemas/template.schema.ts
 var templateSchema = {
@@ -1252,9 +1286,6 @@ Begin by asking the user to describe their provisioning needs.`;
 
 // src/utils/claude-code-runner.ts
 import { spawn } from "child_process";
-import { unlink, writeFile as writeFile3 } from "fs/promises";
-import { tmpdir as tmpdir2 } from "os";
-import { join as join8 } from "path";
 async function isClaudeCodeAvailable() {
   return new Promise((resolve2) => {
     const child = spawn("which", ["claude"], { shell: true });
@@ -1268,58 +1299,49 @@ async function isClaudeCodeAvailable() {
 }
 async function invokeClaudeCode(prompt, options) {
   const timeout = options?.timeout ?? 12e4;
-  const promptFile = join8(tmpdir2(), `syncpoint-prompt-${Date.now()}.txt`);
-  await writeFile3(promptFile, prompt, "utf-8");
-  try {
-    return await new Promise((resolve2, reject) => {
-      const args = ["--permission-mode", "acceptEdits", "--model", "sonnet"];
-      if (options?.sessionId) {
-        args.push("--session", options.sessionId);
+  return await new Promise((resolve2, reject) => {
+    const args = ["--permission-mode", "acceptEdits", "--model", "sonnet"];
+    if (options?.sessionId) {
+      args.push("--session", options.sessionId);
+    }
+    const child = spawn("claude", args, {
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.on("data", (data) => {
+      stdout += data.toString();
+    });
+    child.stderr.on("data", (data) => {
+      stderr += data.toString();
+    });
+    child.stdin.write(prompt);
+    child.stdin.end();
+    const timer = setTimeout(() => {
+      child.kill();
+      reject(new Error(`Claude Code invocation timeout after ${timeout}ms`));
+    }, timeout);
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      if (code === 0) {
+        resolve2({
+          success: true,
+          output: stdout,
+          sessionId: options?.sessionId
+        });
+      } else {
+        resolve2({
+          success: false,
+          output: stdout,
+          error: stderr || `Process exited with code ${code}`
+        });
       }
-      const child = spawn("claude", args, {
-        stdio: ["pipe", "pipe", "pipe"]
-      });
-      let stdout = "";
-      let stderr = "";
-      child.stdout.on("data", (data) => {
-        stdout += data.toString();
-      });
-      child.stderr.on("data", (data) => {
-        stderr += data.toString();
-      });
-      child.stdin.write(prompt);
-      child.stdin.end();
-      const timer = setTimeout(() => {
-        child.kill();
-        reject(new Error(`Claude Code invocation timeout after ${timeout}ms`));
-      }, timeout);
-      child.on("close", (code) => {
-        clearTimeout(timer);
-        if (code === 0) {
-          resolve2({
-            success: true,
-            output: stdout,
-            sessionId: options?.sessionId
-          });
-        } else {
-          resolve2({
-            success: false,
-            output: stdout,
-            error: stderr || `Process exited with code ${code}`
-          });
-        }
-      });
-      child.on("error", (err) => {
-        clearTimeout(timer);
-        reject(err);
-      });
     });
-  } finally {
-    try {
-      await unlink(promptFile);
-    } catch {
-    }
-  }
+    child.on("error", (err) => {
+      clearTimeout(timer);
+      reject(err);
+    });
+  });
 }
 async function resumeClaudeCodeSession(sessionId, prompt, options) {
   return invokeClaudeCode(prompt, {
@@ -1503,14 +1525,14 @@ var CreateTemplateView = ({
           setPhase("writing");
           setMessage("Writing template...");
           const filename = templateName ? `${templateName}.yml` : `${parsedTemplate.name.toLowerCase().replace(/\s+/g, "-")}.yml`;
-          const templatePath = join9(templatesDir, filename);
+          const templatePath = join8(templatesDir, filename);
           if (await fileExists(templatePath)) {
             throw new Error(
               `Template already exists: ${filename}
 Please choose a different name or delete the existing template.`
             );
           }
-          await writeFile4(templatePath, yamlContent, "utf-8");
+          await writeFile3(templatePath, yamlContent, "utf-8");
           setPhase("done");
           setMessage(`\u2713 Template created: ${filename}`);
           setTimeout(() => exit(), 100);
@@ -1623,7 +1645,7 @@ var GeneralHelpView = () => {
         "Restore configuration files"
       ] }),
       /* @__PURE__ */ jsxs4(Text4, { children: [
-        /* @__PURE__ */ jsx4(Text4, { color: "cyan", children: "provision <template>" }),
+        /* @__PURE__ */ jsx4(Text4, { color: "cyan", children: "provision [template]" }),
         "    ",
         "Run machine provisioning template"
       ] }),
@@ -1736,7 +1758,7 @@ function registerHelpCommand(program2) {
 import { useState as useState3, useEffect as useEffect3 } from "react";
 import { Text as Text5, Box as Box4, useApp as useApp3 } from "ink";
 import { render as render4 } from "ink";
-import { join as join10 } from "path";
+import { join as join9 } from "path";
 import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 var InitView = () => {
   const { exit } = useApp3();
@@ -1747,7 +1769,7 @@ var InitView = () => {
     (async () => {
       try {
         const appDir = getAppDir();
-        if (await fileExists(join10(appDir, CONFIG_FILENAME))) {
+        if (await fileExists(join9(appDir, CONFIG_FILENAME))) {
           setError(`Already initialized: ${appDir}`);
           exit();
           return;
@@ -1780,11 +1802,11 @@ var InitView = () => {
         await initDefaultConfig();
         completed.push({ name: `Created ${CONFIG_FILENAME} (defaults)`, done: true });
         setSteps([...completed]);
-        const exampleTemplatePath = join10(getSubDir(TEMPLATES_DIR), "example.yml");
+        const exampleTemplatePath = join9(getSubDir(TEMPLATES_DIR), "example.yml");
         if (!await fileExists(exampleTemplatePath)) {
-          const { writeFile: writeFile6 } = await import("fs/promises");
+          const { writeFile: writeFile5 } = await import("fs/promises");
           const exampleYaml = readAsset("template.example.yml");
-          await writeFile6(exampleTemplatePath, exampleYaml, "utf-8");
+          await writeFile5(exampleTemplatePath, exampleYaml, "utf-8");
           completed.push({ name: `Created templates/example.yml`, done: true });
           setSteps([...completed]);
         }
@@ -1916,7 +1938,7 @@ var Table = ({
 // src/core/provision.ts
 import { exec } from "child_process";
 import { readFile as readFile4, readdir as readdir2 } from "fs/promises";
-import { join as join11 } from "path";
+import { join as join10 } from "path";
 import YAML3 from "yaml";
 var REMOTE_SCRIPT_PATTERNS = [
   /curl\s.*\|\s*(ba)?sh/,
@@ -1956,7 +1978,7 @@ async function listTemplates() {
     if (!entry.isFile() || !entry.name.endsWith(".yml") && !entry.name.endsWith(".yaml")) {
       continue;
     }
-    const fullPath = join11(templatesDir, entry.name);
+    const fullPath = join10(templatesDir, entry.name);
     try {
       const config = await loadTemplate(fullPath);
       templates.push({
@@ -2033,8 +2055,10 @@ async function executeStep(step) {
       output: output || void 0
     };
   } catch (err) {
-    const error = err;
-    const errorOutput = [error.stdout, error.stderr, error.message].filter(Boolean).join("\n").trim();
+    const error = err instanceof Error ? err : new Error(String(err));
+    const stdout = err?.stdout ?? "";
+    const stderr = err?.stderr ?? "";
+    const errorOutput = [stdout, stderr, error.message].filter(Boolean).join("\n").trim();
     return {
       name: step.name,
       status: "failed",
@@ -2073,7 +2097,7 @@ async function* runProvision(templatePath, options = {}) {
 
 // src/core/restore.ts
 import { copyFile, lstat as lstat2, readdir as readdir3, stat as stat2 } from "fs/promises";
-import { dirname as dirname2, join as join12 } from "path";
+import { dirname as dirname2, join as join11 } from "path";
 async function getBackupList(config) {
   const backupDir = config?.backup.destination ? resolveTargetPath(config.backup.destination) : getSubDir(BACKUPS_DIR);
   const exists = await fileExists(backupDir);
@@ -2082,7 +2106,7 @@ async function getBackupList(config) {
   const backups = [];
   for (const entry of entries) {
     if (!entry.isFile() || !entry.name.endsWith(".tar.gz")) continue;
-    const fullPath = join12(backupDir, entry.name);
+    const fullPath = join11(backupDir, entry.name);
     const fileStat = await stat2(fullPath);
     let hostname;
     let fileCount;
@@ -2157,7 +2181,7 @@ async function createSafetyBackup(filePaths) {
   const filename = `_pre-restore_${formatDatetime(now)}.tar.gz`;
   const backupDir = getSubDir(BACKUPS_DIR);
   await ensureDir(backupDir);
-  const archivePath = join12(backupDir, filename);
+  const archivePath = join11(backupDir, filename);
   const files = [];
   for (const fp of filePaths) {
     const absPath = resolveTargetPath(fp);
@@ -2191,8 +2215,8 @@ async function restoreBackup(archivePath, options = {}) {
     };
   }
   const { mkdtemp: mkdtemp2, rm: rm2 } = await import("fs/promises");
-  const { tmpdir: tmpdir3 } = await import("os");
-  const tmpDir = await mkdtemp2(join12(tmpdir3(), "syncpoint-restore-"));
+  const { tmpdir: tmpdir2 } = await import("os");
+  const tmpDir = await mkdtemp2(join11(tmpdir2(), "syncpoint-restore-"));
   try {
     await extractArchive(archivePath, tmpDir);
     for (const action of plan.actions) {
@@ -2201,7 +2225,7 @@ async function restoreBackup(archivePath, options = {}) {
         continue;
       }
       const archiveName = action.path.startsWith("~/") ? action.path.slice(2) : action.path;
-      const extractedPath = join12(tmpDir, archiveName);
+      const extractedPath = join11(tmpDir, archiveName);
       const destPath = resolveTargetPath(action.path);
       const extractedExists = await fileExists(extractedPath);
       if (!extractedExists) {
@@ -2596,6 +2620,10 @@ var ListView = ({ type, deleteIndex }) => {
 function registerListCommand(program2) {
   program2.command("list [type]").description("List backups and templates").option("--delete <n>", "Delete item #n").action(async (type, opts) => {
     const deleteIndex = opts.delete ? parseInt(opts.delete, 10) : void 0;
+    if (deleteIndex !== void 0 && isNaN(deleteIndex)) {
+      console.error(`Invalid delete index: ${opts.delete}`);
+      process.exit(1);
+    }
     const { waitUntilExit } = render5(
       /* @__PURE__ */ jsx8(ListView, { type, deleteIndex })
     );
@@ -2749,6 +2777,18 @@ var ProvisionView = ({
             stepIdx++;
           }
         }
+        if (template.backup && !options.skipRestore) {
+          try {
+            const backups = await getBackupList();
+            const match = backups.find(
+              (b) => b.filename.includes(template.backup)
+            );
+            if (match) {
+              await restoreBackup(match.path);
+            }
+          } catch {
+          }
+        }
         setPhase("done");
         setTimeout(() => exit(), 100);
       } catch (err) {
@@ -2852,17 +2892,36 @@ var ProvisionView = ({
   ] });
 };
 function registerProvisionCommand(program2) {
-  program2.command("provision <template>").description("Run template-based machine provisioning").option("--dry-run", "Show plan without execution", false).option("--skip-restore", "Skip automatic restore after template completion", false).action(
+  program2.command("provision [template]").description("Run template-based machine provisioning").option("--dry-run", "Show plan without execution", false).option("--skip-restore", "Skip automatic restore after template completion", false).option("-f, --file <path>", "Path to template file").action(
     async (templateName, opts) => {
-      const templates = await listTemplates();
-      const match = templates.find(
-        (t) => t.name === templateName || t.name === `${templateName}.yml` || t.config.name === templateName
-      );
-      if (!match) {
-        console.error(`Template not found: ${templateName}`);
+      let templatePath;
+      if (opts.file) {
+        templatePath = resolveTargetPath(opts.file);
+        if (!await fileExists(templatePath)) {
+          console.error(`Template file not found: ${opts.file}`);
+          process.exit(1);
+        }
+        if (!templatePath.endsWith(".yml") && !templatePath.endsWith(".yaml")) {
+          console.error(`Template file must have .yml or .yaml extension: ${opts.file}`);
+          process.exit(1);
+        }
+      } else if (templateName) {
+        const templates = await listTemplates();
+        const match = templates.find(
+          (t) => t.name === templateName || t.name === `${templateName}.yml` || t.config.name === templateName
+        );
+        if (!match) {
+          console.error(`Template not found: ${templateName}`);
+          process.exit(1);
+        }
+        templatePath = match.path;
+      } else {
+        console.error("Error: Either <template> name or --file option must be provided");
+        console.error("Usage: syncpoint provision <template> [options]");
+        console.error("       syncpoint provision --file <path> [options]");
         process.exit(1);
       }
-      const tmpl = await loadTemplate(match.path);
+      const tmpl = await loadTemplate(templatePath);
       if (tmpl.sudo && !opts.dryRun) {
         ensureSudo(tmpl.name);
       }
@@ -2871,7 +2930,7 @@ function registerProvisionCommand(program2) {
           ProvisionView,
           {
             template: tmpl,
-            templatePath: match.path,
+            templatePath,
             options: {
               dryRun: opts.dryRun,
               skipRestore: opts.skipRestore
@@ -2902,7 +2961,8 @@ var RestoreView = ({ filename, options }) => {
   useEffect6(() => {
     (async () => {
       try {
-        const list2 = await getBackupList();
+        const config = await loadConfig();
+        const list2 = await getBackupList(config);
         setBackups(list2);
         if (list2.length === 0) {
           setError("No backups available.");
@@ -3115,7 +3175,7 @@ function registerRestoreCommand(program2) {
 
 // src/commands/Status.tsx
 import { readdirSync, statSync, unlinkSync as unlinkSync2 } from "fs";
-import { join as join13 } from "path";
+import { join as join12 } from "path";
 import { Box as Box10, Text as Text12, useApp as useApp7, useInput as useInput3 } from "ink";
 import { render as render8 } from "ink";
 import SelectInput3 from "ink-select-input";
@@ -3128,7 +3188,7 @@ function getDirStats(dirPath) {
     let count = 0;
     for (const entry of entries) {
       try {
-        const stat4 = statSync(join13(dirPath, entry));
+        const stat4 = statSync(join12(dirPath, entry));
         if (stat4.isFile()) {
           totalSize += stat4.size;
           count++;
@@ -3274,9 +3334,14 @@ var StatusView = ({ cleanup }) => {
         try {
           const entries = readdirSync(logsDir);
           for (const entry of entries) {
-            const logPath = join13(logsDir, entry);
+            const logPath = join12(logsDir, entry);
             if (!isInsideDir(logPath, logsDir)) throw new Error(`Refusing to delete file outside logs directory: ${logPath}`);
-            unlinkSync2(logPath);
+            try {
+              if (statSync(logPath).isFile()) {
+                unlinkSync2(logPath);
+              }
+            } catch {
+            }
           }
         } catch {
         }
@@ -3509,8 +3574,8 @@ function registerStatusCommand(program2) {
 }
 
 // src/commands/Wizard.tsx
-import { copyFile as copyFile2, readFile as readFile5, rename, unlink as unlink2, writeFile as writeFile5 } from "fs/promises";
-import { join as join15 } from "path";
+import { copyFile as copyFile2, readFile as readFile5, rename, unlink, writeFile as writeFile4 } from "fs/promises";
+import { join as join14 } from "path";
 import { Box as Box11, Text as Text13, useApp as useApp8 } from "ink";
 import { render as render9 } from "ink";
 import Spinner3 from "ink-spinner";
@@ -3556,7 +3621,7 @@ ${variables.defaultConfig}
 
 // src/utils/file-scanner.ts
 import { stat as stat3 } from "fs/promises";
-import { join as join14 } from "path";
+import { join as join13 } from "path";
 import glob from "fast-glob";
 var FILE_CATEGORIES = {
   shell: {
@@ -3629,12 +3694,13 @@ async function scanHomeDirectory(options) {
         onlyFiles: true,
         deep: maxDepth,
         absolute: false,
-        cwd: homeDir
+        cwd: homeDir,
+        suppressErrors: true
       });
       const validFiles = [];
       for (const file of files) {
         try {
-          const fullPath = join14(homeDir, file);
+          const fullPath = join13(homeDir, file);
           await stat3(fullPath);
           validFiles.push(file);
           categorizedFiles.add(file);
@@ -3661,14 +3727,15 @@ async function scanHomeDirectory(options) {
         onlyFiles: true,
         deep: maxDepth,
         absolute: false,
-        cwd: homeDir
+        cwd: homeDir,
+        suppressErrors: true
       });
       const uncategorizedFiles = [];
       for (const file of allFiles) {
         if (categorizedFiles.has(file)) continue;
         if (totalFiles >= maxFiles) break;
         try {
-          const fullPath = join14(homeDir, file);
+          const fullPath = join13(homeDir, file);
           await stat3(fullPath);
           uncategorizedFiles.push(file);
           totalFiles++;
@@ -3679,7 +3746,7 @@ async function scanHomeDirectory(options) {
       if (uncategorizedFiles.length > 0) {
         categories.push({
           category: "Other Files",
-          files: uncategorizedFiles.sort().slice(0, maxFiles - totalFiles)
+          files: uncategorizedFiles.sort()
         });
       }
     } catch {
@@ -3753,14 +3820,12 @@ var WizardView = ({ printMode }) => {
   useEffect8(() => {
     (async () => {
       try {
-        const configPath = join15(getAppDir(), CONFIG_FILENAME);
+        const configPath = join14(getAppDir(), CONFIG_FILENAME);
         if (await fileExists(configPath)) {
-          setMessage(
-            `Config already exists: ${configPath}
-Would you like to backup and overwrite? (Backup will be saved as config.yml.bak)`
-          );
-          await rename(configPath, `${configPath}.bak`);
-          setMessage(`Backed up existing config to config.yml.bak`);
+          const timestamp2 = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+          const bakPath = `${configPath}.${timestamp2}.bak`;
+          await rename(configPath, bakPath);
+          setMessage(`Backed up existing config to ${bakPath}`);
         }
         setPhase("scanning");
         setMessage("Scanning home directory for backup targets...");
@@ -3822,12 +3887,12 @@ Would you like to backup and overwrite? (Backup will be saved as config.yml.bak)
             setPhase("writing");
             setMessage("Writing config.yml...");
             const tmpPath = `${configPath}.tmp`;
-            await writeFile5(tmpPath, yamlContent, "utf-8");
+            await writeFile4(tmpPath, yamlContent, "utf-8");
             const verification = validateConfig(parseYAML(yamlContent));
             if (verification.valid) {
               await rename(tmpPath, configPath);
             } else {
-              await unlink2(tmpPath);
+              await unlink(tmpPath);
               throw new Error("Final validation failed");
             }
             setPhase("done");
@@ -3916,11 +3981,13 @@ function registerWizardCommand(program2) {
       await waitUntilExit();
       return;
     }
-    const configPath = join15(getAppDir(), CONFIG_FILENAME);
+    const configPath = join14(getAppDir(), CONFIG_FILENAME);
     try {
       if (await fileExists(configPath)) {
-        console.log(`\u{1F4CB} Backing up existing config to ${configPath}.bak`);
-        await rename(configPath, `${configPath}.bak`);
+        const timestamp2 = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+        const bakPath = `${configPath}.${timestamp2}.bak`;
+        console.log(`\u{1F4CB} Backing up existing config to ${bakPath}`);
+        await rename(configPath, bakPath);
       }
       if (!await isClaudeCodeAvailable()) {
         throw new Error(

package/dist/constants.d.ts

@@ -5,7 +5,6 @@ export declare const METADATA_FILENAME = "_metadata.json";
 export declare const LARGE_FILE_THRESHOLD: number;
 export declare const MAX_RETRY = 3;
 export declare const SENSITIVE_PATTERNS: string[];
-export declare const REMOTE_SCRIPT_PATTERN: RegExp;
 export declare const BACKUPS_DIR = "backups";
 export declare const TEMPLATES_DIR = "templates";
 export declare const SCRIPTS_DIR = "scripts";

package/dist/index.cjs

@@ -429,7 +429,7 @@ function generateFilename(pattern, options) {
 var import_promises3 = require("fs/promises");
 var import_node_path5 = require("path");
 var import_picocolors = __toESM(require("picocolors"), 1);
-var ANSI_RE = /\x1b\[[0-9;]*m/g;
+var ANSI_RE = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, "g");
 function stripAnsi(str) {
   return str.replace(ANSI_RE, "");
 }
@@ -560,7 +560,7 @@ function validateMetadata(data) {
 }
 
 // src/version.ts
-var VERSION = "0.0.2";
+var VERSION = "0.0.4";
 
 // src/core/metadata.ts
 var METADATA_VERSION = "1.0.0";
@@ -611,7 +611,8 @@ async function collectFileInfo(absolutePath, logicalPath) {
   }
   let hash;
   if (lstats.isSymbolicLink()) {
-    hash = `sha256:${(0, import_node_crypto.createHash)("sha256").update(absolutePath).digest("hex")}`;
+    const linkTarget = await (0, import_promises4.readlink)(absolutePath);
+    hash = `sha256:${(0, import_node_crypto.createHash)("sha256").update(linkTarget).digest("hex")}`;
   } else {
     hash = await computeFileHash(absolutePath);
   }
@@ -672,7 +673,8 @@ async function extractArchive(archivePath, destDir) {
       const normalizedPath = (0, import_node_path6.normalize)(path);
       if (normalizedPath.includes("..")) return false;
       if (normalizedPath.startsWith("/")) return false;
-      if (entry.type === "SymbolicLink" || entry.type === "Link") return false;
+      if ("type" in entry && (entry.type === "SymbolicLink" || entry.type === "Link"))
+        return false;
       return true;
     }
   });
@@ -728,8 +730,18 @@ async function scanTargets(config) {
           dot: true,
           absolute: true,
           onlyFiles: true,
-          deep: 5
+          deep: 5,
           // Limit depth for performance
+          suppressErrors: true,
+          ignore: [
+            "**/.Trash/**",
+            "**/Library/**",
+            "**/.cache/**",
+            "**/node_modules/**",
+            ...config.backup.exclude.filter(
+              (p) => detectPatternType(p) === "glob"
+            )
+          ]
         });
         for (const match of allFiles) {
           if (regex.test(match) && !isExcluded(match)) {
@@ -749,8 +761,15 @@ async function scanTargets(config) {
       const matches = await (0, import_fast_glob.default)(expanded, {
         dot: true,
         absolute: true,
-        ignore: globExcludes,
-        onlyFiles: true
+        ignore: [
+          "**/.Trash/**",
+          "**/Library/**",
+          "**/.cache/**",
+          "**/node_modules/**",
+          ...globExcludes
+        ],
+        onlyFiles: true,
+        suppressErrors: true
       });
       for (const match of matches) {
         if (!isExcluded(match)) {
@@ -774,9 +793,16 @@ async function scanTargets(config) {
         const matches = await (0, import_fast_glob.default)(dirGlob, {
           dot: true,
           absolute: true,
-          ignore: globExcludes,
-          onlyFiles: true
+          ignore: [
+            "**/.Trash/**",
+            "**/Library/**",
+            "**/.cache/**",
+            "**/node_modules/**",
+            ...globExcludes
+          ],
+          onlyFiles: true,
           // Only include files, not subdirectories
+          suppressErrors: true
         });
         for (const match of matches) {
           if (!isExcluded(match)) {
@@ -833,7 +859,7 @@ async function createBackup(config, options = {}) {
     }
   }
   let allFiles = [...found];
-  if (config.scripts.includeInBackup) {
+  if (config.scripts?.includeInBackup) {
     const scripts = await collectScripts();
     allFiles = [...allFiles, ...scripts];
   }
@@ -1185,8 +1211,10 @@ async function executeStep(step) {
       output: output || void 0
     };
   } catch (err) {
-    const error = err;
-    const errorOutput = [error.stdout, error.stderr, error.message].filter(Boolean).join("\n").trim();
+    const error = err instanceof Error ? err : new Error(String(err));
+    const stdout = err?.stdout ?? "";
+    const stderr = err?.stderr ?? "";
+    const errorOutput = [stdout, stderr, error.message].filter(Boolean).join("\n").trim();
     return {
       name: step.name,
       status: "failed",

package/dist/index.mjs

@@ -379,7 +379,7 @@ function generateFilename(pattern, options) {
 import { appendFile, mkdir as mkdir2 } from "fs/promises";
 import { join as join5 } from "path";
 import pc from "picocolors";
-var ANSI_RE = /\x1b\[[0-9;]*m/g;
+var ANSI_RE = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, "g");
 function stripAnsi(str) {
   return str.replace(ANSI_RE, "");
 }
@@ -433,7 +433,7 @@ var logger = {
 
 // src/core/metadata.ts
 import { createHash } from "crypto";
-import { lstat, readFile as readFile2 } from "fs/promises";
+import { lstat, readFile as readFile2, readlink } from "fs/promises";
 
 // src/schemas/metadata.schema.ts
 var metadataSchema = {
@@ -510,7 +510,7 @@ function validateMetadata(data) {
 }
 
 // src/version.ts
-var VERSION = "0.0.2";
+var VERSION = "0.0.4";
 
 // src/core/metadata.ts
 var METADATA_VERSION = "1.0.0";
@@ -561,7 +561,8 @@ async function collectFileInfo(absolutePath, logicalPath) {
   }
   let hash;
   if (lstats.isSymbolicLink()) {
-    hash = `sha256:${createHash("sha256").update(absolutePath).digest("hex")}`;
+    const linkTarget = await readlink(absolutePath);
+    hash = `sha256:${createHash("sha256").update(linkTarget).digest("hex")}`;
   } else {
     hash = await computeFileHash(absolutePath);
   }
@@ -622,7 +623,8 @@ async function extractArchive(archivePath, destDir) {
       const normalizedPath = normalize2(path);
       if (normalizedPath.includes("..")) return false;
       if (normalizedPath.startsWith("/")) return false;
-      if (entry.type === "SymbolicLink" || entry.type === "Link") return false;
+      if ("type" in entry && (entry.type === "SymbolicLink" || entry.type === "Link"))
+        return false;
       return true;
     }
   });
@@ -678,8 +680,18 @@ async function scanTargets(config) {
           dot: true,
           absolute: true,
           onlyFiles: true,
-          deep: 5
+          deep: 5,
           // Limit depth for performance
+          suppressErrors: true,
+          ignore: [
+            "**/.Trash/**",
+            "**/Library/**",
+            "**/.cache/**",
+            "**/node_modules/**",
+            ...config.backup.exclude.filter(
+              (p) => detectPatternType(p) === "glob"
+            )
+          ]
         });
         for (const match of allFiles) {
           if (regex.test(match) && !isExcluded(match)) {
@@ -699,8 +711,15 @@ async function scanTargets(config) {
       const matches = await fg(expanded, {
         dot: true,
         absolute: true,
-        ignore: globExcludes,
-        onlyFiles: true
+        ignore: [
+          "**/.Trash/**",
+          "**/Library/**",
+          "**/.cache/**",
+          "**/node_modules/**",
+          ...globExcludes
+        ],
+        onlyFiles: true,
+        suppressErrors: true
       });
       for (const match of matches) {
         if (!isExcluded(match)) {
@@ -724,9 +743,16 @@ async function scanTargets(config) {
         const matches = await fg(dirGlob, {
           dot: true,
           absolute: true,
-          ignore: globExcludes,
-          onlyFiles: true
+          ignore: [
+            "**/.Trash/**",
+            "**/Library/**",
+            "**/.cache/**",
+            "**/node_modules/**",
+            ...globExcludes
+          ],
+          onlyFiles: true,
           // Only include files, not subdirectories
+          suppressErrors: true
         });
         for (const match of matches) {
           if (!isExcluded(match)) {
@@ -783,7 +809,7 @@ async function createBackup(config, options = {}) {
     }
   }
   let allFiles = [...found];
-  if (config.scripts.includeInBackup) {
+  if (config.scripts?.includeInBackup) {
     const scripts = await collectScripts();
     allFiles = [...allFiles, ...scripts];
   }
@@ -1135,8 +1161,10 @@ async function executeStep(step) {
       output: output || void 0
     };
   } catch (err) {
-    const error = err;
-    const errorOutput = [error.stdout, error.stderr, error.message].filter(Boolean).join("\n").trim();
+    const error = err instanceof Error ? err : new Error(String(err));
+    const stdout = err?.stdout ?? "";
+    const stderr = err?.stderr ?? "";
+    const errorOutput = [stdout, stderr, error.message].filter(Boolean).join("\n").trim();
     return {
       name: step.name,
       status: "failed",

package/dist/utils/types.d.ts

@@ -38,7 +38,7 @@ export interface FileEntry {
 }
 export interface TemplateConfig {
     name: string;
-    description: string;
+    description?: string;
     backup?: string;
     sudo?: boolean;
     steps: TemplateStep[];
@@ -92,6 +92,7 @@ export interface RestoreOptions {
 export interface ProvisionOptions {
     dryRun?: boolean;
     skipRestore?: boolean;
+    file?: string;
 }
 export interface BackupInfo {
     filename: string;

package/dist/version.d.ts

@@ -2,4 +2,4 @@
  * Current package version from package.json
  * Automatically synchronized during build process
  */
-export declare const VERSION = "0.0.2";
+export declare const VERSION = "0.0.4";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumy-pack/syncpoint",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "CLI tool for project synchronization and scaffolding",
   "keywords": [
     "cli",
@@ -55,23 +55,22 @@
     "@types/micromatch": "^4.0.9",
     "@types/node": "^20.11.0",
     "@types/react": "^18.0.0",
-    "@types/tar": "^6.1.13",
     "@vitest/coverage-v8": "^3.2.4",
     "ink-testing-library": "^4.0.0"
   },
   "scripts": {
     "build": "node scripts/inject-version.js && tsup && pnpm build:types",
-    "build:types": "tsc -p ./tsconfig.declarations.json",
     "build:publish:npm": "pnpm build && pnpm publish:npm",
+    "build:types": "tsc -p ./tsconfig.declarations.json",
     "dev": "node scripts/inject-version.js && tsx src/cli.ts",
     "format": "prettier --write \"src/**/*.ts\"",
     "lint": "eslint \"src/**/*.ts\"",
     "publish:npm": "pnpm publish --access public --no-git-checks",
     "test": "vitest",
-    "test:run": "vitest run",
-    "test:e2e": "vitest run --config vitest.e2e.config.ts src/__tests__/e2e/",
-    "test:docker": "vitest run --config vitest.e2e.config.ts src/__tests__/docker/",
     "test:all": "vitest run && pnpm test:e2e && pnpm test:docker",
+    "test:docker": "vitest run --config vitest.e2e.config.ts src/__tests__/docker/",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts src/__tests__/e2e/",
+    "test:run": "vitest run",
     "version:major": "pnpm version major",
     "version:minor": "pnpm version minor",
     "version:patch": "pnpm version patch"