diff --git a/CHANGELOG.md b/CHANGELOG.md index ad47b45..b5e2e03 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -48,6 +48,16 @@ an entry here. and conformance roles (Orchestrator, Pipeline Plugin, Skill). Non-goals: trust enforcement and replay prevention are explicitly out of scope. +- Consistency and design review: §5.3 — default decay values, if a + deployer configures them, are tuning guidance (RECOMMENDED at most, + never a conformance requirement); §4/§4.1 decay model stated as the + cross-spec reference for OVOS-PIPELINE-1 §6.1 (post-match decrement + after every match round, freshly written entries exempt). + Companion-spec titles corrected to the canonical SESSION-1/SESSION-2 + titles; §6 INTENT-4 payload citation corrected to §5.2/§6.1 + (INTENT-4 states the unknown-field-tolerance rule this section + relies on); §9 session-security deferral restated as a timeless + out-of-scope statement. ## OVOS-TRANSFORM-1 — Transformer Plugins ### 1 diff --git a/intent-context.md b/intent-context.md index 8bd9506..091416c 100644 --- a/intent-context.md +++ b/intent-context.md @@ -17,10 +17,11 @@ It builds on five companion specifications: `session` carrier in which context lives (§4), and the `forward` derivation used by the `ovos.session.sync` mutation pathway (§5.3); -- the *Session Carrier Wire Shape Specification* (OVOS-SESSION-1) — +- the *Session Specification* (OVOS-SESSION-1) — the field-registry mechanism under which this spec claims `session.intent_context` (§2); -- the *Session Lifecycle Specification* (OVOS-SESSION-2) — the +- the *Session Lifecycle and State Ownership Specification* + (OVOS-SESSION-2) — the `ovos.session.sync` topic and its merge semantics (§5.3); - the *Intent Definition Specification* (OVOS-INTENT-3) — the intent definition this spec extends with a `requires_context` declaration; @@ -521,8 +522,9 @@ received on its last dispatch. *Default decay.* An orchestrator **MAY** apply a deployer-configurable default decay (turn-based, wall-clock, or both) to entries written without an explicit `turns_remaining` or -`expires_at`, to bound state accumulation. If applied, the default -values are implementation-defined; deployers **SHOULD** consider +`expires_at`, to bound state accumulation. Any particular default +values are tuning guidance — **RECOMMENDED** at most, never a +conformance requirement; deployers **SHOULD** consider both interactive latency (turn-based decay is deterministic across pauses) and idle expiry (wall-clock decay bounds a device sitting idle). @@ -598,8 +600,8 @@ The `requires_context` and `excludes_context` (§6.1) fields travel with the rest of the intent definition. In-process engines read them from the registration record they receive locally. They are **optional** declarations of the OVOS-INTENT-3 intent definition, -not enumerated by the OVOS-INTENT-4 registration payload (§6.1 of -that spec): a skill that uses them attaches them to the +not enumerated by the OVOS-INTENT-4 registration payloads (§5.2 / +§6.1 of that spec): a skill that uses them attaches them to the `ovos.intent.register.template` / `.keyword` payload as additional fields, which OVOS-INTENT-4 §6.3 / §5.3 carry without rejecting (unknown fields are tolerated, not malformed). An engine that does @@ -792,8 +794,8 @@ This is the same threat surface the session identifier already has. Authenticating session-bound state — proving that a private entry stored at `:` was actually set by that ``, in the session named by its identifier, at the time -it claims — is **out of scope** for this specification and belongs -to a future session-security specification. +it claims — is **out of scope** for this specification; it is a +session-security concern, not a context concern. Deployments that need stronger guarantees (multi-tenant assistants, hostile-network bus deployments) **SHOULD NOT** rely on intent @@ -815,6 +817,7 @@ a **classification primitive**, not an authorization primitive. - *Session Specification* (OVOS-SESSION-1) — the wire shape of `session`, the registry mechanism under which this specification claims the `intent_context` field, and propagation semantics. -- *Session Lifecycle Specification* (OVOS-SESSION-2) — session +- *Session Lifecycle and State Ownership Specification* + (OVOS-SESSION-2) — session lifecycle responsibilities; cited by §4.2 for client-side session management.