Add Promptkit-owned profile definitions

docs/formats.md

@@ -283,7 +283,8 @@ Profile sources resolve matching IDs in this order:
 2. the ordinary configured source selected by a profile file, `fs.FS`, or
    configured profile directory;
 3. application fallback profiles supplied with `WithFallbackProfileFS`; and
-4. maintained external catalog profiles.
+4. Promptkit-owned profiles; and
+5. maintained external catalog profiles.
 
 A profile source supplies a complete definition; definitions and their fields
 are not merged across sources. A higher-precedence source falls back only when
@@ -326,6 +327,18 @@ that backend's connection and credential metadata. Profile files do not repeat
 those values. A configured, application fallback, or in-memory profile with
 the same profile ID takes precedence.
 
+Promptkit owns two opt-in profiles. Their following definitions are current
+selections, not automatic defaults:
+
+| ID | Current definition |
+| --- | --- |
+| `promptkit-openrouter-standard` | Inherits `gemini-flash-latest`. |
+| `promptkit-openrouter-auto` | Selects backend `openrouter` and model `openrouter/auto`. |
+
+Select either name through an existing request `profile_id` or prompt
+`default_profile`. Consumers can replace either definition or its inherited
+base through the ordinary profile-source precedence above.
+
 | Provider | ID | Backend | Model |
 | --- | --- | --- | --- |
 | aion-labs | `aion-2` | `openrouter` | `aion-labs/aion-2.0` |

docs/internal/overview.md

@@ -18,7 +18,7 @@ contributor workflow and validation.
 | `internal/catalog` | Strictly validates imported immutable maintained backend and profile catalog assets before engine assembly uses them. | [Catalog adapter](../../internal/catalog/catalog.go), [internal sources](sources.md#profiles-and-built-ins) |
 | `internal/capacity` | Owns engine-local bounded execution admission and FIFO model-generation permits for limited backend IDs, including cancellation-safe waiter removal and client wrapping. | [Internal capacity management](capacity.md) |
 | `internal/domain` | Defines internal framework values for requests, artifacts, prompt definitions, profiles, execution targets, rendering, generation, and validation, and owns source-neutral invariants for shared execution settings, OpenAI-compatible base endpoints, session identifiers, and output contracts. Source parsing, required fields, other source-specific normalization, defaulting, and boundary-specific error classification remain with their callers. | [Domain declarations](../../internal/domain/domain.go), [endpoint invariant](../../internal/domain/endpoint.go) |
-| `internal/engine` | Assembles catalogs, repositories, registry, capacity, collaborators, repairer, and the one use-case runner for each engine instance. | [Engine assembly](../../internal/engine/engine.go), [internal runner](runner.md) |
+| `internal/engine` | Assembles external catalogs, Promptkit-owned profiles, repositories, registry, capacity, collaborators, repairer, and the one use-case runner for each engine instance. | [Engine assembly](../../internal/engine/engine.go), [internal sources](sources.md#profiles-and-built-ins), [internal runner](runner.md) |
 | `internal/defaults` | Defines application-neutral framework constants and constructs the default execution target. It contains no CLI, server, or inbound HTTP limits. | [Framework defaults](../../internal/defaults/defaults.go) |
 | `internal/filecatalog` | Provides deterministic YAML discovery and path helpers for operating-system filesystems and `fs.FS` sources. | [File catalog](../../internal/filecatalog/catalog.go) |
 | `internal/jsonvalue` | Validates and deeply copies bounded JSON-compatible extra-parameter and prepared-schema trees while preserving supported concrete value types and rejecting cycles or excessive depth and work. | [JSON values](../../internal/jsonvalue/jsonvalue.go) |

docs/internal/sources.md

@@ -70,7 +70,7 @@ repositories described above.
 Rakestrawhome asset modules as one private adapter boundary. It enforces their
 manifest, layout, profile ownership, inheritance, and secret-safety rules
 before returning raw catalog sources. Internal engine assembly uses those validated
-catalogs as the maintained lowest-precedence profile source.
+catalogs as the lowest-precedence profile source.
 
 Normalized external catalog profile IDs with the exact `promptkit-` prefix are
 rejected at this adapter boundary. That reservation applies only to imported
@@ -86,10 +86,13 @@ profile inspection.
 
 The internal engine assembles one raw composite catalog in precedence order:
 in-memory profiles, one ordinary configured source, an application fallback
-source, then the maintained external catalog. An explicit file or `fs.FS` profile
-source replaces `Config.ProfileDir` within the ordinary configured-source
-category. One outer resolving repository wraps that complete raw catalog, so
-each base lookup observes the same precedence and shadowing rules.
+source, Promptkit-owned profiles, then the maintained external catalog. It
+constructs the owned definitions through the in-memory repository and validates
+their maintained-only resolution and backend membership before consumer sources
+are overlaid. An explicit file or `fs.FS` profile source replaces
+`Config.ProfileDir` within the ordinary configured-source category. One outer
+resolving repository wraps that complete raw catalog, so each base lookup
+observes the same precedence and shadowing rules.
 
 The resolving repository traverses every selected chain afresh, retains no
 cache, detects cycles, limits a chain to 32 profiles, merges root-to-leaf into a
@@ -104,9 +107,10 @@ or schema sources. It does not retain that lookup for a later execution.
 Prepared execution instead freezes the fully resolved target; a later ordinary
 operation performs a fresh traversal.
 
-The maintained external catalog provides every built-in profile and its
-matching backend definition. Profile loading and overlay behavior are owned by the
-[profile repository tests](../../internal/profile/repository_test.go), while
+The imported external catalog provides external profiles and matching backend
+definitions. The internal engine owns the Promptkit profiles documented in the
+[framework format reference](../formats.md#built-in-profile-catalog). Profile
+loading and overlay behavior are owned by the [profile repository tests](../../internal/profile/repository_test.go), while
 catalog completeness, backend selection, and duplicate IDs are owned by the
 [catalog adapter tests](../../internal/catalog/catalog_test.go).
 

docs/roadmap/implementation.md

@@ -151,6 +151,8 @@ consumer source behavior are unchanged.
 
 ## Stage 4: Add And Compose Promptkit-Owned Profiles
 
+**Completed:** 2026-09-22
+
 1. Add a maintained-profile helper in `internal/engine` with the two raw
    definitions specified above. Build its memory repository, overlay it above
    the raw external catalog repository, and supply that raw composition to the