@cubiczan/chp

Protocolo de endurecimiento de consenso para TypeScript — Perfil B puerta de capital, JSON canónico y libro de auditoría firmado.

Repositorio canónico del protocolo: icohangar-ops/consensus-hardening-protocol (especificación, vectores dorados, referencia Python)

Instalación

npm (este paquete)

npm install @cubiczan/chp

• Registro: npmjs.com/package/@cubiczan/chp

PyPI (referencia Python)

pip install consensus-hardening-protocol

• Registro: pypi.org/project/consensus-hardening-protocol

• Deliberación del Perfil A + la especificación normativa. Este paquete npm es la superficie TypeScript instalable para puertas de gasto/mandato — misma forma de canal que @cubiczan/codesentinel-mcp.

Related MCP server: @cubiczan/chp-mcp

Cómo encajan las piezas

CHP es el motor. Los servidores MCP son el transporte.

MCP client (Cursor / Claude / …)
        │  tools/call
        ▼
┌───────────────────────────┐
│  MCP server (transport)   │  ← agent-conductor, codesentinel-mcp, …
│  decision_gate            │
│  decision_adversary       │
│  evaluate_spend_gate      │
└─────────────┬─────────────┘
              │ depends on
              ▼
┌───────────────────────────┐
│  Published CHP packages   │
│  PyPI: consensus-hardening-protocol  (Profile A)
│  npm:  @cubiczan/chp                 (Profile B)  ← you are here
└───────────────────────────┘

Este paquete es el Perfil B (evaluateGate / approveHuman). Conéctalo a un servidor MCP como algo similar a evaluate_spend_gate. Las herramientas de deliberación del Perfil A (decision_gate, decision_adversary) viven en agent-conductor, que depende del paquete PyPI detrás de un puente stdio.

Una línea para MCP

Para Cursor / Claude sin escribir código de conexión:

npx -y @cubiczan/chp-mcp

Nombre del registro: io.github.icohangar-ops/chp-mcp. Fuente: cubiczan-chp-mcp.

Conformidad: Perfil B 30/30 · Perfil A (Python) 70/70.

Inicio rápido

import { evaluateGate, approveHuman } from "@cubiczan/chp";

const policy = {
  max_notional: 500,
  daily_cap: 2500,
  hitl_threshold: 250,
  min_confidence: 0.55,
  allowed_actions: ["LONG", "SHORT"],
};

const decision = evaluateGate(
  { action: "LONG", asset: "ETH", notional: 300, confidence: 0.9 },
  policy,
);
// → { state: "HITL_REQUIRED", requires_human: true, ... }

const locked = approveHuman(
  { action: "LONG", asset: "ETH", notional: 300, confidence: 0.9 },
  policy,
  "cfo@example.com",
);
// → { state: "LOCKED", allowed: true, ... }

Los fallos de reglas estrictas (max_notional, daily_cap, min_confidence, …) se recopilan antes de la prueba de umbral HITL. Un humano puede cruzar el umbral; no puede aprobar una violación de política (especificación §6.3 / §6.5).

Hashes entre lenguajes

Los hashes de contenido de CHP son SHA-256 sobre JSON canónico (especificación §3.1). Python emite flotantes completos como 100.0; el JSON.stringify de JavaScript emite 100. Este paquete formatea los conjuntos de campos con hash del Perfil B a la manera de Python para que los resúmenes de auditoría coincidan con los vectores dorados y la referencia Python.

Adaptador de conformidad

npm run build
python3 path/to/spec/conformance/run_conformance.py \
  --adapter-cmd "node dist/adapter.js" \
  --profile B

Las operaciones del Perfil A se reportan como unsupported (SKIP), no como FAIL.

Licencia

MIT.