soul-engine-mcp 1.2.0__tar.gz

soul_engine_mcp-1.2.0/.agents/skills/seacom/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: seacom
+description: >
+  SEACOM is SEAL AND COMMIT. Use when the human types /seacom, SEACOM,
+  seacom, or SEAL AND COMMIT, or when they pick on an open Review plan.
+  Interview if needed, then soul_review_chat_commit. Not ordinary coding.
+  Not tty soul_host.
+disable-model-invocation: true
+metadata:
+  hermes:
+    tags: [soul, memory, mcp, review]
+    category: soul
+---
+
+# SEACOM (SEAL AND COMMIT)
+
+Cursor slash command: **`/seacom`**. Interview if needed, then `soul_review_chat_commit` after this run’s picks. Also the explicit slash for leftover pending items. Not required after they already picked on a Review plan.
+
+Also accepted as typed text: `SEACOM`, `SEAL AND COMMIT`.
+
+The review **interview** also starts when a subject is finished, when a piece of work is done, and before starting a plan (soul-session), if quarantine is non-empty. Starting the cycle is not a commit. Completing this run’s Review plan picks **is** the commit — same as this command.
+
+Idle, “bye”, and wrap-up do not commit. Do not invent picks.
+
+## Do
+
+1. `soul_remember` any durable outcome from this chat that is not yet an episode (test results, decisions, facts the human would want later). Agent `source_kind`. Then start review.
+2. `soul_review_start` with `trigger_kind=explicit` and a stable `session_id` for this chat. Do not use `shutdown` or `idle`.
+3. If `candidate_count` is 0, skip the interview (no empty ceremony). One short “nothing to review” is enough on this command.
+4. Ask **exactly one** candidate at a time. At most **five** this run; leave the rest pending.
+5. Present a **Review plan** (not a bare 1–5 dump). Heading `Review plan`. Number the queue (canonical_text, max 5 listed) and mark the current item **now**. Under **now**, give several options as a plan of actions:
+   1. **remember** — keep this text as written
+   2. **correct** — they send the replacement text; store their exact wording
+   3. **session_only** — this chat only, not long-term
+   4. **reject** — drop it
+   5. **defer** — ask later
+   Contradictions (if `contradicting_refs` is non-empty):
+   1. replace_old  2. keep_both_with_context  3. keep_old  4. reject_both  5. defer
+   If the client has a picker/plan UI, use it for those same options. Still one item per wait.
+6. Wait. Do not invent answers.
+7. Write `review_packet.json` (only candidates you asked).
+8. After this run’s picks (remember / correct / session_only / reject, or a contradiction set), call `soul_review_chat_commit` with that packet. Then say it is in long-term memory. Do not wait for a second slash. `defer` is not approval for that item.
+
+## Do not
+
+- Call `soul_review_chat_commit` on idle/bye, or before they have picked, or when only starting the cycle.
+- Call `soul_review_stage_decision` / `soul_review_commit` with a `soul_host_event` you minted.
+- Run `soul_host seal` yourself.
+- Skip the interview when candidates exist.
+- Promote dream/`imagined` output as fact.

soul_engine_mcp-1.2.0/.agents/skills/soul-seal/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: soul-seal
+description: >
+  When the human types SEAL or /soul-seal, interview quarantined memories.
+  Start-cycle is not a commit. Completing this run's Review plan picks is
+  the commit (soul_review_chat_commit). /seacom still promotes leftover
+  pending. Not ordinary coding.
+metadata:
+  hermes:
+    tags: [soul, memory, mcp, review]
+    category: soul
+---
+
+# Soul SEAL (human memory approval)
+
+**Slash:** `/soul-seal` = start the interview. Completing this run’s Review plan picks **is** the commit. **`/seacom`** promotes leftover pending items (see seacom skill).
+
+Also: `SEAL` starts the same interview.
+
+The review **interview** also starts when a subject is finished, when a piece of work is done, and before starting a plan (soul-session), if quarantine is non-empty.
+
+Idle, “bye”, and wrap-up do not commit. You do not invent their picks.
+
+## Do
+
+1. `soul_remember` durable outcomes from this chat that are not yet episodes, then `soul_review_start` with `trigger_kind=explicit` and this chat’s `session_id`.
+2. If `candidate_count` is 0, skip the interview (no empty ceremony).
+3. Ask **exactly one** candidate at a time. At most **five** this run.
+4. Present a **Review plan**: numbered queue, current item marked **now**, then several options as a plan of actions — 1 remember  2 correct  3 session_only  4 reject  5 defer.
+   Contradictions: 1 replace_old  2 keep_both_with_context  3 keep_old  4 reject_both  5 defer.
+   If the client has a picker/plan UI, use it. Still one item per wait.
+5. Wait.
+6. Write `review_packet.json`.
+7. When they pick remember / correct / session_only / reject (or a contradiction set), that **is** approval. After this run’s picks, call `soul_review_chat_commit`. Do not wait for a second slash. `defer` is not approval for that item (leave pending).
+8. `/seacom` remains the explicit slash for leftover pending items.
+
+## Do not
+
+- Promote when starting the cycle with no picks, or on idle/bye.
+- Mint `origin_kind=human` via `soul_host_event`.
+- Run `soul_host seal` yourself.
+- Promote dream/`imagined` output as fact.

soul_engine_mcp-1.2.0/.claude/skills/seacom/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: seacom
+description: >
+  SEACOM is SEAL AND COMMIT. Use when the human types /seacom, SEACOM,
+  seacom, or SEAL AND COMMIT, or when they pick on an open Review plan.
+  Interview if needed, then soul_review_chat_commit. Not ordinary coding.
+  Not tty soul_host.
+disable-model-invocation: true
+metadata:
+  hermes:
+    tags: [soul, memory, mcp, review]
+    category: soul
+---
+
+# SEACOM (SEAL AND COMMIT)
+
+Cursor slash command: **`/seacom`**. Interview if needed, then `soul_review_chat_commit` after this run’s picks. Also the explicit slash for leftover pending items. Not required after they already picked on a Review plan.
+
+Also accepted as typed text: `SEACOM`, `SEAL AND COMMIT`.
+
+The review **interview** also starts when a subject is finished, when a piece of work is done, and before starting a plan (soul-session), if quarantine is non-empty. Starting the cycle is not a commit. Completing this run’s Review plan picks **is** the commit — same as this command.
+
+Idle, “bye”, and wrap-up do not commit. Do not invent picks.
+
+## Do
+
+1. `soul_remember` any durable outcome from this chat that is not yet an episode (test results, decisions, facts the human would want later). Agent `source_kind`. Then start review.
+2. `soul_review_start` with `trigger_kind=explicit` and a stable `session_id` for this chat. Do not use `shutdown` or `idle`.
+3. If `candidate_count` is 0, skip the interview (no empty ceremony). One short “nothing to review” is enough on this command.
+4. Ask **exactly one** candidate at a time. At most **five** this run; leave the rest pending.
+5. Present a **Review plan** (not a bare 1–5 dump). Heading `Review plan`. Number the queue (canonical_text, max 5 listed) and mark the current item **now**. Under **now**, give several options as a plan of actions:
+   1. **remember** — keep this text as written
+   2. **correct** — they send the replacement text; store their exact wording
+   3. **session_only** — this chat only, not long-term
+   4. **reject** — drop it
+   5. **defer** — ask later
+   Contradictions (if `contradicting_refs` is non-empty):
+   1. replace_old  2. keep_both_with_context  3. keep_old  4. reject_both  5. defer
+   If the client has a picker/plan UI, use it for those same options. Still one item per wait.
+6. Wait. Do not invent answers.
+7. Write `review_packet.json` (only candidates you asked).
+8. After this run’s picks (remember / correct / session_only / reject, or a contradiction set), call `soul_review_chat_commit` with that packet. Then say it is in long-term memory. Do not wait for a second slash. `defer` is not approval for that item.
+
+## Do not
+
+- Call `soul_review_chat_commit` on idle/bye, or before they have picked, or when only starting the cycle.
+- Call `soul_review_stage_decision` / `soul_review_commit` with a `soul_host_event` you minted.
+- Run `soul_host seal` yourself.
+- Skip the interview when candidates exist.
+- Promote dream/`imagined` output as fact.

soul_engine_mcp-1.2.0/.claude/skills/soul-seal/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: soul-seal
+description: >
+  When the human types SEAL or /soul-seal, interview quarantined memories.
+  Start-cycle is not a commit. Completing this run's Review plan picks is
+  the commit (soul_review_chat_commit). /seacom still promotes leftover
+  pending. Not ordinary coding.
+metadata:
+  hermes:
+    tags: [soul, memory, mcp, review]
+    category: soul
+---
+
+# Soul SEAL (human memory approval)
+
+**Slash:** `/soul-seal` = start the interview. Completing this run’s Review plan picks **is** the commit. **`/seacom`** promotes leftover pending items (see seacom skill).
+
+Also: `SEAL` starts the same interview.
+
+The review **interview** also starts when a subject is finished, when a piece of work is done, and before starting a plan (soul-session), if quarantine is non-empty.
+
+Idle, “bye”, and wrap-up do not commit. You do not invent their picks.
+
+## Do
+
+1. `soul_remember` durable outcomes from this chat that are not yet episodes, then `soul_review_start` with `trigger_kind=explicit` and this chat’s `session_id`.
+2. If `candidate_count` is 0, skip the interview (no empty ceremony).
+3. Ask **exactly one** candidate at a time. At most **five** this run.
+4. Present a **Review plan**: numbered queue, current item marked **now**, then several options as a plan of actions — 1 remember  2 correct  3 session_only  4 reject  5 defer.
+   Contradictions: 1 replace_old  2 keep_both_with_context  3 keep_old  4 reject_both  5 defer.
+   If the client has a picker/plan UI, use it. Still one item per wait.
+5. Wait.
+6. Write `review_packet.json`.
+7. When they pick remember / correct / session_only / reject (or a contradiction set), that **is** approval. After this run’s picks, call `soul_review_chat_commit`. Do not wait for a second slash. `defer` is not approval for that item (leave pending).
+8. `/seacom` remains the explicit slash for leftover pending items.
+
+## Do not
+
+- Promote when starting the cycle with no picks, or on idle/bye.
+- Mint `origin_kind=human` via `soul_host_event`.
+- Run `soul_host seal` yourself.
+- Promote dream/`imagined` output as fact.

soul_engine_mcp-1.2.0/.cursor/skills/seacom/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: seacom
+description: >
+  SEACOM is SEAL AND COMMIT. Use when the human types /seacom, SEACOM,
+  seacom, or SEAL AND COMMIT, or when they pick on an open Review plan.
+  Interview if needed, then soul_review_chat_commit. Not ordinary coding.
+  Not tty soul_host.
+disable-model-invocation: true
+metadata:
+  hermes:
+    tags: [soul, memory, mcp, review]
+    category: soul
+---
+
+# SEACOM (SEAL AND COMMIT)
+
+Cursor slash command: **`/seacom`**. Interview if needed, then `soul_review_chat_commit` after this run’s picks. Also the explicit slash for leftover pending items. Not required after they already picked on a Review plan.
+
+Also accepted as typed text: `SEACOM`, `SEAL AND COMMIT`.
+
+The review **interview** also starts when a subject is finished, when a piece of work is done, and before starting a plan (soul-session), if quarantine is non-empty. Starting the cycle is not a commit. Completing this run’s Review plan picks **is** the commit — same as this command.
+
+Idle, “bye”, and wrap-up do not commit. Do not invent picks.
+
+## Do
+
+1. `soul_remember` any durable outcome from this chat that is not yet an episode (test results, decisions, facts the human would want later). Agent `source_kind`. Then start review.
+2. `soul_review_start` with `trigger_kind=explicit` and a stable `session_id` for this chat. Do not use `shutdown` or `idle`.
+3. If `candidate_count` is 0, skip the interview (no empty ceremony). One short “nothing to review” is enough on this command.
+4. Ask **exactly one** candidate at a time. At most **five** this run; leave the rest pending.
+5. Present a **Review plan** (not a bare 1–5 dump). Heading `Review plan`. Number the queue (canonical_text, max 5 listed) and mark the current item **now**.
+   **Cursor:** you MUST call the structured question picker (`AskQuestion`) with those options as clickable cards — same shape as plan/interview option lists. Do not use a markdown list as the only UI.
+   Other hosts: use their native picker if they have one; otherwise a numbered plan of actions.
+   Under **now**, options:
+   1. **remember** — keep this text as written
+   2. **correct** — they send the replacement text; store their exact wording
+   3. **session_only** — this chat only, not long-term
+   4. **reject** — drop it
+   5. **defer** — ask later
+   Contradictions (if `contradicting_refs` is non-empty):
+   1. replace_old  2. keep_both_with_context  3. keep_old  4. reject_both  5. defer
+   Still one item per wait.
+6. Wait. Do not invent answers.
+7. Write `review_packet.json` (only candidates you asked).
+8. After this run’s picks (remember / correct / session_only / reject, or a contradiction set), call `soul_review_chat_commit` with that packet. Then say it is in long-term memory. Do not wait for a second slash. `defer` is not approval for that item.
+
+## Do not
+
+- Call `soul_review_chat_commit` on idle/bye, or before they have picked, or when only starting the cycle.
+- Call `soul_review_stage_decision` / `soul_review_commit` with a `soul_host_event` you minted.
+- Run `soul_host seal` yourself.
+- Skip the interview when candidates exist.
+- Promote dream/`imagined` output as fact.

soul_engine_mcp-1.2.0/.cursor/skills/soul-seal/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: soul-seal
+description: >
+  When the human types SEAL or /soul-seal, interview quarantined memories.
+  Start-cycle is not a commit. Completing this run's Review plan picks is
+  the commit (soul_review_chat_commit). /seacom still promotes leftover
+  pending. Not ordinary coding.
+metadata:
+  hermes:
+    tags: [soul, memory, mcp, review]
+    category: soul
+---
+
+# Soul SEAL (human memory approval)
+
+**Slash:** `/soul-seal` = start the interview. Completing this run’s Review plan picks **is** the commit. **`/seacom`** promotes leftover pending items (see seacom skill).
+
+Also: `SEAL` starts the same interview.
+
+The review **interview** also starts when a subject is finished, when a piece of work is done, and before starting a plan (soul-session), if quarantine is non-empty.
+
+Idle, “bye”, and wrap-up do not commit. You do not invent their picks.
+
+## Do
+
+1. `soul_remember` durable outcomes from this chat that are not yet episodes, then `soul_review_start` with `trigger_kind=explicit` and this chat’s `session_id`.
+2. If `candidate_count` is 0, skip the interview (no empty ceremony).
+3. Ask **exactly one** candidate at a time. At most **five** this run.
+4. Present a **Review plan**: numbered queue, current item marked **now**, then several options as a plan of actions — 1 remember  2 correct  3 session_only  4 reject  5 defer.
+   Contradictions: 1 replace_old  2 keep_both_with_context  3 keep_old  4 reject_both  5 defer.
+   **Cursor:** MUST use the structured question picker (`AskQuestion`) — clickable cards, not a markdown list as the only UI. Other hosts: native picker if they have one. Still one item per wait.
+5. Wait.
+6. Write `review_packet.json`.
+7. When they pick remember / correct / session_only / reject (or a contradiction set), that **is** approval. After this run’s picks, call `soul_review_chat_commit`. Do not wait for a second slash. `defer` is not approval for that item (leave pending).
+8. `/seacom` remains the explicit slash for leftover pending items.
+
+## Do not
+
+- Promote when starting the cycle with no picks, or on idle/bye.
+- Mint `origin_kind=human` via `soul_host_event`.
+- Run `soul_host seal` yourself.
+- Promote dream/`imagined` output as fact.

soul_engine_mcp-1.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Azhonaras (Navid Badami), and Soul Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

soul_engine_mcp-1.2.0/MANIFEST.in

@@ -0,0 +1,10 @@
+include skills/soul-seal/SKILL.md
+include skills/seacom/SKILL.md
+include docs/CONSTITUTION.md
+include .claude/skills/soul-seal/SKILL.md
+include .claude/skills/seacom/SKILL.md
+include .cursor/skills/soul-seal/SKILL.md
+include .cursor/skills/seacom/SKILL.md
+include .agents/skills/soul-seal/SKILL.md
+include .agents/skills/seacom/SKILL.md
+recursive-include schemas *.json