Files
ARCADIA-Studio/harness/TASK_LEDGER.md
T

3.8 KiB

Task Ledger — first release

Authoritative objective: attachment07aee762-7d27-4cbe-81c3-2e82c7170711/ goal-objective.md, read fully2026-09-06. STATE.md records execution; PLAN.md retains scope; DECISIONS.md and linked contracts preserve rationale.

Goal and success criteria

System engineers develop and iteratively reconcile OA/SA models through equivalent graphical, textual and REST workflows. Rust/Iced Windows/Linux, strict reST, traceability, navigable offline guidance and reproducible deployment. Acceptance requires native workflows, semantic evaluators and fresh independent review.

Given facts

  • User prioritizes Capella domain fidelity, hierarchy, typed ports and intuitive transitions in both directions, without its clutter and navigation friction.
  • Direct exchange drawing must avoid large endpoint dropdowns; ports must move between sides; contextual menus should replace persistent action clutter.
  • Modular source must be practical for humans/AI and Git. Text/graph/API parity is required. Behavior canvases must support editing and preserve drag selection.
  • Git/worktrees are authorized. Remote publication is not requested.

Verified facts

  • Original Capella SAB creates FE function input/output endpoints; component ports are separately Standard/Flow with explicit allocation. Native observations are in release-capella-workflow-benchmark.md; adopted contracts preserve that distinction.
  • Explorer/port discovery, editable routing, nested modular source and coupled REST bundles have scoped Windows/Linux acceptance. Evidence links are in STATE.md.
  • Direct palette connections, four-side port anchors, context menus and source folders passed real Windows/Linux operation. Passive stacked Canvas fixes native tooltip overprint; separate Frames did not. See release-port-drawing.md.
  • Persisted state editing now passes Windows/Linux native and independent review: creation, movement, direct transitions, typed forms, reconnection, fold/reopen. See release-state-editing.md. Scenario/process canvases still need direct editing.
  • Ordinary Document commands atomically synchronize source/model; failed writes retain drafts. Source comments require occurrence/provenance-aware edits, not whole-model equality or flat reformatting. Independent counterexamples were fixed.
  • R3 existing-target reconciliation remains name/description only. R6 data shape expansion is active implementation, not accepted functionality.

Assumptions and open questions

  • Nested aggregate files reduce cognitive load; any additional port/exchange/step shorthand must justify grammar complexity through real authoring tasks.
  • State placements proved viable without a second geometry system. Scenario/chain gestures still need their own occurrence/order semantics and task verification.
  • Routing offers a usable initial path plus manual pins; arbitrary dense diagrams are not guaranteed crossing-free. Measured dense full solve119ms remains a limit.
  • R3 typed historical bodies plus finite proposals appear simpler than a separate recursive semantic-value schema. This candidate awaits R6 freeze and review.

Decisions and current strategy

Preserve one typed core and validated command boundary. Retain current typed ports; R6 uses schema/source4 with explicit1/2/3 migration and no intermediate public4 shape. Freeze payload, defaults, inheritance, associations and identified interface allocations together. Preserve lexical includes/comments during migration.

Finish and independently verify R6, then semantic R3 reconciliation and direct scenario/process gestures. Complete lifecycle/recovery, hosted editing, guidance and fresh cross-disciplinary Windows/Linux acceptance. No subsystem checkpoint completes the first release. Current work is making measured implementation, review and runtime progress; no external blocker exists.