blitz-cli 0.9.0__tar.gz → 0.11.0__tar.gz

{blitz_cli-0.9.0 → blitz_cli-0.11.0}/.gitignore

@@ -8,4 +8,4 @@ dist/
 
 # stray test artifacts from running the CLI in-repo
 /.claude/
-/.playbooks/
+/.blitz/

{blitz_cli-0.9.0 → blitz_cli-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blitz-cli
-Version: 0.9.0
+Version: 0.11.0
 Summary: Developer CLI for Blitz locker-room: spec-driven playbooks, a codebase/huddle ontology graph with an MCP tool, and the composable watcher/trainer/graph containers.
 License: MIT
 License-File: LICENSE
@@ -31,18 +31,18 @@ The core CLI is stdlib plus `rich`. Two optional extras carry heavier deps only
 when you need them: `blitz-cli[locker-room]` (the MCP server) and
 `blitz-cli[train]` (the QLoRA trainer).
 
-Top-level commands: `playbooks`, `implement`, `locker-room`, `activity`.
+Top-level commands: `init`, `model`, `locker-room`.
 
 ## Playbooks: spec-driven development commands
 
-`blitz playbooks init` installs a set of spec-driven-development slash-commands
+`blitz init` installs a set of spec-driven-development slash-commands
 into a repo, rendered for whichever agent you use (Claude Code, Cursor, GitHub
-Copilot, Gemini CLI, OpenCode), plus a shared `.playbooks/` working area.
+Copilot, Gemini CLI, OpenCode), plus a shared `.blitz/` working area.
 
 ```bash
-blitz playbooks init                 # auto-detect the agent(s) in this repo
-blitz playbooks init --agent claude  # or target one explicitly
-blitz playbooks init --all           # install for every supported agent
+blitz init                 # auto-detect the agent(s) in this repo
+blitz init --agent claude  # or target one explicitly
+blitz init --all           # install for every supported agent
 ```
 
 The commands are `specify`, `plan`, `tasks`, `implement`, `playbook`, `clarify`,
@@ -51,9 +51,9 @@ and `analyze`. Run at a folder of repos, `init` installs into each repo it finds
 for coordinating a feature across repos. Use `--ignore PATH` to skip a repo and
 `--root` to force a single install.
 
-## Implement: execute a tasks.md with a local model
+## Model execute: run a tasks.md with a local model
 
-`blitz implement` drives a local model (served by Ollama) through a
+`blitz model execute` drives a local model (served by Ollama) through a
 playbook-generated `tasks.md`, one task at a time. The model only proposes
 actions (full-file writes and shell commands); the driver applies them, runs
 each phase's machine-runnable verification, retries with the failure fed back
@@ -61,17 +61,17 @@ each phase's machine-runnable verification, retries with the failure fed back
 `- [x]` in the tasks.md. A task that keeps failing stops the run so the state
 stays inspectable. Per-attempt model replies, snapshots, and exact token
 accounting (`usage.json`, per task and total) land under
-`.playbooks/implement/runs/<timestamp>/`.
+`.blitz/execute/runs/<timestamp>/`.
 
 ```bash
-blitz implement                                   # auto-detect the open specs/*/tasks.md
-blitz implement specs/001-my-feature/tasks.md     # or name it
-blitz implement --model qwen2.5-14b-28k --start-at T005
+blitz model execute                                   # auto-detect the open specs/*/tasks.md
+blitz model execute specs/001-my-feature/tasks.md     # or name it
+blitz model execute --model qwen2.5-14b-28k --start-at T005
 ```
 
 Tasks whose text says "optional manual" are skipped and left unchecked. The
 Ollama endpoint comes from `--ollama-url` or `OLLAMA_HOST`; the model from
-`--model` or `BLITZ_IMPLEMENT_MODEL`.
+`--model` or `BLITZ_EXECUTE_MODEL`.
 
 ## Locker-room: ontology graph, watcher, trainer, MCP
 
@@ -120,17 +120,17 @@ the base model with `BASE_MODEL_HF` or `blitz locker-room init --base-model`.
 
 ## Activity: replay a coding-agent session
 
-`blitz activity` reads your coding agent's own local session transcripts
+`blitz locker-room activity` reads your coding agent's own local session transcripts
 (currently Claude Code's, at `~/.claude/projects`) for the current repo and
 replays each prompt alongside the actions taken to resolve it (tool calls,
 sub-agents) and the final response:
 
 ```bash
-blitz activity --list               # sessions for this repo, most recent first
-blitz activity                      # the most recent session's timeline
-blitz activity <session-id-prefix>  # a specific session
-blitz activity --full               # untruncated prompts/responses/tool I/O
-blitz activity --html report.html   # also write a self-contained HTML report
+blitz locker-room activity --list               # sessions for this repo, most recent first
+blitz locker-room activity                      # the most recent session's timeline
+blitz locker-room activity <session-id-prefix>  # a specific session
+blitz locker-room activity --full               # untruncated prompts/responses/tool I/O
+blitz locker-room activity --html report.html   # also write a self-contained HTML report
 ```
 
 The terminal view is compact by default; `--full` shows untruncated text. The

{blitz_cli-0.9.0 → blitz_cli-0.11.0}/README.md

@@ -12,18 +12,18 @@ The core CLI is stdlib plus `rich`. Two optional extras carry heavier deps only
 when you need them: `blitz-cli[locker-room]` (the MCP server) and
 `blitz-cli[train]` (the QLoRA trainer).
 
-Top-level commands: `playbooks`, `implement`, `locker-room`, `activity`.
+Top-level commands: `init`, `model`, `locker-room`.
 
 ## Playbooks: spec-driven development commands
 
-`blitz playbooks init` installs a set of spec-driven-development slash-commands
+`blitz init` installs a set of spec-driven-development slash-commands
 into a repo, rendered for whichever agent you use (Claude Code, Cursor, GitHub
-Copilot, Gemini CLI, OpenCode), plus a shared `.playbooks/` working area.
+Copilot, Gemini CLI, OpenCode), plus a shared `.blitz/` working area.
 
 ```bash
-blitz playbooks init                 # auto-detect the agent(s) in this repo
-blitz playbooks init --agent claude  # or target one explicitly
-blitz playbooks init --all           # install for every supported agent
+blitz init                 # auto-detect the agent(s) in this repo
+blitz init --agent claude  # or target one explicitly
+blitz init --all           # install for every supported agent
 ```
 
 The commands are `specify`, `plan`, `tasks`, `implement`, `playbook`, `clarify`,
@@ -32,9 +32,9 @@ and `analyze`. Run at a folder of repos, `init` installs into each repo it finds
 for coordinating a feature across repos. Use `--ignore PATH` to skip a repo and
 `--root` to force a single install.
 
-## Implement: execute a tasks.md with a local model
+## Model execute: run a tasks.md with a local model
 
-`blitz implement` drives a local model (served by Ollama) through a
+`blitz model execute` drives a local model (served by Ollama) through a
 playbook-generated `tasks.md`, one task at a time. The model only proposes
 actions (full-file writes and shell commands); the driver applies them, runs
 each phase's machine-runnable verification, retries with the failure fed back
@@ -42,17 +42,17 @@ each phase's machine-runnable verification, retries with the failure fed back
 `- [x]` in the tasks.md. A task that keeps failing stops the run so the state
 stays inspectable. Per-attempt model replies, snapshots, and exact token
 accounting (`usage.json`, per task and total) land under
-`.playbooks/implement/runs/<timestamp>/`.
+`.blitz/execute/runs/<timestamp>/`.
 
 ```bash
-blitz implement                                   # auto-detect the open specs/*/tasks.md
-blitz implement specs/001-my-feature/tasks.md     # or name it
-blitz implement --model qwen2.5-14b-28k --start-at T005
+blitz model execute                                   # auto-detect the open specs/*/tasks.md
+blitz model execute specs/001-my-feature/tasks.md     # or name it
+blitz model execute --model qwen2.5-14b-28k --start-at T005
 ```
 
 Tasks whose text says "optional manual" are skipped and left unchecked. The
 Ollama endpoint comes from `--ollama-url` or `OLLAMA_HOST`; the model from
-`--model` or `BLITZ_IMPLEMENT_MODEL`.
+`--model` or `BLITZ_EXECUTE_MODEL`.
 
 ## Locker-room: ontology graph, watcher, trainer, MCP
 
@@ -101,17 +101,17 @@ the base model with `BASE_MODEL_HF` or `blitz locker-room init --base-model`.
 
 ## Activity: replay a coding-agent session
 
-`blitz activity` reads your coding agent's own local session transcripts
+`blitz locker-room activity` reads your coding agent's own local session transcripts
 (currently Claude Code's, at `~/.claude/projects`) for the current repo and
 replays each prompt alongside the actions taken to resolve it (tool calls,
 sub-agents) and the final response:
 
 ```bash
-blitz activity --list               # sessions for this repo, most recent first
-blitz activity                      # the most recent session's timeline
-blitz activity <session-id-prefix>  # a specific session
-blitz activity --full               # untruncated prompts/responses/tool I/O
-blitz activity --html report.html   # also write a self-contained HTML report
+blitz locker-room activity --list               # sessions for this repo, most recent first
+blitz locker-room activity                      # the most recent session's timeline
+blitz locker-room activity <session-id-prefix>  # a specific session
+blitz locker-room activity --full               # untruncated prompts/responses/tool I/O
+blitz locker-room activity --html report.html   # also write a self-contained HTML report
 ```
 
 The terminal view is compact by default; `--full` shows untruncated text. The

{blitz_cli-0.9.0 → blitz_cli-0.11.0}/blitz_cli/__init__.py

@@ -13,7 +13,7 @@ Commands:
 - ``blitz traces list`` / ``blitz traces show <trace_id>`` — inspect captured
   traces from the local SQLite store.
 
-- ``blitz activity [session] [--list] [--html report.html]`` — replay a
+- ``blitz locker-room activity [session] [--list] [--html report.html]`` — replay a
   Claude Code session for this repo: each prompt you sent, the actions taken
   to resolve it (tool calls, sub-agents), and the final response. Reads
   ``~/.claude/projects`` directly; unrelated to Blitz's own captured traces.
@@ -30,4 +30,4 @@ Commands:
 
 __all__ = ["__version__"]
 
-__version__ = "0.9.0"
+__version__ = "0.11.0"

{blitz_cli-0.9.0 → blitz_cli-0.11.0}/blitz_cli/_activity.py

@@ -1,4 +1,4 @@
-"""`blitz activity` — replay a coding-agent session: what you asked, and how it
+"""`blitz locker-room activity` — replay a coding-agent session: what you asked, and how it
 was resolved.
 
 The currently-supported transcript format is Claude Code's, at
@@ -734,7 +734,7 @@ def render_html(session: Session, limit: int) -> str:
         '<html lang="en">',
         "<head>",
         '<meta charset="utf-8">',
-        f"<title>blitz activity — {html.escape(session.title)}</title>",
+        f"<title>blitz locker-room activity — {html.escape(session.title)}</title>",
         f"<style>{_HTML_STYLE}</style>",
         "</head>",
         "<body>",

blitz_cli-0.9.0/blitz_cli/_implement.py → blitz_cli-0.11.0/blitz_cli/_execute.py

@@ -1,6 +1,6 @@
 """Drive a local model (served by Ollama) through a playbook-generated
 tasks.md, one task at a time — the local-model execution backend for the
-`implement` playbook.
+`blitz model execute` command.
 
 The model never touches the repo directly: it only proposes actions
 (full-file ===WRITE=== blocks and ===RUN=== commands) and this driver applies
@@ -220,12 +220,12 @@ def spec_name(repo: Path, tasks_file: Path) -> str:
 
 
 def local_model_config(repo: Path) -> dict:
-    """The `local_model` block from the nearest `.playbooks/config.json`,
+    """The `local_model` block from the nearest `.blitz/config.json`,
     checking the repo first and then walking up to the workspace root. This is
     the same config the `tasks` playbook reads to decide which tasks get the
     [L] (local-model eligible) marker. Returns {} when unconfigured."""
     for d in [repo.resolve(), *repo.resolve().parents]:
-        cfg = d / ".playbooks" / "config.json"
+        cfg = d / ".blitz" / "config.json"
         if cfg.is_file():
             try:
                 block = json.loads(cfg.read_text()).get("local_model")
@@ -237,12 +237,12 @@ def local_model_config(repo: Path) -> dict:
 
 
 def usage_by_spec(repo: Path) -> dict:
-    """Aggregate every implement run's usage.json under
-    .playbooks/implement/runs/, keyed by spec: total input/output tokens, model
+    """Aggregate every execute run's usage.json under
+    .blitz/execute/runs/, keyed by spec: total input/output tokens, model
     calls, run count, and the models used. This is what the locker-room
     ontologizer attaches to Feature nodes so the UI can show per-spec cost."""
     totals: dict = {}
-    for f in sorted(repo.glob(".playbooks/implement/runs/*/usage.json")):
+    for f in sorted(repo.glob(".blitz/execute/runs/*/usage.json")):
         try:
             record = json.loads(f.read_text())
         except (OSError, ValueError):
@@ -289,7 +289,7 @@ def run(
     """Execute every unchecked task in tasks_file. Returns 0 on success, 1 when a
     task fails after all retries (the run stops there so state stays inspectable)."""
     call_model = call_model or (lambda messages: call_ollama(ollama_url, model, messages))
-    run_root = run_root or (repo / ".playbooks" / "implement" / "runs")
+    run_root = run_root or (repo / ".blitz" / "execute" / "runs")
     rundir = run_root / datetime.datetime.now().strftime("%Y%m%d-%H%M%S")
     snapdir = rundir / "snapshots"
     snapdir.mkdir(parents=True, exist_ok=True)
@@ -333,7 +333,7 @@ def run(
     if local_only and not any(t["local"] for t in tasks):
         print_fn("warning: no [L] markers in this tasks.md — with --local-only "
                  "there is nothing to execute (regenerate tasks with a "
-                 "local_model configured in .playbooks/config.json).")
+                 "local_model configured in .blitz/config.json).")
     last_in_phase = {t["phase"]: t["id"] for t in tasks}
     started = start_at is None
 

{blitz_cli-0.9.0 → blitz_cli-0.11.0}/blitz_cli/_ontology.py

@@ -16,7 +16,7 @@ import re
 import sqlite3
 from pathlib import Path
 
-from blitz_cli import _activity, _implement, _playbooks
+from blitz_cli import _activity, _execute, _playbooks
 
 # --- graph store -------------------------------------------------------------
 
@@ -338,8 +338,8 @@ class OntologyStore:
 
 
 def _read_active_feature(repo: Path) -> str | None:
-    """Basename of the repo's active feature dir, from .playbooks/feature.json."""
-    fj = repo / ".playbooks" / "feature.json"
+    """Basename of the repo's active feature dir, from .blitz/feature.json."""
+    fj = repo / ".blitz" / "feature.json"
     try:
         val = json.loads(fj.read_text(encoding="utf-8")).get("feature_directory", "")
     except (OSError, ValueError):
@@ -349,10 +349,10 @@ def _read_active_feature(repo: Path) -> str | None:
 
 def _tasks_complete(tasks_md: Path) -> bool:
     """True when every required task in a tasks.md is checked off. Tasks whose
-    text says "optional manual" don't count against completion (the implement
+    text says "optional manual" don't count against completion (the execute
     driver skips them by design)."""
     try:
-        tasks, _ = _implement.parse_tasks(tasks_md.read_text(encoding="utf-8"))
+        tasks, _ = _execute.parse_tasks(tasks_md.read_text(encoding="utf-8"))
     except OSError:
         return False
     required = [t for t in tasks if "optional manual" not in t["body"].lower()]
@@ -422,7 +422,7 @@ def _parse_huddle(text: str) -> dict:
 
 
 def _ingest_huddles(ws_root: Path, ws_id: str, store: OntologyStore, repo_ids: dict) -> None:
-    huddles_dir = ws_root / ".playbooks" / "huddles"
+    huddles_dir = ws_root / ".blitz" / "huddles"
     if not huddles_dir.is_dir():
         return
     for hd in sorted(huddles_dir.iterdir()):
@@ -491,19 +491,19 @@ def ontologize(workspace_root, db_path, ignore=None, code=True,
     ws_id = f"workspace:{ws_root}"
     store.add_node(ws_id, "Workspace", {"name": ws_root.name, "path": str(ws_root)})
     _ingest_doc_file(store, ws_id, "playbook",
-                     ws_root / ".playbooks" / "memory" / "playbook.md", max_file_bytes)
+                     ws_root / ".blitz" / "memory" / "playbook.md", max_file_bytes)
 
     repo_ids: dict[str, str] = {}  # name -> node id, for huddle cross-referencing
     ignore_paths = [Path(p) for p in (ignore or [])]
     for repo in _playbooks.find_git_repos(ws_root, ignore=ignore_paths):
-        if not (repo / ".playbooks").is_dir():
+        if not (repo / ".blitz").is_dir():
             continue  # only playbook-enabled repos are ontologized
         rid = f"repo:{repo.resolve()}"
         repo_ids[repo.name] = rid
         store.add_node(rid, "Repo", {"name": repo.name, "path": str(repo)})
         store.add_edge(ws_id, rid, "CONTAINS")
         _ingest_doc_file(store, rid, "playbook",
-                         repo / ".playbooks" / "memory" / "playbook.md", max_file_bytes)
+                         repo / ".blitz" / "memory" / "playbook.md", max_file_bytes)
 
         for agent in _playbooks.detect_agents(repo):
             aid = f"agent:{agent}"
@@ -527,7 +527,7 @@ def ontologize(workspace_root, db_path, ignore=None, code=True,
             _code_graph.scan_repo(store, repo, rid, max_file_bytes=max_file_bytes)
 
         active = _read_active_feature(repo)
-        usage = _implement.usage_by_spec(repo)
+        usage = _execute.usage_by_spec(repo)
         specs = repo / "specs"
         if specs.is_dir():
             for feat in sorted(specs.iterdir()):

{blitz_cli-0.9.0 → blitz_cli-0.11.0}/blitz_cli/_playbooks.py

@@ -1,10 +1,10 @@
-"""`blitz playbooks init` — install spec-driven-development slash-commands into a repo.
+"""`blitz init` — install spec-driven-development slash-commands into a repo.
 
 The command bodies under ``blitz_cli/playbooks/commands`` are spec-driven-development
 slash-commands adapted from GitHub's spec-kit (https://github.com/github/spec-kit).
 At install time we render each agent-agnostic body into the conventional command
 file for whichever agentic coding tool the user runs (Claude Code, Cursor, GitHub Copilot, Gemini
-CLI, OpenCode), and drop a shared ``.playbooks/`` working area (scripts +
+CLI, OpenCode), and drop a shared ``.blitz/`` working area (scripts +
 templates) that those commands drive.
 """
 
@@ -41,11 +41,11 @@ AGENTS: dict[str, AgentSpec] = {
     "opencode": AgentSpec(".opencode/command", ".md", "md", "$ARGUMENTS", (".opencode",)),
 }
 
-WORKDIR = ".playbooks"
+WORKDIR = ".blitz"
 
 _COMMANDS_PKG = "blitz_cli.playbooks.commands"
 # Workspace-only commands (e.g. /huddle) install into a *folder of repos*, never
-# into an individual repo — they orchestrate across the repos' .playbooks/ dirs.
+# into an individual repo — they orchestrate across the repos' .blitz/ dirs.
 _WORKSPACE_PKG = "blitz_cli.playbooks.workspace"
 
 # spec-kit cross-references commands as ``__SPECKIT_COMMAND_<NAME>__``; we drop
@@ -136,7 +136,7 @@ def render(command: str, agent: str, package: str = _COMMANDS_PKG) -> str:
     return _wrap(spec.fmt, description, body)
 
 
-# --- scaffold (shared .playbooks working area) -------------------------------
+# --- scaffold (shared .blitz working area) -------------------------------
 
 
 def _walk(node, prefix: str = ""):
@@ -231,7 +231,7 @@ def workspace_command_names() -> list[str]:
 
 
 def install_workspace_scaffold(dest_dir: Path) -> Path | None:
-    """Seed the workspace-level ``.playbooks/memory/playbook.md`` from the
+    """Seed the workspace-level ``.blitz/memory/playbook.md`` from the
     default template. Unlike command installs this NEVER overwrites — the
     file holds user-authored operating knowledge, so even ``--force`` must
     not reset it. Returns the written path, or None when it already exists."""
@@ -254,8 +254,8 @@ def install_workspace_commands(
     """Install workspace-only commands (/huddle) into ``dest_dir``'s command dirs.
 
     ``dest_dir`` is a workspace root — a folder of repos, not a repo itself.
-    No ``.playbooks/`` scaffold is installed here; the huddle command creates
-    what it needs (``.playbooks/huddles/``) on first use.
+    No ``.blitz/`` scaffold is installed here; the huddle command creates
+    what it needs (``.blitz/huddles/``) on first use.
     """
     commands = workspace_command_names()
     results: list[InstallResult] = []
@@ -271,9 +271,9 @@ def install_workspace_commands(
 
 
 def install_scaffold(dest_dir: Path, force: bool) -> InstallResult:
-    """Copy the shared ``.playbooks/`` working area, rewriting stale paths.
+    """Copy the shared ``.blitz/`` working area, rewriting stale paths.
 
-    Files under ``.playbooks/memory/`` are seeded once and NEVER overwritten,
+    Files under ``.blitz/memory/`` are seeded once and NEVER overwritten,
     even with ``force`` — they hold user-authored knowledge (a repo's
     constitution/playbook), and ``--force`` is for refreshing rendered
     commands and scaffold templates, not resetting memory."""

{blitz_cli-0.9.0 → blitz_cli-0.11.0}/blitz_cli/_redact.py

@@ -12,7 +12,7 @@ is exactly the class of thing this module exists to catch, and exactly why
 "best-effort" is not "guaranteed."
 
 That same real key also surfaced a concrete failure mode worth documenting:
-once displayed via `blitz activity --full`, rich's Tree rendering wrapped the
+once displayed via `blitz locker-room activity --full`, rich's Tree rendering wrapped the
 long token across terminal lines, inserting a real newline plus a
 box-drawing tree-branch prefix (e.g. "\\n│   │   ") *in the middle of the
 token*. If that wrapped output is later captured as another tool's output