npm - @henryqw/pi-prompt-creator - Versions diffs - 3.2.1 → 3.2.2 - Mend

@henryqw/pi-prompt-creator 3.2.1 → 3.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/README.md +5 -7
package/docs/prompt-lifecycle.svg +41 -14
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # `@henryqw/pi-prompt-creator`
-Turn repeated requests or corrections in the Current Conversation into a global Pi prompt. A child with no tools prepares one Prompt Candidate. Review it with Main and approve it before saving.
+Turn repeated requests or corrections in the Current Conversation into a global Pi prompt. Review the Prompt Candidate with Main and approve it before saving.
 ## Install
@@ -9,7 +9,7 @@ pi install npm:@henryqw/pi-task-models
 pi install npm:@henryqw/pi-prompt-creator
 ```
-Run `/task-models` before analysis. Assign a model to `fast`, or override `pi-prompt-creator/draft`. Reopen `/task-models` to verify the saved route and thinking level.
+Configure `fast` in `/task-models`, or override `pi-prompt-creator/draft`.
 ## Works with
@@ -35,7 +35,7 @@ The extension creates `~/.pi/agent/prompts/<name>.md` and reloads Pi resources,
 ## Flow
-![Automatic analysis waits for candidate display, Main review, and approval; manual candidates appear immediately.](./docs/prompt-lifecycle.svg)
+![Draft outcomes: a candidate proceeds to Main review and approval, null clears the widget, and failure shows a status; manual candidates appear immediately.](./docs/prompt-lifecycle.svg)
 ### Analysis
@@ -47,7 +47,7 @@ Manual and automatic analysis send Pi's current model-visible session context to
 The payload includes the active compaction or branch summary, user text, completed assistant text, and effective prompt names and descriptions. It excludes tool traffic, thinking, images, custom messages, and inactive branches. The child has no tools, user extensions, Skills, saved session, project context files, or prompt templates. It returns one JSON response.
-New input does not stop analysis. Branch navigation discards the old result without stopping the child. Background work does not interrupt the conversation. Manual candidates appear immediately, without the diagram's WAIT stage. Automatic candidates stay behind `Prompt ready — /promptor` until you show them with `/promptor` or discard them with `/promptor dismiss`.
+New input does not stop analysis. Branch navigation discards the old result without stopping the child. Background work does not interrupt the conversation. Manual candidates appear immediately. Automatic candidates stay behind `Prompt ready — /promptor` until you show them with `/promptor` or discard them with `/promptor dismiss`.
 ### Review safeguards
@@ -74,7 +74,7 @@ Invalid or misspelled `automatic` disables automatic analysis for the session. F
 Only `/promptor automatic on` and `/promptor automatic off` write config. Each toggle rereads the file and preserves its current `inputThreshold`, including changes from another session. For a file with problems, it reports them, keeps usable values, and removes unknown keys. If another session changes that file before replacement, the toggle writes nothing.
-The extension owns no model config. At session start and before analysis, it reports each shared task-model config problem once per session.
+The extension owns no model config.
 ## State and storage
@@ -90,5 +90,3 @@ Pending candidates and input counters stay in memory only. Only automatic mode a
 | Child runtime | Two-minute idle timeout and five-minute hard timeout. |
 No candidate clears the running widget without a notice. Invalid output or child failure shows `Prompt analysis failed — /promptor`. Analysis never retries automatically; run `/promptor` or `/promptor analyze` to try again. The next non-empty user input clears the failure widget.
-This package does not create Skills or project-local runtime state.

package/docs/prompt-lifecycle.svg CHANGED Viewed

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <svg width="1280" height="720" viewBox="0 0 1280 720" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="prompt-lifecycle-title prompt-lifecycle-desc" id="prompt-lifecycle-root">
       <title id="prompt-lifecycle-title">Automatic analysis path to a saved prompt</title>
-      <desc id="prompt-lifecycle-desc">Automatic candidates wait for /promptor, while manual candidates display immediately; both require a valid Main review and explicit user approval before saving a new prompt file.</desc>
+      <desc id="prompt-lifecycle-desc">The draft child uses up to three turns: a candidate proceeds to review, null clears the widget, and invalid output or child failure shows a failure status; automatic candidates wait for /promptor, manual candidates display immediately, and both require Main review and user approval before saving.</desc>
       <defs>
       <style>@import url('https://fonts.googleapis.com/css2?family=Instrument+Serif:ital@0;1&amp;family=Geist:wght@400;500;600&amp;family=Geist+Mono:wght@400;500;600&amp;family=Noto+Serif:ital@0;1&amp;family=Noto+Sans+KR:wght@400;500;600&amp;family=Noto+Serif+KR:wght@400&amp;family=Noto+Sans+TC:wght@400;500;600&amp;family=Noto+Serif+TC:wght@400&amp;display=swap');
       #prompt-lifecycle-root { --paper: #f0eee9;
@@ -53,7 +53,7 @@
       <!-- Role lanes -->
       <rect x="40" y="140" width="1200" height="144" fill="#101828" fill-opacity="0.018"/>
       <rect x="40" y="428" width="1200" height="144" fill="#101828" fill-opacity="0.018"/>
-      <g fill="none" stroke="#101828" stroke-opacity="0.14" stroke-width="0.8">
+      <g fill="none" stroke="#101828" stroke-width="0.8" stroke-opacity="0.14">
         <line x1="40" y1="140" x2="1240" y2="140"/>
         <line x1="40" y1="284" x2="1240" y2="284"/>
         <line x1="40" y1="428" x2="1240" y2="428"/>
@@ -71,17 +71,27 @@
       <g fill="none" stroke="#4c5665" stroke-width="1" marker-end="url(#prompt-lifecycle-arrow)">
         <path d="M324 212 H412 Q420 212 420 220 V308"/>
         <path d="M676 500 H764 Q772 500 772 492 V404"/>
-        <path d="M852 356 H940 Q948 356 948 348 V260" stroke-dasharray="5,4"/>
+        <path d="M772 308 V220 Q772 212 780 212 H868" stroke-dasharray="5,4"/>
+        <path d="M556 452 V404"/>
+        <path d="M676 532 H940 Q948 532 948 524 V404"/>
         <path d="M1028 212 H1116 Q1124 212 1124 220 V308"/>
       </g>
-      <path d="M500 356 H588 Q596 356 596 364 V452" fill="none" stroke="#1d4ed8" stroke-width="1.2" marker-end="url(#prompt-lifecycle-arrow-accent)"/>
-      <rect x="604" y="400" width="72" height="16" rx="2" fill="#f0eee9"/>
-      <text x="640" y="412" fill="#1d4ed8" font-family="'Geist Mono', ui-monospace, monospace" font-size="8" text-anchor="middle" letter-spacing="0.8">CONTEXT</text>
+      <path d="M420 404 V476 Q420 484 428 484 H516" fill="none" stroke="#1d4ed8" stroke-width="1.2" marker-end="url(#prompt-lifecycle-arrow-accent)"/>
+      <rect x="432" y="460" width="72" height="16" rx="2" fill="#f0eee9"/>
+      <text x="468" y="472" fill="#1d4ed8" font-family="'Geist Mono', ui-monospace, monospace" font-size="8" text-anchor="middle" letter-spacing="0.8">CONTEXT</text>
+      <g fill="#4c5665" font-family="'Geist Mono', ui-monospace, monospace" font-size="8" text-anchor="middle">
+        <rect x="564" y="420" width="40" height="16" rx="2" fill="#f0eee9"/>
+        <text x="584" y="432">NULL</text>
+        <rect x="780" y="436" width="64" height="16" rx="2" fill="#f0eee9"/>
+        <text x="812" y="448">CANDIDATE</text>
+        <rect x="820" y="508" width="64" height="16" rx="2" fill="#f0eee9"/>
+        <text x="852" y="520">FAILURE</text>
+      </g>
       <!-- Nodes: name text remains 12px; technical text remains 8px. -->
       <g>
         <rect x="164" y="164" width="160" height="96" rx="8" fill="#f0eee9"/>
-        <rect x="164" y="164" width="160" height="96" rx="8" fill="#4c5665" fill-opacity="0.10" stroke="#6a7282"/>
+        <rect x="164" y="164" width="160" height="96" rx="8" fill="#4c5665" stroke="#6a7282" fill-opacity="0.10"/>
         <rect x="176" y="176" width="32" height="16" rx="2" fill="#4c5665" fill-opacity="0.14"/>
         <text x="192" y="188" fill="#4c5665" font-family="'Geist Mono', ui-monospace, monospace" font-size="8" font-weight="600" text-anchor="middle">YOU</text>
         <text x="244" y="212" fill="#101828" font-family="'Geist', system-ui, sans-serif" font-size="12" font-weight="600" text-anchor="middle">Conversation</text>
@@ -98,11 +108,11 @@
       </g>
       <g>
         <rect x="516" y="452" width="160" height="96" rx="8" fill="#f0eee9"/>
-        <rect x="516" y="452" width="160" height="96" rx="8" fill="#1d4ed8" fill-opacity="0.08" stroke="#1d4ed8" stroke-width="1.2"/>
+        <rect x="516" y="452" width="160" height="96" rx="8" fill="#1d4ed8" stroke="#1d4ed8" stroke-width="1.2" fill-opacity="0.08"/>
         <rect x="528" y="464" width="32" height="16" rx="2" fill="#1d4ed8" fill-opacity="0.14"/>
         <text x="544" y="476" fill="#1d4ed8" font-family="'Geist Mono', ui-monospace, monospace" font-size="8" font-weight="600" text-anchor="middle">CHD</text>
-        <text x="596" y="500" fill="#101828" font-family="'Geist', system-ui, sans-serif" font-size="12" font-weight="600" text-anchor="middle">One-turn draft</text>
-        <text x="596" y="520" fill="#4c5665" font-family="'Geist Mono', ui-monospace, monospace" font-size="8" text-anchor="middle">tool-free · isolated</text>
+        <text x="596" y="500" fill="#101828" font-family="'Geist', system-ui, sans-serif" font-size="12" font-weight="600" text-anchor="middle">Draft child</text>
+        <text x="596" y="520" fill="#4c5665" font-family="'Geist Mono', ui-monospace, monospace" font-size="8" text-anchor="middle">up to 3 turns · tool-free</text>
         <text x="596" y="536" fill="#6a7282" font-family="'Geist Mono', ui-monospace, monospace" font-size="8" text-anchor="middle">candidate JSON | null</text>
       </g>
       <g>
@@ -115,7 +125,7 @@
       </g>
       <g>
         <rect x="868" y="164" width="160" height="96" rx="8" fill="#f0eee9"/>
-        <rect x="868" y="164" width="160" height="96" rx="8" fill="#4c5665" fill-opacity="0.10" stroke="#6a7282"/>
+        <rect x="868" y="164" width="160" height="96" rx="8" fill="#4c5665" stroke="#6a7282" fill-opacity="0.10"/>
         <rect x="880" y="176" width="32" height="16" rx="2" fill="#4c5665" fill-opacity="0.14"/>
         <text x="896" y="188" fill="#4c5665" font-family="'Geist Mono', ui-monospace, monospace" font-size="8" font-weight="600" text-anchor="middle">YOU</text>
         <text x="948" y="212" fill="#101828" font-family="'Geist', system-ui, sans-serif" font-size="12" font-weight="600" text-anchor="middle">Review with Main</text>
@@ -124,7 +134,7 @@
       </g>
       <g>
         <rect x="1044" y="308" width="160" height="96" rx="8" fill="#f0eee9"/>
-        <rect x="1044" y="308" width="160" height="96" rx="8" fill="#101828" fill-opacity="0.05" stroke="#4c5665"/>
+        <rect x="1044" y="308" width="160" height="96" rx="8" fill="#101828" stroke="#4c5665" fill-opacity="0.05"/>
         <rect x="1056" y="320" width="32" height="16" rx="2" fill="#101828" fill-opacity="0.10"/>
         <text x="1072" y="332" fill="#4c5665" font-family="'Geist Mono', ui-monospace, monospace" font-size="8" font-weight="600" text-anchor="middle">FILE</text>
         <text x="1124" y="356" fill="#101828" font-family="'Geist', system-ui, sans-serif" font-size="12" font-weight="600" text-anchor="middle">Saved prompt</text>
@@ -132,12 +142,29 @@
         <text x="1124" y="392" fill="#6a7282" font-family="'Geist Mono', ui-monospace, monospace" font-size="8" text-anchor="middle">prompts/&lt;name&gt;.md · new file</text>
       </g>
+      <!-- Null and failure stop analysis without a candidate. -->
+      <g>
+        <rect x="516" y="308" width="160" height="96" rx="8" fill="#ffffff" stroke="#101828"/>
+        <rect x="528" y="320" width="32" height="16" rx="2" fill="#101828" fill-opacity="0.08"/>
+        <text x="544" y="332" fill="#101828" font-family="'Geist Mono', ui-monospace, monospace" font-size="8" font-weight="600" text-anchor="middle">EXT</text>
+        <text x="596" y="356" fill="#101828" font-family="'Geist', system-ui, sans-serif" font-size="12" font-weight="600" text-anchor="middle">Clear widget</text>
+        <text x="596" y="376" fill="#4c5665" font-family="'Geist Mono', ui-monospace, monospace" font-size="8" text-anchor="middle">no candidate</text>
+      </g>
+      <g>
+        <rect x="868" y="308" width="160" height="96" rx="8" fill="#ffffff" stroke="#101828"/>
+        <rect x="880" y="320" width="32" height="16" rx="2" fill="#101828" fill-opacity="0.08"/>
+        <text x="896" y="332" fill="#101828" font-family="'Geist Mono', ui-monospace, monospace" font-size="8" font-weight="600" text-anchor="middle">EXT</text>
+        <text x="948" y="356" fill="#101828" font-family="'Geist', system-ui, sans-serif" font-size="12" font-weight="600" text-anchor="middle">Failure status</text>
+        <text x="948" y="376" fill="#4c5665" font-family="'Geist Mono', ui-monospace, monospace" font-size="8" text-anchor="middle">Prompt analysis failed</text>
+        <text x="948" y="392" fill="#4c5665" font-family="'Geist Mono', ui-monospace, monospace" font-size="8" text-anchor="middle">— /promptor</text>
+      </g>
       <!-- Manual analysis skips WAIT, but does not skip review or approval. -->
       <text x="164" y="608" fill="#101828" font-family="'Geist', system-ui, sans-serif" font-size="12">Manual analysis displays its candidate immediately. Both paths require Main review and your approval before saving.</text>
       <text x="164" y="628" fill="#4c5665" font-family="'Geist Mono', ui-monospace, monospace" font-size="8">/promptor dismiss discards a pending automatic candidate. Saving never replaces an existing file.</text>
       <!-- Horizontal bottom legend; all content stays inside the 40px safe area. -->
-      <line x1="40" y1="644" x2="1240" y2="644" stroke="#101828" stroke-opacity="0.14" stroke-width="0.8"/>
+      <line x1="40" y1="644" x2="1240" y2="644" stroke="#101828" stroke-width="0.8" stroke-opacity="0.14"/>
       <g fill="#4c5665" font-family="'Geist Mono', ui-monospace, monospace" font-size="8">
         <text x="40" y="672" letter-spacing="1.2">LEGEND</text>
         <path d="M144 668 H176" fill="none" stroke="#4c5665" marker-end="url(#prompt-lifecycle-arrow)"/>
@@ -146,7 +173,7 @@
         <text x="416" y="672">ISOLATED ANALYSIS</text>
         <path d="M596 668 H628" fill="none" stroke="#4c5665" stroke-dasharray="5,4" marker-end="url(#prompt-lifecycle-arrow)"/>
         <text x="640" y="672">WAIT FOR USER DISPLAY</text>
-        <rect x="864" y="660" width="24" height="16" rx="2" fill="#101828" fill-opacity="0.05" stroke="#4c5665"/>
+        <rect x="864" y="660" width="24" height="16" rx="2" fill="#101828" stroke="#4c5665" fill-opacity="0.05"/>
         <text x="900" y="672">SAVED AFTER APPROVAL</text>
       </g>
     </svg>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@henryqw/pi-prompt-creator",
-  "version": "3.2.1",
+  "version": "3.2.2",
   "description": "Turn current Pi conversation signals into user-approved prompt templates.",
   "keywords": [
     "pi-package",