marvin8/cang
Watch
1
0
Fork
You've already forked cang
 0
Code Issues Pull requests Releases 35 Activity Actions

Process split: cangcang (daemon) + cangjian (web) #143

New issue
Closed
opened 2026-08-12 06:03:59 +00:00 by agent-pi · 1 comment
agent-pi commented 2026-08-12 06:03:59 +00:00
Collaborator
Copy link

Cang currently runs as a single process doing ingest, cleanup, and web serving in one asyncio event loop. All DB operations share aiosqlite's single background thread, so during periodic scans web requests queue behind writes and the UI hangs.

Split into two processes — cangcang (ingest/cleanup daemon) and cangjian (web server). Both share SQLite via WAL mode.

Also fixes issue #131 (deploy-docs token handling).

Design spec: .superpowers/specs/2026-08-12-cang-process-split-design.md

Cang currently runs as a single process doing ingest, cleanup, and web serving in one asyncio event loop. All DB operations share aiosqlite's single background thread, so during periodic scans web requests queue behind writes and the UI hangs. Split into two processes — cangcang (ingest/cleanup daemon) and cangjian (web server). Both share SQLite via WAL mode. Also fixes issue #131 (deploy-docs token handling). Design spec: .superpowers/specs/2026-08-12-cang-process-split-design.md
agent-pi commented 2026-08-12 06:06:35 +00:00
Author
Collaborator
Copy link

Plan of attack

Two new entry points from the existing codebase, no logic changes:

  1. src/cang/daemon.py — extract all ingest/cleanup/periodic-loop functions from web/lifespan.py into a new module. Exposes run_daemon(cfg, db).
  2. src/cang/web/server.py — new cangjian entry point. Plain FastAPI() app (no lifespan), uvicorn.
  3. web/app.py — drop lifespan import and kwarg.
  4. Delete cli.py and web/lifespan.py.
  5. Containerfile — CMD ["cangjian", "/config/cang.toml"] instead of ENTRYPOINT.
  6. CI — fix stale container annotations + harden deploy-docs token (#131).
  7. Quadlets — pod-level shared volumes, separate cangcang.container and cangjian.container.
  8. Follow-up issue — ability to mark snapshots as keep/do-not-delete.

Full plan: .superpowers/plans/2026-08-12-cang-process-split.md
Design spec: .superpowers/specs/2026-08-12-cang-process-split-design.md

## Plan of attack Two new entry points from the existing codebase, no logic changes: 1. **`src/cang/daemon.py`** — extract all ingest/cleanup/periodic-loop functions from `web/lifespan.py` into a new module. Exposes `run_daemon(cfg, db)`. 2. **`src/cang/web/server.py`** — new `cangjian` entry point. Plain `FastAPI()` app (no lifespan), uvicorn. 3. **`web/app.py`** — drop lifespan import and kwarg. 4. **Delete** `cli.py` and `web/lifespan.py`. 5. **`Containerfile`** — `CMD ["cangjian", "/config/cang.toml"]` instead of ENTRYPOINT. 6. **CI** — fix stale container annotations + harden deploy-docs token (#131). 7. **Quadlets** — pod-level shared volumes, separate `cangcang.container` and `cangjian.container`. 8. **Follow-up issue** — ability to mark snapshots as keep/do-not-delete. Full plan: `.superpowers/plans/2026-08-12-cang-process-split.md` Design spec: `.superpowers/specs/2026-08-12-cang-process-split-design.md`
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
pages
2026.9.7.1
2026.9.6.1
2026.8.24.1
2026.8.12.4
2026.8.12.3
2026.8.12.2
2026.8.12
2026.8.4
2026.7.25
2026.7.24
2026.7.23
2026.7.22
0.10.1
0.10.0
0.9.0
0.8.0
0.7.0
0.6.0
0.5.0
0.4.2
0.4.1
0.4.0
0.3.12
0.3.11
0.3.10
0.3.9
0.3.8
0.3.7
0.3.6
0.3.5
0.3.4
0.3.3
0.3.2
0.3.1
0.3.0
0.2.0
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
marvin8/cang#143
No description provided.