Evidence: Block 1 · Foundational (block-1)

• block type: block
• date: 2026-08-16
• resulting state: closed/verified
• story points (combined assembled cost): 9153
• execution id: 20260816.122441.637Z-c478c6cc

Stories built

• Establish the standard-library-only Go module and decoder command. (architecture) [story]

Reusable compacts

• ARCHITECTURE_compact.md

Stacked context

• compass: COMPASS.md (SP 2942)
• implements: ARCHITECTURE.md (SP 721)
• stack: go.md (SP 3646)
• stack: common.md (SP 1807)

Build directory changes

• cmd/toml-decoder/main.go
• go.mod
• internal/toml/toml.go
• internal/toml/toml_test.go
• toml-decoder

Pre-build acceptance observation

• RED: architecture-build (ARCHITECTURE.md)

intent: The declared Go module and decoder command compile without third-party module requirements. return code: 1 stderr: --- drydock: values at failure --- result = CompletedProcess(args=['sh', 'sources/stage_contract.sh', 'architecture'], returncode=1, stdout='', stderr='') --- drydock: end values --- Traceback (most recent call last): File "architecture-build.py", line 10, in <module> assert result.returncode == 0 ^^^^^^^^^^^^^^^^^^^^^^ AssertionError

• RED: architecture-module (ARCHITECTURE.md)

intent: The command package is buildable through the required repository path. return code: 1 stdout: go: cannot find main module, but found .git/config in /mnt/c/Users/barlo/projects/drydock/uat/Toml to create a module there, run: cd ../../../.. && go mod init stderr: --- drydock: values at failure --- result = CompletedProcess(args=['go', 'build', './cmd/toml-decoder'], returncode=1, stdout='', stderr='go: cannot find main module, but found .git/config in /mnt/c/Users/barlo/projects/drydock/uat/Toml\n\tto create a module there, run:\n\tcd ../../../.. && go mod init\n') --- drydock: end values --- Traceback (most recent call last): File "architecture-module.py", line 10, in <module> assert result.returncode == 0 ^^^^^^^^^^^^^^^^^^^^^^ AssertionError

• RED: architecture-dependencies (ARCHITECTURE.md)

intent: The module declares no forbidden third-party dependency. return code: 1 stderr: --- drydock: values at failure --- self = PosixPath('go.mod') mode = 'r' buffering = -1 encoding = 'utf-8' errors = None newline = None --- drydock: end values --- Traceback (most recent call last): File "architecture-dependencies.py", line 3, in <module> module_text = Path("go.mod").read_text(encoding="utf-8") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/home/barlo/.local/share/uv/python/cpython-3.12.13-linux-x86_64-gnu/lib/python3.12/pathlib.py", line 1027, in read_text with self.open(mode='r', encoding=encoding, errors=errors) as f: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/home/barlo/.local/share/uv/python/cpython-3.12.13-linux-x86_64-gnu/lib/python3.12/pathlib.py", line 1013, in open return io.open(self, mode, buffering, encoding, errors, newline) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
FileNotFoundError: [Errno 2] No such file or directory: 'go.mod'

Post-build programmatic acceptance

• PASS: architecture-build (ARCHITECTURE.md)

intent: The declared Go module and decoder command compile without third-party module requirements. target interpreter: /mnt/c/Users/barlo/projects/drydock/.venv/bin/python3 provisioning: not required return code: 0

• PASS: architecture-module (ARCHITECTURE.md)

intent: The command package is buildable through the required repository path. target interpreter: /mnt/c/Users/barlo/projects/drydock/.venv/bin/python3 provisioning: not required return code: 0

• PASS: architecture-dependencies (ARCHITECTURE.md)

intent: The module declares no forbidden third-party dependency. target interpreter: /mnt/c/Users/barlo/projects/drydock/.venv/bin/python3 provisioning: not required return code: 0

Build summary

<reusable-compact filename="ARCHITECTURE.md"> Go module github.com/owner/toml-decoder using Go 1.22+ and no dependencies. cmd/toml-decoder reads stdin, invokes internal/toml, emits tagged JSON on stdout, and reports errors on stderr with non-zero exit. internal/toml owns TOML parsing. Scalars use {type, value} string fields; tables and arrays map to JSON objects and arrays. </reusable-compact>

RESULT: SUCCESS

FILES CHANGED:

• go.mod
• cmd/toml-decoder/main.go
• internal/toml/toml.go
• internal/toml/toml_test.go

SUMMARY: Created the standard-library-only Go module and decoder command scaffold. go test, go vet, go build, formatting checks, and the architecture contract all pass.

BLOCKERS:

• None