void;
+}
+
+export function AudioSection({
+ muteDoneSound,
+ onMuteDoneSoundChange,
+}: AudioSectionProps) {
+ return (
+
+ );
+}
diff --git a/apps/app/src/components/views/settings-view/cli-status/claude-cli-status.tsx b/apps/app/src/components/views/settings-view/cli-status/claude-cli-status.tsx
index e0283130..8df5b836 100644
--- a/apps/app/src/components/views/settings-view/cli-status/claude-cli-status.tsx
+++ b/apps/app/src/components/views/settings-view/cli-status/claude-cli-status.tsx
@@ -23,9 +23,8 @@ export function ClaudeCliStatus({
return (
void;
+ onNavigate: (sectionId: SettingsViewId) => void;
}
export function SettingsNavigation({
diff --git a/apps/app/src/components/views/settings-view/config/navigation.ts b/apps/app/src/components/views/settings-view/config/navigation.ts
index b98a6e66..e44fa829 100644
--- a/apps/app/src/components/views/settings-view/config/navigation.ts
+++ b/apps/app/src/components/views/settings-view/config/navigation.ts
@@ -3,14 +3,16 @@ import {
Key,
Terminal,
Palette,
- LayoutGrid,
Settings2,
+ Volume2,
FlaskConical,
Trash2,
+ Sparkles,
} from "lucide-react";
+import type { SettingsViewId } from "../hooks/use-settings-view";
export interface NavigationItem {
- id: string;
+ id: SettingsViewId;
label: string;
icon: LucideIcon;
}
@@ -19,9 +21,10 @@ export interface NavigationItem {
export const NAV_ITEMS: NavigationItem[] = [
{ id: "api-keys", label: "API Keys", icon: Key },
{ id: "claude", label: "Claude", icon: Terminal },
+ { id: "ai-enhancement", label: "AI Enhancement", icon: Sparkles },
{ id: "appearance", label: "Appearance", icon: Palette },
- { id: "kanban", label: "Kanban Display", icon: LayoutGrid },
{ id: "keyboard", label: "Keyboard Shortcuts", icon: Settings2 },
+ { id: "audio", label: "Audio", icon: Volume2 },
{ id: "defaults", label: "Feature Defaults", icon: FlaskConical },
{ id: "danger", label: "Danger Zone", icon: Trash2 },
];
diff --git a/apps/app/src/components/views/settings-view/danger-zone/danger-zone-section.tsx b/apps/app/src/components/views/settings-view/danger-zone/danger-zone-section.tsx
index e48aa471..b13d5fd3 100644
--- a/apps/app/src/components/views/settings-view/danger-zone/danger-zone-section.tsx
+++ b/apps/app/src/components/views/settings-view/danger-zone/danger-zone-section.tsx
@@ -16,9 +16,8 @@ export function DangerZoneSection({
return (
(initialView);
+
+ const navigateTo = useCallback((viewId: SettingsViewId) => {
+ setActiveView(viewId);
+ }, []);
+
+ return {
+ activeView,
+ navigateTo,
+ };
+}
diff --git a/apps/app/src/components/views/settings-view/keyboard-shortcuts/keyboard-shortcuts-section.tsx b/apps/app/src/components/views/settings-view/keyboard-shortcuts/keyboard-shortcuts-section.tsx
index a62bd3ac..10c25bc6 100644
--- a/apps/app/src/components/views/settings-view/keyboard-shortcuts/keyboard-shortcuts-section.tsx
+++ b/apps/app/src/components/views/settings-view/keyboard-shortcuts/keyboard-shortcuts-section.tsx
@@ -11,9 +11,8 @@ export function KeyboardShortcutsSection({
}: KeyboardShortcutsSectionProps) {
return (
Promise<{
+ success: boolean;
+ enhancedText?: string;
+ error?: string;
+ }>;
+ };
setup?: {
getClaudeStatus: () => Promise<{
success: boolean;
diff --git a/apps/app/src/lib/http-api-client.ts b/apps/app/src/lib/http-api-client.ts
index 9661ca06..ae9233d5 100644
--- a/apps/app/src/lib/http-api-client.ts
+++ b/apps/app/src/lib/http-api-client.ts
@@ -58,6 +58,12 @@ type EventType =
type EventCallback = (payload: unknown) => void;
+interface EnhancePromptResult {
+ success: boolean;
+ enhancedText?: string;
+ error?: string;
+}
+
/**
* HTTP API Client that implements ElectronAPI interface
*/
@@ -550,6 +556,20 @@ export class HttpApiClient implements ElectronAPI {
},
};
+ // Enhance Prompt API
+ enhancePrompt = {
+ enhance: (
+ originalText: string,
+ enhancementMode: string,
+ model?: string
+ ): Promise
=>
+ this.post("/api/enhance-prompt", {
+ originalText,
+ enhancementMode,
+ model,
+ }),
+ };
+
// Worktree API
worktree: WorktreeAPI = {
revertFeature: (projectPath: string, featureId: string) =>
diff --git a/apps/app/src/store/app-store.ts b/apps/app/src/store/app-store.ts
index ba28eb0e..3ae93d16 100644
--- a/apps/app/src/store/app-store.ts
+++ b/apps/app/src/store/app-store.ts
@@ -292,6 +292,7 @@ export interface Feature {
thinkingLevel?: ThinkingLevel; // Thinking level for extended thinking (defaults to none)
error?: string; // Error message if the agent errored during processing
priority?: number; // Priority: 1 = high, 2 = medium, 3 = low
+ dependencies?: string[]; // Array of feature IDs this feature depends on
// Worktree info - set when a feature is being worked on in an isolated git worktree
worktreePath?: string; // Path to the worktree directory
branchName?: string; // Name of the feature branch
@@ -422,6 +423,9 @@ export interface AppState {
// Audio Settings
muteDoneSound: boolean; // When true, mute the notification sound when agents complete (default: false)
+ // Enhancement Model Settings
+ enhancementModel: AgentModel; // Model used for feature enhancement (default: sonnet)
+
// Project Analysis
projectAnalysis: ProjectAnalysis | null;
isAnalyzing: boolean;
@@ -609,6 +613,9 @@ export interface AppActions {
// Audio Settings actions
setMuteDoneSound: (muted: boolean) => void;
+ // Enhancement Model actions
+ setEnhancementModel: (model: AgentModel) => void;
+
// AI Profile actions
addAIProfile: (profile: Omit) => void;
updateAIProfile: (id: string, updates: Partial) => void;
@@ -748,6 +755,7 @@ const initialState: AppState = {
showProfilesOnly: false, // Default to showing all options (not profiles only)
keyboardShortcuts: DEFAULT_KEYBOARD_SHORTCUTS, // Default keyboard shortcuts
muteDoneSound: false, // Default to sound enabled (not muted)
+ enhancementModel: "sonnet", // Default to sonnet for feature enhancement
aiProfiles: DEFAULT_AI_PROFILES,
projectAnalysis: null,
isAnalyzing: false,
@@ -1393,6 +1401,9 @@ export const useAppStore = create()(
// Audio Settings actions
setMuteDoneSound: (muted) => set({ muteDoneSound: muted }),
+ // Enhancement Model actions
+ setEnhancementModel: (model) => set({ enhancementModel: model }),
+
// AI Profile actions
addAIProfile: (profile) => {
const id = `profile-${Date.now()}-${Math.random()
@@ -2226,6 +2237,7 @@ export const useAppStore = create()(
showProfilesOnly: state.showProfilesOnly,
keyboardShortcuts: state.keyboardShortcuts,
muteDoneSound: state.muteDoneSound,
+ enhancementModel: state.enhancementModel,
// Profiles and sessions
aiProfiles: state.aiProfiles,
chatSessions: state.chatSessions,
diff --git a/apps/server/src/index.ts b/apps/server/src/index.ts
index 21c6de33..078c682f 100644
--- a/apps/server/src/index.ts
+++ b/apps/server/src/index.ts
@@ -22,6 +22,7 @@ import { createAgentRoutes } from "./routes/agent/index.js";
import { createSessionsRoutes } from "./routes/sessions/index.js";
import { createFeaturesRoutes } from "./routes/features/index.js";
import { createAutoModeRoutes } from "./routes/auto-mode/index.js";
+import { createEnhancePromptRoutes } from "./routes/enhance-prompt/index.js";
import { createWorktreeRoutes } from "./routes/worktree/index.js";
import { createGitRoutes } from "./routes/git/index.js";
import { createSetupRoutes } from "./routes/setup/index.js";
@@ -125,6 +126,7 @@ app.use("/api/agent", createAgentRoutes(agentService, events));
app.use("/api/sessions", createSessionsRoutes(agentService));
app.use("/api/features", createFeaturesRoutes(featureLoader));
app.use("/api/auto-mode", createAutoModeRoutes(autoModeService));
+app.use("/api/enhance-prompt", createEnhancePromptRoutes());
app.use("/api/worktree", createWorktreeRoutes());
app.use("/api/git", createGitRoutes());
app.use("/api/setup", createSetupRoutes());
diff --git a/apps/server/src/lib/enhancement-prompts.ts b/apps/server/src/lib/enhancement-prompts.ts
new file mode 100644
index 00000000..ca9bd3c0
--- /dev/null
+++ b/apps/server/src/lib/enhancement-prompts.ts
@@ -0,0 +1,456 @@
+/**
+ * Enhancement Prompts Library - AI-powered text enhancement for task descriptions
+ *
+ * Provides prompt templates and utilities for enhancing user-written task descriptions:
+ * - Improve: Transform vague requests into clear, actionable tasks
+ * - Technical: Add implementation details and technical specifications
+ * - Simplify: Make verbose descriptions concise and focused
+ * - Acceptance: Add testable acceptance criteria
+ *
+ * Uses chain-of-thought prompting with few-shot examples for consistent results.
+ */
+
+/**
+ * Available enhancement modes for transforming task descriptions
+ */
+export type EnhancementMode = "improve" | "technical" | "simplify" | "acceptance";
+
+/**
+ * Example input/output pair for few-shot learning
+ */
+export interface EnhancementExample {
+ input: string;
+ output: string;
+}
+
+/**
+ * System prompt for the "improve" enhancement mode.
+ * Transforms vague or unclear requests into clear, actionable task descriptions.
+ */
+export const IMPROVE_SYSTEM_PROMPT = `You are an expert at transforming vague, unclear, or incomplete task descriptions into clear, actionable specifications.
+
+Your task is to take a user's rough description and improve it by:
+
+1. ANALYZE the input:
+ - Identify the core intent behind the request
+ - Note any ambiguities or missing details
+ - Determine what success would look like
+
+2. CLARIFY the scope:
+ - Define clear boundaries for the task
+ - Identify implicit requirements
+ - Add relevant context that may be assumed
+
+3. STRUCTURE the output:
+ - Write a clear, actionable title
+ - Provide a concise description of what needs to be done
+ - Break down into specific sub-tasks if appropriate
+
+4. ENHANCE with details:
+ - Add specific, measurable outcomes where possible
+ - Include edge cases to consider
+ - Note any dependencies or prerequisites
+
+Output ONLY the improved task description. Do not include explanations, markdown formatting, or meta-commentary about your changes.`;
+
+/**
+ * System prompt for the "technical" enhancement mode.
+ * Adds implementation details and technical specifications.
+ */
+export const TECHNICAL_SYSTEM_PROMPT = `You are a senior software engineer skilled at adding technical depth to feature descriptions.
+
+Your task is to enhance a task description with technical implementation details:
+
+1. ANALYZE the requirement:
+ - Understand the functional goal
+ - Identify the technical domain (frontend, backend, database, etc.)
+ - Consider the likely tech stack based on context
+
+2. ADD technical specifications:
+ - Suggest specific technologies, libraries, or patterns
+ - Define API contracts or data structures if relevant
+ - Note performance considerations
+ - Identify security implications
+
+3. OUTLINE implementation approach:
+ - Break down into technical sub-tasks
+ - Suggest file structure or component organization
+ - Note integration points with existing systems
+
+4. CONSIDER edge cases:
+ - Error handling requirements
+ - Loading and empty states
+ - Boundary conditions
+
+Output ONLY the enhanced technical description. Keep it concise but comprehensive. Do not include explanations about your reasoning.`;
+
+/**
+ * System prompt for the "simplify" enhancement mode.
+ * Makes verbose descriptions concise and focused.
+ */
+export const SIMPLIFY_SYSTEM_PROMPT = `You are an expert editor who excels at making verbose text concise without losing meaning.
+
+Your task is to simplify a task description while preserving essential information:
+
+1. IDENTIFY the core message:
+ - Extract the primary goal or requirement
+ - Note truly essential details
+ - Separate nice-to-have from must-have information
+
+2. ELIMINATE redundancy:
+ - Remove repeated information
+ - Cut unnecessary qualifiers and hedging language
+ - Remove filler words and phrases
+
+3. CONSOLIDATE related points:
+ - Merge overlapping requirements
+ - Group related items together
+ - Use concise language
+
+4. PRESERVE critical details:
+ - Keep specific technical requirements
+ - Retain important constraints
+ - Maintain actionable specifics
+
+Output ONLY the simplified description. Aim for 30-50% reduction in length while keeping all essential information. Do not explain your changes.`;
+
+/**
+ * System prompt for the "acceptance" enhancement mode.
+ * Adds testable acceptance criteria to task descriptions.
+ */
+export const ACCEPTANCE_SYSTEM_PROMPT = `You are a QA specialist skilled at defining testable acceptance criteria for software features.
+
+Your task is to enhance a task description by adding clear acceptance criteria:
+
+1. UNDERSTAND the feature:
+ - Identify all user-facing behaviors
+ - Note system state changes
+ - Consider different user roles or scenarios
+
+2. DEFINE acceptance criteria using Given-When-Then format:
+ - Given: The initial context or preconditions
+ - When: The action or trigger
+ - Then: The expected outcome
+
+3. COVER key scenarios:
+ - Happy path (successful completion)
+ - Edge cases (boundary conditions)
+ - Error scenarios (what should NOT happen)
+ - Performance requirements if relevant
+
+4. MAKE criteria testable:
+ - Use specific, measurable outcomes
+ - Avoid vague terms like "quickly" or "easily"
+ - Include specific values where applicable
+
+Output the original description followed by a clear "Acceptance Criteria:" section with numbered, testable criteria. Do not include explanations about your process.`;
+
+/**
+ * Few-shot examples for the "improve" enhancement mode
+ */
+export const IMPROVE_EXAMPLES: EnhancementExample[] = [
+ {
+ input: "add dark mode",
+ output: `Add Dark Mode Theme Support
+
+Implement a dark mode option that allows users to switch between light and dark themes throughout the application.
+
+Requirements:
+- Add a theme toggle switch in the settings area
+- Store user's theme preference persistently
+- Apply dark theme colors to all UI components
+- Respect system preference as default if user hasn't set a preference
+- Ensure smooth transition when switching themes`,
+ },
+ {
+ input: "fix the login bug",
+ output: `Fix Login Authentication Flow
+
+Investigate and resolve issues preventing users from successfully logging in to the application.
+
+Requirements:
+- Identify the specific failure point in the login process
+- Ensure proper credential validation
+- Handle error states with clear user feedback
+- Verify session token is correctly stored after successful login
+- Test with various credential combinations (valid, invalid, edge cases)`,
+ },
+ {
+ input: "make it faster",
+ output: `Improve Application Performance
+
+Optimize application loading and response times to enhance user experience.
+
+Requirements:
+- Profile current performance to identify bottlenecks
+- Implement code splitting and lazy loading for routes/components
+- Optimize database queries and add appropriate indexes
+- Add caching for frequently accessed data
+- Set performance budget targets (e.g., LCP < 2.5s, FID < 100ms)
+- Measure and document improvements`,
+ },
+];
+
+/**
+ * Few-shot examples for the "technical" enhancement mode
+ */
+export const TECHNICAL_EXAMPLES: EnhancementExample[] = [
+ {
+ input: "Add user profile page",
+ output: `Add User Profile Page
+
+Create a dedicated profile page for viewing and editing user information.
+
+Technical Implementation:
+- Frontend: React component at /profile route with form validation
+- API Endpoint: GET/PUT /api/users/:id for fetching and updating profile
+- Data Model: Extend User schema with profile fields (avatar, bio, preferences)
+- File Upload: Integrate cloud storage for avatar images with client-side resizing
+- State Management: Use optimistic updates for better UX
+- Validation: Server-side validation matching client-side rules
+
+Components:
+- ProfileHeader (avatar, name, edit button)
+- ProfileForm (editable fields with validation)
+- AvatarUploader (drag-drop with preview)
+
+Security: Ensure users can only edit their own profile (auth middleware)`,
+ },
+ {
+ input: "Add search functionality",
+ output: `Add Search Functionality
+
+Implement full-text search across application content.
+
+Technical Implementation:
+- Search Engine: Use Elasticsearch or PostgreSQL full-text search
+- API: GET /api/search?q={query}&type={type}&page={page}
+- Indexing: Create search index with relevant fields, update on content changes
+- Frontend: Debounced search input (300ms) with typeahead suggestions
+- Results: Paginated results with highlighted matching text
+
+Architecture:
+- SearchService class handling query building and execution
+- SearchIndex worker for background indexing
+- SearchResults component with filtering and sorting
+
+Performance:
+- Implement search result caching (Redis, 5-minute TTL)
+- Limit results per page (20 items)
+- Add query complexity limits to prevent abuse`,
+ },
+];
+
+/**
+ * Few-shot examples for the "simplify" enhancement mode
+ */
+export const SIMPLIFY_EXAMPLES: EnhancementExample[] = [
+ {
+ input: `We need to implement a feature that would allow our users to be able to export their data in various different formats. The formats we are thinking about supporting include CSV which is commonly used for spreadsheet applications, and also JSON which is good for developers, and possibly PDF for people who want a printable version. The user should be able to go somewhere in the UI and select which format they want and then download their data in that format. We should probably also show some kind of progress indicator while the export is happening since it might take a while for large datasets.`,
+ output: `Add Data Export Feature
+
+Allow users to export their data in CSV, JSON, or PDF format.
+
+Requirements:
+- Add export button/menu in the UI
+- Support three formats: CSV (spreadsheets), JSON (developers), PDF (printing)
+- Show progress indicator during export
+- Handle large datasets gracefully`,
+ },
+ {
+ input: `The current notification system is not working very well and users are complaining about it. Sometimes they don't receive notifications at all, and other times they receive too many notifications and feel overwhelmed. We also have had reports that the notifications are not appearing correctly on mobile devices. Additionally, some users have requested the ability to customize which types of notifications they receive. We should look into all of these issues and make the notification system work better overall.`,
+ output: `Fix and Improve Notification System
+
+Address reliability issues and add user controls for notifications.
+
+Issues to fix:
+- Missing notifications (delivery reliability)
+- Notification overload (implement batching/digest)
+- Mobile display problems
+
+Enhancements:
+- Add notification preferences (per-type controls)
+- Test across devices and platforms`,
+ },
+];
+
+/**
+ * Few-shot examples for the "acceptance" enhancement mode
+ */
+export const ACCEPTANCE_EXAMPLES: EnhancementExample[] = [
+ {
+ input: "Add password reset functionality",
+ output: `Add Password Reset Functionality
+
+Allow users to reset their password via email when they forget it.
+
+Acceptance Criteria:
+
+1. Given a user is on the login page, when they click "Forgot Password", then they should see a password reset form requesting their email.
+
+2. Given a user enters a valid registered email, when they submit the form, then they should receive a password reset email within 2 minutes.
+
+3. Given a user clicks the reset link in their email, when the link is less than 1 hour old, then they should see a form to enter a new password.
+
+4. Given a user enters a new valid password (min 8 chars, 1 number, 1 special char), when they submit, then their password should be updated and they should be redirected to login.
+
+5. Given a user enters an unregistered email, when they submit the reset form, then they should see the same success message (security: don't reveal which emails exist).
+
+6. Given a reset link older than 1 hour, when a user clicks it, then they should see an expiration message with option to request a new link.`,
+ },
+ {
+ input: "Shopping cart checkout",
+ output: `Shopping Cart Checkout
+
+Implement the checkout flow for purchasing items in the shopping cart.
+
+Acceptance Criteria:
+
+1. Given a user has items in their cart, when they click "Checkout", then they should see an order summary with item details and total price.
+
+2. Given a user is on the checkout page, when they enter valid shipping information, then the form should validate in real-time and show estimated delivery date.
+
+3. Given valid shipping info is entered, when the user proceeds to payment, then they should see available payment methods (credit card, PayPal).
+
+4. Given valid payment details are entered, when the user confirms the order, then the payment should be processed and order confirmation displayed within 5 seconds.
+
+5. Given a successful order, when confirmation is shown, then the user should receive an email receipt and their cart should be emptied.
+
+6. Given a payment failure, when the error occurs, then the user should see a clear error message and their cart should remain intact.
+
+7. Given the user closes the browser during checkout, when they return, then their cart contents should still be available.`,
+ },
+];
+
+/**
+ * Map of enhancement modes to their system prompts
+ */
+const SYSTEM_PROMPTS: Record = {
+ improve: IMPROVE_SYSTEM_PROMPT,
+ technical: TECHNICAL_SYSTEM_PROMPT,
+ simplify: SIMPLIFY_SYSTEM_PROMPT,
+ acceptance: ACCEPTANCE_SYSTEM_PROMPT,
+};
+
+/**
+ * Map of enhancement modes to their few-shot examples
+ */
+const EXAMPLES: Record = {
+ improve: IMPROVE_EXAMPLES,
+ technical: TECHNICAL_EXAMPLES,
+ simplify: SIMPLIFY_EXAMPLES,
+ acceptance: ACCEPTANCE_EXAMPLES,
+};
+
+/**
+ * Enhancement prompt configuration returned by getEnhancementPrompt
+ */
+export interface EnhancementPromptConfig {
+ /** System prompt for the enhancement mode */
+ systemPrompt: string;
+ /** Description of what this mode does */
+ description: string;
+}
+
+/**
+ * Descriptions for each enhancement mode
+ */
+const MODE_DESCRIPTIONS: Record = {
+ improve: "Transform vague requests into clear, actionable task descriptions",
+ technical: "Add implementation details and technical specifications",
+ simplify: "Make verbose descriptions concise and focused",
+ acceptance: "Add testable acceptance criteria to task descriptions",
+};
+
+/**
+ * Get the enhancement prompt configuration for a given mode
+ *
+ * @param mode - The enhancement mode (falls back to 'improve' if invalid)
+ * @returns The enhancement prompt configuration
+ */
+export function getEnhancementPrompt(mode: string): EnhancementPromptConfig {
+ const normalizedMode = mode.toLowerCase() as EnhancementMode;
+ const validMode = normalizedMode in SYSTEM_PROMPTS ? normalizedMode : "improve";
+
+ return {
+ systemPrompt: SYSTEM_PROMPTS[validMode],
+ description: MODE_DESCRIPTIONS[validMode],
+ };
+}
+
+/**
+ * Get the system prompt for a specific enhancement mode
+ *
+ * @param mode - The enhancement mode to get the prompt for
+ * @returns The system prompt string
+ */
+export function getSystemPrompt(mode: EnhancementMode): string {
+ return SYSTEM_PROMPTS[mode];
+}
+
+/**
+ * Get the few-shot examples for a specific enhancement mode
+ *
+ * @param mode - The enhancement mode to get examples for
+ * @returns Array of input/output example pairs
+ */
+export function getExamples(mode: EnhancementMode): EnhancementExample[] {
+ return EXAMPLES[mode];
+}
+
+/**
+ * Build a user prompt for enhancement with optional few-shot examples
+ *
+ * @param mode - The enhancement mode
+ * @param text - The text to enhance
+ * @param includeExamples - Whether to include few-shot examples (default: true)
+ * @returns The formatted user prompt string
+ */
+export function buildUserPrompt(
+ mode: EnhancementMode,
+ text: string,
+ includeExamples: boolean = true
+): string {
+ const examples = includeExamples ? getExamples(mode) : [];
+
+ if (examples.length === 0) {
+ return `Please enhance the following task description:\n\n${text}`;
+ }
+
+ // Build few-shot examples section
+ const examplesSection = examples
+ .map(
+ (example, index) =>
+ `Example ${index + 1}:\nInput: ${example.input}\nOutput: ${example.output}`
+ )
+ .join("\n\n---\n\n");
+
+ return `Here are some examples of how to enhance task descriptions:
+
+${examplesSection}
+
+---
+
+Now, please enhance the following task description:
+
+${text}`;
+}
+
+/**
+ * Check if a mode is a valid enhancement mode
+ *
+ * @param mode - The mode to check
+ * @returns True if the mode is valid
+ */
+export function isValidEnhancementMode(mode: string): mode is EnhancementMode {
+ return mode in SYSTEM_PROMPTS;
+}
+
+/**
+ * Get all available enhancement modes
+ *
+ * @returns Array of available enhancement mode names
+ */
+export function getAvailableEnhancementModes(): EnhancementMode[] {
+ return Object.keys(SYSTEM_PROMPTS) as EnhancementMode[];
+}
diff --git a/apps/server/src/routes/app-spec/generate-features-from-spec.ts b/apps/server/src/routes/app-spec/generate-features-from-spec.ts
index c514d1c4..b436b687 100644
--- a/apps/server/src/routes/app-spec/generate-features-from-spec.ts
+++ b/apps/server/src/routes/app-spec/generate-features-from-spec.ts
@@ -56,17 +56,19 @@ ${spec}
Generate a prioritized list of implementable features. For each feature provide:
1. **id**: A unique lowercase-hyphenated identifier
-2. **title**: Short descriptive title
-3. **description**: What this feature does (2-3 sentences)
-4. **priority**: 1 (high), 2 (medium), or 3 (low)
-5. **complexity**: "simple", "moderate", or "complex"
-6. **dependencies**: Array of feature IDs this depends on (can be empty)
+2. **category**: Functional category (e.g., "Core", "UI", "API", "Authentication", "Database")
+3. **title**: Short descriptive title
+4. **description**: What this feature does (2-3 sentences)
+5. **priority**: 1 (high), 2 (medium), or 3 (low)
+6. **complexity**: "simple", "moderate", or "complex"
+7. **dependencies**: Array of feature IDs this depends on (can be empty)
Format as JSON:
{
"features": [
{
"id": "feature-id",
+ "category": "Feature Category",
"title": "Feature Title",
"description": "What it does",
"priority": 1,
diff --git a/apps/server/src/routes/app-spec/parse-and-create-features.ts b/apps/server/src/routes/app-spec/parse-and-create-features.ts
index 14f475b5..b553f8f9 100644
--- a/apps/server/src/routes/app-spec/parse-and-create-features.ts
+++ b/apps/server/src/routes/app-spec/parse-and-create-features.ts
@@ -54,6 +54,7 @@ export async function parseAndCreateFeatures(
const featureData = {
id: feature.id,
+ category: feature.category || "Uncategorized",
title: feature.title,
description: feature.description,
status: "backlog", // Features go to backlog - user must manually start them
diff --git a/apps/server/src/routes/common.ts b/apps/server/src/routes/common.ts
index 8a1fcc68..d1308b30 100644
--- a/apps/server/src/routes/common.ts
+++ b/apps/server/src/routes/common.ts
@@ -3,9 +3,304 @@
*/
import { createLogger } from "../lib/logger.js";
+import fs from "fs/promises";
+import path from "path";
+import { exec } from "child_process";
+import { promisify } from "util";
type Logger = ReturnType;
+const execAsync = promisify(exec);
+const logger = createLogger("Common");
+
+// Max file size for generating synthetic diffs (1MB)
+const MAX_SYNTHETIC_DIFF_SIZE = 1024 * 1024;
+
+// Binary file extensions to skip
+const BINARY_EXTENSIONS = new Set([
+ ".png", ".jpg", ".jpeg", ".gif", ".bmp", ".ico", ".webp", ".svg",
+ ".pdf", ".doc", ".docx", ".xls", ".xlsx", ".ppt", ".pptx",
+ ".zip", ".tar", ".gz", ".rar", ".7z",
+ ".exe", ".dll", ".so", ".dylib",
+ ".mp3", ".mp4", ".wav", ".avi", ".mov", ".mkv",
+ ".ttf", ".otf", ".woff", ".woff2", ".eot",
+ ".db", ".sqlite", ".sqlite3",
+ ".pyc", ".pyo", ".class", ".o", ".obj",
+]);
+
+// Status map for git status codes
+const GIT_STATUS_MAP: Record = {
+ M: "Modified",
+ A: "Added",
+ D: "Deleted",
+ R: "Renamed",
+ C: "Copied",
+ U: "Updated",
+ "?": "Untracked",
+};
+
+/**
+ * File status interface for git status results
+ */
+export interface FileStatus {
+ status: string;
+ path: string;
+ statusText: string;
+}
+
+/**
+ * Check if a file is likely binary based on extension
+ */
+function isBinaryFile(filePath: string): boolean {
+ const ext = path.extname(filePath).toLowerCase();
+ return BINARY_EXTENSIONS.has(ext);
+}
+
+/**
+ * Check if a path is a git repository
+ */
+export async function isGitRepo(repoPath: string): Promise {
+ try {
+ await execAsync("git rev-parse --is-inside-work-tree", { cwd: repoPath });
+ return true;
+ } catch {
+ return false;
+ }
+}
+
+/**
+ * Parse the output of `git status --porcelain` into FileStatus array
+ */
+export function parseGitStatus(statusOutput: string): FileStatus[] {
+ return statusOutput
+ .split("\n")
+ .filter(Boolean)
+ .map((line) => {
+ const statusChar = line[0];
+ const filePath = line.slice(3);
+ return {
+ status: statusChar,
+ path: filePath,
+ statusText: GIT_STATUS_MAP[statusChar] || "Unknown",
+ };
+ });
+}
+
+/**
+ * Generate a synthetic unified diff for an untracked (new) file
+ * This is needed because `git diff HEAD` doesn't include untracked files
+ */
+export async function generateSyntheticDiffForNewFile(
+ basePath: string,
+ relativePath: string
+): Promise {
+ const fullPath = path.join(basePath, relativePath);
+
+ try {
+ // Check if it's a binary file
+ if (isBinaryFile(relativePath)) {
+ return `diff --git a/${relativePath} b/${relativePath}
+new file mode 100644
+index 0000000..0000000
+Binary file ${relativePath} added
+`;
+ }
+
+ // Get file stats to check size
+ const stats = await fs.stat(fullPath);
+ if (stats.size > MAX_SYNTHETIC_DIFF_SIZE) {
+ const sizeKB = Math.round(stats.size / 1024);
+ return `diff --git a/${relativePath} b/${relativePath}
+new file mode 100644
+index 0000000..0000000
+--- /dev/null
++++ b/${relativePath}
+@@ -0,0 +1 @@
++[File too large to display: ${sizeKB}KB]
+`;
+ }
+
+ // Read file content
+ const content = await fs.readFile(fullPath, "utf-8");
+ const hasTrailingNewline = content.endsWith("\n");
+ const lines = content.split("\n");
+
+ // Remove trailing empty line if the file ends with newline
+ if (lines.length > 0 && lines.at(-1) === "") {
+ lines.pop();
+ }
+
+ // Generate diff format
+ const lineCount = lines.length;
+ const addedLines = lines.map(line => `+${line}`).join("\n");
+
+ let diff = `diff --git a/${relativePath} b/${relativePath}
+new file mode 100644
+index 0000000..0000000
+--- /dev/null
++++ b/${relativePath}
+@@ -0,0 +1,${lineCount} @@
+${addedLines}`;
+
+ // Add "No newline at end of file" indicator if needed
+ if (!hasTrailingNewline && content.length > 0) {
+ diff += "\n\\ No newline at end of file";
+ }
+
+ return diff + "\n";
+ } catch (error) {
+ // Log the error for debugging
+ logger.error(`Failed to generate synthetic diff for ${fullPath}:`, error);
+ // Return a placeholder diff
+ return `diff --git a/${relativePath} b/${relativePath}
+new file mode 100644
+index 0000000..0000000
+--- /dev/null
++++ b/${relativePath}
+@@ -0,0 +1 @@
++[Unable to read file content]
+`;
+ }
+}
+
+/**
+ * Generate synthetic diffs for all untracked files and combine with existing diff
+ */
+export async function appendUntrackedFileDiffs(
+ basePath: string,
+ existingDiff: string,
+ files: Array<{ status: string; path: string }>
+): Promise {
+ // Find untracked files (status "?")
+ const untrackedFiles = files.filter(f => f.status === "?");
+
+ if (untrackedFiles.length === 0) {
+ return existingDiff;
+ }
+
+ // Generate synthetic diffs for each untracked file
+ const syntheticDiffs = await Promise.all(
+ untrackedFiles.map(f => generateSyntheticDiffForNewFile(basePath, f.path))
+ );
+
+ // Combine existing diff with synthetic diffs
+ const combinedDiff = existingDiff + syntheticDiffs.join("");
+
+ return combinedDiff;
+}
+
+/**
+ * List all files in a directory recursively (for non-git repositories)
+ * Excludes hidden files/folders and common build artifacts
+ */
+export async function listAllFilesInDirectory(
+ basePath: string,
+ relativePath: string = ""
+): Promise {
+ const files: string[] = [];
+ const fullPath = path.join(basePath, relativePath);
+
+ // Directories to skip
+ const skipDirs = new Set([
+ "node_modules", ".git", ".automaker", "dist", "build",
+ ".next", ".nuxt", "__pycache__", ".cache", "coverage"
+ ]);
+
+ try {
+ const entries = await fs.readdir(fullPath, { withFileTypes: true });
+
+ for (const entry of entries) {
+ // Skip hidden files/folders (except we want to allow some)
+ if (entry.name.startsWith(".") && entry.name !== ".env") {
+ continue;
+ }
+
+ const entryRelPath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+
+ if (entry.isDirectory()) {
+ if (!skipDirs.has(entry.name)) {
+ const subFiles = await listAllFilesInDirectory(basePath, entryRelPath);
+ files.push(...subFiles);
+ }
+ } else if (entry.isFile()) {
+ files.push(entryRelPath);
+ }
+ }
+ } catch (error) {
+ // Log the error to help diagnose file system issues
+ logger.error(`Error reading directory ${fullPath}:`, error);
+ }
+
+ return files;
+}
+
+/**
+ * Generate diffs for all files in a non-git directory
+ * Treats all files as "new" files
+ */
+export async function generateDiffsForNonGitDirectory(
+ basePath: string
+): Promise<{ diff: string; files: FileStatus[] }> {
+ const allFiles = await listAllFilesInDirectory(basePath);
+
+ const files: FileStatus[] = allFiles.map(filePath => ({
+ status: "?",
+ path: filePath,
+ statusText: "New",
+ }));
+
+ // Generate synthetic diffs for all files
+ const syntheticDiffs = await Promise.all(
+ files.map(f => generateSyntheticDiffForNewFile(basePath, f.path))
+ );
+
+ return {
+ diff: syntheticDiffs.join(""),
+ files,
+ };
+}
+
+/**
+ * Get git repository diffs for a given path
+ * Handles both git repos and non-git directories
+ */
+export async function getGitRepositoryDiffs(
+ repoPath: string
+): Promise<{ diff: string; files: FileStatus[]; hasChanges: boolean }> {
+ // Check if it's a git repository
+ const isRepo = await isGitRepo(repoPath);
+
+ if (!isRepo) {
+ // Not a git repo - list all files and treat them as new
+ const result = await generateDiffsForNonGitDirectory(repoPath);
+ return {
+ diff: result.diff,
+ files: result.files,
+ hasChanges: result.files.length > 0,
+ };
+ }
+
+ // Get git diff and status
+ const { stdout: diff } = await execAsync("git diff HEAD", {
+ cwd: repoPath,
+ maxBuffer: 10 * 1024 * 1024,
+ });
+ const { stdout: status } = await execAsync("git status --porcelain", {
+ cwd: repoPath,
+ });
+
+ const files = parseGitStatus(status);
+
+ // Generate synthetic diffs for untracked (new) files
+ const combinedDiff = await appendUntrackedFileDiffs(repoPath, diff, files);
+
+ return {
+ diff: combinedDiff,
+ files,
+ hasChanges: files.length > 0,
+ };
+}
+
/**
* Get error message from error object
*/
diff --git a/apps/server/src/routes/enhance-prompt/index.ts b/apps/server/src/routes/enhance-prompt/index.ts
new file mode 100644
index 00000000..bd414a5d
--- /dev/null
+++ b/apps/server/src/routes/enhance-prompt/index.ts
@@ -0,0 +1,22 @@
+/**
+ * Enhance prompt routes - HTTP API for AI-powered text enhancement
+ *
+ * Provides endpoints for enhancing user input text using Claude AI
+ * with different enhancement modes (improve, expand, simplify, etc.)
+ */
+
+import { Router } from "express";
+import { createEnhanceHandler } from "./routes/enhance.js";
+
+/**
+ * Create the enhance-prompt router
+ *
+ * @returns Express router with enhance-prompt endpoints
+ */
+export function createEnhancePromptRoutes(): Router {
+ const router = Router();
+
+ router.post("/", createEnhanceHandler());
+
+ return router;
+}
diff --git a/apps/server/src/routes/enhance-prompt/routes/enhance.ts b/apps/server/src/routes/enhance-prompt/routes/enhance.ts
new file mode 100644
index 00000000..75587a94
--- /dev/null
+++ b/apps/server/src/routes/enhance-prompt/routes/enhance.ts
@@ -0,0 +1,195 @@
+/**
+ * POST /enhance-prompt endpoint - Enhance user input text
+ *
+ * Uses Claude AI to enhance text based on the specified enhancement mode.
+ * Supports modes: improve, technical, simplify, acceptance
+ */
+
+import type { Request, Response } from "express";
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import { createLogger } from "../../../lib/logger.js";
+import {
+ getSystemPrompt,
+ buildUserPrompt,
+ isValidEnhancementMode,
+ type EnhancementMode,
+} from "../../../lib/enhancement-prompts.js";
+import { resolveModelString, CLAUDE_MODEL_MAP } from "../../../lib/model-resolver.js";
+
+const logger = createLogger("EnhancePrompt");
+
+/**
+ * Request body for the enhance endpoint
+ */
+interface EnhanceRequestBody {
+ /** The original text to enhance */
+ originalText: string;
+ /** The enhancement mode to apply */
+ enhancementMode: string;
+ /** Optional model override */
+ model?: string;
+}
+
+/**
+ * Success response from the enhance endpoint
+ */
+interface EnhanceSuccessResponse {
+ success: true;
+ enhancedText: string;
+}
+
+/**
+ * Error response from the enhance endpoint
+ */
+interface EnhanceErrorResponse {
+ success: false;
+ error: string;
+}
+
+/**
+ * Extract text content from Claude SDK response messages
+ *
+ * @param stream - The async iterable from the query function
+ * @returns The extracted text content
+ */
+async function extractTextFromStream(
+ stream: AsyncIterable<{
+ type: string;
+ subtype?: string;
+ result?: string;
+ message?: {
+ content?: Array<{ type: string; text?: string }>;
+ };
+ }>
+): Promise {
+ let responseText = "";
+
+ for await (const msg of stream) {
+ if (msg.type === "assistant" && msg.message?.content) {
+ for (const block of msg.message.content) {
+ if (block.type === "text" && block.text) {
+ responseText += block.text;
+ }
+ }
+ } else if (msg.type === "result" && msg.subtype === "success") {
+ responseText = msg.result || responseText;
+ }
+ }
+
+ return responseText;
+}
+
+/**
+ * Create the enhance request handler
+ *
+ * @returns Express request handler for text enhancement
+ */
+export function createEnhanceHandler(): (
+ req: Request,
+ res: Response
+) => Promise {
+ return async (req: Request, res: Response): Promise => {
+ try {
+ const { originalText, enhancementMode, model } =
+ req.body as EnhanceRequestBody;
+
+ // Validate required fields
+ if (!originalText || typeof originalText !== "string") {
+ const response: EnhanceErrorResponse = {
+ success: false,
+ error: "originalText is required and must be a string",
+ };
+ res.status(400).json(response);
+ return;
+ }
+
+ if (!enhancementMode || typeof enhancementMode !== "string") {
+ const response: EnhanceErrorResponse = {
+ success: false,
+ error: "enhancementMode is required and must be a string",
+ };
+ res.status(400).json(response);
+ return;
+ }
+
+ // Validate text is not empty
+ const trimmedText = originalText.trim();
+ if (trimmedText.length === 0) {
+ const response: EnhanceErrorResponse = {
+ success: false,
+ error: "originalText cannot be empty",
+ };
+ res.status(400).json(response);
+ return;
+ }
+
+ // Validate and normalize enhancement mode
+ const normalizedMode = enhancementMode.toLowerCase();
+ const validMode: EnhancementMode = isValidEnhancementMode(normalizedMode)
+ ? normalizedMode
+ : "improve";
+
+ logger.info(
+ `Enhancing text with mode: ${validMode}, length: ${trimmedText.length} chars`
+ );
+
+ // Get the system prompt for this mode
+ const systemPrompt = getSystemPrompt(validMode);
+
+ // Build the user prompt with few-shot examples
+ // This helps the model understand this is text transformation, not a coding task
+ const userPrompt = buildUserPrompt(validMode, trimmedText, true);
+
+ // Resolve the model - use the passed model, default to sonnet for quality
+ const resolvedModel = resolveModelString(model, CLAUDE_MODEL_MAP.sonnet);
+
+ logger.debug(`Using model: ${resolvedModel}`);
+
+ // Call Claude SDK with minimal configuration for text transformation
+ // Key: no tools, just text completion
+ const stream = query({
+ prompt: userPrompt,
+ options: {
+ model: resolvedModel,
+ systemPrompt,
+ maxTurns: 1,
+ allowedTools: [],
+ permissionMode: "acceptEdits",
+ },
+ });
+
+ // Extract the enhanced text from the response
+ const enhancedText = await extractTextFromStream(stream);
+
+ if (!enhancedText || enhancedText.trim().length === 0) {
+ logger.warn("Received empty response from Claude");
+ const response: EnhanceErrorResponse = {
+ success: false,
+ error: "Failed to generate enhanced text - empty response",
+ };
+ res.status(500).json(response);
+ return;
+ }
+
+ logger.info(
+ `Enhancement complete, output length: ${enhancedText.length} chars`
+ );
+
+ const response: EnhanceSuccessResponse = {
+ success: true,
+ enhancedText: enhancedText.trim(),
+ };
+ res.json(response);
+ } catch (error) {
+ const errorMessage =
+ error instanceof Error ? error.message : "Unknown error occurred";
+ logger.error("Enhancement failed:", errorMessage);
+
+ const response: EnhanceErrorResponse = {
+ success: false,
+ error: errorMessage,
+ };
+ res.status(500).json(response);
+ }
+ };
+}
diff --git a/apps/server/src/routes/git/routes/diffs.ts b/apps/server/src/routes/git/routes/diffs.ts
index dd0e809f..eb532a03 100644
--- a/apps/server/src/routes/git/routes/diffs.ts
+++ b/apps/server/src/routes/git/routes/diffs.ts
@@ -3,11 +3,8 @@
*/
import type { Request, Response } from "express";
-import { exec } from "child_process";
-import { promisify } from "util";
import { getErrorMessage, logError } from "../common.js";
-
-const execAsync = promisify(exec);
+import { getGitRepositoryDiffs } from "../../common.js";
export function createDiffsHandler() {
return async (req: Request, res: Response): Promise => {
@@ -20,43 +17,15 @@ export function createDiffsHandler() {
}
try {
- const { stdout: diff } = await execAsync("git diff HEAD", {
- cwd: projectPath,
- maxBuffer: 10 * 1024 * 1024,
- });
- const { stdout: status } = await execAsync("git status --porcelain", {
- cwd: projectPath,
- });
-
- const files = status
- .split("\n")
- .filter(Boolean)
- .map((line) => {
- const statusChar = line[0];
- const filePath = line.slice(3);
- const statusMap: Record = {
- M: "Modified",
- A: "Added",
- D: "Deleted",
- R: "Renamed",
- C: "Copied",
- U: "Updated",
- "?": "Untracked",
- };
- return {
- status: statusChar,
- path: filePath,
- statusText: statusMap[statusChar] || "Unknown",
- };
- });
-
+ const result = await getGitRepositoryDiffs(projectPath);
res.json({
success: true,
- diff,
- files,
- hasChanges: files.length > 0,
+ diff: result.diff,
+ files: result.files,
+ hasChanges: result.hasChanges,
});
- } catch {
+ } catch (innerError) {
+ logError(innerError, "Git diff failed");
res.json({ success: true, diff: "", files: [], hasChanges: false });
}
} catch (error) {
diff --git a/apps/server/src/routes/git/routes/file-diff.ts b/apps/server/src/routes/git/routes/file-diff.ts
index 7f480a6f..fdf66998 100644
--- a/apps/server/src/routes/git/routes/file-diff.ts
+++ b/apps/server/src/routes/git/routes/file-diff.ts
@@ -6,6 +6,7 @@ import type { Request, Response } from "express";
import { exec } from "child_process";
import { promisify } from "util";
import { getErrorMessage, logError } from "../common.js";
+import { generateSyntheticDiffForNewFile } from "../../common.js";
const execAsync = promisify(exec);
@@ -25,16 +26,33 @@ export function createFileDiffHandler() {
}
try {
- const { stdout: diff } = await execAsync(
- `git diff HEAD -- "${filePath}"`,
- {
- cwd: projectPath,
- maxBuffer: 10 * 1024 * 1024,
- }
+ // First check if the file is untracked
+ const { stdout: status } = await execAsync(
+ `git status --porcelain -- "${filePath}"`,
+ { cwd: projectPath }
);
+ const isUntracked = status.trim().startsWith("??");
+
+ let diff: string;
+ if (isUntracked) {
+ // Generate synthetic diff for untracked file
+ diff = await generateSyntheticDiffForNewFile(projectPath, filePath);
+ } else {
+ // Use regular git diff for tracked files
+ const result = await execAsync(
+ `git diff HEAD -- "${filePath}"`,
+ {
+ cwd: projectPath,
+ maxBuffer: 10 * 1024 * 1024,
+ }
+ );
+ diff = result.stdout;
+ }
+
res.json({ success: true, diff, filePath });
- } catch {
+ } catch (innerError) {
+ logError(innerError, "Git file diff failed");
res.json({ success: true, diff: "", filePath });
}
} catch (error) {
diff --git a/apps/server/src/routes/setup/get-claude-status.ts b/apps/server/src/routes/setup/get-claude-status.ts
index b767e0ef..2ae072ff 100644
--- a/apps/server/src/routes/setup/get-claude-status.ts
+++ b/apps/server/src/routes/setup/get-claude-status.ts
@@ -17,12 +17,15 @@ export async function getClaudeStatus() {
let cliPath = "";
let method = "none";
- // Try to find Claude CLI
+ const isWindows = process.platform === "win32";
+
+ // Try to find Claude CLI using platform-specific command
try {
- const { stdout } = await execAsync(
- "which claude || where claude 2>/dev/null"
- );
- cliPath = stdout.trim();
+ // Use 'where' on Windows, 'which' on Unix-like systems
+ const findCommand = isWindows ? "where claude" : "which claude";
+ const { stdout } = await execAsync(findCommand);
+ // 'where' on Windows can return multiple paths - take the first one
+ cliPath = stdout.trim().split(/\r?\n/)[0];
installed = true;
method = "path";
@@ -34,13 +37,26 @@ export async function getClaudeStatus() {
// Version command might not be available
}
} catch {
- // Not in PATH, try common locations
- const commonPaths = [
- path.join(os.homedir(), ".local", "bin", "claude"),
- path.join(os.homedir(), ".claude", "local", "claude"),
- "/usr/local/bin/claude",
- path.join(os.homedir(), ".npm-global", "bin", "claude"),
- ];
+ // Not in PATH, try common locations based on platform
+ const commonPaths = isWindows
+ ? (() => {
+ const appData = process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
+ return [
+ // Windows-specific paths
+ path.join(os.homedir(), ".local", "bin", "claude.exe"),
+ path.join(appData, "npm", "claude.cmd"),
+ path.join(appData, "npm", "claude"),
+ path.join(appData, ".npm-global", "bin", "claude.cmd"),
+ path.join(appData, ".npm-global", "bin", "claude"),
+ ];
+ })()
+ : [
+ // Unix (Linux/macOS) paths
+ path.join(os.homedir(), ".local", "bin", "claude"),
+ path.join(os.homedir(), ".claude", "local", "claude"),
+ "/usr/local/bin/claude",
+ path.join(os.homedir(), ".npm-global", "bin", "claude"),
+ ];
for (const p of commonPaths) {
try {
@@ -124,26 +140,34 @@ export async function getClaudeStatus() {
// Settings file doesn't exist
}
- // Check for credentials file (OAuth tokens from claude login) - legacy/alternative auth
- const credentialsPath = path.join(claudeDir, "credentials.json");
- try {
- const credentialsContent = await fs.readFile(credentialsPath, "utf-8");
- const credentials = JSON.parse(credentialsContent);
- auth.hasCredentialsFile = true;
+ // Check for credentials file (OAuth tokens from claude login)
+ // Note: Claude CLI may use ".credentials.json" (hidden) or "credentials.json" depending on version/platform
+ const credentialsPaths = [
+ path.join(claudeDir, ".credentials.json"),
+ path.join(claudeDir, "credentials.json"),
+ ];
- // Check what type of token is in credentials
- if (credentials.oauth_token || credentials.access_token) {
- auth.hasStoredOAuthToken = true;
- auth.oauthTokenValid = true;
- auth.authenticated = true;
- auth.method = "oauth_token"; // Stored OAuth token from credentials file
- } else if (credentials.api_key) {
- auth.apiKeyValid = true;
- auth.authenticated = true;
- auth.method = "api_key"; // Stored API key in credentials file
+ for (const credentialsPath of credentialsPaths) {
+ try {
+ const credentialsContent = await fs.readFile(credentialsPath, "utf-8");
+ const credentials = JSON.parse(credentialsContent);
+ auth.hasCredentialsFile = true;
+
+ // Check what type of token is in credentials
+ if (credentials.oauth_token || credentials.access_token) {
+ auth.hasStoredOAuthToken = true;
+ auth.oauthTokenValid = true;
+ auth.authenticated = true;
+ auth.method = "oauth_token"; // Stored OAuth token from credentials file
+ } else if (credentials.api_key) {
+ auth.apiKeyValid = true;
+ auth.authenticated = true;
+ auth.method = "api_key"; // Stored API key in credentials file
+ }
+ break; // Found and processed credentials file
+ } catch {
+ // No credentials file at this path or invalid format
}
- } catch {
- // No credentials file or invalid format
}
// Environment variables override stored credentials (higher priority)
diff --git a/apps/server/src/routes/worktree/routes/diffs.ts b/apps/server/src/routes/worktree/routes/diffs.ts
index ba0cbdde..d3b6ed09 100644
--- a/apps/server/src/routes/worktree/routes/diffs.ts
+++ b/apps/server/src/routes/worktree/routes/diffs.ts
@@ -3,13 +3,10 @@
*/
import type { Request, Response } from "express";
-import { exec } from "child_process";
-import { promisify } from "util";
import path from "path";
import fs from "fs/promises";
import { getErrorMessage, logError } from "../common.js";
-
-const execAsync = promisify(exec);
+import { getGitRepositoryDiffs } from "../../common.js";
export function createDiffsHandler() {
return async (req: Request, res: Response): Promise => {
@@ -33,45 +30,33 @@ export function createDiffsHandler() {
const worktreePath = path.join(projectPath, ".worktrees", featureId);
try {
+ // Check if worktree exists
await fs.access(worktreePath);
- const { stdout: diff } = await execAsync("git diff HEAD", {
- cwd: worktreePath,
- maxBuffer: 10 * 1024 * 1024,
- });
- const { stdout: status } = await execAsync("git status --porcelain", {
- cwd: worktreePath,
- });
-
- const files = status
- .split("\n")
- .filter(Boolean)
- .map((line) => {
- const statusChar = line[0];
- const filePath = line.slice(3);
- const statusMap: Record = {
- M: "Modified",
- A: "Added",
- D: "Deleted",
- R: "Renamed",
- C: "Copied",
- U: "Updated",
- "?": "Untracked",
- };
- return {
- status: statusChar,
- path: filePath,
- statusText: statusMap[statusChar] || "Unknown",
- };
- });
+ // Get diffs from worktree
+ const result = await getGitRepositoryDiffs(worktreePath);
res.json({
success: true,
- diff,
- files,
- hasChanges: files.length > 0,
+ diff: result.diff,
+ files: result.files,
+ hasChanges: result.hasChanges,
});
- } catch {
- res.json({ success: true, diff: "", files: [], hasChanges: false });
+ } catch (innerError) {
+ // Worktree doesn't exist - fallback to main project path
+ logError(innerError, "Worktree access failed, falling back to main project");
+
+ try {
+ const result = await getGitRepositoryDiffs(projectPath);
+ res.json({
+ success: true,
+ diff: result.diff,
+ files: result.files,
+ hasChanges: result.hasChanges,
+ });
+ } catch (fallbackError) {
+ logError(fallbackError, "Fallback to main project also failed");
+ res.json({ success: true, diff: "", files: [], hasChanges: false });
+ }
}
} catch (error) {
logError(error, "Get worktree diffs failed");
diff --git a/apps/server/src/routes/worktree/routes/file-diff.ts b/apps/server/src/routes/worktree/routes/file-diff.ts
index c8dea633..70306b6a 100644
--- a/apps/server/src/routes/worktree/routes/file-diff.ts
+++ b/apps/server/src/routes/worktree/routes/file-diff.ts
@@ -8,6 +8,7 @@ import { promisify } from "util";
import path from "path";
import fs from "fs/promises";
import { getErrorMessage, logError } from "../common.js";
+import { generateSyntheticDiffForNewFile } from "../../common.js";
const execAsync = promisify(exec);
@@ -33,16 +34,34 @@ export function createFileDiffHandler() {
try {
await fs.access(worktreePath);
- const { stdout: diff } = await execAsync(
- `git diff HEAD -- "${filePath}"`,
- {
- cwd: worktreePath,
- maxBuffer: 10 * 1024 * 1024,
- }
+
+ // First check if the file is untracked
+ const { stdout: status } = await execAsync(
+ `git status --porcelain -- "${filePath}"`,
+ { cwd: worktreePath }
);
+ const isUntracked = status.trim().startsWith("??");
+
+ let diff: string;
+ if (isUntracked) {
+ // Generate synthetic diff for untracked file
+ diff = await generateSyntheticDiffForNewFile(worktreePath, filePath);
+ } else {
+ // Use regular git diff for tracked files
+ const result = await execAsync(
+ `git diff HEAD -- "${filePath}"`,
+ {
+ cwd: worktreePath,
+ maxBuffer: 10 * 1024 * 1024,
+ }
+ );
+ diff = result.stdout;
+ }
+
res.json({ success: true, diff, filePath });
- } catch {
+ } catch (innerError) {
+ logError(innerError, "Worktree file diff failed");
res.json({ success: true, diff: "", filePath });
}
} catch (error) {
diff --git a/apps/server/tests/unit/lib/enhancement-prompts.test.ts b/apps/server/tests/unit/lib/enhancement-prompts.test.ts
new file mode 100644
index 00000000..d780612d
--- /dev/null
+++ b/apps/server/tests/unit/lib/enhancement-prompts.test.ts
@@ -0,0 +1,233 @@
+import { describe, it, expect } from "vitest";
+import {
+ getEnhancementPrompt,
+ getSystemPrompt,
+ getExamples,
+ buildUserPrompt,
+ isValidEnhancementMode,
+ getAvailableEnhancementModes,
+ IMPROVE_SYSTEM_PROMPT,
+ TECHNICAL_SYSTEM_PROMPT,
+ SIMPLIFY_SYSTEM_PROMPT,
+ ACCEPTANCE_SYSTEM_PROMPT,
+ IMPROVE_EXAMPLES,
+ TECHNICAL_EXAMPLES,
+ SIMPLIFY_EXAMPLES,
+ ACCEPTANCE_EXAMPLES,
+ type EnhancementMode,
+} from "@/lib/enhancement-prompts.js";
+
+describe("enhancement-prompts.ts", () => {
+ describe("System Prompt Constants", () => {
+ it("should have non-empty improve system prompt", () => {
+ expect(IMPROVE_SYSTEM_PROMPT).toBeDefined();
+ expect(IMPROVE_SYSTEM_PROMPT.length).toBeGreaterThan(100);
+ expect(IMPROVE_SYSTEM_PROMPT).toContain("ANALYZE");
+ expect(IMPROVE_SYSTEM_PROMPT).toContain("CLARIFY");
+ });
+
+ it("should have non-empty technical system prompt", () => {
+ expect(TECHNICAL_SYSTEM_PROMPT).toBeDefined();
+ expect(TECHNICAL_SYSTEM_PROMPT.length).toBeGreaterThan(100);
+ expect(TECHNICAL_SYSTEM_PROMPT).toContain("technical");
+ });
+
+ it("should have non-empty simplify system prompt", () => {
+ expect(SIMPLIFY_SYSTEM_PROMPT).toBeDefined();
+ expect(SIMPLIFY_SYSTEM_PROMPT.length).toBeGreaterThan(100);
+ expect(SIMPLIFY_SYSTEM_PROMPT).toContain("simplify");
+ });
+
+ it("should have non-empty acceptance system prompt", () => {
+ expect(ACCEPTANCE_SYSTEM_PROMPT).toBeDefined();
+ expect(ACCEPTANCE_SYSTEM_PROMPT.length).toBeGreaterThan(100);
+ expect(ACCEPTANCE_SYSTEM_PROMPT).toContain("acceptance criteria");
+ });
+ });
+
+ describe("Example Constants", () => {
+ it("should have improve examples with input and output", () => {
+ expect(IMPROVE_EXAMPLES).toBeDefined();
+ expect(IMPROVE_EXAMPLES.length).toBeGreaterThan(0);
+ IMPROVE_EXAMPLES.forEach((example) => {
+ expect(example.input).toBeDefined();
+ expect(example.output).toBeDefined();
+ expect(example.input.length).toBeGreaterThan(0);
+ expect(example.output.length).toBeGreaterThan(0);
+ });
+ });
+
+ it("should have technical examples with input and output", () => {
+ expect(TECHNICAL_EXAMPLES).toBeDefined();
+ expect(TECHNICAL_EXAMPLES.length).toBeGreaterThan(0);
+ TECHNICAL_EXAMPLES.forEach((example) => {
+ expect(example.input).toBeDefined();
+ expect(example.output).toBeDefined();
+ });
+ });
+
+ it("should have simplify examples with input and output", () => {
+ expect(SIMPLIFY_EXAMPLES).toBeDefined();
+ expect(SIMPLIFY_EXAMPLES.length).toBeGreaterThan(0);
+ SIMPLIFY_EXAMPLES.forEach((example) => {
+ expect(example.input).toBeDefined();
+ expect(example.output).toBeDefined();
+ });
+ });
+
+ it("should have acceptance examples with input and output", () => {
+ expect(ACCEPTANCE_EXAMPLES).toBeDefined();
+ expect(ACCEPTANCE_EXAMPLES.length).toBeGreaterThan(0);
+ ACCEPTANCE_EXAMPLES.forEach((example) => {
+ expect(example.input).toBeDefined();
+ expect(example.output).toBeDefined();
+ });
+ });
+ });
+
+ describe("getEnhancementPrompt", () => {
+ it("should return config for improve mode", () => {
+ const config = getEnhancementPrompt("improve");
+ expect(config.systemPrompt).toBe(IMPROVE_SYSTEM_PROMPT);
+ expect(config.description).toContain("clear");
+ });
+
+ it("should return config for technical mode", () => {
+ const config = getEnhancementPrompt("technical");
+ expect(config.systemPrompt).toBe(TECHNICAL_SYSTEM_PROMPT);
+ expect(config.description).toContain("technical");
+ });
+
+ it("should return config for simplify mode", () => {
+ const config = getEnhancementPrompt("simplify");
+ expect(config.systemPrompt).toBe(SIMPLIFY_SYSTEM_PROMPT);
+ expect(config.description).toContain("concise");
+ });
+
+ it("should return config for acceptance mode", () => {
+ const config = getEnhancementPrompt("acceptance");
+ expect(config.systemPrompt).toBe(ACCEPTANCE_SYSTEM_PROMPT);
+ expect(config.description).toContain("acceptance");
+ });
+
+ it("should handle case-insensitive mode", () => {
+ const config = getEnhancementPrompt("IMPROVE");
+ expect(config.systemPrompt).toBe(IMPROVE_SYSTEM_PROMPT);
+ });
+
+ it("should fall back to improve for invalid mode", () => {
+ const config = getEnhancementPrompt("invalid-mode");
+ expect(config.systemPrompt).toBe(IMPROVE_SYSTEM_PROMPT);
+ });
+
+ it("should fall back to improve for empty string", () => {
+ const config = getEnhancementPrompt("");
+ expect(config.systemPrompt).toBe(IMPROVE_SYSTEM_PROMPT);
+ });
+ });
+
+ describe("getSystemPrompt", () => {
+ it("should return correct system prompt for each mode", () => {
+ expect(getSystemPrompt("improve")).toBe(IMPROVE_SYSTEM_PROMPT);
+ expect(getSystemPrompt("technical")).toBe(TECHNICAL_SYSTEM_PROMPT);
+ expect(getSystemPrompt("simplify")).toBe(SIMPLIFY_SYSTEM_PROMPT);
+ expect(getSystemPrompt("acceptance")).toBe(ACCEPTANCE_SYSTEM_PROMPT);
+ });
+ });
+
+ describe("getExamples", () => {
+ it("should return correct examples for each mode", () => {
+ expect(getExamples("improve")).toBe(IMPROVE_EXAMPLES);
+ expect(getExamples("technical")).toBe(TECHNICAL_EXAMPLES);
+ expect(getExamples("simplify")).toBe(SIMPLIFY_EXAMPLES);
+ expect(getExamples("acceptance")).toBe(ACCEPTANCE_EXAMPLES);
+ });
+
+ it("should return arrays with example objects", () => {
+ const modes: EnhancementMode[] = ["improve", "technical", "simplify", "acceptance"];
+ modes.forEach((mode) => {
+ const examples = getExamples(mode);
+ expect(Array.isArray(examples)).toBe(true);
+ expect(examples.length).toBeGreaterThan(0);
+ });
+ });
+ });
+
+ describe("buildUserPrompt", () => {
+ const testText = "Add a logout button";
+
+ it("should build prompt with examples by default", () => {
+ const prompt = buildUserPrompt("improve", testText);
+ expect(prompt).toContain("Example 1:");
+ expect(prompt).toContain(testText);
+ expect(prompt).toContain("Now, please enhance the following task description:");
+ });
+
+ it("should build prompt without examples when includeExamples is false", () => {
+ const prompt = buildUserPrompt("improve", testText, false);
+ expect(prompt).not.toContain("Example 1:");
+ expect(prompt).toContain(testText);
+ expect(prompt).toContain("Please enhance the following task description:");
+ });
+
+ it("should include all examples for improve mode", () => {
+ const prompt = buildUserPrompt("improve", testText);
+ IMPROVE_EXAMPLES.forEach((example, index) => {
+ expect(prompt).toContain(`Example ${index + 1}:`);
+ expect(prompt).toContain(example.input);
+ });
+ });
+
+ it("should include separator between examples", () => {
+ const prompt = buildUserPrompt("improve", testText);
+ expect(prompt).toContain("---");
+ });
+
+ it("should work with all enhancement modes", () => {
+ const modes: EnhancementMode[] = ["improve", "technical", "simplify", "acceptance"];
+ modes.forEach((mode) => {
+ const prompt = buildUserPrompt(mode, testText);
+ expect(prompt).toContain(testText);
+ expect(prompt.length).toBeGreaterThan(100);
+ });
+ });
+
+ it("should preserve the original text exactly", () => {
+ const specialText = "Add feature with special chars: <>&\"'";
+ const prompt = buildUserPrompt("improve", specialText);
+ expect(prompt).toContain(specialText);
+ });
+ });
+
+ describe("isValidEnhancementMode", () => {
+ it("should return true for valid modes", () => {
+ expect(isValidEnhancementMode("improve")).toBe(true);
+ expect(isValidEnhancementMode("technical")).toBe(true);
+ expect(isValidEnhancementMode("simplify")).toBe(true);
+ expect(isValidEnhancementMode("acceptance")).toBe(true);
+ });
+
+ it("should return false for invalid modes", () => {
+ expect(isValidEnhancementMode("invalid")).toBe(false);
+ expect(isValidEnhancementMode("IMPROVE")).toBe(false); // case-sensitive
+ expect(isValidEnhancementMode("")).toBe(false);
+ expect(isValidEnhancementMode("random")).toBe(false);
+ });
+ });
+
+ describe("getAvailableEnhancementModes", () => {
+ it("should return all four enhancement modes", () => {
+ const modes = getAvailableEnhancementModes();
+ expect(modes).toHaveLength(4);
+ expect(modes).toContain("improve");
+ expect(modes).toContain("technical");
+ expect(modes).toContain("simplify");
+ expect(modes).toContain("acceptance");
+ });
+
+ it("should return an array", () => {
+ const modes = getAvailableEnhancementModes();
+ expect(Array.isArray(modes)).toBe(true);
+ });
+ });
+});
diff --git a/backup.json b/backup.json
deleted file mode 100644
index dd5b993c..00000000
--- a/backup.json
+++ /dev/null
@@ -1,269 +0,0 @@
-[
- {
- "id": "feature-1765387670653-bl83444lj",
- "category": "Kanban",
- "description": "In the output logs of the proc agent output in the file diffs Can you add a scroll bar so it actually scroll to see all these new styles right now it seems like I can't scroll",
- "steps": [],
- "status": "verified",
- "startedAt": "2025-12-10T17:42:09.158Z",
- "imagePaths": [],
- "skipTests": true,
- "summary": "Fixed scrolling for file diffs in agent output modal. Changed approach: parent container (agent-output-modal.tsx) now handles scrolling with overflow-y-auto, while GitDiffPanel uses natural height without flex-based scrolling. Modified: agent-output-modal.tsx (line 304), git-diff-panel.tsx (lines 461, 500, 525, 614).",
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765387746902-na752mp1y",
- "category": "Kanban",
- "description": "When the add feature modal pops up, make sure that the description is always the main focus. When it first loads up. Do not focus the prompt tab, which is currently doing this.",
- "steps": [],
- "status": "verified",
- "startedAt": "2025-12-10T17:29:13.854Z",
- "imagePaths": [],
- "skipTests": true,
- "summary": "Added autoFocus prop to DescriptionImageDropZone component. Modified: description-image-dropzone.tsx (added autoFocus prop support), board-view.tsx (enabled autoFocus on add feature modal). Now the description textarea receives focus when the modal opens instead of the prompt tab.",
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765388139100-ln31jgp5n",
- "category": "Uncategorized",
- "description": "Can you add a disclaimer .md file to this project saying that this uses a bunch of AI related tooling which could have access to your operating system and change and delete files and so use at your own risk. We tried to check it for security of vulnerability to make sure it's good. But you assume the risk and you should be reviewing the code yourself before you try to run it. And also sandboxing this so it doesn't have access to your whole operating system like using Docker to sandbox before you run it or use a virtual machine to sandbox it. and that we do not recommend running locally on your computer due to the risk of it having access to everything on your computer.\n\nUpdate or read me with a short paragraph overview/description at the top followed by a disclaimer section in red that points to the disclaimer file with the same disclaimer information.\n\nThen a section that lists out all the features of cool emojis.",
- "steps": [],
- "status": "verified",
- "startedAt": "2025-12-10T17:35:40.700Z",
- "imagePaths": [],
- "skipTests": true,
- "summary": "Created DISCLAIMER.md with comprehensive security warnings about AI tooling risks and sandboxing recommendations. Updated README.md with project overview, red caution disclaimer section linking to DISCLAIMER.md, and features list with emojis covering all major functionality (Kanban, AI agents, multi-model support, etc.).",
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765388388144-oa1dewze9",
- "category": "Uncategorized",
- "description": "Please fix the styling of the hotkeys to be more using the theme colors. Notice that they're kind of gray. I would rather than have some type of like light green if they're not active and then the brighter green if they are active and also the add feature but in the top right it's not very legible. So fix the accessibility of the hotkey but also keep it within the theme. You might just have to change the text inside of it to be bright green.",
- "steps": [],
- "status": "verified",
- "startedAt": "2025-12-10T17:40:02.745Z",
- "imagePaths": [
- {
- "id": "img-1765388352835-dgx4ishp0",
- "path": "/Users/webdevcody/Library/Application Support/automaker/images/1765388352832-6jnbgw8kg_Screenshot_2025-12-10_at_12.39.10_PM.png",
- "filename": "Screenshot 2025-12-10 at 12.39.10 PM.png",
- "mimeType": "image/png"
- },
- {
- "id": "img-1765388356955-a0gdovp5b",
- "path": "/Users/webdevcody/Library/Application Support/automaker/images/1765388356954-d59a65nf9_Screenshot_2025-12-10_at_12.39.15_PM.png",
- "filename": "Screenshot 2025-12-10 at 12.39.15 PM.png",
- "mimeType": "image/png"
- }
- ],
- "skipTests": true,
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765388402095-x66aduwg3",
- "category": "Uncategorized",
- "description": "Can you please add some spacing and fix the styling of the hotkey with the command enter and make it so they're both vertically aligned for those icons?",
- "steps": [],
- "status": "waiting_approval",
- "startedAt": "2025-12-10T17:44:08.667Z",
- "imagePaths": [
- {
- "id": "img-1765388390408-eefybe95t",
- "path": "/Users/webdevcody/Library/Application Support/automaker/images/1765388390408-nn320yoyc_Screenshot_2025-12-10_at_12.39.47_PM.png",
- "filename": "Screenshot 2025-12-10 at 12.39.47 PM.png",
- "mimeType": "image/png"
- }
- ],
- "skipTests": true,
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765388662444-as3hqn7be",
- "category": "Uncategorized",
- "description": "Fix the styling on all the buttons when I hover over them with my mouse they never change to a click mouse cursor. In order they seem to show any type of like hover state changes, if they do, at least for the certain game I'm using, it's not very obvious that you're hovering over the button.",
- "steps": [],
- "status": "waiting_approval",
- "startedAt": "2025-12-10T17:45:59.666Z",
- "imagePaths": [],
- "skipTests": true,
- "summary": "Fixed hover cursor styling on all interactive elements. Modified: button.tsx (added cursor-pointer to base styles), dropdown-menu.tsx (added cursor-pointer to all menu items), checkbox.tsx (added cursor-pointer), tabs.tsx (added cursor-pointer to triggers), dialog.tsx (added cursor-pointer to close button), slider.tsx (added cursor-grab to thumb, cursor-pointer to track), globals.css (added global CSS rules for clickable elements to ensure consistent cursor behavior).",
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765388693856-yx1dk1acj",
- "category": "Kanban",
- "description": "The tabs in the add new feature modal for the prompt model and testing tabs. They don't seem to look like tabs when I'm on a certain theme. Can you verify that those are hooked into the theme? And make sure that the active one is colored differently than the unactive ones. Keep the primary colors when doing this.",
- "steps": [],
- "status": "waiting_approval",
- "startedAt": "2025-12-10T17:46:00.019Z",
- "imagePaths": [],
- "skipTests": true,
- "summary": "Fixed tabs component theme integration. Modified: tabs.tsx. Changes: (1) Added visible border to TabsList container using theme's border color, (2) Changed inactive tab text to foreground/70 for better contrast, (3) Enhanced active tab with shadow-md and semi-transparent primary border, (4) Improved hover state with full accent background. Active tabs now properly use bg-primary/text-primary-foreground which adapts to each theme.",
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765388754462-bek0flvkj",
- "category": "Uncategorized",
- "description": "There's a strange issue when I when when these agents are like doing things it seems like it completely refreshes the whole Kanban board and there's like a black flash. Can you verify that the data loading does not cause the entire component to refresh? Maybe there's an issue with the react effect or how the component is rendered maybe we need some used memos or something but it shouldn't refresh the whole page it should just like update the individual cards when they change.",
- "steps": [],
- "status": "waiting_approval",
- "startedAt": "2025-12-10T17:47:20.170Z",
- "imagePaths": [],
- "skipTests": true,
- "summary": "Fixed Kanban board flash/refresh issue. Changes: (1) board-view.tsx - Added isInitialLoadRef to only show loading spinner on initial load, not on feature reloads; memoized column features with useMemo to prevent recalculation on every render. (2) kanban-card.tsx - Wrapped with React.memo to prevent unnecessary re-renders. (3) kanban-column.tsx - Wrapped with React.memo for performance. The flash was caused by loadFeatures setting isLoading=true on every reload, which caused the entire board to unmount and show a loading spinner.",
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765388793845-yhluf0sry",
- "category": "Uncategorized",
- "description": "Add in the ability so that every project can have its own selected theme. This will allow me to have different projects have different themes so I can easily differentiate when I have one project selected or not.",
- "steps": [],
- "status": "waiting_approval",
- "startedAt": "2025-12-10T18:00:33.814Z",
- "imagePaths": [],
- "skipTests": true,
- "summary": "Fixed per-project theme support. Modified: settings-view.tsx (now saves theme to project when project is selected, shows label indicating scope), page.tsx (computes effectiveTheme from currentProject?.theme || theme), app-store.ts (added setProjectTheme action, theme property on Project interface). When a project is selected, changing theme in Settings saves to that project only.",
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765389333728-y74hmz2yp",
- "category": "Agent Runner",
- "description": "On the Agent Runner, I took a screenshot and dropped it into the text area and after a certain amount of time, it's like the image preview just completely went away. Can you debug and fix this on the Agent Runner?",
- "steps": [],
- "status": "backlog",
- "imagePaths": [],
- "skipTests": true,
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765389352488-j9bez5ztx",
- "category": "Kanban",
- "description": "It seems like the category typehead is no longer working. Can you double check that code didn't break? It should have kept track of categories inside of the categories.json file inside the .automaker folder when adding new features modal",
- "steps": [],
- "status": "backlog",
- "imagePaths": [],
- "skipTests": true,
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765389420151-jzdsjzn9u",
- "category": "Kanban",
- "description": "Add in the ability to just click and drag a card from the waiting approval directly into the verify column as I can usually just commit it manually if I want to.",
- "steps": [],
- "status": "waiting_approval",
- "startedAt": "2025-12-10T18:05:08.252Z",
- "imagePaths": [],
- "skipTests": true,
- "summary": "Fixed drag-and-drop from waiting_approval to verified column. The issue was condition ordering in handleDragEnd - the skipTests check was intercepting waiting_approval features before they could be handled. Moved waiting_approval status check before skipTests check in board-view.tsx:731-752. Also updated agent memory with this lesson.",
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765389468077-9x3vt1yjq",
- "category": "Uncategorized",
- "description": "The commit functionality on the waiting approval cards doesn't seem to work. It just committed everything in my working copy for git. I think I should be a little bit more intelligent and figure out what files it changed for that AI session and then only try to git add those individual files and commit those. Right now it just basically did a git add all and committed those. Re-factor the prompting or figure out a way to make it so it's more specific on what it's going to commit with the future change.",
- "steps": [],
- "status": "backlog",
- "imagePaths": [],
- "skipTests": true,
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765389502705-6deep7mvi",
- "category": "Uncategorized",
- "description": "I'm noticing that a lot of buttons in the UI, especially the ones that are submitting, are either missing the submit hotkey or they're not styled properly. Look at the add feature submit button that's on the add feature modal and abstract away a submit button so that on every single page that needs to submit something I can reuse this type of hotkey functionality. In fact, every single button should be abstracted enough where I can provide a hotkey and it will automatically listen if I press that hotkey when it's in view.",
- "steps": [],
- "status": "backlog",
- "imagePaths": [],
- "skipTests": true,
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765389772166-an3yk3kpo",
- "category": "Uncategorized",
- "description": "Can you add some more padding to the bottom of the settings panel? Notice that I can't scroll down all the way. And that doesn't highlight the left sub navigation to highlight it pink when I'm on that section. I should be able to scroll a bit further and just have like blank space at the bottom. So I can eventually get to that actual section.",
- "steps": [],
- "status": "backlog",
- "imagePaths": [
- {
- "id": "img-1765389750685-jhq6rcidc",
- "path": "/Users/webdevcody/Library/Application Support/automaker/images/1765389750683-mqb0j7a3z_Screenshot_2025-12-10_at_1.02.26_PM.png",
- "filename": "Screenshot 2025-12-10 at 1.02.26 PM.png",
- "mimeType": "image/png"
- }
- ],
- "skipTests": true,
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765389829239-bbk596u6z",
- "category": "Uncategorized",
- "description": "Add some type of XML highlighting to the spec editor view. Right now it's just all grayscale and it's kind of ugly to look at. And try to make the syntax highlighting match the current selected theme.",
- "steps": [],
- "status": "backlog",
- "imagePaths": [],
- "skipTests": true,
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765389859334-si9ivtehw",
- "category": "Uncategorized",
- "description": "Add a search bar to the top of the Kanban column that allows me to search the filter down just to show the cards I'm interested in by keyword.",
- "steps": [],
- "status": "in_progress",
- "startedAt": "2025-12-10T18:09:26.193Z",
- "imagePaths": [],
- "skipTests": true,
- "summary": "Added search bar to Kanban board. Modified: board-view.tsx. Features: 1) Search input with icon at top of columns, 2) Case-insensitive filtering by description or category, 3) Clear button to reset search, 4) Real-time filtering as you type.",
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765390022638-nalulsdxv",
- "category": "Uncategorized",
- "description": "In the project select can you actually remove the whole like 1 2 3 4 5 hotkeys instead? Just make it be a type ahead so when I open the panel I just should be able to type in the first letter or two of the project that I want and press enter and that should Just select it for me",
- "steps": [],
- "status": "backlog",
- "imagePaths": [],
- "skipTests": true,
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765390055621-ewc4w7k5h",
- "category": "Uncategorized",
- "description": "In the add new feature prompt, instead of disabling the add feature button until we type into the description, keep it enabled. But if you click it, make sure you just show the client side validation and turn the description box in any other required field as red so that the user knows they have to fill it in.",
- "steps": [],
- "status": "backlog",
- "imagePaths": [],
- "skipTests": true,
- "model": "opus",
- "thinkingLevel": "none"
- },
- {
- "id": "feature-1765390131625-ymqxr5gln",
- "category": "Uncategorized",
- "description": "Can you please in the top right of the Kanban board use the show three icons for the Kanban card display formatting. You can look at the settings page to see that there's three different settings that we use for displaying the Kanban card information. But I also just want this to be really quickly accessible at the top right of the Kanban that they can switch between those three toggles. Keep them simple only just icons you don't need to put words in them. Make sure they do have harbor states though, or tooltips I mean.",
- "steps": [],
- "status": "backlog",
- "imagePaths": [],
- "skipTests": true,
- "model": "opus",
- "thinkingLevel": "none"
- }
-]
\ No newline at end of file
diff --git a/docs/checkout-branch-pr.md b/docs/checkout-branch-pr.md
new file mode 100644
index 00000000..ff86d324
--- /dev/null
+++ b/docs/checkout-branch-pr.md
@@ -0,0 +1,237 @@
+# Git Workflow: Branch, Commit, Push, and Pull Request
+
+This document outlines the standard workflow for creating a branch, committing changes, pushing to remote, and creating a pull request.
+
+## Prerequisites
+
+- Git installed and configured
+- GitHub CLI (`gh`) installed (optional, but recommended for PR creation)
+- Access to the repository
+- Authentication configured (SSH keys or GitHub CLI authentication)
+
+## Step-by-Step Workflow
+
+### 1. Check Current Status
+
+First, check what changes exist in your working directory:
+
+```bash
+git status
+```
+
+This shows:
+
+- Modified files
+- Deleted files
+- Untracked files
+- Current branch
+
+### 2. Create a New Branch
+
+Create and switch to a new branch for your changes:
+
+```bash
+git checkout -b
+```
+
+**Branch naming conventions:**
+
+- `feature/` - for new features
+- `fix/` or `bugfix/` - for bug fixes
+- `refactor/` - for code refactoring
+- `docs/` - for documentation changes
+- `chore/` - for maintenance tasks
+
+**Example:**
+
+```bash
+git checkout -b refactor/monorepo-restructure
+```
+
+### 3. Stage Changes
+
+Stage all changes (including deletions and new files):
+
+```bash
+git add -A
+```
+
+Or stage specific files:
+
+```bash
+git add
+```
+
+### 4. Commit Changes
+
+Create a commit with a descriptive message:
+
+```bash
+git commit -m "type: descriptive commit message"
+```
+
+**Commit message conventions:**
+
+- Use conventional commits format: `type: description`
+- Types: `feat`, `fix`, `refactor`, `docs`, `chore`, `test`, `style`
+- Keep messages concise but descriptive
+
+**Example:**
+
+```bash
+git commit -m "refactor: restructure project to monorepo with apps directory"
+```
+
+### 5. Push Branch to Remote
+
+Push your branch to the remote repository:
+
+```bash
+git push -u origin
+```
+
+The `-u` flag sets up tracking so future pushes can use `git push` without specifying the branch.
+
+**Example:**
+
+```bash
+git push -u origin refactor/monorepo-restructure
+```
+
+### 6. Create Pull Request
+
+#### Option A: Using GitHub CLI (Recommended)
+
+If you have GitHub CLI installed:
+
+```bash
+gh pr create --title "Your PR Title" --body "Description of changes"
+```
+
+To open in browser for review before creating:
+
+```bash
+gh pr create --title "Your PR Title" --body "Description" --web
+```
+
+#### Option B: Using GitHub Web Interface
+
+After pushing, GitHub will provide a URL in the terminal output:
+
+```
+remote: Create a pull request for '' on GitHub by visiting:
+remote: https://github.com///pull/new/
+```
+
+Visit that URL to create the PR through the web interface.
+
+#### Option C: Manual PR Creation
+
+1. Go to your repository on GitHub
+2. Click "Pull requests" tab
+3. Click "New pull request"
+4. Select your branch as the source
+5. Select the target branch (usually `main` or `master`)
+6. Fill in title and description
+7. Click "Create pull request"
+
+## Complete Example Workflow
+
+```bash
+# 1. Check status
+git status
+
+# 2. Create branch
+git checkout -b feature/add-new-component
+
+# 3. Make your changes (edit files, etc.)
+
+# 4. Stage changes
+git add -A
+
+# 5. Commit
+git commit -m "feat: add new user dashboard component"
+
+# 6. Push
+git push -u origin feature/add-new-component
+
+# 7. Create PR
+gh pr create --title "feat: add new user dashboard component" --body "Implements new dashboard component with user statistics and activity feed."
+```
+
+## Handling Additional Changes
+
+If you need to make more changes after pushing:
+
+```bash
+# Make your changes
+git add -A
+git commit -m "fix: address review feedback"
+git push
+```
+
+The PR will automatically update with the new commits.
+
+## Troubleshooting
+
+### Branch already exists
+
+```bash
+git checkout
+```
+
+### Need to update from main before creating PR
+
+```bash
+git checkout main
+git pull origin main
+git checkout
+git merge main
+# Resolve conflicts if any
+git push
+```
+
+### PR creation fails
+
+- Ensure branch is pushed: `git push -u origin `
+- Check GitHub CLI authentication: `gh auth status`
+- Verify repository access permissions
+- Try creating PR via web interface instead
+
+## Best Practices
+
+1. **Keep branches focused**: One branch = one feature/fix
+2. **Write clear commit messages**: Help reviewers understand changes
+3. **Keep PRs small**: Easier to review and merge
+4. **Update before creating PR**: Merge latest `main` into your branch
+5. **Add tests**: Include tests for new features
+6. **Update documentation**: Keep docs in sync with code changes
+7. **Request reviews**: Tag relevant team members for review
+
+## Quick Reference Commands
+
+```bash
+# Status check
+git status
+
+# Create branch
+git checkout -b
+
+# Stage all changes
+git add -A
+
+# Commit
+git commit -m "type: message"
+
+# Push
+git push -u origin
+
+# Create PR (GitHub CLI)
+gh pr create --title "Title" --body "Description"
+
+# View PR
+gh pr view
+
+# List PRs
+gh pr list
+```
diff --git a/logs/server.log b/logs/server.log
deleted file mode 100644
index 5994fe28..00000000
--- a/logs/server.log
+++ /dev/null
@@ -1,42 +0,0 @@
-
-> automaker@1.0.0 dev:server
-> npm run dev --workspace=apps/server
-
-
-> @automaker/server@0.1.0 dev
-> tsx watch src/index.ts
-
-[dotenv@17.2.3] injecting env (1) from .env -- tip: ⚙️ override existing env vars with { override: true }
-[Server] ✓ CLAUDE_CODE_OAUTH_TOKEN detected (subscription auth)
-
-╔═══════════════════════════════════════════════════════╗
-║ Automaker Backend Server ║
-╠═══════════════════════════════════════════════════════╣
-║ HTTP API: http://localhost:3008 ║
-║ WebSocket: ws://localhost:3008/api/events ║
-║ Terminal: ws://localhost:3008/api/terminal/ws ║
-║ Health: http://localhost:3008/api/health ║
-║ Terminal: enabled ║
-╚═══════════════════════════════════════════════════════╝
-
-[Server] Agent service initialized
-[WebSocket] Client connected
-12:52:41 AM [tsx] change in ./src\index.ts Rerunning...
-c12:52:41 AM [tsx] unlink in ./src\services\auto-mode-service.ts Restarting...
-c[dotenv@17.2.3] injecting env (1) from .env -- tip: 🔐 encrypt with Dotenvx: https://dotenvx.com
-[Server] ✓ CLAUDE_CODE_OAUTH_TOKEN detected (subscription auth)
-
-╔═══════════════════════════════════════════════════════╗
-║ Automaker Backend Server ║
-╠═══════════════════════════════════════════════════════╣
-║ HTTP API: http://localhost:3008 ║
-║ WebSocket: ws://localhost:3008/api/events ║
-║ Terminal: ws://localhost:3008/api/terminal/ws ║
-║ Health: http://localhost:3008/api/health ║
-║ Terminal: enabled ║
-╚═══════════════════════════════════════════════════════╝
-
-[Server] Agent service initialized
-[WebSocket] Client connected
-[WebSocket] Client disconnected
-^C^C
\ No newline at end of file
diff --git a/test-results/.last-run.json b/test-results/.last-run.json
deleted file mode 100644
index 5fca3f84..00000000
--- a/test-results/.last-run.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
- "status": "failed",
- "failedTests": []
-}
\ No newline at end of file