iranti 0.3.2 → 0.3.3

package/dist/src/attendant/AttendantInstance.js

@@ -72,7 +72,7 @@ const ATTEND_EXPECTED_CALL_SEQUENCE = [
     "Call iranti_attend(phase='post-response') after every response without exception — even short replies may contain durable findings. Omitting this call is a compliance violation.",
     'Call iranti_attend again when the new knowledge should change what is loaded next.',
 ];
-const ATTEND_USAGE_REMINDER = 'Iranti is a hive mind. iranti_attend is mandatory before each reply and around knowledge discovery, and knowledge-changing actions must leave breadcrumbs through iranti_write and/or iranti_checkpoint so later sessions do not have to rediscover context.';
+const ATTEND_USAGE_REMINDER = 'Iranti is a hive mind. MANDATORY: call iranti_attend before every reply and around knowledge discovery. MANDATORY: call iranti_write after every file edit, confirmed finding, environment state change, and subagent completion — write what changed, why, and what it means. Skipping writes means the next session starts blind and must rediscover everything from scratch.';
 const OBSERVE_USAGE_NOTE = 'observe() is retrieval-only. It surfaces candidate facts for context and warm-up, but it does not persist memory, replace iranti_attend, or count as a checkpoint/write.';
 function normalizeContinuityKey(key) {
     return LEGACY_CONTINUITY_KEY_MAP[key] ?? key;
@@ -352,10 +352,20 @@ function advisoryTaskTokens(taskType) {
         .map((token) => token.trim())
         .filter((token) => token.length >= 4)));
 }
-function buildUsageGuidance(tool) {
+function buildUsageGuidance(tool, turnsWithoutWrite = 0) {
+    let reminder = ATTEND_USAGE_REMINDER;
+    if (turnsWithoutWrite >= 3) {
+        reminder += ` NON-COMPLIANT: ${turnsWithoutWrite} turns have completed without a single iranti_write call. You are losing knowledge. Call iranti_write NOW for any findings, file changes, or decisions from recent turns.`;
+    }
+    else if (turnsWithoutWrite >= 2) {
+        reminder += ` WARNING: ${turnsWithoutWrite} turns without an iranti_write call. If you discovered, changed, or confirmed anything, write it now before it is lost.`;
+    }
+    else if (turnsWithoutWrite === 1) {
+        reminder += ' Reminder: if the previous turn produced durable findings, call iranti_write before continuing.';
+    }
     return {
         tool,
-        reminder: ATTEND_USAGE_REMINDER,
+        reminder,
         expectedCallSequence: ATTEND_EXPECTED_CALL_SEQUENCE,
         note: tool === 'observe'
             ? OBSERVE_USAGE_NOTE
@@ -587,6 +597,16 @@ function buildSessionComplianceState(input) {
             requiredAction: 'Persist durable findings with iranti_write or iranti_checkpoint before the next turn if new knowledge, validation, or file changes occurred.',
         });
     }
+    if (input.turnsWithoutWrite >= 2) {
+        const severity = input.turnsWithoutWrite >= 3 ? 'error' : 'warn';
+        issues.push({
+            code: 'missing_writes_across_turns',
+            severity,
+            count: input.turnsWithoutWrite,
+            message: `${input.turnsWithoutWrite} completed turns without a single iranti_write or iranti_checkpoint call. Knowledge discovered during these turns is not being persisted.`,
+            requiredAction: 'Call iranti_write for each durable finding — file edits, confirmed facts, environment state, subagent results. Every turn that discovers something should write it.',
+        });
+    }
     if (input.consecutiveUnusedMemoryInjections > 0) {
         const severity = input.consecutiveUnusedMemoryInjections >= 2 ? 'error' : 'warn';
         issues.push({
@@ -613,12 +633,12 @@ function buildSessionComplianceState(input) {
         : status === 'degraded'
             ? input.consecutiveUnusedMemoryInjections > 0
                 ? 'Lifecycle is degraded: injected memory was surfaced but not used.'
-                : 'Lifecycle is degraded: persistence breadcrumbs are lagging.'
+                : 'Lifecycle is degraded: iranti_write has not been called after recent knowledge-changing actions.'
             : input.consecutivePreResponseWithoutPost > 0
                 ? 'Lifecycle is non-compliant: the previous turn is still missing a post-response attend.'
                 : input.consecutiveUnusedMemoryInjections > 0
                     ? 'Lifecycle is non-compliant: injected memory is being ignored instead of used or explicitly challenged.'
-                    : 'Lifecycle is non-compliant: accountability breadcrumbs are missing.';
+                    : 'Lifecycle is non-compliant: iranti_write calls are missing — durable findings are not being persisted.';
     return {
         status,
         summary,
@@ -626,6 +646,7 @@ function buildSessionComplianceState(input) {
         lastUpdated: input.lastUpdated ?? new Date().toISOString(),
         counters: {
             attendsWithoutPersist: input.attendsWithoutPersist,
+            turnsWithoutWrite: input.turnsWithoutWrite,
             consecutivePreResponseWithoutPost: input.consecutivePreResponseWithoutPost,
             consecutiveUnusedMemoryInjections: input.consecutiveUnusedMemoryInjections,
             pendingPostResponse,
@@ -1327,6 +1348,7 @@ class AttendantInstance {
         this.advisoryLearningProfile = null;
         this.contextCallCount = 0;
         this.attendsWithoutPersist = 0;
+        this.turnsWithoutWrite = 0;
         this.consecutivePreResponseWithoutPost = 0;
         this.consecutiveUnusedMemoryInjections = 0;
         this.lastAttendPhase = undefined;
@@ -1792,6 +1814,7 @@ class AttendantInstance {
     buildComplianceState(lastUpdated) {
         return buildSessionComplianceState({
             attendsWithoutPersist: this.attendsWithoutPersist,
+            turnsWithoutWrite: this.turnsWithoutWrite,
             consecutivePreResponseWithoutPost: this.consecutivePreResponseWithoutPost,
             consecutiveUnusedMemoryInjections: this.consecutiveUnusedMemoryInjections,
             lastAttendPhase: this.lastAttendPhase,
@@ -1800,6 +1823,7 @@ class AttendantInstance {
     }
     async notifyWriteOccurred() {
         this.attendsWithoutPersist = 0;
+        this.turnsWithoutWrite = 0;
         this.lastAttendPhase = undefined;
         this.consecutivePreResponseWithoutPost = 0;
         this.complianceUpdatedAt = new Date().toISOString();
@@ -1816,6 +1840,7 @@ class AttendantInstance {
     }
     async checkpoint(input) {
         this.attendsWithoutPersist = 0;
+        this.turnsWithoutWrite = 0;
         this.lastAttendPhase = undefined;
         this.consecutivePreResponseWithoutPost = 0;
         this.complianceUpdatedAt = new Date().toISOString();
@@ -2055,8 +2080,10 @@ class AttendantInstance {
         let complianceWarning;
         const ignoredMemoryWarning = 'COMPLIANCE: injected memory was surfaced but not used. On the next turn, either answer from injected facts directly or persist why the injected memory was insufficient before rediscovering the same state manually.';
         if (phase === 'post-response') {
-            // Correct post-response call — reset counters
+            // Correct post-response call — reset attend counters but NOT turnsWithoutWrite
+            // turnsWithoutWrite only resets on actual writes/checkpoints
             this.attendsWithoutPersist = 0;
+            this.turnsWithoutWrite++;
             this.lastAttendPhase = 'post-response';
             this.consecutivePreResponseWithoutPost = 0;
         }
@@ -2143,7 +2170,7 @@ class AttendantInstance {
                 complianceWarning,
                 compliance,
                 memoryAttributions,
-                usageGuidance: buildUsageGuidance('attend'),
+                usageGuidance: buildUsageGuidance('attend', this.turnsWithoutWrite),
                 facts: [],
                 entitiesDetected: [],
                 alreadyPresent: 0,
@@ -2221,7 +2248,7 @@ class AttendantInstance {
                 complianceWarning,
                 compliance,
                 memoryAttributions: [],
-                usageGuidance: buildUsageGuidance('attend'),
+                usageGuidance: buildUsageGuidance('attend', this.turnsWithoutWrite),
                 facts: [],
                 entitiesDetected: [],
                 alreadyPresent: 0,
@@ -2313,7 +2340,7 @@ class AttendantInstance {
             complianceWarning,
             compliance,
             memoryAttributions,
-            usageGuidance: buildUsageGuidance('attend'),
+            usageGuidance: buildUsageGuidance('attend', this.turnsWithoutWrite),
         };
         if (input.suppressEvents !== true) {
             (0, staffEventRegistry_1.getStaffEventEmitter)().emit({
@@ -2426,29 +2453,29 @@ class AttendantInstance {
             const entityResponse = await (0, router_1.route)('extraction', [
                 {
                     role: 'user',
-                    content: `Extract explicitly named entities from the text.
-An entity can be a person, organization, project, technology, or named concept.
-
-Return ONLY valid JSON as an array of objects in this exact shape:
-[
-  {
-    "type": "project",
-    "name": "Project Atlas",
-    "id_guess": "project_atlas",
-    "confidence": 0.92,
-    "evidence": "Project Atlas",
-    "start": 123,
-    "end": 136
-  }
-]
-
-Rules:
-- Only include entities explicitly named in the provided text.
-- Do not infer or carry over entities not present in the text.
-- If uncertain, omit.
-- If none are present, return [].
-
-Text:
+                    content: `Extract explicitly named entities from the text.
+An entity can be a person, organization, project, technology, or named concept.
+
+Return ONLY valid JSON as an array of objects in this exact shape:
+[
+  {
+    "type": "project",
+    "name": "Project Atlas",
+    "id_guess": "project_atlas",
+    "confidence": 0.92,
+    "evidence": "Project Atlas",
+    "start": 123,
+    "end": 136
+  }
+]
+
+Rules:
+- Only include entities explicitly named in the provided text.
+- Do not infer or carry over entities not present in the text.
+- If uncertain, omit.
+- If none are present, return [].
+
+Text:
 ${detectionWindow}`,
                 },
             ], 512);
@@ -2782,21 +2809,21 @@ ${detectionWindow}`,
         const response = await (0, router_1.route)('classification', [
             {
                 role: 'user',
-                content: `Decide whether this assistant should fetch persistent memory before replying.
-
-Latest user message:
-${input.latestMessage || '(none)'}
-
-Recent context excerpt:
-${contextWindow || '(empty)'}
-
-Return ONLY valid JSON with this exact shape:
-{"needsMemory":true,"confidence":0.81,"reason":"short_reason"}
-
-Rules:
-- needsMemory=true when the message involves project context, technical decisions, code state, prior work, open tasks, bugs, architecture, preferences, or anything session- or project-specific.
-- needsMemory=true when in doubt — false positives are cheap, false negatives lose context.
-- needsMemory=false ONLY for clear one-word acks, simple greetings, or purely generic factual questions with no project relevance.
+                content: `Decide whether this assistant should fetch persistent memory before replying.
+
+Latest user message:
+${input.latestMessage || '(none)'}
+
+Recent context excerpt:
+${contextWindow || '(empty)'}
+
+Return ONLY valid JSON with this exact shape:
+{"needsMemory":true,"confidence":0.81,"reason":"short_reason"}
+
+Rules:
+- needsMemory=true when the message involves project context, technical decisions, code state, prior work, open tasks, bugs, architecture, preferences, or anything session- or project-specific.
+- needsMemory=true when in doubt — false positives are cheap, false negatives lose context.
+- needsMemory=false ONLY for clear one-word acks, simple greetings, or purely generic factual questions with no project relevance.
 - confidence is a float from 0 to 1.`,
             },
         ], 128);
@@ -3159,14 +3186,14 @@ Rules:
         const response = await (0, router_1.route)('task_inference', [
             {
                 role: 'user',
-                content: `You are analyzing what an AI agent is currently working on.
-
-Agent ID: ${this.agentId}
-Task description: ${context.task}
-Recent messages:
-${context.recentMessages.map((m, i) => `${i + 1}. ${m}`).join('\n')}
-
-In one short sentence, describe the specific type of task this agent is currently performing.
+                content: `You are analyzing what an AI agent is currently working on.
+
+Agent ID: ${this.agentId}
+Task description: ${context.task}
+Recent messages:
+${context.recentMessages.map((m, i) => `${i + 1}. ${m}`).join('\n')}
+
+In one short sentence, describe the specific type of task this agent is currently performing.
 Be specific and concrete.`,
             },
         ], 256);
@@ -3199,15 +3226,15 @@ Be specific and concrete.`,
         const response = await (0, router_1.route)('relevance_filtering', [
             {
                 role: 'user',
-                content: `You are deciding what knowledge an AI agent needs for its current task.
-
-Agent task: ${taskType}
-
-Available knowledge entries:
-${entryInputs.map((e, i) => `${i + 1}. [${e.key}] ${e.valueSummary} (confidence: ${e.confidence})`).join('\n')}
-
-Return only the numbers of entries that are directly relevant to the current task.
-Format: comma-separated numbers only. Example: 1,3,5
+                content: `You are deciding what knowledge an AI agent needs for its current task.
+
+Agent task: ${taskType}
+
+Available knowledge entries:
+${entryInputs.map((e, i) => `${i + 1}. [${e.key}] ${e.valueSummary} (confidence: ${e.confidence})`).join('\n')}
+
+Return only the numbers of entries that are directly relevant to the current task.
+Format: comma-separated numbers only. Example: 1,3,5
 If nothing is relevant, return: none`,
             },
         ], 128);
@@ -3272,6 +3299,7 @@ If nothing is relevant, return: none`,
         this.advisoryLearningProfile = null;
         this.sharedStateObservedAt = state.briefGeneratedAt;
         this.attendsWithoutPersist = state.compliance?.counters.attendsWithoutPersist ?? 0;
+        this.turnsWithoutWrite = state.compliance?.counters.turnsWithoutWrite ?? 0;
         this.consecutivePreResponseWithoutPost = state.compliance?.counters.consecutivePreResponseWithoutPost ?? 0;
         this.consecutiveUnusedMemoryInjections = state.compliance?.counters.consecutiveUnusedMemoryInjections ?? 0;
         this.lastAttendPhase = state.compliance?.counters.lastAttendPhase ?? undefined;