@piecemaker-legal/piecemaker 1.0.0

package/dist-server/server/modules/projects/services/project-clone.service.js

@@ -0,0 +1,220 @@
+import { access, mkdir, rm } from 'node:fs/promises';
+import path from 'node:path';
+// cross-spawn: drop-in spawn with Windows .cmd/PATHEXT resolution.
+import spawn from 'cross-spawn';
+import { githubTokensDb } from '../../../modules/database/index.js';
+import { createProject } from '../../../modules/projects/services/project-management.service.js';
+import { AppError, validateWorkspacePath } from '../../../shared/utils.js';
+async function defaultPathExists(targetPath) {
+    try {
+        await access(targetPath);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return false;
+        }
+        throw error;
+    }
+}
+function sanitizeGitError(message, token) {
+    if (!message || !token) {
+        return message;
+    }
+    const escapedToken = token.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return message.replace(new RegExp(escapedToken, 'g'), '***');
+}
+function resolveCloneFailureMessage(lastError, sanitizedError) {
+    if (lastError.includes('Authentication failed') || lastError.includes('could not read Username')) {
+        return 'Authentication failed. Please check your credentials.';
+    }
+    if (lastError.includes('Repository not found')) {
+        return 'Repository not found. Please check the URL and ensure you have access.';
+    }
+    if (lastError.includes('already exists')) {
+        return 'Directory already exists';
+    }
+    if (sanitizedError) {
+        return sanitizedError;
+    }
+    return 'Git clone failed';
+}
+function resolveErrorMessage(error) {
+    if (error instanceof AppError) {
+        return error.message;
+    }
+    if (error instanceof Error && error.message) {
+        return error.message;
+    }
+    return 'Unexpected error';
+}
+const defaultDependencies = {
+    validatePath: validateWorkspacePath,
+    ensureDirectory: async (directoryPath) => {
+        await mkdir(directoryPath, { recursive: true });
+    },
+    pathExists: defaultPathExists,
+    removePath: async (targetPath) => {
+        await rm(targetPath, { recursive: true, force: true });
+    },
+    getGithubTokenById: async (tokenId, userId) => {
+        const tokenRow = githubTokensDb.getGithubTokenById(userId, tokenId);
+        return tokenRow;
+    },
+    spawnGitClone: (cloneUrl, clonePath) => spawn('git', ['clone', '--progress', '--', cloneUrl, clonePath], {
+        stdio: ['ignore', 'pipe', 'pipe'],
+        env: {
+            ...process.env,
+            GIT_TERMINAL_PROMPT: '0',
+        },
+    }),
+    registerProject: async (projectPath, customName) => createProject({
+        projectPath,
+        customName,
+    }),
+    logError: (message, error) => {
+        console.error(message, error);
+    },
+};
+export async function startCloneProject(input, handlers, dependencies = defaultDependencies) {
+    const normalizedWorkspacePath = input.workspacePath.trim();
+    const normalizedGithubUrl = input.githubUrl.trim();
+    if (!normalizedWorkspacePath) {
+        throw new AppError('workspacePath and githubUrl are required', {
+            code: 'WORKSPACE_PATH_REQUIRED',
+            statusCode: 400,
+        });
+    }
+    if (!normalizedGithubUrl) {
+        throw new AppError('workspacePath and githubUrl are required', {
+            code: 'GITHUB_URL_REQUIRED',
+            statusCode: 400,
+        });
+    }
+    if (normalizedGithubUrl.startsWith('-')) {
+        throw new AppError('Invalid githubUrl', {
+            code: 'INVALID_GITHUB_URL',
+            statusCode: 400,
+        });
+    }
+    const pathValidation = await dependencies.validatePath(normalizedWorkspacePath);
+    if (!pathValidation.valid || !pathValidation.resolvedPath) {
+        throw new AppError(pathValidation.error || 'Invalid workspace path', {
+            code: 'INVALID_PROJECT_PATH',
+            statusCode: 400,
+        });
+    }
+    const absolutePath = pathValidation.resolvedPath;
+    await dependencies.ensureDirectory(absolutePath);
+    let githubToken = null;
+    if (typeof input.githubTokenId === 'number') {
+        const numericUserId = typeof input.userId === 'number' ? input.userId : Number.parseInt(String(input.userId), 10);
+        if (Number.isNaN(numericUserId)) {
+            throw new AppError('Authenticated user is required', {
+                code: 'AUTHENTICATION_REQUIRED',
+                statusCode: 401,
+            });
+        }
+        const token = await dependencies.getGithubTokenById(input.githubTokenId, numericUserId);
+        if (!token) {
+            throw new AppError('GitHub token not found', {
+                code: 'GITHUB_TOKEN_NOT_FOUND',
+                statusCode: 404,
+            });
+        }
+        githubToken = token.github_token;
+    }
+    else if (input.newGithubToken && input.newGithubToken.trim().length > 0) {
+        githubToken = input.newGithubToken.trim();
+    }
+    const sanitizedGithubUrl = normalizedGithubUrl.replace(/\/+$/, '').replace(/\.git$/, '');
+    const repoName = sanitizedGithubUrl.split('/').pop() || 'repository';
+    const clonePath = path.join(absolutePath, repoName);
+    if (await dependencies.pathExists(clonePath)) {
+        throw new AppError(`Directory "${repoName}" already exists. Please choose a different location or remove the existing directory.`, {
+            code: 'CLONE_TARGET_ALREADY_EXISTS',
+            statusCode: 409,
+        });
+    }
+    let cloneUrl = normalizedGithubUrl;
+    if (githubToken) {
+        try {
+            const url = new URL(normalizedGithubUrl);
+            url.username = githubToken;
+            url.password = '';
+            cloneUrl = url.toString();
+        }
+        catch {
+            // SSH URLs cannot be represented by URL constructor and are used as-is.
+        }
+    }
+    handlers.onProgress(`Cloning into '${repoName}'...`);
+    const gitProcess = dependencies.spawnGitClone(cloneUrl, clonePath);
+    let lastError = '';
+    gitProcess.stdout?.on('data', (data) => {
+        const message = data.toString().trim();
+        if (message) {
+            handlers.onProgress(message);
+        }
+    });
+    gitProcess.stderr?.on('data', (data) => {
+        const message = data.toString().trim();
+        lastError = message;
+        if (message) {
+            handlers.onProgress(message);
+        }
+    });
+    const waitForCompletion = new Promise((resolve, reject) => {
+        gitProcess.on('close', async (code) => {
+            if (code === 0) {
+                try {
+                    const createdProject = await dependencies.registerProject(clonePath, repoName);
+                    handlers.onComplete({
+                        project: createdProject.project,
+                        message: 'Repository cloned successfully',
+                    });
+                    resolve();
+                }
+                catch (error) {
+                    reject(new AppError(`Clone succeeded but failed to add project: ${resolveErrorMessage(error)}`, {
+                        code: 'CLONE_PROJECT_REGISTRATION_FAILED',
+                        statusCode: 500,
+                    }));
+                }
+                return;
+            }
+            const sanitizedError = sanitizeGitError(lastError, githubToken);
+            const errorMessage = resolveCloneFailureMessage(lastError, sanitizedError);
+            try {
+                await dependencies.removePath(clonePath);
+            }
+            catch (cleanupError) {
+                dependencies.logError('Failed to clean up after clone failure:', cleanupError);
+            }
+            reject(new AppError(errorMessage, {
+                code: 'GIT_CLONE_FAILED',
+                statusCode: 500,
+            }));
+        });
+        gitProcess.on('error', (error) => {
+            if (error.code === 'ENOENT') {
+                reject(new AppError('Git is not installed or not in PATH', {
+                    code: 'GIT_NOT_FOUND',
+                    statusCode: 500,
+                }));
+                return;
+            }
+            reject(new AppError(error.message, {
+                code: 'GIT_EXECUTION_FAILED',
+                statusCode: 500,
+            }));
+        });
+    });
+    return {
+        waitForCompletion,
+        cancel: () => {
+            gitProcess.kill();
+        },
+    };
+}
+//# sourceMappingURL=project-clone.service.js.map

package/dist-server/server/modules/projects/services/project-clone.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-clone.service.js","sourceRoot":"","sources":["../../../../../server/modules/projects/services/project-clone.service.ts"],"names":[],"mappings":"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"}

package/dist-server/server/modules/projects/services/project-delete.service.js

@@ -0,0 +1,89 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { projectsDb, sessionsDb } from '../../../modules/database/index.js';
+import { AppError } from '../../../shared/utils.js';
+function uniqueJsonlPathsFromSessions(sessions) {
+    const seen = new Set();
+    const result = [];
+    for (const row of sessions) {
+        const raw = row.jsonl_path?.trim();
+        if (!raw) {
+            continue;
+        }
+        const absolute = path.isAbsolute(raw) ? path.normalize(raw) : path.resolve(raw);
+        if (seen.has(absolute)) {
+            continue;
+        }
+        seen.add(absolute);
+        result.push(absolute);
+    }
+    return result;
+}
+async function unlinkJsonlIfExists(filePath) {
+    try {
+        await fs.unlink(filePath);
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'ENOENT') {
+            return;
+        }
+        console.warn(`[project-delete] Failed to remove ${filePath}:`, error.message);
+    }
+}
+/**
+ * Loads all session rows for the project path and removes each distinct `jsonl_path` file on disk.
+ */
+export async function deleteSessionJsonlFilesForProjectPath(projectPath) {
+    const sessions = sessionsDb.getSessionsByProjectPathIncludingArchived(projectPath);
+    // Including the transcripts a session has left behind: editing a message on
+    // a provider that rewinds by branching moves the session onto a copy, and
+    // the row stops pointing at the file the replaced turns are still in.
+    const paths = uniqueJsonlPathsFromSessions([
+        ...sessions,
+        ...sessions.flatMap((session) => sessionsDb
+            .getSupersededTranscriptPaths(session.session_id)
+            .map((jsonl_path) => ({ jsonl_path }))),
+    ]);
+    for (const filePath of paths) {
+        await unlinkJsonlIfExists(filePath);
+    }
+    for (const session of sessions) {
+        sessionsDb.clearSupersededProviderSessions(session.session_id);
+    }
+}
+/**
+ * - **Soft delete** (`force` false): set `isArchived` on the `projects` row (hide from the active list; DB only).
+ * - **Force** (`force` true): for each session row for that `project_path`, delete the file at `jsonl_path`
+ *   (when set), then remove session rows and the `projects` row.
+ */
+export async function deleteOrArchiveProject(projectId, force) {
+    const row = projectsDb.getProjectById(projectId);
+    if (!row) {
+        throw new AppError(`Unknown projectId: ${projectId}`, {
+            code: 'PROJECT_NOT_FOUND',
+            statusCode: 404,
+        });
+    }
+    if (!force) {
+        projectsDb.updateProjectIsArchivedById(projectId, true);
+        return;
+    }
+    await deleteSessionJsonlFilesForProjectPath(row.project_path);
+    sessionsDb.deleteSessionsByProjectPath(row.project_path);
+    projectsDb.deleteProjectById(projectId);
+}
+/**
+ * Restores one archived project row back into the active project list.
+ */
+export function restoreArchivedProject(projectId) {
+    const row = projectsDb.getProjectById(projectId);
+    if (!row) {
+        throw new AppError(`Unknown projectId: ${projectId}`, {
+            code: 'PROJECT_NOT_FOUND',
+            statusCode: 404,
+        });
+    }
+    projectsDb.updateProjectIsArchivedById(projectId, false);
+}
+//# sourceMappingURL=project-delete.service.js.map

package/dist-server/server/modules/projects/services/project-delete.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-delete.service.js","sourceRoot":"","sources":["../../../../../server/modules/projects/services/project-delete.service.ts"],"names":[],"mappings":"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"}

package/dist-server/server/modules/projects/services/project-management.service.js

@@ -0,0 +1,90 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { projectsDb } from '../../../modules/database/index.js';
+import { AppError, normalizeProjectPath, validateWorkspacePath } from '../../../shared/utils.js';
+const defaultDependencies = {
+    validatePath: validateWorkspacePath,
+    ensureWorkspaceDirectory: async (projectPath) => {
+        await fs.mkdir(projectPath, { recursive: true });
+        const directoryStats = await fs.stat(projectPath);
+        if (!directoryStats.isDirectory()) {
+            throw new AppError('Path exists but is not a directory', {
+                code: 'PROJECT_PATH_NOT_DIRECTORY',
+                statusCode: 400,
+            });
+        }
+    },
+    persistProjectPath: (projectPath, customName) => projectsDb.createProjectPath(projectPath, customName),
+    getProjectByPath: (projectPath) => projectsDb.getProjectPath(projectPath),
+};
+function resolveDisplayName(customName, projectPath) {
+    const trimmedCustomName = typeof customName === 'string' ? customName.trim() : '';
+    if (trimmedCustomName.length > 0) {
+        return trimmedCustomName;
+    }
+    return path.basename(projectPath) || projectPath;
+}
+function mapProjectRowToApiView(projectRow) {
+    return {
+        projectId: projectRow.project_id,
+        path: projectRow.project_path,
+        fullPath: projectRow.project_path,
+        displayName: resolveDisplayName(projectRow.custom_project_name, projectRow.project_path),
+        customName: projectRow.custom_project_name,
+        isArchived: Boolean(projectRow.isArchived),
+        isStarred: Boolean(projectRow.isStarred),
+        sessions: [],
+        sessionMeta: {
+            hasMore: false,
+            total: 0,
+        },
+    };
+}
+export async function createProject(input, dependencies = defaultDependencies) {
+    const normalizedPath = normalizeProjectPath(input.projectPath || '');
+    if (!normalizedPath) {
+        throw new AppError('path is required', {
+            code: 'PROJECT_PATH_REQUIRED',
+            statusCode: 400,
+        });
+    }
+    const pathValidation = await dependencies.validatePath(normalizedPath);
+    if (!pathValidation.valid || !pathValidation.resolvedPath) {
+        throw new AppError('Invalid project path', {
+            code: 'INVALID_PROJECT_PATH',
+            statusCode: 400,
+            details: pathValidation.error ?? 'Path validation failed',
+        });
+    }
+    const resolvedProjectPath = normalizeProjectPath(pathValidation.resolvedPath);
+    await dependencies.ensureWorkspaceDirectory(resolvedProjectPath);
+    const normalizedCustomName = resolveDisplayName(input.customName ?? null, resolvedProjectPath);
+    const persistedProject = dependencies.persistProjectPath(resolvedProjectPath, normalizedCustomName);
+    if (persistedProject.outcome === 'active_conflict') {
+        throw new AppError('Project path already exists and is active', {
+            code: 'PROJECT_ALREADY_EXISTS',
+            statusCode: 409,
+            details: `Project path already exists: ${resolvedProjectPath}`,
+        });
+    }
+    const projectRow = persistedProject.project ?? dependencies.getProjectByPath(resolvedProjectPath);
+    if (!projectRow) {
+        throw new AppError('Failed to resolve project after creation', {
+            code: 'PROJECT_CREATE_FAILED',
+            statusCode: 500,
+        });
+    }
+    // Archived rows intentionally remain archived when reused, as requested.
+    return {
+        outcome: persistedProject.outcome,
+        project: mapProjectRowToApiView(projectRow),
+    };
+}
+/**
+ * Sets `projects.custom_project_name` for the given `projectId` (or clears it when empty).
+ */
+export function updateProjectDisplayName(projectId, newDisplayName) {
+    const trimmed = typeof newDisplayName === 'string' ? newDisplayName.trim() : '';
+    projectsDb.updateCustomProjectNameById(projectId, trimmed.length > 0 ? trimmed : null);
+}
+//# sourceMappingURL=project-management.service.js.map

package/dist-server/server/modules/projects/services/project-management.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-management.service.js","sourceRoot":"","sources":["../../../../../server/modules/projects/services/project-management.service.ts"],"names":[],"mappings":"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"}

package/dist-server/server/modules/projects/services/project-star.service.js

@@ -0,0 +1,60 @@
+import { projectsDb } from '../../../modules/database/index.js';
+import { AppError } from '../../../shared/utils.js';
+function normalizeProjectId(projectId) {
+    return projectId.trim();
+}
+function uniqueProjectIds(projectIds) {
+    const uniqueIds = new Set();
+    for (const projectId of projectIds) {
+        const normalizedProjectId = normalizeProjectId(projectId);
+        if (!normalizedProjectId) {
+            continue;
+        }
+        uniqueIds.add(normalizedProjectId);
+    }
+    return [...uniqueIds];
+}
+/**
+ * Applies legacy `localStorage` stars keyed by DB `projectId` onto `projects.isStarred`.
+ *
+ * The operation is idempotent: already-starred projects are ignored, unknown ids are skipped.
+ */
+export function applyLegacyStarredProjectIds(projectIds) {
+    const normalizedProjectIds = uniqueProjectIds(projectIds);
+    let updated = 0;
+    for (const projectId of normalizedProjectIds) {
+        const project = projectsDb.getProjectById(projectId);
+        if (!project) {
+            continue;
+        }
+        if (project.isStarred) {
+            continue;
+        }
+        projectsDb.updateProjectIsStarredById(projectId, true);
+        updated += 1;
+    }
+    return { updated };
+}
+/**
+ * Flips `projects.isStarred` for one project and returns the new state.
+ */
+export function toggleProjectStar(projectId) {
+    const normalizedProjectId = normalizeProjectId(projectId);
+    if (!normalizedProjectId) {
+        throw new AppError('projectId is required', {
+            code: 'PROJECT_ID_REQUIRED',
+            statusCode: 400,
+        });
+    }
+    const project = projectsDb.getProjectById(normalizedProjectId);
+    if (!project) {
+        throw new AppError('Project not found', {
+            code: 'PROJECT_NOT_FOUND',
+            statusCode: 404,
+        });
+    }
+    const nextStarredState = !project.isStarred;
+    projectsDb.updateProjectIsStarredById(normalizedProjectId, nextStarredState);
+    return { isStarred: nextStarredState };
+}
+//# sourceMappingURL=project-star.service.js.map

package/dist-server/server/modules/projects/services/project-star.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-star.service.js","sourceRoot":"","sources":["../../../../../server/modules/projects/services/project-star.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAU7C,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAoB;IAC5C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,UAAoB;IAC/D,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC1D,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,SAAS,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,SAAS;QACX,CAAC;QAED,UAAU,CAAC,0BAA0B,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,CAAC;IACf,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC1D,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,MAAM,IAAI,QAAQ,CAAC,uBAAuB,EAAE;YAC1C,IAAI,EAAE,qBAAqB;YAC3B,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,QAAQ,CAAC,mBAAmB,EAAE;YACtC,IAAI,EAAE,mBAAmB;YACzB,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,gBAAgB,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC;IAC5C,UAAU,CAAC,0BAA0B,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CAAC;IAE7E,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC;AACzC,CAAC"}

package/dist-server/server/modules/projects/services/projects-has-taskmaster.service.js

@@ -0,0 +1,167 @@
+import { access, readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { projectsDb } from '../../../modules/database/index.js';
+import { AppError } from '../../../shared/utils.js';
+function extractTasksFromJson(tasksData) {
+    if (!tasksData || typeof tasksData !== 'object') {
+        return [];
+    }
+    const legacyTasks = tasksData.tasks;
+    if (Array.isArray(legacyTasks)) {
+        return legacyTasks;
+    }
+    const taggedTaskCollections = [];
+    for (const tagValue of Object.values(tasksData)) {
+        if (!tagValue || typeof tagValue !== 'object') {
+            continue;
+        }
+        const tagTasks = tagValue.tasks;
+        if (Array.isArray(tagTasks)) {
+            taggedTaskCollections.push(...tagTasks);
+        }
+    }
+    return taggedTaskCollections;
+}
+async function detectTaskMasterFolder(projectPath) {
+    try {
+        const taskMasterPath = path.join(projectPath, '.taskmaster');
+        try {
+            const taskMasterStats = await stat(taskMasterPath);
+            if (!taskMasterStats.isDirectory()) {
+                return {
+                    hasTaskmaster: false,
+                    reason: '.taskmaster exists but is not a directory',
+                };
+            }
+        }
+        catch (error) {
+            const fileError = error;
+            if (fileError.code === 'ENOENT') {
+                return {
+                    hasTaskmaster: false,
+                    reason: '.taskmaster directory not found',
+                };
+            }
+            throw fileError;
+        }
+        const keyFiles = ['tasks/tasks.json', 'config.json'];
+        const fileStatus = {};
+        let hasEssentialFiles = true;
+        for (const fileName of keyFiles) {
+            const absoluteFilePath = path.join(taskMasterPath, fileName);
+            try {
+                await access(absoluteFilePath);
+                fileStatus[fileName] = true;
+            }
+            catch {
+                fileStatus[fileName] = false;
+                if (fileName === 'tasks/tasks.json') {
+                    hasEssentialFiles = false;
+                }
+            }
+        }
+        let taskMetadata = null;
+        if (fileStatus['tasks/tasks.json']) {
+            const tasksPath = path.join(taskMasterPath, 'tasks/tasks.json');
+            try {
+                const tasksContent = await readFile(tasksPath, 'utf8');
+                const parsedTasksJson = JSON.parse(tasksContent);
+                const tasks = extractTasksFromJson(parsedTasksJson);
+                const stats = tasks.reduce((accumulator, currentTask) => {
+                    accumulator.total += 1;
+                    const normalizedTaskStatus = currentTask.status || 'pending';
+                    accumulator.byStatus[normalizedTaskStatus] = (accumulator.byStatus[normalizedTaskStatus] || 0) + 1;
+                    if (Array.isArray(currentTask.subtasks)) {
+                        for (const subtask of currentTask.subtasks) {
+                            accumulator.subtotalTasks += 1;
+                            const normalizedSubtaskStatus = subtask.status || 'pending';
+                            accumulator.subtaskByStatus[normalizedSubtaskStatus] =
+                                (accumulator.subtaskByStatus[normalizedSubtaskStatus] || 0) + 1;
+                        }
+                    }
+                    return accumulator;
+                }, {
+                    total: 0,
+                    subtotalTasks: 0,
+                    byStatus: {},
+                    subtaskByStatus: {},
+                });
+                const tasksStat = await stat(tasksPath);
+                taskMetadata = {
+                    taskCount: stats.total,
+                    subtaskCount: stats.subtotalTasks,
+                    completed: stats.byStatus.done || 0,
+                    pending: stats.byStatus.pending || 0,
+                    inProgress: stats.byStatus['in-progress'] || 0,
+                    review: stats.byStatus.review || 0,
+                    completionPercentage: stats.total > 0 ? Math.round(((stats.byStatus.done || 0) / stats.total) * 100) : 0,
+                    lastModified: tasksStat.mtime.toISOString(),
+                };
+            }
+            catch (parseError) {
+                console.warn('Failed to parse tasks.json:', parseError.message);
+                taskMetadata = {
+                    error: 'Failed to parse tasks.json',
+                };
+            }
+        }
+        return {
+            hasTaskmaster: true,
+            hasEssentialFiles,
+            files: fileStatus,
+            metadata: taskMetadata,
+            path: taskMasterPath,
+        };
+    }
+    catch (error) {
+        console.error('Error detecting TaskMaster folder:', error);
+        return {
+            hasTaskmaster: false,
+            reason: `Error checking directory: ${error.message}`,
+        };
+    }
+}
+function normalizeTaskMasterInfo(taskMasterResult = null) {
+    const hasTaskmaster = Boolean(taskMasterResult?.hasTaskmaster);
+    const hasEssentialFiles = Boolean(taskMasterResult?.hasEssentialFiles);
+    return {
+        hasTaskmaster,
+        hasEssentialFiles,
+        metadata: taskMasterResult?.metadata ?? null,
+        status: hasTaskmaster && hasEssentialFiles ? 'configured' : 'not-configured',
+    };
+}
+const defaultDependencies = {
+    resolveProjectPathById: (projectId) => projectsDb.getProjectPathById(projectId),
+    detectTaskMasterFolder,
+};
+export async function getProjectTaskMasterById(projectId, dependencies = defaultDependencies) {
+    const projectPath = dependencies.resolveProjectPathById(projectId);
+    if (!projectPath) {
+        return null;
+    }
+    const taskMasterResult = await dependencies.detectTaskMasterFolder(projectPath);
+    return {
+        projectId,
+        projectPath,
+        taskmaster: normalizeTaskMasterInfo(taskMasterResult),
+    };
+}
+export async function getProjectTaskMaster(projectId, resolveById = getProjectTaskMasterById) {
+    const normalizedProjectId = projectId.trim();
+    if (!normalizedProjectId) {
+        throw new AppError('projectId is required', {
+            code: 'PROJECT_ID_REQUIRED',
+            statusCode: 400,
+        });
+    }
+    const taskMasterDetails = await resolveById(normalizedProjectId);
+    if (!taskMasterDetails) {
+        throw new AppError('Project not found', {
+            code: 'PROJECT_NOT_FOUND',
+            statusCode: 404,
+        });
+    }
+    return taskMasterDetails;
+}
+//# sourceMappingURL=projects-has-taskmaster.service.js.map