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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multi-forge
-Version: 0.2.0
+Version: 0.3.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
@@ -24,15 +24,15 @@ Requires-Python: <3.14,>=3.11
 Requires-Dist: click>=8.3.1
 Requires-Dist: coolname<6,>=5.0.0
 Requires-Dist: dacite>=1.8.0
-Requires-Dist: fastapi>=0.115.11
+Requires-Dist: fastapi>=0.115.14
 Requires-Dist: httpx>=0.25.0
-Requires-Dist: litellm[proxy]>=1.84.0
+Requires-Dist: litellm[proxy]>=1.85.0
 Requires-Dist: openai>=1.0.0
 Requires-Dist: packaging>=21.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: python-dotenv>=1.2.2
 Requires-Dist: pyyaml>=6.0.0
-Requires-Dist: rich>=13.0.0
+Requires-Dist: rich>=13.9.0
 Requires-Dist: ruamel-yaml>=0.18.0
 Requires-Dist: tenacity>=8.0.0
 Requires-Dist: uvicorn>=0.31.1
@@ -41,8 +41,13 @@ Description-Content-Type: text/markdown
 
 # Multi-Forge
 
-[![License](https://img.shields.io/github/license/hapa1i/multi-forge)](LICENSE)
-[![Python](https://img.shields.io/badge/python-3.11--3.13-blue)](https://github.com/hapa1i/multi-forge)
+<p align="left">
+  <img src="assets/logo.jpg" alt="Dusk" width=320">
+</p>
+
+[![PyPI](https://img.shields.io/pypi/v/multi-forge)](https://pypi.org/project/multi-forge/)
+[![Python](https://img.shields.io/pypi/pyversions/multi-forge)](https://pypi.org/project/multi-forge/)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
 
 > [!WARNING]
 > **Research Preview** -- Forge is under active development. APIs, commands, and file formats may change without notice
@@ -206,7 +211,7 @@ inside Claude Code for an interactive walkthrough.
 | `forge session`        | Named sessions, worktrees, resume, fork      |
 | `forge proxy`          | Model routing, templates, tier mappings      |
 | `forge authentication` | Credential management (`credentials.yaml`)   |
-| `forge guard`          | Policy enforcement, plan supervision         |
+| `forge policy`         | Policy enforcement, plan supervision         |
 | `forge workflow`       | Workflow runners (panel, analyze, debate)    |
 | `forge search`         | Transcript search across sessions            |
 | `forge config`         | Runtime preferences (`~/.forge/config.yaml`) |
@@ -217,11 +222,12 @@ Run `forge <command> --help` for details on any command.
 
 ## Documentation
 
-| Audience         | Location                           | Contents                                          |
-| ---------------- | ---------------------------------- | ------------------------------------------------- |
-| **Users**        | [docs/end-user/](docs/end-user/)   | Tour, guides for sessions, proxies, policies, ... |
-| **Developers**   | [docs/developer/](docs/developer/) | Setup, coding standards, testing guidelines       |
-| **Architecture** | [docs/design.md](docs/design.md)   | System narrative, data flow, invariants           |
+| Audience         | Location                           | Contents                                             |
+| ---------------- | ---------------------------------- | ---------------------------------------------------- |
+| **Users**        | [docs/end-user/](docs/end-user/)   | Tour, guides for sessions, proxies, policies, ...    |
+| **Developers**   | [docs/developer/](docs/developer/) | Setup, coding standards, testing guidelines          |
+| **Architecture** | [docs/design.md](docs/design.md)   | System narrative, data flow, invariants              |
+| **Work Board**   | [docs/board/](docs/board/)         | Cards, checklists, change log, implementation memory |
 
 ## Contributing
 

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

@@ -1,7 +1,12 @@
 # Multi-Forge
 
-[![License](https://img.shields.io/github/license/hapa1i/multi-forge)](LICENSE)
-[![Python](https://img.shields.io/badge/python-3.11--3.13-blue)](https://github.com/hapa1i/multi-forge)
+<p align="left">
+  <img src="assets/logo.jpg" alt="Dusk" width=320">
+</p>
+
+[![PyPI](https://img.shields.io/pypi/v/multi-forge)](https://pypi.org/project/multi-forge/)
+[![Python](https://img.shields.io/pypi/pyversions/multi-forge)](https://pypi.org/project/multi-forge/)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
 
 > [!WARNING]
 > **Research Preview** -- Forge is under active development. APIs, commands, and file formats may change without notice
@@ -165,7 +170,7 @@ inside Claude Code for an interactive walkthrough.
 | `forge session`        | Named sessions, worktrees, resume, fork      |
 | `forge proxy`          | Model routing, templates, tier mappings      |
 | `forge authentication` | Credential management (`credentials.yaml`)   |
-| `forge guard`          | Policy enforcement, plan supervision         |
+| `forge policy`         | Policy enforcement, plan supervision         |
 | `forge workflow`       | Workflow runners (panel, analyze, debate)    |
 | `forge search`         | Transcript search across sessions            |
 | `forge config`         | Runtime preferences (`~/.forge/config.yaml`) |
@@ -176,11 +181,12 @@ Run `forge <command> --help` for details on any command.
 
 ## Documentation
 
-| Audience         | Location                           | Contents                                          |
-| ---------------- | ---------------------------------- | ------------------------------------------------- |
-| **Users**        | [docs/end-user/](docs/end-user/)   | Tour, guides for sessions, proxies, policies, ... |
-| **Developers**   | [docs/developer/](docs/developer/) | Setup, coding standards, testing guidelines       |
-| **Architecture** | [docs/design.md](docs/design.md)   | System narrative, data flow, invariants           |
+| Audience         | Location                           | Contents                                             |
+| ---------------- | ---------------------------------- | ---------------------------------------------------- |
+| **Users**        | [docs/end-user/](docs/end-user/)   | Tour, guides for sessions, proxies, policies, ...    |
+| **Developers**   | [docs/developer/](docs/developer/) | Setup, coding standards, testing guidelines          |
+| **Architecture** | [docs/design.md](docs/design.md)   | System narrative, data flow, invariants              |
+| **Work Board**   | [docs/board/](docs/board/)         | Cards, checklists, change log, implementation memory |
 
 ## Contributing
 

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

@@ -1,6 +1,6 @@
 [project]
 name = "multi-forge"
-version = "0.2.0"
+version = "0.3.0"
 description = "Multi-runtime agent toolkit: proxy routing, cost control, session management, policy enforcement, and workflow orchestration"
 readme = "README.md"
 license = "Apache-2.0"
@@ -28,7 +28,7 @@ dependencies = [
     "dacite>=1.8.0",
     "click>=8.3.1",
     "coolname>=5.0.0,<6",
-    "rich>=13.0.0",
+    "rich>=13.9.0",
     "pydantic>=2.0.0",
     "openai>=1.0.0",
     "httpx>=0.25.0",
@@ -41,10 +41,10 @@ dependencies = [
     # Plain `fastapi` (no `[standard]` extras): Forge uses none of websockets/
     # uvloop/httptools/multipart/jinja2. `watchfiles` is declared explicitly
     # because Forge owns `--reload` (`forge proxy server --reload`).
-    "fastapi>=0.115.11",
+    "fastapi>=0.115.14",
     "uvicorn>=0.31.1",
     "watchfiles>=0.20",
-    "litellm[proxy]>=1.84.0",
+    "litellm[proxy]>=1.85.0",
 ]
 
 [project.scripts]
@@ -104,9 +104,11 @@ markers = [
 asyncio_mode = "auto"
 
 [tool.mypy]
-# Exclude extension scripts with optional dependencies
+# Same-named standalone scripts in separate skill directories collide in mypy's
+# module map during broad scans. Keep this exclusion local to the duplicate
+# script name; it is not a source-of-truth relationship between the skills.
 exclude = [
-    "src/skills/",
+    'src/skills/qa/scripts/walkthrough-state\.py$',
 ]
 ignore_missing_imports = true
 
@@ -137,18 +139,19 @@ dev = [
     "pytest-cov>=4.1.0",
     "pytest-asyncio>=0.23.0",
     "pytest-mock>=3.15.1",
-    "ruff>=0.8.0",
+    "ruff>=0.15.0",
+    "black>=26.5.0",
     "mypy>=1.13.0",
     "pyright>=1.1.0",
     "pytest-rerunfailures>=14.0",
-    "pre-commit>=4.0.0",
+    "pre-commit>=4.5.0",
     "types-PyYAML>=6.0.0",
     "types-requests>=2.31.0",
     "python-dotenv>=1.2.1",
 ]
 provider-check = [
-    "anthropic>=0.52.0",
-    "google-genai>=2.3.0",
-    "openai>=1.0.0",
+    "anthropic>=0.100.0",
+    "google-genai>=2.5.0",
+    "openai>=2.0.0",
     "tiktoken>=0.12.0",
 ]

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

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

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

@@ -21,6 +21,7 @@ from forge.backend import BackendManager
 from forge.backend.adapters import get_adapter
 from forge.backend.creation import create_backend_config, get_backend_config_path
 from forge.backend.registry import BackendRegistryStore, is_pid_alive
+from forge.cli.output import print_error_with_tip, print_tip
 from forge.core.paths import display_path, get_forge_home
 
 
@@ -64,7 +65,7 @@ def list_cmd(as_json: bool) -> None:
 
     if not backends:
         console.print("No backends found.")
-        console.print("\n[dim]Tip: Run 'forge backend create litellm'.[/dim]")
+        print_tip("Run 'forge backend create litellm'.", console=console)
         return
 
     table = Table(title="Forge Backends")
@@ -146,7 +147,7 @@ def show_cmd(backend_id: str, raw: bool) -> None:
             console.print(syntax)
     else:
         console.print(f"\n[dim]No config found for adapter '{adapter_type}'.[/dim]")
-        console.print(f"[dim]Tip: Run 'forge backend create {adapter_type}'.[/dim]")
+        print_tip(f"Run 'forge backend create {adapter_type}'.", blank_before=False, console=console)
 
 
 @backend.command("create")
@@ -166,10 +167,13 @@ def create_cmd(adapter: str, config: Path | None) -> None:
 
     config_path = get_backend_config_path(adapter)
     if config_path.exists():
-        console.print(f"[yellow]Backend config already exists:[/yellow] {display_path(config_path)}")
-        console.print("\n[dim]Start an instance with:[/dim]")
-        console.print(f"  forge backend start {adapter} --port 4000")
-        return
+        print_error_with_tip(
+            f"Backend config already exists: {display_path(config_path)}",
+            "Start an instance with:",
+            commands=[f"forge backend start {adapter} --port 4000"],
+            console=console,
+        )
+        sys.exit(1)
 
     try:
         config_path = create_backend_config(
@@ -194,9 +198,12 @@ def start_cmd(adapter: str, port: int) -> None:
 
     config_path = get_backend_config_path(adapter)
     if not config_path.exists():
-        console.print(f"[red]Error:[/red] Backend config not found for '{adapter}'")
-        console.print("\n[dim]Create it first:[/dim]")
-        console.print(f"  forge backend create {adapter}")
+        print_error_with_tip(
+            f"Backend config not found for '{adapter}'",
+            "Create it first:",
+            commands=[f"forge backend create {adapter}"],
+            console=console,
+        )
         sys.exit(1)
 
     backend_id = f"{adapter}-{port}"
@@ -271,7 +278,12 @@ def delete_cmd(adapter: str, port: int | None, yes: bool, force: bool) -> None:
     else:
         backend_dir = get_forge_home() / "backends" / adapter
         if not backend_dir.exists():
-            console.print(f"[red]Error:[/red] Backend config not found for '{adapter}'")
+            print_error_with_tip(
+                f"Backend config not found for '{adapter}'",
+                "Create it first:",
+                commands=[f"forge backend create {adapter}"],
+                console=console,
+            )
             sys.exit(1)
 
         if not yes and not click.confirm(f"Delete backend config for '{adapter}' (stops all instances)?"):

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

@@ -20,10 +20,9 @@ from rich.console import Console
 
 from forge.core.paths import display_path
 from forge.proxy.proxies import (
+    ProxyNotFoundError,
     ProxyRegistryCorruptedError,
-    ProxyRegistryStore,
     ProxyResolutionError,
-    resolve_proxy,
 )
 from forge.session.direct_model import apply_direct_model_env
 
@@ -208,20 +207,22 @@ def start_cmd(
     proxy_display: str | None = None
 
     if proxy_id:
-        proxy_store = ProxyRegistryStore()
+        from forge.proxy.proxy_orchestrator import ProxyStartError, ensure_proxy
 
         try:
-            registry = proxy_store.read()
+            entry, started = ensure_proxy(proxy_id)
         except ProxyRegistryCorruptedError as e:
             click.echo(f"Error: {e}")
             sys.exit(1)
-
-        try:
-            entry = resolve_proxy(registry, proxy_id)
-        except ProxyResolutionError as e:
+        except (ProxyResolutionError, ProxyStartError) as e:
             click.echo(f"Error: {e}")
+            if isinstance(e, ProxyNotFoundError):
+                click.echo("Tip: Run 'forge proxy template list' to see available templates.")
             sys.exit(1)
 
+        if started:
+            console.print(f"[dim]Started proxy '{entry.proxy_id}' from template '{proxy_id}'.[/dim]")
+
         try:
             _healthcheck_proxy(
                 base_url=entry.base_url,

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

@@ -35,23 +35,23 @@ from forge.runtime_config import (
 )
 
 
-@click.group(invoke_without_command=True)
+@click.group(invoke_without_command=True, subcommand_metavar="[COMMAND] [ARGS]...")
 @click.pass_context
 def config(ctx: click.Context) -> None:
     """Manage Forge global configuration.
 
     \b
     Configuration file: ~/.forge/config.yaml
-    Auto-created with documented defaults on first access.
+    Auto-created with documented defaults by `forge config show`.
 
     \b
     Examples:
-        forge config                      # Show effective config
+        forge config show                 # Show effective config
         forge config set proxy_mode=sidecar
         forge config edit                 # Open in $EDITOR
     """
     if ctx.invoked_subcommand is None:
-        ctx.invoke(show_cmd)
+        click.echo(ctx.get_help())
 
 
 @config.command("show")

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

@@ -17,6 +17,7 @@ import click
 from rich.console import Console
 from rich.table import Table
 
+from forge.cli.output import print_tip
 from forge.core.paths import display_path
 from forge.install.exceptions import (
     ForgeInstallError,
@@ -179,11 +180,17 @@ def _print_completion_message(
             parts.append(f"{settings_actions} setting{'s' if settings_actions != 1 else ''}")
         console.print(f"\n[green]Extensions enabled.[/green] ({', '.join(parts)} updated)")
 
-    console.print("[dim]Tip: Customize permissions and env vars with 'forge claude preset edit'.[/dim]")
+    print_tip(
+        "Run 'forge claude preset edit' to customize permissions and env vars.",
+        blank_before=False,
+        console=console,
+    )
 
     if InstallModule.SKILLS.value in plan.modules:
-        console.print(
-            "[dim]Tip: Multi-model skills require proxy credentials. " "Run 'forge auth status' to check.[/dim]"
+        print_tip(
+            "Multi-model skills require proxy credentials. Run 'forge auth status' to check.",
+            blank_before=False,
+            console=console,
         )
 
     profile = InstallProfile(plan.profile)
@@ -191,7 +198,7 @@ def _print_completion_message(
     if gated:
         skill_list = ", ".join(f"/forge:{name}" for name, _ in gated)
         required = gated[0][1].value
-        console.print(f"\n[dim]Tip: Additional skills available with --profile {required}: {skill_list}[/dim]")
+        print_tip(f"Additional skills available with --profile {required}: {skill_list}", console=console)
 
 
 def _validate_anchor(anchor: Path) -> None:
@@ -321,7 +328,7 @@ def _print_plan(plan: InstallPlan, dry_run: bool = False) -> None:
         console.print(f"\n{prefix}[bold red]Conflicts detected:[/bold red]")
         for c in plan.conflicts:
             console.print(f"  [red]- {c}[/red]")
-        console.print("\n[dim]Tip: Use --force to override, or resolve conflicts manually.[/dim]")
+        print_tip("Use --force to override, or resolve conflicts manually.", console=console)
 
 
 def _uninstall_all_installations(tracking: TrackingStore, yes: bool) -> None:
@@ -507,7 +514,7 @@ def enable_cmd(
         version_check = check_minimum_version()
         if not version_check.ok:
             console.print(f"[red]Error:[/red] {version_check.reason}")
-            console.print("\n[dim]Tip: Run 'claude update' to upgrade.[/dim]")
+            print_tip("Run 'claude update' to upgrade.", console=console)
             sys.exit(1)
 
         anchor = Path(path) if path else None
@@ -597,14 +604,13 @@ def enable_cmd(
         raise
     except NoClaudeDirectoryError as e:
         console.print(f"[red]Error:[/red] {e}")
-        console.print(
-            "\n[dim]Tip: Use '--scope user' to enable globally, "
-            "or '--root <dir>' to target a specific directory.[/dim]"
+        print_tip(
+            "Use --scope user to enable globally, or --root <dir> to target a specific directory.", console=console
         )
         sys.exit(1)
     except SettingsConflictError as e:
         console.print(f"[red]Settings conflict:[/red] {e}")
-        console.print("\n[dim]Tip: Use --force to override.[/dim]")
+        print_tip("Use --force to override.", console=console)
         sys.exit(1)
     except ForgeInstallError as e:
         console.print(f"[red]Error:[/red] {e}")
@@ -647,7 +653,7 @@ def sync_cmd(scope: str | None, force: bool) -> None:
         version_check = check_minimum_version()
         if not version_check.ok:
             console.print(f"[red]Error:[/red] {version_check.reason}")
-            console.print("\n[dim]Tip: Run 'claude update' to upgrade.[/dim]")
+            print_tip("Run 'claude update' to upgrade.", console=console)
             sys.exit(1)
 
         if scope is None:
@@ -683,7 +689,7 @@ def sync_cmd(scope: str | None, force: bool) -> None:
         sys.exit(1)
     except NotInstalledError as e:
         console.print(f"[red]Error:[/red] {e}")
-        console.print("\n[dim]Tip: Run 'forge extension enable' first.[/dim]")
+        print_tip("Run 'forge extension enable' first.", console=console)
         sys.exit(1)
     except ForgeInstallError as e:
         console.print(f"[red]Error:[/red] {e}")
@@ -809,12 +815,12 @@ def disable_cmd(scope: str | None, uninstall_all: bool, yes: bool, force: bool)
     except NoForgeInstallationError as e:
         console.print(f"[red]Error:[/red] {e}")
         sys.exit(1)
-    except ForgeInstallError as e:
-        console.print(f"[red]Error:[/red] {e}")
-        sys.exit(1)
     except TrackingCorruptedError as e:
         console.print(f"[bold red]Error:[/bold red] {e}")
         sys.exit(1)
+    except ForgeInstallError as e:
+        console.print(f"[red]Error:[/red] {e}")
+        sys.exit(1)
 
 
 @extensions.command("status")
@@ -993,9 +999,9 @@ def status_cmd(scope: str | None, path: str | None, show_all: bool, as_json: boo
         if not local_installed:
             all_installations = tracking.list_installations()
             if all_installations:
-                console.print(
-                    f"\n[dim]Tip: {len(all_installations)} installation(s) exist elsewhere. "
-                    "Use 'forge info' to see all.[/dim]"
+                print_tip(
+                    f"{len(all_installations)} installation(s) exist elsewhere. Run 'forge info' to see all.",
+                    console=console,
                 )
             else:
-                console.print("\n[dim]Tip: Run 'forge extension enable' to set up Forge.[/dim]")
+                print_tip("Run 'forge extension enable' to set up Forge.", console=console)

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

@@ -8,6 +8,7 @@ import sys
 import click
 from rich.console import Console
 
+from forge.cli.output import print_tip
 from forge.core.ops.context import ExecutionContext
 from forge.core.ops.gc import CleanError, CleanReport, collect_clean_report, run_clean
 
@@ -78,7 +79,7 @@ def _print_report(report: CleanReport, verbose: bool, console: Console) -> None:
         console.print("[green]Nothing to clean.[/green]")
     else:
         console.print(f"Total: [cyan]{report.total_count}[/cyan] objects to clean\n")
-        console.print("[dim]Tip: Run with --yes to clean, or --verbose for details.[/dim]")
+        print_tip("Use --yes to clean, or --verbose for details.", blank_before=False, console=console)
 
 
 def _run_and_report(ctx: ExecutionContext, scope: str, report: CleanReport, console: Console) -> None:

{multi_forge-0.2.0 → multi_forge-0.3.0}/src/forge/cli/guards.py

@@ -12,6 +12,7 @@ from pathlib import Path
 
 from rich.console import Console
 
+from forge.cli.output import print_tip
 from forge.core.paths import display_path
 
 console = Console()
@@ -47,7 +48,7 @@ def require_repo_root() -> Path:
         console.print(
             f"[red]Error:[/red] Must run from the repository root ({display_path(repo_root)}), " f"not a subdirectory"
         )
-        console.print(f"\n[dim]Tip: cd {display_path(hint)}[/dim]")
+        print_tip("Run from:", commands=[f"cd {display_path(hint)}"], console=console)
         sys.exit(1)
 
     return cwd
@@ -87,7 +88,7 @@ def require_main_repo_root() -> Path:
             "[red]Error:[/red] Cannot create worktrees from inside a child worktree. "
             f"Run from the main repository root ({display_path(main_root)})"
         )
-        console.print(f"\n[dim]Tip: cd {display_path(main_root)}[/dim]")
+        print_tip("Run from:", commands=[f"cd {display_path(main_root)}"], console=console)
         sys.exit(1)
 
     # Accept CWD at a Forge project root (nested or top-level)
@@ -100,7 +101,7 @@ def require_main_repo_root() -> Path:
         console.print(
             f"[red]Error:[/red] Must run from the repository root ({display_path(repo_root)}), " f"not a subdirectory"
         )
-        console.print(f"\n[dim]Tip: cd {display_path(repo_root)}[/dim]")
+        print_tip("Run from:", commands=[f"cd {display_path(repo_root)}"], console=console)
         sys.exit(1)
 
     return cwd

{multi_forge-0.2.0 → multi_forge-0.3.0}/src/forge/cli/handoff.py

@@ -71,16 +71,21 @@ def run_cmd(
         logger.warning("Failed to read session manifest for %s: %s", session_name, e)
         raise SystemExit(1)
 
-    if not effective.memory or not effective.memory.auto_update:
-        logger.info("Handoff not configured for session %s", session_name)
-        return
+    import dataclasses
 
-    config = effective.memory.auto_update
-    if not config.enabled:
-        logger.info("Handoff disabled for session %s", session_name)
+    from forge.session.handoff_agent import resolve_handoff_base_url, run_handoff_agent
+    from forge.session.project_memory import (
+        DEFAULT_SCAN_ROOTS,
+        is_memory_enabled,
+        scan_passported_docs,
+    )
+
+    if not is_memory_enabled(manifest, effective):
+        logger.info("Handoff not activated for session %s", session_name)
         return
 
-    from forge.session.handoff_agent import resolve_handoff_base_url, run_handoff_agent
+    assert effective.memory is not None and effective.memory.auto_update is not None
+    config = dataclasses.replace(effective.memory.auto_update, enabled=True)
 
     confirmed_proxy_url = None
     if manifest.confirmed.started_with_proxy:
@@ -94,7 +99,7 @@ def run_cmd(
         subprocess_proxy=subprocess_proxy or effective.subprocess_proxy,
     )
 
-    designated_docs = effective.memory.designated_docs if effective.memory else []
+    designated_docs = scan_passported_docs(effective_root, DEFAULT_SCAN_ROOTS, session_name)
 
     success = run_handoff_agent(
         session_name=session_name,

{multi_forge-0.2.0 → multi_forge-0.3.0}/src/forge/cli/hooks/commands.py

@@ -52,9 +52,9 @@ from .direct_commands import (
     _handle_cmd_cancel_verification,
     _handle_cmd_clean,
     _handle_cmd_config,
-    _handle_cmd_guard,
     _handle_cmd_help,
     _handle_cmd_plan,
+    _handle_cmd_policy,
     _handle_cmd_proxy,
     _handle_cmd_session,
     _parse_direct_command,
@@ -513,11 +513,14 @@ def stop() -> None:
         is not None
     )
 
-    # Enqueue handoff marker if auto_update is enabled (best-effort)
+    # Enqueue handoff marker if memory is enabled for this session (best-effort).
     queued_handoff = False
     try:
         effective = compute_effective_intent(manifest)
-        if effective.memory and effective.memory.auto_update and effective.memory.auto_update.enabled:
+
+        from forge.session.project_memory import is_memory_enabled
+
+        if is_memory_enabled(manifest, effective):
             queued_handoff = (
                 enqueue_handoff_marker(
                     session_id=session_id,
@@ -530,7 +533,7 @@ def stop() -> None:
                 is not None
             )
     except Exception:
-        pass  # Best-effort: don't break stop hook on handoff enqueue failure
+        logger.debug("Memory handoff enqueue failed for session %s", manifest.name, exc_info=True)
 
     if not manifest_updated:
         # Manifest failed but we still tried to enqueue
@@ -1117,8 +1120,8 @@ def policy_check() -> None:
         print("[forge] Policy check: cannot build action context", file=sys.stderr)
         sys.exit(0)
 
-    from forge.guard.engine import build_engine
-    from forge.guard.types import FailMode
+    from forge.policy.engine import build_engine
+    from forge.policy.types import FailMode
 
     fail_mode: FailMode = effective.policy.fail_mode or "open"
     bundles = effective.policy.bundles or []
@@ -1140,7 +1143,7 @@ def policy_check() -> None:
 
     # Register semantic supervisor before restore_state so cached state is restored with it.
     if has_supervisor:
-        from forge.guard.semantic.supervisor import SemanticSupervisorPolicy
+        from forge.policy.semantic.supervisor import SemanticSupervisorPolicy
 
         supervisor_policy = SemanticSupervisorPolicy(config=effective.policy.supervisor)
         engine.register(supervisor_policy)
@@ -1321,8 +1324,8 @@ def user_prompt_submit() -> None:
         _handle_cmd_plan(args)
         return
 
-    if cmd == "guard":
-        _handle_cmd_guard(data, args)
+    if cmd == "policy":
+        _handle_cmd_policy(data, args)
         return
 
     if cmd == "config":
@@ -1541,7 +1544,7 @@ def teammate_idle() -> None:
     if not config or not config.enabled:
         sys.exit(0)
 
-    from forge.guard.team.handlers import handle_teammate_idle
+    from forge.policy.team.handlers import handle_teammate_idle
 
     cache_key = _safe_cache_key(data.get("session_id"))
     exit_code, feedback = _run_team_handler(cache_key, lambda cache: handle_teammate_idle(data, config, cache))
@@ -1576,7 +1579,7 @@ def task_completed() -> None:
     if not config or not config.enabled:
         sys.exit(0)
 
-    from forge.guard.team.handlers import handle_task_completed
+    from forge.policy.team.handlers import handle_task_completed
 
     cache_key = _safe_cache_key(data.get("session_id"))
     exit_code, feedback = _run_team_handler(cache_key, lambda cache: handle_task_completed(data, config, cache))