From 1132a28e65ecad2a1edab54f993e422803d5ecf4 Mon Sep 17 00:00:00 2001 From: archae0pteryx Date: Sat, 17 Oct 2026 15:24:43 -0700 Subject: [PATCH] [release-proof]: Record verified v0.1.5 packages --- .../contracts/current-behavior.md | 2 +- specs/003-ranch-today/tasks.md | 9 ++++-- .../003-ranch-today/validation/pass-record.md | 29 +++++++++++++++++-- 3 files changed, 33 insertions(+), 7 deletions(-) diff --git a/specs/003-ranch-today/contracts/current-behavior.md b/specs/003-ranch-today/contracts/current-behavior.md index 05c12d3..271114f 100644 --- a/specs/003-ranch-today/contracts/current-behavior.md +++ b/specs/003-ranch-today/contracts/current-behavior.md @@ -25,7 +25,7 @@ V1–V7 refer to [quickstart](../quickstart.md). FR-013–FR-015 require accurat | FR-013 | Positional Timer drift is an observation, not a preservation requirement. | [Storage mapping](../../../crates/storage/src/focus_store.rs), draft [004](../../004-task-timer-hand-edits/spec.md); V7. | | FR-014 | Late-frame eligibility, indistinguishable stop endings, and invalidation/refetch recorded alongside ADR-0002 drift. | [Server](../../../crates/storage/src/agent_hooks/server/unix.rs), [events](../../../src-tauri/src/app/agent_hooks.rs), [reader](../../../src/api/tauriAgentSessionReader.ts); V7. | | FR-015 | Legacy direct entries remain; new install uses plugin/stable client. No cleanup added. | [Client placement](../../../src-tauri/src/app/claude_hook.rs), draft [007](../../007-one-hook-delivery/spec.md); V7. | -| FR-016 | macOS primary; Windows package builds passed; Linux packaging is an FR-016 target with build evidence still unverified; no Windows hook delivery. | [Windows workflow](../../../.github/workflows/windows.yml), [release matrix](../../../.github/workflows/release.yml); platform gates. | +| FR-016 | macOS primary; v0.1.5 macOS universal, Windows x64/ARM64, and Linux x64 packages built; no Windows hook delivery. Native acceptance remains open. | [Windows workflow](../../../.github/workflows/windows.yml), [release matrix](../../../.github/workflows/release.yml); platform gates. | | FR-018, FR-019, FR-020 | No sync/multi-user/import service, external work writer, auto-complete/merge, network API, slash command, or Harness notification forwarding. | Scoped source review V6; fixture file diffs V1/V5 check absence of unsolicited writes in exercised scenarios. | | FR-021, FR-022 | Primary-only default; Gather/no Wrangle; Pig and Claude Code only. | [Settings](../../../crates/domain/src/settings.rs), [Species](../../../crates/commands/src/render_scene.rs), tray; V3/V4/V6. | diff --git a/specs/003-ranch-today/tasks.md b/specs/003-ranch-today/tasks.md index 68e2a3d..40230c4 100644 --- a/specs/003-ranch-today/tasks.md +++ b/specs/003-ranch-today/tasks.md @@ -8,7 +8,7 @@ **Organization**: Setup → foundation → five independently verifiable user stories → cross-cutting reconciliation. Every task starts unchecked. Mark an execution task done when its stated work and honest result record are complete; a recorded failure or unverified check is not a passed acceptance criterion. -**Execution record (2026-10-17)**: The current-main automated gate passed. Native/platform observations remain unverified as detailed in [the pass record](validation/pass-record.md). Checked tasks record completed evidence assessment, not passed product acceptance; all six success criteria still need end-to-end proof. +**Execution record (2026-10-17)**: The current-main automated gate passed. Native acceptance remains unverified; T029 platform package builds passed in v0.1.5 as detailed in [the pass record](validation/pass-record.md). Checked tasks record completed evidence assessment, not passed product acceptance; all six success criteria still need end-to-end proof. ## Format and Paths @@ -183,7 +183,7 @@ These are scheduling examples, not instructions to spawn agents during task gene ## Phase 9: Convergence -**Assessment (2026-10-17):** 28 FR/SC entries, 16 acceptance scenarios, six plan decisions, four validation slices, and Constitution I–VI checked. Seven partial acceptance-evidence gaps remain: five HIGH, two MEDIUM. Existing implementation and automated proof do not establish the native results below. No additional confirmed code defect or constitutional violation was established by this bounded assessment. +**Assessment (2026-10-17, before release):** 28 FR/SC entries, 16 acceptance scenarios, six plan decisions, four validation slices, and Constitution I–VI checked. Seven partial acceptance-evidence gaps remain: five HIGH, two MEDIUM. Existing implementation and automated proof do not establish the native results below. No additional confirmed code defect or constitutional violation was established by this bounded assessment. **Constitution compliance:** This phase preserves local synthetic state, independent domains, typed boundaries, and explicit integration actions (I–IV). It requires actual acceptance evidence before completion claims (V), preserves Draft status and source classifications (VI), and grants no exception. FR-013–FR-015 remain observations; their fixes and stale follow-on issue contracts stay outside this baseline. @@ -197,8 +197,11 @@ These are scheduling examples, not instructions to spawn agents during task gene - [ ] T026 [US3] **HIGH — F4:** Execute native V4 in `specs/003-ranch-today/quickstart.md`: verify tray New Focus, Gather, delete cancellation/confirmation, Settings/Preferences naming, quit, immediate Settings application and restart persistence. Verify defaults 5/7, then cross lowered Focus/Task Limits while retaining writes, observe the red tray icon and one enabled notification per crossing without repeats, repeat with notifications disabled, and confirm completed Tasks count. Record evidence in `specs/003-ranch-today/validation/us3.md` and its `validation/pass-record.md` rows per SC-004, US3/AC1–AC3, FR-006–FR-008, and plan: ambient-shell validation (partial). T028 supplies the separate live-Agent exclusion proof; SC-004 cannot close until both portions are supported. - [ ] T027 **HIGH — F5:** Obtain a matching packaged Ranch build using existing `Taskfile.yaml` build commands if needed, then execute V6 from `specs/003-ranch-today/quickstart.md` with process-scoped network inspection while exercising the core synthetic scenarios. Record build identity, platform, inspection tool, process, observation window, exercised actions, and actual connection/listener results in `specs/003-ranch-today/validation/pass-record.md`; separate Vite traffic and explicit Claude CLI effects from product runtime. Source searches alone do not close this task per SC-006, FR-012, and plan: runtime-boundary validation (partial). - [ ] T028 [US5] **MEDIUM — F6:** Execute native/live V5 from `specs/003-ranch-today/quickstart.md` in an independently usable disposable Claude configuration with matching Ranch/Claude environment values and an explicit Install Hooks action. Verify default-off and opt-in visibility, no silent installation, a post-listener session Firing, Agent non-editability, unchanged Focus/Task files and Limits, and toggle-off hiding Agents while retaining Focus Animals/plugin. Open Agent Hooks and observe wiring/configuration health, live sessions, and recent Firings including an unchanged repeat; distinguish configuration health from real delivery. Record actual results in `specs/003-ranch-today/validation/us5.md` and its `validation/pass-record.md` rows without borrowing credentials or reading personal transcripts per SC-005, SC-004 (Agent exclusion), US5/AC1–AC4, FR-010–FR-011, and plan: Agent-boundary validation (partial). -- [ ] T029 **MEDIUM — F7:** Obtain successful Windows and Linux package-build evidence matching the assessed runtime source, using the existing non-publishing Windows workflow in `.github/workflows/windows.yml` and package commands/platform prerequisites defined by `.github/workflows/release.yml`. Use an appropriate target environment or matching recorded build results; do not create new pipelines or dispatch publishing release workflows. Record source/build identity, target, commands, exit status, and package artifacts in `specs/003-ranch-today/validation/pass-record.md`; workflow configuration or a compile-only result is not package proof, and Windows hook delivery remains unsupported per FR-016 and plan: retained platform compatibility (partial). +- [X] T029 **MEDIUM — F7:** Obtain successful Windows and Linux package-build evidence matching the assessed runtime source, using the existing non-publishing Windows workflow in `.github/workflows/windows.yml` and package commands/platform prerequisites defined by `.github/workflows/release.yml`. Use an appropriate target environment or matching recorded build results; do not create new pipelines or dispatch publishing release workflows. Record source/build identity, target, commands, exit status, and package artifacts in `specs/003-ranch-today/validation/pass-record.md`; workflow configuration or a compile-only result is not package proof, and Windows hook delivery remains unsupported per FR-016 and plan: retained platform compatibility (partial). **Execution and evidence:** Keep native work serial on the shared OS surface. Each task updates its story note where applicable and the shared evidence index, retaining earlier results as historical observations. T026's Focus/Task checks can finish independently; its Agent comparison is supplied by T028. Before declaring convergence, reconcile every affected FR/SC and acceptance scenario to the obtained proof. Preserve the existing current-source automated gate result unless relevant source changes or failures justify rerunning it. If required access remains unavailable, keep this phase open rather than cycling another implement/converge pass as proof. Path clarification for this phase: shortened `validation/pass-record.md` references in T023–T026 and T028 mean `specs/003-ranch-today/validation/pass-record.md`. + + +**Release checkpoint (2026-10-17):** T029 is complete: matching Windows smoke builds and the native v0.1.5 release matrix produced all required packages. All five downloaded release packages matched `SHA256SUMS.txt`; source/build identity and hashes are in [the release proof](validation/pass-record.md#release-package-proof-t029). T023–T028 remain unchecked for the owner’s later native/live test pass. No SC is promoted by package builds. diff --git a/specs/003-ranch-today/validation/pass-record.md b/specs/003-ranch-today/validation/pass-record.md index 8f96e7b..4220e7b 100644 --- a/specs/003-ranch-today/validation/pass-record.md +++ b/specs/003-ranch-today/validation/pass-record.md @@ -1,6 +1,6 @@ # Ranch Today Validation Pass -**Date**: 2026-10-17 | **State**: Convergence attempt incomplete; Linux package attempt failed; native acceptance remains open; no shipped completion claimed. +**Date**: 2026-10-17 | **State**: Platform package proof complete; v0.1.5 published; six native validation tasks remain open; no full native acceptance claimed. Runtime source commit: `a48525d9a89555bf9bc925a20d626c0dc634b4ce` (local main equals origin/main after a successful fetch). Tests run in a temporary detached worktree at that commit. The working checkout contains only unrelated/documentation edits, preserved in place. The clarified 003 documents guide this pass but remain Draft. @@ -121,7 +121,7 @@ Every tracked entry is assessed. UNVERIFIED means some required native/platform/ | FR-013 | OBSERVATION | T014/T019: positional drift, [US4](us4.md), follow-on 004/056. | | FR-014 | OBSERVATION | T016/T019: arrival-order/refetch drift, [US5](us5.md), follow-ons 005/059 and 061. | | FR-015 | OBSERVATION | T016/T019: retained legacy entries/current stable plugin client, [US5](us5.md), follow-on 007/062. | -| FR-016 | UNVERIFIED | T020/T029: fresh macOS and Windows x64/ARM64 packages passed; Linux package attempt failed at dependency linking under emulation. Native platform acceptance remains open; see the convergence execution below. | +| FR-016 | PASS (package/source scope) | T029: v0.1.5 macOS universal, Windows x64/ARM64, and Linux x64 packages passed; Windows hook delivery remains unsupported by the reviewed source. See [release package proof](#release-package-proof-t029). Native behavior remains outside this package claim. | | FR-017 | UNVERIFIED | T006/T020: [native attention scenario](us1.md) not performed. | | FR-018 | PASS (source scope) | T020: no sync, multi-user, or external work-import capability found. | | FR-019 | PASS (source scope) | T010/T018/T020: IPC/writer ownership reviewed; no network API, slash command, or integration work writer found. | @@ -135,7 +135,7 @@ Every tracked entry is assessed. UNVERIFIED means some required native/platform/ | SC-005 | UNVERIFIED | T017–T018: [controlled Agent proof](us5.md) passed; actual native visibility/non-editability journey absent. | | SC-006 | UNVERIFIED | T020: no packaged-process network observation. | -No unmapped entries. Four source-scoped PASS entries, three observations, and 21 entries with remaining proof gaps; all six success criteria remain UNVERIFIED end-to-end. Source/runtime discrepancies are linked to existing follow-on issues above. Unavailable observations are a manual validation backlog in [quickstart](../quickstart.md), not newly demonstrated product defects. +No unmapped entries. Five scoped PASS entries (four source-only, plus FR-016 package/source proof), three observations, and 20 entries with remaining proof gaps; all six success criteria remain UNVERIFIED end-to-end. Source/runtime discrepancies are linked to existing follow-on issues above. Unavailable observations are a manual validation backlog in [quickstart](../quickstart.md), not newly demonstrated product defects. ## Completion limits @@ -207,3 +207,26 @@ The owner explicitly authorized continuing through PR, independent review, merge 003 describes the existing product and adds no runtime implementation. Its known limitations remain observations with separately scoped follow-ons; this release does not implement the Draft 004–008 proposals or claim full 003 acceptance. The specification remains Draft. The shipping change contains only 003 planning/evidence documents and the release changelog; all unrelated dirty files are preserved outside its isolated branch. Constitution I–IV and VI retain the prior controls: unchanged local-data and integration contracts, independent domains, generated boundaries, explicit installation, and unchanged authority. For V, documentation delivery will require independent review, a green automated gate/PR CI, and merge. The owner has deferred product-level native acceptance; those criteria remain unverified rather than waived or marked complete. Release packaging must still succeed on every configured target before the existing workflow publishes. + + +## Release package proof (T029) + +**PASS — T029 complete.** [v0.1.5](https://github.com/killallgit/adhd-ranch/releases/tag/v0.1.5) was published at `2026-10-17T22:20:57Z` from `a6029d6ce2ac9c0e635975f252b0b8a0233e074b`. [Release run 39074102546](https://github.com/killallgit/adhd-ranch/actions/runs/39074102546) completed successfully: macOS universal DMG, Windows x64 NSIS, Windows ARM64 NSIS, and native Ubuntu 22.04 x64 AppImage/deb jobs all passed, including provenance attestations. Checksum generation, publication, and the existing release-asset retention job also passed. + +The unchanged release workflow runs `npm ci --no-audit --no-fund` and the existing Tauri package commands with a generated `release-version.json` containing `0.1.5`: macOS uses `--target universal-apple-darwin --bundles dmg`; Windows uses the x64/ARM64 MSVC targets with `--bundles nsis`; Linux uses `--bundles appimage,deb`. These are package builds, not compile-only evidence. The earlier matching non-publishing Windows smoke builds are retained above. No new pipeline, linker override, dependency change, or relaxed gate was introduced. + +The release source differs from the original assessed runtime `a48525d9a89555bf9bc925a20d626c0dc634b4ce` only in baseline documentation and changelog. `git diff --exit-code` across `crates/`, `src/`, `src-tauri/`, manifests/lockfiles, `Taskfile.yaml`, and `.github/workflows/` passed. The version override changes package metadata; assessed runtime/build source is unchanged. The native Linux success supersedes the missing package proof, without erasing the failed emulated attempt or claiming its crash cause is proven. + +Downloaded all five packages and `SHA256SUMS.txt` with `gh release download v0.1.5`. Python SHA-256 verification matched every package, and the manifest covered exactly the five downloaded packages: + +| Package | Bytes | SHA-256 | +|---|---|---| +| `Adhd.Ranch_0.1.5_darwin_universal.dmg` | 8,359,578 | `96c6733e92333b8da1f72a84bb10fddf195d01317ceaea524b8720894c8ae413` | +| `Adhd.Ranch_0.1.5_linux_amd64.AppImage` | 84,457,976 | `b85edd2f85f73354f0f55d7bf288e803c413cf993291540b49b34a3228c576ad` | +| `Adhd.Ranch_0.1.5_linux_amd64.deb` | 6,447,450 | `4591f12d2189a3a97fd751bd865ad41bdadef7d73472fb822f7131229d3a0110` | +| `Adhd.Ranch_0.1.5_windows_arm64-setup.exe` | 2,574,296 | `8cb05e9024764b916aba6a4f3d589eb0e51c7743cfd37cd74e82d57c87dfd9e7` | +| `Adhd.Ranch_0.1.5_windows_x64-setup.exe` | 2,847,131 | `49e9f50f196a8e085934e767ac22af5fd2077e7efef5d97b84ea76ecac006b4b` | + +Delivery: [PR #92](https://github.com/killallgit/adhd-ranch/pull/92) merged after independent review, correction of CodeRabbit's Linux-proof finding, and [current-head CI](https://github.com/killallgit/adhd-ranch/actions/runs/39073736207). Fresh local `rtk task check` passed (exit 0, 136.05 seconds), and [merged-main CI](https://github.com/killallgit/adhd-ranch/actions/runs/39073944179) passed before release dispatch. This proof update changes documentation only and reuses those unchanged-runtime results. + +T023–T028 remain open for the owner's deferred native/live testing. All six SCs remain unverified end to end; package builds do not establish UI behavior, notifications, live Claude delivery, or runtime network behavior. The specification remains Draft and FR-013–FR-015 remain known observations. No product acceptance or ADR-conformance waiver is claimed.