@cubiczan/chp

Consensus Hardening Protocol для TypeScript — капитальный гейт Profile B, канонический JSON и подписанный журнал аудита.

Канонический репозиторий протокола: icohangar-ops/consensus-hardening-protocol (спецификация, эталонные векторы, Python reference)

Установка

npm (этот пакет)

npm install @cubiczan/chp

• Реестр: npmjs.com/package/@cubiczan/chp

PyPI (эталонная реализация на Python)

pip install consensus-hardening-protocol

• Реестр: pypi.org/project/consensus-hardening-protocol

• Профиль A — обсуждение, плюс нормативная спецификация. Этот npm-пакет — устанавливаемая TypeScript-оболочка для гейтов расходов и мандатов — та же форма канала, что и у @cubiczan/codesentinel-mcp.

Related MCP server: @cubiczan/chp-mcp

Как сочетаются компоненты

CHP — это движок. MCP-серверы — это транспорт.

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
└───────────────────────────┘

Данный пакет реализует профиль B (evaluateGate / approveHuman). Подключается к MCP-серверу, например, как evaluate_spend_gate. Инструменты согласования профиля A (decision_gate, decision_adversary) находятся в agent-conductor, который зависит от PyPI-пакета, использующего через мост stdio.

MCP одной строкой

Для Cursor / Claude Code без написания склейки:

npx -y @cubiczan/chp-mcp

Имя в реестре: io.github.icohangar-ops/chp-mcp. Исходный код: cubiczan-chp-mcp.

Соответствие: Profile B 30/30 · Profile A (Python) 70/70.

Быстрый старт

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, ... }

Срабатывания жёстких правил (max_notional, daily_cap, min_confidence, …) собираются до проверки порога HITL. Человек может пересечь порог, но не может одобрить нарушение политики (спецификация §6.3 / §6.5).

Межязыковые хэши

Контентные хэши CHP — это SHA-256 над каноническим JSON (спецификация §3.1). Python выводит целые значующие float как 100.0; JavaScript'а JSON.stringify выводит 100. Этот пакет форматирует наборы хешируемых полей Profile B следовавательно как в Python, чтобы аудиторские дайджесты совпадали с эталонными векторами и Python reference.

Адаптер соответствия

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

Операции Profile A возвращаются как unsupported (SKIP), а не FAIL.

Лицензия

MIT.