@leanspec/ui 0.2.25 → 0.2.27

package/dist/lib/types/api.d.ts

@@ -1,11 +1,11 @@
-import { LightweightSpec as UiLightweightSpec, SpecRelationships as UiSpecRelationships, SpecPriority as UiSpecPriority, SpecStatus as UiSpecStatus, SpecWithMetadata as UiSpecWithMetadata, SubSpec as UiSubSpec } from './specs';
-export type SpecStatus = UiSpecStatus;
-export type SpecPriority = UiSpecPriority;
+import { LightweightSpec as UiLightweightSpec, SpecRelationships as UiSpecRelationships, SpecWithMetadata as UiSpecWithMetadata, SubSpec as UiSubSpec } from './specs';
+import { SessionMode as GeneratedSessionMode, SessionStatus as GeneratedSessionStatus, SpecPriority as GeneratedSpecPriority, SpecStatus as GeneratedSpecStatus } from './generated';
+export type SpecStatus = GeneratedSpecStatus;
+export type SpecPriority = GeneratedSpecPriority;
 export type TokenStatus = 'optimal' | 'good' | 'warning' | 'critical';
 export type ValidationStatus = 'pass' | 'warn' | 'fail';
-export type SessionStatus = 'pending' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
-/** @deprecated 'ralph' is deprecated and kept only for backward-compatibility with existing sessions */
-export type SessionMode = 'guided' | 'autonomous' | 'ralph';
+export type SessionStatus = GeneratedSessionStatus;
+export type SessionMode = GeneratedSessionMode;
 export type SessionProtocol = 'acp' | 'subprocess';
 export type SubSpec = UiSubSpec & {
     file?: string;
@@ -62,6 +62,8 @@ export interface RunnerDefinition {
     command?: string | null;
     args: string[];
     env: Record<string, string>;
+    model?: string | null;
+    modelProviders?: string[] | null;
     /**
      * True if command is available, false if not, undefined if validation pending.
      * When skipValidation=true on list request, this will be undefined.
@@ -81,6 +83,9 @@ export interface RunnerValidateResponse {
 export interface RunnerVersionResponse {
     version?: string | null;
 }
+export interface RunnerModelsResponse {
+    models: string[];
+}
 export type RunnerScope = 'project' | 'global';
 export interface SessionLog {
     id: number;
@@ -403,3 +408,14 @@ export interface FileSearchResponse {
     query: string;
     results: FileSearchEntry[];
 }
+export interface SpecSearchFilters {
+    status?: string;
+    priority?: string;
+    tags?: string[];
+}
+export interface SpecSearchResponse {
+    results: Spec[];
+    total: number;
+    query: string;
+    projectId?: string;
+}

package/dist/lib/types/generated/BatchMetadataRequest.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Batch metadata request
+ */
+export type BatchMetadataRequest = {
+    specNames: Array<string>;
+};

package/dist/lib/types/generated/BatchMetadataResponse.d.ts

@@ -0,0 +1,9 @@
+import { SpecMetadata } from './SpecMetadata';
+/**
+ * Batch metadata response - tokens and validation for multiple specs
+ */
+export type BatchMetadataResponse = {
+    specs: {
+        [key in string]?: SpecMetadata;
+    };
+};

package/dist/lib/types/generated/ChecklistToggleItem.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A single checklist toggle item
+ */
+export type ChecklistToggleItem = {
+    itemText: string;
+    checked: boolean;
+};

package/dist/lib/types/generated/ChecklistToggleRequest.d.ts

@@ -0,0 +1,12 @@
+import { ChecklistToggleItem } from './ChecklistToggleItem';
+/**
+ * Request to toggle checklist items in a spec
+ */
+export type ChecklistToggleRequest = {
+    toggles: Array<ChecklistToggleItem>;
+    expectedContentHash: string | null;
+    /**
+     * Optional sub-spec filename (e.g., "IMPLEMENTATION.md")
+     */
+    subspec: string | null;
+};

package/dist/lib/types/generated/ChecklistToggleResponse.d.ts

@@ -0,0 +1,9 @@
+import { ChecklistToggledResult } from './ChecklistToggledResult';
+/**
+ * Response from checklist toggle
+ */
+export type ChecklistToggleResponse = {
+    success: boolean;
+    contentHash: string;
+    toggled: Array<ChecklistToggledResult>;
+};

package/dist/lib/types/generated/ChecklistToggledResult.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Result of a single checklist toggle
+ */
+export type ChecklistToggledResult = {
+    itemText: string;
+    checked: boolean;
+    line: number;
+};

package/dist/lib/types/generated/ConfigFeatures.d.ts

@@ -0,0 +1,3 @@
+export type ConfigFeatures = {
+    aiAgents: boolean | null;
+};

package/dist/lib/types/generated/ConfigStructure.d.ts

@@ -0,0 +1,7 @@
+export type ConfigStructure = {
+    pattern: string | null;
+    prefix: string | null;
+    dateFormat: string | null;
+    sequenceDigits: number | null;
+    defaultFile: string | null;
+};

package/dist/lib/types/generated/ContextFile.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Context file representation
+ */
+export type ContextFile = {
+    name: string;
+    path: string;
+    content: string;
+    tokenCount: number;
+    lastModified: string;
+};

package/dist/lib/types/generated/CreateSpecRequest.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Create spec request
+ */
+export type CreateSpecRequest = {
+    name: string;
+    title: string | null;
+    status: string | null;
+    priority: string | null;
+    tags: Array<string> | null;
+    assignee: string | null;
+    dependsOn: Array<string> | null;
+    template: string | null;
+    content: string | null;
+};

package/dist/lib/types/generated/DependencyEdge.d.ts

@@ -0,0 +1,5 @@
+export type DependencyEdge = {
+    source: string;
+    target: string;
+    type: string | null;
+};

package/dist/lib/types/generated/DependencyGraphResponse.d.ts

@@ -0,0 +1,10 @@
+import { DependencyEdge } from './DependencyEdge';
+import { DependencyNode } from './DependencyNode';
+/**
+ * Project-level dependency graph
+ */
+export type DependencyGraphResponse = {
+    projectId: string | null;
+    nodes: Array<DependencyNode>;
+    edges: Array<DependencyEdge>;
+};

package/dist/lib/types/generated/DependencyNode.d.ts

@@ -0,0 +1,8 @@
+export type DependencyNode = {
+    id: string;
+    name: string;
+    number: number;
+    status: string;
+    priority: string;
+    tags: Array<string>;
+};

package/dist/lib/types/generated/DependencyResponse.d.ts

@@ -0,0 +1,9 @@
+import { SpecSummary } from './SpecSummary';
+/**
+ * Dependency graph response
+ */
+export type DependencyResponse = {
+    spec: SpecSummary;
+    dependsOn: Array<SpecSummary>;
+    requiredBy: Array<SpecSummary>;
+};

package/dist/lib/types/generated/DetailedBreakdown.d.ts

@@ -0,0 +1,22 @@
+import { SectionTokenCount } from './SectionTokenCount';
+/**
+ * Detailed content breakdown
+ */
+export type DetailedBreakdown = {
+    /**
+     * Tokens in code blocks
+     */
+    codeBlocks: number;
+    /**
+     * Tokens in checklists (- [ ] items)
+     */
+    checklists: number;
+    /**
+     * Tokens in plain prose/text
+     */
+    prose: number;
+    /**
+     * Tokens per h2 section
+     */
+    sections: Array<SectionTokenCount>;
+};

package/dist/lib/types/generated/DetectionConfig.d.ts

@@ -0,0 +1,6 @@
+export type DetectionConfig = {
+    commands: Array<string>;
+    config_dirs: Array<string>;
+    env_vars: Array<string>;
+    extensions: Array<string>;
+};

package/dist/lib/types/generated/DetectionResult.d.ts

@@ -0,0 +1,6 @@
+import { RunnerDefinition } from './RunnerDefinition';
+export type DetectionResult = {
+    runner: RunnerDefinition;
+    detected: boolean;
+    reasons: Array<string>;
+};

package/dist/lib/types/generated/DraftStatusConfig.d.ts

@@ -0,0 +1,3 @@
+export type DraftStatusConfig = {
+    enabled: boolean | null;
+};

package/dist/lib/types/generated/FrontmatterResponse.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Frontmatter response for API
+ */
+export type FrontmatterResponse = {
+    status: string;
+    created: string;
+    priority: string | null;
+    tags: Array<string>;
+    dependsOn: Array<string>;
+    parent: string | null;
+    assignee: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+    completedAt: string | null;
+};

package/dist/lib/types/generated/HealthResponse.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Health check response
+ */
+export type HealthResponse = {
+    status: string;
+    version: string;
+};

package/dist/lib/types/generated/HierarchyNode.d.ts

@@ -0,0 +1,29 @@
+import { SpecRelationships } from './SpecRelationships';
+/**
+ * Hierarchical node for tree view - pre-computed server-side for performance
+ */
+export type HierarchyNode = {
+    childNodes: Array<HierarchyNode>;
+    projectId: string | null;
+    id: string;
+    specNumber: number | null;
+    specName: string;
+    title: string | null;
+    status: string;
+    priority: string | null;
+    tags: Array<string>;
+    assignee: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+    completedAt: string | null;
+    filePath: string;
+    dependsOn: Array<string>;
+    parent: string | null;
+    children: Array<string>;
+    requiredBy: Array<string>;
+    contentHash: string | null;
+    tokenCount: number | null;
+    tokenStatus: string | null;
+    validationStatus: string | null;
+    relationships: SpecRelationships | null;
+};

package/dist/lib/types/generated/LeanSpecConfig.d.ts

@@ -0,0 +1,16 @@
+import { ConfigFeatures } from './ConfigFeatures';
+import { ConfigStructure } from './ConfigStructure';
+import { DraftStatusConfig } from './DraftStatusConfig';
+/**
+ * LeanSpec configuration structure
+ */
+export type LeanSpecConfig = {
+    template: string | null;
+    specsDir: string | null;
+    structure: ConfigStructure | null;
+    features: ConfigFeatures | null;
+    draftStatus: DraftStatusConfig | null;
+    templates: {
+        [key in string]?: string;
+    } | null;
+};

package/dist/lib/types/generated/ListSpecsQuery.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Query parameters for list specs
+ */
+export type ListSpecsQuery = {
+    status: string | null;
+    priority: string | null;
+    tags: string | null;
+    assignee: string | null;
+    limit: number | null;
+    offset: number | null;
+    cursor: string | null;
+    /**
+     * When true, return pre-built hierarchy tree structure for performance
+     */
+    hierarchy: boolean | null;
+};

package/dist/lib/types/generated/ListSpecsResponse.d.ts

@@ -0,0 +1,15 @@
+import { HierarchyNode } from './HierarchyNode';
+import { SpecSummary } from './SpecSummary';
+/**
+ * Response for list specs endpoint
+ */
+export type ListSpecsResponse = {
+    specs: Array<SpecSummary>;
+    total: number;
+    nextCursor: string | null;
+    projectId: string | null;
+    /**
+     * Pre-built hierarchy tree (only when hierarchy=true query param)
+     */
+    hierarchy: Array<HierarchyNode> | null;
+};

package/dist/lib/types/generated/MetadataUpdate.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Metadata update request
+ */
+export type MetadataUpdate = {
+    status: string | null;
+    priority: string | null;
+    tags: Array<string> | null;
+    assignee: string | null;
+    addDependsOn: Array<string> | null;
+    removeDependsOn: Array<string> | null;
+    parent: string | null | null;
+    expectedContentHash: string | null;
+    /**
+     * Skip completion verification when setting status to complete
+     */
+    force: boolean | null;
+};

package/dist/lib/types/generated/PriorityCountItem.d.ts

@@ -0,0 +1,4 @@
+export type PriorityCountItem = {
+    priority: string;
+    count: number;
+};

package/dist/lib/types/generated/ProjectConfigResponse.d.ts

@@ -0,0 +1,9 @@
+import { ContextFile } from './ContextFile';
+import { LeanSpecConfig } from './LeanSpecConfig';
+/**
+ * Project config container
+ */
+export type ProjectConfigResponse = {
+    file: ContextFile | null;
+    parsed: LeanSpecConfig | null;
+};

package/dist/lib/types/generated/ProjectContextResponse.d.ts

@@ -0,0 +1,12 @@
+import { ContextFile } from './ContextFile';
+import { ProjectConfigResponse } from './ProjectConfigResponse';
+/**
+ * Project context response
+ */
+export type ProjectContextResponse = {
+    agentInstructions: Array<ContextFile>;
+    config: ProjectConfigResponse;
+    projectDocs: Array<ContextFile>;
+    totalTokens: number;
+    projectRoot: string;
+};

package/dist/lib/types/generated/ProjectValidationResponse.d.ts

@@ -0,0 +1,9 @@
+import { ProjectValidationSummary } from './ProjectValidationSummary';
+/**
+ * Project validation summary
+ */
+export type ProjectValidationResponse = {
+    projectId: string;
+    path: string;
+    validation: ProjectValidationSummary;
+};

package/dist/lib/types/generated/ProjectValidationSummary.d.ts

@@ -0,0 +1,5 @@
+export type ProjectValidationSummary = {
+    isValid: boolean;
+    error: string | null;
+    specsDir: string | null;
+};

package/dist/lib/types/generated/RunnerDefinition.d.ts

@@ -0,0 +1,29 @@
+import { DetectionConfig } from './DetectionConfig';
+export type RunnerDefinition = {
+    id: string;
+    name: string | null;
+    command: string | null;
+    args: Array<string>;
+    env: {
+        [key in string]?: string;
+    };
+    model: string | null;
+    /**
+     * models.dev provider IDs whose models this runner can use.
+     * Models are resolved dynamically from the registry.
+     */
+    model_providers: Array<string> | null;
+    detection: DetectionConfig | null;
+    symlink_file: string | null;
+    /**
+     * Controls how the session prompt is passed to the runner CLI.
+     * - `Some(flag)` — prepend `flag` before the prompt value (e.g. `"--print"`).
+     * - `Some("-")` — suppress prompt injection (runner doesn't accept a prompt arg).
+     * - `None` — append the prompt as a positional argument.
+     */
+    prompt_flag: string | null;
+    /**
+     * Optional execution protocol override (`acp` or `shell`). Defaults to shell.
+     */
+    protocol: string | null;
+};

package/dist/lib/types/generated/SearchFilters.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Search filters
+ */
+export type SearchFilters = {
+    status: string | null;
+    priority: string | null;
+    tags: Array<string> | null;
+};

package/dist/lib/types/generated/SearchRequest.d.ts

@@ -0,0 +1,9 @@
+import { SearchFilters } from './SearchFilters';
+/**
+ * Request body for search
+ */
+export type SearchRequest = {
+    query: string;
+    filters: SearchFilters | null;
+    projectId: string | null;
+};

package/dist/lib/types/generated/SearchResponse.d.ts

@@ -0,0 +1,10 @@
+import { SpecSummary } from './SpecSummary';
+/**
+ * Response for search endpoint
+ */
+export type SearchResponse = {
+    results: Array<SpecSummary>;
+    total: number;
+    query: string;
+    projectId: string | null;
+};

package/dist/lib/types/generated/SectionTokenCount.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Section token count for h2 sections
+ */
+export type SectionTokenCount = {
+    heading: string;
+    tokens: number;
+};

package/dist/lib/types/generated/Session.d.ts

@@ -0,0 +1,69 @@
+import { SessionMode } from './SessionMode';
+import { SessionStatus } from './SessionStatus';
+/**
+ * A coding session
+ */
+export type Session = {
+    /**
+     * Unique session ID (UUID)
+     */
+    id: string;
+    /**
+     * Project path where session runs
+     */
+    project_path: string;
+    /**
+     * Specs attached as context (zero or more)
+     */
+    spec_ids: Array<string>;
+    /**
+     * Optional custom prompt/instructions for the session
+     */
+    prompt: string | null;
+    /**
+     * AI runner used (claude, copilot, codex, opencode)
+     */
+    runner: string;
+    /**
+     * Session mode (guided, autonomous)
+     */
+    mode: SessionMode;
+    /**
+     * Current session status
+     */
+    status: SessionStatus;
+    /**
+     * Exit code (None if still running)
+     */
+    exit_code: number | null;
+    /**
+     * When session started
+     */
+    started_at: string;
+    /**
+     * When session ended (None if still running)
+     */
+    ended_at: string | null;
+    /**
+     * Duration in milliseconds
+     */
+    duration_ms: bigint | null;
+    /**
+     * Estimated token count
+     */
+    token_count: bigint | null;
+    /**
+     * Additional metadata
+     */
+    metadata: {
+        [key in string]?: string;
+    };
+    /**
+     * When session was created in database
+     */
+    created_at: string;
+    /**
+     * When session was last updated
+     */
+    updated_at: string;
+};

package/dist/lib/types/generated/SessionConfig.d.ts

@@ -0,0 +1,44 @@
+import { SessionMode } from './SessionMode';
+/**
+ * Configuration for creating a new session
+ */
+export type SessionConfig = {
+    /**
+     * Project path
+     */
+    project_path: string;
+    /**
+     * Specs attached as context (zero or more)
+     */
+    spec_ids: Array<string>;
+    /**
+     * Optional custom prompt/instructions for the session
+     */
+    prompt: string | null;
+    /**
+     * AI runner to use
+     */
+    runner: string;
+    /**
+     * Session mode
+     */
+    mode: SessionMode;
+    /**
+     * Maximum iterations for Ralph mode
+     */
+    max_iterations: number | null;
+    /**
+     * Working directory
+     */
+    working_dir: string | null;
+    /**
+     * Environment variables
+     */
+    env_vars: {
+        [key in string]?: string;
+    };
+    /**
+     * Additional arguments for the runner
+     */
+    runner_args: Array<string>;
+};

package/dist/lib/types/generated/SessionMode.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Session mode - controls behavior during execution
+ */
+export type SessionMode = "guided" | "autonomous";

package/dist/lib/types/generated/SessionStatus.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Session status
+ */
+export type SessionStatus = "pending" | "running" | "paused" | "completed" | "failed" | "cancelled";

package/dist/lib/types/generated/SpecDetail.d.ts

@@ -0,0 +1,31 @@
+import { SpecRelationships } from './SpecRelationships';
+import { SubSpec } from './SubSpec';
+/**
+ * Full spec detail for view
+ */
+export type SpecDetail = {
+    projectId: string | null;
+    id: string;
+    specNumber: number | null;
+    specName: string;
+    title: string | null;
+    status: string;
+    priority: string | null;
+    tags: Array<string>;
+    assignee: string | null;
+    contentMd: string;
+    createdAt: string | null;
+    updatedAt: string | null;
+    completedAt: string | null;
+    filePath: string;
+    dependsOn: Array<string>;
+    parent: string | null;
+    children: Array<string>;
+    requiredBy: Array<string>;
+    contentHash: string | null;
+    tokenCount: number | null;
+    tokenStatus: string | null;
+    validationStatus: string | null;
+    relationships: SpecRelationships | null;
+    subSpecs: Array<SubSpec> | null;
+};

package/dist/lib/types/generated/SpecMetadata.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Metadata for a single spec (tokens + validation)
+ */
+export type SpecMetadata = {
+    tokenCount: number;
+    tokenStatus: string;
+    validationStatus: string;
+};

package/dist/lib/types/generated/SpecPriority.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Priority of a spec
+ */
+export type SpecPriority = "low" | "medium" | "high" | "critical";