vestige/docs
Sam Valladares 50e7f2d0fb feat(connectors): external-source connector layer + GitHub Issues (#57)
Make Vestige a durable, local, semantically-searchable retrieval layer over an
external system of record (GitHub Issues first), citing back to the canonical
record. Unlike a live ticket-system MCP proxy, Vestige keeps a durable embedded
index: searchable offline, joinable with the rest of memory, temporally
versioned, and re-syncable idempotently with no duplication.

Phases 1-2 of #57 plus a GitHub reference connector and source-aware search:

- Source envelope on KnowledgeNode/IngestInput (source_system, source_id,
  source_url, source_updated_at, content_hash, synced_at, source_project,
  source_type, source_author). Migration V17: nullable columns (additive),
  partial UNIQUE index on (source_system, source_id), connector_cursors table.
- Idempotent sync primitives in vestige-core: upsert_by_source (content-hash
  change detection), connector cursor checkpoints, reconcile_source_tombstones
  (invalidate-don't-delete via bitemporal valid_until).
- Connector contract + run_sync driver + GitHub Issues connector behind the
  optional `connectors` feature (on by default in vestige-mcp, off in the core
  library default so non-connector consumers link no HTTP client).
- source_sync MCP tool ({"repo": "owner/name"}); token from GITHUB_TOKEN env
  only. Search results gain a sourceRecord citation for connector memories.

Adversarial review fixes: GitHub `since` Z-form (the `+00:00` offset corrupted
the cursor server-side), un-tombstone clears superseded_by too, cursor never
advances past a failing record, Link next-url host-pinned (token-leak guard),
records_seen counts new records only.

Verified: cargo check/test/clippy -D warnings green across the workspace
(default and connectors features); 483 core tests pass. Version bump to 2.1.27
and tag deferred to release.

Refs #57

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-19 01:21:59 -05:00
..
adr docs: rewrite local-dev-postgres-setup for container approach; bump pg16 -> pg18 2026-05-27 15:09:23 +02:00
blog Add simple Vestige update flow 2026-05-01 13:33:54 -05:00
integrations Add OpenCode integration and safer startup 2026-06-15 17:06:01 -05:00
launch Add OpenCode integration and safer startup 2026-06-15 17:06:01 -05:00
plans docs: rewrite local-dev-postgres-setup for container approach; bump pg16 -> pg18 2026-05-27 15:09:23 +02:00
prd Merge pull request #62 from delandtj/design-adr-0002-phase-2-execution 2026-06-15 16:25:38 -05:00
AGENT-MEMORY-PROTOCOL.md Add OpenCode integration and safer startup 2026-06-15 17:06:01 -05:00
claude-desktop-config.json Initial commit: Vestige v1.0.0 - Cognitive memory MCP server 2026-01-25 01:31:03 -06:00
CLAUDE-SETUP.md fix: v2.0.1 release — fix broken installs, CI, security, and docs 2026-03-01 20:20:14 -06:00
COGNITIVE_SANDWICH.md Release v2.1.23 Receipt Lock hardening 2026-05-27 19:03:16 -05:00
COMPOSED_GRAPH.md Add ComposedGraph composition ledger 2026-06-18 16:00:29 -05:00
CONFIGURATION.md Add OpenCode integration and safer startup 2026-06-15 17:06:01 -05:00
CONNECTORS.md feat(connectors): external-source connector layer + GitHub Issues (#57) 2026-06-19 01:21:59 -05:00
FAQ.md Add OpenCode integration and safer startup 2026-06-15 17:06:01 -05:00
INSTALL-INTEL-MAC.md Add simple Vestige update flow 2026-05-01 13:33:54 -05:00
MERGE_SUPERSEDE.md feat(merge-supersede): Phase 3 — diff-previewed, reversible merge/supersede controls (v2.1.25) (#75) 2026-06-12 12:55:31 -05:00
ROADMAP.md Add OpenCode integration and safer startup 2026-06-15 17:06:01 -05:00
SANHEDRIN_RECEIPTS.md docs: add test integrity delta receipt sketch 2026-06-18 23:02:32 +00:00
SANHEDRIN_TEST_INTEGRITY_DELTAS.md docs: add test integrity delta receipt sketch 2026-06-18 23:02:32 +00:00
SCIENCE.md Prepare agent-neutral hardening release 2026-05-24 16:09:44 -05:00
STORAGE.md Prepare agent-neutral hardening release 2026-05-24 16:09:44 -05:00
VESTIGE_STATE_AND_PLAN.md Add OpenCode integration and safer startup 2026-06-15 17:06:01 -05:00