@ijfw/memory-server 1.4.4 → 1.5.1

package/bin/ijfw-memorize

@@ -4,9 +4,13 @@
 // payload on stdin (Stop-hook json), produces structured memory entries,
 // and appends them to .ijfw/memory/knowledge.md via the existing store helpers.
 //
-// Deterministic by default: feedback/signals promote 1:1. LLM-based synthesis
-// activates only when IJFW_AUTOMEM_MODEL is set (documented as a wiring point;
-// current build emits a TODO marker instead of calling an LLM).
+// Deterministic by default: feedback/signals promote 1:1 directly into
+// knowledge.md -- this is the fully-functional production path. When
+// IJFW_AUTOMEM_MODEL is set, an additional LLM-synthesis path runs: it
+// appends a {pending:true} record to .ijfw/.automem-llm-queue.jsonl for
+// later batch processing. That is a deliberate deferred-queue design (the
+// queue decouples session-end from the LLM call) -- NOT an unimplemented
+// stub. It never writes literal TODO text into user memory.
 //
 // Consent: reads .ijfw/.automem-consent. If absent or consented=false, exits 0
 // silently. User sets consent via `/ijfw memory consent yes|no|ask`.
@@ -241,11 +245,14 @@ async function main() {
     thisRunSummaries.add(capped.summary);
   }
 
-  // TODO: LLM-synthesis path (IJFW_AUTOMEM_MODEL). Stub emits a marker
-  // so downstream tooling can detect that a richer synthesis could run.
+  // LLM-synthesis path (IJFW_AUTOMEM_MODEL). When a model is configured,
+  // enqueue a {pending:true} record onto .ijfw/.automem-llm-queue.jsonl for
+  // batch processing by the LLM-synthesis worker. This is a deliberate
+  // deferred-queue design -- the queue decouples the latency-sensitive
+  // session-end hook from the LLM round-trip -- not an unimplemented stub.
+  // Nothing here is written into user memory (knowledge.md); the queue file
+  // is a separate, internal work list.
   if (process.env.IJFW_AUTOMEM_MODEL && process.env.IJFW_AUTOMEM_MODEL !== 'off') {
-    // Wiring point -- Phase 5+ connects this to Anthropic SDK / Ollama.
-    // For now, record the opportunity.
     try {
       mkdirSync(IJFW_DIR, { recursive: true });
       appendFileSync(join(IJFW_DIR, '.automem-llm-queue.jsonl'),

package/fixtures/team/book.json

@@ -5,7 +5,7 @@
     "project_archetypes": ["book"],
     "roles": [
       {
-        "name": "chapter-writer",
+        "name": "ijfw-line-editor",
         "role_type": "book",
         "model": "sonnet",
         "effort": "medium",
@@ -16,7 +16,7 @@
         "coordination": {"parallel_safe": true, "claim_required": true, "conflicts_with": ["manuscript/chapters/**"]}
       },
       {
-        "name": "continuity-editor",
+        "name": "ijfw-narrative-continuity-checker",
         "role_type": "review",
         "model": "sonnet",
         "effort": "medium",
@@ -32,8 +32,8 @@
     "schema_version": "team-workflow/v1",
     "project_archetypes": ["book"],
     "artifacts": [
-      {"id": "chapter-draft", "type": "chapter", "paths": ["manuscript/chapters/ch01.md"], "owner": "chapter-writer", "reviewers": ["continuity-editor"], "depends_on": [], "verification": ["continuity review"]},
-      {"id": "continuity-notes", "type": "continuity_notes", "paths": ["manuscript/notes/continuity.md"], "owner": "continuity-editor", "reviewers": ["chapter-writer"], "depends_on": ["chapter-draft"], "verification": ["open thread audit"]}
+      {"id": "chapter-draft", "type": "chapter", "paths": ["manuscript/chapters/ch01.md"], "owner": "ijfw-line-editor", "reviewers": ["ijfw-narrative-continuity-checker"], "depends_on": [], "verification": ["continuity review"]},
+      {"id": "continuity-notes", "type": "continuity_notes", "paths": ["manuscript/notes/continuity.md"], "owner": "ijfw-narrative-continuity-checker", "reviewers": ["ijfw-line-editor"], "depends_on": ["chapter-draft"], "verification": ["open thread audit"]}
     ],
     "waves": [
       {"id": "w1", "mode": "parallel", "artifact_ids": ["chapter-draft"]},
@@ -41,7 +41,7 @@
     ]
   },
   "blackboard": {
-    "tasks": [{"id": "task-chapter", "title": "Draft chapter one", "status": "ready", "artifact_ids": ["chapter-draft"], "owner": "chapter-writer"}],
-    "claims": [{"id": "claim-chapter", "artifact_id": "chapter-draft", "agent": "chapter-writer", "status": "active", "paths": ["manuscript/chapters/ch01.md"]}]
+    "tasks": [{"id": "task-chapter", "title": "Draft chapter one", "status": "ready", "artifact_ids": ["chapter-draft"], "owner": "ijfw-line-editor"}],
+    "claims": [{"id": "claim-chapter", "artifact_id": "chapter-draft", "agent": "ijfw-line-editor", "status": "active", "paths": ["manuscript/chapters/ch01.md"]}]
   }
 }

package/fixtures/team/business.json

@@ -2,46 +2,172 @@
   "charter": {
     "schema_version": "team-charter/v1",
     "team_name": "strategy-operations-team",
-    "project_archetypes": ["business"],
+    "project_archetypes": [
+      "business"
+    ],
     "roles": [
       {
-        "name": "strategy-lead",
+        "name": "ijfw-strategy-lead",
         "role_type": "business",
         "model": "sonnet",
         "effort": "medium",
-        "phase_scope": ["diagnose", "plan", "decide"],
-        "owns": [{"artifact_type": "strategy_doc", "paths": ["strategy/**"]}],
-        "reviews": [{"artifact_type": "risk_register", "criteria": ["assumptions", "decision-quality"]}],
-        "handoff": {"format": "markdown", "required_sections": ["recommendation", "assumptions", "tradeoffs"]},
-        "coordination": {"parallel_safe": true, "claim_required": true, "conflicts_with": []}
+        "phase_scope": [
+          "diagnose",
+          "plan",
+          "decide"
+        ],
+        "owns": [
+          {
+            "artifact_type": "strategy_doc",
+            "paths": [
+              "strategy/**"
+            ]
+          }
+        ],
+        "reviews": [
+          {
+            "artifact_type": "risk_register",
+            "criteria": [
+              "assumptions",
+              "decision-quality"
+            ]
+          }
+        ],
+        "handoff": {
+          "format": "markdown",
+          "required_sections": [
+            "recommendation",
+            "assumptions",
+            "tradeoffs"
+          ]
+        },
+        "coordination": {
+          "parallel_safe": true,
+          "claim_required": true,
+          "conflicts_with": []
+        }
       },
       {
-        "name": "risk-reviewer",
+        "name": "ijfw-risk-reviewer",
         "role_type": "review",
         "model": "sonnet",
         "effort": "medium",
-        "phase_scope": ["review", "verify"],
-        "owns": [{"artifact_type": "risk_register", "paths": ["strategy/risks/**"]}],
-        "reviews": [{"artifact_type": "strategy_doc", "criteria": ["feasibility", "downside", "metrics"]}],
-        "handoff": {"format": "markdown", "required_sections": ["risks", "mitigations", "decision_points"]},
-        "coordination": {"parallel_safe": true, "claim_required": true, "conflicts_with": []}
+        "phase_scope": [
+          "review",
+          "verify"
+        ],
+        "owns": [
+          {
+            "artifact_type": "risk_register",
+            "paths": [
+              "strategy/risks/**"
+            ]
+          }
+        ],
+        "reviews": [
+          {
+            "artifact_type": "strategy_doc",
+            "criteria": [
+              "feasibility",
+              "downside",
+              "metrics"
+            ]
+          }
+        ],
+        "handoff": {
+          "format": "markdown",
+          "required_sections": [
+            "risks",
+            "mitigations",
+            "decision_points"
+          ]
+        },
+        "coordination": {
+          "parallel_safe": true,
+          "claim_required": true,
+          "conflicts_with": []
+        }
       }
     ]
   },
   "workflow": {
     "schema_version": "team-workflow/v1",
-    "project_archetypes": ["business"],
+    "project_archetypes": [
+      "business"
+    ],
     "artifacts": [
-      {"id": "operating-plan", "type": "strategy_doc", "paths": ["strategy/operating-plan.md"], "owner": "strategy-lead", "reviewers": ["risk-reviewer"], "depends_on": [], "verification": ["decision review"]},
-      {"id": "risk-register", "type": "risk_register", "paths": ["strategy/risks/register.md"], "owner": "risk-reviewer", "reviewers": ["strategy-lead"], "depends_on": ["operating-plan"], "verification": ["assumption audit"]}
+      {
+        "id": "operating-plan",
+        "type": "strategy_doc",
+        "paths": [
+          "strategy/operating-plan.md"
+        ],
+        "owner": "ijfw-strategy-lead",
+        "reviewers": [
+          "ijfw-risk-reviewer"
+        ],
+        "depends_on": [],
+        "verification": [
+          "decision review"
+        ]
+      },
+      {
+        "id": "risk-register",
+        "type": "risk_register",
+        "paths": [
+          "strategy/risks/register.md"
+        ],
+        "owner": "ijfw-risk-reviewer",
+        "reviewers": [
+          "ijfw-strategy-lead"
+        ],
+        "depends_on": [
+          "operating-plan"
+        ],
+        "verification": [
+          "assumption audit"
+        ]
+      }
     ],
     "waves": [
-      {"id": "w1", "mode": "sequential", "artifact_ids": ["operating-plan"]},
-      {"id": "w2", "mode": "review", "artifact_ids": ["risk-register"]}
+      {
+        "id": "w1",
+        "mode": "sequential",
+        "artifact_ids": [
+          "operating-plan"
+        ]
+      },
+      {
+        "id": "w2",
+        "mode": "review",
+        "artifact_ids": [
+          "risk-register"
+        ]
+      }
     ]
   },
   "blackboard": {
-    "tasks": [{"id": "task-plan", "title": "Draft operating plan", "status": "ready", "artifact_ids": ["operating-plan"], "owner": "strategy-lead"}],
-    "claims": [{"id": "claim-plan", "artifact_id": "operating-plan", "agent": "strategy-lead", "status": "active", "paths": ["strategy/operating-plan.md"]}]
+    "tasks": [
+      {
+        "id": "task-plan",
+        "title": "Draft operating plan",
+        "status": "ready",
+        "artifact_ids": [
+          "operating-plan"
+        ],
+        "owner": "ijfw-strategy-lead"
+      }
+    ],
+    "claims": [
+      {
+        "id": "claim-plan",
+        "artifact_id": "operating-plan",
+        "agent": "ijfw-strategy-lead",
+        "status": "active",
+        "paths": [
+          "strategy/operating-plan.md"
+        ]
+      }
+    ]
   }
 }

package/fixtures/team/content.json

@@ -5,7 +5,7 @@
     "project_archetypes": ["content"],
     "roles": [
       {
-        "name": "content-strategist",
+        "name": "ijfw-campaign-strategist",
         "role_type": "content",
         "model": "sonnet",
         "effort": "medium",
@@ -16,7 +16,7 @@
         "coordination": {"parallel_safe": true, "claim_required": true, "conflicts_with": []}
       },
       {
-        "name": "editor",
+        "name": "ijfw-copy-reviewer",
         "role_type": "review",
         "model": "sonnet",
         "effort": "medium",
@@ -32,8 +32,8 @@
     "schema_version": "team-workflow/v1",
     "project_archetypes": ["content"],
     "artifacts": [
-      {"id": "campaign-brief", "type": "brief", "paths": ["content/briefs/campaign.md"], "owner": "content-strategist", "reviewers": ["editor"], "depends_on": [], "verification": ["brand voice review"]},
-      {"id": "article-draft", "type": "article", "paths": ["content/posts/*.mdx"], "owner": "editor", "reviewers": ["content-strategist"], "depends_on": ["campaign-brief"], "verification": ["seo checklist"]}
+      {"id": "campaign-brief", "type": "brief", "paths": ["content/briefs/campaign.md"], "owner": "ijfw-campaign-strategist", "reviewers": ["ijfw-copy-reviewer"], "depends_on": [], "verification": ["brand voice review"]},
+      {"id": "article-draft", "type": "article", "paths": ["content/posts/*.mdx"], "owner": "ijfw-copy-reviewer", "reviewers": ["ijfw-campaign-strategist"], "depends_on": ["campaign-brief"], "verification": ["seo checklist"]}
     ],
     "waves": [
       {"id": "w1", "mode": "sequential", "artifact_ids": ["campaign-brief"]},
@@ -41,7 +41,7 @@
     ]
   },
   "blackboard": {
-    "tasks": [{"id": "task-brief", "title": "Prepare campaign brief", "status": "ready", "artifact_ids": ["campaign-brief"], "owner": "content-strategist"}],
-    "claims": [{"id": "claim-brief", "artifact_id": "campaign-brief", "agent": "content-strategist", "status": "active", "paths": ["content/briefs/campaign.md"]}]
+    "tasks": [{"id": "task-brief", "title": "Prepare campaign brief", "status": "ready", "artifact_ids": ["campaign-brief"], "owner": "ijfw-campaign-strategist"}],
+    "claims": [{"id": "claim-brief", "artifact_id": "campaign-brief", "agent": "ijfw-campaign-strategist", "status": "active", "paths": ["content/briefs/campaign.md"]}]
   }
 }

package/fixtures/team/design.json

@@ -2,46 +2,174 @@
   "charter": {
     "schema_version": "team-charter/v1",
     "team_name": "design-studio-team",
-    "project_archetypes": ["design"],
+    "project_archetypes": [
+      "design"
+    ],
     "roles": [
       {
-        "name": "product-designer",
+        "name": "ijfw-design-critic",
         "role_type": "design",
         "model": "sonnet",
         "effort": "medium",
-        "phase_scope": ["discovery", "shape", "execute"],
-        "owns": [{"artifact_type": "screen", "paths": ["design/screens/**"]}],
-        "reviews": [{"artifact_type": "prototype", "criteria": ["usability", "accessibility"]}],
-        "handoff": {"format": "markdown", "required_sections": ["rationale", "changed_artifacts", "open_questions"]},
-        "coordination": {"parallel_safe": true, "claim_required": true, "conflicts_with": ["design/tokens/**"]}
+        "phase_scope": [
+          "discovery",
+          "shape",
+          "execute"
+        ],
+        "owns": [
+          {
+            "artifact_type": "screen",
+            "paths": [
+              "design/screens/**"
+            ]
+          }
+        ],
+        "reviews": [
+          {
+            "artifact_type": "prototype",
+            "criteria": [
+              "usability",
+              "accessibility"
+            ]
+          }
+        ],
+        "handoff": {
+          "format": "markdown",
+          "required_sections": [
+            "rationale",
+            "changed_artifacts",
+            "open_questions"
+          ]
+        },
+        "coordination": {
+          "parallel_safe": true,
+          "claim_required": true,
+          "conflicts_with": [
+            "design/tokens/**"
+          ]
+        }
       },
       {
-        "name": "visual-qa",
+        "name": "ijfw-accessibility-reviewer",
         "role_type": "review",
         "model": "sonnet",
         "effort": "low",
-        "phase_scope": ["review", "verify"],
-        "owns": [{"artifact_type": "audit", "paths": ["design/reviews/**"]}],
-        "reviews": [{"artifact_type": "screen", "criteria": ["layout", "contrast", "responsive-fit"]}],
-        "handoff": {"format": "markdown", "required_sections": ["findings", "severity", "recommendations"]},
-        "coordination": {"parallel_safe": true, "claim_required": true, "conflicts_with": []}
+        "phase_scope": [
+          "review",
+          "verify"
+        ],
+        "owns": [
+          {
+            "artifact_type": "audit",
+            "paths": [
+              "design/reviews/**"
+            ]
+          }
+        ],
+        "reviews": [
+          {
+            "artifact_type": "screen",
+            "criteria": [
+              "layout",
+              "contrast",
+              "responsive-fit"
+            ]
+          }
+        ],
+        "handoff": {
+          "format": "markdown",
+          "required_sections": [
+            "findings",
+            "severity",
+            "recommendations"
+          ]
+        },
+        "coordination": {
+          "parallel_safe": true,
+          "claim_required": true,
+          "conflicts_with": []
+        }
       }
     ]
   },
   "workflow": {
     "schema_version": "team-workflow/v1",
-    "project_archetypes": ["design"],
+    "project_archetypes": [
+      "design"
+    ],
     "artifacts": [
-      {"id": "screen-system", "type": "screen", "paths": ["design/screens/**"], "owner": "product-designer", "reviewers": ["visual-qa"], "depends_on": [], "verification": ["visual audit"]},
-      {"id": "design-review", "type": "audit", "paths": ["design/reviews/**"], "owner": "visual-qa", "reviewers": ["product-designer"], "depends_on": ["screen-system"], "verification": ["accessibility checklist"]}
+      {
+        "id": "screen-system",
+        "type": "screen",
+        "paths": [
+          "design/screens/**"
+        ],
+        "owner": "ijfw-design-critic",
+        "reviewers": [
+          "ijfw-accessibility-reviewer"
+        ],
+        "depends_on": [],
+        "verification": [
+          "visual audit"
+        ]
+      },
+      {
+        "id": "design-review",
+        "type": "audit",
+        "paths": [
+          "design/reviews/**"
+        ],
+        "owner": "ijfw-accessibility-reviewer",
+        "reviewers": [
+          "ijfw-design-critic"
+        ],
+        "depends_on": [
+          "screen-system"
+        ],
+        "verification": [
+          "accessibility checklist"
+        ]
+      }
     ],
     "waves": [
-      {"id": "w1", "mode": "parallel", "artifact_ids": ["screen-system"]},
-      {"id": "w2", "mode": "review", "artifact_ids": ["design-review"]}
+      {
+        "id": "w1",
+        "mode": "parallel",
+        "artifact_ids": [
+          "screen-system"
+        ]
+      },
+      {
+        "id": "w2",
+        "mode": "review",
+        "artifact_ids": [
+          "design-review"
+        ]
+      }
     ]
   },
   "blackboard": {
-    "tasks": [{"id": "task-screens", "title": "Draft core screens", "status": "ready", "artifact_ids": ["screen-system"], "owner": "product-designer"}],
-    "claims": [{"id": "claim-screens", "artifact_id": "screen-system", "agent": "product-designer", "status": "active", "paths": ["design/screens/**"]}]
+    "tasks": [
+      {
+        "id": "task-screens",
+        "title": "Draft core screens",
+        "status": "ready",
+        "artifact_ids": [
+          "screen-system"
+        ],
+        "owner": "ijfw-design-critic"
+      }
+    ],
+    "claims": [
+      {
+        "id": "claim-screens",
+        "artifact_id": "screen-system",
+        "agent": "ijfw-design-critic",
+        "status": "active",
+        "paths": [
+          "design/screens/**"
+        ]
+      }
+    ]
   }
 }