frontend-patterns/workplans/FEP-WP-0002-seed-language-validation.md

---
id: FEP-WP-0002
type: workplan
title: "Validate the seed frontend pattern language"
domain: infotech
repo: frontend-patterns
status: active
quality_dor: DoR-Ok
quality_dor_at: "2026-09-24"
quality_dor_by: codex
quality_dor_note: "Self-review against work-item-dor; see readiness assessment below."
reviewed_at: "2026-09-24"
reviewed_against_commit: "c161369ad58782ff0a13429c61cc7c8efc36e33d"
owner: codex
topic_slug: canon
created: "2026-09-23"
updated: "2026-09-27"
state_hub_workstream_id: "3350b7f2-375a-54e8-8f7c-3bf7c7c3af71"
---

# Validate the seed frontend pattern language

First executable cycle of `research/plan/ResearchProgram.md`, following `REVIEW.md`
and FEP-WP-0001. Readiness review on 2026-09-24: scaffold is present, source and
walkthrough templates exist, VC-01/VC-02 are defined, and deliverables below are
bounded. Schema reconciliation and source preparation began on 2026-09-24;
full source investigation and the M1 evidence gate remain incomplete.

T01 and source extraction in T02 can proceed independently. T03 admission requires both. Per the 2026-09-25 optimization direction,
a provisional synthetic T03 walkthrough may proceed with explicit evidence gaps
while T02 continues; this does not relax canonical admission.
Use `research/plan/ResearchProtocol.md`; track Q01–Q04 in the question ledger.

## Reconcile the metadata contract

```task
id: FEP-WP-0002-T01
status: done
priority: high
state_hub_task_id: "e59295dd-a087-5dbc-9bb2-230488c48e96"
```

Resolve relation spelling, force and pattern IDs, prerequisite target types,
multi-scale representation and editorial status versus evidence maturity.
Done when schema and template agree and a worked example resolves every reference.

## Establish traceable source evidence

```task
id: FEP-WP-0002-T02
status: done
priority: high
state_hub_task_id: "0eb32b3e-07d6-5e16-a735-7d75d9dace83"
```

Complete the first source case and a contrasting local-first source review.
Record source identity, URL, date/version, claim references, interpretations and
counterexamples. Reconcile README maturity claims with the evidence.

## Validate a connected seed corpus

```task
id: FEP-WP-0002-T03
status: progress
priority: medium
state_hub_task_id: "54940b04-1d0f-5bff-98d4-be290eca8048"
```

Author a small connected pattern set and exercise it in server-authoritative and
local-first scenarios. Show forces, alternatives, ordering rationale, resulting
contexts and failure modes. Record gaps, then define the minimum metadata
validator and graph export needed by these examples.


## Phase acceptance

Produce 6–10 connected draft patterns, complete VC-01 and VC-02, and write
`research/reviews/M1-SeedReview.md` with evidence for each M1 criterion. Include
rejected or merged candidates and any source-access limitations. Retain hypothesis
maturity where evidence is incomplete. Handoff broader investigations to FEP-WP-0003;
metadata tooling and empirical evaluation are tracked in FEP-WP-0004.


## Readiness assessment

Self-reviewed by codex against State Hub `policies/work-item-dor.md` on
2026-09-24. Outcome: DoR-Ok for the plan structure; child tasks remain to be
assessed before execution.

- Scope: metadata reconciliation, two contrasting source reviews, 6–10 draft
  patterns and VC-01/VC-02. Broad coverage, tooling implementation and real-repo
  validation are outside this cycle and belong to FEP-WP-0003/0004.
- Owner and repository: codex in frontend-patterns. No external intake; this follows
  the repository review and the user's research-program instruction.
- Dependencies: scaffold and templates are committed. No known blocker prevents
  T01 or source discovery. T03 depends on T01/T02; inaccessible sources must be
  reported and alternatives assessed rather than evidence invented.
- Execution boundary: documentation and read-only public-source research, with
  ordinary Git/State Hub synchronization. Deployments, purchases and third-party
  messaging are outside scope. This plan does not schedule background execution.
- Verification: schema/template agreement, traceable claims and references, two
  walkthrough reviews, explicit counterevidence and the M1 acceptance review.
- Done-condition: the phase acceptance section above; hypotheses may be rejected
  or deferred with reasons rather than falsely confirmed to close a task.


## Source investigation tooling

FEP-WP-0005 established `research/bench/README.md` and `scripts/research_bench.py`.
Use one isolated workspace per source excerpt, review original-source-grounded
claims/candidates/relations/critique, and follow `research/bench/Admission.md`.
The fixture run is synthetic and does not complete any task in this workplan.
T02 still owns source acquisition/review; T03 owns cross-source synthesis and cases.


## 2026-09-24 execution evidence

T01 completed: `canon/PatternSchema.md`, `canon/vocabulary.yaml` and the pattern
template agree on identities, scales, force keys, statuses, evidence and typed
relations. `research/examples/schema-contract.yaml` exercises resolved references;
`make schema-test` verifies it. Review: `research/reviews/SchemaAndSourcePreparation.md`.

T02 in progress: SRC-0001/SRC-0002 verified and indexed. Two original-passage
workspaces and four-call preflight plans are prepared under `research/bench/infospaces/`.
No live generation or complete source review is claimed. Selection of model/provider,
source-grounded investigation, broader case review and counterexamples remain.


## First source investigation — 2026-09-24

Attempted the two four-stage source investigations with Gemini 2.5 Flash through
OpenRouter. Both stopped at the first call; a separate authentication probe returned
HTTP 401. No provider-generated research artifacts exist. The existing workload
credential route does not apply to a generic workstation client; a correct route or
provider was requested from the user. Failed receipts are retained.

Manual authority-focused reviews are in `research/cases/CarniatoGrandUnifyingArchitecture.md`
and `research/cases/LocalFirstAuthority.md`; synthesis/dispositions are in
`research/reviews/AuthorityPilot.md`. Source catalog states are extracted, not fully
reviewed. Added safe error status/model recording to the adapter and a regression
check preventing raw sensitive diagnostic detail from entering receipts.

T02 remains progress: broader evidence and independent known uses are still needed.
Live reruns specifically depend on an authorized working credential; manual research
can continue. No failure of the research hypothesis is inferred from provider failure.


## llm-connect execution — 2026-09-24

User clarified that live execution must use llm-connect. Replaced direct OpenRouter
execution with the llm-connect service contract; no workstation credential required.
Service model/usage/finish reason and safe failure receipts are retained. Carniato
`-03` completed four stages; Carniato `-02` and local-first `-02` were truncated and
rejected. Review: `research/reviews/LLMConnectPilot.md`. No proposal admitted.

T02 remains progress and owns the next bounded steps: resolve local-first truncation
with explicit research settings; tighten prompts and checks around unsourced known
uses, recurrence and claim-vs-pattern relation targets; continue source evidence.
These replace the earlier workstation-credential dependency. T03 remains todo.


## Bounded pipeline refinement — 2026-09-25

T02: tightened prompts, added conservative evidence-ledger/relation screening and
captured-failure regression checks. The historical Carniato proposal is blocked;
checks never grant semantic admission. See research/reviews/ResearchPipelineRefinement.md.
A fresh local-first `-03` run through llm-connect with requested low reasoning and
6,000 completion tokens again truncated at claims (one service request, 6,525 total
tokens). No further retry or pattern admission. T02 remains progress.

Next bounded action: establish effective service reasoning settings and token
breakdown, or a documented research profile, before another live attempt. Then
verify the revised prompts in a complete run and perform editorial review. Missing
provider diagnostics remain an execution limitation, not a research conclusion.


## Truncation diagnosed and bounded investigation completed — 2026-09-25

T02: live diagnostics confirmed reasoning_effort is dropped before the provider;
rejected `-05` output revealed pathological Markdown table padding, not reported
reasoning token use. Switched to compact records. Local-first `-06` completed four
stages through llm-connect, passed structural screening, and yielded a reviewed
negative finding: this packet does not justify a pattern. No pattern admission.
Evidence: research/reviews/TruncationDiagnosis.md and LocalFirstAdmissionScreen.json.

The previous effective-settings diagnostic action is complete; no service deployment
or credential change was needed. T02 remains progress for expanded source evidence:
located persistence, synchronization, conflict and independent implementation passages.
T03 remains todo for comparative walkthroughs and the connected seed corpus.


## Evidence expansion and candidate synthesis — 2026-09-25

T02: indexed SRC-0003–0007 official Joplin/Obsidian documentation and expanded SRC-0002
reading. Two llm-connect investigations completed all four stages. Joplin structural
screen passed; Obsidian claim-ID relations were blocked and editorially rejected.
Merged the useful mechanisms into research/candidates/ConflictCopy.md with hypothesis
maturity and two documented uses; no canonical admission. Full review and receipts:
research/reviews/LocalFirstEvidenceExpansion.md.

T02 remains progress for precise durability, independent runtime validation and
quality constraints. T03 remains todo; prepare the connected drafts and execute the
planned restart/reconnect comparison after the source-evidence gate. Do not count
multiple documentation pages from one application as independent implementations.


## Application-driven optimization — 2026-09-25

Implemented conditional-v1 stage execution, pre-propagation structural gates,
deterministic review handoff, explicit fingerprinted reuse and per-run call/cache/
structural-rejection metrics. Editorial corrections use a separate named record;
unknown is not zero. Synthetic smoke/replay verify two versus zero new adapter calls.
No new paid inference or broad source collection was needed.

T03 is now progress: research/walkthroughs/VC02-OfflineFieldNotes.md contains the first
synthetic trace, single-writer branch, baseline comparison and self-review. Four
connected research drafts remain hypotheses. Decision usefulness beyond baseline
is unknown; no runtime validation, canonical admission or M1 completion claimed.

Targeted next tasks: T02 obtain storage atomicity and receiver retry/ancestry evidence;
T03 define accessible conflict-review acceptance and execute the VC-01 contrast.
See research/reviews/ResearchOptimization.md for checks, corrections and dispositions.

## Transactional evidence and contrast — 2026-09-25

T02 remains progress: SRC-0008–0012 add Kubernetes/GitLab concurrent-write behavior,
Stripe bounded retry identity and React Router projection/feedback evidence. One
bounded Kubernetes investigation completed through llm-connect (two service calls,
2,849 reported tokens), with separate editorial review. API documentation is not
proof of complete frontend uses. Four new hypothesis drafts bring the developed
research set to eight; no canonical admission or M1 completion.

T03 remains progress: VC-01 now includes rejection, domain failure, unknown outcome,
late refresh, keyboard/privacy requirements, a single-writer branch and baseline
comparison. VC01-VC02-Comparison records shared concerns and differing acceptance
boundaries. Usefulness beyond plain narrative remains unknown.

Next bounded actions under T02: inspect two actual frontend implementations for
draft retention and unknown-outcome recovery at exact revisions. Under T03: obtain
independent review of both cases and their baselines. Existing offline atomicity,
receiver ancestry/retry and accessible reconciliation evidence gaps remain active.
Evidence: research/reviews/TransactionalEvidenceExpansion.md.

## Pinned frontend recovery evidence — 2026-09-25

T02: inspected Zulip and Element at exact commits, with a separately pinned Matrix
SDK and Matrix v1.15 protocol reference (SRC-0013–0016). File hashes/locators retained.
Two partial uses support draft/intent separation; full-pattern recurrence and runtime
correctness remain unknown. Element/SDK count as one implementation family; deployed
dependency pairing is not verified. No new patterns or canonical admission.

T03: reviewed frozen VC-01/VC-02 through llm-connect. First response truncated and was
quarantined; one shorter follow-up completed. Two calls, 10,605 reported tokens.
Both model fixes rejected editorially. Separately corrected opA blocking/supersession,
read-generation/consistency assumptions and late receipt/error handling. Independent
human review and baseline usefulness remain open; M1 is not complete.

Next bounded work: T02 pin an actual client/SDK/server pairing and exercise lost
response/delayed echo recovery; retain existing offline crash/ancestry/accessibility
gaps. T03 prepare a blinded matched comparison using unseen variants and independent
review. See research/reviews/FrontendRecoveryImplementations.md and
research/reviews/RecoveryWalkthroughReview.md. T02/T03 remain progress.

## Executable SDK recovery experiment — 2026-09-25

T02: resolved Element lockfile to the previously inspected SDK commit. Separately
executed published matrix-js-sdk 42.3.0 with a locked dependency set and controlled
transport. Four cases pass: lost response/same-event retry, negative control with
fresh identity after local cancellation, echo before success, and echo before error.
A rejected promise can coexist with an already reconciled event. The SDK initially
blocks fresh sends behind unresolved pending events; preserve this qualification.

Receiver deduplication is synthetic, not real-server evidence. No production changes,
external messages or inference calls. T02 remains progress for actual server,
offline storage/ancestry and accessibility guarantees. T03 remains progress for an
independent matched baseline comparison; experiment does not settle usefulness.
Eight drafts remain hypotheses, with no canonical admission or M1 completion.
See research/reviews/MatrixRecoveryExperiment.md and reproducible experiment files.

## Matched presentation pilot — preregistered 2026-09-26

T03: user authorized six new scenarios in two conditions (12 isolated llm-connect
sessions), with equivalent information, counterbalanced order and frozen rubrics.
Protocol, source hashes, packs and scorer masking are under
research/evaluations/language-pilot-01/. Freeze before generation; commit initial
condition-masked editorial scores before unmasking. Do not claim human validation.

Human follow-up remains part of T03: prepare masked answers/rubric/empty score sheet
for independent human review, record disagreements and adjudication before claiming
usefulness. No canonical admission or M1 completion follows from the model pilot.

## Presentation pilot results and human handoff — 2026-09-26

T03: all 12 isolated sessions completed through llm-connect, 14,677 reported tokens,
no retries or truncation. Preregistration 6acbe6d; masked editorial scores committed
in 3690af1 before unmasking. Named presentation met 21/24 obligations versus 19/24
for equivalent prose; each had two unsupported claims. Pair comparison: two named
advantages, one prose advantage, three ties. Inconclusive, no human validation.

Human follow-up is explicitly pending within T03: use
research/evaluations/language-pilot-01/human-review/README.md and its empty score
sheet to obtain independent ratings, retain disagreements and adjudicate against
the frozen rubric. No human scores may be inferred or filled by a model. Shared
weaknesses concern policy-dependent retention, atomic supersession and backup/restore.
After human review, revise shared guidance if warranted and replicate on fresh
scenarios. These six briefs are consumed. T02/T03 remain progress; no M1 completion.

## User-submitted worksheet adjudicated — 2026-09-26

T03: imported worksheet-completed.md byte-for-byte under the pilot's
submitted-review-01 directory; verified all twelve answer texts and rubric rows.
The worksheet identifies GPT-5.6 Sol as reviewer, explicitly model review, with
aggregate-result exposure. Accepted as the user's submitted review without claiming
independent human validation or inventing external inference provenance.

Accepted all four binary-rating corrections under the frozen no-partial-credit
rubric: 44/48 ratings unchanged; updated totals 18/24 for both named and prose packs.
Original scores/summary remain immutable. Narrative unsafe-claim annotations are
retained with adjudication, not converted to an unsupported numeric count.
No presentation benefit demonstrated; equal counts do not establish equivalence.

User-review incorporation is complete. T03 remains progress: independent-human
validation is still unfulfilled under the frozen protocol, and later studies need
atomic criteria and fresh scenarios. Target shared guidance at policy-dependent
recovery, cancellation/reversal contracts, atomic supersession and backup/restore.
See research/evaluations/language-pilot-01/submitted-review-01/adjudication.md.

## Shared guidance corrected — 2026-09-26

T02/T03 remain progress. Applied submitted-review lessons to six current hypothesis
records: policy-dependent retention/export, cancellation/reversal and identity lookup,
atomic supersession, backup/restore and the difference between unknown and impossible.
See research/reviews/SharedGuidanceRevision.md. Frozen pilot files and scores remain
unchanged; historical corpus hashes remain reproducible. No new evaluation or M1
completion. WP-0003 T01 now owns a bounded exploratory navigation/rendering expansion;
independent-human validation and a fresh-scenario replication remain open here.

## Consolidated source and seed review — 2026-09-27

[SourceReadiness-0.1](../research/reviews/SourceReadiness-0.1.md) completes T02's
original documentary traceability deliverable. Later storage/receiver fault-validation
obligations are transferred to explicit WP-0003 T04, origin WP-0002 T02; independent
uses continue under WP-0003 T01 and human/usefulness under this T03. No evidence
obligation is declared satisfied merely by transfer. Workplan remains active.

[M1-SeedReview](../research/reviews/M1-SeedReview.md) records pass/revise/defer criteria.
The eight-record editorial core is suitable for a qualified research preview; M1
remains revise/defer and T03 progress. WP-0007 packages it without canonical admission,
independent-human claims or fresh held-out evaluation.