// TaskGenerator import removed - legacy test functionality replaced with AI validation
import { Storage } from './core/storage.js';
import { StorageManager } from './core/storage-manager.js';
import { TaskStatusSchema } from './types/index.js';
import { promises as fs } from 'fs';
import path from 'path';
import { DEFAULT_CONFIG } from './types/config.js';
/**
* Resolves the project root directory using multiple fallback strategies
*/
export async function resolveProjectRoot(explicitRoot?: string): Promise<string> {
// 1. Use explicit parameter if provided
if (explicitRoot) {
return path.resolve(explicitRoot);
}
// 2. Check environment variable
if (process.env.SPECLINTER_PROJECT_ROOT) {
return path.resolve(process.env.SPECLINTER_PROJECT_ROOT);
}
// 3. Auto-detect by walking up from process.cwd()
const detected = await findProjectRoot(process.cwd());
if (detected) {
return detected;
}
// 4. Fallback to process.cwd()
return process.cwd();
}
/**
* Walks up the directory tree looking for a .speclinter directory
*/
async function findProjectRoot(startDir: string): Promise<string | null> {
let currentDir = path.resolve(startDir);
const rootDir = path.parse(currentDir).root;
while (currentDir !== rootDir) {
try {
const speclinterPath = path.join(currentDir, '.speclinter');
await fs.access(speclinterPath);
// Found .speclinter directory
return currentDir;
} catch {
// .speclinter not found, go up one level
currentDir = path.dirname(currentDir);
}
}
return null;
}
// Tool handlers
export async function handleGetTaskStatus(args: any) {
const { feature_name, project_root } = args;
const rootDir = await resolveProjectRoot(project_root);
const storage = await StorageManager.createInitializedStorage(rootDir);
const status = await storage.getFeatureStatus(feature_name);
return status;
}
// handleRunTests function removed - replaced with AI-leveraged validation
// Use speclinter_validate_implementation_prepare and speclinter_validate_implementation_process instead
export async function handleUpdateTaskStatus(args: any) {
const { feature_name, task_id, status, notes, project_root } = args;
// Validate status
const validStatus = TaskStatusSchema.parse(status);
const rootDir = await resolveProjectRoot(project_root);
const storage = await StorageManager.createInitializedStorage(rootDir);
// Update task status
const updatedTask = await storage.updateTaskStatus(
feature_name,
task_id,
validStatus,
notes
);
// Update active file
await storage.updateActiveFile(feature_name);
return {
task_id: updatedTask.id,
feature_name: updatedTask.featureName,
status: updatedTask.status,
title: updatedTask.title,
updated: true
};
}
export async function handleInitProject(args: any) {
const { project_root, force_reinit = false } = args;
const root = await resolveProjectRoot(project_root);
const speclinterDir = path.join(root, '.speclinter');
// Check if already initialized
try {
await fs.access(speclinterDir);
if (!force_reinit) {
return {
success: false,
message: 'SpecLinter already initialized in this directory. Use force_reinit: true to reinitialize.',
project_root: root
};
}
} catch {
// Directory doesn't exist, proceed with initialization
}
try {
// Create directory structure
const directories = [
'.speclinter',
'.speclinter/context',
'speclinter-tasks'
];
for (const dir of directories) {
const dirPath = path.join(root, dir);
await fs.mkdir(dirPath, { recursive: true });
}
// Create default config
const configPath = path.join(speclinterDir, 'config.json');
await fs.writeFile(
configPath,
JSON.stringify(DEFAULT_CONFIG, null, 2)
);
// Create context directory (files will be AI-generated on first analysis)
await fs.mkdir(path.join(speclinterDir, 'context'), { recursive: true });
// Create .gitignore for speclinter
const gitignorePath = path.join(speclinterDir, '.gitignore');
await fs.writeFile(gitignorePath, '*.db\n*.db-journal\n');
// Initialize database and create tables
const storage = new Storage(root);
await storage.initialize();
return {
success: true,
message: 'SpecLinter initialized successfully!',
project_root: root,
directories_created: directories,
next_steps: [
'Run codebase analysis to generate AI-powered context files',
'Use speclinter_analyze_codebase_prepare to start AI analysis',
'Context files will be automatically generated with project-specific content'
]
};
} catch (error) {
return {
success: false,
message: `Failed to initialize SpecLinter: ${error instanceof Error ? error.message : 'Unknown error'}`,
project_root: root
};
}
}
// Template creation removed in Option A implementation
// Context files are now generated by AI analysis instead of generic templates
