NLP implemengted to create certian features

Author: ather-techie

CLAUDE.md

@@ -121,7 +121,9 @@ All providers talk directly to their APIs over native `fetch` (no vendor SDKs).
 | `azure` | `gpt-4o` | `api-key` header — set `AI_BASE_URL` to the full deployment endpoint incl. `?api-version=…` |
 | `ollama` | `llama3` | `Authorization: Bearer ollama`; default base `http://localhost:11434` |
 
-`lib/sseLines.ts` is the shared SSE line reader used by every streaming provider. Currently only `POST /api/ai/cards/:id/summarize` consumes the provider.
+`lib/sseLines.ts` is the shared SSE line reader used by every streaming provider. Two AI endpoints are currently implemented:
+- `POST /api/ai/cards/:id/summarize` — generates a 2–3 sentence summary of a story card
+- `POST /api/ai/parse-item` — parses natural-language work item requests and returns a discriminated union with type + payload (used for universal NL input across the board, epics, sprints, calendar, and project creation)
 
 ## Real-time (SSE)
 

client/CLAUDE.md

@@ -65,6 +65,7 @@ Scoped guidance for Claude Code when editing under `client/`. For repo-wide cont
 - `CardModal` — full story editor; **5 tabs**: Description (with inline Tasks checklist), Comments, Activity, Tests, Dependencies (blocks / blocked-by). Right sidebar holds Sprint, Feature, Assignee, Priority, Story Points selectors
 - `ProtectedRoute` — auth gate; redirects to `/login` when no session
 - `FeatureGate` — `<FeatureGate flag="ai">{children}</FeatureGate>`; renders only when the flag resolves true
+- `NLItemInput` — universal natural-language work item creation (gated by `FEATURE_AI`). Props: `allowedTypes` (array of types the parser can return), `context` (projectId/epicId/laneId), `lanes` (for story lane picker), `cards` (for task parent picker), `onCreated` (refresh callback). State machine: idle → input → loading → preview → confirming. Editable fields appear based on inferred type (priority/assignee for epics/features/stories, dates for sprints/calendar, parent selectors as needed). Wrapped in `<FeatureGate flag="ai">` at every mount site: BoardPage, EpicsPage, SprintsPage, CalendarPage, DashboardPage
 - `ProjectAccessModal` — per-user table of all projects with role dropdowns; saves inline on change
 - `CreateUserModal` (inline in AdminPage) — chains `POST /users` then `POST /projects/:id/access` per assigned project
 - `SettingsTab` (inline in AdminPage) — feature flag toggles; toggle is disabled when the env var is `false` (env is the ceiling)
@@ -84,10 +85,15 @@ Scoped guidance for Claude Code when editing under `client/`. For repo-wide cont
 Two files exist; the codebase is mid-migration:
 
 - [src/api.ts](src/api.ts) — fetch-based, flat function exports. Most existing pages import from `'../api'` which resolves to this file (TS prefers the `.ts` over the `api/` directory).
-- [src/api/index.ts](src/api/index.ts) — newer axios namespace (`api.projects.list()`, `api.cards.create()`, …). More complete coverage of new endpoints (roadmap, reports, projectAccess).
+- [src/api/index.ts](src/api/index.ts) — newer axios namespace (`api.projects.list()`, `api.cards.create()`, …). More complete coverage of new endpoints (roadmap, reports, projectAccess, ai).
 
 **When adding new endpoints:** add to the axios namespace in `api/index.ts`. Don't extend `api.ts` further. If you touch a page that's still on fetch, leave the migration for a separate change unless trivial — do NOT mix axios and fetch in the same component.
 
+**AI methods and types exported from `api/index.ts`:**
+- `api.ai.parseItem(data)` — `(input: string, context?: { projectId?, epicId?, laneId?, allowedTypes? }) => Promise<ParsedIntent>` — parses natural-language input into a work item
+- `type ParsedIntent = { type, payload } | { type: "unknown", reason }` — discriminated union returned by the `/api/ai/parse-item` endpoint; `type` is one of `"epic"`, `"feature"`, `"story"`, `"task"`, `"project"`, `"sprint"`, `"calendar"`, or `"unknown"`; each type carries different fields in `payload` (e.g., epic/feature/story have priority + assignee, sprint has dates + goal, task has assignee only)
+- `type NLAllowedType = "epic" | "feature" | "story" | "task" | "project" | "sprint" | "calendar"` — work item types the parser can infer
+
 Vite proxies `/api` → `localhost:3000` in dev (see `vite.config.ts`). Both clients send credentials so the `sf_token` cookie is included.
 
 ## Hooks ([src/hooks/](src/hooks/))

client/src/api/index.ts

@@ -17,13 +17,27 @@ import type {
   RetroCategory,
   RetroItem,
   Retrospective,
+  Sprint,
   Task,
   TestCase,
   TestCaseSummary,
   TestRun,
   TestSuite,
 } from '../types'
 
+type Priority = 'low' | 'medium' | 'high' | 'critical'
+
+export type ParsedIntent =
+  | { type: 'epic' | 'feature'; payload: { title: string; description: string; priority: Priority; assignee: string | null } }
+  | { type: 'story'; payload: { title: string; description: string; priority: Priority; assignee: string | null; estimate: number | null } }
+  | { type: 'task'; payload: { title: string; description: string; assignee: string | null } }
+  | { type: 'project'; payload: { name: string; description: string } }
+  | { type: 'sprint'; payload: { name: string; goal: string; start_date: string; end_date: string } }
+  | { type: 'calendar'; payload: { title: string; description: string; start_date: string; end_date: string } }
+  | { type: 'unknown'; reason: string }
+
+export type NLAllowedType = 'epic' | 'feature' | 'story' | 'task' | 'project' | 'sprint' | 'calendar'
+
 export const http = axios.create({ baseURL: '/api', withCredentials: true })
 
 http.interceptors.response.use(
@@ -50,7 +64,16 @@ function unwrap<T>(p: Promise<{ data: { data: T } }>): Promise<T> {
   return p.then(r => r.data.data)
 }
 
+// Backward-compatible helper for lane card creation
+function createLaneCard(
+  laneId: number,
+  data: { title: string; priority?: Card['priority']; assignee?: string | null; sprint_id?: number | null },
+): Promise<Card> {
+  return http.post(`/lanes/${laneId}/cards`, data).then(r => r.data.data)
+}
+
 export const api = {
+  createLaneCard,
   projects: {
     list: () => unwrap<Project[]>(http.get('/projects')),
     get: (id: number) => unwrap<Project>(http.get(`/projects/${id}`)),
@@ -80,7 +103,7 @@ export const api = {
     get: (cardId: number) => unwrap<Card>(http.get(`/cards/${cardId}`)),
     create: (
       laneId: number,
-      data: { title: string; priority?: Card['priority']; assignee?: string | null; feature_id?: number | null },
+      data: { title: string; priority?: Card['priority']; assignee?: string | null; feature_id?: number | null; sprint_id?: number | null },
     ) => unwrap<Card>(http.post(`/lanes/${laneId}/cards`, data)),
     update: (
       cardId: number,
@@ -120,6 +143,15 @@ export const api = {
     delete: (id: number) => unwrap<{ id: number }>(http.delete(`/features/${id}`)),
     listStories: (featureId: number) => unwrap<Card[]>(http.get(`/features/${featureId}/stories`)),
   },
+  sprints: {
+    list: (projectId: number) => unwrap<Sprint[]>(http.get(`/projects/${projectId}/sprints`)),
+    get: (id: number) => unwrap<Sprint>(http.get(`/sprints/${id}`)),
+    create: (projectId: number, data: { name: string; goal?: string; start_date: string; end_date: string; status?: Sprint['status'] }) =>
+      unwrap<Sprint>(http.post(`/projects/${projectId}/sprints`, data)),
+    update: (id: number, data: Partial<Pick<Sprint, 'name' | 'goal' | 'start_date' | 'end_date' | 'status'>>) =>
+      unwrap<Sprint>(http.patch(`/sprints/${id}`, data)),
+    delete: (id: number) => unwrap<{ id: number }>(http.delete(`/sprints/${id}`)),
+  },
   comments: {
     list: (cardId: number) => unwrap<Comment[]>(http.get(`/cards/${cardId}/comments`)),
     create: (cardId: number, data: { author: string; body: string }) =>
@@ -200,4 +232,8 @@ export const api = {
       delete: (id: number) => unwrap<{ id: number }>(http.delete(`/admin/holidays/${id}`)),
     },
   },
+  ai: {
+    parseItem: (data: { input: string; context?: { projectId?: number; epicId?: number; laneId?: number; allowedTypes?: NLAllowedType[] } }) =>
+      unwrap<ParsedIntent>(http.post('/ai/parse-item', data)),
+  },
 }