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

5.0 KiB

Issue implementation plan - 2026-10-26

Repository: https://git.mchus.pro/mchus/QuoteForge

Six issues (#2-#7) remain open. Their initial fixes were merged into main in PR #8, with release notes in v3.50. Acceptance and remaining rule compliance work continue sequentially on fix/issue-acceptance-and-migration-safety.

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 and real setup/runtime router tests reject attacks without changing saved credentials or user data. Acceptance passed
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 headless Chrome DOM checks pass. Acceptance passed
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. The original implementation PR is merged. Remaining acceptance work and rule compliance are tracked below; issue state changes are separate.

Acceptance follow-up

Issue #2

go test ./cmd/qfs -run TestRequestBoundaryOnApplicationRouters -count=1 exercises the production setup and runtime route constructors with temporary SQLite state. Foreign setup forms, opaque origins and rebinding hosts are rejected, text/plain JSON receives 415, and both setup handlers reject saved password reuse for a changed destination. Local reads still succeed. Saved credentials, project/configuration counts and the pending queue remain unchanged. The setup router construction was extracted without changing its routes so this regression exercises the same middleware registration as startup.

Issue #4

node scripts/tests/html-security-browser.cjs passes in headless Chrome with an isolated temporary profile. It executes the actual template rendering functions in a browser DOM with controlled API responses. Both cart layouts, rental, parsed BOM, toast, pending sync errors, error history and repair errors preserve malicious strings as text. Real click/change/focus events preserve LOT values through delegated handlers; no injected elements or payload execution are observed. This is a rendering integration check, not a full application navigation test. Set CHROME_BIN outside macOS to select a Chrome executable.