🏗️ Architecture: How should we restructure session management from workspace-...

Date: 2026-02-05
Time: 21:23:27 UTC
Session: editor2-92.16
Agent: backend
Confidence: 92%
Status: ✅ Documented

📋 Decision Context

Question:

How should we restructure session management from workspace-folder-based to flat, globally-unique?

Task: Session management v12.0 restructuring

🎯 Decision Made

Chosen:

v12.0: Global monotonic counter (S1, S2... S94) via MongoDB atomic $inc, fully flat file structure (sessions/manifests/S{N}.json), lean sessions with rich sub-sessions carrying WHO/WHERE/WHAT/WHEN attribution, no inline decisions in manifests

Options Considered:

• No alternatives documented

💭 Reasoning

Workspace folders (sessions-history/editor2/, gspace/) were a maintenance nightmare preventing cross-workspace session management. Sub-sessions are the real unit of work, not sessions. By making sessions lean containers and sub-sessions rich with developer/agent/workspace/platform attribution, we eliminate folder structure as an organizational mechanism while preserving all metadata. MongoDB atomic $inc prevents ID collisions. Decisions stay in MongoDB only (current session-92.json was 765 lines due to inline decisions; v12 manifests are ~80 lines).

📁 Files Involved

• apis/backend-ai-api/src/app/schemas/ai-infrastructure.schema.ts
• apis/backend-ai-api/src/app/infrastructure/services/session.service.ts
• apis/backend-ai-api/src/app/infrastructure/infrastructure.controller.ts
• MCP/mcp-gograb-ai/src/config/constants.ts
• MCP/mcp-gograb-ai/src/storage/docs-data-integration.ts
• MCP/mcp-gograb-ai/src/session/session-detector.ts
• MCP/mcp-gograb-ai/src/services/auto-documentation.ts
• MCP/mcp-gograb-ai/src/tools/gateways/session-gateway.ts
• MCP/mcp-gograb-ai/src/tools/session-validator.ts
• MCP/mcp-gograb-ai/src/types/index.ts
• MCP/mcp-gograb-ai/src/types/session-v10.types.ts
• tools/scripts/database/migrate-sessions-v12.js
• apps/vscode-gograb-ai/src/panels/webview/components/sessions/sessions-view.ts
• apps/vscode-gograb-ai/src/panels/webview/types.ts

🔗 Related

• Decision ID: dev_1770326607482_s1y8e7v
• Session: 92
• Workspace: editor2

Auto-generated by MCP Smart Consolidation