@imunitic/synapse 0.4.3 → 0.4.5

package/commands/synapse-init.md

@@ -153,7 +153,7 @@ emit into tool calls than read into a window. Never hand-author those.
 
    **Load the `synapse-orientation` skill** for how to read the vocabulary, the four questions that
    cover a tree with no grammar, and the grammar-discovery procedure. It is shared with
-   `/synapse-rebuild`'s re-orient class, which needs the same technique.
+   `/synapse-rebuild-diff`'s re-orient class, which needs the same technique.
 4. **Cluster into nodes — write `manifest.tsv`, the seam.** Group what you learned into a few dozen
    readable nodes, not one per file — same density Graft aims for. A node is a subsystem or concept,
    not a file; a file may legitimately belong to more than one node's `sources` when it's genuinely
@@ -249,7 +249,7 @@ emit into tool calls than read into a window. Never hand-author those.
    **Load the `synapse-node-format` skill too, before writing the first one** — it is the
    single description of the node contract itself (summary, the crux *pointer*, `## Links`,
    `grounded_in`, what the writer adds and what it refuses), shared with the `synapse-node`
-   skill and `/synapse-rebuild`, which write the same artifact. `synapse-node-authoring`
+   skill and `/synapse-rebuild-diff`, which write the same artifact. `synapse-node-authoring`
    covers *how* nodes get written; this covers *what* one is. Do not re-derive either from an
    existing node: a node you are reading may predate a change to its format.
 8. **Write `_index.bin`** — mechanics, run `synapse build-index`. It emits

package/harness/opencode/plugin/synapse.js

@@ -105,6 +105,12 @@ const EDIT_TOOLS = new Set(["write", "edit"])
 // yet -- delivered on that session's next `chat.message`.
 const pendingNudge = new Map()
 
+// sessionID -> queued `staleness` output, same reason and same delivery as
+// `pendingNudge` above: `tool.execute.after` has no message `output` to push
+// a part onto, so a drift/grounding warning from it would otherwise be
+// silently discarded instead of just reaching the next turn late.
+const pendingStaleness = new Map()
+
 export const Synapse = async ({ directory, client }) => {
   return {
     "chat.message": async (input, output) => {
@@ -123,6 +129,12 @@ export const Synapse = async ({ directory, client }) => {
         newParts.push(textPart(sessionID, output, `[SYNAPSE-STOP-NUDGE]\n${queuedNudge}`))
       }
 
+      const queuedStaleness = pendingStaleness.get(sessionID)
+      if (queuedStaleness) {
+        pendingStaleness.delete(sessionID)
+        newParts.push(textPart(sessionID, output, `[SYNAPSE-STALENESS]\n${queuedStaleness}`))
+      }
+
       const promptText = (output.parts || [])
         .filter((p) => p.type === "text")
         .map((p) => p.text)
@@ -136,10 +148,11 @@ export const Synapse = async ({ directory, client }) => {
     "tool.execute.after": async (input) => {
       const filePath = input.args?.filePath
       if (EDIT_TOOLS.has(input.tool) && filePath) {
-        runHook("staleness", {
+        const text = runHook("staleness", {
           session_id: input.sessionID,
           tool_input: { file_path: filePath },
         })
+        if (text) pendingStaleness.set(input.sessionID, text)
       }
     },
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imunitic/synapse",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "Memory for Claude Code, Codex CLI, and OpenCode: a durable markdown vault plus a per-repo code graph.",
   "repository": {
     "type": "git",
@@ -23,9 +23,9 @@
     "*.conf.template"
   ],
   "optionalDependencies": {
-    "@imunitic/synapse-darwin-arm64": "0.4.3",
-    "@imunitic/synapse-linux-x64": "0.4.3",
-    "@imunitic/synapse-linux-arm64": "0.4.3"
+    "@imunitic/synapse-darwin-arm64": "0.4.5",
+    "@imunitic/synapse-linux-x64": "0.4.5",
+    "@imunitic/synapse-linux-arm64": "0.4.5"
   },
   "license": "SEE LICENSE IN LICENSE"
 }

package/skills/synapse-node/SKILL.md

@@ -71,7 +71,7 @@ needs one.
 4. **Regeneration (only if step 1 or 2 found the node stale).** You re-author the prose; a script
    writes the file. **The node contract itself — frontmatter fields, the crux pointer, `## Links`,
    `grounded_in` — is the `synapse-node-format` skill**, shared with `/synapse-init` and
-   `/synapse-rebuild`. What follows here is only what differs when *re*-authoring an existing
+   `/synapse-rebuild-diff`. What follows here is only what differs when *re*-authoring an existing
    node rather than writing a new one. Everything mechanical — hashes, `sources_digest`, the `## Sources` mirror,
    `built_at`, `commit`, `stale: false`, and preserving `## Notes` — belongs to
    `synapse write-node`, because a hub node's `sources` can no more be *emitted* into a tool call
@@ -105,7 +105,7 @@ needs one.
      first (exit 0 use the tags, exit 1 fall back to reading the file, exit 2 run the discovery
      procedure `/synapse-init` documents, then retry), and read the load-bearing files in full — the
      tags signal informs regrouping, it never substitutes for reading a file before rewriting its prose.
-     If this is happening across many nodes at once, stop and run `/synapse-rebuild` instead: that is
+     If this is happening across many nodes at once, stop and run `/synapse-rebuild-diff` instead: that is
      the instrument for major drift, and it triages node by node rather than paying full cost for each.
    - Re-author `## Summary`, `## Crux` and `## Links` to match what the files contain now, into
      `$W/body.md`. Re-check the node's one-line `summary` as well; keep the existing one with

package/skills/synapse-node-format/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: synapse-node-format
-description: The contract for a Synapse code-graph node — frontmatter fields, the crux pointer, `## Links`, `grounded_in`, `## Sources`, and what `synapse write-node` adds or refuses. Load before authoring or regenerating any node, whether from /synapse-init's first build, /synapse-rebuild's triage, or the synapse-node skill's lazy regeneration. Not for reading the graph (that is synapse-query) or for task notes in the vault (that is synapse-task).
+description: The contract for a Synapse code-graph node — frontmatter fields, the crux pointer, `## Links`, `grounded_in`, `## Sources`, and what `synapse write-node` adds or refuses. Load before authoring or regenerating any node, whether from /synapse-init's first build, /synapse-rebuild-diff's triage, or the synapse-node skill's lazy regeneration. Not for reading the graph (that is synapse-query) or for task notes in the vault (that is synapse-task).
 ---
 
 # What a node is, and how to author one
 
 Every component that writes a node loads this: `/synapse-init` (first build), the `synapse-node`
-skill (Tier 2 lazy regeneration), and `/synapse-rebuild` (reseat, patch, re-orient).
+skill (Tier 2 lazy regeneration), and `/synapse-rebuild-diff` (reseat, patch, re-orient).
 
 All three write the same artifact, so the format belongs in one place rather than being restated
 wherever it is used. What stays with each caller is what is genuinely specific to it — the skill's

package/skills/synapse-orientation/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: synapse-orientation
-description: How to work out where meaning lives in a codebase you have not seen before — first mechanically, from the repo's own symbol vocabulary, and where no grammar exists, by four questions in order with the cheap commands that answer each. Includes tree-sitter grammar discovery. Use when clustering a repo into Synapse graph nodes for the first time, when re-deriving a node's premises in /synapse-rebuild's re-orient class, or any time you need to orient in an unfamiliar tree before making claims about it.
+description: How to work out where meaning lives in a codebase you have not seen before — first mechanically, from the repo's own symbol vocabulary, and where no grammar exists, by four questions in order with the cheap commands that answer each. Includes tree-sitter grammar discovery. Use when clustering a repo into Synapse graph nodes for the first time, when re-deriving a node's premises in /synapse-rebuild-diff's re-orient class, or any time you need to orient in an unfamiliar tree before making claims about it.
 ---
 
 # Orienting in an unfamiliar repo
 
-Loaded by `/synapse-init` at its orientation step, and by `/synapse-rebuild` when a node lands in
+Loaded by `/synapse-init` at its orientation step, and by `/synapse-rebuild-diff` when a node lands in
 the *re-orient* class and its premises have to be re-derived rather than patched. Useful on its own
 terms too: nothing here is Synapse-specific except what you do with the answers.