eric/promptkit

Go to file

Eric Rakestraw 4bddbbe8f4 Record collection ownership and ConfigKit boundary decisions

2026-10-14 00:19:05 +00:00

Record collection ownership and ConfigKit boundary decisions

2026-10-14 00:19:05 +00:00

examples/go-library

Document request validation workflow

2026-10-12 17:47:04 +00:00

Report known zero usage when smoke tests do not dispatch

2026-10-13 20:32:24 +00:00

Upgrade the release tooling to ReleaseKit v0.3.0

2026-10-09 03:48:52 +00:00

.gitignore

Add native ReleaseKit bootstrap

2026-10-08 16:23:26 +00:00

AGENTS.md

Align policies with the standard and record their provenance

2026-09-27 21:18:11 +00:00

appended_messages_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

architecture_test.go

Publish the Promptkit engine facade

2026-07-28 04:43:19 +00:00

artifact_reader_internal_test.go

Publish the Promptkit engine facade

2026-07-28 04:43:19 +00:00

artifact_reader.go

Publish the Promptkit engine facade

2026-07-28 04:43:19 +00:00

assembled_workflow_benchmark_test.go

Add assembled workflow benchmark baseline

2026-10-09 00:49:46 +00:00

backends.go

Load backend smoke-test metadata

2026-10-13 15:53:27 +00:00

capacity_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

capacity_error.go

Expose structured capacity errors

2026-07-30 23:24:04 +00:00

configuration_diff_contract_test.go

Verify configuration diff disclosure semantics

2026-10-09 15:59:58 +00:00

configuration_inspection_contract_test.go

Verify captured configuration diff concurrency

2026-10-09 16:01:24 +00:00

configuration_inspection.go

Document captured configuration comparison

2026-10-09 16:06:09 +00:00

configuration_sources_test.go

Capture keyed prompts and source-backed content at load time

2026-09-30 02:19:52 +00:00

configuration_sources.go

Cut over public engine construction to ConfigKit sources

2026-09-30 03:18:49 +00:00

construction_contract_test.go

Load backend smoke-test metadata

2026-10-13 15:53:27 +00:00

consumer_test_helpers_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

convert_appended_messages_test.go

Add appended message request validation

2026-08-26 02:10:01 +00:00

convert.go

Avoid redundant smoke report copying

2026-10-13 21:12:17 +00:00

COPYRIGHT

Align policies with the standard and record their provenance

2026-09-27 21:18:11 +00:00

doc.go

Document profile and prompt identity listings

2026-10-09 04:34:45 +00:00

engine.go

Expose the public smoke-test API

2026-10-13 18:16:34 +00:00

errors_internal_test.go

Expose transport and malformed generation errors

2026-09-23 16:37:47 +00:00

errors.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

formatting.go

Add appended message request validation

2026-08-26 02:10:01 +00:00

frozen_rendering_contract_test.go

Render captured prompt templates without reloading sources

2026-09-30 03:24:12 +00:00

generation_error_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

generation_error_internal_test.go

Expose structured generation errors to consumers

2026-08-23 19:01:38 +00:00

generation_error.go

Expose structured generation errors to consumers

2026-08-23 19:01:38 +00:00

go.mod

Adopt tagged diagnostic catalogs

2026-10-13 16:28:41 +00:00

go.sum

Adopt tagged diagnostic catalogs

2026-10-13 16:28:41 +00:00

json_contract_test.go

Preserve reported token usage presence

2026-09-23 16:39:43 +00:00

json.go

Consolidate public JSON serialization

2026-08-11 21:40:12 +00:00

LICENSE

Align licensing documentation and adopt MIT catalogs

2026-09-26 21:44:52 +00:00

listing_contract_test.go

Verify effective listing ownership and concurrency

2026-10-09 04:31:31 +00:00

listing.go

Expose profile and prompt identity listings

2026-10-09 04:28:23 +00:00

llm_adapter_internal_test.go

Retain injected client diagnostic evidence

2026-10-13 17:05:40 +00:00

llm_adapter.go

Retain injected client diagnostic evidence

2026-10-13 17:05:40 +00:00

message_roles.go

Document appended request messages

2026-08-26 02:19:44 +00:00

observation_boundary_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

observation_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

observations.go

Reconcile reliable execution documentation

2026-09-23 17:29:12 +00:00

output_contract_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

prepared_execution_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

prepared_execution.go

Observe claimed prepared executions

2026-09-23 17:15:51 +00:00

prepared_observation_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

profile_inheritance_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

profile_inspection_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

profiles.go

Cut over public engine construction to ConfigKit sources

2026-09-30 03:18:49 +00:00

provider_values.go

Cut over public engine construction to ConfigKit sources

2026-09-30 03:18:49 +00:00

public_boundary_test.go

Close gaps in public boundary checks

2026-09-22 11:40:25 +00:00

README.md

Document smoke-test diagnostics

2026-10-13 18:32:41 +00:00

releasekit.json

Extract example checks into release profile

2026-10-08 16:20:51 +00:00

reliable_execution_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

requirements_inspection_benchmark_test.go

Add requirement inspection benchmarks

2026-10-09 00:30:51 +00:00

requirements_inspection_contract_test.go

Select prompt metadata for inspection

2026-10-09 00:45:25 +00:00

requirements_test.go

Expose prompt requirement inspection

2026-10-08 20:40:16 +00:00

requirements.go

Clarify inspected input identifier disclosure

2026-10-08 21:19:24 +00:00

retry_exhausted_error.go

Configure built-in retries across execution paths

2026-09-23 16:56:20 +00:00

smoke_conversion_internal_test.go

Avoid redundant smoke report copying

2026-10-13 21:12:17 +00:00

smoke_diagnostics.go

Avoid redundant smoke report copying

2026-10-13 21:12:17 +00:00

smoke_integration_contract_test.go

Report actual inference smoke test destinations

2026-10-13 20:27:46 +00:00

smoke_test_contract_test.go

Expose the public smoke-test API

2026-10-13 18:16:34 +00:00

transient_retries_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

types.go

Cut over public engine construction to ConfigKit sources

2026-09-30 03:18:49 +00:00

validate_request_contract_test.go

Consolidate request validation parity assertions

2026-10-12 19:31:54 +00:00

README.md

Promptkit

Promptkit is a reusable Go library for preparing and executing prompt-defined LLM workflows. Its module path is:

gitea.maximumdirect.net/eric/promptkit

The root promptkit package provides the supported public engine. Consumers can configure file, embedded, or programmatic backend, profile, and prompt definitions alongside filesystem or in-memory schemas, prepare requests without generation, run requests with the built-in OpenAI-compatible client, or inject their own model client and artifact reader.

Quickstart

Run the maintained offline preparation example from the repository root:

go run ./examples/go-library/prepare

It loads a repository-local prompt, supplies a programmatic profile and inline input, inspects the captured configuration, and prints deterministic preparation metadata without contacting a provider or requiring credentials. The consumer guide also shows a local backend, ordered file/embedded sources, programmatic mappings, and how to replace an engine when source files change. Read the example source, the Go package consumer guide, and the framework format reference to build a consumer workflow. The consumer guide also covers explicit, live smoke diagnostics and interpreting their factual reports; they are separate from the offline quickstart.

Contributors should start with the development guide. The architecture policy defines the library boundary and constraints that framework work must preserve.

Release Guidance

The v0.15.0 release notes cover error-only validation of concrete requests with Engine.ValidateRequest.

Consumers upgrading to v0.12.0 should read the v0.12.0 release notes for the intentional ConfigKit configuration and public construction API migration.

The v0.11.2 release notes cover policy alignment and copied-policy attribution updates.

The v0.11.1 release notes cover the MIT-licensed catalog updates and licensing documentation improvements.

Consumers upgrading to v0.11.0 should read the v0.11.0 changelog and migration guide, particularly the default retry behavior and license change.

Consumers upgrading to the v0.10.0 profile-policy transition should read the v0.10.0 transition guide.

Consumers upgrading from v0.8.0 to v0.9.0 should read the v0.9.0 changelog and migration guide.

Consumers upgrading from v0.7.0 to v0.8.0 can consult the v0.8.0 changelog and migration guide.

Earlier adopters can consult the v0.7.0 changelog and migration guide.

Consumers upgrading from v0.5.0 to v0.6.0 can consult the v0.6.0 changelog and migration guide.

Consumers upgrading from v0.4.0 to v0.5.0 can consult the v0.5.0 changelog and migration guide.

Consumers upgrading from v0.3.0 to v0.4.0 should read the v0.4.0 changelog and adoption guide.

Consumers upgrading from v0.2.0 to v0.3.0 should read the v0.3.0 changelog.

Consumers moving from v0.1.0 to v0.2.0 should read the v0.2.0 changelog and migration guide.

Scriptorium is the CLI and HTTP application built on Promptkit.

License

Promptkit is licensed under the LGPL v3.0 or later.

Open Source attribution notices are available.