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.
TypeScript agentic-aiai-agentsai-codinganthropicautomationclaudeclaude-codecodexcoding-agentsdevops-automationdevtoolsgithub-actionsgrokllmloop-engineeringmcpprompt-engineering
chore: STATE after cache npm publish (queue clear) (#353)
Cobus Greyling782c7945990f
diff --git a/RELEASE_NOTES_DRAFT.md b/RELEASE_NOTES_DRAFT.mdindex 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.mdindex 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.mdindex 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"}