@gramatr/mcp 0.7.15 → 0.7.17

package/dist/hooks/user-prompt-submit.js

@@ -4,14 +4,15 @@ import { emitStatus, formatFailureWarning, formatIntelligence, mergeEnrichmentIn
 import { fetchEnrichment, persistClassificationResult, routePrompt, shouldSkipPromptRouting, } from './lib/routing.js';
 import { appendOpHistory, appendTurn, getSessionContext, hydrateSessionContextFromServer, isFilesystemAvailable, setLatestClassification, } from './lib/hook-state.js';
 import { resolveHookClientRuntime } from './lib/client-runtime.js';
+import { appendPacketDebugLog } from './lib/packet-debug-log.js';
 let turnCounter = 0;
-const TIMEOUT_MS = getGramatrTimeoutFromEnv(30000);
+const TIMEOUT_MS = getGramatrTimeoutFromEnv(60000);
 const ENABLED = isGramatrEnrichEnabledFromEnv();
 const PACKET_MODE = getGramatrPacketModeFromEnv();
 const PACKET2_WAIT_MS = getGramatrPacket2WaitMsFromEnv(20000);
-const HOOK_ROUTE_TIMEOUT_CAP_MS = 9000;
-const HOOK_PACKET2_TIMEOUT_CAP_MS = 2500;
-const HOOK_PACKET2_WAIT_CAP_MS = 4000;
+const HOOK_ROUTE_TIMEOUT_CAP_MS = 60000;
+const HOOK_PACKET2_TIMEOUT_CAP_MS = 15000;
+const HOOK_PACKET2_WAIT_CAP_MS = 20000;
 const HOOK_PACKET2_POLL_MS = 500;
 function persistLastClassification(prompt, sessionId, route, downstreamModel, clientType, agentName) {
     try {
@@ -73,32 +74,63 @@ export async function runUserPromptSubmitHook(_args = []) {
             sessionContext = getSessionContext(sessionId);
         }
         const projectId = sessionContext?.project_id || (git ? deriveProjectId(git.remote, git.projectName) : null) || undefined;
-        // Pass gramatr interaction_id as session_id so route_request can load
-        // conversation history. Fall back to the Claude session_id only if no
-        // interaction has been registered yet (e.g. server was down at SessionStart).
-        const gramatrSessionId = sessionContext?.interaction_id || sessionId;
+        // gramatr interaction_id is the cross-agent session key — use it for
+        // both session_id (server history) and interaction_id (explicit resolution).
+        const gramatrInteractionId = sessionContext?.interaction_id || null;
+        const gramatrSessionId = gramatrInteractionId || sessionId;
         process.stderr.write('[gramatr] classifying...\n');
         const t0 = Date.now();
         const routed = await routePrompt({
             prompt,
             projectId,
             sessionId: gramatrSessionId,
+            interactionId: gramatrInteractionId || undefined,
             timeoutMs: Math.min(TIMEOUT_MS, HOOK_ROUTE_TIMEOUT_CAP_MS),
         });
         const result = routed.route;
         const elapsed = Date.now() - t0;
+        const isV2 = result?.schema === 'gmtr.intelligence.contract.v2';
         let lastFailure = null;
         if (!result && routed.error) {
             lastFailure = mapRoutingFailure(routed.error.reason, routed.error.detail);
         }
+        // Debug log — rolling 100-entry JSONL at ~/.gramatr/debug/packets.jsonl
+        appendPacketDebugLog({
+            ts: new Date().toISOString(),
+            project_id: projectId ?? null,
+            session_id: gramatrSessionId,
+            client_type: runtime.clientType,
+            agent_name: runtime.agentName,
+            downstream_model: downstreamModel,
+            status: !result && routed.error
+                ? (routed.error.reason === 'timeout' ? 'timeout' : 'error')
+                : result ? 'ok' : 'skipped',
+            elapsed_ms: elapsed,
+            packet: result ?? null,
+            error: routed.error ? { reason: routed.error.reason, detail: routed.error.detail } : null,
+        });
         let enrichment = null;
         const packet1 = result?.packet_1;
-        const manifest = packet1?.manifest || result;
-        const packetTokenSavings = packet1?.token_savings || result?.token_savings || {};
-        if (result && manifest?.packet_2_status === 'required' && manifest?.enrichment_id) {
-            enrichment = await fetchEnrichment(manifest.enrichment_id, {
+        // v2: manifest is a top-level field; v1: it's nested under packet_1
+        const manifest = isV2 ? result?.manifest : (packet1?.manifest || result);
+        // v2: token_savings lives under result.execution; v1: under packet_1 or result directly
+        const packetTokenSavings = packet1?.token_savings
+            || (isV2 ? result?.execution?.token_savings : result?.token_savings)
+            || {};
+        const packet2Required = Boolean(
+        // v2: enrichment.required is the canonical signal
+        result?.enrichment?.required === true
+            // v1 fallbacks
+            || result?.packet_2?.required === true
+            || manifest?.packet_2_status === 'required'
+            || manifest?.packet_2_required === true);
+        const enrichmentId = result?.enrichment?.enrichment_id
+            || result?.packet_2?.enrichment_id
+            || manifest?.enrichment_id;
+        if (result && packet2Required && enrichmentId) {
+            enrichment = await fetchEnrichment(enrichmentId, {
                 mode: PACKET_MODE,
-                timeoutMs: Math.min(5000, HOOK_PACKET2_TIMEOUT_CAP_MS),
+                timeoutMs: HOOK_PACKET2_TIMEOUT_CAP_MS,
                 waitMs: Math.min(PACKET2_WAIT_MS, HOOK_PACKET2_WAIT_CAP_MS),
                 pollMs: HOOK_PACKET2_POLL_MS,
             });
@@ -121,7 +153,9 @@ export async function runUserPromptSubmitHook(_args = []) {
                 effort: cl.effort_level || null,
                 intent: cl.intent_type || null,
                 confidence: cl.confidence ?? null,
-                memory_delivered: (packet1?.memory_context || result?.memory_context)?.results?.length || null,
+                memory_delivered: isV2
+                    ? (result?.memory?.search_results?.length ?? null)
+                    : ((packet1?.memory_context || result?.memory_context)?.results?.length ?? null),
                 downstream_model: downstreamModel || null,
                 server_version: es.server_version || null,
                 stage_timing: es.stage_timing ? JSON.stringify(es.stage_timing) : null,

package/dist/hooks/user-prompt-submit.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-prompt-submit.js","sourceRoot":"","sources":["../../src/hooks/user-prompt-submit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"user-prompt-submit.js","sourceRoot":"","sources":["../../src/hooks/user-prompt-submit.ts"],"names":[],"mappings":"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"}

package/dist/proxy/local-client.d.ts

@@ -1,49 +1,28 @@
 /**
- * local-client.ts — Hook-side client for the local MCP hooks listener.
+ * local-client.ts — Hook-side client for gramatr tool calls.
  *
- * Phase IV: Hook subprocesses call this module instead of remote-client.ts.
- * Routes all tool calls and session-context reads/writes through the local
- * MCP server when it is running, falling back to direct remote calls otherwise.
+ * Hooks call gramatr tools directly through the remote API via callRemoteTool.
+ * The compiled binary owns auth resolution — no port-based local HTTP server needed.
  *
- * Priority:
- *   1. Local hooks server (localhost:PORT from ~/.gramatr/.hooks-port)
- *      → auth already loaded in server process, no token resolution needed
- *      → data shape validated before any remote call
- *   2. Direct remote (callRemoteTool from remote-client.ts)
- *      → hooks resolve their own auth token as before
- *
- * The local server's port file is read once per hook process lifetime and
- * cached. Stale port files (server crashed without cleanup) are caught by a
- * connection error on first use, which clears the cache and falls through to
- * direct remote.
+ * Session context (project_id, interaction_id) is managed locally via SQLite
+ * in hook-state.ts. pushSessionContextToLocal / pullSessionContextFromLocal
+ * are retained as no-ops for call-site compatibility while the port IPC is removed.
  */
-/** True when the local hooks server port file exists and contains a valid port. */
+/** Always false — port-based local server is no longer used. */
 export declare function isLocalHooksServerAvailable(): boolean;
 /**
- * Call a gramatr tool, routing through the local hooks server when available.
- *
- * The local server injects auth and enforces data shapes before forwarding to
- * the remote API. If the local server is unavailable or returns an error,
- * falls back to a direct remote call via callRemoteTool.
+ * Call a gramatr tool via the remote API.
+ * Auth is resolved by the compiled binary's auth module.
  */
 export declare function callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
 /**
- * Push session context to the local server's in-memory store.
- *
- * Called by the session-start hook after setSessionContext() so later hook
- * processes (user-prompt-submit, session-end) can read the context without
- * hitting the SQLite file or the remote REST API.
- *
- * Returns true if the write was acknowledged. A false return is non-fatal —
- * later hooks fall back to SQLite → remote REST.
+ * No-op — session context is persisted to SQLite via setSessionContext in hook-state.ts.
+ * Retained for call-site compatibility.
  */
-export declare function pushSessionContextToLocal(ctx: unknown): Promise<boolean>;
+export declare function pushSessionContextToLocal(_ctx: unknown): Promise<boolean>;
 /**
- * Pull session context from the local server's in-memory store.
- *
- * Returns the stored context for the given session_id, or the most recently
- * written context as a fallback. Returns null if the local server is
- * unavailable or has no context for this session.
+ * No-op — callers fall through to remote REST hydration via hydrateSessionContextFromServer.
+ * Retained for call-site compatibility.
  */
-export declare function pullSessionContextFromLocal(sessionId: string): Promise<Record<string, unknown> | null>;
+export declare function pullSessionContextFromLocal(_sessionId: string): Promise<Record<string, unknown> | null>;
 //# sourceMappingURL=local-client.d.ts.map

package/dist/proxy/local-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-client.d.ts","sourceRoot":"","sources":["../../src/proxy/local-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA6BH,mFAAmF;AACnF,wBAAgB,2BAA2B,IAAI,OAAO,CAErD;AAID;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAID;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAe9E;AAED;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAezC"}
+{"version":3,"file":"local-client.d.ts","sourceRoot":"","sources":["../../src/proxy/local-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,gEAAgE;AAChE,wBAAgB,2BAA2B,IAAI,OAAO,CAErD;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAElB;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/E;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAEzC"}

package/dist/proxy/local-client.js

@@ -1,135 +1,37 @@
 /**
- * local-client.ts — Hook-side client for the local MCP hooks listener.
+ * local-client.ts — Hook-side client for gramatr tool calls.
  *
- * Phase IV: Hook subprocesses call this module instead of remote-client.ts.
- * Routes all tool calls and session-context reads/writes through the local
- * MCP server when it is running, falling back to direct remote calls otherwise.
+ * Hooks call gramatr tools directly through the remote API via callRemoteTool.
+ * The compiled binary owns auth resolution — no port-based local HTTP server needed.
  *
- * Priority:
- *   1. Local hooks server (localhost:PORT from ~/.gramatr/.hooks-port)
- *      → auth already loaded in server process, no token resolution needed
- *      → data shape validated before any remote call
- *   2. Direct remote (callRemoteTool from remote-client.ts)
- *      → hooks resolve their own auth token as before
- *
- * The local server's port file is read once per hook process lifetime and
- * cached. Stale port files (server crashed without cleanup) are caught by a
- * connection error on first use, which clears the cache and falls through to
- * direct remote.
+ * Session context (project_id, interaction_id) is managed locally via SQLite
+ * in hook-state.ts. pushSessionContextToLocal / pullSessionContextFromLocal
+ * are retained as no-ops for call-site compatibility while the port IPC is removed.
  */
-import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { getGramatrDirFromEnv, getHomeDir } from '../config-runtime.js';
 import { callRemoteTool } from './remote-client.js';
-// ── Port discovery ──
-function getPortFilePath() {
-    const dir = getGramatrDirFromEnv() || join(getHomeDir(), '.gramatr');
-    return join(dir, '.hooks-port');
-}
-// undefined = not yet read; null = not available; number = available
-let _cachedPort = undefined;
-function getLocalPort() {
-    if (_cachedPort !== undefined)
-        return _cachedPort;
-    try {
-        const raw = readFileSync(getPortFilePath(), 'utf8').trim();
-        const port = parseInt(raw, 10);
-        _cachedPort = Number.isFinite(port) && port > 0 ? port : null;
-    }
-    catch {
-        _cachedPort = null;
-    }
-    return _cachedPort;
-}
-/** True when the local hooks server port file exists and contains a valid port. */
+/** Always false — port-based local server is no longer used. */
 export function isLocalHooksServerAvailable() {
-    return getLocalPort() !== null;
+    return false;
 }
-// ── Tool call proxy ──
 /**
- * Call a gramatr tool, routing through the local hooks server when available.
- *
- * The local server injects auth and enforces data shapes before forwarding to
- * the remote API. If the local server is unavailable or returns an error,
- * falls back to a direct remote call via callRemoteTool.
+ * Call a gramatr tool via the remote API.
+ * Auth is resolved by the compiled binary's auth module.
  */
 export async function callTool(name, args) {
-    const port = getLocalPort();
-    if (port !== null) {
-        try {
-            const res = await fetch(`http://127.0.0.1:${port}/hooks/tool`, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ name, args }),
-                signal: AbortSignal.timeout(30000),
-            });
-            // gramatr-allow: B1 — HTTP transport sentinel, caught immediately in the enclosing try/catch
-            if (!res.ok)
-                throw new Error(`HTTP ${res.status}`);
-            const data = await res.json();
-            // gramatr-allow: B1 — error string forwarded from local server, caught immediately in the enclosing try/catch
-            if (data.error)
-                throw new Error(data.error);
-            return data.result;
-        }
-        catch {
-            // Local server failed (stale port file, crash, etc.) — invalidate cache
-            // and fall through to direct remote.
-            _cachedPort = null;
-        }
-    }
     return callRemoteTool(name, args);
 }
-// ── Session context IPC ──
 /**
- * Push session context to the local server's in-memory store.
- *
- * Called by the session-start hook after setSessionContext() so later hook
- * processes (user-prompt-submit, session-end) can read the context without
- * hitting the SQLite file or the remote REST API.
- *
- * Returns true if the write was acknowledged. A false return is non-fatal —
- * later hooks fall back to SQLite → remote REST.
+ * No-op — session context is persisted to SQLite via setSessionContext in hook-state.ts.
+ * Retained for call-site compatibility.
  */
-export async function pushSessionContextToLocal(ctx) {
-    const port = getLocalPort();
-    if (port === null)
-        return false;
-    try {
-        const res = await fetch(`http://127.0.0.1:${port}/hooks/session`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify(ctx),
-            signal: AbortSignal.timeout(3000),
-        });
-        return res.ok;
-    }
-    catch {
-        _cachedPort = null; // Invalidate on connection failure
-        return false;
-    }
+export async function pushSessionContextToLocal(_ctx) {
+    return false;
 }
 /**
- * Pull session context from the local server's in-memory store.
- *
- * Returns the stored context for the given session_id, or the most recently
- * written context as a fallback. Returns null if the local server is
- * unavailable or has no context for this session.
+ * No-op — callers fall through to remote REST hydration via hydrateSessionContextFromServer.
+ * Retained for call-site compatibility.
  */
-export async function pullSessionContextFromLocal(sessionId) {
-    const port = getLocalPort();
-    if (port === null)
-        return null;
-    try {
-        const res = await fetch(`http://127.0.0.1:${port}/hooks/session?session_id=${encodeURIComponent(sessionId)}`, { signal: AbortSignal.timeout(3000) });
-        if (!res.ok)
-            return null;
-        const data = await res.json();
-        return data.ctx;
-    }
-    catch {
-        _cachedPort = null;
-        return null;
-    }
+export async function pullSessionContextFromLocal(_sessionId) {
+    return null;
 }
 //# sourceMappingURL=local-client.js.map

package/dist/proxy/local-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-client.js","sourceRoot":"","sources":["../../src/proxy/local-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"local-client.js","sourceRoot":"","sources":["../../src/proxy/local-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,gEAAgE;AAChE,MAAM,UAAU,2BAA2B;IACzC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,IAA6B;IAE7B,OAAO,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,IAAa;IAC3D,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,UAAkB;IAElB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/setup/instructions.d.ts

@@ -3,7 +3,7 @@ export declare const CLAUDE_BLOCK_END = "<!-- GRAMATR-END -->";
 export declare const CODEX_BLOCK_START = "<!-- GRAMATR-CODEX-START -->";
 export declare const CODEX_BLOCK_END = "<!-- GRAMATR-CODEX-END -->";
 export type InstallPromptTarget = 'claude-code' | 'codex' | 'gemini-cli' | 'claude-desktop' | 'chatgpt-desktop' | 'cursor' | 'windsurf' | 'vscode';
-export declare const CLAUDE_CODE_GUIDANCE = "<!-- GRAMATR-START -->\n# gramatr\n\nYou have gramatr installed. Local hooks and the local MCP server inject\nintelligence as `[gramatr intelligence \u2014 ...]` into your context.\n\nFollow the injected JSON contract. Prefer `unified_packet` when present.\nIt is the canonical complete contract. Fall back to `packet_1` /`packet_2`\nonly when `unified_packet` is absent.\n\nUse gramatr tools and packet data instead of stale local markdown. Prefer\npacket memory/search results when present. Use `search_semantic` only for\nfollow-up expansion, not as a replacement for the injected packet.\n\nWhen the contract includes behavioral rules, directives, phase templates,\nISC/quality-gate data, or formatting constraints, treat those fields as\nexecution requirements rather than optional suggestions. Do not reconstruct\nthem from local prose when the structured fields are present.\n\nIf the server is unavailable, degrade cleanly and keep working, but do not\npretend intelligence was delivered.\n<!-- GRAMATR-END -->\n";
-export declare const CODEX_GUIDANCE = "<!-- GRAMATR-CODEX-START -->\n# gramatr codex guidance\n\n## Repo Expectations\n\n- Prefer gramatr memory and project handoff context over ad hoc local summaries.\n- Treat Codex hook augmentation as authoritative when a gramatr JSON intelligence block is present.\n- If gramatr augmentation is missing, query gramatr memory before relying on stale local notes.\n- Prefer TypeScript implementations over shell scripts for client integration code unless the platform requires shell.\n- Maintain test coverage for new hook and utility logic.\n\n## Codex Integration\n\n- Repo-local Codex hooks are configured in `.codex/hooks.json`.\n- `UserPromptSubmit` is responsible for prompt enrichment.\n- `SessionStart` is responsible for session restore and continuity.\n- Hook failures must degrade cleanly and never block the user session.\n- Prefer `unified_packet` as the canonical complete contract. When it is absent, treat `packet_1` as mandatory deterministic input and `packet_2` as mandatory when required.\n- If `packet_2.required === true`, call `gramatr_get_packet_two` with `enrichment_id` before deep execution.\n- Consume structured JSON fields as source of truth. Do not replace packet-provided behavioral rules, ISC gates, quality gates, or format constraints with local prose summaries.\n- `gramatr_route_request` is mandatory when hook injection is missing/stale for the current user prompt.\n- `search_semantic` remains available for follow-up memory expansion, not as a replacement for packet flow.\n<!-- GRAMATR-CODEX-END -->\n";
+export declare const CLAUDE_CODE_GUIDANCE = "<!-- GRAMATR-START -->\n# gramatr\n\nYou have gramatr installed. Hooks inject a `gmtr.intelligence.contract.v2`\npacket into your context on every prompt.\n\n**Follow the packet.** It contains classification, behavioral directives,\nphase templates, capability audit, quality gates, memory/search results,\nagent suggestions, and enrichment (RE + ISC scaffold).\n\n**Mandatory fields:**\n- `directives.hard_gates` \u2014 non-negotiable behavioral constraints\n- `directives.behavioral_rules` \u2014 algorithm phases, code rules, safety rules\n- `process.phase_template` \u2014 effort-gated phase sequence\n- `process.quality_gate_config` \u2014 ISC verification rules\n- `enrichment.data.reasoning` \u2014 RE + ISC when present\n\n**Memory:** Use gramatr MCP tools (`search_semantic`, `create_entity`,\n`add_observation`), not local markdown files.\n\n**Sub-agent composition:** Before launching any sub-agent for non-trivial work,\ncall `gramatr_route_request` with the task prompt first. Use the returned\npacket to compose the brief: RE \u2192 task description, ISC scaffold \u2192 acceptance\ncriteria, orchestration.agents.composed \u2192 agent system prompt, hard_gates \u2192\nconstraints.\n\n**Effort-gated phases:**\n- instant: RESPOND only\n- fast: OBSERVE \u2192 RESPOND\n- standard: OBSERVE \u2192 PLAN \u2192 BUILD \u2192 VERIFY\n- extended+: OBSERVE \u2192 THINK \u2192 PLAN \u2192 BUILD \u2192 EXECUTE \u2192 VERIFY \u2192 LEARN\n\n**Identity:** Read from `~/.gramatr/settings.json` \u2014 `daidentity` for your\nname, `principal` for the user's name.\n\n**If the server is unavailable:** Degrade cleanly and keep working. Use the\n7-phase structure. Create ISC before work. Never combine phases.\n<!-- GRAMATR-END -->\n";
+export declare const CODEX_GUIDANCE = "<!-- GRAMATR-CODEX-START -->\n# gramatr codex guidance\n\n## Repo Expectations\n\n- Prefer gramatr memory and project handoff context over ad hoc local summaries.\n- Treat Codex hook augmentation as authoritative when a gramatr intelligence block is present.\n- If gramatr augmentation is missing, query gramatr memory before relying on stale local notes.\n- Prefer TypeScript implementations over shell scripts for client integration code unless the platform requires shell.\n- Maintain test coverage for new hook and utility logic.\n\n## Codex Integration\n\n- Repo-local Codex hooks are configured in `.codex/hooks.json`.\n- `UserPromptSubmit` is responsible for prompt enrichment.\n- `SessionStart` is responsible for session restore and continuity.\n- Hook failures must degrade cleanly and never block the user session.\n- The contract is always `gmtr.intelligence.contract.v2`. There is no\n  `unified_packet`, `packet_1`, or `packet_2` \u2014 the v2 packet is the only format.\n- Treat `directives.hard_gates` and `directives.behavioral_rules` as mandatory.\n- Follow `process.phase_template` for effort-gated phase sequencing.\n- Use `process.quality_gate_config` for ISC verification.\n- Consume `enrichment.data.reasoning` for RE and ISC when present.\n- `gramatr_route_request` is mandatory when hook injection is missing/stale.\n- `search_semantic` remains available for follow-up memory expansion.\n<!-- GRAMATR-CODEX-END -->\n";
 export declare function buildInstallPromptSuggestion(target: InstallPromptTarget): string;
 //# sourceMappingURL=instructions.d.ts.map

package/dist/setup/instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/setup/instructions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAC3D,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AACvD,eAAO,MAAM,iBAAiB,iCAAiC,CAAC;AAChE,eAAO,MAAM,eAAe,+BAA+B,CAAC;AAE5D,MAAM,MAAM,mBAAmB,GAC3B,aAAa,GACb,OAAO,GACP,YAAY,GACZ,gBAAgB,GAChB,iBAAiB,GACjB,QAAQ,GACR,UAAU,GACV,QAAQ,CAAC;AAEb,eAAO,MAAM,oBAAoB,igCAsBhC,CAAC;AAEF,eAAO,MAAM,cAAc,wgDAuB1B,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAehF"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/setup/instructions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAC3D,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AACvD,eAAO,MAAM,iBAAiB,iCAAiC,CAAC;AAChE,eAAO,MAAM,eAAe,+BAA+B,CAAC;AAE5D,MAAM,MAAM,mBAAmB,GAC3B,aAAa,GACb,OAAO,GACP,YAAY,GACZ,gBAAgB,GAChB,iBAAiB,GACjB,QAAQ,GACR,UAAU,GACV,QAAQ,CAAC;AAEb,eAAO,MAAM,oBAAoB,4sDAsChC,CAAC;AAEF,eAAO,MAAM,cAAc,s6CA0B1B,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAehF"}

package/dist/setup/instructions.js

@@ -5,24 +5,40 @@ export const CODEX_BLOCK_END = '<!-- GRAMATR-CODEX-END -->';
 export const CLAUDE_CODE_GUIDANCE = `${CLAUDE_BLOCK_START}
 # gramatr
 
-You have gramatr installed. Local hooks and the local MCP server inject
-intelligence as \`[gramatr intelligence — ...]\` into your context.
-
-Follow the injected JSON contract. Prefer \`unified_packet\` when present.
-It is the canonical complete contract. Fall back to \`packet_1\` /\`packet_2\`
-only when \`unified_packet\` is absent.
-
-Use gramatr tools and packet data instead of stale local markdown. Prefer
-packet memory/search results when present. Use \`search_semantic\` only for
-follow-up expansion, not as a replacement for the injected packet.
-
-When the contract includes behavioral rules, directives, phase templates,
-ISC/quality-gate data, or formatting constraints, treat those fields as
-execution requirements rather than optional suggestions. Do not reconstruct
-them from local prose when the structured fields are present.
-
-If the server is unavailable, degrade cleanly and keep working, but do not
-pretend intelligence was delivered.
+You have gramatr installed. Hooks inject a \`gmtr.intelligence.contract.v2\`
+packet into your context on every prompt.
+
+**Follow the packet.** It contains classification, behavioral directives,
+phase templates, capability audit, quality gates, memory/search results,
+agent suggestions, and enrichment (RE + ISC scaffold).
+
+**Mandatory fields:**
+- \`directives.hard_gates\` — non-negotiable behavioral constraints
+- \`directives.behavioral_rules\` — algorithm phases, code rules, safety rules
+- \`process.phase_template\` — effort-gated phase sequence
+- \`process.quality_gate_config\` — ISC verification rules
+- \`enrichment.data.reasoning\` — RE + ISC when present
+
+**Memory:** Use gramatr MCP tools (\`search_semantic\`, \`create_entity\`,
+\`add_observation\`), not local markdown files.
+
+**Sub-agent composition:** Before launching any sub-agent for non-trivial work,
+call \`gramatr_route_request\` with the task prompt first. Use the returned
+packet to compose the brief: RE → task description, ISC scaffold → acceptance
+criteria, orchestration.agents.composed → agent system prompt, hard_gates →
+constraints.
+
+**Effort-gated phases:**
+- instant: RESPOND only
+- fast: OBSERVE → RESPOND
+- standard: OBSERVE → PLAN → BUILD → VERIFY
+- extended+: OBSERVE → THINK → PLAN → BUILD → EXECUTE → VERIFY → LEARN
+
+**Identity:** Read from \`~/.gramatr/settings.json\` — \`daidentity\` for your
+name, \`principal\` for the user's name.
+
+**If the server is unavailable:** Degrade cleanly and keep working. Use the
+7-phase structure. Create ISC before work. Never combine phases.
 ${CLAUDE_BLOCK_END}
 `;
 export const CODEX_GUIDANCE = `${CODEX_BLOCK_START}
@@ -31,7 +47,7 @@ export const CODEX_GUIDANCE = `${CODEX_BLOCK_START}
 ## Repo Expectations
 
 - Prefer gramatr memory and project handoff context over ad hoc local summaries.
-- Treat Codex hook augmentation as authoritative when a gramatr JSON intelligence block is present.
+- Treat Codex hook augmentation as authoritative when a gramatr intelligence block is present.
 - If gramatr augmentation is missing, query gramatr memory before relying on stale local notes.
 - Prefer TypeScript implementations over shell scripts for client integration code unless the platform requires shell.
 - Maintain test coverage for new hook and utility logic.
@@ -42,11 +58,14 @@ export const CODEX_GUIDANCE = `${CODEX_BLOCK_START}
 - \`UserPromptSubmit\` is responsible for prompt enrichment.
 - \`SessionStart\` is responsible for session restore and continuity.
 - Hook failures must degrade cleanly and never block the user session.
-- Prefer \`unified_packet\` as the canonical complete contract. When it is absent, treat \`packet_1\` as mandatory deterministic input and \`packet_2\` as mandatory when required.
-- If \`packet_2.required === true\`, call \`gramatr_get_packet_two\` with \`enrichment_id\` before deep execution.
-- Consume structured JSON fields as source of truth. Do not replace packet-provided behavioral rules, ISC gates, quality gates, or format constraints with local prose summaries.
-- \`gramatr_route_request\` is mandatory when hook injection is missing/stale for the current user prompt.
-- \`search_semantic\` remains available for follow-up memory expansion, not as a replacement for packet flow.
+- The contract is always \`gmtr.intelligence.contract.v2\`. There is no
+  \`unified_packet\`, \`packet_1\`, or \`packet_2\` — the v2 packet is the only format.
+- Treat \`directives.hard_gates\` and \`directives.behavioral_rules\` as mandatory.
+- Follow \`process.phase_template\` for effort-gated phase sequencing.
+- Use \`process.quality_gate_config\` for ISC verification.
+- Consume \`enrichment.data.reasoning\` for RE and ISC when present.
+- \`gramatr_route_request\` is mandatory when hook injection is missing/stale.
+- \`search_semantic\` remains available for follow-up memory expansion.
 ${CODEX_BLOCK_END}
 `;
 export function buildInstallPromptSuggestion(target) {
@@ -73,28 +92,25 @@ function buildHookedPromptSuggestion(target) {
             : 'Codex';
     return `# gramatr (${platform})
 
-gramatr is installed locally. Hooks and the local MCP runtime usually inject
-the intelligence packet automatically at session start and prompt submit time.
+gramatr is installed locally. Hooks inject a \`gmtr.intelligence.contract.v2\`
+packet into your context at session start and on every user prompt.
 
-When a \`[gramatr intelligence]\` block is present, follow it as authoritative.
+When a gramatr intelligence block is present, follow it as authoritative.
 When the packet is missing or clearly stale, call \`gramatr_route_request\`
 with the user's request before answering.
 
-Treat \`unified_packet\` as the canonical complete contract when present.
-Otherwise treat \`packet_1\` as the canonical fast contract envelope. All
-intelligence data should be consumed from JSON blocks (not prose). Read from
-\`unified_packet\` first, then \`packet_1.manifest\`,
-\`packet_1.classification\`, \`packet_1.search_results\` /
-\`packet_1.memory_context\`, and any packet-provided behavioral rules,
-quality gates, phase templates, or format constraints when present.
-Treat \`required_actions\` and \`contract_enforcement.hard_gates\` as mandatory.
+The packet contains classification (effort, intent, confidence), behavioral
+directives, phase templates, capability audit, quality gates, memory/search
+results, agent suggestions, and enrichment (reverse engineering + ISC scaffold).
+
+Treat \`directives.hard_gates\` and \`directives.behavioral_rules\` as mandatory.
+Follow \`process.phase_template\` for effort-gated phase sequencing.
+Use \`process.quality_gate_config\` for ISC verification.
+Consume \`enrichment.data.reasoning\` for RE and ISC when present.
+
 If responses are wrapped with \`schema: "gmtr.tool.result.v1"\`, parse the
 \`data\` field as the canonical tool payload.
 
-If \`packet_1.manifest.packet_2_status === "required"\`, call
-\`gramatr_get_packet_two\` with \`packet_1.manifest.enrichment_id\` before
-proceeding. Packet 2 is mandatory whenever it is required.
-
 For continuity questions like "what were we doing?" or "what changed?",
 call \`gramatr_load_handoff\` first, then \`search_semantic\` for detail.
 
@@ -113,25 +129,33 @@ function buildHooklessLocalPromptSuggestion(target) {
 
 You have gramatr connected as an MCP server.
 
-Before responding to any user message, call \`gramatr_route_request\` with the
-user's request. This returns the current project context, memory, behavioral
-guidance, and effort classification needed for a grounded response.
+**Before responding to any user message,** call \`gramatr_route_request\` with
+the user's prompt. This returns a \`gmtr.intelligence.contract.v2\` packet.
+
+**Follow the packet.** It contains classification, behavioral directives,
+phase templates, capability audit, quality gates, memory/search results,
+agent suggestions, and enrichment (RE + ISC scaffold).
+
+**Mandatory fields:**
+- \`directives.hard_gates\` — non-negotiable behavioral constraints
+- \`directives.behavioral_rules\` — algorithm phases, code rules, safety rules
+- \`process.phase_template\` — effort-gated phase sequence
+- \`process.quality_gate_config\` — ISC verification rules
+- \`enrichment.data.reasoning\` — RE + ISC when present
+
+**Memory:** Use gramatr MCP tools (\`search_semantic\`, \`create_entity\`,
+\`add_observation\`) as the source of truth — not local notes.
+
+**Effort-gated phases:**
+- instant: RESPOND only
+- fast: OBSERVE → RESPOND
+- standard: OBSERVE → PLAN → BUILD → VERIFY
+- extended+: OBSERVE → THINK → PLAN → BUILD → EXECUTE → VERIFY → LEARN
 
-Use \`unified_packet\` as the canonical complete response when present.
-Otherwise use \`packet_1\` as the canonical response envelope. If
-\`packet_1.manifest.packet_2_status === "required"\`, call
-\`gramatr_get_packet_two\` with the returned \`enrichment_id\` and treat Packet 2
-as mandatory before full execution.
 If responses are wrapped with \`schema: "gmtr.tool.result.v1"\`, use
 \`data\` as the canonical payload.
-Consume packet-provided behavioral rules, ISC/quality-gate fields, and
-format constraints directly from the JSON contract when present.
-Treat \`required_actions\` and \`contract_enforcement.hard_gates\` as mandatory.
-
-For continuity questions like "what were we doing?" or "what changed?",
-call \`gramatr_load_handoff\` before answering, then \`search_semantic\`
-for additional detail.
 
-Use gramatr as the source of truth for memory and project state.`;
+For continuity questions ("what were we doing?", "what changed?"),
+call \`gramatr_load_handoff\` before answering, then \`search_semantic\`.`;
 }
 //# sourceMappingURL=instructions.js.map

package/dist/setup/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/setup/instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAC3D,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,8BAA8B,CAAC;AAChE,MAAM,CAAC,MAAM,eAAe,GAAG,4BAA4B,CAAC;AAY5D,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,kBAAkB;;;;;;;;;;;;;;;;;;;;;EAqBvD,gBAAgB;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,iBAAiB;;;;;;;;;;;;;;;;;;;;;;EAsBhD,eAAe;CAChB,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAAC,MAA2B;IACtE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,aAAa,CAAC;QACnB,KAAK,OAAO,CAAC;QACb,KAAK,YAAY;YACf,OAAO,2BAA2B,CAAC,MAAM,CAAC,CAAC;QAC7C,KAAK,gBAAgB,CAAC;QACtB,KAAK,iBAAiB,CAAC;QACvB,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,kCAAkC,CAAC,MAAM,CAAC,CAAC;QACpD;YACE,OAAO,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,SAAS,2BAA2B,CAAC,MAA8C;IACjF,MAAM,QAAQ,GAAG,MAAM,KAAK,aAAa;QACvC,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,MAAM,KAAK,YAAY;YACvB,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,OAAO,CAAC;IAEd,OAAO,cAAc,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCA4BQ,CAAC;AACxC,CAAC;AAED,SAAS,kCAAkC,CACzC,MAA+E;IAE/E,MAAM,WAAW,GAAkC;QACjD,gBAAgB,EAAE,gBAAgB;QAClC,iBAAiB,EAAE,iBAAiB;QACpC,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,SAAS;KAClB,CAAC;IAEF,OAAO,cAAc,WAAW,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;iEAuBuB,CAAC;AAClE,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/setup/instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAC3D,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,8BAA8B,CAAC;AAChE,MAAM,CAAC,MAAM,eAAe,GAAG,4BAA4B,CAAC;AAY5D,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCvD,gBAAgB;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;EAyBhD,eAAe;CAChB,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAAC,MAA2B;IACtE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,aAAa,CAAC;QACnB,KAAK,OAAO,CAAC;QACb,KAAK,YAAY;YACf,OAAO,2BAA2B,CAAC,MAAM,CAAC,CAAC;QAC7C,KAAK,gBAAgB,CAAC;QACtB,KAAK,iBAAiB,CAAC;QACvB,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,kCAAkC,CAAC,MAAM,CAAC,CAAC;QACpD;YACE,OAAO,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,SAAS,2BAA2B,CAAC,MAA8C;IACjF,MAAM,QAAQ,GAAG,MAAM,KAAK,aAAa;QACvC,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,MAAM,KAAK,YAAY;YACvB,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,OAAO,CAAC;IAEd,OAAO,cAAc,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;uCAyBQ,CAAC;AACxC,CAAC;AAED,SAAS,kCAAkC,CACzC,MAA+E;IAE/E,MAAM,WAAW,GAAkC;QACjD,gBAAgB,EAAE,gBAAgB;QAClC,iBAAiB,EAAE,iBAAiB;QACpC,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,SAAS;KAClB,CAAC;IAEF,OAAO,cAAc,WAAW,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0EA+BgC,CAAC;AAC3E,CAAC"}

package/dist/setup/integrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../src/setup/integrations.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAC;CAClD;AAYD,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAwEnD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAExE;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAEvE;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpD,OAAO,EAAE,gBAAgB,GACxB,gBAAgB,CAQlB;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAalE;AAED,wBAAgB,yBAAyB,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAIhF"}
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../src/setup/integrations.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAC;CAClD;AAYD,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAwEnD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAExE;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAEvE;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpD,OAAO,EAAE,gBAAgB,GACxB,gBAAgB,CAyBlB;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAalE;AAED,wBAAgB,yBAAyB,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAIhF"}