Handoff: SVC-013-formula-runtime-boundary-audit formula-docx-service runtime boundary audit

Scope

• Service/area: formula-docx-service
• Task pack: docs/agents/service-tasks/formula-docx-service.md
• Goal: accept the bounded SVC-013 runtime-adapter evidence for the existing external Go Formula DOCX runtime and the docx-import-service adapter contract.
• Non-goals: creating services/formula-docx-service, public route promotion, OpenAPI service publication, K8s service promotion, MathType/OLE full corpus parity, or changes to legacy source under /Users/velikho/Desktop/WORKING/HOCTAPAZ/.

Docs Read

• go-platform/docs/architecture/service-responsibility-matrix.md
• go-platform/docs/architecture/legacy-api-map.md
• go-platform/docs/agents/service-agent-execution-queue.json
• go-platform/docs/agents/service-agent-closeout-ledger.json
• go-platform/docs/agents/service-tasks/formula-docx-service.md
• go-platform/docs/agents/service-tasks/import-mathtype-conversion-boundary.md
• go-platform/docs/agents/agent-handoff-format.md
• go-platform/docs/api/docx-import-service.md
• go-platform/docs/qa/service-agent-goal-completion-audit.md
• go-platform/docs/qa/service-agent-readiness-smoke.md

Legacy Evidence Read

• runtimes/go-formula-docx/**
• /Users/velikho/Desktop/WORKING/HOCTAPAZ/node-platform/apps/api/src/modules/formula-recognition/**
• /Users/velikho/Desktop/WORKING/HOCTAPAZ/node-platform/apps/api/src/modules/exam-paper-templates/**
• External runtime and legacy source were read-only evidence only; no runtime source changes are claimed.

Files Changed

• go-platform/docs/agents/handoffs/SVC-013-formula-runtime-boundary-audit.md
• go-platform/docs/agents/service-agent-closeout-ledger.json
• go-platform/docs/agents/service-agent-closeout-ledger.md

Behavior Implemented

• No new runtime code was implemented in this handoff.
• Existing audited docx-import-service adapter uses GO_FORMULA_DOCX_URL or baseline fallback and calls /v1/import/docx/simple.
• Existing audited adapter mapping preserves parser stats, latency, annotated fallback, warnings, and review-safety warnings.
• Existing audited runtime/deploy guards keep go-formula-docx as an internal runtime image, not a deployable services/formula-docx-service boundary.

Tests And Verification

• Command: sh scripts/test/go-formula-runtime-coverage.sh
• Result: passed.
• Evidence: runtime coverage verified Compose/Helm internal GO_FORMULA_DOCX_URL, RUNTIME_IMAGES, and absence from deployable service lists.
• Command: GOTOOLCHAIN=go1.25.11 go test ./services/docx-import-service/internal/parser/docx -count=1
• Result: passed.
• Evidence: parser adapter package passed.
• Command: GOTOOLCHAIN=go1.25.11 go test ./services/docx-import-service/... -count=1
• Result: passed.
• Evidence: all docx-import-service packages passed with the current runtime adapter contract.

Route State

• Legacy route: default /api/exam-import remains legacy-proxied in deploy/gateway/routes.json.
• Native route: formula-docx has no public route and no service-local /v1 route in Go platform.
• Gateway state: no route table targets formula-docx-service; this row is runtime-adapter evidence only.
• Rollback: keep the current import-service adapter fallback and internal runtime wiring. Do not create or route a formula-docx-service unless a later ADR explicitly promotes the runtime.

Data Notes

• Tables touched: none.
• Migration run: none.
• Validation report: not applicable because no data was migrated or backfilled.

Risks / Blockers

• MathType/OLE deterministic parity corpus, materialized refs, and status/download/accounting tests remain future import-service adapter work.
• No public API, default route, or deployable formula-docx-service promotion is accepted here.
• Runtime changes outside go-platform require a separate user-approved task.

Next Step

• Keep MathType/OLE work inside import-service adapter tests and docs unless an ADR promotes the Go Formula runtime into a formal deployable service boundary.