Skip to content

refactor(v1.0): P1-P7 — cleanup, MCP 5→3, tests qa→test/, config deploy→etc/, docs - #69

Closed
eSlider wants to merge 5 commits into
mainfrom
refactor/v1.0-p1
Closed

refactor(v1.0): P1-P7 — cleanup, MCP 5→3, tests qa→test/, config deploy→etc/, docs#69
eSlider wants to merge 5 commits into
mainfrom
refactor/v1.0-p1

Conversation

@eSlider

@eSlider eSlider commented Aug 21, 2026

Copy link
Copy Markdown
Owner

v1.0 refactor (P1-P7)

Plan: docs/refactor-v1.0.md, epic gitea #65. Parallel to cash-sprint #62.

P1 cleanup — rm deprecated bin/kb/, bin/serve.go; fixtures → testdata; httpapi Ingest → bin/brain/add.go.

P4 MCP 5→3 — surface = search/get/audit; stats/ingest stay OpenAPI paths.

P5 tests taxonomyqa/test/{system,stress}; test/README.md tiers; historical load report → docs.

P6 FHS configdeploy/etc/{searxng,picoclaw}; compose/skills/docs updated.

P7 docs — README 'What's in 2dph today'; docs index lists test taxonomy + etc/.

P2/P3 verified already lean (compose 9 services; active tools kept). mapstructure not needed (yaml.v3 struct tags). CI green (system tier).

… fixtures

- rm bin/kb/{add,index,search,watch} (deprecated; Go replacements in bin/brain)
- rm bin/serve.go (replaced by bin/brain/serve.go)
- rm bin/tools/web-search fixtures (unused test data)
- httpapi Ingest now execs bin/brain/add.go --json
- ci: drop bash -n bin/kb/search
- docs/refactor-v1.0.md: measure-first plan + A/B (epic #65)
…earch fixtures to testdata

- spec.go: stats/ingest no longer exposed as MCP tools (stay OpenAPI paths)
- spec_test.go: assert minimal surface (search/get/audit only)
- websearch: move fixtures from bin/tools to internal/websearch/testdata
- skills/brain/tools.md regenerated
- docs/refactor-v1.0.md: status P1/P2/P3/P4, corrected counts
…cs rework

P5 tests taxonomy:
- qa/ → test/{system,stress}; system is the offline CI tier
- test/README.md: how to run each tier (system/stress/integration)
- historical load-test report → docs/load-test-summary-2026-08-11.md

P6 FHS config:
- deploy/{searxng,picoclaw} → etc/{searxng,picoclaw}
- compose + skill/docs paths updated; docker compose config -q clean

P7 documentation:
- README: add 'What's in 2dph today' (store, HNSW, BM25, hybrid, graph-hop,
  ACID, incremental, DuckDB as auxiliary)
- docs/README index: test taxonomy + etc/ config

Epic #65, milestone v1.0.
@eSlider eSlider changed the title refactor(v1.0): drop deprecated bin/kb+serve, MCP surface 5→3, plan doc refactor(v1.0): P1-P7 — cleanup, MCP 5→3, tests qa→test/, config deploy→etc/, docs Aug 21, 2026
- README: 'Tool layout' table (bin/{subject}/{method}.go) + explain bin/cgo
  as the CGO toolchain (not CI/CD); move cli/complete.go out of table
- test/README: drop verbose stress-gate details; keep tier table + commands
- PLAN: architecture map now matches reality (no deprecated kb/, adds
  test/, etc/, contacts/ci/qa/watch subjects)
…→ pkg/

Rule (D14, apply ALWAYS, also for var/ etc/): bin/{subject}/{verb}-{object}.go
singular, no trailing 's'. subject = object/system you act on; verb = action.

contacts → split by target:
- bin/contact/import.go        read/normalize csv/vcf/mab → out (pure)
- bin/brain/import-contact.go  upsert contacts into the brain (info leafs)
- bin/onlyoffice/import-contact.go  reconcile contacts into OO CRM
- pkg/contact                  Contact type + parsers + Load/Dedupe/Render

Generic (no 2dph deps) internal/ → pkg/ (public reusable):
- cli, cmdbin, contact, duckstats, httpapi
- 36 import sites updated; internal/ keeps 2dph-specific (brain, chats, facts,
  gitlog, mailconv, mdleaves, ocr, reasoner, websearch)

AGENTS.md documents the rule; docs/skills/PLAN paths synced.
@eSlider eSlider closed this Aug 21, 2026
@eSlider
eSlider deleted the refactor/v1.0-p1 branch August 21, 2026 17:00
eSlider added a commit that referenced this pull request Aug 21, 2026
fix(brain/import-git): single parser, best-effort skips (#69)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant