@xopcai/xopc 0.0.176 → 0.0.177

package/dist/src/storage/sqlite/migrations/071_proactive_inbox.sql

@@ -0,0 +1,45 @@
+CREATE TABLE proactive_inbox_items (
+  inbox_item_id TEXT PRIMARY KEY,
+  insight_id TEXT NOT NULL UNIQUE,
+  status TEXT NOT NULL CHECK (status IN ('unread', 'read', 'snoozed', 'resolved')),
+  snoozed_until TEXT,
+  resolution TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (insight_id) REFERENCES proactive_insights(insight_id) ON DELETE CASCADE
+);
+
+CREATE TABLE proactive_decisions (
+  decision_id TEXT PRIMARY KEY,
+  inbox_item_id TEXT NOT NULL,
+  choice TEXT NOT NULL,
+  note TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (inbox_item_id) REFERENCES proactive_inbox_items(inbox_item_id) ON DELETE CASCADE
+);
+
+CREATE TABLE proactive_delivery_outbox (
+  delivery_id TEXT PRIMARY KEY,
+  inbox_item_id TEXT NOT NULL UNIQUE,
+  status TEXT NOT NULL CHECK (status IN ('pending', 'delivering', 'delivered', 'retryable', 'failed')),
+  attempt INTEGER NOT NULL DEFAULT 0 CHECK (attempt >= 0),
+  next_attempt_at TEXT NOT NULL,
+  lease_expires_at TEXT,
+  error_message TEXT,
+  created_at TEXT NOT NULL,
+  delivered_at TEXT,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (inbox_item_id) REFERENCES proactive_inbox_items(inbox_item_id) ON DELETE CASCADE
+);
+
+CREATE TABLE proactive_feedback (
+  feedback_id TEXT PRIMARY KEY,
+  inbox_item_id TEXT NOT NULL,
+  rating TEXT NOT NULL CHECK (rating IN ('useful', 'not_useful')),
+  note TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (inbox_item_id) REFERENCES proactive_inbox_items(inbox_item_id) ON DELETE CASCADE
+);
+
+CREATE INDEX idx_proactive_inbox_status ON proactive_inbox_items(status, updated_at DESC);
+CREATE INDEX idx_proactive_outbox_ready ON proactive_delivery_outbox(status, next_attempt_at);

package/dist/src/storage/sqlite/migrations/072_proactive_judgments.sql

@@ -0,0 +1,14 @@
+ALTER TABLE proactive_insights ADD COLUMN work_done TEXT NOT NULL DEFAULT '';
+ALTER TABLE proactive_insights ADD COLUMN decision_json TEXT;
+
+CREATE TABLE proactive_instruction_feedback (
+  instruction_id TEXT PRIMARY KEY,
+  inbox_item_id TEXT NOT NULL,
+  prompt_revision_id TEXT NOT NULL,
+  instruction TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (inbox_item_id) REFERENCES proactive_inbox_items(inbox_item_id) ON DELETE CASCADE,
+  FOREIGN KEY (prompt_revision_id) REFERENCES proactive_prompt_revisions(revision_id)
+);
+
+CREATE INDEX idx_proactive_instruction_item ON proactive_instruction_feedback(inbox_item_id, created_at DESC);

package/dist/src/storage/sqlite/migrations/073_enable_default_proactive_scenarios.sql

@@ -0,0 +1,13 @@
+INSERT OR IGNORE INTO proactive_scenario_subscriptions (
+  subscription_id,
+  scenario_key,
+  workspace_id,
+  scope_kind,
+  scope_id,
+  enabled,
+  created_at,
+  updated_at
+) VALUES
+  ('default-project-delivery-risk', 'project_delivery_risk', 'default', 'workspace', 'default', 1, datetime('now'), datetime('now')),
+  ('default-blocked-work', 'blocked_work', 'default', 'workspace', 'default', 1, datetime('now'), datetime('now')),
+  ('default-automation-failure-impact', 'automation_failure_impact', 'default', 'workspace', 'default', 1, datetime('now'), datetime('now'));

package/dist/src/storage/sqlite/migrations/074_deduplicate_blocked_work_routing.sql

@@ -0,0 +1,5 @@
+UPDATE proactive_scenarios
+SET condition_json = '{"op":"neq","field":"payload.after.status","value":"blocked"}',
+    version = version + 1,
+    updated_at = datetime('now')
+WHERE scenario_key = 'project_delivery_risk';

package/dist/src/storage/sqlite/migrations/runner.d.ts

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 67;
+export declare const XOPC_DB_SCHEMA_VERSION = 74;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

package/dist/src/storage/sqlite/migrations/runner.js

@@ -12,7 +12,7 @@ const log = createLogger("Sqlite:Migrations");
 /** Baseline schema version applied from schema.sql on first open. */
 const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-const XOPC_DB_SCHEMA_VERSION = 67;
+const XOPC_DB_SCHEMA_VERSION = 74;
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 function resolveMigrationsDir(override) {
 	if (override) return override;
@@ -46,7 +46,7 @@ function applySingleMigration(db, migration) {
 * Each step runs in its own transaction and updates schema_meta on success.
 */
 function applyPendingMigrations(db, options = {}) {
-	const targetVersion = options.targetVersion ?? 67;
+	const targetVersion = options.targetVersion ?? 74;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (currentVersion >= targetVersion) return currentVersion;
@@ -62,7 +62,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 67;
+	const appVersion = options.targetVersion ?? 74;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,

package/dist/src/storage/sqlite/migrations/runner.ts

@@ -19,7 +19,7 @@ const log = createLogger('Sqlite:Migrations');
 export const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 
 /** Latest schema version this release supports (increment when adding migrations). */
-export const XOPC_DB_SCHEMA_VERSION = 67;
+export const XOPC_DB_SCHEMA_VERSION = 74;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

package/dist/src/storage/sqlite/schema.js

@@ -31,7 +31,7 @@ function ensureXopcDatabaseSchema(db) {
 		bootstrapFreshDatabase(db);
 		currentVersion = 11;
 	}
-	applyPendingMigrations(db, { targetVersion: 67 });
+	applyPendingMigrations(db, { targetVersion: 74 });
 }
 //#endregion
 export { SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, ensureSchemaMetaTable, ensureXopcDatabaseSchema, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion };

package/dist/src/work-discovery/thread-service.d.ts

@@ -1,8 +1,6 @@
 import type { WorkContextSnapshot, WorkDiscoveryResult, WorkUnderstandingEvidenceItem, WorkUnderstandingThread } from './types.js';
 /**
- * Discovery produces suggestions only. The user turns a suggestion into a Focus explicitly.
- * The legacy thread-shaped return value remains local to the discovery result renderer; it is
- * not a second persisted domain model.
+ * Discovery returns bounded suggestions for the current result only.
  */
 export declare function persistWorkThreadsFromDiscovery(input: {
     projectId: string;

package/dist/src/work-discovery/thread-service.js

@@ -1,50 +1,38 @@
-import { upsertFocusCandidate } from "../focuses/candidate-repository.js";
 //#region src/work-discovery/thread-service.ts
 function confidenceValue(value) {
 	return value === "high" ? .9 : value === "medium" ? .72 : .55;
 }
 /**
-* Discovery produces suggestions only. The user turns a suggestion into a Focus explicitly.
-* The legacy thread-shaped return value remains local to the discovery result renderer; it is
-* not a second persisted domain model.
+* Discovery returns bounded suggestions for the current result only.
 */
 function persistWorkThreadsFromDiscovery(input) {
 	const nowMs = input.nowMs ?? Date.now();
 	return (input.result.workThreadCandidates ?? []).flatMap((candidate) => {
-		const evidence = candidate.evidenceRefs.flatMap((ref) => {
+		if (candidate.evidenceRefs.flatMap((ref) => {
 			const item = input.evidence.find((entry) => entry.sourceRef === ref);
 			return item ? [{
 				label: item.observation.slice(0, 300),
 				source: item.sourceRef
 			}] : [];
-		});
-		if (evidence.length === 0) return [];
+		}).length === 0) return [];
 		const canonicalKey = `${input.projectId}:${candidate.horizon}:${candidate.topicKey}`.slice(0, 300);
-		const stored = upsertFocusCandidate({
+		const confidence = confidenceValue(candidate.confidence);
+		return [{
+			id: canonicalKey,
 			canonicalKey,
 			title: candidate.title,
 			summary: candidate.summary,
-			confidence: confidenceValue(candidate.confidence),
-			evidence,
-			projectIds: [input.projectId],
-			nowMs
-		});
-		return [{
-			id: stored.id,
-			canonicalKey,
-			title: stored.title,
-			summary: stored.summary,
 			status: candidate.status,
 			horizon: candidate.horizon,
-			focusScore: Math.round(stored.confidence * 100),
-			confidence: stored.confidence,
+			focusScore: Math.round(confidence * 100),
+			confidence,
 			userStatus: "unreviewed",
-			projectIds: stored.projectIds,
+			projectIds: [input.projectId],
 			evidenceIds: [],
-			firstObservedAt: stored.discoveredAt,
-			lastObservedAt: stored.updatedAt,
-			createdAt: stored.discoveredAt,
-			updatedAt: stored.updatedAt
+			firstObservedAt: nowMs,
+			lastObservedAt: nowMs,
+			createdAt: nowMs,
+			updatedAt: nowMs
 		}];
 	});
 }

package/dist/src/work-items/work-item-service.d.ts

@@ -1,4 +1,5 @@
 import type { MediaRef } from '../media/types.js';
+import type { ProactiveSignalPublisher } from '../proactive/events/publisher.js';
 import { WorkItemStore } from './work-item-store.js';
 import type { CreateWorkItemUpdateSuggestionInput, CreateWorkItemInput, UpdateWorkItemInput, WorkItem, WorkItemAttachment, WorkItemEvent, WorkItemLink, WorkItemListQuery, WorkItemListResult, WorkItemUpdateSuggestion, WorkItemUpdateSuggestionStatus } from './types.js';
 export declare const WORK_ITEM_ATTACHMENT_MAX_BYTES: number;
@@ -6,7 +7,8 @@ export declare const WORK_ITEM_ATTACHMENT_MAX_COUNT = 10;
 export declare const WORK_ITEM_ATTACHMENT_UPLOAD_BODY_MAX_BYTES: number;
 export declare class WorkItemService {
     private readonly store;
-    constructor(store?: WorkItemStore);
+    private readonly signals?;
+    constructor(store?: WorkItemStore, signals?: ProactiveSignalPublisher);
     listProjectWorkItems(projectId: string, query?: WorkItemListQuery): WorkItemListResult;
     listWorkItems(query?: WorkItemListQuery): WorkItemListResult;
     createProjectWorkItem(projectId: string, input: CreateWorkItemInput): WorkItem;

package/dist/src/work-items/work-item-service.js

@@ -1,7 +1,9 @@
+import { runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { changedFieldsFromPatch, emitActivity, systemActivityActor, systemActivitySource } from "../activity/emitter.js";
 import { deleteMediaBuffer, mimeTypeFromMediaPath, saveMediaBuffer } from "../media/store.js";
 import { readMediaReference } from "../media/media-reference.js";
 import { WorkItemStore } from "./work-item-store.js";
+import { createHash } from "node:crypto";
 //#region src/work-items/work-item-service.ts
 const WORK_ITEM_ATTACHMENT_MAX_BYTES = 25 * 1024 * 1024;
 const WORK_ITEM_ATTACHMENT_MAX_COUNT = 10;
@@ -16,8 +18,9 @@ function attachmentTypeForMediaRef(attachment) {
 	return attachment.type === "file" ? "document" : attachment.type;
 }
 var WorkItemService = class {
-	constructor(store = new WorkItemStore()) {
+	constructor(store = new WorkItemStore(), signals) {
 		this.store = store;
+		this.signals = signals;
 	}
 	listProjectWorkItems(projectId, query = {}) {
 		return this.store.list(projectId, query);
@@ -62,42 +65,70 @@ var WorkItemService = class {
 		return this.store.get(id);
 	}
 	updateWorkItem(id, patch) {
-		const before = this.store.get(id);
-		if (!before) return null;
-		const after = this.store.update(id, patch);
-		if (!after) return null;
-		if (before.status !== after.status) this.store.addEvent(id, "status_changed", {
-			from: before.status,
-			to: after.status
-		});
-		else this.store.addEvent(id, "updated", patch);
-		if (!before.archivedAt && after.archivedAt) this.store.addEvent(id, "archived", { archivedAt: after.archivedAt });
-		const type = !before.archivedAt && after.archivedAt ? "work_item.archived" : before.status !== after.status ? "work_item.status_changed" : "work_item.updated";
-		emitActivity({
-			type,
-			primaryObject: {
-				kind: "work_item",
-				id: after.id,
-				title: after.title
-			},
-			actor: systemActivityActor(),
-			source: systemActivitySource(),
-			payload: {
-				changes: changedFieldsFromPatch(patch),
-				...type === "work_item.status_changed" ? {
-					from: before.status,
-					to: after.status
-				} : {},
-				...type === "work_item.archived" ? { archivedAt: after.archivedAt } : {}
-			},
-			scopes: [{
-				scopeKind: "project",
-				scopeId: after.projectId,
-				reason: "object_owner"
-			}],
-			nowMs: after.updatedAt
+		return runSqliteWriteTransaction(() => {
+			const before = this.store.get(id);
+			if (!before) return null;
+			const after = this.store.update(id, patch);
+			if (!after) return null;
+			if (before.status !== after.status) this.store.addEvent(id, "status_changed", {
+				from: before.status,
+				to: after.status
+			});
+			else this.store.addEvent(id, "updated", patch);
+			if (!before.archivedAt && after.archivedAt) this.store.addEvent(id, "archived", { archivedAt: after.archivedAt });
+			const type = !before.archivedAt && after.archivedAt ? "work_item.archived" : before.status !== after.status ? "work_item.status_changed" : "work_item.updated";
+			const changes = changedFieldsFromPatch(patch);
+			emitActivity({
+				type,
+				primaryObject: {
+					kind: "work_item",
+					id: after.id,
+					title: after.title
+				},
+				actor: systemActivityActor(),
+				source: systemActivitySource(),
+				payload: {
+					changes,
+					...type === "work_item.status_changed" ? {
+						from: before.status,
+						to: after.status
+					} : {},
+					...type === "work_item.archived" ? { archivedAt: after.archivedAt } : {}
+				},
+				scopes: [{
+					scopeKind: "project",
+					scopeId: after.projectId,
+					reason: "object_owner"
+				}],
+				nowMs: after.updatedAt
+			});
+			this.signals?.publish({
+				type: before.status !== after.status ? "work_item.status_changed.v1" : "work_item.updated.v1",
+				schemaVersion: 1,
+				source: {
+					kind: "work_items",
+					id: "local"
+				},
+				subject: {
+					kind: "work_item",
+					id: after.id
+				},
+				actor: { kind: "system" },
+				scope: {
+					workspaceId: "default",
+					projectId: after.projectId
+				},
+				occurredAt: new Date(after.updatedAt).toISOString(),
+				dedupeKey: `work_item:${after.id}:${after.updatedAt}:${createHash("sha256").update(JSON.stringify(patch)).digest("hex")}`,
+				sensitivity: "personal",
+				payload: {
+					before,
+					after,
+					changes
+				}
+			});
+			return after;
 		});
-		return after;
 	}
 	addLink(workItemId, input, eventType = "link_added") {
 		if (!this.store.get(workItemId)) return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.176",
+  "version": "0.0.177",
   "description": "Local-first AI system that remembers context, coordinates AI, and sustains long-term progress.",
   "type": "module",
   "main": "dist/src/index.js",