autosnippet 3.2.3 → 3.2.6

package/lib/service/chat/memory/index.js

@@ -0,0 +1,13 @@
+/**
+ * Memory Module — 统一导出
+ *
+ * Phase 2: MemoryCoordinator + legacy module re-exports
+ * Phase 3: ActiveContext (合并 WorkingMemory + ReasoningTrace)
+ * Phase 4: SessionStore (合并 EpisodicMemory + ToolResultCache)
+ * Phase 5: PersistentMemory (继承 ProjectSemanticMemory + 增强)
+ */
+
+export { MemoryCoordinator } from './MemoryCoordinator.js';
+export { ActiveContext } from './ActiveContext.js';
+export { SessionStore } from './SessionStore.js';
+export { PersistentMemory } from './PersistentMemory.js';

package/lib/service/chat/tools/ast-graph.js

@@ -451,19 +451,18 @@ export const noteFinding = {
     required: ['finding'],
   },
   handler: async (params, ctx) => {
-    const workingMemory = ctx._workingMemory;
-    if (!workingMemory) {
-      return '⚠ 工作记忆未初始化 (仅在 bootstrap 分析期间可用)';
-    }
-
-    const finding = params.finding || '';
-    const evidence = params.evidence || '';
-    const importance = params.importance || 5;
-    const round = ctx._currentRound || 0;
-
-    workingMemory.noteKeyFinding(finding, evidence, importance, round);
-
-    return `📌 已记录发现 [${importance}/10]: "${finding.substring(0, 80)}" — 当前共 ${workingMemory.scratchpadSize} 条关键发现`;
+    // v5.0: 通过 MemoryCoordinator
+    const coordinator = ctx._memoryCoordinator;
+    if (coordinator) {
+      const finding = params.finding || '';
+      const evidence = params.evidence || '';
+      const importance = params.importance || 5;
+      const round = ctx._currentRound || 0;
+      const scopeId = ctx._dimensionScopeId || undefined;
+      return coordinator.noteFinding(finding, evidence, importance, round, scopeId);
+    }
+
+    return '⚠ 工作记忆未初始化 (仅在 bootstrap 分析期间可用)';
   },
 };
 
@@ -490,12 +489,14 @@ export const getPreviousEvidence = {
     required: ['query'],
   },
   handler: async (params, ctx) => {
-    const episodicMemory = ctx._episodicMemory;
-    if (!episodicMemory) {
+    // v5.0: 通过 MemoryCoordinator 获取 SessionStore
+    const coordinator = ctx._memoryCoordinator;
+    const sessionStore = coordinator?.getSessionStore();
+    if (!sessionStore) {
       return '没有前序维度的证据可用。';
     }
 
-    const results = episodicMemory.searchEvidence(params.query, params.dimId || undefined);
+    const results = sessionStore.searchEvidence(params.query, params.dimId || undefined);
 
     if (results.length === 0) {
       return `没有找到与 "${params.query}" 相关的前序证据。建议自行搜索。`;

package/lib/service/cursor/AgentInstructionsGenerator.js

@@ -55,9 +55,7 @@ const MCP_TOOLS_SUMMARY = [
   { name: 'autosnippet_skill', desc: 'Skill management (list/load/create/update/delete/suggest)' },
   { name: 'autosnippet_save_document', desc: 'Save development document (auto-publish)' },
   { name: 'autosnippet_bootstrap', desc: 'Project cold-start & scan (knowledge/refine/scan)' },
-  { name: 'autosnippet_ready', desc: 'Session entry point — loads decisions + ready tasks (call FIRST)' },
-  { name: 'autosnippet_decide', desc: 'Decision management (record/revise/unpin/list)' },
-  { name: 'autosnippet_task', desc: 'Task CRUD (create/claim/close/fail/defer/progress/decompose)' },
+  { name: 'autosnippet_task', desc: 'Unified task & decision management: prime (session entry, CALL FIRST) / create/claim/close/fail/defer/progress/decompose (task CRUD) / record_decision/revise_decision/unpin_decision/list_decisions (decisions)' },
   { name: 'autosnippet_health', desc: 'Service health & KB statistics' },
   { name: 'autosnippet_capabilities', desc: 'List all available MCP tools (self-discovery)' },
 ];
@@ -89,14 +87,22 @@ export class AgentInstructionsGenerator {
     // 构建共享内容块
     const sections = this._buildSections({ rules, patterns, skills });
 
-    // 生成 3 个目标文件
-    const agents = this._writeAgentsMd(sections);
-    const claude = this._writeClaudeMd(sections);
+    // 避免 IDE 上下文重复：
+    //   - 不自动生成 CLAUDE.md（用户自己维护）
+    //   - 如果项目已有 CLAUDE.md，跳过 AGENTS.md（避免两份文件同时注入 IDE 上下文）
+    const claudePath = path.join(this.projectRoot, 'CLAUDE.md');
+    const hasClaudeMd = fs.existsSync(claudePath);
+
+    const agents = hasClaudeMd
+      ? { filePath: path.join(this.projectRoot, 'AGENTS.md'), tokensUsed: 0, skipped: true }
+      : this._writeAgentsMd(sections);
+    const claude = { filePath: claudePath, tokensUsed: 0, skipped: true }; // 不自动生成
     const copilot = this._writeCopilotInstructions(sections);
 
     const duration = Date.now() - startTime;
-    const filesWritten = [agents, claude, copilot].filter((r) => !r.skipped).length;
-    const skippedFiles = [agents, claude, copilot].filter((r) => r.skipped);
+    const allResults = [agents, claude, copilot];
+    const filesWritten = allResults.filter((r) => !r.skipped).length;
+    const skippedFiles = allResults.filter((r) => r.skipped);
     if (skippedFiles.length > 0) {
       this.logger.info?.(
         `[AgentInstructions] Skipped ${skippedFiles.length} file(s) — ` +
@@ -279,21 +285,24 @@ export class AgentInstructionsGenerator {
     lines.push('');
 
     // Key tools highlight for Claude
-    lines.push('### Recommended Workflow', '');
+    lines.push('### Task Workflow', '');
+    lines.push(
+      '1. **Every message → `autosnippet_task({ operation: "prime" })`** — Load decisions + tasks + knowledge context (ALWAYS FIRST)'
+    );
     lines.push(
-      '1. **Session start**: `autosnippet_ready()` — Restore task context and decisions'
+      '2. **Create task for non-trivial work** — ≥2 files OR ≥10 lines → `create` → `claim` → code → `close`'
     );
     lines.push(
-      '2. **Before writing code**: `autosnippet_search({ query: "<topic>" })` to find relevant patterns'
+      '3. **User agrees/disagrees → `autosnippet_task({ operation: "record_decision" })`** — Persist decision immediately'
     );
     lines.push(
-      '3. **Check compliance**: `autosnippet_guard({ code: "<your code>" })` before committing'
+      '4. **Before writing code**: `autosnippet_search({ query: "<topic>" })` to find relevant patterns'
     );
     lines.push(
-      '4. **Complete task**: `autosnippet_task({ operation: "close", id: "<id>" })`'
+      '5. **Complete task**: `autosnippet_task({ operation: "close", id: "<id>", reason: "..." })`'
     );
     lines.push(
-      '5. **Guard diagnostics**: Read ruleId → `autosnippet_search({ query: "<ruleId>" })` → fix'
+      '6. **Session end**: Close or defer ALL in_progress tasks — zero in_progress on exit'
     );
     lines.push('');
 
@@ -361,12 +370,7 @@ export class AgentInstructionsGenerator {
     lines.push('');
 
     // Workflow
-    lines.push('## Workflow', '');
-    lines.push('1. Search before coding: `autosnippet_search({ query: "..." })`');
-    lines.push('2. Prefer Recipe over raw source code');
-    lines.push('3. Submit discoveries: `autosnippet_submit_knowledge({ ... })`');
-    lines.push('4. Do NOT directly modify `AutoSnippet/` or `.autosnippet/` files');
-    lines.push('');
+    lines.push(...this._renderWorkflow());
 
     const content = `${lines.join('\n')}\n`;
     const destDir = path.join(this.projectRoot, '.github');
@@ -388,10 +392,34 @@ export class AgentInstructionsGenerator {
    */
   _renderConstraints() {
     return [
-      '## Mandatory Constraints',
+      '## CRITICAL: You Operate autosnippet_task — The User Doesn\'t',
+      '',
+      'You are the task operator. Users speak naturally; you translate to task operations.',
+      'DO NOT tell users to call autosnippet_task. That\'s YOUR job.',
+      '',
+      '- WRONG: "You can run autosnippet_task({ operation: \'create\' }) to create a task"',
+      '- RIGHT: *(you run create yourself and tell the user "Created task asd-42: Fix login bug")*',
+      '',
+      '## Task Tracking Rules (MANDATORY)',
       '',
-      '1. **Do NOT modify** knowledge base files directly (`AutoSnippet/recipes/`, `.autosnippet/`).',
-      '2. Create or update knowledge **only** through MCP tools (`autosnippet_submit_knowledge`).',
+      '1. **MUST prime on EVERY message** — `autosnippet_task({ operation: "prime" })` BEFORE anything else. No exceptions.',
+      '2. **MUST create task for non-trivial work** — ≥2 files OR ≥10 lines → create BEFORE starting.',
+      '3. **MUST claim before coding** — `autosnippet_task({ operation: "claim", id })` then code.',
+      '4. **MUST close when done** — `autosnippet_task({ operation: "close", id, reason })` with meaningful reason.',
+      '5. **MUST handle unfinished tasks first** — If prime shows in-progress, ask user: Continue, Defer, Abandon? Do NOT auto-resume.',
+      '6. **NEVER skip prime** — Even for follow-up messages.',
+      '7. **NEVER start new work with open in-progress tasks** — Handle existing first.',
+      '8. **NEVER leave tasks in in_progress when session ends** — Close or defer everything.',
+      '9. **NEVER tell the user to run task commands** — You are the operator.',
+      '',
+      'When in doubt → create a task. When idle → `autosnippet_task({ operation: "ready" })`.',
+      '',
+      '**When NOT to create**: Quick questions, single-file trivial fixes (<10 lines), code explanation, running tests.',
+      '',
+      '## Knowledge Rules',
+      '',
+      '1. **User agrees/disagrees with a plan → `autosnippet_task({ operation: "record_decision" })` immediately** — Persist team memory first.',
+      '2. **Do NOT modify** knowledge base files directly (`AutoSnippet/recipes/`, `.autosnippet/`).',
       '3. **Prefer Recipes** as project standards; source code is supplementary.',
       '4. Use `autosnippet_search` for knowledge retrieval; do not retry on failure in the same turn.',
       '5. Skills handle semantics and workflow; MCP handles capabilities — do not hardcode URLs in Skills.',
@@ -404,28 +432,35 @@ export class AgentInstructionsGenerator {
    */
   _renderWorkflow() {
     return [
-      '## Recommended Workflow',
+      '## User Says → You Run',
+      '',
+      '| User Says | Your Action |',
+      '|---|---|',
+      '| "Fix this bug" / "帮我修 bug" | `create` → `claim` → code → `close` |',
+      '| "Implement this" / "做功能" | `create` → `claim` → code → `close` |',
+      '| "Continue" / "继续" | resume in-progress → code → `close` |',
+      '| "Pause" / "先不做了" | `defer(id, reason)` |',
+      '| "Abandon" / "不做了" | `fail(id, reason)` |',
+      '| "Break it down" / "太大了" | `decompose(id, subtasks)` |',
+      '| "What\'s next" / "有什么要做的" | `ready()` → present list |',
+      '| "Agreed" / "就这么定了" | `record_decision(...)` |',
+      '| Quick question (no code) | No task. Just answer. |',
+      '',
+      '## Session Closing Protocol',
+      '',
+      'Before ending work, you MUST complete this checklist:',
       '',
-      '### Session Start (ALWAYS)',
-      '1. `autosnippet_ready()` — Restore task context and decisions',
+      '- [ ] Close every claimed task with reason describing what was accomplished',
+      '- [ ] Defer any incomplete tasks with notes on why and what remains',
+      '- [ ] Verify zero tasks in in_progress state',
+      '- [ ] If prime showed ready tasks, mention them to the user for next session',
       '',
-      '### Task Lifecycle',
-      '2. `autosnippet_task({ operation: "claim", id: "asd-xxx" })` — Start working',
-      '3. `autosnippet_search({ query: "<topic>" })` — Search knowledge before coding',
-      '4. **CODE** — Write the implementation',
-      '5. `autosnippet_guard({ code: "<code>" })` — Check compliance',
-      '6. `autosnippet_task({ operation: "close", id: "asd-xxx" })` — Complete',
+      '**Work is not done until all tasks are closed or deferred.**',
       '',
-      '### Guard Diagnostics Response',
-      'When editor shows diagnostics from "AutoSnippet Guard":',
-      '1. Read the `ruleId` from the diagnostic message',
-      '2. `autosnippet_search({ query: "<ruleId>" })` to find the Recipe',
-      '3. Apply the Recipe\'s `doClause` + `coreCode` to fix',
-      '4. Save and verify the diagnostic disappears',
+      '## Context Pressure',
       '',
-      '### Context Pressure',
       '- `_contextHint: CONTEXT_PRESSURE:WARNING` → Summarize completed work, then continue',
-      '- `_contextHint: CONTEXT_PRESSURE:CRITICAL` → Call `autosnippet_ready()` immediately',
+      '- `_contextHint: CONTEXT_PRESSURE:CRITICAL` → Call `autosnippet_task({ operation: "prime" })` immediately',
       '',
     ];
   }

package/lib/service/cursor/FileProtection.js

@@ -17,8 +17,11 @@ import fs from 'node:fs';
 /**
  * AutoSnippet 文件签名模式（case-insensitive）
  * 检查文件前 1024 字节即可——签名总在文件头部
+ * 匹配以下任一标记：
+ *   - "Auto-generated by AutoSnippet" / "Auto-generated by [AutoSnippet]"
+ *   - "<!-- autosnippet:begin -->" (模板起始标记)
  */
-const SIGNATURE_PATTERN = /auto-generated by (?:\[)?autosnippet(?:\])?/i;
+const SIGNATURE_PATTERN = /auto-generated by (?:\[)?autosnippet(?:\])?|autosnippet:begin/i;
 
 /**
  * 检查文件是否可以被 AutoSnippet 安全写入

package/lib/service/guard/GuardCheckEngine.js

@@ -592,7 +592,7 @@ export class GuardCheckEngine {
               id: g.id || r.id,
               name: g.name || r.title,
               message: g.message || r.description || r.title,
-              languages: r.language ? [r.language] : [],
+              languages: r.language ? [r.language, LanguageService.toGuardLangId(r.language)] : [],
               severity: g.severity || 'warning',
               dimension: r.scope || 'file',
               source: 'database',
@@ -647,9 +647,16 @@ export class GuardCheckEngine {
       }
     }
 
-    // 按语言过滤
+    // 按语言过滤（标准化比较：objc == objectivec == objective-c）
     if (language) {
-      rules = rules.filter((r) => !r.languages?.length || r.languages.includes(language));
+      const langNorm = LanguageService.toGuardLangId(language);
+      rules = rules.filter(
+        (r) =>
+          !r.languages?.length ||
+          r.languages.includes(language) ||
+          r.languages.includes(langNorm) ||
+          r.languages.some((l) => LanguageService.toGuardLangId(l) === langNorm)
+      );
     }
 
     // 按 disabledRules 配置过滤

package/lib/service/task/TaskGraphService.js

@@ -398,7 +398,7 @@ export class TaskGraphService {
       }
 
       // P1 Result Compaction: compact 模式 — description 截断到 120 chars
-      // Agent 需要完整内容时调用 autosnippet_decide({ operation: 'list' })
+      // Agent 需要完整内容时调用 autosnippet_task({ operation: 'list_decisions' })
       result.decisions = activeDecisions.map((t) => ({
         id: t.id,
         title: t.title,
@@ -424,13 +424,13 @@ export class TaskGraphService {
 
       result._decisionHint =
         'These are team-agreed decisions (compact view). Respect them in your response. ' +
-        'Call autosnippet_decide({ operation: "list" }) for full details. ' +
+        'Call autosnippet_task({ operation: "list_decisions" }) for full details. ' +
         "If the user's request conflicts with a decision, point out the conflict and ask whether to revise_decision.";
 
       if (staleDecisions.length > 0) {
         result._staleHint =
           `${staleDecisions.length} decision(s) are stale (>${Math.floor(staleThresholdSec / 86400)} days). ` +
-          'Consider reviewing with autosnippet_decide({ operation: "list" }) and unpin outdated ones.';
+          'Consider reviewing with autosnippet_task({ operation: "list_decisions" }) and unpin outdated ones.';
       }
     }
 

package/lib/shared/LanguageService.js

@@ -386,7 +386,8 @@ export class LanguageService {
    * @returns {string}
    */
   static toGuardLangId(langId) {
-    return langId === 'objectivec' ? 'objc' : langId;
+    const id = (langId || '').toLowerCase().replace(/[_-]/g, '');
+    return id === 'objectivec' ? 'objc' : langId;
   }
 
   // ─── 显示名 ────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autosnippet",
-  "version": "3.2.3",
+  "version": "3.2.6",
   "description": "Extract code patterns into a knowledge base for AI coding assistants",
   "type": "module",
   "main": "lib/bootstrap.js",

package/skills/autosnippet-intent/SKILL.md

@@ -46,9 +46,7 @@ Use this skill when the user's intent is unclear or overlaps multiple capabiliti
 - Guard: `autosnippet_guard` (code 单文件 / files[] 批量)
 - Bootstrap: `autosnippet_bootstrap` (no params — Mission Briefing) + `autosnippet_dimension_complete`
 - Wiki: `autosnippet_wiki_plan` (topic planning) + `autosnippet_wiki_finalize` (meta.json + dedup)
-- Ready: `autosnippet_ready` (session entry — loads decisions + tasks)
-- Decide: `autosnippet_decide` (operation: record / revise / unpin / list)
-- Task: `autosnippet_task` (operation: create / ready / claim / close / fail / defer / progress / stats / decompose)
+- Task: `autosnippet_task` (operation: prime (session entry) / create / ready / claim / close / fail / defer / progress / stats / decompose / record_decision / revise_decision / unpin_decision / list_decisions)
 - Skills: `autosnippet_skill` (operation: list / load / create / update / delete / suggest)
 - Admin: `autosnippet_enrich_candidates`, `autosnippet_knowledge_lifecycle`, `autosnippet_validate_candidate`, `autosnippet_check_duplicate`
 

package/skills/autosnippet-recipes/SKILL.md

@@ -118,9 +118,7 @@ Recipe is the core knowledge unit. V3 uses a unified structured model:
 
 | Tool | Description |
 |------|-------------|
-| `autosnippet_ready` | Session entry point — loads decisions + ready tasks (call FIRST) |
-| `autosnippet_decide` | Decision management (`operation`: record/revise/unpin/list) |
-| `autosnippet_task` | Task CRUD (`operation`: create/ready/claim/close/fail/defer/progress/stats/decompose) |
+| `autosnippet_task` | Unified task & decision management (`operation`: prime/create/claim/close/fail/defer/progress/decompose/record_decision/revise_decision/unpin_decision/list_decisions) |
 
 ### Skills Management
 

package/templates/claude-code/commands/prime.md

@@ -0,0 +1,19 @@
+---
+description: "MANDATORY: Load AutoSnippet project context — decisions, tasks, knowledge"
+allowed-tools: ["mcp__autosnippet__autosnippet_task"]
+---
+
+Call autosnippet_task with `{ "operation": "prime" }` to load the current project context.
+
+**You MUST call this on EVERY user message BEFORE doing anything else.**
+
+This returns:
+- **Active decisions** — team agreements that must be followed
+- **Ready tasks** — next items to work on
+- **In-progress tasks** — unfinished work (ask user before resuming)
+- **Task rules reminder** — behavioral rules for task management
+- **Project statistics**
+
+If there are unfinished tasks, present them to the user and ask: **Continue**, **Defer**, or **Abandon**? Do NOT auto-resume.
+
+Call again after long conversations, compaction, or when `_contextHint` shows `CONTEXT_PRESSURE:CRITICAL`.

package/templates/claude-code/hooks/autosnippet-session.sh

@@ -0,0 +1,63 @@
+#!/bin/bash
+# AutoSnippet session hook for Claude Code
+# SessionStart: full task rules + prime reminder
+# PreCompact (--brief): minimal rules to survive compaction
+
+if [[ "$1" == "--brief" ]]; then
+  # Brief mode — survives compaction, minimal context
+  cat <<'EOF'
+📋 AutoSnippet Task Rules (MANDATORY):
+• Prime EVERY message: autosnippet_task({ operation: "prime" }) FIRST.
+• Create task for non-trivial work (≥2 files OR ≥10 lines). Claim → code → close.
+• Handle in-progress tasks before new work. Close/defer ALL on session end.
+• You are the task operator — user speaks naturally, you run task operations.
+• User agrees/disagrees → record_decision immediately.
+• "fix bug"/"implement" → create→claim→code→close | "pause" → defer | "abandon" → fail | "next" → ready()
+EOF
+else
+  # Full mode — SessionStart
+  cat <<'EOF'
+[AutoSnippet Task Rules]
+
+⚡ FIRST: Call autosnippet_task({ "operation": "prime" }) on EVERY message. No exceptions.
+
+🔑 CRITICAL: YOU Operate autosnippet_task — The User Doesn't
+• WRONG: "You can run autosnippet_task to create a task"
+• RIGHT: (you run create yourself and tell the user "Created task asd-42")
+
+📋 MUST:
+• Create task for non-trivial work (≥2 files OR ≥10 lines) BEFORE starting
+• Claim before coding, close when done with meaningful reason
+• Handle unfinished tasks first (ask user: Continue/Defer/Abandon)
+• Close or defer ALL in_progress tasks before session ends
+
+🚫 NEVER:
+• Skip prime
+• Start new work with open in_progress tasks
+• Tell user to run task commands (YOU are the operator)
+• Leave tasks in in_progress when session ends
+
+📖 User Says → You Run:
+• "fix bug" / "implement" → create → claim → code → close
+• "continue" → resume in-progress → code → close
+• "pause" → defer(id, reason)
+• "abandon" → fail(id, reason)
+• "break down" → decompose(id, subtasks)
+• "what's next" → ready() → present list
+• "agreed" → record_decision(...)
+• Quick question → No task. Just answer.
+
+💡 When in doubt → create a task. When idle → autosnippet_task({ operation: "ready" })
+
+📌 User agrees/disagrees with plan → autosnippet_task({ operation: "record_decision" }) immediately
+
+✅ Session end checklist:
+  [ ] Close every claimed task with reason
+  [ ] Defer incomplete tasks with notes
+  [ ] Verify zero in_progress
+  [ ] Mention ready tasks for next session
+
+🔎 Search knowledge: autosnippet_search({ query: "..." })
+📚 Do NOT modify AutoSnippet/recipes/ or .autosnippet/ directly
+EOF
+fi

package/templates/claude-code/settings.json

@@ -0,0 +1,21 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(asd *)",
+      "Bash(curl -s * localhost:3000/*)",
+      "mcp__autosnippet__*"
+    ]
+  },
+  "hooks": {
+    "SessionStart": [
+      {
+        "command": "bash .claude/hooks/autosnippet-session.sh"
+      }
+    ],
+    "PreCompact": [
+      {
+        "command": "bash .claude/hooks/autosnippet-session.sh --brief"
+      }
+    ]
+  }
+}