Repository navigation
docs(ai-sessions): document AI design sessions in context files and README - #27
Merged
Merged
Conversation
…EADME Brings the tracked docs in line with AI sessions steps 1-5. Docs only. docs.md is gitignored, so its matching refresh stays local. - context/architecture-context.md: AI Design Agent section (turn = run, turn steps, code-enforced rules, settle on read, reliability, model config) and invariants 5-9 - context/project-overview.md: canvas snapshots in Vercel Blob (was "filesystem"); chat cards and canvas-aware generation - context/ui-context.md: AI sidebar session bar, saved chats and cards follow the paper conventions - context/progress-tracker.md: step 6 entry and current goal - README.md: local AI design agent setup Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
Important Review skippedAuto reviews are disabled on base/target branches other than the default branch. Please check the settings in the CodeRabbit UI or the ⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Advanced Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
Suharshit
added a commit
that referenced
this pull request
Sep 15, 2026
GitHub main has steps 1-3 only; steps 4-6 were merged into stacked base branches. Content matches local exactly; a stacked merge into main conflicts in 11 files, so main needs a sync commit whose tree is the stack head. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Suharshit
added a commit
that referenced
this pull request
Sep 15, 2026
* feat(ai-sessions): add persistent storage for AI design sessions The AI sidebar kept its chat in React state only, so a reload lost the transcript and any in-flight run. This adds the storage layer the multi-turn design agent will build on (not wired to the UI yet). - AiSession / AiMessage Prisma models + additive migration; sessions cascade with their project, messages cascade with their session - lib/ai/session-store.ts: 7-day sliding expiry, 10 sessions per user per project, 60 messages per session; reads ignore expired rows - GET/POST /api/projects/[projectId]/ai-sessions and GET/DELETE /api/projects/[projectId]/ai-sessions/[sessionId], private to the session's creator - Daily Vercel Cron cleanup at /api/cron/ai-sessions/cleanup, gated by CRON_SECRET (public in proxy.ts) Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(ai-sessions): run the AI Architect chat on stored sessions A reload no longer loses the chat or an in-flight run. Generation is still one-shot; this changes persistence and resume only. - POST /api/projects/[projectId]/ai-sessions/[sessionId]/turns stores the prompt and a PENDING reply carrying the run id (replaces POST /api/ai/design, which is removed) - Replies are settled from runs.retrieve whenever a session is read, so a turn is saved even if the tab closed mid-run; concurrent reads settle once - useAiSession replaces useDesignAgent: reopens the last chat, resumes pending runs via Realtime with a 4s polling fallback, stores new chats lazily on the first message - Sidebar session bar with saved-chat history (delete, expiry) and New chat - Limits moved to lib/ai/session-limits.ts for client use; formatRelativeTime extracted to lib/relative-time.ts Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(ai-agent): multi-turn design agent - clarify, plan, then generate Each turn is still one design-agent run, but the agent now keeps a requirements brief, asks up to 3 rounds of clarifying questions when an unknown would change the architecture, proposes a plan (components, flows, decisions with rationale and alternatives, assumptions), and only draws the diagram once the plan is approved. - lib/ai/agent-schema.ts: brief, question, plan, turn-analysis and run-result schemas; list limits trimmed in code rather than enforced as maxItems, which models don't reliably honour - lib/ai/prompts.ts, lib/ai/design-agent-engine.ts: analyze/plan/ generate on generateText + Output.object; code-enforced decision rules; per-step thinking level (Gemini 3) or budget (Gemini 2.x); one retry on schema mismatch; per-call timeouts - design-agent task: single attempt, maxDuration 300s - Turns route accepts message, answers, generate and skip; stored replies are validated run output (QUESTIONS / PLAN / RESULT) and run failures are shown as friendly messages Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(ai-agent): question, plan and result cards in the AI sidebar The AI Architect chat now renders the design agent's turns as cards instead of plain text, so users answer, skip and approve with buttons. - QuestionsCard: option chips and a free-text answer per question, Send answers and Skip; read-only with the chosen answers once sent - PlanCard: summary, highlighted key decisions with rationale and alternatives, components (folded after 6), flows, assumptions, and Draw this plan - ResultCard: canvas summary with collapsible decisions - Only the newest non-failed reply is interactive, and only while no turn is pending, mirroring the server's rules - useAiSession.sendTurn sends message, answers, generate and skip, with optimistic user text matching what the server stores - TurnInput, the generate/skip texts and payload readers now live in the client-safe agent-schema and are shared with the server; question and plan payloads also store the agent's reply Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(ai-agent): canvas-aware generation with roles, async edges and repair The design agent now sees what is already on the canvas, so follow-up requests extend the existing design instead of redrawing it, and generated diagrams match the starter templates' visual conventions. - lib/ai/canvas-summary.ts: compact canvas listing with refs (ex-N), kinds, used connection points, connections and notes, passed to the analyze, plan and generate steps - Generation schema: role + kicker instead of legacy dark colorId, sync/async delivery (async edges dashed); edges may reference existing components by ref - buildCanvasGraph: resolves refs, folds redrawn or repeated components into the existing/first node, drops unknown and duplicate links, and assigns connection points counting existing edges - lib/ai/graph-validation.ts + one repair call: duplicate/redrawn components, unknown refs, self loops, repeated links, >4 connections, unconnected components, missing plan components - Shared NODE_ROLES / getRoleFill and SHAPE_KICKERS in types/canvas.ts (starter templates use them) - Plan text no longer shows internal canvas refs Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * docs(ai-sessions): document AI design sessions in context files and README Brings the tracked docs in line with AI sessions steps 1-5. Docs only. docs.md is gitignored, so its matching refresh stays local. - context/architecture-context.md: AI Design Agent section (turn = run, turn steps, code-enforced rules, settle on read, reliability, model config) and invariants 5-9 - context/project-overview.md: canvas snapshots in Vercel Blob (was "filesystem"); chat cards and canvas-aware generation - context/ui-context.md: AI sidebar session bar, saved chats and cards follow the paper conventions - context/progress-tracker.md: step 6 entry and current goal - README.md: local AI design agent setup Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * feat(spec): generate a Markdown technical spec from the canvas The Specs tab now turns the current canvas into a Markdown technical spec that downloads automatically: an overview, key decisions highlighted as callouts, one Mermaid diagram section per group of connected components, a component reference, connections, and risks. - spec-agent Trigger task: reads the room, builds the spec graph in code, makes one structured model call for the prose (sanitised against the graph, internal refs stripped), renders the Markdown in code; aborts on an empty or oversized canvas - Stored on read like AI turns: GET /api/projects/[id]/spec uploads a finished run to private Vercel Blob and records it on Project (guarded on the run id); POST starts a run (409 while one is pending); GET .../spec/markdown downloads the file - Decisions recorded in the user's AI design sessions are included and tagged as recorded - Migration: TaskRun.kind (DESIGN or SPEC) and Project spec fields - useSpecGenerator and SpecPanel replace the placeholder Specs tab - Shared lib/ai/model.ts, lib/ai/run-failure.ts and lib/canvas-room.ts used by both agents Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * docs(tracker): record stacked merges of #25-#27 and the main sync need GitHub main has steps 1-3 only; steps 4-6 were merged into stacked base branches. Content matches local exactly; a stacked merge into main conflicts in 11 files, so main needs a sync commit whose tree is the stack head. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> * docs(tracker): record merging the AI stack into main Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Steps 1–5 replaced the one-shot "diagram from prompt" feature with saved, multi-turn AI design sessions, but the context files and README still described the old flow. This is step 6 of the AI sessions plan. It changes docs only; no code.
What
context/architecture-context.md:TaskRuncheckcontext/project-overview.md:context/ui-context.md: the AI sidebar session bar, saved-chat list and chat cards follow the paper conventions.context/progress-tracker.md: the step 6 entry and the current goal (the Specs tab is next).README.md: local AI setup covering the API key and model, the migrations, running and restarting the worker, andCRON_SECRETin production.docs.mdstays localdocs.mdis listed in.gitignoreand has never been committed, so it is not in this PR. The matching refresh was made in the local working copy:Keeping it local was a deliberate choice.
Verification
README.md, the context files and the localdocs.md(/api/ai/designoutside the token route,useDesignAgent,generateObject, "Diagram from prompt", "lost on reload", "filesystem"): no stale matches remain.docs.mdresolves.🤖 Generated with Claude Code