@cubiczan/chp

Consensus Hardening Protocol für TypeScript — Profile B Kapital-Gate, kanonisches JSON und signiertes Audit-Ledger.

Kanonisches Protokoll-Repository: icohangar-ops/consensus-hardening-protocol (Spezifikation, Goldene Vektoren, Python-Referenz)

Installation

npm (dieses Paket)

npm install @cubiczan/chp

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

PyPI (Python-Referenz)

pip install consensus-hardening-protocol

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

• Profile-A-Deliberation + die normative Spezifikation. Dieses npm-Paket ist die installierbare TypeScript-Oberfläche für Ausgaben-/Mandats-Gates — mit derselben Kanalform wie @cubiczan/codesentinel-mcp.

Related MCP server: @cubiczan/chp-mcp

Wie die Teile zusammenpassen

CHP ist die Engine. MCP-Server sind der Transport.

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

Dieses Paket ist Profile B (evaluateGate / approveHuman). Binden Sie es als etwas wie evaluate_spend_gate in einen MCP-Server ein. Profile-A-Deliberations-Tools (decision_gate, decision_adversary) befinden sich auf agent-conductor, das hinter einer stdio-Brücke vom PyPI-Paket abhängt.

MCP-Einzeiler

Für Cursor / Claude, ohne Klebecode zu schreiben:

npx -y @cubiczan/chp-mcp

Registry-Name: io.github.icohangar-ops/chp-mcp. Quelle: cubiczan-chp-mcp.

Konformität: Profile B 30/30 · Profile A (Python) 70/70.

Schnellstart

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

Fehler bei harten Regeln (max_notional, daily_cap, min_confidence, …) werden vor dem HITL-Schwellenwerttest gesammelt. Eine Person darf die Schwelle überschreiten; eine Richtlinienverletzung darf sie jedoch nicht genehmigen (Spezifikation §6.3 / §6.5).

Sprachübergreifende Hashes

CHP-Inhalts-Hashes sind SHA-256-Hashes über kanonisches JSON (Spezifikation §3.1). Python gibt ganzzahlige Floats als 100.0 aus; JSON.stringify von JavaScript gibt 100 aus. Dieses Paket formatiert die gehashten Feldsätze von Profile B auf die Python-Weise, sodass die Audit-Digests mit den Goldenen Vektoren und der Python-Referenz übereinstimmen.

Konformitätsadapter

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

Profile-A-Operationen werden als unsupported (SKIP) gemeldet, nicht als FAIL.

Lizenz

MIT.