dsh-continual-evolve 0.11.0 → 0.12.0

package/lib/memory-guide.d.ts

@@ -1,19 +1,18 @@
 /**
- * The persistent-memory guide injected as part of the `evolve:memory-index`
- * system-prompt section (evolve v2, change two).
+ * The persistent-memory guide injected as part of the memory section.
  *
- * This text is the write-path half of the v2 plan: it teaches the model when a
- * durable memory is worth creating, which recall type it belongs to, what body
- * structure each type owes, and that the main session may write directly with
- * `evolve_add` instead of waiting for the background pipeline.
+ * This text is the write-path half of the ZCode-aligned design: it teaches
+ * the model when a durable memory is worth creating, which type it belongs
+ * to, what body structure each type owes, and that memories are plain
+ * markdown files written directly with the native file tools — the plugin
+ * registers no tools and no commands.
  *
- * Provenance: `docs/research/evolve-v2-passive-read-write-plan.md` §改动二
- * (Chinese full text, adapted from ZCode's persistent-memory prompt). Kept in
- * its own module so the wording is a single home — `memory-index.ts` only
- * composes it with the `<memories>` block.
+ * Provenance: the when_to_save taxonomy is adapted from ZCode's persistent-
+ * memory prompt (introduced here in evolve v2); the write-path wording now
+ * targets native file operations on `<workspace>/.evolve/memory/`.
  */
-/** Heading and framing before the `<memories>` block. */
-export declare const MEMORY_GUIDE_INTRO = "# \u6301\u4E45\u8BB0\u5FC6\n\n\u4F60\u6709\u4E00\u4E2A\u8DE8\u4F1A\u8BDD\u7684\u6301\u4E45\u8BB0\u5FC6\u7CFB\u7EDF\u3002\u4EE5\u4E0B\u662F\u5F53\u524D\u8BB0\u5FC6\uFF08\u5DF2\u76F4\u63A5\u6CE8\u5165\uFF0C\u65E0\u9700\u67E5\u8BE2\u5373\u53EF\u4F7F\u7528\uFF1B\u9700\u8981\u68C0\u7D22\u5B8C\u6574\u5185\u5BB9\u6216\u786E\u8BA4\u662F\u5426\u6709\u76F8\u5173\u8BB0\u5FC6\u65F6\uFF0C\u8C03\u7528 evolve_recall\uFF09\u3002\u672C\u4F1A\u8BDD\u5185\u53EF\u4EE5\u76F4\u63A5\u7528 evolve_add \u843D\u76D8\uFF0C\u4E0D\u5FC5\u7B49\u540E\u53F0\u6D41\u7A0B\u2014\u2014\u9ED8\u8BA4\u5199 local\uFF0C\u53EA\u6709\u7A33\u5B9A\u7684\u8DE8\u9879\u76EE\u6559\u8BAD\u624D\u5199 global\uFF08global \u5199\u5165\u4F1A\u5F39\u4EBA\u5DE5\u6279\u51C6\uFF09\u3002";
-/** The when_to_save / how_to_use rules and maintenance discipline. */
-export declare const MEMORY_GUIDE_RULES = "## \u4F55\u65F6\u5199\u5165\u8BB0\u5FC6\n\n\u7528\u6237\u660E\u786E\u8981\u6C42\u8BB0\u4F4F\u65F6\uFF0C\u7ACB\u5373\u5B58\u4E3A\u6700\u5408\u9002\u7684\u7C7B\u578B\uFF1B\u8981\u6C42\u5FD8\u8BB0\u65F6\uFF0C\u627E\u5230\u5E76\u5220\u9664\u76F8\u5173\u6761\u76EE\u3002\n\u9664\u6B64\u4E4B\u5916\uFF0C\u5728\u5BF9\u8BDD\u4E2D\u81EA\u7136\u9047\u5230\u4EE5\u4E0B\u4FE1\u53F7\u65F6\u4E3B\u52A8\u5199\u5165\u3002\u5B58\u4E4B\u524D\u5148\u8FC7\u4E00\u9053\u7B5B\u5B50\uFF1A\n**\u80FD\u4ECE\u4EE3\u7801\u3001git \u5386\u53F2\u3001\u4ED3\u5E93\u6587\u4EF6\u91CC\u91CD\u65B0\u63A8\u5BFC\u51FA\u6765\u7684\u4E8B\u5B9E\u4E0D\u5B58**\u2014\u2014\u53EA\u5B58\u91CD\u63A8\u5BFC\u4E0D\u51FA\u6765\u7684\n\u80CC\u666F\u3001\u51B3\u7B56\u548C\u504F\u597D\u3002\u76F8\u5BF9\u65E5\u671F\u4E00\u5F8B\u8F6C\u6210\u7EDD\u5BF9\u65E5\u671F\uFF08\"\u5468\u56DB\"\u2192\"2026-10-08\"\uFF09\uFF0C\u5426\u5219\u672A\u6765\n\u7684\u4F1A\u8BDD\u65E0\u6CD5\u89E3\u8BFB\u3002\u4E00\u6761\u4E8B\u5B9E\u4E00\u4E2A\u6761\u76EE\uFF1B\u4E0D\u786E\u5B9A\u503C\u4E0D\u503C\u5F97\u5B58\u65F6\uFF0C\u95EE\u81EA\u5DF1\"\u8FD9\u6761\u7684\u4FE1\u606F\u91CF\n\u662F\u5426\u5728'\u4E3A\u4EC0\u4E48'\u91CC\uFF0C\u800C\u4E0D\u5728'\u662F\u4EC0\u4E48'\u91CC\"\u3002\n\n<type name=\"user\">\n  <when_to_save>\u5F97\u77E5\u7528\u6237\u7684\u89D2\u8272\u3001\u6280\u672F\u6808\u3001\u7ECF\u9A8C\u6C34\u5E73\u3001\u504F\u597D\u6216\u77E5\u8BC6\u80CC\u666F\u7684\u4EFB\u4F55\u7EC6\u8282\u65F6\u3002\n  \u4F8B\u5982\u7528\u6237\u81EA\u8FF0\"\u6211\u662F\u6570\u636E\u79D1\u5B66\u5BB6\uFF0C\u5728\u67E5\u65E5\u5FD7\u7CFB\u7EDF\"\u2014\u2014\u5B58\uFF1A\u7528\u6237\u662F\u6570\u636E\u79D1\u5B66\u5BB6\uFF0C\n  \u5F53\u524D\u5173\u6CE8\u53EF\u89C2\u6D4B\u6027/\u65E5\u5FD7\u3002</when_to_save>\n  <how_to_use>\u540E\u7EED\u89E3\u91CA\u548C\u5EFA\u8BAE\u6309\u7528\u6237\u7684\u80CC\u666F\u5B9A\u5236\u6DF1\u6D45\u4E0E\u7C7B\u6BD4\uFF1B\u5BF9\u8D44\u6DF1\u5DE5\u7A0B\u5E08\n  \u4E0D\u89E3\u91CA\u57FA\u7840\u6982\u5FF5\uFF0C\u5BF9\u67D0\u9886\u57DF\u7684\u65B0\u624B\u7528\u5176\u719F\u6089\u9886\u57DF\u7684\u7C7B\u6BD4\u5207\u5165\u3002</how_to_use>\n</type>\n\n<type name=\"feedback\">\n  <when_to_save>\u4E24\u6761\u4FE1\u53F7\uFF0C\u7F3A\u4E00\u4E0D\u53EF\uFF1A\n  \uFF081\uFF09\u7EA0\u6B63\u2014\u2014\u7528\u6237\u8BF4\"\u4E0D\u662F\u8FD9\u6837\"\"\u522B\"\"\u505C\u4E0B\"\u65F6\uFF0C\u5B58\u88AB\u7EA0\u6B63\u7684\u505A\u6CD5\u4E0E\u6B63\u786E\u505A\u6CD5\uFF1B\n  \uFF082\uFF09\u786E\u8BA4\u2014\u2014\u8FD9\u662F\u66F4\u5B89\u9759\u3001\u66F4\u5BB9\u6613\u6F0F\u7684\u4FE1\u53F7\uFF1A\u7528\u6237\u63A5\u53D7\u4E86\u4F60\u4E0D\u5BFB\u5E38\u7684\u9009\u62E9\u800C\u6CA1\u6709\u5F02\u8BAE\uFF0C\n  \u6216\u660E\u786E\u8BF4\"\u5BF9\uFF0C\u5C31\u8FD9\u6837\"\"\u4FDD\u6301\u8FD9\u6837\"\u3002\u786E\u8BA4\u8FC7\u7684\u5224\u65AD\u662F\u5DF2\u9A8C\u8BC1\u7684\u65B9\u6CD5\u8BBA\uFF0C\u53EA\u5B58\u7EA0\u9519\n  \u4F1A\u8BA9\u4F60\u7684\u884C\u4E3A\u8D8A\u6765\u8D8A\u4FDD\u5B88\u3001\u504F\u79BB\u7528\u6237\u5DF2\u8BA4\u53EF\u7684\u8DEF\u3002\n  \u4F8B\uFF1A\"\u6D4B\u8BD5\u522B mock \u6570\u636E\u5E93\uFF0C\u4E0A\u6B21 mock \u8FC7\u4E86\u7EBF\u4E0A\u8FC1\u79FB\u6302\u4E86\"\u2014\u2014\u5B58\u89C4\u5219\u5E76\u5E26\u4E0A\u4E8B\u6545\u539F\u56E0\u3002\n  \u4F8B\uFF1A\"\u7ED3\u5C3E\u4E0D\u7528\u603B\u7ED3\uFF0Cdiff \u6211\u81EA\u5DF1\u4F1A\u770B\"\u2014\u2014\u5B58\uFF1A\u8BE5\u7528\u6237\u4E0D\u8981\u5C3E\u968F\u6027\u603B\u7ED3\u3002</when_to_save>\n  <how_to_use>\u8BA9\u7528\u6237\u4E0D\u5FC5\u628A\u540C\u4E00\u6761\u6307\u5BFC\u8BF4\u7B2C\u4E8C\u904D\u3002</how_to_use>\n  <body_structure>\u89C4\u5219\u5148\u884C\uFF0C\u968F\u540E\u5FC5\u5E26\u4E24\u884C\uFF1A**Why:**\uFF08\u7528\u6237\u7ED9\u7684\u7406\u7531\uFF0C\u5E38\u662F\u67D0\u6B21\n  \u4E8B\u6545\u6216\u5F3A\u504F\u597D\u2014\u2014\u77E5\u9053\u4E3A\u4EC0\u4E48\u624D\u80FD\u5224\u65AD\u8FB9\u7F18\u60C5\u51B5\u8BE5\u4E0D\u8BE5\u7834\u4F8B\uFF09\u548C **How to apply:**\n  \uFF08\u4F55\u65F6\u4F55\u5730\u751F\u6548\uFF09\u3002feedback \u7C7B\u578B\u7F3A\u8FD9\u4E24\u884C\u89C6\u4E3A\u4E0D\u5B8C\u6574\u3002</body_structure>\n</type>\n\n<type name=\"project\">\n  <when_to_save>\u5F97\u77E5\u8FDB\u884C\u4E2D\u7684\u5DE5\u4F5C\u3001\u76EE\u6807\u3001\u51B3\u7B56\u3001\u622A\u6B62\u671F\u6216\u4E8B\u6545\u7684\u80CC\u666F\u52A8\u673A\u65F6\u2014\u2014\n  \u51E1\u662F\"\u8C01\u5728\u505A\u4EC0\u4E48\u3001\u4E3A\u4EC0\u4E48\u3001\u5230\u4EC0\u4E48\u65F6\u5019\"\u4E14\u65E0\u6CD5\u4ECE\u4EE3\u7801\u6216 git \u63A8\u5BFC\u7684\u4FE1\u606F\u3002\n  \u8FD9\u7C7B\u8BB0\u5FC6\u8870\u51CF\u5FEB\uFF0C\u72B6\u6001\u53D8\u5316\u65F6\u66F4\u65B0\u5B83\uFF0C\u522B\u5806\u53E0\u65B0\u6761\u76EE\u3002</when_to_save>\n  <how_to_use>\u7528\u5B83\u8865\u5168\u8BF7\u6C42\u80CC\u540E\u7684\u4E0A\u4E0B\u6587\u4E0E\u52A8\u673A\uFF0C\u8BA9\u5EFA\u8BAE\u8D34\u4F4F\u771F\u5B9E\u7EA6\u675F\u3002\n  \u4F8B\uFF1A\"\u5468\u56DB\u8D77\u51BB\u7ED3\u5408\u5E76\"\u2014\u2014\u5B58\uFF1A2026-03-05 \u8D77\u51BB\u7ED3\u5408\u5E76\uFF0C\u975E\u5173\u952E PR \u63D0\u524D\u6807\u8BB0\u3002</how_to_use>\n  <body_structure>\u4E8B\u5B9E/\u51B3\u7B56\u5148\u884C + **Why:**\uFF08\u52A8\u673A\uFF1A\u7EA6\u675F\u3001deadline\u3001\u5E72\u7CFB\u4EBA\u8981\u6C42\uFF09\n  + **How to apply:**\uFF08\u8FD9\u6761\u5982\u4F55\u5F71\u54CD\u540E\u7EED\u5EFA\u8BAE\uFF09\u3002</body_structure>\n</type>\n\n<type name=\"reference\">\n  <when_to_save>\u7528\u6237\u63D0\u5230\u672A\u6765\u4F1A\u7528\u5230\u7684\u5916\u90E8\u8D44\u6E90\u6307\u9488\uFF1AURL\u3001\u4EEA\u8868\u76D8\u3001\u5DE5\u5355\u3001\n  \u6587\u6863\u4F4D\u7F6E\u3002</when_to_save>\n  <how_to_use>\u9700\u8981\u65F6\u76F4\u63A5\u53D6\u7528\uFF0C\u4E0D\u91CD\u65B0\u68C0\u7D22\u3002</how_to_use>\n</type>\n\n## \u5982\u4F55\u7EF4\u62A4\n\n- \u66F4\u65B0\u4F18\u5148\u4E8E\u65B0\u5EFA\uFF1A\u72B6\u6001\u53D8\u4E86\u6539\u539F\u6761\u76EE\uFF0C\u4E0D\u53E6\u8D77\u4E00\u6761\uFF08\u65B0\u65E7\u5E76\u5B58\u6BD4\u6CA1\u6709\u8BB0\u5FC6\u66F4\u7CDF\uFF09\u3002\n- \u6BCF\u6761\u7684 description \u662F\u7ED9\u672A\u6765\u4F1A\u8BDD\u7684\u76F8\u5173\u6027 hook\u2014\u2014\u5199\"\u51B3\u5B9A\u4E86\u4E00\u6761\u8BB0\u5FC6\u4F1A\u4E0D\u4F1A\n  \u88AB\u60F3\u8D77\"\u7684\u4E00\u53E5\u8BDD\uFF0C\u4E0D\u5199\u6D41\u6C34\u8D26\u3002\n- [[\u540D\u5B57]] \u4E92\u76F8\u5F15\u7528\u76F8\u5173\u8BB0\u5FC6\uFF1B\u5F15\u7528\u8FD8\u4E0D\u5B58\u5728\u7684\u540D\u5B57\u662F\u5408\u6CD5\u7684\uFF0C\u5B83\u6807\u8BB0\"\u503C\u5F97\u5C06\u6765\u8865\u5199\"\u3002";
+/** Heading and framing before the `<memories>` block. Takes the absolute memory dir. */
+export declare function memoryGuideIntro(memoryDir: string): string;
+/** The file format, when_to_save / how_to_use rules, and maintenance discipline. */
+export declare const MEMORY_GUIDE_RULES = "## \u8BB0\u5FC6\u6587\u4EF6\u7684\u683C\u5F0F\n\n---\nname: <\u77ED\u6A2A\u7EBF\u5C0F\u5199\u6807\u8BC6>\ndescription: <\u4E00\u53E5\u8BDD\u76F8\u5173\u6027\u94A9\u5B50\u2014\u2014\u51B3\u5B9A\u672A\u6765\u4F1A\u8BDD\u4F1A\u4E0D\u4F1A\u60F3\u8D77\u8FD9\u6761\u8BB0\u5FC6>\nmetadata:\n  type: user | feedback | project | reference\n---\n\n<\u6B63\u6587>\n\n## \u4F55\u65F6\u5199\u5165\u8BB0\u5FC6\n\n\u7528\u6237\u660E\u786E\u8981\u6C42\u8BB0\u4F4F\u65F6\uFF0C\u7ACB\u5373\u5B58\u4E3A\u6700\u5408\u9002\u7684\u7C7B\u578B\uFF1B\u8981\u6C42\u5FD8\u8BB0\u65F6\uFF0C\u627E\u5230\u5E76\u5220\u9664\u76F8\u5173\u6587\u4EF6\u4E0E\u7D22\u5F15\u884C\u3002\n\u9664\u6B64\u4E4B\u5916\uFF0C\u5728\u5BF9\u8BDD\u4E2D\u81EA\u7136\u9047\u5230\u4EE5\u4E0B\u4FE1\u53F7\u65F6\u4E3B\u52A8\u5199\u5165\u3002\u5B58\u4E4B\u524D\u5148\u8FC7\u4E00\u9053\u7B5B\u5B50\uFF1A\n**\u80FD\u4ECE\u4EE3\u7801\u3001git \u5386\u53F2\u3001\u4ED3\u5E93\u6587\u4EF6\u91CC\u91CD\u65B0\u63A8\u5BFC\u51FA\u6765\u7684\u4E8B\u5B9E\u4E0D\u5B58**\u2014\u2014\u53EA\u5B58\u91CD\u63A8\u5BFC\u4E0D\u51FA\u6765\u7684\n\u80CC\u666F\u3001\u51B3\u7B56\u548C\u504F\u597D\u3002\u76F8\u5BF9\u65E5\u671F\u4E00\u5F8B\u8F6C\u6210\u7EDD\u5BF9\u65E5\u671F\uFF08\"\u5468\u56DB\"\u2192\"2026-10-08\"\uFF09\uFF0C\u5426\u5219\u672A\u6765\n\u7684\u4F1A\u8BDD\u65E0\u6CD5\u89E3\u8BFB\u3002\u4E00\u6761\u4E8B\u5B9E\u4E00\u4E2A\u6587\u4EF6\uFF1B\u4E0D\u786E\u5B9A\u503C\u4E0D\u503C\u5F97\u5B58\u65F6\uFF0C\u95EE\u81EA\u5DF1\"\u8FD9\u6761\u7684\u4FE1\u606F\u91CF\n\u662F\u5426\u5728'\u4E3A\u4EC0\u4E48'\u91CC\uFF0C\u800C\u4E0D\u5728'\u662F\u4EC0\u4E48'\u91CC\"\u3002\n\n<type name=\"user\">\n  <when_to_save>\u5F97\u77E5\u7528\u6237\u7684\u89D2\u8272\u3001\u6280\u672F\u6808\u3001\u7ECF\u9A8C\u6C34\u5E73\u3001\u504F\u597D\u6216\u77E5\u8BC6\u80CC\u666F\u7684\u4EFB\u4F55\u7EC6\u8282\u65F6\u3002\n  \u4F8B\u5982\u7528\u6237\u81EA\u8FF0\"\u6211\u662F\u6570\u636E\u79D1\u5B66\u5BB6\uFF0C\u5728\u67E5\u65E5\u5FD7\u7CFB\u7EDF\"\u2014\u2014\u5B58\uFF1A\u7528\u6237\u662F\u6570\u636E\u79D1\u5B66\u5BB6\uFF0C\n  \u5F53\u524D\u5173\u6CE8\u53EF\u89C2\u6D4B\u6027/\u65E5\u5FD7\u3002</when_to_save>\n  <how_to_use>\u540E\u7EED\u89E3\u91CA\u548C\u5EFA\u8BAE\u6309\u7528\u6237\u7684\u80CC\u666F\u5B9A\u5236\u6DF1\u6D45\u4E0E\u7C7B\u6BD4\uFF1B\u5BF9\u8D44\u6DF1\u5DE5\u7A0B\u5E08\n  \u4E0D\u89E3\u91CA\u57FA\u7840\u6982\u5FF5\uFF0C\u5BF9\u67D0\u9886\u57DF\u7684\u65B0\u624B\u7528\u5176\u719F\u6089\u9886\u57DF\u7684\u7C7B\u6BD4\u5207\u5165\u3002</how_to_use>\n</type>\n\n<type name=\"feedback\">\n  <when_to_save>\u4E24\u6761\u4FE1\u53F7\uFF0C\u7F3A\u4E00\u4E0D\u53EF\uFF1A\n  \uFF081\uFF09\u7EA0\u6B63\u2014\u2014\u7528\u6237\u8BF4\"\u4E0D\u662F\u8FD9\u6837\"\"\u522B\"\"\u505C\u4E0B\"\u65F6\uFF0C\u5B58\u88AB\u7EA0\u6B63\u7684\u505A\u6CD5\u4E0E\u6B63\u786E\u505A\u6CD5\uFF1B\n  \uFF082\uFF09\u786E\u8BA4\u2014\u2014\u8FD9\u662F\u66F4\u5B89\u9759\u3001\u66F4\u5BB9\u6613\u6F0F\u7684\u4FE1\u53F7\uFF1A\u7528\u6237\u63A5\u53D7\u4E86\u4F60\u4E0D\u5BFB\u5E38\u7684\u9009\u62E9\u800C\u6CA1\u6709\u5F02\u8BAE\uFF0C\n  \u6216\u660E\u786E\u8BF4\"\u5BF9\uFF0C\u5C31\u8FD9\u6837\"\"\u4FDD\u6301\u8FD9\u6837\"\u3002\u786E\u8BA4\u8FC7\u7684\u5224\u65AD\u662F\u5DF2\u9A8C\u8BC1\u7684\u65B9\u6CD5\u8BBA\uFF0C\u53EA\u5B58\u7EA0\u9519\n  \u4F1A\u8BA9\u4F60\u7684\u884C\u4E3A\u8D8A\u6765\u8D8A\u4FDD\u5B88\u3001\u504F\u79BB\u7528\u6237\u5DF2\u8BA4\u53EF\u7684\u8DEF\u3002\n  \u4F8B\uFF1A\"\u6D4B\u8BD5\u522B mock \u6570\u636E\u5E93\uFF0C\u4E0A\u6B21 mock \u8FC7\u4E86\u7EBF\u4E0A\u8FC1\u79FB\u6302\u4E86\"\u2014\u2014\u5B58\u89C4\u5219\u5E76\u5E26\u4E0A\u4E8B\u6545\u539F\u56E0\u3002\n  \u4F8B\uFF1A\"\u7ED3\u5C3E\u4E0D\u7528\u603B\u7ED3\uFF0Cdiff \u6211\u81EA\u5DF1\u4F1A\u770B\"\u2014\u2014\u5B58\uFF1A\u8BE5\u7528\u6237\u4E0D\u8981\u5C3E\u968F\u6027\u603B\u7ED3\u3002</when_to_save>\n  <how_to_use>\u8BA9\u7528\u6237\u4E0D\u5FC5\u628A\u540C\u4E00\u6761\u6307\u5BFC\u8BF4\u7B2C\u4E8C\u904D\u3002</how_to_use>\n  <body_structure>\u89C4\u5219\u5148\u884C\uFF0C\u968F\u540E\u5FC5\u5E26\u4E24\u884C\uFF1A**Why:**\uFF08\u7528\u6237\u7ED9\u7684\u7406\u7531\uFF0C\u5E38\u662F\u67D0\u6B21\n  \u4E8B\u6545\u6216\u5F3A\u504F\u597D\u2014\u2014\u77E5\u9053\u4E3A\u4EC0\u4E48\u624D\u80FD\u5224\u65AD\u8FB9\u7F18\u60C5\u51B5\u8BE5\u4E0D\u8BE5\u7834\u4F8B\uFF09\u548C **How to apply:**\n  \uFF08\u4F55\u65F6\u4F55\u5730\u751F\u6548\uFF09\u3002feedback \u7C7B\u578B\u7F3A\u8FD9\u4E24\u884C\u89C6\u4E3A\u4E0D\u5B8C\u6574\u3002</body_structure>\n</type>\n\n<type name=\"project\">\n  <when_to_save>\u5F97\u77E5\u8FDB\u884C\u4E2D\u7684\u5DE5\u4F5C\u3001\u76EE\u6807\u3001\u51B3\u7B56\u3001\u622A\u6B62\u671F\u6216\u4E8B\u6545\u7684\u80CC\u666F\u52A8\u673A\u65F6\u2014\u2014\n  \u51E1\u662F\"\u8C01\u5728\u505A\u4EC0\u4E48\u3001\u4E3A\u4EC0\u4E48\u3001\u5230\u4EC0\u4E48\u65F6\u5019\"\u4E14\u65E0\u6CD5\u4ECE\u4EE3\u7801\u6216 git \u63A8\u5BFC\u7684\u4FE1\u606F\u3002\n  \u8FD9\u7C7B\u8BB0\u5FC6\u8870\u51CF\u5FEB\uFF0C\u72B6\u6001\u53D8\u5316\u65F6\u66F4\u65B0\u5B83\uFF0C\u522B\u5806\u53E0\u65B0\u6587\u4EF6\u3002</when_to_save>\n  <how_to_use>\u7528\u5B83\u8865\u5168\u8BF7\u6C42\u80CC\u540E\u7684\u4E0A\u4E0B\u6587\u4E0E\u52A8\u673A\uFF0C\u8BA9\u5EFA\u8BAE\u8D34\u4F4F\u771F\u5B9E\u7EA6\u675F\u3002\n  \u4F8B\uFF1A\"\u5468\u56DB\u8D77\u51BB\u7ED3\u5408\u5E76\"\u2014\u2014\u5B58\uFF1A2026-03-05 \u8D77\u51BB\u7ED3\u5408\u5E76\uFF0C\u975E\u5173\u952E PR \u63D0\u524D\u6807\u8BB0\u3002</how_to_use>\n  <body_structure>\u4E8B\u5B9E/\u51B3\u7B56\u5148\u884C + **Why:**\uFF08\u52A8\u673A\uFF1A\u7EA6\u675F\u3001deadline\u3001\u5E72\u7CFB\u4EBA\u8981\u6C42\uFF09\n  + **How to apply:**\uFF08\u8FD9\u6761\u5982\u4F55\u5F71\u54CD\u540E\u7EED\u5EFA\u8BAE\uFF09\u3002</body_structure>\n</type>\n\n<type name=\"reference\">\n  <when_to_save>\u7528\u6237\u63D0\u5230\u672A\u6765\u4F1A\u7528\u5230\u7684\u5916\u90E8\u8D44\u6E90\u6307\u9488\uFF1AURL\u3001\u4EEA\u8868\u76D8\u3001\u5DE5\u5355\u3001\n  \u6587\u6863\u4F4D\u7F6E\u3002</when_to_save>\n  <how_to_use>\u9700\u8981\u65F6\u76F4\u63A5\u53D6\u7528\uFF0C\u4E0D\u91CD\u65B0\u68C0\u7D22\u3002</how_to_use>\n</type>\n\n## \u5982\u4F55\u7EF4\u62A4\n\n- \u5199\u5B8C\u8BB0\u5FC6\u6587\u4EF6\u540E\u7ACB\u5373\u5728 MEMORY.md \u8FFD\u52A0\u6216\u66F4\u65B0\u4E00\u884C\u7D22\u5F15\uFF1A`- [\u6807\u9898](\u6587\u4EF6\u540D.md) \u2014 \u94A9\u5B50`\uFF1B\u72B6\u6001\u53D8\u5316\u65F6\u539F\u6587\u4E0E\u7D22\u5F15\u884C\u4E00\u8D77\u6539\uFF0C\u522B\u8BA9\u7D22\u5F15\u8BF4\u8C0E\u3002\n- \u66F4\u65B0\u4F18\u5148\u4E8E\u65B0\u5EFA\uFF1A\u72B6\u6001\u53D8\u4E86\u6539\u539F\u6587\u4EF6\uFF0C\u4E0D\u53E6\u8D77\u4E00\u6761\uFF08\u65B0\u65E7\u5E76\u5B58\u6BD4\u6CA1\u6709\u8BB0\u5FC6\u66F4\u7CDF\uFF09\u3002\n- [[\u540D\u5B57]] \u4E92\u76F8\u5F15\u7528\u76F8\u5173\u8BB0\u5FC6\uFF1B\u5F15\u7528\u8FD8\u4E0D\u5B58\u5728\u7684\u540D\u5B57\u662F\u5408\u6CD5\u7684\uFF0C\u5B83\u6807\u8BB0\"\u503C\u5F97\u5C06\u6765\u8865\u5199\"\u3002";
 //# sourceMappingURL=memory-guide.d.ts.map

package/lib/memory-guide.js

@@ -1,29 +1,41 @@
 /**
- * The persistent-memory guide injected as part of the `evolve:memory-index`
- * system-prompt section (evolve v2, change two).
+ * The persistent-memory guide injected as part of the memory section.
  *
- * This text is the write-path half of the v2 plan: it teaches the model when a
- * durable memory is worth creating, which recall type it belongs to, what body
- * structure each type owes, and that the main session may write directly with
- * `evolve_add` instead of waiting for the background pipeline.
+ * This text is the write-path half of the ZCode-aligned design: it teaches
+ * the model when a durable memory is worth creating, which type it belongs
+ * to, what body structure each type owes, and that memories are plain
+ * markdown files written directly with the native file tools — the plugin
+ * registers no tools and no commands.
  *
- * Provenance: `docs/research/evolve-v2-passive-read-write-plan.md` §改动二
- * (Chinese full text, adapted from ZCode's persistent-memory prompt). Kept in
- * its own module so the wording is a single home — `memory-index.ts` only
- * composes it with the `<memories>` block.
+ * Provenance: the when_to_save taxonomy is adapted from ZCode's persistent-
+ * memory prompt (introduced here in evolve v2); the write-path wording now
+ * targets native file operations on `<workspace>/.evolve/memory/`.
  */
-/** Heading and framing before the `<memories>` block. */
-export const MEMORY_GUIDE_INTRO = `# 持久记忆
+/** Heading and framing before the `<memories>` block. Takes the absolute memory dir. */
+export function memoryGuideIntro(memoryDir) {
+    return `# 持久记忆
 
-你有一个跨会话的持久记忆系统。以下是当前记忆（已直接注入，无需查询即可使用；需要检索完整内容或确认是否有相关记忆时，调用 evolve_recall）。本会话内可以直接用 evolve_add 落盘，不必等后台流程——默认写 local，只有稳定的跨项目教训才写 global（global 写入会弹人工批准）。`;
-/** The when_to_save / how_to_use rules and maintenance discipline. */
-export const MEMORY_GUIDE_RULES = `## 何时写入记忆
+你有一个跨会话的持久记忆系统，存放在 \`${memoryDir}/\`：一事一文，\`MEMORY.md\` 是索引，其内容已注入在下方。没有专用命令或工具——直接用你的文件读写工具查看、新建、修改、删除记忆文件，并在同一会话内顺手落盘。`;
+}
+/** The file format, when_to_save / how_to_use rules, and maintenance discipline. */
+export const MEMORY_GUIDE_RULES = `## 记忆文件的格式
 
-用户明确要求记住时，立即存为最合适的类型；要求忘记时，找到并删除相关条目。
+---
+name: <短横线小写标识>
+description: <一句话相关性钩子——决定未来会话会不会想起这条记忆>
+metadata:
+  type: user | feedback | project | reference
+---
+
+<正文>
+
+## 何时写入记忆
+
+用户明确要求记住时，立即存为最合适的类型；要求忘记时，找到并删除相关文件与索引行。
 除此之外，在对话中自然遇到以下信号时主动写入。存之前先过一道筛子：
 **能从代码、git 历史、仓库文件里重新推导出来的事实不存**——只存重推导不出来的
 背景、决策和偏好。相对日期一律转成绝对日期（"周四"→"2026-10-08"），否则未来
-的会话无法解读。一条事实一个条目；不确定值不值得存时，问自己"这条的信息量
+的会话无法解读。一条事实一个文件；不确定值不值得存时，问自己"这条的信息量
 是否在'为什么'里，而不在'是什么'里"。
 
 <type name="user">
@@ -51,7 +63,7 @@ export const MEMORY_GUIDE_RULES = `## 何时写入记忆
 <type name="project">
   <when_to_save>得知进行中的工作、目标、决策、截止期或事故的背景动机时——
   凡是"谁在做什么、为什么、到什么时候"且无法从代码或 git 推导的信息。
-  这类记忆衰减快，状态变化时更新它，别堆叠新条目。</when_to_save>
+  这类记忆衰减快，状态变化时更新它，别堆叠新文件。</when_to_save>
   <how_to_use>用它补全请求背后的上下文与动机，让建议贴住真实约束。
   例："周四起冻结合并"——存：2026-03-05 起冻结合并，非关键 PR 提前标记。</how_to_use>
   <body_structure>事实/决策先行 + **Why:**（动机：约束、deadline、干系人要求）
@@ -66,8 +78,7 @@ export const MEMORY_GUIDE_RULES = `## 何时写入记忆
 
 ## 如何维护
 
-- 更新优先于新建：状态变了改原条目，不另起一条（新旧并存比没有记忆更糟）。
-- 每条的 description 是给未来会话的相关性 hook——写"决定了一条记忆会不会
-  被想起"的一句话，不写流水账。
+- 写完记忆文件后立即在 MEMORY.md 追加或更新一行索引：\`- [标题](文件名.md) — 钩子\`；状态变化时原文与索引行一起改，别让索引说谎。
+- 更新优先于新建：状态变了改原文件，不另起一条（新旧并存比没有记忆更糟）。
 - [[名字]] 互相引用相关记忆；引用还不存在的名字是合法的，它标记"值得将来补写"。`;
 //# sourceMappingURL=memory-guide.js.map

package/lib/memory-section.d.ts

@@ -0,0 +1,77 @@
+/** Name of the injected section (unique — duplicate names throw upstream). */
+export declare const MEMORY_SECTION_NAME = "evolve:memory-index";
+/** Default prompt-section order (empty 1–499 slot; upstream named slots start at 500). */
+export declare const DEFAULT_MEMORY_SECTION_ORDER = 400;
+/** Default hard character budget for the injected index. */
+export declare const DEFAULT_MAX_CHARS = 6000;
+/** Sessions whose frozen section text is kept before LRU eviction. */
+export declare const DEFAULT_FROZEN_SESSIONS = 32;
+/** The assembling agent's validated absolute cwd, or undefined when absent. */
+export declare function cwdOf(agent: unknown): string | undefined;
+/** Absolute memory directory for a workspace root. */
+export declare function memoryDirFor(cwd: string): string;
+/**
+ * Ensure `.evolve/` is ignored when the workspace is a git repository, so
+ * the memory store never shows up in git status. Best-effort hygiene: a
+ * non-git workspace (no `.git` entry at the cwd) is left untouched — no
+ * `.gitignore` is created — and any write failure is swallowed.
+ */
+export declare function ensureGitIgnored(cwd: string): void;
+/**
+ * Ensure the store exists (creating the directory and a starter index on
+ * first use), then return the trimmed index text. Any filesystem failure
+ * degrades to "" — injection must never break an assembly.
+ */
+export declare function readMemoryIndex(dir: string, bootstrap?: boolean): string;
+/** What fitting the index into the budget produced. */
+export interface IndexFit {
+    /** Index text actually shown (possibly truncated to a line boundary). */
+    text: string;
+    /** Characters dropped by the budget, 0 when the index fit whole. */
+    dropped: number;
+}
+/**
+ * Whole-line-preserving truncation of the index to `maxChars` characters.
+ * Only index rows that fit whole are shown — a partial markdown row would
+ * corrupt the line the model reads. When not even one row fits, `text` is
+ * "" and `dropped` carries the full length.
+ */
+export declare function fitIndex(index: string, maxChars: number): IndexFit;
+/** Options for {@link memorySectionText}. */
+export interface MemorySectionOptions {
+    /** Hard character budget for the injected index (default 6000). */
+    maxChars?: number;
+    /** Include the when_to_save guide (default true). */
+    guide?: boolean;
+    /** Skip store bootstrap (tests). */
+    bootstrap?: boolean;
+}
+/**
+ * Compose the full memory section for one assembling agent: the guide
+ * wrapped around the budget-bounded index, with the absolute store path
+ * handed out so the model can read and write the files directly. With the
+ * guide off and an empty index the result is "" — the prompt renderer then
+ * drops the section, so an empty workspace costs zero tokens.
+ */
+export declare function memorySectionText(agent: unknown, opts?: MemorySectionOptions): string;
+/** A per-session frozen view of the memory section text. */
+export interface FrozenMemorySection {
+    /**
+     * The section text for this agent: built on first use per agent id and
+     * reused byte-for-byte afterwards. An agent without an id is rebuilt on
+     * every call (nothing to key the cache on).
+     */
+    textFor(agent: unknown, build: (agent: unknown) => string): string;
+    /** Sessions currently frozen (test/observability hook). */
+    size(): number;
+    /** Drop every frozen session (tests; a restart rebuilds naturally). */
+    clear(): void;
+}
+/**
+ * Freeze the section text per agent id. The frozen value is what keeps the
+ * system prompt stable across a session's assemblies (prompt-cache guard);
+ * bounded by `maxSessions` with insertion-order (LRU) eviction, so a
+ * long-lived process cannot grow without limit.
+ */
+export declare function createFrozenMemorySection(maxSessions?: number): FrozenMemorySection;
+//# sourceMappingURL=memory-section.d.ts.map

package/lib/memory-section.js

@@ -0,0 +1,189 @@
+/**
+ * The whole runtime of the plugin after the 2026-10-04 ZCode-alignment
+ * teardown: the session-start memory section.
+ *
+ * The store is plain markdown inside the workspace — `<cwd>/.evolve/memory/`
+ * with a `MEMORY.md` index and one file per fact — so the model reads and
+ * writes it with its native file tools (DSH fences only out-of-workspace
+ * writes; dot-directories inside the workspace pass both ways). This module
+ * hands out the absolute path, injects the index content, and wraps the
+ * when-to-save guide around it. There are no tools, no scopes, and no
+ * governance: the files are the store, and a bad memory is a visible file
+ * the user deletes.
+ *
+ * Session-freeze contract (the prompt-cache guard): the section is computed
+ * once per agent id and reused byte-for-byte afterwards, so the system
+ * prompt stays stable within a session and cache reads keep hitting. A
+ * memory written mid-session becomes visible in the NEXT session; the model
+ * can always read the directory directly for the immediate need.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { isAbsolute, join, resolve } from "node:path";
+import { MEMORY_GUIDE_RULES, memoryGuideIntro } from "./memory-guide.js";
+/** Name of the injected section (unique — duplicate names throw upstream). */
+export const MEMORY_SECTION_NAME = "evolve:memory-index";
+/** Default prompt-section order (empty 1–499 slot; upstream named slots start at 500). */
+export const DEFAULT_MEMORY_SECTION_ORDER = 400;
+/** Default hard character budget for the injected index. */
+export const DEFAULT_MAX_CHARS = 6000;
+/** Sessions whose frozen section text is kept before LRU eviction. */
+export const DEFAULT_FROZEN_SESSIONS = 32;
+const MEMORY_DIR_SEGMENTS = [".evolve", "memory"];
+const INDEX_FILE = "MEMORY.md";
+/** Starter index written on first use; the model maintains every line after. */
+const STARTER_INDEX = "# 记忆索引\n\n<!-- 一行一条：- [标题](文件名.md) — 一句话相关性钩子；写新记忆后在此追加一行 -->\n";
+/** Appended to the workspace .gitignore on bootstrap (git workspaces only). */
+const GITIGNORE_ENTRY = "# workspace memory (dsh-continual-evolve)\n.evolve/\n";
+/** The assembling agent's validated absolute cwd, or undefined when absent. */
+export function cwdOf(agent) {
+    try {
+        const header = agent?.session?.header;
+        const raw = header?.cwd ?? header?.meta?.cwd;
+        if (typeof raw !== "string" || raw.trim().length === 0) {
+            return undefined;
+        }
+        const cwd = raw.trim();
+        if (!isAbsolute(cwd)) {
+            return undefined;
+        }
+        return resolve(cwd);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Absolute memory directory for a workspace root. */
+export function memoryDirFor(cwd) {
+    return join(resolve(cwd), ...MEMORY_DIR_SEGMENTS);
+}
+/**
+ * Ensure `.evolve/` is ignored when the workspace is a git repository, so
+ * the memory store never shows up in git status. Best-effort hygiene: a
+ * non-git workspace (no `.git` entry at the cwd) is left untouched — no
+ * `.gitignore` is created — and any write failure is swallowed.
+ */
+export function ensureGitIgnored(cwd) {
+    try {
+        if (!existsSync(join(cwd, ".git"))) {
+            return;
+        }
+        const gitignore = join(cwd, ".gitignore");
+        const existing = existsSync(gitignore) ? readFileSync(gitignore, "utf8") : "";
+        if (existing.split("\n").some((line) => line.trim() === ".evolve/")) {
+            return;
+        }
+        const prefix = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+        writeFileSync(gitignore, `${existing}${prefix}${GITIGNORE_ENTRY}`, "utf8");
+    }
+    catch {
+        // Never blocks the store; worst case is a visible .evolve/ in git status.
+    }
+}
+/**
+ * Ensure the store exists (creating the directory and a starter index on
+ * first use), then return the trimmed index text. Any filesystem failure
+ * degrades to "" — injection must never break an assembly.
+ */
+export function readMemoryIndex(dir, bootstrap = true) {
+    try {
+        if (bootstrap && !existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+            writeFileSync(join(dir, INDEX_FILE), STARTER_INDEX, "utf8");
+            ensureGitIgnored(resolve(dir, "..", ".."));
+        }
+        return readFileSync(join(dir, INDEX_FILE), "utf8").trim();
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Whole-line-preserving truncation of the index to `maxChars` characters.
+ * Only index rows that fit whole are shown — a partial markdown row would
+ * corrupt the line the model reads. When not even one row fits, `text` is
+ * "" and `dropped` carries the full length.
+ */
+export function fitIndex(index, maxChars) {
+    const budget = Math.max(0, maxChars);
+    if (index.length <= budget) {
+        return { text: index, dropped: 0 };
+    }
+    const cut = index.slice(0, budget);
+    const lastLine = cut.lastIndexOf("\n");
+    if (lastLine <= 0) {
+        return { text: "", dropped: index.length };
+    }
+    const text = cut.slice(0, lastLine);
+    return { text, dropped: index.length - text.length };
+}
+/**
+ * Compose the full memory section for one assembling agent: the guide
+ * wrapped around the budget-bounded index, with the absolute store path
+ * handed out so the model can read and write the files directly. With the
+ * guide off and an empty index the result is "" — the prompt renderer then
+ * drops the section, so an empty workspace costs zero tokens.
+ */
+export function memorySectionText(agent, opts) {
+    const guide = opts?.guide ?? true;
+    const maxChars = opts?.maxChars ?? DEFAULT_MAX_CHARS;
+    const cwd = cwdOf(agent);
+    if (!cwd) {
+        return "";
+    }
+    const dir = memoryDirFor(cwd);
+    const index = readMemoryIndex(dir, opts?.bootstrap ?? true);
+    const { text, dropped } = fitIndex(index, maxChars);
+    const parts = [];
+    if (index.length === 0) {
+        parts.push("<memories>\n（暂无记忆）\n</memories>");
+    }
+    else if (text.length > 0) {
+        parts.push(`<memories>\n${text}\n</memories>`);
+        if (dropped > 0) {
+            parts.push(`（索引超出 ${maxChars} 字符预算，已截断——其余记忆直接读取 \`${dir}/\` 目录）`);
+        }
+    }
+    else {
+        parts.push(`（索引超出 ${maxChars} 字符预算，一行都放不下——记忆直接读取 \`${dir}/\` 目录）`);
+    }
+    if (!guide) {
+        return index.length === 0 ? "" : parts.join("\n\n");
+    }
+    return [memoryGuideIntro(dir), ...parts, MEMORY_GUIDE_RULES].join("\n\n");
+}
+/**
+ * Freeze the section text per agent id. The frozen value is what keeps the
+ * system prompt stable across a session's assemblies (prompt-cache guard);
+ * bounded by `maxSessions` with insertion-order (LRU) eviction, so a
+ * long-lived process cannot grow without limit.
+ */
+export function createFrozenMemorySection(maxSessions = DEFAULT_FROZEN_SESSIONS) {
+    const limit = Math.max(1, maxSessions);
+    const frozen = new Map();
+    return {
+        textFor(agent, build) {
+            const id = agent?.id;
+            const key = typeof id === "string" && id.length > 0 ? id : undefined;
+            if (key === undefined) {
+                return build(agent);
+            }
+            const cached = frozen.get(key);
+            if (cached !== undefined) {
+                return cached;
+            }
+            const text = build(agent);
+            frozen.set(key, text);
+            while (frozen.size > limit) {
+                const oldest = frozen.keys().next();
+                if (oldest.done === true) {
+                    break;
+                }
+                frozen.delete(oldest.value);
+            }
+            return text;
+        },
+        size: () => frozen.size,
+        clear: () => frozen.clear(),
+    };
+}
+//# sourceMappingURL=memory-section.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-continual-evolve",
-  "version": "0.11.0",
-  "description": "Continual self-evolution plugin for DeepSeek Harness: versioned, auditable, rollback-safe harness state (prompt notes, memories, skills, subagent specs) refined from session trajectories.",
+  "version": "0.12.0",
+  "description": "ZCode-style workspace memory for DeepSeek Harness: a per-workspace markdown store (<workspace>/.evolve/memory/) with session-start index injection — the model reads and writes the files with its native tools.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -19,10 +19,6 @@
       "types": "./lib/index.d.ts",
       "default": "./lib/index.js"
     },
-    "./types": {
-      "types": "./lib/types.d.ts",
-      "default": "./lib/types.js"
-    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -51,7 +47,6 @@
     "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.scripts.json --noEmit",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
-    "coverage:gaps": "tsx scripts/coverage-gaps.ts",
     "test:watch": "vitest",
     "lint": "oxlint src test",
     "clean": "rm -rf lib",
@@ -60,19 +55,9 @@
     "check:governance": "tsx scripts/verify-governance.ts"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.6 || ^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6 || ^0.1.7-rc.1 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6 || ^0.1.7-rc.1 || ^0.2.0-rc.1",
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.4",
-    "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-commands": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-home-paths": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-tools": "0.2.0-rc.2",
     "@deepseek-ai/schemastery": "3.18.4",
     "@types/node": "^22.10.0",
     "@vitest/coverage-v8": "^3.2.0",

package/lib/apply.d.ts

@@ -1,22 +0,0 @@
-/**
- * The apply pass: turn a validated proposal into state changes with full
- * per-edit accounting. Every failure is recorded per edit — a bad edit never
- * invalidates the whole proposal — and optimistic-concurrency checks reject
- * edits whose target entry changed while planning was in flight.
- */
-import type { EntrySource, HarnessScope, HarnessState, RefinementProposal, RefinementResult } from "./types.js";
-export interface ApplyOptions {
-    id: string;
-    scope?: HarnessScope;
-    rollbackOf?: string;
-    /** State captured before planning; used to reject conflicting edits. */
-    baselineState?: HarnessState;
-    /**
-     * Trajectory citation stamped into newly created entries' metadata
-     * (sourceSession + sourceSeqs); updates keep whatever the entry already
-     * carries. Omitted entirely when the caller cannot determine it.
-     */
-    source?: EntrySource;
-}
-export declare function applyRefinementProposal(state: HarnessState, proposal: RefinementProposal, options: ApplyOptions): RefinementResult;
-//# sourceMappingURL=apply.d.ts.map

package/lib/apply.js

@@ -1,157 +0,0 @@
-import { SOURCE_SESSION_KEY, SOURCE_SEQS_KEY, ARCHIVED_AT_KEY, cloneEntry, isArchived, slug } from "./types.js";
-import { entryChangedSince } from "./state.js";
-import { validateEdit } from "./validate.js";
-export function applyRefinementProposal(state, proposal, options) {
-    const appliedEdits = [];
-    const touched = new Set();
-    const now = new Date().toISOString();
-    for (const edit of proposal.edits) {
-        // Store-prefix hygiene: planner edits are written against the MERGED
-        // view, where colliding project/local ids carry a `project:` /
-        // `local:` / `global:` prefix. A CREATE must never bake that view
-        // prefix into a permanent id (observed: global entries literally
-        // named "local:handoff_todo_…").
-        // Non-create edits address existing entries: the literal id wins —
-        // legacy stores contain entries whose literal id carries a colon
-        // prefix, and stripping unconditionally would resolve them to a
-        // sibling that does not exist ("entry not found", forcing file-level
-        // surgery). Only when the literal id is absent does the stripped
-        // form serve as the merged-view fallback.
-        // (Review audit 2026-08-28 S7 origin; literal-first fix 2026-09-24.)
-        const strippedId = edit.id?.replace(/^(?:local|project|global):/, "");
-        const requestedId = edit.action === "create"
-            ? strippedId
-            : edit.id !== undefined && state.entries[edit.kind]?.[edit.id] !== undefined
-                ? edit.id
-                : edit.id && strippedId;
-        const computedId = requestedId ?? (edit.action === "create" ? slug(edit.title ?? edit.kind, edit.kind) : undefined);
-        const id = computedId ?? "";
-        // Unknown kinds fail per-edit — a malformed proposal must never crash
-        // the whole pass (review audit 2026-08-28 S1).
-        const records = state.entries[edit.kind];
-        if (!records) {
-            appliedEdits.push({ ...edit, id, applied: false, error: `unsupported kind ${String(edit.kind)}` });
-            continue;
-        }
-        const before = cloneEntry(records[id]);
-        const entryKey = `${edit.kind}:${id}`;
-        if (options.baselineState && !touched.has(entryKey) && entryChangedSince(options.baselineState, state, edit.kind, id)) {
-            appliedEdits.push({
-                ...edit,
-                id,
-                ...(before ? { before } : {}),
-                applied: false,
-                error: "entry changed during planning",
-            });
-            continue;
-        }
-        // Validation sees the current entry so update rules can distinguish
-        // "carrying the persisted value" from "changing it" (skill_kind).
-        const validationError = validateEdit(edit, computedId, options.scope, before);
-        if (validationError) {
-            appliedEdits.push({ ...edit, id, applied: false, error: validationError });
-            continue;
-        }
-        if (edit.action === "delete") {
-            if (!before) {
-                appliedEdits.push({ ...edit, id, applied: false, error: "entry not found" });
-                continue;
-            }
-            delete records[id];
-            touched.add(entryKey);
-            appliedEdits.push({ ...edit, id, before, applied: true });
-            continue;
-        }
-        if (edit.action === "archive") {
-            // Archive hides an entry from injection but never deletes it:
-            // metadata.archivedAt is stamped through the normal apply path, so
-            // the edit gets a before/after snapshot, a version bump, and a
-            // rollback inverse like any other edit (restoring the snapshot
-            // clears the stamp). Idempotency is explicit: re-archiving an
-            // already-archived entry is an error, not a silent no-op.
-            if (!before) {
-                appliedEdits.push({ ...edit, id, applied: false, error: "entry not found" });
-                continue;
-            }
-            if (isArchived(before)) {
-                appliedEdits.push({ ...edit, id, before, applied: false, error: "entry already archived" });
-                continue;
-            }
-            const after = {
-                ...before,
-                metadata: { ...before.metadata, [ARCHIVED_AT_KEY]: now },
-                updated_at: now,
-                version: before.version + 1,
-            };
-            records[id] = after;
-            touched.add(entryKey);
-            appliedEdits.push({ ...edit, id, before, after: cloneEntry(after) ?? after, applied: true });
-            continue;
-        }
-        if (edit.action === "create" && before) {
-            appliedEdits.push({ ...edit, id, before, applied: false, error: "entry already exists" });
-            continue;
-        }
-        if (edit.action === "update" && !before) {
-            appliedEdits.push({ ...edit, id, applied: false, error: "entry not found" });
-            continue;
-        }
-        // Trajectory citation: stamped on create (the distillation moment),
-        // never re-stamped on update (the entry keeps its original source).
-        // Model-supplied metadata wins on key collision.
-        const sourceMetadata = !before && options.source
-            ? {
-                [SOURCE_SESSION_KEY]: options.source.sessionId,
-                ...(options.source.seqs && options.source.seqs.length > 0
-                    ? { [SOURCE_SEQS_KEY]: options.source.seqs }
-                    : {}),
-            }
-            : {};
-        const skillKind = edit.skill_kind ?? before?.skill_kind;
-        const after = {
-            id,
-            kind: edit.kind,
-            title: edit.title ?? before?.title ?? id,
-            content: edit.content ?? before?.content ?? "",
-            path: edit.path ?? before?.path ?? "general",
-            scope: before?.scope ?? options.scope ?? "local",
-            reference: edit.reference ?? before?.reference ?? {},
-            arguments: edit.arguments ?? before?.arguments ?? {},
-            ...(skillKind !== undefined ? { skill_kind: skillKind } : {}),
-            metadata: { ...sourceMetadata, ...(edit.metadata ?? before?.metadata ?? {}) },
-            source: "evolve",
-            created_at: before?.created_at ?? now,
-            updated_at: now,
-            version: before ? before.version + 1 : 1,
-        };
-        records[id] = after;
-        touched.add(entryKey);
-        appliedEdits.push({
-            ...edit,
-            id,
-            ...(before ? { before } : {}),
-            after: cloneEntry(after) ?? after,
-            applied: true,
-        });
-    }
-    const changes = appliedEdits.filter((edit) => edit.applied).map((edit) => `${edit.action} ${edit.kind}:${edit.id}`);
-    state.refinements.push({
-        id: options.id,
-        trigger: proposal.summary,
-        changes,
-        evidence: proposal.rationale,
-        outcome: proposal.expectedOutcome,
-        created_at: now,
-    });
-    return {
-        id: options.id,
-        summary: proposal.summary,
-        rationale: proposal.rationale,
-        expectedOutcome: proposal.expectedOutcome,
-        appliedEdits,
-        harnessStatePath: "",
-        ...(options.rollbackOf ? { rollbackOf: options.rollbackOf } : {}),
-        ...(options.scope ? { scope: options.scope } : {}),
-    };
-}
-//# sourceMappingURL=apply.js.map