> For the complete documentation index, see [llms.txt](https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/.spec_system/archive/sessions/phase38-session10-hunk-reconciliation-and-release-gate/tasks.md).

# Task Checklist

**Session ID**: `phase38-session10-hunk-reconciliation-and-release-gate` **Total Tasks**: 22 **Estimated Duration**: 3-4 hours **Created**: 2026-06-30

***

## Progress Summary

| Metric          | Value    |
| --------------- | -------- |
| Tasks Completed | 22 / 22  |
| Current Task    | Complete |
| Blockers        | 0        |

***

Legend: `[x]` completed; `[ ]` pending; `[P]` parallelizable; `[SNNMM]` session ref; `TNNN` task ID.

***

## Setup (3 tasks)

* [x] T001 \[S3810] Verify deterministic project state, Sessions 01-09 validation prerequisites, and upstream comparison artifact availability (`.spec_system/PRD/phase_38/session_10_hunk_reconciliation_and_release_gate.md`)
* [x] T002 \[S3810] Create closeout ledgers for implementation notes, hunk reconciliation, release verification, and security compliance (`.spec_system/specs/phase38-session10-hunk-reconciliation-and-release-gate/implementation-notes.md`, `.spec_system/specs/phase38-session10-hunk-reconciliation-and-release-gate/hunk-reconciliation.md`, `.spec_system/specs/phase38-session10-hunk-reconciliation-and-release-gate/release-gate-verification.md`, `.spec_system/specs/phase38-session10-hunk-reconciliation-and-release-gate/security-compliance.md`)
* [x] T003 \[S3810] Record the Phase 38 changed-path ledger, resolved policies, and Suggested Test Checklist execution matrix (`.spec_system/specs/phase38-session10-hunk-reconciliation-and-release-gate/implementation-notes.md`)

***

## Foundation (4 tasks)

* [x] T004 \[S3810] Extract modified-file patch ranges and enumerate hunks for all 18 modified upstream files (`/home/aiwithapex/projects/claudeos/claude-os-v2.7_to_v2.8.1.full.patch`)
* [x] T005 \[S3810] \[P] Inventory the 21 added upstream files and map each to AI OS ownership, supersession, or skip status (`.spec_system/specs/phase38-session10-hunk-reconciliation-and-release-gate/hunk-reconciliation.md`)
* [x] T006 \[S3810] \[P] Collect Sessions 01-09 validation evidence for implemented, superseded, and policy-skipped Phase 38 slices (`.spec_system/specs/phase38-session09-intelligence-portal/validation.md`)
* [x] T007 \[S3810] Build the complete 39-path disposition table using only allowed statuses and required superseded/policy metadata (`.spec_system/specs/phase38-session10-hunk-reconciliation-and-release-gate/hunk-reconciliation.md`)

***

## Reconciliation And Corrections (8 tasks)

* [x] T008 \[S3810] Reconcile `scripts/aggregate.ts` upstream hunks against AI OS aggregate orchestration, platform helpers, and Dream health modules (`scripts/aggregate.ts`, `scripts/lib/aggregate-orchestration.ts`, `scripts/lib/dream/health.ts`)
* [x] T009 \[S3810] Reconcile `scripts/install-dream-cron.ts` upstream hunks against AI OS scheduler install, Dream install, platform, and user-warning behavior (`scripts/install-dream-cron.ts`, `scripts/lib/scheduler/dream-install.ts`, `scripts/lib/platform.ts`)
* [x] T010 \[S3810] Reconcile `vite.config.ts` upstream hunks against AI OS local control-plane, Host-header, token, Dream, voice, and Hermes chat behavior with schema-validated input and explicit error mapping (`vite.config.ts`)
* [x] T011 \[S3810] Reconcile home and setup route hunks against AI OS Dream engine, health, setup config, and browser-local activation behavior (`src/routes/index.tsx`, `src/routes/setup.tsx`, `src/components/setup/setup-modal.tsx`)
* [x] T012 \[S3810] Reconcile Hermes and Memory route hunks against the AI OS Hermes page, chat bridge, Intelligence portal, Knowledge Graph grounding, and source-count behavior (`src/routes/agents.hermes.tsx`, `src/routes/memory.tsx`, `src/components/hermes/hermes-read-only-page.tsx`)
* [x] T013 \[S3810] Reconcile docs, license, package metadata, launch config, and executable-mode hunks against AI OS policy decisions and current scripts (`README.md`, `CLAUDE.md`, `LICENSE`, `package.json`, `.claude/launch.json`, `.githooks/pre-commit`)
* [x] T014 \[S3810] Reconcile added platform, seed, Dream runner, voice broker, voice-lab, and Intelligence source files as ported, superseded, skipped-resolved-policy, or skipped-n/a (`scripts/lib/platform.ts`, `scripts/seed-data.ts`, `scripts/lib/voice-broker.ts`, `voice-lab/server.ts`, `src/components/hermes/intelligence/intelligence-portal.tsx`)
* [x] T015 \[S3810] Apply exact stale-claim corrections found by the docs and product-copy sweep without adding new feature scope (`README.md`, `docs/intelligence-view.md`, `docs/local-voice-setup.md`, `docs/runbooks/ai-os-dream.md`, `docs/development.md`, `docs/commands.md`, `voice-lab/README.md`, `voice-lab/index.html`)

***

## Verification (7 tasks)

* [x] T016 \[S3810] Run focused script unit tests for platform, aggregate, scheduler, Dream, setup, local-control-plane, Hermes bridge, voice broker, and voice launch behavior (`bun run test -- scripts/lib/__tests__/platform.test.ts scripts/lib/__tests__/aggregate-orchestration.test.ts scripts/lib/__tests__/scheduler-dream-handler.test.ts scripts/lib/__tests__/dream-install.test.ts scripts/lib/__tests__/dream-engine-config.test.ts scripts/lib/__tests__/dream-health.test.ts scripts/lib/__tests__/local-control-plane-guard.test.ts scripts/lib/__tests__/hermes-admin-bridge.test.ts scripts/lib/__tests__/voice-broker.test.ts scripts/lib/__tests__/voice-launch-bridge.test.ts`)
* [x] T017 \[S3810] Run focused app unit tests for Dream UI, setup config, Hermes admin, Intelligence events, voice lifecycle, portal, visualizers, and chat launcher behavior (`bun run test -- src/lib/__tests__/use-dream-engines.test.tsx src/lib/__tests__/use-dream-run.test.tsx src/lib/__tests__/setup-config.test.ts src/hooks/__tests__/use-hermes-admin.test.tsx src/lib/__tests__/hermes-intelligence-events.test.ts src/hooks/__tests__/use-hermes-intelligence-voice.test.tsx src/components/hermes/intelligence/__tests__/intelligence-portal.test.tsx src/components/hermes/intelligence/__tests__/visualizers.test.tsx src/components/hermes/chat/__tests__/hermes-chat-tab.test.tsx`)
* [x] T018 \[S3810] Run browser proof for Home Dream surfaces, setup wizard, Hermes Intelligence, and recovery/product-copy states (`bun run test:e2e -- tests/e2e/home-dashboard.spec.ts tests/e2e/setup-wizard.spec.ts tests/e2e/hermes-intelligence.spec.ts --project=chromium`)
* [x] T019 \[S3810] Run whole-repo static gates and production build, recording exact unrelated blockers if any command fails (`bun run typecheck`, `bun run typecheck:scripts`, `bun run lint`, `bun run format:check`, `git diff --check`, `bun run build`)
* [x] T020 \[S3810] Run security, privacy, dependency, and private-runtime sweeps for endpoint guards, provider-key handling, browser-safe data, short docs examples, and generated private artifacts (`bun audit --audit-level high`, `bun run runtime:check-private`)
* [x] T021 \[S3810] Record cross-platform, Windows-specific, macOS/Linux regression, Dream engine, and provider-credential proof or exact environment limitations (`.spec_system/specs/phase38-session10-hunk-reconciliation-and-release-gate/release-gate-verification.md`)
* [x] T022 \[S3810] Finalize release artifacts with ASCII/LF checks, no unresolved markers, complete superseded absolute paths, complete policy skip names, and summary-ready results (`.spec_system/specs/phase38-session10-hunk-reconciliation-and-release-gate/hunk-reconciliation.md`, `.spec_system/specs/phase38-session10-hunk-reconciliation-and-release-gate/release-gate-verification.md`, `.spec_system/specs/phase38-session10-hunk-reconciliation-and-release-gate/security-compliance.md`)

***

## Completion Checklist

* [x] All tasks marked `[x]`
* [x] All tests and checks passing or exact non-port blockers recorded
* [x] All files ASCII-encoded with LF line endings
* [x] implementation-notes.md updated
* [x] hunk-reconciliation.md includes all 39 changed paths and modified-file hunks
* [x] Ready for `updateprd` to mark the session and phase complete

***

## Next Steps

Run `updateprd`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/.spec_system/archive/sessions/phase38-session10-hunk-reconciliation-and-release-gate/tasks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.