jml 7facac08a2 feat(aphoria): add enhanced bulk claim import with validation and reporting

Replaces tedious shell scripts with TOML-based bulk import:
- 340 lines bash → 200 lines TOML → 1 command
- 15 minutes → <1 second execution time
- 0% → 100% error detection before writes

Features:
- Pre-import validation (ID format, tiers, required fields, duplicates)
- Detailed reporting (table and JSON formats)
- Template generation (--template)
- Validation-only mode (--validate-only)
- Merge strategies (skip_existing, overwrite, fail_on_duplicate)

Documentation:
- Comprehensive guide: docs/guides/bulk-claim-import.md
- Updated README with quick start
- Example files with inline documentation

Validation catches:
- Invalid claim IDs (must be kebab-case)
- Unknown authority tiers
- Empty required fields
- Duplicate IDs within import file
- Duplicate concept paths (warnings)

Error reporting:
- Shows ALL errors before any writes (not just first failure)
- Clear context: claim index, ID, field, and error message
- Warnings for non-blocking issues

Testing:
- All clippy checks pass
- Production build succeeds
- Validated template generation, validation-only, dry-run, import, merge strategies

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

2026-02-10 05:31:04 +00:00

3.2 KiB

Raw Blame History

Aphoria Guides

Quick-start guides and workflows for Aphoria users.

New to Aphoria? Start with LLM-driven workflows for autonomous operation.

LLM Workflows (Primary Interface)

Aphoria is designed for LLM-driven autonomous operation:

Interface	Use Case	Documentation
Claude Code Skills	Interactive agent workflows	Load `/aphoria-claims`, `/aphoria-suggest`
Go ADK Agents	Fully autonomous CI/CD	See ADK-Go Integration
Custom LLM Integration	Any tool-use capable LLM	See LLM Wiki Extraction

Why LLM workflows?

Enforce naming conventions (manual errors break tail-path matching)
Reason about consequences (not just pattern matching)
Suggest claims from patterns automatically
Create extractors for custom patterns
Enable the autonomous flywheel (scan→fix→evaluate→claim→create)

The CLI is a debug/fallback interface. For production use, integrate LLM workflows.

Getting Started (Fallback: No LLM Access)

Guide	Audience	Description
Solo Developer Guide	Individual developers	Get immediate value on personal or side projects
Enterprise Pilot Guide	Security teams	Run a measurable pilot with stakeholder buy-in
Enterprise Quick Start	Platform engineering	5-minute path from git clone to enforcing standards
The First Scan	Everyone	Your first Aphoria scan walkthrough
Pre-Flight Checks	DevOps	Pre-commit and CI integration

Core Workflows

Guide	Description
Bulk Claim Import	Import claims in bulk from TOML files with validation
Federating Truth	Trust Pack creation and distribution
Multi-Team Policy Governance	Managing policies across teams
Policy Audit Trails	Compliance and auditing
Authoritative State Per Project	Project-specific policy management

Advanced Topics

Guide	Description
Golden Path Loop	Continuous policy improvement
AAA Game Development	Unreal Engine patterns
LLM Wiki Extraction	Extract claims from technical docs using LLM skill

Reference Documentation

Document	Description
CLI Reference	Complete command documentation
Comparison Modes	Detailed guide for claim comparison modes

Architecture

See Architecture Documentation for:

System design and data flow
Concept matching algorithms
Extension points and performance targets

UAT Results

See UAT Reports for validation results:

Policy Source Tracking UAT - Trust Pack workflow validation

3.2 KiB Raw Blame History