@askexenow/exe-os 0.9.111 → 0.9.113

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (95) hide show
  1. package/README.md +9 -7
  2. package/dist/bin/agentic-ontology-backfill.js +62 -12
  3. package/dist/bin/agentic-reflection-backfill.js +37 -2
  4. package/dist/bin/agentic-semantic-label.js +37 -2
  5. package/dist/bin/backfill-conversations.js +61 -11
  6. package/dist/bin/backfill-responses.js +62 -12
  7. package/dist/bin/backfill-vectors.js +37 -2
  8. package/dist/bin/bulk-sync-postgres.js +63 -13
  9. package/dist/bin/cleanup-stale-review-tasks.js +83 -16
  10. package/dist/bin/cli.js +312 -80
  11. package/dist/bin/exe-agent-config.js +7 -1
  12. package/dist/bin/exe-agent.js +29 -3
  13. package/dist/bin/exe-assign.js +62 -12
  14. package/dist/bin/exe-boot.js +500 -151
  15. package/dist/bin/exe-call.js +46 -5
  16. package/dist/bin/exe-cloud.js +101 -16
  17. package/dist/bin/exe-dispatch.js +827 -27
  18. package/dist/bin/exe-doctor.js +61 -11
  19. package/dist/bin/exe-export-behaviors.js +67 -14
  20. package/dist/bin/exe-forget.js +62 -12
  21. package/dist/bin/exe-gateway.js +147 -27
  22. package/dist/bin/exe-heartbeat.js +83 -16
  23. package/dist/bin/exe-kill.js +62 -12
  24. package/dist/bin/exe-launch-agent.js +83 -15
  25. package/dist/bin/exe-new-employee.js +176 -8
  26. package/dist/bin/exe-pending-messages.js +83 -16
  27. package/dist/bin/exe-pending-notifications.js +83 -16
  28. package/dist/bin/exe-pending-reviews.js +83 -16
  29. package/dist/bin/exe-rename.js +62 -12
  30. package/dist/bin/exe-review.js +62 -12
  31. package/dist/bin/exe-search.js +62 -12
  32. package/dist/bin/exe-session-cleanup.js +949 -149
  33. package/dist/bin/exe-settings.js +10 -4
  34. package/dist/bin/exe-start-codex.js +537 -248
  35. package/dist/bin/exe-start-opencode.js +547 -168
  36. package/dist/bin/exe-status.js +83 -16
  37. package/dist/bin/exe-support.js +1 -1
  38. package/dist/bin/exe-team.js +62 -12
  39. package/dist/bin/git-sweep.js +827 -27
  40. package/dist/bin/graph-backfill.js +62 -12
  41. package/dist/bin/graph-export.js +62 -12
  42. package/dist/bin/install.js +62 -4
  43. package/dist/bin/intercom-check.js +949 -149
  44. package/dist/bin/pre-publish.js +14 -2
  45. package/dist/bin/scan-tasks.js +827 -27
  46. package/dist/bin/setup.js +99 -14
  47. package/dist/bin/shard-migrate.js +62 -12
  48. package/dist/bin/stack-update.js +1 -1
  49. package/dist/bin/update.js +3 -3
  50. package/dist/gateway/index.js +586 -26
  51. package/dist/hooks/bug-report-worker.js +586 -26
  52. package/dist/hooks/codex-stop-task-finalizer.js +977 -143
  53. package/dist/hooks/commit-complete.js +827 -27
  54. package/dist/hooks/error-recall.js +62 -12
  55. package/dist/hooks/ingest.js +4579 -249
  56. package/dist/hooks/instructions-loaded.js +62 -12
  57. package/dist/hooks/notification.js +62 -12
  58. package/dist/hooks/post-compact.js +83 -16
  59. package/dist/hooks/post-tool-combined.js +83 -16
  60. package/dist/hooks/pre-compact.js +907 -107
  61. package/dist/hooks/pre-tool-use.js +98 -16
  62. package/dist/hooks/prompt-submit.js +596 -30
  63. package/dist/hooks/session-end.js +909 -112
  64. package/dist/hooks/session-start.js +112 -17
  65. package/dist/hooks/stop.js +82 -15
  66. package/dist/hooks/subagent-stop.js +83 -16
  67. package/dist/hooks/summary-worker.js +81 -8
  68. package/dist/index.js +595 -29
  69. package/dist/lib/agent-config.js +16 -1
  70. package/dist/lib/cloud-sync.js +45 -1
  71. package/dist/lib/consolidation.js +16 -1
  72. package/dist/lib/database.js +23 -0
  73. package/dist/lib/db.js +23 -0
  74. package/dist/lib/device-registry.js +23 -0
  75. package/dist/lib/employee-templates.js +30 -4
  76. package/dist/lib/employees.js +16 -1
  77. package/dist/lib/exe-daemon.js +482 -52
  78. package/dist/lib/hybrid-search.js +62 -12
  79. package/dist/lib/license.js +3 -3
  80. package/dist/lib/messaging.js +21 -4
  81. package/dist/lib/schedules.js +37 -2
  82. package/dist/lib/skill-learning.js +910 -41
  83. package/dist/lib/status-brief.js +14 -1
  84. package/dist/lib/store.js +62 -12
  85. package/dist/lib/tasks.js +843 -93
  86. package/dist/lib/tmux-routing.js +766 -16
  87. package/dist/mcp/server.js +238 -41
  88. package/dist/mcp/tools/create-task.js +525 -15
  89. package/dist/mcp/tools/deactivate-behavior.js +33 -24
  90. package/dist/mcp/tools/list-tasks.js +21 -4
  91. package/dist/mcp/tools/send-message.js +21 -4
  92. package/dist/mcp/tools/update-task.js +840 -93
  93. package/dist/runtime/index.js +913 -107
  94. package/dist/tui/App.js +227 -58
  95. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Exe OS
2
2
 
3
- ![npm version](https://img.shields.io/npm/v/@askexenow/exe-os.svg) ![License: CC-BY-NC-4.0](https://img.shields.io/badge/license-CC--BY--NC--4.0-blue.svg) ![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg)
3
+ ![npm version](https://img.shields.io/npm/v/@askexenow/exe-os.svg) ![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue.svg) ![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg)
4
4
 
5
5
  **Hire the team you couldn't afford.** AI employee operating system with persistent memory, identity, and multi-agent orchestration.
6
6
 
@@ -51,9 +51,10 @@ Best for: managing multiple projects and employees.
51
51
  | Feature | What it does |
52
52
  |---------|-------------|
53
53
  | **Persistent memory** | Every interaction stored in encrypted SQLCipher + vector search. Searchable across sessions. |
54
- | **Three-layer cognition** | Identity (who you are) + Expertise (what you've learned) + Experience (what you remember) |
54
+ | **Four-layer cognition** | Company Procedures (org-wide rules) + Identity (who you are) + Expertise (what you've learned) + Experience (what you remember) |
55
55
  | **Multi-agent orchestration** | COO coordinates CTO, CMO, engineers. Parallel task execution via tmux. |
56
56
  | **Task system** | Create, assign, review, chain tasks. Auto-dispatch. Review pipeline with cascading approval. |
57
+ | **Company procedures** | Org-wide rules that every employee follows. Set once, cascades everywhere. |
57
58
  | **Identity injection** | Each employee gets a permanent identity doc. Claude Code's `--agent` flag replaces the default system prompt. |
58
59
  | **Skill learning** | Agents learn procedures from repeated patterns. Corrections become permanent behaviors. |
59
60
  | **Cloud sync** | End-to-end encrypted memory sync across devices. Your key, your data. |
@@ -80,6 +81,7 @@ You talk to your COO. Your COO delegates. Each employee has:
80
81
  - **Identity** — permanent role doc that defines who they are
81
82
  - **Task queue** — auto-chains through assigned work
82
83
  - **Behavioral expertise** — corrections accumulate as permanent rules
84
+ - **Company procedures** — org-wide rules that cascade to every employee
83
85
 
84
86
  ---
85
87
 
@@ -100,7 +102,7 @@ npm install -g @askexenow/exe-os
100
102
  # Run `wsl --install` in PowerShell first, then follow Linux steps inside WSL2
101
103
  ```
102
104
 
103
- Requires Node.js 22+ and tmux. See **[docs/install.md](docs/install.md)** for full platform-specific instructions and troubleshooting.
105
+ Requires Node.js 22+ and tmux. See **[docs/install.md](docs/install.md)** for full platform-specific instructions and **[docs/quickstart.md](docs/quickstart.md)** for the 5-minute getting started guide.
104
106
 
105
107
  ### 2. Run Setup
106
108
 
@@ -136,8 +138,8 @@ exe-os # launch the TUI dashboard
136
138
 
137
139
  | Plan | Price | Employees | Memories | Devices |
138
140
  |------|-------|-----------|----------|---------|
139
- | Free | $0 | 1 (COO) | 5,000 | 1 |
140
- | Solopreneur | $97/mo | 5 | 100,000 | 2 |
141
+ | Free | $0 | 1 (COO) | 50,000 | 1 |
142
+ | Solopreneur | $97/mo | 5 | 250,000 | 2 |
141
143
  | Company | $297/mo | 20 | 1,000,000 | 10 |
142
144
  | Agency | $497/mo | 100 | 10,000,000 | 50 |
143
145
  | Enterprise | Custom | Unlimited | Unlimited | Unlimited |
@@ -202,7 +204,7 @@ See [docs/Agency-Playbook.md](docs/Agency-Playbook.md) for multi-client VPS depl
202
204
  exe-os/
203
205
  src/
204
206
  lib/ # Core: memory, tasks, identity, behaviors, search, sync, encryption
205
- mcp/ # MCP server (20+ tools for Claude Code integration)
207
+ mcp/ # MCP server (100+ tools for Claude Code integration)
206
208
  adapters/ # Claude Code hooks (ingest, session-start, pre-tool-use, etc.)
207
209
  tui/ # Ink-based terminal dashboard (Mode 2)
208
210
  runtime/ # Agent loop, tool registry, permissions (Mode 2 standalone)
@@ -244,4 +246,4 @@ Full guide: **[docs/install.md](docs/install.md)**
244
246
 
245
247
  ## License
246
248
 
247
- CC-BY-NC-4.0 (non-commercial). Commercial licenses available at [askexe.com](https://askexe.com).
249
+ AGPL-3.0. Commercial licenses available at [askexe.com](https://askexe.com).
@@ -1811,6 +1811,13 @@ async function ensureSchema() {
1811
1811
  } catch (e) {
1812
1812
  logCatchDebug("migration", e);
1813
1813
  }
1814
+ for (const col of ["created_by_agent TEXT", "created_by_device TEXT", "source_session_id TEXT"]) {
1815
+ try {
1816
+ await client.execute({ sql: `ALTER TABLE behaviors ADD COLUMN ${col}`, args: [] });
1817
+ } catch (e) {
1818
+ logCatchDebug("migration", e);
1819
+ }
1820
+ }
1814
1821
  try {
1815
1822
  await client.execute({
1816
1823
  sql: `ALTER TABLE tasks ADD COLUMN blocked_by TEXT`,
@@ -3027,6 +3034,22 @@ async function ensureSchema() {
3027
3034
  } catch (e) {
3028
3035
  logCatchDebug("migration", e);
3029
3036
  }
3037
+ try {
3038
+ await client.execute({
3039
+ sql: `ALTER TABLE memories ADD COLUMN visibility TEXT DEFAULT 'private'`,
3040
+ args: []
3041
+ });
3042
+ } catch (e) {
3043
+ logCatchDebug("migration", e);
3044
+ }
3045
+ try {
3046
+ await client.execute({
3047
+ sql: `ALTER TABLE memories ADD COLUMN strength REAL DEFAULT 1.0`,
3048
+ args: []
3049
+ });
3050
+ } catch (e) {
3051
+ logCatchDebug("migration", e);
3052
+ }
3030
3053
  }
3031
3054
  async function disposeDatabase() {
3032
3055
  if (_walCheckpointTimer) {
@@ -3593,11 +3616,17 @@ var init_platform_procedures = __esm({
3593
3616
  content: "Founder -> coordinator (the executive agent, internally routed as 'COO') -> CTO/CMO. CTO -> engineers. CMO -> content production. Never skip levels: the coordinator does not bypass managers for specialist work. Specialists report to their manager. If you need cross-team info, use ask_team_memory \u2014 don't read other agents' task folders. Each level owns dispatch downward and review upward."
3594
3617
  },
3595
3618
  {
3596
- title: "Customer orchestration maturity \u2014 recommend, never trap",
3619
+ title: "Orchestration phase guidance \u2014 recommend, never trap",
3597
3620
  domain: "workflow",
3598
3621
  priority: "p1",
3599
3622
  content: "New customers start best in Phase 1: founder \u2194 coordinator/Chief of Staff, building company context. Suggest Phase 2 executives when domain work repeats; suggest Phase 3 parallel execution only when review/permission gates are ready. This is guidance, not a blocker: users may jump phases anytime. Never overwrite their phase, role titles, identities, or custom org design."
3600
3623
  },
3624
+ {
3625
+ title: "Routing slot vs display title \u2014 internal 'coo' is plumbing, not your name",
3626
+ domain: "identity",
3627
+ priority: "p0",
3628
+ content: "These procedures reference 'COO' as a shorthand for the coordinator role. This is an INTERNAL routing slot used by exe-os code (chain-of-command checks, dispatch logic, session detection). It is NOT your display title. Your actual title comes from your identity file's `title:` field \u2014 that is what you use externally: introductions, sign-offs, team comms, and any user-facing text. If your identity says `title: AI Chief of Staff`, you are the AI Chief of Staff. The routing slot stays `role: coo` for code compatibility \u2014 never rename it, but also never introduce yourself as 'COO' unless your identity file explicitly says so. The founder chose your title; respect it."
3629
+ },
3601
3630
  {
3602
3631
  title: "Single dispatch path \u2014 create_task only",
3603
3632
  domain: "workflow",
@@ -3631,6 +3660,12 @@ var init_platform_procedures = __esm({
3631
3660
  priority: "p0",
3632
3661
  content: "NEVER: (1) Access the database directly \u2014 it's SQLCipher encrypted, always fails. Use MCP tools only. (2) Manually spawn tmux sessions \u2014 create_task handles it. (3) Run git checkout main \u2014 agents work in worktrees. (4) Modify another agent's in-progress task. (5) Push to remote \u2014 the COO reviews and pushes. (6) Skip update_task(done) \u2014 it's the ONLY way your work gets reviewed. (7) Run git init."
3633
3662
  },
3663
+ {
3664
+ title: "Destructive operations \u2014 mandatory reviewer gate",
3665
+ domain: "security",
3666
+ priority: "p0",
3667
+ content: "Before ANY destructive operation (delete, remove, overwrite, drop, reset, force-push, truncate), you MUST: (1) Have your full task spec accessible \u2014 if you cannot read it, STOP and report to your reviewer. Never improvise destructive actions. (2) Confirm with your reviewer (assigned_by or COO) before executing. (3) If the task spec explicitly authorizes the operation, proceed \u2014 but log it. Violation = immediate task failure. This applies to ALL agents regardless of role."
3668
+ },
3634
3669
  {
3635
3670
  title: "Customer patch triage \u2014 upstream bug vs customization",
3636
3671
  domain: "support",
@@ -3782,7 +3817,7 @@ var init_platform_procedures = __esm({
3782
3817
  title: "MCP tool dispatch \u2014 all tools use action parameter",
3783
3818
  domain: "tool-use",
3784
3819
  priority: "p0",
3785
- content: 'exe-os MCP tools come in two surfaces depending on EXE_MCP_TOOL_SURFACE config. Consolidated (19 tools): action-based dispatch \u2014 memory(action="recall"), task(action="create"), etc. Legacy (108 tools): one tool per operation \u2014 recall_my_memory, create_task, etc. Both surfaces have identical functionality. Use whichever tool names are available in your session. If you see domain tools (memory, task, config, etc.), use the action parameter. If you see specific tools (recall_my_memory, create_task, etc.), call them directly.'
3820
+ content: 'exe-os MCP tools use consolidated action-based dispatch by default (19 tools). Call domain tools with an action parameter: memory(action="recall"), task(action="create"), config(action="list_employees"), etc. Legacy mode (108 separate tools like recall_my_memory, create_task) is still available via EXE_MCP_TOOL_SURFACE=legacy but will be removed in a future version. If you see specific tool names, call them directly \u2014 both surfaces are identical. Consolidated is the default and recommended surface.'
3786
3821
  },
3787
3822
  {
3788
3823
  title: "MCP tools \u2014 memory, decision, and search",
@@ -3916,10 +3951,24 @@ function stableId(memoryId, type, content) {
3916
3951
  return createHash2("sha256").update(`${memoryId}:${type}:${content}`).digest("hex").slice(0, 32);
3917
3952
  }
3918
3953
  function cleanText(text) {
3919
- return text.replace(/```[\s\S]*?```/g, " ").replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
3920
- }
3921
- function splitSentences(text) {
3922
- return cleanText(text).split(/(?<=[.!?])\s+|\n+/).map((s) => s.trim()).filter((s) => s.length >= 24 && s.length <= MAX_SENTENCE_CHARS);
3954
+ let cleaned = text.replace(
3955
+ /```(\w*)\n(.*?)(?:\n[\s\S]*?)```/g,
3956
+ (_m, lang, firstLine) => `[code${lang ? `:${lang}` : ""}] ${firstLine.trim()}`
3957
+ );
3958
+ cleaned = cleaned.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
3959
+ return cleaned;
3960
+ }
3961
+ function splitSegments(text) {
3962
+ const cleaned = cleanText(text);
3963
+ const segments = cleaned.split(/(?<=[.!?:;])\s+|\n{2,}|(?<=\))\s+(?=[A-Z])|\s*[|│]\s*/).map((s) => s.trim()).filter((s) => s.length >= MIN_SEGMENT_CHARS && s.length <= MAX_SEGMENT_CHARS);
3964
+ if (segments.length === 0 && cleaned.length >= MIN_SEGMENT_CHARS) {
3965
+ const lines = cleaned.split(/\n+/).map((l) => l.trim()).filter((l) => l.length >= MIN_SEGMENT_CHARS && l.length <= MAX_SEGMENT_CHARS);
3966
+ if (lines.length > 0) return lines;
3967
+ if (cleaned.length >= MIN_SEGMENT_CHARS) {
3968
+ return [cleaned.slice(0, MAX_SEGMENT_CHARS)];
3969
+ }
3970
+ }
3971
+ return segments;
3923
3972
  }
3924
3973
  function inferCardType(sentence, toolName) {
3925
3974
  const lower = sentence.toLowerCase();
@@ -3951,12 +4000,12 @@ function predicateFor(type) {
3951
4000
  }
3952
4001
  }
3953
4002
  function extractMemoryCards(row) {
3954
- const sentences = splitSentences(row.raw_text);
4003
+ const segments = splitSegments(row.raw_text);
3955
4004
  const cards = [];
3956
- for (const sentence of sentences) {
4005
+ for (const sentence of segments) {
3957
4006
  const type = inferCardType(sentence, row.tool_name);
3958
4007
  const subject = extractSubject(sentence, row.agent_id);
3959
- const content = sentence.length > MAX_SENTENCE_CHARS ? `${sentence.slice(0, MAX_SENTENCE_CHARS - 1)}\u2026` : sentence;
4008
+ const content = sentence.length > MAX_SEGMENT_CHARS ? `${sentence.slice(0, MAX_SEGMENT_CHARS - 1)}\u2026` : sentence;
3960
4009
  cards.push({
3961
4010
  id: stableId(row.id, type, content),
3962
4011
  memory_id: row.id,
@@ -4052,13 +4101,14 @@ Source memory: ${String(row.source_ref ?? row.memory_id)}`,
4052
4101
  last_accessed: String(row.timestamp)
4053
4102
  }));
4054
4103
  }
4055
- var MAX_CARDS_PER_MEMORY, MAX_SENTENCE_CHARS;
4104
+ var MAX_CARDS_PER_MEMORY, MAX_SEGMENT_CHARS, MIN_SEGMENT_CHARS;
4056
4105
  var init_memory_cards = __esm({
4057
4106
  "src/lib/memory-cards.ts"() {
4058
4107
  "use strict";
4059
4108
  init_database();
4060
- MAX_CARDS_PER_MEMORY = 6;
4061
- MAX_SENTENCE_CHARS = 360;
4109
+ MAX_CARDS_PER_MEMORY = 8;
4110
+ MAX_SEGMENT_CHARS = 500;
4111
+ MIN_SEGMENT_CHARS = 20;
4062
4112
  }
4063
4113
  });
4064
4114
 
@@ -1811,6 +1811,13 @@ async function ensureSchema() {
1811
1811
  } catch (e) {
1812
1812
  logCatchDebug("migration", e);
1813
1813
  }
1814
+ for (const col of ["created_by_agent TEXT", "created_by_device TEXT", "source_session_id TEXT"]) {
1815
+ try {
1816
+ await client.execute({ sql: `ALTER TABLE behaviors ADD COLUMN ${col}`, args: [] });
1817
+ } catch (e) {
1818
+ logCatchDebug("migration", e);
1819
+ }
1820
+ }
1814
1821
  try {
1815
1822
  await client.execute({
1816
1823
  sql: `ALTER TABLE tasks ADD COLUMN blocked_by TEXT`,
@@ -3027,6 +3034,22 @@ async function ensureSchema() {
3027
3034
  } catch (e) {
3028
3035
  logCatchDebug("migration", e);
3029
3036
  }
3037
+ try {
3038
+ await client.execute({
3039
+ sql: `ALTER TABLE memories ADD COLUMN visibility TEXT DEFAULT 'private'`,
3040
+ args: []
3041
+ });
3042
+ } catch (e) {
3043
+ logCatchDebug("migration", e);
3044
+ }
3045
+ try {
3046
+ await client.execute({
3047
+ sql: `ALTER TABLE memories ADD COLUMN strength REAL DEFAULT 1.0`,
3048
+ args: []
3049
+ });
3050
+ } catch (e) {
3051
+ logCatchDebug("migration", e);
3052
+ }
3030
3053
  }
3031
3054
  async function disposeDatabase() {
3032
3055
  if (_walCheckpointTimer) {
@@ -3593,11 +3616,17 @@ var init_platform_procedures = __esm({
3593
3616
  content: "Founder -> coordinator (the executive agent, internally routed as 'COO') -> CTO/CMO. CTO -> engineers. CMO -> content production. Never skip levels: the coordinator does not bypass managers for specialist work. Specialists report to their manager. If you need cross-team info, use ask_team_memory \u2014 don't read other agents' task folders. Each level owns dispatch downward and review upward."
3594
3617
  },
3595
3618
  {
3596
- title: "Customer orchestration maturity \u2014 recommend, never trap",
3619
+ title: "Orchestration phase guidance \u2014 recommend, never trap",
3597
3620
  domain: "workflow",
3598
3621
  priority: "p1",
3599
3622
  content: "New customers start best in Phase 1: founder \u2194 coordinator/Chief of Staff, building company context. Suggest Phase 2 executives when domain work repeats; suggest Phase 3 parallel execution only when review/permission gates are ready. This is guidance, not a blocker: users may jump phases anytime. Never overwrite their phase, role titles, identities, or custom org design."
3600
3623
  },
3624
+ {
3625
+ title: "Routing slot vs display title \u2014 internal 'coo' is plumbing, not your name",
3626
+ domain: "identity",
3627
+ priority: "p0",
3628
+ content: "These procedures reference 'COO' as a shorthand for the coordinator role. This is an INTERNAL routing slot used by exe-os code (chain-of-command checks, dispatch logic, session detection). It is NOT your display title. Your actual title comes from your identity file's `title:` field \u2014 that is what you use externally: introductions, sign-offs, team comms, and any user-facing text. If your identity says `title: AI Chief of Staff`, you are the AI Chief of Staff. The routing slot stays `role: coo` for code compatibility \u2014 never rename it, but also never introduce yourself as 'COO' unless your identity file explicitly says so. The founder chose your title; respect it."
3629
+ },
3601
3630
  {
3602
3631
  title: "Single dispatch path \u2014 create_task only",
3603
3632
  domain: "workflow",
@@ -3631,6 +3660,12 @@ var init_platform_procedures = __esm({
3631
3660
  priority: "p0",
3632
3661
  content: "NEVER: (1) Access the database directly \u2014 it's SQLCipher encrypted, always fails. Use MCP tools only. (2) Manually spawn tmux sessions \u2014 create_task handles it. (3) Run git checkout main \u2014 agents work in worktrees. (4) Modify another agent's in-progress task. (5) Push to remote \u2014 the COO reviews and pushes. (6) Skip update_task(done) \u2014 it's the ONLY way your work gets reviewed. (7) Run git init."
3633
3662
  },
3663
+ {
3664
+ title: "Destructive operations \u2014 mandatory reviewer gate",
3665
+ domain: "security",
3666
+ priority: "p0",
3667
+ content: "Before ANY destructive operation (delete, remove, overwrite, drop, reset, force-push, truncate), you MUST: (1) Have your full task spec accessible \u2014 if you cannot read it, STOP and report to your reviewer. Never improvise destructive actions. (2) Confirm with your reviewer (assigned_by or COO) before executing. (3) If the task spec explicitly authorizes the operation, proceed \u2014 but log it. Violation = immediate task failure. This applies to ALL agents regardless of role."
3668
+ },
3634
3669
  {
3635
3670
  title: "Customer patch triage \u2014 upstream bug vs customization",
3636
3671
  domain: "support",
@@ -3782,7 +3817,7 @@ var init_platform_procedures = __esm({
3782
3817
  title: "MCP tool dispatch \u2014 all tools use action parameter",
3783
3818
  domain: "tool-use",
3784
3819
  priority: "p0",
3785
- content: 'exe-os MCP tools come in two surfaces depending on EXE_MCP_TOOL_SURFACE config. Consolidated (19 tools): action-based dispatch \u2014 memory(action="recall"), task(action="create"), etc. Legacy (108 tools): one tool per operation \u2014 recall_my_memory, create_task, etc. Both surfaces have identical functionality. Use whichever tool names are available in your session. If you see domain tools (memory, task, config, etc.), use the action parameter. If you see specific tools (recall_my_memory, create_task, etc.), call them directly.'
3820
+ content: 'exe-os MCP tools use consolidated action-based dispatch by default (19 tools). Call domain tools with an action parameter: memory(action="recall"), task(action="create"), config(action="list_employees"), etc. Legacy mode (108 separate tools like recall_my_memory, create_task) is still available via EXE_MCP_TOOL_SURFACE=legacy but will be removed in a future version. If you see specific tool names, call them directly \u2014 both surfaces are identical. Consolidated is the default and recommended surface.'
3786
3821
  },
3787
3822
  {
3788
3823
  title: "MCP tools \u2014 memory, decision, and search",
@@ -1811,6 +1811,13 @@ async function ensureSchema() {
1811
1811
  } catch (e) {
1812
1812
  logCatchDebug("migration", e);
1813
1813
  }
1814
+ for (const col of ["created_by_agent TEXT", "created_by_device TEXT", "source_session_id TEXT"]) {
1815
+ try {
1816
+ await client.execute({ sql: `ALTER TABLE behaviors ADD COLUMN ${col}`, args: [] });
1817
+ } catch (e) {
1818
+ logCatchDebug("migration", e);
1819
+ }
1820
+ }
1814
1821
  try {
1815
1822
  await client.execute({
1816
1823
  sql: `ALTER TABLE tasks ADD COLUMN blocked_by TEXT`,
@@ -3027,6 +3034,22 @@ async function ensureSchema() {
3027
3034
  } catch (e) {
3028
3035
  logCatchDebug("migration", e);
3029
3036
  }
3037
+ try {
3038
+ await client.execute({
3039
+ sql: `ALTER TABLE memories ADD COLUMN visibility TEXT DEFAULT 'private'`,
3040
+ args: []
3041
+ });
3042
+ } catch (e) {
3043
+ logCatchDebug("migration", e);
3044
+ }
3045
+ try {
3046
+ await client.execute({
3047
+ sql: `ALTER TABLE memories ADD COLUMN strength REAL DEFAULT 1.0`,
3048
+ args: []
3049
+ });
3050
+ } catch (e) {
3051
+ logCatchDebug("migration", e);
3052
+ }
3030
3053
  }
3031
3054
  async function disposeDatabase() {
3032
3055
  if (_walCheckpointTimer) {
@@ -3593,11 +3616,17 @@ var init_platform_procedures = __esm({
3593
3616
  content: "Founder -> coordinator (the executive agent, internally routed as 'COO') -> CTO/CMO. CTO -> engineers. CMO -> content production. Never skip levels: the coordinator does not bypass managers for specialist work. Specialists report to their manager. If you need cross-team info, use ask_team_memory \u2014 don't read other agents' task folders. Each level owns dispatch downward and review upward."
3594
3617
  },
3595
3618
  {
3596
- title: "Customer orchestration maturity \u2014 recommend, never trap",
3619
+ title: "Orchestration phase guidance \u2014 recommend, never trap",
3597
3620
  domain: "workflow",
3598
3621
  priority: "p1",
3599
3622
  content: "New customers start best in Phase 1: founder \u2194 coordinator/Chief of Staff, building company context. Suggest Phase 2 executives when domain work repeats; suggest Phase 3 parallel execution only when review/permission gates are ready. This is guidance, not a blocker: users may jump phases anytime. Never overwrite their phase, role titles, identities, or custom org design."
3600
3623
  },
3624
+ {
3625
+ title: "Routing slot vs display title \u2014 internal 'coo' is plumbing, not your name",
3626
+ domain: "identity",
3627
+ priority: "p0",
3628
+ content: "These procedures reference 'COO' as a shorthand for the coordinator role. This is an INTERNAL routing slot used by exe-os code (chain-of-command checks, dispatch logic, session detection). It is NOT your display title. Your actual title comes from your identity file's `title:` field \u2014 that is what you use externally: introductions, sign-offs, team comms, and any user-facing text. If your identity says `title: AI Chief of Staff`, you are the AI Chief of Staff. The routing slot stays `role: coo` for code compatibility \u2014 never rename it, but also never introduce yourself as 'COO' unless your identity file explicitly says so. The founder chose your title; respect it."
3629
+ },
3601
3630
  {
3602
3631
  title: "Single dispatch path \u2014 create_task only",
3603
3632
  domain: "workflow",
@@ -3631,6 +3660,12 @@ var init_platform_procedures = __esm({
3631
3660
  priority: "p0",
3632
3661
  content: "NEVER: (1) Access the database directly \u2014 it's SQLCipher encrypted, always fails. Use MCP tools only. (2) Manually spawn tmux sessions \u2014 create_task handles it. (3) Run git checkout main \u2014 agents work in worktrees. (4) Modify another agent's in-progress task. (5) Push to remote \u2014 the COO reviews and pushes. (6) Skip update_task(done) \u2014 it's the ONLY way your work gets reviewed. (7) Run git init."
3633
3662
  },
3663
+ {
3664
+ title: "Destructive operations \u2014 mandatory reviewer gate",
3665
+ domain: "security",
3666
+ priority: "p0",
3667
+ content: "Before ANY destructive operation (delete, remove, overwrite, drop, reset, force-push, truncate), you MUST: (1) Have your full task spec accessible \u2014 if you cannot read it, STOP and report to your reviewer. Never improvise destructive actions. (2) Confirm with your reviewer (assigned_by or COO) before executing. (3) If the task spec explicitly authorizes the operation, proceed \u2014 but log it. Violation = immediate task failure. This applies to ALL agents regardless of role."
3668
+ },
3634
3669
  {
3635
3670
  title: "Customer patch triage \u2014 upstream bug vs customization",
3636
3671
  domain: "support",
@@ -3782,7 +3817,7 @@ var init_platform_procedures = __esm({
3782
3817
  title: "MCP tool dispatch \u2014 all tools use action parameter",
3783
3818
  domain: "tool-use",
3784
3819
  priority: "p0",
3785
- content: 'exe-os MCP tools come in two surfaces depending on EXE_MCP_TOOL_SURFACE config. Consolidated (19 tools): action-based dispatch \u2014 memory(action="recall"), task(action="create"), etc. Legacy (108 tools): one tool per operation \u2014 recall_my_memory, create_task, etc. Both surfaces have identical functionality. Use whichever tool names are available in your session. If you see domain tools (memory, task, config, etc.), use the action parameter. If you see specific tools (recall_my_memory, create_task, etc.), call them directly.'
3820
+ content: 'exe-os MCP tools use consolidated action-based dispatch by default (19 tools). Call domain tools with an action parameter: memory(action="recall"), task(action="create"), config(action="list_employees"), etc. Legacy mode (108 separate tools like recall_my_memory, create_task) is still available via EXE_MCP_TOOL_SURFACE=legacy but will be removed in a future version. If you see specific tool names, call them directly \u2014 both surfaces are identical. Consolidated is the default and recommended surface.'
3786
3821
  },
3787
3822
  {
3788
3823
  title: "MCP tools \u2014 memory, decision, and search",
@@ -1951,6 +1951,13 @@ async function ensureSchema() {
1951
1951
  } catch (e) {
1952
1952
  logCatchDebug("migration", e);
1953
1953
  }
1954
+ for (const col of ["created_by_agent TEXT", "created_by_device TEXT", "source_session_id TEXT"]) {
1955
+ try {
1956
+ await client.execute({ sql: `ALTER TABLE behaviors ADD COLUMN ${col}`, args: [] });
1957
+ } catch (e) {
1958
+ logCatchDebug("migration", e);
1959
+ }
1960
+ }
1954
1961
  try {
1955
1962
  await client.execute({
1956
1963
  sql: `ALTER TABLE tasks ADD COLUMN blocked_by TEXT`,
@@ -3167,6 +3174,22 @@ async function ensureSchema() {
3167
3174
  } catch (e) {
3168
3175
  logCatchDebug("migration", e);
3169
3176
  }
3177
+ try {
3178
+ await client.execute({
3179
+ sql: `ALTER TABLE memories ADD COLUMN visibility TEXT DEFAULT 'private'`,
3180
+ args: []
3181
+ });
3182
+ } catch (e) {
3183
+ logCatchDebug("migration", e);
3184
+ }
3185
+ try {
3186
+ await client.execute({
3187
+ sql: `ALTER TABLE memories ADD COLUMN strength REAL DEFAULT 1.0`,
3188
+ args: []
3189
+ });
3190
+ } catch (e) {
3191
+ logCatchDebug("migration", e);
3192
+ }
3170
3193
  }
3171
3194
  async function disposeDatabase() {
3172
3195
  if (_walCheckpointTimer) {
@@ -3733,11 +3756,17 @@ var init_platform_procedures = __esm({
3733
3756
  content: "Founder -> coordinator (the executive agent, internally routed as 'COO') -> CTO/CMO. CTO -> engineers. CMO -> content production. Never skip levels: the coordinator does not bypass managers for specialist work. Specialists report to their manager. If you need cross-team info, use ask_team_memory \u2014 don't read other agents' task folders. Each level owns dispatch downward and review upward."
3734
3757
  },
3735
3758
  {
3736
- title: "Customer orchestration maturity \u2014 recommend, never trap",
3759
+ title: "Orchestration phase guidance \u2014 recommend, never trap",
3737
3760
  domain: "workflow",
3738
3761
  priority: "p1",
3739
3762
  content: "New customers start best in Phase 1: founder \u2194 coordinator/Chief of Staff, building company context. Suggest Phase 2 executives when domain work repeats; suggest Phase 3 parallel execution only when review/permission gates are ready. This is guidance, not a blocker: users may jump phases anytime. Never overwrite their phase, role titles, identities, or custom org design."
3740
3763
  },
3764
+ {
3765
+ title: "Routing slot vs display title \u2014 internal 'coo' is plumbing, not your name",
3766
+ domain: "identity",
3767
+ priority: "p0",
3768
+ content: "These procedures reference 'COO' as a shorthand for the coordinator role. This is an INTERNAL routing slot used by exe-os code (chain-of-command checks, dispatch logic, session detection). It is NOT your display title. Your actual title comes from your identity file's `title:` field \u2014 that is what you use externally: introductions, sign-offs, team comms, and any user-facing text. If your identity says `title: AI Chief of Staff`, you are the AI Chief of Staff. The routing slot stays `role: coo` for code compatibility \u2014 never rename it, but also never introduce yourself as 'COO' unless your identity file explicitly says so. The founder chose your title; respect it."
3769
+ },
3741
3770
  {
3742
3771
  title: "Single dispatch path \u2014 create_task only",
3743
3772
  domain: "workflow",
@@ -3771,6 +3800,12 @@ var init_platform_procedures = __esm({
3771
3800
  priority: "p0",
3772
3801
  content: "NEVER: (1) Access the database directly \u2014 it's SQLCipher encrypted, always fails. Use MCP tools only. (2) Manually spawn tmux sessions \u2014 create_task handles it. (3) Run git checkout main \u2014 agents work in worktrees. (4) Modify another agent's in-progress task. (5) Push to remote \u2014 the COO reviews and pushes. (6) Skip update_task(done) \u2014 it's the ONLY way your work gets reviewed. (7) Run git init."
3773
3802
  },
3803
+ {
3804
+ title: "Destructive operations \u2014 mandatory reviewer gate",
3805
+ domain: "security",
3806
+ priority: "p0",
3807
+ content: "Before ANY destructive operation (delete, remove, overwrite, drop, reset, force-push, truncate), you MUST: (1) Have your full task spec accessible \u2014 if you cannot read it, STOP and report to your reviewer. Never improvise destructive actions. (2) Confirm with your reviewer (assigned_by or COO) before executing. (3) If the task spec explicitly authorizes the operation, proceed \u2014 but log it. Violation = immediate task failure. This applies to ALL agents regardless of role."
3808
+ },
3774
3809
  {
3775
3810
  title: "Customer patch triage \u2014 upstream bug vs customization",
3776
3811
  domain: "support",
@@ -3922,7 +3957,7 @@ var init_platform_procedures = __esm({
3922
3957
  title: "MCP tool dispatch \u2014 all tools use action parameter",
3923
3958
  domain: "tool-use",
3924
3959
  priority: "p0",
3925
- content: 'exe-os MCP tools come in two surfaces depending on EXE_MCP_TOOL_SURFACE config. Consolidated (19 tools): action-based dispatch \u2014 memory(action="recall"), task(action="create"), etc. Legacy (108 tools): one tool per operation \u2014 recall_my_memory, create_task, etc. Both surfaces have identical functionality. Use whichever tool names are available in your session. If you see domain tools (memory, task, config, etc.), use the action parameter. If you see specific tools (recall_my_memory, create_task, etc.), call them directly.'
3960
+ content: 'exe-os MCP tools use consolidated action-based dispatch by default (19 tools). Call domain tools with an action parameter: memory(action="recall"), task(action="create"), config(action="list_employees"), etc. Legacy mode (108 separate tools like recall_my_memory, create_task) is still available via EXE_MCP_TOOL_SURFACE=legacy but will be removed in a future version. If you see specific tool names, call them directly \u2014 both surfaces are identical. Consolidated is the default and recommended surface.'
3926
3961
  },
3927
3962
  {
3928
3963
  title: "MCP tools \u2014 memory, decision, and search",
@@ -4056,10 +4091,24 @@ function stableId(memoryId, type, content) {
4056
4091
  return createHash2("sha256").update(`${memoryId}:${type}:${content}`).digest("hex").slice(0, 32);
4057
4092
  }
4058
4093
  function cleanText(text) {
4059
- return text.replace(/```[\s\S]*?```/g, " ").replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
4094
+ let cleaned = text.replace(
4095
+ /```(\w*)\n(.*?)(?:\n[\s\S]*?)```/g,
4096
+ (_m, lang, firstLine) => `[code${lang ? `:${lang}` : ""}] ${firstLine.trim()}`
4097
+ );
4098
+ cleaned = cleaned.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
4099
+ return cleaned;
4060
4100
  }
4061
- function splitSentences(text) {
4062
- return cleanText(text).split(/(?<=[.!?])\s+|\n+/).map((s) => s.trim()).filter((s) => s.length >= 24 && s.length <= MAX_SENTENCE_CHARS);
4101
+ function splitSegments(text) {
4102
+ const cleaned = cleanText(text);
4103
+ const segments = cleaned.split(/(?<=[.!?:;])\s+|\n{2,}|(?<=\))\s+(?=[A-Z])|\s*[|│]\s*/).map((s) => s.trim()).filter((s) => s.length >= MIN_SEGMENT_CHARS && s.length <= MAX_SEGMENT_CHARS);
4104
+ if (segments.length === 0 && cleaned.length >= MIN_SEGMENT_CHARS) {
4105
+ const lines = cleaned.split(/\n+/).map((l) => l.trim()).filter((l) => l.length >= MIN_SEGMENT_CHARS && l.length <= MAX_SEGMENT_CHARS);
4106
+ if (lines.length > 0) return lines;
4107
+ if (cleaned.length >= MIN_SEGMENT_CHARS) {
4108
+ return [cleaned.slice(0, MAX_SEGMENT_CHARS)];
4109
+ }
4110
+ }
4111
+ return segments;
4063
4112
  }
4064
4113
  function inferCardType(sentence, toolName) {
4065
4114
  const lower = sentence.toLowerCase();
@@ -4091,12 +4140,12 @@ function predicateFor(type) {
4091
4140
  }
4092
4141
  }
4093
4142
  function extractMemoryCards(row) {
4094
- const sentences = splitSentences(row.raw_text);
4143
+ const segments = splitSegments(row.raw_text);
4095
4144
  const cards = [];
4096
- for (const sentence of sentences) {
4145
+ for (const sentence of segments) {
4097
4146
  const type = inferCardType(sentence, row.tool_name);
4098
4147
  const subject = extractSubject(sentence, row.agent_id);
4099
- const content = sentence.length > MAX_SENTENCE_CHARS ? `${sentence.slice(0, MAX_SENTENCE_CHARS - 1)}\u2026` : sentence;
4148
+ const content = sentence.length > MAX_SEGMENT_CHARS ? `${sentence.slice(0, MAX_SEGMENT_CHARS - 1)}\u2026` : sentence;
4100
4149
  cards.push({
4101
4150
  id: stableId(row.id, type, content),
4102
4151
  memory_id: row.id,
@@ -4192,13 +4241,14 @@ Source memory: ${String(row.source_ref ?? row.memory_id)}`,
4192
4241
  last_accessed: String(row.timestamp)
4193
4242
  }));
4194
4243
  }
4195
- var MAX_CARDS_PER_MEMORY, MAX_SENTENCE_CHARS;
4244
+ var MAX_CARDS_PER_MEMORY, MAX_SEGMENT_CHARS, MIN_SEGMENT_CHARS;
4196
4245
  var init_memory_cards = __esm({
4197
4246
  "src/lib/memory-cards.ts"() {
4198
4247
  "use strict";
4199
4248
  init_database();
4200
- MAX_CARDS_PER_MEMORY = 6;
4201
- MAX_SENTENCE_CHARS = 360;
4249
+ MAX_CARDS_PER_MEMORY = 8;
4250
+ MAX_SEGMENT_CHARS = 500;
4251
+ MIN_SEGMENT_CHARS = 20;
4202
4252
  }
4203
4253
  });
4204
4254