@wrongstack/core 0.300.0 → 0.301.0

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 (144) hide show
  1. package/dist/chronicle/index.d.ts +2 -0
  2. package/dist/chronicle/index.js +297 -10
  3. package/dist/chronicle/project-server.js +253 -15
  4. package/dist/chronicle/sqlite-compaction.d.ts +20 -0
  5. package/dist/chronicle/sqlite-journal.d.ts +57 -0
  6. package/dist/coordination/agents/capability-manifest.d.ts +7 -0
  7. package/dist/coordination/agents/index.d.ts +3 -2
  8. package/dist/coordination/agents/index.js +818 -570
  9. package/dist/coordination/agents/project-agent-identity.d.ts +6 -6
  10. package/dist/coordination/agents/role-skills.d.ts +1 -1
  11. package/dist/coordination/agents/types.d.ts +6 -0
  12. package/dist/coordination/director.d.ts +2 -2
  13. package/dist/coordination/index.js +6778 -6438
  14. package/dist/coordination/mail-tools.d.ts +3 -3
  15. package/dist/coordination/mailbox-project-server.js +3 -4
  16. package/dist/coordination/mailbox-types.d.ts +6 -0
  17. package/dist/core/agent-response.d.ts +5 -1
  18. package/dist/core/agent-tools.d.ts +3 -0
  19. package/dist/core/context.d.ts +20 -0
  20. package/dist/core/index.d.ts +8 -7
  21. package/dist/core/index.js +893 -284
  22. package/dist/core/instruction-template.d.ts +6 -3
  23. package/dist/core/next-steps-slot.d.ts +88 -0
  24. package/dist/core/system-prompt-builder.d.ts +5 -3
  25. package/dist/core/system-prompt-memory-skills.d.ts +1 -0
  26. package/dist/core/system-prompt-skill-bodies.d.ts +3 -3
  27. package/dist/defaults/index.js +9796 -8897
  28. package/dist/design/index.js +11 -3
  29. package/dist/execution/auto-compaction-middleware.d.ts +17 -0
  30. package/dist/execution/autonomy-brain.d.ts +8 -2
  31. package/dist/execution/brain-runtime.d.ts +3 -1
  32. package/dist/execution/compaction-core.d.ts +41 -2
  33. package/dist/execution/council-brain.d.ts +37 -2
  34. package/dist/execution/council-orchestrator.d.ts +2 -2
  35. package/dist/execution/index.d.ts +11 -10
  36. package/dist/execution/index.js +5178 -4077
  37. package/dist/execution/tool-executor.d.ts +4 -1
  38. package/dist/execution/topic-shift-advisor.d.ts +53 -0
  39. package/dist/extension/index.js +8 -2
  40. package/dist/extension/registry.d.ts +8 -1
  41. package/dist/goal/index.js +11 -3
  42. package/dist/hooks/index.js +42 -9
  43. package/dist/hooks/runner.d.ts +12 -1
  44. package/dist/hq/index.js +41 -17
  45. package/dist/hq/publisher.d.ts +21 -3
  46. package/dist/index.d.ts +21 -20
  47. package/dist/index.js +10887 -8053
  48. package/dist/infrastructure/index.js +108 -21
  49. package/dist/kernel/events/session-events.d.ts +13 -0
  50. package/dist/kernel/events/tool-events.d.ts +3 -3
  51. package/dist/models/index.d.ts +1 -0
  52. package/dist/models/index.js +17 -0
  53. package/dist/models/provider-credentials.d.ts +54 -0
  54. package/dist/plugin/index.d.ts +1 -0
  55. package/dist/plugin/index.js +2024 -502
  56. package/dist/plugins/auto-review-plugin.d.ts +3 -0
  57. package/dist/plugins/cloud-config-sync-plugin.d.ts +22 -0
  58. package/dist/plugins/review-claim-registry.d.ts +23 -8
  59. package/dist/plugins/review-types.d.ts +2 -0
  60. package/dist/registry/index.js +109 -74
  61. package/dist/registry/tool-registry.d.ts +15 -0
  62. package/dist/security/capabilities.d.ts +2 -0
  63. package/dist/security/index.d.ts +1 -1
  64. package/dist/security/index.js +9 -2
  65. package/dist/security/readonly-permission-policy.d.ts +20 -0
  66. package/dist/session-registry-atomic-file.d.ts +32 -5
  67. package/dist/skills/frontmatter.d.ts +6 -0
  68. package/dist/skills/index.js +22 -5
  69. package/dist/storage/cloud-config-sync/sanitize.d.ts +54 -0
  70. package/dist/storage/cloud-config-sync.d.ts +87 -0
  71. package/dist/storage/index.d.ts +1 -0
  72. package/dist/storage/index.js +854 -66
  73. package/dist/tools/index.d.ts +1 -1
  74. package/dist/tools/index.js +511 -234
  75. package/dist/tools/one-shot-llm-tool.d.ts +1 -0
  76. package/dist/tools/plugin-manager.d.ts +27 -0
  77. package/dist/types/config/mcp-features.d.ts +18 -11
  78. package/dist/types/config/root.d.ts +8 -1
  79. package/dist/types/config/runtime.d.ts +20 -6
  80. package/dist/types/config/skills-fleet-brain.d.ts +12 -4
  81. package/dist/types/config/tools.d.ts +16 -0
  82. package/dist/types/context-window.d.ts +1 -0
  83. package/dist/types/hooks.d.ts +14 -0
  84. package/dist/types/index.d.ts +2 -2
  85. package/dist/types/index.js +1 -0
  86. package/dist/types/multi-agent.d.ts +2 -0
  87. package/dist/types/one-shot-llm.d.ts +16 -0
  88. package/dist/types/provider.d.ts +16 -0
  89. package/dist/types/runtime-capability-manifest.d.ts +168 -0
  90. package/dist/types/skill.d.ts +5 -0
  91. package/dist/types/system-prompt.d.ts +3 -1
  92. package/dist/types/tool-executor.d.ts +8 -1
  93. package/dist/utils/context-breakdown.d.ts +8 -2
  94. package/dist/utils/index.d.ts +1 -1
  95. package/dist/utils/index.js +141 -31
  96. package/dist/utils/regex-guard.d.ts +16 -2
  97. package/dist/utils/sage-output-block.d.ts +7 -10
  98. package/dist/utils/wstack-paths.d.ts +11 -3
  99. package/instructions/agents/browser.md +1 -4
  100. package/instructions/agents/e2e.md +17 -15
  101. package/instructions/agents/ios.md +3 -3
  102. package/instructions/agents/search.md +1 -1
  103. package/instructions/autonomy/goal-preamble.md +4 -4
  104. package/instructions/coordination/director-preamble.md +2 -3
  105. package/instructions/coordination/subagent-baseline.md +3 -1
  106. package/instructions/leader-after-task.md +12 -0
  107. package/instructions/llm/chimera-review.md +1 -1
  108. package/instructions/modes/audit-lite.md +1 -1
  109. package/instructions/sections/tool/common-patterns.md +18 -2
  110. package/instructions/sections/tool/mailbox-compact.md +1 -1
  111. package/instructions/sections/tool/mailbox-full.md +1 -1
  112. package/instructions/system-lite.md +10 -0
  113. package/instructions/system-pro.md +23 -14
  114. package/instructions/system.md +22 -13
  115. package/package.json +3 -3
  116. package/skills/api-design/SKILL.md +3 -0
  117. package/skills/audit-log/SKILL.md +2 -0
  118. package/skills/auto-review/SKILL.md +6 -1
  119. package/skills/bug-hunter/SKILL.md +4 -1
  120. package/skills/chimera/SKILL.md +3 -0
  121. package/skills/data-governance/SKILL.md +3 -0
  122. package/skills/design-system/SKILL.md +5 -2
  123. package/skills/docker-deploy/SKILL.md +2 -0
  124. package/skills/git-flow/SKILL.md +2 -0
  125. package/skills/mailbox-bridge/SKILL.md +3 -0
  126. package/skills/mnemosyne/SKILL.md +2 -0
  127. package/skills/multi-agent/SKILL.md +4 -1
  128. package/skills/node-modern/SKILL.md +4 -1
  129. package/skills/observability/SKILL.md +3 -0
  130. package/skills/output-standards/SKILL.md +2 -0
  131. package/skills/plugin-author/SKILL.md +4 -1
  132. package/skills/prompt-engineering/SKILL.md +3 -1
  133. package/skills/react-modern/SKILL.md +6 -3
  134. package/skills/refactor-planner/SKILL.md +2 -0
  135. package/skills/research-web/SKILL.md +3 -0
  136. package/skills/sdd/SKILL.md +3 -1
  137. package/skills/security-scanner/SKILL.md +3 -0
  138. package/skills/skill-creator/SKILL.md +2 -0
  139. package/skills/tech-stack/SKILL.md +3 -0
  140. package/skills/testing/SKILL.md +4 -1
  141. package/skills/typescript-strict/SKILL.md +4 -1
  142. package/skills/wrongstack-kanban/SKILL.md +6 -3
  143. package/skills/wrongstack-mailbox/SKILL.md +4 -1
  144. package/skills/wrongstack-mailbox-mcp/SKILL.md +10 -8
@@ -9,6 +9,9 @@ description: |
9
9
  "latest", "what's new in", "breaking changes", "find current",
10
10
  "web research", "search the web", "look up".
11
11
  version: 1.0.0
12
+ required-capabilities: [web.research]
13
+ required-tools: [context_manager, delegate, fetch, search]
14
+ optional-capabilities: [runtime.admin]
12
15
  ---
13
16
 
14
17
  # Research Web — WrongStack
@@ -5,6 +5,8 @@ description: |
5
5
  in WrongStack. Triggers: user says "/sdd", "spec", "specification", "task graph",
6
6
  "SDD", "acceptance criteria", or starts a new feature.
7
7
  version: 2.1.0
8
+ required-capabilities: [work.plan, filesystem.write]
9
+ required-tools: []
8
10
  ---
9
11
 
10
12
  # Spec-Driven Development — WrongStack
@@ -132,4 +134,4 @@ Stage shown in real-time. Pause stops after current iteration completes.
132
134
  - `refactor-planner` — when the spec reveals a multi-file refactor
133
135
  - `bug-hunter` — when a bugfix spec needs a root cause analysis section
134
136
  - `multi-agent` — for executing parallel task groups
135
- - `output-standards` — for standardized `<nextsteps>` formatting
137
+ - `output-standards` — for standardized `<nextsteps>` formatting
@@ -5,6 +5,9 @@ description: |
5
5
  in WrongStack. Triggers: user says "security", "vulnerability", "CVE", "secret",
6
6
  "injection", "XSS", "SQL injection", "audit security", "supply chain".
7
7
  version: 1.2.0
8
+ required-capabilities: [filesystem.read, code.inspect]
9
+ required-tools: []
10
+ optional-capabilities: [dependencies.manage]
8
11
  ---
9
12
 
10
13
  # Security Scanner — WrongStack
@@ -4,6 +4,8 @@ description: |
4
4
  Use this skill when the user wants to create a new AI skill in WrongStack.
5
5
  Triggers: user says "create a skill", "new skill", "add a skill", "skill definition".
6
6
  version: 1.2.0
7
+ required-capabilities: [filesystem.write, runtime.admin]
8
+ required-tools: [bash, skill]
7
9
  ---
8
10
 
9
11
  # Skill Creator — WrongStack
@@ -5,6 +5,9 @@ description: |
5
5
  or evaluating third-party libraries in WrongStack. Triggers: user says "dependency",
6
6
  "package version", "outdated", "npm audit", "deprecated package", "tech stack".
7
7
  version: 1.2.0
8
+ required-capabilities: [dependencies.manage]
9
+ required-tools: []
10
+ optional-capabilities: [web.research]
8
11
  ---
9
12
 
10
13
  # Tech Stack Validator — WrongStack (Language-Agnostic)
@@ -5,6 +5,9 @@ description: |
5
5
  Triggers: user says "test", "unit test", "integration test", "e2e", "mock",
6
6
  "vitest", "coverage", "assert", "expect", "test strategy", "write tests".
7
7
  version: 1.0.0
8
+ required-capabilities: [filesystem.read, verification.run]
9
+ required-tools: []
10
+ optional-capabilities: [execution.shell]
8
11
  ---
9
12
 
10
13
  # Testing — WrongStack
@@ -157,7 +160,7 @@ coverageThreshold: {
157
160
 
158
161
  ## WrongStack-specific test notes
159
162
 
160
- - **Subpath exports**: Some packages use `exports` field in `package.json` — tests must use the public entry point, not `dist/`.
163
+ - **Subpath exports**: Some packages define an `exports` field in `package.json` — tests must use the public entry point, not `dist/`.
161
164
  - **AbortSignal**: Any test involving timeouts must use `AbortSignal.timeout()` not `setTimeout`.
162
165
  - **pnpm workspaces**: Run `pnpm test` in the package root, or `pnpm -r test` for all packages.
163
166
  - **Vitest config**: Each package has its own `vitest.config.ts`.
@@ -5,6 +5,9 @@ description: |
5
5
  in WrongStack. Triggers: user mentions "TypeScript", "strict", "type error",
6
6
  "type safety", "narrowing", "branded type", "discriminated union", "noUncheckedIndexedAccess".
7
7
  version: 1.1.0
8
+ required-capabilities: [filesystem.read, filesystem.write]
9
+ required-tools: []
10
+ optional-capabilities: [verification.run]
8
11
  ---
9
12
 
10
13
  # TypeScript Strict Mode — WrongStack
@@ -237,4 +240,4 @@ console.log(name!.toUpperCase());
237
240
  - `node-modern` — for TypeScript + ESM patterns
238
241
  - `react-modern` — for React + TypeScript patterns
239
242
  - `bug-hunter` — for type-related bugs like unsafe casts
240
- - `output-standards` — for standardized `<nextsteps>` formatting
243
+ - `output-standards` — for standardized `<nextsteps>` formatting
@@ -10,6 +10,8 @@ triggers:
10
10
  - user says "kanban", "board", "task dispatch", "kanban queue"
11
11
  - working with the kanban tool or kanban_queue
12
12
  - managing project work through boards
13
+ required-capabilities: [work.plan]
14
+ required-tools: [kanban, kanban_queue]
13
15
  ---
14
16
 
15
17
  # WrongStack Kanban — Deterministic Enforcement Skill
@@ -67,12 +69,13 @@ The lifecycle guard enforces these mechanically. Do not attempt to bypass them.
67
69
  order, and creation time — not randomly. Do not attempt to influence dispatch
68
70
  order by shuffling tasks or boards.
69
71
 
70
- 2. **Claim before working.** Call `kanban_queue` or `claim_task` before starting
72
+ 2. **Claim before working.** Call `kanban_queue`, or call `kanban` with the
73
+ `claim_task` action, before starting
71
74
  work. Working on an unclaimed card means another agent may also be working on
72
75
  it.
73
76
 
74
- 3. **Heartbeat or lose the lease.** If you hold a lease, you must call
75
- `heartbeat_assignment` before it expires. Expired leases are recovered by the
77
+ 3. **Heartbeat or lose the lease.** If you hold a lease, you must call `kanban`
78
+ with the `heartbeat_assignment` action before it expires. Expired leases are recovered by the
76
79
  system and the task is reassigned.
77
80
 
78
81
  4. **Fence your writes.** Include `expectedLeaseId` in every `mark_assignment`
@@ -9,6 +9,9 @@ description: |
9
9
  fleet", "tell the wrongstack agents", "is anyone online in
10
10
  wrongstack", or "register me with wrongstack".
11
11
  version: 1.0.0
12
+ required-capabilities: []
13
+ required-tools: [mailbox]
14
+ optional-capabilities: [mcp.dynamic, web.research]
12
15
  ---
13
16
 
14
17
  # WrongStack Mailbox Client
@@ -658,7 +661,7 @@ await mb('/mailbox/send', {
658
661
  credential. If you must print the URL, redact the token (`[REDACTED]`).
659
662
  - **Don't reply to a broadcast with another broadcast.** Replies should
660
663
  target the original sender via `to: <their-id>`, with `replyTo` set.
661
- - **Don't use `control` messages.** They go through a different path in
664
+ - **Avoid `control` messages.** They go through a different path in
662
665
  the WrongStack agent loop and will likely be dropped on the floor by
663
666
  the recipient.
664
667
 
@@ -1,6 +1,8 @@
1
1
  ---
2
2
  name: wrongstack-mailbox-mcp
3
3
  description: Coordinate with WrongStack agents through the project-scoped Mailbox MCP server. Use when an external coding agent needs to inspect unread or incomplete messages, query conversation history, discover online agents, send direct/reply/broadcast/steer messages, acknowledge outcomes, maintain its presence, soft-delete or restore messages, watch for changes, or perform explicitly authorized Mailbox administration without reading Mailbox files or SQLite directly.
4
+ required-capabilities: [mcp.dynamic]
5
+ required-tools: [mcp_use]
4
6
  ---
5
7
 
6
8
  # WrongStack Mailbox MCP
@@ -34,11 +36,11 @@ heartbeat identity to `--actor`; tool arguments cannot impersonate another actor
34
36
 
35
37
  ## Coordinate
36
38
 
37
- 1. Call `mailbox_manage` with `register_self`. Include a stable name and role when known.
38
- 2. Call `mailbox_read` with `unread`, then `query`. Prefer `unreadBy` plus `incompleteOnly` when
39
+ 1. Call `mcp_use` for the remote `mailbox_manage` operation with `register_self`. Include a stable name and role when known.
40
+ 2. Call `mcp_use` for the remote `mailbox_read` operation with `unread`, then `query`. Prefer `unreadBy` plus `incompleteOnly` when
39
41
  looking for actionable work.
40
- 3. Use `mailbox_read` with `online_agents` before routing a time-sensitive direct message.
41
- 4. Use `mailbox_manage` with `send`. Set an explicit recipient and message type:
42
+ 3. Call `mcp_use` for remote `mailbox_read` with `online_agents` before routing a time-sensitive direct message.
43
+ 4. Call `mcp_use` for remote `mailbox_manage` with `send`. Set an explicit recipient and message type:
42
44
  - `ask` for a blocking question;
43
45
  - `assign` for delegated work;
44
46
  - `steer` for changed direction;
@@ -46,17 +48,17 @@ heartbeat identity to `--actor`; tool arguments cannot impersonate another actor
46
48
  - `result` for a completed outcome;
47
49
  - `broadcast` only when every relevant agent should receive it.
48
50
  5. Set `replyTo` when continuing a thread. Do not create an unrelated message that loses context.
49
- 6. Use `ack` or `ack_many` after reading or completing messages. Record a truthful outcome when
51
+ 6. Call `mcp_use` for the remote `ack` or `ack_many` operation after reading or completing messages. Record a truthful outcome when
50
52
  marking work completed.
51
53
  7. Send `heartbeat_self` during long work and `deregister_self` on a clean shutdown.
52
54
 
53
- Runtime-only `control` messages are deliberately unavailable. Use `steer` for normal external
55
+ Runtime-only `control` messages are deliberately unavailable. Call `mcp_use` for the remote `steer` operation for normal external
54
56
  direction; never bypass the restriction through another channel.
55
57
 
56
58
  ## Observe changes
57
59
 
58
- Call `mailbox_watch` with an optional event type and timeout no greater than 25 seconds. Treat the
59
- result as a wake-up hint. After every event or timeout, reconcile with `mailbox_read`; watch events
60
+ Call `mcp_use` for remote `mailbox_watch` with an optional event type and timeout no greater than 25 seconds. Treat the
61
+ result as a wake-up hint. After every event or timeout, reconcile through remote `mailbox_read`; watch events
60
62
  contain identifiers and metadata, not the authoritative message snapshot.
61
63
 
62
64
  ## Manage and administer