prjct-cli 0.11.0 → 0.11.2

package/packages/shared/dist/index.d.ts

@@ -0,0 +1,615 @@
+import { z } from 'zod';
+
+/**
+ * Core Types for prjct
+ */
+interface Session {
+    id: string;
+    projectId: string;
+    task: string;
+    status: 'active' | 'paused' | 'completed';
+    startedAt: string;
+    pausedAt: string | null;
+    completedAt: string | null;
+    duration: number;
+    metrics: SessionMetrics;
+    timeline: TimelineEvent[];
+}
+interface SessionMetrics {
+    filesChanged: number;
+    linesAdded: number;
+    linesRemoved: number;
+    commits: number;
+    snapshots: string[];
+}
+interface TimelineEvent {
+    type: 'start' | 'pause' | 'resume' | 'complete' | 'snapshot';
+    at: string;
+    data?: Record<string, unknown>;
+}
+interface Snapshot {
+    hash: string;
+    shortHash: string;
+    message: string;
+    timestamp: string;
+    files: string[];
+}
+interface Task {
+    id: string;
+    title: string;
+    description?: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'blocked';
+    priority: 'low' | 'medium' | 'high' | 'critical';
+    createdAt: string;
+    completedAt?: string;
+    duration?: number;
+    tags?: string[];
+}
+interface Idea {
+    id: string;
+    content: string;
+    capturedAt: string;
+    source?: string;
+    promoted?: boolean;
+    promotedTo?: string;
+}
+interface Feature {
+    id: string;
+    title: string;
+    description?: string;
+    status: 'planned' | 'in_progress' | 'shipped' | 'cancelled';
+    priority: number;
+    createdAt: string;
+    shippedAt?: string;
+    tasks?: Task[];
+    version?: string;
+}
+interface Project {
+    id: string;
+    name: string;
+    path: string;
+    createdAt: string;
+    lastActiveAt: string;
+    config: ProjectConfig;
+}
+interface ProjectConfig {
+    projectId: string;
+    name?: string;
+    plugins?: string[];
+    [key: string]: unknown;
+}
+interface DailyMetrics {
+    date: string;
+    sessions: number;
+    duration: number;
+    commits: number;
+    filesChanged: number;
+    linesAdded: number;
+    linesRemoved: number;
+}
+interface WeeklyMetrics {
+    weekStart: string;
+    weekEnd: string;
+    totalSessions: number;
+    totalDuration: number;
+    averageDuration: number;
+    tasksCompleted: number;
+    featuresShipped: number;
+    productivityScore: number;
+    streak: number;
+    byDay: Record<string, DailyMetrics>;
+}
+interface WSMessage {
+    type: string;
+    payload?: unknown;
+    timestamp: string;
+}
+interface WSInputMessage extends WSMessage {
+    type: 'input';
+    payload: {
+        data: string;
+    };
+}
+interface WSOutputMessage extends WSMessage {
+    type: 'output';
+    payload: {
+        data: string;
+    };
+}
+interface WSResizeMessage extends WSMessage {
+    type: 'resize';
+    payload: {
+        cols: number;
+        rows: number;
+    };
+}
+interface WSStatusMessage extends WSMessage {
+    type: 'status';
+    payload: {
+        status: 'connected' | 'disconnected' | 'error';
+        message?: string;
+    };
+}
+interface ApiResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    timestamp: string;
+}
+type EventType = 'session.started' | 'session.paused' | 'session.resumed' | 'session.completed' | 'task.created' | 'task.completed' | 'feature.added' | 'feature.shipped' | 'idea.captured' | 'snapshot.created' | 'snapshot.restored' | 'git.commit' | 'git.push' | 'project.init' | 'project.sync';
+interface EventPayload {
+    type: EventType;
+    timestamp: string;
+    projectId: string;
+    data: Record<string, unknown>;
+}
+
+/**
+ * Zod Schemas for validation
+ */
+
+declare const SessionMetricsSchema: z.ZodObject<{
+    filesChanged: z.ZodDefault<z.ZodNumber>;
+    linesAdded: z.ZodDefault<z.ZodNumber>;
+    linesRemoved: z.ZodDefault<z.ZodNumber>;
+    commits: z.ZodDefault<z.ZodNumber>;
+    snapshots: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    filesChanged: number;
+    linesAdded: number;
+    linesRemoved: number;
+    commits: number;
+    snapshots: string[];
+}, {
+    filesChanged?: number | undefined;
+    linesAdded?: number | undefined;
+    linesRemoved?: number | undefined;
+    commits?: number | undefined;
+    snapshots?: string[] | undefined;
+}>;
+declare const TimelineEventSchema: z.ZodObject<{
+    type: z.ZodEnum<["start", "pause", "resume", "complete", "snapshot"]>;
+    at: z.ZodString;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    type: "start" | "pause" | "resume" | "complete" | "snapshot";
+    data?: Record<string, unknown> | undefined;
+}, {
+    at: string;
+    type: "start" | "pause" | "resume" | "complete" | "snapshot";
+    data?: Record<string, unknown> | undefined;
+}>;
+declare const SessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    projectId: z.ZodString;
+    task: z.ZodString;
+    status: z.ZodEnum<["active", "paused", "completed"]>;
+    startedAt: z.ZodString;
+    pausedAt: z.ZodNullable<z.ZodString>;
+    completedAt: z.ZodNullable<z.ZodString>;
+    duration: z.ZodNumber;
+    metrics: z.ZodObject<{
+        filesChanged: z.ZodDefault<z.ZodNumber>;
+        linesAdded: z.ZodDefault<z.ZodNumber>;
+        linesRemoved: z.ZodDefault<z.ZodNumber>;
+        commits: z.ZodDefault<z.ZodNumber>;
+        snapshots: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        filesChanged: number;
+        linesAdded: number;
+        linesRemoved: number;
+        commits: number;
+        snapshots: string[];
+    }, {
+        filesChanged?: number | undefined;
+        linesAdded?: number | undefined;
+        linesRemoved?: number | undefined;
+        commits?: number | undefined;
+        snapshots?: string[] | undefined;
+    }>;
+    timeline: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["start", "pause", "resume", "complete", "snapshot"]>;
+        at: z.ZodString;
+        data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        type: "start" | "pause" | "resume" | "complete" | "snapshot";
+        data?: Record<string, unknown> | undefined;
+    }, {
+        at: string;
+        type: "start" | "pause" | "resume" | "complete" | "snapshot";
+        data?: Record<string, unknown> | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    status: "active" | "paused" | "completed";
+    id: string;
+    task: string;
+    startedAt: string;
+    pausedAt: string | null;
+    completedAt: string | null;
+    duration: number;
+    metrics: {
+        filesChanged: number;
+        linesAdded: number;
+        linesRemoved: number;
+        commits: number;
+        snapshots: string[];
+    };
+    timeline: {
+        at: string;
+        type: "start" | "pause" | "resume" | "complete" | "snapshot";
+        data?: Record<string, unknown> | undefined;
+    }[];
+}, {
+    projectId: string;
+    status: "active" | "paused" | "completed";
+    id: string;
+    task: string;
+    startedAt: string;
+    pausedAt: string | null;
+    completedAt: string | null;
+    duration: number;
+    metrics: {
+        filesChanged?: number | undefined;
+        linesAdded?: number | undefined;
+        linesRemoved?: number | undefined;
+        commits?: number | undefined;
+        snapshots?: string[] | undefined;
+    };
+    timeline: {
+        at: string;
+        type: "start" | "pause" | "resume" | "complete" | "snapshot";
+        data?: Record<string, unknown> | undefined;
+    }[];
+}>;
+declare const TaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["pending", "in_progress", "completed", "blocked"]>;
+    priority: z.ZodEnum<["low", "medium", "high", "critical"]>;
+    createdAt: z.ZodString;
+    completedAt: z.ZodOptional<z.ZodString>;
+    duration: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    status: "completed" | "pending" | "in_progress" | "blocked";
+    id: string;
+    title: string;
+    priority: "low" | "medium" | "high" | "critical";
+    createdAt: string;
+    completedAt?: string | undefined;
+    duration?: number | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+}, {
+    status: "completed" | "pending" | "in_progress" | "blocked";
+    id: string;
+    title: string;
+    priority: "low" | "medium" | "high" | "critical";
+    createdAt: string;
+    completedAt?: string | undefined;
+    duration?: number | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+}>;
+declare const IdeaSchema: z.ZodObject<{
+    id: z.ZodString;
+    content: z.ZodString;
+    capturedAt: z.ZodString;
+    source: z.ZodOptional<z.ZodString>;
+    promoted: z.ZodOptional<z.ZodBoolean>;
+    promotedTo: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    content: string;
+    capturedAt: string;
+    source?: string | undefined;
+    promoted?: boolean | undefined;
+    promotedTo?: string | undefined;
+}, {
+    id: string;
+    content: string;
+    capturedAt: string;
+    source?: string | undefined;
+    promoted?: boolean | undefined;
+    promotedTo?: string | undefined;
+}>;
+declare const FeatureSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["planned", "in_progress", "shipped", "cancelled"]>;
+    priority: z.ZodNumber;
+    createdAt: z.ZodString;
+    shippedAt: z.ZodOptional<z.ZodString>;
+    tasks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<["pending", "in_progress", "completed", "blocked"]>;
+        priority: z.ZodEnum<["low", "medium", "high", "critical"]>;
+        createdAt: z.ZodString;
+        completedAt: z.ZodOptional<z.ZodString>;
+        duration: z.ZodOptional<z.ZodNumber>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        status: "completed" | "pending" | "in_progress" | "blocked";
+        id: string;
+        title: string;
+        priority: "low" | "medium" | "high" | "critical";
+        createdAt: string;
+        completedAt?: string | undefined;
+        duration?: number | undefined;
+        description?: string | undefined;
+        tags?: string[] | undefined;
+    }, {
+        status: "completed" | "pending" | "in_progress" | "blocked";
+        id: string;
+        title: string;
+        priority: "low" | "medium" | "high" | "critical";
+        createdAt: string;
+        completedAt?: string | undefined;
+        duration?: number | undefined;
+        description?: string | undefined;
+        tags?: string[] | undefined;
+    }>, "many">>;
+    version: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "in_progress" | "planned" | "shipped" | "cancelled";
+    id: string;
+    title: string;
+    priority: number;
+    createdAt: string;
+    description?: string | undefined;
+    shippedAt?: string | undefined;
+    tasks?: {
+        status: "completed" | "pending" | "in_progress" | "blocked";
+        id: string;
+        title: string;
+        priority: "low" | "medium" | "high" | "critical";
+        createdAt: string;
+        completedAt?: string | undefined;
+        duration?: number | undefined;
+        description?: string | undefined;
+        tags?: string[] | undefined;
+    }[] | undefined;
+    version?: string | undefined;
+}, {
+    status: "in_progress" | "planned" | "shipped" | "cancelled";
+    id: string;
+    title: string;
+    priority: number;
+    createdAt: string;
+    description?: string | undefined;
+    shippedAt?: string | undefined;
+    tasks?: {
+        status: "completed" | "pending" | "in_progress" | "blocked";
+        id: string;
+        title: string;
+        priority: "low" | "medium" | "high" | "critical";
+        createdAt: string;
+        completedAt?: string | undefined;
+        duration?: number | undefined;
+        description?: string | undefined;
+        tags?: string[] | undefined;
+    }[] | undefined;
+    version?: string | undefined;
+}>;
+declare const ProjectConfigSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    plugins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    projectId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    plugins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    projectId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    plugins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+declare const WSInputMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"input">;
+    payload: z.ZodObject<{
+        data: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        data: string;
+    }, {
+        data: string;
+    }>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "input";
+    payload: {
+        data: string;
+    };
+    timestamp: string;
+}, {
+    type: "input";
+    payload: {
+        data: string;
+    };
+    timestamp: string;
+}>;
+declare const WSResizeMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"resize">;
+    payload: z.ZodObject<{
+        cols: z.ZodNumber;
+        rows: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        cols: number;
+        rows: number;
+    }, {
+        cols: number;
+        rows: number;
+    }>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "resize";
+    payload: {
+        cols: number;
+        rows: number;
+    };
+    timestamp: string;
+}, {
+    type: "resize";
+    payload: {
+        cols: number;
+        rows: number;
+    };
+    timestamp: string;
+}>;
+declare const WSMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"input">;
+    payload: z.ZodObject<{
+        data: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        data: string;
+    }, {
+        data: string;
+    }>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "input";
+    payload: {
+        data: string;
+    };
+    timestamp: string;
+}, {
+    type: "input";
+    payload: {
+        data: string;
+    };
+    timestamp: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"resize">;
+    payload: z.ZodObject<{
+        cols: z.ZodNumber;
+        rows: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        cols: number;
+        rows: number;
+    }, {
+        cols: number;
+        rows: number;
+    }>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "resize";
+    payload: {
+        cols: number;
+        rows: number;
+    };
+    timestamp: string;
+}, {
+    type: "resize";
+    payload: {
+        cols: number;
+        rows: number;
+    };
+    timestamp: string;
+}>]>;
+declare const CreateSessionRequestSchema: z.ZodObject<{
+    task: z.ZodString;
+    projectId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    task: string;
+}, {
+    projectId: string;
+    task: string;
+}>;
+declare const CreateTaskRequestSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    priority: z.ZodDefault<z.ZodEnum<["low", "medium", "high", "critical"]>>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    priority: "low" | "medium" | "high" | "critical";
+    description?: string | undefined;
+}, {
+    title: string;
+    description?: string | undefined;
+    priority?: "low" | "medium" | "high" | "critical" | undefined;
+}>;
+declare const CaptureIdeaRequestSchema: z.ZodObject<{
+    content: z.ZodString;
+    source: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    source?: string | undefined;
+}, {
+    content: string;
+    source?: string | undefined;
+}>;
+type SessionInput = z.infer<typeof SessionSchema>;
+type TaskInput = z.infer<typeof TaskSchema>;
+type IdeaInput = z.infer<typeof IdeaSchema>;
+type FeatureInput = z.infer<typeof FeatureSchema>;
+type ProjectConfigInput = z.infer<typeof ProjectConfigSchema>;
+type WSMessageInput = z.infer<typeof WSMessageSchema>;
+
+/**
+ * Shared Utilities
+ */
+/**
+ * Generate a unique session ID
+ */
+declare function generateSessionId(): string;
+/**
+ * Generate a unique ID with prefix
+ */
+declare function generateId(prefix?: string): string;
+/**
+ * Format duration in seconds to human readable
+ */
+declare function formatDuration(seconds: number): string;
+/**
+ * Parse duration string to seconds
+ */
+declare function parseDuration(duration: string): number;
+/**
+ * Get relative time string
+ */
+declare function getRelativeTime(date: Date | string): string;
+/**
+ * Get ISO timestamp
+ */
+declare function getTimestamp(): string;
+/**
+ * Get date in YYYY-MM-DD format
+ */
+declare function getDate(): string;
+/**
+ * Get year-month in YYYY-MM format
+ */
+declare function getYearMonth(): string;
+/**
+ * Safely parse JSON
+ */
+declare function safeJsonParse<T>(json: string, fallback: T): T;
+/**
+ * Truncate string with ellipsis
+ */
+declare function truncate(str: string, maxLength: number): string;
+/**
+ * Slugify string
+ */
+declare function slugify(str: string): string;
+/**
+ * Deep clone object
+ */
+declare function deepClone<T>(obj: T): T;
+/**
+ * Check if running in Node.js
+ */
+declare function isNode(): boolean;
+/**
+ * Check if running in browser
+ */
+declare function isBrowser(): boolean;
+
+export { type ApiResponse, CaptureIdeaRequestSchema, CreateSessionRequestSchema, CreateTaskRequestSchema, type DailyMetrics, type EventPayload, type EventType, type Feature, type FeatureInput, FeatureSchema, type Idea, type IdeaInput, IdeaSchema, type Project, type ProjectConfig, type ProjectConfigInput, ProjectConfigSchema, type Session, type SessionInput, type SessionMetrics, SessionMetricsSchema, SessionSchema, type Snapshot, type Task, type TaskInput, TaskSchema, type TimelineEvent, TimelineEventSchema, type WSInputMessage, WSInputMessageSchema, type WSMessage, type WSMessageInput, WSMessageSchema, type WSOutputMessage, type WSResizeMessage, WSResizeMessageSchema, type WSStatusMessage, type WeeklyMetrics, deepClone, formatDuration, generateId, generateSessionId, getDate, getRelativeTime, getTimestamp, getYearMonth, isBrowser, isNode, parseDuration, safeJsonParse, slugify, truncate };