forge-openclaw-plugin 0.2.15 → 0.2.19

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "forge-openclaw-plugin",
   "name": "Forge",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
-  "version": "0.2.15",
+  "version": "0.2.19",
   "skills": [
     "./skills"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-openclaw-plugin",
-  "version": "0.2.15",
+  "version": "0.2.19",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
   "type": "module",
   "license": "MIT",

package/server/migrations/003_habits.sql

@@ -0,0 +1,30 @@
+CREATE TABLE IF NOT EXISTS habits (
+  id TEXT PRIMARY KEY,
+  title TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT '',
+  status TEXT NOT NULL DEFAULT 'active',
+  polarity TEXT NOT NULL DEFAULT 'positive',
+  frequency TEXT NOT NULL DEFAULT 'daily',
+  target_count INTEGER NOT NULL DEFAULT 1,
+  week_days_json TEXT NOT NULL DEFAULT '[]',
+  linked_behavior_id TEXT REFERENCES psyche_behaviors(id) ON DELETE SET NULL,
+  reward_xp INTEGER NOT NULL DEFAULT 12,
+  penalty_xp INTEGER NOT NULL DEFAULT 8,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS habit_check_ins (
+  id TEXT PRIMARY KEY,
+  habit_id TEXT NOT NULL REFERENCES habits(id) ON DELETE CASCADE,
+  date_key TEXT NOT NULL,
+  status TEXT NOT NULL,
+  note TEXT NOT NULL DEFAULT '',
+  delta_xp INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE (habit_id, date_key)
+);
+
+CREATE INDEX IF NOT EXISTS idx_habits_status ON habits(status, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_habit_check_ins_habit_date ON habit_check_ins(habit_id, date_key DESC);

package/server/migrations/004_habit_links.sql

@@ -0,0 +1,8 @@
+ALTER TABLE habits
+ADD COLUMN linked_goal_ids_json TEXT NOT NULL DEFAULT '[]';
+
+ALTER TABLE habits
+ADD COLUMN linked_project_ids_json TEXT NOT NULL DEFAULT '[]';
+
+ALTER TABLE habits
+ADD COLUMN linked_task_ids_json TEXT NOT NULL DEFAULT '[]';

package/server/migrations/005_habit_psyche_links.sql

@@ -0,0 +1,24 @@
+ALTER TABLE habits
+ADD COLUMN linked_value_ids_json TEXT NOT NULL DEFAULT '[]';
+
+ALTER TABLE habits
+ADD COLUMN linked_pattern_ids_json TEXT NOT NULL DEFAULT '[]';
+
+ALTER TABLE habits
+ADD COLUMN linked_behavior_ids_json TEXT NOT NULL DEFAULT '[]';
+
+ALTER TABLE habits
+ADD COLUMN linked_belief_ids_json TEXT NOT NULL DEFAULT '[]';
+
+ALTER TABLE habits
+ADD COLUMN linked_mode_ids_json TEXT NOT NULL DEFAULT '[]';
+
+ALTER TABLE habits
+ADD COLUMN linked_report_ids_json TEXT NOT NULL DEFAULT '[]';
+
+UPDATE habits
+SET linked_behavior_ids_json = CASE
+  WHEN linked_behavior_id IS NULL OR trim(linked_behavior_id) = '' THEN '[]'
+  ELSE json_array(linked_behavior_id)
+END
+WHERE linked_behavior_ids_json = '[]';

package/server/migrations/006_work_adjustments.sql

@@ -0,0 +1,14 @@
+CREATE TABLE IF NOT EXISTS work_adjustments (
+  id TEXT PRIMARY KEY,
+  entity_type TEXT NOT NULL,
+  entity_id TEXT NOT NULL,
+  requested_delta_minutes INTEGER NOT NULL,
+  applied_delta_minutes INTEGER NOT NULL,
+  note TEXT NOT NULL DEFAULT '',
+  actor TEXT,
+  source TEXT NOT NULL,
+  created_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_work_adjustments_entity
+ON work_adjustments(entity_type, entity_id, created_at DESC);

package/server/migrations/007_weekly_review_closures.sql

@@ -0,0 +1,17 @@
+CREATE TABLE IF NOT EXISTS weekly_review_closures (
+  id TEXT PRIMARY KEY,
+  week_key TEXT NOT NULL UNIQUE,
+  week_start_date TEXT NOT NULL,
+  week_end_date TEXT NOT NULL,
+  window_label TEXT NOT NULL,
+  actor TEXT,
+  source TEXT NOT NULL,
+  reward_id TEXT NOT NULL,
+  activity_event_id TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (reward_id) REFERENCES reward_ledger(id) ON DELETE RESTRICT,
+  FOREIGN KEY (activity_event_id) REFERENCES activity_events(id) ON DELETE RESTRICT
+);
+
+CREATE INDEX IF NOT EXISTS idx_weekly_review_closures_created_at
+  ON weekly_review_closures(created_at DESC);

package/server/migrations/008_calendar_execution.sql

@@ -0,0 +1,147 @@
+ALTER TABLE projects ADD COLUMN scheduling_rules_json TEXT NOT NULL DEFAULT '{}';
+ALTER TABLE tasks ADD COLUMN scheduling_rules_json TEXT;
+ALTER TABLE tasks ADD COLUMN planned_duration_seconds INTEGER;
+ALTER TABLE task_runs ADD COLUMN override_reason TEXT;
+
+CREATE TABLE IF NOT EXISTS stored_secrets (
+  id TEXT PRIMARY KEY,
+  cipher_text TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT '',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS calendar_connections (
+  id TEXT PRIMARY KEY,
+  provider TEXT NOT NULL,
+  label TEXT NOT NULL,
+  account_label TEXT NOT NULL DEFAULT '',
+  status TEXT NOT NULL DEFAULT 'connected',
+  config_json TEXT NOT NULL DEFAULT '{}',
+  credentials_secret_id TEXT NOT NULL,
+  forge_calendar_id TEXT,
+  last_synced_at TEXT,
+  last_sync_error TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (credentials_secret_id) REFERENCES stored_secrets(id) ON DELETE RESTRICT,
+  FOREIGN KEY (forge_calendar_id) REFERENCES calendar_calendars(id) ON DELETE SET NULL
+);
+
+CREATE TABLE IF NOT EXISTS calendar_calendars (
+  id TEXT PRIMARY KEY,
+  connection_id TEXT NOT NULL,
+  remote_id TEXT NOT NULL,
+  title TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT '',
+  color TEXT NOT NULL DEFAULT '#7dd3fc',
+  timezone TEXT NOT NULL DEFAULT 'UTC',
+  is_primary INTEGER NOT NULL DEFAULT 0,
+  can_write INTEGER NOT NULL DEFAULT 1,
+  forge_managed INTEGER NOT NULL DEFAULT 0,
+  sync_cursor TEXT,
+  remote_etag TEXT,
+  last_synced_at TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE(connection_id, remote_id),
+  FOREIGN KEY (connection_id) REFERENCES calendar_connections(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS calendar_events (
+  id TEXT PRIMARY KEY,
+  connection_id TEXT NOT NULL,
+  calendar_id TEXT NOT NULL,
+  remote_id TEXT NOT NULL,
+  remote_href TEXT,
+  remote_etag TEXT,
+  ownership TEXT NOT NULL DEFAULT 'external',
+  status TEXT NOT NULL DEFAULT 'confirmed',
+  title TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT '',
+  location TEXT NOT NULL DEFAULT '',
+  start_at TEXT NOT NULL,
+  end_at TEXT NOT NULL,
+  is_all_day INTEGER NOT NULL DEFAULT 0,
+  availability TEXT NOT NULL DEFAULT 'busy',
+  event_type TEXT NOT NULL DEFAULT '',
+  categories_json TEXT NOT NULL DEFAULT '[]',
+  raw_payload_json TEXT NOT NULL DEFAULT '{}',
+  remote_updated_at TEXT,
+  deleted_at TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE(connection_id, calendar_id, remote_id),
+  FOREIGN KEY (connection_id) REFERENCES calendar_connections(id) ON DELETE CASCADE,
+  FOREIGN KEY (calendar_id) REFERENCES calendar_calendars(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_calendar_events_calendar_start
+  ON calendar_events(calendar_id, start_at, end_at);
+
+CREATE INDEX IF NOT EXISTS idx_calendar_events_connection_updated
+  ON calendar_events(connection_id, updated_at);
+
+CREATE TABLE IF NOT EXISTS work_block_templates (
+  id TEXT PRIMARY KEY,
+  title TEXT NOT NULL,
+  kind TEXT NOT NULL,
+  color TEXT NOT NULL DEFAULT '#60a5fa',
+  timezone TEXT NOT NULL DEFAULT 'UTC',
+  weekdays_json TEXT NOT NULL DEFAULT '[]',
+  start_minute INTEGER NOT NULL,
+  end_minute INTEGER NOT NULL,
+  blocking_state TEXT NOT NULL DEFAULT 'blocked',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS work_block_instances (
+  id TEXT PRIMARY KEY,
+  template_id TEXT NOT NULL,
+  date_key TEXT NOT NULL,
+  start_at TEXT NOT NULL,
+  end_at TEXT NOT NULL,
+  title TEXT NOT NULL,
+  kind TEXT NOT NULL,
+  color TEXT NOT NULL DEFAULT '#60a5fa',
+  blocking_state TEXT NOT NULL DEFAULT 'blocked',
+  calendar_event_id TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE(template_id, date_key, start_at, end_at),
+  FOREIGN KEY (template_id) REFERENCES work_block_templates(id) ON DELETE CASCADE,
+  FOREIGN KEY (calendar_event_id) REFERENCES calendar_events(id) ON DELETE SET NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_work_block_instances_date
+  ON work_block_instances(date_key, start_at, end_at);
+
+CREATE TABLE IF NOT EXISTS task_timeboxes (
+  id TEXT PRIMARY KEY,
+  task_id TEXT NOT NULL,
+  project_id TEXT,
+  connection_id TEXT,
+  calendar_id TEXT,
+  remote_event_id TEXT,
+  linked_task_run_id TEXT,
+  status TEXT NOT NULL DEFAULT 'planned',
+  source TEXT NOT NULL DEFAULT 'manual',
+  title TEXT NOT NULL,
+  starts_at TEXT NOT NULL,
+  ends_at TEXT NOT NULL,
+  override_reason TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (task_id) REFERENCES tasks(id) ON DELETE CASCADE,
+  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE SET NULL,
+  FOREIGN KEY (connection_id) REFERENCES calendar_connections(id) ON DELETE SET NULL,
+  FOREIGN KEY (calendar_id) REFERENCES calendar_calendars(id) ON DELETE SET NULL,
+  FOREIGN KEY (linked_task_run_id) REFERENCES task_runs(id) ON DELETE SET NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_task_timeboxes_task_start
+  ON task_timeboxes(task_id, starts_at, ends_at);
+
+CREATE INDEX IF NOT EXISTS idx_task_timeboxes_run
+  ON task_timeboxes(linked_task_run_id);

package/server/migrations/009_true_calendar_events.sql

@@ -0,0 +1,195 @@
+CREATE TABLE IF NOT EXISTS forge_events (
+  id TEXT PRIMARY KEY,
+  preferred_connection_id TEXT,
+  preferred_calendar_id TEXT,
+  ownership TEXT NOT NULL DEFAULT 'forge',
+  origin_type TEXT NOT NULL DEFAULT 'native',
+  status TEXT NOT NULL DEFAULT 'confirmed',
+  title TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT '',
+  location TEXT NOT NULL DEFAULT '',
+  start_at TEXT NOT NULL,
+  end_at TEXT NOT NULL,
+  timezone TEXT NOT NULL DEFAULT 'UTC',
+  is_all_day INTEGER NOT NULL DEFAULT 0,
+  availability TEXT NOT NULL DEFAULT 'busy',
+  event_type TEXT NOT NULL DEFAULT '',
+  categories_json TEXT NOT NULL DEFAULT '[]',
+  deleted_at TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (preferred_connection_id) REFERENCES calendar_connections(id) ON DELETE SET NULL,
+  FOREIGN KEY (preferred_calendar_id) REFERENCES calendar_calendars(id) ON DELETE SET NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_forge_events_time
+  ON forge_events(start_at, end_at);
+
+CREATE INDEX IF NOT EXISTS idx_forge_events_calendar
+  ON forge_events(preferred_calendar_id, start_at, end_at);
+
+CREATE TABLE IF NOT EXISTS forge_event_sources (
+  id TEXT PRIMARY KEY,
+  forge_event_id TEXT NOT NULL,
+  provider TEXT NOT NULL,
+  connection_id TEXT,
+  calendar_id TEXT,
+  remote_calendar_id TEXT,
+  remote_event_id TEXT NOT NULL,
+  remote_uid TEXT,
+  recurrence_instance_id TEXT,
+  is_master_recurring INTEGER NOT NULL DEFAULT 0,
+  remote_href TEXT,
+  remote_etag TEXT,
+  sync_state TEXT NOT NULL DEFAULT 'synced',
+  raw_payload_json TEXT NOT NULL DEFAULT '{}',
+  last_synced_at TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (forge_event_id) REFERENCES forge_events(id) ON DELETE CASCADE,
+  FOREIGN KEY (connection_id) REFERENCES calendar_connections(id) ON DELETE SET NULL,
+  FOREIGN KEY (calendar_id) REFERENCES calendar_calendars(id) ON DELETE SET NULL,
+  UNIQUE(provider, connection_id, calendar_id, remote_event_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_forge_event_sources_event
+  ON forge_event_sources(forge_event_id);
+
+CREATE INDEX IF NOT EXISTS idx_forge_event_sources_remote
+  ON forge_event_sources(connection_id, calendar_id, remote_event_id);
+
+CREATE TABLE IF NOT EXISTS forge_event_links (
+  id TEXT PRIMARY KEY,
+  forge_event_id TEXT NOT NULL,
+  entity_type TEXT NOT NULL,
+  entity_id TEXT NOT NULL,
+  relationship_type TEXT NOT NULL DEFAULT 'context',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (forge_event_id) REFERENCES forge_events(id) ON DELETE CASCADE,
+  UNIQUE(forge_event_id, entity_type, entity_id, relationship_type)
+);
+
+CREATE INDEX IF NOT EXISTS idx_forge_event_links_entity
+  ON forge_event_links(entity_type, entity_id);
+
+CREATE TABLE IF NOT EXISTS forge_event_metadata (
+  id TEXT PRIMARY KEY,
+  forge_event_id TEXT NOT NULL,
+  namespace TEXT NOT NULL,
+  key TEXT NOT NULL,
+  value_json TEXT NOT NULL DEFAULT 'null',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (forge_event_id) REFERENCES forge_events(id) ON DELETE CASCADE,
+  UNIQUE(forge_event_id, namespace, key)
+);
+
+ALTER TABLE task_timeboxes ADD COLUMN forge_event_id TEXT REFERENCES forge_events(id) ON DELETE SET NULL;
+
+INSERT INTO forge_events (
+  id,
+  preferred_connection_id,
+  preferred_calendar_id,
+  ownership,
+  origin_type,
+  status,
+  title,
+  description,
+  location,
+  start_at,
+  end_at,
+  timezone,
+  is_all_day,
+  availability,
+  event_type,
+  categories_json,
+  deleted_at,
+  created_at,
+  updated_at
+)
+SELECT
+  calendar_events.id,
+  calendar_events.connection_id,
+  calendar_events.calendar_id,
+  calendar_events.ownership,
+  calendar_connections.provider,
+  calendar_events.status,
+  calendar_events.title,
+  calendar_events.description,
+  calendar_events.location,
+  calendar_events.start_at,
+  calendar_events.end_at,
+  COALESCE(calendar_calendars.timezone, 'UTC'),
+  calendar_events.is_all_day,
+  calendar_events.availability,
+  calendar_events.event_type,
+  calendar_events.categories_json,
+  calendar_events.deleted_at,
+  calendar_events.created_at,
+  calendar_events.updated_at
+FROM calendar_events
+LEFT JOIN calendar_connections
+  ON calendar_connections.id = calendar_events.connection_id
+LEFT JOIN calendar_calendars
+  ON calendar_calendars.id = calendar_events.calendar_id
+WHERE NOT EXISTS (
+  SELECT 1 FROM forge_events WHERE forge_events.id = calendar_events.id
+);
+
+INSERT INTO forge_event_sources (
+  id,
+  forge_event_id,
+  provider,
+  connection_id,
+  calendar_id,
+  remote_calendar_id,
+  remote_event_id,
+  remote_uid,
+  recurrence_instance_id,
+  is_master_recurring,
+  remote_href,
+  remote_etag,
+  sync_state,
+  raw_payload_json,
+  last_synced_at,
+  created_at,
+  updated_at
+)
+SELECT
+  'evsrc_' || lower(hex(randomblob(5))),
+  calendar_events.id,
+  calendar_connections.provider,
+  calendar_events.connection_id,
+  calendar_events.calendar_id,
+  calendar_calendars.remote_id,
+  calendar_events.remote_id,
+  json_extract(calendar_events.raw_payload_json, '$.uid'),
+  json_extract(calendar_events.raw_payload_json, '$.recurrenceid'),
+  CASE
+    WHEN json_extract(calendar_events.raw_payload_json, '$.rrule') IS NOT NULL THEN 1
+    ELSE 0
+  END,
+  calendar_events.remote_href,
+  calendar_events.remote_etag,
+  CASE
+    WHEN calendar_events.deleted_at IS NOT NULL THEN 'deleted'
+    ELSE 'synced'
+  END,
+  calendar_events.raw_payload_json,
+  COALESCE(calendar_events.remote_updated_at, calendar_events.updated_at),
+  calendar_events.created_at,
+  calendar_events.updated_at
+FROM calendar_events
+LEFT JOIN calendar_connections
+  ON calendar_connections.id = calendar_events.connection_id
+LEFT JOIN calendar_calendars
+  ON calendar_calendars.id = calendar_events.calendar_id
+WHERE NOT EXISTS (
+  SELECT 1
+  FROM forge_event_sources
+  WHERE forge_event_sources.forge_event_id = calendar_events.id
+    AND forge_event_sources.connection_id = calendar_events.connection_id
+    AND forge_event_sources.calendar_id = calendar_events.calendar_id
+    AND forge_event_sources.remote_event_id = calendar_events.remote_id
+);

package/server/migrations/010_calendar_selection_state.sql

@@ -0,0 +1,6 @@
+ALTER TABLE calendar_calendars
+ADD COLUMN selected_for_sync INTEGER NOT NULL DEFAULT 1;
+
+UPDATE calendar_calendars
+SET selected_for_sync = 1
+WHERE selected_for_sync IS NULL;

package/server/migrations/011_calendar_timezone_backfill.sql

@@ -0,0 +1,11 @@
+UPDATE calendar_calendars
+SET timezone = 'UTC'
+WHERE TRIM(COALESCE(timezone, '')) = '';
+
+UPDATE forge_events
+SET timezone = 'UTC'
+WHERE TRIM(COALESCE(timezone, '')) = '';
+
+UPDATE work_block_templates
+SET timezone = 'UTC'
+WHERE TRIM(COALESCE(timezone, '')) = '';

package/server/migrations/012_work_block_ranges.sql

@@ -0,0 +1,7 @@
+ALTER TABLE work_block_templates ADD COLUMN starts_on TEXT;
+ALTER TABLE work_block_templates ADD COLUMN ends_on TEXT;
+
+CREATE INDEX IF NOT EXISTS idx_work_block_templates_active_window
+  ON work_block_templates(starts_on, ends_on, start_minute);
+
+DROP TABLE IF EXISTS work_block_instances;

package/server/migrations/013_microsoft_local_auth_settings.sql

@@ -0,0 +1,8 @@
+ALTER TABLE app_settings
+  ADD COLUMN microsoft_client_id TEXT NOT NULL DEFAULT '';
+
+ALTER TABLE app_settings
+  ADD COLUMN microsoft_tenant_id TEXT NOT NULL DEFAULT 'common';
+
+ALTER TABLE app_settings
+  ADD COLUMN microsoft_redirect_uri TEXT NOT NULL DEFAULT '';

package/server/migrations/014_note_tags_and_ephemeral.sql

@@ -0,0 +1,8 @@
+ALTER TABLE notes
+  ADD COLUMN tags_json TEXT NOT NULL DEFAULT '[]';
+
+ALTER TABLE notes
+  ADD COLUMN destroy_at TEXT;
+
+CREATE INDEX IF NOT EXISTS idx_notes_destroy_at
+  ON notes(destroy_at);