Skip to content

Practical patterns, starters & CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.

chore: STATE after cache npm publish (queue clear) (#353)

Cobus Greyling782c7945990f
diff --git a/RELEASE_NOTES_DRAFT.md b/RELEASE_NOTES_DRAFT.md
index c6c9d48..b81406b 100644
--- a/RELEASE_NOTES_DRAFT.md
+++ b/RELEASE_NOTES_DRAFT.md
@@ -67,8 +67,8 @@ npx @cobusgreyling/loop-worktree list
| Package | On npm now | This PR / tag | Action |
|---------|------------|---------------|--------|
-| `@cobusgreyling/loop-cost` | 1.1.0 | **1.2.0** → `loop-cost-v1.2.0` | **Publish after merge** |
-| `@cobusgreyling/loop-context` | 1.4.0 | **1.5.0** → `loop-context-v1.5.0` | **Publish after merge** (depends on cost 1.2.0 for dep range) |
+| `@cobusgreyling/loop-cost` | **1.2.0** | `loop-cost-v1.2.0` | **Published** |
+| `@cobusgreyling/loop-context` | **1.5.0** | `loop-context-v1.5.0` | **Published** |
| `@cobusgreyling/loop-audit` | 1.7.0 | — | No change |
| `@cobusgreyling/loop-init` | 1.5.0 | — | No change |
| `@cobusgreyling/loop-worktree` | 1.2.0 | — | Already published |
@@ -82,20 +82,11 @@ npx @cobusgreyling/loop-worktree list
### Suggested publish steps
-1. Merge this PR (versions + notes + STATE).
-2. Tag and push (triggers release workflows):
-
-```bash
-git tag loop-cost-v1.2.0
-git push origin loop-cost-v1.2.0
-git tag loop-context-v1.5.0
-git push origin loop-context-v1.5.0
-```
-
-3. Confirm Actions → Release loop-cost / Release loop-context are green.
-4. `npm view @cobusgreyling/loop-cost version` → `1.2.0`; same for `loop-context` → `1.5.0`.
-5. Human: fold this draft into discussion/announce for [#332](https://github.com/cobusgreyling/loop-engineering/issues/332) when ready.
-6. Supersedes contributor draft [#348](https://github.com/cobusgreyling/loop-engineering/pull/348) (stale checklist).
+1. ~~Merge version bump PR #352~~ done.
+2. ~~Tag `loop-cost-v1.2.0` + `loop-context-v1.5.0`~~ done; release workflows green.
+3. ~~`npm view` → 1.2.0 / 1.5.0~~ confirmed.
+4. Human: fold this draft into discussion/announce for [#332](https://github.com/cobusgreyling/loop-engineering/issues/332) when ready.
+5. Superseded contributor draft [#348](https://github.com/cobusgreyling/loop-engineering/pull/348) (closed).
---
diff --git a/STATE.md b/STATE.md
index af7aaca..a45a6d7 100644
--- a/STATE.md
+++ b/STATE.md
@@ -1,31 +1,31 @@
# Loop State — loop-engineering reference
-Last run: 2026-07-22T12:48:31Z (scheduled maintenance — publish checklist + cache bumps + STATE)
+Last run: 2026-07-22T12:52:20Z (scheduled maintenance — post-publish confirm)
## High Priority (loop is acting or waiting on human)
- Maintain loop readiness score ≥ 58 (current: **100**, level **L3**).
-- **Publish after this PR merges:** tag `loop-cost-v1.2.0` and `loop-context-v1.5.0` (prompt-caching work from #346/#347). See `RELEASE_NOTES_DRAFT.md` checklist.
-- [#332](https://github.com/cobusgreyling/loop-engineering/issues/332) release prep / discussion announce — human when notes are ready.
+- [#332](https://github.com/cobusgreyling/loop-engineering/issues/332) release prep / discussion announce — human when ready to fold `RELEASE_NOTES_DRAFT.md`.
## Watch List
- Contributor failure stories; Post-Merge Cleanup production story
-- Remaining Cursor/docs GFI: #220, #223, #224; #118–#120, #147, #173, #195 ( #117 via #351, #196 via #350 — done)
+- Remaining Cursor/docs GFI: #220, #223, #224; #118–#120, #147, #173, #195 (#117 via #351, #196 via #350 — done)
- Validate `loop-init --with-foundry` + `goal-init` on fresh projects
- Optional: StackMap #300, Pluribus #262, loop.js #246
## Open PRs
-- None expected after merge of this maintenance PR and close of #348 (superseded).
-- If anything reopens: first-time contributor workflows need `validate`+`audit` approval before merge.
+- **None.** Queue cleared after #352 (cache bumps) and close of #348 (superseded notes).
## Housekeeping (2026-07-22)
-- **Merged:** #346 loop-cost caching, #347 loop-context caching budget, #349 daily-triage readiness-core build, #350 Copilot appendix, #351 Continue appendix.
-- **Closed:** #344 night STATE draft (superseded); #348 release-notes draft (stale npm table — replaced by this checklist).
-- **Version bumps in this run:** loop-cost **1.2.0**, loop-context **1.5.0** (npm still 1.1.0 / 1.4.0 until tags).
-- Other packages already current on npm: loop-audit 1.7.0, loop-init 1.5.0, loop-worktree 1.2.0, loop-gate 1.0.0, goal-init 1.0.0, readiness-core 1.0.0.
+- **Merged:** #346/#347 cache features, #349 daily-triage CI, #350 Copilot, #351 Continue, #352 version bumps + notes + STATE.
+- **Published to npm:**
+ - `@cobusgreyling/[email protected]` (tag `loop-cost-v1.2.0`)
+ - `@cobusgreyling/[email protected]` (tag `loop-context-v1.5.0`)
+- **Also current on npm:** loop-audit 1.7.0, loop-init 1.5.0, loop-worktree 1.2.0, loop-gate 1.0.0, goal-init 1.0.0, readiness-core 1.0.0.
+- **Closed:** #344 (superseded STATE draft), #348 (stale publish checklist).
## Recent Noise
@@ -34,9 +34,8 @@ Last run: 2026-07-22T12:48:31Z (scheduled maintenance — publish checklist + ca
## Post-Run Critique
-- Friction: #346/#347 shipped features without package.json bumps — blocked real npm consumers until this maintenance.
-- Adjustment (reaffirmed): any `tools/*` behavior change PR must include version bump + RELEASE_NOTES_DRAFT row in the same PR.
-- Friction: first-time contributor PRs blocked on workflow approval for required checks — approve early in triage.
+- Feature PRs without version bumps blocked consumers until maintenance (#346/#347 gap) — keep bump + RELEASE_NOTES row in the same PR.
+- Dist for loop-cost/loop-context was stale on main until #352 rebuild — publish path tests source then ships `dist`; prefer rebuilding tracked dist when tool source changes.
---
Run log: Updated by daily-triage.yml and scheduled maintenance. See LOOP.md for cadence and gates.
diff --git a/loop-run-log.md b/loop-run-log.md
index 3978a5d..3edc454 100644
--- a/loop-run-log.md
+++ b/loop-run-log.md
@@ -48,3 +48,4 @@ Append one entry per run. Prune entries older than 30 days.
{"run_id":"2026-07-21T12:38:33Z","pattern":"daily-triage","duration_s":90,"items_found":7,"actions_taken":1,"escalations":5,"tokens_estimate":25000,"readiness_score":100,"outcome":"report-only","note":"new PR #335 loop-context breaker; open 315-318,321,323,335"}
{"run_id":"2026-07-21T14:11:50Z","pattern":"daily-triage","duration_s":600,"items_found":7,"actions_taken":5,"escalations":2,"tokens_estimate":40000,"readiness_score":100,"outcome":"report-only","note":"PR triage: merge 316/318/335; close 315; changes-requested 317/321"}
{"run_id":"2026-07-22T12:48:31Z","pattern":"scheduled-maintenance","duration_s":900,"items_found":4,"actions_taken":4,"escalations":1,"tokens_estimate":40000,"readiness_score":100,"outcome":"acting","note":"bump loop-cost 1.2.0 + loop-context 1.5.0; refresh RELEASE_NOTES checklist; rewrite STATE after #350/#351; supersede #348; tags after merge"}
+{"run_id":"2026-07-22T12:52:20Z","pattern":"scheduled-maintenance","duration_s":300,"items_found":1,"actions_taken":2,"escalations":0,"tokens_estimate":15000,"readiness_score":100,"outcome":"report-only","note":"confirmed npm loop-cost 1.2.0 + loop-context 1.5.0; STATE open-PR queue empty; #348 closed"}