Library / Knowledge-Corpus Access Engineering Principles Framework
Jump to passage
In this reading

Link to current text

Published source confirmed at last check

Source changed 2026-10-03 14:36:52 UTC · snapshot created 2026-10-03 14:38:14 UTC · last check 2026-10-03 14:50:08 UTC

KCAE.ENCOUNTER:4 - Solution

KCAE.ENCOUNTER:4.1 - Choose an occasion and obtain observation authority

Start from work whose receiving result can matter, not from the available telemetry. Possible occasions include a handover, a changed configuration, a failed test, an unusual manual correction or a scheduled review already attended by a responsible person. Also inspect successful work: repeated compensation can make an inadequate input appear satisfactory. A failure-only trigger cannot expose that class.

Name who authorizes the observation, which events and fields may be used, for what purpose, for how long, and which recipient can receive the result. Obtain the permission through the actual owner. If it is absent, propose an attainable manual occasion or ask for the needed authorization; do not infer consent from installing a skill. State the stop on permission withdrawal.

The occasion must exist in the runtime or practice. A document describing a background observer is not that observer. A callable MCP tool exposes operations when invoked; it does not by itself watch a work stream. A skill can teach a response; it cannot alone schedule its own invocation. Choose an existing human participant, event subscriber, timer, application hook or explicit invocation that actually supplies the opening.

KCAE.ENCOUNTER:4.2 - Project an event without erasing the unknown distinction

An event projection carries only the allowed context needed to open inquiry: receiving work, observed result or contrast, the relevant passage or value, source/time identity and available case facts. Preserve the original observation separately from a proposed interpretation. “Three duplicate rows were removed by a senior analyst after a successful export” is evidence of an episode; “workers are too slow” is a hypothesis.

Use deterministic validation for payload shape, identifiers, dates and permissions. Use semantic assessment for the relationship between the event and a possible question. If a projection omits the very compensation that raises the question, improve that projection or obtain the fuller authorized episode. Do not compensate with a more confident classifier on the same insufficient fields.

Minimize private data before any transfer and keep a source return under appropriate access. A public service may receive “repeated duplicate reconciliation after a successful export” while customer identifiers and row contents stay local. If an essential distinction cannot be shared, use a qualified local reader or return a limitation.

KCAE.ENCOUNTER:4.3 - Provide actual invocation, deduplication and receipt

For a software observer, identify the event subscription, its delivery semantics, a receiver and failure behavior. Validate the event’s source and permitted scope before running retrieval. Use a stable event identity together with the intended operation/version when suppressing repeated processing. Choosing only a case ID can wrongly suppress a later changed condition; choosing the receipt timestamp can fail to recognize a retry of the same event.

Under at-least-once delivery, distinguish a claim to perform the inquiry from a completed result. In a store with suitable conditional writes, create one processing record for the logical event/operation key, with the relevant input identity, an in-progress state, an attempt/owner token and a bounded completion or lease deadline. A duplicate with the same key but a different relevant payload is an identity conflict to resolve, not a cached answer. The first worker’s successful claim authorizes that attempt under the stated permission; it does not assert that the inquiry happened.

On a repeated invocation, read the state using the consistency needed by that store’s conditional-update contract:

  • Completed, with a durably stored result: return that result and its original source/case basis, if access and retention still permit it. Do not rerun the inquiry or create another outgoing notice just to answer the duplicate. Missing result data is an integrity/recovery problem, not a successful completed state. KCAE.ENCOUNTER:4.4 separately checks whether an old result can support reliance now.
  • In progress, with a valid claim: return a pending disposition or arrange a bounded later retry according to the event interface. Do not start a competing inquiry merely because the caller has not received a result. Do not permanently acknowledge unfinished work unless a durable continuation or recovery mechanism has taken responsibility for it.
  • Abandoned or expired, without a completed result: establish the permitted recovery. A runtime may confirm that the earlier invocation terminated; another environment may only show an expired lease. Conditionally replace the stale claim with a new attempt token so two recovery workers cannot both acquire it. Then resume from a valid checkpoint or rerun only the work whose repetition is safe under the known effect state. If recovery cannot exclude conflicting commits or harmful repeated effects, return a recoverable unresolved state and obtain reconciliation rather than silently treating the event as processed.

Provide the mechanism that revisits an unfinished claim: actual queue redelivery, a recovery scheduler, or a resumable workflow with its documented behavior. A stored deadline does not invoke any of them. Choose bounded retries and account for repeated computation and model charges. Retain completed keys/results for the intended duplicate window, or define how older deliveries are rejected or reconciled when retention expires. An expired cache entry must not silently turn an old consequential operation into a new one.

Lease expiry does not kill a worker. If an old worker can resume after another attempt takes over, guard completion with an atomic comparison of the current owner token and in-progress state; a stale owner must be unable to commit its result or outgoing intent. In this construction, keep the inquiry replayable and defer externally visible effects until that guarded commit. Any effect path outside the guarded store needs its own idempotency or fencing support. Merely checking a lease and later making an unguarded external call leaves a race. If the chosen runtime cannot exclude that race for the proposed action, confirm termination before taking over, or preserve the unresolved effect state for an authorized person.

Persist the accepted result and completed state together. If another service must receive a suggestion, a transactional outbox can also commit the outgoing intent in that same supported local transaction, guarded by the current attempt token. Give the outgoing logical operation a stable identity across attempts. A sender can retry that intent; the recipient must deduplicate or otherwise reconcile repeated effects at its own boundary. The local outbox does not make arbitrary remote effects exactly once.

If an earlier attempt may already have posted a note, sent a message or launched an action before recording completion, inspect the external effect using that stable identity where possible. Recover an observed result, retry through a receiver that enforces the required idempotency window, or perform an explicitly authorized compensating operation when appropriate. Where the effect is unknown and repetition could be harmful, do not automatically replay it. An explicit “inquiry/effect unresolved” return is safer and more truthful than either a fabricated result or indefinite silent suppression.

Separate “event received,” “inquiry performed,” “suggestion sent,” “suggestion displayed” and “person understood or used it.” An acknowledgement lost after display creates an unknown receipt state, not proof of non-delivery. Do not repeatedly interrupt the user merely to make an internal receipt counter definite. Obtain a receiver query or use the agreed duplicate policy. Deletion and permission withdrawal apply to stored event payloads as well as search data.

KCAE.ENCOUNTER:4.4 - Turn the occasion into inquiry before recommending a solution

Use the observed work to ask what the result should enable and what remains unexplained. Keep a cue even if no diagnosis is available. B.5.PI supplies this opening of inquiry; KCAE.SEARCH can then find a contribution to the developed question. A practical event need not first match a known pattern label.

Compare the candidate’s contribution with the case and a nearby non-fit. “Duplicate reconciliation occurs” does not always imply a software defect: a declared manual control might already be the intended and affordable arrangement. If the current arrangement is adequate, the inquiry can end quietly. If case information is missing, decide whether asking for it is worth the recipient’s effort. If a useful new explanation is already available, deliver that explanation instead of demanding that the person learn a framework.

Keep applicability, present recommendation and interruption separate. A method can fit in principle while its benefit is too small now, its necessary support is unavailable, or the timing is poor. Select a quiet link, a digest, an agreed pause, a prompt to the responsible participant or immediate interruption according to the allowed use and consequence. The access system does not invent a new emergency authority.

Before a delayed suggestion is released, check that it still concerns the same episode revision, relevant case facts, source basis and allowed receiving purpose. A ticket edited after inquiry can require reassessment; attaching the old recommendation to the new text would hide that change. Reuse unaffected findings, but reopen any changed premise that can alter the recommendation. If the opportunity has ended, keep a permitted historical result or discard the pending suggestion. Do not broaden an old observation permission to deliver advice for a new purpose.

KCAE.ENCOUNTER:4.5 - Test the complete encounter and adjust its burden

Use a real or safely constructed episode with the intended observer, projection, receiver and aids. Check whether the relevant distinction reaches the inquiry, whether the recipient encounters the cue, whether they can understand the offered contribution, and what they do next. Include a similar event where the system should remain quiet, an overlapping retry, a crash after claim creation but before result persistence, a duplicate after completion, an unavailable source and a permission withdrawal. Inspect the allowed continuation and any external effect in each case, including whether a stale worker can still commit. A simulated successful classifier call does not test this complete path.

Measure the work imposed by false suggestions and by obtaining missing facts. Preserve dismissed or unhelpful suggestions only to the extent justified by the retention policy and improvement use. If the same suggestion has become familiar, reduce or remove it. If the cue is understood but the action remains unavailable, obtain support or an appropriate learning method; repeated notices do not supply capability.