Skip to content

IMP-071: add structured local runtime failure guidance - #226

Merged
badjoke-lab merged 16 commits into
mainfrom
imp-071-structured-local-failure-guidance
Jul 30, 2026
Merged

IMP-071: add structured local runtime failure guidance#226
badjoke-lab merged 16 commits into
mainfrom
imp-071-structured-local-failure-guidance

Conversation

@badjoke-lab

@badjoke-lab badjoke-lab commented Jul 30, 2026

Copy link
Copy Markdown
Owner

Summary

Add deterministic provider-neutral local-only guidance to every failed canonical local runtime turn.

Implemented

  • add immutable LocalFailureGuidance coverage for all nine accepted RuntimeFailureCode values;
  • expose one versioned guidance identifier, exact failure code, bounded summary, and ordered bounded local-only options;
  • record state_preserved=true, automatic_action_taken=false, and cloud_fallback_used=false;
  • attach matching guidance to failed, cancelled, and timed-out LocalConversationResult values;
  • persist the same guidance fields in canonical error-event extensions;
  • keep completed turns free of guidance;
  • keep audit metadata content-free through guidance identity and option count only;
  • preserve the existing canonical user/context/error graph and all accepted local workflow boundaries;
  • update the Phase 6 roadmap, daily-use matrix, public status, public checker, and generated specification;
  • advance the next unallocated implementation identifier to IMP-072.

Safety boundary

Guidance may describe local retry, smaller requests or context, local runtime-health or model-inventory inspection, manual repair of the configured local runtime, manual activation of an already approved installed local model or fallback binding, bounded timeout adjustment, or continued state/export/backup/restore/recovery without model execution.

Guidance never performs or recommends automatic cloud fallback, provider login, API-key entry, remote upload, automatic model download or installation, automatic binding changes, process launch, shell execution, tools, capabilities, or destructive state mutation.

Verification

  • all nine accepted failure codes: covered;
  • deterministic immutable guidance acceptance: passed;
  • canonical error-event parity: passed;
  • completed-turn absence and failed/cancelled/timeout integration: passed;
  • Ruff lint and formatting: passed;
  • strict mypy: passed;
  • generated specification: passed;
  • public-site status checker: passed;
  • implementation numbering: passed;
  • Ubuntu full CI: passed;
  • macOS full CI: passed;
  • Windows full CI: passed;
  • IMP-062 imported-context acceptance: passed on Ubuntu, macOS, and Windows;
  • IMP-064 local-writing acceptance: passed on Ubuntu, macOS, and Windows;
  • unresolved review threads: none.

Evidence boundary

IMP-071 establishes deterministic CI evidence only. It does not establish preflight exception redesign, accessibility presentation, Lite performance measurement, the release soak gate, complete Phase 6, Lite v1.0 completion, or stable general anti-lock-in.

Closes #225

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 30, 2026

Copy link
Copy Markdown

Deploying doll-bjl with  Cloudflare Pages  Cloudflare Pages

Latest commit: 2ad43b9
Status: ✅  Deploy successful!
Preview URL: https://b5bb2369.doll-bjl.pages.dev
Branch Preview URL: https://imp-071-structured-local-fai.doll-bjl.pages.dev

View logs

@badjoke-lab
badjoke-lab marked this pull request as ready for review July 30, 2026 17:46
@badjoke-lab
badjoke-lab merged commit 848d9e3 into main Jul 30, 2026
19 checks passed
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.

IMP-071: add structured local runtime failure guidance

1 participant