meridian-cli 0.2.19__tar.gz → 0.2.22__tar.gz

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meridian-cli
-Version: 0.2.19
+Version: 0.2.22
 Summary: Orchestrate CLI + MCP server for multi-model agent workflows
 Project-URL: Homepage, https://github.com/haowjy/meridian-cli
 Project-URL: Repository, https://github.com/haowjy/meridian-cli

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/pyproject.toml

@@ -63,7 +63,9 @@ templates = [
 ]
 
 [build-system]
-requires = ["hatchling>=1.25.0"]
+# Pinned: hatchling >=1.28 emits Metadata-Version 2.5, rejected by pypa/gh-action-pypi-publish.
+# When the publisher supports 2.5, remove the pin and drop scripts/verify-release-metadata.py.
+requires = ["hatchling==1.27.0"]
 build-backend = "hatchling.build"
 
 [tool.hatch.version]

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.2.19"
+__version__ = "0.2.22"

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/cli/bootstrap.py

@@ -23,12 +23,20 @@ _TOP_LEVEL_VALUE_FLAGS = frozenset(
         "--fork",
         "--fork-fresh",
         "--from",
+        "--file",
+        "-f",
+        "--prompt-file",
+        "--prompt",
+        "-p",
+        "--skills",
+        "--goal",
         "--model",
         "-m",
         "--harness",
         "-a",
         "--work",
         "--autocompact",
+        "--autocompact-pct",
         "--effort",
         "--sandbox",
         "--approval",

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/config/AGENTS.md

@@ -71,7 +71,7 @@ Claude profile includes:
 - `[harness.claude] wait_yield_seconds` — polling interval (float, env:
   `MERIDIAN_HARNESS_WAIT_YIELD_SECONDS_CLAUDE`)
 - `[harness.claude] allow_builtin_agents` — whether to permit Claude's built-in
-  subagents (Explore, Plan, General-purpose). Default `false` — Meridian denies them
+  subagents (Explore, Plan, general-purpose). Default `false` — Meridian denies them
   so sessions use custom Meridian agents exclusively. Set `true` to opt out.
 
 ## Depth

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/config/settings.py

@@ -345,6 +345,15 @@ def _normalize_harness_table(
                         )
                     harness_values["wait_yield_seconds"] = float(harness_value)
                     continue
+                if key == "claude" and harness_key == "allow_builtin_agents":
+                    if not isinstance(harness_value, bool):
+                        raise ValueError(
+                            f"Invalid value for '{source}.{key}.allow_builtin_agents': "
+                            f"expected bool, got "
+                            f"{type(harness_value).__name__} ({harness_value!r})."
+                        )
+                    harness_values["allow_builtin_agents"] = harness_value
+                    continue
                 if key == "pi" and harness_key == "disable_managed_bash":
                     if not isinstance(harness_value, bool):
                         raise ValueError(
@@ -425,6 +434,9 @@ def _normalize_spawn_table(raw_value: object, *, source: str) -> dict[str, objec
 
     values: dict[str, object] = {}
     for key, value in cast("dict[str, object]", raw_value).items():
+        if key == "deny_headless_harnesses":
+            values[key] = _parse_toml_list(raw_value=value, source=f"{source}.{key}")
+            continue
         if key not in {"default_wait_yield_seconds", "min_wait_yield_seconds"}:
             logger.warning("Ignoring unknown Meridian config key '%s.%s'.", source, key)
             continue
@@ -1154,6 +1166,7 @@ class HarnessProfileConfig(BaseModel):
 
 
 class ClaudeHarnessProfileConfig(HarnessProfileConfig):
+    allow_builtin_agents: bool = False
     model: Annotated[
         str,
         config_field(
@@ -1354,6 +1367,14 @@ class MeridianConfig(BaseSettings):
             env_vars=("MERIDIAN_MIN_WAIT_YIELD_SECONDS",),
         ),
     ] = 30.0
+    deny_headless_harnesses: Annotated[
+        tuple[str, ...],
+        config_field(
+            "spawn.deny_headless_harnesses",
+            value_kind="str_list",
+            file_aliases=(file_alias("spawn", "deny_headless_harnesses"),),
+        ),
+    ] = ()
     harness: HarnessConfig = Field(default_factory=HarnessConfig)
     primary: PrimaryConfig = Field(default_factory=PrimaryConfig)
     output: OutputConfig = Field(default_factory=OutputConfig)
@@ -1560,6 +1581,23 @@ def resolve_pi_harness_profile_for_launch(
     )
 
 
+def resolve_claude_allow_builtin_agents_for_launch(
+    *,
+    config_snapshot: dict[str, object] | None,
+    project_root: Path,
+) -> bool:
+    """Resolve ``[harness.claude].allow_builtin_agents`` from a launch config snapshot."""
+
+    if config_snapshot:
+        try:
+            return bool(
+                MeridianConfig.model_validate(config_snapshot).harness.claude.allow_builtin_agents
+            )
+        except Exception:
+            pass
+    return bool(load_config(project_root).harness.claude.allow_builtin_agents)
+
+
 def resolve_pi_disable_managed_bash() -> bool:
     """Resolve whether Meridian should skip Pi's managed bash extension."""
 

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/harness/.context/CONTEXT.md

@@ -39,7 +39,7 @@ Per-harness mapping:
 - Claude subprocess: `claude -p --output-format stream-json --verbose -`
 - Claude connection: `claude -p --input-format stream-json --output-format stream-json --verbose` (stdin/stdout NDJSON, not WebSocket despite `claude_ws.py` name)
 - **Claude built-in agent denial**: Meridian injects `--disallowedTools
-  Agent(Explore),Agent(Plan),Agent(General-purpose)` by default. Gated by
+  Agent(Explore),Agent(Plan),Agent(general-purpose)` by default. Gated by
   `[harness.claude] allow_builtin_agents` (bool, default `false`). The denials
   merge into permission-derived `--disallowedTools` via `dedupe_nonempty()`.
 - Codex subprocess: `codex exec --json`; connection: `codex app-server` (real WebSocket, JSON-RPC 2.0)
@@ -190,9 +190,9 @@ value. Windows does not support PTY — Claude primary uses a fallback detection
 
 ### Claude: Built-in Subagent Denial
 
-Claude Code ships with three built-in subagents: Explore, Plan, and General-purpose.
+Claude Code ships with three built-in subagents: Explore, Plan, and general-purpose.
 These conflict with Meridian's own agent system. Meridian injects
-`--disallowedTools Agent(Explore),Agent(Plan),Agent(General-purpose)` by default
+`--disallowedTools Agent(Explore),Agent(Plan),Agent(general-purpose)` by default
 so Claude sessions use custom Meridian agents exclusively. The behavior is gated by
 `[harness.claude] allow_builtin_agents` (bool, default `false`).
 
@@ -205,7 +205,7 @@ permission-derived `--disallowedTools` so exactly one flag is emitted.
 This is implemented as a Meridian platform policy (harness adapter injection),
 not as a per-agent `disallowed-tools` field. This means individual agent profiles
 no longer need to carry deny entries like
-`disallowed-tools: [Agent(Explore), Agent(Plan), Agent(General-purpose)]` —
+`disallowed-tools: [Agent(Explore), Agent(Plan), Agent(general-purpose)]` —
 they're inherited from the harness adapter.
 
 ### Claude: System-Prompt File Channel

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/harness/AGENTS.md

@@ -38,7 +38,7 @@ Per-harness commands:
 - Claude subprocess: `claude -p --output-format stream-json --verbose -`
 - Claude connection: stdin/stdout NDJSON (not WebSocket despite `claude_ws.py` name)
 - **Claude built-in agent denial**: Meridian injects
-  `--disallowedTools Agent(Explore),Agent(Plan),Agent(General-purpose)` by default
+  `--disallowedTools Agent(Explore),Agent(Plan),Agent(general-purpose)` by default
   so sessions use custom Meridian agents instead of Claude's built-in subagents.
   Gated by `[harness.claude] allow_builtin_agents` (bool, default `false`).
   The builtin denials merge into permission-derived `--disallowedTools` via

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/harness/adapter.py

@@ -237,6 +237,7 @@ class SpawnParams(BaseModel):
     context_from_payload: tuple[str, ...] = ()
     reference_items: tuple[Any, ...] = ()
     pi_harness_profile: PiHarnessProfileConfig | None = None
+    claude_allow_builtin_agents: bool = False
 
 
 class McpConfig(BaseModel):

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/harness/claude.py

@@ -265,6 +265,7 @@ class ClaudeAdapter(BaseHarnessAdapter[ResolvedLaunchSpec]):
             "mcp_tools",
             "projected_roots",
             "user_turn_content",
+            "claude_allow_builtin_agents",
         }
     )
     _EXPLICITLY_IGNORED_FIELDS: ClassVar[frozenset[str]] = frozenset(
@@ -374,6 +375,9 @@ class ClaudeAdapter(BaseHarnessAdapter[ResolvedLaunchSpec]):
             prompt_file_path = str(Path(run.control_root) / "system-prompt.md")
         # Extract user_turn_content from run params if available
         user_turn_content = getattr(run, "user_turn_content", None)
+        disallowed_tools: tuple[str, ...] = ()
+        if not run.claude_allow_builtin_agents:
+            disallowed_tools = ("Agent(Explore),Agent(Plan),Agent(general-purpose)",)
         return ResolvedLaunchSpec(
             harness=HarnessId.CLAUDE,
             model=str(run.model).strip() if run.model else None,
@@ -391,6 +395,7 @@ class ClaudeAdapter(BaseHarnessAdapter[ResolvedLaunchSpec]):
             agent_name=run.agent,
             prompt_file_path=prompt_file_path,
             user_turn_content=user_turn_content,
+            disallowed_tools=disallowed_tools,
         )
 
     def preflight(

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/harness/codex.py

@@ -286,6 +286,7 @@ class CodexAdapter(BaseHarnessAdapter[ResolvedLaunchSpec]):
             "reference_items",
             "task_cwd",
             "pi_harness_profile",
+            "claude_allow_builtin_agents",
         }
     )
 

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/harness/cursor.py

@@ -75,6 +75,7 @@ class CursorAdapter(BaseHarnessAdapter[ResolvedLaunchSpec]):
             "continue_fork",
             "effort",
             "pi_harness_profile",
+            "claude_allow_builtin_agents",
         }
     )
 

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/harness/opencode.py

@@ -350,6 +350,7 @@ class OpenCodeAdapter(BaseHarnessAdapter[ResolvedLaunchSpec]):
             "reference_items",
             "task_cwd",
             "pi_harness_profile",
+            "claude_allow_builtin_agents",
         }
     )
 

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/harness/pi.py

@@ -116,6 +116,7 @@ class PiAdapter(BaseHarnessAdapter[ResolvedLaunchSpec]):
             "context_from_payload",
             "reference_items",
             "task_cwd",
+            "claude_allow_builtin_agents",
         }
     )
 

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/harness/projections/project_claude.py

@@ -33,6 +33,7 @@ _PROJECTED_FIELDS: frozenset[str] = frozenset(
         "prompt",
         "prompt_file_path",
         "user_turn_content",
+        "disallowed_tools",
     }
 )
 
@@ -179,6 +180,10 @@ def project_claude_spec_to_cli_args(
 
     permission_flags = resolve_permission_flags(spec.permission_resolver, HarnessId.CLAUDE)
     permission_tail, allowed_tools, disallowed_tools = _extract_claude_tool_flags(permission_flags)
+    spec_disallowed: list[str] = []
+    for entry in spec.disallowed_tools:
+        spec_disallowed.extend(split_csv_entries(entry))
+    disallowed_tools = dedupe_nonempty((*disallowed_tools, *spec_disallowed))
     allowed_tools = dedupe_nonempty((*allowed_tools, *parent_allowed_tools))
     command.extend(permission_tail)
     if allowed_tools:

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/harness/projections/project_codex_streaming.py

@@ -75,6 +75,7 @@ _DELEGATED_FIELDS: frozenset[str] = frozenset(
         "harness",
         "pi_extension_entrypoints",
         "load_all_pi_extensions",
+        "disallowed_tools",
         "prompt_file_path",
         "reference_items",
         "skills",

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/harness/projections/project_codex_subprocess.py

@@ -43,6 +43,7 @@ _DELEGATED_FIELDS: frozenset[str] = frozenset(
         "harness",
         "pi_extension_entrypoints",
         "load_all_pi_extensions",
+        "disallowed_tools",
         "prompt_file_path",
         "reference_items",
         "skills",

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/harness/projections/project_cursor.py

@@ -43,6 +43,7 @@ _DELEGATED_FIELDS: frozenset[str] = frozenset(
         "reference_items",
         "pi_extension_entrypoints",
         "load_all_pi_extensions",
+        "disallowed_tools",
     }
 )
 

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/harness/projections/project_opencode_streaming.py

@@ -50,6 +50,7 @@ _DELEGATED_FIELDS: frozenset[str] = frozenset(
         "harness",
         "pi_extension_entrypoints",
         "load_all_pi_extensions",
+        "disallowed_tools",
         "prompt_file_path",
         "report_output_path",
         "task_cwd",

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/harness/projections/project_opencode_subprocess.py

@@ -42,6 +42,7 @@ _DELEGATED_FIELDS: frozenset[str] = frozenset(
         "harness",
         "pi_extension_entrypoints",
         "load_all_pi_extensions",
+        "disallowed_tools",
         "prompt_file_path",
         "reference_items",
         "report_output_path",

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/harness/projections/project_pi_native_tui.py

@@ -45,6 +45,7 @@ _DELEGATED_FIELDS: frozenset[str] = frozenset(
         "mcp_tools",
         "projected_roots",
         "task_cwd",
+        "disallowed_tools",
     }
 )
 

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/harness/projections/project_pi_rpc.py

@@ -46,6 +46,7 @@ _DELEGATED_FIELDS: frozenset[str] = frozenset(
         "skills",
         "reference_items",
         "task_cwd",
+        "disallowed_tools",
     }
 )
 

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/launch/context.py

@@ -23,6 +23,7 @@ from meridian.lib.config.settings import (
     MeridianConfig,
     PiHarnessProfileConfig,
     load_config,
+    resolve_claude_allow_builtin_agents_for_launch,
     resolve_pi_harness_profile_for_launch,
 )
 from meridian.lib.config.workspace import get_projectable_roots
@@ -555,6 +556,7 @@ def materialize_launch_artifacts(
     approval: str | None = None,
     unsafe_no_permissions: bool = False,
     pi_harness_profile: PiHarnessProfileConfig | None = None,
+    claude_allow_builtin_agents: bool = False,
 ) -> MaterializedLaunchArtifacts:
     """Build shared run/spec/permission launch artifacts."""
 
@@ -595,6 +597,7 @@ def materialize_launch_artifacts(
         reference_items=reference_items,
         user_turn_content=prompt_payload.user_turn_content,
         pi_harness_profile=pi_harness_profile,
+        claude_allow_builtin_agents=claude_allow_builtin_agents,
     )
     permission_config, perms = resolve_permission_pipeline(
         sandbox=sandbox,
@@ -611,6 +614,51 @@ def materialize_launch_artifacts(
     )
 
 
+def _resolve_deny_headless_harnesses(
+    runtime: LaunchRuntime,
+    project_paths: ProjectConfigPaths,
+) -> tuple[str, ...]:
+    """Resolve ``[spawn].deny_headless_harnesses`` from config."""
+    if runtime.config_snapshot:
+        try:
+            return tuple(
+                MeridianConfig.model_validate(
+                    runtime.config_snapshot
+                ).deny_headless_harnesses
+            )
+        except Exception:
+            pass
+    return tuple(load_config(project_paths.project_root).deny_headless_harnesses)
+
+
+_CLAUDE_DELEGATION_GUIDANCE = (
+    "\n\n# Delegation\n"
+    "Prefer Agent() for agents in your agents menu — in-process, fast, visible.\n"
+    "Use `meridian spawn` for agents not in the menu or when you need session\n"
+    "tracking / cross-harness models. Use `/handoff` when the user takes the baton.\n"
+)
+
+
+def _inject_claude_delegation_guidance(
+    prompt_payload: PreparedPromptPayload,
+    *,
+    project_root: Path,
+) -> PreparedPromptPayload:
+    """Append delegation guidance when Claude has native agents available."""
+    claude_agents_dir = project_root / ".claude" / "agents"
+    try:
+        has_claude_agents = claude_agents_dir.is_dir() and any(claude_agents_dir.iterdir())
+    except OSError:
+        return prompt_payload
+    if not has_claude_agents:
+        return prompt_payload
+    existing = prompt_payload.appended_system_prompt or ""
+    return replace(
+        prompt_payload,
+        appended_system_prompt=(existing + _CLAUDE_DELEGATION_GUIDANCE).lstrip(),
+    )
+
+
 def _missing_continue_session_error(source_ref: str | None) -> str:
     normalized_source = (source_ref or "").strip()
     if normalized_source:
@@ -1683,6 +1731,17 @@ def bind_launch_context(
                 }
             )
 
+    if (
+        runtime.composition_surface == LaunchCompositionSurface.SPAWN_PREPARE
+        and harness.id.value in _resolve_deny_headless_harnesses(runtime, project_paths)
+    ):
+        raise ValueError(
+            f"Headless spawns on the '{harness.id.value}' harness are denied by "
+            f"'[spawn] deny_headless_harnesses' in meridian.toml. "
+            f"Use a native primary session for the {harness.id.value} harness, "
+            "or change the setting in meridian.toml."
+        )
+
     is_primary_launch = runtime.composition_surface == LaunchCompositionSurface.PRIMARY
     inject_task_cwd_instruction = directory_context.should_inject_task_cwd_instruction(
         runtime.composition_surface
@@ -1695,6 +1754,21 @@ def bind_launch_context(
         if harness.id == HarnessId.PI
         else None
     )
+    claude_allow_builtin_agents = (
+        resolve_claude_allow_builtin_agents_for_launch(
+            config_snapshot=runtime.config_snapshot,
+            project_root=project_paths.project_root,
+        )
+        if harness.id == HarnessId.CLAUDE
+        else False
+    )
+    if (
+        harness.id == HarnessId.CLAUDE
+        and runtime.composition_surface == LaunchCompositionSurface.PRIMARY
+    ):
+        prompt_payload = _inject_claude_delegation_guidance(
+            prompt_payload, project_root=project_root
+        )
     materialized = materialize_launch_artifacts(
         harness=harness,
         prompt=resolved_request.prompt,
@@ -1724,6 +1798,7 @@ def bind_launch_context(
         approval=resolved_request.execution_policy.approval,
         unsafe_no_permissions=runtime.unsafe_no_permissions,
         pi_harness_profile=pi_harness_profile,
+        claude_allow_builtin_agents=claude_allow_builtin_agents,
     )
     run_params = materialized.run_params
 

{meridian_cli-0.2.19 → meridian_cli-0.2.22}/src/meridian/lib/launch/launch_types.py

@@ -106,6 +106,7 @@ class ResolvedLaunchSpec(BaseModel):
     # Claude only
     agents_payload: str | None = None
     prompt_file_path: str | None = None
+    disallowed_tools: tuple[str, ...] = ()
 
     # Claude + Codex
     user_turn_content: str | None = None