@askexenow/exe-os 0.9.112 → 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 +54 -11
  3. package/dist/bin/agentic-reflection-backfill.js +29 -1
  4. package/dist/bin/agentic-semantic-label.js +29 -1
  5. package/dist/bin/backfill-conversations.js +53 -10
  6. package/dist/bin/backfill-responses.js +54 -11
  7. package/dist/bin/backfill-vectors.js +29 -1
  8. package/dist/bin/bulk-sync-postgres.js +55 -12
  9. package/dist/bin/cleanup-stale-review-tasks.js +75 -15
  10. package/dist/bin/cli.js +293 -76
  11. package/dist/bin/exe-agent-config.js +7 -1
  12. package/dist/bin/exe-agent.js +28 -2
  13. package/dist/bin/exe-assign.js +54 -11
  14. package/dist/bin/exe-boot.js +481 -147
  15. package/dist/bin/exe-call.js +45 -4
  16. package/dist/bin/exe-cloud.js +93 -15
  17. package/dist/bin/exe-dispatch.js +369 -24
  18. package/dist/bin/exe-doctor.js +53 -10
  19. package/dist/bin/exe-export-behaviors.js +54 -11
  20. package/dist/bin/exe-forget.js +54 -11
  21. package/dist/bin/exe-gateway.js +128 -23
  22. package/dist/bin/exe-heartbeat.js +75 -15
  23. package/dist/bin/exe-kill.js +54 -11
  24. package/dist/bin/exe-launch-agent.js +70 -12
  25. package/dist/bin/exe-new-employee.js +175 -7
  26. package/dist/bin/exe-pending-messages.js +75 -15
  27. package/dist/bin/exe-pending-notifications.js +75 -15
  28. package/dist/bin/exe-pending-reviews.js +75 -15
  29. package/dist/bin/exe-rename.js +54 -11
  30. package/dist/bin/exe-review.js +54 -11
  31. package/dist/bin/exe-search.js +54 -11
  32. package/dist/bin/exe-session-cleanup.js +491 -146
  33. package/dist/bin/exe-settings.js +10 -4
  34. package/dist/bin/exe-start-codex.js +524 -245
  35. package/dist/bin/exe-start-opencode.js +534 -165
  36. package/dist/bin/exe-status.js +75 -15
  37. package/dist/bin/exe-support.js +1 -1
  38. package/dist/bin/exe-team.js +54 -11
  39. package/dist/bin/git-sweep.js +369 -24
  40. package/dist/bin/graph-backfill.js +54 -11
  41. package/dist/bin/graph-export.js +54 -11
  42. package/dist/bin/install.js +62 -4
  43. package/dist/bin/intercom-check.js +491 -146
  44. package/dist/bin/pre-publish.js +13 -1
  45. package/dist/bin/scan-tasks.js +369 -24
  46. package/dist/bin/setup.js +91 -13
  47. package/dist/bin/shard-migrate.js +54 -11
  48. package/dist/bin/stack-update.js +1 -1
  49. package/dist/bin/update.js +3 -3
  50. package/dist/gateway/index.js +128 -23
  51. package/dist/hooks/bug-report-worker.js +128 -23
  52. package/dist/hooks/codex-stop-task-finalizer.js +512 -140
  53. package/dist/hooks/commit-complete.js +369 -24
  54. package/dist/hooks/error-recall.js +54 -11
  55. package/dist/hooks/ingest.js +4575 -252
  56. package/dist/hooks/instructions-loaded.js +54 -11
  57. package/dist/hooks/notification.js +54 -11
  58. package/dist/hooks/post-compact.js +75 -15
  59. package/dist/hooks/post-tool-combined.js +75 -15
  60. package/dist/hooks/pre-compact.js +449 -104
  61. package/dist/hooks/pre-tool-use.js +90 -15
  62. package/dist/hooks/prompt-submit.js +129 -24
  63. package/dist/hooks/session-end.js +451 -109
  64. package/dist/hooks/session-start.js +104 -16
  65. package/dist/hooks/stop.js +74 -14
  66. package/dist/hooks/subagent-stop.js +75 -15
  67. package/dist/hooks/summary-worker.js +73 -7
  68. package/dist/index.js +128 -23
  69. package/dist/lib/agent-config.js +16 -1
  70. package/dist/lib/cloud-sync.js +38 -1
  71. package/dist/lib/consolidation.js +16 -1
  72. package/dist/lib/database.js +16 -0
  73. package/dist/lib/db.js +16 -0
  74. package/dist/lib/device-registry.js +16 -0
  75. package/dist/lib/employee-templates.js +29 -3
  76. package/dist/lib/employees.js +16 -1
  77. package/dist/lib/exe-daemon.js +268 -42
  78. package/dist/lib/hybrid-search.js +54 -11
  79. package/dist/lib/license.js +3 -3
  80. package/dist/lib/messaging.js +21 -4
  81. package/dist/lib/schedules.js +29 -1
  82. package/dist/lib/skill-learning.js +458 -70
  83. package/dist/lib/status-brief.js +14 -1
  84. package/dist/lib/store.js +54 -11
  85. package/dist/lib/tasks.js +393 -91
  86. package/dist/lib/tmux-routing.js +316 -14
  87. package/dist/mcp/server.js +169 -30
  88. package/dist/mcp/tools/create-task.js +75 -13
  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 +390 -91
  93. package/dist/runtime/index.js +446 -101
  94. package/dist/tui/App.js +208 -54
  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).
@@ -3034,6 +3034,22 @@ async function ensureSchema() {
3034
3034
  } catch (e) {
3035
3035
  logCatchDebug("migration", e);
3036
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
+ }
3037
3053
  }
3038
3054
  async function disposeDatabase() {
3039
3055
  if (_walCheckpointTimer) {
@@ -3600,11 +3616,17 @@ var init_platform_procedures = __esm({
3600
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."
3601
3617
  },
3602
3618
  {
3603
- title: "Customer orchestration maturity \u2014 recommend, never trap",
3619
+ title: "Orchestration phase guidance \u2014 recommend, never trap",
3604
3620
  domain: "workflow",
3605
3621
  priority: "p1",
3606
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."
3607
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
+ },
3608
3630
  {
3609
3631
  title: "Single dispatch path \u2014 create_task only",
3610
3632
  domain: "workflow",
@@ -3638,6 +3660,12 @@ var init_platform_procedures = __esm({
3638
3660
  priority: "p0",
3639
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."
3640
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
+ },
3641
3669
  {
3642
3670
  title: "Customer patch triage \u2014 upstream bug vs customization",
3643
3671
  domain: "support",
@@ -3923,10 +3951,24 @@ function stableId(memoryId, type, content) {
3923
3951
  return createHash2("sha256").update(`${memoryId}:${type}:${content}`).digest("hex").slice(0, 32);
3924
3952
  }
3925
3953
  function cleanText(text) {
3926
- return text.replace(/```[\s\S]*?```/g, " ").replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
3927
- }
3928
- function splitSentences(text) {
3929
- 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;
3930
3972
  }
3931
3973
  function inferCardType(sentence, toolName) {
3932
3974
  const lower = sentence.toLowerCase();
@@ -3958,12 +4000,12 @@ function predicateFor(type) {
3958
4000
  }
3959
4001
  }
3960
4002
  function extractMemoryCards(row) {
3961
- const sentences = splitSentences(row.raw_text);
4003
+ const segments = splitSegments(row.raw_text);
3962
4004
  const cards = [];
3963
- for (const sentence of sentences) {
4005
+ for (const sentence of segments) {
3964
4006
  const type = inferCardType(sentence, row.tool_name);
3965
4007
  const subject = extractSubject(sentence, row.agent_id);
3966
- 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;
3967
4009
  cards.push({
3968
4010
  id: stableId(row.id, type, content),
3969
4011
  memory_id: row.id,
@@ -4059,13 +4101,14 @@ Source memory: ${String(row.source_ref ?? row.memory_id)}`,
4059
4101
  last_accessed: String(row.timestamp)
4060
4102
  }));
4061
4103
  }
4062
- var MAX_CARDS_PER_MEMORY, MAX_SENTENCE_CHARS;
4104
+ var MAX_CARDS_PER_MEMORY, MAX_SEGMENT_CHARS, MIN_SEGMENT_CHARS;
4063
4105
  var init_memory_cards = __esm({
4064
4106
  "src/lib/memory-cards.ts"() {
4065
4107
  "use strict";
4066
4108
  init_database();
4067
- MAX_CARDS_PER_MEMORY = 6;
4068
- MAX_SENTENCE_CHARS = 360;
4109
+ MAX_CARDS_PER_MEMORY = 8;
4110
+ MAX_SEGMENT_CHARS = 500;
4111
+ MIN_SEGMENT_CHARS = 20;
4069
4112
  }
4070
4113
  });
4071
4114
 
@@ -3034,6 +3034,22 @@ async function ensureSchema() {
3034
3034
  } catch (e) {
3035
3035
  logCatchDebug("migration", e);
3036
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
+ }
3037
3053
  }
3038
3054
  async function disposeDatabase() {
3039
3055
  if (_walCheckpointTimer) {
@@ -3600,11 +3616,17 @@ var init_platform_procedures = __esm({
3600
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."
3601
3617
  },
3602
3618
  {
3603
- title: "Customer orchestration maturity \u2014 recommend, never trap",
3619
+ title: "Orchestration phase guidance \u2014 recommend, never trap",
3604
3620
  domain: "workflow",
3605
3621
  priority: "p1",
3606
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."
3607
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
+ },
3608
3630
  {
3609
3631
  title: "Single dispatch path \u2014 create_task only",
3610
3632
  domain: "workflow",
@@ -3638,6 +3660,12 @@ var init_platform_procedures = __esm({
3638
3660
  priority: "p0",
3639
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."
3640
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
+ },
3641
3669
  {
3642
3670
  title: "Customer patch triage \u2014 upstream bug vs customization",
3643
3671
  domain: "support",
@@ -3034,6 +3034,22 @@ async function ensureSchema() {
3034
3034
  } catch (e) {
3035
3035
  logCatchDebug("migration", e);
3036
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
+ }
3037
3053
  }
3038
3054
  async function disposeDatabase() {
3039
3055
  if (_walCheckpointTimer) {
@@ -3600,11 +3616,17 @@ var init_platform_procedures = __esm({
3600
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."
3601
3617
  },
3602
3618
  {
3603
- title: "Customer orchestration maturity \u2014 recommend, never trap",
3619
+ title: "Orchestration phase guidance \u2014 recommend, never trap",
3604
3620
  domain: "workflow",
3605
3621
  priority: "p1",
3606
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."
3607
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
+ },
3608
3630
  {
3609
3631
  title: "Single dispatch path \u2014 create_task only",
3610
3632
  domain: "workflow",
@@ -3638,6 +3660,12 @@ var init_platform_procedures = __esm({
3638
3660
  priority: "p0",
3639
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."
3640
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
+ },
3641
3669
  {
3642
3670
  title: "Customer patch triage \u2014 upstream bug vs customization",
3643
3671
  domain: "support",
@@ -3174,6 +3174,22 @@ async function ensureSchema() {
3174
3174
  } catch (e) {
3175
3175
  logCatchDebug("migration", e);
3176
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
+ }
3177
3193
  }
3178
3194
  async function disposeDatabase() {
3179
3195
  if (_walCheckpointTimer) {
@@ -3740,11 +3756,17 @@ var init_platform_procedures = __esm({
3740
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."
3741
3757
  },
3742
3758
  {
3743
- title: "Customer orchestration maturity \u2014 recommend, never trap",
3759
+ title: "Orchestration phase guidance \u2014 recommend, never trap",
3744
3760
  domain: "workflow",
3745
3761
  priority: "p1",
3746
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."
3747
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
+ },
3748
3770
  {
3749
3771
  title: "Single dispatch path \u2014 create_task only",
3750
3772
  domain: "workflow",
@@ -3778,6 +3800,12 @@ var init_platform_procedures = __esm({
3778
3800
  priority: "p0",
3779
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."
3780
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
+ },
3781
3809
  {
3782
3810
  title: "Customer patch triage \u2014 upstream bug vs customization",
3783
3811
  domain: "support",
@@ -4063,10 +4091,24 @@ function stableId(memoryId, type, content) {
4063
4091
  return createHash2("sha256").update(`${memoryId}:${type}:${content}`).digest("hex").slice(0, 32);
4064
4092
  }
4065
4093
  function cleanText(text) {
4066
- 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;
4067
4100
  }
4068
- function splitSentences(text) {
4069
- 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;
4070
4112
  }
4071
4113
  function inferCardType(sentence, toolName) {
4072
4114
  const lower = sentence.toLowerCase();
@@ -4098,12 +4140,12 @@ function predicateFor(type) {
4098
4140
  }
4099
4141
  }
4100
4142
  function extractMemoryCards(row) {
4101
- const sentences = splitSentences(row.raw_text);
4143
+ const segments = splitSegments(row.raw_text);
4102
4144
  const cards = [];
4103
- for (const sentence of sentences) {
4145
+ for (const sentence of segments) {
4104
4146
  const type = inferCardType(sentence, row.tool_name);
4105
4147
  const subject = extractSubject(sentence, row.agent_id);
4106
- 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;
4107
4149
  cards.push({
4108
4150
  id: stableId(row.id, type, content),
4109
4151
  memory_id: row.id,
@@ -4199,13 +4241,14 @@ Source memory: ${String(row.source_ref ?? row.memory_id)}`,
4199
4241
  last_accessed: String(row.timestamp)
4200
4242
  }));
4201
4243
  }
4202
- var MAX_CARDS_PER_MEMORY, MAX_SENTENCE_CHARS;
4244
+ var MAX_CARDS_PER_MEMORY, MAX_SEGMENT_CHARS, MIN_SEGMENT_CHARS;
4203
4245
  var init_memory_cards = __esm({
4204
4246
  "src/lib/memory-cards.ts"() {
4205
4247
  "use strict";
4206
4248
  init_database();
4207
- MAX_CARDS_PER_MEMORY = 6;
4208
- MAX_SENTENCE_CHARS = 360;
4249
+ MAX_CARDS_PER_MEMORY = 8;
4250
+ MAX_SEGMENT_CHARS = 500;
4251
+ MIN_SEGMENT_CHARS = 20;
4209
4252
  }
4210
4253
  });
4211
4254
 
@@ -3174,6 +3174,22 @@ async function ensureSchema() {
3174
3174
  } catch (e) {
3175
3175
  logCatchDebug("migration", e);
3176
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
+ }
3177
3193
  }
3178
3194
  async function disposeDatabase() {
3179
3195
  if (_walCheckpointTimer) {
@@ -3740,11 +3756,17 @@ var init_platform_procedures = __esm({
3740
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."
3741
3757
  },
3742
3758
  {
3743
- title: "Customer orchestration maturity \u2014 recommend, never trap",
3759
+ title: "Orchestration phase guidance \u2014 recommend, never trap",
3744
3760
  domain: "workflow",
3745
3761
  priority: "p1",
3746
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."
3747
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
+ },
3748
3770
  {
3749
3771
  title: "Single dispatch path \u2014 create_task only",
3750
3772
  domain: "workflow",
@@ -3778,6 +3800,12 @@ var init_platform_procedures = __esm({
3778
3800
  priority: "p0",
3779
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."
3780
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
+ },
3781
3809
  {
3782
3810
  title: "Customer patch triage \u2014 upstream bug vs customization",
3783
3811
  domain: "support",
@@ -4063,10 +4091,24 @@ function stableId(memoryId, type, content) {
4063
4091
  return createHash2("sha256").update(`${memoryId}:${type}:${content}`).digest("hex").slice(0, 32);
4064
4092
  }
4065
4093
  function cleanText(text) {
4066
- return text.replace(/```[\s\S]*?```/g, " ").replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
4067
- }
4068
- function splitSentences(text) {
4069
- return cleanText(text).split(/(?<=[.!?])\s+|\n+/).map((s) => s.trim()).filter((s) => s.length >= 24 && s.length <= MAX_SENTENCE_CHARS);
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;
4100
+ }
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;
4070
4112
  }
4071
4113
  function inferCardType(sentence, toolName) {
4072
4114
  const lower = sentence.toLowerCase();
@@ -4098,12 +4140,12 @@ function predicateFor(type) {
4098
4140
  }
4099
4141
  }
4100
4142
  function extractMemoryCards(row) {
4101
- const sentences = splitSentences(row.raw_text);
4143
+ const segments = splitSegments(row.raw_text);
4102
4144
  const cards = [];
4103
- for (const sentence of sentences) {
4145
+ for (const sentence of segments) {
4104
4146
  const type = inferCardType(sentence, row.tool_name);
4105
4147
  const subject = extractSubject(sentence, row.agent_id);
4106
- 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;
4107
4149
  cards.push({
4108
4150
  id: stableId(row.id, type, content),
4109
4151
  memory_id: row.id,
@@ -4199,13 +4241,14 @@ Source memory: ${String(row.source_ref ?? row.memory_id)}`,
4199
4241
  last_accessed: String(row.timestamp)
4200
4242
  }));
4201
4243
  }
4202
- var MAX_CARDS_PER_MEMORY, MAX_SENTENCE_CHARS;
4244
+ var MAX_CARDS_PER_MEMORY, MAX_SEGMENT_CHARS, MIN_SEGMENT_CHARS;
4203
4245
  var init_memory_cards = __esm({
4204
4246
  "src/lib/memory-cards.ts"() {
4205
4247
  "use strict";
4206
4248
  init_database();
4207
- MAX_CARDS_PER_MEMORY = 6;
4208
- MAX_SENTENCE_CHARS = 360;
4249
+ MAX_CARDS_PER_MEMORY = 8;
4250
+ MAX_SEGMENT_CHARS = 500;
4251
+ MIN_SEGMENT_CHARS = 20;
4209
4252
  }
4210
4253
  });
4211
4254
 
@@ -3170,6 +3170,22 @@ async function ensureSchema() {
3170
3170
  } catch (e) {
3171
3171
  logCatchDebug("migration", e);
3172
3172
  }
3173
+ try {
3174
+ await client.execute({
3175
+ sql: `ALTER TABLE memories ADD COLUMN visibility TEXT DEFAULT 'private'`,
3176
+ args: []
3177
+ });
3178
+ } catch (e) {
3179
+ logCatchDebug("migration", e);
3180
+ }
3181
+ try {
3182
+ await client.execute({
3183
+ sql: `ALTER TABLE memories ADD COLUMN strength REAL DEFAULT 1.0`,
3184
+ args: []
3185
+ });
3186
+ } catch (e) {
3187
+ logCatchDebug("migration", e);
3188
+ }
3173
3189
  }
3174
3190
  async function disposeDatabase() {
3175
3191
  if (_walCheckpointTimer) {
@@ -3736,11 +3752,17 @@ var init_platform_procedures = __esm({
3736
3752
  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."
3737
3753
  },
3738
3754
  {
3739
- title: "Customer orchestration maturity \u2014 recommend, never trap",
3755
+ title: "Orchestration phase guidance \u2014 recommend, never trap",
3740
3756
  domain: "workflow",
3741
3757
  priority: "p1",
3742
3758
  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."
3743
3759
  },
3760
+ {
3761
+ title: "Routing slot vs display title \u2014 internal 'coo' is plumbing, not your name",
3762
+ domain: "identity",
3763
+ priority: "p0",
3764
+ 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."
3765
+ },
3744
3766
  {
3745
3767
  title: "Single dispatch path \u2014 create_task only",
3746
3768
  domain: "workflow",
@@ -3774,6 +3796,12 @@ var init_platform_procedures = __esm({
3774
3796
  priority: "p0",
3775
3797
  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."
3776
3798
  },
3799
+ {
3800
+ title: "Destructive operations \u2014 mandatory reviewer gate",
3801
+ domain: "security",
3802
+ priority: "p0",
3803
+ 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."
3804
+ },
3777
3805
  {
3778
3806
  title: "Customer patch triage \u2014 upstream bug vs customization",
3779
3807
  domain: "support",