# sntllgnc/cint architecture

> Architecture diagram of the GitHub repository sntllgnc/cint, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sntllgnc/cint
- Repository: https://github.com/sntllgnc/cint

## Overview

CINT is a local decision-bound action-control runtime: it turns an untrusted request into a checked decision, grants executable authority only through a signed one-shot receipt, then revalidates and executes through an adapter before verifying and sealing the outcome. The README also identifies a preserved, separate Agent Floor delegated-review adapter. The principal stages and capability boundaries are documented; some internal call details are unsampled, so those links are omitted rather than inferred from imports alone.

Main entry points: [`src/cint/challenge.ts`](https://github.com/sntllgnc/cint/blob/main/src/cint/challenge.ts) (State Challenge), [`src/cint/execution.ts`](https://github.com/sntllgnc/cint/blob/main/src/cint/execution.ts) (Execution Coordinator), [`src/adapters/codex-delegation/runner.js`](https://github.com/sntllgnc/cint/blob/main/src/adapters/codex-delegation/runner.js) (Delegation Runner), [`src/cint/revalidation.ts`](https://github.com/sntllgnc/cint/blob/main/src/cint/revalidation.ts) (Revalidation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["CINT Control Plane"]
  node_cintcli["CINT CLI<br/>[cli.ts]"]
  node_intent["Intent Reconstruction<br/>[intent.ts]"]
  node_principal["Principal Resolution<br/>[principal.ts]"]
  node_authority["Authority Records<br/>[authority.ts]"]
  node_policy["Policy Evaluation<br/>[policy.ts]"]
  node_challenge["State Challenge<br/>[challenge.ts]"]
  node_decision["Decision<br/>[decision.ts]"]
  node_canonical["Canonical Validation<br/>[canonical.ts]"]
  node_schema["Runtime Schemas<br/>[schema.ts]"]
  node_contracts["Typed Contracts"]
end

subgraph group_execution["Receipt Execution"]
  node_receipt["Signed Receipt<br/>[receipt.ts]"]
  node_store[("Receipt Store<br/>[store.ts]")]
  node_revalidation["Revalidation<br/>[revalidation.ts]"]
  node_execution["Execution Coordinator<br/>[execution.ts]"]
  node_outcome["Outcome Verification<br/>[outcome.ts]"]
  node_rollback["Rollback<br/>[rollback.ts]"]
  node_evidence["Evidence Records<br/>[evidence.ts]"]
  node_seal["Evidence Seal<br/>[seal.ts]"]
end

subgraph group_adapters["Action Adapters"]
  node_synthetic["Synthetic Patch"]
  node_codexadapter["Codex Adapter<br/>[index.ts]"]
end

subgraph group_legacy["Delegated Review"]
  node_legacycli["Agent Floor CLI<br/>[cli.js]"]
  node_legacyrunner["Delegation Runner<br/>[runner.js]"]
  node_legacyadmission["Result Admission<br/>[admission.js]"]
  node_legacyaudit["Trace Audit<br/>[audit.js]"]
  node_legacypolicy["Task Policy<br/>[policy.js]"]
end

node_requester(("Requester"))

node_requester -->|"submits request"| node_cintcli
node_cintcli -->|"starts workflow"| node_intent
node_intent -->|"resolves principal"| node_principal
node_principal -->|"resolves authority"| node_authority
node_authority -->|"checks authority"| node_challenge
node_challenge -->|"challenges policy"| node_policy
node_challenge -->|"produces decision"| node_decision
node_decision -->|"ADMIT issues"| node_receipt
node_receipt -->|"revalidates receipt"| node_revalidation
node_revalidation -->|"consumes atomically"| node_store
node_store -->|"authorizes execution"| node_execution
node_execution -->|"dispatches action"| node_synthetic
node_execution -->|"dispatches action"| node_codexadapter
node_execution -->|"verifies outcome"| node_outcome
node_outcome -->|"seals evidence"| node_seal
node_outcome -->|"restores on failure"| node_rollback
node_execution -->|"records execution"| node_evidence
node_canonical -->|"validates records"| node_schema
node_challenge -->|"validates record"| node_authority
node_challenge -->|"verifies records"| node_canonical
node_revalidation -->|"rechecks state"| node_challenge
node_legacycli -->|"inspects surface"| node_legacyrunner
node_legacyrunner -->|"admits results"| node_legacyadmission
node_legacyrunner -->|"audits traces"| node_legacyaudit
node_legacyrunner -->|"loads policy"| node_legacypolicy

click node_cintcli "https://github.com/sntllgnc/cint/blob/main/src/cint/cli.ts"
click node_intent "https://github.com/sntllgnc/cint/blob/main/src/cint/intent.ts"
click node_principal "https://github.com/sntllgnc/cint/blob/main/src/cint/principal.ts"
click node_authority "https://github.com/sntllgnc/cint/blob/main/src/cint/authority.ts"
click node_policy "https://github.com/sntllgnc/cint/blob/main/src/cint/policy.ts"
click node_challenge "https://github.com/sntllgnc/cint/blob/main/src/cint/challenge.ts"
click node_decision "https://github.com/sntllgnc/cint/blob/main/src/cint/decision.ts"
click node_canonical "https://github.com/sntllgnc/cint/blob/main/src/cint/canonical.ts"
click node_schema "https://github.com/sntllgnc/cint/blob/main/src/cint/schema.ts"
click node_contracts "https://github.com/sntllgnc/cint/tree/main/src/cint/types"
click node_receipt "https://github.com/sntllgnc/cint/blob/main/src/cint/receipt.ts"
click node_store "https://github.com/sntllgnc/cint/blob/main/src/cint/store.ts"
click node_revalidation "https://github.com/sntllgnc/cint/blob/main/src/cint/revalidation.ts"
click node_execution "https://github.com/sntllgnc/cint/blob/main/src/cint/execution.ts"
click node_outcome "https://github.com/sntllgnc/cint/blob/main/src/cint/outcome.ts"
click node_rollback "https://github.com/sntllgnc/cint/blob/main/src/cint/rollback.ts"
click node_evidence "https://github.com/sntllgnc/cint/blob/main/src/cint/evidence.ts"
click node_seal "https://github.com/sntllgnc/cint/blob/main/src/cint/seal.ts"
click node_synthetic "https://github.com/sntllgnc/cint/blob/main/src/cint/adapters/synthetic-file-patch.ts"
click node_codexadapter "https://github.com/sntllgnc/cint/blob/main/src/cint/adapters/codex/index.ts"
click node_legacycli "https://github.com/sntllgnc/cint/blob/main/src/cli.js"
click node_legacyrunner "https://github.com/sntllgnc/cint/blob/main/src/adapters/codex-delegation/runner.js"
click node_legacyadmission "https://github.com/sntllgnc/cint/blob/main/src/adapters/codex-delegation/admission.js"
click node_legacyaudit "https://github.com/sntllgnc/cint/blob/main/src/adapters/codex-delegation/audit.js"
click node_legacypolicy "https://github.com/sntllgnc/cint/blob/main/src/adapters/codex-delegation/policy.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cintcli,node_intent,node_principal,node_authority,node_policy,node_challenge,node_decision,node_canonical,node_schema,node_contracts toneBlue
class node_receipt,node_store,node_revalidation,node_execution,node_outcome,node_rollback,node_evidence,node_seal toneAmber
class node_synthetic,node_codexadapter,node_requester toneMint
class node_legacycli,node_legacyrunner,node_legacyadmission,node_legacyaudit,node_legacypolicy toneRose
```

## Components

### CINT Control Plane

- [CINT CLI](https://github.com/sntllgnc/cint/blob/main/src/cint/cli.ts): `src/cint/cli.ts`
- [Intent Reconstruction](https://github.com/sntllgnc/cint/blob/main/src/cint/intent.ts): `src/cint/intent.ts`
- [Principal Resolution](https://github.com/sntllgnc/cint/blob/main/src/cint/principal.ts): `src/cint/principal.ts`
- [Authority Records](https://github.com/sntllgnc/cint/blob/main/src/cint/authority.ts): `src/cint/authority.ts`
- [Policy Evaluation](https://github.com/sntllgnc/cint/blob/main/src/cint/policy.ts): `src/cint/policy.ts`
- [State Challenge](https://github.com/sntllgnc/cint/blob/main/src/cint/challenge.ts): `src/cint/challenge.ts`
- [Decision](https://github.com/sntllgnc/cint/blob/main/src/cint/decision.ts): `src/cint/decision.ts`
- [Canonical Validation](https://github.com/sntllgnc/cint/blob/main/src/cint/canonical.ts): `src/cint/canonical.ts`
- [Runtime Schemas](https://github.com/sntllgnc/cint/blob/main/src/cint/schema.ts): `src/cint/schema.ts`
- [Typed Contracts](https://github.com/sntllgnc/cint/tree/main/src/cint/types): `src/cint/types`

### Receipt Execution

- [Signed Receipt](https://github.com/sntllgnc/cint/blob/main/src/cint/receipt.ts): `src/cint/receipt.ts`
- [Receipt Store](https://github.com/sntllgnc/cint/blob/main/src/cint/store.ts): `src/cint/store.ts`
- [Revalidation](https://github.com/sntllgnc/cint/blob/main/src/cint/revalidation.ts): `src/cint/revalidation.ts`
- [Execution Coordinator](https://github.com/sntllgnc/cint/blob/main/src/cint/execution.ts): `src/cint/execution.ts`
- [Outcome Verification](https://github.com/sntllgnc/cint/blob/main/src/cint/outcome.ts): `src/cint/outcome.ts`
- [Rollback](https://github.com/sntllgnc/cint/blob/main/src/cint/rollback.ts): `src/cint/rollback.ts`
- [Evidence Records](https://github.com/sntllgnc/cint/blob/main/src/cint/evidence.ts): `src/cint/evidence.ts`
- [Evidence Seal](https://github.com/sntllgnc/cint/blob/main/src/cint/seal.ts): `src/cint/seal.ts`

### Action Adapters

- [Synthetic Patch](https://github.com/sntllgnc/cint/blob/main/src/cint/adapters/synthetic-file-patch.ts): `src/cint/adapters/synthetic-file-patch.ts`
- [Codex Adapter](https://github.com/sntllgnc/cint/blob/main/src/cint/adapters/codex/index.ts): `src/cint/adapters/codex/index.ts`

### Delegated Review

- [Agent Floor CLI](https://github.com/sntllgnc/cint/blob/main/src/cli.js): `src/cli.js`
- [Delegation Runner](https://github.com/sntllgnc/cint/blob/main/src/adapters/codex-delegation/runner.js): `src/adapters/codex-delegation/runner.js`
- [Result Admission](https://github.com/sntllgnc/cint/blob/main/src/adapters/codex-delegation/admission.js): `src/adapters/codex-delegation/admission.js`
- [Trace Audit](https://github.com/sntllgnc/cint/blob/main/src/adapters/codex-delegation/audit.js): `src/adapters/codex-delegation/audit.js`
- [Task Policy](https://github.com/sntllgnc/cint/blob/main/src/adapters/codex-delegation/policy.js): `src/adapters/codex-delegation/policy.js`

### Other components

- **Requester**

## Connections

- Requester → CINT CLI: submits request
- CINT CLI → Intent Reconstruction: starts workflow
- Intent Reconstruction → Principal Resolution: resolves principal
- Principal Resolution → Authority Records: resolves authority
- Authority Records → State Challenge: checks authority (evidence: `src/cint/challenge.ts`)
- State Challenge → Policy Evaluation: challenges policy (evidence: `src/cint/challenge.ts`)
- State Challenge → Decision: produces decision
- Decision → Signed Receipt: ADMIT issues
- Signed Receipt → Revalidation: revalidates receipt
- Revalidation → Receipt Store: consumes atomically
- Receipt Store → Execution Coordinator: authorizes execution
- Execution Coordinator → Synthetic Patch: dispatches action
- Execution Coordinator → Codex Adapter: dispatches action
- Execution Coordinator → Outcome Verification: verifies outcome (evidence: `src/cint/execution.ts`)
- Outcome Verification → Evidence Seal: seals evidence
- Outcome Verification → Rollback: restores on failure (evidence: `src/cint/rollback.ts`)
- Execution Coordinator → Evidence Records: records execution (evidence: `src/cint/execution.ts`)
- Canonical Validation → Runtime Schemas: validates records (evidence: `src/cint/canonical.ts`)
- State Challenge → Authority Records: validates record (evidence: `src/cint/challenge.ts`)
- State Challenge → Canonical Validation: verifies records (evidence: `src/cint/challenge.ts`)
- Revalidation → State Challenge: rechecks state (evidence: `src/cint/revalidation.ts`)
- Agent Floor CLI → Delegation Runner: inspects surface (evidence: `src/cli.js`)
- Delegation Runner → Result Admission: admits results (evidence: `src/adapters/codex-delegation/runner.js`)
- Delegation Runner → Trace Audit: audits traces (evidence: `src/adapters/codex-delegation/runner.js`)
- Delegation Runner → Task Policy: loads policy (evidence: `src/adapters/codex-delegation/runner.js`)
