synapse-recall 0.1.0__tar.gz

synapse_recall-0.1.0/.dockerignore

@@ -0,0 +1,9 @@
+.git
+.env
+.DS_Store
+**/__pycache__
+**/.pytest_cache
+**/.mypy_cache
+**/.ruff_cache
+apps/web/node_modules
+apps/web/dist

synapse_recall-0.1.0/.env.example

@@ -0,0 +1,19 @@
+SYNAPSE_WEB_PORT=3000
+SYNAPSE_API_PORT=8000
+# Chat and embeddings are two OpenAI-compatible endpoints. The defaults below
+# are a local Cactus serving Gemma for both; point them at a hosted gateway and
+# set the matching key to run inference remotely instead.
+CHAT_BASE_URL=http://host.docker.internal:8080/v1
+EMBEDDING_BASE_URL=http://host.docker.internal:8080/v1
+CHAT_MODEL=google/gemma-4-E2B-it
+EMBEDDING_MODEL=google/gemma-4-E2B-it
+# Ignored by a local Cactus; required by anything hosted.
+CHAT_API_KEY=cactus-local
+EMBEDDING_API_KEY=cactus-local
+# Extra completion budget for a model that reasons before answering, which
+# would otherwise spend a call's whole budget thinking and return nothing.
+# Gemma answers directly, so it needs none; set a few thousand for one that
+# doesn't.
+CHAT_REASONING_TOKENS=0
+INFERENCE_MODE=auto
+CRUSTDATA_API_KEY=

synapse_recall-0.1.0/.github/copilot-instructions.md

@@ -0,0 +1,16 @@
+# Synapse Memory
+
+- Use the `synapse-memory` MCP server's `recall` tool whenever a task depends on company
+  decisions, systems, owners, blockers, project context, or prior organizational work.
+- Treat `recall` as the mandatory retrieval path. Do not bypass it with direct database or
+  graph queries because semantic fallback must create a retrieval episode for future use.
+- Use `get_episode` only to inspect an episode cited by `recall`.
+- Call `list_skill_specs` before a multi-step company research, architecture, or project
+  briefing task. If an approved workflow applies, fetch it with `get_skill_spec` and follow
+  its recall queries, steps, output contract, and guardrails.
+- Never assume a candidate or rejected procedural skill is available; MCP exposes approved
+  versions only.
+- Synapse MCP tools are read-only. Repository inspection, edits, commands, and validation
+  remain the responsibility of the VS Code agent and require the normal user approval flow.
+- The server uses the stable MCP Python SDK v1 (`mcp>=1.27,<2`). SDK documentation:
+  https://github.com/modelcontextprotocol/python-sdk/tree/v1.x

synapse_recall-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,46 @@
+# Publish to PyPI when a GitHub release is published.
+#
+# No API token exists anywhere: PyPI is configured to trust this specific
+# workflow in this specific repository, and the upload is authenticated by a
+# short-lived OIDC token GitHub mints for the job. That is why `id-token: write`
+# is granted here and nowhere else, and why the job is otherwise given nothing.
+#
+# Building and publishing are separate jobs so the artifact is produced by a job
+# with no credentials at all, and the job that can publish only ever downloads
+# it.
+
+name: Publish
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    # Named on PyPI's side too, so a trusted publish can only come from a run
+    # that entered this environment.
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

synapse_recall-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+.env
+.DS_Store
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+__pycache__/
+*.pyc
+apps/web/node_modules/
+apps/web/dist/
+# Python build artifacts, produced by `python -m build` before a release.
+/dist/
+test-results/
+playwright-report/
+slack-exports/

synapse_recall-0.1.0/.vscode/mcp.json

@@ -0,0 +1,9 @@
+{
+  "servers": {
+    "synapse-recall": {
+      "type": "stdio",
+      "command": "docker",
+      "args": ["compose", "run", "--rm", "-T", "--build", "mcp"]
+    }
+  }
+}

synapse_recall-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abhi Jain
+
+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.

synapse_recall-0.1.0/Makefile

@@ -0,0 +1,42 @@
+.PHONY: up down build logs replay slack-preview slack-import test lint reset cactus
+
+up:
+	docker compose up -d --build --wait
+
+down:
+	docker compose down
+
+build:
+	docker compose build
+
+logs:
+	docker compose logs -f api worker web
+
+replay:
+	@test -n "$${SYNAPSE_GROUP_ID}" || (echo "Set SYNAPSE_GROUP_ID to the account to replay into" && exit 1)
+	curl --fail --request POST "http://localhost:$${SYNAPSE_WEB_PORT:-3000}/api/demo/replay?group_id=$${SYNAPSE_GROUP_ID}"
+
+slack-preview:
+	@test -n "$${SLACK_EXPORT_DIR}" || (echo "Set SLACK_EXPORT_DIR to the extracted Slack export directory" && exit 1)
+	docker compose run --rm -T -v "$${SLACK_EXPORT_DIR}:/data/slack-export:ro" api python -m synapse.sources.slack_import --export-root /data/slack-export --channel all-docwise --channel scribe-iteration --max-events 40 --max-per-channel 30 --min-score 4 --dry-run
+
+slack-import:
+	@test -n "$${SLACK_EXPORT_DIR}" || (echo "Set SLACK_EXPORT_DIR to the extracted Slack export directory" && exit 1)
+	@test -n "$${SYNAPSE_GROUP_ID}" || (echo "Set SYNAPSE_GROUP_ID to the account this export belongs to" && exit 1)
+	docker compose run --rm -T -v "$${SLACK_EXPORT_DIR}:/data/slack-export:ro" api python -m synapse.sources.slack_import --export-root /data/slack-export --group-id "$${SYNAPSE_GROUP_ID}" --channel all-docwise --channel scribe-iteration --max-events 40 --max-per-channel 30 --min-score 4
+
+test:
+	docker compose run --rm --build test
+	npm --prefix apps/web run lint
+	npm --prefix apps/web run build
+
+lint:
+	docker compose run --rm api ruff check src tests migrations
+	docker compose run --rm api mypy src
+	npm --prefix apps/web run lint
+
+reset:
+	docker compose down --volumes
+
+cactus:
+	sh scripts/cactus-host.sh