afi-config

Canonical configuration and JSON Schema library for AFI Protocol

This repository is the single source of truth for all AFI Protocol configuration schemas, templates, and validation utilities. It provides JSON Schema definitions that are consumed by all other AFI modules.

Quick Links

📖 AFI Config Overview - Comprehensive guide to schemas and usage

Contents

• schemas/ - JSON Schema definitions for all AFI configurations
• templates/ - Configuration templates and starter files
• cli_utils/ - CLI utilities for config validation
• docs/ - Documentation and authoring guidelines
• tests/ - Schema validation tests
• codex/ - Codex governance artifacts and policies
  • governance/droids/ - Droid operation policies (AFI Droid Charter)

Core Schemas

• character.schema.json - Agent/character configs (afi-core)
• schemas/pipeline/v1/ - Canonical pipeline topology contract afi.pipeline.v1 (FACTORY-CONTRACT; supersedes the retired ungoverned pipeline.schema.json / blueprint.schema.json drafts)
• schemas/pipeline-template/v1/, schemas/analysis-plugin/v1/, schemas/analyst-strategy-config/v1/, schemas/analyst-strategy-registration/v1/, schemas/provider-strategy-binding/v1/, schemas/composition-ref/v1/ - The analyst-configurable pipelines V1 contract family
• plugin-manifest.schema.json - Plugin manifests
• vault.schema.json - T.S.S.D. Vault configs (afi-infra)
• .afi-codex.schema.json - Codex metadata schema (all repos)

Usage

Other AFI repos consume these schemas for configuration validation:

• afi-core: Character and agent configurations
• afi-reactor: Manifest-driven pipeline orchestration
• afi-infra: T.S.S.D. Vault and infrastructure
• afi-token: Smart contract configurations

Governance

AFI Protocol uses Codex as the canonical registry for schemas, policies, and provenance.

This repository now includes a Codex governance namespace:

• AFI Droid Charter v0.1 – defines how Factory droids and automated agents are expected to operate across AFI repos Path: codex/governance/droids/AFI_DROID_CHARTER.v0.1.md

Schema and Codex changes in this repo should respect the Charter and are subject to human review.

Development

# Install dependencies
npm install

# Run tests
npm test

# Validate schemas
npm run validate

# Build TypeScript utilities
npm run build

Environment Variables

This repo has no runtime server and needs no secrets to build or test. The only supported variable tunes a tooling threshold; see .env.example.

Variable	Default	Purpose
AFI_MAX_FILE_KB	1024	Max size (KB) for any tracked file before the large-file guard fails in CI/pre-commit.

Migration Note

2025-11-14: Consolidated schema and configuration content into this repo.