multi-forge 0.3.0__tar.gz → 0.4.0__tar.gz

{multi_forge-0.3.0 → multi_forge-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multi-forge
-Version: 0.3.0
+Version: 0.4.0
 Summary: Multi-runtime agent toolkit: proxy routing, cost control, session management, policy enforcement, and workflow orchestration
 Project-URL: Homepage, https://github.com/hapa1i/multi-forge
 Project-URL: Repository, https://github.com/hapa1i/multi-forge
@@ -42,7 +42,7 @@ Description-Content-Type: text/markdown
 # Multi-Forge
 
 <p align="left">
-  <img src="assets/logo.jpg" alt="Dusk" width=320">
+  <img src="assets/logo.jpg" alt="Dusk" width=240">
 </p>
 
 [![PyPI](https://img.shields.io/pypi/v/multi-forge)](https://pypi.org/project/multi-forge/)
@@ -96,7 +96,7 @@ Running `claude` directly bypasses session tracking. When you launch through For
 | Hook-driven artifacts  | No                | Yes -- plan snapshots, transcript capture     |
 | Policy enforcement     | No                | Yes -- TDD, coding standards, supervisor      |
 | Search across sessions | No                | Yes -- `forge search` indexes transcripts     |
-| Handoff agent          | No                | Yes -- auto-updates project docs on exit      |
+| Project memory         | No                | Yes -- passported docs auto-updated on exit   |
 
 Even without a proxy, `forge session start` gives you session tracking, hooks, and the status line (direct mode is the
 default). The proxy adds multi-model routing on top. (`forge claude start` is also available as a bare launcher with
@@ -209,6 +209,7 @@ inside Claude Code for an interactive walkthrough.
 | ---------------------- | -------------------------------------------- |
 | `forge claude`         | Bare launch, settings preset management      |
 | `forge session`        | Named sessions, worktrees, resume, fork      |
+| `forge memory`         | Project memory passports, shadow proposals   |
 | `forge proxy`          | Model routing, templates, tier mappings      |
 | `forge authentication` | Credential management (`credentials.yaml`)   |
 | `forge policy`         | Policy enforcement, plan supervision         |

{multi_forge-0.3.0 → multi_forge-0.4.0}/README.md

@@ -1,7 +1,7 @@
 # Multi-Forge
 
 <p align="left">
-  <img src="assets/logo.jpg" alt="Dusk" width=320">
+  <img src="assets/logo.jpg" alt="Dusk" width=240">
 </p>
 
 [![PyPI](https://img.shields.io/pypi/v/multi-forge)](https://pypi.org/project/multi-forge/)
@@ -55,7 +55,7 @@ Running `claude` directly bypasses session tracking. When you launch through For
 | Hook-driven artifacts  | No                | Yes -- plan snapshots, transcript capture     |
 | Policy enforcement     | No                | Yes -- TDD, coding standards, supervisor      |
 | Search across sessions | No                | Yes -- `forge search` indexes transcripts     |
-| Handoff agent          | No                | Yes -- auto-updates project docs on exit      |
+| Project memory         | No                | Yes -- passported docs auto-updated on exit   |
 
 Even without a proxy, `forge session start` gives you session tracking, hooks, and the status line (direct mode is the
 default). The proxy adds multi-model routing on top. (`forge claude start` is also available as a bare launcher with
@@ -168,6 +168,7 @@ inside Claude Code for an interactive walkthrough.
 | ---------------------- | -------------------------------------------- |
 | `forge claude`         | Bare launch, settings preset management      |
 | `forge session`        | Named sessions, worktrees, resume, fork      |
+| `forge memory`         | Project memory passports, shadow proposals   |
 | `forge proxy`          | Model routing, templates, tier mappings      |
 | `forge authentication` | Credential management (`credentials.yaml`)   |
 | `forge policy`         | Policy enforcement, plan supervision         |

{multi_forge-0.3.0 → multi_forge-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "multi-forge"
-version = "0.3.0"
+version = "0.4.0"
 description = "Multi-runtime agent toolkit: proxy routing, cost control, session management, policy enforcement, and workflow orchestration"
 readme = "README.md"
 license = "Apache-2.0"
@@ -122,10 +122,11 @@ disallow_untyped_calls = false
 constraint-dependencies = [
     "filelock>=3.20.3",
     "virtualenv>=20.36.1",
-    "aiohttp>=3.13.4",
+    "aiohttp>=3.14.0",
     "cryptography>=46.0.7",
     "python-multipart>=0.0.26",
     "Pygments>=2.20.0",
+    "starlette>=1.0.1",
 ]
 # litellm pins fastapi-sso<0.17.0 but 0.16.x has a CSRF vulnerability.
 # Forge doesn't use fastapi-sso directly; override to force the patched version.
@@ -148,6 +149,7 @@ dev = [
     "types-PyYAML>=6.0.0",
     "types-requests>=2.31.0",
     "python-dotenv>=1.2.1",
+    "httpx2>=2.3.0",
 ]
 provider-check = [
     "anthropic>=0.100.0",

{multi_forge-0.3.0 → multi_forge-0.4.0}/src/forge/__init__.py

@@ -1,3 +1,3 @@
 """Multi-Forge - Multi-runtime agent toolkit."""
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"

multi_forge-0.4.0/src/forge/cli/activity.py

@@ -0,0 +1,151 @@
+"""``forge activity`` — per-session Forge *automation* activity (supervisor, memory
+writer, workflow verbs) + policy decisions. NOT your full interactive Claude usage.
+
+Reads the two already-captured planes (usage ledger + ``confirmed.policy.decisions``)
+via :func:`forge.core.ops.usage_summary.build_session_activity_summary` and renders a
+table. Cost is reported-or-estimated (best-effort attribution) — ``forge proxy costs show``
+stays the authoritative spend view.
+"""
+
+from __future__ import annotations
+
+import json
+import sys
+from dataclasses import asdict
+from datetime import datetime, timedelta, timezone
+
+import click
+from rich.console import Console
+from rich.table import Table
+
+from forge.cli.output import print_error_with_tip
+from forge.core.ops.session_context import (
+    SessionContextError,
+    resolve_session_identifier,
+)
+from forge.core.ops.usage_summary import (
+    SessionActivitySummary,
+    build_session_activity_summary,
+)
+
+console = Console()
+
+
+@click.command("activity")
+@click.argument("session", required=False)
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+@click.option("--days", "-d", type=int, default=30, help="Look back this many days (default: 30)")
+@click.option("--all", "all_time", is_flag=True, help="Report all time (ignore --days)")
+def activity_cmd(session: str | None, as_json: bool, days: int, all_time: bool) -> None:
+    """Show Forge's automation activity for a session: supervisor checks, cost, tokens.
+
+    This is what Forge did *on top of* your session — the supervisor, memory writer,
+    and workflow verbs (panel/debate/...) — plus policy decisions. It is **not** your
+    full interactive Claude usage. Reads the usage ledger and the session's
+    policy-decision log. Cost is reported-or-estimated (best-effort attribution);
+    'forge proxy costs show' is the authoritative spend view.
+
+    \b
+    Examples:
+        forge activity                  # current session ($FORGE_SESSION)
+        forge activity planner          # a named session (or Claude UUID)
+        forge activity --all --json     # full history, JSON
+    """
+    try:
+        session_name, forge_root = resolve_session_identifier(session)
+    except SessionContextError as e:
+        if as_json:
+            click.echo(json.dumps({"error": str(e)}))
+        else:
+            print_error_with_tip(
+                str(e),
+                "Run 'forge session list' to see sessions.",
+                console=console,
+            )
+        sys.exit(1)
+
+    since = None if all_time else datetime.now(timezone.utc) - timedelta(days=days)
+    summary = build_session_activity_summary(session_name, forge_root, since=since)
+
+    if as_json:
+        console.print_json(data=asdict(summary))
+        return
+    _render(summary, days=None if all_time else days)
+
+
+def _render(summary: SessionActivitySummary, *, days: int | None) -> None:
+    scope = "all time" if days is None else f"last {days}d"
+    if summary.is_empty:
+        console.print(f"[dim]No Forge activity for session '{summary.session}' ({scope}).[/dim]")
+        return
+
+    console.print(f"\n[bold]Forge activity — {summary.session}[/bold] [dim]({scope})[/dim]")
+    console.print(
+        "[dim]Forge automation (supervisor, memory writer, workflow verbs) — "
+        "not your full interactive session.[/dim]"
+    )
+
+    if summary.commands:
+        # The Workers column only earns its width when a fan-out (panel/debate/...) ran;
+        # supervisor/memory-writer have no workers, so most sessions skip it.
+        show_workers = any(c.workers for c in summary.commands)
+        table = Table(show_header=True, header_style="bold", box=None, padding=(0, 2))
+        table.add_column("Command", style="cyan")
+        table.add_column("Calls", justify="right")
+        if show_workers:
+            table.add_column("Workers", justify="right", style="dim")
+        table.add_column("Errors", justify="right")
+        table.add_column("Tokens in/out", justify="right", style="dim")
+        table.add_column("Cost", justify="right", style="dim")
+        for c in summary.commands:
+            errors = f"[red]{c.errors}[/red]" if c.errors else "0"
+            tokens = f"{c.input_tokens}/{c.output_tokens}" if (c.input_tokens or c.output_tokens) else "-"
+            cost = f"~{_fmt_usd(c.cost_micro_usd)}" if c.cost_micro_usd is not None else "-"
+            row = [c.command, str(c.calls)]
+            if show_workers:
+                row.append(str(c.workers) if c.workers else "-")
+            row += [errors, tokens, cost]
+            table.add_row(*row)
+        console.print(table)
+
+    pol = summary.policy
+    if pol and pol.has_content:
+        console.print(
+            f"\n[bold]Supervisor[/bold]: {pol.supervisor_allow} allow · "
+            f"{pol.supervisor_warn} warn · {pol.supervisor_deny} block"
+        )
+        for warning in pol.recent_warnings:
+            console.print(f"  [yellow]•[/yellow] {warning}")
+
+    if summary.subagents:
+        console.print(f"\n[bold]Subagents[/bold]: {summary.subagents}")
+
+    total_cost = f"~{_fmt_usd(summary.total_cost_micro_usd)}" if summary.total_cost_micro_usd is not None else "n/a"
+    console.print(
+        f"\n[dim]Total:[/dim] {summary.total_events} events · "
+        f"{summary.total_input_tokens}/{summary.total_output_tokens} tok · {total_cost}"
+    )
+
+    for note in _footnotes(summary):
+        console.print(f"[dim]{note}[/dim]")
+
+
+def _footnotes(summary: SessionActivitySummary) -> list[str]:
+    notes: list[str] = []
+    if summary.cost_partial:
+        notes.append("cost is best-effort and partial (some calls report no cost)")
+    if summary.policy is not None and summary.policy.log_capped:
+        notes.append("policy decision log is at capacity — older decisions may not be shown")
+    if summary.session_tagging_partial:
+        notes.append("some calls (e.g. the action tagger) are not session-attributed")
+    notes.append("cost is reported-or-estimated, best-effort; 'forge proxy costs show' is the authoritative spend view")
+    return notes
+
+
+def _fmt_usd(micros: int | None) -> str:
+    if micros is None:
+        return "-"
+    dollars = micros / 1_000_000
+    if dollars and abs(dollars) < 0.01:
+        return f"${dollars:.4f}"
+    return f"${dollars:.2f}"

{multi_forge-0.3.0 → multi_forge-0.4.0}/src/forge/cli/auth.py

@@ -408,8 +408,7 @@ def status(profile: str | None) -> None:
     help="Profile to remove credentials from (default: 'default' or FORGE_PROFILE)",
 )
 @click.option("--yes", "-y", is_flag=True, help="Skip confirmation prompt")
-@click.option("--force", "-f", is_flag=True, hidden=True, help="Deprecated alias for --yes")
-def logout(profile: str | None, yes: bool, force: bool) -> None:
+def logout(profile: str | None, yes: bool) -> None:
     """Remove stored credentials for a profile.
 
     Deletes the profile from ~/.forge/credentials.yaml.
@@ -421,7 +420,6 @@ def logout(profile: str | None, yes: bool, force: bool) -> None:
         forge authentication logout --profile work
         forge authentication logout -y  # Skip confirmation
     """
-    yes = yes or force
     profile_name = resolve_profile(profile)
 
     if not yes:

{multi_forge-0.3.0 → multi_forge-0.4.0}/src/forge/cli/backend.py

@@ -251,8 +251,7 @@ def stop_cmd(adapter: str, port: int) -> None:
     help="Delete specific instance (if not specified, deletes config)",
 )
 @click.option("--yes", "-y", is_flag=True, help="Skip confirmation prompt")
-@click.option("--force", "-f", is_flag=True, hidden=True, help="Deprecated alias for --yes")
-def delete_cmd(adapter: str, port: int | None, yes: bool, force: bool) -> None:
+def delete_cmd(adapter: str, port: int | None, yes: bool) -> None:
     """Delete a backend instance or config.
 
     Without --port: Deletes the backend config (stops all instances first).
@@ -260,7 +259,6 @@ def delete_cmd(adapter: str, port: int | None, yes: bool, force: bool) -> None:
     """
     import shutil
 
-    yes = yes or force
     console = Console(width=200)
 
     if port is not None:

{multi_forge-0.3.0 → multi_forge-0.4.0}/src/forge/cli/claude.py

@@ -392,13 +392,11 @@ def preset_edit() -> None:
 
 @preset.command("reset")
 @click.option("--yes", "-y", is_flag=True, help="Skip confirmation prompt")
-@click.option("--force", "-f", is_flag=True, hidden=True, help="Deprecated alias for --yes")
-def preset_reset(yes: bool, force: bool) -> None:
+def preset_reset(yes: bool) -> None:
     """Reset settings preset to built-in defaults."""
     from forge.core.state import atomic_write_text
     from forge.install.preset import get_builtin_preset_json, get_preset_path
 
-    yes = yes or force
     preset_path = get_preset_path()
 
     if not yes:

{multi_forge-0.3.0 → multi_forge-0.4.0}/src/forge/cli/config_cmd.py

@@ -16,7 +16,8 @@ import shutil
 import subprocess
 import sys
 import tempfile
-from dataclasses import fields
+from collections.abc import MutableMapping
+from dataclasses import asdict, fields, is_dataclass
 from pathlib import Path
 from typing import Any
 
@@ -71,7 +72,12 @@ def show_cmd(raw: bool = False) -> None:
 
     effective: dict[str, Any] = {}
     for f in fields(RuntimeConfig):
-        effective[f.name] = getattr(rc, f.name)
+        val = getattr(rc, f.name)
+        # Nested config (e.g. statusline) must render as a plain mapping — yaml
+        # can't dump a dataclass instance.
+        if is_dataclass(val) and not isinstance(val, type):
+            val = asdict(val)
+        effective[f.name] = val
 
     content = yaml.dump(effective, default_flow_style=False, sort_keys=False)
 
@@ -107,6 +113,11 @@ def set_cmd(key_value: str) -> None:
 
     key, value = key_value.split("=", 1)
 
+    # Nested section keys (e.g. statusline.cost_mode) take the dotted path.
+    if "." in key:
+        _set_nested_key(key, value, console)
+        return
+
     known_fields = {f.name: f for f in fields(RuntimeConfig)}
     if key not in known_fields:
         console.print(f"[red]Error:[/red] Unknown config key: '{key}'")
@@ -198,6 +209,20 @@ def edit_cmd() -> None:
             console.print(f"Your changes are saved at: {display_path(tmp_path)}")
             sys.exit(1)
 
+        # Segment names aren't validated by StatusLineConfig (the renderer and
+        # the set/edit CLI own that), so the edit path must enforce the allowlist
+        # too — otherwise statusline.segments: [path, bogus] would be accepted.
+        sl_section = edited_data.get("statusline")
+        if isinstance(sl_section, dict) and isinstance(sl_section.get("segments"), list):
+            unknown_segs = _unknown_segments(sl_section["segments"])
+            if unknown_segs:
+                from forge.cli.statusline.names import SEGMENT_NAMES
+
+                console.print(f"[red]Error:[/red] Unknown statusline segment(s): {', '.join(map(str, unknown_segs))}")
+                console.print(f"[dim]Valid segments: {', '.join(SEGMENT_NAMES)}[/dim]")
+                console.print(f"Your changes are saved at: {display_path(tmp_path)}")
+                sys.exit(1)
+
         write_runtime_config(dict(edited_data))
         success = True
         console.print("[green]Updated[/green] runtime configuration")
@@ -213,14 +238,12 @@ def edit_cmd() -> None:
 @config.command("reset")
 @click.argument("key", required=False)
 @click.option("--yes", "-y", is_flag=True, help="Skip confirmation prompt")
-@click.option("--force", "-f", is_flag=True, hidden=True, help="Deprecated alias for --yes")
-def reset_cmd(key: str | None = None, yes: bool = False, force: bool = False) -> None:
+def reset_cmd(key: str | None = None, yes: bool = False) -> None:
     """Reset configuration to defaults.
 
     With KEY: removes that key (reverts to built-in default).
     Without KEY: deletes the entire config file.
     """
-    yes = yes or force
     console = Console(width=200)
     config_path = get_config_path()
 
@@ -257,18 +280,23 @@ def reset_cmd(key: str | None = None, yes: bool = False, force: bool = False) ->
         return
 
     del data[key]
+    _persist_or_clear(data, config_path)
+
+    default_val = getattr(RuntimeConfig(), key)
+    console.print(f"[green]Reset[/green] {key} (default: {default_val})")
 
+
+# --- Helpers ---
+
+
+def _persist_or_clear(data: MutableMapping[str, Any], config_path: Path) -> None:
+    """Write ``data`` back, or remove the config file when nothing remains."""
     if data:
         write_runtime_config(dict(data))
     else:
         config_path.unlink()
         reset_runtime_config()
 
-    default_val = getattr(RuntimeConfig(), key)
-    console.print(f"[green]Reset[/green] {key} (default: {default_val})")
-
-
-# --- Helpers ---
 
 _COERCE_ERROR = object()
 
@@ -301,3 +329,79 @@ def _coerce_value(key: str, value: str, field_info: Any) -> Any:
 
     # String fields: pass through
     return value
+
+
+def _unknown_segments(segments: list[Any]) -> list[Any]:
+    """Return segment names not in the allowlist (the set/edit strict gate).
+
+    Segment names are intentionally NOT validated by ``StatusLineConfig`` (the
+    renderer drops unknown names on load); the write paths reject them instead.
+    """
+    from forge.cli.statusline.names import SEGMENT_NAMES
+
+    return [s for s in segments if s not in SEGMENT_NAMES]
+
+
+def _set_nested_key(key: str, value: str, console: Console) -> None:
+    """Set a dotted nested config key. Only ``statusline.<subkey>`` is supported.
+
+    Strict (fail-closed): unknown section/subkey, invalid enum values, and
+    unknown segment names all error and exit non-zero, naming valid options.
+    """
+    from forge.cli.statusline.names import SEGMENT_NAMES
+    from forge.runtime_config import StatusLineConfig
+
+    section, _, subkey = key.partition(".")
+    if section != "statusline":
+        console.print(f"[red]Error:[/red] Unknown config section: '{section}'")
+        console.print("\n[dim]Only 'statusline.*' nested keys are supported.[/dim]")
+        sys.exit(1)
+
+    sl_fields = {f.name: f for f in fields(StatusLineConfig)}
+    if subkey not in sl_fields:
+        console.print(f"[red]Error:[/red] Unknown statusline key: '{subkey}'")
+        console.print(f"\n[dim]Available: {', '.join(sorted(sl_fields))}[/dim]")
+        sys.exit(1)
+
+    coerced_sub: Any
+    if subkey == "segments":
+        coerced_sub = [s.strip() for s in value.split(",") if s.strip()]
+        unknown = _unknown_segments(coerced_sub)
+        if unknown:
+            console.print(f"[red]Error:[/red] Unknown segment(s): {', '.join(unknown)}")
+            console.print(f"\n[dim]Valid segments: {', '.join(SEGMENT_NAMES)}[/dim]")
+            sys.exit(1)
+    else:
+        coerced_sub = _coerce_value(subkey, value, sl_fields[subkey])
+        if coerced_sub is _COERCE_ERROR:
+            console.print(f"[red]Error:[/red] Invalid value for 'statusline.{subkey}': {value}")
+            sys.exit(1)
+
+    config_path = get_config_path()
+    if config_path.is_file():
+        from ruamel.yaml import YAML
+
+        ruamel = YAML()
+        ruamel.preserve_quotes = True
+        with open(config_path) as f:
+            data = ruamel.load(f) or {}
+    else:
+        data = {}
+
+    section_data = data.get("statusline")
+    if not isinstance(section_data, dict):
+        section_data = {}
+    section_data[subkey] = coerced_sub
+    data["statusline"] = section_data
+
+    # Validate via construction — StatusLineConfig.__post_init__ rejects bad enums
+    # (fail-closed); segment names were already checked above.
+    known_fields = {f.name for f in fields(RuntimeConfig)}
+    try:
+        RuntimeConfig(**{k: v for k, v in dict(data).items() if k in known_fields})
+    except (ValueError, TypeError) as e:
+        console.print(f"[red]Error:[/red] Invalid configuration: {e}")
+        sys.exit(1)
+
+    write_runtime_config(data)
+    console.print(f"[green]Set[/green] {key}={coerced_sub}")

multi_forge-0.4.0/src/forge/cli/editor.py

@@ -0,0 +1,44 @@
+"""Shared $EDITOR launcher for editable transfer/context files.
+
+Extracted from ``session_lifecycle`` so both ``forge session resume --review``
+and ``forge transfer edit`` use one editor-launch path with the same
+git-commit-style abort behavior: a non-zero editor exit aborts and leaves the
+file untouched.
+"""
+
+from __future__ import annotations
+
+import os
+import shlex
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+from rich.console import Console
+
+from forge.cli.output import print_tip
+
+
+def open_in_editor(file_path: Path, *, console: Console, abort_tip: str | None = None) -> None:
+    """Open ``file_path`` in $EDITOR, aborting on a non-zero editor exit.
+
+    Git-commit-style: a non-zero editor exit prints the optional ``abort_tip``
+    and exits with the editor's return code, leaving the file as the user left
+    it. Exits 1 when $EDITOR is empty or its program is not on PATH.
+    """
+    editor = os.environ.get("EDITOR", "vim")
+    editor_argv = shlex.split(editor)
+    if not editor_argv:
+        console.print("[red]Error:[/red] $EDITOR is empty. Set $EDITOR to an available editor.")
+        sys.exit(1)
+    if not shutil.which(editor_argv[0]):
+        console.print(f"[red]Error:[/red] Editor '{editor}' not found. Set $EDITOR to an available editor.")
+        sys.exit(1)
+
+    result = subprocess.run([*editor_argv, str(file_path)])
+    if result.returncode != 0:
+        console.print(f"[red]Aborted:[/red] editor exited with code {result.returncode}.")
+        if abort_tip:
+            print_tip(abort_tip, blank_before=False, console=console)
+        sys.exit(result.returncode)

{multi_forge-0.3.0 → multi_forge-0.4.0}/src/forge/cli/extensions.py

@@ -712,8 +712,7 @@ def sync_cmd(scope: str | None, force: bool) -> None:
     help="Disable ALL tracked installations",
 )
 @click.option("--yes", "-y", is_flag=True, help="Skip confirmation prompt")
-@click.option("--force", "-f", is_flag=True, hidden=True, help="Deprecated alias for --yes")
-def disable_cmd(scope: str | None, uninstall_all: bool, yes: bool, force: bool) -> None:
+def disable_cmd(scope: str | None, uninstall_all: bool, yes: bool) -> None:
     """Disable Forge extensions.
 
     Removes only files and settings entries that were added by Forge.
@@ -737,8 +736,6 @@ def disable_cmd(scope: str | None, uninstall_all: bool, yes: bool, force: bool)
         forge extension disable --scope local     # Disable local scope
         forge extension disable --all --yes       # Disable everything
     """
-    yes = yes or force
-
     if uninstall_all and scope is not None:
         raise click.UsageError("--all and --scope are mutually exclusive.")
     try:
@@ -791,7 +788,7 @@ def disable_cmd(scope: str | None, uninstall_all: bool, yes: bool, force: bool)
             console.print("[bold]Settings:[/bold]")
             console.print(table)
 
-        if not (force or yes):
+        if not yes:
             if not click.confirm("\nProceed with disable?"):
                 console.print("[dim]Cancelled.[/dim]")
                 return

{multi_forge-0.3.0 → multi_forge-0.4.0}/src/forge/cli/gc.py

@@ -24,7 +24,7 @@ from forge.core.ops.gc import CleanError, CleanReport, collect_clean_report, run
 @click.option("--verbose", "-v", is_flag=True, help="Show individual items")
 @click.option("--json", "as_json", is_flag=True, help="JSON output")
 def clean_cmd(scope: str, yes: bool, verbose: bool, as_json: bool) -> None:
-    """Remove orphaned Forge state (sessions, handoff files, stale entries).
+    """Remove orphaned Forge state (sessions, transfer files, stale entries).
 
     By default, shows what would be cleaned (dry-run). Pass --yes to actually delete.
 
@@ -156,7 +156,7 @@ def _category_label(category: str) -> str:
     """Human-readable label for a category."""
     labels = {
         "session_dirs": "Orphan session dirs:",
-        "handoff_files": "Orphan handoff files:",
+        "transfer_files": "Orphan transfer files:",
         "active_entries": "Stale active entries:",
         "work_queue": "Stale work queue:",
         "proxies": "Stale proxy entries:",