@ixo/topic-protocol 0.3.0 → 0.4.0

package/README.md

@@ -9,7 +9,7 @@ identity of a discussion.
 
 ## Status
 
-**Version:** 0.3.0
+**Version:** 0.4.0
 
 **Maturity:** Draft implementation candidate  
 **Execution source of truth:** [Linear Topic Protocol project](https://linear.app/ixo-world/project/topic-protocol-4ea58bc7910d)
@@ -39,7 +39,8 @@ key-value adapter at its integration boundary.
 
 The package includes:
 
-- strict Draft 2020-12 validation for all 16 contracts;
+- strict Draft 2020-12 validation for all 17 contracts;
+- deterministic Topic-index reconciliation, structured search, and personal ranking;
 - deterministic Topic projection from a root and authorised operations;
 - singular accepted Overview projection with deterministic conflict handling;
 - relation-free Matrix root and canonical native `m.thread` event builders;
@@ -94,6 +95,11 @@ never binds a Topic to a temporary local-echo ID. Pending storage contains only
 the room ID, Topic ID, root event ID, and creation timestamp; clients must back
 it with durable local storage to make restart recovery effective.
 
+Topic index snapshots are plaintext only while in trusted process memory. A
+client persistence adapter must encrypt them at rest. Portal uses Matrix Secret
+Storage, while follow, mute, pin, and mark-unread flags remain room account data
+rather than shared Topic state.
+
 Install development dependencies and run the complete quality gate:
 
 ```bash

package/dist/schemas/topic-index-entry.schema.json

@@ -8,10 +8,43 @@
         "topicId": { "type": "string", "pattern": "^ixo:topic:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
         "roomId": { "type": "string", "minLength": 1 },
         "rootEventId": { "type": "string", "pattern": "^\\$" },
+        "title": { "type": "string", "minLength": 1, "maxLength": 280 },
+        "currentState": { "type": "string", "minLength": 1, "maxLength": 280 },
         "status": { "type": "string" },
+        "kind": { "type": "string", "enum": ["discussion", "question", "decision", "proposal", "task", "incident", "flow"] },
+        "domain": {
+            "type": "object",
+            "required": ["id"],
+            "properties": {
+                "id": { "type": "string", "minLength": 1 },
+                "name": { "type": "string", "minLength": 1 }
+            },
+            "additionalProperties": false
+        },
+        "context": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "required": ["type", "id"],
+                "properties": {
+                    "type": { "type": "string", "minLength": 1 },
+                    "id": { "type": "string", "minLength": 1 }
+                },
+                "additionalProperties": false
+            }
+        },
+        "sourceKinds": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": { "type": "string", "enum": ["message", "flow", "decision", "artifact", "notification", "other"] }
+        },
         "latestActivityAt": { "type": "string", "format": "date-time" },
+        "latestEventId": { "type": "string", "pattern": "^\\$" },
+        "participated": { "type": "boolean" },
+        "unread": { "type": "string", "enum": ["unread", "read", "unknown"] },
         "notificationMode": { "type": "string", "enum": ["follow", "default", "mute"] },
-        "completeness": { "type": "string", "enum": ["complete", "partial-history", "metadata-pending", "decryption-pending"] }
+        "completeness": { "type": "string", "enum": ["complete", "partial-history", "metadata-pending", "decryption-pending"] },
+        "indexedAt": { "type": "string", "format": "date-time" }
     },
     "additionalProperties": true
 }

package/dist/schemas/topic-index.schema.json

@@ -0,0 +1,39 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/topic-index.schema.json",
+    "title": "Encrypted Topic index plaintext snapshot",
+    "type": "object",
+    "required": ["version", "updatedAt", "entries", "tombstones"],
+    "properties": {
+        "version": { "const": 1 },
+        "updatedAt": { "type": "string", "format": "date-time" },
+        "entries": {
+            "type": "array",
+            "items": {
+                "allOf": [
+                    { "$ref": "https://topic-protocol.ixo.world/schemas/topic-index-entry.schema.json" },
+                    {
+                        "type": "object",
+                        "required": ["participated", "unread", "indexedAt"],
+                        "properties": {
+                            "status": { "type": "string", "enum": ["draft", "active", "waiting", "blocked", "resolved", "archived", "redirected"] }
+                        }
+                    }
+                ]
+            }
+        },
+        "tombstones": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "required": ["roomId", "removedAt"],
+                "properties": {
+                    "roomId": { "type": "string", "minLength": 1 },
+                    "removedAt": { "type": "string", "format": "date-time" }
+                },
+                "additionalProperties": false
+            }
+        }
+    },
+    "additionalProperties": false
+}

package/dist/src/contracts/schemas.d.ts

@@ -307,13 +307,79 @@ export declare const SCHEMA_REGISTRY: Readonly<{
                 type: string;
                 pattern: string;
             };
+            title: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+            };
+            currentState: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+            };
             status: {
                 type: string;
             };
+            kind: {
+                type: string;
+                enum: string[];
+            };
+            domain: {
+                type: string;
+                required: string[];
+                properties: {
+                    id: {
+                        type: string;
+                        minLength: number;
+                    };
+                    name: {
+                        type: string;
+                        minLength: number;
+                    };
+                };
+                additionalProperties: boolean;
+            };
+            context: {
+                type: string;
+                items: {
+                    type: string;
+                    required: string[];
+                    properties: {
+                        type: {
+                            type: string;
+                            minLength: number;
+                        };
+                        id: {
+                            type: string;
+                            minLength: number;
+                        };
+                    };
+                    additionalProperties: boolean;
+                };
+            };
+            sourceKinds: {
+                type: string;
+                uniqueItems: boolean;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+            };
             latestActivityAt: {
                 type: string;
                 format: string;
             };
+            latestEventId: {
+                type: string;
+                pattern: string;
+            };
+            participated: {
+                type: string;
+            };
+            unread: {
+                type: string;
+                enum: string[];
+            };
             notificationMode: {
                 type: string;
                 enum: string[];
@@ -322,6 +388,66 @@ export declare const SCHEMA_REGISTRY: Readonly<{
                 type: string;
                 enum: string[];
             };
+            indexedAt: {
+                type: string;
+                format: string;
+            };
+        };
+        additionalProperties: boolean;
+    };
+    "topic-index": {
+        $schema: string;
+        $id: string;
+        title: string;
+        type: string;
+        required: string[];
+        properties: {
+            version: {
+                const: number;
+            };
+            updatedAt: {
+                type: string;
+                format: string;
+            };
+            entries: {
+                type: string;
+                items: {
+                    allOf: ({
+                        $ref: string;
+                        type?: never;
+                        required?: never;
+                        properties?: never;
+                    } | {
+                        type: string;
+                        required: string[];
+                        properties: {
+                            status: {
+                                type: string;
+                                enum: string[];
+                            };
+                        };
+                        $ref?: never;
+                    })[];
+                };
+            };
+            tombstones: {
+                type: string;
+                items: {
+                    type: string;
+                    required: string[];
+                    properties: {
+                        roomId: {
+                            type: string;
+                            minLength: number;
+                        };
+                        removedAt: {
+                            type: string;
+                            format: string;
+                        };
+                    };
+                    additionalProperties: boolean;
+                };
+            };
         };
         additionalProperties: boolean;
     };
@@ -867,4 +993,4 @@ export declare const SCHEMA_REGISTRY: Readonly<{
     };
 }>;
 export type ContractName = keyof typeof SCHEMA_REGISTRY;
-export declare const CONTRACT_NAMES: readonly ("action-receipt" | "agent-run" | "external-session-binding" | "room-policy" | "topic-capsule" | "topic-file-attachment" | "topic-index-entry" | "topic-message" | "topic-operation" | "topic-preferences" | "topic-record" | "topic-record-message" | "topic-relation" | "topic-root" | "topic-state" | "topic-source-message")[];
+export declare const CONTRACT_NAMES: readonly ("action-receipt" | "agent-run" | "external-session-binding" | "room-policy" | "topic-capsule" | "topic-file-attachment" | "topic-index-entry" | "topic-index" | "topic-message" | "topic-operation" | "topic-preferences" | "topic-record" | "topic-record-message" | "topic-relation" | "topic-root" | "topic-state" | "topic-source-message")[];

package/dist/src/contracts/schemas.js

@@ -5,6 +5,7 @@ import roomPolicy from "../../schemas/room-policy.schema.json" with { type: "jso
 import topicCapsule from "../../schemas/topic-capsule.schema.json" with { type: "json" };
 import topicFileAttachment from "../../schemas/topic-file-attachment.schema.json" with { type: "json" };
 import topicIndexEntry from "../../schemas/topic-index-entry.schema.json" with { type: "json" };
+import topicIndex from "../../schemas/topic-index.schema.json" with { type: "json" };
 import topicMessage from "../../schemas/topic-message.schema.json" with { type: "json" };
 import topicOperation from "../../schemas/topic-operation.schema.json" with { type: "json" };
 import topicPreferences from "../../schemas/topic-preferences.schema.json" with { type: "json" };
@@ -22,6 +23,7 @@ export const SCHEMA_REGISTRY = Object.freeze({
     "topic-capsule": topicCapsule,
     "topic-file-attachment": topicFileAttachment,
     "topic-index-entry": topicIndexEntry,
+    "topic-index": topicIndex,
     "topic-message": topicMessage,
     "topic-operation": topicOperation,
     "topic-preferences": topicPreferences,

package/dist/src/contracts/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/contracts/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,0CAA0C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC3F,OAAO,QAAQ,MAAM,qCAAqC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACjF,OAAO,sBAAsB,MAAM,oDAAoD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9G,OAAO,UAAU,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrF,OAAO,YAAY,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACzF,OAAO,mBAAmB,MAAM,iDAAiD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxG,OAAO,eAAe,MAAM,6CAA6C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAChG,OAAO,YAAY,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACzF,OAAO,cAAc,MAAM,2CAA2C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC7F,OAAO,gBAAgB,MAAM,6CAA6C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACjG,OAAO,WAAW,MAAM,wCAAwC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACvF,OAAO,kBAAkB,MAAM,gDAAgD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACtG,OAAO,aAAa,MAAM,0CAA0C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC3F,OAAO,SAAS,MAAM,sCAAsC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACnF,OAAO,UAAU,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrF,OAAO,kBAAkB,MAAM,gDAAgD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEtG,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,gBAAgB,EAAE,aAAa;IAC/B,WAAW,EAAE,QAAQ;IACrB,0BAA0B,EAAE,sBAAsB;IAClD,aAAa,EAAE,UAAU;IACzB,eAAe,EAAE,YAAY;IAC7B,uBAAuB,EAAE,mBAAmB;IAC5C,mBAAmB,EAAE,eAAe;IACpC,eAAe,EAAE,YAAY;IAC7B,iBAAiB,EAAE,cAAc;IACjC,mBAAmB,EAAE,gBAAgB;IACrC,cAAc,EAAE,WAAW;IAC3B,sBAAsB,EAAE,kBAAkB;IAC1C,gBAAgB,EAAE,aAAa;IAC/B,YAAY,EAAE,SAAS;IACvB,aAAa,EAAE,UAAU;IACzB,sBAAsB,EAAE,kBAAkB;CAC3C,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CACzC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,EAAoB,CACtD,CAAC"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/contracts/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,0CAA0C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC3F,OAAO,QAAQ,MAAM,qCAAqC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACjF,OAAO,sBAAsB,MAAM,oDAAoD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9G,OAAO,UAAU,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrF,OAAO,YAAY,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACzF,OAAO,mBAAmB,MAAM,iDAAiD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxG,OAAO,eAAe,MAAM,6CAA6C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAChG,OAAO,UAAU,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrF,OAAO,YAAY,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACzF,OAAO,cAAc,MAAM,2CAA2C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC7F,OAAO,gBAAgB,MAAM,6CAA6C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACjG,OAAO,WAAW,MAAM,wCAAwC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACvF,OAAO,kBAAkB,MAAM,gDAAgD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACtG,OAAO,aAAa,MAAM,0CAA0C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC3F,OAAO,SAAS,MAAM,sCAAsC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACnF,OAAO,UAAU,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrF,OAAO,kBAAkB,MAAM,gDAAgD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEtG,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,gBAAgB,EAAE,aAAa;IAC/B,WAAW,EAAE,QAAQ;IACrB,0BAA0B,EAAE,sBAAsB;IAClD,aAAa,EAAE,UAAU;IACzB,eAAe,EAAE,YAAY;IAC7B,uBAAuB,EAAE,mBAAmB;IAC5C,mBAAmB,EAAE,eAAe;IACpC,aAAa,EAAE,UAAU;IACzB,eAAe,EAAE,YAAY;IAC7B,iBAAiB,EAAE,cAAc;IACjC,mBAAmB,EAAE,gBAAgB;IACrC,cAAc,EAAE,WAAW;IAC3B,sBAAsB,EAAE,kBAAkB;IAC1C,gBAAgB,EAAE,aAAa;IAC/B,YAAY,EAAE,SAAS;IACvB,aAAa,EAAE,UAAU;IACzB,sBAAsB,EAAE,kBAAkB;CAC3C,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CACzC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,EAAoB,CACtD,CAAC"}

package/dist/src/index.d.ts

@@ -11,3 +11,7 @@ export { TopicRuntime, type TopicRuntimeOptions } from "./matrix/runtime.js";
 export { MATRIX_ROOM_MESSAGE, TOPIC_ANCHOR_KEY, TOPIC_METADATA_KEY, TOPIC_OPERATION_EVENT_TYPE, type CanonicalTopicAnchor, type MatrixEventContent, type MatrixSendRequest, type MatrixTopicProjection, type MatrixTopicProjectionInput, type ParsedTopicRoot, type PendingTopicCreation, type PendingTopicStore, type RejectedTopicEvent, type RejectedTopicEventReason, type TopicAnchorConflict, type TopicCreationInput, type TopicCreationResult, type TopicFirstMessageFactory, type TopicMatrixEvent, type TopicMatrixTransport, type TopicRootContentOptions, } from "./matrix/types.js";
 export { TOPIC_KINDS, TOPIC_CONTEXT_TYPES, TOPIC_STATUSES, TOPIC_VFS_FILE_PROVIDER, type IgnoredOperation, type IgnoredOperationReason, type MatrixAnchor, type ProjectedTopicRelation, type ProjectionInput, type TopicContext, type TopicContextType, type TopicFileAttachmentIdentity, type TopicDecision, type TopicKind, type TopicNextStep, type TopicOperation, type TopicOperationType, type TopicProjection, type ProjectedTopicAttachment, type ProjectedTopicOverview, type TopicOverview, type TopicProjectionConflict, type TopicRelationType, type TopicRoot, type TopicStatus, type TopicVfsFileReference, isCanonicalTopicContextType, } from "./projector/types.js";
 export { TOPIC_RECORD_KINDS, type TopicRecord, type TopicRecordKind, } from "./records/types.js";
+export { emptyTopicIndexSnapshot, reconcileTopicIndex } from "./indexing/reconcile.js";
+export { searchTopicIndex } from "./indexing/search.js";
+export { rankTopicIndex } from "./indexing/rank.js";
+export { TOPIC_INDEX_COMPLETENESS, TOPIC_INDEX_RANK_REASONS, TOPIC_INDEX_STORAGE_STATES, TOPIC_INDEX_UNREAD_STATES, TOPIC_NOTIFICATION_MODES, type RankedTopicIndexEntry, type TopicAttentionSignalMap, type TopicAttentionSignals, type TopicIndexCompleteness, type TopicIndexDomain, type TopicIndexEntry, type TopicIndexObservation, type TopicIndexRankReason, type TopicIndexReconciliation, type TopicIndexSearchFilters, type TopicIndexSnapshot, type TopicIndexStorageState, type TopicIndexTombstone, type TopicIndexUnreadState, type TopicNotificationMode, type TopicPreference, type TopicPreferenceMap, } from "./indexing/types.js";

package/dist/src/index.js

@@ -11,4 +11,8 @@ export { TopicRuntime } from "./matrix/runtime.js";
 export { MATRIX_ROOM_MESSAGE, TOPIC_ANCHOR_KEY, TOPIC_METADATA_KEY, TOPIC_OPERATION_EVENT_TYPE, } from "./matrix/types.js";
 export { TOPIC_KINDS, TOPIC_CONTEXT_TYPES, TOPIC_STATUSES, TOPIC_VFS_FILE_PROVIDER, isCanonicalTopicContextType, } from "./projector/types.js";
 export { TOPIC_RECORD_KINDS, } from "./records/types.js";
+export { emptyTopicIndexSnapshot, reconcileTopicIndex } from "./indexing/reconcile.js";
+export { searchTopicIndex } from "./indexing/search.js";
+export { rankTopicIndex } from "./indexing/rank.js";
+export { TOPIC_INDEX_COMPLETENESS, TOPIC_INDEX_RANK_REASONS, TOPIC_INDEX_STORAGE_STATES, TOPIC_INDEX_UNREAD_STATES, TOPIC_NOTIFICATION_MODES, } from "./indexing/types.js";
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAEf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,cAAc,EACd,gBAAgB,GAGjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kBAAkB,GAEnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,aAAa,EACb,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,+BAA+B,EAC/B,+BAA+B,EAC/B,8BAA8B,EAC9B,8BAA8B,GAS/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GAExB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAA4B,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,GAkB3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EAuBvB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAEf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,cAAc,EACd,gBAAgB,GAGjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kBAAkB,GAEnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,aAAa,EACb,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,+BAA+B,EAC/B,+BAA+B,EAC/B,8BAA8B,EAC9B,8BAA8B,GAS/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GAExB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAA4B,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,GAkB3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EAuBvB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,GAkBzB,MAAM,qBAAqB,CAAC"}

package/dist/src/indexing/rank.d.ts

@@ -0,0 +1,2 @@
+import type { RankedTopicIndexEntry, TopicAttentionSignalMap, TopicIndexEntry, TopicPreferenceMap } from "./types.js";
+export declare function rankTopicIndex(entries: readonly TopicIndexEntry[], preferences?: TopicPreferenceMap, signals?: TopicAttentionSignalMap): RankedTopicIndexEntry[];

package/dist/src/indexing/rank.js

@@ -0,0 +1,31 @@
+import { compareText } from "../shared/compare.js";
+const REASON_RANK = {
+    pinned: 0,
+    "direct-attention": 1,
+    "followed-unread": 2,
+    participated: 3,
+    recent: 4,
+};
+function reasonFor(entry, preferences, signals) {
+    const preference = preferences[entry.topicId];
+    if (preference?.pinned)
+        return "pinned";
+    if (signals[entry.topicId]?.directAttention)
+        return "direct-attention";
+    if (preference?.notificationMode === "follow" && entry.unread === "unread")
+        return "followed-unread";
+    if (entry.participated)
+        return "participated";
+    return "recent";
+}
+function compareRanked(left, right) {
+    return REASON_RANK[left.reason] - REASON_RANK[right.reason]
+        || compareText(right.entry.latestActivityAt, left.entry.latestActivityAt)
+        || compareText(left.entry.topicId, right.entry.topicId);
+}
+export function rankTopicIndex(entries, preferences = {}, signals = {}) {
+    return entries
+        .map((entry) => ({ entry, reason: reasonFor(entry, preferences, signals) }))
+        .sort(compareRanked);
+}
+//# sourceMappingURL=rank.js.map

package/dist/src/indexing/rank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rank.js","sourceRoot":"","sources":["../../../src/indexing/rank.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AASnD,MAAM,WAAW,GAAyC;IACxD,MAAM,EAAE,CAAC;IACT,kBAAkB,EAAE,CAAC;IACrB,iBAAiB,EAAE,CAAC;IACpB,YAAY,EAAE,CAAC;IACf,MAAM,EAAE,CAAC;CACV,CAAC;AAEF,SAAS,SAAS,CAAC,KAAsB,EAAE,WAA+B,EAAE,OAAgC;IAC1G,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,UAAU,EAAE,MAAM;QAAE,OAAO,QAAQ,CAAC;IACxC,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,eAAe;QAAE,OAAO,kBAAkB,CAAC;IACvE,IAAI,UAAU,EAAE,gBAAgB,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,iBAAiB,CAAC;IACrG,IAAI,KAAK,CAAC,YAAY;QAAE,OAAO,cAAc,CAAC;IAC9C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CAAC,IAA2B,EAAE,KAA4B;IAC9E,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC;WACtD,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC;WACtE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAmC,EACnC,cAAkC,EAAE,EACpC,UAAmC,EAAE;IAErC,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;SAC3E,IAAI,CAAC,aAAa,CAAC,CAAC;AACzB,CAAC"}

package/dist/src/indexing/reconcile.d.ts

@@ -0,0 +1,3 @@
+import type { TopicIndexReconciliation, TopicIndexSnapshot } from "./types.js";
+export declare function emptyTopicIndexSnapshot(updatedAt: string): TopicIndexSnapshot;
+export declare function reconcileTopicIndex(snapshot: TopicIndexSnapshot, input: TopicIndexReconciliation): TopicIndexSnapshot;

package/dist/src/indexing/reconcile.js

@@ -0,0 +1,58 @@
+import { compareText } from "../shared/compare.js";
+const COMPLETENESS_RANK = {
+    complete: 4,
+    "partial-history": 3,
+    "metadata-pending": 2,
+    "decryption-pending": 1,
+};
+function compareEntries(left, right) {
+    return compareText(left.indexedAt, right.indexedAt)
+        || COMPLETENESS_RANK[left.completeness] - COMPLETENESS_RANK[right.completeness]
+        || compareText(right.roomId, left.roomId)
+        || compareText(right.rootEventId, left.rootEventId);
+}
+function latestEntries(entries) {
+    const byTopic = new Map();
+    entries.forEach((entry) => {
+        const current = byTopic.get(entry.topicId);
+        if (current === undefined || compareEntries(current, entry) < 0)
+            byTopic.set(entry.topicId, entry);
+    });
+    return byTopic;
+}
+function latestTombstones(tombstones) {
+    const byRoom = new Map();
+    tombstones.forEach((tombstone) => {
+        const current = byRoom.get(tombstone.roomId);
+        if (current === undefined || compareText(current.removedAt, tombstone.removedAt) < 0)
+            byRoom.set(tombstone.roomId, tombstone);
+    });
+    return byRoom;
+}
+function isAfterTombstone(entry, tombstones) {
+    const tombstone = tombstones.get(entry.roomId);
+    return tombstone === undefined || compareText(tombstone.removedAt, entry.indexedAt) < 0;
+}
+export function emptyTopicIndexSnapshot(updatedAt) {
+    return { version: 1, updatedAt, entries: [], tombstones: [] };
+}
+export function reconcileTopicIndex(snapshot, input) {
+    const removed = new Set(input.leftRoomIds ?? []);
+    const tombstones = latestTombstones([
+        ...snapshot.tombstones,
+        ...[...removed].map((roomId) => ({ roomId, removedAt: input.reconciledAt })),
+    ]);
+    const observed = input.observations
+        .filter(({ canonicalAnchor }) => canonicalAnchor)
+        .map(({ entry }) => entry);
+    const entries = [...latestEntries([...snapshot.entries, ...observed]).values()]
+        .filter((entry) => !removed.has(entry.roomId) && isAfterTombstone(entry, tombstones))
+        .sort((left, right) => compareText(left.topicId, right.topicId));
+    return {
+        version: 1,
+        updatedAt: input.reconciledAt,
+        entries,
+        tombstones: [...tombstones.values()].sort((left, right) => compareText(left.roomId, right.roomId)),
+    };
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/src/indexing/reconcile.js.map

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

package/dist/src/indexing/search.d.ts

@@ -0,0 +1,2 @@
+import type { TopicIndexEntry, TopicIndexSearchFilters, TopicPreferenceMap } from "./types.js";
+export declare function searchTopicIndex(entries: readonly TopicIndexEntry[], filters?: TopicIndexSearchFilters, preferences?: TopicPreferenceMap): TopicIndexEntry[];

package/dist/src/indexing/search.js

@@ -0,0 +1,37 @@
+import { compareText } from "../shared/compare.js";
+function includesAny(value, accepted) {
+    return accepted === undefined || accepted.length === 0 || (value !== undefined && accepted.includes(value));
+}
+function includesSource(entry, accepted) {
+    return accepted === undefined || accepted.length === 0 || accepted.some((kind) => entry.sourceKinds?.includes(kind));
+}
+function searchText(entry) {
+    return [
+        entry.title,
+        entry.currentState,
+        entry.domain?.name,
+        entry.domain?.id,
+        ...(entry.context?.flatMap(({ type, id }) => [type, id]) ?? []),
+    ].filter((value) => value !== undefined).join(" ").toLowerCase();
+}
+function matchesQuery(entry, query) {
+    const tokens = query?.trim().toLowerCase().split(/\s+/).filter(Boolean) ?? [];
+    if (tokens.length === 0)
+        return true;
+    const haystack = searchText(entry);
+    return tokens.every((token) => haystack.includes(token));
+}
+function matchesFollowing(entry, following, preferences) {
+    if (following === undefined)
+        return true;
+    return (preferences[entry.topicId]?.notificationMode === "follow") === following;
+}
+export function searchTopicIndex(entries, filters = {}, preferences = {}) {
+    return entries.filter((entry) => matchesQuery(entry, filters.query)
+        && includesAny(entry.status, filters.statuses)
+        && includesAny(entry.domain?.id, filters.domainIds)
+        && includesAny(entry.kind, filters.kinds)
+        && includesSource(entry, filters.sourceKinds)
+        && matchesFollowing(entry, filters.following, preferences)).sort((left, right) => compareText(left.title ?? "", right.title ?? "") || compareText(left.topicId, right.topicId));
+}
+//# sourceMappingURL=search.js.map

package/dist/src/indexing/search.js.map

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

package/dist/src/indexing/types.d.ts

@@ -0,0 +1,75 @@
+import type { TopicSourceKind } from "../matrix/cards.js";
+import type { TopicContext, TopicKind, TopicStatus } from "../projector/types.js";
+export declare const TOPIC_INDEX_COMPLETENESS: readonly ["complete", "partial-history", "metadata-pending", "decryption-pending"];
+export declare const TOPIC_INDEX_UNREAD_STATES: readonly ["unread", "read", "unknown"];
+export declare const TOPIC_INDEX_STORAGE_STATES: readonly ["encrypted", "memory-only", "locked", "unavailable"];
+export declare const TOPIC_NOTIFICATION_MODES: readonly ["follow", "default", "mute"];
+export declare const TOPIC_INDEX_RANK_REASONS: readonly ["pinned", "direct-attention", "followed-unread", "participated", "recent"];
+export type TopicIndexCompleteness = (typeof TOPIC_INDEX_COMPLETENESS)[number];
+export type TopicIndexUnreadState = (typeof TOPIC_INDEX_UNREAD_STATES)[number];
+export type TopicIndexStorageState = (typeof TOPIC_INDEX_STORAGE_STATES)[number];
+export type TopicNotificationMode = (typeof TOPIC_NOTIFICATION_MODES)[number];
+export type TopicIndexRankReason = (typeof TOPIC_INDEX_RANK_REASONS)[number];
+export interface TopicIndexDomain {
+    readonly id: string;
+    readonly name?: string;
+}
+export interface TopicIndexEntry {
+    readonly topicId: string;
+    readonly roomId: string;
+    readonly rootEventId: string;
+    readonly title?: string;
+    readonly currentState?: string;
+    readonly status: TopicStatus;
+    readonly kind?: TopicKind;
+    readonly domain?: TopicIndexDomain;
+    readonly context?: readonly TopicContext[];
+    readonly sourceKinds?: readonly TopicSourceKind[];
+    readonly latestActivityAt: string;
+    readonly latestEventId?: string;
+    readonly participated: boolean;
+    readonly unread: TopicIndexUnreadState;
+    readonly completeness: TopicIndexCompleteness;
+    readonly indexedAt: string;
+}
+export interface TopicIndexTombstone {
+    readonly roomId: string;
+    readonly removedAt: string;
+}
+export interface TopicIndexSnapshot {
+    readonly version: 1;
+    readonly updatedAt: string;
+    readonly entries: readonly TopicIndexEntry[];
+    readonly tombstones: readonly TopicIndexTombstone[];
+}
+export interface TopicPreference {
+    readonly notificationMode: TopicNotificationMode;
+    readonly pinned: boolean;
+    readonly markedUnreadFrom?: string | null;
+}
+export type TopicPreferenceMap = Readonly<Record<string, TopicPreference>>;
+export interface TopicIndexObservation {
+    readonly entry: TopicIndexEntry;
+    readonly canonicalAnchor: boolean;
+}
+export interface TopicIndexReconciliation {
+    readonly observations: readonly TopicIndexObservation[];
+    readonly leftRoomIds?: readonly string[];
+    readonly reconciledAt: string;
+}
+export interface TopicIndexSearchFilters {
+    readonly query?: string;
+    readonly statuses?: readonly TopicStatus[];
+    readonly domainIds?: readonly string[];
+    readonly following?: boolean;
+    readonly kinds?: readonly TopicKind[];
+    readonly sourceKinds?: readonly TopicSourceKind[];
+}
+export interface TopicAttentionSignals {
+    readonly directAttention?: boolean;
+}
+export type TopicAttentionSignalMap = Readonly<Record<string, TopicAttentionSignals>>;
+export interface RankedTopicIndexEntry {
+    readonly entry: TopicIndexEntry;
+    readonly reason: TopicIndexRankReason;
+}

package/dist/src/indexing/types.js

@@ -0,0 +1,22 @@
+export const TOPIC_INDEX_COMPLETENESS = [
+    "complete",
+    "partial-history",
+    "metadata-pending",
+    "decryption-pending",
+];
+export const TOPIC_INDEX_UNREAD_STATES = ["unread", "read", "unknown"];
+export const TOPIC_INDEX_STORAGE_STATES = [
+    "encrypted",
+    "memory-only",
+    "locked",
+    "unavailable",
+];
+export const TOPIC_NOTIFICATION_MODES = ["follow", "default", "mute"];
+export const TOPIC_INDEX_RANK_REASONS = [
+    "pinned",
+    "direct-attention",
+    "followed-unread",
+    "participated",
+    "recent",
+];
+//# sourceMappingURL=types.js.map

package/dist/src/indexing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/indexing/types.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,UAAU;IACV,iBAAiB;IACjB,kBAAkB;IAClB,oBAAoB;CACZ,CAAC;AACX,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAChF,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,WAAW;IACX,aAAa;IACb,QAAQ;IACR,aAAa;CACL,CAAC;AACX,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AAC/E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,QAAQ;IACR,kBAAkB;IAClB,iBAAiB;IACjB,cAAc;IACd,QAAQ;CACA,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ixo/topic-protocol",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Reference contracts and deterministic projection for IXO Topics",
   "type": "module",
   "sideEffects": false,