Commit Graph

52 Commits

Author SHA1 Message Date
grokbot_ty 44c40feec5 docs(TEST-SPEC): add Gitea-only issue reporting rule to Results section
Gitea issues are the only mechanism for reporting issues found during a test
pass. Chat, Slack, and PR comments are not the bug log. On fail, open or
update a Gitea issue with case id and evidence pointer; the report table
blocker column links that issue. Do not invent issues that lack runner
evidence.
2026-09-07 04:42:45 +00:00
grokbot_ty 7cb1a8e81c docs: add Results recording & report-out section to TEST-SPEC 2026-09-07 04:41:36 +00:00
grokbot_ty 8453c15c28 Fix TEST-SPEC exit evidence: restore Ty as gate/phase owner where IMPL-PLAN mandates it
- Gate B: Ty confirms TV-3/6/7/10 on real fixtures; unit/API automated
- Gate C: Ty opens SLAB-UAT-* draft in real store admin; mocked-store not exit
- Phase 3: Ty publishes test slab as Woo draft SLAB-UAT-*; automation UI cases
- Phase 5: Ty judgment on species acceptance; automation Call 1/2 cases
- Phase 6: deployment smoke automated; Ty walks UAT-PRACTICE.md for UAT signoff
- Rename 'Cadence summary' to 'When tests are written'
- Phase 1 remainder: agent automation drives calibrated → ready (keep, per #20)
2026-09-07 04:20:50 +00:00
grokbot_ty e287f5c1c3 Rewrite TEST-SPEC: satisfy issue #20
- Add Section 1: case ID naming convention (all prefixes and abbreviations defined)
- Add Section 2: how cases are executed (paths, tools, staging for unit/contract/integration/E2E/ops)
- Restructured every case table to three columns: what must happen, where the rule lives, how verified
- Replaced cadence column with when-written in pyramid overview; cadence summary preserved
- Fixed all exit-evidence lines: agent-written test automation replaces Ty-driven curl
- Expanded all acronyms on first use; no magic acronyms in case descriptions
- Removed Ty-driven manual testing; automation is the verification path
2026-09-07 04:17:14 +00:00
grokbot_ty aa43fa7628 docs: fix TEST-SPEC completeness and alignment gaps
Fixes:
- GC-2 SoT: add CONTENT-WOO §2.5 (duplicate SKU lookup lives there, not OPENAPI)
- GC-5: add http:// WOO_BASE_URL startup rejection case (AGENTS §4 + DEPLOYMENT §3)
- UIE-3 SoT: add UX §Publish for exact duplicate-SKU wording
- UIE-8: add brand voice/GEO to Settings UI expected behavior (IMPL-PLAN Phase 3)
- W-5: add failed publish → retained photos → retry → success path
- API-9: add DELETE /slabs/{id} contract case (OPENAPI §slabs DELETE)
- API-10: add test-woo fails-closed case (OPENAPI §settings test-woo)
- TAX-3: add client re-pull on anchor advance (ARCHITECTURE §7)
- INS-3: fix to reference request_payload/response_payload instead of non-existent columns
- Cross-reference table: update ranges for new cases, split INS row
2026-09-07 03:04:51 +00:00
grokbot_ty 72d1cfa920 docs: add TEST-SPEC engineer bar (pyramid through PROD) 2026-09-07 02:36:31 +00:00
grokbot_ty a06a4a0123 docs: purge scope-out sections; affirmative plan only 2026-09-07 02:22:34 +00:00
grokbot_ty 80af35721f docs: align tracked files to single coherent SoT
Contradictions resolved:

- AGENTS.md: add 'Known stale PRD lines' section (FR17, FR19, FR40, NFR, FR42)
  so PRD's cross-reference resolves
- AGENTS §6: remove 'tag sets' from Call 1 body description (Call 1 only uses
  species and attribute lists)
- PROMPTS.md: shipped defaults path corrected to backend/app/prompts/ (matches
  DEPLOYMENT repo layout)
- PROMPTS.md: Call 1 notes removed feat-* and fig-* from taxonomy list (Call 1
  returns free-text observations mapped to feat-* tags by server, not fig-*)
- PROMPTS.md: Call 2 template field names aligned with CONTENT-WOO defaults
  (width_avg_in, width_min_in, width_max_in, length_in_remainder)
- UX.md §112: remove 'tag lists' from Call 1 body description
- DATA-MODEL: prompt files location corrected from /data/prompts/ to
  backend/app/prompts/ (bind-mounted read-only to /app/prompts/)
- DEPLOYMENT: backup script updated (prompts are version-controlled in repo,
  no separate backup needed)
- docker-compose.yml: prompts mount corrected to ../backend/app/prompts
2026-09-07 02:17:22 +00:00
grokbot_ty 68185d8bd7 docs: README positive locks (drop don't-ladders; SoT is main) 2026-09-07 01:59:32 +00:00
grokbot_ty e5ab62df17 docs: AGENTS.md positive locks only (drop don't-ladders) 2026-09-07 01:48:16 +00:00
grokbot_ty 6442a60ecc docs: drop AGENTS conflict-ladder precedence slop
Docs should agree. Replace ranked disagreement order with a plain
ownership map and keep only real archive mistakes plus open #4 pins.
2026-09-07 01:40:00 +00:00
grokbot_ty c0c217b754 Purge docs/process/overnight-docs-refactor/ — leftover process docs, not SoT 2026-09-07 01:36:27 +00:00
grokbot_ty 10858d2502 docs: lock WOO_BASE_URL Whidbey Wood Store in inventory 2026-09-06 23:04:56 +00:00
grokbot_ty b97e4187b2 docs: lock APP_HOSTNAME slab.local (LAN-first) in inventory 2026-09-06 23:04:03 +00:00
grokbot_ty 45f0f4ea1c docs: draft Gate B inventory for ubuDual5060 practice host
SSH verified as ty. Ports, Docker, Tailscale IPs recorded.
APP_HOSTNAME and WOO_BASE_URL still TBD.
2026-09-06 23:01:09 +00:00
grokbot_ty 00346ce0f4 docs: drop RESUME-SESSIONS scratch from branch 2026-09-06 22:49:39 +00:00
grokbot_ty 8d757283d7 docs: signed UX + PC browsers + UAT practice walk
Replay local tip onto origin/docs/refactor-v2. Keeps remote UX-DESIGN
wireframes. Adds signed UX, browser matrix (phone+PC), and UAT-PRACTICE.
2026-09-06 22:49:32 +00:00
Ty 3f3eff24a5 docs(#10): add UX-DESIGN wireframes for review
Publish the phone screen inventory, ASCII wireframes, error states, and
UAT cases so Ty can review issue #10 on docs/refactor-v2. UX.md points
at UX-DESIGN for presentation.
2026-09-05 22:39:12 -07:00
grokbot_ty f3117c7905 docs: mill-owner UX rewrite on local inference 2026-09-02 03:32:29 +00:00
grokbot_ty 96e689fb94 docs: mill-owner UX from sources, fields on the happy path 2026-09-02 03:13:07 +00:00
grokbot_ty 3455cd9a6f docs: unslop UX.md (pstack mandatory)
Happy path then usual failures, same locks. Cut cute section titles, dense capture blob, and Continue-system voice.
2026-09-02 02:45:20 +00:00
grokbot_ty f0014676ee docs: UX.md happy path then the usual failures
Drop the lecture cadence. Same product locks.
2026-09-02 02:43:20 +00:00
grokbot_ty 0c5ee36a7a docs: split list-ready into capture, submit, and confidence-gate
Name every DATA-MODEL submit field in mill-owner English. Issue #9 empty-below-0.7 stays a subset; species plus one figure is not enough to list.
2026-09-02 02:40:28 +00:00
grokbot_ty b5c45c75be docs: list-ready is the full store row, not the confidence-gate trio
Ty rejected the three-bullet UX block. Name the DATA-MODEL submit set. Empty-below-0.7 stays a subset for vision fields only.
2026-09-02 02:38:15 +00:00
grokbot_ty 06a5c23c5f docs: finish capture UX vs TECH-SPEC pipeline
Overlay and knobs are the check; no checker-generated mask copy.
Sheet is a knob when auto misses. Axis confirm by eye. 1600 is an
after-crop size gate (retake), not a vision slogan. Builds on e2bdd80.
2026-09-02 02:32:17 +00:00
grokbot_ty e2bdd80538 docs: UX capture is overlay and knobs, not photo banners
Ty rejected invented mask-quality copy. Confirm/retake/knobs only. Field strings stay on review and settings.
2026-09-02 02:30:26 +00:00
grokbot_ty 776681d892 docs: unslop UX, README, and store copy for a human reader
Same locks. Drop ticket numbers and agent shorthand from the mill-owner facing files.
2026-09-02 00:37:36 +00:00
grokbot_ty 33ce86c2e9 docs: unslop DEPLOYMENT store URL and Woo password setup
Drop issue-number pointers so a person can follow deploy/auth without the tracker.
2026-09-02 00:36:31 +00:00
grokbot_ty fc5df28b8c docs: pair locks for #14 #2 #17 #18 (PPM product OK)
Two taxonomy stamps, validation/module + 412 hash mismatch, SKU charset
vs UTF-8 titles, 409 open_existing required, draft = phone form + failed row.
2026-09-02 00:34:44 +00:00
grokbot_ty d413e2f935 docs(#12,#14,#18): synced species, taxonomy anchor, 409/422 recovery
Species UI and Call 1 use only Woo-synced leaves. Middle tier manufactures a
taxonomy last-modified anchor (bump on stored-subset change only; test-woo
always resyncs; publish if >1h). CONTENT-WOO field-level 409/422 recovery.
IMPL acceptance and AGENTS locks updated.
2026-09-02 00:33:05 +00:00
grokbot_ty be221433ea docs(#15): mask is load-bearing; inline knobs, live re-run, U2Net deferred
TECH-SPEC states BG removal defines the measurement footprint and silent
corruption failure mode. Four knobs stay on capture with live overlay on the
source photo. POC is client-side only; U2Net try-harder deferred, not deleted.
ARCHITECTURE swimlane and clarifications match.
2026-09-02 00:32:49 +00:00
grokbot_ty 7b7ed712c2 docs(#10): UX interaction spec plus remaining POC issue write-back
UAT is POC, so #10 is in DOC COMPLETE. Capture knobs live on-screen, review
confidence presentation, 409/422 field recovery, taxonomy cache, portable
Call 1→Call 2, shared validation. U2Net Try harder deferred, not deleted.
2026-09-02 00:30:47 +00:00
Dev Manager 3921a9dfa2 docs(#11): WOO_BASE_URL in compose, HTTPS-only, Settings read-only
Check in implementable deploy/docker-compose.yml, .env.example, and Caddy
fragment. Store URL is env SoT (not a settings row). Application Password
setup stays in DEPLOYMENT §5 (issue #5).
2026-09-02 00:28:56 +00:00
grokbot_ty 8c88c97c1a docs(#9): Call 1 confidence gate ≥0.7 prefill, <0.7 empty + mandatory gate
Pin threshold rules: above pre-populates mutable fields; below leaves empty and
blocks ready until species + ≥1 figure are set. Manual authoritative; assist-only.
Also completes CONTENT-WOO Call 1 primary pre-fill (#8).
2026-09-02 00:28:56 +00:00
grokbot_ty 2f87e09c16 docs(#8): Call 1 pre-populates review taxonomy when inference on
State that Call 1 vision results fill species, character, tags, and attributes
on the review screen; manual entry remains authoritative; assist-only.
2026-09-02 00:28:07 +00:00
grokbot_ty 7bfba9f39f docs(#5): Woo auth is WordPress Application Passwords
Replace consumer-key auth with dedicated low-priv WP user + application
password over HTTPS Basic Auth. AES-GCM at rest, server-only calls, rotation
via profile revoke. CONTENT-WOO, OPENAPI, ARCHITECTURE, DEPLOYMENT, DATA-MODEL,
AGENTS, IMPL-PLAN, README.
2026-09-02 00:27:46 +00:00
grokbot_ty fcad50d86e docs(#3): OPENAPI duplicate SKU means exists in Woo, any status
Replace stale "already published" wording on 409 duplicate_sku.
2026-09-02 00:26:46 +00:00
grokbot_ty fe2dd3200b docs: add overnight refactor briefing and review artifacts 2026-09-01 19:13:25 +00:00
grokbot_ty 779fa7d484 docs: archive PRD, gate map in AGENTS, drop PM-DESIGN
Move PRD to docs/archive/PRD-2026-08.txt with superseded header.
Rewrite live references. AGENTS gains Gate A/B/C table, freeze
provenance, open-doc-defects slot, and archive rank. README/TECH-SPEC
/ARCHITECTURE de-dupe. DoD green: delete PM-DESIGN-ALIGNMENT.
2026-09-01 05:30:27 +00:00
grokbot_ty 3ac5e36dc3 docs: factual CONTENT-WOO/DATA-MODEL fixes + hybrid Phases 3-5
CONTENT-WOO: PNG media, fig-*/feat-* tags, five locked attributes,
AGENTS-cited Woo safety. DATA-MODEL/OPENAPI drop server sheet prefs
and PWA wording. ARCHITECTURE status reflects locked hybrid topology.
IMPL Phases 3-5 rewritten for hybrid (all-photos@1024, confidence 0.7,
no offline-era paths).
2026-09-01 05:28:03 +00:00
grokbot_ty 369d404c29 docs: env-agnostic deploy (APP_HOSTNAME, inventory, Caddy order)
DEPLOYMENT is host-variable: APP_HOST/APP_HOSTNAME/ports, inventory
worksheet, corrected Caddy handle /api/* before frontend. Drop RemBG
and output_px 1000 as deploy SoT. AGENTS §9, README, IMPL host wording
match. Historical .201 lab is a non-normative callout only.
2026-09-01 05:26:45 +00:00
grokbot_ty 48720d83e1 docs: stop wrong-code paths (OPENAPI store-only, Gate C, TV-10)
OPENAPI PUT stores client-sent derived fields; POST/examples return
calibrated. AGENTS + IMPL require TV-1 through TV-10. IMPL Phase 1
owns Gate C hybrid capture + Woo draft listing; Phase 2 is deferred
stub; Phase 6 is online UAT only; processing status removed. AGENTS
known-stale list matches HEAD (drop false FR4 /12 warning).
2026-09-01 05:25:52 +00:00
grokbot_ty e1e087b736 docs: unslop PM-DESIGN-ALIGNMENT for human review 2026-09-01 04:13:47 +00:00
grokbot_ty 6e918db3a5 docs: add PM↔design alignment audit (workspace HOLD lift for this file) 2026-09-01 04:08:01 +00:00
grokbot_ty 4ec478f383 docs: finish Gate A contradiction patches
Align PRD/README/CONTENT-WOO/DATA-MODEL/OPENAPI/DEPLOYMENT with AGENTS.md
and the POC review package: hybrid client SoT, bdft without /12, server AES
creds, woo_create_status draft|publish with SLAB-UAT-* firebreak, deploy smoke
and health path /api/health.
2026-09-01 03:59:46 +00:00
Dev Manager 457711bd78 docs: Gate A freeze — AGENTS.md + hybrid Phase 0
Lock hybrid topology, Woo draft+SLAB-UAT-* UAT firebreak, client-authoritative
TECH-SPEC math, and sequenced inference after Gate C. Supersede obsolete
server-pipeline Phase 0 and flag Phase 2 offline/OCR/ruler as out of POC scope.
2026-09-01 03:59:07 +00:00
grokbot_ty a94d81d8ce docs: set gitea-atd Ty_Tech/SlabUploader as remotes SoT 2026-09-01 02:43:39 +00:00
Ty 4d9f3070a7 docs: lock inference review — prompts, Call 1/2, feat tags
Restore CONTENT-WOO, add PROMPTS.md, and align PRD/architecture/API
with inference decisions: prompt files on disk, 0.7 confidence gate,
species constrained to Woo leaves, Call 2 prose-only + templates,
feat-* tags, and inference_enabled gating.
2026-08-31 17:11:05 -07:00
Ty 4e97770373 docs: lock revised capture pipeline and hybrid architecture
Rewrite PRD, tech spec, data model, and OpenAPI around the 2026-08-27
decisions: client-side mask/measure/crop, U2Net on demand, Woo as product
source of truth, draft-only local state. Architecture records topology C
through the status machine. Drop the old CONTENT-WOO spec until the
Call 2 prompt review finishes.
2026-08-27 19:26:45 -07:00
Hermes Agent bee3bcc278 docs: full implementation plan (PRD decisions locked + specs 1-4 + impl plan)
- PRD: 20 locked decisions, open items cleared, fence fixed
- docs/TECH-SPEC-PIPELINE.md: deterministic math + 9 test vectors (deliverable #1)
- docs/ARCHITECTURE.md, DATA-MODEL.md, OPENAPI.md (deliverable #2),
  CONTENT-WOO.md, DEPLOYMENT.md (deliverable #4), IMPL-PLAN.md
- README rewritten; .gitignore added

AGENTS.md pending Ty's approval (protected file write was blocked).
2026-08-24 12:27:20 -07:00