From d6c498f0cfecffb80b402601c3385dd2f67891fa Mon Sep 17 00:00:00 2001 From: Mikhail Chusavitin Date: Mon, 26 Oct 2026 10:54:22 +0300 Subject: [PATCH] docs: record issue implementation plan and validation results --- bible-local/README.md | 1 + bible-local/issue-plan-2026-10-26.md | 46 ++++++++++++++++++++++++++++ 2 files changed, 47 insertions(+) create mode 100644 bible-local/issue-plan-2026-10-26.md diff --git a/bible-local/README.md b/bible-local/README.md index eca6cda..7689d68 100644 --- a/bible-local/README.md +++ b/bible-local/README.md @@ -16,6 +16,7 @@ Project-specific architecture and operational contracts. | [09-vendor-spec.md](09-vendor-spec.md) | Vendor BOM and CFXML import contract | | [10-agent-api-guide.md](10-agent-api-guide.md) | End-to-end API guide for agents pricing servers from a TZ | | [11-lot-suggestions.md](11-lot-suggestions.md) | lot_suggestion column in qt_vendor_partnumber_seen — write/read contract for manual UI mappings | +| [issue-plan-2026-10-26.md](issue-plan-2026-10-26.md) | Open issue plan, implementation status and validation | | [decisions/](decisions/README.md) | Architectural decision log, one file per decision | ## Rules diff --git a/bible-local/issue-plan-2026-10-26.md b/bible-local/issue-plan-2026-10-26.md new file mode 100644 index 0000000..56a3237 --- /dev/null +++ b/bible-local/issue-plan-2026-10-26.md @@ -0,0 +1,46 @@ +# Issue implementation plan - 2026-10-26 + +Repository: https://git.mchus.pro/mchus/QuoteForge + +All issue pages were retrieved, including closed issues: seven total, six open. +Issue [#1](https://git.mchus.pro/mchus/QuoteForge/issues/1) was already closed and +is excluded from implementation. Work is sequential on +`fix/open-issues-security-recovery`, with one implementation commit per open issue. + +| Order | Issue | Implementation and acceptance | Status | +| --- | --- | --- | --- | +| 1 | [#2](https://git.mchus.pro/mchus/QuoteForge/issues/2) | Block foreign Host/Origin/Referer and cross-site browser requests in both routers; validate API body types; refuse saved-password reuse for a changed host/port/user. Middleware attack cases and setup credential tests must pass. | Implemented | +| 2 | [#4](https://git.mchus.pro/mchus/QuoteForge/issues/4) | Move LOT-bearing cart/rental events to delegated listeners and escaped data attributes; escape BOM and sync output; share HTML escaping; render toast as text. Malicious LOT regression checks and template tests must pass. | Implemented | +| 3 | [#7](https://git.mchus.pro/mchus/QuoteForge/issues/7) | Require a fresh verified archive outside rotation before reset, refuse unsynced/legacy states without explicit force, use transactional deletion, remove environment-triggered reset. Verify refusal, ZIP restore, backup failure and rollback. | Implemented | +| 4 | [#5](https://git.mchus.pro/mchus/QuoteForge/issues/5) | Persist TLS mode/CA in SQLite, expose setup controls, share policy across setup/sync/migration DSNs. Verify certificate trust, hostname checks, plaintext fallback policy and settings round-trip. | Implemented | +| 5 | [#3](https://git.mchus.pro/mchus/QuoteForge/issues/3) | Keep each migration file in one session, execute verify headers before history insertion, propagate FK failures. Verify failed queries/checks never enter history. | Implemented | +| 6 | [#6](https://git.mchus.pro/mchus/QuoteForge/issues/6) | Require Go 1.27.3, update vulnerable dependencies, block release on pinned govulncheck. Full tests, vet, security scan and macOS/Windows builds must pass. | Implemented | + +## Decisions + +- HTTP forms remain supported on setup and multipart vendor import; JSON APIs + reject non-JSON bodies. CLI clients may omit browser origin headers. +- CSP without inline scripts remains outside this patch; the issue lists it as optional. +- Forced reset still requires a verified backup. `QFS_RESET_LOCAL_DB` is ignored, + with a startup warning; only explicit CLI flags can initiate reset. +- TLS defaults to `preferred` for existing-server compatibility, as requested in + the issue. It permits plaintext fallback; use `verify-full` for authenticated + encryption. The setup form explains this distinction. +- `go 1.27.3` enforces the minimum compiler, including with `GOTOOLCHAIN=local`. + A redundant `toolchain go1.27.3` is removed by Go tooling and is unnecessary. +- The local ignored `.claude/skills/release/SKILL.md` was updated with the security + prerequisite; the shared Makefile and release script enforce it in git. + +## Validation and handoff + +Passed: `go test ./...`, `go vet ./...`, `node scripts/tests/html-security.cjs`, +`make security-check`, shell syntax and diff checks, and CGO-free builds for +macOS arm64 and Windows amd64. + +Govulncheck reports zero reachable vulnerabilities and one module-level advisory +whose affected code is not called. Gin's transitive quic-go was explicitly raised +to v0.59.1 after the first scan identified a reachable advisory in v0.59.0. + +The checks use temporary SQLite databases and synthetic certificates. They do +not exercise a live MariaDB server or browser automation. Review the draft PR +before merge; issue state changes and a production release remain separate steps.