@leanspec/ui 0.2.24 → 0.2.26

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,19 @@
+import { DetectionConfig } from './DetectionConfig';
+export type RunnerDefinition = {
+    id: string;
+    name: string | null;
+    command: string | null;
+    args: Array<string>;
+    env: {
+        [key in string]?: string;
+    };
+    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;
+};

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" | "ralph";

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";

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

@@ -0,0 +1,8 @@
+/**
+ * Raw spec content response
+ */
+export type SpecRawResponse = {
+    content: string;
+    contentHash: string;
+    filePath: string;
+};

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

@@ -0,0 +1,7 @@
+/**
+ * Request to update raw spec content
+ */
+export type SpecRawUpdateRequest = {
+    content: string;
+    expectedContentHash: string | null;
+};

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

@@ -0,0 +1,7 @@
+/**
+ * Spec relationships container
+ */
+export type SpecRelationships = {
+    dependsOn: Array<string>;
+    requiredBy: Array<string> | null;
+};

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

@@ -0,0 +1,4 @@
+/**
+ * Status of a spec
+ */
+export type SpecStatus = "draft" | "planned" | "in-progress" | "complete" | "archived";

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

@@ -0,0 +1,28 @@
+import { SpecRelationships } from './SpecRelationships';
+/**
+ * Lightweight spec for list views
+ */
+export type SpecSummary = {
+    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/SpecTokenResponse.d.ts

@@ -0,0 +1,9 @@
+import { TokenBreakdown } from './TokenBreakdown';
+/**
+ * Spec token response
+ */
+export type SpecTokenResponse = {
+    tokenCount: number;
+    tokenStatus: string;
+    tokenBreakdown: TokenBreakdown;
+};

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

@@ -0,0 +1,10 @@
+/**
+ * Spec validation error
+ */
+export type SpecValidationError = {
+    severity: string;
+    message: string;
+    line: number | null;
+    type: string;
+    suggestion: string | null;
+};

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

@@ -0,0 +1,8 @@
+import { SpecValidationError } from './SpecValidationError';
+/**
+ * Spec validation response
+ */
+export type SpecValidationResponse = {
+    status: string;
+    errors: Array<SpecValidationError>;
+};

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

@@ -0,0 +1,13 @@
+import { PriorityCountItem } from './PriorityCountItem';
+import { StatusCountItem } from './StatusCountItem';
+/**
+ * Statistics response
+ */
+export type StatsResponse = {
+    totalProjects: number;
+    totalSpecs: number;
+    specsByStatus: Array<StatusCountItem>;
+    specsByPriority: Array<PriorityCountItem>;
+    completionRate: number;
+    projectId: string | null;
+};

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

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

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

@@ -0,0 +1,8 @@
+import { SpecStatus } from './SpecStatus';
+/**
+ * A status transition record for tracking spec lifecycle
+ */
+export type StatusTransition = {
+    status: SpecStatus;
+    at: string;
+};

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

@@ -0,0 +1,8 @@
+/**
+ * Sub-spec metadata for spec detail payloads
+ */
+export type SubSpec = {
+    name: string;
+    file: string;
+    content: string;
+};

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

@@ -0,0 +1,13 @@
+import { DetailedBreakdown } from './DetailedBreakdown';
+/**
+ * Token breakdown for a spec
+ */
+export type TokenBreakdown = {
+    frontmatter: number;
+    content: number;
+    title: number;
+    /**
+     * Detailed breakdown by content type
+     */
+    detailed: DetailedBreakdown;
+};

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

@@ -0,0 +1,9 @@
+import { FrontmatterResponse } from './FrontmatterResponse';
+/**
+ * Metadata update response
+ */
+export type UpdateMetadataResponse = {
+    success: boolean;
+    specId: string;
+    frontmatter: FrontmatterResponse;
+};

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

@@ -0,0 +1,5 @@
+export type ValidationError = {
+    severity: string;
+    message: string;
+    spec: string | null;
+};

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

@@ -0,0 +1,8 @@
+import { ValidationError } from './ValidationError';
+/**
+ * Validation result
+ */
+export type ValidationResponse = {
+    isValid: boolean;
+    errors: Array<ValidationError>;
+};