@harnspec/ui 0.0.1

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

@@ -0,0 +1,448 @@
+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 = GeneratedSessionStatus;
+export type SessionMode = GeneratedSessionMode;
+export type SessionProtocol = 'acp' | 'subprocess';
+export type SubSpec = UiSubSpec & {
+    file?: string;
+    name?: string;
+    content?: string;
+};
+export type Spec = UiLightweightSpec & {
+    content?: string;
+    contentMd?: string;
+    contentHash?: string;
+    tokenCount?: number;
+    tokenStatus?: TokenStatus;
+    validationStatus?: ValidationStatus;
+    relationships?: UiSpecRelationships;
+};
+export type SpecDetail = UiSpecWithMetadata & {
+    content?: string;
+    contentHash?: string;
+    tokenCount?: number;
+    tokenStatus?: TokenStatus;
+    validationStatus?: ValidationStatus;
+    metadata?: Record<string, unknown>;
+    subSpecs?: SubSpec[];
+};
+export interface Session {
+    id: string;
+    projectPath: string;
+    specIds: string[];
+    /** @deprecated Use specIds instead. Returns first spec ID for backward compatibility. */
+    specId?: string | null;
+    prompt?: string | null;
+    runner: string;
+    mode: SessionMode;
+    protocol?: SessionProtocol | null;
+    status: SessionStatus;
+    startedAt: string;
+    endedAt?: string | null;
+    durationMs?: number | null;
+    tokenCount?: number | null;
+    activeToolCall?: {
+        id?: string;
+        tool: string;
+        status: 'running' | 'completed' | 'failed';
+    } | null;
+    planProgress?: {
+        completed: number;
+        total: number;
+    } | null;
+}
+export type RunnerSource = 'builtin' | 'global' | 'project';
+export interface RunnerDefinition {
+    id: string;
+    name?: string | null;
+    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.
+     */
+    available?: boolean;
+    version?: string | null;
+    source: RunnerSource;
+}
+export interface RunnerListResponse {
+    default?: string | null;
+    runners: RunnerDefinition[];
+}
+export interface RunnerValidateResponse {
+    valid: boolean;
+    error?: string | null;
+}
+export interface RunnerVersionResponse {
+    version?: string | null;
+}
+export interface RunnerModelsResponse {
+    models: string[];
+}
+export type RunnerScope = 'project' | 'global';
+export interface SessionLog {
+    id: number;
+    timestamp: string;
+    level: string;
+    message: string;
+}
+export type AcpToolCallStatus = 'running' | 'completed' | 'failed';
+export type AcpPlanEntryStatus = 'pending' | 'running' | 'done';
+export type SessionStreamEvent = {
+    type: 'log';
+    timestamp: string;
+    level: string;
+    message: string;
+} | {
+    type: 'acp_message';
+    timestamp?: string;
+    role: 'agent' | 'user';
+    content: string;
+    done: boolean;
+    contentBlocks?: unknown[];
+    rawContent?: unknown;
+} | {
+    type: 'acp_thought';
+    timestamp?: string;
+    content: string;
+    done: boolean;
+    contentBlocks?: unknown[];
+    rawContent?: unknown;
+} | {
+    type: 'acp_tool_call';
+    timestamp?: string;
+    id: string;
+    tool: string;
+    args: Record<string, unknown>;
+    status: AcpToolCallStatus;
+    result?: unknown;
+    rawContent?: unknown;
+} | {
+    type: 'acp_plan';
+    timestamp?: string;
+    entries: Array<{
+        id: string;
+        title: string;
+        status: AcpPlanEntryStatus;
+    }>;
+    done?: boolean;
+} | {
+    type: 'acp_permission_request';
+    timestamp?: string;
+    id: string;
+    tool: string;
+    args: Record<string, unknown>;
+    options: string[];
+} | {
+    type: 'acp_mode_update';
+    timestamp?: string;
+    mode: string;
+} | {
+    type: 'complete';
+    status: string;
+    duration_ms: number;
+};
+export interface SessionArchiveResult {
+    path: string;
+}
+export interface SessionEvent {
+    id: number;
+    timestamp: string;
+    eventType?: string;
+    event_type?: string;
+    data?: string | null;
+}
+export type MachineStatus = 'online' | 'offline';
+export interface Machine {
+    id: string;
+    label: string;
+    status: MachineStatus;
+    lastSeen?: string;
+    projectCount?: number;
+}
+export interface MachinesResponse {
+    machines: Machine[];
+}
+export interface Stats {
+    totalProjects: number;
+    totalSpecs: number;
+    specsByStatus: {
+        status: string;
+        count: number;
+    }[];
+    specsByPriority: {
+        priority: string;
+        count: number;
+    }[];
+    completionRate: number;
+    projectId?: string;
+}
+export interface DependencyNode {
+    id: string;
+    name: string;
+    number: number;
+    status: string;
+    priority: string;
+    tags: string[];
+}
+export interface DependencyEdge {
+    source: string;
+    target: string;
+    type?: 'depends_on' | 'required_by' | 'dependsOn';
+}
+export interface DependencyGraph {
+    nodes: DependencyNode[];
+    edges: DependencyEdge[];
+}
+export interface Project {
+    id: string;
+    name?: string;
+    displayName?: string;
+    path?: string;
+    specsDir?: string;
+    favorite?: boolean;
+    color?: string | null;
+    description?: string | null;
+    isFeatured?: boolean;
+    lastAccessed?: string | Date | null;
+    source?: 'local' | 'git';
+    git?: {
+        remoteUrl: string;
+        branch: string;
+        specsPath: string;
+        lastSynced?: string | null;
+    } | null;
+}
+export interface ProjectsResponse {
+    projects?: Project[];
+    recentProjects?: string[];
+    favoriteProjects?: string[];
+}
+export interface DetectedSpec {
+    path: string;
+    title?: string | null;
+    status?: string | null;
+    priority?: string | null;
+}
+export interface GitDetectResult {
+    remoteUrl?: string;
+    repo?: string;
+    branch: string;
+    specsDir: string;
+    specCount: number;
+    specs: DetectedSpec[];
+}
+export interface GitImportResult {
+    projectId: string;
+    projectName: string;
+    repo: string;
+    branch: string;
+    specsPath: string;
+    syncedSpecs: number;
+}
+export interface ProjectValidationResult {
+    isValid: boolean;
+    error?: string | null;
+}
+export interface ProjectValidationResponse {
+    validation: ProjectValidationResult;
+}
+export interface ProjectStatsResponse {
+    stats: Stats;
+}
+export interface DirectoryItem {
+    name: string;
+    path: string;
+    isDirectory: boolean;
+}
+export interface DirectoryListResponse {
+    items: DirectoryItem[];
+    path: string;
+}
+export interface ContextFileListItem {
+    name: string;
+    path: string;
+    size: number;
+    modified?: string | null;
+    modifiedAt?: Date | null;
+}
+export interface ContextFileContent extends ContextFileListItem {
+    content: string;
+    fileType?: string | null;
+    tokenCount: number;
+    lineCount: number;
+}
+/**
+ * Context file representation for project context visibility
+ */
+export interface ContextFile {
+    name: string;
+    path: string;
+    content: string;
+    tokenCount: number;
+    lastModified: Date | string;
+}
+/**
+ * HarnSpec configuration (from .harnspec/config.json)
+ */
+export interface HarnSpecConfig {
+    template?: string;
+    specsDir?: string;
+    draftStatus?: {
+        enabled?: boolean;
+    };
+    structure?: {
+        pattern?: string;
+        prefix?: string;
+        dateFormat?: string;
+        sequenceDigits?: number;
+        defaultFile?: string;
+    };
+    features?: {
+        aiAgents?: boolean;
+    };
+    templates?: Record<string, string>;
+}
+/**
+ * Project context containing all contextual files
+ */
+export interface ProjectContext {
+    agentInstructions: ContextFile[];
+    config: {
+        file: ContextFile | null;
+        parsed: HarnSpecConfig | null;
+    };
+    projectDocs: ContextFile[];
+    totalTokens: number;
+    projectRoot: string;
+}
+export interface ListParams {
+    status?: string;
+    priority?: string;
+    tag?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
+    cursor?: string;
+    /** When true, server returns pre-built hierarchy tree for performance */
+    hierarchy?: boolean;
+}
+export interface ListSpecsResponse {
+    specs: Spec[];
+    total: number;
+    nextCursor?: string;
+    projectId?: string;
+    /** Pre-built hierarchy tree (only when hierarchy=true query param) */
+    hierarchy?: HierarchyNode[];
+}
+/** Hierarchical node for tree view - pre-computed server-side for performance */
+export interface HierarchyNode {
+    id: string;
+    specNumber?: number;
+    specName: string;
+    title?: string | null;
+    status?: SpecStatus;
+    priority?: SpecPriority;
+    tags?: string[];
+    parent?: string | null;
+    children?: string[];
+    dependsOn?: string[];
+    requiredBy?: string[];
+    tokenCount?: number;
+    tokenStatus?: TokenStatus;
+    validationStatus?: ValidationStatus;
+    childNodes: HierarchyNode[];
+}
+export interface SectionTokenCount {
+    heading: string;
+    tokens: number;
+}
+export interface DetailedBreakdown {
+    codeBlocks: number;
+    checklists: number;
+    prose: number;
+    sections: SectionTokenCount[];
+}
+export interface TokenBreakdown {
+    frontmatter: number;
+    content: number;
+    title: number;
+    detailed: DetailedBreakdown;
+}
+export interface SpecTokenResponse {
+    tokenCount: number;
+    tokenStatus: TokenStatus;
+    tokenBreakdown: TokenBreakdown;
+}
+export interface SpecValidationError {
+    severity: 'info' | 'warning' | 'error';
+    message: string;
+    line?: number;
+    type: string;
+    suggestion?: string | null;
+}
+export interface SpecValidationResponse {
+    status: ValidationStatus;
+    errors: SpecValidationError[];
+}
+/** Metadata for a single spec (tokens + validation) */
+export interface SpecMetadata {
+    tokenCount: number;
+    tokenStatus: TokenStatus;
+    validationStatus: ValidationStatus;
+}
+/** Batch metadata response - tokens and validation for multiple specs */
+export interface BatchMetadataResponse {
+    specs: Record<string, SpecMetadata>;
+}
+export type FileEntryType = 'file' | 'directory';
+export interface FileEntry {
+    name: string;
+    type: FileEntryType;
+    /** Size in bytes – only for files */
+    size?: number;
+    /** Whether this entry is ignored by .gitignore */
+    ignored?: boolean;
+}
+export interface FileListResponse {
+    path: string;
+    entries: FileEntry[];
+}
+export interface FileContentResponse {
+    path: string;
+    content: string;
+    language: string;
+    size: number;
+    lineCount: number;
+}
+export interface FileSearchEntry {
+    name: string;
+    path: string;
+    type: FileEntryType;
+    /** Size in bytes – only for files */
+    size?: number;
+    /** Whether this entry is ignored by .gitignore */
+    ignored?: boolean;
+}
+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/chat-config.d.ts

@@ -0,0 +1,29 @@
+export interface Model {
+    id: string;
+    name: string;
+    maxTokens?: number;
+    contextWindow?: string;
+    pricing?: {
+        input: number;
+        output: number;
+    };
+    default?: boolean;
+}
+export interface Provider {
+    id: string;
+    name: string;
+    baseURL?: string;
+    models: Model[];
+    hasApiKey: boolean;
+    apiKey?: string;
+}
+export interface ChatConfig {
+    version: string;
+    providers: Provider[];
+    settings: {
+        maxSteps: number;
+        defaultProviderId: string;
+        defaultModelId: string;
+        enabledModels?: Record<string, 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/HarnSpecConfig.d.ts

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