spets 0.2.8 → 0.2.9

package/README.md

@@ -140,6 +140,15 @@ agent: gemini  # or claude, codex
   - Gemini CLI (`gemini` command)
   - Codex CLI (`codex` command)
 
+## Troubleshooting: `npm EPERM` with `npx`
+
+If `npx spets ...` fails with permission errors like `~/.npm/_logs`, run with a project-local npm cache:
+
+```bash
+NPM_CONFIG_CACHE=.spets/.npm-cache npm_config_cache=.spets/.npm-cache npx --yes spets init
+NPM_CONFIG_CACHE=.spets/.npm-cache npm_config_cache=.spets/.npm-cache npx --yes spets plugin install codex
+```
+
 ## License
 
 MIT

package/dist/index.js

@@ -365,6 +365,7 @@ function formatDocStatus(status) {
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2, rmSync, readdirSync } from "fs";
 import { join as join2 } from "path";
 import { homedir } from "os";
+var INSTALLED_SPETS_CMD = "spets";
 async function pluginCommand(action, name) {
   switch (action) {
     case "install":
@@ -588,11 +589,11 @@ You execute spets workflow commands. Follow orchestrator instructions exactly.
 
 IF \`$ARGUMENTS\` starts with "resume":
   Extract optional task ID from arguments (e.g. "resume abc-123" or "resume --task abc-123")
-  RUN \`npx --yes spets orchestrate resume <taskId>\` (omit taskId if none provided)
+  RUN \`${INSTALLED_SPETS_CMD} orchestrate resume <taskId>\` (omit taskId if none provided)
 ELSE IF \`$ARGUMENTS\` starts with "list":
-  RUN \`npx --yes spets orchestrate list\`
+  RUN \`${INSTALLED_SPETS_CMD} orchestrate list\`
 ELSE:
-  RUN \`npx --yes spets orchestrate init "$ARGUMENTS"\`
+  RUN \`${INSTALLED_SPETS_CMD} orchestrate init "$ARGUMENTS"\`
 
 ## Loop
 
@@ -630,11 +631,11 @@ You execute spets workflow commands. Follow orchestrator instructions exactly.
 
 IF \`$ARGUMENTS\` starts with "resume":
   Extract optional task ID from arguments (e.g. "resume abc-123" or "resume --task abc-123")
-  RUN \`node dist/index.js orchestrate resume <taskId> || npx --yes spets orchestrate resume <taskId>\` (omit taskId if none provided)
+  RUN \`node dist/index.js orchestrate resume <taskId> || ${INSTALLED_SPETS_CMD} orchestrate resume <taskId>\` (omit taskId if none provided)
 ELSE IF \`$ARGUMENTS\` starts with "list":
-  RUN \`node dist/index.js orchestrate list || npx --yes spets orchestrate list\`
+  RUN \`node dist/index.js orchestrate list || ${INSTALLED_SPETS_CMD} orchestrate list\`
 ELSE:
-  RUN \`node dist/index.js orchestrate init "$ARGUMENTS" || npx --yes spets orchestrate init "$ARGUMENTS"\`
+  RUN \`node dist/index.js orchestrate init "$ARGUMENTS" || ${INSTALLED_SPETS_CMD} orchestrate init "$ARGUMENTS"\`
 
 ## Loop
 
@@ -672,11 +673,11 @@ You execute spets workflow commands. Follow orchestrator instructions exactly.
 
 IF \`$ARGUMENTS\` starts with "resume":
   Extract optional task ID from arguments (e.g. "resume abc-123" or "resume --task abc-123")
-  RUN \`npx --yes spets orchestrate resume <taskId>\` (omit taskId if none provided)
+  RUN \`${INSTALLED_SPETS_CMD} orchestrate resume <taskId>\` (omit taskId if none provided)
 ELSE IF \`$ARGUMENTS\` starts with "list":
-  RUN \`npx --yes spets orchestrate list\`
+  RUN \`${INSTALLED_SPETS_CMD} orchestrate list\`
 ELSE:
-  RUN \`npx --yes spets orchestrate init "$ARGUMENTS"\`
+  RUN \`${INSTALLED_SPETS_CMD} orchestrate init "$ARGUMENTS"\`
 
 ## Loop
 
@@ -1496,7 +1497,7 @@ function checkpointApprove(specPath, cmds) {
 }
 var PRINT_MESSAGE_AND_STOP = "Print the message. Stop.";
 var PRINT_ERROR_AND_STOP = "Print the error. Stop.";
-var LIST_TASKS = "Show tasks to user. Ask which to resume. Run:\n  npx spets orchestrate resume <selectedTaskId>";
+var LIST_TASKS = "Show tasks to user. Ask which to resume. Run:\n  spets orchestrate resume <selectedTaskId>";
 var LIST_EMPTY = "No resumable tasks found. Show this to the user. Stop.";
 
 // src/orchestrator/responses.ts
@@ -1510,7 +1511,7 @@ function getOrchestrateCommandPrefix() {
     const escapedPath = entryScript.includes(" ") ? `"${entryScript.replace(/"/g, '\\"')}"` : entryScript;
     return `node ${escapedPath} orchestrate`;
   }
-  return "npx --yes spets orchestrate";
+  return "spets orchestrate";
 }
 function buildOrchestrateCommand(args) {
   return `${getOrchestrateCommandPrefix()} ${args}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spets",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "Spec Driven Development Execution Framework",
   "type": "module",
   "main": "dist/index.js",