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
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 6 additions & 15 deletions AGENT_COORDINATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,21 +57,12 @@ Server Error) for an unknown slug.

## Active claims (who is editing what RIGHT NOW)

- **2026-07-14 · Codex release captain →** `.github/workflows/tier-b-preview.yml`,
`.github/workflows/post-deploy-verify.yml`, `scripts/post-deploy-verify.mjs`,
`tests/e2e/live-smoke.spec.ts`, release runbooks, and final migration governance/proof ·
repair fail-closed release truth and own the serial merge/deploy train · branch
`fix/release-verification-fail-closed`.
- **2026-07-14 · Codex message lane →**
`src/features/agents/components/FastAgentPanel/adapters/*`, direct message contract tests,
and `FastAgentPanel.UIMessageBubble.tsx` · build the identity-preserving Convex-to-AI-parts
adapter and the live bubble wrap · branch `codex/ai-elements-message`.
- **2026-07-14 · Codex tools lane →** `CollapsibleAgentProgress.tsx`,
`ToolCallTransparency.tsx`, `LiveEventCard.tsx`, and their dedicated tests · migrate the
reasoning/tool leaves with honest reachability · branch `codex/ai-elements-tools`.
- **2026-07-14 · Codex composer lane →** `FastAgentPanel.InputBar.tsx`, its direct tests,
and the minimal `FastAgentPanel.tsx` send-forwarding seam · preserve every composer
callback while wrapping the live input · branch `codex/ai-elements-composer`.
- **2026-07-14 · Codex release captain →**
`convex/domains/agents/agentPlanning.ts`, `agentMemory.ts`, their exact public-summary
projectors/tests, `FastAgentPanel.tsx#unused-ambient-subscriptions`, and final AI Elements
governance/proof · repair the signed-in production query-validator crash discovered by
live dogfood, then own the serial P0 merge/deploy/evidence train · branch
`fix/agent-query-summary-contracts`.

- **2026-06-03 · Claude →** `convex/*#handoff-token`, `src/.../ScratchnodePrivateBridge`,
`src/App.tsx#events-private-route`, `public/proto/home-v5.html#private-handoff` ·
Expand Down
27 changes: 26 additions & 1 deletion CHANGELOG/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,32 @@ This directory contains append-only per-surface changelog lanes. Each lane recor
### Pages and prototypes

- [`pages/proto-home-v5.md`](pages/proto-home-v5.md) — ScratchNode live-event prototype at `public/proto/home-v5.html`.
- [`pages/convex-events.md`](pages/convex-events.md) — ScratchNode live-event backend surface.
- [`pages/linkedin-daily-brief.md`](pages/linkedin-daily-brief.md) — LinkedIn daily-brief pipeline.
- [`pages/scratchnode-nodebench-bridge.md`](pages/scratchnode-nodebench-bridge.md) — ScratchNode-to-NodeBench bridge.

### Components

- [`components/fast-agent-panel.md`](components/fast-agent-panel.md) — FastAgentPanel AI Elements cutovers and preserved behavior seams.

### Integrations

- [`integrations/ai-elements.md`](integrations/ai-elements.md) — Vercel AI Elements scaffold, adapter, and governance integration.

### Build and bundling

- [`build/vite.md`](build/vite.md) — Vite/PWA chunking rules that affect runtime delivery.

### Scripts and operating systems

- [`scripts/improvement-loop.md`](scripts/improvement-loop.md) — self-improvement loop tooling.
- [`goals.md`](goals.md) — goal-driven development operating system.

## Format

Use the template in [`TEMPLATE.md`](TEMPLATE.md). Prepend new entries at the top of the relevant lane.
Use the template in [`TEMPLATE.md`](TEMPLATE.md). Prepend new entries at the top
of the relevant lane. Cross-link every affected lane for a multi-surface change.
Use the canonical squash SHA from `origin/main`; if it does not exist yet, use
the template's explicit pending marker and replace it before the final release
commit. Source, checks, visual proof, preview, and production-live state are
separate claims.
19 changes: 17 additions & 2 deletions CHANGELOG/TEMPLATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,23 @@ Each lane is append-only. Add the newest entry directly below the title and desc
## YYYY-MM-DD — Short imperative title
What changed and why in 1–3 sentences. Mention the user-visible effect and any important verification.

**Commit**: `<sha or this commit>`. **Author**: Homen Shum + Augment Agent.
**Touches**: `other/lane.md` if this is part of a multi-surface change.
**PR / canonical main commit**: `#NNN` / `<squash SHA>`.
Use `PENDING #NNN MAIN SHA / FINAL QA` only while the merge or exact-revision
verification is genuinely pending; replace it before the final release commit.

**Evidence state**:
- Source: `<merged | pending>`
- Checks: `<exact commands/result/SHA | not recorded>`
- Visual proof: `<path | not recorded>`
- Preview: `<URL + assertions | not recorded>`
- Production live: `<URL + deployed revision + assertions | not recorded>`

**Author**: Homen Shum + `<agent or contributor>`.
**Touches**: `other/lane.md` if this is part of a multi-surface change; use a
real relative Markdown link in the completed entry.
```

Skip entries for generated files, pure formatting, lockfile churn, or changes that would not help a future maintainer understand the surface.
Never fabricate screenshots, QA receipts, findings, Agentic UI Bar scores, test
counts, preview results, or production-live claims. A green build proves only
the build that ran; it does not prove a deployment.
15 changes: 15 additions & 0 deletions CHANGELOG/build/vite.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# Vite and PWA bundling

Append-only lane for Vite/Rolldown chunking and service-worker precache rules.
Newest entries first.

## 2026-07-14 — Preserve Shiki's lazy grammar splitting

Removed `@shikijs/*` from the shared editor manual chunk, routed emitted
grammar/theme chunks under `assets/shiki/`, and excluded that directory from
PWA precache. The rule preserves lazy language loading and avoids collapsing
the grammar set into an oversized eager/precache asset.

**PR / canonical main commit**: #516 / `c83a41c8`.
**Evidence state**: source merged. Build and chunk-size claims must be measured on the exact candidate revision.
**Touches**: [`../integrations/ai-elements.md`](../integrations/ai-elements.md), [`../components/fast-agent-panel.md`](../components/fast-agent-panel.md).
65 changes: 65 additions & 0 deletions CHANGELOG/components/fast-agent-panel.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
# FastAgentPanel

Append-only lane for behavior-preserving AI Elements adoption inside
`src/features/agents/components/FastAgentPanel/`. Newest entries first.

## 2026-07-14 — Migrate LiveEventCard onto the shared tool shell

LiveEventCard now composes the tool/task vocabulary, while live-event derivation
is shared with FastAgentPanel and the panel header is isolated behind its own
component contract. This records source merge, not visual-proof-complete or a
direct production DOM claim.

**PR / canonical main commit**: #527 / `28d704b2`.
**Evidence state**: source merged; later evidence states not recorded here.
**Touches**: [`../integrations/ai-elements.md`](../integrations/ai-elements.md).

## 2026-07-14 — Wrap the live composer without changing send semantics

InputBar now composes the `prompt-input` shell while the explicit send-contract
seam preserves send, stop, spawn, voice, attachment, model, and enhancement
behavior. This entry records source state only; visual and production proof are
tracked separately.

**PR / canonical main commit**: #526 / `3cc7cd06`.
**Evidence state**: source merged; later evidence states not recorded here.
**Touches**: [`../integrations/ai-elements.md`](../integrations/ai-elements.md).

## 2026-07-14 — Wrap the live message bubble around generic parts

UIMessageBubble now uses the message/reasoning/tool/source vocabulary while the
identity-preserving adapter routes domain cards through the existing custom
renderers and leaves live Convex hooks authoritative.

**PR / canonical main commit**: #525 / `165ecec2`.
**Evidence state**: source merged; later evidence states not recorded here.
**Touches**: [`../integrations/ai-elements.md`](../integrations/ai-elements.md).

## 2026-07-14 — Migrate tool-call transparency

ToolCallTransparency maps running, success, and error states onto the AI
Elements tool shell without changing the existing arguments/results disclosure.

**PR / canonical main commit**: #524 / `64203ded`.
**Evidence state**: source merged; later evidence states not recorded here.
**Touches**: [`../integrations/ai-elements.md`](../integrations/ai-elements.md).

## 2026-07-14 — Wrap the agent-progress disclosure

CollapsibleAgentProgress composes task, reasoning, and tool primitives while
preserving its exported ToolUIPart contract. This is a source-migration record,
not a claim that the component rendered on a live production path.

**PR / canonical main commit**: #523 / `a4fe5ee3`.
**Evidence state**: source merged; live-render evidence not claimed.
**Touches**: [`../integrations/ai-elements.md`](../integrations/ai-elements.md).

## 2026-07-14 — Adopt primitives in six low-risk leaves

TypingIndicator, ThoughtBubble, QuickCommandChips, LazySyntaxHighlighter,
AgentHierarchy, and SourceCard moved onto the themed primitive layer with their
public component contracts retained.

**PR / canonical main commit**: #516 / `c83a41c8`.
**Evidence state**: source merged; later evidence states not recorded here.
**Touches**: [`../integrations/ai-elements.md`](../integrations/ai-elements.md), [`../build/vite.md`](../build/vite.md).
34 changes: 34 additions & 0 deletions CHANGELOG/integrations/ai-elements.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# Vercel AI Elements integration

Append-only lane for the vendored primitive layer, shared adapters, design
governance, and integration-wide contracts. Newest entries first.

## 2026-07-14 — Add the identity-preserving Convex parts adapter

Added `convexToUIParts` as the shared parser for UIMessage parts. It retains
source part identity, separates generic parts from domain passthrough, and does
not take ownership of persistent text streams.

**PR / canonical main commit**: #521 / `30688119`.
**Evidence state**: source merged; adapter test evidence belongs to the exact tested revision.
**Touches**: [`../components/fast-agent-panel.md`](../components/fast-agent-panel.md).

## 2026-07-14 — Prevent code-token cache collisions

Changed the code-block token cache key to include the complete source so equal-
length snippets with the same prefix and suffix cannot display each other's
cached middle content.

**PR / canonical main commit**: #517 / `988a3f56`.
**Evidence state**: source merged; later evidence states not recorded here.
**Touches**: [`../components/fast-agent-panel.md`](../components/fast-agent-panel.md).

## 2026-07-14 — Establish the AI Elements primitive and governance layer

Vendored the themed AI Elements and isolated shadcn base primitives, added the
thin consumer layer, migrated six leaves, and created the design manifest,
56-file migration matrix, and visual-proof protocol.

**PR / canonical main commit**: #516 / `c83a41c8`.
**Evidence state**: source merged; no dated visual-proof folder is claimed by this entry.
**Touches**: [`../components/fast-agent-panel.md`](../components/fast-agent-panel.md), [`../build/vite.md`](../build/vite.md).
Loading
Loading