@aexol/spectral 0.9.200 → 0.9.202

package/dist/extensions/image-generation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/image-generation/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAmB,YAAY,EAAkB,MAAM,iCAAiC,CAAC;AA4GrG,wBAA8B,wBAAwB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA4DvF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/image-generation/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAmB,YAAY,EAAkB,MAAM,iCAAiC,CAAC;AAyLrG,wBAA8B,wBAAwB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDvF"}

package/dist/extensions/image-generation/index.js

@@ -1,6 +1,6 @@
 import { Type } from "typebox";
-import { mkdirSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { extname, join, resolve } from "node:path";
 import { generateImages, getImageModel, getImageModels } from "../../sdk/ai/index.js";
 // App-layer routing helpers (mirror aexol-mcp.ts): obtain backendUrl +
 // machineJwt the same way agent-bridge.ts gets them for text models, so image
@@ -9,13 +9,23 @@ import { generateImages, getImageModel, getImageModels } from "../../sdk/ai/inde
 import { getApiUrl, readConfig } from "../../config.js";
 import { loadMachine } from "../../relay/machine-store.js";
 import { isJwtExpired } from "../../relay/registration.js";
+const imageReferenceSchema = Type.Union([
+    Type.String({
+        description: "Path to a reference image file (relative to the project working directory or absolute).",
+    }),
+    Type.Object({
+        data: Type.String({ description: "Reference image as raw base64 or data URL." }),
+        mimeType: Type.Optional(Type.String({ default: "image/png", description: "Reference image MIME type." })),
+    }, { description: "Reference image provided inline as base64 data." }),
+    Type.Object({
+        path: Type.String({ description: "Path to a reference image file (relative to the project working directory or absolute)." }),
+        mimeType: Type.Optional(Type.String({ description: "Reference image MIME type. Defaults to the type detected from the file extension." })),
+    }, { description: "Reference image provided as a file path." }),
+]);
 const imageGenerateSchema = Type.Object({
     prompt: Type.String({ description: "Text prompt describing the image to generate." }),
     model: Type.Optional(Type.String({ default: "google/gemini-3.1-flash-lite-image", description: "OpenRouter image model id." })),
-    images: Type.Optional(Type.Array(Type.Object({
-        data: Type.String({ description: "Reference image as raw base64 or data URL." }),
-        mimeType: Type.Optional(Type.String({ default: "image/png", description: "Reference image MIME type." })),
-    }), { description: "Optional reference images for image-to-image generation." })),
+    images: Type.Optional(Type.Array(imageReferenceSchema, { description: "Optional reference images for image-to-image generation. Each element may be a file path string, an object { data: <base64 or data URL>, mimeType?: string }, or an object { path: <file path>, mimeType?: string }." })),
     n: Type.Optional(Type.Number({ minimum: 1, maximum: 10, default: 1 })),
     resolution: Type.Optional(Type.String({ description: "Resolution tier, e.g. 512, 1K, 2K, 4K." })),
     aspect_ratio: Type.Optional(Type.String({ description: "Aspect ratio, e.g. 1:1, 16:9, 9:16, auto." })),
@@ -40,6 +50,70 @@ function extensionForMimeType(mimeType) {
         return "webp";
     return "png";
 }
+function mimeTypeForPath(filePath) {
+    switch (extname(filePath).toLowerCase()) {
+        case ".png":
+            return "image/png";
+        case ".jpg":
+        case ".jpeg":
+            return "image/jpeg";
+        case ".webp":
+            return "image/webp";
+        case ".gif":
+            return "image/gif";
+        default:
+            return "image/png";
+    }
+}
+function readReferenceImageFromPath(filePath, mimeType) {
+    let data;
+    try {
+        data = readFileSync(filePath).toString("base64");
+    }
+    catch (error) {
+        const code = error?.code;
+        if (code === "ENOENT") {
+            throw new Error(`Reference image file does not exist: ${filePath}`);
+        }
+        if (code === "EACCES" || code === "EPERM") {
+            throw new Error(`Permission denied while reading reference image: ${filePath}`);
+        }
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to read reference image: ${filePath} (${detail})`);
+    }
+    return {
+        type: "image",
+        data,
+        mimeType: mimeType ?? mimeTypeForPath(filePath),
+    };
+}
+function normalizeReferenceImages(images, cwd) {
+    if (!images)
+        return [];
+    return images.map((image, index) => {
+        if (typeof image === "string") {
+            return readReferenceImageFromPath(resolve(cwd, image), undefined);
+        }
+        if (typeof image !== "object" || image === null) {
+            throw new Error(`Invalid reference image at index ${index}: expected a file path string or an object with "data" or "path".`);
+        }
+        const reference = image;
+        if (typeof reference.data === "string" && typeof reference.path === "string") {
+            throw new Error(`Invalid reference image at index ${index}: provide only one of "data" (inline base64) or "path" (file path), not both.`);
+        }
+        if (typeof reference.data === "string") {
+            return {
+                type: "image",
+                data: reference.data,
+                mimeType: reference.mimeType ?? "image/png",
+            };
+        }
+        if (typeof reference.path === "string") {
+            return readReferenceImageFromPath(resolve(cwd, reference.path), reference.mimeType);
+        }
+        throw new Error(`Invalid reference image at index ${index}: expected a file path string or an object with "data" or "path".`);
+    });
+}
 function slugFromPrompt(prompt) {
     const slug = prompt
         .normalize("NFKD")
@@ -120,11 +194,7 @@ export default async function imageGenerationExtension(ext) {
             const context = {
                 input: [
                     { type: "text", text: input.prompt },
-                    ...(input.images ?? []).map((image) => ({
-                        type: "image",
-                        data: image.data,
-                        mimeType: image.mimeType ?? "image/png",
-                    })),
+                    ...normalizeReferenceImages(input.images, ctx.cwd),
                 ],
             };
             // Route through the backend image proxy (POST /image/generation) using

package/dist/memory/tools/read-project-observations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-project-observations.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/read-project-observations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAE/E,eAAO,MAAM,2BAA2B;;iFAwFtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE3E"}
+{"version":3,"file":"read-project-observations.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/read-project-observations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAE/E,eAAO,MAAM,2BAA2B;;iFA4FtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE3E"}

package/dist/memory/tools/read-project-observations.js

@@ -9,22 +9,26 @@ export const readProjectObservationsTool = defineTool({
         "and per-working-directory (cwd). " +
         "Use this when you need to recall project conventions, past decisions, " +
         "file locations, or user preferences before editing or creating files. " +
-        "Uses simple substring matching — be specific with your query terms. " +
-        "Returns up to 20 most recent matching observations with relevance tags. " +
+        "Uses n-gram matching: multi-word queries match observations containing all terms; " +
+        "typo-tolerant fallback when nothing matches exactly. " +
+        "Returns up to 20 best-matching observations with relevance tags. " +
         "Results are local to this machine and cwd; they are NOT synced across machines or teams.",
     promptSnippet: "Use read_project_observations(<query>) to search past observations across sessions in this local project working directory.",
     promptGuidelines: [
         "Results are per-machine + per-cwd and cross-session; they are NOT shared across machines or teams.",
         "Use read_project_observations before creating new files to find conventions for that file kind.",
         "Use read_project_observations before editing a file to find past context about that file or its directory.",
-        "Be specific: search for file paths, technology names, or pattern keywords.",
+        "Search for file paths, technology names, or pattern keywords; multi-word queries match observations containing all terms.",
         "Do not use for broad topic searches — keep queries narrow for relevant results.",
         "Results include relevance tags (critical/high/medium/low) to help you prioritize.",
+        "Results are ranked by match quality, relevance tag, and recency.",
     ],
     parameters: Type.Object({
         query: Type.String({
             minLength: 1,
-            description: "Substring to search for in past observation content. " +
+            description: "Search terms to look for in past observation content. " +
+                "Multi-word queries match observations containing all terms; " +
+                "minor typos are tolerated when nothing matches exactly. " +
                 "Use file paths (e.g. 'src/auth/middleware'), technology names, " +
                 "or pattern keywords (e.g. 'convention', 'api route').",
         }),

package/dist/memory/tools/write-project-observation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-project-observation.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/write-project-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAE/E,eAAO,MAAM,2BAA2B;;;iFA2EtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE3E"}
+{"version":3,"file":"write-project-observation.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/write-project-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAE/E,eAAO,MAAM,2BAA2B;;;iFA+EtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE3E"}

package/dist/memory/tools/write-project-observation.js

@@ -11,7 +11,9 @@ export const writeProjectObservationTool = defineTool({
         "they are shared across sessions on this machine but are NOT synced across machines or teams. " +
         "Use this to persist discovered conventions, architectural rules, " +
         "gotchas, and directory purposes. Observations are deduplicated by " +
-        "content hash — writing the same fact twice is harmless (idempotent). " +
+        "content hash — writing the same fact twice is harmless (idempotent) — " +
+        "and near-duplicate rewordings (very similar content) automatically " +
+        "replace the older observation. " +
         "Future sessions in this working directory can discover these via read_project_observations.",
     promptSnippet: "Use write_project_observation(content, relevance) to persist local, cross-session knowledge for this working directory.",
     promptGuidelines: [
@@ -22,6 +24,8 @@ export const writeProjectObservationTool = defineTool({
         "Use relevance='medium' for useful patterns and directory purposes.",
         "Content must be a single, self-contained sentence — no markdown, no lists.",
         "Deduplication is automatic — same content = same ID → INSERT OR REPLACE.",
+        "Near-duplicate rewordings (very similar content) replace the older observation automatically — no need to delete or rewrite existing facts first.",
+        "A rewording that replaces a near-duplicate gets a new id; observation ids shared before the replacement may become unresolvable.",
     ],
     parameters: Type.Object({
         content: Type.String({

package/dist/server/storage.d.ts

@@ -154,9 +154,17 @@ export declare class SessionStore {
     private stmtSetForkCompactSource;
     private stmtGetForkCompactSource;
     private stmtInsertProjectObs;
-    private stmtSearchProjectObs;
     private stmtGetProjectObsById;
     private stmtGetProjectByCwd;
+    private stmtListProjectObsByProject;
+    private stmtDeleteProjectObs;
+    private stmtCountProjectObs;
+    private ftsEnabled;
+    private stmtInsertProjectObsFts;
+    private stmtDeleteProjectObsFts;
+    private stmtDeleteProjectObsFtsByProject;
+    private stmtSearchProjectObsFts;
+    private stmtCountProjectObsFts;
     private stmtUpsertProjectRecallSource;
     private stmtGetProjectRecallSource;
     private stmtEnqueuePrompt;
@@ -409,6 +417,12 @@ export declare class SessionStore {
     /**
      * Insert multiple project observations in a single transaction.
      * Uses INSERT OR REPLACE so re-running after the same compaction is idempotent.
+     *
+     * Write-time near-duplicate detection: an observation whose content is a
+     * near-identical rewording (trigram Jaccard >= NEAR_DUPLICATE_SIMILARITY)
+     * of an existing row replaces it — new wording wins — so refinements of
+     * the same fact don't accumulate as duplicates. The FTS5 trigram index is
+     * synced in the same transaction.
      */
     insertProjectObservations(projectId: string, sessionId: string, observations: Array<{
         id: string;
@@ -416,7 +430,26 @@ export declare class SessionStore {
         relevance: string;
     }>, createdAt: number): void;
     /**
-     * Search project observations by substring match. Returns up to 20 most recent.
+     * Find an existing project observation whose content is a near-identical
+     * rewording of `content` (trigram Jaccard >= NEAR_DUPLICATE_SIMILARITY).
+     */
+    private findNearDuplicateObservation;
+    /**
+     * Search project observations using n-gram matching.
+     *
+     * Query tokens are matched via the FTS5 trigram index: each token becomes
+     * a quoted phrase joined with AND, so a multi-word query matches
+     * observations containing ALL tokens anywhere (case-insensitive substring
+     * semantics). Tokens shorter than 3 characters cannot be matched by the
+     * trigram tokenizer; they are applied as a complementary LIKE filter over
+     * the FTS candidates (or as a plain LIKE conjunction when every token is
+     * short, or when the index is unavailable). When no candidate survives,
+     * a typo-tolerant fallback keeps observations whose token-level trigram
+     * similarity to the query is >= TYPO_FALLBACK_MIN_MEAN_SIMILARITY.
+     *
+     * Results are ranked by a blend of text-match quality, relevance tag and
+     * recency. The return shape is unchanged from the previous substring
+     * search: { content, relevance, createdAt, sessionId }.
      */
     searchProjectObservations(projectId: string, query: string, limit?: number): Array<{
         content: string;
@@ -424,6 +457,30 @@ export declare class SessionStore {
         createdAt: number;
         sessionId: string;
     }>;
+    /**
+     * Collect candidate observations for a tokenized query, assigning each a
+     * normalized text-match score in (0, 1].
+     */
+    private findObservationCandidates;
+    /**
+     * FTS5 trigram MATCH over `longTokens`, then a complementary LIKE filter
+     * for tokens too short for the trigram tokenizer. Returns an empty array
+     * when the index yields nothing usable (the caller then falls back).
+     */
+    private searchObservationsFts;
+    /**
+     * Rebuild the FTS index from project_observations when it is out of sync
+     * (empty or partial relative to the base table). Handles databases created
+     * before the FTS index existed and any drift (e.g. projects deleted by an
+     * older build without FTS cleanup). No-op when the counts already match.
+     */
+    private backfillProjectObservationsFts;
+    /**
+     * Whether the FTS5 trigram index is active for project observations.
+     * Exposed for diagnostics and tests; false means search is running in
+     * LIKE-only degradation mode.
+     */
+    isProjectObsFtsEnabled(): boolean;
     /**
      * Get a single project observation by id. Returns null if not found.
      */

package/dist/server/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/server/storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/server/storage.ts"],"names":[],"mappings":"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"}

package/dist/server/storage.js

@@ -28,6 +28,7 @@
  * later (e.g. if we ever need to colocate with a remote service).
  */
 import { createSqliteAdapter } from "./sqlite-adapter.js";
+import { MIN_TRIGRAM_TOKEN_LENGTH, bestTokenTrigramJaccard, buildFtsMatchQuery, trigramJaccard, } from "./text/trigrams.js";
 import { randomUUID } from "node:crypto";
 import { mkdirSync, readFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
@@ -149,6 +150,61 @@ CREATE TABLE IF NOT EXISTS dev_process_definitions (
   updated_at INTEGER NOT NULL
 );
 `;
+/**
+ * FTS5 trigram index over project-observation content, synced explicitly in
+ * code (same transaction as `insertProjectObservations`) rather than via
+ * triggers so the behavior is obvious and testable. `obs_id` stores the
+ * observation id so stale index rows can be deleted on INSERT OR REPLACE.
+ *
+ * Created outside SCHEMA_SQL on purpose: if the bundled SQLite build lacks
+ * FTS5, the store still opens and observation search degrades to LIKE
+ * filtering instead of failing at startup.
+ */
+const PROJECT_OBS_FTS_SQL = `
+CREATE VIRTUAL TABLE IF NOT EXISTS project_observations_fts USING fts5(
+  content,
+  project_id UNINDEXED,
+  obs_id UNINDEXED,
+  tokenize='trigram'
+);
+`;
+// ---- observational-memory ranking constants ------------------------------
+/** Weight of the text-match component (bm25-derived or trigram similarity). */
+const WEIGHT_TEXT_MATCH = 0.6;
+/** Weight of the relevance-tag component (critical=1.0 … low=0.25). */
+const WEIGHT_RELEVANCE = 0.25;
+/** Weight of the recency component. */
+const WEIGHT_RECENCY = 0.15;
+/** Recency decay constant: exp(-ageDays / RECENCY_DECAY_DAYS). */
+const RECENCY_DECAY_DAYS = 30;
+const MS_PER_DAY = 86_400_000;
+/** Relevance-tag weights used by the ranking formula. */
+const RELEVANCE_WEIGHTS = {
+    critical: 1.0,
+    high: 0.75,
+    medium: 0.5,
+    low: 0.25,
+};
+/** Minimum mean trigram Jaccard similarity for a typo-tolerant fallback match. */
+const TYPO_FALLBACK_MIN_MEAN_SIMILARITY = 0.3;
+/**
+ * Trigram Jaccard similarity at or above which a new observation is treated
+ * as a near-duplicate rewording of an existing row and replaces it.
+ */
+const NEAR_DUPLICATE_SIMILARITY = 0.9;
+/**
+ * Final ranking score for a candidate observation: a weighted blend of
+ * normalized text-match quality, relevance tag and recency decay. Every
+ * component is in [0, 1]; higher is better.
+ */
+function scoreObservation(textScore, relevance, createdAt, now) {
+    const ageDays = Math.max(0, (now - createdAt) / MS_PER_DAY);
+    const recency = Math.exp(-ageDays / RECENCY_DECAY_DAYS);
+    const relevanceWeight = RELEVANCE_WEIGHTS[relevance] ?? RELEVANCE_WEIGHTS.low;
+    return (textScore * WEIGHT_TEXT_MATCH +
+        relevanceWeight * WEIGHT_RELEVANCE +
+        recency * WEIGHT_RECENCY);
+}
 /**
  * Synchronous binding-file reader for a project at the given filesystem path.
  * Returns null when no `.aexol/aexol.jsonc` exists at that path.
@@ -269,9 +325,20 @@ export class SessionStore {
     stmtGetForkCompactSource;
     // Project observations: cross-session durable memory.
     stmtInsertProjectObs;
-    stmtSearchProjectObs;
     stmtGetProjectObsById;
     stmtGetProjectByCwd;
+    // Shared by the typo-tolerant search fallback and near-duplicate detection.
+    stmtListProjectObsByProject;
+    stmtDeleteProjectObs;
+    stmtCountProjectObs;
+    // FTS5 trigram index statements. Null when the bundled SQLite build has no
+    // FTS5 — the store then degrades to LIKE-only search (see `ftsEnabled`).
+    ftsEnabled = false;
+    stmtInsertProjectObsFts = null;
+    stmtDeleteProjectObsFts = null;
+    stmtDeleteProjectObsFtsByProject = null;
+    stmtSearchProjectObsFts = null;
+    stmtCountProjectObsFts = null;
     stmtUpsertProjectRecallSource;
     stmtGetProjectRecallSource;
     // Prompt queue statements
@@ -539,14 +606,15 @@ export class SessionStore {
         this.stmtGetForkCompactSource = this.db.prepare(`SELECT fork_compact_source_id FROM sessions WHERE id = ?`);
         this.stmtInsertProjectObs = this.db.prepare(`INSERT OR REPLACE INTO project_observations (id, project_id, session_id, content, relevance, created_at)
        VALUES (?, ?, ?, ?, ?, ?)`);
-        this.stmtSearchProjectObs = this.db.prepare(`SELECT id, project_id, session_id, content, relevance, created_at
-       FROM project_observations
-       WHERE project_id = ? AND content LIKE ?
-       ORDER BY created_at DESC
-       LIMIT 20`);
         this.stmtGetProjectObsById = this.db.prepare(`SELECT id, project_id, session_id, content, relevance, created_at
        FROM project_observations
        WHERE project_id = ? AND id = ?`);
+        this.stmtListProjectObsByProject = this.db.prepare(`SELECT id, project_id, session_id, content, relevance, created_at
+       FROM project_observations
+       WHERE project_id = ?
+       ORDER BY created_at DESC`);
+        this.stmtDeleteProjectObs = this.db.prepare(`DELETE FROM project_observations WHERE id = ? AND project_id = ?`);
+        this.stmtCountProjectObs = this.db.prepare(`SELECT COUNT(*) AS count FROM project_observations`);
         this.stmtGetProjectByCwd = this.db.prepare(`SELECT id FROM projects WHERE path = ? LIMIT 1`);
         this.stmtUpsertProjectRecallSource = this.db.prepare(`INSERT OR REPLACE INTO project_recall_sources
        (project_id, memory_id, entries_json, updated_at)
@@ -554,6 +622,35 @@ export class SessionStore {
         this.stmtGetProjectRecallSource = this.db.prepare(`SELECT project_id, memory_id, entries_json, updated_at
        FROM project_recall_sources
        WHERE project_id = ? AND memory_id = ?`);
+        // ---- project-observation FTS trigram index ---------------------------
+        // The index is a standalone FTS5 virtual table synced explicitly in code
+        // (same transaction as insertProjectObservations). If the SQLite build
+        // lacks FTS5 we log a warning and degrade to LIKE-only search instead of
+        // failing to open the store.
+        try {
+            this.db.exec(PROJECT_OBS_FTS_SQL);
+            this.stmtInsertProjectObsFts = this.db.prepare(`INSERT INTO project_observations_fts (content, project_id, obs_id) VALUES (?, ?, ?)`);
+            this.stmtDeleteProjectObsFts = this.db.prepare(`DELETE FROM project_observations_fts WHERE obs_id = ? AND project_id = ?`);
+            this.stmtDeleteProjectObsFtsByProject = this.db.prepare(`DELETE FROM project_observations_fts WHERE project_id = ?`);
+            this.stmtSearchProjectObsFts = this.db.prepare(`SELECT o.id, o.session_id, o.content, o.relevance, o.created_at,
+                bm25(project_observations_fts) AS bm25_score
+         FROM project_observations_fts
+         JOIN project_observations o
+           ON o.id = project_observations_fts.obs_id
+          AND o.project_id = project_observations_fts.project_id
+         WHERE project_observations_fts MATCH ?
+           AND project_observations_fts.project_id = ?`);
+            this.stmtCountProjectObsFts = this.db.prepare(`SELECT COUNT(*) AS count FROM project_observations_fts`);
+            this.backfillProjectObservationsFts();
+            this.ftsEnabled = true;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.warn(`[storage] FTS5 trigram index unavailable (${msg}); ` +
+                `project-observation search degrades to a LIKE-conjunction ` +
+                `(exact token substring) scan without typo tolerance or bm25 ranking.`);
+            this.ftsEnabled = false;
+        }
         // ---- prompt queue statements ----------------------------------------
         this.stmtEnqueuePrompt = this.db.prepare(`INSERT INTO prompt_queue (id, session_id, content, images_json, position, created_at)
        VALUES (?, ?, ?, ?, ?, ?)`);
@@ -736,6 +833,11 @@ export class SessionStore {
     deleteProject(id) {
         const sessionIds = this.stmtListSessionIdsByProject.all(id).map((r) => r.id);
         const info = this.stmtDeleteProject.run(id);
+        if (info.changes > 0) {
+            // project_observations rows cascade via FK, but the standalone FTS
+            // index has no FK — clean it explicitly so it never accumulates orphans.
+            this.stmtDeleteProjectObsFtsByProject?.run(id);
+        }
         return { deleted: info.changes > 0, sessionIds };
     }
     /** Sessions belonging to a single project, newest-first. */
@@ -1358,29 +1460,202 @@ export class SessionStore {
     /**
      * Insert multiple project observations in a single transaction.
      * Uses INSERT OR REPLACE so re-running after the same compaction is idempotent.
+     *
+     * Write-time near-duplicate detection: an observation whose content is a
+     * near-identical rewording (trigram Jaccard >= NEAR_DUPLICATE_SIMILARITY)
+     * of an existing row replaces it — new wording wins — so refinements of
+     * the same fact don't accumulate as duplicates. The FTS5 trigram index is
+     * synced in the same transaction.
      */
     insertProjectObservations(projectId, sessionId, observations, createdAt) {
         if (observations.length === 0)
             return;
         const tx = this.db.transaction(() => {
             for (const obs of observations) {
+                // Near-duplicate detection: a reworded duplicate replaces the older
+                // row. Identical re-inserts also match (similarity 1.0), which keeps
+                // INSERT OR REPLACE idempotency intact.
+                const duplicate = this.findNearDuplicateObservation(projectId, obs.content);
+                if (duplicate) {
+                    this.stmtDeleteProjectObs.run(duplicate.id, projectId);
+                    this.stmtDeleteProjectObsFts?.run(duplicate.id, projectId);
+                }
                 this.stmtInsertProjectObs.run(obs.id, projectId, sessionId, obs.content, obs.relevance, createdAt);
+                if (this.ftsEnabled) {
+                    // INSERT OR REPLACE semantics: drop any stale index row for this id
+                    // before indexing the new content.
+                    this.stmtDeleteProjectObsFts?.run(obs.id, projectId);
+                    this.stmtInsertProjectObsFts?.run(obs.content, projectId, obs.id);
+                }
             }
         });
         tx();
     }
     /**
-     * Search project observations by substring match. Returns up to 20 most recent.
+     * Find an existing project observation whose content is a near-identical
+     * rewording of `content` (trigram Jaccard >= NEAR_DUPLICATE_SIMILARITY).
+     */
+    findNearDuplicateObservation(projectId, content) {
+        let best = null;
+        let bestSimilarity = 0;
+        for (const row of this.stmtListProjectObsByProject.all(projectId)) {
+            const similarity = trigramJaccard(content, row.content);
+            if (similarity > bestSimilarity) {
+                bestSimilarity = similarity;
+                best = row;
+            }
+        }
+        return bestSimilarity >= NEAR_DUPLICATE_SIMILARITY ? best : null;
+    }
+    /**
+     * Search project observations using n-gram matching.
+     *
+     * Query tokens are matched via the FTS5 trigram index: each token becomes
+     * a quoted phrase joined with AND, so a multi-word query matches
+     * observations containing ALL tokens anywhere (case-insensitive substring
+     * semantics). Tokens shorter than 3 characters cannot be matched by the
+     * trigram tokenizer; they are applied as a complementary LIKE filter over
+     * the FTS candidates (or as a plain LIKE conjunction when every token is
+     * short, or when the index is unavailable). When no candidate survives,
+     * a typo-tolerant fallback keeps observations whose token-level trigram
+     * similarity to the query is >= TYPO_FALLBACK_MIN_MEAN_SIMILARITY.
+     *
+     * Results are ranked by a blend of text-match quality, relevance tag and
+     * recency. The return shape is unchanged from the previous substring
+     * search: { content, relevance, createdAt, sessionId }.
      */
     searchProjectObservations(projectId, query, limit = 20) {
-        const pattern = `%${query}%`;
-        const rows = this.stmtSearchProjectObs.all(projectId, pattern);
-        return rows.slice(0, limit).map((r) => ({
+        const trimmed = query.trim();
+        if (!trimmed)
+            return [];
+        const tokens = trimmed.split(/\s+/).filter((t) => t.length > 0);
+        if (tokens.length === 0)
+            return [];
+        const now = Date.now();
+        return this.findObservationCandidates(projectId, tokens)
+            .map((candidate) => ({
+            candidate,
+            score: scoreObservation(candidate.textScore, candidate.relevance, candidate.created_at, now),
+        }))
+            .sort((a, b) => b.score - a.score || b.candidate.created_at - a.candidate.created_at)
+            .slice(0, limit)
+            .map(({ candidate }) => ({
+            content: candidate.content,
+            relevance: candidate.relevance,
+            createdAt: candidate.created_at,
+            sessionId: candidate.session_id,
+        }));
+    }
+    /**
+     * Collect candidate observations for a tokenized query, assigning each a
+     * normalized text-match score in (0, 1].
+     */
+    findObservationCandidates(projectId, tokens) {
+        const longTokens = tokens.filter((t) => t.length >= MIN_TRIGRAM_TOKEN_LENGTH);
+        const shortTokens = tokens.filter((t) => t.length < MIN_TRIGRAM_TOKEN_LENGTH);
+        // Primary path: FTS5 trigram MATCH over the trigram-matchable tokens.
+        if (longTokens.length > 0 && this.ftsEnabled) {
+            const candidates = this.searchObservationsFts(projectId, longTokens, shortTokens);
+            if (candidates.length > 0)
+                return candidates;
+        }
+        else if (!this.ftsEnabled && longTokens.length > 0) {
+            // FTS5 unavailable: LIKE-conjunction scan over the project's rows using
+            // ALL tokens as needles, preserving the pre-FTS substring semantics for
+            // non-token-aligned substrings (e.g. "igrate rollb").
+            const needles = tokens.map((t) => t.toLowerCase());
+            return this.stmtListProjectObsByProject
+                .all(projectId)
+                .filter((row) => {
+                const content = row.content.toLowerCase();
+                return needles.every((needle) => content.includes(needle));
+            })
+                .map((row) => ({ ...row, textScore: 1 }));
+        }
+        else if (longTokens.length === 0) {
+            // All tokens shorter than a trigram: plain LIKE conjunction.
+            const needles = shortTokens.map((t) => t.toLowerCase());
+            return this.stmtListProjectObsByProject
+                .all(projectId)
+                .filter((row) => {
+                const content = row.content.toLowerCase();
+                return needles.every((needle) => content.includes(needle));
+            })
+                .map((row) => ({ ...row, textScore: 1 }));
+        }
+        // Typo-tolerant fallback: nothing matched exactly. Scan the project's
+        // observations (small corpus) and keep near matches by trigram
+        // similarity, which substitutes for the bm25 component in the ranking.
+        return this.stmtListProjectObsByProject
+            .all(projectId)
+            .map((row) => ({ row, similarity: bestTokenTrigramJaccard(tokens, row.content) }))
+            .filter(({ similarity }) => similarity >= TYPO_FALLBACK_MIN_MEAN_SIMILARITY)
+            .map(({ row, similarity }) => ({ ...row, textScore: similarity }));
+    }
+    /**
+     * FTS5 trigram MATCH over `longTokens`, then a complementary LIKE filter
+     * for tokens too short for the trigram tokenizer. Returns an empty array
+     * when the index yields nothing usable (the caller then falls back).
+     */
+    searchObservationsFts(projectId, longTokens, shortTokens) {
+        const matchQuery = buildFtsMatchQuery(longTokens);
+        if (!matchQuery)
+            return [];
+        let rows;
+        try {
+            rows = this.stmtSearchProjectObsFts?.all(matchQuery, projectId) ?? [];
+        }
+        catch (err) {
+            // Defensive: a MATCH failure should degrade to the fallback path, not
+            // surface as a tool error.
+            const msg = err instanceof Error ? err.message : String(err);
+            console.warn(`[storage] project-observation FTS query failed: ${msg}`);
+            return [];
+        }
+        let candidates = rows.map((r) => ({
+            id: r.id,
+            project_id: projectId,
+            session_id: r.session_id,
             content: r.content,
             relevance: r.relevance,
-            createdAt: r.created_at,
-            sessionId: r.session_id,
+            created_at: r.created_at,
+            // bm25() is negative with lower = better in SQLite; 1 - exp(bm25)
+            // maps it to a bounded, higher-is-better text score in (0, 1].
+            textScore: 1 - Math.exp(r.bm25_score),
         }));
+        for (const token of shortTokens) {
+            const needle = token.toLowerCase();
+            candidates = candidates.filter((c) => c.content.toLowerCase().includes(needle));
+        }
+        return candidates;
+    }
+    /**
+     * Rebuild the FTS index from project_observations when it is out of sync
+     * (empty or partial relative to the base table). Handles databases created
+     * before the FTS index existed and any drift (e.g. projects deleted by an
+     * older build without FTS cleanup). No-op when the counts already match.
+     */
+    backfillProjectObservationsFts() {
+        const obsCount = this.stmtCountProjectObs.get()?.count ?? 0;
+        const ftsCount = this.stmtCountProjectObsFts?.get()?.count ?? 0;
+        if (obsCount === ftsCount)
+            return;
+        const tx = this.db.transaction(() => {
+            this.db.exec(`DELETE FROM project_observations_fts`);
+            if (obsCount > 0) {
+                this.db.exec(`INSERT INTO project_observations_fts (content, project_id, obs_id)
+           SELECT content, project_id, id FROM project_observations`);
+            }
+        });
+        tx();
+    }
+    /**
+     * Whether the FTS5 trigram index is active for project observations.
+     * Exposed for diagnostics and tests; false means search is running in
+     * LIKE-only degradation mode.
+     */
+    isProjectObsFtsEnabled() {
+        return this.ftsEnabled;
     }
     /**
      * Get a single project observation by id. Returns null if not found.

package/dist/server/text/trigrams.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Character-trigram text utilities for observational memory.
+ *
+ * Shared by the storage layer for:
+ *   - building FTS5 MATCH queries against the trigram-tokenized index
+ *     (`buildFtsMatchQuery`),
+ *   - typo-tolerant search fallback (`bestTokenTrigramJaccard`),
+ *   - write-time near-duplicate detection (`trigramJaccard`).
+ *
+ * Pure functions with no SQLite dependency so the logic is unit-testable
+ * in isolation.
+ */
+/**
+ * Minimum token length the SQLite trigram tokenizer can match. Tokens
+ * shorter than this cannot be satisfied by an FTS5 MATCH query and must be
+ * handled with complementary LIKE filtering (or the LIKE-only search path).
+ */
+export declare const MIN_TRIGRAM_TOKEN_LENGTH = 3;
+/**
+ * Per-token floor for {@link bestTokenTrigramJaccard}: every trigram-matchable
+ * query token must reach this Jaccard similarity against some content token,
+ * otherwise the content is considered not to match the query at all. This
+ * mirrors the AND semantics of the FTS MATCH path — every term must be
+ * (approximately) present — while still tolerating typos.
+ */
+export declare const TYPO_FALLBACK_MIN_TOKEN_SIMILARITY = 0.2;
+/** Normalize text for trigram comparison: lowercase and collapse whitespace. */
+export declare function normalizeForTrigrams(text: string): string;
+/**
+ * Build the set of character trigrams of `text`.
+ *
+ * Strings shorter than one trigram collapse to a single pseudo-token so
+ * identical short strings still compare equal (Jaccard 1.0). Empty input
+ * yields an empty set.
+ */
+export declare function trigramSet(text: string): Set<string>;
+/**
+ * Jaccard similarity between the character-trigram sets of two strings,
+ * in [0, 1]. Returns 0 when either side has no trigrams.
+ */
+export declare function trigramJaccard(a: string, b: string): number;
+/**
+ * Typo-tolerant similarity between a whole query and a piece of content:
+ * the mean, over query tokens, of the best Jaccard similarity between that
+ * token and any single content token.
+ *
+ * Comparing token-to-token (instead of query-to-full-content) keeps the
+ * score robust to sentence length — a one-word typo in a long observation
+ * would otherwise be diluted below any useful threshold.
+ *
+ * Only `queryTokens` of trigram-matchable length are scored; shorter tokens
+ * are ignored so they do not drag the mean down for matches they can never
+ * express. Returns 0 — no match — when any such token fails to reach
+ * TYPO_FALLBACK_MIN_TOKEN_SIMILARITY against every content token (the token
+ * is absent, mirroring the AND semantics of the FTS path), or when no query
+ * token qualifies.
+ */
+export declare function bestTokenTrigramJaccard(queryTokens: string[], content: string): number;
+/**
+ * Build an FTS5 MATCH query from search tokens.
+ *
+ * Each token becomes a quoted phrase (`"token"`); phrases are joined with
+ * AND. With the trigram tokenizer each quoted phrase acts as a
+ * case-insensitive substring match, so a multi-token query matches content
+ * containing all tokens anywhere. Embedded double quotes are escaped by
+ * doubling, which is how FTS5 string literals represent a literal quote.
+ *
+ * Returns an empty string when no non-empty tokens are supplied — callers
+ * must guard against that before running a MATCH query.
+ */
+export declare function buildFtsMatchQuery(tokens: string[]): string;
+//# sourceMappingURL=trigrams.d.ts.map

package/dist/server/text/trigrams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigrams.d.ts","sourceRoot":"","sources":["../../../src/server/text/trigrams.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,kCAAkC,MAAM,CAAC;AAEtD,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAWpD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,MAAM,GACd,MAAM,CAoBR;AAaD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAK3D"}

package/dist/server/text/trigrams.js

@@ -0,0 +1,128 @@
+/**
+ * Character-trigram text utilities for observational memory.
+ *
+ * Shared by the storage layer for:
+ *   - building FTS5 MATCH queries against the trigram-tokenized index
+ *     (`buildFtsMatchQuery`),
+ *   - typo-tolerant search fallback (`bestTokenTrigramJaccard`),
+ *   - write-time near-duplicate detection (`trigramJaccard`).
+ *
+ * Pure functions with no SQLite dependency so the logic is unit-testable
+ * in isolation.
+ */
+/**
+ * Minimum token length the SQLite trigram tokenizer can match. Tokens
+ * shorter than this cannot be satisfied by an FTS5 MATCH query and must be
+ * handled with complementary LIKE filtering (or the LIKE-only search path).
+ */
+export const MIN_TRIGRAM_TOKEN_LENGTH = 3;
+/**
+ * Per-token floor for {@link bestTokenTrigramJaccard}: every trigram-matchable
+ * query token must reach this Jaccard similarity against some content token,
+ * otherwise the content is considered not to match the query at all. This
+ * mirrors the AND semantics of the FTS MATCH path — every term must be
+ * (approximately) present — while still tolerating typos.
+ */
+export const TYPO_FALLBACK_MIN_TOKEN_SIMILARITY = 0.2;
+/** Normalize text for trigram comparison: lowercase and collapse whitespace. */
+export function normalizeForTrigrams(text) {
+    return text.toLowerCase().replace(/\s+/g, " ").trim();
+}
+/**
+ * Build the set of character trigrams of `text`.
+ *
+ * Strings shorter than one trigram collapse to a single pseudo-token so
+ * identical short strings still compare equal (Jaccard 1.0). Empty input
+ * yields an empty set.
+ */
+export function trigramSet(text) {
+    const normalized = normalizeForTrigrams(text);
+    if (normalized.length === 0)
+        return new Set();
+    if (normalized.length < MIN_TRIGRAM_TOKEN_LENGTH) {
+        return new Set([normalized]);
+    }
+    const grams = new Set();
+    for (let i = 0; i + MIN_TRIGRAM_TOKEN_LENGTH <= normalized.length; i++) {
+        grams.add(normalized.slice(i, i + MIN_TRIGRAM_TOKEN_LENGTH));
+    }
+    return grams;
+}
+/**
+ * Jaccard similarity between the character-trigram sets of two strings,
+ * in [0, 1]. Returns 0 when either side has no trigrams.
+ */
+export function trigramJaccard(a, b) {
+    const setA = trigramSet(a);
+    const setB = trigramSet(b);
+    return jaccard(setA, setB);
+}
+/**
+ * Typo-tolerant similarity between a whole query and a piece of content:
+ * the mean, over query tokens, of the best Jaccard similarity between that
+ * token and any single content token.
+ *
+ * Comparing token-to-token (instead of query-to-full-content) keeps the
+ * score robust to sentence length — a one-word typo in a long observation
+ * would otherwise be diluted below any useful threshold.
+ *
+ * Only `queryTokens` of trigram-matchable length are scored; shorter tokens
+ * are ignored so they do not drag the mean down for matches they can never
+ * express. Returns 0 — no match — when any such token fails to reach
+ * TYPO_FALLBACK_MIN_TOKEN_SIMILARITY against every content token (the token
+ * is absent, mirroring the AND semantics of the FTS path), or when no query
+ * token qualifies.
+ */
+export function bestTokenTrigramJaccard(queryTokens, content) {
+    const scorable = queryTokens.filter((t) => t.length >= MIN_TRIGRAM_TOKEN_LENGTH);
+    if (scorable.length === 0)
+        return 0;
+    const contentTokens = content.split(/\s+/).filter((t) => t.length > 0);
+    const contentTokenGrams = contentTokens.map((token) => trigramSet(token));
+    let total = 0;
+    for (const queryToken of scorable) {
+        let best = 0;
+        const queryGrams = trigramSet(queryToken);
+        for (const grams of contentTokenGrams) {
+            const similarity = jaccard(queryGrams, grams);
+            if (similarity > best)
+                best = similarity;
+            if (best === 1)
+                break;
+        }
+        if (best < TYPO_FALLBACK_MIN_TOKEN_SIMILARITY)
+            return 0;
+        total += best;
+    }
+    return total / scorable.length;
+}
+/** Jaccard similarity between two pre-built sets, in [0, 1]. */
+function jaccard(a, b) {
+    if (a.size === 0 || b.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const gram of a) {
+        if (b.has(gram))
+            intersection++;
+    }
+    const union = a.size + b.size - intersection;
+    return union === 0 ? 0 : intersection / union;
+}
+/**
+ * Build an FTS5 MATCH query from search tokens.
+ *
+ * Each token becomes a quoted phrase (`"token"`); phrases are joined with
+ * AND. With the trigram tokenizer each quoted phrase acts as a
+ * case-insensitive substring match, so a multi-token query matches content
+ * containing all tokens anywhere. Embedded double quotes are escaped by
+ * doubling, which is how FTS5 string literals represent a literal quote.
+ *
+ * Returns an empty string when no non-empty tokens are supplied — callers
+ * must guard against that before running a MATCH query.
+ */
+export function buildFtsMatchQuery(tokens) {
+    return tokens
+        .filter((token) => token.length > 0)
+        .map((token) => `"${token.replace(/"/g, '""')}"`)
+        .join(" AND ");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexol/spectral",
-  "version": "0.9.200",
+  "version": "0.9.202",
   "description": "AI coding agent for Aexol with relay-based browser access.",
   "type": "module",
   "private": false,