Topological Intel Realm SDK TS/JS

TypeScript SDK for the no-SSH Topological Intel Realm workflow.

Purpose

This package is the local integration layer used by target repositories during commit time. The git hook stays thin. The SDK performs the real work:

• load target configuration from .topological/config.json or environment variables
• inspect staged Git state
• build a filtered staged-tree archive from the Git index
• request a short-lived upload session from Topological Intel Realm API
• upload the snapshot archive
• submit the run metadata
• wait for generated artifacts
• write and stage only:
  • README.md
  • openspec/**
• delete obsolete generated surfaces that no longer belong to the contract

Configuration

Default config file:

{
  "apiBaseUrl": "https://topological-intel-realm-api.example.com",
  "targetId": "target-uuid",
  "repoKey": "savant-realms/topological-intel-realm-ui-web",
  "targetSecret": "topological-target-secret",
  "mode": "soft",
  "timeoutMs": 15000,
  "pollIntervalMs": 1500,
  "archiveFormat": "tar.gz",
  "generatedPathAllowlist": [
    "README.md",
    "openspec/"
  ]
}

Path:

• .topological/config.json

Development

npm install
npm run build
npm run test