@imunitic/synapse 0.9.0 → 0.11.0

package/commands/synapse-design-note.md

@@ -217,8 +217,8 @@ unquoted all-digit value is parsed as an integer, which fails a `type: string` s
 field. `title`, `project`, `note_id`, and both timestamps are quoted above.
 
 Resolve tags through the `synapse-vault` skill's configured vocabulary procedure. Fetch machine
-local time once (`date '+%Y-%m-%d %H:%M:%S %Z'`) — never infer it — and use the exact same value
-for `created` and `updated`.
+local time once (`synapse now`) — never infer it — and use the exact same value for `created` and
+`updated`.
 
 No `Notes`/changelog section — it stays a small, single-conclusion note; there's no long-running
 edit history here worth tracking separately.

package/commands/synapse-note.md

@@ -174,8 +174,8 @@ or supplied directly by a caller like `/synapse-task-note`):
 2. Resolve tags through the `synapse-vault` skill's configured
    `synapse-tag-vocabulary.conf` procedure. Choose only entries already in that vocabulary; an
    empty list is valid when no tag applies, but the `tags` field itself is mandatory.
-3. Fetch machine local time once: `date '+%Y-%m-%d %H:%M:%S %Z'` — never use inferred
-   time. Use the exact same value for `created` and `updated`.
+3. Fetch machine local time once: `synapse now` — never use inferred time. Use the
+   exact same value for `created` and `updated`.
 4. Build the file content. A bare note needs a concise Summary. A task note needs lead prose and
    at least one real flat checklist item before it can be written; never create an invalid empty
    skeleton and promise to populate it later.

package/commands/synapse-status.md

@@ -1,5 +1,5 @@
 ---
-description: Print a read-only report of what in Synapse Vault currently needs a human decision -- design notes still Discussing, design notes marked Ready with no compiled task yet, design notes with open questions, task notes with unchecked items, and task notes stuck in REVIEW. Use whenever the user wants a status check on the vault ("what's outstanding", "what needs my attention", "vault status", "what did we leave open"). Never modifies anything -- a report only, not a task-management action. Not for creating, continuing, or listing a specific note kind (that's synapse-note/synapse-design-note/synapse-task-note's own --list modes) -- this is the one cross-cutting view over all of them at once.
+description: Print a read-only report of what in Synapse Vault currently needs a human decision -- design notes still Discussing, design notes marked Ready with no compiled task yet, Ready design notes with open questions still outstanding, task notes with unchecked items, and task notes stuck in REVIEW. Use whenever the user wants a status check on the vault ("what's outstanding", "what needs my attention", "vault status", "what did we leave open"). Never modifies anything -- a report only, not a task-management action. Not for creating, continuing, or listing a specific note kind (that's synapse-note/synapse-design-note/synapse-task-note's own --list modes) -- this is the one cross-cutting view over all of them at once.
 ---
 
 # Synapse Status: Vault-Wide Attention Report
@@ -64,34 +64,52 @@ synapse vault-search --fields frontmatter.title,frontmatter.note_id <<'EOF'
 EOF
 ```
 
-**3. Design notes (any status) with a non-empty `## Open Questions`.** Match the heading followed by
-at least one bullet -- a heading with nothing under it (fully pruned, per the Ready-gate convention
-`/synapse-design-note` now follows) doesn't count as open. Since this section spans every status,
-each line in the composed report also shows *which* status the note is currently in, and whether it
-has a compiled task note -- request `content` and `note_id` too, and pull the status/compiled-task
-target directly out of the returned text rather than reading the note again:
+**3. `Ready` design notes with a non-empty `## Open Questions`, excluding ones whose compiled task is
+already `DONE`.** Match the heading followed by at least one bullet -- a heading with nothing under
+it (fully pruned, per the Ready-gate convention `/synapse-design-note` now follows) doesn't count as
+open. A `Discussing` note with open questions isn't actionable yet (it's still being worked out in
+conversation, surfaced already by query 1), and a note whose compiled task has already shipped is
+stale noise -- so this query narrows to the two states that actually need a human decision: `Ready`
+with open questions and no compiled task, or `Ready` with open questions and a compiled task that
+hasn't reached `DONE`. `vault-search` has no cross-note join, so this takes two queries: the first
+finds `Ready`-with-open-questions design notes and pulls each one's compiled-task title (if any)
+straight out of its own `content`; the second resolves those titles' status against `tasks/`.
 
 ```
 synapse vault-search --fields frontmatter.title,frontmatter.note_id,content <<'EOF'
 {"and": [
   {"glob": ["designs/*", {"var": "path"}]},
+  {"regexp": ["## Status\nReady", {"var": "content"}]},
   {"regexp": ["## Open Questions\n- ", {"var": "content"}]}
 ]}
 EOF
 ```
 
-This spans every status, so take two things from each row's `content` column directly instead of
-chaining further status-specific `regexp` branches onto the query: the line following `## Status`
-(normally `Discussing`/`Ready`/`Reference`, but a note written before the three-word convention can
-carry free text instead, e.g. `Superseded by [[...]]` -- report that verbatim rather than forcing it
-into a bucket, surfacing an odd note beats losing it) and the target of a `> Compiled task: [[...]]`
-line, if present -- that's the compiled task, parsed straight out of the wikilink text rather than
-resolved through any vault-wide link index.
+For each match, pull the target of a `> Compiled task: [[...]]` line out of its `content`, if present
+-- parsed straight out of the wikilink text rather than resolved through any vault-wide link index.
+Collect the distinct compiled-task titles found across all matches. If none of the matches have a
+`Compiled task:` line, skip the second query entirely -- every match stays in (no compiled task means
+the "either" branch is already satisfied). Otherwise, resolve those titles' status in one follow-up
+call:
+
+```
+synapse vault-search --fields frontmatter.title,frontmatter.status <<'EOF'
+{"and": [
+  {"glob": ["tasks/*", {"var": "path"}]},
+  {"in": [{"var": "frontmatter.title"}, ["{title one}", "{title two}"]]}
+]}
+EOF
+```
+
+Keep a match from the first query only if it has no `Compiled task:` line, or its compiled task's
+title isn't found in the second query's results with `frontmatter.status` equal to `DONE` -- a title
+the second query didn't return at all (a stale or broken link) counts as "not `DONE`" and stays in,
+since a broken link is itself worth a human noticing rather than a reason to drop the note silently.
 
 A `regexp` pattern containing a literal newline (`\n`) must be written with a single backslash, byte-
 for-byte, in the JSON text piped to `vault-search` -- the heredocs above are unquoted-delimiter
 (`<<'EOF'`), so nothing here re-escapes it; `\\n` would reach the JSON parser as a literal backslash
-followed by `n`, never matching a real line break, and every one of this command's five queries would
+followed by `n`, never matching a real line break, and every `regexp` query in this command would
 silently stop finding anything under a multi-line pattern.
 
 **4. Open task notes with at least one unchecked item.** Task notes carry `status:` in frontmatter,
@@ -127,11 +145,10 @@ one is that a human can act on a line directly ("open sb-068") without the title
 step — followed by the title, plus whatever other identifying detail that category needs. A note
 somehow missing its id (pre-dates the field, or the backfill hasn't reached it yet) drops the bracket
 entirely rather than printing an empty one, the same graceful-degradation the title-less case already
-gets. The Open Questions section is the one place a note's status and compiled-task link also belong
-on the line -- every other section's heading already implies status (the "Discussing" section only
-ever holds `Discussing` notes) and compiled-task-ness (the "Ready, not yet compiled" section only ever
-holds notes without one), but Open Questions spans every status and both compiled and uncompiled
-notes, so put the status first, before the id, so it's the first thing scanned:
+gets. Every section's heading already implies status now (the "Discussing" section only ever holds
+`Discussing` notes, "Open questions" only ever holds `Ready` ones per query 3 above), but Open
+questions still spans both compiled and uncompiled notes, so its line also names the compiled task
+(or says there isn't one) -- the one piece of state that section doesn't already imply:
 
 ```
 ## Discussing
@@ -141,7 +158,7 @@ notes, so put the status first, before the id, so it's the first thing scanned:
 - [{note_id}] {title}
 
 ## Open questions
-- **{status}** — [{note_id}] {title} — {compiled task title, or "not compiled"}
+- [{note_id}] {title} — {compiled task title, or "not compiled"}
 
 ## In progress (unchecked items)
 - [{task_id}] {title} ({N} unchecked)

package/harness/codex/skills/synapse-design-note/SKILL.md

@@ -220,8 +220,8 @@ Open Questions (optional)`: the schema and `/synapse-status`'s own query both ma
 heading text, and a suffixed one is invisible to both.
 
 Resolve tags through the `synapse-vault` skill's configured vocabulary procedure. Fetch machine
-local time once (`date '+%Y-%m-%d %H:%M:%S %Z'`) — never infer it — and use the exact same value
-for `created` and `updated`.
+local time once (`synapse now`) — never infer it — and use the exact same value for `created` and
+`updated`.
 
 No `Notes`/changelog section — it stays a small, single-conclusion note; there's no long-running
 edit history here worth tracking separately.

package/harness/codex/skills/synapse-note/SKILL.md

@@ -193,8 +193,8 @@ or supplied directly by a caller like the synapse-task-note skill):
 2. Resolve tags through the `synapse-vault` skill's configured
    `synapse-tag-vocabulary.conf` procedure. Choose only configured entries; an empty list is valid
    when no tag applies, but the field itself is mandatory.
-3. Fetch machine local time once: `date '+%Y-%m-%d %H:%M:%S %Z'` — never use inferred
-   time. Use the exact same value for `created` and `updated`.
+3. Fetch machine local time once: `synapse now` — never use inferred time. Use the
+   exact same value for `created` and `updated`.
 4. Build the file content. Bare notes require a concise Summary. Task notes require lead prose and
    at least one real flat checklist item before the first write.
 

package/harness/codex/skills/synapse-status/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: synapse-status
-description: Print a read-only report of what in Synapse Vault currently needs a human decision -- design notes still Discussing, design notes marked Ready with no compiled task yet, design notes with open questions, task notes with unchecked items, and task notes stuck in REVIEW. Use whenever the user wants a status check on the vault ("what's outstanding", "what needs my attention", "vault status", "what did we leave open"). Never modifies anything -- a report only, not a task-management action. Not for creating, continuing, or listing a specific note kind (that's the synapse-note/synapse-design-note/synapse-task-note skills' own --list modes) -- this is the one cross-cutting view over all of them at once.
+description: Print a read-only report of what in Synapse Vault currently needs a human decision -- design notes still Discussing, design notes marked Ready with no compiled task yet, Ready design notes with open questions still outstanding, task notes with unchecked items, and task notes stuck in REVIEW. Use whenever the user wants a status check on the vault ("what's outstanding", "what needs my attention", "vault status", "what did we leave open"). Never modifies anything -- a report only, not a task-management action. Not for creating, continuing, or listing a specific note kind (that's the synapse-note/synapse-design-note/synapse-task-note skills' own --list modes) -- this is the one cross-cutting view over all of them at once.
 ---
 
 # Synapse Status: Vault-Wide Attention Report
@@ -66,35 +66,52 @@ synapse vault-search --fields frontmatter.title,frontmatter.note_id <<'EOF'
 EOF
 ```
 
-**3. Design notes (any status) with a non-empty `## Open Questions`.** Match the heading followed by
-at least one bullet -- a heading with nothing under it (fully pruned, per the design-note skill's own
-Ready-gate convention) doesn't count as open. Since this section spans every status, each line in the
-composed report also shows *which* status the note is currently in, and whether it has a compiled task
-note -- request `content` and `note_id` too, and pull both directly out of the returned text rather
-than reading the note again:
+**3. `Ready` design notes with a non-empty `## Open Questions`, excluding ones whose compiled task is
+already `DONE`.** Match the heading followed by at least one bullet -- a heading with nothing under
+it (fully pruned, per the design-note skill's own Ready-gate convention) doesn't count as open. A
+`Discussing` note with open questions isn't actionable yet (it's still being worked out in
+conversation, surfaced already by query 1), and a note whose compiled task has already shipped is
+stale noise -- so this query narrows to the two states that actually need a human decision: `Ready`
+with open questions and no compiled task, or `Ready` with open questions and a compiled task that
+hasn't reached `DONE`. `vault-search` has no cross-note join, so this takes two queries: the first
+finds `Ready`-with-open-questions design notes and pulls each one's compiled-task title (if any)
+straight out of its own `content`; the second resolves those titles' status against `tasks/`.
 
 ```
 synapse vault-search --fields frontmatter.title,frontmatter.note_id,content <<'EOF'
 {"and": [
   {"glob": ["designs/*", {"var": "path"}]},
+  {"regexp": ["## Status\nReady", {"var": "content"}]},
   {"regexp": ["## Open Questions\n- ", {"var": "content"}]}
 ]}
 EOF
 ```
 
-This spans every status, so take two things from each row's `content` column directly instead of
-chaining further status-specific `regexp` branches onto the query: the line following `## Status`
-(normally `Discussing`/`Ready`/`Reference`, but a design note written before that three-word convention
-was standardized can carry free text there instead, e.g. `Superseded by [[...]]` -- report that
-verbatim rather than forcing it into a bucket, surfacing an odd note beats losing it, the same
-reasoning behind reporting a 0-unchecked task instead of hiding it, see Query 4 below) and the target
-of a `> Compiled task: [[...]]` line, if present -- that's the compiled task, parsed straight out of
-the wikilink text rather than resolved through any vault-wide link index.
+For each match, pull the target of a `> Compiled task: [[...]]` line out of its `content`, if present
+-- parsed straight out of the wikilink text rather than resolved through any vault-wide link index.
+Collect the distinct compiled-task titles found across all matches. If none of the matches have a
+`Compiled task:` line, skip the second query entirely -- every match stays in (no compiled task means
+the "either" branch is already satisfied). Otherwise, resolve those titles' status in one follow-up
+call:
+
+```
+synapse vault-search --fields frontmatter.title,frontmatter.status <<'EOF'
+{"and": [
+  {"glob": ["tasks/*", {"var": "path"}]},
+  {"in": [{"var": "frontmatter.title"}, ["{title one}", "{title two}"]]}
+]}
+EOF
+```
+
+Keep a match from the first query only if it has no `Compiled task:` line, or its compiled task's
+title isn't found in the second query's results with `frontmatter.status` equal to `DONE` -- a title
+the second query didn't return at all (a stale or broken link) counts as "not `DONE`" and stays in,
+since a broken link is itself worth a human noticing rather than a reason to drop the note silently.
 
 A `regexp` pattern containing a literal newline (`\n`) must be written with a single backslash, byte-
 for-byte, in the JSON text piped to `vault-search` -- the heredocs above are unquoted-delimiter
 (`<<'EOF'`), so nothing here re-escapes it; `\\n` would reach the JSON parser as a literal backslash
-followed by `n`, never matching a real line break, and every one of this skill's five queries would
+followed by `n`, never matching a real line break, and every `regexp` query in this skill would
 silently stop finding anything under a multi-line pattern.
 
 **4. Open task notes with at least one unchecked item.** Task notes carry `status:` in frontmatter,
@@ -129,11 +146,10 @@ One section per category, in the order above. Each line leads with the note's ow
 one is that a human can act on a line directly ("open sb-068") without the title as an intermediate
 step — followed by the title. A note somehow missing its id (pre-dates the field) drops the bracket
 entirely rather than printing an empty one, the same graceful-degradation the title-less case already
-gets. The Open Questions section is the one place a note's status and compiled-task link also belong
-on the line -- every other section's heading already implies status (the "Discussing" section only
-ever holds `Discussing` notes) and compiled-task-ness (the "Ready, not yet compiled" section only ever
-holds notes without one), but Open Questions spans every status and both compiled and uncompiled
-notes, so put the status first, before the id, so it's the first thing scanned:
+gets. Every section's heading already implies status now (the "Discussing" section only ever holds
+`Discussing` notes, "Open questions" only ever holds `Ready` ones per query 3 above), but Open
+questions still spans both compiled and uncompiled notes, so its line also names the compiled task
+(or says there isn't one) -- the one piece of state that section doesn't already imply:
 
 ```
 ## Discussing
@@ -143,7 +159,7 @@ notes, so put the status first, before the id, so it's the first thing scanned:
 - [{note_id}] {title}
 
 ## Open questions
-- **{status}** — [{note_id}] {title} — {compiled task title, or "not compiled"}
+- [{note_id}] {title} — {compiled task title, or "not compiled"}
 
 ## In progress (unchecked items)
 - [{task_id}] {title} ({N} unchecked)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imunitic/synapse",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "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.9.0",
-    "@imunitic/synapse-linux-x64": "0.9.0",
-    "@imunitic/synapse-linux-arm64": "0.9.0"
+    "@imunitic/synapse-darwin-arm64": "0.11.0",
+    "@imunitic/synapse-linux-x64": "0.11.0",
+    "@imunitic/synapse-linux-arm64": "0.11.0"
   },
   "license": "SEE LICENSE IN LICENSE"
 }

package/schema/vault-design-note/v1.yaml

@@ -79,25 +79,38 @@ body:
   section_order: relative
 
 checks:
-  - equals: [filename.stem, frontmatter.title]
-  - unique: frontmatter.note_id
-    when: create
-  - vocabulary:
-      field: frontmatter.project
-      source: synapse-projects.conf
-      projection: values
-  - vocabulary:
-      field: frontmatter.tags
-      source: synapse-tag-vocabulary.conf
-  - not_before: [frontmatter.updated, frontmatter.created]
-  - equals:
-      values: [frontmatter.created, frontmatter.updated]
-      when: create
+  - eq:
+      - var: filename.stem
+      - var: frontmatter.title
+    message: 'filename.stem: must equal frontmatter.title'
+  - on_create:
+      var: id_is_unique
+    message: 'frontmatter.note_id: identity already exists'
+  - in:
+      - var: frontmatter.project
+      - var: vocabularies.synapse-projects
+    message: 'frontmatter.project: not in synapse-projects.conf'
+  - all:
+      - var: frontmatter.tags
+      - in:
+          - var: ''
+          - var: vocabularies.synapse-tag-vocabulary
+    message: 'frontmatter.tags: every tag must be in synapse-tag-vocabulary.conf'
+  - lte:
+      - var: created_epoch
+      - var: updated_epoch
+    message: 'frontmatter.updated: must not precede frontmatter.created'
+  - on_create:
+      eq:
+        - var: created_epoch
+        - var: updated_epoch
+    message: 'frontmatter.created: must equal frontmatter.updated on creation'
 
 lints:
-  - no_hard_wrap: body.prose
+  - no_hard_wrap:
+      var: body.prose
     severity: warn
   - no_id_prefix_in_title:
-      title: frontmatter.title
-      id: frontmatter.note_id
+      - var: frontmatter.title
+      - var: frontmatter.note_id
     severity: warn

package/schema/vault-note/v1.yaml

@@ -55,17 +55,30 @@ body:
   section_order: relative
 
 checks:
-  - equals: [filename.stem, frontmatter.title]
-  - unique: frontmatter.note_id
-    when: create
-  - vocabulary:
-      field: frontmatter.tags
-      source: synapse-tag-vocabulary.conf
-  - not_before: [frontmatter.updated, frontmatter.created]
-  - equals:
-      values: [frontmatter.created, frontmatter.updated]
-      when: create
+  - eq:
+      - var: filename.stem
+      - var: frontmatter.title
+    message: 'filename.stem: must equal frontmatter.title'
+  - on_create:
+      var: id_is_unique
+    message: 'frontmatter.note_id: identity already exists'
+  - all:
+      - var: frontmatter.tags
+      - in:
+          - var: ''
+          - var: vocabularies.synapse-tag-vocabulary
+    message: 'frontmatter.tags: every tag must be in synapse-tag-vocabulary.conf'
+  - lte:
+      - var: created_epoch
+      - var: updated_epoch
+    message: 'frontmatter.updated: must not precede frontmatter.created'
+  - on_create:
+      eq:
+        - var: created_epoch
+        - var: updated_epoch
+    message: 'frontmatter.created: must equal frontmatter.updated on creation'
 
 lints:
-  - no_hard_wrap: body.prose
+  - no_hard_wrap:
+      var: body.prose
     severity: warn

package/schema/vault-task-note/v1.yaml

@@ -73,29 +73,43 @@ body:
   section_order: relative
 
 checks:
-  - equals: [filename.stem, frontmatter.title]
-  - unique: frontmatter.task_id
-    when: create
-  - vocabulary:
-      field: frontmatter.project
-      source: synapse-projects.conf
-      projection: values
-  - vocabulary:
-      field: frontmatter.tags
-      source: synapse-tag-vocabulary.conf
-  - not_before: [frontmatter.updated, frontmatter.created]
-  - equals:
-      values: [frontmatter.created, frontmatter.updated]
-      when: create
-  - const:
-      field: frontmatter.status
-      value: TODO
-      when: create
+  - eq:
+      - var: filename.stem
+      - var: frontmatter.title
+    message: 'filename.stem: must equal frontmatter.title'
+  - on_create:
+      var: id_is_unique
+    message: 'frontmatter.task_id: identity already exists'
+  - in:
+      - var: frontmatter.project
+      - var: vocabularies.synapse-projects
+    message: 'frontmatter.project: not in synapse-projects.conf'
+  - all:
+      - var: frontmatter.tags
+      - in:
+          - var: ''
+          - var: vocabularies.synapse-tag-vocabulary
+    message: 'frontmatter.tags: every tag must be in synapse-tag-vocabulary.conf'
+  - lte:
+      - var: created_epoch
+      - var: updated_epoch
+    message: 'frontmatter.updated: must not precede frontmatter.created'
+  - on_create:
+      eq:
+        - var: created_epoch
+        - var: updated_epoch
+    message: 'frontmatter.created: must equal frontmatter.updated on creation'
+  - on_create:
+      eq:
+        - var: frontmatter.status
+        - TODO
+    message: 'frontmatter.status: must equal TODO on creation'
 
 lints:
-  - no_hard_wrap: body.prose
+  - no_hard_wrap:
+      var: body.prose
     severity: warn
   - no_id_prefix_in_title:
-      title: frontmatter.title
-      id: frontmatter.task_id
+      - var: frontmatter.title
+      - var: frontmatter.task_id
     severity: warn

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

@@ -63,7 +63,7 @@ to orient someone already inside. A node without one is an error, not a default.
 - **`sources_digest`:** `sha256` over the sorted `path:hash` lines of `sources` (see "Computing
   `sources_digest`" below). Lets a staleness check answer "has this node changed" by reading one
   field instead of every hash.
-- **`built_at`:** machine local time (`date '+%Y-%m-%d %H:%M'`) — never inferred.
+- **`built_at`:** machine local time (`synapse now --built-at`) — never inferred.
 - **`stale`:** `false` — freshly built.
 - **Body:** `summary` (plain-English, the explanation a senior engineer would give walking
   someone through this subsystem), `crux` (the few lines that carry the actual logic — **authored

package/skills/synapse-task/SKILL.md

@@ -60,8 +60,7 @@ into `status:` either — always go through this skill, which caps at
 2. Inspect its checklist items (`- [ ]` / `- [x]`).
 3. Determine the new `status:` value: `IN-PROGRESS` if any unchecked,
    `REVIEW` if all checked.
-4. Fetch machine local time: `date '+%Y-%m-%d %H:%M:%S %Z'` — never use inferred
-   time.
+4. Fetch machine local time: `synapse now` — never use inferred time.
 5. Update `status:` and `updated:` with two `synapse frontmatter set`
    calls, one per field: `synapse frontmatter set <path> status <value>`
    then `synapse frontmatter set <path> updated "{now}"`. Each call