spets 0.1.99 → 0.2.1

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,
@@ -274,29 +275,51 @@ function getClaudeSkillContent() {
 
 You execute spets orchestrator commands. Parse JSON, follow instructions, repeat.
 
-## Execution
+## Startup
 
-1. RUN \`npx spets orchestrate init "$ARGUMENTS"\`
-2. PARSE JSON response
-3. SWITCH on \`type\`:
+IF \`$ARGUMENTS\` starts with "resume":
+  1. RUN \`npx spets orchestrate resume\`
+ELSE:
+  1. RUN \`npx spets orchestrate init "$ARGUMENTS"\`
 
-type="phase":
+Then GOTO **Loop**.
+
+## Loop
+
+1. PARSE JSON response
+2. SWITCH on \`type\`:
+
+### type="phase"
   - EXECUTE what \`prompt\` says
   - RUN \`onComplete\` with your output as JSON argument
-  - GOTO step 2
+  - GOTO Loop
 
-type="checkpoint", checkpoint="clarify":
-  - ASK user each question in \`questions[]\` using AskUserQuestion
-  - RUN \`onComplete\` with \`[{questionId, answer}, ...]\`
-  - GOTO step 2
+### 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":
+### 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 step 2
+  - GOTO Loop
 
-type="complete" or "error":
+### 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
+
+### 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
+
+### type="complete" or "error"
   - PRINT message
   - STOP
 
@@ -305,7 +328,7 @@ type="complete" or "error":
 EnterPlanMode, TaskCreate, TaskUpdate
 
 $ARGUMENTS
-description: Task description for the workflow
+description: Task description for the workflow (or "resume" to continue a previous workflow)
 `;
 }
 function getCodexSkillContent() {
@@ -318,33 +341,54 @@ description: SDD workflow executor - orchestrator-controlled spec-driven develop
 
 You execute spets orchestrator commands. Parse JSON, follow instructions, repeat.
 
-## Execution
+## Startup
+
+IF \`$ARGUMENTS\` starts with "resume":
+  1. RUN \`npx spets orchestrate resume\`
+ELSE:
+  1. RUN \`npx spets orchestrate init "$ARGUMENTS"\`
 
-1. RUN \`npx spets orchestrate init "$ARGUMENTS"\`
-2. PARSE JSON response
-3. SWITCH on \`type\`:
+Then GOTO **Loop**.
 
-type="phase":
+## 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 step 2
+  - GOTO Loop
 
-type="checkpoint", checkpoint="clarify":
-  - FORMAT questions as table for user:
-    | # | Question | Context | Options |
+### type="checkpoint", checkpoint="clarify"
+  - FORMAT decisions as table for user:
+    | # | Decision | Context | Options |
     |---|----------|---------|---------|
-    | q1 | ... | ... | 1. ... 2. ... |
-  - ASK user to answer each question
-  - RUN \`onComplete\` with \`[{questionId, answer}, ...]\`
-  - GOTO step 2
+    | d1 | ... | ... | 1. ... 2. ... |
+  - ASK user to pick an option for each decision
+  - RUN \`onComplete\` with \`[{decisionId, selectedOptionId}, ...]\`
+  - GOTO Loop
 
-type="checkpoint", checkpoint="approve":
+### type="checkpoint", checkpoint="approve"
   - READ \`specPath\`, summarize key points to user
-  - ASK user using AskUserQuestion with options: Approve / Revise / Reject / Stop
+  - ASK user with options: Approve / Revise / Reject / Stop
   - RUN matching \`onComplete\` based on user's choice
-  - GOTO step 2
+  - 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
 
-type="complete" or "error":
+### 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
+
+### type="complete" or "error"
   - PRINT message
   - STOP
 
@@ -353,7 +397,7 @@ type="complete" or "error":
 Planning mode, task tracking tools
 
 $ARGUMENTS
-description: Task description for the workflow
+description: Task description for the workflow (or "resume" to continue a previous workflow)
 `;
 }
 function getGeminiSkillContent() {
@@ -366,29 +410,50 @@ description: SDD workflow executor - orchestrator-controlled spec-driven develop
 
 You execute spets orchestrator commands. Parse JSON, follow instructions, repeat.
 
-## Execution
+## Startup
+
+IF \`$ARGUMENTS\` starts with "resume":
+  1. RUN \`npx spets orchestrate resume\`
+ELSE:
+  1. RUN \`npx spets orchestrate init "$ARGUMENTS"\`
+
+Then GOTO **Loop**.
 
-1. RUN \`npx spets orchestrate init "$ARGUMENTS"\`
-2. PARSE JSON response
-3. SWITCH on \`type\`:
+## Loop
 
-type="phase":
+1. PARSE JSON response
+2. SWITCH on \`type\`:
+
+### type="phase"
   - EXECUTE what \`prompt\` says
   - RUN \`onComplete\` with your output as JSON argument
-  - GOTO step 2
+  - GOTO Loop
 
-type="checkpoint", checkpoint="clarify":
-  - ASK user each question in \`decisions[]\`
+### type="checkpoint", checkpoint="clarify"
+  - ASK user each decision in \`decisions[]\`
   - RUN \`onComplete\` with \`[{decisionId, selectedOptionId}, ...]\`
-  - GOTO step 2
+  - GOTO Loop
 
-type="checkpoint", checkpoint="approve":
+### 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 step 2
+  - 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
+
+### 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
 
-type="complete" or "error":
+### type="complete" or "error"
   - PRINT message
   - STOP
 
@@ -397,7 +462,7 @@ type="complete" or "error":
 Planning mode, task tracking tools
 
 $ARGUMENTS
-description: Task description for the workflow
+description: Task description for the workflow (or "resume" to continue a previous workflow)
 `;
 }
 
@@ -981,7 +1046,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);
     }
@@ -1061,6 +1126,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("");
@@ -1077,6 +1143,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("");
@@ -1344,6 +1417,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("");
@@ -1454,6 +1533,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)");
@@ -1478,7 +1571,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());
   }
@@ -1599,6 +1691,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:");
@@ -1614,6 +1720,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:");
@@ -1624,7 +1734,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("}");
@@ -1778,6 +1889,7 @@ function buildPhaseVerifyResponse(cwd, state) {
     totalSteps: state.totalSteps,
     documentPath,
     verifyAttempts: state.verifyAttempts || 1,
+    loadedKnowledge: state.loadedKnowledge?.map((k) => ({ filename: k.filename, content: k.content })),
     cwd
   });
   return {
@@ -2382,7 +2494,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"
         }))
       };
     }
@@ -2394,7 +2507,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"
           }))
         };
       }
@@ -5797,7 +5911,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.1.99",
+  "version": "0.2.1",
   "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"`로 생성
+- 중복 파일이 누적되지 않도록 기존 항목을 확인하세요
+
 ## 예시
 
 ```