Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
29 changes: 29 additions & 0 deletions .brv/context-tree/architecture/remote_control/extracted_facts.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
---
title: extracted_facts
summary: Extracted factual statements from provided context (full list with concise overview)
tags: []
related: []
keywords: []
createdAt: '2026-05-27T18:12:54.989Z'
updatedAt: '2026-05-27T18:12:54.989Z'
consolidated_at: '2026-05-27T23:37:51.479Z'
consolidated_from: [{date: '2026-05-27T23:37:51.479Z', path: architecture/remote_control/extracted_facts.abstract.md, reason: 'All three files document the same extracted facts about project loader behavior, design guidelines, and command taxonomy. The markdown file contains the full fact list, while the abstract and overview provide summaries. Merging preserves the complete facts and adds the concise summaries as a front‑matter summary section.'}, {date: '2026-05-27T23:37:51.479Z', path: architecture/remote_control/extracted_facts.overview.md, reason: 'All three files document the same extracted facts about project loader behavior, design guidelines, and command taxonomy. The markdown file contains the full fact list, while the abstract and overview provide summaries. Merging preserves the complete facts and adds the concise summaries as a front‑matter summary section.'}]
---
## Reason
Curate extracted factual statements from context

## Raw Concept
**Task:**
Extract factual statements

## Narrative
### Structure
Facts extracted from context

### Highlights
{{abstract_summary}}

{{overview_summary}}

## Facts
{{full_facts_list}}
Original file line number Diff line number Diff line change
@@ -1,11 +1,13 @@
---
title: Lossless Markdown Handling
summary: Result content renders full markdown losslessly; UI preview collapses with ctrl+o
summary: Result content renders full markdown losslessly; UI preview collapses with ctrl+O (full details below)
tags: []
related: []
keywords: []
createdAt: '2026-05-27T13:46:25.141Z'
updatedAt: '2026-05-27T13:46:25.141Z'
consolidated_at: '2026-05-27T23:37:51.482Z'
consolidated_from: [{date: '2026-05-27T23:37:51.482Z', path: architecture/result_content/lossless_markdown_handling.abstract.md, reason: 'These files cover the same topic – lossless markdown handling – with the markdown file providing the full description, the abstract giving a one‑sentence summary, and the overview offering a bullet‑point overview. Merging creates a single authoritative file that includes the detailed content plus the concise abstract and overview sections.'}, {date: '2026-05-27T23:37:51.483Z', path: architecture/result_content/lossless_markdown_handling.overview.md, reason: 'These files cover the same topic – lossless markdown handling – with the markdown file providing the full description, the abstract giving a one‑sentence summary, and the overview offering a bullet‑point overview. Merging creates a single authoritative file that includes the detailed content plus the concise abstract and overview sections.'}]
---
## Reason
Curate extracted facts from RLM extraction
Expand All @@ -21,13 +23,16 @@ Render result content without truncation, UI handles preview

## Narrative
### Structure
Result content module retains full markdown; Pi UI shows collapsed preview with ctrl+o to expand
Result content module retains full markdown; Pi UI shows collapsed preview with ctrl+O to expand

### Dependencies
Pi UI component, result-content renderer
Pi UI component, resultcontent renderer

### Highlights
Lossless markdown preserved, UI preview hint added

{{abstract_summary}}
{{overview_summary}}

### Examples
Collapsed view shows "..." and hint, expanded shows full markdown
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
confidence: 0.94
sources: [architecture/_index.md, facts/_index.md, facts/_index.md]
synthesized_at: '2026-05-27T23:38:23.762Z'
type: synthesis
title: Unified Remote‑Control Architecture Enforced by Server‑Owned State
summary: Remote‑control design centralizes state on the server and standardizes command interfaces across CLI, API, and UX layers.
tags: [remote-control, server-state, cli, api]
related: []
keywords: [remote, control, server, state, cli, api, sanitization, boundary, commands, ux]
createdAt: '2026-05-27T23:38:23.762Z'
updatedAt: '2026-05-27T23:38:23.762Z'
---

# Unified Remote‑Control Architecture Enforced by Server‑Owned State

Both the architecture and facts domains document a server‑owned, secret‑free remote boundary with structured control commands, reinforcing a consistent remote‑control model across implementation, review, and runtime conventions.

## Evidence

- **architecture**: Core architecture describes a server‑owned, secret‑free remote boundary with structured control commands.
- **facts**: Review outcomes (e.g., task_7_review_outcome) verify sanitization and server‑owned field boundaries for remote control.
- **facts**: Remote‑control review/outcome entries emphasize server‑side validation and redaction of client‑supplied fields.
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
---
title: clipboard fallback
summary: Facts about clipboard fallback
tags: []
related: []
keywords: []
createdAt: '2026-05-28T11:17:08.550Z'
updatedAt: '2026-05-28T11:17:08.550Z'
---
## Reason
Curated extracted facts from context

## Raw Concept
**Task:**
Document extracted factual statements

**Flow:**
extraction -> curation

**Timestamp:** 2026-05-28T11:17:08.519Z

## Narrative
### Structure
Facts grouped under clipboard fallback

### Highlights
Contains 1 factual statements

## Facts
- **clipboard fallback**: Clipboard fallback selects/focuses snippets implemented at index.astro:480-514.
39 changes: 39 additions & 0 deletions .brv/context-tree/codebase/caplets/caplets_module.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
title: Caplets Module
summary: Extracted facts and narrative for Caplets module
tags: []
related: []
keywords: []
createdAt: '2026-05-28T10:44:17.974Z'
updatedAt: '2026-05-28T10:46:57.621Z'
---
## Reason
Curate extracted facts from context

## Raw Concept
**Task:**
Document Caplets module knowledge

**Timestamp:** 2026-05-28T10:46:57.618Z

## Narrative
### Structure
Extracted factual statements and organized by subject.

### Dependencies
Relies on Node.js, Astro, and various plugins.

### Highlights
copy button visibility, page-load animations, responsive specificity, typecheck, build, format check, lint, impeccable check, risks, working tree

## Facts
- **copy button visibility**: Copy buttons are hidden by default and only shown via `.js-enabled .copy-button`.
- **page-load animations**: Header, hero copy, and title page-load animations plus related keyframes and blur motion were removed.
- **responsive specificity**: Tablet/mobile overrides were fixed with matching `.js-enabled .agent-setup-panels` and `.js-enabled .agent-setup-panel` selectors.
- **typecheck**: `pnpm --filter @caplets/landing typecheck` passed with 0 errors.
- **build**: `pnpm --filter @caplets/landing build` passed, building 1 page.
- **format check**: `pnpm format:check` passed.
- **lint**: `pnpm lint` passed.
- **impeccable check**: `npx impeccable --json apps/landing/src/pages/index.astro` passed, output `[]`.
- **risks**: There are no open risks or questions for the requested blockers.
- **working tree**: Existing unrelated working-tree changes remain untouched.
66 changes: 66 additions & 0 deletions .brv/context-tree/codebase/caplets/pr_preview_deploy_fix.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
---
title: pr_preview_deploy_fix
summary: Documented Alchemy fetch compatibility fix and CI workflow updates for PR preview deploy
tags: []
related: []
keywords: []
createdAt: '2026-05-28T11:44:45.781Z'
updatedAt: '2026-05-28T11:44:45.781Z'
---
## Reason
Curate fix details for PR preview deploy failure

## Raw Concept
**Task:**
Document PR preview deploy fix and related changes

**Changes:**
- Fixed InvalidArgumentError in Alchemy fetch compatibility
- Added scripts/alchemy-fetch-compat.mjs and test
- Updated package.json to run Alchemy with import shim
- Enhanced .github/workflows/pr-preview-deploy.yml
- Adjusted alchemy.run.ts for GitHub Actions metadata

**Files:**
- scripts/alchemy-fetch-compat.mjs
- scripts/alchemy-fetch-compat.test.mjs
- package.json
- .github/workflows/pr-preview-deploy.yml
- alchemy.run.ts

**Flow:**
detect error -> implement compatibility shim -> update workflow -> verify tests

**Timestamp:** 2026-05-28T11:44:45.779Z

**Author:** AI Assistant

## Narrative
### Structure
Added compatibility shim scripts and updated CI workflow to fix fetch dispatcher issue.

### Dependencies
Depends on undici@8.3.0 behavior in GitHub Actions.

### Highlights
All lint, typecheck, tests, schema, benchmark, and build passed after fix.

### Examples
Error: InvalidArgumentError: invalid onRequestStart method

## Facts
- **CI**: InvalidArgumentError: invalid onRequestStart method
- **Alchemy integration**: Alchemy passes a userland undici dispatcher into Node 24’s native fetch, and in GitHub Actions it resolves undici@8.3.0, which breaks the dispatcher interface
- **scripts/alchemy-fetch-compat.mjs**: scripts/alchemy-fetch-compat.mjs strips the incompatible dispatcher before native fetch
- **scripts/alchemy-fetch-compat.test.mjs**: scripts/alchemy-fetch-compat.test.mjs adds a regression test
- **package.json**: package.json runs Alchemy via node --import ./scripts/alchemy-fetch-compat.mjs
- **.github/workflows/pr-preview-deploy.yml**: .github/workflows/pr-preview-deploy.yml adds a PR-specific stage, GitHub token/metadata, issue comment permission, and clearer step name
- **alchemy.run.ts**: alchemy.run.ts removes placeholder your-username/your-repo, uses GitHub Actions repo metadata, and fixes comment markdown
- **format check**: pnpm format:check passes
- **lint**: pnpm lint passes
- **typecheck**: pnpm typecheck passes
- **test suite**: pnpm test runs 622 Vitest tests plus a shim regression test, all passed
- **schema check**: pnpm schema:check passes
- **benchmark check**: pnpm benchmark:check passes
- **build**: pnpm build passes
- **Cloudflare API parsing**: Cloudflare API JSON parsing works with the shim under Node 26
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
---
title: .copy-button min-height
summary: Facts about .copy-button min-height
tags: []
related: []
keywords: []
createdAt: '2026-05-28T11:17:08.521Z'
updatedAt: '2026-05-28T11:17:08.521Z'
---
## Reason
Curated extracted facts from context

## Raw Concept
**Task:**
Document extracted factual statements

**Flow:**
extraction -> curation

**Timestamp:** 2026-05-28T11:17:08.519Z

## Narrative
### Structure
Facts grouped under .copy-button min-height

### Highlights
Contains 1 factual statements

## Facts
- **.copy-button min-height**: apps/landing/src/styles/global.css:889-899 sets .copy-button to min-height: 32px, below the requested 44px target.
36 changes: 36 additions & 0 deletions .brv/context-tree/design/caplets/caplets_findings.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
---
title: Caplets Findings
summary: Extracted factual statements from caplets context
tags: []
related: []
keywords: []
createdAt: '2026-05-28T13:44:33.912Z'
updatedAt: '2026-05-28T13:44:33.912Z'
---
## Reason
Curate extracted findings from caplets source

## Raw Concept
**Task:**
Document caplets findings

**Timestamp:** 2026-05-28T13:44:33.909Z

## Narrative
### Structure
Aggregated factual statements extracted from caplets context

### Highlights
1 statements for task, 3 statements for index.astro, 1 statements for content_visibility, 1 statements for global.css, 1 statements for typecheck, 1 statements for build, 1 statements for repository_state, 1 statements for review

## Facts
- **task**: Implemented reveal motion resilience in apps/landing.
- **index.astro**: Removed the 1.8s global fallback in apps/landing/src/pages/index.astro.
- **content_visibility**: Keeps content visible by default unless IntersectionObserver is available and initialized.
- **index.astro**: Adds .motion-ready only after observer setup.
- **index.astro**: Adds a 100ms safety net if no observer update arrives.
- **global.css**: Reveal transition now uses only opacity and transform in apps/landing/src/styles/global.css.
- **typecheck**: pnpm --filter @caplets/landing typecheck passed with 0 errors.
- **build**: pnpm --filter @caplets/landing build passed, 1 page built.
- **repository_state**: Working tree contains unrelated pre-existing changes in global.css and other files.
- **review**: Recommended next step: review the landing diff before commit because of the pre-existing unrelated working tree changes.
43 changes: 43 additions & 0 deletions .brv/context-tree/design/caplets_copy/caplets_copy_guidance.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
---
title: Caplets Copy Guidance
summary: Guidelines for skill-like terminology and placement in Caplets marketing
tags: []
related: []
keywords: []
createdAt: '2026-05-28T09:54:35.504Z'
updatedAt: '2026-05-28T09:54:35.504Z'
---
## Reason
Curate branding copy decisions from conversation

## Raw Concept
**Task:**
Document copy guidance for Caplets skill-like branding

**Changes:**
- Defined copy guidance for skill-like terminology
- Specified placement recommendations

**Flow:**
conversation -> extraction -> curation

**Timestamp:** 2026-05-28T09:54:35.502Z

**Author:** Ian Pascoe

## Narrative
### Structure
Guidelines for using "skill-like" vs "skillify" in Caplets marketing copy

### Highlights
Use skill-like explicitly, avoid skillify as primary heading, hierarchy of language

### Examples
Caplets turns each backend into a skill-like capability...

## Facts
- **copy guidance**: Use “skill-like” explicitly, but be careful with “skillify.”
- **Caplets functionality**: Caplets turns each backend into a skill-like capability: one card first, then searchable tools, inspectable schemas, and safe calls only when needed.
- **Caplets description**: Skill-like backends for coding agents: Caplets wraps MCP servers, APIs, and commands as focused capabilities with progressive disclosure built in.
- **placement of “skillify”**: Avoid leading with “skillify” in the H1 unless a more opinionated brand voice is desired; better places are a small supporting phrase, section heading, docs concept, or “What Caplets does” explainer.
- **language hierarchy**: Primary language hierarchy: Primary – capability cards; Secondary – skill-like progressive disclosure; Avoid as primary – skillify, unless defined.
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
title: Apps/landing/src/pages/index.astro
summary: Facts about apps/landing/src/pages/index.astro
tags: []
related: []
keywords: []
createdAt: '2026-05-28T13:47:56.603Z'
updatedAt: '2026-05-28T13:47:56.603Z'
---
## Reason
Curated factual statements extracted from source context

## Raw Concept
**Task:**
Document facts for apps/landing/src/pages/index.astro

## Narrative
### Highlights
Extracted 1 facts

## Facts
- **apps/landing/src/pages/index.astro**: Changed file apps/landing/src/pages/index.astro.
22 changes: 22 additions & 0 deletions .brv/context-tree/design/caplets_curate/build.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
title: Build
summary: Facts about build
tags: []
related: []
keywords: []
createdAt: '2026-05-28T13:47:56.618Z'
updatedAt: '2026-05-28T13:47:56.618Z'
---
## Reason
Curated factual statements extracted from source context

## Raw Concept
**Task:**
Document facts for build

## Narrative
### Highlights
Extracted 1 facts

## Facts
- **build**: pnpm --filter @caplets/landing build passed, 1 page built.
10 changes: 10 additions & 0 deletions .brv/context-tree/design/caplets_curate/context.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# Topic: caplets_curate

## Overview
Review of integration tab/panel markup and JS for accessibility after progressive enhancement fix

## Key Concepts
- ARIA roles
- tablist
- tabpanel
- progressive enhancement
Loading