Developer Diagnostics

Knowledge & Reasoning Registry

Evidence-anchored record of what Abbicus knows, has proven, does not know, and the next evidence-based step. Entries are curated — Abbicus does not invent them, and recommendations must cite a job, cert, investigation, or certified pattern.

← Certification library

17 / 17

Forms (4)

Personal InformationCertifiedform.personal-infoproven v0.1.37
Evidence source
CERT-PERSONAL-INFO-LIVE-V1PLAN

What Abbicus knows

  • All Personal Info fields fill via keyboard_entry.
  • Filing status is a single dropdown; MFJ triggers spouse postback on change.
  • Commit Audit passes; Save advances TPL out of OLTFedPersonalInfo.
  • Manual SSN entry is authoritative and skipped by the writer.

What Abbicus does not know

No open unknowns recorded.

Current blocker
none
Next recommended action
none — no evidence supports a recommendation yet

Updated 2026-06-20

W-2 (single record)Certifiedform.w2-singleproven v0.1.53
Evidence source
CERT-001 (v0.1.53 chain)

What Abbicus knows

  • Tree anchor 'W2' navigates to grid; Add New opens entry form.
  • Entry-form fill + Save succeeds via keyboard_entry + Commit Audit.
  • Chain Gate confirms departure from Personal Info before advancing.

What Abbicus does not know

  • Behavior with multiple W-2 records (not yet exercised).
Current blocker
none
Next recommended action
none — no evidence supports a recommendation yet

Updated 2026-06-22

1099-R (single record)Blockedform.1099r-singleproven v0.1.70 (narrow, before taxable-amount rule enforcement)failed v0.1.74

Blocker: Taxable Amount radio not visibly selected before Save.

Evidence source
CERT-1099R-NARROW / v0.1.74

What Abbicus knows

  • Tree anchor '1099R', grid frame 'OLTFedInc1099R', entry 'frmOLTFedInc1099R'.
  • Distribution-code → taxable-amount value mapping is correct (7 → value 1).
  • Anchor-form scoping resolves the correct <form> in the DOM.
  • TPL auto-formats Payer TIN (dashes) — loose digit match handles this.

What Abbicus does not know

  • Whether the three Taxable Amount radios live inside the anchor form in live DOM.
  • Whether TPL commits these radios via FormData or a different mechanism.
  • Whether the staged visual-label heuristic matches TPL's rendered label text.
Current blocker
Taxable Amount radio not visibly selected before Save.
Next recommended action
Run a narrow live probe on the 1099-R taxable-amount radio group only (see Investigation Mode roadmap). Do not build/bump until visible selection is proven.

Reasoning

Observed problem
Save halts with save.uncommitted_fields; no visible selection on the three Taxable Amount options.

Evidence collected

  • job diagnostics show radio_evidence with 9 candidate elements (grid templates polluted results)
  • v0.1.74 scoped discovery to anchor form; still no visible selection
  • distribution-code rule fires correctly (evidence in radio_evidence payload)

Likely failure patterns

  • radios not inside the anchor <form> element (sibling container in TPL DOM)
  • label text differs from expected strings
  • hidden template controls being matched instead of live controls
Confidence
medium
Recommended next investigation
Passive DOM snapshot of live 1099-R entry form: enumerate all radio inputs with visibility, label text, form/frame ownership. No interaction.
Recommended next production fix
withheld — evidence does not yet support a production change

Updated 2026-06-30

1099-R (multiple records)Blockedform.1099r-multifailed v0.1.72

Blocker: Depends on 1099-R single-record taxable-amount blocker.

Evidence source
CERT-1099R-MULTI

What Abbicus knows

  • Fixture (CERT-1099R-MULTI) contains three complete 1099-R source documents.
  • First record fills payer name/TIN; address fields recently added to mapper.

What Abbicus does not know

  • Whether multi-record loop advances past first Save (blocked by single-record blocker).
Current blocker
Depends on 1099-R single-record taxable-amount blocker.
Next recommended action
Resolve form.1099r-single blocker before re-running multi.

Updated 2026-06-30

Interaction patterns (5)

Text input (keyboard_entry)Certifiedpattern.text-inputproven v0.1.37
Evidence source
CERT-PERSONAL-INFO-LIVE-V1PLAN

What Abbicus knows

  • typeKeyboard() bypasses TPL input masks for SSN, EIN, phone, currency.
  • Commit Audit verifies FormData matches visual fill before Save.

What Abbicus does not know

No open unknowns recorded.

Current blocker
none
Next recommended action
none — no evidence supports a recommendation yet

Updated 2026-06-20

TPL grid navigation (tree → grid)Implementedpattern.grid-navproven v0.1.55
Evidence source
CERT-001 (W-2) + CERT-1099R-NARROW

What Abbicus knows

  • Tree click → Acceptance Gate polls for target URL / nextCall token.
  • Rejects popup_redirect / uselinks_redirect / 404 acceptance signals.

What Abbicus does not know

  • Behavior across all interview/branching screens (not exercised).
Current blocker
none
Next recommended action
none — no evidence supports a recommendation yet

Updated 2026-06-25

Add New (grid → entry form)Implementedpattern.add-newproven v0.1.53 (W-2)

Blocker: Not certified for 1099-R multi (blocked upstream by taxable-amount).

Evidence source
CERT-001 (W-2)

What Abbicus knows

  • Shared Add New helper opens entry form; W-2 certified end-to-end.

What Abbicus does not know

  • Whether Add New behaves identically for a SECOND 1099-R record after first Save.
Current blocker
Not certified for 1099-R multi (blocked upstream by taxable-amount).
Next recommended action
Re-run CERT-1099R-MULTI after form.1099r-single is green.

Updated 2026-06-30

EIN / SSN / TIN normalizationCertifiedpattern.ein-ssn-normalizationproven v0.1.72
Evidence source
v0.1.72 loose digit-match in apply-screen-fill-plan.cjs

What Abbicus knows

  • 746002199 and 74-6002199 treated as equivalent for non-select inputs.

What Abbicus does not know

No open unknowns recorded.

Current blocker
none
Next recommended action
none — no evidence supports a recommendation yet

Updated 2026-06-28

Radio groups (visible selection)Blockedpattern.radio-groupsfailed v0.1.74

Blocker: No confirmed selection strategy for TPL radio groups.

Evidence source
v0.1.73 / v0.1.74

What Abbicus knows

  • ID-prefix discovery is unstable (matches grid templates).
  • Anchor-form scoping narrows candidates but has not produced visible selection.

What Abbicus does not know

  • Whether radios are inside the anchor form.
  • Whether visual-label heuristic (staged) matches TPL labels.
Current blocker
No confirmed selection strategy for TPL radio groups.
Next recommended action
Investigation Mode passive snapshot of 1099-R radio group.

Reasoning

Observed problem
Radio group not visibly selected; Save halts with save.uncommitted_fields.

Evidence collected

  • radio_evidence payload from v0.1.73/0.1.74
  • anchor-form scoping edit landed in v0.1.74

Likely failure patterns

  • container mismatch (form vs surrounding div)
  • duplicated hidden template radios sharing ids
Confidence
medium
Recommended next investigation
Enumerate all radio inputs on live 1099-R entry form with visibility + form ownership + label text.
Recommended next production fix
withheld — evidence does not yet support a production change

Updated 2026-06-30

Save barriers (2)

Post-Save validation / missing-critical-info promptImplementedsave.validation-promptproven v0.1.32
Evidence source
v0.1.32 three-outcome Save model

What Abbicus knows

  • Save has three outcomes: saved_and_advanced, saved_pending_validation_prompt, no_save_execution_detected.
  • Validation prompt captures warning text + choices and pauses for operator.

What Abbicus does not know

No open unknowns recorded.

Current blocker
none
Next recommended action
none — no evidence supports a recommendation yet

Updated 2026-06-18

save.uncommitted_fields terminal haltImplementedsave.uncommitted-fieldsproven v0.1.34
Evidence source
v0.1.34 harvestInvalidFields

What Abbicus knows

  • Commit Audit compares FormData vs visual fill; halts on mismatch.
  • Currently over-triggers on radios (see pattern.radio-groups).

What Abbicus does not know

  • Whether bypassing this halt for radios is safe across all forms.
Current blocker
none
Next recommended action
Refine per-control-type Commit Audit rules once radio selection proven.

Updated 2026-06-30

Investigations (2)

navInventoryProbe (form_grid_dom + form_entry_dom)Certifiedinvest.nav-probeproven v0.1.56
Evidence source
v0.1.54 / v0.1.55 / v0.1.56

What Abbicus knows

  • Snapshots frames + forms + fields; used to derive tree/grid/entry tokens.
  • Acceptance Gate polls for target URL before snapshot (v0.1.55).

What Abbicus does not know

No open unknowns recorded.

Current blocker
none
Next recommended action
none — no evidence supports a recommendation yet

Updated 2026-06-25

Investigation Mode (generic passive observer)Discoveredinvest.investigation-mode

Blocker: Awaiting PO decisions on 3 scoping questions.

Evidence source
none recorded

What Abbicus knows

  • Design intent: reusable dev capability to remove unknowns after 2 failed attempts.

What Abbicus does not know

  • Scope of interaction (passive vs one scoped click).
  • Trigger (automatic vs operator).
  • Where output surfaces (new tab vs existing panel).
Current blocker
Awaiting PO decisions on 3 scoping questions.
Next recommended action
PO answers scoping questions; then write roadmap doc + Core rule.

Updated 2026-06-30

Known blockers (3)

Hidden / template controls polluting selectorsDiscoveredblocker.hidden-template-controls
Evidence source
radio_evidence from v0.1.73

What Abbicus knows

  • TPL renders hidden grid-template controls that share ids/prefixes with live controls.
  • Discovery must filter by visibility AND form/frame ownership.

What Abbicus does not know

  • Full inventory of TPL screens where this pattern applies.
Current blocker
none
Next recommended action
Add visibility filter to all selector discovery helpers; audit after Investigation Mode ships.

Updated 2026-06-30

Red 'required' visual indicatorsDiscoveredblocker.red-required-indicators
Evidence source
operator screenshots (1099-R entry form)

What Abbicus knows

  • TPL marks required fields with red visual indicators (not always ARIA required).

What Abbicus does not know

  • Whether these correlate with save_readiness invalid-field reporting.
Current blocker
none
Next recommended action
Correlate red-indicator DOM signal with harvestInvalidFields output during next investigation.

Updated 2026-06-30

Launch Program opens duplicate TPL tabsImplementedblocker.duplicate-tpl-tabsfailed v0.1.74

Blocker: Awaiting user manual build + install of v0.1.75.

Evidence source
v0.1.75 (staged, not yet released)

What Abbicus knows

  • Root cause: Chrome session restore re-opens prior TPL tab.
  • v0.1.75 patches Launch to attach to existing TPL tab via listTargets().

What Abbicus does not know

  • Behavior confirmed in live Chrome session (build pending user dispatch).
Current blocker
Awaiting user manual build + install of v0.1.75.
Next recommended action
User runs build-agent.yml, installs, verifies single-tab behavior; then bump AGENT_LATEST_VERSION.

Updated 2026-06-30

Failed / uncertified capabilities (1)

Save Recovery / Requires Attention workflowUnknowncap.save-recovery

Blocker: Deferred by policy until 1099-R green.

Evidence source
mem://roadmap/exception-mode-requires-attention.md

What Abbicus knows

  • Design intent: recover-once then skip; categorize forms 🟦/🟨/🟥; never halt whole return.
  • Deferred until 1099-R milestone is green.

What Abbicus does not know

  • Implementation shape; UI surface; audit trail requirements.
Current blocker
Deferred by policy until 1099-R green.
Next recommended action
Do not start until form.1099r-single and form.1099r-multi are certified.

Updated 2026-06-30