@dreadedzombie/pi-init 1.2.0 → 1.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreadedzombie/pi-init",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Generates a typed AGENTS.md for your project — /init, /init research, /init debug, /init code",
   "license": "MIT",
   "author": "DreadedZombie",

package/src/index.ts

@@ -18,6 +18,9 @@ import * as path from "node:path";
 
 const TEMPLATE_CODE = `# Project Agent
 
+**Workspace Path:** \`{{CWD}}\`
+*(Note to Pi: Your file write/edit tools run in a different directory by default. You MUST use absolute paths starting with the Workspace Path above for ALL file operations!)*
+
 <!-- Pi: before writing anything, explore this project:
   1. Read package.json / pyproject.toml / Cargo.toml / go.mod — identify stack and versions
   2. Scan directory structure: rg --files | head -60
@@ -58,15 +61,14 @@ const TEMPLATE_CODE = `# Project Agent
 
 const TEMPLATE_RESEARCH = `# Research Agent
 
-**Started:** <!-- Pi: insert today's date (YYYY-MM-DD) -->
+**Workspace Path:** \`{{CWD}}\`
+*(Note to Pi: Your file write/edit tools run in a different directory by default. You MUST use absolute paths starting with the Workspace Path above for ALL file operations!)*
 
-## FIRST ACTION — Before anything else
-Create the \`research/\` directory and write \`research/plan.md\` listing the topics you will investigate.
-Do this before any searching or reading. This is not optional.
+**Started:** <!-- Pi: insert today's date (YYYY-MM-DD) -->
 
 ## Output Rule — Files Before Chat
 **Never summarize findings in chat.** Every finding goes into a file.
-- Create \`research/<topic>.md\` as you complete each topic — not at the end
+- Create \`{{CWD}}/research/<topic>.md\` as you complete each topic — not at the end
 - Update the Research Findings section in this file after writing each doc
 - Chat response comes last, only to say what files were written and what to do next
 - **If you are about to type a finding into chat — stop. Write it to a file instead.**
@@ -89,7 +91,7 @@ Do this before any searching or reading. This is not optional.
 2. **Dive** — read the full content of the 5-6 most relevant sources
 3. **Cross-reference** — identify what sources agree and disagree on
 4. **Synthesize** — build a coherent picture with citations
-5. **Write** — save to \`research/<topic>.md\` with full detail, citations, code snippets, and gaps
+5. **Write** — save to \`{{CWD}}/research/<topic>.md\` with full detail, citations, code snippets, and gaps
 6. **Update AGENTS.md** — add the file to Research Findings below, one line per file
 7. Repeat steps 1-6 for each sub-topic before moving on
 
@@ -111,13 +113,16 @@ Each file should contain:
 - \`pi-docparser\` — for PDFs, papers, Word docs, spreadsheets
 
 ## Research Findings
-<!-- Pi: after writing each research/<topic>.md, add a line here immediately:
+<!-- Pi: after writing each {{CWD}}/research/<topic>.md, add a line here immediately:
      - [Topic title](research/filename.md) — one-line summary of what was found
      Do not wait until the end. Update this section after every file written. -->
 `;
 
 const TEMPLATE_DEBUG = `# Debug Agent
 
+**Workspace Path:** \`{{CWD}}\`
+*(Note to Pi: Your file write/edit tools run in a different directory by default. You MUST use absolute paths starting with the Workspace Path above for ALL file operations!)*
+
 ## Research Findings
 <!-- Pi: read every file linked here before starting investigation — prior research is your context -->
 
@@ -264,11 +269,27 @@ export default function (pi: ExtensionAPI) {
         }
       }
 
-      const content = type === "research" ? TEMPLATE_RESEARCH
+      let content = type === "research" ? TEMPLATE_RESEARCH
                     : type === "debug"    ? TEMPLATE_DEBUG
                     :                       TEMPLATE_CODE;
 
+      // Ensure paths are absolute and formatted correctly for the LLM
+      const absoluteCwd = cwd.replace(/\\/g, "/");
+      content = content.replace(/\{\{CWD\}\}/g, absoluteCwd);
+
       fs.writeFileSync(dest, content, "utf8");
+
+      // ── Research: scaffold research/ dir and plan.md so Pi fills in existing files ──
+      if (type === "research") {
+        const researchDir = path.join(cwd, "research");
+        if (!fs.existsSync(researchDir)) fs.mkdirSync(researchDir);
+        const planPath = path.join(researchDir, "plan.md");
+        if (!fs.existsSync(planPath)) {
+          fs.writeFileSync(planPath, `# Research Plan\n\n## Topic\n<!-- What are we researching? -->\n\n## Sub-topics to investigate\n<!-- Pi: list each angle you will cover, one per line. Write a <topic>.md file for each. -->\n\n## Key questions to answer\n<!-- Pi: what specific questions must be answered by the end of this session? -->\n\n## Known starting points\n<!-- Pi: any URLs, files, or repos already identified as relevant -->\n`, "utf8");
+        }
+        ctx.ui.notify(`[pi-init] research/plan.md created — Pi will fill this in before searching`, "info");
+      }
+
       ctx.ui.notify(`[pi-init] AGENTS.md (${type}) written to ${cwd}`, "info");
       ctx.ui.notify(getFollowUp(type), "info");
     },