How alizahidraja/isnad works
ISNAD is a Python framework for claim-level provenance and trust grading in RAG and multi-agent systems, with an API, CLI, integrations, and a JavaScript audit-record verifier. The principal workflow registers transmitter grades, records an ordered claim chain, grades its weakest link, critiques claim content, and routes the combined verdict to serve, review, or quarantine; audit records make the judgment verifiable. The graph preserves documented corroboration, grounding, persistence, and integration capabilities. Source-index references and README statements support some links; unsampled implementation details are not assumed.
Main entry points: chain.py Claim and chain · registry.py Narrator registry · grading.py Weakest-link grading · embedding.py Content critics
Components 26
Trust and provenance
- Claim and chain
src/isnad/core/chain.py - Narrator registry
src/isnad/core/registry.py - Narrator identity
src/isnad/core/identity.py - Weakest-link grading
src/isnad/core/grading.py - Chain grounding
src/isnad/core/chain_grounding.py - Corroboration
src/isnad/core/corroboration.py - Trust policies
src/isnad/core/policies.py - Action decision
src/isnad/core/decision.py
Content criticism
- Content critics
src/isnad/critics/embedding.py - Critic protocol
src/isnad/critics/base.py - LLM criticism
src/isnad/critics/llm.py - NLI criticism
src/isnad/critics/nli.py - Numeric recomputation
src/isnad/critics/recompute.py - Matn rules
src/isnad/matn.py
API and operations
- Claim API
src/isnad/api/endpoints/claims.py - API application
src/isnad/api/app.py - CLI
src/isnad/cli/main.py - SQLAlchemy persistence
src/isnad/storage/sqlalchemy.py - Claim data models
src/isnad/models.py
Audit evidence
- Audit records
src/isnad/audit/merkle_log.py - Record signatures
src/isnad/audit/sign.py - JS record verifier
js/src/verify.ts
Integrations
- Framework integrations
src/isnad/integrations/langchain/callback.py - OTel ingestion
src/isnad/integrations/otel/ingest.py - MCP interface
src/isnad/integrations/mcp.py
Other components
- Pipeline operator
Connections 28
- Pipeline operator → Claim and chain: submits claim
README.md - Pipeline operator → Narrator registry: registers grades
README.md - Claim and chain → Narrator registry: looks up narrators
src/isnad/core/chain.py - Narrator registry → Narrator identity: resolves identities
src/isnad/core/registry.py - Claim and chain → Weakest-link grading: grades chain
src/isnad/__init__.py - Weakest-link grading → Narrator registry: uses grades
src/isnad/core/chain.py - Corroboration → Weakest-link grading: supports grading
README.md - Claim and chain → Chain grounding: checks grounding
src/isnad/api/endpoints/claims.py - Narrator registry → Trust policies: applies policies
src/isnad/core/registry.py - Claim and chain → Content critics: critiques content
README.md - Content critics → Critic protocol: implements protocol
src/isnad/critics/__init__.py - LLM criticism → Critic protocol: implements protocol
src/isnad/critics/__init__.py - NLI criticism → Critic protocol: implements protocol
src/isnad/critics/__init__.py - Content critics → Numeric recomputation: combines with
src/isnad/critics/__init__.py - Claim and chain → Matn rules: can use rules
src/isnad/__init__.py - Weakest-link grading → Action decision: supplies chain grade
README.md - Content critics → Action decision: supplies content verdict
README.md - Action decision → Claim API: routes action
src/isnad/api/endpoints/claims.py - API application → Claim API: mounts routes
src/isnad/api/app.py - Claim API → SQLAlchemy persistence: persists claims
src/isnad/api/app.py - SQLAlchemy persistence → Claim data models: uses models
src/isnad/storage/sqlalchemy.py - Claim API → Audit records: creates audit evidence
src/isnad/api/endpoints/claims.py - CLI → Audit records: exports and verifies
src/isnad/cli/main.py - Audit records → Record signatures: supports signatures
src/isnad/cli/main.py - JS record verifier → Audit records: verifies records
README.md - Framework integrations → Claim and chain: captures traces
README.md - OTel ingestion → Weakest-link grading: grades ingested links
src/isnad/integrations/otel/ingest.py - MCP interface → Pipeline operator: exposes tools