spets 0.2.0 → 0.2.2

package/dist/{chunk-3QH66XVU.js → chunk-OIFVTELS.js}

@@ -12,6 +12,8 @@ import { join } from "path";
 import matter from "gray-matter";
 var KNOWLEDGE_DIR = "knowledge";
 var GUIDE_FILE = "guide.md";
+var MAX_SUMMARY_CHARS = 2e3;
+var MAX_KNOWLEDGE_CHARS = 8e3;
 function getKnowledgeDir(cwd = process.cwd()) {
   return join(getSpetsDir(cwd), KNOWLEDGE_DIR);
 }
@@ -58,10 +60,21 @@ function saveKnowledge(filename, content, source, cwd = process.cwd()) {
   ensureKnowledgeDir(cwd);
   const knowledgeDir = getKnowledgeDir(cwd);
   const filePath = join(knowledgeDir, `${filename}.md`);
+  let createdAt = (/* @__PURE__ */ new Date()).toISOString();
+  if (existsSync(filePath)) {
+    const existing = readFileSync(filePath, "utf-8");
+    const { data } = matter(existing);
+    if (data.createdAt) {
+      createdAt = data.createdAt;
+    }
+  }
   const frontmatter = {
     source,
-    createdAt: (/* @__PURE__ */ new Date()).toISOString()
+    createdAt
   };
+  if (existsSync(filePath)) {
+    frontmatter.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  }
   const fileContent = matter.stringify(content, frontmatter);
   writeFileSync(filePath, fileContent);
 }
@@ -75,21 +88,69 @@ function loadGuide(cwd = process.cwd()) {
   const { content } = matter(fileContent);
   return content.trim();
 }
-function buildAvailableKnowledgeSection(cwd = process.cwd()) {
+function knowledgePriority(filename) {
+  if (filename.startsWith("rule--")) return 0;
+  if (filename.startsWith("pattern--")) return 1;
+  if (filename.startsWith("pref--")) return 2;
+  return 3;
+}
+function buildKnowledgeSummarySection(cwd = process.cwd()) {
   const files = listKnowledgeFiles(cwd);
   if (files.length === 0) {
     return "";
   }
+  const sorted = [...files].sort((a, b) => knowledgePriority(a) - knowledgePriority(b));
+  const lines = [];
+  let charCount = 0;
+  let truncated = 0;
+  for (const filename of sorted) {
+    const entry = loadKnowledgeFile(filename, cwd);
+    const firstLine = entry?.content.split("\n")[0]?.trim() || "";
+    const line = `- ${filename}: ${firstLine}`;
+    if (charCount + line.length > MAX_SUMMARY_CHARS) {
+      truncated = sorted.length - lines.length;
+      break;
+    }
+    lines.push(line);
+    charCount += line.length;
+  }
   const parts = [];
-  parts.push("## Available Knowledge");
+  parts.push("## Knowledge Summary");
   parts.push("");
-  parts.push("\uB2E4\uC74C \uC9C0\uC2DD \uD30C\uC77C\uB4E4\uC774 \uC774 \uD504\uB85C\uC81D\uD2B8\uC5D0 \uC800\uC7A5\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4:");
-  for (const file of files) {
-    parts.push(`- ${file}`);
+  parts.push("\uC774 \uD504\uB85C\uC81D\uD2B8\uC5D0 \uC800\uC7A5\uB41C \uC9C0\uC2DD:");
+  parts.push("");
+  parts.push(...lines);
+  if (truncated > 0) {
+    parts.push(`- ... and ${truncated} more`);
   }
   parts.push("");
-  parts.push("\uD604\uC7AC \uD0DC\uC2A4\uD06C\uC5D0 \uCC38\uACE0\uD560 \uC9C0\uC2DD\uC774 \uC788\uB2E4\uBA74 JSON \uCD9C\uB825\uC758 `knowledgeRequests` \uD544\uB4DC\uC5D0 \uD30C\uC77C\uBA85\uC744 \uCD94\uAC00\uD558\uC138\uC694.");
+  return parts.join("\n");
+}
+function buildBudgetedKnowledgeSection(entries, heading = "## Loaded Knowledge") {
+  if (entries.length === 0) {
+    return "";
+  }
+  const parts = [];
+  parts.push(heading);
   parts.push("");
+  let charCount = 0;
+  for (const entry of entries) {
+    const section = `### ${entry.filename}
+
+${entry.content}
+`;
+    if (charCount + section.length > MAX_KNOWLEDGE_CHARS) {
+      const remaining = entries.length - parts.filter((p) => p.startsWith("### ")).length;
+      if (remaining > 0) {
+        parts.push(`
+*... ${remaining} more entries truncated due to budget*
+`);
+      }
+      break;
+    }
+    parts.push(section);
+    charCount += section.length;
+  }
   return parts.join("\n");
 }
 
@@ -210,7 +271,8 @@ export {
   loadKnowledgeFiles,
   saveKnowledge,
   loadGuide,
-  buildAvailableKnowledgeSection,
+  buildKnowledgeSummarySection,
+  buildBudgetedKnowledgeSection,
   renderKnowledgeJSON,
   runKnowledgeInteractive
 };

package/dist/index.js

@@ -22,7 +22,8 @@ import {
   runDocsInteractive
 } from "./chunk-3JIHGW47.js";
 import {
-  buildAvailableKnowledgeSection,
+  buildBudgetedKnowledgeSection,
+  buildKnowledgeSummarySection,
   getKnowledgeDir,
   listKnowledgeFiles,
   loadGuide,
@@ -31,7 +32,7 @@ import {
   renderKnowledgeJSON,
   runKnowledgeInteractive,
   saveKnowledge
-} from "./chunk-3QH66XVU.js";
+} from "./chunk-OIFVTELS.js";
 import {
   clearConfigCache,
   getConfigPath,
@@ -272,62 +273,37 @@ async function listPlugins() {
 function getClaudeSkillContent() {
   return `# Spets Executor
 
-You execute spets orchestrator commands. Parse JSON, follow instructions, repeat.
+You execute spets workflow commands. Follow orchestrator instructions exactly.
 
 ## Startup
 
 IF \`$ARGUMENTS\` starts with "resume":
-  1. RUN \`npx spets orchestrate resume\`
+  RUN \`npx spets orchestrate resume\`
+ELSE IF \`$ARGUMENTS\` starts with "list":
+  RUN \`npx spets orchestrate list\`
 ELSE:
-  1. RUN \`npx spets orchestrate init "$ARGUMENTS"\`
-
-Then GOTO **Loop**.
+  RUN \`npx spets orchestrate init "$ARGUMENTS"\`
 
 ## Loop
 
-1. PARSE JSON response
-2. SWITCH on \`type\`:
-
-### type="phase"
-  - EXECUTE what \`prompt\` says
-  - RUN \`onComplete\` with your output as JSON argument
-  - GOTO Loop
-
-### type="checkpoint", checkpoint="clarify"
-  - ASK user each decision in \`decisions[]\` using AskUserQuestion
-  - Format each decision as a question with its options
-  - RUN \`onComplete\` with \`[{decisionId, selectedOptionId}, ...]\`
-  - GOTO Loop
-
-### type="checkpoint", checkpoint="approve"
-  - READ \`specPath\`, summarize key points to user
-  - ASK user using AskUserQuestion with options: Approve / Revise / Reject / Stop
-  - RUN matching \`onComplete\` based on user's choice
-  - GOTO Loop
-
-### type="checkpoint", checkpoint="knowledge"
-  - Show \`suggestedKnowledge[]\` to user
-  - ASK user if they want to save, modify, or skip
-  - If save: RUN \`onComplete\` with entries JSON
-  - If skip: RUN \`onSkip\`
-  - GOTO Loop
+1. Parse the JSON response
+2. Read the \`instructions\` field
+3. Follow the instructions exactly
+4. Repeat until the response says to stop
 
-### type="list"
-  - Show \`tasks[]\` to user with taskId, description, status, currentStep
-  - ASK user which task to resume
-  - RUN \`npx spets orchestrate resume <selectedTaskId>\`
-  - GOTO Loop
+## Rules
 
-### type="complete" or "error"
-  - PRINT message
-  - STOP
+- NEVER skip or modify orchestrator commands
+- NEVER improvise steps \u2014 only do what instructions say
+- Always pass JSON output as a single-quoted string argument
+- Minify JSON when passing as command arguments
 
 ## Forbidden
 
 EnterPlanMode, TaskCreate, TaskUpdate
 
 $ARGUMENTS
-description: Task description for the workflow (or "resume" to continue a previous workflow)
+description: Task description for the workflow (or "resume" to list/continue previous workflows)
 `;
 }
 function getCodexSkillContent() {
@@ -338,65 +314,37 @@ description: SDD workflow executor - orchestrator-controlled spec-driven develop
 
 # Spets Executor
 
-You execute spets orchestrator commands. Parse JSON, follow instructions, repeat.
+You execute spets workflow commands. Follow orchestrator instructions exactly.
 
 ## Startup
 
 IF \`$ARGUMENTS\` starts with "resume":
-  1. RUN \`npx spets orchestrate resume\`
+  RUN \`npx spets orchestrate resume\`
+ELSE IF \`$ARGUMENTS\` starts with "list":
+  RUN \`npx spets orchestrate list\`
 ELSE:
-  1. RUN \`npx spets orchestrate init "$ARGUMENTS"\`
-
-Then GOTO **Loop**.
+  RUN \`npx spets orchestrate init "$ARGUMENTS"\`
 
 ## Loop
 
-1. PARSE JSON response
-2. SWITCH on \`type\`:
-
-### type="phase"
-  - EXECUTE what \`prompt\` says
-  - RUN \`onComplete\` with your output as minified JSON argument
-  - GOTO Loop
-
-### type="checkpoint", checkpoint="clarify"
-  - FORMAT decisions as table for user:
-    | # | Decision | Context | Options |
-    |---|----------|---------|---------|
-    | d1 | ... | ... | 1. ... 2. ... |
-  - ASK user to pick an option for each decision
-  - RUN \`onComplete\` with \`[{decisionId, selectedOptionId}, ...]\`
-  - GOTO Loop
-
-### type="checkpoint", checkpoint="approve"
-  - READ \`specPath\`, summarize key points to user
-  - ASK user with options: Approve / Revise / Reject / Stop
-  - RUN matching \`onComplete\` based on user's choice
-  - GOTO Loop
-
-### type="checkpoint", checkpoint="knowledge"
-  - Show \`suggestedKnowledge[]\` to user
-  - ASK user if they want to save, modify, or skip
-  - If save: RUN \`onComplete\` with entries JSON
-  - If skip: RUN \`onSkip\`
-  - GOTO Loop
+1. Parse the JSON response
+2. Read the \`instructions\` field
+3. Follow the instructions exactly
+4. Repeat until the response says to stop
 
-### type="list"
-  - Show \`tasks[]\` to user with taskId, description, status, currentStep
-  - ASK user which task to resume
-  - RUN \`npx spets orchestrate resume <selectedTaskId>\`
-  - GOTO Loop
+## Rules
 
-### type="complete" or "error"
-  - PRINT message
-  - STOP
+- NEVER skip or modify orchestrator commands
+- NEVER improvise steps \u2014 only do what instructions say
+- Always pass JSON output as a single-quoted string argument
+- Minify JSON when passing as command arguments
 
 ## Forbidden
 
 Planning mode, task tracking tools
 
 $ARGUMENTS
-description: Task description for the workflow (or "resume" to continue a previous workflow)
+description: Task description for the workflow (or "resume" to list/continue previous workflows)
 `;
 }
 function getGeminiSkillContent() {
@@ -407,61 +355,37 @@ description: SDD workflow executor - orchestrator-controlled spec-driven develop
 
 # Spets Executor
 
-You execute spets orchestrator commands. Parse JSON, follow instructions, repeat.
+You execute spets workflow commands. Follow orchestrator instructions exactly.
 
 ## Startup
 
 IF \`$ARGUMENTS\` starts with "resume":
-  1. RUN \`npx spets orchestrate resume\`
+  RUN \`npx spets orchestrate resume\`
+ELSE IF \`$ARGUMENTS\` starts with "list":
+  RUN \`npx spets orchestrate list\`
 ELSE:
-  1. RUN \`npx spets orchestrate init "$ARGUMENTS"\`
-
-Then GOTO **Loop**.
+  RUN \`npx spets orchestrate init "$ARGUMENTS"\`
 
 ## Loop
 
-1. PARSE JSON response
-2. SWITCH on \`type\`:
-
-### type="phase"
-  - EXECUTE what \`prompt\` says
-  - RUN \`onComplete\` with your output as JSON argument
-  - GOTO Loop
-
-### type="checkpoint", checkpoint="clarify"
-  - ASK user each decision in \`decisions[]\`
-  - RUN \`onComplete\` with \`[{decisionId, selectedOptionId}, ...]\`
-  - GOTO Loop
-
-### type="checkpoint", checkpoint="approve"
-  - READ \`specPath\`, summarize key points to user
-  - ASK user with options: Approve / Revise / Reject / Stop
-  - RUN matching \`onComplete\` based on user's choice
-  - GOTO Loop
-
-### type="checkpoint", checkpoint="knowledge"
-  - Show \`suggestedKnowledge[]\` to user
-  - ASK user if they want to save, modify, or skip
-  - If save: RUN \`onComplete\` with entries JSON
-  - If skip: RUN \`onSkip\`
-  - GOTO Loop
+1. Parse the JSON response
+2. Read the \`instructions\` field
+3. Follow the instructions exactly
+4. Repeat until the response says to stop
 
-### type="list"
-  - Show \`tasks[]\` to user with taskId, description, status, currentStep
-  - ASK user which task to resume
-  - RUN \`npx spets orchestrate resume <selectedTaskId>\`
-  - GOTO Loop
+## Rules
 
-### type="complete" or "error"
-  - PRINT message
-  - STOP
+- NEVER skip or modify orchestrator commands
+- NEVER improvise steps \u2014 only do what instructions say
+- Always pass JSON output as a single-quoted string argument
+- Minify JSON when passing as command arguments
 
 ## Forbidden
 
 Planning mode, task tracking tools
 
 $ARGUMENTS
-description: Task description for the workflow (or "resume" to continue a previous workflow)
+description: Task description for the workflow (or "resume" to list/continue previous workflows)
 `;
 }
 
@@ -503,19 +427,26 @@ async function initCommand(options) {
   const hookTemplate = join2(__dirname, "..", "templates", "hooks", "cleanup-branch.sh");
   if (existsSync2(hookTemplate)) {
     const hookDest = join2(spetsDir, "hooks", "cleanup-branch.sh");
-    cpSync(hookTemplate, hookDest);
-    try {
-      execSync(`chmod +x "${hookDest}"`);
-    } catch {
+    if (!existsSync2(hookDest)) {
+      cpSync(hookTemplate, hookDest);
+      try {
+        execSync(`chmod +x "${hookDest}"`);
+      } catch {
+      }
     }
   }
   const knowledgeGuideTemplate = join2(__dirname, "..", "templates", "knowledge", "guide.md");
   if (existsSync2(knowledgeGuideTemplate)) {
     const guideDest = join2(spetsDir, "knowledge", "guide.md");
-    cpSync(knowledgeGuideTemplate, guideDest);
+    if (!existsSync2(guideDest)) {
+      cpSync(knowledgeGuideTemplate, guideDest);
+    }
   }
   const githubInfo = getGitHubInfoFromRemote();
-  writeFileSync2(join2(spetsDir, "config.yml"), getDefaultConfig(githubInfo));
+  const configPath = join2(spetsDir, "config.yml");
+  if (!existsSync2(configPath)) {
+    writeFileSync2(configPath, getDefaultConfig(githubInfo));
+  }
   createDefaultSteps(spetsDir);
   createClaudeCommand(cwd);
   printEnhancedInitOutput(options);
@@ -739,20 +670,23 @@ async function runInteractiveSetup(cwd, spetsDir, options) {
   const hookTemplate = join2(__dirname, "..", "templates", "hooks", "cleanup-branch.sh");
   if (existsSync2(hookTemplate)) {
     const hookDest = join2(spetsDir, "hooks", "cleanup-branch.sh");
-    cpSync(hookTemplate, hookDest);
-    try {
-      execSync(`chmod +x "${hookDest}"`);
-    } catch {
+    if (!existsSync2(hookDest)) {
+      cpSync(hookTemplate, hookDest);
+      try {
+        execSync(`chmod +x "${hookDest}"`);
+      } catch {
+      }
     }
   }
   const knowledgeGuideTemplate = join2(__dirname, "..", "templates", "knowledge", "guide.md");
-  if (existsSync2(knowledgeGuideTemplate)) {
-    cpSync(knowledgeGuideTemplate, join2(spetsDir, "knowledge", "guide.md"));
+  const guideDest = join2(spetsDir, "knowledge", "guide.md");
+  if (existsSync2(knowledgeGuideTemplate) && !existsSync2(guideDest)) {
+    cpSync(knowledgeGuideTemplate, guideDest);
+  }
+  const configPath = join2(spetsDir, "config.yml");
+  if (!existsSync2(configPath)) {
+    writeFileSync2(configPath, getDefaultConfig(githubInfo, { agent, githubEnabled }));
   }
-  writeFileSync2(
-    join2(spetsDir, "config.yml"),
-    getDefaultConfig(githubInfo, { agent, githubEnabled })
-  );
   createDefaultSteps(spetsDir);
   createClaudeCommand(cwd);
   if (githubEnabled && githubInfo) {
@@ -764,10 +698,16 @@ async function runInteractiveSetup(cwd, spetsDir, options) {
 function createDefaultSteps(spetsDir) {
   const planDir = join2(spetsDir, "steps", "01-plan");
   mkdirSync2(planDir, { recursive: true });
-  writeFileSync2(join2(planDir, "template.md"), getPlanTemplate());
+  const planTemplatePath = join2(planDir, "template.md");
+  if (!existsSync2(planTemplatePath)) {
+    writeFileSync2(planTemplatePath, getPlanTemplate());
+  }
   const implementDir = join2(spetsDir, "steps", "02-implement");
   mkdirSync2(implementDir, { recursive: true });
-  writeFileSync2(join2(implementDir, "template.md"), getImplementTemplate());
+  const implementTemplatePath = join2(implementDir, "template.md");
+  if (!existsSync2(implementTemplatePath)) {
+    writeFileSync2(implementTemplatePath, getImplementTemplate());
+  }
 }
 function getPlanTemplate() {
   const fullTemplate = readFileSync(join2(__dirname, "..", "templates", "steps", "01-plan", "template.md"), "utf-8");
@@ -1045,7 +985,7 @@ function buildExplorePrompt(params) {
   parts.push("");
   const config = loadConfig(cwd);
   if (config.knowledge?.inject !== false) {
-    const knowledgeSection = buildAvailableKnowledgeSection(cwd);
+    const knowledgeSection = buildKnowledgeSummarySection(cwd);
     if (knowledgeSection) {
       parts.push(knowledgeSection);
     }
@@ -1125,6 +1065,7 @@ function buildExploreTeamSection() {
 
 // src/core/prompts/clarify.ts
 function buildClarifyPrompt(params) {
+  const cwd = params.cwd || process.cwd();
   const parts = [];
   parts.push("# Clarify Phase");
   parts.push("");
@@ -1141,6 +1082,13 @@ function buildClarifyPrompt(params) {
   parts.push("");
   parts.push(params.gatheredContext);
   parts.push("");
+  const config = loadConfig(cwd);
+  if (config.knowledge?.inject !== false) {
+    const knowledgeSection = buildKnowledgeSummarySection(cwd);
+    if (knowledgeSection) {
+      parts.push(knowledgeSection);
+    }
+  }
   if (params.loadedKnowledge && params.loadedKnowledge.length > 0) {
     parts.push("## Requested Knowledge");
     parts.push("");
@@ -1408,6 +1356,12 @@ function buildExecutePrompt(params) {
     }
     parts.push("");
   }
+  if (config.knowledge?.inject !== false) {
+    const knowledgeSection = buildKnowledgeSummarySection(cwd);
+    if (knowledgeSection) {
+      parts.push(knowledgeSection);
+    }
+  }
   if (params.loadedKnowledge && params.loadedKnowledge.length > 0) {
     parts.push("### Referenced Knowledge");
     parts.push("");
@@ -1518,6 +1472,20 @@ function buildVerifyPrompt(params) {
     parts.push(template);
     parts.push("");
   }
+  const config = loadConfig(cwd);
+  if (config.knowledge?.inject !== false) {
+    const knowledgeSection = buildKnowledgeSummarySection(cwd);
+    if (knowledgeSection) {
+      parts.push(knowledgeSection);
+    }
+  }
+  if (params.loadedKnowledge && params.loadedKnowledge.length > 0) {
+    const knowledgeContent = buildBudgetedKnowledgeSection(params.loadedKnowledge);
+    if (knowledgeContent) {
+      parts.push(knowledgeContent);
+      parts.push("");
+    }
+  }
   parts.push("## Verification Criteria");
   parts.push("");
   parts.push("1. **Accuracy** (0-100)");
@@ -1542,7 +1510,6 @@ function buildVerifyPrompt(params) {
   parts.push("");
   parts.push("If it fails, the output will be automatically revised (up to 3 attempts).");
   parts.push("");
-  const config = loadConfig(cwd);
   if (config.team?.enabled) {
     parts.push(buildVerifyTeamSection());
   }
@@ -1663,6 +1630,20 @@ function buildKnowledgeExtractPrompt(params) {
       parts.push("");
     }
   }
+  const cwd = params.cwd || process.cwd();
+  const existingFiles = listKnowledgeFiles(cwd);
+  if (existingFiles.length > 0) {
+    parts.push("## Existing Knowledge Entries");
+    parts.push("");
+    parts.push("\uB2E4\uC74C \uC9C0\uC2DD\uC774 \uC774\uBBF8 \uC800\uC7A5\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4. \uACB9\uCE58\uB294 \uB0B4\uC6A9\uC740 update, \uC0C8\uB85C\uC6B4 \uAC83\uB9CC create \uD558\uC138\uC694:");
+    parts.push("");
+    for (const filename of existingFiles) {
+      const entry = loadKnowledgeFile(filename, cwd);
+      const firstLine = entry?.content.split("\n")[0]?.trim() || "";
+      parts.push(`- **${filename}**: ${firstLine}`);
+    }
+    parts.push("");
+  }
   parts.push("## Your Task");
   parts.push("");
   parts.push("Extract knowledge that would be useful for future workflows:");
@@ -1678,6 +1659,10 @@ function buildKnowledgeExtractPrompt(params) {
   parts.push("- One-time decisions");
   parts.push("- Temporary workarounds");
   parts.push("");
+  parts.push("**Update or Create:**");
+  parts.push('- If an existing entry covers the same topic, use `"action": "update"` with the same filename');
+  parts.push('- Only use `"action": "create"` for genuinely new knowledge');
+  parts.push("");
   parts.push("## Output Format");
   parts.push("");
   parts.push("Output a JSON object with this structure:");
@@ -1688,7 +1673,8 @@ function buildKnowledgeExtractPrompt(params) {
   parts.push("    {");
   parts.push('      "filename": "pattern--error-handling",');
   parts.push('      "content": "The knowledge content in markdown format...",');
-  parts.push('      "reason": "Why this is worth saving"');
+  parts.push('      "reason": "Why this is worth saving",');
+  parts.push('      "action": "create"');
   parts.push("    }");
   parts.push("  ]");
   parts.push("}");
@@ -1706,6 +1692,36 @@ function buildKnowledgeExtractPrompt(params) {
   return parts.join("\n");
 }
 
+// src/orchestrator/instructions.ts
+function phaseWithJsonOutput(onComplete) {
+  return `Execute the prompt. Then run:
+  ${onComplete} '<your_json_output>'`;
+}
+function phaseExecute(outputFile, onComplete) {
+  return `Execute the prompt \u2014 write the document to ${outputFile}. Then run:
+  ${onComplete}`;
+}
+function checkpointClarify(onComplete) {
+  return [
+    `Present each decision to the user with its options. Collect their choices. Then run:`,
+    `  ${onComplete} '<answers_json>'`,
+    `Answer format: [{decisionId, selectedOptionId, customInput?}, ...]`
+  ].join("\n");
+}
+function checkpointApprove(specPath, cmds) {
+  return [
+    `Read the document at ${specPath}. Summarize key points to the user. Ask: Approve / Revise / Reject / Stop. Then run the matching command:`,
+    `  approve: ${cmds.approve}`,
+    `  revise: ${cmds.revise}`,
+    `  reject: ${cmds.reject}`,
+    `  stop: ${cmds.stop}`
+  ].join("\n");
+}
+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_EMPTY = "No resumable tasks found. Show this to the user. Stop.";
+
 // src/orchestrator/responses.ts
 function buildPhaseExploreResponse(cwd, state) {
   const steps = getSteps(cwd);
@@ -1727,6 +1743,7 @@ function buildPhaseExploreResponse(cwd, state) {
     previousOutput,
     cwd
   });
+  const onComplete = `npx spets orchestrate explore-done ${state.taskId}`;
   return {
     type: "phase",
     phase: "explore",
@@ -1739,7 +1756,8 @@ function buildPhaseExploreResponse(cwd, state) {
     context: {
       previousOutput
     },
-    onComplete: `npx spets orchestrate explore-done ${state.taskId}`
+    onComplete,
+    instructions: phaseWithJsonOutput(onComplete)
   };
 }
 function buildPhaseClarifyResponse(cwd, state) {
@@ -1754,6 +1772,7 @@ function buildPhaseClarifyResponse(cwd, state) {
     // Legacy support
     cwd
   });
+  const onComplete = `npx spets orchestrate clarify-done ${state.taskId}`;
   return {
     type: "phase",
     phase: "clarify",
@@ -1765,7 +1784,8 @@ function buildPhaseClarifyResponse(cwd, state) {
     previousDecisions: state.decisionHistory,
     previousQA: state.qaHistory,
     // Legacy support
-    onComplete: `npx spets orchestrate clarify-done ${state.taskId}`
+    onComplete,
+    instructions: phaseWithJsonOutput(onComplete)
   };
 }
 function buildPhaseExecuteResponse(cwd, state) {
@@ -1808,6 +1828,8 @@ ${issues}`;
     verifyFeedback,
     cwd
   });
+  const onComplete = `npx spets orchestrate execute-done ${state.taskId}`;
+  const outputFile = join9(outputPath, state.taskId, `${state.currentStep}.md`);
   return {
     type: "phase",
     phase: "execute",
@@ -1822,11 +1844,12 @@ ${issues}`;
     context: {
       template: hasTemplate ? templatePath : void 0,
       previousOutput,
-      output: join9(outputPath, state.taskId, `${state.currentStep}.md`),
+      output: outputFile,
       revisionFeedback: state.revisionFeedback,
       verifyFeedback
     },
-    onComplete: `npx spets orchestrate execute-done ${state.taskId}`
+    onComplete,
+    instructions: phaseExecute(outputFile, onComplete)
   };
 }
 function buildPhaseVerifyResponse(cwd, state) {
@@ -1842,8 +1865,10 @@ function buildPhaseVerifyResponse(cwd, state) {
     totalSteps: state.totalSteps,
     documentPath,
     verifyAttempts: state.verifyAttempts || 1,
+    loadedKnowledge: state.loadedKnowledge?.map((k) => ({ filename: k.filename, content: k.content })),
     cwd
   });
+  const onComplete = `npx spets orchestrate verify-done ${state.taskId}`;
   return {
     type: "phase",
     phase: "verify",
@@ -1859,7 +1884,8 @@ function buildPhaseVerifyResponse(cwd, state) {
       template: hasTemplate ? templatePath : void 0,
       document: documentPath
     },
-    onComplete: `npx spets orchestrate verify-done ${state.taskId}`
+    onComplete,
+    instructions: phaseWithJsonOutput(onComplete)
   };
 }
 function buildPhaseKnowledgeResponse(cwd, state) {
@@ -1872,6 +1898,7 @@ function buildPhaseKnowledgeResponse(cwd, state) {
     guide,
     cwd
   });
+  const onComplete = `npx spets orchestrate knowledge-extract-done ${state.taskId}`;
   return {
     type: "phase",
     phase: "knowledge",
@@ -1884,21 +1911,31 @@ function buildPhaseKnowledgeResponse(cwd, state) {
       totalSteps: state.totalSteps
     },
     guide,
-    onComplete: `npx spets orchestrate knowledge-extract-done ${state.taskId}`
+    onComplete,
+    instructions: phaseWithJsonOutput(onComplete)
   };
 }
 function buildCheckpointClarifyResponse(state) {
+  const onComplete = `npx spets orchestrate clarified ${state.taskId}`;
   return {
     type: "checkpoint",
     checkpoint: "clarify",
     taskId: state.taskId,
     step: state.currentStep,
     decisions: state.decisions || [],
-    onComplete: `npx spets orchestrate clarified ${state.taskId} '<answers_json>'`
+    onComplete: `${onComplete} '<answers_json>'`,
+    instructions: checkpointClarify(onComplete)
   };
 }
 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}`
+  };
   return {
     type: "checkpoint",
     checkpoint: "approve",
@@ -1906,14 +1943,10 @@ function buildCheckpointApproveResponse(cwd, state) {
     step: state.currentStep,
     stepIndex: state.stepIndex,
     totalSteps: state.totalSteps,
-    specPath: join9(outputPath, state.taskId, `${state.currentStep}.md`),
+    specPath,
     options: ["approve", "revise", "reject", "stop"],
-    onComplete: {
-      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}`
-    }
+    onComplete: cmds,
+    instructions: checkpointApprove(specPath, cmds)
   };
 }
 function buildCompleteResponse(cwd, state, status) {
@@ -1936,11 +1969,12 @@ function buildCompleteResponse(cwd, state, status) {
     status,
     taskId: state.taskId,
     outputs,
-    message: messages[status]
+    message: messages[status],
+    instructions: PRINT_MESSAGE_AND_STOP
   };
 }
 function buildErrorResponse(error, taskId, step) {
-  const response = { type: "error", error };
+  const response = { type: "error", error, instructions: PRINT_ERROR_AND_STOP };
   if (taskId) response.taskId = taskId;
   if (step) response.step = step;
   return response;
@@ -2282,7 +2316,7 @@ var Orchestrator = class {
     const outputPath = getOutputPath(this.cwd);
     const tasks = [];
     if (!existsSync11(outputPath)) {
-      return { type: "list", tasks: [] };
+      return { type: "list", tasks: [], instructions: LIST_EMPTY };
     }
     const dirs = readdirSync2(outputPath, { withFileTypes: true }).filter((d) => d.isDirectory());
     for (const dir of dirs) {
@@ -2304,7 +2338,11 @@ var Orchestrator = class {
       const bTime = b.updatedAt ? new Date(b.updatedAt).getTime() : 0;
       return bTime - aTime;
     });
-    return { type: "list", tasks };
+    return {
+      type: "list",
+      tasks,
+      instructions: tasks.length > 0 ? LIST_TASKS : LIST_EMPTY
+    };
   }
   /**
    * Get current workflow status
@@ -2446,7 +2484,8 @@ function parseKnowledgeOutput(response) {
         entries: entries.map((e) => ({
           filename: e.filename || "",
           content: e.content || "",
-          reason: e.reason || ""
+          reason: e.reason || "",
+          action: e.action === "update" ? "update" : "create"
         }))
       };
     }
@@ -2458,7 +2497,8 @@ function parseKnowledgeOutput(response) {
           entries: parsed.map((e) => ({
             filename: e.filename || "",
             content: e.content || "",
-            reason: e.reason || ""
+            reason: e.reason || "",
+            action: e.action === "update" ? "update" : "create"
           }))
         };
       }
@@ -5861,7 +5901,7 @@ async function uiKnowledgeCommand(entryName, options) {
     console.log(renderKnowledgeJSON(void 0, cwd));
     return;
   }
-  const { runKnowledgeInteractive: runKnowledgeInteractive2 } = await import("./knowledge-QC6464NS.js");
+  const { runKnowledgeInteractive: runKnowledgeInteractive2 } = await import("./knowledge-TVXZATJX.js");
   await runKnowledgeInteractive2(cwd);
 }
 

package/dist/{knowledge-QC6464NS.js → knowledge-TVXZATJX.js}

@@ -1,7 +1,7 @@
 import {
   renderKnowledgeJSON,
   runKnowledgeInteractive
-} from "./chunk-3QH66XVU.js";
+} from "./chunk-OIFVTELS.js";
 import "./chunk-2MUV3F53.js";
 export {
   renderKnowledgeJSON,

package/package.json

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

package/templates/knowledge/guide.md

@@ -27,6 +27,12 @@
   - `pattern--` : 코드 패턴 (예: `pattern--error-handling`)
   - prefix 없이 사용해도 무방
 
+## Update or Create
+
+- 기존 파일과 겹치는 내용이면 `"action": "update"`로 업데이트
+- 새로운 지식이면 `"action": "create"`로 생성
+- 중복 파일이 누적되지 않도록 기존 항목을 확인하세요
+
 ## 예시
 
 ```