mova-claude-import 0.1.1

package/docs/OPERATOR_GUIDE_v0.md

@@ -0,0 +1,43 @@
+# Operator Guide v0
+
+## Контрольные поверхности Claude Code
+
+Основные точки контроля, которые всегда существуют в эталонном профиле:
+
+- `CLAUDE.md` (маркер `<!-- MOVA_CONTROL_ENTRY_V0 -->`)
+- `.claude/settings.json`
+- `.claude/settings.local.example.json`
+- `.claude/commands/`
+- `.claude/agents/`
+- `.claude/output-styles/`
+- `.claude/hooks/`
+- `.mcp.json`
+
+## Как MOVA слой добавляет наблюдаемость
+
+- Импорт и проверки пишут отчёты в `mova/claude_import/v0/`.
+- Control‑команды пишут планы/отчёты в `mova/claude_control/v0/runs/<run_id>/`.
+- Канон control‑схем: `schemas/claude_control/v0/{ds,env,global}`.
+
+## Команды CLI
+
+| Команда | Назначение |
+| --- | --- |
+| `init` | создать полный эталонный профиль |
+| `--project ...` | импорт/ребилд существующего проекта |
+| `control prefill` | создать `claude_control_profile_v0.json` и `prefill_report_v0.json` |
+| `control check` | построить план, ничего не менять |
+| `control apply` | применить изменения при `--mode apply`, иначе preview |
+
+См. `docs/CONTROL_PROFILE_GUIDE_v0.md` и примеры в `examples/`.
+
+## Автоматизация/CI
+
+`--strict` предназначен для CI/проверок: при запрещённых входах он останавливает процесс и возвращает код 2.
+Для пользовательских сценариев по умолчанию применяется мягкий режим (preview + отчёт).
+
+## Коды завершения CLI
+
+- `0` — успех или preview‑план построен.
+- `1` — неожиданный runtime‑сбой.
+- `2` — автоматизация остановлена политикой контроля (strict/CI).

package/docs/SECURITY_MODEL_v0.md

@@ -0,0 +1,20 @@
+# Security Model v0
+
+## Основная идея
+
+Control‑команды по умолчанию работают в режиме preview: они строят планы и отчёты,
+но не вносят изменений, пока вы явно не попросите `--mode apply`.
+
+## Жёсткие режимы — для автоматизации
+
+`--strict` — это режим CI/проверок. Он останавливает процесс с кодом 2, если
+политика контроля запрещает входы или шаги. Пользовательский режим остаётся мягким.
+
+## Ответственность пользователя
+
+Профиль контроля (`claude_control_profile_v0.json`) — это явная политика, которую
+вы задаёте сами. Инструмент не добавляет скрытых запретов и не выполняет “магии”.
+
+## Границы модели
+
+Мы не оцениваем “смысл” навыков и команд, и не гарантируем безопасность внешних MCP‑серверов.

package/examples/control_profile_min.json

@@ -0,0 +1,37 @@
+{
+  "kind": "ds",
+  "id": "ds.claude_control_profile_v0",
+  "version": "0.1.0",
+  "title": "Claude Control Profile v0 (min)",
+  "mode": "report_only",
+  "anthropic": {
+    "permissions": {
+      "allow": [],
+      "deny": [],
+      "behavior": {
+        "on_conflict": "deny_wins",
+        "on_unknown": "report_only"
+      }
+    },
+    "mcp": {
+      "servers": {}
+    },
+    "claude_md": {
+      "inject_control_entry": true,
+      "marker": "<!-- MOVA_CONTROL_ENTRY_V0 -->"
+    }
+  },
+  "mova": {
+    "overlay": {
+      "emit": true
+    },
+    "observability": {
+      "artifact_root": "mova/claude_import/v0"
+    }
+  },
+  "apply": {
+    "default_apply_mode": "preview",
+    "default_target": "project_only",
+    "backup_before_write": true
+  }
+}

package/examples/control_profile_standard.json

@@ -0,0 +1,81 @@
+{
+  "kind": "ds",
+  "id": "ds.claude_control_profile_v0",
+  "version": "0.1.0",
+  "title": "Claude Control Profile v0 (standard)",
+  "mode": "report_only",
+  "anthropic": {
+    "permissions": {
+      "allow": [],
+      "deny": [],
+      "behavior": {
+        "on_conflict": "deny_wins",
+        "on_unknown": "report_only"
+      }
+    },
+    "mcp": {
+      "servers": {},
+      "env_expansion_policy": {
+        "require_all_vars": false,
+        "allow_defaults_syntax": true,
+        "on_missing_var": "report_only"
+      }
+    },
+    "plugins": {
+      "enable": true,
+      "allowed_plugin_ids": [],
+      "denied_plugin_ids": [],
+      "behavior": {
+        "on_unknown": "report_only"
+      }
+    },
+    "hooks": {
+      "enable": true,
+      "definitions": [],
+      "behavior": {
+        "on_invalid_hook": "report_only"
+      }
+    },
+    "claude_md": {
+      "inject_control_entry": true,
+      "marker": "<!-- MOVA_CONTROL_ENTRY_V0 -->",
+      "paths": {
+        "project_primary": "CLAUDE.md",
+        "project_alt": ".claude/CLAUDE.md",
+        "local": "CLAUDE.local.md"
+      }
+    }
+  },
+  "mova": {
+    "overlay": {
+      "emit": true
+    },
+    "observability": {
+      "emit_version_anchor": true,
+      "emit_manifest": true,
+      "emit_policy_report": true,
+      "emit_apply_report": true,
+      "emit_quality_report": true,
+      "artifact_root": "mova/claude_import/v0"
+    },
+    "export": {
+      "emit_zip": false,
+      "zip_name": "export.zip",
+      "emit_export_manifest": true
+    }
+  },
+  "apply": {
+    "default_apply_mode": "preview",
+    "default_target": "project_only",
+    "backup_before_write": true,
+    "write_scopes": {
+      "user": false,
+      "project": true,
+      "local": false
+    },
+    "behavior": {
+      "on_unwritable_target": "report_only",
+      "on_parse_error": "report_only"
+    }
+  }
+}

package/examples/control_profile_strict.json

@@ -0,0 +1,68 @@
+{
+  "kind": "ds",
+  "id": "ds.claude_control_profile_v0",
+  "version": "0.1.0",
+  "title": "Claude Control Profile v0 (strict)",
+  "mode": "report_only",
+  "anthropic": {
+    "permissions": {
+      "allow": [
+        "fs.read",
+        "fs.write",
+        "process.spawn"
+      ],
+      "deny": [
+        "network.raw"
+      ],
+      "behavior": {
+        "on_conflict": "deny_wins",
+        "on_unknown": "report_only"
+      }
+    },
+    "mcp": {
+      "servers": {},
+      "env_expansion_policy": {
+        "require_all_vars": true,
+        "allow_defaults_syntax": false,
+        "on_missing_var": "report_only"
+      }
+    },
+    "plugins": {
+      "enable": true,
+      "allowed_plugin_ids": [
+        "local-tools"
+      ],
+      "denied_plugin_ids": [],
+      "behavior": {
+        "on_unknown": "report_only"
+      }
+    },
+    "claude_md": {
+      "inject_control_entry": true,
+      "marker": "<!-- MOVA_CONTROL_ENTRY_V0 -->"
+    }
+  },
+  "mova": {
+    "overlay": {
+      "emit": true
+    },
+    "observability": {
+      "emit_version_anchor": true,
+      "emit_manifest": true,
+      "emit_policy_report": true,
+      "emit_apply_report": true,
+      "emit_quality_report": true,
+      "artifact_root": "mova/claude_import/v0"
+    },
+    "export": {
+      "emit_zip": true,
+      "zip_name": "export.zip",
+      "emit_export_manifest": true
+    }
+  },
+  "apply": {
+    "default_apply_mode": "preview",
+    "default_target": "project_only",
+    "backup_before_write": true
+  }
+}

package/fixtures/neg/bad_skill_structure/.claude/skills/bad/README.md

@@ -0,0 +1,3 @@
+# Bad Skill
+
+Missing SKILL.md on purpose.

package/fixtures/neg/bad_skill_structure/CLAUDE.md

@@ -0,0 +1,3 @@
+# CLAUDE
+
+This fixture has an invalid skills structure.

package/fixtures/neg/local_settings_present/.claude/settings.local.json

@@ -0,0 +1,3 @@
+{
+  "note": "local settings should not be present"
+}

package/fixtures/neg/local_settings_present/.claude/skills/alpha/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: alpha
+version: v0
+---
+
+# Alpha Skill

package/fixtures/neg/local_settings_present/CLAUDE.md

@@ -0,0 +1,3 @@
+# CLAUDE
+
+Local settings should not be present in inputs for quality.

package/fixtures/neg/secret_leak/.claude/skills/alpha/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: alpha
+version: v0
+---
+
+# Alpha Skill

package/fixtures/neg/secret_leak/.mcp.json

@@ -0,0 +1,3 @@
+{
+  "servers": []
+}

package/fixtures/neg/secret_leak/CLAUDE.md

@@ -0,0 +1,3 @@
+# CLAUDE
+
+This fixture includes a token: sk-SECRET123456.

package/fixtures/neg/strict_denied_local/.claude/settings.local.json

@@ -0,0 +1,3 @@
+{
+  "note": "local settings must be denied"
+}

package/fixtures/neg/strict_denied_local/CLAUDE.md

@@ -0,0 +1,3 @@
+# CLAUDE
+
+Strict input policy should deny local settings.

package/fixtures/pos/basic/.claude/skills/alpha/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: alpha
+version: v0
+---
+
+# Alpha Skill
+
+Quality v0 positive fixture.

package/fixtures/pos/basic/.mcp.json

@@ -0,0 +1,3 @@
+{
+  "servers": []
+}

package/fixtures/pos/basic/CLAUDE.md

@@ -0,0 +1,3 @@
+# CLAUDE
+
+Project: quality v0 basic fixture.

package/fixtures/pos/control_basic_project/.mcp.json

@@ -0,0 +1,3 @@
+{
+  "servers": []
+}

package/fixtures/pos/control_basic_project/CLAUDE.md

@@ -0,0 +1,3 @@
+# CLAUDE
+
+Control basic project fixture.

package/fixtures/pos/control_profile_filled/claude_control_profile_v0.json

@@ -0,0 +1,18 @@
+{
+  "anthropic": {
+    "claude_md": {
+      "inject_control_entry": true,
+      "marker": "<!-- MOVA_CONTROL_ENTRY_V0 -->"
+    },
+    "mcp": {
+      "servers": {}
+    }
+  },
+  "apply": {
+    "default_apply_mode": "preview"
+  },
+  "kind": "ds",
+  "mode": "report_only",
+  "title": "Claude Control Profile v0",
+  "version": "0.1.0"
+}

package/fixtures/pos/full_scaffold_roundtrip/README.md

@@ -0,0 +1 @@
+Full scaffold roundtrip fixture.

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "mova-claude-import",
+  "version": "0.1.1",
+  "main": "index.js",
+  "scripts": {
+    "test": "node --test",
+    "build": "tsc -p tsconfig.json",
+    "validate": "npm run build",
+    "deps:audit": "node tools/deps_audit_v0.mjs",
+    "docs:bindings": "node tools/write_mova_spec_bindings_v0.mjs",
+    "docs:check": "npm run docs:bindings -- --check",
+    "demo": "node tools/demo_v0.mjs",
+    "demo:clean": "node -e \"require('fs').rmSync('.tmp_demo',{recursive:true,force:true})\"",
+    "quality": "node dist/quality_v0.js --suite pos",
+    "quality:neg": "node dist/quality_v0.js --suite neg"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "@types/yazl": "^3.3.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@leryk1981/mova-core-engine": "^0.1.1",
+    "@leryk1981/mova-spec": "^4.1.1",
+    "yazl": "^3.3.1"
+  },
+  "type": "module",
+  "bin": {
+    "mova-claude-import": "dist/cli.js"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": "./dist/index.js"
+  }
+}

package/schemas/claude_control/v0/ds/ds.claude_control_mapping_v0.json

@@ -0,0 +1,227 @@
+{
+  "kind": "ds",
+  "id": "ds.claude_control_mapping_v0",
+  "version": "0.1.0",
+  "title": "Claude Control Mapping v0",
+  "notes": [
+    "Явная карта разноса значений из control_profile в файлы Claude Code.",
+    "Цель v0: детерминированный apply без «магии» и без неожиданных изменений user/local.",
+    "Все операции должны сопровождаться apply_report и policy_report."
+  ],
+  "files": {
+    "claude_md_project": {
+      "scope": "project",
+      "path": "CLAUDE.md",
+      "format": "text"
+    },
+    "claude_settings_project": {
+      "scope": "project",
+      "path": ".claude/settings.json",
+      "format": "json"
+    },
+    "claude_settings_local": {
+      "scope": "local",
+      "path": ".claude/settings.local.json",
+      "format": "json"
+    },
+    "mcp_project": {
+      "scope": "project",
+      "path": ".mcp.json",
+      "format": "json"
+    },
+    "mova_overlay_context": {
+      "scope": "project",
+      "path": "mova/claude_import/v0/overlay/mova_context_v0.json",
+      "format": "json"
+    },
+    "mova_overlay_proof": {
+      "scope": "project",
+      "path": "mova/claude_import/v0/overlay/mova_proof_v0.json",
+      "format": "json"
+    },
+    "mova_control_skill": {
+      "scope": "project",
+      "path": "mova/claude_import/v0/overlay/skills/mova_control.skill.md",
+      "format": "text"
+    }
+  },
+  "merge": {
+    "strategies": {
+      "override": {
+        "description": "Заменить целевое значение полностью.",
+        "kind": "override"
+      },
+      "append_unique": {
+        "description": "Добавить элементы, сохраняя уникальность (по строковому представлению).",
+        "kind": "append_unique"
+      },
+      "deny_wins": {
+        "description": "При конфликте allow/deny — deny сильнее.",
+        "kind": "deny_wins"
+      },
+      "object_deep_merge": {
+        "description": "Рекурсивное слияние объектов, ключи источника перекрывают целевые.",
+        "kind": "object_deep_merge"
+      }
+    }
+  },
+  "mappings": [
+    {
+      "id": "map.claude_md.control_entry",
+      "description": "Вставить/обновить блок MOVA Control Entry в CLAUDE.md по маркеру.",
+      "from": "control_profile.anthropic.claude_md",
+      "to": {
+        "file_ref": "claude_md_project",
+        "text_mode": "marker_replace",
+        "marker": "<!-- MOVA_CONTROL_ENTRY_V0 -->"
+      },
+      "when": {
+        "field_equals": {
+          "path": "control_profile.anthropic.claude_md.inject_control_entry",
+          "value": true
+        }
+      },
+      "behavior": {
+        "on_missing_target": "report_only",
+        "on_parse_error": "report_only"
+      }
+    },
+    {
+      "id": "map.settings.permissions.allow",
+      "description": "Разнести allow-правила в project settings.",
+      "from": "control_profile.anthropic.permissions.allow",
+      "to": {
+        "file_ref": "claude_settings_project",
+        "json_path": "permissions.allow",
+        "merge_strategy": "append_unique"
+      },
+      "when": {
+        "non_empty_array": "control_profile.anthropic.permissions.allow"
+      }
+    },
+    {
+      "id": "map.settings.permissions.deny",
+      "description": "Разнести deny-правила в project settings.",
+      "from": "control_profile.anthropic.permissions.deny",
+      "to": {
+        "file_ref": "claude_settings_project",
+        "json_path": "permissions.deny",
+        "merge_strategy": "append_unique"
+      },
+      "when": {
+        "non_empty_array": "control_profile.anthropic.permissions.deny"
+      }
+    },
+    {
+      "id": "map.settings.permissions.behavior",
+      "description": "Записать поведение разрешений (конфликт/неизвестное) в settings.",
+      "from": "control_profile.anthropic.permissions.behavior",
+      "to": {
+        "file_ref": "claude_settings_project",
+        "json_path": "permissions.behavior",
+        "merge_strategy": "object_deep_merge"
+      }
+    },
+    {
+      "id": "map.mcp.servers",
+      "description": "Разнести MCP servers в .mcp.json (project).",
+      "from": "control_profile.anthropic.mcp.servers",
+      "to": {
+        "file_ref": "mcp_project",
+        "json_path": "mcpServers",
+        "merge_strategy": "object_deep_merge"
+      }
+    },
+    {
+      "id": "map.mcp.env_policy",
+      "description": "Записать политику разворачивания env-переменных (MOVA-уровень) в overlay context.",
+      "from": "control_profile.anthropic.mcp.env_expansion_policy",
+      "to": {
+        "file_ref": "mova_overlay_context",
+        "json_path": "anthropic.mcp.env_expansion_policy",
+        "merge_strategy": "object_deep_merge"
+      }
+    },
+    {
+      "id": "map.plugins.policy",
+      "description": "Политика плагинов как наблюдаемость (не навязываем Anthropic формат).",
+      "from": "control_profile.anthropic.plugins",
+      "to": {
+        "file_ref": "mova_overlay_context",
+        "json_path": "anthropic.plugins",
+        "merge_strategy": "object_deep_merge"
+      }
+    },
+    {
+      "id": "map.hooks.policy",
+      "description": "Политика hooks как наблюдаемость (v0).",
+      "from": "control_profile.anthropic.hooks",
+      "to": {
+        "file_ref": "mova_overlay_context",
+        "json_path": "anthropic.hooks",
+        "merge_strategy": "object_deep_merge"
+      }
+    },
+    {
+      "id": "map.apply.defaults",
+      "description": "Зафиксировать настройки apply в overlay context (источник правды для отчётов).",
+      "from": "control_profile.apply",
+      "to": {
+        "file_ref": "mova_overlay_context",
+        "json_path": "apply",
+        "merge_strategy": "object_deep_merge"
+      }
+    },
+    {
+      "id": "map.mova.observability",
+      "description": "Настройки наблюдаемости MOVA слоя.",
+      "from": "control_profile.mova.observability",
+      "to": {
+        "file_ref": "mova_overlay_context",
+        "json_path": "mova.observability",
+        "merge_strategy": "object_deep_merge"
+      }
+    },
+    {
+      "id": "map.mova.export",
+      "description": "Настройки экспорта zip.",
+      "from": "control_profile.mova.export",
+      "to": {
+        "file_ref": "mova_overlay_context",
+        "json_path": "mova.export",
+        "merge_strategy": "object_deep_merge"
+      }
+    },
+    {
+      "id": "map.mova.premium",
+      "description": "Премиум-блоки (по умолчанию выключены) — только фиксация намерения.",
+      "from": "control_profile.mova.premium",
+      "to": {
+        "file_ref": "mova_overlay_context",
+        "json_path": "mova.premium",
+        "merge_strategy": "object_deep_merge"
+      }
+    },
+    {
+      "id": "map.overlay.proof",
+      "description": "Сформировать базовый proof-контейнер для ссылок на отчёты/доказательства.",
+      "from": "control_profile",
+      "to": {
+        "file_ref": "mova_overlay_proof",
+        "json_path": "proof",
+        "merge_strategy": "override"
+      },
+      "behavior": {
+        "generate_proof_container": true
+      }
+    }
+  ],
+  "constraints": {
+    "default_write_scopes": ["project"],
+    "safe_by_default": true,
+    "never_write_user_scope_by_default": true,
+    "never_write_local_scope_by_default": true,
+    "require_apply_report": true,
+    "require_policy_report": true
+  }
+}