@gramatr/client 0.6.18 → 0.6.20

package/hooks/gramatr-prompt-enricher.hook.ts

@@ -20,7 +20,7 @@
  * - Token savings metadata
  */
 
-import { readFileSync } from 'fs';
+import { readFileSync, appendFileSync } from 'fs';
 import { getGitContext } from './lib/gmtr-hook-utils.ts';
 import {
   persistClassificationResult,
@@ -29,6 +29,12 @@ import {
 } from '../core/routing.ts';
 import type { RouteResponse } from '../core/types.ts';
 
+// ── Turn Tracking (Issue #594) ──
+// Module-level counter incremented per prompt in this process.
+// Reset on process restart (acceptable — session-end flushes).
+let turnCounter = 0;
+const TURNS_JSONL_PATH = '/tmp/gramatr-turns.jsonl';
+
 // ── Types ──
 
 interface HookInput {
@@ -337,6 +343,10 @@ function formatIntelligence(data: RouteResponse): string {
   lines.push('The ISC prefix is REQUIRED — it signals to the user that GMTR intelligence is driving the criteria.');
   lines.push('This is a HARD GATE — do NOT proceed to any work until TaskCreate calls are complete.');
 
+  // ── grā identity — server-generated content marker ──
+  lines.push('');
+  lines.push('When presenting gramatr intelligence (ISC scaffolds, search results, agent recommendations, summaries), prefix with **grā:** in bold. This distinguishes server-pre-computed content from your own reasoning. Example: "**grā:** ISC scaffold suggests 6 criteria for this migration task."');
+
   // ── Effort-level-scaled format ──
   if (effort === 'instant') {
     lines.push('');
@@ -614,6 +624,23 @@ async function main() {
 
   persistLastClassification(prompt, session_id, result, downstreamModel);
 
+  // Accumulate turn data for batch flush at session end (Issue #594)
+  try {
+    const cl = result?.classification || {};
+    const es = result?.execution_summary || {};
+    const turnData = {
+      turn_number: turnCounter++,
+      timestamp: new Date().toISOString(),
+      prompt: prompt.substring(0, 500),
+      effort_level: cl.effort_level || null,
+      intent_type: cl.intent_type || null,
+      confidence: cl.confidence || null,
+      memory_tier: cl.memory_tier || null,
+      classifier_model: es.classifier_model || null,
+    };
+    appendFileSync(TURNS_JSONL_PATH, JSON.stringify(turnData) + '\n');
+  } catch { /* never block the hook */ }
+
   // If no result — DO NOT silently pass through. Tell the user what's broken.
   if (!result || !result.classification) {
     if (lastFailure) {

package/hooks/session-end.hook.ts

@@ -11,7 +11,7 @@
  * ZERO external CLI dependencies — no jq, sed, curl, awk.
  */
 
-import { writeFileSync } from 'fs';
+import { writeFileSync, readFileSync, existsSync, unlinkSync } from 'fs';
 import { join } from 'path';
 import {
   readHookInput,
@@ -129,6 +129,32 @@ async function main(): Promise<void> {
         log('');
         log('Saving session state to gramatr...');
 
+        // ── Flush accumulated turns to server (Issue #594) ──
+        try {
+          const turnsFile = '/tmp/gramatr-turns.jsonl';
+          if (existsSync(turnsFile)) {
+            const lines = readFileSync(turnsFile, 'utf8').trim().split('\n').filter(Boolean);
+            const turns = lines.map(line => JSON.parse(line));
+            if (turns.length > 0) {
+              log(`  Flushing ${turns.length} turns to gramatr...`);
+              const interactionId = config?.current_session?.interaction_id || '';
+              const flushResult = await callMcpToolRaw('gramatr_batch_save_turns', {
+                session_id: sessionEntityId || sessionId,
+                project_id: projectId,
+                turns,
+              });
+              if (flushResult && flushResult.includes('"turns_saved"')) {
+                log(`  Turns flushed successfully`);
+              } else {
+                log('  Turn flush uncertain (server may be unavailable)');
+              }
+            }
+            unlinkSync(turnsFile);
+          }
+        } catch {
+          log('  Turn flush failed (non-critical)');
+        }
+
         // Session lifecycle only — gramatr_session_end records git summary on the session entity.
         // Handoffs are saved by the AGENT in the LEARN phase via gramatr_save_handoff (HARD GATE).
         // The hook does NOT save handoffs — it lacks conversation context.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gramatr/client",
-  "version": "0.6.18",
+  "version": "0.6.20",
   "publishConfig": {
     "access": "public"
   },