8000 GitHub - sargonxg/AGON: Experimental Rust engine for mapping actors, claims, commitments, and contradictions in policy and conflict documents. · GitHub
[go: up one dir, main page]

Skip to content
sargonxgPublic

About

Experimental Rust engine for mapping actors, claims, commitments, and contradictions in policy and conflict documents.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

50 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

AGON

Purpose, code and a playable introduction

Current local Rust verification and remaining acceptance gates

Represent claims, actors, interests, constraints and commitments as reviewable objects anchored to source spans.

Experimental conflict engine. Experimental perception engine; inferred interests and narratives are proposals. Original TACITUS code is Apache-2.0; third-party code, model weights and evidence retain their own terms.

Setup, code walkthrough, research & verification · Play the original 8-bit teaching adventure · Demo credits

The original House of Evidence teaching adventure; synthetic case, separate from this project’s runtime

Research: RAG, long-context evidence use, GraphRAG. What TACITUS borrows, adds and still needs to measure.

A source-grounded conflict-perception engine from TACITUS.

Rust Status License

AGON is a Rust research system for turning difficult human text—transcripts, correspondence, minutes, case notes, and policy records—into typed, reviewable conflict objects. It focuses on actors, claims, interests, constraints, leverage, commitments, events, narratives, contradictions, friction signals, source spans, and provenance.

Experimental research software. AGON is not a legal, clinical, human-resources, mediation, or autonomous decision product. Its outputs are analytical proposals for human review, not findings about people or disputes.

30-second read

  • Problem: fluent summaries often blur attribution, evidence, chronology, commitments, contradiction, and uncertainty.
  • Approach: typed contracts and deterministic validation surround optional model-based extraction.
  • Output: a graph-shaped conflict scene in which claim-bearing objects point back to exact source spans.
  • Current scope: an experimental Rust workspace, API/workbench scaffold, fixtures, tests, and deployment tooling. Production validation remains incomplete.

What AGON is designed to preserve

Object Question it helps an analyst ask
Actor Who is speaking, acting, affected, or represented?
Claim What was asserted, by whom, and on what evidence?
Interest What underlying objective may explain a stated position?
Constraint What legal, procedural, financial, temporal, or relational limit applies?
Leverage What resource or dependency changes bargaining power?
Commitment Who promised what, to whom, by when, and with what status?
Event What happened, when, and according to which source?
Narrative What broader frame connects multiple claims?
Contradiction Which statements or commitments cannot be jointly sustained?
Provenance Which exact source span supports each object and transformation?

Inference and observation are not interchangeable. Interests, narratives, patterns, and causal explanations require explicit uncertainty and review.

Architecture

AGON is organized as a layered perception stack:

raw text
   │
   ▼
segmentation, speaker turns, time expressions, lexical features
   │
   ▼
structured extraction proposals behind typed contracts
   │
   ▼
actor resolution, commitment state, chronology, span verification
   │
   ▼
friction, contradiction, and pattern proposals
   │
   ▼
calibration, abstention, provenance, review questions
   │
   ▼
API, graph output, and analyst-facing workbench

The workspace separates contracts, text processing, temporal analysis, extraction, embeddings, storage, fusion, inference, scoring, CLI, server, and benchmarks into independently testable crates. See Cargo.toml and ARCHITECTURE.md for the current structure.

Core design principles:

  • Evidence before fluency: claim-bearing objects should cite exact source text.
  • Typed contracts: models propose data; schemas and deterministic code define admissible structure.
  • Human review: pattern labels and hypotheses remain contestable and should expose their basis.
  • Temporal state: commitments and claims can be made, confirmed, contested, superseded, or broken.
  • Provider separation: model choice should not define the public data contract.
  • Abstention over forced certainty: insufficient evidence should remain visible as insufficient evidence.

Build and inspect locally

Requirements vary by feature. A recent Rust toolchain is sufficient to inspect the workspace and run components that do not require external services.

git clone https://github.com/sargonxg/AGON.git
cd AGON
cargo test --workspace
cargo run -p aco-server --bin agon-server

Model-backed extraction, database features, and cloud deployment require additional configuration. Review .env.example, BUILDPLAN.md, and the operator documentation before supplying credentials or data. Do not upload confidential material until the deployment, retention, provider, and access-control path has been independently reviewed.

Check an actual evidence span

The CLI can now verify a model-supplied quotation against exact canonical source text. It checks the displayed quote and hash together, uses Unicode code-point bounds, and exits nonzero for a non-exact result. This is a working source-integrity tool, separate from the experimental conflict-reasoning modules.

cargo run --locked -p aco-cli -- verify-evidence --text canonical-source.txt --span evidence-span.json

Current evidence boundary

The repository contains substantial implementation work, but architecture, test counts, fixtures, and demonstrations do not by themselves establish analyst usefulness or real-world accuracy. Public claims about extraction quality, contradiction detection, calibration, pattern detection, or downstream decision improvement require published evaluation against appropriate baselines and human review.

Named conflict patterns are particularly sensitive. A textual resemblance to a pattern is not a diagnosis, intent determination, or conclusion about a person. Public interfaces should use neutral language, expose supporting spans, and make alternative explanations easy to record.

Place in the TACITUS stack

  • AGON explores evidence-linked conflict perception.
  • KAIROS explores temporal structure: events, episodes, overlap, delay, and commitment status.
  • DIALECTICA builds reviewable, portable context capsules for PRAXIS.
  • TCGC provides a benchmark surface for structural conflict reasoning.

These repositories share a research direction but should be judged by their individual code, tests, status statements, and published evidence.

Documentation

License status

The licensing posture is not yet finalized. The root LICENSE file controls the current repository; do not infer redistribution rights from package metadata or badges. The root license and Cargo package metadata should be aligned before any formal public release.

Package manifests declare Apache-2.0 for original TACITUS code, as approved by the repository owner on 12 November 2026. Preserve LICENSE, NOTICE and third-party notices. External evidence and model weights retain their separate terms.

Current native, database, security and Apache-2.0 verification · Third-party rights and credits.

The Dockerfile requires BuildKit (enabled by default in current Docker). It builds locked source with Rust 1.95.0, retains embedded migrations and license notices, and avoids repeated source-copy layers on vfs builders.

About

Experimental Rust engine for mapping actors, claims, commitments, and contradictions in policy and conflict documents.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0