mikoshi-construct 0.3.0 → 0.4.0

package/README.md

@@ -3,6 +3,8 @@
 Bootstrap for AI-native software projects. Start with a proven engineering workflow instead of an
 empty repository.
 
+**[Documentation](https://e1i.github.io/mikoshi-construct/)** · [Getting started](https://e1i.github.io/mikoshi-construct/guide/getting-started) · [The development cycle](https://e1i.github.io/mikoshi-construct/guide/the-cycle) · [CLI reference](https://e1i.github.io/mikoshi-construct/cli)
+
 ```bash
 mkdir my-service && cd my-service
 npx mikoshi-construct init          # interactive: preset, agent, project name
@@ -13,10 +15,6 @@ pnpm install && pnpm run quality    # green before you write a line
 > the full lifecycle; Cursor gets the rules, the conventions and the discovery protocol.
 > `construct sync` moves a repository already carrying a construct onto newer templates.
 
-**Documentation — [e1i.github.io/mikoshi-construct](https://e1i.github.io/mikoshi-construct/)**:
-getting started, [the development cycle](https://e1i.github.io/mikoshi-construct/guide/the-cycle),
-the reasoning budget, [upgrading](https://e1i.github.io/mikoshi-construct/guide/upgrading) and the
-CLI reference.
 
 ## What it does
 

package/dist/cli.js

@@ -46,6 +46,7 @@ function claudeProjectsDir() {
 }
 function readUsage(file) {
   const totals = emptyUsage();
+  const counted = /* @__PURE__ */ new Set();
   for (const line of readFileSync(file, "utf8").split("\n")) {
     if (!line.startsWith("{"))
       continue;
@@ -58,6 +59,11 @@ function readUsage(file) {
     const message = entry.message;
     if (message?.role !== "assistant" || message.usage == null)
       continue;
+    if (entry.requestId != null) {
+      if (counted.has(entry.requestId))
+        continue;
+      counted.add(entry.requestId);
+    }
     totals.calls += 1;
     totals.input += message.usage.input_tokens ?? 0;
     totals.cacheWrite += message.usage.cache_creation_input_tokens ?? 0;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mikoshi-construct",
   "type": "module",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Bootstrap for AI-native software projects. Start with a proven engineering workflow instead of an empty repository.",
   "author": "Eli Tabrisov",
   "license": "MIT",
@@ -42,6 +42,7 @@
   },
   "devDependencies": {
     "@antfu/eslint-config": "^9.5.1",
+    "@anthropic-ai/sdk": "^0.127.0",
     "@changesets/changelog-github": "^1.0.0",
     "@changesets/cli": "^3.0.0",
     "@types/node": "^22.18.0",
@@ -54,6 +55,7 @@
     "yaml": "^2.9.1"
   },
   "scripts": {
+    "bench:architect": "tsx scripts/bench/run.ts",
     "build": "tsup",
     "changeset": "changeset",
     "ci": "pnpm run quality",
@@ -68,6 +70,7 @@
     "privacy:check": "tsx scripts/privacy/check.ts",
     "quality": "pnpm composition:check && pnpm privacy:check && pnpm lint && pnpm typecheck && pnpm test",
     "release": "pnpm build && changeset publish",
+    "release:verify": "tsx scripts/release/verify-published.ts",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",

package/templates/ai/claude/_claude/skills/implement/SKILL.md

@@ -37,7 +37,10 @@ repository's CLAUDE.md and `construct.json`.
    - `degraded` — a rung passed the harness, but a design step was rejected by the schema and the
      run continued without it. The result's `effort` is the class that actually executed.
    - `design incomplete` — a high-effort run whose architect was rejected by the schema. No
-     implementer ran without a spec; the result carries the validator's text in `validationError`.
+     implementer ran without a spec; the result carries the validator's text in `validationError` and
+     the way out in `recovery`, which is a measured route rather than advice: re-running one class
+     lower with the design written into the brief produced the design on three of the three occasions
+     it has been tried on the construct's own repository.
    - `failed` — every rung ran and the harness stayed red; `lastFailure` carries the excerpt.
    - `blocked` — the last rung stopped on a question; `question` carries it verbatim.
 4. Record the run: append one JSON line to `.construct/runs.jsonl` (create the directory if needed)
@@ -66,8 +69,9 @@ repository's CLAUDE.md and `construct.json`.
 5. Relay the result: status, the effort rung that succeeded and how many attempts it took, the
    files changed, and the harness tail. When the status is `blocked`, put the architect's or
    implementer's question to the user verbatim. When `failed`, give the last failure excerpt. When
-   `design incomplete`, say that the design step did not complete and give `validationError` as the
-   runtime reported it; when `degraded`, say which design step was rejected and that the reported
+   `design incomplete`, say that the design step did not complete, give `validationError` as the
+   runtime reported it, and relay `recovery` verbatim — a dead end that names no way out is how the
+   next person decides the ladder is broken rather than that this run needs re-running lower; when `degraded`, say which design step was rejected and that the reported
    class is the one that executed, not the one that was requested.
    Unless `construct.json` sets `report.usage` to `false`, end with one usage line for this run,
    from the Workflow tool's own accounting: agents, subagent tokens, tool uses, wall time — so the

package/templates/ai/claude/scripts/construct/implement.workflow.mjs

@@ -52,6 +52,8 @@ const SPEC = {
   },
 }
 
+const DESIGN_RECOVERY = 'Re-run this task one class lower with the design written into the brief. That is the measured route out: three of three such re-runs on the construct\'s own repository produced the design the architect had failed to return. The run does not retry the design step itself, because a second agent entry pays for the exploration again.'
+
 const DEFAULT_RETRY_LIMIT = 0
 const DESIGN_EFFORT = 'xhigh'
 const EFFORT_WITHOUT_DESIGN = { high: 'medium', xhigh: 'medium' }
@@ -150,7 +152,7 @@ async function design(rung, reason, label) {
     designFailed = true
     designError = lastValidationError ?? ''
     attempts.push({ rung, effort: DESIGN_EFFORT, outcome: 'design schema invalid', reason: designError })
-    log(`${label}: the design step did not complete`)
+    log(`${label}: the design step did not complete. ${DESIGN_RECOVERY}`)
     return false
   }
   spec = result
@@ -165,6 +167,7 @@ function designIncomplete(effort, question) {
     effort: performedEffort(effort),
     attempts,
     validationError: designError,
+    recovery: DESIGN_RECOVERY,
     question: question ?? '',
     lastFailure: feedback ?? '',
   }