docs: hounfour v8 integration research — living document

[janitooor]

Summary

Living research document mapping concrete integration opportunities between loa's existing patterns and loa-hounfour v8.3.1's capabilities.

• Inventories all hounfour v8.x exports (201 schemas, 232 conformance vectors, 10 module paths)
• Maps 9 integration opportunities across 3 tiers (schema alignment, structural correspondence, direct consumption)
• Prioritizes proposals with effort estimates and risk assessments
• Includes code examples for each opportunity

Integration Opportunities

#	Opportunity	Tier	Priority
1	Consumer Contract — machine-verifiable structural correspondence	T1	P0
2	Flatline dampened scoring (computeDampenedScore())	T2	P1
3	Audit trail chain hashing (computeChainBoundHash())	T1/T2	P1
4	BudgetEnforcer as GovernedResource<T>	T2	P2
5	Bridge state machine formalization	T2	P2
6	Constraint registry → ConstraintCondition alignment	T1/T2	P2
7	Feature flag registry	T1	P2
8	Metering ledger as AuditTrail	T2	P3
9	x402 payment schema awareness	T1	P3

Recommended Sequencing

1. Phase A (P0): Consumer Contract — establishes the verification bridge
2. Phase B (P1): Dampened flatline + audit chain hashing — highest-impact quality improvements
3. Phase C (P2+): Registry formalization, state machine vocabulary, deep integration

Intent

This is an exploratory research document, not an implementation PR. It's intended to be iterated on as we identify which integrations deliver the most value. Each opportunity can become its own implementation PR when ready.

Builds on #436 (version pin update to @8.3.1).

Test plan

• Document review for accuracy of hounfour capability mapping
• Validate priority ordering makes sense for current roadmap
• Identify which P0/P1 items to convert into implementation issues

🤖 Generated with Claude Code