crewplane 0.3.2__tar.gz → 0.3.4__tar.gz

{crewplane-0.3.2 → crewplane-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: crewplane
-Version: 0.3.2
+Version: 0.3.4
 Summary: A provider-neutral CLI-first control plane for human-designed coding-agent workflows
 Project-URL: Homepage, https://github.com/crewplaneai/crewplane
 Project-URL: Repository, https://github.com/crewplaneai/crewplane
@@ -37,10 +37,22 @@ Description-Content-Type: text/markdown
     Crewplane is an open-source workflow runner for reviewable, resumable
     coding-agent workflows. Define the whole process in Markdown — the prompts,
     stages, agents, handoffs, and rules for what happens next.
-    Crewplane runs Claude Code, Codex, Copilot CLI, Gemini, Kilo, or another CLI.
+    Crewplane runs your coding-agent CLIs.
     Review becomes a gate, completed work survives failure, and every handoff
     stays on disk.
   </p>
+  <p>
+    Works with:
+    <a href="https://code.claude.com/docs/en/overview" title="Claude Code documentation"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-svg/icons/claudecode-color.svg" width="20" height="20" align="top" alt="Claude Code"></a>&nbsp;
+    <a href="https://learn.chatgpt.com/docs/codex/cli" title="Codex CLI documentation"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-svg/icons/codex-color.svg" width="20" height="20" align="top" alt="Codex"></a>&nbsp;
+    <a href="https://docs.github.com/en/copilot/concepts/agents/copilot-cli/about-copilot-cli" title="GitHub Copilot CLI documentation"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/dark/githubcopilot.png"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/light/githubcopilot.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/light/githubcopilot.png" width="20" height="20" align="top" alt="GitHub Copilot CLI"></picture></a>&nbsp;
+    <a href="https://geminicli.com/docs/" title="Gemini CLI documentation"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-svg/icons/geminicli-color.svg" width="20" height="20" align="top" alt="Gemini CLI"></a>&nbsp;
+    <a href="https://kilo.ai/docs/code-with-ai/platforms/cli" title="Kilo Code CLI documentation"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/dark/kilocode.png"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/light/kilocode.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/light/kilocode.png" width="20" height="20" align="top" alt="Kilo Code"></picture></a>&nbsp;
+    <a href="https://pi.dev/docs/latest" title="Pi documentation"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/dark/pi.png"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/light/pi.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/light/pi.png" width="20" height="20" align="top" alt="Pi"></picture></a>&nbsp;
+    <a href="https://deepseek-harness.github.io/deepseek-harness/" title="DeepSeek Harness documentation"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-svg/icons/deepseek-color.svg" width="20" height="20" align="top" alt="DeepSeek"></a>&nbsp;
+    <a href="https://opencode.ai/docs/cli/" title="OpenCode CLI documentation"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/dark/opencode.png"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/light/opencode.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/light/opencode.png" width="20" height="20" align="top" alt="OpenCode"></picture></a>&nbsp;·&nbsp;
+    <a href="docs/getting-started/provider-setup.md">Provider&nbsp;setup&nbsp;→</a>
+  </p>
   <p>
     <a href="https://github.com/crewplaneai/crewplane/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/crewplaneai/crewplane/actions/workflows/ci.yml/badge.svg?branch=master"></a>
     <a href="https://www.bestpractices.dev/projects/13966"><img src="https://www.bestpractices.dev/projects/13966/badge"></a>

{crewplane-0.3.2 → crewplane-0.3.4}/README.md

@@ -5,10 +5,22 @@
     Crewplane is an open-source workflow runner for reviewable, resumable
     coding-agent workflows. Define the whole process in Markdown — the prompts,
     stages, agents, handoffs, and rules for what happens next.
-    Crewplane runs Claude Code, Codex, Copilot CLI, Gemini, Kilo, or another CLI.
+    Crewplane runs your coding-agent CLIs.
     Review becomes a gate, completed work survives failure, and every handoff
     stays on disk.
   </p>
+  <p>
+    Works with:
+    <a href="https://code.claude.com/docs/en/overview" title="Claude Code documentation"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-svg/icons/claudecode-color.svg" width="20" height="20" align="top" alt="Claude Code"></a>&nbsp;
+    <a href="https://learn.chatgpt.com/docs/codex/cli" title="Codex CLI documentation"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-svg/icons/codex-color.svg" width="20" height="20" align="top" alt="Codex"></a>&nbsp;
+    <a href="https://docs.github.com/en/copilot/concepts/agents/copilot-cli/about-copilot-cli" title="GitHub Copilot CLI documentation"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/dark/githubcopilot.png"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/light/githubcopilot.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/light/githubcopilot.png" width="20" height="20" align="top" alt="GitHub Copilot CLI"></picture></a>&nbsp;
+    <a href="https://geminicli.com/docs/" title="Gemini CLI documentation"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-svg/icons/geminicli-color.svg" width="20" height="20" align="top" alt="Gemini CLI"></a>&nbsp;
+    <a href="https://kilo.ai/docs/code-with-ai/platforms/cli" title="Kilo Code CLI documentation"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/dark/kilocode.png"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/light/kilocode.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/light/kilocode.png" width="20" height="20" align="top" alt="Kilo Code"></picture></a>&nbsp;
+    <a href="https://pi.dev/docs/latest" title="Pi documentation"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/dark/pi.png"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/light/pi.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/light/pi.png" width="20" height="20" align="top" alt="Pi"></picture></a>&nbsp;
+    <a href="https://deepseek-harness.github.io/deepseek-harness/" title="DeepSeek Harness documentation"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-svg/icons/deepseek-color.svg" width="20" height="20" align="top" alt="DeepSeek"></a>&nbsp;
+    <a href="https://opencode.ai/docs/cli/" title="OpenCode CLI documentation"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/dark/opencode.png"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/light/opencode.png"><img src="https://raw.githubusercontent.com/lobehub/lobe-icons/a94750e3f5f8fc33757b839d85030e742284e43a/packages/static-png/light/opencode.png" width="20" height="20" align="top" alt="OpenCode"></picture></a>&nbsp;·&nbsp;
+    <a href="docs/getting-started/provider-setup.md">Provider&nbsp;setup&nbsp;→</a>
+  </p>
   <p>
     <a href="https://github.com/crewplaneai/crewplane/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/crewplaneai/crewplane/actions/workflows/ci.yml/badge.svg?branch=master"></a>
     <a href="https://www.bestpractices.dev/projects/13966"><img src="https://www.bestpractices.dev/projects/13966/badge"></a>

{crewplane-0.3.2 → crewplane-0.3.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "crewplane"
-version = "0.3.2"
+version = "0.3.4"
 description = "A provider-neutral CLI-first control plane for human-designed coding-agent workflows"
 readme = "README.md"
 requires-python = ">=3.13"
@@ -41,7 +41,7 @@ Issues = "https://github.com/crewplaneai/crewplane/issues"
 Documentation = "https://github.com/crewplaneai/crewplane/blob/master/docs/index.md"
 
 [build-system]
-requires = ["hatchling==1.32.0"]
+requires = ["hatchling==1.32.3"]
 build-backend = "hatchling.build"
 
 [tool.hatch.build.targets.wheel]

{crewplane-0.3.2 → crewplane-0.3.4}/src/crewplane/adapters/invokers/cli_invoker/capabilities.py

@@ -13,7 +13,17 @@ from crewplane.architecture.contracts.provider_log import build_provider_log_hea
 from crewplane.core.config import AgentConfig
 
 from .capability import CliInvocationRequest, CliProviderCapability
-from .providers import claude, codex, copilot, deepseek, gemini, generic, kilo, pi
+from .providers import (
+    claude,
+    codex,
+    copilot,
+    deepseek,
+    gemini,
+    generic,
+    kilo,
+    opencode,
+    pi,
+)
 
 CAPABILITIES: dict[ProviderKind, CliProviderCapability] = {
     ProviderKind.CLAUDE: claude.CLAUDE,
@@ -23,6 +33,7 @@ CAPABILITIES: dict[ProviderKind, CliProviderCapability] = {
     ProviderKind.KILO: kilo.KILO,
     ProviderKind.PI: pi.PI,
     ProviderKind.DEEPSEEK: deepseek.DEEPSEEK,
+    ProviderKind.OPENCODE: opencode.OPENCODE,
     ProviderKind.GENERIC: generic.GENERIC,
 }
 

crewplane-0.3.4/src/crewplane/adapters/invokers/cli_invoker/providers/opencode.py

@@ -0,0 +1,169 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from crewplane.architecture.contracts import ProviderKind
+
+from ..capability import CliCommand, CliInvocationRequest, CliProviderCapability
+from ..commands import build_standard_command
+from ..env_command import parse_env_command_context
+from ..validation import reject_unsupported_reasoning
+from .opencode_events import decode_opencode_usage, extract_opencode_output
+
+_VALUE_OPTIONS = frozenset(
+    {"--model", "-m", "--agent", "--variant", "--title", "--log-level"}
+)
+_BOOLEAN_OPTIONS = frozenset({"--thinking", "--auto", "--print-logs"})
+_CONFLICTING_OPTIONS = frozenset(
+    {
+        "--format",
+        "--continue",
+        "-c",
+        "--session",
+        "-s",
+        "--fork",
+        "--attach",
+        "--password",
+        "-p",
+        "--username",
+        "-u",
+        "--port",
+        "--hostname",
+        "--dir",
+        "--file",
+        "-f",
+        "--command",
+        "--interactive",
+        "-i",
+        "--mini",
+        "--share",
+        "--help",
+        "-h",
+        "--version",
+        "-v",
+        "--replay",
+        "--replay-limit",
+        "--no-replay",
+        "--yolo",
+        "--dangerously-skip-permissions",
+        "--demo",
+        "--",
+    }
+)
+
+
+def validate_opencode_request(request: CliInvocationRequest) -> None:
+    """Validate a fresh local run before command construction or allocation."""
+    try:
+        reject_unsupported_reasoning(request)
+    except ValueError as exc:
+        raise ValueError(f"OpenCode: {exc}") from exc
+    config = request.config
+    if config.prompt_transport != "stdin" or config.prompt_transport_arg is not None:
+        raise ValueError(
+            "OpenCode requires stdin transport without prompt_transport_arg."
+        )
+    arguments = _run_arguments(request)
+    seen_options: set[str] = set()
+    command_models = _validate_arguments(arguments, "cli_cmd", seen_options)
+    extra_models = _validate_arguments(
+        tuple(config.extra_args), "extra_args", seen_options
+    )
+    _validate_model_selection(command_models + extra_models, request.model)
+
+
+def _run_arguments(request: CliInvocationRequest) -> tuple[str, ...]:
+    try:
+        context = parse_env_command_context(request.config.cli_cmd, None, "")
+    except ValueError as exc:
+        raise ValueError(f"OpenCode env wrapper validation failed: {exc}") from exc
+    if context.command_working_directory_option is not None:
+        raise ValueError(
+            f"OpenCode option {context.command_working_directory_option!r} "
+            "conflicts with the runtime-owned working directory."
+        )
+    if context.command_executable is None:
+        raise ValueError("OpenCode requires an executable after the env wrapper.")
+    arguments = context.command_arguments
+    if not arguments or arguments[0] != "run":
+        raise ValueError("OpenCode requires run immediately after the executable.")
+    return arguments[1:]
+
+
+def _validate_arguments(
+    arguments: tuple[str, ...], location: str, seen_options: set[str]
+) -> tuple[str, ...]:
+    model_options: list[str] = []
+    tokens = iter(enumerate(arguments, start=1))
+    for position, token in tokens:
+        option, separator, inline_value = token.partition("=")
+        if option in _BOOLEAN_OPTIONS:
+            _validate_boolean(option, inline_value if separator else None)
+            continue
+        if option not in _VALUE_OPTIONS:
+            _reject_argument(option, location, position)
+        value = inline_value if separator else next(tokens, (0, None))[1]
+        _validate_value(option, value)
+        if option in {"--model", "-m"}:
+            model_options.append(option)
+            continue
+        if option in seen_options:
+            raise ValueError(
+                f"OpenCode option {option!r} may appear at most once "
+                "across cli_cmd and extra_args."
+            )
+        seen_options.add(option)
+    return tuple(model_options)
+
+
+def _validate_boolean(option: str, value: str | None) -> None:
+    if value is not None and value not in {"true", "false"}:
+        raise ValueError(
+            f"OpenCode option {option!r} requires a bare flag or =true/=false."
+        )
+
+
+def _validate_value(option: str, value: str | None) -> None:
+    if value is None or not value.strip() or (value.startswith("-") and value != "-"):
+        raise ValueError(f"OpenCode option {option!r} requires a nonblank value.")
+
+
+def _reject_argument(option: str, location: str, position: int) -> None:
+    if option in _CONFLICTING_OPTIONS:
+        raise ValueError(
+            f"OpenCode option {option!r} conflicts with managed fresh local runs."
+        )
+    raise ValueError(
+        f"OpenCode {location} argument at position {position} is outside the "
+        "supported option grammar; positional prompts are not supported."
+    )
+
+
+def _validate_model_selection(options: tuple[str, ...], model: str | None) -> None:
+    if model is not None:
+        _validate_value("--model", model)
+    if len(options) > 1:
+        raise ValueError("OpenCode accepts at most one raw --model/-m selector.")
+    if options and model is not None:
+        raise ValueError(
+            f"OpenCode option {options[0]!r} conflicts with the resolved Crewplane model."
+        )
+
+
+def build_opencode_command(request: CliInvocationRequest, prompt: str) -> CliCommand:
+    """Bind native directory selection to runtime cwd instead of inherited PWD."""
+    directory = (request.working_directory or Path.cwd()).resolve()
+    return build_standard_command(
+        request, prompt, structured_args=("--format", "json", "--dir", str(directory))
+    )
+
+
+OPENCODE = CliProviderCapability(
+    provider_kind=ProviderKind.OPENCODE,
+    validate_request=validate_opencode_request,
+    build_command=build_opencode_command,
+    output_extractor=extract_opencode_output,
+    usage_decoder=decode_opencode_usage,
+    log_presentation_format="json_lines",
+    log_presentation_profile="generic",
+)

crewplane-0.3.4/src/crewplane/adapters/invokers/cli_invoker/providers/opencode_events.py

@@ -0,0 +1,218 @@
+from __future__ import annotations
+
+import json
+import math
+from collections.abc import Mapping
+from dataclasses import dataclass, field
+from pathlib import Path
+
+from crewplane.architecture.contracts import (
+    CommandResult,
+    OutputExtractionResult,
+    ProviderTokenUsage,
+    UsageDecodeResult,
+)
+
+from ..usage_decoders import CounterReader, UsageAccumulator, complete_sum
+
+_ANSWER_EVENTS = frozenset({"step_start", "text", "tool_use", "step_finish"})
+type _Identity = tuple[str, str, str]
+type _Counters = tuple[int | None, ...]
+
+
+def extract_opencode_output(
+    result: CommandResult,
+    structured_output_file: Path | None,  # noqa: ARG001 - OutputExtractor contract.
+) -> OutputExtractionResult:
+    """Select only completed text from the terminal stopped message."""
+    state = _AnswerState()
+    try:
+        for line in result.iter_stdout_lines():
+            event = _read_event(line)
+            if event is not None:
+                state.consume(event)
+    except ValueError:
+        return OutputExtractionResult("", "malformed")
+    return state.result()
+
+
+@dataclass(frozen=True)
+class _AnswerPart:
+    kind: str
+    message_id: str
+    text: str = ""
+    end: int | float | None = None
+    reason: str = ""
+
+
+@dataclass
+class _AnswerState:
+    session_id: str | None = None
+    last_message: str | None = None
+    parts: dict[str, _AnswerPart] = field(default_factory=dict)
+    finish_reasons: dict[str, str] = field(default_factory=dict)
+
+    def consume(self, event: Mapping[str, object]) -> None:
+        kind = event.get("type")
+        if kind == "error":
+            raise ValueError("OpenCode session error.")
+        if not isinstance(kind, str) or kind not in _ANSWER_EVENTS:
+            return
+        identity, part = _identified_part(event)
+        session_id, message_id, part_id = identity
+        if self.session_id is not None and self.session_id != session_id:
+            raise ValueError("Inconsistent OpenCode session identity.")
+        self.session_id = session_id
+        snapshot = _answer_part(kind, message_id, part)
+        if part_id in self.parts:
+            if self.parts[part_id] != snapshot:
+                raise ValueError("Contradictory OpenCode part snapshot.")
+            return
+        self.parts[part_id] = snapshot
+        self.last_message = message_id
+        if kind == "step_finish":
+            self.finish_reasons[message_id] = snapshot.reason
+        else:
+            self.finish_reasons.pop(message_id, None)
+
+    def result(self) -> OutputExtractionResult:
+        if (
+            self.last_message is None
+            or self.finish_reasons.get(self.last_message) != "stop"
+        ):
+            return OutputExtractionResult("", "missing")
+        texts = [
+            part.text
+            for part in self.parts.values()
+            if part.message_id == self.last_message and part.text.strip()
+        ]
+        if not texts:
+            return OutputExtractionResult("", "missing")
+        text = "\n".join(texts)
+        if not text.endswith("\n"):
+            text += "\n"
+        return OutputExtractionResult(text, "success", output_char_count=len(text))
+
+
+def _answer_part(kind: str, message_id: str, part: Mapping[str, object]) -> _AnswerPart:
+    if kind == "text":
+        text = part.get("text")
+        if not isinstance(text, str):
+            raise ValueError("Malformed OpenCode text.")
+        return _AnswerPart(kind, message_id, text=text, end=_completed_time(part))
+    if kind == "step_finish":
+        reason = part.get("reason")
+        if not isinstance(reason, str):
+            raise ValueError("Malformed OpenCode finish reason.")
+        return _AnswerPart(kind, message_id, reason=reason)
+    return _AnswerPart(kind, message_id)
+
+
+def _completed_time(part: Mapping[str, object]) -> int | float:
+    time = part.get("time")
+    end = time.get("end") if isinstance(time, dict) else None
+    if (
+        isinstance(end, bool)
+        or not isinstance(end, (int, float))
+        or end <= 0
+        or (isinstance(end, float) and not math.isfinite(end))
+    ):
+        raise ValueError("OpenCode text requires a completed time.end.")
+    return end
+
+
+def _read_event(line: str) -> Mapping[str, object] | None:
+    if not line.strip():
+        return None
+    try:
+        event = json.loads(line)
+    except json.JSONDecodeError as exc:
+        raise ValueError("Malformed OpenCode JSON output.") from exc
+    if not isinstance(event, dict):
+        raise ValueError("OpenCode events must be JSON objects.")
+    return event
+
+
+def _identified_part(
+    event: Mapping[str, object],
+) -> tuple[_Identity, Mapping[str, object]]:
+    part = event.get("part")
+    if not isinstance(part, dict):
+        raise ValueError("Malformed OpenCode event part.")
+    session_id = _identity_field(event, "sessionID")
+    if session_id != _identity_field(part, "sessionID"):
+        raise ValueError("Inconsistent OpenCode envelope/part session identity.")
+    return (
+        (session_id, _identity_field(part, "messageID"), _identity_field(part, "id")),
+        part,
+    )
+
+
+def _identity_field(payload: Mapping[str, object], key: str) -> str:
+    value = payload.get(key)
+    if not isinstance(value, str) or not value.strip():
+        raise ValueError(f"OpenCode {key} must be a nonblank string.")
+    return value
+
+
+def decode_opencode_usage(result: CommandResult) -> UsageDecodeResult:
+    """Aggregate distinct native steps independently of answer extraction."""
+    accumulator = UsageAccumulator()
+    reports: dict[_Identity, _Counters] = {}
+    for line in result.iter_stdout_lines():
+        try:
+            event = _read_event(line)
+            if event is None or event.get("type") != "step_finish":
+                continue
+            report = _usage_report(event)
+            if report is None:
+                continue
+            identity, counters = report
+            if identity in reports:
+                if reports[identity] != counters:
+                    raise ValueError("Contradictory OpenCode step usage report.")
+                continue
+            reports[identity] = counters
+            accumulator.record_usage(_normalized_usage(counters))
+        except ValueError as exc:
+            accumulator.record_error(str(exc))
+    return accumulator.result()
+
+
+def _usage_report(
+    event: Mapping[str, object],
+) -> tuple[_Identity, _Counters] | None:
+    part = event.get("part")
+    if not isinstance(part, dict) or "tokens" not in part:
+        return None
+    identity, part = _identified_part(event)
+    tokens = part["tokens"]
+    if not isinstance(tokens, dict):
+        raise ValueError("Malformed OpenCode token payload.")
+    cache = tokens.get("cache")
+    if cache is None:
+        cache = {}
+    if not isinstance(cache, dict):
+        raise ValueError("Malformed OpenCode cache payload.")
+    counters = CounterReader("OpenCode", tokens)
+    cached = CounterReader("OpenCode", cache)
+    return identity, (
+        counters.optional("input"),
+        counters.optional("output"),
+        counters.optional("reasoning"),
+        cached.optional("read"),
+        cached.optional("write"),
+        counters.optional("total"),
+    )
+
+
+def _normalized_usage(counters: _Counters) -> ProviderTokenUsage:
+    input_tokens, output, reasoning, cache_read, cache_write, total = counters
+    return ProviderTokenUsage(
+        input=complete_sum(input_tokens, cache_read, cache_write),
+        cached_input=cache_read,
+        cache_write=cache_write,
+        output=complete_sum(output, reasoning),
+        reasoning=reasoning,
+        total=total if total is not None else complete_sum(*counters[:5]),
+    )

{crewplane-0.3.2 → crewplane-0.3.4}/src/crewplane/adapters/invokers/mock_invoker/invoker.py

@@ -9,12 +9,10 @@ from crewplane.architecture.contracts import (
     MockInvokerOptions,
 )
 from crewplane.architecture.contracts.invocation_failures import (
+    InvocationFailureError,
     InvocationFailureSummary,
 )
 from crewplane.core.config import AgentConfig
-from crewplane.runtime.agent.failures import (
-    InvocationFailureError,
-)
 
 from .context import is_reviewer_context
 from .fixtures import fixture_candidates

{crewplane-0.3.2 → crewplane-0.3.4}/src/crewplane/architecture/contracts/execution_status.py

@@ -1,7 +1,7 @@
 """Execution states and the subsets supported by each lifecycle."""
 
 from enum import StrEnum, unique
-from typing import Literal
+from typing import Literal, get_args
 
 
 @unique
@@ -16,6 +16,16 @@ class ExecutionStatus(StrEnum):
     BLOCKED = "blocked"
 
 
+type TerminalWorkspaceStatus = Literal[
+    ExecutionStatus.SUCCEEDED,
+    ExecutionStatus.FAILED,
+    ExecutionStatus.CANCELLED,
+]
+TERMINAL_WORKSPACE_STATUSES: frozenset[TerminalWorkspaceStatus] = frozenset(
+    get_args(TerminalWorkspaceStatus.__value__)
+)
+
+
 type LifecycleStatus = Literal[
     ExecutionStatus.PENDING,
     ExecutionStatus.RUNNING,

{crewplane-0.3.2 → crewplane-0.3.4}/src/crewplane/architecture/contracts/integration_secrets.py

@@ -4,15 +4,13 @@ import re
 from collections.abc import Callable, Collection, Sequence
 from dataclasses import dataclass, field
 
+from crewplane.core.sensitive_names import is_sensitive_name
+
 from .json import JsonObject, JsonValue
 
 type JsonPathSegment = str | int
 type SensitiveOptionTransform = Callable[[str, JsonValue], JsonValue]
 
-_SENSITIVE_OPTION_PATTERN = re.compile(
-    r"(secret|token|password|passwd|api[_-]?key|credential|private)",
-    re.IGNORECASE,
-)
 _INVALID_JSON_POINTER_ESCAPE = re.compile(r"~(?:[^01]|$)")
 _JSON_ARRAY_INDEX = re.compile(r"0|[1-9][0-9]*")
 
@@ -117,10 +115,7 @@ class _SensitiveOptionWalker:
     @staticmethod
     def _is_sensitive_name(path: tuple[JsonPathSegment, ...]) -> bool:
         segment = path[-1]
-        return (
-            isinstance(segment, str)
-            and _SENSITIVE_OPTION_PATTERN.search(segment) is not None
-        )
+        return isinstance(segment, str) and is_sensitive_name(segment)
 
     def _has_explicit_descendant(self, pointer: str) -> bool:
         prefix = f"{pointer}/"

{crewplane-0.3.2 → crewplane-0.3.4}/src/crewplane/architecture/contracts/invocation.py

@@ -32,6 +32,7 @@ class ProviderKind(StrEnum):
     KILO = "kilo"
     PI = "pi"
     DEEPSEEK = "deepseek"
+    OPENCODE = "opencode"
     GENERIC = "generic"
 
 

{crewplane-0.3.2 → crewplane-0.3.4}/src/crewplane/architecture/contracts/invocation_failures.py

@@ -54,6 +54,23 @@ class InvocationFailureSummary:
         return self.message
 
 
+class InvocationFailureError(RuntimeError):
+    def __init__(
+        self,
+        prefix: str,
+        summary: InvocationFailureSummary,
+        log_file: Path | None,
+    ) -> None:
+        self.summary = summary
+        self.kind = summary.kind
+        self.phase = summary.phase
+        self.source = summary.source
+        self.advice = summary.advice
+        self.log_file = log_file
+        self.last_non_quota_failure: InvocationFailureSummary | None = None
+        super().__init__(f"{prefix}: {summary.format_for_error(log_file)}")
+
+
 ADVICE_BY_KIND: dict[FailureKind, str] = {
     "provider_session_context_exhausted": (
         "Provider context filled during tool or file exploration. Split the "

{crewplane-0.3.2 → crewplane-0.3.4}/src/crewplane/artifacts/atomic.py

@@ -8,6 +8,23 @@ from contextlib import suppress
 from pathlib import Path
 from typing import Any
 
+_TEMPORARY_SUFFIX = ".tmp"
+
+
+def _temporary_name_prefix(target_name: str) -> str:
+    return f".{target_name}."
+
+
+def atomic_temporary_target_name(name: str) -> str | None:
+    """Decode a temporary basename without imposing target-file eligibility."""
+    if not name.startswith(".") or not name.endswith(_TEMPORARY_SUFFIX):
+        return None
+    target_and_token = name[1 : -len(_TEMPORARY_SUFFIX)]
+    target_name, separator, token = target_and_token.rpartition(".")
+    if not separator or not token or not target_name:
+        return None
+    return target_name
+
 
 def json_bytes(payload: Any) -> bytes:
     return (
@@ -32,8 +49,8 @@ def atomic_write_bytes(path: Path, payload: bytes, ensure_parent: bool = True) -
         with tempfile.NamedTemporaryFile(
             mode="wb",
             dir=path.parent,
-            prefix=f".{path.name}.",
-            suffix=".tmp",
+            prefix=_temporary_name_prefix(path.name),
+            suffix=_TEMPORARY_SUFFIX,
             delete=False,
         ) as handle:
             publication_phase = "write temporary file"
@@ -75,8 +92,8 @@ def atomic_write_bytes_if_absent(
         with tempfile.NamedTemporaryFile(
             mode="wb",
             dir=path.parent,
-            prefix=f".{path.name}.",
-            suffix=".tmp",
+            prefix=_temporary_name_prefix(path.name),
+            suffix=_TEMPORARY_SUFFIX,
             delete=False,
         ) as handle:
             publication_phase = "write temporary file"