mova-claude-import 0.1.1 → 0.1.2

package/schemas/mova.control_v0.schema.json

@@ -0,0 +1,252 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mova.dev/schemas/mova.control_v0.schema.json",
+  "type": "object",
+  "required": ["version", "claude_md", "overlay", "settings", "mcp", "policy", "assets", "observability"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "version": {
+      "type": "string",
+      "const": "control_v0"
+    },
+    "claude_md": {
+      "type": "object",
+      "required": ["inject_control_entry", "marker", "priority_sources"],
+      "additionalProperties": false,
+      "properties": {
+        "inject_control_entry": { "type": "boolean" },
+        "marker": { "type": "string" },
+        "priority_sources": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "claude_memory": {
+      "type": "object",
+      "required": ["enable", "sources"],
+      "additionalProperties": false,
+      "properties": {
+        "enable": { "type": "boolean" },
+        "sources": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "overlay": {
+      "type": "object",
+      "required": ["enable"],
+      "additionalProperties": false,
+      "properties": {
+        "enable": { "type": "boolean" }
+      }
+    },
+    "settings": {
+      "type": "object",
+      "required": ["include_co_authored_by", "env"],
+      "additionalProperties": false,
+      "properties": {
+        "include_co_authored_by": { "type": "boolean" },
+        "env": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        }
+      }
+    },
+    "mcp": {
+      "type": "object",
+      "required": [
+        "servers",
+        "enable_all_project_mcp_servers",
+        "enabled_mcpjson_servers",
+        "env_substitutions"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "servers": {
+          "anyOf": [
+            {
+              "type": "array"
+            },
+            {
+              "type": "object"
+            }
+          ]
+        },
+        "enable_all_project_mcp_servers": { "type": "boolean" },
+        "enabled_mcpjson_servers": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "env_substitutions": {
+          "type": "object",
+          "required": ["format", "default_format"],
+          "additionalProperties": false,
+          "properties": {
+            "format": { "type": "string" },
+            "default_format": { "type": "string" }
+          }
+        }
+      }
+    },
+    "policy": {
+      "type": "object",
+      "required": ["mode", "hooks", "permissions", "plugins"],
+      "additionalProperties": false,
+      "properties": {
+        "mode": { "type": "string" },
+        "hooks": {
+          "type": "object",
+          "required": ["enable", "on_invalid_hook", "definitions", "events"],
+          "additionalProperties": false,
+          "properties": {
+            "enable": { "type": "boolean" },
+            "on_invalid_hook": { "type": "string" },
+            "definitions": { "type": "array" },
+            "events": {
+              "type": "object",
+              "additionalProperties": true
+            }
+          }
+        },
+        "permissions": {
+          "type": "object",
+          "required": ["allow", "deny", "on_conflict", "on_unknown"],
+          "additionalProperties": false,
+          "properties": {
+            "allow": { "type": "array" },
+            "deny": { "type": "array" },
+            "on_conflict": { "type": "string" },
+            "on_unknown": { "type": "string" }
+          }
+        },
+        "plugins": {
+          "type": "object",
+          "required": ["enable", "allowed_plugin_ids", "denied_plugin_ids", "on_unknown", "enabled_plugins"],
+          "additionalProperties": false,
+          "properties": {
+            "enable": { "type": "boolean" },
+            "allowed_plugin_ids": { "type": "array" },
+            "denied_plugin_ids": { "type": "array" },
+            "on_unknown": { "type": "string" },
+            "enabled_plugins": {
+              "type": "object",
+              "additionalProperties": { "type": "boolean" }
+            }
+          }
+        }
+      }
+    },
+    "lsp": {
+      "type": "object",
+      "required": ["enabled_plugins", "config_path", "managed"],
+      "additionalProperties": false,
+      "properties": {
+        "enabled_plugins": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "config_path": { "type": "string" },
+        "managed": { "type": "boolean" }
+      }
+    },
+    "skill_eval": {
+      "type": "object",
+      "required": ["enable", "hooks", "rules_path", "scoring"],
+      "additionalProperties": false,
+      "properties": {
+        "enable": { "type": "boolean" },
+        "hooks": {
+          "type": "object",
+          "required": ["shell", "node"],
+          "additionalProperties": false,
+          "properties": {
+            "shell": { "type": "string" },
+            "node": { "type": "string" }
+          }
+        },
+        "rules_path": { "type": "string" },
+        "scoring": {
+          "type": "object",
+          "required": ["threshold"],
+          "additionalProperties": false,
+          "properties": {
+            "threshold": { "type": "number" }
+          }
+        }
+      }
+    },
+    "observability": {
+      "type": "object",
+      "required": [
+        "enable",
+        "mode",
+        "writer",
+        "output_dir",
+        "stdout_tail_bytes",
+        "stderr_tail_bytes",
+        "max_event_bytes",
+        "tail_lines",
+        "include_tools",
+        "include_events"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "enable": { "type": "boolean" },
+        "mode": { "type": "string" },
+        "writer": {
+          "type": "object",
+          "required": ["type", "script_path"],
+          "additionalProperties": false,
+          "properties": {
+            "type": { "type": "string", "const": "node" },
+            "script_path": { "type": "string" }
+          }
+        },
+        "output_dir": { "type": "string" },
+        "stdout_tail_bytes": { "type": "number" },
+        "stderr_tail_bytes": { "type": "number" },
+        "max_event_bytes": { "type": "number" },
+        "tail_lines": { "type": "number" },
+        "include_tools": { "type": "array", "items": { "type": "string" } },
+        "include_events": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "assets": {
+      "type": "object",
+      "required": ["skills", "agents", "commands", "rules", "hooks", "workflows", "docs", "dotfiles", "schemas"],
+      "additionalProperties": false,
+      "properties": {
+        "skills": { "$ref": "#/$defs/asset_list" },
+        "agents": { "$ref": "#/$defs/asset_list" },
+        "commands": { "$ref": "#/$defs/asset_list" },
+        "rules": { "$ref": "#/$defs/asset_list" },
+        "hooks": { "$ref": "#/$defs/asset_list" },
+        "workflows": { "$ref": "#/$defs/asset_list" },
+        "docs": { "$ref": "#/$defs/asset_list" },
+        "dotfiles": { "$ref": "#/$defs/asset_list" },
+        "schemas": { "$ref": "#/$defs/asset_list" }
+      }
+    }
+  },
+  "$defs": {
+    "asset_list": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/asset_item" }
+    },
+    "asset_item": {
+      "type": "object",
+      "required": ["path", "mode"],
+      "additionalProperties": false,
+      "properties": {
+        "path": { "type": "string" },
+        "mode": { "type": "string", "enum": ["copy_through", "managed"] },
+        "source_path": { "type": "string" }
+      }
+    }
+  }
+}

package/src/anthropic_profile_v0.ts

@@ -7,6 +7,7 @@ export const anthropicProfileV0RequiredFiles = [
   ".claude/commands/mova_context.md",
   ".claude/commands/mova_lint.md",
   ".claude/skills/mova-layer-v0/SKILL.md",
+  "mova/control_v0.json",
 ] as const;
 
 export function getAnthropicProfileV0Files(): Record<string, string> {

package/src/cli.ts

@@ -3,6 +3,8 @@ import { initProfileV0 } from "./init_v0.js";
 import { controlPrefillV0 } from "./control_prefill_v0.js";
 import { controlCheckV0 } from "./control_check_v0.js";
 import { controlApplyV0 } from "./control_apply_v0.js";
+import { listObservabilityRuns, readObservabilitySummary, tailObservabilityEvents } from "./observe_v0.js";
+import { listPresets, readPresetControlRaw, resolvePreset } from "./presets_v0.js";
 
 function getArg(name: string): string | undefined {
   const idx = process.argv.indexOf(name);
@@ -18,10 +20,15 @@ function usage(exitCode = 0) {
     "",
     "Usage:",
     "  mova-claude-import --project <dir> [--out <dir>] [--dry-run] [--strict] [--include-local] [--include-user-settings] [--no-emit-profile] [--no-emit-overlay] [--zip] [--zip-name <name>]",
-    "  mova-claude-import init --out <dir> [--zip]",
+    "  mova-claude-import init --out <dir> [--zip] [--preset <name>]",
     "  mova-claude-import control prefill --project <dir> --out <dir> [--include-local]",
     "  mova-claude-import control check --project <dir> --profile <file>",
-    "  mova-claude-import control apply --project <dir> --profile <file> [--mode preview|apply]",
+    "  mova-claude-import control apply --project <dir> --profile <file> [--mode preview|apply|overlay] [--preset <name>]",
+    "  mova-claude-import preset list",
+    "  mova-claude-import preset show <name>",
+    "  mova-claude-import observe list --project <dir>",
+    "  mova-claude-import observe tail --project <dir> --run <id> [--limit <n>]",
+    "  mova-claude-import observe summary --project <dir> --run <id>",
     "",
     "Notes:",
     "  - CLAUDE.local.md and *.local.* are excluded unless --include-local",
@@ -30,6 +37,7 @@ function usage(exitCode = 0) {
     "  - overlay emission is enabled by default; use --no-emit-overlay to skip",
     "  - zip export is disabled by default; use --zip to enable",
     "  - init creates a clean Anthropic profile v0 scaffold",
+    "  - init --preset uses preset control_v0.json + assets",
     "  - control commands run in preview by default",
   ].join("\n"));
   process.exit(exitCode);
@@ -49,15 +57,41 @@ if (subcommand === "init") {
     process.exit(2);
   }
   const emitZip = hasFlag("--zip");
-  initProfileV0(out, emitZip)
-    .then((res) => {
-      process.stdout.write(JSON.stringify(res, null, 2) + "\n");
-      process.exit(0);
-    })
-    .catch((err) => {
-      console.error(err);
-      process.exit(1);
-    });
+  const presetName = getArg("--preset");
+  if (presetName) {
+    resolvePreset(presetName)
+      .then(async (preset) => {
+        if (!preset) {
+          console.error(`Preset not found: ${presetName}`);
+          process.exit(2);
+        }
+        const raw = await readPresetControlRaw(presetName);
+        const control = raw ? JSON.parse(raw) : null;
+        if (!control) {
+          console.error(`Preset control missing: ${presetName}`);
+          process.exit(2);
+        }
+        return initProfileV0(out, emitZip, { controlOverride: control, assetsRoot: preset.assets_root });
+      })
+      .then((res) => {
+        process.stdout.write(JSON.stringify(res, null, 2) + "\n");
+        process.exit(0);
+      })
+      .catch((err) => {
+        console.error(err);
+        process.exit(1);
+      });
+  } else {
+    initProfileV0(out, emitZip)
+      .then((res) => {
+        process.stdout.write(JSON.stringify(res, null, 2) + "\n");
+        process.exit(0);
+      })
+      .catch((err) => {
+        console.error(err);
+        process.exit(1);
+      });
+  }
 } else if (subcommand === "control") {
   const action = process.argv[3];
   const project = getArg("--project");
@@ -94,10 +128,12 @@ if (subcommand === "init") {
     controlCheckV0(project, profile, out)
       .then((res) => {
         console.log([
-          "control check: ok",
+          res.exit_code && res.exit_code !== 0 ? "control check: issues" : "control check: ok",
           `plan: ${res.plan_path}`,
           `summary: ${res.summary_path}`,
-        ].join("\n"));
+          res.exit_code ? `exit_code: ${res.exit_code}` : null,
+        ].filter(Boolean).join("\n"));
+        if (typeof res.exit_code === "number") process.exit(res.exit_code);
         process.exit(0);
       })
       .catch((err) => {
@@ -105,19 +141,154 @@ if (subcommand === "init") {
         process.exit(1);
       });
   } else if (action === "apply") {
-    const profile = getArg("--profile");
-    if (!profile) {
+    const out = getArg("--out") || project;
+    const mode = getArg("--mode");
+    const presetName = getArg("--preset");
+    if (presetName) {
+      resolvePreset(presetName)
+        .then(async (preset) => {
+          if (!preset) {
+            console.error(`Preset not found: ${presetName}`);
+            process.exit(2);
+          }
+          return controlApplyV0(project, preset.control_path, out, mode, {
+            assetSourceRoot: preset.assets_root,
+          });
+        })
+        .then((res) => {
+          console.log([
+            res.exit_code && res.exit_code !== 0 ? "control apply: issues" : "control apply: ok",
+            `report: ${res.report_path}`,
+            res.exit_code ? `exit_code: ${res.exit_code}` : null,
+          ].filter(Boolean).join("\n"));
+          if (typeof res.exit_code === "number") process.exit(res.exit_code);
+          process.exit(0);
+        })
+        .catch((err) => {
+          console.error(err);
+          process.exit(1);
+        });
+    } else {
+      const profile = getArg("--profile");
+      if (!profile) {
+        usage(2);
+        process.exit(2);
+      }
+      controlApplyV0(project, profile, out, mode)
+        .then((res) => {
+          console.log([
+            res.exit_code && res.exit_code !== 0 ? "control apply: issues" : "control apply: ok",
+            `report: ${res.report_path}`,
+            res.exit_code ? `exit_code: ${res.exit_code}` : null,
+          ].filter(Boolean).join("\n"));
+          if (typeof res.exit_code === "number") process.exit(res.exit_code);
+          process.exit(0);
+        })
+        .catch((err) => {
+          console.error(err);
+          process.exit(1);
+        });
+    }
+  } else {
+    usage(2);
+    process.exit(2);
+  }
+} else if (subcommand === "preset") {
+  const action = process.argv[3];
+  if (action === "list") {
+    listPresets()
+      .then((presets) => {
+        for (const name of presets) {
+          console.log(name);
+        }
+        process.exit(0);
+      })
+      .catch((err) => {
+        console.error(err);
+        process.exit(1);
+      });
+  } else if (action === "show") {
+    const name = process.argv[4];
+    if (!name) {
       usage(2);
       process.exit(2);
     }
-    const out = getArg("--out") || project;
-    const mode = getArg("--mode");
-    controlApplyV0(project, profile, out, mode)
-      .then((res) => {
-        console.log([
-          "control apply: ok",
-          `report: ${res.report_path}`,
-        ].join("\n"));
+    readPresetControlRaw(name)
+      .then((raw) => {
+        if (!raw) {
+          console.error(`Preset not found: ${name}`);
+          process.exit(2);
+        }
+        process.stdout.write(raw + "\n");
+        process.exit(0);
+      })
+      .catch((err) => {
+        console.error(err);
+        process.exit(1);
+      });
+  } else {
+    usage(2);
+    process.exit(2);
+  }
+} else if (subcommand === "observe") {
+  const action = process.argv[3];
+  const project = getArg("--project");
+  if (!project) {
+    usage(2);
+    process.exit(2);
+  }
+  if (action === "list") {
+    listObservabilityRuns(project)
+      .then((runs) => {
+        if (!runs.length) {
+          console.log("observe list: no runs");
+          process.exit(0);
+        }
+        for (const run of runs) {
+          console.log(JSON.stringify(run));
+        }
+        process.exit(0);
+      })
+      .catch((err) => {
+        console.error(err);
+        process.exit(1);
+      });
+  } else if (action === "tail") {
+    const runId = getArg("--run");
+    if (!runId) {
+      usage(2);
+      process.exit(2);
+    }
+    const limitRaw = getArg("--limit");
+    const limit = limitRaw ? Number(limitRaw) : 20;
+    tailObservabilityEvents(project, runId, Number.isFinite(limit) ? limit : 20)
+      .then((lines) => {
+        if (!lines.length) {
+          console.log("observe tail: no events");
+          process.exit(0);
+        }
+        for (const line of lines) {
+          console.log(line);
+        }
+        process.exit(0);
+      })
+      .catch((err) => {
+        console.error(err);
+        process.exit(1);
+      });
+  } else if (action === "summary") {
+    const runId = getArg("--run");
+    if (!runId) {
+      usage(2);
+      process.exit(2);
+    }
+    readObservabilitySummary(project, runId)
+      .then((summary) => {
+        if (!summary) {
+          console.log("observe summary: not found");
+          process.exit(0);
+        }
+        process.stdout.write(JSON.stringify(summary, null, 2) + "\n");
         process.exit(0);
       })
       .catch((err) => {