spets 0.2.7 → 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 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 spets orchestrate list\`
+  RUN \`${INSTALLED_SPETS_CMD} orchestrate list\`
 ELSE:
-  RUN \`npx 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 \`npx 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 \`npx spets orchestrate list\`
+  RUN \`node dist/index.js orchestrate list || ${INSTALLED_SPETS_CMD} orchestrate list\`
 ELSE:
-  RUN \`npx 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 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 spets orchestrate list\`
+  RUN \`${INSTALLED_SPETS_CMD} orchestrate list\`
 ELSE:
-  RUN \`npx spets orchestrate init "$ARGUMENTS"\`
+  RUN \`${INSTALLED_SPETS_CMD} orchestrate init "$ARGUMENTS"\`
 
 ## Loop
 
@@ -1496,10 +1497,25 @@ 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
+function getOrchestrateCommandPrefix() {
+  const override = process.env.SPETS_ORCHESTRATE_CMD?.trim();
+  if (override) {
+    return override;
+  }
+  const entryScript = process.argv[1];
+  if (entryScript && existsSync10(entryScript)) {
+    const escapedPath = entryScript.includes(" ") ? `"${entryScript.replace(/"/g, '\\"')}"` : entryScript;
+    return `node ${escapedPath} orchestrate`;
+  }
+  return "spets orchestrate";
+}
+function buildOrchestrateCommand(args) {
+  return `${getOrchestrateCommandPrefix()} ${args}`;
+}
 function buildPhaseExploreResponse(cwd, state) {
   const steps = getSteps(cwd);
   const outputPath = getOutputPath(cwd);
@@ -1520,7 +1536,7 @@ function buildPhaseExploreResponse(cwd, state) {
     previousOutput,
     cwd
   });
-  const onComplete = `npx spets orchestrate explore-done ${state.taskId}`;
+  const onComplete = buildOrchestrateCommand(`explore-done ${state.taskId}`);
   return {
     type: "phase",
     phase: "explore",
@@ -1549,7 +1565,7 @@ function buildPhaseClarifyResponse(cwd, state) {
     // Legacy support
     cwd
   });
-  const onComplete = `npx spets orchestrate clarify-done ${state.taskId}`;
+  const onComplete = buildOrchestrateCommand(`clarify-done ${state.taskId}`);
   return {
     type: "phase",
     phase: "clarify",
@@ -1605,7 +1621,7 @@ ${issues}`;
     verifyFeedback,
     cwd
   });
-  const onComplete = `npx spets orchestrate execute-done ${state.taskId}`;
+  const onComplete = buildOrchestrateCommand(`execute-done ${state.taskId}`);
   const outputFile = join9(outputPath, state.taskId, `${state.currentStep}.md`);
   return {
     type: "phase",
@@ -1645,7 +1661,7 @@ function buildPhaseVerifyResponse(cwd, state) {
     loadedKnowledge: state.loadedKnowledge?.map((k) => ({ filename: k.filename, content: k.content })),
     cwd
   });
-  const onComplete = `npx spets orchestrate verify-done ${state.taskId}`;
+  const onComplete = buildOrchestrateCommand(`verify-done ${state.taskId}`);
   return {
     type: "phase",
     phase: "verify",
@@ -1675,7 +1691,7 @@ function buildPhaseKnowledgeResponse(cwd, state) {
     guide,
     cwd
   });
-  const onComplete = `npx spets orchestrate knowledge-extract-done ${state.taskId}`;
+  const onComplete = buildOrchestrateCommand(`knowledge-extract-done ${state.taskId}`);
   return {
     type: "phase",
     phase: "knowledge",
@@ -1693,7 +1709,7 @@ function buildPhaseKnowledgeResponse(cwd, state) {
   };
 }
 function buildCheckpointClarifyResponse(state) {
-  const onComplete = `npx spets orchestrate clarified ${state.taskId}`;
+  const onComplete = buildOrchestrateCommand(`clarified ${state.taskId}`);
   return {
     type: "checkpoint",
     checkpoint: "clarify",
@@ -1708,10 +1724,10 @@ function buildCheckpointApproveResponse(cwd, state) {
   const outputPath = getOutputPath(cwd);
   const specPath = join9(outputPath, state.taskId, `${state.currentStep}.md`);
   const cmds = {
-    approve: `npx spets orchestrate approve ${state.taskId}`,
-    revise: `npx spets orchestrate revise ${state.taskId} '<feedback>'`,
-    reject: `npx spets orchestrate reject ${state.taskId}`,
-    stop: `npx spets orchestrate stop ${state.taskId}`
+    approve: buildOrchestrateCommand(`approve ${state.taskId}`),
+    revise: buildOrchestrateCommand(`revise ${state.taskId} '<feedback>'`),
+    reject: buildOrchestrateCommand(`reject ${state.taskId}`),
+    stop: buildOrchestrateCommand(`stop ${state.taskId}`)
   };
   return {
     type: "checkpoint",
@@ -1738,7 +1754,7 @@ function buildCompleteResponse(cwd, state, status) {
   }
   const messages = {
     completed: "Workflow completed successfully",
-    stopped: `Workflow stopped. Resume with: spets orchestrate resume ${state.taskId}`,
+    stopped: `Workflow stopped. Resume with: ${buildOrchestrateCommand(`resume ${state.taskId}`)}`,
     rejected: "Workflow rejected"
   };
   return {

package/package.json

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