cortex-engine 0.4.1 → 0.5.0

package/dist/tools/thread-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-create.d.ts","sourceRoot":"","sources":["../../src/tools/thread-create.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,iBAAiB,CAAC;AAInE,eAAO,MAAM,gBAAgB,EAAE,cAsD9B,CAAC"}

package/dist/tools/thread-create.js

@@ -0,0 +1,57 @@
+/**
+ * thread_create — create a new thought thread.
+ */
+const COLLECTION = 'threads_v2';
+export const threadCreateTool = {
+    name: 'thread_create',
+    description: 'Create a new thought thread for tracking ongoing questions, explorations, or topics.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            title: { type: 'string', description: 'Short thread name' },
+            body: { type: 'string', description: 'Current state description' },
+            kind: { type: 'string', description: "Thread kind: 'work' | 'exploration' | 'creative' | 'revenue' | 'meta'" },
+            tags: { type: 'array', items: { type: 'string' }, description: 'Array of tags' },
+            priority: { type: 'number', description: 'Priority 0-1 (default 0.5)' },
+            project: { type: 'string', description: 'Project scope for filtered queries' },
+            next_step: { type: 'string', description: 'Actionable next move' },
+            namespace: { type: 'string', description: 'Namespace (defaults to default)' },
+        },
+        required: ['title', 'body'],
+    },
+    async handler(args, ctx) {
+        const title = typeof args['title'] === 'string' ? args['title'] : '';
+        const body = typeof args['body'] === 'string' ? args['body'] : '';
+        if (!title)
+            return { error: 'title is required' };
+        if (!body)
+            return { error: 'body is required' };
+        const kind = typeof args['kind'] === 'string' ? args['kind'] : 'exploration';
+        const project = typeof args['project'] === 'string' ? args['project'] : null;
+        const tags = Array.isArray(args['tags']) ? args['tags'] : [];
+        const priority = typeof args['priority'] === 'number' ? args['priority'] : 0.5;
+        const nextStep = typeof args['next_step'] === 'string' ? args['next_step'] : undefined;
+        const namespace = typeof args['namespace'] === 'string' ? args['namespace'] : undefined;
+        const store = ctx.namespaces.getStore(namespace);
+        const now = new Date().toISOString();
+        const doc = {
+            title,
+            body,
+            kind,
+            project,
+            tags,
+            status: 'open',
+            priority,
+            updates: [],
+            session_refs: [],
+            related_memory_ids: [],
+            created_at: now,
+            updated_at: now,
+        };
+        if (nextStep !== undefined)
+            doc['next_step'] = nextStep;
+        const id = await store.put(COLLECTION, doc);
+        return { id, title, body, kind, project, status: 'open', priority };
+    },
+};
+//# sourceMappingURL=thread-create.js.map

package/dist/tools/thread-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-create.js","sourceRoot":"","sources":["../../src/tools/thread-create.ts"],"names":[],"mappings":"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"}

package/dist/tools/thread-resolve.d.ts

@@ -0,0 +1,6 @@
+/**
+ * thread_resolve — resolve a thread with a resolution note.
+ */
+import type { ToolDefinition } from '../mcp/tools.js';
+export declare const threadResolveTool: ToolDefinition;
+//# sourceMappingURL=thread-resolve.d.ts.map

package/dist/tools/thread-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-resolve.d.ts","sourceRoot":"","sources":["../../src/tools/thread-resolve.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,iBAAiB,CAAC;AAInE,eAAO,MAAM,iBAAiB,EAAE,cAuC/B,CAAC"}

package/dist/tools/thread-resolve.js

@@ -0,0 +1,42 @@
+/**
+ * thread_resolve — resolve a thread with a resolution note.
+ */
+const COLLECTION = 'threads_v2';
+export const threadResolveTool = {
+    name: 'thread_resolve',
+    description: 'Resolve a thread with a resolution note.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: { type: 'string', description: 'Thread ID' },
+            resolution: { type: 'string', description: 'How/why it was resolved' },
+            namespace: { type: 'string', description: 'Namespace (defaults to default)' },
+        },
+        required: ['id', 'resolution'],
+    },
+    async handler(args, ctx) {
+        const id = typeof args['id'] === 'string' ? args['id'] : '';
+        const resolution = typeof args['resolution'] === 'string' ? args['resolution'] : '';
+        if (!id)
+            return { error: 'id is required' };
+        if (!resolution)
+            return { error: 'resolution is required' };
+        const namespace = typeof args['namespace'] === 'string' ? args['namespace'] : undefined;
+        const store = ctx.namespaces.getStore(namespace);
+        const existing = await store.get(COLLECTION, id);
+        if (!existing)
+            return { error: `Thread not found: ${id}` };
+        const now = new Date().toISOString();
+        const existingUpdates = Array.isArray(existing['updates']) ? existing['updates'] : [];
+        const resolveEntry = { timestamp: now, content: `Resolved: ${resolution}` };
+        await store.update(COLLECTION, id, {
+            status: 'resolved',
+            resolved_at: now,
+            resolution,
+            updated_at: now,
+            updates: [...existingUpdates, resolveEntry],
+        });
+        return { id, status: 'resolved', resolution };
+    },
+};
+//# sourceMappingURL=thread-resolve.js.map

package/dist/tools/thread-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-resolve.js","sourceRoot":"","sources":["../../src/tools/thread-resolve.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,GAAG,YAAY,CAAC;AAEhC,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,0CAA0C;IACvD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE;YAChD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;YACtE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;SAC9E;QACD,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC;KAC/B;IAED,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,GAAgB;QAC3D,MAAM,EAAE,GAAG,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,IAAI,CAAC,EAAE;YAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAC5C,IAAI,CAAC,UAAU;YAAE,OAAO,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;QAE5D,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxF,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,EAAE,CAAC;QAE3D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAA8B,CAAC,CAAC,CAAC,EAAE,CAAC;QACnH,MAAM,YAAY,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,UAAU,EAAE,EAAE,CAAC;QAE5E,MAAM,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE;YACjC,MAAM,EAAE,UAAU;YAClB,WAAW,EAAE,GAAG;YAChB,UAAU;YACV,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,CAAC,GAAG,eAAe,EAAE,YAAY,CAAC;SAC5C,CAAC,CAAC;QAEH,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;IAChD,CAAC;CACF,CAAC"}

package/dist/tools/thread-update.d.ts

@@ -0,0 +1,6 @@
+/**
+ * thread_update — update a thread's status, content, or metadata.
+ */
+import type { ToolDefinition } from '../mcp/tools.js';
+export declare const threadUpdateTool: ToolDefinition;
+//# sourceMappingURL=thread-update.d.ts.map

package/dist/tools/thread-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-update.d.ts","sourceRoot":"","sources":["../../src/tools/thread-update.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,iBAAiB,CAAC;AAInE,eAAO,MAAM,gBAAgB,EAAE,cAsF9B,CAAC"}

package/dist/tools/thread-update.js

@@ -0,0 +1,91 @@
+/**
+ * thread_update — update a thread's status, content, or metadata.
+ */
+const COLLECTION = 'threads_v2';
+export const threadUpdateTool = {
+    name: 'thread_update',
+    description: 'Update a thread — change status, edit title/body, add session refs, link memories.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: { type: 'string', description: 'Thread ID' },
+            title: { type: 'string', description: 'New title' },
+            body: { type: 'string', description: 'New body text' },
+            kind: { type: 'string', description: "Thread kind: 'work' | 'exploration' | 'creative' | 'revenue' | 'meta'" },
+            status: { type: 'string', description: 'New status: open, active, blocked, parked, resolved' },
+            blocked_by: { type: 'string', description: 'What is blocking this thread — auto-sets status to blocked' },
+            next_step: { type: 'string', description: 'Actionable next move' },
+            update_note: { type: 'string', description: 'Progress note to append to updates log' },
+            add_session_ref: { type: 'string', description: 'Session date to append' },
+            project: { type: 'string', description: 'Set or change project scope' },
+            add_memory_id: { type: 'string', description: 'Memory ID to link' },
+            priority: { type: 'number', description: 'New priority 0-1' },
+            tags: { type: 'array', items: { type: 'string' }, description: 'Replace tags entirely' },
+            namespace: { type: 'string', description: 'Namespace (defaults to default)' },
+        },
+        required: ['id'],
+    },
+    async handler(args, ctx) {
+        const id = typeof args['id'] === 'string' ? args['id'] : '';
+        if (!id)
+            return { error: 'id is required' };
+        const namespace = typeof args['namespace'] === 'string' ? args['namespace'] : undefined;
+        const store = ctx.namespaces.getStore(namespace);
+        const existing = await store.get(COLLECTION, id);
+        if (!existing)
+            return { error: `Thread not found: ${id}` };
+        const now = new Date().toISOString();
+        const updates = { updated_at: now };
+        if (typeof args['title'] === 'string')
+            updates['title'] = args['title'];
+        if (typeof args['body'] === 'string')
+            updates['body'] = args['body'];
+        if (typeof args['kind'] === 'string')
+            updates['kind'] = args['kind'];
+        if (typeof args['status'] === 'string')
+            updates['status'] = args['status'];
+        if (typeof args['next_step'] === 'string')
+            updates['next_step'] = args['next_step'];
+        if (typeof args['project'] === 'string')
+            updates['project'] = args['project'] || null;
+        if (typeof args['priority'] === 'number')
+            updates['priority'] = args['priority'];
+        if (Array.isArray(args['tags']))
+            updates['tags'] = args['tags'];
+        // Append to session_refs array
+        if (typeof args['add_session_ref'] === 'string') {
+            const refs = Array.isArray(existing['session_refs']) ? existing['session_refs'] : [];
+            if (!refs.includes(args['add_session_ref'])) {
+                updates['session_refs'] = [...refs, args['add_session_ref']];
+            }
+        }
+        // Append to related_memory_ids array
+        if (typeof args['add_memory_id'] === 'string') {
+            const ids = Array.isArray(existing['related_memory_ids']) ? existing['related_memory_ids'] : [];
+            if (!ids.includes(args['add_memory_id'])) {
+                updates['related_memory_ids'] = [...ids, args['add_memory_id']];
+            }
+        }
+        // Handle blocked_by — auto-set status
+        if (typeof args['blocked_by'] === 'string') {
+            updates['blocked_by'] = args['blocked_by'];
+            updates['status'] = 'blocked';
+        }
+        // Append update note
+        if (typeof args['update_note'] === 'string') {
+            const existingUpdates = Array.isArray(existing['updates']) ? existing['updates'] : [];
+            const entry = {
+                timestamp: now,
+                content: args['update_note'],
+            };
+            if (typeof args['add_session_ref'] === 'string') {
+                entry['session_ref'] = args['add_session_ref'];
+            }
+            updates['updates'] = [...existingUpdates, entry];
+        }
+        await store.update(COLLECTION, id, updates);
+        const updated = await store.get(COLLECTION, id);
+        return { id, ...updated };
+    },
+};
+//# sourceMappingURL=thread-update.js.map

package/dist/tools/thread-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-update.js","sourceRoot":"","sources":["../../src/tools/thread-update.ts"],"names":[],"mappings":"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"}

package/dist/tools/threads-list.d.ts

@@ -0,0 +1,6 @@
+/**
+ * threads_list — list thought threads with filters.
+ */
+import type { ToolDefinition } from '../mcp/tools.js';
+export declare const threadsListTool: ToolDefinition;
+//# sourceMappingURL=threads-list.d.ts.map

package/dist/tools/threads-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads-list.d.ts","sourceRoot":"","sources":["../../src/tools/threads-list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,iBAAiB,CAAC;AAKnE,eAAO,MAAM,eAAe,EAAE,cAuE7B,CAAC"}

package/dist/tools/threads-list.js

@@ -0,0 +1,70 @@
+/**
+ * threads_list — list thought threads with filters.
+ */
+const COLLECTION = 'threads_v2';
+export const threadsListTool = {
+    name: 'threads_list',
+    description: "List thought threads. Filter by status (default 'open'), project, kind, or tag.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            status: { type: 'string', description: "Filter by status: open, active, blocked, parked, resolved (default 'open')" },
+            project: { type: 'string', description: 'Filter by project scope' },
+            kind: { type: 'string', description: "Filter by kind: 'work' | 'exploration' | 'creative' | 'revenue' | 'meta'" },
+            tag: { type: 'string', description: 'Filter by tag' },
+            limit: { type: 'number', description: 'Max threads to return (default 50)' },
+            namespace: { type: 'string', description: 'Namespace (defaults to default)' },
+        },
+    },
+    async handler(args, ctx) {
+        const status = typeof args['status'] === 'string' ? args['status'] : 'open';
+        const project = typeof args['project'] === 'string' ? args['project'] : undefined;
+        const kind = typeof args['kind'] === 'string' ? args['kind'] : undefined;
+        const tag = typeof args['tag'] === 'string' ? args['tag'] : undefined;
+        const limit = typeof args['limit'] === 'number' ? args['limit'] : 50;
+        const namespace = typeof args['namespace'] === 'string' ? args['namespace'] : undefined;
+        const store = ctx.namespaces.getStore(namespace);
+        // Build filters
+        const filters = [
+            { field: 'status', op: '==', value: status },
+        ];
+        if (project) {
+            filters.push({ field: 'project', op: '==', value: project });
+        }
+        if (tag) {
+            filters.push({ field: 'tags', op: 'array-contains', value: tag });
+        }
+        const docs = await store.query(COLLECTION, filters, {
+            limit,
+            orderBy: 'priority',
+            orderDir: 'desc',
+        });
+        // Client-side kind filter (not all stores support compound queries efficiently)
+        let threads = docs.map(d => ({
+            id: d['id'],
+            title: d['title'],
+            body: d['body'],
+            kind: d['kind'],
+            project: d['project'] ?? null,
+            priority: d['priority'],
+            status: d['status'],
+            next_step: d['next_step'],
+            tags: d['tags'],
+            updates_count: Array.isArray(d['updates']) ? d['updates'].length : 0,
+            created_at: d['created_at'],
+            updated_at: d['updated_at'],
+        }));
+        if (kind) {
+            threads = threads.filter(t => t.kind === kind);
+        }
+        return {
+            status,
+            project: project ?? 'all',
+            kind: kind ?? 'all',
+            filter: tag ?? 'all',
+            count: threads.length,
+            threads,
+        };
+    },
+};
+//# sourceMappingURL=threads-list.js.map

package/dist/tools/threads-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads-list.js","sourceRoot":"","sources":["../../src/tools/threads-list.ts"],"names":[],"mappings":"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"}

package/fozikio.json

@@ -0,0 +1,14 @@
+{
+  "name": "cortex-engine",
+  "version": "0.4.1",
+  "description": "Portable cognitive engine for AI agents — semantic memory, embeddings, dream consolidation, MCP server",
+  "requires": {
+    "cortex_api": ">=0.3.0"
+  },
+  "contents": {
+    "hooks": ["cognitive-grounding", "observe-first", "cortex-telemetry", "session-lifecycle", "project-board-gate"],
+    "reflex_rules": ["cognitive-grounding", "observe-first", "note-about-doing"],
+    "skills": ["cortex-query", "cortex-review"],
+    "agents": ["cortex-researcher"]
+  }
+}

package/hooks/cognitive-grounding.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+# ============================================================================
+# cognitive-grounding.sh — Claude Code Hook
+# ============================================================================
+# Event:    UserPromptSubmit
+# Purpose:  Reminds agents to call cortex query() before substantive work
+#           (evaluation, design, review, architecture, etc.)
+# How:      Pattern-matches the user prompt for cognitive-work keywords.
+#           If matched, injects a system message nudging the agent to query().
+# Disable:  Delete this file from .claude/hooks/ — no other config needed.
+# Part of:  fozikio — portable, no project-specific paths.
+# ============================================================================
+
+INPUT=$(cat)
+PROMPT=$(echo "$INPUT" | jq -r '.user_prompt // ""' 2>/dev/null)
+
+# Check if prompt involves evaluation/design/review work
+if echo "$PROMPT" | grep -qiE '(evaluat|review|design|assess|analyz|creat|build|architect|plan|propos|critique|audit|diagnos)'; then
+  cat <<'EOF'
+{
+  "systemMessage": "**[fozikio: cognitive-grounding]**\nThis prompt involves substantive cognitive work. Before responding, call `query()` on the topic to ground your work in accumulated experience.\n\n```\nmcp__cortex__query({ text: \"[the topic]\" })\n```"
+}
+EOF
+else
+  echo '{}'
+fi

package/hooks/cortex-telemetry.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+# ============================================================================
+# cortex-telemetry.sh — Claude Code Hook
+# ============================================================================
+# Event:    PostToolUse
+# Purpose:  Tracks cortex retrieval tool usage and detects retries (repeat
+#           retrieval calls within 60s), sending feedback to the cortex API
+#           for retrieval quality improvement.
+# How:      Logs each cortex retrieval call (query, recall, wander, etc.) to
+#           .claude/state/cortex-calls.log. If two calls happen within 60s,
+#           POSTs a "retry" signal to CORTEX_API_URL/api/v2/retrieval-feedback.
+# Env:      CORTEX_API_URL, CORTEX_API_TOKEN (optional — skips API call if unset)
+# Disable:  Delete this file from .claude/hooks/ — no other config needed.
+# Part of:  fozikio — portable, fire-and-forget HTTP calls.
+# ============================================================================
+
+INPUT=$(cat)
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // ""' 2>/dev/null)
+TIMESTAMP=$(date +%s)
+STATE_DIR="${CLAUDE_PROJECT_DIR:-.}/.claude/state"
+LOG_FILE="$STATE_DIR/cortex-calls.log"
+
+# Only track cortex retrieval tools
+case "$TOOL_NAME" in
+  mcp__cortex__query|mcp__cortex__recall|mcp__cortex__wander|mcp__cortex__neighbors|mcp__cortex__surface|mcp__cortex__retrieve)
+    mkdir -p "$STATE_DIR"
+
+    # Read previous entry BEFORE appending current
+    PREV=$(tail -1 "$LOG_FILE" 2>/dev/null || echo "")
+    PREV_TS=$(echo "$PREV" | cut -d' ' -f1)
+    PREV_TOOL=$(echo "$PREV" | cut -d' ' -f2-)
+
+    # Log current call
+    echo "$TIMESTAMP $TOOL_NAME" >> "$LOG_FILE"
+
+    # Check if this is a retry (another cortex call within 60s)
+    if [ -n "$PREV_TS" ] && [ "$((TIMESTAMP - PREV_TS))" -lt 60 ] 2>/dev/null; then
+      # Post feedback to cortex API (fire and forget)
+      CORTEX_API_URL="${CORTEX_API_URL:-}"
+      CORTEX_API_TOKEN="${CORTEX_API_TOKEN:-}"
+      if [ -n "$CORTEX_API_URL" ] && [ -n "$CORTEX_API_TOKEN" ]; then
+        curl -s --max-time 3 "$CORTEX_API_URL/api/v2/retrieval-feedback" \
+          -H "x-cortex-token: $CORTEX_API_TOKEN" \
+          -H "Content-Type: application/json" \
+          -d "{\"original_tool\":\"$PREV_TOOL\",\"retry_tool\":\"$TOOL_NAME\",\"signal\":\"retry\",\"timestamp\":$TIMESTAMP}" \
+          > /dev/null 2>&1 &
+      fi
+    fi
+    ;;
+esac
+
+# Always output empty JSON (non-blocking hook)
+echo '{}'

package/hooks/observe-first.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# ============================================================================
+# observe-first.sh — Claude Code Hook
+# ============================================================================
+# Event:    PreToolUse (Write, Edit)
+# Purpose:  Reminds agents to call observe() or query() before writing to
+#           memory directories (Mind/, Journal/, memory/).
+# How:      Checks the file path of Write/Edit operations. If targeting a
+#           memory directory, injects a system message reminder.
+# Disable:  Delete this file from .claude/hooks/ — no other config needed.
+# Part of:  fozikio — portable, no project-specific paths.
+# ============================================================================
+
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // ""' 2>/dev/null)
+
+if echo "$FILE_PATH" | grep -qiE '(Mind|Journal|memory)'; then
+  cat <<'EOF'
+{
+  "systemMessage": "**[fozikio: observe-first]**\nWriting to a memory directory. Have you called observe() or query() first? Memory writes should be grounded in cortex context."
+}
+EOF
+else
+  echo '{}'
+fi