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
fix(release): unblock npm publish + refresh Help wanted (#421)
Cobus Greylingb20a3f10f21b
diff --git a/.github/workflows/release-loop-init.yml b/.github/workflows/release-loop-init.ymlindex e614e7f..c6676ba 100644--- a/.github/workflows/release-loop-init.yml+++ b/.github/workflows/release-loop-init.yml@@ -34,8 +34,9 @@ jobs:- name: Test, build & publishworking-directory: tools/loop-initrun: |- # Build monorepo sibling first — declared ^range may not be on npm yet+ # Build monorepo siblings first — declared ^range may not be on npm yet# when cutting audit + init in the same release window.+ (cd ../readiness-core && npm ci && npm run build)(cd ../loop-audit && npm ci && npm run build)cp package.json package.json.release-bakcp package-lock.json package-lock.json.release-bakdiff --git a/.github/workflows/release-loop-mcp-server.yml b/.github/workflows/release-loop-mcp-server.ymlindex 751b524..a9d2db9 100644--- a/.github/workflows/release-loop-mcp-server.yml+++ b/.github/workflows/release-loop-mcp-server.yml@@ -33,11 +33,12 @@ jobs:- name: Ensure npm supports trusted publishing (OIDC)run: npm install -g npm@latest- - name: Build loop-gate sibling (file dependency)- working-directory: tools/loop-gate+ - name: Build monorepo siblings (file dependencies)run: |- npm ci- npm run build+ for dir in readiness-core loop-audit loop-context loop-cost loop-gate; do+ echo "== building tools/$dir =="+ (cd tools/$dir && npm ci && npm run build)+ done- name: Install, build, testworking-directory: tools/mcp-serverdiff --git a/.gitignore b/.gitignoreindex 0d32bfe..aa8ceac 100644--- a/.gitignore+++ b/.gitignore@@ -54,3 +54,4 @@ state.json!starters/**/.codex/***.session!tools/loop-sync/dist/+*.tgzdiff --git a/README.md b/README.mdindex b7e4cce..a374d98 100644--- a/README.md+++ b/README.md@@ -301,19 +301,18 @@ Addy Osmani:**First PR?** Pick one open issue below. Stories and adopters get **same-day review** when possible. See [CONTRIBUTORS.md](CONTRIBUTORS.md) and the [contributor quickstart](https://github.com/cobusgreyling/loop-engineering/discussions/123).-**14 open** [`good first issue`](https://github.com/cobusgreyling/loop-engineering/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)s (refreshed Jul 2026). Comment **"I'll take this"** for assignment.+**6 open** [`good first issue`](https://github.com/cobusgreyling/loop-engineering/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)s (refreshed 2026-07-29). Comment **"I'll take this"** for assignment.| Time | Issue | What you ship ||------|-------|---------------|| ~10 min | [#120 — Adopters list](https://github.com/cobusgreyling/loop-engineering/issues/120) | One row in `docs/adopters.md` (or [Add Adopter](https://github.com/cobusgreyling/loop-engineering/issues/new?template=add-adopter.yml) template) |-| ~15–20 min | [#118 — Daily Triage story](https://github.com/cobusgreyling/loop-engineering/issues/118) · [#173 — Issue Triage story](https://github.com/cobusgreyling/loop-engineering/issues/173) · [#119 — PR Babysitter failure](https://github.com/cobusgreyling/loop-engineering/issues/119) · [#392 — CI Sweeper story](https://github.com/cobusgreyling/loop-engineering/issues/392) | Honest `stories/` write-up + index row |-| ~25–30 min | [#389 — loop-action QUICKSTART](https://github.com/cobusgreyling/loop-engineering/issues/389) · [#390 — loop-sandbox QUICKSTART](https://github.com/cobusgreyling/loop-engineering/issues/390) · [#391 — loop-gate QUICKSTART](https://github.com/cobusgreyling/loop-engineering/issues/391) | Doc subsection + links to tool READMEs |-| ~40 min | [#384 — Windsurf CI Sweeper](https://github.com/cobusgreyling/loop-engineering/issues/384) · [#385 — Windsurf Issue Triage](https://github.com/cobusgreyling/loop-engineering/issues/385) · [#386 — Windsurf Dependency Sweeper](https://github.com/cobusgreyling/loop-engineering/issues/386) | Fill pattern-coverage gaps in `examples/windsurf/` |+| ~15–20 min | [#118 — Daily Triage story](https://github.com/cobusgreyling/loop-engineering/issues/118) · [#173 — Issue Triage story](https://github.com/cobusgreyling/loop-engineering/issues/173) · [#119 — PR Babysitter failure](https://github.com/cobusgreyling/loop-engineering/issues/119) | Honest `stories/` write-up + index row || ~40–45 min | [#387 — Hermes CI Sweeper](https://github.com/cobusgreyling/loop-engineering/issues/387) · [#388 — Hermes Issue Triage](https://github.com/cobusgreyling/loop-engineering/issues/388) | Fill pattern-coverage gaps in `examples/hermes/` |-| ~45–60 min | [#393 — Harden loop-action quoting](https://github.com/cobusgreyling/loop-engineering/issues/393) | Safer `inputs.command` handling in `tools/loop-action` || Anytime | Templates | [Add Adopter](https://github.com/cobusgreyling/loop-engineering/issues/new?template=add-adopter.yml) · [Share a story](https://github.com/cobusgreyling/loop-engineering/issues/new?template=share-story.yml) || Hubs | Discussions | [Show your loop](https://github.com/cobusgreyling/loop-engineering/discussions/326) · [Ask anything](https://github.com/cobusgreyling/loop-engineering/discussions/327) |+**Recently shipped (thanks!):** Windsurf examples (#384–#386), loop-action/sandbox/gate QUICKSTART (#389–#391), CI Sweeper story (#392), loop-action hardening (#393/#395).+Maintainers re-seed the backlog with `bash scripts/create-good-first-issues.sh` (idempotent; skips existing titles). Prefer [live open GFI filter](https://github.com/cobusgreyling/loop-engineering/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) over this table if a row looks stale.## Contributingdiff --git a/tools/loop-swarm/package.json b/tools/loop-swarm/package.jsonindex 70c816a..43d8e0b 100644--- a/tools/loop-swarm/package.json+++ b/tools/loop-swarm/package.json@@ -4,7 +4,7 @@"description": "Multi-agent consensus sandboxing for extreme high-confidence loop operations.","type": "module","bin": {- "loop-swarm": "dist/cli.js"+ "loop-swarm": "./dist/cli.js"},"main": "dist/swarm.js","types": "dist/swarm.d.ts",diff --git a/tools/loop-worktree/package.json b/tools/loop-worktree/package.jsonindex cfb7c1a..a02ddcf 100644--- a/tools/loop-worktree/package.json+++ b/tools/loop-worktree/package.json@@ -4,7 +4,7 @@"description": "Manage isolated git worktrees for loop engineering attempts: create, mark, cleanup, and reconcile one worktree per fix attempt.","type": "module","bin": {- "loop-worktree": "dist/cli.js"+ "loop-worktree": "./dist/cli.js"},"main": "dist/worktree.js","types": "dist/worktree.d.ts",diff --git a/tools/loop-worktree/test/package-exports.test.mjs b/tools/loop-worktree/test/package-exports.test.mjsindex 502624e..2a97e0e 100644--- a/tools/loop-worktree/test/package-exports.test.mjs+++ b/tools/loop-worktree/test/package-exports.test.mjs@@ -40,7 +40,17 @@ test('packed package exposes the public lock subpath and keeps legacy deep impor],{ cwd: packageRoot, maxBuffer: 10 * 1024 * 1024 },);- const packed = JSON.parse(stdout);+ // npm may print notices before JSON, and newer npm may return a single object.+ const jsonStart = (() => {+ const arr = stdout.indexOf('[');+ const obj = stdout.indexOf('{');+ if (arr === -1) return obj;+ if (obj === -1) return arr;+ return Math.min(arr, obj);+ })();+ assert.ok(jsonStart >= 0, `npm pack --json produced no JSON: ${stdout.slice(0, 200)}`);+ const parsed = JSON.parse(stdout.slice(jsonStart));+ const packed = Array.isArray(parsed) ? parsed : [parsed];assert.equal(packed.length, 1);assert.ok(packed[0].files.some((file) => file.path === 'dist/lock.d.ts'),