Files
QuoteForge/bible-local/issue-plan-2026-10-26.md
T

3.7 KiB

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 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 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 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 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 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 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 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.