Handbook

Intelligence Comprehension Service (ICS)

Granite-resident HTTP API for problem-class comprehension without embedding Forge Intelligence packs or LCDL/lmeta in clients.

Updated

Public URL: https://ics.forgedc.net
Canonical docs: forge-intelligence/docs/comprehension/ (private product repo)
ADR: ADR-0011

Role

Layer Responsibility
ICS Deterministic-first ladder → FI router/graph → session M/H
Clients Channel agents, KA, Cockpit, product bots — HTTP + bearer only
Lenses ForgeRun system of record; ICS returns attach payloads
CDP Automation lmeta (/v1/flows/run) — not comprehension

Quick API

Method Path Auth
GET /v1/health None
GET /v1/capabilities Bearer
POST /v1/comprehend Bearer
GET /v1/sessions/{id} Bearer
POST /v1/sessions/{id}/freeze Bearer
POST /v1/sessions/{id}/attach Bearer

Deploy

  1. Build image: docker build -f runtime/Dockerfile -t forge-intelligence-comprehend:latest .
  2. Granite: ./scripts/install-granite-ics.sh --build
  3. Tunnel: ./scripts/apply-cf-ics-tunnel.sh
  4. Smoke: curl https://ics.forgedc.net/v1/health