mova-claude-import 0.1.1

package/.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: ci
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node: [ "20.x", "22.x" ]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+          cache: "npm"
+
+      - name: Install
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Test
+        run: npm test
+
+      - name: Deps audit
+        run: npm run deps:audit
+
+      - name: Docs check
+        run: npm run docs:check
+
+      - name: Pack (smoke)
+        run: npm pack --silent

package/.github/workflows/release-dry-run.yml

@@ -0,0 +1,40 @@
+name: release-dry-run
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  dry_run:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22.x"
+          cache: "npm"
+
+      - name: Install
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Test
+        run: npm test
+
+      - name: Pack
+        run: |
+          npm pack --silent
+          ls -la *.tgz
+
+      - name: Upload tarball
+        uses: actions/upload-artifact@v4
+        with:
+          name: npm-tarball
+          path: "*.tgz"

package/.github/workflows/release-publish.yml

@@ -0,0 +1,43 @@
+name: release-publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22.x"
+          cache: "npm"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Install
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Test
+        run: npm test
+
+      - name: Pack (smoke)
+        run: |
+          npm pack --silent
+          ls -la *.tgz
+
+      - name: Publish to npm
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish

package/.tmp_test_control_apply/proj/.claude/agents/example_agent.md

@@ -0,0 +1,3 @@
+# example_agent
+
+Role: reviewer

package/.tmp_test_control_apply/proj/.claude/commands/example_command.md

@@ -0,0 +1,3 @@
+# example_command
+
+Write a brief project summary.

package/.tmp_test_control_apply/proj/.claude/hooks/example_hook.sh

@@ -0,0 +1,2 @@
+#!/usr/bin/env bash
+echo "hook: dry check"

package/.tmp_test_control_apply/proj/.claude/output-styles/example_style.md

@@ -0,0 +1,3 @@
+# example_style
+
+Style: concise, bullet-first.

package/.tmp_test_control_apply/proj/.claude/settings.json

@@ -0,0 +1,30 @@
+{
+  "claude_md": {
+    "inject_control_entry": true,
+    "marker": "<!-- MOVA_CONTROL_ENTRY_V0 -->"
+  },
+  "hooks": {
+    "behavior": {
+      "on_invalid_hook": "report_only"
+    },
+    "definitions": [],
+    "enable": true
+  },
+  "permissions": {
+    "allow": [],
+    "behavior": {
+      "on_conflict": "deny_wins",
+      "on_unknown": "report_only"
+    },
+    "deny": []
+  },
+  "plugins": {
+    "allowed_plugin_ids": [],
+    "behavior": {
+      "on_unknown": "report_only"
+    },
+    "denied_plugin_ids": [],
+    "enable": true
+  },
+  "profile_version": "v0"
+}

package/.tmp_test_control_apply/proj/.claude/settings.local.example.json

@@ -0,0 +1,3 @@
+{
+  "note": "Local settings are not committed; use this as a template."
+}

package/.tmp_test_control_apply/proj/.mcp.json

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

package/.tmp_test_control_apply/proj/CLAUDE.md

@@ -0,0 +1,13 @@
+<!-- MOVA_CONTROL_ENTRY_V0 -->
+## MOVA Control Entry (v0)
+
+Source of truth (do this first):
+- mova/claude_import/v0/contracts/instruction_profile_v0.json
+- mova/claude_import/v0/contracts/skills_catalog_v0.json
+- mova/claude_import/v0/contracts/mcp_servers_v0.json
+
+Proof / evidence:
+- mova/claude_import/v0/quality_report_v0.json
+- mova/claude_import/v0/export_manifest_v0.json
+
+Hello

package/.tmp_test_control_apply/proj/MOVA.md

@@ -0,0 +1,3 @@
+# MOVA
+
+Notes and operator instructions.

package/.tmp_test_control_check/proj/.mcp.json

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

package/.tmp_test_control_check/proj/CLAUDE.md

@@ -0,0 +1 @@
+Hello

package/.tmp_test_control_prefill/out1/claude_control_profile_v0.json

@@ -0,0 +1,114 @@
+{
+  "anthropic": {
+    "claude_md": {
+      "description": "Политика вставки управляющего блока MOVA и позиционирование его в CLAUDE.md.",
+      "inject_control_entry": true,
+      "marker": "<!-- MOVA_CONTROL_ENTRY_V0 -->",
+      "paths": {
+        "local": "CLAUDE.local.md",
+        "project_alt": ".claude/CLAUDE.md",
+        "project_primary": "CLAUDE.md"
+      }
+    },
+    "hooks": {
+      "behavior": {
+        "on_invalid_hook": "report_only"
+      },
+      "definitions": [],
+      "description": "Крючки (hooks) Claude Code, если используются в проекте/плагинах.",
+      "enable": true
+    },
+    "mcp": {
+      "description": "Подключения MCP серверов и правила по переменным окружения.",
+      "env_expansion_policy": {
+        "allow_defaults_syntax": true,
+        "on_missing_var": "report_only",
+        "require_all_vars": false
+      },
+      "servers": []
+    },
+    "permissions": {
+      "allow": [],
+      "behavior": {
+        "on_conflict": "deny_wins",
+        "on_unknown": "report_only"
+      },
+      "deny": [],
+      "description": "Правила allow/deny (в стиле Claude Code) для действий и инструментов."
+    },
+    "plugins": {
+      "allowed_plugin_ids": [],
+      "behavior": {
+        "on_unknown": "report_only"
+      },
+      "denied_plugin_ids": [],
+      "description": "Политика использования плагинов/команд. На v0 — только реестр намерений и отчёты.",
+      "enable": true
+    },
+    "scopes_enabled": {
+      "local": true,
+      "managed": false,
+      "project": true,
+      "user": true
+    }
+  },
+  "apply": {
+    "backup_before_write": true,
+    "behavior": {
+      "on_parse_error": "report_only",
+      "on_unwritable_target": "report_only"
+    },
+    "default_apply_mode": "preview",
+    "default_target": "project_only",
+    "description": "Настройки операции apply (разнос из профиля в файлы Claude Code).",
+    "write_scopes": {
+      "local": false,
+      "project": true,
+      "user": false
+    }
+  },
+  "id": "ds.claude_control_profile_v0",
+  "kind": "ds",
+  "mode": "report_only",
+  "mova": {
+    "export": {
+      "description": "Экспорт zip для передачи/архивации результата.",
+      "emit_export_manifest": true,
+      "emit_zip": false,
+      "zip_name": "export.zip"
+    },
+    "observability": {
+      "artifact_root": "mova/claude_import/v0",
+      "description": "Артефакты наблюдаемости и доказательности. Включены по умолчанию.",
+      "emit_apply_report": true,
+      "emit_manifest": true,
+      "emit_policy_report": true,
+      "emit_quality_report": true,
+      "emit_version_anchor": true
+    },
+    "overlay": {
+      "description": "MOVA Control Overlay — добавляет понятный блок управления и ссылки на отчёты.",
+      "emit": true
+    },
+    "premium": {
+      "description": "Премиум-блоки по умолчанию выключены. Включаются пользователем, если он подключает соответствующие пакеты/дверь.",
+      "proofkits": {
+        "enabled": false,
+        "selected": []
+      },
+      "tool_door": {
+        "auth_ref": "",
+        "enabled": false,
+        "endpoint": "",
+        "policy_profile_id": ""
+      }
+    }
+  },
+  "notes": [
+    "Единая точка управления контролем Claude Code + MOVA слой наблюдаемости.",
+    "По умолчанию НЕ ломает работу: формирует отчёты и подсказки. Жёсткое применение/запреты включаются явно пользователем.",
+    "Этот профиль можно заполнить вручную или получить prefill через импорт существующей папки Claude."
+  ],
+  "title": "Claude Control Profile v0",
+  "version": "0.1.0"
+}

package/.tmp_test_control_prefill/out1/prefill_report_v0.json

@@ -0,0 +1,13 @@
+{
+  "applied": {
+    "mcp_servers": true
+  },
+  "found": {
+    "mcp_json": true,
+    "settings_json": false,
+    "settings_local_json": false
+  },
+  "profile_path": "D:\\Projects_Clean\\mova-claude-import\\.tmp_test_control_prefill\\out1\\claude_control_profile_v0.json",
+  "profile_version": "v0",
+  "project_dir": "D:\\Projects_Clean\\mova-claude-import\\fixtures\\pos\\control_basic_project"
+}

package/.tmp_test_control_prefill/out2/claude_control_profile_v0.json

@@ -0,0 +1,114 @@
+{
+  "anthropic": {
+    "claude_md": {
+      "description": "Политика вставки управляющего блока MOVA и позиционирование его в CLAUDE.md.",
+      "inject_control_entry": true,
+      "marker": "<!-- MOVA_CONTROL_ENTRY_V0 -->",
+      "paths": {
+        "local": "CLAUDE.local.md",
+        "project_alt": ".claude/CLAUDE.md",
+        "project_primary": "CLAUDE.md"
+      }
+    },
+    "hooks": {
+      "behavior": {
+        "on_invalid_hook": "report_only"
+      },
+      "definitions": [],
+      "description": "Крючки (hooks) Claude Code, если используются в проекте/плагинах.",
+      "enable": true
+    },
+    "mcp": {
+      "description": "Подключения MCP серверов и правила по переменным окружения.",
+      "env_expansion_policy": {
+        "allow_defaults_syntax": true,
+        "on_missing_var": "report_only",
+        "require_all_vars": false
+      },
+      "servers": []
+    },
+    "permissions": {
+      "allow": [],
+      "behavior": {
+        "on_conflict": "deny_wins",
+        "on_unknown": "report_only"
+      },
+      "deny": [],
+      "description": "Правила allow/deny (в стиле Claude Code) для действий и инструментов."
+    },
+    "plugins": {
+      "allowed_plugin_ids": [],
+      "behavior": {
+        "on_unknown": "report_only"
+      },
+      "denied_plugin_ids": [],
+      "description": "Политика использования плагинов/команд. На v0 — только реестр намерений и отчёты.",
+      "enable": true
+    },
+    "scopes_enabled": {
+      "local": true,
+      "managed": false,
+      "project": true,
+      "user": true
+    }
+  },
+  "apply": {
+    "backup_before_write": true,
+    "behavior": {
+      "on_parse_error": "report_only",
+      "on_unwritable_target": "report_only"
+    },
+    "default_apply_mode": "preview",
+    "default_target": "project_only",
+    "description": "Настройки операции apply (разнос из профиля в файлы Claude Code).",
+    "write_scopes": {
+      "local": false,
+      "project": true,
+      "user": false
+    }
+  },
+  "id": "ds.claude_control_profile_v0",
+  "kind": "ds",
+  "mode": "report_only",
+  "mova": {
+    "export": {
+      "description": "Экспорт zip для передачи/архивации результата.",
+      "emit_export_manifest": true,
+      "emit_zip": false,
+      "zip_name": "export.zip"
+    },
+    "observability": {
+      "artifact_root": "mova/claude_import/v0",
+      "description": "Артефакты наблюдаемости и доказательности. Включены по умолчанию.",
+      "emit_apply_report": true,
+      "emit_manifest": true,
+      "emit_policy_report": true,
+      "emit_quality_report": true,
+      "emit_version_anchor": true
+    },
+    "overlay": {
+      "description": "MOVA Control Overlay — добавляет понятный блок управления и ссылки на отчёты.",
+      "emit": true
+    },
+    "premium": {
+      "description": "Премиум-блоки по умолчанию выключены. Включаются пользователем, если он подключает соответствующие пакеты/дверь.",
+      "proofkits": {
+        "enabled": false,
+        "selected": []
+      },
+      "tool_door": {
+        "auth_ref": "",
+        "enabled": false,
+        "endpoint": "",
+        "policy_profile_id": ""
+      }
+    }
+  },
+  "notes": [
+    "Единая точка управления контролем Claude Code + MOVA слой наблюдаемости.",
+    "По умолчанию НЕ ломает работу: формирует отчёты и подсказки. Жёсткое применение/запреты включаются явно пользователем.",
+    "Этот профиль можно заполнить вручную или получить prefill через импорт существующей папки Claude."
+  ],
+  "title": "Claude Control Profile v0",
+  "version": "0.1.0"
+}

package/.tmp_test_control_prefill/out2/prefill_report_v0.json

@@ -0,0 +1,13 @@
+{
+  "applied": {
+    "mcp_servers": true
+  },
+  "found": {
+    "mcp_json": true,
+    "settings_json": false,
+    "settings_local_json": false
+  },
+  "profile_path": "D:\\Projects_Clean\\mova-claude-import\\.tmp_test_control_prefill\\out2\\claude_control_profile_v0.json",
+  "profile_version": "v0",
+  "project_dir": "D:\\Projects_Clean\\mova-claude-import\\fixtures\\pos\\control_basic_project"
+}

package/.tmp_test_overlay/proj/.claude/skills/a.md

@@ -0,0 +1 @@
+# skill

package/.tmp_test_overlay/proj/.mcp.json

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

package/.tmp_test_overlay/proj/CLAUDE.md

@@ -0,0 +1 @@
+Hello

package/.tmp_test_profile/proj/.claude/skills/a.md

@@ -0,0 +1 @@
+# skill

package/.tmp_test_profile/proj/.mcp.json

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

package/.tmp_test_profile/proj/CLAUDE.md

@@ -0,0 +1 @@
+Hello

package/.tmp_test_scaffold_apply/proj/.claude/agents/example_agent.md

@@ -0,0 +1,3 @@
+# example_agent
+
+Role: reviewer

package/.tmp_test_scaffold_apply/proj/.claude/commands/example_command.md

@@ -0,0 +1,3 @@
+# example_command
+
+Write a brief project summary.

package/.tmp_test_scaffold_apply/proj/.claude/hooks/example_hook.sh

@@ -0,0 +1,2 @@
+#!/usr/bin/env bash
+echo "hook: dry check"

package/.tmp_test_scaffold_apply/proj/.claude/output-styles/example_style.md

@@ -0,0 +1,3 @@
+# example_style
+
+Style: concise, bullet-first.

package/.tmp_test_scaffold_apply/proj/.claude/settings.json

@@ -0,0 +1,30 @@
+{
+  "claude_md": {
+    "inject_control_entry": true,
+    "marker": "<!-- MOVA_CONTROL_ENTRY_V0 -->"
+  },
+  "hooks": {
+    "behavior": {
+      "on_invalid_hook": "report_only"
+    },
+    "definitions": [],
+    "enable": true
+  },
+  "permissions": {
+    "allow": [],
+    "behavior": {
+      "on_conflict": "deny_wins",
+      "on_unknown": "report_only"
+    },
+    "deny": []
+  },
+  "plugins": {
+    "allowed_plugin_ids": [],
+    "behavior": {
+      "on_unknown": "report_only"
+    },
+    "denied_plugin_ids": [],
+    "enable": true
+  },
+  "profile_version": "v0"
+}

package/.tmp_test_scaffold_apply/proj/.claude/settings.local.example.json

@@ -0,0 +1,3 @@
+{
+  "note": "Local settings are not committed; use this as a template."
+}

package/.tmp_test_scaffold_apply/proj/.mcp.json

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

package/.tmp_test_scaffold_apply/proj/CLAUDE.md

@@ -0,0 +1,13 @@
+<!-- MOVA_CONTROL_ENTRY_V0 -->
+## MOVA Control Entry (v0)
+
+Source of truth (do this first):
+- mova/claude_import/v0/contracts/instruction_profile_v0.json
+- mova/claude_import/v0/contracts/skills_catalog_v0.json
+- mova/claude_import/v0/contracts/mcp_servers_v0.json
+
+Proof / evidence:
+- mova/claude_import/v0/quality_report_v0.json
+- mova/claude_import/v0/export_manifest_v0.json
+
+Custom

package/.tmp_test_scaffold_apply/proj/MOVA.md

@@ -0,0 +1,3 @@
+# MOVA
+
+Notes and operator instructions.

package/.tmp_test_strict/mova/claude_import/v0/VERSION.json

@@ -0,0 +1,10 @@
+{
+  "export_zip_version": "export_zip_v0",
+  "input_policy_version": "input_policy_v0",
+  "lint_version": "lint_v0",
+  "overlay_version": "mova_control_overlay_v0",
+  "profile_version": "anthropic_profile_v0",
+  "quality_version": "quality_v0",
+  "tool_name": "mova-claude-import",
+  "tool_version": "0.1.1"
+}

package/.tmp_test_strict/mova/claude_import/v0/episode_import_run.json

@@ -0,0 +1,20 @@
+{
+  "episode_id": "b7387398df279407",
+  "episode_type": "claude_import_run_v0",
+  "failure": {
+    "denied_count": 1,
+    "reason": "input_policy_denied"
+  },
+  "ok": false,
+  "recorded_at": "1970-01-01T00:00:00.000Z",
+  "result_core": {
+    "imported": {
+      "claude_md": false,
+      "mcp_json": false,
+      "skills_count": 0
+    },
+    "inputs_count": 0,
+    "validation": null
+  },
+  "run_id": "b7387398df279407"
+}

package/.tmp_test_strict/mova/claude_import/v0/import_manifest.json

@@ -0,0 +1,20 @@
+{
+  "emit_profile": true,
+  "imported": {
+    "claude_md": false,
+    "mcp_json": false,
+    "skills_count": 0
+  },
+  "input_policy_ok": false,
+  "inputs": [],
+  "project_dir": "D:\\Projects_Clean\\mova-claude-import\\fixtures\\neg\\strict_denied_local",
+  "run_id": "b7387398df279407",
+  "skipped": [
+    {
+      "path": "~/.claude/*",
+      "reason": "excluded_by_default_user_settings"
+    }
+  ],
+  "tool": "mova-claude-import",
+  "version": "v0"
+}

package/.tmp_test_strict/mova/claude_import/v0/input_policy_report_v0.json

@@ -0,0 +1,32 @@
+{
+  "allowed": [
+    {
+      "kind": "other",
+      "path": "CLAUDE.md"
+    }
+  ],
+  "denied": [
+    {
+      "kind": "claude_settings_local",
+      "path": ".claude/settings.local.json",
+      "reason": "settings_local_not_allowed"
+    }
+  ],
+  "exit_code_recommended": 2,
+  "found": [
+    {
+      "kind": "other",
+      "path": "CLAUDE.md"
+    },
+    {
+      "kind": "claude_settings_local",
+      "path": ".claude/settings.local.json"
+    }
+  ],
+  "ok": false,
+  "opts": {
+    "include_local": false,
+    "strict": true
+  },
+  "policy_version": "v0"
+}

package/.tmp_test_zip/out1/.claude/agents/example_agent.md

@@ -0,0 +1,3 @@
+# example_agent
+
+Role: reviewer