Skip to content

v1.2.0 — Upgrade path + seat brains

Choose a tag to compare

View all tags
@diego-alfadev diego-alfadev released this 01 Jul 07:33
· 30 commits to main since this release
v1.2.0
1e97393

Bring your v0.3 brain to v1, and run one brain per workspace. Additive release — the brain
schema is unchanged (1.0), so an existing v1 brain has nothing to migrate; only a v0.3 brain runs an upgrade.

Highlights

  • v0.3 → v1 upgrade path. A paste-to-agent runbook (docs/UPGRADE-v0.3-to-v1.AGENT.md) + a hardened
    skill-side procedure: works on a copy, verified backup as a hard gate, content-conservation check
    (not a naive node count), no silent deletions, staging kept until after verification, working rollback.
  • Seat / global brain (one brain, a whole workspace of repos). Detect-on-Load now resolves the brain
    via the <!-- BEGIN:SYNAPTIC --> bridge pointer (not only a CWD-relative .synaptic/) and stays
    silent when a bridge is present     — so a sibling-repo working dir never offers to create a competing
    nested brain. Model: one brain per workspace; the workspace's breadth is up to you.
  • Harness: detect-then-deploy, prefer one user-level pointer (keeps work repos clean of brain
    refs), one source → many host targets; optional command-discovery stubs; a harness/setup/<host>.md
    record (your re-deploy recipe across machines).
  • Operating rules (conventions, guardrails) live in harness/ as the source and are deployed to
    the host's instruction context — no Top Guardrails block in BRAIN.md (removed from the template).
  • Three-tier zero-tooling install (agent self-install / npx degit / manual copy).

How to upgrade

  • New (no brain yet): point your agent at the skill — npx degit diego-alfadev/synaptic-core/standalone/synaptic .claude/skills/synaptic, or the agent self-installs from SKILL.md + MANIFEST.txt, or copy the folder. Then /synaptic-init.
  • Already on a v1 brain (older skill): just reinstall the skill to get v1.2.0 behavior — no brain migration (schema is unchanged). Re-run /synaptic-init on a wired brain to refresh the harness wiring.
  • On a v0.3 brain: run the upgrade — paste docs/UPGRADE-v0.3-to-v1.AGENT.md to your agent (or run /synaptic-upgrade once the v1 skill is installed). It bootstraps the skill, backs up, restructures to v1 on a copy, rewires your harness, verifies, and swaps only when green.

Not in this release (roadmap)

Generic version-aware /synaptic-upgrade dispatcher + migrations/ library (future schema bumps);
deploy.js --brain/--repos to automate seat-brain wiring; content-routing for nested global+project brains.

Assets 2
Loading