bb0c33f8d3
## 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>
50 lines
2.1 KiB
Markdown
50 lines
2.1 KiB
Markdown
# Aphoria Guides
|
|
|
|
Quick-start guides and workflows for Aphoria users.
|
|
|
|
## Getting Started
|
|
|
|
| Guide | Audience | Description |
|
|
|-------|----------|-------------|
|
|
| [Solo Developer Guide](./solo-developer-guide.md) | Individual developers | Get immediate value on personal or side projects |
|
|
| [Enterprise Pilot Guide](./enterprise-pilot-guide.md) | Security teams | Run a measurable pilot with stakeholder buy-in |
|
|
| [Enterprise Quick Start](./enterprise-quick-start.md) | Platform engineering | 5-minute path from git clone to enforcing standards |
|
|
| [The First Scan](./the-first-scan.md) | Everyone | Your first Aphoria scan walkthrough |
|
|
| [Pre-Flight Checks](./pre-flight-checks.md) | DevOps | Pre-commit and CI integration |
|
|
|
|
## Core Workflows
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [Federating Truth](./federating-truth.md) | Trust Pack creation and distribution |
|
|
| [Multi-Team Policy Governance](./multi-team-policy-governance.md) | Managing policies across teams |
|
|
| [Policy Audit Trails](./policy-audit-trails.md) | Compliance and auditing |
|
|
| [Authoritative State Per Project](./authoritative-state-per-project.md) | Project-specific policy management |
|
|
|
|
## Advanced Topics
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [Golden Path Loop](./golden-path-loop.md) | Continuous policy improvement |
|
|
| [AAA Game Development](./aaa-game-development.md) | Unreal Engine patterns |
|
|
| [LLM Wiki Extraction](./llm-wiki-extraction.md) | Extract claims from technical docs using LLM skill |
|
|
|
|
## Reference Documentation
|
|
|
|
| Document | Description |
|
|
|----------|-------------|
|
|
| [CLI Reference](../cli-reference.md) | Complete command documentation |
|
|
| [Comparison Modes](../comparison-modes.md) | Detailed guide for claim comparison modes |
|
|
|
|
## Architecture
|
|
|
|
See [Architecture Documentation](../architecture/README.md) for:
|
|
- System design and data flow
|
|
- Concept matching algorithms
|
|
- Extension points and performance targets
|
|
|
|
## UAT Results
|
|
|
|
See [UAT Reports](../../uat/) for validation results:
|
|
- [Policy Source Tracking UAT](../../uat/2026-02-04-uat-real-world-policy-source.md) - Trust Pack workflow validation
|