@continuity/core

Shared business logic for Continuity — used by @continuity/cli, the VS Code extension, and @continuity/mcp.

License: Proprietary — SEE LICENSE IN LICENSE. Not open source. Most users should install @continuity/cli or @continuity/mcp instead of depending on core directly.

npm ecosystem

| Package | Purpose | |---------|---------| | @continuity/cli | Terminal commands (continuity bin) | | @continuity/mcp | MCP server (continuity-mcp bin) | | @continuity/core | This library — journal, handoffs, search, licensing contract | | @continuity/benchmarks | Retrieval benchmark suites (installed on demand by CLI) |

What's inside

Published surface: dist/index.js + dist/index.d.ts. Deep imports are internal and may change in patch releases.

Decision storage & writes

• JournalStore — append-only decisions.jsonl journal, compaction, regeneration of derived cache
• DecisionWriteService — validated upsert/search with relationship and tag normalization
• PendingDecisionQueue — hook draft inbox promotion path

Context & handoffs

• HandoffGenerator — SESSION_HANDOFF.md assembly (architecture, deltas, commits, decisions)
• DeltaTracker — change detection since last sync
• BootstrapDecisionSelector / FallbackContextPolicy — MCP bootstrap and degraded read paths

Search & intelligence

• SemanticSearchService — embedding + hybrid keyword search
• RelationshipDetector — suggest supersedes/contradicts/depends-on edges
• MetricsTracker — usage and information-gain statistics
• StalenessScorer, DecisionDebtTracker, EntityExtractor

Protection & integrations

• FileProtection — protected-file pattern storage
• DecisionWebhookEmitter — HTTP fanout for decisions/tasks/notes
• Tracker adapters — Jira, Linear, GitHub Issues (services/trackers/)

Licensing & telemetry (CO-418 contract)

• resolveLicense, revalidateLicense, licenseCachePath — shared license cache at ~/.continuity/license-cache.json
• sanitizeTelemetryProperties, event allowlists — canonical PostHog/MCP telemetry chokepoint

Security & domain

• Credential scrubber and secret-pattern helpers (security/)
• Domain profiles for decision tagging (domain/)

Requirements

• Node.js >= 18

Install (advanced / library consumers)

npm install @continuity/core

The CLI bundles a copy of core at pack time (continuity-cli/bundled-core/) so the global npm install works without a separate core install. The MCP server bundles core via esbuild.

Stability

Treat anything not exported from dist/index.js as private. Semver applies to the documented export surface only.

License

Proprietary — Copyright © Hackerware. See LICENSE and Software License Terms.