hammoc 1.0.0

package/packages/server/dist/services/projectService.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Project Service
+ * Scans ~/.claude/projects/ directory for project list
+ * [Source: Story 3.1 - Task 2]
+ * [Extended: Story 3.6 - Task 2: Project creation service]
+ */
+import type { PromptHistoryData, ProjectInfo, ProjectSettings, UpdateProjectSettingsRequest, ProjectSettingsApiResponse, CreateProjectRequest, CreateProjectResponse, ValidatePathResponse } from '@hammoc/shared';
+/**
+ * ProjectService - Scans and lists Claude Code projects
+ */
+declare class ProjectService {
+    /**
+     * Get the Claude projects directory path
+     * @returns Path to ~/.claude/projects/
+     */
+    getClaudeProjectsDir(): string;
+    /**
+     * Scan the projects directory and return project list
+     * @returns Array of ProjectInfo sorted by lastModified (descending)
+     */
+    scanProjects(): Promise<ProjectInfo[]>;
+    /**
+     * Parse sessions-index.json file from a project directory
+     * @param projectPath Full path to the project directory in ~/.claude/projects/
+     * @param projectSlug The folder name (hash/slug)
+     * @returns ProjectInfo or null if parsing fails
+     */
+    parseSessionsIndex(projectPath: string, projectSlug: string): Promise<ProjectInfo | null>;
+    /**
+     * Read project settings from <originalPath>/.hammoc/settings.json
+     * Returns default values if file doesn't exist
+     */
+    readProjectSettings(originalPath: string): Promise<ProjectSettings>;
+    /**
+     * Write project settings to <originalPath>/.hammoc/settings.json
+     * Creates .hammoc directory if it doesn't exist
+     * Supports null values to delete overrides (null = remove field, undefined = no change)
+     */
+    writeProjectSettings(originalPath: string, settings: UpdateProjectSettingsRequest): Promise<void>;
+    /**
+     * Internal helper: builds ProjectSettingsApiResponse from an already-resolved originalPath.
+     * Used by both getProjectSettingsWithEffective() and updateProjectSettings() to avoid
+     * redundant parseSessionsIndex() calls.
+     */
+    private _buildEffectiveResponse;
+    /**
+     * Returns project settings merged with global preferences.
+     * Calculates effective values and identifies which fields are overridden.
+     */
+    getProjectSettingsWithEffective(projectSlug: string): Promise<ProjectSettingsApiResponse>;
+    /**
+     * Update settings for a project identified by its slug
+     * @returns Updated ProjectSettingsApiResponse with effective values
+     */
+    updateProjectSettings(projectSlug: string, settings: UpdateProjectSettingsRequest): Promise<ProjectSettingsApiResponse>;
+    /**
+     * Read session names from <originalPath>/.hammoc/session-names.json
+     * Returns empty object if file doesn't exist
+     */
+    readSessionNames(originalPath: string): Promise<Record<string, string>>;
+    /**
+     * Write session names to <originalPath>/.hammoc/session-names.json
+     */
+    private writeSessionNames;
+    /**
+     * Update a session name for a project identified by slug
+     * @param name null to remove the name
+     */
+    updateSessionName(projectSlug: string, sessionId: string, name: string | null): Promise<string | null>;
+    /**
+     * Resolve a project slug to its original filesystem path.
+     * Returns null if the project does not exist.
+     */
+    resolveProjectPath(projectSlug: string): Promise<string | null>;
+    /**
+     * Read session names for a project identified by slug
+     */
+    readSessionNamesBySlug(projectSlug: string): Promise<Record<string, string>>;
+    /**
+     * Read prompt history for a session within a project
+     */
+    readPromptHistory(originalPath: string, sessionId: string): Promise<PromptHistoryData>;
+    /**
+     * Write prompt history for a session within a project
+     */
+    writePromptHistory(originalPath: string, sessionId: string, data: PromptHistoryData): Promise<void>;
+    /**
+     * Read prompt history for a session identified by project slug
+     */
+    readPromptHistoryBySlug(projectSlug: string, sessionId: string): Promise<PromptHistoryData>;
+    /**
+     * Write prompt history for a session identified by project slug
+     */
+    writePromptHistoryBySlug(projectSlug: string, sessionId: string, data: PromptHistoryData): Promise<void>;
+    /**
+     * Extract originalPath (cwd) from a .jsonl session file's first few lines.
+     * Used as fallback when sessions-index.json doesn't exist (e.g., VS Code extension projects).
+     * Only reads the first 4KB to avoid loading large conversation logs.
+     */
+    private extractCwdFromSessionFiles;
+    /**
+     * Build ProjectInfo from a project directory without sessions-index.json.
+     * Scans .jsonl files for session count, timestamps, and originalPath.
+     */
+    private buildProjectFromDirectory;
+    /**
+     * Resolve a project slug to its originalPath.
+     * Tries sessions-index.json first, falls back to JSONL-based discovery.
+     * @throws Error with code 'PROJECT_NOT_FOUND' if project cannot be resolved
+     */
+    resolveOriginalPath(projectSlug: string): Promise<string>;
+    /**
+     * Get session count for a single project (lightweight, no full scan).
+     * Used by dashboard to avoid expensive scanProjects() calls.
+     */
+    getProjectSessionCount(projectSlug: string): Promise<number>;
+    /**
+     * Check if a path exists on the filesystem
+     * @param targetPath Path to check
+     * @returns true if path exists
+     */
+    checkPathExists(targetPath: string): Promise<boolean>;
+    /**
+     * Check if a project has .bmad-core folder
+     * @param originalPath The original project path from sessions-index.json
+     * @returns true if .bmad-core folder exists
+     */
+    checkBmadProject(originalPath: string): Promise<boolean>;
+    /**
+     * Validate a directory path
+     * [Source: Story 3.6 - Task 2]
+     * @param inputPath Path to validate
+     * @returns Validation result
+     */
+    validatePath(inputPath: string): Promise<ValidatePathResponse>;
+    /**
+     * Find project by original path
+     * [Source: Story 3.6 - Task 2]
+     * @param originalPath Original project path
+     * @returns ProjectInfo or null
+     */
+    findProjectByPath(originalPath: string): Promise<ProjectInfo | null>;
+    /**
+     * Create a new project
+     * [Source: Story 3.6 - Task 2]
+     * @param request Create project request
+     * @returns Created project info
+     */
+    createProject(request: CreateProjectRequest): Promise<CreateProjectResponse>;
+    /**
+     * Initialize a Claude project directory
+     * Creates the necessary structure in ~/.claude/projects/
+     * [Source: Story 3.6 - Task 2]
+     *
+     * Strategy:
+     * 1. Check if project already exists with this path
+     * 2. Try to use Claude Code CLI for initialization
+     * 3. Fallback: use same path-encoding as Claude Code
+     *
+     * @param projectPath Original project path
+     * @returns Project slug (path-encoded or existing)
+     */
+    initializeClaudeProject(projectPath: string): Promise<string>;
+    /**
+     * Get list of available BMad method versions from bundled resources
+     * @returns Array of version strings sorted descending (latest first)
+     */
+    getBmadVersions(): Promise<string[]>;
+    /**
+     * Get the latest available BMad method version
+     * @returns Latest version string or null if none available
+     */
+    getLatestBmadVersion(): Promise<string | null>;
+    /**
+     * Setup .bmad-core folder in project by copying from bundled template
+     * Copies the full BMad method content (agents, tasks, templates, workflows, etc.)
+     * @param projectPath Project directory path
+     * @param version BMad method version to install
+     */
+    setupBmadCore(projectPath: string, version: string): Promise<void>;
+    /**
+     * Setup BMad for an existing project by slug
+     * @param projectSlug Project slug (folder name in ~/.claude/projects/)
+     * @param version BMad version to install (defaults to latest)
+     * @param force Force setup even if project already has .bmad-core
+     * @returns Object with updated ProjectInfo and installed version
+     */
+    setupBmadForProject(projectSlug: string, version?: string, force?: boolean): Promise<{
+        project: ProjectInfo;
+        installedVersion: string;
+    }>;
+    /**
+     * Delete a project's session data from ~/.claude/projects/
+     * Optionally also deletes the actual project files on disk.
+     * @param projectSlug Project slug (folder name in ~/.claude/projects/)
+     * @param deleteFiles If true, also delete the project directory on disk
+     * @returns true if deleted successfully
+     */
+    deleteProject(projectSlug: string, deleteFiles?: boolean): Promise<boolean>;
+    /**
+     * Recursively copy directory contents from source to destination
+     * Preserves directory structure. Does not overwrite existing files.
+     * @param src Source directory path
+     * @param dest Destination directory path
+     */
+    private copyDirRecursive;
+}
+export declare const projectService: ProjectService;
+export {};
+//# sourceMappingURL=projectService.d.ts.map

package/packages/server/dist/services/projectService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectService.d.ts","sourceRoot":"","sources":["../../src/services/projectService.ts"],"names":[],"mappings":"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"}