@nanopm/cli 0.1.18 → 0.1.19

package/dist/index.js

@@ -5335,6 +5335,8 @@ var BUILD_SKILL = "build";
 var BUILD_STEPS_MIN = 1;
 var BUILD_STEPS_MAX = 8;
 var BUILD_STEP_MAX = 120;
+var BUILD_UNDERSTOOD_MIN = 40;
+var BUILD_UNDERSTOOD_MAX = 600;
 var BUILD_RESUMES_MAX = 3;
 var BUILD_TRAILER = "Co-Authored-By: NanoPM <noreply@nanopm.app>";
 var BUILD_COLUMNS = "id, ref, title, status, actor, agent_spec, spec";
@@ -11271,9 +11273,10 @@ async function runBuildJob(input) {
     let end = { stop: failed("the agent produced no result") };
     for await (const event of adapter.run({ ...spec2, prompt, resumeSessionId: resume3 ? spec2.sessionId : void 0 })) {
       await input.onEvent(event);
-      if (event.type === "tool_use" && event.tool === PLAN_TOOL && !plan) {
+      if (event.type === "tool_result" && event.tool === PLAN_TOOL && !event.isError && !plan) {
         plan = stepsOf(event.input);
-        if (plan) await events.write("plan", { steps: plan });
+        const understood = event.input?.understood;
+        if (plan) await events.write("plan", { steps: plan, ...typeof understood === "string" && understood.trim() ? { understood: understood.trim().slice(0, BUILD_UNDERSTOOD_MAX) } : {} });
       } else if (event.type === "tool_result" && event.tool === STEP_TOOL && !event.isError) {
         const { step, summary } = event.input ?? {};
         const index = Number(step) - 1;
@@ -12827,8 +12830,8 @@ ${renderMap()}`,
   server.registerTool(
     "build_plan",
     {
-      description: `Say the plan before you change anything: ${BUILD_STEPS_MIN} to ${BUILD_STEPS_MAX} steps, in order, each one change the founder can recognise, in their words (at most ${BUILD_STEP_MAX} characters). The last step is your own check of the whole change. Call it once; the founder sees it as a checklist.`,
-      inputSchema: { steps: z21.array(z21.string().min(3).max(BUILD_STEP_MAX)).min(BUILD_STEPS_MIN).max(BUILD_STEPS_MAX) }
+      description: `Say what you understood and your plan before you change anything. \`understood\`: in your own words and plain language, the problem, what you will change, and what you will not touch \u2014 a short paragraph the founder reads first, so a misunderstanding shows before any code (at most ${BUILD_UNDERSTOOD_MAX} characters). \`steps\`: ${BUILD_STEPS_MIN} to ${BUILD_STEPS_MAX}, in order, each one change the founder can recognise, in their words (at most ${BUILD_STEP_MAX} characters); the last is your own check of the whole change. Call it once; the founder sees the paragraph, then the steps as a checklist.`,
+      inputSchema: { understood: z21.string().min(BUILD_UNDERSTOOD_MIN).max(BUILD_UNDERSTOOD_MAX), steps: z21.array(z21.string().min(3).max(BUILD_STEP_MAX)).min(BUILD_STEPS_MIN).max(BUILD_STEPS_MAX) }
     },
     async ({ steps }) => ctx.workspace ? json({ recorded: steps.length, note: "Recorded. Build step 1 now; call build_step when it is done." }) : failure("this job builds nothing")
   );
@@ -14667,7 +14670,7 @@ import { promisify as promisify8 } from "util";
 // package.json
 var package_default = {
   name: "@nanopm/cli",
-  version: "0.1.18",
+  version: "0.1.19",
   description: "An autonomous product manager for builders who run several small products. Runs on your machine, drives your own coding harness.",
   type: "module",
   license: "MIT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanopm/cli",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "An autonomous product manager for builders who run several small products. Runs on your machine, drives your own coding harness.",
   "type": "module",
   "license": "MIT",

package/skills/build/SKILL.md

@@ -24,8 +24,11 @@ NanoPM commits each step for you and opens the pull request when you are done.
 2. If the code contradicts the spec — what it asks already exists, a step it assumes is not
    there, the size does not hold — `ask_user` before you plan: what the spec says, what the code
    has, what it changes, and the options. Do not guess what the founder decided.
-3. `build_plan`: your plan, 1 to 8 steps, in order, each a change the founder can recognise, in
-   their words. The last step is your check of the whole change.
+3. `build_plan`: first, in `understood`, what you understood, in your own words and plain
+   language — the problem, what you will change, what you will not touch. The founder reads it
+   before anything else; a misunderstanding must show there, not in the pull request. Then your
+   plan, 1 to 8 steps, in order, each a change the founder can recognise, in their words. The last
+   step is your check of the whole change.
 4. Build one step at a time. After each: run its tests and the project's own checks (the ones
    CLAUDE.md, the README or `package.json` name), fix what they report, then `build_step` with the
    step's number and one line on what you did. NanoPM commits right then, so a step is committed