> 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-session06-ingest-ui-connect-prompt-starter-chips/tasks.md).

# Task Checklist

**Session ID**: `phase26-session06-ingest-ui-connect-prompt-starter-chips` **Total Tasks**: 20 **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 | 7      | 7      | 0         |
| Testing        | 4      | 4      | 0         |
| **Total**      | **20** | **20** | **0**     |

***

## Setup (3 tasks)

Initial configuration and environment preparation.

* [x] T001 \[S2606] Verify Sessions 03 and 05 prerequisites, admin hook exports, `/__token` behavior, and Session 06 stub scope (`.spec_system/PRD/phase_26/session_06_ingest_ui_connect_prompt_starter_chips.md`)
* [x] T002 \[S2606] Inspect upstream ingest, connect prompt, starter chip, and mini stat behavior for AI OS-safe adaptation only (`/home/aiwithapex/projects/claudeos/claude-os-v2.4/src/routes/codegraph.tsx`)
* [x] T003 \[S2606] Confirm current Knowledge Graph page composition and existing tests before adding write-capable UI (`src/components/knowledge-graph/knowledge-graph-page.tsx`)

***

## Foundation (6 tasks)

Core structures and base implementations.

* [x] T004 \[S2606] \[P] Create the token query hook for `/__token` with typed success, malformed, fetch-error, offline, demo, and abort-cleanup states (`src/hooks/use-knowledge-graph-token.ts`)
* [x] T005 \[S2606] \[P] Create the pure connect prompt builder and starter-question definitions with no tokenless-write, curl, header, raw token, or direct mutation endpoint instructions (`src/lib/knowledge-graph-connect-prompt.ts`)
* [x] T006 \[S2606] \[P] Create the reusable Knowledge Graph mini stat tile with stable dimensions, tabular numbers, bounded labels, and long-text overflow handling (`src/components/knowledge-graph/knowledge-graph-mini-stat.tsx`)
* [x] T007 \[S2606] Define the ingest card props and state model around read view, token view, and admin mutation views with state reset on close/re-entry (`src/components/knowledge-graph/knowledge-graph-ingest-card.tsx`)
* [x] T008 \[S2606] Define connect prompt card props, clipboard state, fallback copy path, and redacted failure messaging with state reset on collapse (`src/components/knowledge-graph/knowledge-graph-connect-prompt.tsx`)
* [x] T009 \[S2606] Define starter chip props and event dispatch helpers with platform-appropriate accessibility labels, focus management, and repeated-click support (`src/components/knowledge-graph/knowledge-graph-starter-chips.tsx`)

***

## Implementation (7 tasks)

Main feature implementation.

* [x] T010 \[S2606] Implement `KnowledgeGraphIngestCard` collapsed and expanded UI for local path or Git/GitHub URL input with explicit loading, empty, error, offline, demo, admin-disabled, token-failure, and graphify-missing states (`src/components/knowledge-graph/knowledge-graph-ingest-card.tsx`)
* [x] T011 \[S2606] Implement ingest submit through `useKnowledgeGraphAdmin().ingest.run` with duplicate-trigger prevention while in-flight, disabled buttons, trimmed input, optional name handling, success reset, and scoped rollback on error (`src/components/knowledge-graph/knowledge-graph-ingest-card.tsx`)
* [x] T012 \[S2606] Implement active graph remove action through `useKnowledgeGraphAdmin().remove.run` with confirmation state, disabled-while-pending behavior, active-project revalidation, and graph-list refresh through hook invalidation (`src/components/knowledge-graph/knowledge-graph-ingest-card.tsx`)
* [x] T013 \[S2606] Implement the copyable connect-with-Hermes prompt card with clipboard success/fallback behavior, safe prompt preview, and no token, header, curl, or direct mutation text in copied output (`src/components/knowledge-graph/knowledge-graph-connect-prompt.tsx`)
* [x] T014 \[S2606] Implement starter-question chips that dispatch `hermes-chat-prefill`, preserve page state, and gracefully no-op when the future chat anchor is absent (`src/components/knowledge-graph/knowledge-graph-starter-chips.tsx`)
* [x] T015 \[S2606] Wire token/admin hooks, ingest card, connect prompt, starter chips, and post-write refetch handling into the Knowledge Graph page without changing the thin route (`src/components/knowledge-graph/knowledge-graph-page.tsx`)
* [x] T016 \[S2606] Reuse the mini stat tile in gallery and side-rail metrics while preserving existing loaded, demo, offline, empty, and error read states (`src/components/knowledge-graph/knowledge-graph-project-gallery.tsx`)

***

## Testing (4 tasks)

Verification and quality assurance.

* [x] T017 \[S2606] \[P] Write token hook and prompt builder tests for token success/failure/offline/demo, registry path insertion, starter text, and forbidden unsafe prompt text (`src/hooks/__tests__/use-knowledge-graph-token.test.tsx`)
* [x] T018 \[S2606] \[P] Write ingest card tests for token, local path ingest, GitHub URL ingest, remove, demo/admin-disabled/offline/token-failure/graphify-missing states, duplicate prevention, and reset behavior (`src/components/knowledge-graph/__tests__/knowledge-graph-ingest-card.test.tsx`)
* [x] T019 \[S2606] \[P] Write connect prompt, starter chip, and page composition tests for copy success/fallback, redacted copy errors, `hermes-chat-prefill` dispatch, and preserved fallback graph content (`src/components/knowledge-graph/__tests__/knowledge-graph-connect-prompt.test.tsx`)
* [x] T020 \[S2606] Run focused tests, update any adjacent admin-hook expectations, and validate ASCII encoding for all Session 06 files (`.spec_system/specs/phase26-session06-ingest-ui-connect-prompt-starter-chips/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-session06-ingest-ui-connect-prompt-starter-chips/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.