@lumy-pack/syncpoint 0.0.9 → 0.0.10

package/dist/cli.mjs

@@ -1,8 +1,124 @@
 #!/usr/bin/env node
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/utils/assets.ts
+var assets_exports = {};
+__export(assets_exports, {
+  getAssetPath: () => getAssetPath,
+  readAsset: () => readAsset
+});
+import { existsSync, readFileSync } from "fs";
+import { dirname, join as join6 } from "path";
+import { fileURLToPath } from "url";
+function getPackageRoot() {
+  let dir = dirname(fileURLToPath(import.meta.url));
+  while (dir !== dirname(dir)) {
+    if (existsSync(join6(dir, "package.json"))) return dir;
+    dir = dirname(dir);
+  }
+  throw new Error("Could not find package root");
+}
+function getAssetPath(filename) {
+  return join6(getPackageRoot(), "assets", filename);
+}
+function readAsset(filename) {
+  return readFileSync(getAssetPath(filename), "utf-8");
+}
+var init_assets = __esm({
+  "src/utils/assets.ts"() {
+    "use strict";
+  }
+});
+
+// src/prompts/wizard-template.ts
+var wizard_template_exports = {};
+__export(wizard_template_exports, {
+  generateTemplateWizardPrompt: () => generateTemplateWizardPrompt
+});
+function generateTemplateWizardPrompt(variables) {
+  return `You are a Syncpoint provisioning template assistant. Your role is to help users create automated environment setup templates.
+
+**Input:**
+1. User's provisioning requirements (described in natural language)
+2. Example template structure (YAML)
+
+**Your Task:**
+1. Ask clarifying questions to understand the provisioning workflow:
+   - What software/tools need to be installed?
+   - What dependencies should be checked?
+   - Are there any configuration steps after installation?
+   - Should any steps require sudo privileges?
+   - Should any steps be conditional (skip_if)?
+2. Based on user responses, generate a complete provision template
+
+**Output Requirements:**
+- Pure YAML format only (no markdown, no code blocks, no explanations)
+- Must be valid according to Syncpoint template schema
+- Required fields:
+  - \`name\`: Template name
+  - \`steps\`: Array of provisioning steps (minimum 1)
+- Each step must include:
+  - \`name\`: Step name (required)
+  - \`command\`: Shell command to execute (required)
+  - \`description\`: Step description (optional)
+  - \`skip_if\`: Condition to skip step (optional)
+  - \`continue_on_error\`: Whether to continue on failure (optional, default: false)
+- Optional template fields:
+  - \`description\`: Template description
+  - \`backup\`: Backup name to restore after provisioning
+  - \`sudo\`: Whether sudo is required (boolean)
+
+**Example Template:**
+${variables.exampleTemplate}
+
+Begin by asking the user to describe their provisioning needs.`;
+}
+var init_wizard_template = __esm({
+  "src/prompts/wizard-template.ts"() {
+    "use strict";
+  }
+});
 
 // src/cli.ts
 import { Command } from "commander";
 
+// ../shared/src/respond.ts
+function respond(command, data, startTime, version) {
+  const response = {
+    ok: true,
+    command,
+    data,
+    meta: {
+      version,
+      durationMs: Date.now() - startTime,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    }
+  };
+  process.stdout.write(JSON.stringify(response) + "\n");
+}
+function respondError(command, code, message, startTime, version, details) {
+  const response = {
+    ok: false,
+    command,
+    error: { code, message, ...details !== void 0 ? { details } : {} },
+    meta: {
+      version,
+      durationMs: Date.now() - startTime,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    }
+  };
+  process.stdout.write(JSON.stringify(response) + "\n");
+  process.exitCode = 1;
+}
+
 // src/commands/Backup.tsx
 import { Box, Static, Text as Text2, useApp } from "ink";
 import { render } from "ink";
@@ -486,7 +602,7 @@ function validateMetadata(data) {
 }
 
 // src/version.ts
-var VERSION = "0.0.8";
+var VERSION = "0.0.10";
 
 // src/core/metadata.ts
 var METADATA_VERSION = "1.0.0";
@@ -912,26 +1028,8 @@ function validateConfig(data) {
   return { valid: false, errors };
 }
 
-// src/utils/assets.ts
-import { existsSync, readFileSync } from "fs";
-import { dirname, join as join6 } from "path";
-import { fileURLToPath } from "url";
-function getPackageRoot() {
-  let dir = dirname(fileURLToPath(import.meta.url));
-  while (dir !== dirname(dir)) {
-    if (existsSync(join6(dir, "package.json"))) return dir;
-    dir = dirname(dir);
-  }
-  throw new Error("Could not find package root");
-}
-function getAssetPath(filename) {
-  return join6(getPackageRoot(), "assets", filename);
-}
-function readAsset(filename) {
-  return readFileSync(getAssetPath(filename), "utf-8");
-}
-
 // src/core/config.ts
+init_assets();
 function stripDangerousKeys(obj) {
   if (obj === null || typeof obj !== "object") return obj;
   if (Array.isArray(obj)) return obj.map(stripDangerousKeys);
@@ -994,6 +1092,35 @@ async function initDefaultConfig() {
   return { created, skipped };
 }
 
+// src/errors.ts
+var SyncpointErrorCode = {
+  CONFIG_NOT_FOUND: "CONFIG_NOT_FOUND",
+  CONFIG_INVALID: "CONFIG_INVALID",
+  BACKUP_FAILED: "BACKUP_FAILED",
+  RESTORE_FAILED: "RESTORE_FAILED",
+  TEMPLATE_NOT_FOUND: "TEMPLATE_NOT_FOUND",
+  PROVISION_FAILED: "PROVISION_FAILED",
+  MISSING_ARGUMENT: "MISSING_ARGUMENT",
+  INVALID_ARGUMENT: "INVALID_ARGUMENT",
+  UNKNOWN: "UNKNOWN"
+};
+function classifyError(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  if (msg.includes("Config file not found") || msg.includes('Run "syncpoint init"')) {
+    return SyncpointErrorCode.CONFIG_NOT_FOUND;
+  }
+  if (msg.includes("Invalid config")) {
+    return SyncpointErrorCode.CONFIG_INVALID;
+  }
+  if (msg.includes("Template not found") || msg.includes("template not found")) {
+    return SyncpointErrorCode.TEMPLATE_NOT_FOUND;
+  }
+  if (msg.includes("Template file not found")) {
+    return SyncpointErrorCode.TEMPLATE_NOT_FOUND;
+  }
+  return SyncpointErrorCode.UNKNOWN;
+}
+
 // src/utils/command-registry.ts
 var COMMANDS = {
   init: {
@@ -1009,7 +1136,8 @@ var COMMANDS = {
     options: [
       {
         flag: "-p, --print",
-        description: "Print prompt instead of invoking Claude Code"
+        description: "Print prompt instead of invoking Claude Code",
+        type: "boolean"
       }
     ],
     examples: [
@@ -1024,15 +1152,18 @@ var COMMANDS = {
     options: [
       {
         flag: "--dry-run",
-        description: "Preview files to be backed up without creating archive"
+        description: "Preview files to be backed up without creating archive",
+        type: "boolean"
       },
       {
         flag: "--tag <name>",
-        description: "Add custom tag to backup filename"
+        description: "Add custom tag to backup filename",
+        type: "string"
       },
       {
         flag: "-v, --verbose",
-        description: "Show detailed output including missing files"
+        description: "Show detailed output including missing files",
+        type: "boolean"
       }
     ],
     examples: [
@@ -1055,7 +1186,8 @@ var COMMANDS = {
     options: [
       {
         flag: "--dry-run",
-        description: "Show restore plan without actually restoring"
+        description: "Show restore plan without actually restoring",
+        type: "boolean"
       }
     ],
     examples: [
@@ -1078,15 +1210,18 @@ var COMMANDS = {
     options: [
       {
         flag: "-f, --file <path>",
-        description: "Path to template file (alternative to template name)"
+        description: "Path to template file (alternative to template name)",
+        type: "string"
       },
       {
         flag: "--dry-run",
-        description: "Show execution plan without running commands"
+        description: "Show execution plan without running commands",
+        type: "boolean"
       },
       {
         flag: "--skip-restore",
-        description: "Skip automatic config restore after provisioning"
+        description: "Skip automatic config restore after provisioning",
+        type: "boolean"
       }
     ],
     examples: [
@@ -1111,7 +1246,8 @@ var COMMANDS = {
     options: [
       {
         flag: "-p, --print",
-        description: "Print prompt instead of invoking Claude Code"
+        description: "Print prompt instead of invoking Claude Code",
+        type: "boolean"
       }
     ],
     examples: [
@@ -1131,7 +1267,7 @@ var COMMANDS = {
         required: false
       }
     ],
-    options: [{ flag: "--delete <n>", description: "Delete item number n" }],
+    options: [{ flag: "--delete <filename>", description: "Delete item by filename", type: "string" }],
     examples: [
       "npx @lumy-pack/syncpoint list",
       "npx @lumy-pack/syncpoint list backups",
@@ -1143,7 +1279,7 @@ var COMMANDS = {
     description: "Show ~/.syncpoint/ status summary and manage cleanup",
     usage: "npx @lumy-pack/syncpoint status [options]",
     options: [
-      { flag: "--cleanup", description: "Enter interactive cleanup mode" }
+      { flag: "--cleanup", description: "Enter interactive cleanup mode", type: "boolean" }
     ],
     examples: [
       "npx @lumy-pack/syncpoint status",
@@ -1157,7 +1293,8 @@ var COMMANDS = {
     options: [
       {
         flag: "--dry-run",
-        description: "Preview changes without writing"
+        description: "Preview changes without writing",
+        type: "boolean"
       }
     ],
     examples: [
@@ -1334,6 +1471,33 @@ function registerBackupCommand(program2) {
   });
   cmd.action(
     async (opts) => {
+      const globalOpts = program2.opts();
+      const startTime = Date.now();
+      if (globalOpts.json) {
+        try {
+          const config = await loadConfig();
+          const result = await createBackup(config, {
+            dryRun: opts.dryRun,
+            tag: opts.tag,
+            verbose: opts.verbose
+          });
+          respond(
+            "backup",
+            {
+              archivePath: result.archivePath,
+              fileCount: result.metadata.summary.fileCount,
+              totalSize: result.metadata.summary.totalSize,
+              tag: opts.tag ?? null
+            },
+            startTime,
+            VERSION
+          );
+        } catch (error) {
+          const code = classifyError(error);
+          respondError("backup", code, error.message, startTime, VERSION);
+        }
+        return;
+      }
       const { waitUntilExit } = render(
         /* @__PURE__ */ jsx2(
           BackupView,
@@ -1358,46 +1522,7 @@ import { Box as Box2, Text as Text3, useApp as useApp2 } from "ink";
 import { render as render2 } from "ink";
 import Spinner from "ink-spinner";
 import { useEffect as useEffect2, useState as useState2 } from "react";
-
-// src/prompts/wizard-template.ts
-function generateTemplateWizardPrompt(variables) {
-  return `You are a Syncpoint provisioning template assistant. Your role is to help users create automated environment setup templates.
-
-**Input:**
-1. User's provisioning requirements (described in natural language)
-2. Example template structure (YAML)
-
-**Your Task:**
-1. Ask clarifying questions to understand the provisioning workflow:
-   - What software/tools need to be installed?
-   - What dependencies should be checked?
-   - Are there any configuration steps after installation?
-   - Should any steps require sudo privileges?
-   - Should any steps be conditional (skip_if)?
-2. Based on user responses, generate a complete provision template
-
-**Output Requirements:**
-- Pure YAML format only (no markdown, no code blocks, no explanations)
-- Must be valid according to Syncpoint template schema
-- Required fields:
-  - \`name\`: Template name
-  - \`steps\`: Array of provisioning steps (minimum 1)
-- Each step must include:
-  - \`name\`: Step name (required)
-  - \`command\`: Shell command to execute (required)
-  - \`description\`: Step description (optional)
-  - \`skip_if\`: Condition to skip step (optional)
-  - \`continue_on_error\`: Whether to continue on failure (optional, default: false)
-- Optional template fields:
-  - \`description\`: Template description
-  - \`backup\`: Backup name to restore after provisioning
-  - \`sudo\`: Whether sudo is required (boolean)
-
-**Example Template:**
-${variables.exampleTemplate}
-
-Begin by asking the user to describe their provisioning needs.`;
-}
+init_wizard_template();
 
 // assets/schemas/template.schema.json
 var template_schema_default = {
@@ -1473,6 +1598,9 @@ function validateTemplate(data) {
   return { valid: false, errors };
 }
 
+// src/commands/CreateTemplate.tsx
+init_assets();
+
 // src/utils/claude-code-runner.ts
 import { spawn } from "child_process";
 async function isClaudeCodeAvailable() {
@@ -1797,6 +1925,30 @@ ${formatValidationErrors(validation.errors || [])}`
 };
 function registerCreateTemplateCommand(program2) {
   program2.command("create-template [name]").description("Interactive wizard to create a provisioning template").option("-p, --print", "Print prompt instead of invoking Claude Code").action(async (name, opts) => {
+    const globalOpts = program2.opts();
+    const startTime = Date.now();
+    if (globalOpts.json) {
+      if (!opts.print) {
+        respondError(
+          "create-template",
+          SyncpointErrorCode.MISSING_ARGUMENT,
+          "--print is required in --json mode (interactive mode requires a terminal)",
+          startTime,
+          VERSION
+        );
+        return;
+      }
+      try {
+        const { generateTemplateWizardPrompt: generateTemplateWizardPrompt2 } = await Promise.resolve().then(() => (init_wizard_template(), wizard_template_exports));
+        const { readAsset: readAsset2 } = await Promise.resolve().then(() => (init_assets(), assets_exports));
+        const exampleTemplate = readAsset2("template.example.yml");
+        const prompt = generateTemplateWizardPrompt2({ exampleTemplate });
+        respond("create-template", { prompt }, startTime, VERSION);
+      } catch (err) {
+        respondError("create-template", SyncpointErrorCode.UNKNOWN, err.message, startTime, VERSION);
+      }
+      return;
+    }
     const { waitUntilExit } = render2(
       /* @__PURE__ */ jsx3(
         CreateTemplateView,
@@ -1949,6 +2101,21 @@ var HelpView = ({ commandName }) => {
 };
 function registerHelpCommand(program2) {
   program2.command("help [command]").description("Display help information").action(async (commandName) => {
+    const globalOpts = program2.opts();
+    const startTime = Date.now();
+    if (globalOpts.json) {
+      if (commandName) {
+        const commandInfo = COMMANDS[commandName];
+        if (!commandInfo) {
+          respond("help", { error: `Unknown command: ${commandName}`, commands: Object.keys(COMMANDS) }, startTime, VERSION);
+        } else {
+          respond("help", { command: commandInfo }, startTime, VERSION);
+        }
+      } else {
+        respond("help", { commands: COMMANDS }, startTime, VERSION);
+      }
+      return;
+    }
     const { waitUntilExit } = render3(/* @__PURE__ */ jsx4(HelpView, { commandName }));
     await waitUntilExit();
   });
@@ -1959,6 +2126,7 @@ import { join as join9 } from "path";
 import { Box as Box4, Text as Text5, useApp as useApp3 } from "ink";
 import { render as render4 } from "ink";
 import { useEffect as useEffect3, useState as useState3 } from "react";
+init_assets();
 import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 var InitView = () => {
   const { exit } = useApp3();
@@ -2062,6 +2230,18 @@ function registerInitCommand(program2) {
   program2.command("init").description(
     `Initialize ~/.${APP_NAME}/ directory structure and default config`
   ).action(async () => {
+    const globalOpts = program2.opts();
+    const startTime = Date.now();
+    if (globalOpts.json) {
+      try {
+        const result = await initDefaultConfig();
+        respond("init", { created: result.created, skipped: result.skipped }, startTime, VERSION);
+      } catch (error) {
+        const code = classifyError(error);
+        respondError("init", code, error.message, startTime, VERSION);
+      }
+      return;
+    }
     const { waitUntilExit } = render4(/* @__PURE__ */ jsx5(InitView, {}));
     await waitUntilExit();
   });
@@ -2844,11 +3024,72 @@ var ListView = ({ type, deleteIndex }) => {
   return null;
 };
 function registerListCommand(program2) {
-  program2.command("list [type]").description("List backups and templates").option("--delete <n>", "Delete item #n").action(async (type, opts) => {
+  program2.command("list [type]").description("List backups and templates").option("--delete <filename>", "Delete item by filename").action(async (type, opts) => {
+    const globalOpts = program2.opts();
+    const startTime = Date.now();
+    if (globalOpts.json) {
+      try {
+        const config = await loadConfig();
+        if (opts.delete) {
+          const filename = opts.delete;
+          const backupDirectory = config.backup.destination ? resolveTargetPath(config.backup.destination) : getSubDir("backups");
+          const isTemplate = type === "templates";
+          if (isTemplate) {
+            const templates = await listTemplates();
+            const match = templates.find(
+              (t) => t.name === filename || t.name === filename.replace(/\.ya?ml$/, "")
+            );
+            if (!match) {
+              respondError("list", SyncpointErrorCode.INVALID_ARGUMENT, `Template not found: ${filename}`, startTime, VERSION);
+              return;
+            }
+            if (!isInsideDir(match.path, getSubDir("templates"))) {
+              respondError("list", SyncpointErrorCode.INVALID_ARGUMENT, `Refusing to delete file outside templates directory: ${match.path}`, startTime, VERSION);
+              return;
+            }
+            unlinkSync(match.path);
+            respond("list", { deleted: match.name, path: match.path }, startTime, VERSION);
+          } else {
+            const list2 = await getBackupList(config);
+            const match = list2.find(
+              (b) => b.filename === filename || b.filename.startsWith(filename)
+            );
+            if (!match) {
+              respondError("list", SyncpointErrorCode.INVALID_ARGUMENT, `Backup not found: ${filename}`, startTime, VERSION);
+              return;
+            }
+            if (!isInsideDir(match.path, backupDirectory)) {
+              respondError("list", SyncpointErrorCode.INVALID_ARGUMENT, `Refusing to delete file outside backups directory: ${match.path}`, startTime, VERSION);
+              return;
+            }
+            unlinkSync(match.path);
+            respond("list", { deleted: match.filename, path: match.path }, startTime, VERSION);
+          }
+          return;
+        }
+        const showBackups = !type || type === "backups";
+        const showTemplates = !type || type === "templates";
+        const result = {};
+        if (showBackups) {
+          result.backups = await getBackupList(config);
+        }
+        if (showTemplates) {
+          result.templates = await listTemplates();
+        }
+        respond("list", result, startTime, VERSION);
+      } catch (error) {
+        const code = classifyError(error);
+        respondError("list", code, error.message, startTime, VERSION);
+      }
+      return;
+    }
     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: waitUntilExit2 } = render5(
+        /* @__PURE__ */ jsx8(ListView, { type, deleteIndex: void 0 })
+      );
+      await waitUntilExit2();
+      return;
     }
     const { waitUntilExit } = render5(
       /* @__PURE__ */ jsx8(ListView, { type, deleteIndex })
@@ -2865,6 +3106,7 @@ import { useEffect as useEffect5, useState as useState6 } from "react";
 // src/core/migrate.ts
 import { copyFile as copyFile2, readFile as readFile5, writeFile as writeFile4 } from "fs/promises";
 import YAML4 from "yaml";
+init_assets();
 function extractSchemaPaths(schema, prefix = []) {
   const paths = [];
   const properties = schema.properties;
@@ -3085,6 +3327,18 @@ var MigrateView = ({ dryRun }) => {
 };
 function registerMigrateCommand(program2) {
   program2.command("migrate").description("Migrate config.yml to match the current schema").option("--dry-run", "Preview changes without writing").action(async (opts) => {
+    const globalOpts = program2.opts();
+    const startTime = Date.now();
+    if (globalOpts.json) {
+      try {
+        const result = await migrateConfig({ dryRun: opts.dryRun ?? false });
+        respond("migrate", result, startTime, VERSION);
+      } catch (error) {
+        const code = classifyError(error);
+        respondError("migrate", code, error.message, startTime, VERSION);
+      }
+      return;
+    }
     const { waitUntilExit } = render6(
       /* @__PURE__ */ jsx9(MigrateView, { dryRun: opts.dryRun ?? false })
     );
@@ -3396,14 +3650,24 @@ function registerProvisionCommand(program2) {
     false
   ).option("-f, --file <path>", "Path to template file").action(
     async (templateName, opts) => {
+      const globalOpts = program2.opts();
+      const startTime = Date.now();
       let templatePath;
       if (opts.file) {
         templatePath = resolveTargetPath(opts.file);
         if (!await fileExists(templatePath)) {
+          if (globalOpts.json) {
+            respondError("provision", SyncpointErrorCode.TEMPLATE_NOT_FOUND, `Template file not found: ${opts.file}`, startTime, VERSION);
+            return;
+          }
           console.error(`Template file not found: ${opts.file}`);
           process.exit(1);
         }
         if (!templatePath.endsWith(".yml") && !templatePath.endsWith(".yaml")) {
+          if (globalOpts.json) {
+            respondError("provision", SyncpointErrorCode.INVALID_ARGUMENT, `Template file must have .yml or .yaml extension: ${opts.file}`, startTime, VERSION);
+            return;
+          }
           console.error(
             `Template file must have .yml or .yaml extension: ${opts.file}`
           );
@@ -3415,11 +3679,19 @@ function registerProvisionCommand(program2) {
           (t) => t.name === templateName || t.name === `${templateName}.yml` || t.config.name === templateName
         );
         if (!match) {
+          if (globalOpts.json) {
+            respondError("provision", SyncpointErrorCode.TEMPLATE_NOT_FOUND, `Template not found: ${templateName}`, startTime, VERSION);
+            return;
+          }
           console.error(`Template not found: ${templateName}`);
           process.exit(1);
         }
         templatePath = match.path;
       } else {
+        if (globalOpts.json) {
+          respondError("provision", SyncpointErrorCode.MISSING_ARGUMENT, "Either <template> name or --file option must be provided", startTime, VERSION);
+          return;
+        }
         console.error(
           "Error: Either <template> name or --file option must be provided"
         );
@@ -3431,6 +3703,30 @@ function registerProvisionCommand(program2) {
       if (tmpl.sudo && !opts.dryRun) {
         ensureSudo(tmpl.name);
       }
+      if (globalOpts.json) {
+        try {
+          const collectedSteps = [];
+          const generator = runProvision(templatePath, {
+            dryRun: opts.dryRun,
+            skipRestore: opts.skipRestore
+          });
+          for await (const result of generator) {
+            if (result.status !== "running") {
+              collectedSteps.push(result);
+            }
+          }
+          respond(
+            "provision",
+            { steps: collectedSteps, totalDuration: Date.now() - startTime },
+            startTime,
+            VERSION
+          );
+        } catch (error) {
+          const code = classifyError(error);
+          respondError("provision", code, error.message, startTime, VERSION);
+        }
+        return;
+      }
       const { waitUntilExit } = render7(
         /* @__PURE__ */ jsx11(
           ProvisionView,
@@ -3666,6 +3962,52 @@ var RestoreView = ({ filename, options }) => {
 };
 function registerRestoreCommand(program2) {
   program2.command("restore [filename]").description("Restore config files from a backup").option("--dry-run", "Show planned changes without actual restore", false).action(async (filename, opts) => {
+    const globalOpts = program2.opts();
+    const startTime = Date.now();
+    if (globalOpts.json) {
+      if (!filename) {
+        respondError(
+          "restore",
+          SyncpointErrorCode.MISSING_ARGUMENT,
+          "filename argument is required in --json mode",
+          startTime,
+          VERSION
+        );
+        return;
+      }
+      try {
+        const config = await loadConfig();
+        const list2 = await getBackupList(config);
+        const match = list2.find(
+          (b) => b.filename === filename || b.filename.startsWith(filename)
+        );
+        if (!match) {
+          respondError(
+            "restore",
+            SyncpointErrorCode.RESTORE_FAILED,
+            `Backup not found: ${filename}`,
+            startTime,
+            VERSION
+          );
+          return;
+        }
+        const result = await restoreBackup(match.path, { dryRun: opts.dryRun });
+        respond(
+          "restore",
+          {
+            restoredFiles: result.restoredFiles,
+            skippedFiles: result.skippedFiles,
+            safetyBackupPath: result.safetyBackupPath ?? null
+          },
+          startTime,
+          VERSION
+        );
+      } catch (error) {
+        const code = classifyError(error);
+        respondError("restore", code, error.message, startTime, VERSION);
+      }
+      return;
+    }
     const { waitUntilExit } = render8(
       /* @__PURE__ */ jsx12(RestoreView, { filename, options: { dryRun: opts.dryRun } })
     );
@@ -4080,6 +4422,34 @@ var StatusView = ({ cleanup }) => {
 };
 function registerStatusCommand(program2) {
   program2.command("status").description(`Show ~/.${APP_NAME}/ status summary`).option("--cleanup", "Interactive cleanup mode", false).action(async (opts) => {
+    const globalOpts = program2.opts();
+    const startTime = Date.now();
+    if (globalOpts.json) {
+      try {
+        const config = await loadConfig();
+        const backupDirectory = config.backup.destination ? resolveTargetPath(config.backup.destination) : getSubDir("backups");
+        const backupStats = getDirStats(backupDirectory);
+        const templateStats = getDirStats(getSubDir("templates"));
+        const scriptStats = getDirStats(getSubDir("scripts"));
+        const logStats = getDirStats(getSubDir("logs"));
+        const backupList = await getBackupList(config);
+        const lastBackup = backupList.length > 0 ? backupList[0].createdAt : null;
+        const oldestBackup = backupList.length > 0 ? backupList[backupList.length - 1].createdAt : null;
+        const statusInfo = {
+          backups: backupStats,
+          templates: templateStats,
+          scripts: scriptStats,
+          logs: logStats,
+          lastBackup: lastBackup ?? void 0,
+          oldestBackup: oldestBackup ?? void 0
+        };
+        respond("status", statusInfo, startTime, VERSION);
+      } catch (error) {
+        const code = classifyError(error);
+        respondError("status", code, error.message, startTime, VERSION);
+      }
+      return;
+    }
     const { waitUntilExit } = render9(/* @__PURE__ */ jsx13(StatusView, { cleanup: opts.cleanup }));
     await waitUntilExit();
   });
@@ -4137,6 +4507,9 @@ ${variables.defaultConfig}
 **Start by greeting the user and asking about their backup priorities. After understanding their needs, write the config.yml file directly.**`;
 }
 
+// src/commands/Wizard.tsx
+init_assets();
+
 // src/utils/file-scanner.ts
 import { stat as stat3 } from "fs/promises";
 import { join as join13 } from "path";
@@ -4494,6 +4867,27 @@ function registerWizardCommand(program2) {
     cmd.option(opt.flag, opt.description);
   });
   cmd.action(async (opts) => {
+    const globalOpts = program2.opts();
+    const startTime = Date.now();
+    if (globalOpts.json) {
+      if (!opts.print) {
+        respondError(
+          "wizard",
+          SyncpointErrorCode.MISSING_ARGUMENT,
+          "--print is required in --json mode (interactive mode requires a terminal)",
+          startTime,
+          VERSION
+        );
+        return;
+      }
+      try {
+        const scanResult = await runScanPhase();
+        respond("wizard", { prompt: scanResult.prompt }, startTime, VERSION);
+      } catch (err) {
+        respondError("wizard", SyncpointErrorCode.UNKNOWN, err.message, startTime, VERSION);
+      }
+      return;
+    }
     if (opts.print) {
       const { waitUntilExit } = render10(/* @__PURE__ */ jsx14(WizardView, { printMode: true }));
       await waitUntilExit();
@@ -4530,7 +4924,7 @@ function registerWizardCommand(program2) {
 var program = new Command();
 program.name("syncpoint").description(
   "Personal Environment Manager \u2014 Config backup/restore and machine provisioning CLI"
-).version(VERSION);
+).version(VERSION).option("--json", "Output structured JSON to stdout").option("--yes", "Skip confirmation prompts (non-interactive mode)");
 registerInitCommand(program);
 registerWizardCommand(program);
 registerBackupCommand(program);
@@ -4541,7 +4935,34 @@ registerListCommand(program);
 registerMigrateCommand(program);
 registerStatusCommand(program);
 registerHelpCommand(program);
+if (process.argv.includes("--describe")) {
+  const startTime = Date.now();
+  const globalOptions = [
+    { flag: "--json", description: "Output structured JSON to stdout", type: "boolean" },
+    { flag: "--yes", description: "Skip confirmation prompts (non-interactive mode)", type: "boolean" },
+    { flag: "--describe", description: "Print CLI schema as JSON and exit", type: "boolean" },
+    { flag: "-V, --version", description: "Output the version number", type: "boolean" },
+    { flag: "-h, --help", description: "Display help for command", type: "boolean" }
+  ];
+  respond(
+    "describe",
+    {
+      name: "syncpoint",
+      version: VERSION,
+      description: program.description(),
+      globalOptions,
+      commands: COMMANDS
+    },
+    startTime,
+    VERSION
+  );
+  process.exit(0);
+}
 program.parseAsync(process.argv).catch((error) => {
+  if (process.argv.includes("--json")) {
+    respondError("unknown", SyncpointErrorCode.UNKNOWN, error.message, Date.now(), VERSION);
+    process.exit(1);
+  }
   console.error("Fatal error:", error.message);
   process.exit(1);
 });

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+export declare const SyncpointErrorCode: {
+    readonly CONFIG_NOT_FOUND: "CONFIG_NOT_FOUND";
+    readonly CONFIG_INVALID: "CONFIG_INVALID";
+    readonly BACKUP_FAILED: "BACKUP_FAILED";
+    readonly RESTORE_FAILED: "RESTORE_FAILED";
+    readonly TEMPLATE_NOT_FOUND: "TEMPLATE_NOT_FOUND";
+    readonly PROVISION_FAILED: "PROVISION_FAILED";
+    readonly MISSING_ARGUMENT: "MISSING_ARGUMENT";
+    readonly INVALID_ARGUMENT: "INVALID_ARGUMENT";
+    readonly UNKNOWN: "UNKNOWN";
+};
+export type SyncpointErrorCode = (typeof SyncpointErrorCode)[keyof typeof SyncpointErrorCode];
+/**
+ * Classify an error into a SyncpointErrorCode based on the error message.
+ */
+export declare function classifyError(err: unknown): SyncpointErrorCode;

package/dist/index.cjs

@@ -646,7 +646,7 @@ function validateMetadata(data) {
 }
 
 // src/version.ts
-var VERSION = "0.0.8";
+var VERSION = "0.0.10";
 
 // src/core/metadata.ts
 var METADATA_VERSION = "1.0.0";

package/dist/index.mjs

@@ -596,7 +596,7 @@ function validateMetadata(data) {
 }
 
 // src/version.ts
-var VERSION = "0.0.8";
+var VERSION = "0.0.10";
 
 // src/core/metadata.ts
 var METADATA_VERSION = "1.0.0";

package/dist/utils/command-registry.d.ts

@@ -5,6 +5,7 @@
 export interface CommandOption {
     flag: string;
     description: string;
+    type?: 'boolean' | 'string' | 'number';
     default?: string;
 }
 export interface CommandArgument {

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.8";
+export declare const VERSION = "0.0.10";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumy-pack/syncpoint",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "description": "CLI tool for project synchronization and scaffolding",
   "keywords": [
     "cli",
@@ -56,7 +56,6 @@
     "version:patch": "yarn version patch"
   },
   "dependencies": {
-    "@lumy-pack/shared": "0.0.1",
     "ajv": "^8.0.0",
     "ajv-formats": "^3.0.0",
     "commander": "^12.1.0",
@@ -71,6 +70,7 @@
     "yaml": "^2.0.0"
   },
   "devDependencies": {
+    "@lumy-pack/shared": "0.0.1",
     "@types/micromatch": "^4.0.9",
     "@types/node": "^20.11.0",
     "@types/react": "^18.0.0",