Commit Graph

177 Commits

Author SHA1 Message Date
Ty 813af72d98 docs: remove live OPENAPI.md 2026-09-11 13:47:16 +00:00
Ty fb74b28404 docs: remove live DEPLOYMENT.md 2026-09-11 13:47:15 +00:00
Ty bbaa759f5e docs: remove live DATA-MODEL.md 2026-09-11 13:47:14 +00:00
Ty 5346fc8402 docs: remove live CONTENT-WOO.md 2026-09-11 13:47:12 +00:00
Ty dd952441aa docs: remove live IMPL-PLAN.md 2026-09-11 13:47:08 +00:00
Ty 3353f86f62 docs: remove live TEST-SPEC.md 2026-09-11 13:47:07 +00:00
Ty f5b3f4ebe6 docs: remove live UX-DESIGN.md 2026-09-11 13:47:06 +00:00
Ty b36e33e239 docs: remove live ARCHITECTURE.md (see archive + main 13bfa792) 2026-09-11 13:47:05 +00:00
Ty 6e2b9b3008 docs: archive index for pre-simplification specs 2026-09-11 13:46:40 +00:00
Ty 1254bd9cd7 docs: slim README to live file map 2026-09-11 13:46:17 +00:00
Ty 8d95a8e518 docs: replace AGENTS.md with Slice 1 contract 2026-09-11 13:46:13 +00:00
Ty 13ab6097e6 docs: add live CAPTURE spec on doc-simplification 2026-09-11 13:45:59 +00:00
Ty f1c60de355 docs: add live PRODUCT spec on doc-simplification 2026-09-11 13:45:53 +00:00
grokbot_ty 13bfa792bb docs: add release/deploy process with Gitea release workflow
- deploy/RELEASE-PROCESS.md: three build surfaces (dev, UAT, debug),
  Gitea release workflow, naming conventions, promotion and rollback
- AGENTS.md: add deploy/RELEASE-PROCESS.md to doc index

Follows GitHub release management conventions adapted for Gitea.
Dev builds run on cursor machine without tags. UAT builds require
a Gitea release tag. All test submissions use draft status.
2026-09-09 21:46:17 +00:00
Ty 9aa0ca3e92 Update docs/Build-release-standard.md 2026-09-09 21:40:32 +00:00
Ty 5e364cfa41 Update docs/Build-release-standard.md 2026-09-09 21:37:24 +00:00
Ty 478ae2bcc2 Add docs/Build-release-standard 2026-09-09 21:37:09 +00:00
Ty 5c1da50174 docs(structure): single Gates home and honest scaffold targets
Merge docs/structure-pass into main as docs SoT.

Nits fixed on 2c73e5f. check-structure.sh PASSED. Product locks unchanged.
2026-09-09 20:02:29 +00:00
grokbot_ty 2c73e5fa4e docs(structure): fix single-home wording nits
Point UAT at IMPL-PLAN only. Soften AGENTS and IMPL-PLAN so the meanings
table has one home while TEST-SPEC may still map cases to phases.
2026-09-09 19:56:31 +00:00
grokbot_ty 4576df7253 docs(structure): restore Gate B wording and harden pin
Drop the Gate B parenthetical that was not in the frozen AGENTS table.
Require Phase 0 labels in both compose and DEPLOYMENT, and pin the full
client-authoritative math lock phrase.
2026-09-09 19:47:17 +00:00
grokbot_ty 32547cad8c docs(audit): structure-pass decision trail
TSV log for the docs/structure-pass figure-it-out run.
2026-09-09 19:45:25 +00:00
grokbot_ty f855f91b8b docs: label Phase 0 scaffold targets on docs-only main
TEST-SPEC harness paths and compose Dockerfiles are deliverables until code
lands. Cases stay not run. Stops agents inventing alternate test trees.
2026-09-09 19:45:25 +00:00
grokbot_ty 8d65984936 docs: single Gates home and honest UX ownership
Move Gate A/B/C meanings to IMPL-PLAN. List UX-DESIGN as non-normative with
signed UX.md winning conflicts. List INVENTORY in AGENTS §0.
2026-09-09 19:45:25 +00:00
grokbot_ty bad96f944b docs(checks): add structure pin harness
Fails closed until ownership, calendar home, UX demotion, TEST-SPEC honesty,
and Gate A lock phrases hold. Reviewers re-run docs/checks/check-structure.sh.
2026-09-09 19:45:25 +00:00
grokbot_ty f02b53dfa2 docs(TEST-SPEC): add Fundamentals cross-cutting bar (FUND-1 through FUND-25) 2026-09-07 05:04:46 +00:00
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