snowytrees.dev / project-manager

0

Integrated repository, worktree, git stacker, and project manager

0

project-manager / integrations / systemd /

at master 4 files

Jordan Isaacs agent: add `pm agent serve` daemon for live session tracking 4w ago

agent: add `pm agent serve` daemon for live session tracking A headless daemon (stdlib threaded HTTP + SSE, ephemeral WAL SQLite) that ingests best-effort hook events from Claude/Codex/Cursor and broadcasts live session state to observers (the Emacs sidebar, curl). - serve/{server,store,status,fallback}: HTTP+SSE server, WAL store, pure status-derivation, and a Tier-2 transcript fallback poller. Status vocab: working / waiting_response / waiting_permission / idle / unknown, with openui-style activity-gating and a pid-liveness cleanup backstop. - install-hooks: a shared stdlib reporter installed for Claude (settings.json), Codex (a --profile pm config, since isaac regenerates ~/.codex/hooks.json), and Cursor (~/.cursor/hooks.json, incl. shell/MCP approval). Skips the Claude-hook double-report Cursor triggers. - transcript: shared title library (custom-title > ai-title > synthetic > first prompt) that also parses Codex rollouts natively; the fallback fills source-reader titles (e.g. Cursor) for sessions it cannot parse. - config [serve], opt-in WAL in sqlite_db, systemd unit, tests.

1 month ago

pm-repo-mgmt.service

Add integrations/{emacs,systemd}: pm Emacs package and user units Combines the previously separate extensions/emacs add, README path fix, and extensions/systemd add into a single integrations/* layout — mirroring emacs-config's integrations/ convention. integrations/emacs/ ships the pm.el package (project.el backend, magit-style transients, 21 ERT tests). integrations/systemd/ ships pm-repo-mgmt.{service,timer} for keeping the canonical repo store warm. Wired into `make check` via the existing test-emacs target.

2 months ago

pm-repo-mgmt.timer

pm-repo-mgmt.timer: switch to OnCalendar wall-clock schedule OnUnitActiveSec drifts whenever the service runs longer than expected or boots late, so the 15-minute cadence wandered off the quarter-hour. OnCalendar=*:0/15 anchors runs to :00/:15/:30/:45 regardless of how the prior run went.

2 months ago

pm-serve.service

agent: add `pm agent serve` daemon for live session tracking A headless daemon (stdlib threaded HTTP + SSE, ephemeral WAL SQLite) that ingests best-effort hook events from Claude/Codex/Cursor and broadcasts live session state to observers (the Emacs sidebar, curl). - serve/{server,store,status,fallback}: HTTP+SSE server, WAL store, pure status-derivation, and a Tier-2 transcript fallback poller. Status vocab: working / waiting_response / waiting_permission / idle / unknown, with openui-style activity-gating and a pid-liveness cleanup backstop. - install-hooks: a shared stdlib reporter installed for Claude (settings.json), Codex (a --profile pm config, since isaac regenerates ~/.codex/hooks.json), and Cursor (~/.cursor/hooks.json, incl. shell/MCP approval). Skips the Claude-hook double-report Cursor triggers. - transcript: shared title library (custom-title > ai-title > synthetic > first prompt) that also parses Codex rollouts natively; the fallback fills source-reader titles (e.g. Cursor) for sessions it cannot parse. - config [serve], opt-in WAL in sqlite_db, systemd unit, tests.

1 month ago

README.md

pm — systemd user units#

Units that keep the canonical-repo store warm, its pinned branches up to date, and the agent-session tracking daemon running.

File	Role
`pm-repo-mgmt.service`	Runs `pm repo pull` + `pm repo maintenance` (fetch, ff-only, gc).
`pm-repo-mgmt.timer`	Fires the service 15s after boot and every 15 minutes thereafter.
`pm-serve.service`	Long-running `pm agent serve` session-tracking daemon (auto-restart).

The services use %h so they work for any user; they expect pm at ~/.local/bin/pm — adjust ExecStart= if your install lives elsewhere.

`pm-serve` (agent session tracker)#

pm agent serve is a loopback HTTP+SSE daemon that tracks live agent session status. It ingests best-effort lifecycle-hook events (POST /api/status), keeps live state in an ephemeral WAL SQLite store (recreated on each start), backfills via a transcript-tailing poller, and pushes updates over SSE (GET /api/stream, with ?meta.<KEY>=<val> / ?agent= / ?project= / ?status= server-side filters). It is a pure observer — no action endpoints. Port and paths come from [serve] in the pm config (default port 8787, db ~/.pm/serve.db).

Install the hooks that feed it (idempotent, user level):

pm agent install-hooks            # both Claude + Codex
pm agent install-hooks --no-codex # Claude only

This writes a fire-and-forget reporter to ~/.pm/hooks/status-reporter.sh and registers it in ~/.claude/settings.json and ~/.codex/hooks.json (backing each up to *.pm-bak). Hook failures are logged to ~/.pm/hook-debug.log and never block the agent. Sessions launched with PM_META_* env vars carry those into the session's meta for filtering (e.g. an Emacs client sets PM_META_SOURCE=emacs).

Install#

ln -sf "$PWD"/pm-repo-mgmt.service ~/.config/systemd/user/
ln -sf "$PWD"/pm-repo-mgmt.timer   ~/.config/systemd/user/
ln -sf "$PWD"/pm-serve.service     ~/.config/systemd/user/
systemctl --user daemon-reload
systemctl --user enable --now pm-repo-mgmt.timer
systemctl --user enable --now pm-serve.service

Verify:

systemctl --user list-timers pm-repo-mgmt.timer
journalctl --user -u pm-repo-mgmt.service -n 20

Uninstall#

systemctl --user disable --now pm-repo-mgmt.timer
rm ~/.config/systemd/user/pm-repo-mgmt.{service,timer}
systemctl --user daemon-reload