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.

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.yml
index 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 & publish
working-directory: tools/loop-init
run: |
- # 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-bak
cp package-lock.json package-lock.json.release-bak
diff --git a/.github/workflows/release-loop-mcp-server.yml b/.github/workflows/release-loop-mcp-server.yml
index 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, test
working-directory: tools/mcp-server
diff --git a/.gitignore b/.gitignore
index 0d32bfe..aa8ceac 100644
--- a/.gitignore
+++ b/.gitignore
@@ -54,3 +54,4 @@ state.json
!starters/**/.codex/**
*.session
!tools/loop-sync/dist/
+*.tgz
diff --git a/README.md b/README.md
index 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.
## Contributing
diff --git a/tools/loop-swarm/package.json b/tools/loop-swarm/package.json
index 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.json
index 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.mjs
index 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'),