@lumy-pack/syncpoint 0.0.2 → 0.0.3

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

@@ -426,7 +426,7 @@ function validateMetadata(data) {
 }
 
 // src/version.ts
-var VERSION = "0.0.2";
+var VERSION = "0.0.3";
 
 // src/core/metadata.ts
 var METADATA_VERSION = "1.0.0";
@@ -594,8 +594,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 +625,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 +657,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)) {
@@ -947,10 +971,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 +991,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": {
@@ -1623,7 +1653,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"
       ] }),
@@ -2852,17 +2882,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 +2920,7 @@ function registerProvisionCommand(program2) {
           ProvisionView,
           {
             template: tmpl,
-            templatePath: match.path,
+            templatePath,
             options: {
               dryRun: opts.dryRun,
               skipRestore: opts.skipRestore
@@ -3629,7 +3678,8 @@ async function scanHomeDirectory(options) {
         onlyFiles: true,
         deep: maxDepth,
         absolute: false,
-        cwd: homeDir
+        cwd: homeDir,
+        suppressErrors: true
       });
       const validFiles = [];
       for (const file of files) {
@@ -3661,7 +3711,8 @@ async function scanHomeDirectory(options) {
         onlyFiles: true,
         deep: maxDepth,
         absolute: false,
-        cwd: homeDir
+        cwd: homeDir,
+        suppressErrors: true
       });
       const uncategorizedFiles = [];
       for (const file of allFiles) {

package/dist/index.cjs

@@ -560,7 +560,7 @@ function validateMetadata(data) {
 }
 
 // src/version.ts
-var VERSION = "0.0.2";
+var VERSION = "0.0.3";
 
 // src/core/metadata.ts
 var METADATA_VERSION = "1.0.0";
@@ -728,8 +728,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 +759,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 +791,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)) {

package/dist/index.mjs

@@ -510,7 +510,7 @@ function validateMetadata(data) {
 }
 
 // src/version.ts
-var VERSION = "0.0.2";
+var VERSION = "0.0.3";
 
 // src/core/metadata.ts
 var METADATA_VERSION = "1.0.0";
@@ -678,8 +678,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 +709,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 +741,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)) {

package/dist/utils/types.d.ts

@@ -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.3";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumy-pack/syncpoint",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "CLI tool for project synchronization and scaffolding",
   "keywords": [
     "cli",