metagit-cli 0.23.0__tar.gz → 0.23.2__tar.gz

{metagit_cli-0.23.0 → metagit_cli-0.23.2}/.mex/ROUTER.md

@@ -29,7 +29,7 @@ Then read this file fully before doing anything else in this session.
 **Working:**
 - **Derived projects + skills surface (2026-07-14):** in-manifest surgical `workspace.projects[]` via `metagit project derived create|refresh|include|exclude` and MCP `metagit_project_derived_*`; layered `metagit skills surface` / `metagit_skills_surface`; docs `derived-projects.md` / `skills-surface.md`; example `examples/derived-workspace/`; design `docs/superpowers/specs/2026-07-14-derived-projects-skills-inventory-design.md`.
 - **RFC-0013 Agent Operating System (implemented on `feat/rfc-0013-aos`):** thin `metagit.core.aos` composition façade; `metagit aos|coord status|doctor|next`; MCP `metagit_aos_*` / `metagit_coord_*`; `SchedulerService.preview_next`; modality `aos_status`; docs `docs/reference/aos.md`; skill `metagit-aos`; worktree `.worktrees/rfc-0013`.
-- **RFC-0014 Metagit Atlas (Phase 0–1 local MVP on `feat/rfc-0014-atlas`):** repository-local `.atlas/` semantic layer with curated intent, deterministic inventory/Python-symbol/test evidence, validation, derived query index, and `metagit atlas init|generate|validate|status|query|refresh`; modality `atlas_local`; docs `docs/reference/atlas.md`. MCP, federation, and optional adapters remain deferred.
+- **RFC-0014 Metagit Atlas (Phase 0–1 local MVP on `feat/rfc-0014-atlas`):** repository-local `.atlas/` semantic layer with curated intent, deterministic inventory/Python-symbol/test evidence, validation, derived query index, and `metagit atlas init|generate|validate|status|query|refresh`; modality `atlas_local`; docs `docs/reference/atlas.md`. MCP, federation, and optional adapters remain deferred. **Packaging fix:** `atlas validate` schemas live under `src/metagit/data/schemas/atlas/` so PyPI wheels resolve them (repo-root `schemas/atlas/` alone was missing from 0.22.0 wheels).
 - **RFC-0012 Distributed Agent Scheduler (shipped on main via PR #63):** `metagit.core.scheduler` scores ready task nodes; `metagit schedule policy|next|status`; MCP `metagit_schedule_*`; modality `agent_scheduler`; docs `docs/reference/agent-scheduler.md`.
 - **RFC-0008 Task Graph & Intent + RFC-0009 Context Compiler (shipped on main):** `metagit task` + MCP `metagit_task_*`; `metagit context compile` + MCP `metagit_context_compile`; packages `metagit.core.taskgraph` / `metagit.core.context.compiler`; docs `task-graph.md` / `context-compiler.md`; modality `task_graph` / `context_compile`.
 - **RFC-0010 + RFC-0011 (shipped on main via PR #62):** Semantic KG + Merge Orchestrator with CLI/MCP/docs/modality parity. RFC-0010 Task 9 GitNexus import remains deferred/optional.

{metagit_cli-0.23.0 → metagit_cli-0.23.2}/.mex/patterns/atlas-local.md

@@ -20,6 +20,9 @@ last_updated: 2026-07-14
    target repository with `--path` when it is not the current directory.
 3. When changing the user-facing CLI, keep `atlas_local` markers and
    `docs/reference/atlas.md` synchronized.
+4. Runtime JSON Schemas for `atlas validate` live under
+   `src/metagit/data/schemas/atlas/` (packaged via `package-data`). Keep the
+   docs/IDE copies in `schemas/atlas/` byte-identical; tests enforce parity.
 
 ## Verify
 

{metagit_cli-0.23.0 → metagit_cli-0.23.2}/CHANGELOG.md

@@ -4,6 +4,21 @@
 
 
 
+## [0.23.2] - 2026-07-16
+
+
+
+### Changed
+- Merge pull request #70 from metagit-ai/fix/mcp-stdio-stdout-pollution (6a5d818)
+- fix(logging): route console sink to stderr so MCP stdio stays clean (ba58c1c)
+
+## [0.23.1] - 2026-07-14
+
+
+
+### Fixed
+- **`metagit atlas validate`:** ship Atlas JSON Schemas under `metagit/data/schemas/atlas/` so installed wheels resolve schemas without the repo-root `schemas/atlas/` tree (fixes `FileNotFoundError` on PyPI 0.22.0).
+
 ## [0.23.0] - 2026-07-14
 
 

{metagit_cli-0.23.0 → metagit_cli-0.23.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metagit-cli
-Version: 0.23.0
+Version: 0.23.2
 Summary: Metagit multi-repo management tool
 Author-email: Zachary Loeber <zloeber@gmail.com>
 Project-URL: Homepage, https://github.com/metagit-ai/metagit-cli

{metagit_cli-0.23.0 → metagit_cli-0.23.2}/docs/reference/atlas.md

@@ -58,6 +58,12 @@ metagit atlas refresh src/toy/refunds.py --path /path/to/repo
 
 Use `--json` with each command for machine-readable output.
 
+## Schemas
+
+JSON Schemas for Atlas config and entity envelopes ship in the package at
+`metagit/data/schemas/atlas/` (used by `metagit atlas validate`). Matching
+copies under repo-root `schemas/atlas/` are for docs and IDE tooling.
+
 ## Boundaries
 
 - **RFC-0010 semantic knowledge graph:** workspace-level concept-to-path

{metagit_cli-0.23.0 → metagit_cli-0.23.2}/src/metagit/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.23.0'
-__version_tuple__ = version_tuple = (0, 23, 0)
+__version__ = version = '0.23.2'
+__version_tuple__ = version_tuple = (0, 23, 2)
 
-__commit_id__ = commit_id = 'g3a18d9ba9'
+__commit_id__ = commit_id = 'g985a83699'

{metagit_cli-0.23.0 → metagit_cli-0.23.2}/src/metagit/core/atlas/validate.py

@@ -17,6 +17,15 @@ _REF_LIST_KEYS = ("invariants", "contracts", "dependsOn")
 
 
 def _schemas_dir() -> Path:
+    """Return Atlas JSON Schema directory (packaged wheel or repo checkout).
+
+    Installed wheels ship schemas under ``metagit/data/schemas/atlas/`` via
+    ``package-data``. Repo checkouts also keep a docs/IDE copy at
+    ``schemas/atlas/`` beside the package tree.
+    """
+    packaged = Path(__file__).resolve().parents[2] / "data" / "schemas" / "atlas"
+    if packaged.is_dir():
+        return packaged
     current = Path(__file__).resolve().parent
     for parent in (current, *current.parents):
         candidate = parent / "schemas" / "atlas"

{metagit_cli-0.23.0 → metagit_cli-0.23.2}/src/metagit/core/utils/logging.py

@@ -160,9 +160,14 @@ class UnifiedLogger(LoggerProtocol):
             )
             serialize = False
 
-        # Console sink
+        # Console sink.
+        # NOTE: this MUST target stderr, never stdout. When metagit runs as an
+        # MCP server over stdio (`metagit mcp serve`), stdout is reserved
+        # exclusively for JSON-RPC frames; any human-readable log line written
+        # to stdout corrupts the transport and breaks the client handshake
+        # (loguru's own default sink is stderr for exactly this reason).
         self._stdout_handler_id = logger.add(
-            sys.stdout,
+            sys.stderr,
             level=config.log_level,
             format=log_format,
             backtrace=config.backtrace,
@@ -199,11 +204,12 @@ class UnifiedLogger(LoggerProtocol):
             self.config.log_level = level
             self.debug_mode = level == "DEBUG" or level == "TRACE"
 
-            # Update stdout handler
+            # Update stdout handler (stderr sink — see __init__ note: stdout is
+            # reserved for MCP stdio JSON-RPC and must stay clean).
             if self._stdout_handler_id is not None:
                 logger.remove(self._stdout_handler_id)
                 self._stdout_handler_id = logger.add(
-                    sys.stdout,
+                    sys.stderr,
                     level=level,
                     format=(
                         "{message}"

metagit_cli-0.23.2/src/metagit/data/schemas/atlas/atlas-config.schema.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://metagit.dev/schemas/atlas/atlas-config.schema.json",
+  "title": "AtlasConfig",
+  "description": "Top-level `.atlas/atlas.yaml` configuration (RFC-0014).",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["repository", "formatVersion"],
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "const": "atlas.metagit.dev/v1alpha1",
+      "default": "atlas.metagit.dev/v1alpha1"
+    },
+    "repository": {
+      "type": "string",
+      "minLength": 1
+    },
+    "formatVersion": {
+      "type": "string",
+      "minLength": 1
+    },
+    "commitGenerated": {
+      "type": "boolean",
+      "default": true
+    },
+    "sources": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string",
+        "enum": ["fresh", "stale", "unknown", "missing"]
+      }
+    }
+  }
+}

metagit_cli-0.23.2/src/metagit/data/schemas/atlas/entity.schema.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://metagit.dev/schemas/atlas/entity.schema.json",
+  "title": "EntityEnvelope",
+  "description": "Kubernetes-style envelope for a curated or generated Atlas entity (RFC-0014).",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["apiVersion", "kind", "metadata"],
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "const": "atlas.metagit.dev/v1alpha1"
+    },
+    "kind": {
+      "type": "string",
+      "minLength": 1
+    },
+    "metadata": {
+      "$ref": "#/$defs/EntityMetadata"
+    },
+    "spec": {
+      "type": "object",
+      "additionalProperties": true,
+      "default": {}
+    }
+  },
+  "$defs": {
+    "Lifecycle": {
+      "type": "string",
+      "enum": ["proposed", "active", "deprecated", "retired"]
+    },
+    "Classification": {
+      "type": "string",
+      "enum": ["public", "internal", "confidential", "restricted"]
+    },
+    "ProvenanceSource": {
+      "type": "string",
+      "enum": ["curated", "generated", "imported"]
+    },
+    "Provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source"],
+      "properties": {
+        "source": {
+          "$ref": "#/$defs/ProvenanceSource"
+        },
+        "updatedAt": {
+          "type": "string"
+        }
+      }
+    },
+    "EntityMetadata": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "name", "lifecycle", "classification", "provenance"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]*:[A-Za-z0-9_.\\-]+$"
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "lifecycle": {
+          "$ref": "#/$defs/Lifecycle"
+        },
+        "classification": {
+          "$ref": "#/$defs/Classification"
+        },
+        "provenance": {
+          "$ref": "#/$defs/Provenance"
+        },
+        "owners": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        },
+        "labels": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "default": {}
+        }
+      }
+    }
+  }
+}

{metagit_cli-0.23.0 → metagit_cli-0.23.2}/src/metagit_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metagit-cli
-Version: 0.23.0
+Version: 0.23.2
 Summary: Metagit multi-repo management tool
 Author-email: Zachary Loeber <zloeber@gmail.com>
 Project-URL: Homepage, https://github.com/metagit-ai/metagit-cli

{metagit_cli-0.23.0 → metagit_cli-0.23.2}/src/metagit_cli.egg-info/SOURCES.txt

@@ -749,6 +749,8 @@ src/metagit/data/init-templates/umbrella/template.yaml
 src/metagit/data/prompts/gemini_prompt.md
 src/metagit/data/prompts/gemini_prompt_example.md
 src/metagit/data/prompts/gemini_prompt_filled.md
+src/metagit/data/schemas/atlas/atlas-config.schema.json
+src/metagit/data/schemas/atlas/entity.schema.json
 src/metagit/data/skills/README.md
 src/metagit/data/skills/metagit-agent-access/SKILL.md
 src/metagit/data/skills/metagit-agent-access/reference.md