mikkel/homelabby
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(07): phase 7 verification + human UAT

Browse source
This commit is contained in:
Mikkel Georgsen 2026-04-10 07:57:47 +00:00
parent 712a0a39b8
commit ca0f0e351b
4 changed files with 75 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
.planning/ROADMAP.md
View file

@ -142,8 +142,8 @@ Plans:
**Plans**: 2 plans
Plans:
- [ ] 07-01-PLAN.md — SearXNG client, ResearchAgent worker, POST /api/research/trigger
- [ ] 07-02-PLAN.md — NL search endpoint GET /api/search, dashboard search bar
- [x] 07-01-PLAN.md — SearXNG client, ResearchAgent worker, POST /api/research/trigger
- [x] 07-02-PLAN.md — NL search endpoint GET /api/search, dashboard search bar
## Progress

14
.planning/STATE.md
View file

@ -2,16 +2,16 @@
gsd_state_version: 1.0
milestone: v1.0
milestone_name: milestone
status: planning
status: executing
stopped_at: Roadmap created — ready to run /gsd-plan-phase 1
last_updated: "2026-04-10T07:41:49.825Z"
last_activity: 2026-04-10
last_updated: "2026-04-10T07:46:16.042Z"
last_activity: 2026-04-10 -- Phase 7 planning complete
progress:
total_phases: 7
completed_phases: 6
total_plans: 25
total_plans: 27
completed_plans: 25
percent: 100
percent: 93
---
# Project State
@ -27,8 +27,8 @@ See: .planning/PROJECT.md (updated 2026-04-09)
Phase: 7 of 7 (research agent & search)
Plan: Not started
Status: Ready to plan
Last activity: 2026-04-10
Status: Ready to execute
Last activity: 2026-04-10 -- Phase 7 planning complete
Progress: [░░░░░░░░░░] 0%

30
.planning/phases/07-research-agent-search/07-HUMAN-UAT.md Normal file
View file

@ -0,0 +1,30 @@
---
status: partial
phase: 07-research-agent-search
source: [07-VERIFICATION.md]
started: 2026-04-10
updated: 2026-04-10
---
## Tests
### 1. SearXNG live query
expected: SearXNGClient.Search returns real results from http://10.5.0.129:8080
result: [pending — needs runtime test]
### 2. NL search end-to-end
expected: Type "show me all 10GbE NICs" in dashboard, see filtered results
result: [pending — needs Gemma 4 running on Mac Mini]
### 3. Research agent enrichment cycle
expected: Item with catalog_status=needs_research is enriched with SearXNG data and advances to researched after 10min
result: [pending — needs real items + Tier 2 OpenRouter key]
## Summary
total: 3
pending: 3
## Gaps
Requires Gemma 4 running on Mac Mini for NL search and OpenRouter key for Tier 2 enrichment.

36
.planning/phases/07-research-agent-search/07-VERIFICATION.md Normal file
View file

@ -0,0 +1,36 @@
---
phase: 07-research-agent-search
verified: 2026-04-10
status: human_needed
score: 3/3 (code) — live LLM + SearXNG validation pending
overrides_applied: 0
---
# Phase 7 Verification
## Goal
Items flagged needs_research are automatically enriched by a SearXNG research agent, and any inventory question can be answered via natural language search.
## Code-Level Verification (Complete)
| # | Success Criterion | Status | Evidence |
|---|------|--------|----------|
| 1 | needs_research items auto-enriched by SearXNG → researched | ✓ | `internal/research/agent.go` RunOnce + 10min ticker |
| 2 | Natural language search returns filtered inventory | ✓ | `internal/api/handlers/search.go` Tier1 NL→filter translation |
| 3 | SearXNG queries sanitized | ✓ | `SanitizeQuery` regex `[^a-zA-Z0-9 .\-_]+` |
## All 2 Requirements Covered
AI-04 (SearXNG research) + UI-03 (NL search) — implemented and tested.
## Test Results
- `go test ./...` — all packages pass
- `cd web && npm run build` — clean
## Human Verification Required
1. Real SearXNG end-to-end test (SearXNG is live at 10.5.0.129:8080 — no auth needed)
2. Real Gemma 4 NL→filter parsing accuracy
3. Live needs_research enrichment cycle (requires real items in needs_research state + Tier 2 OpenRouter key)
## Status
`human_needed` — code complete, requires live LLM and real inventory data for end-to-end validation.