@themoltnet/pi-extension 0.32.1 → 0.33.0

package/dist/index.js

@@ -18037,7 +18037,7 @@ function createMoltNetTools(config) {
 	const searchEntries = defineTool({
 		name: "moltnet_search_entries",
 		label: "Search MoltNet Diary Entries",
-		description: "Hybrid (semantic + lexical) search over diary entries. Optional tags / excludeTags / entryTypes filters AND with the query; the taskFilter shorthand expands into task:* provenance tags so `taskFilter: { taskType: \"fulfill_brief\" }` returns only entries from fulfill_brief attempts. Filters apply server-side before ranking.",
+		description: "Hybrid (semantic + lexical) search over diary entries. Use proactively before non-trivial investigation, code changes, review, or episodic incident capture so prior decisions and recurring failures surface before you act. Do not search randomly: pass taskFilter for task/correlation-local searches and tags or entryTypes for broader prior-knowledge searches. Optional tags / excludeTags / entryTypes filters AND with the query; the taskFilter shorthand expands into task:* provenance tags so `taskFilter: { taskType: \"fulfill_brief\" }` returns only entries from fulfill_brief attempts. Filters apply server-side before ranking.",
 		parameters: Type.Object({
 			query: Type.String({ description: "Natural language search query" }),
 			limit: Type.Optional(Type.Number({ description: "Max results (default 5)" })),
@@ -18096,12 +18096,18 @@ function createMoltNetTools(config) {
 	const createEntry = defineTool({
 		name: "moltnet_create_entry",
 		label: "Create MoltNet Diary Entry",
-		description: "Create a new diary entry to record decisions, findings, incidents, or reflections. During an active task, the entry is forced into the task diary and tagged with the task:* provenance namespace (task:id:<id>, task:type:<type>, task:attempt:<n>, plus task:correlation:<id> when set); an explicit diaryId mismatching the task diary is rejected. Use this tool — NOT `moltnet entry create` / `moltnet entry create-signed` via bash. The CLI path bypasses task-tag auto-injection and leaves entries invisible to taskFilter queries.",
+		description: "Create a new diary entry to record decisions, findings, incidents, or reflections. Before creating an episodic incident entry, first call moltnet_search_entries with the title/root-cause/error/watch-for terms plus taskFilter, tags, or entryTypes filters, then reference close matches instead of creating an isolated duplicate. During an active task, the entry is forced into the task diary and tagged with the task:* provenance namespace (task:id:<id>, task:type:<type>, task:attempt:<n>, plus task:correlation:<id> when set); an explicit diaryId mismatching the task diary is rejected. Use this tool — NOT `moltnet entry create` / `moltnet entry create-signed` via bash. The CLI path bypasses task-tag auto-injection and leaves entries invisible to taskFilter queries.",
 		parameters: Type.Object({
 			title: Type.String({ description: "Entry title (concise, descriptive)" }),
 			content: Type.String({ description: "Entry content (markdown)" }),
 			tags: Type.Optional(Type.Array(Type.String(), { description: "Tags for categorization" })),
 			importance: Type.Optional(Type.Number({ description: "Importance 1-10 (default 5)" })),
+			entryType: Type.Optional(Type.Union([
+				Type.Literal("episodic"),
+				Type.Literal("semantic"),
+				Type.Literal("procedural"),
+				Type.Literal("reflection")
+			], { description: "Entry type. Use episodic for incidents, workarounds, bugs, or recurrence evidence; defaults to semantic." })),
 			diaryId: Type.Optional(Type.String({ description: "Explicit diary id. During an active task, must match the task diary or the call is rejected. Outside a task, overrides the env-derived diary." }))
 		}),
 		async execute(_id, params) {
@@ -18125,7 +18131,8 @@ function createMoltNetTools(config) {
 				title: params.title,
 				content: params.content,
 				tags: mergedTags,
-				importance: params.importance ?? 5
+				importance: params.importance ?? 5,
+				...params.entryType ? { entryType: params.entryType } : {}
 			});
 			return {
 				content: [{
@@ -18135,6 +18142,8 @@ function createMoltNetTools(config) {
 						title: entry.title,
 						createdAt: entry.createdAt,
 						diaryId: targetDiaryId,
+						entryType: entry.entryType,
+						importance: entry.importance,
 						tags: mergedTags
 					}, null, 2)
 				}],
@@ -18514,6 +18523,29 @@ function buildRuntimeInstructor(ctx) {
 		"  requires human approval and is unavailable in headless task runs;",
 		"  never use it for routine git/gh.",
 		"",
+		"## Proactive memory use",
+		"",
+		"- Before non-trivial investigation, debugging, code changes, or review,",
+		"  check the task diary for relevant prior knowledge instead of waiting",
+		"  for a human to ask. Use `moltnet_diary_tags` for cheap reconnaissance,",
+		"  `moltnet_list_entries` when tags or task provenance are known, and",
+		"  `moltnet_search_entries` for semantic similarity. Do not search",
+		"  randomly: pass `taskFilter` for task-local or correlation-local",
+		"  queries, and pass `tags` / `entryTypes` for broader prior-knowledge",
+		"  queries using known tags such as `incident`, `decision`, or",
+		"  `scope:<area>`. Broaden only after constrained searches miss.",
+		"- Before creating an `episodic` incident entry, you MUST search for",
+		"  similar incidents using the proposed title, root cause, error text,",
+		"  affected subsystem, and watch-for terms, filtered by `entryTypes:",
+		"  [\"episodic\", \"semantic\"]` and any known `scope:*` / task provenance",
+		"  tags. If a close prior match exists, do not create an isolated",
+		"  duplicate: reference the prior entry in your response or diary content,",
+		"  update/link it when the new occurrence adds material evidence, or",
+		"  create a new recurrence entry only when the recurrence itself is",
+		"  important signal.",
+		"- When you create a recurrence entry, include the prior matching entry",
+		"  id(s) in the content and explain what is new about this occurrence.",
+		"",
 		"## Diary discipline",
 		"",
 		`- During this task, every diary entry MUST land in \`${ctx.diaryId}\``,
@@ -20114,6 +20146,22 @@ function buildFinalOutputBlock(opts) {
 	return lines.join("\n");
 }
 //#endregion
+//#region ../agent-runtime/src/prompts/proactive-memory.ts
+function buildProactiveMemoryWorkflowBlock() {
+	return [
+		"Before material work, apply the runtime instructor's proactive memory",
+		"rules instead of waiting for a human prompt. Start with constrained",
+		"diary context: inspect tags/list entries when task provenance or scope",
+		"tags are known, then use `moltnet_search_entries` with `taskFilter`,",
+		"`entryTypes`, and tags. Do not run broad unfiltered searches before",
+		"constrained searches miss.",
+		"",
+		"For incident capture, follow the runtime instructor exactly: search",
+		"for similar episodic/semantic entries first, reference close matches,",
+		"and create a recurrence entry only when the repeat is useful signal."
+	].join("\n");
+}
+//#endregion
 //#region ../agent-runtime/src/prompts/rubric-common.ts
 function renderRubricCriteriaList(rubric) {
 	return rubric.criteria.map((c, i) => `${i + 1}. **${c.id}** (weight ${c.weight}, scoring: \`${c.scoring}\`) — ${c.description}`).join("\n");
@@ -20215,6 +20263,12 @@ function buildAssessBriefUserPrompt(input, ctx) {
 			header: "Querying the producer's diary entries",
 			body: diaryQuery
 		},
+		{
+			id: "assess_brief.proactive_memory",
+			source: "discipline",
+			header: "Proactive memory use",
+			body: buildProactiveMemoryWorkflowBlock()
+		},
 		{
 			id: "assess_brief.workspace",
 			source: "workspace",
@@ -20542,11 +20596,13 @@ function buildFreeformUserPrompt(input, ctx) {
 	const suggestedTaskType = input.suggestedTaskType ? [`The proposer suggested task type \`${input.suggestedTaskType}\`.`, "Use it as a hint, not as a contract."].join("\n") : "";
 	const workflow = [
 		"1. Clarify the real objective from the brief before acting.",
-		"2. Gather enough context to avoid guessing.",
-		"3. Complete the requested work when it is safe and bounded.",
-		"4. If the request reveals a recurring task shape, include a",
+		"2. Search MoltNet diary memory for prior decisions, incidents, and",
+		"   recurring traps relevant to the brief.",
+		"3. Gather enough context to avoid guessing.",
+		"4. Complete the requested work when it is safe and bounded.",
+		"5. If the request reveals a recurring task shape, include a",
 		"   `proposedTaskType` in the final output with a concise rationale.",
-		"5. If you changed code on a branch, include that branch in",
+		"6. If you changed code on a branch, include that branch in",
 		"   `branch` so future continuations can recover git context."
 	].join("\n");
 	const sections = [
@@ -20585,6 +20641,12 @@ function buildFreeformUserPrompt(input, ctx) {
 			header: "Workflow",
 			body: workflow
 		},
+		{
+			id: "freeform.proactive_memory",
+			source: "discipline",
+			header: "Proactive memory use",
+			body: buildProactiveMemoryWorkflowBlock()
+		},
 		{
 			id: "freeform.verification",
 			source: "verification",
@@ -20661,13 +20723,15 @@ function buildFulfillBriefUserPrompt(input, ctx) {
 	].join("\n") : "";
 	const workflow = [
 		ctx.workspace?.mode === "dedicated_worktree" ? `1. Use the already-provisioned dedicated worktree branch${ctx.workspace.branch ? ` (\`${ctx.workspace.branch}\`)` : ""}; do not create or switch the primary checkout.` : `1. Create a feature branch (starting prefix suggestion: \`${branchSlug}<short-slug>\`).`,
-		"2. Understand the problem — read relevant code; do not speculate.",
-		"3. Implement the change. Keep commits small and coherent.",
-		"4. Add tests if applicable.",
-		"5. For every commit, create a signed diary entry first via",
+		"2. Search MoltNet diary memory for prior decisions, incidents, and",
+		"   recurring traps relevant to the brief before changing code.",
+		"3. Understand the problem — read relevant code; do not speculate.",
+		"4. Implement the change. Keep commits small and coherent.",
+		"5. Add tests if applicable.",
+		"6. For every commit, create a signed diary entry first via",
 		"   `moltnet_create_entry` and embed its id in the commit trailer",
 		"   `MoltNet-Diary: <id>` (per the runtime instructor).",
-		"6. Push the branch and open a PR — run `git push` and `gh pr create`",
+		"7. Push the branch and open a PR — run `git push` and `gh pr create`",
 		"   IN the VM with your normal `bash` tool (use the",
 		"   `GH_TOKEN=$(moltnet github token …) gh …` form from the runtime",
 		"   instructor). Do NOT use `moltnet_host_exec` for this; it needs human",
@@ -20709,6 +20773,12 @@ function buildFulfillBriefUserPrompt(input, ctx) {
 			header: "Workflow",
 			body: workflow
 		},
+		{
+			id: "fulfill_brief.proactive_memory",
+			source: "discipline",
+			header: "Proactive memory use",
+			body: buildProactiveMemoryWorkflowBlock()
+		},
 		{
 			id: "fulfill_brief.verification",
 			source: "verification",
@@ -21024,13 +21094,15 @@ function buildPrReviewUserPrompt(input, ctx) {
 	const workflow = [
 		"1. Read the subject summary, resources, inspection hints, and any",
 		"   task-specific instructions before scoring.",
-		"2. Inspect the target artefact directly using the tools and resources the",
+		"2. Search MoltNet diary memory for prior decisions, incidents, and",
+		"   recurring review traps relevant to the subject.",
+		"3. Inspect the target artefact directly using the tools and resources the",
 		"   task makes available.",
-		"3. If you are in a dedicated disposable worktree and need the review target",
+		"4. If you are in a dedicated disposable worktree and need the review target",
 		"   checked out locally, do that work inside this disposable workspace only.",
-		"4. Apply the rubric strictly. This task is about complexity and",
+		"5. Apply the rubric strictly. This task is about complexity and",
 		"   reviewability, not correctness or feature desirability.",
-		"5. Perform any required outward action before emitting the final",
+		"6. Perform any required outward action before emitting the final",
 		"   structured output."
 	].join("\n");
 	const taskPromptSection = input.taskPrompt ?? "";
@@ -21087,6 +21159,12 @@ function buildPrReviewUserPrompt(input, ctx) {
 			header: "Review workflow",
 			body: workflow
 		},
+		{
+			id: "pr_review.proactive_memory",
+			source: "discipline",
+			header: "Proactive memory use",
+			body: buildProactiveMemoryWorkflowBlock()
+		},
 		{
 			id: "pr_review.task_prompt",
 			source: "task_input",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@themoltnet/pi-extension",
-  "version": "0.32.1",
+  "version": "0.33.0",
   "type": "module",
   "description": "MoltNet pi extension — sandboxed tool execution in Gondolin VMs with MoltNet identity and persistent memory",
   "keywords": [
@@ -36,8 +36,8 @@
     "@earendil-works/gondolin": "^0.9.1",
     "@opentelemetry/api": "^1.9.0",
     "typebox": "^1.2.8",
-    "@themoltnet/sdk": "0.119.0",
-    "@themoltnet/agent-runtime": "0.34.1"
+    "@themoltnet/agent-runtime": "0.35.0",
+    "@themoltnet/sdk": "0.119.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": ">=0.74.0",