scriptorium/docs/internal/overview.md

Internal Component Overview

This is the complete inventory of Scriptorium's implemented Go components. The architecture policy owns normative boundaries; public behavior belongs in the linked contracts.

Component	Implemented responsibility	References
cmd/scriptorium	Process entrypoint that delegates arguments and streams to the CLI adapter.	CLI contract, adapter internals
internal/adapter/cli	Parses execution and application-configuration inspection commands, resolves settings, constructs Promptkit engines only for execution/definition inspection, maps requests, and owns process output and exit behavior.	CLI contract, adapter internals
internal/adapter/http	Owns routes, DTOs, strict decoding, limits, Promptkit request/result mapping, public error mapping, and restricted HTTP artifact reading.	HTTP API, adapter internals, source internals
internal/config	Selects application sources, supplies the ConfigKit definition and explicit overrides, and converts resolved settings for runtime use.	configuration contract, adapter internals
internal/defaults	Holds Scriptorium-owned application and HTTP defaults.	configuration contract
internal/format	Formats Promptkit prepared-run and prompt/profile inspection values for CLI text or JSON output.	CLI contract, adapter internals
internal/report	Projects one terminal Promptkit observation into Scriptorium-owned execution metadata.	adapter internals

Framework implementation packages are provided by Promptkit v0.11.1 and are not part of this repository.