@fonlan/dsh-gitmemo 0.1.5 → 0.3.0

package/lib/index.d.ts

@@ -2,14 +2,21 @@
  * dsh-gitmemo — Git-backed long-term memory for DeepSeek Harness.
  *
  * A Cordis plugin mirroring gitmemo (https://github.com/fonlan/gitmemo):
- * the agent stores completed task outcomes as markdown entries in a local
- * `.mem` git repository and searches them before starting new work.
+ * the root agent stores completed task outcomes as immutable markdown
+ * entries in a local `.mem` git repository (single `main` branch, structured
+ * commit messages) and searches them before starting new work.
  *
- * This plugin registers on the host plane:
- *  - five model-facing tools: `mem_init`, `mem_search`, `mem_read`,
- *    `mem_write`, `mem_delete` (backed by {@link GitMemo});
- *  - an always-on system-prompt section with the full memory workflow rules;
- *  - a per-session seed of the most recent memory titles.
+ * Mechanism:
+ *  - only ROOT agents (delegationDepth === 0) receive the gitmemo workflow
+ *    section and the five `mem_*` tools, scoped into `agent.ctx` at
+ *    `agent/created`; subagents carry neither (no token cost, no duplicate
+ *    memory writes);
+ *  - registration performs zero Git I/O;
+ *  - no session-start seeding, no synchronous git runners, no branch
+ *    alignment — `.mem` permanently stays on `main`;
+ *  - the previous `mem_init` tool is gone from the model surface; legacy
+ *    argument shapes are accepted for one version by the core engine
+ *    compatibility adapter, while the model-facing schemas stay strict.
  *
  * @module dsh-gitmemo
  */
@@ -18,37 +25,34 @@ import z from "@deepseek-ai/schemastery";
 declare const name = "dsh-gitmemo";
 /** Host services this plugin needs. */
 declare const inject: string[];
-/** Plugin configuration (all optional). */
+/** Plugin configuration. */
 declare const Config: z<Schemastery.ObjectS<{
-    /** Name of the memory repo directory at the project root. Default ".mem". */
+    /** @deprecated — the memory dir is fixed at `<projectRoot>/.mem`; kept for one version. */
     memDirName: z<string, string>;
-    /** Max search hits per mem_search call. Default 20. */
+    /** Max search hits per mem_search call (page size). Default 20. */
     searchLimit: z<number, number>;
-    /** Align the .mem branch with the project branch on writes. Default true. */
+    /** @deprecated — `.mem` always stays on main; kept for one version, no effect. */
     branchAlign: z<boolean, boolean>;
-    /** Number of most recent memory titles injected into each new session's system prompt (0 disables). Default 5. */
+    /** @deprecated — session-start recent seeding was removed; kept for one version, no effect. */
     recentContextLimit: z<number, number>;
+    /** Cross-process lock wait timeout in milliseconds. Default 30000. */
+    lockTimeoutMs: z<number, number>;
     /** Optional explicit project root; defaults to the calling session's cwd. */
     projectRoot: z<string, string>;
 }>, Schemastery.ObjectT<{
-    /** Name of the memory repo directory at the project root. Default ".mem". */
+    /** @deprecated — the memory dir is fixed at `<projectRoot>/.mem`; kept for one version. */
     memDirName: z<string, string>;
-    /** Max search hits per mem_search call. Default 20. */
+    /** Max search hits per mem_search call (page size). Default 20. */
     searchLimit: z<number, number>;
-    /** Align the .mem branch with the project branch on writes. Default true. */
+    /** @deprecated — `.mem` always stays on main; kept for one version, no effect. */
     branchAlign: z<boolean, boolean>;
-    /** Number of most recent memory titles injected into each new session's system prompt (0 disables). Default 5. */
+    /** @deprecated — session-start recent seeding was removed; kept for one version, no effect. */
     recentContextLimit: z<number, number>;
+    /** Cross-process lock wait timeout in milliseconds. Default 30000. */
+    lockTimeoutMs: z<number, number>;
     /** Optional explicit project root; defaults to the calling session's cwd. */
     projectRoot: z<string, string>;
 }>>;
-interface ResolvedConfig {
-    memDirName: string;
-    searchLimit: number;
-    branchAlign: boolean;
-    recentContextLimit: number;
-    projectRoot?: string;
-}
 /** Shape of the agent payload received by an `agent/created` listener. */
 interface CreatedAgent {
     id: string;
@@ -59,8 +63,11 @@ interface CreatedAgent {
         };
     };
     ctx: {
+        tools: {
+            register(tool: unknown): unknown;
+        };
         systemPrompt: {
-            context(section: {
+            section(section: {
                 name: string;
                 order: number;
                 text: string;
@@ -69,26 +76,23 @@ interface CreatedAgent {
     };
 }
 /**
- * Register the plugin: tools, always-on rules, and session-start seed.
- * @param ctx - registrant context carrying the host tool/prompt services.
- * @param config - plugin configuration (defaults applied by the loader).
+ * Register the plugin: root-agent-scoped mem tools + workflow rules. No
+ * global tool registration, no session-start seeding, no Git I/O at
+ * registration time.
  */
 declare function apply(ctx: {
-    tools: {
-        register(tool: unknown): unknown;
-    };
-    systemPrompt: {
-        section(section: {
-            name: string;
-            order: number;
-            text: string;
-        }): unknown;
-    };
     on(event: string, handler: (payload: {
         agent: CreatedAgent;
     }) => void): unknown;
     logger: {
         warn(message: string): void;
     };
-}, config?: Partial<ResolvedConfig>): Promise<void>;
+}, config?: Partial<{
+    memDirName?: string;
+    searchLimit?: number;
+    branchAlign?: boolean;
+    recentContextLimit?: number;
+    lockTimeoutMs?: number;
+    projectRoot?: string;
+}>): Promise<void>;
 export { Config, apply, inject, name };