From 7c78320999de5c05a31d124642e63bf8968f8c40 Mon Sep 17 00:00:00 2001 From: johnnyjoygh Date: Sun, 19 Jul 2026 23:51:11 +0800 Subject: [PATCH] chore: cleanup docs --- .../definition.md | 35 - .../2026-03-23-memo-detail-outline/plan.md | 47 - .../definition.md | 98 - .../execution.md | 63 - .../2026-03-23-tag-blur-attribute/plan.md | 89 - .../definition.md | 41 - .../design.md | 63 - .../execution.md | 62 - .../plan.md | 106 - .../definition.md | 47 - .../2026-03-31-quick-voice-input/design.md | 58 - .../2026-03-31-quick-voice-input/execution.md | 40 - .../2026-03-31-quick-voice-input/plan.md | 63 - .../2026-04-06-memo-mentions/definition.md | 49 - docs/plans/2026-04-06-memo-mentions/design.md | 69 - .../2026-04-06-memo-mentions/execution.md | 37 - docs/plans/2026-04-06-memo-mentions/plan.md | 104 - .../definition.md | 70 - .../design.md | 173 -- .../execution.md | 105 - .../plan.md | 328 --- ...2026-05-02-activity-calendar-time-basis.md | 1018 ------- .../plans/2026-05-02-calendar-date-prefill.md | 738 ----- .../plans/2026-05-02-stt-audiollm-split.md | 1590 ---------- .../2026-05-02-transcription-settings.md | 1816 ------------ ...2026-05-12-first-screen-lazy-heavy-deps.md | 774 ----- .../plans/2026-05-12-placeholder-component.md | 776 ----- .../plans/2026-05-31-remove-react-use.md | 673 ----- .../plans/2026-06-08-openapi-mcp-support.md | 1562 ---------- .../2026-06-11-markdown-wysiwyg-editor.md | 2621 ----------------- ...2026-06-15-cel-filter-surface-expansion.md | 887 ------ ...-02-activity-calendar-time-basis-design.md | 124 - ...2026-05-02-calendar-date-prefill-design.md | 165 -- .../2026-05-02-stt-audiollm-split-design.md | 511 ---- ...026-05-02-transcription-settings-design.md | 155 - ...-12-first-screen-lazy-heavy-deps-design.md | 113 - ...2026-05-12-placeholder-component-design.md | 282 -- .../2026-05-31-remove-react-use-design.md | 82 - .../2026-06-08-openapi-mcp-support-design.md | 241 -- ...26-06-11-markdown-wysiwyg-editor-design.md | 168 -- ...-15-cel-filter-surface-expansion-design.md | 257 -- 41 files changed, 16300 deletions(-) delete mode 100644 docs/plans/2026-03-23-memo-detail-outline/definition.md delete mode 100644 docs/plans/2026-03-23-memo-detail-outline/plan.md delete mode 100644 docs/plans/2026-03-23-tag-blur-attribute/definition.md delete mode 100644 docs/plans/2026-03-23-tag-blur-attribute/execution.md delete mode 100644 docs/plans/2026-03-23-tag-blur-attribute/plan.md delete mode 100644 docs/plans/2026-03-24-user-resource-identifiers/definition.md delete mode 100644 docs/plans/2026-03-24-user-resource-identifiers/design.md delete mode 100644 docs/plans/2026-03-24-user-resource-identifiers/execution.md delete mode 100644 docs/plans/2026-03-24-user-resource-identifiers/plan.md delete mode 100644 docs/plans/2026-03-31-quick-voice-input/definition.md delete mode 100644 docs/plans/2026-03-31-quick-voice-input/design.md delete mode 100644 docs/plans/2026-03-31-quick-voice-input/execution.md delete mode 100644 docs/plans/2026-03-31-quick-voice-input/plan.md delete mode 100644 docs/plans/2026-04-06-memo-mentions/definition.md delete mode 100644 docs/plans/2026-04-06-memo-mentions/design.md delete mode 100644 docs/plans/2026-04-06-memo-mentions/execution.md delete mode 100644 docs/plans/2026-04-06-memo-mentions/plan.md delete mode 100644 docs/plans/2026-04-21-sso-user-identity-linkage/definition.md delete mode 100644 docs/plans/2026-04-21-sso-user-identity-linkage/design.md delete mode 100644 docs/plans/2026-04-21-sso-user-identity-linkage/execution.md delete mode 100644 docs/plans/2026-04-21-sso-user-identity-linkage/plan.md delete mode 100644 docs/superpowers/plans/2026-05-02-activity-calendar-time-basis.md delete mode 100644 docs/superpowers/plans/2026-05-02-calendar-date-prefill.md delete mode 100644 docs/superpowers/plans/2026-05-02-stt-audiollm-split.md delete mode 100644 docs/superpowers/plans/2026-05-02-transcription-settings.md delete mode 100644 docs/superpowers/plans/2026-05-12-first-screen-lazy-heavy-deps.md delete mode 100644 docs/superpowers/plans/2026-05-12-placeholder-component.md delete mode 100644 docs/superpowers/plans/2026-05-31-remove-react-use.md delete mode 100644 docs/superpowers/plans/2026-06-08-openapi-mcp-support.md delete mode 100644 docs/superpowers/plans/2026-06-11-markdown-wysiwyg-editor.md delete mode 100644 docs/superpowers/plans/2026-06-15-cel-filter-surface-expansion.md delete mode 100644 docs/superpowers/specs/2026-05-02-activity-calendar-time-basis-design.md delete mode 100644 docs/superpowers/specs/2026-05-02-calendar-date-prefill-design.md delete mode 100644 docs/superpowers/specs/2026-05-02-stt-audiollm-split-design.md delete mode 100644 docs/superpowers/specs/2026-05-02-transcription-settings-design.md delete mode 100644 docs/superpowers/specs/2026-05-12-first-screen-lazy-heavy-deps-design.md delete mode 100644 docs/superpowers/specs/2026-05-12-placeholder-component-design.md delete mode 100644 docs/superpowers/specs/2026-05-31-remove-react-use-design.md delete mode 100644 docs/superpowers/specs/2026-06-08-openapi-mcp-support-design.md delete mode 100644 docs/superpowers/specs/2026-06-11-markdown-wysiwyg-editor-design.md delete mode 100644 docs/superpowers/specs/2026-06-15-cel-filter-surface-expansion-design.md diff --git a/docs/plans/2026-03-23-memo-detail-outline/definition.md b/docs/plans/2026-03-23-memo-detail-outline/definition.md deleted file mode 100644 index 58a7b705..00000000 --- a/docs/plans/2026-03-23-memo-detail-outline/definition.md +++ /dev/null @@ -1,35 +0,0 @@ -## Background & Context - -The MemoDetail page (`web/src/pages/MemoDetail.tsx`) renders a memo's full content with a right sidebar (`MemoDetailSidebar`) on desktop. The sidebar currently shows share controls, timestamps, property badges (links, to-do, code), and tags. Memo content is rendered via `react-markdown` with custom heading components (h1–h6) in `MemoContent/markdown/Heading.tsx`. The page already has hash-based scroll-to-element infrastructure for comments (lines 39–43 of MemoDetail.tsx). - -## Issue Statement - -When viewing a memo with structured headings, there is no outline or table of contents in the MemoDetail sidebar, so readers cannot see the document structure at a glance or jump to specific sections. Heading elements rendered by the `Heading` component do not have `id` attributes, preventing any anchor-based navigation to them. - -## Current State - -- **`web/src/pages/MemoDetail.tsx`** (93 lines) — MemoDetail page. Hash-based `scrollIntoView` logic exists at lines 39–43 but only targets comment elements. The sidebar is rendered at lines 82–86 as ``. -- **`web/src/components/MemoDetailSidebar/MemoDetailSidebar.tsx`** (109 lines) — Desktop sidebar. Contains sections: Share (lines 58–65), Created-at (lines 67–76), Properties (lines 78–89), Tags (lines 91–102). Uses a reusable `SidebarSection` helper (lines 24–32). No outline section exists. -- **`web/src/components/MemoDetailSidebar/MemoDetailSidebarDrawer.tsx`** (36 lines) — Mobile drawer wrapper for the sidebar. -- **`web/src/components/MemoContent/markdown/Heading.tsx`** (30 lines) — Renders h1–h6 with Tailwind classes. Does not generate `id` attributes on heading elements. -- **`web/src/components/MemoContent/index.tsx`** (157 lines) — ReactMarkdown renderer. Maps h1–h6 to the `Heading` component (lines 72–101). No rehype-slug or equivalent plugin is installed. -- **`web/src/utils/markdown-manipulation.ts`** (143 lines) — Contains `fromMarkdown()` MDAST parsing with GFM extensions. Used for task extraction; no heading extraction exists. - -## Non-Goals - -- Redesigning the overall MemoDetail layout or sidebar structure beyond adding the outline section. -- Supporting outline for the mobile drawer — the outline section should appear in the desktop sidebar only for now. -- Adding active heading highlighting on scroll (scroll-spy behavior). -- Supporting outline in the memo list/timeline view (compact mode). -- Changing the existing heading visual styles in the content area. - -## Open Questions - -- Which heading levels to include in the outline? (default: h1–h4, matching user request) -- How to generate slug IDs — install `rehype-slug` or custom implementation? (default: lightweight custom slug generation in the Heading component to avoid a new dependency) -- Should the outline section be hidden when no headings exist? (default: yes, hide entirely like Properties/Tags sections) -- Should duplicate heading text produce unique slugs (e.g. `my-heading`, `my-heading-1`)? (default: yes, append numeric suffix for duplicates) - -## Scope - -**M** — Touches 3–4 files (Heading component, MemoDetailSidebar, possibly a new outline component, and a slug utility). Existing patterns (SidebarSection, hash scrolling) apply directly. No new subsystem or novel approach required. diff --git a/docs/plans/2026-03-23-memo-detail-outline/plan.md b/docs/plans/2026-03-23-memo-detail-outline/plan.md deleted file mode 100644 index 3c039677..00000000 --- a/docs/plans/2026-03-23-memo-detail-outline/plan.md +++ /dev/null @@ -1,47 +0,0 @@ -## Task List - -T1: Add heading extraction utility [S] — T2: Add slug IDs to Heading component [S] — T3: Create MemoOutline sidebar component [M] — T4: Integrate outline into MemoDetailSidebar [S] - -### T1: Add heading extraction utility [S] - -**Objective**: Provide a function to extract h1–h4 headings from markdown content with slugified IDs, reusing the existing MDAST parsing pattern from `markdown-manipulation.ts`. -**Files**: `web/src/utils/markdown-manipulation.ts` -**Implementation**: Add `HeadingItem` interface (text, level, slug) and `extractHeadings(markdown: string): HeadingItem[]` function. Use existing `fromMarkdown()` + `visit()` pattern. Visit `"heading"` nodes with depth 1–4, extract text from children, generate slug via `slugify()` helper (lowercase, replace non-alphanumeric with hyphens, deduplicate). Export both. -**Validation**: `cd web && pnpm lint` — no new errors - -### T2: Add slug IDs to Heading component [S] - -**Objective**: Generate deterministic `id` attributes on h1–h6 elements so outline links can scroll to them via `#hash`. -**Files**: `web/src/components/MemoContent/markdown/Heading.tsx` -**Implementation**: In `Heading` (~line 13), extract text from `children` using a `getTextContent(children)` helper that recursively extracts string content from React children. Generate slug with the same `slugify` logic. Apply `id={slug}` to the rendered ``. -**Validation**: `cd web && pnpm lint` — no new errors - -### T3: Create MemoOutline sidebar component [M] - -**Objective**: Create a modern, Claude/Linear-style outline component that renders h1–h4 headings as anchor links with indentation by level. -**Size**: M (new component file, modern styling) -**Files**: -- Create: `web/src/components/MemoDetailSidebar/MemoOutline.tsx` -**Implementation**: -1. Props: `{ headings: HeadingItem[] }` from `markdown-manipulation.ts` -2. Render a `