stagent 0.6.2 → 0.7.0

package/README.md

@@ -57,6 +57,7 @@ Run the same business process on different AI providers without changing a line
 | 🧠 | **[Agent Profiles](#agent-profiles)** | Reusable specialist definitions with prompts, tool policy, and runtime tuning |
 | ⏰ | **[Schedules](#schedules)** | Recurring and one-shot automations with cadence, expiry, and firing controls |
 | 📄 | **[Documents](#document-management)** | Upload, preprocess, inspect, and link files to tasks and projects |
+| 📊 | **[Tables](#tables)** | Airtable-like structured data with spreadsheet editing, charts, triggers, and agent tools |
 | 📥 | **[Human-in-the-Loop Inbox](#inbox--human-in-the-loop)** | Approve tool use, answer questions, and review results from one queue |
 | 💬 | **[Chat](#chat)** | Tool catalog with model selection, @ mentions, slash commands, and browser automation |
 | 👀 | **[Monitoring](#monitoring)** | Live runtime visibility with log streaming, filters, and health signals |
@@ -203,6 +204,24 @@ Automatic text extraction on upload for five file types: text, PDF (pdf-parse),
 #### Agent Document Context
 Documents linked to a task are automatically injected into the agent's prompt as context. The context builder aggregates extracted text from all linked documents, giving agents access to uploaded reference material without manual copy-paste.
 
+#### Tables
+Airtable-like structured data system at `/tables` with 14 features. Create tables from scratch, import from CSV/XLSX documents, or use one of 12 built-in templates across 5 categories. Each table includes an inline spreadsheet editor with keyboard navigation, type-aware cell renderers, computed columns with formula support (12 functions including sum, avg, if, daysBetween), and optimistic saves.
+
+| Table List | Spreadsheet Editor |
+|:-:|:-:|
+| <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/tables-list.png" alt="Tables list view" width="580" /> | <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/tables-detail.png" alt="Table spreadsheet editor" width="580" /> |
+
+| Charts | Template Gallery |
+|:-:|:-:|
+| <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/tables-detail-charts.png" alt="Table charts tab" width="580" /> | <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/tables-templates.png" alt="Table template gallery" width="580" /> |
+
+- **Charts** — Bar, line, pie, and scatter charts with configurable X/Y axes and aggregation
+- **Workflow triggers** — Automated actions fired when row data matches conditions
+- **12 agent tools** — Agents can list, query, aggregate, search, add/update/delete rows, and create tables
+- **Cross-table relations** — Link rows across tables with searchable relation combobox
+- **Export** — CSV, XLSX, and JSON export for any table
+- **Row versioning** — History tab with snapshot-before-mutation and rollback to previous versions
+
 ### Knowledge
 
 #### Playbook
@@ -295,7 +314,7 @@ Real-time agent log streaming via Server-Sent Events. Filter by task or event ty
 File upload with drag-and-drop in task creation. Type-aware content preview for text, markdown (via react-markdown), code, and JSON. Copy-to-clipboard and download-as-file for task outputs.
 
 #### Settings
-Configuration hub with provider-aware sections: Claude authentication (API key or OAuth), OpenAI Codex runtime API-key management, chat defaults (model selection), **browser tools** (Chrome DevTools and Playwright MCP toggles), runtime configuration (SDK timeout and max turns), tool permissions (saved "Always Allow" patterns with revoke), permission presets, budget guardrails, and data management.
+Configuration hub with provider-aware sections: Claude authentication (API key or OAuth), OpenAI Codex runtime API-key management, chat defaults (model selection), **browser tools** (Chrome DevTools and Playwright MCP toggles), runtime configuration (SDK timeout and max turns), tool permissions (saved "Always Allow" patterns with revoke), permission presets, budget guardrails, **database snapshots** (automatic backups with configurable retention and one-click restore), and data management.
 
 <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/settings-list.png" alt="Stagent settings" width="1200" />
 
@@ -307,7 +326,7 @@ Configuration hub with provider-aware sections: Claude authentication (API key o
 The `npx stagent` entry point boots a Next.js server from the published npm package. It is built from `bin/cli.ts` into `dist/cli.js` using tsup, and serves as the primary distribution channel — no clone required.
 
 #### Database
-SQLite with WAL mode via better-sqlite3 + Drizzle ORM. Fourteen tables: `projects`, `tasks`, `workflows`, `agent_logs`, `notifications`, `documents`, `schedules`, `settings`, `learned_context`, `usage_ledger`, `conversations`, `chat_messages`, `environments`, `environment_configs`. Self-healing bootstrap — tables are created on startup if missing.
+SQLite with WAL mode via better-sqlite3 + Drizzle ORM. 27+ tables including core tables: `projects`, `tasks`, `workflows`, `agent_logs`, `notifications`, `documents`, `schedules`, `settings`, `learned_context`, `usage_ledger`, `conversations`, `chat_messages`, `environments`, `environment_configs`. Self-healing bootstrap — tables are created on startup if missing.
 
 #### Command Palette
 Global `⌘K` command palette for fast navigation and search across tasks, projects, workflows, and settings. Recent items, fuzzy search, and keyboard-driven navigation.

package/dist/cli.js

@@ -112,7 +112,24 @@ var STAGENT_TABLES = [
   "agent_memory",
   "channel_configs",
   "channel_bindings",
-  "agent_messages"
+  "agent_messages",
+  "workflow_document_inputs",
+  "schedule_document_inputs",
+  "project_document_defaults",
+  "user_tables",
+  "user_table_columns",
+  "user_table_rows",
+  "user_table_views",
+  "user_table_relationships",
+  "user_table_templates",
+  "user_table_imports",
+  "table_document_inputs",
+  "task_table_inputs",
+  "workflow_table_inputs",
+  "schedule_table_inputs",
+  "user_table_triggers",
+  "user_table_row_history",
+  "snapshots"
 ];
 function bootstrapStagentDatabase(sqlite2) {
   sqlite2.exec(`
@@ -139,6 +156,7 @@ function bootstrapStagentDatabase(sqlite2) {
       result TEXT,
       session_id TEXT,
       resume_count INTEGER DEFAULT 0 NOT NULL,
+      workflow_run_number INTEGER,
       created_at INTEGER NOT NULL,
       updated_at INTEGER NOT NULL,
       FOREIGN KEY (project_id) REFERENCES projects(id) ON UPDATE NO ACTION ON DELETE NO ACTION,
@@ -152,6 +170,7 @@ function bootstrapStagentDatabase(sqlite2) {
       name TEXT NOT NULL,
       definition TEXT NOT NULL,
       status TEXT DEFAULT 'draft' NOT NULL,
+      run_number INTEGER DEFAULT 0 NOT NULL,
       created_at INTEGER NOT NULL,
       updated_at INTEGER NOT NULL,
       FOREIGN KEY (project_id) REFERENCES projects(id) ON UPDATE NO ACTION ON DELETE NO ACTION
@@ -347,6 +366,8 @@ function bootstrapStagentDatabase(sqlite2) {
   addColumnIfMissing(`ALTER TABLE schedules ADD COLUMN heartbeat_spent_today INTEGER DEFAULT 0 NOT NULL;`);
   addColumnIfMissing(`ALTER TABLE schedules ADD COLUMN heartbeat_budget_reset_at INTEGER;`);
   addColumnIfMissing(`ALTER TABLE tasks ADD COLUMN source_type TEXT;`);
+  addColumnIfMissing(`ALTER TABLE workflows ADD COLUMN run_number INTEGER DEFAULT 0 NOT NULL;`);
+  addColumnIfMissing(`ALTER TABLE tasks ADD COLUMN workflow_run_number INTEGER;`);
   addColumnIfMissing(`ALTER TABLE documents ADD COLUMN version INTEGER NOT NULL DEFAULT 1;`);
   addColumnIfMissing(`ALTER TABLE documents ADD COLUMN source TEXT DEFAULT 'upload';`);
   addColumnIfMissing(`ALTER TABLE documents ADD COLUMN conversation_id TEXT REFERENCES conversations(id);`);
@@ -619,6 +640,256 @@ function bootstrapStagentDatabase(sqlite2) {
     CREATE INDEX IF NOT EXISTS idx_agent_messages_to_status ON agent_messages(to_profile_id, status);
     CREATE INDEX IF NOT EXISTS idx_agent_messages_task ON agent_messages(task_id);
   `);
+  sqlite2.exec(`
+    CREATE TABLE IF NOT EXISTS workflow_document_inputs (
+      id TEXT PRIMARY KEY NOT NULL,
+      workflow_id TEXT NOT NULL,
+      document_id TEXT NOT NULL,
+      step_id TEXT,
+      created_at INTEGER NOT NULL,
+      FOREIGN KEY (workflow_id) REFERENCES workflows(id) ON UPDATE NO ACTION ON DELETE NO ACTION,
+      FOREIGN KEY (document_id) REFERENCES documents(id) ON UPDATE NO ACTION ON DELETE NO ACTION
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_wdi_workflow ON workflow_document_inputs(workflow_id);
+    CREATE INDEX IF NOT EXISTS idx_wdi_document ON workflow_document_inputs(document_id);
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_wdi_workflow_doc_step ON workflow_document_inputs(workflow_id, document_id, step_id);
+
+    CREATE TABLE IF NOT EXISTS schedule_document_inputs (
+      id TEXT PRIMARY KEY NOT NULL,
+      schedule_id TEXT NOT NULL,
+      document_id TEXT NOT NULL,
+      created_at INTEGER NOT NULL,
+      FOREIGN KEY (schedule_id) REFERENCES schedules(id) ON UPDATE NO ACTION ON DELETE NO ACTION,
+      FOREIGN KEY (document_id) REFERENCES documents(id) ON UPDATE NO ACTION ON DELETE NO ACTION
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_sdi_schedule ON schedule_document_inputs(schedule_id);
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_sdi_schedule_doc ON schedule_document_inputs(schedule_id, document_id);
+
+    CREATE TABLE IF NOT EXISTS project_document_defaults (
+      id TEXT PRIMARY KEY NOT NULL,
+      project_id TEXT NOT NULL,
+      document_id TEXT NOT NULL,
+      created_at INTEGER NOT NULL,
+      FOREIGN KEY (project_id) REFERENCES projects(id) ON UPDATE NO ACTION ON DELETE NO ACTION,
+      FOREIGN KEY (document_id) REFERENCES documents(id) ON UPDATE NO ACTION ON DELETE NO ACTION
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_pdd_project ON project_document_defaults(project_id);
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_pdd_project_doc ON project_document_defaults(project_id, document_id);
+  `);
+  sqlite2.exec(`
+    CREATE TABLE IF NOT EXISTS user_tables (
+      id TEXT PRIMARY KEY NOT NULL,
+      project_id TEXT,
+      name TEXT NOT NULL,
+      description TEXT,
+      column_schema TEXT NOT NULL DEFAULT '[]',
+      row_count INTEGER DEFAULT 0 NOT NULL,
+      source TEXT DEFAULT 'manual' NOT NULL,
+      template_id TEXT,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL,
+      FOREIGN KEY (project_id) REFERENCES projects(id) ON UPDATE NO ACTION ON DELETE NO ACTION
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_user_tables_project_id ON user_tables(project_id);
+    CREATE INDEX IF NOT EXISTS idx_user_tables_source ON user_tables(source);
+
+    CREATE TABLE IF NOT EXISTS user_table_columns (
+      id TEXT PRIMARY KEY NOT NULL,
+      table_id TEXT NOT NULL,
+      name TEXT NOT NULL,
+      display_name TEXT NOT NULL,
+      data_type TEXT NOT NULL,
+      position INTEGER NOT NULL,
+      required INTEGER DEFAULT 0 NOT NULL,
+      default_value TEXT,
+      config TEXT,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL,
+      FOREIGN KEY (table_id) REFERENCES user_tables(id) ON UPDATE NO ACTION ON DELETE NO ACTION
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_user_table_columns_table_id ON user_table_columns(table_id);
+    CREATE INDEX IF NOT EXISTS idx_user_table_columns_position ON user_table_columns(table_id, position);
+
+    CREATE TABLE IF NOT EXISTS user_table_rows (
+      id TEXT PRIMARY KEY NOT NULL,
+      table_id TEXT NOT NULL,
+      data TEXT NOT NULL DEFAULT '{}',
+      position INTEGER NOT NULL,
+      created_by TEXT DEFAULT 'user',
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL,
+      FOREIGN KEY (table_id) REFERENCES user_tables(id) ON UPDATE NO ACTION ON DELETE NO ACTION
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_user_table_rows_table_id ON user_table_rows(table_id);
+    CREATE INDEX IF NOT EXISTS idx_user_table_rows_position ON user_table_rows(table_id, position);
+
+    CREATE TABLE IF NOT EXISTS user_table_views (
+      id TEXT PRIMARY KEY NOT NULL,
+      table_id TEXT NOT NULL,
+      name TEXT NOT NULL,
+      type TEXT DEFAULT 'grid' NOT NULL,
+      config TEXT,
+      is_default INTEGER DEFAULT 0 NOT NULL,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL,
+      FOREIGN KEY (table_id) REFERENCES user_tables(id) ON UPDATE NO ACTION ON DELETE NO ACTION
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_user_table_views_table_id ON user_table_views(table_id);
+
+    CREATE TABLE IF NOT EXISTS user_table_relationships (
+      id TEXT PRIMARY KEY NOT NULL,
+      from_table_id TEXT NOT NULL,
+      from_column TEXT NOT NULL,
+      to_table_id TEXT NOT NULL,
+      to_column TEXT NOT NULL,
+      relationship_type TEXT NOT NULL,
+      config TEXT,
+      created_at INTEGER NOT NULL,
+      FOREIGN KEY (from_table_id) REFERENCES user_tables(id) ON UPDATE NO ACTION ON DELETE NO ACTION,
+      FOREIGN KEY (to_table_id) REFERENCES user_tables(id) ON UPDATE NO ACTION ON DELETE NO ACTION
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_user_table_rels_from ON user_table_relationships(from_table_id);
+    CREATE INDEX IF NOT EXISTS idx_user_table_rels_to ON user_table_relationships(to_table_id);
+
+    CREATE TABLE IF NOT EXISTS user_table_templates (
+      id TEXT PRIMARY KEY NOT NULL,
+      name TEXT NOT NULL,
+      description TEXT,
+      category TEXT NOT NULL,
+      column_schema TEXT NOT NULL,
+      sample_data TEXT,
+      scope TEXT DEFAULT 'system' NOT NULL,
+      icon TEXT,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_user_table_templates_category ON user_table_templates(category);
+    CREATE INDEX IF NOT EXISTS idx_user_table_templates_scope ON user_table_templates(scope);
+
+    CREATE TABLE IF NOT EXISTS user_table_imports (
+      id TEXT PRIMARY KEY NOT NULL,
+      table_id TEXT NOT NULL,
+      document_id TEXT,
+      row_count INTEGER DEFAULT 0 NOT NULL,
+      error_count INTEGER DEFAULT 0 NOT NULL,
+      errors TEXT,
+      status TEXT DEFAULT 'pending' NOT NULL,
+      created_at INTEGER NOT NULL,
+      FOREIGN KEY (table_id) REFERENCES user_tables(id) ON UPDATE NO ACTION ON DELETE NO ACTION,
+      FOREIGN KEY (document_id) REFERENCES documents(id) ON UPDATE NO ACTION ON DELETE NO ACTION
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_user_table_imports_table_id ON user_table_imports(table_id);
+
+    CREATE TABLE IF NOT EXISTS table_document_inputs (
+      id TEXT PRIMARY KEY NOT NULL,
+      table_id TEXT NOT NULL,
+      document_id TEXT NOT NULL,
+      created_at INTEGER NOT NULL,
+      FOREIGN KEY (table_id) REFERENCES user_tables(id) ON UPDATE NO ACTION ON DELETE NO ACTION,
+      FOREIGN KEY (document_id) REFERENCES documents(id) ON UPDATE NO ACTION ON DELETE NO ACTION
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_tdi_table ON table_document_inputs(table_id);
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_tdi_table_doc ON table_document_inputs(table_id, document_id);
+
+    CREATE TABLE IF NOT EXISTS task_table_inputs (
+      id TEXT PRIMARY KEY NOT NULL,
+      task_id TEXT NOT NULL,
+      table_id TEXT NOT NULL,
+      created_at INTEGER NOT NULL,
+      FOREIGN KEY (task_id) REFERENCES tasks(id) ON UPDATE NO ACTION ON DELETE NO ACTION,
+      FOREIGN KEY (table_id) REFERENCES user_tables(id) ON UPDATE NO ACTION ON DELETE NO ACTION
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_tti_task ON task_table_inputs(task_id);
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_tti_task_table ON task_table_inputs(task_id, table_id);
+
+    CREATE TABLE IF NOT EXISTS workflow_table_inputs (
+      id TEXT PRIMARY KEY NOT NULL,
+      workflow_id TEXT NOT NULL,
+      table_id TEXT NOT NULL,
+      step_id TEXT,
+      created_at INTEGER NOT NULL,
+      FOREIGN KEY (workflow_id) REFERENCES workflows(id) ON UPDATE NO ACTION ON DELETE NO ACTION,
+      FOREIGN KEY (table_id) REFERENCES user_tables(id) ON UPDATE NO ACTION ON DELETE NO ACTION
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_wti_workflow ON workflow_table_inputs(workflow_id);
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_wti_workflow_table_step ON workflow_table_inputs(workflow_id, table_id, step_id);
+
+    CREATE TABLE IF NOT EXISTS schedule_table_inputs (
+      id TEXT PRIMARY KEY NOT NULL,
+      schedule_id TEXT NOT NULL,
+      table_id TEXT NOT NULL,
+      created_at INTEGER NOT NULL,
+      FOREIGN KEY (schedule_id) REFERENCES schedules(id) ON UPDATE NO ACTION ON DELETE NO ACTION,
+      FOREIGN KEY (table_id) REFERENCES user_tables(id) ON UPDATE NO ACTION ON DELETE NO ACTION
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_sti_schedule ON schedule_table_inputs(schedule_id);
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_sti_schedule_table ON schedule_table_inputs(schedule_id, table_id);
+
+    CREATE TABLE IF NOT EXISTS user_table_triggers (
+      id TEXT PRIMARY KEY NOT NULL,
+      table_id TEXT NOT NULL,
+      name TEXT NOT NULL,
+      trigger_event TEXT NOT NULL,
+      condition TEXT,
+      action_type TEXT NOT NULL,
+      action_config TEXT NOT NULL,
+      status TEXT DEFAULT 'active' NOT NULL,
+      fire_count INTEGER DEFAULT 0 NOT NULL,
+      last_fired_at INTEGER,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL,
+      FOREIGN KEY (table_id) REFERENCES user_tables(id) ON UPDATE NO ACTION ON DELETE NO ACTION
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_user_table_triggers_table_id ON user_table_triggers(table_id);
+    CREATE INDEX IF NOT EXISTS idx_user_table_triggers_status ON user_table_triggers(status);
+
+    CREATE TABLE IF NOT EXISTS user_table_row_history (
+      id TEXT PRIMARY KEY NOT NULL,
+      row_id TEXT NOT NULL,
+      table_id TEXT NOT NULL,
+      previous_data TEXT NOT NULL,
+      changed_by TEXT DEFAULT 'user',
+      change_type TEXT NOT NULL,
+      created_at INTEGER NOT NULL,
+      FOREIGN KEY (table_id) REFERENCES user_tables(id) ON UPDATE NO ACTION ON DELETE NO ACTION
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_row_history_row_id ON user_table_row_history(row_id);
+    CREATE INDEX IF NOT EXISTS idx_row_history_table_id ON user_table_row_history(table_id);
+    CREATE INDEX IF NOT EXISTS idx_row_history_created_at ON user_table_row_history(created_at);
+
+    CREATE TABLE IF NOT EXISTS snapshots (
+      id TEXT PRIMARY KEY NOT NULL,
+      label TEXT NOT NULL,
+      type TEXT DEFAULT 'manual' NOT NULL,
+      status TEXT DEFAULT 'in_progress' NOT NULL,
+      file_path TEXT NOT NULL,
+      size_bytes INTEGER DEFAULT 0 NOT NULL,
+      db_size_bytes INTEGER DEFAULT 0 NOT NULL,
+      files_size_bytes INTEGER DEFAULT 0 NOT NULL,
+      file_count INTEGER DEFAULT 0 NOT NULL,
+      error TEXT,
+      created_at INTEGER NOT NULL
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_snapshots_type ON snapshots(type);
+    CREATE INDEX IF NOT EXISTS idx_snapshots_created_at ON snapshots(created_at);
+  `);
 }
 function hasLegacyStagentTables(sqlite2) {
   const placeholders = STAGENT_TABLES.map(() => "?").join(", ");

package/docs/.coverage-gaps.json

@@ -1,21 +1,71 @@
 {
-  "generated": "2026-03-31T21:00:00Z",
-  "totalFeatures": 31,
-  "coveredFeatures": 28,
-  "uncoveredFeatures": 3,
-  "coveragePercent": 90.3,
-  "gaps": {
-    "book-content-merge": {
-      "availableScreenshots": ["book-reader.png"],
-      "note": "Book reader screenshot exists but not referenced in any journey doc"
+  "generated": "2026-04-03T23:30:00Z",
+  "summary": {
+    "totalFeatures": 82,
+    "coveredFeatures": 78,
+    "gapCount": 4,
+    "unusedScreenshotCount": 0,
+    "brokenReferences": 0,
+    "orphanedImages": 14
+  },
+  "gaps": [
+    {
+      "feature": "book-content-merge",
+      "category": "Living Book",
+      "screenshots": ["book-list.png"],
+      "journeyCoverage": [],
+      "suggestedPersona": "personal",
+      "note": "Book reader captured but not referenced in any journey"
     },
-    "book-reading-paths": {
-      "availableScreenshots": ["book-reader.png", "book-chapter-nav.png"],
-      "note": "Book navigation screenshots exist but not referenced in any journey doc"
+    {
+      "feature": "book-reading-paths",
+      "category": "Living Book",
+      "screenshots": ["book-list.png"],
+      "journeyCoverage": [],
+      "suggestedPersona": "personal",
+      "note": "Book navigation not in any journey"
     },
-    "browser-tool-orchestration": {
-      "availableScreenshots": ["settings-browser-tools.png"],
-      "note": "Browser tools settings screenshot exists but not referenced in any journey doc"
+    {
+      "feature": "tables-document-import",
+      "category": "Structured Data",
+      "screenshots": [],
+      "journeyCoverage": ["work-use"],
+      "suggestedPersona": "work",
+      "note": "Import wizard not captured (no dedicated screenshot) but tables mentioned in Work journey"
+    },
+    {
+      "feature": "database-snapshot-backup",
+      "category": "Platform",
+      "screenshots": ["settings-snapshots.png"],
+      "journeyCoverage": [],
+      "suggestedPersona": "developer",
+      "note": "New feature - settings snapshot card captured, not yet in any journey"
     }
-  }
+  ],
+  "brokenReferences": [
+    { "file": "developer.md", "screenshot": "settings-ollama-connected.png", "status": "STALE", "note": "Old screenshot in public/readme/, not in current screengrabs/" },
+    { "file": "developer.md", "screenshot": "settings-channels-add-form.png", "status": "STALE", "note": "Old screenshot in public/readme/" },
+    { "file": "developer.md", "screenshot": "settings-channels-telegram-form.png", "status": "STALE", "note": "Old screenshot in public/readme/" },
+    { "file": "developer.md", "screenshot": "settings-channels-webhook-form.png", "status": "STALE", "note": "Old screenshot in public/readme/" },
+    { "file": "developer.md", "screenshot": "chat-conversation.png", "status": "STALE", "note": "Old screenshot in public/readme/" },
+    { "file": "developer.md", "screenshot": "schedules-detail.png", "status": "STALE", "note": "Old screenshot in public/readme/" },
+    { "file": "personal-use.md", "screenshot": "dashboard-card-detail.png", "status": "STALE", "note": "Old screenshot in public/readme/" },
+    { "file": "personal-use.md", "screenshot": "settings-channels.png", "status": "STALE", "note": "Old screenshot in public/readme/" },
+    { "file": "power-user.md", "screenshot": "settings-ollama-connected.png", "status": "STALE", "note": "Old screenshot in public/readme/" },
+    { "file": "power-user.md", "screenshot": "chat-model-selector.png", "status": "STALE", "note": "Old screenshot in public/readme/" },
+    { "file": "power-user.md", "screenshot": "schedules-detail.png", "status": "STALE", "note": "Old screenshot in public/readme/" },
+    { "file": "power-user.md", "screenshot": "chat-create-tab.png", "status": "STALE", "note": "Old screenshot in public/readme/" },
+    { "file": "work-use.md", "screenshot": "chat-conversation.png", "status": "STALE", "note": "Old screenshot in public/readme/" },
+    { "file": "work-use.md", "screenshot": "settings-channels.png", "status": "STALE", "note": "Old screenshot in public/readme/" }
+  ],
+  "orphanedImages": [
+    "book-chapter-header.png", "book-chapter-nav.png", "book-reader.png",
+    "book-settings.png", "book-toc.png", "book-try-it-now.png",
+    "chat-conversation.png", "chat-create-tab.png", "chat-model-selector.png",
+    "chat-quick-access.png", "dashboard-card-detail.png", "playbook-list.png",
+    "schedules-detail.png", "schedules-edit-form.png", "settings-browser-tools.png",
+    "settings-channels-add-form.png", "settings-channels-telegram-form.png",
+    "settings-channels-webhook-form.png", "settings-channels.png",
+    "settings-ollama-connected.png"
+  ]
 }

package/docs/.last-generated

@@ -1 +1 @@
-2026-04-01T05:15:01Z
+2026-04-03T23:43:05Z

package/docs/features/dashboard-kanban.md

@@ -5,31 +5,37 @@ section: "dashboard-kanban"
 route: "/dashboard"
 tags: [tasks, kanban, board, table, filter, create, ai-assist, drag-and-drop, bulk-operations, heartbeat]
 features: ["task-board", "kanban-board-operations", "micro-visualizations", "task-definition-ai", "detail-view-redesign", "ui-density-refinement", "heartbeat-scheduler"]
-screengrabCount: 5
-lastUpdated: "2026-03-31"
+screengrabCount: 7
+lastUpdated: "2026-04-03"
 ---
 
 # Dashboard Kanban
 
-The Dashboard is your primary task management surface. It presents all tasks as a Kanban board with drag-and-drop columns, or as a sortable table -- whichever fits your workflow. A powerful filter bar, AI-assisted task creation, bulk operations, and inline editing let you manage agent work without switching context.
+The Dashboard is your primary task management surface. It presents all tasks as a Kanban board with drag-and-drop columns, or as a sortable table -- whichever fits your workflow. A powerful filter bar, AI-assisted task creation, bulk operations, and inline editing let you manage agent work without switching context. The default seed data populates the board with business-relevant tasks across three personas -- product launch, content engine, and customer success -- giving you a realistic starting point to explore the interface.
 
 ## Screenshots
 
 ![Dashboard board view](../screengrabs/dashboard-list.png)
-*Kanban board with columns for Planned, Queued, Running, Completed, and Failed tasks*
+*Kanban board with columns for Planned, Queued, Running, Completed, and Failed tasks showing business-relevant tasks across product launch, content engine, and customer success personas*
+
+![Dashboard below the fold](../screengrabs/dashboard-below-fold.png)
+*Below-the-fold view of the kanban board with additional task cards and columns*
 
 ![Dashboard table view](../screengrabs/dashboard-table.png)
 *Table view with sortable columns for title, status, priority, project, and timestamps*
 
-![Task detail sheet](../screengrabs/dashboard-card-detail.png)
-*Task detail sheet showing task properties, description, and execution history*
-
 ![Task edit dialog](../screengrabs/dashboard-card-edit.png)
 *Task edit dialog for updating task details from the kanban board*
 
 ![Bulk select mode](../screengrabs/dashboard-bulk-select.png)
 *Kanban board in select mode with checked cards and bulk action toolbar*
 
+![Create task form empty](../screengrabs/dashboard-create-form-empty.png)
+*Empty task creation form with fields for title, description, project, priority, runtime, and agent profile*
+
+![Create task form filled](../screengrabs/dashboard-create-form-filled.png)
+*Task creation form filled with business-relevant task details and AI-assisted description*
+
 ## Key Features
 
 ### Kanban Board

package/docs/features/settings.md

@@ -4,9 +4,9 @@ category: "feature-reference"
 section: "settings"
 route: "/settings"
 tags: ["settings", "configuration", "auth", "runtime", "browser-tools", "permissions", "budget", "ollama", "channels"]
-features: ["session-management", "tool-permission-persistence", "tool-permission-presets", "browser-use", "spend-budget-guardrails", "settings-interactive-controls", "ollama-runtime-provider", "multi-channel-delivery", "bidirectional-channel-chat"]
-screengrabCount: 9
-lastUpdated: "2026-03-31"
+features: ["session-management", "tool-permission-persistence", "tool-permission-presets", "browser-use", "spend-budget-guardrails", "settings-interactive-controls", "ollama-runtime-provider", "multi-channel-delivery", "bidirectional-channel-chat", "database-snapshot-backup"]
+screengrabCount: 10
+lastUpdated: "2026-04-03"
 ---
 
 # Settings
@@ -42,6 +42,9 @@ The Settings page is the central configuration hub for Stagent. From a single sc
 ![Data management section with clear and populate options](../screengrabs/settings-data.png)
 *Data Management section for resetting or populating workspace data.*
 
+![Database Snapshots settings](../screengrabs/settings-snapshots.png)
+*Database Snapshots section with automatic backup configuration, retention settings, and snapshot list with restore/delete actions.*
+
 ## Key Features
 
 ### Authentication
@@ -122,6 +125,15 @@ Two operations for managing workspace content:
 - **Clear Data** -- removes tasks, logs, documents, schedules, and other workspace content. Settings and permissions are preserved.
 - **Populate Sample Data** -- seeds the workspace with example projects, tasks, and documents.
 
+### Database Snapshots
+
+Protect your workspace with automatic and manual database backups:
+
+- **Automatic backup** -- enable scheduled backups with a configurable cron interval (e.g., every 6 hours, daily). Snapshots are created in the background without interrupting your workflow.
+- **Retention settings** -- control how many snapshots to keep with a maximum count and a maximum age in weeks. Older snapshots beyond the retention limits are pruned automatically.
+- **Snapshot list** -- view all existing snapshots with timestamps and sizes. Each snapshot has **Restore** and **Delete** action buttons for quick management.
+- **Pre-restore safety snapshot** -- before restoring an older snapshot, Stagent automatically creates a safety snapshot of the current database state so you can roll back if needed.
+
 ## How To
 
 ### Connect Ollama for Local Models