store_session

[CodeArchitect] Save important conversations for future reference.

=== WHEN TO USE ===

• User says: "use codearchitect store_session", "save this conversation", "store this", "remember this"

• User wants to keep/remember an important discussion

• After solving complex problems or making architecture decisions

=== STORAGE BEHAVIOR ===

1. ALWAYS saves to main folder: ~/.codearchitect/sessions/ (user's home directory)

2. OPTIONALLY saves to project folder if user specifies projectDir parameter

3. NEVER auto-detects project - only use projectDir if user explicitly provides it

=== CONVERSATION SOURCE (CHOOSE ONE) ===

OPTION 1: Export File (RECOMMENDED - Most Reliable)

• User exports conversation from Cursor/VS Code to .codearchitect/exports/ folder

• Tool automatically detects and processes the export file

• No need to manually extract conversation

WORKFLOW:

1. User exports chat: In Cursor/VS Code → three dots (⋯) → "Export Chat"

2. User saves to: ~/.codearchitect/exports/ folder (main location - always the same)

3. User says: "use codearchitect store_session"

4. Tool automatically finds newest export file and stores it

If multiple exports exist:

• Tool processes newest file (modified in last 10 minutes)

• If user wants specific file: use exportFilename parameter (e.g., "resolve_mcp")

OPTION 2: Direct Conversation Parameter (Fallback)

• Only use if export file method doesn't work

• Extract FULL conversation from your context window

• Format as plain text with USER/ASSISTANT markers OR JSON array

=== PARAMETERS ===

• conversation (optional): Direct conversation text/JSON - only use if export file unavailable

• exportFilename (optional): Pattern to match specific export file (e.g., "resolve_mcp" matches "cursor_resolve_mcp_configuration_issues.md")

• topic (optional): Session topic - auto-extracted if not provided

• projectDir (optional): Project directory path - if provided, saves to both main and project folders

• format (optional): "plain" or "messages" - default "plain"

=== WORKFLOW (EXPORT METHOD) === Step 1: User exports conversation to ~/.codearchitect/exports/ folder (main location) Step 2: User says "use codearchitect store_session" Step 3: Tool detects export file automatically from main exports folder Step 4: Tool parses and stores conversation Step 5: Tool saves to main sessions folder (always) + optionally project folder if projectDir specified

=== ERROR HANDLING === If no export file found:

• Return clear instructions with OS/IDE-specific export folder path

• Tell user exactly where to save the export file

• Provide step-by-step instructions

=== RESPONSE === After saving, return concise message:

• "Detected export file '[filename]', saved to main: [topic-name]. Next: use codearchitect get_session [topic-name]"

• Or if projectDir provided: "Detected export file '[filename]', saved to main: [topic-name] and project: [topic-name]. Next: use codearchitect get_session [topic-name]"