Skip to content

docs(guides): runtime config composition and workspace replacements#24

Open
AndrewKirkovski wants to merge 1 commit into
mainfrom
docs/runtime-config-composition
Open

docs(guides): runtime config composition and workspace replacements#24
AndrewKirkovski wants to merge 1 commit into
mainfrom
docs/runtime-config-composition

Conversation

@AndrewKirkovski

@AndrewKirkovski AndrewKirkovski commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Documents runtime PR wippyai/runtime#461 (feat(config): compose runtime config files), which composes runtime configuration files and moves module replacements out of wippy.lock.

What changed

  • guides/configuration.md — new Configuration Composition, Profiles, and Workspace Replacements sections: repeatable --config (merged left→right, later overrides earlier), named profiles: applied with --profile, --set applied last, and the workspace.replacements map.
  • guides/dependency-management.md — the Local Development with Replacements section now uses the workspace.replacements map in a runtime config file instead of the wippy.lock replacements: list. Integrity Verification documents the boot-time re-hash: a rebuilt replacement is picked up on the next wippy run with no reinstall (the old replacement content digest mismatch failure is gone). Lock-file replacements are marked deprecated.
  • guides/cli.md--config is repeatable/merged; --profile/--set added to install and update; replacement-skip and deprecation-warning notes.
  • guides/publishing.md — documents publish.profiles.include and that the machine-local workspace/boot/extensions sections and env references are stripped from published metadata.

Scope

English (en/) canonical pages only; locale mirrors left to the translation pipeline. No nav (manifest.json) changes — all edits extend existing pages.

Verification

Rendered locally (Docsify) — all edited tables, code blocks, lists, and cross-links parse and display correctly. Strings (reworded install --help, deprecation warnings, workspace.replacements schema) taken verbatim from #461.

🤖 Generated with Claude Code

…cements

Reflect runtime PR wippyai/runtime#461, which composes runtime config files
and moves module replacements out of wippy.lock into runtime configuration.

- configuration: add Configuration Composition, Profiles, and Workspace
  Replacements sections (repeatable --config merge order, profiles, --set)
- dependency-management: replace the lock-file replacements example with the
  workspace.replacements map; document the boot-time re-hash so a rebuilt
  replacement is picked up on the next run (no more digest mismatch); mark
  lock-file replacements deprecated
- cli: --config is repeatable/merged; add --profile/--set to install and
  update; note replacement skip + deprecation warning
- publishing: document publish.profiles.include and that workspace/boot/
  extensions and env references are stripped from published metadata

Claude-Session: https://claude.ai/code/session_017Eht1LfkVeCj7oeSpACp4C
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant