@lumy-pack/syncpoint 0.0.8 → 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";
@@ -843,18 +959,12 @@ var config_schema_default = {
   title: "Syncpoint Config",
   description: "Configuration for syncpoint backup tool",
   type: "object",
-  required: [
-    "backup"
-  ],
+  required: ["backup"],
   properties: {
     backup: {
       type: "object",
       description: "Backup configuration",
-      required: [
-        "targets",
-        "exclude",
-        "filename"
-      ],
+      required: ["targets", "exclude", "filename"],
       properties: {
         targets: {
           type: "array",
@@ -918,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);
@@ -1000,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: {
@@ -1015,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: [
@@ -1030,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: [
@@ -1061,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: [
@@ -1084,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: [
@@ -1117,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: [
@@ -1137,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",
@@ -1149,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",
@@ -1163,7 +1293,8 @@ var COMMANDS = {
     options: [
       {
         flag: "--dry-run",
-        description: "Preview changes without writing"
+        description: "Preview changes without writing",
+        type: "boolean"
       }
     ],
     examples: [
@@ -1210,7 +1341,11 @@ var BackupView = ({ options }) => {
     for (const f of foundFiles) {
       if (seen.has(f.absolutePath)) continue;
       seen.add(f.absolutePath);
-      deduped.push({ id: `found-${f.absolutePath}`, type: "found", file: f });
+      deduped.push({
+        id: `found-${f.absolutePath}`,
+        type: "found",
+        file: f
+      });
     }
     for (const p of missingFiles) {
       if (seen.has(p)) continue;
@@ -1334,21 +1469,60 @@ function registerBackupCommand(program2) {
   cmdInfo.options?.forEach((opt) => {
     cmd.option(opt.flag, opt.description);
   });
-  cmd.action(async (opts) => {
-    const { waitUntilExit } = render(
-      /* @__PURE__ */ jsx2(BackupView, { options: { dryRun: opts.dryRun, tag: opts.tag, verbose: opts.verbose } })
-    );
-    await waitUntilExit();
-  });
+  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,
+          {
+            options: {
+              dryRun: opts.dryRun,
+              tag: opts.tag,
+              verbose: opts.verbose
+            }
+          }
+        )
+      );
+      await waitUntilExit();
+    }
+  );
 }
 
 // src/commands/CreateTemplate.tsx
-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 join8 } from "path";
 import { writeFile as writeFile3 } from "fs/promises";
+import { join as join8 } from "path";
+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";
+init_wizard_template();
 
 // assets/schemas/template.schema.json
 var template_schema_default = {
@@ -1424,45 +1598,8 @@ function validateTemplate(data) {
   return { valid: false, errors };
 }
 
-// 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.`;
-}
+// src/commands/CreateTemplate.tsx
+init_assets();
 
 // src/utils/claude-code-runner.ts
 import { spawn } from "child_process";
@@ -1566,6 +1703,39 @@ Start by asking the user about their backup priorities for the home directory st
   });
 }
 
+// src/utils/error-formatter.ts
+function formatValidationErrors(errors) {
+  if (errors.length === 0) {
+    return "No validation errors.";
+  }
+  const formattedErrors = errors.map((error, index) => {
+    return `${index + 1}. ${error}`;
+  });
+  return `Validation failed with ${errors.length} error(s):
+
+${formattedErrors.join("\n")}`;
+}
+function createRetryPrompt(originalPrompt, errors, attemptNumber) {
+  const errorSummary = formatValidationErrors(errors);
+  return `${originalPrompt}
+
+---
+
+**VALIDATION FAILED (Attempt ${attemptNumber})**
+
+The previously generated YAML configuration did not pass validation:
+
+${errorSummary}
+
+Please analyze these errors and generate a corrected YAML configuration that addresses all validation issues.
+
+Remember:
+- Output pure YAML only (no markdown, no code blocks, no explanations)
+- Ensure all required fields are present
+- Follow the correct schema structure
+- Validate pattern syntax for targets and exclude arrays`;
+}
+
 // src/utils/yaml-parser.ts
 import YAML2 from "yaml";
 function isStructuredYAML(parsed) {
@@ -1603,39 +1773,6 @@ function parseYAML(yamlString) {
   return YAML2.parse(yamlString);
 }
 
-// src/utils/error-formatter.ts
-function formatValidationErrors(errors) {
-  if (errors.length === 0) {
-    return "No validation errors.";
-  }
-  const formattedErrors = errors.map((error, index) => {
-    return `${index + 1}. ${error}`;
-  });
-  return `Validation failed with ${errors.length} error(s):
-
-${formattedErrors.join("\n")}`;
-}
-function createRetryPrompt(originalPrompt, errors, attemptNumber) {
-  const errorSummary = formatValidationErrors(errors);
-  return `${originalPrompt}
-
----
-
-**VALIDATION FAILED (Attempt ${attemptNumber})**
-
-The previously generated YAML configuration did not pass validation:
-
-${errorSummary}
-
-Please analyze these errors and generate a corrected YAML configuration that addresses all validation issues.
-
-Remember:
-- Output pure YAML only (no markdown, no code blocks, no explanations)
-- Ensure all required fields are present
-- Follow the correct schema structure
-- Validate pattern syntax for targets and exclude arrays`;
-}
-
 // src/commands/CreateTemplate.tsx
 import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
 var MAX_RETRIES = 3;
@@ -1685,7 +1822,9 @@ var CreateTemplateView = ({
     while (currentAttempt <= MAX_RETRIES) {
       try {
         setPhase("llm-invoke");
-        setMessage(`Generating template... (Attempt ${currentAttempt}/${MAX_RETRIES})`);
+        setMessage(
+          `Generating template... (Attempt ${currentAttempt}/${MAX_RETRIES})`
+        );
         const result = currentSessionId ? await resumeClaudeCodeSession(currentSessionId, currentPrompt) : await invokeClaudeCode(currentPrompt);
         if (!result.success) {
           throw new Error(result.error || "Failed to invoke Claude Code");
@@ -1762,8 +1901,11 @@ ${formatValidationErrors(validation.errors || [])}`
       /* @__PURE__ */ jsx3(Text3, { color: "green", children: message }),
       /* @__PURE__ */ jsxs3(Box2, { marginTop: 1, children: [
         /* @__PURE__ */ jsx3(Text3, { children: "Next steps:" }),
-        /* @__PURE__ */ jsx3(Text3, { children: "  1. Review your template: syncpoint list templates" }),
-        /* @__PURE__ */ jsx3(Text3, { children: "  2. Run provisioning: syncpoint provision <template-name>" })
+        /* @__PURE__ */ jsx3(Text3, { children: " 1. Review your template: syncpoint list templates" }),
+        /* @__PURE__ */ jsxs3(Text3, { children: [
+          " ",
+          "2. Run provisioning: syncpoint provision <template-name>"
+        ] })
       ] })
     ] });
   }
@@ -1783,8 +1925,38 @@ ${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, { printMode: opts.print || false, templateName: name })
+      /* @__PURE__ */ jsx3(
+        CreateTemplateView,
+        {
+          printMode: opts.print || false,
+          templateName: name
+        }
+      )
     );
     await waitUntilExit();
   });
@@ -1929,16 +2101,32 @@ 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();
   });
 }
 
 // src/commands/Init.tsx
-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 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();
@@ -1980,9 +2168,15 @@ var InitView = () => {
           setSteps([...completed]);
         }
         await initDefaultConfig();
-        completed.push({ name: `Created ${CONFIG_FILENAME} (defaults)`, done: true });
+        completed.push({
+          name: `Created ${CONFIG_FILENAME} (defaults)`,
+          done: true
+        });
         setSteps([...completed]);
-        const exampleTemplatePath = join9(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 exampleYaml = readAsset("template.example.yml");
@@ -2033,7 +2227,21 @@ var InitView = () => {
   ] });
 };
 function registerInitCommand(program2) {
-  program2.command("init").description(`Initialize ~/.${APP_NAME}/ directory structure and default config`).action(async () => {
+  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();
   });
@@ -2084,7 +2292,7 @@ var Confirm = ({
 };
 
 // src/components/Table.tsx
-import { Text as Text7, Box as Box5 } from "ink";
+import { Box as Box5, Text as Text7 } from "ink";
 import { jsx as jsx7, jsxs as jsxs7 } from "react/jsx-runtime";
 var Table = ({
   headers,
@@ -2555,7 +2763,9 @@ var ListView = ({ type, deleteIndex }) => {
     if (yes && deleteTarget) {
       try {
         if (!isInsideDir(deleteTarget.path, backupDir)) {
-          throw new Error(`Refusing to delete file outside backups directory: ${deleteTarget.path}`);
+          throw new Error(
+            `Refusing to delete file outside backups directory: ${deleteTarget.path}`
+          );
         }
         unlinkSync(deleteTarget.path);
         const deletedName = deleteTarget.name;
@@ -2814,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 })
@@ -2828,13 +3099,14 @@ function registerListCommand(program2) {
 }
 
 // src/commands/Migrate.tsx
-import { useState as useState6, useEffect as useEffect5 } from "react";
-import { Text as Text9, Box as Box7, useApp as useApp5 } from "ink";
+import { Box as Box7, Text as Text9, useApp as useApp5 } from "ink";
 import { render as render6 } from "ink";
+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;
@@ -3055,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 })
     );
@@ -3063,44 +3347,12 @@ function registerMigrateCommand(program2) {
 }
 
 // src/commands/Provision.tsx
-import { useState as useState7, useEffect as useEffect6 } from "react";
-import { Text as Text11, Box as Box9, useApp as useApp6 } from "ink";
+import { Box as Box9, Text as Text11, useApp as useApp6 } from "ink";
 import { render as render7 } from "ink";
-
-// src/utils/sudo.ts
-import { execSync } from "child_process";
-import pc2 from "picocolors";
-function isSudoCached() {
-  try {
-    execSync("sudo -n true", { stdio: "ignore" });
-    return true;
-  } catch {
-    return false;
-  }
-}
-function ensureSudo(templateName) {
-  if (isSudoCached()) return;
-  console.log(
-    `
-${pc2.yellow("\u26A0")} Template ${pc2.bold(templateName)} requires ${pc2.bold("sudo")} privileges.`
-  );
-  console.log(
-    pc2.gray("  Some provisioning steps need elevated permissions to execute.")
-  );
-  console.log(pc2.gray("  You will be prompted for your password.\n"));
-  try {
-    execSync("sudo -v", { stdio: "inherit", timeout: 6e4 });
-  } catch {
-    console.error(
-      `
-${pc2.red("\u2717")} Sudo authentication failed or was cancelled. Aborting.`
-    );
-    process.exit(1);
-  }
-}
+import { useEffect as useEffect6, useState as useState7 } from "react";
 
 // src/components/StepRunner.tsx
-import { Text as Text10, Box as Box8, Static as Static2 } from "ink";
+import { Box as Box8, Static as Static2, Text as Text10 } from "ink";
 import Spinner2 from "ink-spinner";
 import { jsx as jsx10, jsxs as jsxs10 } from "react/jsx-runtime";
 var StepIcon = ({ status }) => {
@@ -3169,10 +3421,7 @@ var StepItemView = ({
     /* @__PURE__ */ jsx10(StepStatusText, { step })
   ] })
 ] });
-var StepRunner = ({
-  steps,
-  total
-}) => {
+var StepRunner = ({ steps, total }) => {
   const completedSteps = [];
   const activeSteps = [];
   steps.forEach((step, idx) => {
@@ -3208,6 +3457,38 @@ var StepRunner = ({
   ] });
 };
 
+// src/utils/sudo.ts
+import { execSync } from "child_process";
+import pc2 from "picocolors";
+function isSudoCached() {
+  try {
+    execSync("sudo -n true", { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function ensureSudo(templateName) {
+  if (isSudoCached()) return;
+  console.log(
+    `
+${pc2.yellow("\u26A0")} Template ${pc2.bold(templateName)} requires ${pc2.bold("sudo")} privileges.`
+  );
+  console.log(
+    pc2.gray("  Some provisioning steps need elevated permissions to execute.")
+  );
+  console.log(pc2.gray("  You will be prompted for your password.\n"));
+  try {
+    execSync("sudo -v", { stdio: "inherit", timeout: 6e4 });
+  } catch {
+    console.error(
+      `
+${pc2.red("\u2717")} Sudo authentication failed or was cancelled. Aborting.`
+    );
+    process.exit(1);
+  }
+}
+
 // src/commands/Provision.tsx
 import { jsx as jsx11, jsxs as jsxs11 } from "react/jsx-runtime";
 var ProvisionView = ({
@@ -3216,7 +3497,9 @@ var ProvisionView = ({
   options
 }) => {
   const { exit } = useApp6();
-  const [phase, setPhase] = useState7(options.dryRun ? "done" : "running");
+  const [phase, setPhase] = useState7(
+    options.dryRun ? "done" : "running"
+  );
   const [steps, setSteps] = useState7(
     template.steps.map((s) => ({
       name: s.name,
@@ -3361,17 +3644,33 @@ 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).option("-f, --file <path>", "Path to template file").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 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")) {
-          console.error(`Template file must have .yml or .yaml extension: ${opts.file}`);
+          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}`
+          );
           process.exit(1);
         }
       } else if (templateName) {
@@ -3380,12 +3679,22 @@ 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 {
-        console.error("Error: Either <template> name or --file option must be provided");
+        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"
+        );
         console.error("Usage: syncpoint provision <template> [options]");
         console.error("       syncpoint provision --file <path> [options]");
         process.exit(1);
@@ -3394,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,
@@ -3413,10 +3746,10 @@ function registerProvisionCommand(program2) {
 }
 
 // src/commands/Restore.tsx
-import { useState as useState8, useEffect as useEffect7 } from "react";
-import { Text as Text12, Box as Box10, useApp as useApp7 } from "ink";
-import SelectInput2 from "ink-select-input";
+import { Box as Box10, Text as Text12, useApp as useApp7 } from "ink";
 import { render as render8 } from "ink";
+import SelectInput2 from "ink-select-input";
+import { useEffect as useEffect7, useState as useState8 } from "react";
 import { jsx as jsx12, jsxs as jsxs12 } from "react/jsx-runtime";
 var RestoreView = ({ filename, options }) => {
   const { exit } = useApp7();
@@ -3629,14 +3962,54 @@ 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 { waitUntilExit } = render8(
-      /* @__PURE__ */ jsx12(
-        RestoreView,
-        {
-          filename,
-          options: { dryRun: opts.dryRun }
+    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 } })
     );
     await waitUntilExit();
   });
@@ -3787,7 +4160,10 @@ var StatusView = ({ cleanup }) => {
       if (cleanupAction === "keep-recent-5") {
         const toDelete = backups.slice(5);
         for (const b of toDelete) {
-          if (!isInsideDir(b.path, backupDir)) throw new Error(`Refusing to delete file outside backups directory: ${b.path}`);
+          if (!isInsideDir(b.path, backupDir))
+            throw new Error(
+              `Refusing to delete file outside backups directory: ${b.path}`
+            );
           unlinkSync2(b.path);
         }
       } else if (cleanupAction === "older-than-30") {
@@ -3795,7 +4171,10 @@ var StatusView = ({ cleanup }) => {
         cutoff.setDate(cutoff.getDate() - 30);
         const toDelete = backups.filter((b) => b.createdAt < cutoff);
         for (const b of toDelete) {
-          if (!isInsideDir(b.path, backupDir)) throw new Error(`Refusing to delete file outside backups directory: ${b.path}`);
+          if (!isInsideDir(b.path, backupDir))
+            throw new Error(
+              `Refusing to delete file outside backups directory: ${b.path}`
+            );
           unlinkSync2(b.path);
         }
       } else if (cleanupAction === "delete-logs") {
@@ -3804,7 +4183,10 @@ var StatusView = ({ cleanup }) => {
           const entries = readdirSync(logsDir);
           for (const entry of entries) {
             const logPath = join12(logsDir, entry);
-            if (!isInsideDir(logPath, logsDir)) throw new Error(`Refusing to delete file outside logs directory: ${logPath}`);
+            if (!isInsideDir(logPath, logsDir))
+              throw new Error(
+                `Refusing to delete file outside logs directory: ${logPath}`
+              );
             try {
               if (statSync(logPath).isFile()) {
                 unlinkSync2(logPath);
@@ -3816,7 +4198,10 @@ var StatusView = ({ cleanup }) => {
         }
       } else if (cleanupAction === "select-specific") {
         for (const b of selectedForDeletion) {
-          if (!isInsideDir(b.path, backupDir)) throw new Error(`Refusing to delete file outside backups directory: ${b.path}`);
+          if (!isInsideDir(b.path, backupDir))
+            throw new Error(
+              `Refusing to delete file outside backups directory: ${b.path}`
+            );
           unlinkSync2(b.path);
         }
       }
@@ -4037,13 +4422,47 @@ 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();
   });
 }
 
 // src/commands/Wizard.tsx
-import { copyFile as copyFile3, readFile as readFile6, rename, unlink, writeFile as writeFile5 } from "fs/promises";
+import {
+  copyFile as copyFile3,
+  readFile as readFile6,
+  rename,
+  unlink,
+  writeFile as writeFile5
+} from "fs/promises";
 import { join as join14 } from "path";
 import { Box as Box12, Text as Text14, useApp as useApp9 } from "ink";
 import { render as render10 } from "ink";
@@ -4088,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";
@@ -4445,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();
@@ -4481,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);
@@ -4492,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);
 });