@compilr-dev/cli 0.4.0

package/dist/db/repositories/document-repository.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Document Repository
+ *
+ * Handles all database operations for project documents (PRD, architecture, etc.).
+ */
+import type { DocumentType } from '../schema.js';
+export interface CreateDocumentInput {
+    project_id: number;
+    doc_type: DocumentType;
+    title: string;
+    content: string;
+}
+export interface UpdateDocumentInput {
+    title?: string;
+    content?: string;
+}
+export interface ProjectDocument {
+    id: number;
+    projectId: number;
+    docType: DocumentType;
+    title: string;
+    content: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const documentRepository: {
+    /**
+     * Create or update a document (upsert by project_id + doc_type)
+     */
+    upsert(input: CreateDocumentInput): ProjectDocument;
+    /**
+     * Create a new document
+     */
+    create(input: CreateDocumentInput): ProjectDocument;
+    /**
+     * Get document by ID
+     */
+    getById(id: number): ProjectDocument | null;
+    /**
+     * Get document by project and type
+     */
+    getByType(projectId: number, docType: DocumentType): ProjectDocument | null;
+    /**
+     * List all documents for a project
+     */
+    listByProject(projectId: number): ProjectDocument[];
+    /**
+     * Update a document
+     */
+    update(id: number, input: UpdateDocumentInput): ProjectDocument | null;
+    /**
+     * Delete a document
+     */
+    delete(id: number): boolean;
+    /**
+     * Delete all documents of a type for a project
+     */
+    deleteByType(projectId: number, docType: DocumentType): boolean;
+    /**
+     * Get document counts by type for a project
+     */
+    getTypeCounts(projectId: number): Record<DocumentType, number>;
+};

package/dist/db/repositories/document-repository.js

@@ -0,0 +1,184 @@
+/**
+ * Document Repository
+ *
+ * Handles all database operations for project documents (PRD, architecture, etc.).
+ */
+import { getDb } from '../index.js';
+/**
+ * Convert database record to ProjectDocument object
+ */
+function recordToDocument(record) {
+    return {
+        id: record.id,
+        projectId: record.project_id,
+        docType: record.doc_type,
+        title: record.title,
+        content: record.content,
+        createdAt: new Date(record.created_at),
+        updatedAt: new Date(record.updated_at),
+    };
+}
+export const documentRepository = {
+    /**
+     * Create or update a document (upsert by project_id + doc_type)
+     */
+    upsert(input) {
+        const db = getDb();
+        const now = new Date().toISOString();
+        // Check if document exists
+        const existing = this.getByType(input.project_id, input.doc_type);
+        if (existing) {
+            // Update existing document
+            db.prepare(`
+        UPDATE project_documents
+        SET title = ?, content = ?, updated_at = ?
+        WHERE id = ?
+      `).run(input.title, input.content, now, existing.id);
+            const doc = this.getById(existing.id);
+            if (!doc)
+                throw new Error('Failed to update document');
+            return doc;
+        }
+        // Create new document
+        const result = db
+            .prepare(`
+      INSERT INTO project_documents (
+        project_id, doc_type, title, content, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?)
+    `)
+            .run(input.project_id, input.doc_type, input.title, input.content, now, now);
+        const doc = this.getById(Number(result.lastInsertRowid));
+        if (!doc)
+            throw new Error('Failed to create document');
+        return doc;
+    },
+    /**
+     * Create a new document
+     */
+    create(input) {
+        const db = getDb();
+        const now = new Date().toISOString();
+        const result = db
+            .prepare(`
+      INSERT INTO project_documents (
+        project_id, doc_type, title, content, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?)
+    `)
+            .run(input.project_id, input.doc_type, input.title, input.content, now, now);
+        const doc = this.getById(Number(result.lastInsertRowid));
+        if (!doc)
+            throw new Error('Failed to create document');
+        return doc;
+    },
+    /**
+     * Get document by ID
+     */
+    getById(id) {
+        const db = getDb();
+        const record = db
+            .prepare('SELECT * FROM project_documents WHERE id = ?')
+            .get(id);
+        return record ? recordToDocument(record) : null;
+    },
+    /**
+     * Get document by project and type
+     */
+    getByType(projectId, docType) {
+        const db = getDb();
+        const record = db
+            .prepare('SELECT * FROM project_documents WHERE project_id = ? AND doc_type = ?')
+            .get(projectId, docType);
+        return record ? recordToDocument(record) : null;
+    },
+    /**
+     * List all documents for a project
+     */
+    listByProject(projectId) {
+        const db = getDb();
+        const records = db
+            .prepare(`
+      SELECT * FROM project_documents
+      WHERE project_id = ?
+      ORDER BY
+        CASE doc_type
+          WHEN 'prd' THEN 1
+          WHEN 'architecture' THEN 2
+          WHEN 'design' THEN 3
+          WHEN 'notes' THEN 4
+          ELSE 5
+        END,
+        created_at ASC
+    `)
+            .all(projectId);
+        return records.map(recordToDocument);
+    },
+    /**
+     * Update a document
+     */
+    update(id, input) {
+        const db = getDb();
+        const updates = [];
+        const params = [];
+        if (input.title !== undefined) {
+            updates.push('title = ?');
+            params.push(input.title);
+        }
+        if (input.content !== undefined) {
+            updates.push('content = ?');
+            params.push(input.content);
+        }
+        if (updates.length === 0) {
+            return this.getById(id);
+        }
+        updates.push('updated_at = ?');
+        params.push(new Date().toISOString());
+        params.push(id);
+        const query = `UPDATE project_documents SET ${updates.join(', ')} WHERE id = ?`;
+        db.prepare(query).run(...params);
+        return this.getById(id);
+    },
+    /**
+     * Delete a document
+     */
+    delete(id) {
+        const db = getDb();
+        const result = db
+            .prepare('DELETE FROM project_documents WHERE id = ?')
+            .run(id);
+        return result.changes > 0;
+    },
+    /**
+     * Delete all documents of a type for a project
+     */
+    deleteByType(projectId, docType) {
+        const db = getDb();
+        const result = db
+            .prepare('DELETE FROM project_documents WHERE project_id = ? AND doc_type = ?')
+            .run(projectId, docType);
+        return result.changes > 0;
+    },
+    /**
+     * Get document counts by type for a project
+     */
+    getTypeCounts(projectId) {
+        const db = getDb();
+        const results = db
+            .prepare(`
+      SELECT doc_type, COUNT(*) as count
+      FROM project_documents
+      WHERE project_id = ?
+      GROUP BY doc_type
+    `)
+            .all(projectId);
+        const counts = {
+            prd: 0,
+            architecture: 0,
+            design: 0,
+            notes: 0,
+        };
+        for (const row of results) {
+            counts[row.doc_type] = row.count;
+        }
+        return counts;
+    },
+};

package/dist/db/repositories/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Repository exports
+ */
+export { projectRepository } from './project-repository.js';
+export type { CreateProjectInput, UpdateProjectInput, Project, } from './project-repository.js';
+export { workItemRepository } from './work-item-repository.js';
+export type { CreateWorkItemInput, UpdateWorkItemInput, QueryWorkItemsInput, WorkItem, } from './work-item-repository.js';
+export { documentRepository } from './document-repository.js';
+export type { CreateDocumentInput, UpdateDocumentInput, ProjectDocument, } from './document-repository.js';

package/dist/db/repositories/index.js

@@ -0,0 +1,6 @@
+/**
+ * Repository exports
+ */
+export { projectRepository } from './project-repository.js';
+export { workItemRepository } from './work-item-repository.js';
+export { documentRepository } from './document-repository.js';

package/dist/db/repositories/project-repository.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Project Repository
+ *
+ * Handles all database operations for projects.
+ */
+import type { ProjectType, ProjectStatus, RepoPattern, WorkflowMode, LifecycleState } from '../schema.js';
+export interface CreateProjectInput {
+    name: string;
+    display_name: string;
+    description?: string;
+    type?: ProjectType;
+    path: string;
+    docs_path?: string;
+    repo_pattern?: RepoPattern;
+    language?: string;
+    framework?: string;
+    package_manager?: string;
+    runtime_version?: string;
+    commands?: Record<string, string>;
+    git_remote?: string;
+    git_branch?: string;
+    workflow_mode?: WorkflowMode;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateProjectInput {
+    display_name?: string;
+    description?: string;
+    type?: ProjectType;
+    status?: ProjectStatus;
+    docs_path?: string;
+    repo_pattern?: RepoPattern;
+    language?: string;
+    framework?: string;
+    package_manager?: string;
+    runtime_version?: string;
+    commands?: Record<string, string>;
+    git_remote?: string;
+    git_branch?: string;
+    workflow_mode?: WorkflowMode;
+    lifecycle_state?: LifecycleState;
+    current_item_id?: string | null;
+    last_context?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface Project {
+    id: number;
+    name: string;
+    displayName: string;
+    description: string | null;
+    type: ProjectType;
+    status: ProjectStatus;
+    path: string;
+    docsPath: string | null;
+    repoPattern: RepoPattern;
+    language: string | null;
+    framework: string | null;
+    packageManager: string | null;
+    runtimeVersion: string | null;
+    commands: Record<string, string> | null;
+    gitRemote: string | null;
+    gitBranch: string;
+    workflowMode: WorkflowMode;
+    lifecycleState: LifecycleState;
+    currentItemId: string | null;
+    lastContext: Record<string, unknown> | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: Date;
+    updatedAt: Date;
+    lastActivityAt: Date | null;
+}
+export declare const projectRepository: {
+    /**
+     * Create a new project
+     */
+    create(input: CreateProjectInput): Project;
+    /**
+     * Get project by ID
+     */
+    getById(id: number): Project | null;
+    /**
+     * Get project by name
+     */
+    getByName(name: string): Project | null;
+    /**
+     * Get project by path (code repo)
+     */
+    getByPath(projectPath: string): Project | null;
+    /**
+     * Get project by docs path (for two-repo pattern)
+     */
+    getByDocsPath(docsPath: string): Project | null;
+    /**
+     * Find project by path (checks both path and docs_path, including parent directories)
+     */
+    findByPath(searchPath: string): Project | null;
+    /**
+     * List projects with optional filters
+     */
+    list(options?: {
+        status?: ProjectStatus | "all";
+        type?: ProjectType | "all";
+        limit?: number;
+        offset?: number;
+    }): {
+        projects: Project[];
+        total: number;
+    };
+    /**
+     * Update a project
+     */
+    update(id: number, input: UpdateProjectInput): Project | null;
+    /**
+     * Update last activity timestamp
+     */
+    touch(id: number): void;
+    /**
+     * Delete a project (cascades to work_items, documents, history)
+     */
+    delete(id: number): boolean;
+    /**
+     * Archive a project (set status to 'archived')
+     */
+    archive(id: number): Project | null;
+    /**
+     * Check if a project name is available
+     */
+    isNameAvailable(name: string, excludeId?: number): boolean;
+    /**
+     * Get project counts by status
+     */
+    getStatusCounts(): Record<ProjectStatus, number>;
+};