> 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/phase26-session08-homepage-surface-shared-brain-scripts-oauth/tasks.md). # Task Checklist **Session ID**: `phase26-session08-homepage-surface-shared-brain-scripts-oauth` **Total Tasks**: 23 **Estimated Duration**: 3-4 hours **Created**: 2026-06-09 *** ## Legend * `[x]` = Completed * `[ ]` = Pending * `[P]` = Parallelizable (can run with other \[P] tasks) * `[SNNMM]` = Session reference (NN=phase number, MM=session number) * `TNNN` = Task ID *** ## Progress Summary | Category | Total | Done | Remaining | | -------------- | ------ | ------ | --------- | | Setup | 3 | 3 | 0 | | Foundation | 6 | 6 | 0 | | Implementation | 10 | 10 | 0 | | Testing | 4 | 4 | 0 | | **Total** | **23** | **23** | **0** | *** ## Setup (3 tasks) Initial configuration and environment preparation. * [x] T001 \[S2608] Verify Sessions 02-07 prerequisites, current Knowledge Graph hook/component contracts, home route structure, and graphify endpoint names (`.spec_system/PRD/phase_26/session_08_homepage_surface_shared_brain_scripts_oauth.md`) * [x] T002 \[S2608] Inspect upstream setup script, dashboard-ingest script, and OAuth provider readiness reference for behavior mapping only (`/home/aiwithapex/projects/claudeos/claude-os-v2.4/scripts/setup-graphify-brain.sh`) * [x] T003 \[S2608] Confirm focused test seams for home components, script smoke checks, Hermes bridge status, scanner parity, and generated output ignore hygiene (`package.json`) *** ## Foundation (6 tasks) Core structures and base implementations. * [x] T004 \[S2608] \[P] Create the Knowledge Graph home summary helper for seed/live stats, provenance, savings, important files, bounded display paths, and deterministic ordering with types matching declared graph contracts; exhaustive enum handling (`src/lib/knowledge-graph-home-summary.ts`) * [x] T005 \[S2608] Define the home Knowledge Graph section skeleton with lazy renderer boundaries, compact AI OS layout, route CTA, and explicit loading, empty, error, and offline states (`src/components/home/knowledge-graph-section.tsx`) * [x] T006 \[S2608] \[P] Scaffold `setup-graphify-brain.sh` with repo-root resolution, install candidate detection, idempotency markers, quoted paths, and no credential output (`scripts/setup-graphify-brain.sh`) * [x] T007 \[S2608] \[P] Scaffold `graph-to-dashboard.sh` with target validation, `AI_OS_URL` base resolution, token read path, curl timeout settings, and safe error mapping (`scripts/graph-to-dashboard.sh`) * [x] T008 \[S2608] Add bridge-side provider readiness classification for OAuth providers versus API-key providers with schema-validated input and explicit error mapping (`scripts/lib/hermes-dev-bridge.ts`) * [x] T009 \[S2608] Mirror Hermes scanner provider readiness projection for OAuth providers so aggregate status matches bridge behavior (`scripts/lib/hermes-scanner.ts`) *** ## Implementation (10 tasks) Main feature implementation. * [x] T010 \[S2608] Wire the Knowledge Graph home section into the home route without expanding route-local derivation or disrupting existing sections (`src/routes/index.tsx`) * [x] T011 \[S2608] Implement the home section live/seed/demo preview, stats, provenance, savings, top files, lazy 3D fallback, accessible CTA, and bounded responsive text with platform-appropriate accessibility labels, focus management, and input support (`src/components/home/knowledge-graph-section.tsx`) * [x] T012 \[S2608] Implement graphify install/resolve/symlink behavior with command existence checks, quoted paths, bounded failure messages, and failure-path handling (`scripts/setup-graphify-brain.sh`) * [x] T013 \[S2608] Implement Hermes and Claude Code graphify skill registration plus single shared-brain note prepending with duplicate-trigger prevention while in-flight and idempotency protection (`scripts/setup-graphify-brain.sh`) * [x] T014 \[S2608] Implement structured registry `graphPath` backfill and optional Hermes restart with transaction-style temp write, rollback on error, and bounded command output (`scripts/setup-graphify-brain.sh`) * [x] T015 \[S2608] Implement dashboard reachability, token read, JSON POST to `/__graphify_ingest`, timeout handling, non-JSON response handling, and token redaction (`scripts/graph-to-dashboard.sh`) * [x] T016 \[S2608] Add the `graphify-out/` generated output ignore entry without changing unrelated ignore rules (`.gitignore`) * [x] T017 \[S2608] Implement Hermes dev bridge OAuth-provider setup fix so OAuth-backed providers are not blocked by absent API keys while known API-key providers still fail closed (`scripts/lib/hermes-dev-bridge.ts`) * [x] T018 \[S2608] Implement Hermes scanner parity for OAuth provider readiness, safe provider labels, and sanitized aggregate output (`scripts/lib/hermes-scanner.ts`) * [x] T019 \[S2608] Preserve existing public/sensitive Hermes endpoint behavior while extending status and connection metadata for provider readiness without exposing token store contents (`scripts/lib/hermes-dev-bridge.ts`) *** ## Testing (4 tasks) Verification and quality assurance. * [x] T020 \[S2608] \[P] Write home summary and section tests for live, seed fallback, demo, loading, empty, error, offline, lazy fallback, route CTA, and bounded text (`src/components/home/__tests__/knowledge-graph-section.test.tsx`) * [x] T021 \[S2608] \[P] Write script smoke tests for `bash -n`, AI OS wording, URL fallback, token redaction, idempotency markers, JSON payload encoding, curl timeout, and ASCII-only output (`scripts/lib/__tests__/graphify-shared-brain-scripts.test.ts`) * [x] T022 \[S2608] \[P] Extend Hermes bridge and scanner tests for OAuth providers, API-key providers, unknown providers, no token leakage, and unchanged endpoint gates (`scripts/lib/__tests__/hermes-dev-bridge.test.ts`) * [x] T023 \[S2608] Run focused tests, `bash -n` checks, and ASCII validation for all Session 08 files (`.spec_system/specs/phase26-session08-homepage-surface-shared-brain-scripts-oauth/tasks.md`) *** ## Completion Checklist Before marking session complete: * [x] All tasks marked `[x]` * [x] All tests passing * [x] All files ASCII-encoded * [x] implementation-notes.md updated * [x] Ready for the validate workflow step *** ## Next Steps Run the implement workflow step to begin AI-led implementation. --- # 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/phase26-session08-homepage-surface-shared-brain-scripts-oauth/tasks.md?ask=&goal= ``` `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.