Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 1 addition & 10 deletions .skills/context-claims-ok
Original file line number Diff line number Diff line change
@@ -1,11 +1,2 @@
# curating-context claims warrants (prove-no-loss.sh --claims). Grammar: `--help`.
# #126: links into docs/DEPLOYMENT.md sections that the same change split out.
AGENTS.md :: retarget :: DEPLOYMENT.md#bumping-co-core
AGENTS.md :: retarget :: DEPLOYMENT.md#ci-pins-and-dependabot
AGENTS.md :: retarget :: DEPLOYMENT.md#disk-gc
AGENTS.md :: retarget :: DEPLOYMENT.md#extraction-dependencies
AGENTS.md :: retarget :: DEPLOYMENT.md#liveness
AGENTS.md :: retarget :: DEPLOYMENT.md#shell-lint
AGENTS.md :: retarget :: DEPLOYMENT.md#tailscale-dns
AGENTS.md :: retarget :: DEPLOYMENT.md#the-drift-check
AGENTS.md :: retarget :: DEPLOYMENT.md#the-lock-audit
# None for #126 part 2: no line was tightened. Part 1's are in git history.
82 changes: 37 additions & 45 deletions .skills/context-loss-ok

Large diffs are not rendered by default.

2 changes: 2 additions & 0 deletions .skills/context-metrics.jsonl
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
{"actions": ["baseline:pre-curation"], "budget": 6000, "bytes": 15801, "claims_dropped": null, "claims_warranted": null, "counts": null, "counts_acked": null, "delta_days": null, "delta_tokens": null, "docs_orphaned": 0, "docs_total": 3, "docs_unindexed": 0, "file": "AGENTS.md", "lines": 127, "links_dead": 0, "links_dead_anchors": 0, "no_loss": null, "no_loss_warrants": null, "note": null, "over_budget": true, "repo": "processor", "repo_commit": "e81eb9f", "seams": null, "seams_acked": null, "skill_commit": "04c4bc87", "skill_version": "1.31", "tokens": 6663, "tokens_exact": true, "tokens_live": 60780, "top_section": "Infrastructure", "top_section_share": 41, "ts": "2026-11-08"}
{"actions": ["split:docs/DEPLOYMENT.md", "demote:Infrastructure", "demote:Parity goldens", "tighten:Infrastructure", "restructure:Hard Rules", "fix:retarget-links", "index:Detail Docs", "wire:write-guard", "wire:cadence"], "budget": 6000, "bytes": 13978, "claims_dropped": 0, "claims_warranted": 9, "counts": 0, "counts_acked": 3, "delta_days": 0, "delta_tokens": -734, "docs_orphaned": 0, "docs_total": 7, "docs_unindexed": 0, "file": "AGENTS.md", "lines": 131, "links_dead": 0, "links_dead_anchors": 0, "no_loss": "ok", "no_loss_warrants": 38, "note": "docs/DEPLOYMENT.md still over (17.6k): § Patching and § Node.js held until #113's 2026-11-10 window closes; they move in #126's second PR. Phase 8: write guard and weekly cadence installed (operator, 2026-11-08)", "over_budget": false, "repo": "processor", "repo_commit": "595ae1b", "seams": 0, "seams_acked": 90, "skill_commit": "04c4bc87", "skill_version": "1.31", "tokens": 5929, "tokens_exact": true, "tokens_live": 64626, "top_section": "Hard Rules", "top_section_share": 17, "ts": "2026-11-08"}
{"actions": ["baseline:scheduled"], "budget": 6000, "bytes": 13978, "claims_dropped": null, "claims_warranted": null, "counts": 0, "counts_acked": 3, "delta_days": 0, "delta_tokens": 0, "docs_orphaned": 0, "docs_total": 7, "docs_unindexed": 0, "file": "AGENTS.md", "lines": 131, "links_dead": 0, "links_dead_anchors": 0, "no_loss": null, "no_loss_warrants": null, "note": null, "over_budget": false, "repo": "processor", "repo_commit": "25467d4", "seams": 0, "seams_acked": 10, "skill_commit": "04c4bc87", "skill_version": "1.31", "tokens": 5929, "tokens_exact": true, "tokens_live": 64626, "top_section": "Hard Rules", "top_section_share": 17, "ts": "2026-11-08"}
{"actions": ["baseline:pre-curation"], "budget": 6000, "bytes": 13978, "claims_dropped": null, "claims_warranted": null, "counts": null, "counts_acked": null, "delta_days": 2, "delta_tokens": 0, "docs_orphaned": 0, "docs_total": 7, "docs_unindexed": 0, "file": "AGENTS.md", "lines": 131, "links_dead": 0, "links_dead_anchors": 0, "no_loss": null, "no_loss_warrants": null, "note": null, "over_budget": false, "repo": "processor", "repo_commit": "1c1312c", "seams": null, "seams_acked": null, "skill_commit": "b51f3c24", "skill_version": "1.31", "tokens": 5929, "tokens_exact": true, "tokens_live": 64626, "top_section": "Hard Rules", "top_section_share": 17, "ts": "2026-11-10"}
{"actions": ["split:docs/DEPLOYMENT.md", "fix:false-fact", "fix:retarget-links", "index:Detail Docs", "fix:runtime-citations"], "budget": 6000, "bytes": 14033, "claims_dropped": null, "claims_warranted": null, "counts": 0, "counts_acked": 3, "delta_days": 0, "delta_tokens": 16, "docs_orphaned": 0, "docs_total": 8, "docs_unindexed": 0, "file": "AGENTS.md", "lines": 132, "links_dead": 0, "links_dead_anchors": 0, "no_loss": "ok", "no_loss_warrants": 16, "note": "#126 part 2: § Patching and § Node.js to docs/PATCHING.md after #113's 2026-11-10 window; every live doc under budget", "over_budget": false, "repo": "processor", "repo_commit": "2f414c6", "seams": 0, "seams_acked": 52, "skill_commit": "b51f3c24", "skill_version": "1.31", "tokens": 5945, "tokens_exact": true, "tokens_live": 65146, "top_section": "Hard Rules", "top_section_share": 17, "ts": "2026-11-10"}
57 changes: 30 additions & 27 deletions .skills/context-seams-ok
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,6 @@ tests/test_drift.py :: "CLAUDE.md",
tests/test_drift.py :: r"deploy only if the merge touched (.+?) \(", (root / "AGENTS.md").read_text()
tests/test_lock_audit.py :: """The summary and AGENTS.md link DEPENDENCIES.md's sections by anchor, and
tests/test_nodesource.py :: assert f"{EXPECTED_MAJOR} LTS from NodeSource" in (ROOT / "AGENTS.md").read_text()
tests/test_patching_knob.py :: """The knob, AGENTS.md and docs/SKILLS.md link DEPLOYMENT.md's sections by anchor."""
tests/test_pin.py :: "restore it to the contract (spec §5, D5; AGENTS.md; DEPENDENCIES.md step 4; "
tests/test_skills.py :: """A superpowers skill's ``superpowers:<n>`` is ``skills/<n>``; AGENTS.md maps strays."""
tests/test_skills.py :: agents = (ROOT / "AGENTS.md").read_text()
Expand All @@ -37,29 +36,21 @@ tests/test_skills.py :: agents = (ROOT / "AGENTS.md").read_text()
.gitignore :: # keeps its files for a rollback past #121 (docs/DEPLOYMENT.md § Rollback). No
.socraticodecontextartifacts.json :: "path": "./docs/DEPLOYMENT.md",
docs/DEPENDENCIES.md :: - **Outside the deploy gate.** The gate reads `ci.yml`'s push run alone (DEPLOYMENT.md § The CI gate); `tests/test_lock_
docs/DEPENDENCIES.md :: - **The weekly window, the human read** (#75, operator 2026-10-26). Each run's after-probe (DEPLOYMENT.md § Patching, st
docs/DEPENDENCIES.md :: What Processor pins and how each pin moves: the CI workflow's actions and images, shellcheck, the lock audit, co-core, t
docs/DEPLOYMENT.md :: In one commit, edit `node_<N>.x` in `deploy/apt/nodesource.sources`, `EXPECTED_MAJOR` in `tests/test_nodesource.py`, thi
docs/DEPLOYMENT.md :: | Service | systemd unit `processor` — [deploy/processor.service](../deploy/processor.service), runbook [docs/DEPLOYMENT
docs/MONITORING.md :: **With DEPLOYMENT.md § Patching:**
docs/MONITORING.md :: **`missing` on `co-processor-drift` means the check isn't reporting.** The cause is one of: the timer is stopped, live w
docs/MONITORING.md :: - **GitHub's budget:** unauthenticated, 60 requests an hour per address, shared with DEPLOYMENT.md § The CI gate. A run
docs/MONITORING.md :: What checks in to Status, and the host's resources: the drift check, liveness, the disk GC and its headroom sensor, memo
docs/MONITORING.md :: | behind in code for more than 8 h | `alert` (`lag`), every hour until deployed. It names `main`'s CI result | `scripts/
docs/NETWORK.md :: `-p warning` does the level filter (#76) and `fromjson?` drops systemd's own warning lines; for a window before #76's de
docs/PROVISIONING.md :: - `processor-patching.service`, since #113, which reads no `.env` either (DEPLOYMENT.md § The patch-due check).
docs/PROVISIONING.md :: What the operator set up once, on `co-processor` and around it: grants and credentials, `/etc/processor/`, the child's c
docs/SKILLS.md :: **gregoryfoster-skills (16):** `auditing-ci-cost` (CI since #12), `coordinating-epics` (#24 since #52), `curating-contex
docs/SKILLS.md :: - **Superpowers' `using-git-worktrees` and `writing-plans` are not linked**: gregoryfoster's own, same-named, win. So br
docs/SKILLS.md :: None since #62. `brainstorming` was one, synced from v6.4.2 to move the design doc to `docs/specs/`, until v7 deferred t
docs/SKILLS.md :: The post-merge pass runs as written. Its `git pull --ff-only` is a no-op after the push. Step 8 then offers `run-deploy-
docs/SKILLS.md :: `curating-context` holds `AGENTS.md` to 6,000 tokens and each live doc under `docs/` (not `plans/`, `specs/`) to 10,000
tests/test_apt_automatic.py :: Tracked in ``deploy/``, installed by hand (docs/DEPLOYMENT.md § Patching) as:
tests/test_apt_automatic.py :: pytest.fail(f"{installed} is not installed on {NODE} (docs/DEPLOYMENT.md § Patching)")
tests/test_deploy.py :: by its own commit's deploy.sh (docs/DEPLOYMENT.md § Rollback)."""
tests/test_drift.py :: world.lag(hours=72, files=["docs/DEPLOYMENT.md", "tests/test_drift.py"])
tests/test_needrestart.py :: pytest.fail(f"{INSTALLED} is not installed on {NODE} (docs/DEPLOYMENT.md § Patching)")
tests/test_nodesource.py :: """The NodeSource apt setup is pinned and self-consistent (docs/DEPLOYMENT.md, #6).

# A moved subsection, already named with the doc it moved to (or its own doc).
.socraticodecontextartifacts.json :: "description": "The tailnet path to the broker: Tailscale DNS, tailscaled's OOM rank and boot orderi
Expand All @@ -72,34 +63,46 @@ scripts/co_pypi_token.py :: f" {type(exc).__name__}: {exc}. The key: docs/PROVIS
scripts/co_pypi_token.py :: gets there: docs/PROVISIONING.md § GCP provisioning.
tests/test_main.py :: # NETWORK.md "At boot" (#8, #15): a start whose preflight still fails after the

# Runtime paths (processor.drift.RUNTIME_*): editing one is a deploy, and this
# change is docs only. Each still resolves: a section that stayed, or its stub
# under DEPLOYMENT.md's "Moved sections". Repointing them is #126's remaining work.
deploy/apt-daily.timer.d/processor-window.conf :: # /etc/systemd/system/apt-daily.timer.d/processor-window.conf (docs/DEPLOYMENT.md).
deploy/apt/apt.conf.d/processor-periodic :: // by hand as /etc/apt/apt.conf.d/processor-periodic (docs/DEPLOYMENT.md § Patching).
deploy/disk-gc/disk-gc.conf :: # (root, 0644); scripts/deploy.sh compares the two. docs/DEPLOYMENT.md § Disk GC.
deploy/needrestart.conf.d/processor.conf :: # Restarts on this node belong to the patch window (docs/DEPLOYMENT.md § Patching).
deploy/nodesource.sh :: # the processor service never runs it. docs/DEPLOYMENT.md -> Node.js; #6.
# Runtime paths (processor.drift.RUNTIME_*) that name docs/DEPLOYMENT.md: each
# points at what stayed there (the deploy, the CI gate, rollback, host configs).
# The rest were repointed in #126 part 2's deploy.
deploy/processor-drift.service :: # release and enables the timer the first time it installs it (docs/DEPLOYMENT.md).
deploy/processor-drift.service :: Documentation=https://github.com/CannObserv/processor/blob/main/docs/DEPLOYMENT.md
deploy/processor-patching.service :: Documentation=https://github.com/CannObserv/processor/blob/main/docs/DEPLOYMENT.md
deploy/processor.service :: # the deploy installs this file from that release (docs/DEPLOYMENT.md).
deploy/processor.service :: Documentation=https://github.com/CannObserv/processor/blob/main/docs/DEPLOYMENT.md
deploy/tailscaled.service.d/90-processor-oom.conf :: # Install: docs/DEPLOYMENT.md. OOMScoreAdjust= applies at exec, so tailscaled
pyproject.toml :: # version docs/DEPLOYMENT.md § Shell lint names, which tests/test_shellcheck.py holds.
pyproject.toml :: readme = "AGENTS.md"
scripts/deploy.sh :: "restarted on the unit it replaced. docs/DEPLOYMENT.md § Rollback"
scripts/deploy.sh :: "sudo systemctl disable --now $name (docs/DEPLOYMENT.md § Rollback)"
scripts/deploy.sh :: # (#34, as status#11; docs/DEPLOYMENT.md § The CI gate).
scripts/deploy.sh :: # (its spec's R1-R13; docs/DEPLOYMENT.md says where processor differs). The unit
scripts/deploy.sh :: die "Roll back to a kept release, or build this one with its own commit's scripts/deploy.sh (docs/DEPLOYMENT.md § Rollba
scripts/deploy.sh :: note "systemctl enable --now $name failed; enable it by hand (docs/DEPLOYMENT.md § The drift check)"
scripts/deploy.sh :: say "host config deploy/$rel differs from $dest; install it by hand (docs/DEPLOYMENT.md)"
scripts/deploy.sh :: say "host config deploy/$rel is not installed at $dest (docs/DEPLOYMENT.md)"
src/processor/checkin.py :: "reinstall it (docs/DEPLOYMENT.md § The drift check)"
src/processor/drift.py :: #: AGENTS.md's rule for when a merge needs ``scripts/deploy.sh``, defined here
src/processor/patching.py :: "isn't recorded: approve it in co-processor's session (docs/DEPLOYMENT.md "
src/processor/patching.py :: "or record why not (docs/DEPLOYMENT.md § Patching)",

# Moved verbatim from DEPLOYMENT.md; renaming it would break its anchor.
docs/PROVISIONING.md :: Broker credential handoff (hash-only, broker#75 as of 2026-09-30)

# #126 part 2 (judged 2026-11-10): PATCHING.md's intro and its links to sections
# that stayed in DEPLOYMENT.md, or to its own; mentions of the patch-due check
# as a thing, not a section; its tests and manifest entry.
docs/PATCHING.md :: Keeping `co-processor`'s packages current: the posture and its two lanes, the weekly attended run, the patch-due check,
docs/PATCHING.md :: | `health` ×2 | The unit is active, and nothing at `-p warning` in 6 min ([§ Operate → Logs](DEPLOYMENT.md#operate); val
docs/PATCHING.md :: | `origin deb.nodesource.com follow` | Node, agent tooling ([§ Patching Node](#patching-node)) |
docs/PATCHING.md :: **Deploys don't wait for a window** (operator, 2026-10-26, #77). The skill's policy.md says a deploy that restarts a dec
docs/PATCHING.md :: **The record** goes on the issue (`records CannObserv/processor`), per run.md §7, and ends with the next window's date.
docs/PATCHING.md :: In one commit, edit `node_<N>.x` in `deploy/apt/nodesource.sources`, `EXPECTED_MAJOR` in `tests/test_nodesource.py`, thi
docs/DEPLOYMENT.md :: The rest of the runbook, by topic (#126): [PROVISIONING.md](PROVISIONING.md) (prerequisites, `/etc/processor/` and `proc
docs/DEPLOYMENT.md :: A merge that changes nothing under `src/`, `deploy/`, `scripts/deploy.sh`, `pyproject.toml`, `uv.lock` or `.skills/patch
docs/PROVISIONING.md :: - `processor-patching.service`, since #113, which reads no `.env` either (PATCHING.md § The patch-due check).
.socraticodecontextartifacts.json :: "description": "Keeping co-processor patched: the automatic posture and its two lanes, the weekly attended run, the patc
src/processor/__main__.py :: — the drift check; ``processor patching`` — the patch-due check."""
src/processor/patching.py :: """Has this week's attended patch run been recorded? The patch-due check (#113).
tests/test_nodesource.py :: it. Moving the major line is a deliberate act: edit ``EXPECTED_MAJOR`` here in the same
tests/test_patching_knob.py :: for heading in ("## Patching", "### Patching Node"):

# Prose that happens to contain a moved heading ("removing it").
.claude/hooks/skills-submodule-update.sh :: # Judging a marker dead and then removing it are two steps, and two sessions
.claude/hooks/skills-submodule-update.sh :: # Taken, not removed (CR 1897): between judging it dead and removing it,

# Fresh-eyes review: the host-config notes name § Deploy a change, which stayed
# and links where each one installs.
scripts/deploy.sh :: say "host config deploy/$rel is not installed at $dest (where each is installed: docs/DEPLOYMENT.md § Deploy a change)"
scripts/deploy.sh :: say "host config deploy/$rel differs from $dest; install it by hand (where: docs/DEPLOYMENT.md § Deploy a change)"
13 changes: 7 additions & 6 deletions .skills/context-token-counts
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,12 @@
# The offline estimators prefer a file's own last exact measurement to the
# repo-wide figure in .skills/context-token-ratio, falling back to it for a
# file never counted exactly or since drifted far from the size recorded here.
13978 5929 AGENTS.md
20182 8178 docs/DEPENDENCIES.md
43700 17639 docs/DEPLOYMENT.md
18503 7633 docs/MONITORING.md
14033 5945 AGENTS.md
20180 8174 docs/DEPENDENCIES.md
23401 9473 docs/DEPLOYMENT.md
18501 7629 docs/MONITORING.md
14366 5801 docs/NETWORK.md
19540 8303 docs/PROVISIONING.md
16292 6674 docs/SKILLS.md
21352 8690 docs/PATCHING.md
19538 8299 docs/PROVISIONING.md
16288 6666 docs/SKILLS.md
11647 4469 docs/SOCRATICODE.md
1 change: 1 addition & 0 deletions .skills/doc-sections
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ docs/specs/2026-09-29-processor-service-design.md: a behaviour change under src/
AGENTS.md: the co-core pin and the co-pypi index under Environment & Tooling (pyproject.toml, uv.lock); the Infrastructure table (deploy/, .github/, scripts/deploy.sh); Hard Rules, its containment and parity paragraphs (src/processor/_child.py, _contain.py, tests/fixtures/parity/); Detail Docs when a doc is added or renamed
docs/DEPENDENCIES.md "Bumping co-core", docs/DEPENDENCIES.md "Extraction dependencies": pyproject.toml, uv.lock, the co-pypi index and scripts/co-pypi.sh, LOCAL_GENERATION
docs/DEPLOYMENT.md "Deploy a change: `scripts/deploy.sh`", docs/MONITORING.md "The drift check", docs/MONITORING.md "Liveness": deploy/ units, scripts/deploy.sh, processor.drift.RUNTIME_*
docs/PATCHING.md "Patching", docs/PATCHING.md "The patch-due check", docs/PATCHING.md "Node.js (agent tooling only)": .skills/patching-hosts, deploy/apt/, the apt timers' drop-ins, deploy/needrestart.conf.d/, deploy/nodesource.sh, src/processor/patching.py
docs/DEPENDENCIES.md "CI pins and Dependabot", docs/DEPENDENCIES.md "Shell lint", docs/DEPENDENCIES.md "The lock audit": .github/, scripts/shellcheck.sh, scripts/audit_lock.sh, .githooks/
docs/SKILLS.md: the inventory, the refresh hook, Merging under pr and the doc-check lists (skills/, .claude/, .gitmodules, the .skills/ knobs)
docs/SOCRATICODE.md: the store, the index scope and the context manifest (.socraticode.json, .socraticodecontextartifacts.json, .socraticodeignore, .claude/settings.json's env block)
6 changes: 3 additions & 3 deletions .skills/patching-hosts
Original file line number Diff line number Diff line change
Expand Up @@ -24,14 +24,14 @@ window Tue 05:00-10:00
# and a Status check-in. processor-patching.timer (#113) ticks on the hour, the
# same read and check-in, and reads this file's weekday window lines from the
# release: a change here is a deploy (RUNTIME_FILES). Liveness checks in every 5 min from inside
# `processor run`; a stop past its 900 s grace pages (docs/DEPLOYMENT.md).
# `processor run`; a stop past its 900 s grace pages (docs/MONITORING.md § Liveness).

# --- the service ----------------------------------------------------------
# Stopped in the reboot chain, and checked after boot for its first start and
# NRestarts. KillMode=mixed + TimeoutStopSec=240 let the in-flight command
# finish; one cut off stays pending and is reclaimed (store -> publish -> ack).
# A deploy restarts it outside any window, by the owner's choice (2026-10-26):
# docs/DEPLOYMENT.md § Patching.
# docs/PATCHING.md § Patching.
service processor.service

# An extraction mid-run: its child is a `python -I -m processor._child`.
Expand Down Expand Up @@ -61,7 +61,7 @@ hold tailscale tailscale

# --- owners ---------------------------------------------------------------
# The release is an extract with no git origin: its uv.lock is this repo's,
# updated through scripts/deploy.sh (the lock audit: docs/DEPLOYMENT.md).
# updated through scripts/deploy.sh (docs/DEPENDENCIES.md § The lock audit).
owner /srv/processor/live self

records CannObserv/processor
7 changes: 6 additions & 1 deletion .socraticodecontextartifacts.json
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,12 @@
{
"name": "deployment-runbook",
"path": "./docs/DEPLOYMENT.md",
"description": "Deploying and operating processor on co-processor: releases and scripts/deploy.sh, the CI gate, rollback, operate, patching, Node.js; stubs for the sections that moved (#126)."
"description": "Deploying and operating processor on co-processor: releases and scripts/deploy.sh, the CI gate, rollback, operate; stubs for the sections that moved (#126)."
},
{
"name": "patching-doc",
"path": "./docs/PATCHING.md",
"description": "Keeping co-processor patched: the automatic posture and its two lanes, the weekly attended run, the patch-due check (processor patching), and Node.js from NodeSource."
},
{
"name": "provisioning-doc",
Expand Down
Loading
Loading