jordan/stemedb
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
4012791e7e
stemedb/applications/aphoria/docs/guides/README.md
jml bb0c33f8d3 fix(api): enable querying of CLI-created community corpus items 
## Problem
CLI-created community corpus items (tier 3) were stored correctly but
invisible via API queries. Two issues blocked discoverability:

1. **Prefix mismatch**: API hardcoded 'community://pattern/' for
   aggregated patterns, but CLI creates 'community://rust/http/...' URIs
2. **Query parameter parsing**: Axum's default parser doesn't support
   bracket notation (?sources[]=value) used by the dashboard

Result: 0/22 CLI-created items were queryable.

## Solution

### Fix 1: Broaden Community Prefix
- Changed: 'community://pattern/' → 'community://' in corpus handler
- Impact: Now matches both aggregated patterns AND CLI-created items
- Backward compatible: Broader prefix includes narrower results

### Fix 2: Add QsQuery Extractor
- Added: serde_qs dependency + custom QsQuery extractor
- Supports: Bracket notation for array parameters (?sources[]=a&sources[]=b)
- Compatible: Works with JavaScript URLSearchParams standard
- Tested: 3 new unit tests for extractor behavior

## Verification
- ✅ All 22 CLI-created community items now queryable (was 0)
- ✅ Source filtering works: community (22), RFC (2), vendor (5)
- ✅ Multi-source queries work: ?sources[]=community&sources[]=rfc → 24
- ✅ All 89 API tests pass + 3 new extractor tests
- ✅ Clippy clean (0 warnings)
- ✅ No regressions in existing functionality

## Files Changed
- crates/stemedb-api/Cargo.toml: Add serde_qs dependency
- crates/stemedb-api/src/extractors.rs: New QsQuery extractor (117 lines)
- crates/stemedb-api/src/handlers/aphoria/corpus.rs: Use QsQuery, broaden prefix
- crates/stemedb-api/src/lib.rs: Export extractors module

Also includes: Scale-adaptive thresholds, wiki corpus extraction,
documentation updates, and dashboard UI improvements from prior work.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-09 15:54:35 +00:00

2.1 KiB
Raw Blame History

Aphoria Guides

Quick-start guides and workflows for Aphoria users.

Getting Started

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
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: