Skip to content

Add runtime context placeholder support (app_context) across docs, fixtures, init, and tests#2

Merged
PredictabilityAtScale merged 1 commit into
mainfrom
codex/confirm-and-document-placeholder-support
Apr 19, 2026
Merged

Add runtime context placeholder support (app_context) across docs, fixtures, init, and tests#2
PredictabilityAtScale merged 1 commit into
mainfrom
codex/confirm-and-document-placeholder-support

Conversation

@PredictabilityAtScale

Copy link
Copy Markdown
Owner

Motivation

  • Add explicit runtime context placeholder examples so shared system instructions and templates can consume render-time context values (e.g., {{ app_context }}).
  • Ensure the CLI scaffolding, documentation, fixture prompts, and unit tests reflect and verify this usage pattern.

Description

  • Updated README, docs (cli.md, composition.md, getting-started.md, prompt-format.md, providers.md) to show app_context as a runtime placeholder and explain mapping from --vars to {{ name }} keys.
  • Updated example and fixture prompt files (fixtures/prompts/*) to declare app_context in context.inputs and to use {{ app_context }} in system and prompt template sections.
  • Updated the init command (src/cli/commands/init.ts) scaffolding to include app_context in generated prompt, include file, and test sidecar examples.
  • Extended interpolation tests (tests/interpolate.test.ts) and added new integration-style tests (tests/runtime-context-placeholders.test.ts) to verify {{ app_context }} interpolation across modes and environments (source-only and compiled-only).

Testing

  • Ran the unit test suite with vitest, including tests/interpolate.test.ts and the new tests/runtime-context-placeholders.test.ts, and all tests passed.
  • Verified that rendering in both source-only and compiled-only modes substitutes {{ app_context }} into system and template sections and selects environment overrides as expected.

Codex Task

@PredictabilityAtScale PredictabilityAtScale merged commit 7a0a2fa into main Apr 19, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant