threadkeeper 0.9.0__tar.gz → 0.9.2__tar.gz

{threadkeeper-0.9.0 → threadkeeper-0.9.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: threadkeeper
-Version: 0.9.0
+Version: 0.9.2
 Summary: Multi-agent shared brain across Claude Code/Desktop, Codex, Gemini, Copilot, VS Code. Cross-session memory, self-improving skill loops, inter-agent signaling — one local MCP server.
 Author: thread-keeper contributors
 License: MIT
@@ -211,18 +211,20 @@ tk-agent-status --json
 `apps/macos-agent-status/` contains a small macOS menu-bar app that polls this
 command every 5 seconds and shows every autonomous learning loop: enabled/off,
 running/idle/ready, last pass, backlog, and active child RSS when that loop has
-spawned a worker. Active loops are sorted first (`running`, then `ready`), so
-background work stays at the top of the panel. The app also requests macOS
-notification permission and sends a notification when a newly completed
-autonomous child task produces a useful result in `recent_results`; the first
-poll only marks existing results as seen, so old completions do not spam
-notifications. Probe backlog is due objective probes only, not every registered
-probe, so a healthy cooldown shows `0 due probes` instead of looking stuck. On
-macOS, `python -m threadkeeper.server` automatically installs and launches it
-on MCP startup. Set `THREADKEEPER_MENUBAR_AUTO_LAUNCH=0` to disable that
-behavior.
-
-Manual fallback:
+spawned a worker. PyPI wheels and sdists also bundle the same Swift source under
+`threadkeeper/assets/macos-agent-status/`, so a normal `pipx`/`uv tool` install
+does not need a git checkout for the widget to build. Active loops are sorted
+first (`running`, then `ready`), so background work stays at the top of the
+panel. The app also requests macOS notification permission and sends a
+notification when a newly completed autonomous child task produces a useful
+result in `recent_results`; the first poll only marks existing results as seen,
+so old completions do not spam notifications. Probe backlog is due objective
+probes only, not every registered probe, so a healthy cooldown shows `0 due
+probes` instead of looking stuck. On macOS, `python -m threadkeeper.server`
+automatically installs and launches it on MCP startup. Set
+`THREADKEEPER_MENUBAR_AUTO_LAUNCH=0` to disable that behavior.
+
+Manual fallback from a source checkout:
 
 ```sh
 cd apps/macos-agent-status
@@ -365,7 +367,10 @@ Hard limits: max 2 new skills per pass, `[PROTECTED]` (pinned +
 foreground-authored) skills off-limits. Closes the gap between
 heuristic harvest and SKILL.md materialization — previously pending
 candidates accumulated indefinitely waiting for an agent to call
-`accept_candidate()` manually.
+`accept_candidate()` manually. The loop is machine-wide single-flight:
+while one reviewer child is running, other foreground servers/ticks report
+`candidate_review_running` instead of spawning another child for the same
+queue.
 
 #### 5. Autonomous Curator
 

{threadkeeper-0.9.0 → threadkeeper-0.9.2}/README.md

@@ -170,18 +170,20 @@ tk-agent-status --json
 `apps/macos-agent-status/` contains a small macOS menu-bar app that polls this
 command every 5 seconds and shows every autonomous learning loop: enabled/off,
 running/idle/ready, last pass, backlog, and active child RSS when that loop has
-spawned a worker. Active loops are sorted first (`running`, then `ready`), so
-background work stays at the top of the panel. The app also requests macOS
-notification permission and sends a notification when a newly completed
-autonomous child task produces a useful result in `recent_results`; the first
-poll only marks existing results as seen, so old completions do not spam
-notifications. Probe backlog is due objective probes only, not every registered
-probe, so a healthy cooldown shows `0 due probes` instead of looking stuck. On
-macOS, `python -m threadkeeper.server` automatically installs and launches it
-on MCP startup. Set `THREADKEEPER_MENUBAR_AUTO_LAUNCH=0` to disable that
-behavior.
-
-Manual fallback:
+spawned a worker. PyPI wheels and sdists also bundle the same Swift source under
+`threadkeeper/assets/macos-agent-status/`, so a normal `pipx`/`uv tool` install
+does not need a git checkout for the widget to build. Active loops are sorted
+first (`running`, then `ready`), so background work stays at the top of the
+panel. The app also requests macOS notification permission and sends a
+notification when a newly completed autonomous child task produces a useful
+result in `recent_results`; the first poll only marks existing results as seen,
+so old completions do not spam notifications. Probe backlog is due objective
+probes only, not every registered probe, so a healthy cooldown shows `0 due
+probes` instead of looking stuck. On macOS, `python -m threadkeeper.server`
+automatically installs and launches it on MCP startup. Set
+`THREADKEEPER_MENUBAR_AUTO_LAUNCH=0` to disable that behavior.
+
+Manual fallback from a source checkout:
 
 ```sh
 cd apps/macos-agent-status
@@ -324,7 +326,10 @@ Hard limits: max 2 new skills per pass, `[PROTECTED]` (pinned +
 foreground-authored) skills off-limits. Closes the gap between
 heuristic harvest and SKILL.md materialization — previously pending
 candidates accumulated indefinitely waiting for an agent to call
-`accept_candidate()` manually.
+`accept_candidate()` manually. The loop is machine-wide single-flight:
+while one reviewer child is running, other foreground servers/ticks report
+`candidate_review_running` instead of spawning another child for the same
+queue.
 
 #### 5. Autonomous Curator
 

{threadkeeper-0.9.0 → threadkeeper-0.9.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "threadkeeper"
-version = "0.9.0"
+version = "0.9.2"
 description = "Multi-agent shared brain across Claude Code/Desktop, Codex, Gemini, Copilot, VS Code. Cross-session memory, self-improving skill loops, inter-agent signaling — one local MCP server."
 requires-python = ">=3.11"
 authors = [{ name = "thread-keeper contributors" }]
@@ -78,6 +78,15 @@ tk-agent-status = "threadkeeper.agent_status:main"
 include = ["threadkeeper*"]
 exclude = ["tests*", "scripts*"]
 
+[tool.setuptools.package-data]
+threadkeeper = [
+    "assets/macos-agent-status/Info.plist",
+    "assets/macos-agent-status/README.md",
+    "assets/macos-agent-status/ThreadKeeperAgentStatus.swift",
+    "assets/macos-agent-status/build.sh",
+    "assets/macos-agent-status/install.sh",
+]
+
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 addopts = "-q --strict-markers"

{threadkeeper-0.9.0 → threadkeeper-0.9.2}/tests/test_candidate_reviewer.py

@@ -7,6 +7,7 @@ fork.
 
 from __future__ import annotations
 
+import os
 import sys
 import time
 from pathlib import Path
@@ -205,6 +206,41 @@ def test_run_spawns_when_threshold_met(tmp_path, monkeypatch):
     assert "Bash" not in allowed
 
 
+def test_single_flight_when_reviewer_child_running(tmp_path, monkeypatch):
+    """Candidate review consumes one global queue; don't spawn duplicates."""
+    pkg = _bootstrap(tmp_path, monkeypatch, min_n="3")
+    conn = pkg["db"].get_db()
+    for i in range(4):
+        _seed_pending(conn, "verbatim", f"candidate {i}", age_s=60 + i)
+    conn.execute(
+        "INSERT INTO tasks "
+        "(id, pid, parent_cid, spawned_cid, cwd, prompt, started_at) "
+        "VALUES ('tk_running_review', ?, 'p', 'c', '/x', ?, ?)",
+        (
+            os.getpid(),
+            "You are a CANDIDATE REVIEWER for thread-keeper's extract queue.",
+            int(time.time()) - 30,
+        ),
+    )
+    conn.commit()
+
+    import threadkeeper.tools.spawn as spawn_mod
+
+    def fail_spawn(**kwargs):  # pragma: no cover - should not be called
+        raise AssertionError("spawn should not run while reviewer is active")
+
+    monkeypatch.setattr(spawn_mod, "spawn", fail_spawn)
+
+    out = pkg["candidate_reviewer"].run_review_pass(force=True)
+
+    assert out == "candidate_review_running n=1 (single-flight)"
+    row = conn.execute(
+        "SELECT summary FROM events WHERE kind='candidate_review_pass' "
+        "ORDER BY id DESC LIMIT 1"
+    ).fetchone()
+    assert "candidate_review_running n=1" in row["summary"]
+
+
 # ──────────────────────────────────────────────────────────────────────
 # Daemon lifecycle
 # ──────────────────────────────────────────────────────────────────────

threadkeeper-0.9.2/tests/test_menubar_app.py

@@ -0,0 +1,69 @@
+from __future__ import annotations
+
+from pathlib import Path
+from types import SimpleNamespace
+
+
+def test_menubar_packaged_assets_are_available(fresh_mp):
+    import threadkeeper.menubar_app as menubar_app
+
+    src = menubar_app._package_source_dir()
+
+    assert src.name == "macos-agent-status"
+    assert (src / "ThreadKeeperAgentStatus.swift").exists()
+    assert (src / "Info.plist").exists()
+    assert (src / "build.sh").exists()
+
+
+def test_menubar_source_falls_back_to_packaged_assets(fresh_mp, tmp_path, monkeypatch):
+    import threadkeeper.menubar_app as menubar_app
+
+    monkeypatch.setattr(menubar_app, "_dev_source_dir", lambda: tmp_path / "missing")
+
+    assert menubar_app._source_dir() == menubar_app._package_source_dir()
+
+
+def test_install_app_builds_from_task_log_scratch_without_executable_bit(
+    fresh_mp,
+    tmp_path,
+    monkeypatch,
+):
+    import threadkeeper.menubar_app as menubar_app
+
+    src = tmp_path / "source"
+    src.mkdir()
+    (src / "ThreadKeeperAgentStatus.swift").write_text("// swift\n", encoding="utf-8")
+    (src / "Info.plist").write_text("<plist></plist>\n", encoding="utf-8")
+    build = src / "build.sh"
+    build.write_text("#!/usr/bin/env bash\n", encoding="utf-8")
+    build.chmod(0o644)
+
+    task_logs = tmp_path / "tasks"
+    monkeypatch.setattr(menubar_app, "TASK_LOG_DIR", task_logs)
+    monkeypatch.setattr(menubar_app, "_app_is_current", lambda src, app: False)
+    calls = []
+
+    def fake_run(args, timeout=60, cwd=None):
+        calls.append((args, timeout, Path(cwd)))
+        app_dir = Path(cwd) / "build" / menubar_app.APP_BUNDLE
+        bin_dir = app_dir / "Contents" / "MacOS"
+        bin_dir.mkdir(parents=True)
+        (app_dir / "Contents" / "Info.plist").write_text(
+            "<plist></plist>\n",
+            encoding="utf-8",
+        )
+        (bin_dir / menubar_app.APP_NAME).write_text("binary\n", encoding="utf-8")
+        return SimpleNamespace(returncode=0, stdout=f"{app_dir}\n")
+
+    monkeypatch.setattr(menubar_app, "_run", fake_run)
+
+    installed = tmp_path / "Applications" / menubar_app.APP_BUNDLE
+    assert menubar_app._install_app(src, installed) is True
+
+    assert calls
+    assert calls[0][0][0] == "/bin/bash"
+    assert calls[0][0][1] == str(task_logs / "menubar-build" / "source" / "build.sh")
+    assert calls[0][2] == task_logs / "menubar-build" / "source"
+    assert (installed / "Contents" / "Info.plist").exists()
+    assert (installed / "Contents" / "MacOS" / menubar_app.APP_NAME).exists()
+    assert not (src / "build").exists()

threadkeeper-0.9.2/threadkeeper/assets/macos-agent-status/Info.plist

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
+  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleExecutable</key>
+  <string>ThreadKeeperAgentStatus</string>
+  <key>CFBundleIdentifier</key>
+  <string>local.threadkeeper.agent-status</string>
+  <key>CFBundleName</key>
+  <string>ThreadKeeperAgentStatus</string>
+  <key>CFBundlePackageType</key>
+  <string>APPL</string>
+  <key>CFBundleShortVersionString</key>
+  <string>0.1.0</string>
+  <key>CFBundleVersion</key>
+  <string>1</string>
+  <key>LSMinimumSystemVersion</key>
+  <string>13.0</string>
+  <key>LSUIElement</key>
+  <true/>
+  <key>NSHighResolutionCapable</key>
+  <true/>
+</dict>
+</plist>

threadkeeper-0.9.2/threadkeeper/assets/macos-agent-status/README.md

@@ -0,0 +1,65 @@
+# ThreadKeeper Agent Status
+
+Small macOS menu-bar app for live thread-keeper autonomous learning loop status.
+
+It polls `tk-agent-status --json` every 5 seconds and shows:
+
+- running/enabled loop count in the menu bar,
+- every autonomous learning loop,
+- a stable role description for what each loop/agent is responsible for,
+- running / idle / ready / off state,
+- active loops first (`running`, then `ready`),
+- last pass summary,
+- backlog count,
+- active spawned-child RSS when a loop has a worker running,
+- macOS notifications for newly completed autonomous child tasks that produced
+  a useful result.
+
+The first poll primes the seen-result list, so the app does not notify for old
+completed tasks that existed before it started.
+
+## Automatic startup
+
+On macOS, `python -m threadkeeper.server` installs and launches this app
+automatically when the MCP server starts. The startup hook is idempotent: it
+rebuilds only when the installed app is missing or older than the source,
+registers the LaunchAgent, and opens the app if it is not already running.
+
+Disable automatic startup with:
+
+```sh
+THREADKEEPER_MENUBAR_AUTO_LAUNCH=0
+```
+
+## Build
+
+```sh
+./build.sh
+open build/ThreadKeeperAgentStatus.app
+```
+
+## Install at login
+
+```sh
+./install.sh
+```
+
+The app is installed to `~/Applications/ThreadKeeperAgentStatus.app` and a
+LaunchAgent is registered at
+`~/Library/LaunchAgents/local.threadkeeper.agent-status.plist`.
+
+If `tk-agent-status` is not already installed on PATH, `install.sh` creates a
+small fallback wrapper at `~/.local/bin/tk-agent-status` that runs the local
+repo module through `.venv/bin/python`.
+
+## Command lookup
+
+The app looks for `tk-agent-status` in:
+
+- `/opt/homebrew/bin/tk-agent-status`
+- `/usr/local/bin/tk-agent-status`
+- `~/.local/bin/tk-agent-status`
+- `PATH` via `/usr/bin/env`
+
+Set `THREADKEEPER_AGENT_STATUS_COMMAND` when launching the app if the command
+lives somewhere else.