@crewx/sdk 0.9.0-rc.8 → 0.9.0-rc.80

package/dist/internal/windows-spawn.d.ts

@@ -20,15 +20,25 @@ export type WindowsSpawnInvocation = {
     shell?: boolean;
     windowsHide?: boolean;
 };
+export type BinResolutionMode = 'global_first' | 'local_first';
+export type ResolveExecutablePathOptions = {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    platform?: NodeJS.Platform;
+    resolution?: BinResolutionMode;
+};
 export type ResolveWindowsSpawnProgramParams = {
     command: string;
     platform?: NodeJS.Platform;
     env?: NodeJS.ProcessEnv;
     execPath?: string;
     packageName?: string;
+    cwd?: string;
+    resolution?: BinResolutionMode;
     allowShellFallback?: boolean;
 };
 export type ResolveWindowsSpawnProgramCandidateParams = Omit<ResolveWindowsSpawnProgramParams, 'allowShellFallback'>;
+export declare function resolveExecutablePath(command: string, options?: ResolveExecutablePathOptions): string;
 export declare function resolveWindowsExecutablePath(command: string, env: NodeJS.ProcessEnv): string;
 export declare function resolveWindowsSpawnProgramCandidate(params: ResolveWindowsSpawnProgramCandidateParams): WindowsSpawnProgramCandidate;
 export declare function applyWindowsSpawnProgramPolicy(params: {

package/dist/layout/types.d.ts

@@ -25,6 +25,13 @@ export interface LayoutDefinition {
     template: string;
     propsSchema: Record<string, PropSchema>;
     defaultProps: Record<string, any>;
+    capabilities?: LayoutCapabilities;
+}
+export interface LayoutCapabilities {
+    semanticContinuity?: boolean;
+    continuity?: boolean;
+    continuitySlot?: string;
+    slot?: string;
 }
 export interface CustomLayoutDefinition {
     template: string;
@@ -32,10 +39,15 @@ export interface CustomLayoutDefinition {
     version?: string;
     propsSchema?: Record<string, any>;
     defaultProps?: Record<string, any>;
+    capabilities?: LayoutCapabilities;
 }
 export type InlineLayoutSpec = string | {
     id: string;
     props?: Record<string, any>;
+    capabilities?: LayoutCapabilities;
+} | {
+    template: string;
+    capabilities?: LayoutCapabilities;
 };
 export interface ValidationResult {
     valid: boolean;
@@ -97,6 +109,9 @@ export interface RenderContext {
         [key: string]: any;
     };
     context?: Record<string, any>;
+    semanticContinuity?: import('../conversation/types.js').SemanticContinuityContext;
+    thread_state?: import('../conversation/types.js').ConversationThreadState;
+    threadState?: import('../conversation/types.js').ConversationThreadState;
     contextOptions?: {
         goals: boolean | string | string[];
         daily: boolean;
@@ -109,7 +124,8 @@ export interface RawLayoutYaml {
     description?: string;
     propsSchema?: Record<string, any>;
     template?: string;
-    layouts?: Record<string, string>;
+    layouts?: Record<string, any>;
+    capabilities?: LayoutCapabilities;
 }
 export declare class LayoutLoadError extends Error {
     readonly layoutId?: string | undefined;

package/dist/local-server/base-url.d.ts

@@ -0,0 +1,18 @@
+export declare const LOCAL_SERVER_BASE_URL_MAX_LENGTH = 2048;
+export type LocalServerHostClass = 'loopback' | 'private-ipv4' | 'cgnat' | 'unique-local-ipv6';
+export type LocalServerBaseUrlErrorCode = 'invalid_input' | 'url_too_long' | 'invalid_scheme' | 'invalid_url' | 'userinfo_not_allowed' | 'query_not_allowed' | 'fragment_not_allowed' | 'invalid_port' | 'host_not_ip_literal' | 'zone_id' | 'loopback_not_allowed' | 'metadata_address' | 'link_local' | 'multicast' | 'unspecified' | 'ipv4_mapped_ipv6' | 'ip_not_allowed';
+export interface LocalServerBaseUrlOptions {
+    allowLoopback?: boolean;
+}
+export interface LocalServerBaseUrlSuccess {
+    ok: true;
+    normalizedBaseUrl: string;
+    hostClass: LocalServerHostClass;
+}
+export interface LocalServerBaseUrlFailure {
+    ok: false;
+    code: LocalServerBaseUrlErrorCode;
+}
+export type LocalServerBaseUrlResult = LocalServerBaseUrlSuccess | LocalServerBaseUrlFailure;
+export declare function parseLocalServerBaseUrl(value: unknown, options?: LocalServerBaseUrlOptions): LocalServerBaseUrlResult;
+export declare function isAllowedLocalServerIp(value: string, options?: LocalServerBaseUrlOptions): boolean;

package/dist/local-server/index.d.ts

@@ -0,0 +1,8 @@
+export { isAllowedLocalServerIp, parseLocalServerBaseUrl, } from './base-url';
+export type { LocalServerBaseUrlErrorCode, LocalServerBaseUrlFailure, LocalServerBaseUrlOptions, LocalServerBaseUrlResult, LocalServerBaseUrlSuccess, LocalServerHostClass, } from './base-url';
+export { DEFAULT_LOCAL_SERVER_PROBE_TIMEOUT_MS, probeLocalServer } from './probe';
+export type { LocalServerDefinition, LocalServerFetch, LocalServerKind, LocalServerModel, LocalServerOpenCodeOverlay, LocalServerProbeOptions, LocalServerProbeReason, LocalServerProbeResponse, LocalServerProbeResult, LocalServerSettings, } from './types';
+export { buildLocalServerOpenCodeOverlay, LocalServerOpenCodeOverlayError, } from './opencode';
+export type { LocalServerOpenCodeOverlayErrorCode } from './opencode';
+export { isLocalServerRuntimeEligible, resolveLocalServerRuntime, LocalServerRuntimeError, LOCAL_AI_SERVER_CONFIG_INVALID, } from './runtime';
+export type { LocalServerRuntimeMetadata, LocalServerRuntimeOptions, LocalServerRuntimeResolution, } from './runtime';

package/dist/local-server/opencode.d.ts

@@ -0,0 +1,8 @@
+import type { LocalServerOpenCodeOverlay, LocalServerSettings } from './types';
+export type LocalServerOpenCodeOverlayErrorCode = 'missing_default_model' | 'invalid_default_model' | 'invalid_label' | 'invalid_provider_id' | 'invalid_api_key_env' | 'invalid_base_url';
+export declare class LocalServerOpenCodeOverlayError extends Error {
+    readonly code: LocalServerOpenCodeOverlayErrorCode;
+    readonly name = "LocalServerOpenCodeOverlayError";
+    constructor(code: LocalServerOpenCodeOverlayErrorCode);
+}
+export declare function buildLocalServerOpenCodeOverlay(settings: LocalServerSettings): LocalServerOpenCodeOverlay;

package/dist/local-server/probe.d.ts

@@ -0,0 +1,3 @@
+import type { LocalServerProbeOptions, LocalServerProbeResult } from './types.js';
+export declare const DEFAULT_LOCAL_SERVER_PROBE_TIMEOUT_MS = 3000;
+export declare function probeLocalServer(baseUrl: string, options?: LocalServerProbeOptions): Promise<LocalServerProbeResult>;

package/dist/local-server/runtime.d.ts

@@ -0,0 +1,26 @@
+import type { GlobalSettingsStore } from '../config/global-settings';
+export declare const LOCAL_AI_SERVER_CONFIG_INVALID: "LOCAL_AI_SERVER_CONFIG_INVALID";
+export interface LocalServerRuntimeMetadata {
+    providerId: string;
+    model: string;
+    source: 'global_settings';
+}
+export interface LocalServerRuntimeResolution {
+    model?: string;
+    env?: {
+        OPENCODE_CONFIG_CONTENT: string;
+    };
+    metadata?: LocalServerRuntimeMetadata;
+}
+export interface LocalServerRuntimeOptions {
+    effectiveProviderStr: string;
+    effectiveModel?: string;
+    globalSettings?: GlobalSettingsStore;
+}
+export declare class LocalServerRuntimeError extends Error {
+    readonly name = "LocalServerRuntimeError";
+    readonly code: "LOCAL_AI_SERVER_CONFIG_INVALID";
+    constructor();
+}
+export declare function isLocalServerRuntimeEligible(effectiveProviderStr: string, effectiveModel: string | undefined): boolean;
+export declare function resolveLocalServerRuntime(options: LocalServerRuntimeOptions): LocalServerRuntimeResolution;

package/dist/local-server/types.d.ts

@@ -0,0 +1,43 @@
+export type LocalServerKind = 'ollama' | 'lm-studio' | 'unsloth-desktop';
+export interface LocalServerDefinition {
+    id: string;
+    label: string;
+    kind: LocalServerKind;
+    baseUrl: string;
+    discovery: 'tailscale' | 'manual';
+    defaultModel?: string;
+    auth?: {
+        apiKeyEnv: string;
+    };
+}
+export interface LocalServerSettings {
+    version: 1;
+    definition: LocalServerDefinition;
+    verifiedAt: string;
+}
+export interface LocalServerOpenCodeOverlay {
+    env: {
+        OPENCODE_CONFIG_CONTENT: string;
+    };
+    model: string;
+    providerId: string;
+}
+export interface LocalServerModel {
+    id: string;
+}
+export type LocalServerProbeReason = 'http_error' | 'timeout' | 'network_error' | 'invalid_json' | 'invalid_envelope';
+export interface LocalServerProbeResponse {
+    readonly ok: boolean;
+    json(): Promise<unknown>;
+}
+export type LocalServerFetch = (url: string, init?: RequestInit) => Promise<LocalServerProbeResponse>;
+export interface LocalServerProbeOptions {
+    timeoutMs?: number;
+    fetch?: LocalServerFetch;
+}
+export interface LocalServerProbeResult {
+    ok: boolean;
+    models: LocalServerModel[];
+    latencyMs: number;
+    reason?: LocalServerProbeReason;
+}

package/dist/migrations/0008_careful_black_bird.sql

@@ -0,0 +1,17 @@
+CREATE TABLE IF NOT EXISTS `usage_reports` (
+	`id` text PRIMARY KEY NOT NULL,
+	`workspace_id` text NOT NULL,
+	`month` text NOT NULL,
+	`generated_at` text NOT NULL,
+	`source_range` text NOT NULL,
+	`tier` text NOT NULL,
+	`total_tokens` integer NOT NULL,
+	`total_cost_usd` real NOT NULL,
+	`payload` text NOT NULL,
+	`payload_hash` text,
+	`signature` text,
+	`signed_at` text,
+	`issuer` text
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `uniq_usage_reports_ws_month` ON `usage_reports` (`workspace_id`,`month`);

package/dist/migrations/0009_hot_dark_phoenix.sql

@@ -0,0 +1 @@
+CREATE INDEX IF NOT EXISTS `idx_threads_ws_updated` ON `threads` (`workspace_id`,`updated_at`);

package/dist/migrations/0010_analyze_stats.sql

@@ -0,0 +1,6 @@
+-- Custom SQL migration file, put your code below! --
+-- WI-20260706-006: seed sqlite_stat1 so the query planner has index
+-- selectivity data from the very first run on a fresh DB (idempotent).
+PRAGMA analysis_limit = 400;
+--> statement-breakpoint
+ANALYZE;

package/dist/migrations/0011_far_black_tarantula.sql

@@ -0,0 +1 @@
+CREATE INDEX IF NOT EXISTS `idx_threads_title` ON `threads` (`title`);

package/dist/migrations/0012_blue_turbo.sql

@@ -0,0 +1,23 @@
+CREATE TABLE IF NOT EXISTS `notification_reads` (
+	`notification_id` text NOT NULL,
+	`user_id` text NOT NULL,
+	`read_at` text NOT NULL,
+	PRIMARY KEY(`notification_id`, `user_id`)
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `notifications` (
+	`id` text PRIMARY KEY NOT NULL,
+	`workspace_id` text NOT NULL,
+	`agent_id` text,
+	`task_id` text,
+	`thread_id` text,
+	`source` text DEFAULT 'agent' NOT NULL,
+	`level` text DEFAULT 'info' NOT NULL,
+	`title` text NOT NULL,
+	`body` text,
+	`target_user_id` text,
+	`created_at` text NOT NULL,
+	`metadata` text
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_notifications_ws_created` ON `notifications` (`workspace_id`,"created_at" DESC);

package/dist/migrations/0013_hesitant_adam_destine.sql

@@ -0,0 +1,15 @@
+CREATE TABLE IF NOT EXISTS `agent_suggestions` (
+	`id` text PRIMARY KEY NOT NULL,
+	`workspace_id` text NOT NULL,
+	`agent_id` text NOT NULL,
+	`task_id` text,
+	`type` text NOT NULL,
+	`status` text DEFAULT 'pending' NOT NULL,
+	`payload` text NOT NULL,
+	`applied_commit_sha` text,
+	`created_at` text NOT NULL,
+	`updated_at` text NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_agent_suggestions_ws_agent` ON `agent_suggestions` (`workspace_id`,`agent_id`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_agent_suggestions_ws_created` ON `agent_suggestions` (`workspace_id`,`created_at`);

package/dist/migrations/0014_organic_mongu.sql

@@ -0,0 +1,73 @@
+CREATE TABLE IF NOT EXISTS `ui_instances` (
+	`id` text PRIMARY KEY NOT NULL,
+	`definition_id` text NOT NULL,
+	`definition_version` integer NOT NULL,
+	`definition_hash` text NOT NULL,
+	`workspace_id` text NOT NULL,
+	`thread_id` text NOT NULL,
+	`anchor_task_id` text,
+	`domain_ref_json` text NOT NULL,
+	`state_json` text NOT NULL,
+	`revision` integer DEFAULT 0 NOT NULL,
+	`status` text DEFAULT 'active' NOT NULL,
+	`granted_capabilities_json` text DEFAULT '[]' NOT NULL,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	CONSTRAINT "ui_instances_id_ck" CHECK(length("ui_instances"."id") BETWEEN 5 AND 128 AND "ui_instances"."id" GLOB 'uic_*'),
+	CONSTRAINT "ui_instances_definition_id_ck" CHECK(length("ui_instances"."definition_id") BETWEEN 1 AND 128),
+	CONSTRAINT "ui_instances_definition_version_ck" CHECK("ui_instances"."definition_version" >= 1),
+	CONSTRAINT "ui_instances_definition_hash_ck" CHECK(length("ui_instances"."definition_hash") = 64 AND "ui_instances"."definition_hash" NOT GLOB '*[^0-9a-f]*'),
+	CONSTRAINT "ui_instances_workspace_id_ck" CHECK(length("ui_instances"."workspace_id") BETWEEN 1 AND 256),
+	CONSTRAINT "ui_instances_thread_id_ck" CHECK(length("ui_instances"."thread_id") BETWEEN 1 AND 256),
+	CONSTRAINT "ui_instances_domain_ref_json_ck" CHECK(json_valid("ui_instances"."domain_ref_json") AND json_type("ui_instances"."domain_ref_json") = 'object'),
+	CONSTRAINT "ui_instances_state_json_ck" CHECK(json_valid("ui_instances"."state_json") AND json_type("ui_instances"."state_json") = 'object'),
+	CONSTRAINT "ui_instances_revision_ck" CHECK("ui_instances"."revision" >= 0),
+	CONSTRAINT "ui_instances_status_ck" CHECK("ui_instances"."status" IN ('active', 'completed', 'expired', 'revoked', 'unsupported')),
+	CONSTRAINT "ui_instances_granted_capabilities_json_ck" CHECK(json_valid("ui_instances"."granted_capabilities_json") AND json_type("ui_instances"."granted_capabilities_json") = 'array'),
+	CONSTRAINT "ui_instances_created_at_ck" CHECK("ui_instances"."created_at" >= 0),
+	CONSTRAINT "ui_instances_updated_at_ck" CHECK("ui_instances"."updated_at" >= "ui_instances"."created_at")
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `ui_instances_workspace_thread_idx` ON `ui_instances` (`workspace_id`,`thread_id`);--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `ui_action_receipts` (
+	`id` text PRIMARY KEY NOT NULL,
+	`instance_id` text NOT NULL,
+	`request_id` text NOT NULL,
+	`action_id` text NOT NULL,
+	`actor_json` text NOT NULL,
+	`source` text NOT NULL,
+	`expected_revision` integer NOT NULL,
+	`before_revision` integer NOT NULL,
+	`after_revision` integer,
+	`status` text NOT NULL,
+	`outcome` text,
+	`input_json` text NOT NULL,
+	`result_json` text,
+	`error_code` text,
+	`requested_at` integer NOT NULL,
+	`settled_at` integer,
+	CONSTRAINT "ui_action_receipts_id_ck" CHECK(length("ui_action_receipts"."id") BETWEEN 5 AND 128),
+	CONSTRAINT "ui_action_receipts_instance_id_ck" CHECK(length("ui_action_receipts"."instance_id") BETWEEN 1 AND 128),
+	CONSTRAINT "ui_action_receipts_request_id_ck" CHECK(length("ui_action_receipts"."request_id") BETWEEN 1 AND 128),
+	CONSTRAINT "ui_action_receipts_action_id_ck" CHECK(length("ui_action_receipts"."action_id") BETWEEN 1 AND 128),
+	CONSTRAINT "ui_action_receipts_actor_json_ck" CHECK(json_valid("ui_action_receipts"."actor_json") AND json_type("ui_action_receipts"."actor_json") = 'object'),
+	CONSTRAINT "ui_action_receipts_source_ck" CHECK("ui_action_receipts"."source" IN ('ui_host', 'cli', 'system')),
+	CONSTRAINT "ui_action_receipts_expected_revision_ck" CHECK("ui_action_receipts"."expected_revision" >= 0),
+	CONSTRAINT "ui_action_receipts_before_revision_ck" CHECK("ui_action_receipts"."before_revision" >= 0),
+	CONSTRAINT "ui_action_receipts_after_revision_ck" CHECK("ui_action_receipts"."after_revision" IS NULL OR "ui_action_receipts"."after_revision" >= 0),
+	CONSTRAINT "ui_action_receipts_status_ck" CHECK("ui_action_receipts"."status" IN ('requested', 'settled')),
+	CONSTRAINT "ui_action_receipts_outcome_ck" CHECK("ui_action_receipts"."outcome" IS NULL OR "ui_action_receipts"."outcome" IN ('succeeded', 'rejected', 'failed', 'conflicted', 'expired')),
+	CONSTRAINT "ui_action_receipts_input_json_ck" CHECK(json_valid("ui_action_receipts"."input_json") AND json_type("ui_action_receipts"."input_json") = 'object'),
+	CONSTRAINT "ui_action_receipts_result_json_ck" CHECK("ui_action_receipts"."result_json" IS NULL OR (json_valid("ui_action_receipts"."result_json") AND json_type("ui_action_receipts"."result_json") = 'object')),
+	CONSTRAINT "ui_action_receipts_requested_at_ck" CHECK("ui_action_receipts"."requested_at" >= 0),
+	CONSTRAINT "ui_action_receipts_settled_at_ck" CHECK("ui_action_receipts"."settled_at" IS NULL OR "ui_action_receipts"."settled_at" >= "ui_action_receipts"."requested_at"),
+	CONSTRAINT "ui_action_receipts_status_transition_ck" CHECK((
+        ("ui_action_receipts"."status" = 'requested' AND "ui_action_receipts"."after_revision" IS NULL AND "ui_action_receipts"."outcome" IS NULL AND "ui_action_receipts"."settled_at" IS NULL)
+        OR
+        ("ui_action_receipts"."status" = 'settled' AND "ui_action_receipts"."after_revision" IS NOT NULL AND "ui_action_receipts"."outcome" IS NOT NULL AND "ui_action_receipts"."settled_at" IS NOT NULL)
+      ))
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `ui_action_receipts_instance_request_uq` ON `ui_action_receipts` (`instance_id`,`request_id`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `ui_action_receipts_instance_id_idx` ON `ui_action_receipts` (`instance_id`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `ui_action_receipts_requested_at_idx` ON `ui_action_receipts` (`requested_at`);

package/dist/migrations/0015_panoramic_gorilla_man.sql

@@ -0,0 +1,71 @@
+CREATE TABLE IF NOT EXISTS `project_criteria` (
+	`id` text PRIMARY KEY NOT NULL,
+	`project_id` text NOT NULL,
+	`position` integer NOT NULL,
+	`statement` text NOT NULL,
+	`verify_status` text DEFAULT 'pending' NOT NULL,
+	`verified_at` text,
+	`evidence_json` text DEFAULT '[]' NOT NULL,
+	`created_at` text NOT NULL,
+	`updated_at` text NOT NULL,
+	FOREIGN KEY (`project_id`) REFERENCES `projects`(`id`) ON UPDATE no action ON DELETE cascade,
+	CONSTRAINT "project_criteria_id_ck" CHECK("project_criteria"."id" GLOB 'pjc_*'),
+	CONSTRAINT "project_criteria_verify_status_ck" CHECK("project_criteria"."verify_status" IN ('pending', 'verifying', 'passed', 'failed')),
+	CONSTRAINT "project_criteria_evidence_json_ck" CHECK(json_valid("project_criteria"."evidence_json") AND json_type("project_criteria"."evidence_json") = 'array')
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `project_criteria_project_position_uq` ON `project_criteria` (`project_id`,`position`);--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `project_events` (
+	`id` text PRIMARY KEY NOT NULL,
+	`project_id` text NOT NULL,
+	`seq` integer NOT NULL,
+	`actor_type` text NOT NULL,
+	`actor_id` text,
+	`type` text NOT NULL,
+	`title` text NOT NULL,
+	`summary` text,
+	`payload_json` text DEFAULT '{}' NOT NULL,
+	`created_at` text NOT NULL,
+	FOREIGN KEY (`project_id`) REFERENCES `projects`(`id`) ON UPDATE no action ON DELETE restrict,
+	CONSTRAINT "project_events_id_ck" CHECK("project_events"."id" GLOB 'pje_*'),
+	CONSTRAINT "project_events_actor_type_ck" CHECK("project_events"."actor_type" IN ('user', 'project_manager', 'system')),
+	CONSTRAINT "project_events_payload_json_ck" CHECK(json_valid("project_events"."payload_json") AND json_type("project_events"."payload_json") = 'object')
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `project_events_project_seq_uq` ON `project_events` (`project_id`,`seq`);--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `projects` (
+	`id` text PRIMARY KEY NOT NULL,
+	`workspace_id` text NOT NULL,
+	`name` text NOT NULL,
+	`outcome` text NOT NULL,
+	`due_date` text,
+	`scene` text DEFAULT 'planning' NOT NULL,
+	`stages_json` text NOT NULL,
+	`stage_index` integer NOT NULL,
+	`created_at` text NOT NULL,
+	`updated_at` text NOT NULL,
+	`accepted_at` text,
+	`archived_at` text,
+	CONSTRAINT "projects_id_ck" CHECK("projects"."id" GLOB 'prj_*'),
+	CONSTRAINT "projects_scene_ck" CHECK("projects"."scene" IN ('planning', 'plan_review', 'running', 'human_wait', 'limit_wait', 'failed_stop', 'analyzing_feedback', 'replanned', 'awaiting_review', 'accepted')),
+	CONSTRAINT "projects_stages_json_ck" CHECK(json_valid("projects"."stages_json") AND json_type("projects"."stages_json") = 'array'),
+	CONSTRAINT "projects_stage_index_ck" CHECK("projects"."stage_index" >= 1)
+);
+--> statement-breakpoint
+CREATE TRIGGER IF NOT EXISTS project_events_no_update
+BEFORE UPDATE ON project_events
+BEGIN
+  SELECT RAISE(ABORT, 'project_events is append-only');
+END;
+--> statement-breakpoint
+CREATE TRIGGER IF NOT EXISTS project_events_no_delete
+BEFORE DELETE ON project_events
+BEGIN
+  SELECT RAISE(ABORT, 'project_events is append-only');
+END;
+--> statement-breakpoint
+UPDATE tasks
+SET project_id = NULL
+WHERE id = 'task_1773657200590_gu3z335oy'
+  AND project_id = '9c899c8b05f8d8d8d1df6d904c0a7fa8e5c95f1cb81602423c1e508f8b77d1dc'
+  AND workspace_id = '9c899c8b05f8d8d8d1df6d904c0a7fa8e5c95f1cb81602423c1e508f8b77d1dc';

package/dist/migrations/0016_fuzzy_hemingway.sql

@@ -0,0 +1,14 @@
+CREATE TABLE IF NOT EXISTS `task_log_events` (
+	`id` integer PRIMARY KEY NOT NULL,
+	`task_id` text NOT NULL,
+	`seq` integer NOT NULL,
+	`timestamp` text NOT NULL,
+	`level` text NOT NULL,
+	`message` text NOT NULL,
+	FOREIGN KEY (`task_id`) REFERENCES `tasks`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `task_log_events_task_seq_uq` ON `task_log_events` (`task_id`,`seq`);--> statement-breakpoint
+ALTER TABLE `tasks` ADD `log_storage` text DEFAULT 'blob' NOT NULL CONSTRAINT "tasks_log_storage_ck" CHECK("tasks"."log_storage" IN ('blob', 'events'));--> statement-breakpoint
+ALTER TABLE `tasks` ADD `last_log_seq` integer DEFAULT 0 NOT NULL;--> statement-breakpoint
+ALTER TABLE `tasks` ADD `log_revision` integer DEFAULT 0 NOT NULL;

package/dist/migrations/0017_project_stage_sdk_migration.sql

@@ -0,0 +1,29 @@
+-- Normalize the exact historical default without carrying translated labels
+-- into the SDK-owned persistence contract.
+UPDATE projects
+SET stages_json = '[{"key":"outcome_plan","labelOverride":null},{"key":"contract_check","labelOverride":null},{"key":"feature_link","labelOverride":null},{"key":"use_verify","labelOverride":null},{"key":"result_review","labelOverride":null}]'
+WHERE json(stages_json) = json('[{"key":"outcome_plan","label":"결과·계획"},{"key":"contract_check","label":"계약 확인"},{"key":"feature_link","label":"기능 연결"},{"key":"use_verify","label":"사용 검증"},{"key":"result_review","label":"결과 확인"}]');
+--> statement-breakpoint
+-- Custom and mixed arrays retain their label text under the new property name.
+UPDATE projects
+SET stages_json = (
+  SELECT json_group_array(
+    CASE
+      WHEN json_type(value, '$.label') IS NULL THEN json(value)
+      ELSE json_set(
+        json_remove(json(value), '$.label'),
+        '$.labelOverride',
+        json(json_quote(json_extract(value, '$.label')))
+      )
+    END
+  )
+  FROM json_each(projects.stages_json)
+)
+WHERE json_valid(stages_json)
+  AND json_type(stages_json) = 'array'
+  AND json(stages_json) <> json('[{"key":"outcome_plan","label":"결과·계획"},{"key":"contract_check","label":"계약 확인"},{"key":"feature_link","label":"기능 연결"},{"key":"use_verify","label":"사용 검증"},{"key":"result_review","label":"결과 확인"}]')
+  AND EXISTS (
+    SELECT 1
+    FROM json_each(projects.stages_json)
+    WHERE json_type(value, '$.label') IS NOT NULL
+  );

package/dist/migrations/0018_bored_jackal.sql

@@ -0,0 +1,33 @@
+CREATE TABLE IF NOT EXISTS `common_codes` (
+	`code_group` text NOT NULL,
+	`code` text NOT NULL,
+	`code_name` text,
+	`color` text DEFAULT 'gray' NOT NULL,
+	`sort_order` integer NOT NULL,
+	`workspace_id` text,
+	`is_builtin` integer DEFAULT 0 NOT NULL,
+	`is_archived` integer DEFAULT 0 NOT NULL,
+	`metadata` text,
+	`created_at` text NOT NULL,
+	`updated_at` text NOT NULL,
+	PRIMARY KEY(`code_group`, `code`),
+	CONSTRAINT "common_codes_metadata_ck" CHECK("common_codes"."metadata" IS NULL OR (json_valid("common_codes"."metadata") AND json_type("common_codes"."metadata") = 'object')),
+	CONSTRAINT "common_codes_builtin_ck" CHECK("common_codes"."is_builtin" IN (0, 1)),
+	CONSTRAINT "common_codes_archived_ck" CHECK("common_codes"."is_archived" IN (0, 1))
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_common_codes_group_archived_order` ON `common_codes` (`code_group`,`is_archived`,`sort_order`);--> statement-breakpoint
+INSERT OR IGNORE INTO `common_codes`
+  (`code_group`, `code`, `code_name`, `color`, `sort_order`, `workspace_id`, `is_builtin`, `is_archived`, `metadata`, `created_at`, `updated_at`)
+VALUES
+  ('THREAD_PRIORITY', 'urgent', NULL, 'red', 0, NULL, 1, 0, NULL, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  ('THREAD_PRIORITY', 'high', NULL, 'orange', 1, NULL, 1, 0, NULL, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  ('THREAD_PRIORITY', 'medium', NULL, 'blue', 2, NULL, 1, 0, NULL, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  ('THREAD_PRIORITY', 'low', NULL, 'gray', 3, NULL, 1, 0, NULL, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  ('THREAD_STATE', 'investigating', NULL, 'violet', 0, NULL, 1, 0, NULL, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  ('THREAD_STATE', 'in-progress', NULL, 'blue', 1, NULL, 1, 0, NULL, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  ('THREAD_STATE', 'in-review', NULL, 'amber', 2, NULL, 1, 0, NULL, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  ('THREAD_STATE', 'on-hold', NULL, 'gray', 3, NULL, 1, 0, NULL, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  ('THREAD_STATE', 'done', NULL, 'green', 4, NULL, 1, 0, NULL, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), strftime('%Y-%m-%dT%H:%M:%fZ', 'now'));--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_threads_workspace_thread_state` ON `threads` (`workspace_id`, json_extract(metadata, '$.threadTitle.state'));--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_threads_workspace_thread_priority` ON `threads` (`workspace_id`, json_extract(metadata, '$.threadTitle.priority'));

package/dist/migrations/0019_backfill_task_thread_ids.sql

@@ -0,0 +1,74 @@
+-- Backfill the indexed thread_id before command-based legacy lookups are removed.
+-- The command format stores a thread id as the next whitespace-delimited value
+-- after --thread=. Quoted values are normalized because some older launchers
+-- persisted argv strings with quotes. A prompt can also contain a documented
+-- --thread= example, so the final marker is the actual CLI option appended by
+-- the launcher.
+WITH RECURSIVE thread_markers(id, command, marker_pos) AS (
+  SELECT
+    id,
+    command,
+    instr(command, '--thread=') AS marker_pos
+  FROM tasks
+  WHERE thread_id IS NULL
+    AND command IS NOT NULL
+    AND instr(command, '--thread=') > 0
+
+  UNION ALL
+
+  SELECT
+    id,
+    command,
+    marker_pos
+      + length('--thread=')
+      - 1
+      + instr(substr(command, marker_pos + length('--thread=')), '--thread=')
+  FROM thread_markers
+  WHERE instr(substr(command, marker_pos + length('--thread=')), '--thread=') > 0
+), last_markers AS (
+  SELECT id, command, MAX(marker_pos) AS marker_pos
+  FROM thread_markers
+  GROUP BY id, command
+), legacy_threads AS (
+  SELECT
+    id,
+    substr(command, marker_pos + length('--thread=')) AS tail
+  FROM last_markers
+), extracted AS (
+  SELECT
+    id,
+    trim(
+      CASE
+        WHEN instr(replace(replace(replace(tail, char(9), ' '), char(10), ' '), char(13), ' '), ' ') > 0
+        THEN substr(
+          replace(replace(replace(tail, char(9), ' '), char(10), ' '), char(13), ' '),
+          1,
+          instr(replace(replace(replace(tail, char(9), ' '), char(10), ' '), char(13), ' '), ' ') - 1
+        )
+        ELSE replace(replace(replace(tail, char(9), ' '), char(10), ' '), char(13), ' ')
+      END
+    ) AS raw_thread_id
+  FROM legacy_threads
+), normalized AS (
+  SELECT
+    id,
+    CASE
+      WHEN substr(raw_thread_id, 1, 1) IN ('"', char(39))
+        AND substr(raw_thread_id, -1, 1) = substr(raw_thread_id, 1, 1)
+      THEN substr(raw_thread_id, 2, length(raw_thread_id) - 2)
+      ELSE raw_thread_id
+    END AS thread_id
+  FROM extracted
+)
+UPDATE tasks
+SET thread_id = (
+  SELECT normalized.thread_id
+  FROM normalized
+  WHERE normalized.id = tasks.id
+)
+WHERE tasks.thread_id IS NULL
+  AND tasks.id IN (
+    SELECT id
+    FROM normalized
+    WHERE length(thread_id) > 0
+  );

package/dist/migrations/0020_useful_iron_lad.sql

@@ -0,0 +1,55 @@
+CREATE TABLE IF NOT EXISTS `thread_events` (
+	`id` text PRIMARY KEY NOT NULL,
+	`thread_id` text NOT NULL,
+	`seq` integer NOT NULL,
+	`type` text NOT NULL,
+	`actor_type` text NOT NULL,
+	`payload_json` text NOT NULL,
+	`created_at` text NOT NULL,
+	`actor_id` text,
+	`task_id` text,
+	`highlight_id` text,
+	FOREIGN KEY (`thread_id`) REFERENCES `threads`(`id`) ON UPDATE no action ON DELETE cascade,
+	CONSTRAINT "thread_events_type_ck" CHECK("thread_events"."type" IN ('thread.snapshot.imported', 'thread.title.changed', 'thread.priority.changed', 'thread.state.changed', 'thread.highlight.created', 'thread.highlight.updated', 'thread.highlight.deleted')),
+	CONSTRAINT "thread_events_actor_type_ck" CHECK("thread_events"."actor_type" IN ('user', 'agent', 'system')),
+	CONSTRAINT "thread_events_payload_json_ck" CHECK(json_valid("thread_events"."payload_json") AND json_type("thread_events"."payload_json") = 'object')
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_thread_events_thread_seq` ON `thread_events` (`thread_id`,`seq`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_thread_events_thread_created` ON `thread_events` (`thread_id`,`created_at`);--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `thread_events_thread_seq_uq` ON `thread_events` (`thread_id`,`seq`);--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `thread_highlights` (
+	`id` text PRIMARY KEY NOT NULL,
+	`thread_id` text NOT NULL,
+	`source` text NOT NULL,
+	`kind` text NOT NULL,
+	`status` text DEFAULT 'active' NOT NULL,
+	`text` text,
+	`covers_from_task_id` text NOT NULL,
+	`covers_to_task_id` text NOT NULL,
+	`revision` integer DEFAULT 0 NOT NULL,
+	`created_at` text NOT NULL,
+	`updated_at` text NOT NULL,
+	`agent_id` text,
+	`source_task_id` text,
+	`detector_version` text,
+	`content_fingerprint` text,
+	`dismissed_at` text,
+	FOREIGN KEY (`thread_id`) REFERENCES `threads`(`id`) ON UPDATE no action ON DELETE cascade,
+	CONSTRAINT "thread_highlights_source_ck" CHECK("thread_highlights"."source" IN ('auto', 'manual')),
+	CONSTRAINT "thread_highlights_kind_ck" CHECK("thread_highlights"."kind" IN ('decision', 'judgment', 'issue', 'result', 'pivot')),
+	CONSTRAINT "thread_highlights_status_ck" CHECK("thread_highlights"."status" IN ('active', 'dismissed')),
+	CONSTRAINT "thread_highlights_active_text_ck" CHECK("thread_highlights"."status" = 'dismissed' OR ("thread_highlights"."text" IS NOT NULL AND length("thread_highlights"."text") > 0)),
+	CONSTRAINT "thread_highlights_covers_ck" CHECK(length("thread_highlights"."covers_from_task_id") > 0 AND length("thread_highlights"."covers_to_task_id") > 0),
+	CONSTRAINT "thread_highlights_auto_key_ck" CHECK("thread_highlights"."source" = 'manual' OR ("thread_highlights"."source" = 'auto' AND "thread_highlights"."source_task_id" IS NOT NULL AND "thread_highlights"."detector_version" IS NOT NULL AND "thread_highlights"."content_fingerprint" IS NOT NULL AND length("thread_highlights"."source_task_id") > 0 AND length("thread_highlights"."detector_version") > 0 AND length("thread_highlights"."content_fingerprint") > 0))
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_thread_highlights_thread_status_created` ON `thread_highlights` (`thread_id`,`status`,`created_at`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_thread_highlights_thread_covers` ON `thread_highlights` (`thread_id`,`covers_from_task_id`,`covers_to_task_id`);--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `thread_highlights_auto_idempotency_uq` ON `thread_highlights` (`thread_id`,`source_task_id`,`detector_version`,`content_fingerprint`) WHERE "thread_highlights"."source" = 'auto';
+--> statement-breakpoint
+CREATE TRIGGER IF NOT EXISTS thread_events_no_update
+BEFORE UPDATE ON thread_events
+BEGIN
+  SELECT RAISE(ABORT, 'thread_events is append-only');
+END;