thwip-cli 1.9.0__tar.gz → 1.9.2__tar.gz

{thwip_cli-1.9.0 → thwip_cli-1.9.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thwip-cli
-Version: 1.9.0
+Version: 1.9.2
 Summary: Universal coding agent multiplexer: detect, switch, and route between AI coding agents seamlessly
 Project-URL: Homepage, https://github.com/tanmayhutt/thwip-cli
 Project-URL: Repository, https://github.com/tanmayhutt/thwip-cli

{thwip_cli-1.9.0 → thwip_cli-1.9.2}/docs/verification.md

@@ -1,6 +1,6 @@
 # Verification status
 
-Verified locally on 2026-09-25 for v1.9.0. The Python suite
+Verified locally on 2026-09-25 for v1.9.1. The Python suite
 passes 286 offline tests on Python 3.11, 3.12, and 3.13. Exhaustive behavior across every provider and
 configuration has not been established.
 
@@ -19,6 +19,7 @@ each using its existing sign-in. No API keys were configured.
 | Ctrl+C during a response | Turn cancelled, child process terminated, REPL continued, unanswered message removed |
 | Ctrl+C at a Codex permission prompt | Turn cancelled, no file created, no leftover process, REPL continued |
 | Usage-limit failover | With a test-only shim making Codex report "You've hit your usage limit", the real REPL showed the alternatives, switched to Claude Code on `1`, retried the message, and answered; history held one clean pair |
+| First-run and returning-user walkthrough (v1.9.2) | Driven as a brand-new user from an empty config: onboarding, chat, `/memory init`, compact `/switch`, `/status`, `/memory update` with diff, quit offer; then restart, `/resume`, `/history`, `/memory`, Ctrl+C exit with the memory offer. Fixed on the way: `/switch` printed four blocks (now one line unless a capability is lost), long paths wrapped every panel (now shown relative to home), the template wrote an empty `tags: []`, `/status` showed an API-key field for native agents, sessions stored the project as `.` so `/resume` from another directory pointed at the wrong project, `/resume <number>` was not accepted, and Ctrl+C at the prompt skipped the memory offer |
 | Config sections (v1.9.0) | Found and fixed: the loader's section whitelist dropped `[memory]` and `[endpoints]`, so onboarding repeated and file-based endpoint overrides were ignored. Round-trip regression test added |
 | Vault sync all (v1.9.0) | `/memory sync all` over the three project collections filed 26 cards under `Projects/thwip/` with Stack, Areas, and Tags hubs and a dashboard inside that folder, and left every hand-written note untouched |
 | Real vault connection (v1.8.1) | Onboarding in the thwip project chose the real Obsidian vault; `/memory sync` wrote nothing and reported the three hand-written notes it left untouched; stack and purpose now fall back to the Snapshot body so existing context files link by stack |

{thwip_cli-1.9.0 → thwip_cli-1.9.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "thwip-cli"
-version = "1.9.0"
+version = "1.9.2"
 description = "Universal coding agent multiplexer: detect, switch, and route between AI coding agents seamlessly"
 readme = "README.md"
 license = "MIT"

{thwip_cli-1.9.0 → thwip_cli-1.9.2}/tests/test_audit_regressions.py

@@ -266,3 +266,14 @@ async def test_failover_chain_model_must_be_listed_by_provider(cli, monkeypatch)
     cli.current_agent = cli.registry.get_agent('openai')
     await cli.handle_limit_failover(LimitHit(error_type=LimitStatus.QUOTA_EXHAUSTED, message='usage limit'), {'openai'})
     assert switched == [('claude', 'fable')]
+
+
+def test_cli_stores_absolute_project_paths(tmp_path, monkeypatch):
+    """A relative project path saved into a session made /memory depend on the current directory after /resume."""
+    monkeypatch.setenv("THWIP_CONFIG_DIR", str(tmp_path / "cfg"))
+    monkeypatch.chdir(tmp_path)
+    from thwip import cli as cli_module
+
+    monkeypatch.setattr(cli_module.ThwipConfig, "load", classmethod(lambda cls: ThwipConfig(project=".")))
+    cli = cli_module.ThwipCLI()
+    assert cli.session.project_path == str(tmp_path) and cli.config.project == str(tmp_path)

{thwip_cli-1.9.0 → thwip_cli-1.9.2}/tests/test_handoff.py

@@ -160,13 +160,12 @@ async def test_switch_previews_before_mutating(tmp_path, monkeypatch):
     calls = []
 
     def preview(*args):
-        assert cli.current_agent is source
         calls.append(args)
 
     monkeypatch.setattr(cli, "cmd_handoff", preview)
     await cli.cmd_switch("offline", "test-model")
-    assert calls == [("offline", "test-model")]
-    assert cli.current_agent is target
+    assert calls == [], "/switch no longer prints the full handoff table; /handoff does"
+    assert cli.current_agent is target and cli.session.current_agent == "offline"
 
 
 @pytest.mark.parametrize("command", ["/clear", "/session clear"])

{thwip_cli-1.9.0 → thwip_cli-1.9.2}/tests/test_memory.py

@@ -249,3 +249,19 @@ def test_sync_all_discovers_projects_and_files_cards_in_a_subfolder(tmp_path):
     assert "[[Projects/thwip/Stack/Python|Python]]" in alpha, "hub links point into thwip's own folder"
     assert (tmp_path / "brain" / "Projects" / "thwip" / "Dashboard.md").is_file(), "dashboard goes in the cards folder when it is not Projects/"
     assert not (tmp_path / "brain" / "Projects.md").exists() and not (tmp_path / "brain" / "Stack").exists()
+
+
+def test_rebuild_tolerates_cards_without_a_context_path(tmp_path):
+    from thwip.memory import Vault
+
+    vault = Vault(str(tmp_path / "brain"), cards_dir="Projects/thwip")
+    vault.create()
+    (vault.cards_root / "old.md").write_text("---\nproject: old\ngenerated_by: thwip\n---\n\n# old\n")
+    project = tmp_path / "fresh"
+    project.mkdir()
+    ProjectMemory(str(project)).write("---\nproject: fresh\narea: X\n---\n\n# fresh\n")
+    report = vault.sync_all([ProjectMemory(str(project))])
+    assert any(path.endswith("fresh.md") for path in report["written"])
+    assert "context file `unknown`" in (vault.cards_root / "old.md").read_text()
+    report = vault.sync_all([ProjectMemory(str(project))])
+    assert [c.name for c in vault.cards()] == ["fresh", "old"], "Dashboard.md is not treated as a project card"

{thwip_cli-1.9.0 → thwip_cli-1.9.2}/tests/test_parity_commands.py

@@ -98,6 +98,11 @@ async def test_new_saves_previous_and_resume_restores_it(cli, monkeypatch):
     cli.cmd_new()
     await cli.cmd_resume(old_name)
     assert cli.session.name == old_name
+    cli.cmd_new()
+    first = Session.list_saved_sessions()[0]["name"]
+    await cli.cmd_resume("1")
+    assert cli.session.name == first, "/resume 1 picks the first listed session"
+    assert cli.session.project_path.startswith("/"), "loaded project path is absolute"
 
 
 @pytest.mark.asyncio

{thwip_cli-1.9.0 → thwip_cli-1.9.2}/thwip/__init__.py

@@ -1,4 +1,4 @@
 """thwip: Universal Coding Agent Multiplexer."""
 
-__version__ = "1.9.0"
+__version__ = "1.9.2"
 __app_name__ = "thwip"

{thwip_cli-1.9.0 → thwip_cli-1.9.2}/thwip/cli.py

@@ -103,6 +103,13 @@ class QuietTerminal:
         return False
 
 
+def pretty_path(path) -> str:
+    """Show paths relative to the home directory so panels stop wrapping."""
+    text = str(path)
+    home = str(Path.home())
+    return "~" + text[len(home):] if text.startswith(home + os.sep) or text == home else text
+
+
 class TurnInterrupted(Exception):
     """Raised when the user presses Ctrl+C at a prompt shown during a turn."""
 
@@ -123,6 +130,8 @@ class ThwipCLI:
         self.config = ThwipConfig.load()
         if project:
             self.config.project = project
+        # Sessions and memory files are keyed by project; never let that depend on the current directory later.
+        self.config.project = os.path.abspath(os.path.expanduser(self.config.project or "."))
         self.registry = AgentRegistry(self.config)
         self.detector = SystemDetector()
         self.usage_tracker = UsageTracker()
@@ -260,7 +269,12 @@ class ThwipCLI:
                     await self._run_interruptible(self.process_user_message(self._expand_mentions(user_input)))
 
             except (KeyboardInterrupt, EOFError):
-                console.print("\n[dim]Exiting thwip. Goodbye![/dim]")
+                console.print()
+                try:
+                    await self._run_interruptible(self._offer_memory_update("quitting"))
+                except (KeyboardInterrupt, EOFError):
+                    pass
+                console.print("[dim]Exiting thwip. Goodbye![/dim]")
                 break
             except Exception as e:
                 print_error(f"Unexpected error: {e}")
@@ -462,6 +476,7 @@ class ThwipCLI:
         if not agent.get_model_info(loaded.current_model):
             loaded.current_model = agent.get_default_model()
             print_warning("The saved model is unavailable. Using the provider default.")
+        loaded.project_path = str(project)
         self.session = loaded
         self.current_agent = agent
         self.tool_manager = ToolManager(str(project))
@@ -503,11 +518,13 @@ class ThwipCLI:
         print_success(f"Started new session {self.session.name}.")
 
     async def cmd_resume(self, name: str = "") -> None:
-        """Resume a saved session by name or from a numbered list, like /resume in Codex and Claude Code."""
+        """Resume a saved session by name, by list number, or from a numbered list, like /resume in Codex and Claude Code."""
+        sessions = Session.list_saved_sessions()
         if name:
+            if name.isdigit() and sessions and 1 <= int(name) <= len(sessions):
+                name = sessions[int(name) - 1]["name"]
             self._load_session(name)
             return
-        sessions = Session.list_saved_sessions()
         if not sessions:
             print_info("No saved sessions found.")
             return
@@ -719,14 +736,14 @@ class ThwipCLI:
             try:
                 vault.create()
             except OSError as exc:
-                print_error(f"Could not create the vault folder: {exc}")
+                print_error(f"Could not create the vault folder at {pretty_path(chosen)}: {exc}")
                 chosen = ""
         cfg.vault = chosen
         cfg.onboarded = True
         with contextlib.suppress(Exception):
             self.config.save()
         if chosen:
-            print_success(f"Second brain connected: {chosen}. Use /memory to view or update this project's memory.")
+            print_success(f"Second brain connected: {pretty_path(chosen)}. Use /memory in any project to view or update its memory.")
         else:
             print_info("No vault connected. Project memory still works locally; set one later with /memory vault <path>.")
 
@@ -744,14 +761,16 @@ class ThwipCLI:
                 console.print(Text(render_frontmatter(data), style="dim"))
             console.print(self._render_response(body))
             vault = self._vault()
-            console.print(Text(f"File: {memory.path}" + (f"  |  Vault: {vault.root}" if vault else "  |  No vault connected (/memory vault <path>)"), style="dim"))
+            console.print(Text(f"File: {pretty_path(memory.path)}" + (f"  |  Vault: {pretty_path(vault.root)}" if vault else "  |  No vault connected (/memory vault <path>)"), style="dim"))
         elif sub == "init":
             if memory.exists():
                 print_info(f"{cfg.file} already exists.")
                 return
             area = rest or "General"
             memory.init(area=area)
-            print_success(f"Created {memory.path} from the template with detected facts. Edit it or run /memory update.")
+            detected = memory.frontmatter().get("stack") or []
+            found = f" ({', '.join(detected)} detected)" if detected else ""
+            print_success(f"Created {cfg.file}{found}. Edit it, or run /memory update after a conversation.")
             self._sync_vault(memory)
         elif sub == "edit":
             editor = os.environ.get("VISUAL") or os.environ.get("EDITOR")
@@ -810,7 +829,7 @@ class ThwipCLI:
             return
         try:
             report = vault.sync_all(memories)
-        except OSError as exc:
+        except (OSError, ValueError) as exc:
             print_error(f"Vault sync failed: {exc}")
             return
         print_success(f"Filed {report['projects']} projects from {', '.join(roots)}: {len(report['written'])} notes written or refreshed "
@@ -826,12 +845,12 @@ class ThwipCLI:
             return
         try:
             report = vault.sync(memory)
-        except OSError as exc:
+        except (OSError, ValueError) as exc:
             print_error(f"Vault sync failed: {exc}")
             return
         if verbose or report["written"]:
             written = len(report["written"])
-            print_success(f"Filed in the vault: {written} note{'s' if written != 1 else ''} written or refreshed under {vault.root}.")
+            print_success(f"Filed in the vault ({written} note{'s' if written != 1 else ''} refreshed under {pretty_path(vault.cards_root)}).")
         for path in report["skipped"]:
             print_warning(f"Left untouched (not created by thwip): {path}")
 
@@ -903,7 +922,7 @@ class ThwipCLI:
             print_info("Project memory unchanged.")
             return False
         memory.write(proposed)
-        print_success(f"Project memory updated: {memory.path}")
+        print_success(f"Project memory updated: {pretty_path(memory.path)}")
         self._sync_vault(memory)
         return True
 
@@ -1063,7 +1082,7 @@ class ThwipCLI:
              f"{report.excluded_tool_calls} stored tool-call entries")),
             ("Transient results", f"{report.observed_tool_results} observed tool results not transferred"),
             ("Tracking coverage", "Since session creation" if report.tracking_complete
-             else "Partial: legacy session has uncounted earlier tool results"),
+             else "Partial: native CLI tool activity is not counted"),
             ("Capabilities lost", ", ".join(report.lost_capabilities) or "None in local catalog"),
             ("Capabilities gained", ", ".join(report.gained_capabilities) or "None in local catalog"),
             ("Context pressure", (f"{report.context_pressure}: ~{report.estimated_input_tokens:,} input "
@@ -1148,26 +1167,27 @@ class ThwipCLI:
 
         old_agent = self.current_agent
         old_caps = old_agent.get_capabilities_for_model(self.session.current_model)
-
-        self.cmd_handoff(new_agent.name, chosen_model)
+        carried = len(self.session.to_portable_messages())
 
         self.current_agent = new_agent
         self.session.switch_agent(new_agent.name, chosen_model)
 
-        # Capability comparison & disclaimer
+        # Only interrupt with the capability panel when something is actually lost; /handoff has the full report.
         new_capabilities = new_agent.get_capabilities_for_model(chosen_model)
         missing = [
             capability.display_name
             for capability in sorted(old_caps - new_capabilities, key=lambda item: item.value)
         ]
-        console.print(
-            render_capability_disclaimer(
-                agent_name=new_agent.display_name,
-                company=new_agent.company,
-                supported=[c.display_name for c in new_capabilities],
-                unsupported=missing,
+        if missing:
+            console.print(
+                render_capability_disclaimer(
+                    agent_name=new_agent.display_name,
+                    company=new_agent.company,
+                    supported=[c.display_name for c in new_capabilities],
+                    unsupported=missing,
+                )
             )
-        )
+        carried_text = f"{carried} message{'s' if carried != 1 else ''} carried over" if carried else "fresh conversation"
 
         if not new_agent.is_configured():
             key_name = {
@@ -1184,15 +1204,11 @@ class ThwipCLI:
                 f"  Or add it to ~/.thwip/config.toml"
             )
         elif getattr(new_agent, "native_tools", False):
-            print_success(
-                f"Now chatting with {new_agent.display_name} ({chosen_model}) through its existing sign-in. "
-                "Portable text history preserved."
-            )
+            print_success(f"Now chatting with {new_agent.display_name} ({chosen_model}) through its existing sign-in; "
+                          f"{carried_text}. /handoff shows the full transfer report.")
         else:
-            print_success(
-                f"Now chatting with {new_agent.display_name} ({chosen_model}). "
-                "Portable text history preserved."
-            )
+            print_success(f"Now chatting with {new_agent.display_name} ({chosen_model}); {carried_text}. "
+                          "/handoff shows the full transfer report.")
 
     def cmd_show_agents(self) -> None:
         """Show table of all detected agents."""
@@ -1408,7 +1424,7 @@ class ThwipCLI:
         content = Text()
         content.append(f"Agent:       {self.current_agent.display_name} ({self.current_agent.company})\n", style=brand.label_style)
         content.append(f"Model:       {self.session.current_model}\n", style="bold white")
-        content.append(f"Project:     {os.path.abspath(self.session.project_path)}\n", style="white")
+        content.append(f"Project:     {pretty_path(os.path.abspath(self.session.project_path))}\n", style="white")
         content.append(f"Session:     {self.session.name} ({len(self.session.messages)} messages)\n", style="white")
         content.append(f"Tokens:      {self.session.get_total_tokens():,} used\n", style="dim")
         if getattr(self.current_agent, "native_tools", False):
@@ -1419,7 +1435,8 @@ class ThwipCLI:
                 content.append(f"CLI session: {record['id']} (has seen {record['synced']} messages; only new ones are sent)\n", style="dim")
             else:
                 content.append("CLI session: none yet; the first message sends the full conversation\n", style="dim")
-        content.append(f"Config Key:  {self.config.key_sources.get(self.current_agent.name, 'None')}\n", style="dim")
+        if not getattr(self.current_agent, "native_tools", False):
+            content.append(f"Config Key:  {self.config.key_sources.get(self.current_agent.name, 'None')}\n", style="dim")
 
         console.print(Panel(content, title="Current Status", box=box.ROUNDED))
 

{thwip_cli-1.9.0 → thwip_cli-1.9.2}/thwip/memory.py

@@ -170,6 +170,8 @@ class ProjectMemory:
             stack=", ".join(facts["stack"]), stack_text=", ".join(facts["stack"]) or "not detected",
             tags=", ".join(tags or []), entry_points=facts["entry_points"], runtime=facts["runtime"],
         )
+        # The format says: do not add empty fields.
+        text = "\n".join(line for line in text.splitlines() if line.strip() not in {"tags: []", "stack: []"}) + "\n"
         self.write(text)
         return text
 
@@ -317,6 +319,8 @@ class Vault:
             if MARKER not in text[:600]:
                 continue
             data, _ = parse_frontmatter(text)
+            if "project" not in data:
+                continue  # the dashboard and hub notes also carry the marker
             found.append(ProjectCard(name=str(data.get("project", note.stem)), context_path=str(data.get("context_path", "")),
                                      area=str(data.get("area", "")), stack=_as_list(data.get("stack")), tags=_as_list(data.get("tags")),
                                      status=str(data.get("status", "")), purpose=str(data.get("purpose", "")), updated=str(data.get("updated", ""))))
@@ -366,8 +370,10 @@ class Vault:
         }), "", f"# {card.name}", ""]
         if card.purpose:
             lines += [card.purpose, ""]
+        context = Path(card.context_path) if card.context_path else None
+        link = f"[context file]({context.as_uri()})" if context and context.is_absolute() else f"context file `{card.context_path or 'unknown'}`"
         lines += ["## Technical source", "",
-                  (f"Current work, decisions, and history live in the project's [context file]({Path(card.context_path).as_uri()}). "
+                  (f"Current work, decisions, and history live in the project's {link}. "
                   "This card is a stable index entry maintained by thwip; do not put changing detail here."), ""]
         if card.area or card.stack or card.tags:
             lines += ["## Links", ""]

{thwip_cli-1.9.0 → thwip_cli-1.9.2}/thwip/session.py

@@ -287,4 +287,5 @@ class Session:
                 })
             except Exception:
                 continue
-        return sorted(result, key=lambda x: x["updated_at"], reverse=True)
+        # Newest first; ties broken by name so numbered picks stay stable between calls.
+        return sorted(result, key=lambda x: (x["updated_at"], x["name"]), reverse=True)

{thwip_cli-1.9.0 → thwip_cli-1.9.2}/thwip/theme.py

@@ -20,6 +20,12 @@ from rich.theme import Theme
 
 from thwip import __version__
 
+
+def _pretty(path: str) -> str:
+    from pathlib import Path
+    home = str(Path.home())
+    return '~' + path[len(home):] if path.startswith(home + '/') or path == home else path
+
 # ---------------------------------------------------------------------------
 # Company / Provider Brand Colors
 # ---------------------------------------------------------------------------
@@ -155,7 +161,7 @@ def render_startup_banner(
     lines.append("  Model:       ", style="dim")
     lines.append(f"{model}\n", style="bold white")
     lines.append("  Workspace:   ", style="dim")
-    lines.append(f"{project_path}\n", style="white")
+    lines.append(f"{_pretty(project_path)}\n", style="white")
     lines.append("  Session:     ", style="dim")
     lines.append(f"{session_name}\n", style="white")
     lines.append("  Environment: ", style="dim")

{thwip_cli-1.9.0 → thwip_cli-1.9.2}/uv.lock

@@ -1022,7 +1022,7 @@ wheels = [
 
 [[package]]
 name = "thwip-cli"
-version = "1.9.0"
+version = "1.9.2"
 source = { editable = "." }
 dependencies = [
     { name = "anthropic" },