ai-spec-dev 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,151 @@
+import OpenAI from 'openai';
+
+interface ProjectContext {
+    techStack: string[];
+    fileStructure: string[];
+    dependencies: string[];
+    apiStructure: string[];
+    schema?: string;
+    routeSummary?: string;
+    /** Contents of .ai-spec-constitution.md if present */
+    constitution?: string;
+    /** Extracted error handling patterns from source */
+    errorPatterns?: string;
+}
+declare class ContextLoader {
+    private projectRoot;
+    constructor(projectRoot: string);
+    loadProjectContext(): Promise<ProjectContext>;
+    private loadPackageJson;
+    private loadPrismaSchema;
+    private loadFileStructure;
+    private loadConstitution;
+    private loadErrorPatterns;
+    private loadApiStructure;
+}
+
+interface AIProvider {
+    generate(prompt: string, systemInstruction?: string): Promise<string>;
+    readonly providerName: string;
+    readonly modelName: string;
+}
+interface ProviderMeta {
+    /** Human-readable display name */
+    displayName: string;
+    /** Short description shown in model picker */
+    description: string;
+    /** Available models (first is the default) */
+    models: string[];
+    /** Environment variable name for the API key */
+    envKey: string;
+    /**
+     * Base URL for OpenAI-compatible providers.
+     * Undefined means the provider has its own SDK (Gemini / Claude).
+     */
+    baseURL?: string;
+}
+declare const PROVIDER_CATALOG: Record<string, ProviderMeta>;
+declare const SUPPORTED_PROVIDERS: string[];
+declare const DEFAULT_MODELS: Record<string, string>;
+declare const ENV_KEY_MAP: Record<string, string>;
+declare class GeminiProvider implements AIProvider {
+    private genAI;
+    readonly providerName = "gemini";
+    readonly modelName: string;
+    constructor(apiKey: string, modelName?: string);
+    generate(prompt: string, systemInstruction?: string): Promise<string>;
+}
+declare class ClaudeProvider implements AIProvider {
+    private client;
+    readonly providerName = "claude";
+    readonly modelName: string;
+    constructor(apiKey: string, modelName?: string);
+    generate(prompt: string, systemInstruction?: string): Promise<string>;
+}
+declare class OpenAICompatibleProvider implements AIProvider {
+    protected client: OpenAI;
+    readonly providerName: string;
+    readonly modelName: string;
+    constructor(providerName: string, apiKey: string, modelName: string, baseURL?: string);
+    generate(prompt: string, systemInstruction?: string): Promise<string>;
+}
+declare function createProvider(providerName: string, apiKey: string, modelName?: string): AIProvider;
+declare class SpecGenerator {
+    private provider;
+    constructor(provider: AIProvider);
+    generateSpec(idea: string, context?: ProjectContext): Promise<string>;
+}
+
+declare class SpecRefiner {
+    private provider;
+    constructor(provider: AIProvider);
+    refineLoop(initialSpec: string): Promise<string>;
+}
+
+type CodeGenMode = "claude-code" | "api" | "plan";
+interface CodeGenOptions {
+    /** Run claude non-interactively via -p flag (saves tokens, good for automation) */
+    auto?: boolean;
+}
+declare class CodeGenerator {
+    private provider;
+    private mode;
+    constructor(provider: AIProvider, mode?: CodeGenMode);
+    generateCode(specFilePath: string, workingDir: string, context?: ProjectContext, options?: CodeGenOptions): Promise<void>;
+    private isClaudeCLIAvailable;
+    private runClaudeCode;
+    private runApiMode;
+    private runApiModeWithTasks;
+    private generateFiles;
+    private runPlanMode;
+}
+
+declare class CodeReviewer {
+    private provider;
+    constructor(provider: AIProvider);
+    private getGitDiff;
+    private getDiffStats;
+    reviewCode(specContent: string): Promise<string>;
+}
+
+declare const CONSTITUTION_FILE = ".ai-spec-constitution.md";
+declare class ConstitutionGenerator {
+    private provider;
+    constructor(provider: AIProvider);
+    generate(projectRoot: string): Promise<string>;
+    saveConstitution(projectRoot: string, content: string): Promise<string>;
+}
+declare function loadConstitution(projectRoot: string): Promise<string | undefined>;
+declare function printConstitutionHint(exists: boolean): void;
+
+type TaskLayer = "data" | "infra" | "service" | "api" | "test";
+type TaskPriority = "high" | "medium" | "low";
+interface SpecTask {
+    id: string;
+    title: string;
+    description: string;
+    layer: TaskLayer;
+    filesToTouch: string[];
+    acceptanceCriteria: string[];
+    dependencies: string[];
+    priority: TaskPriority;
+}
+declare class TaskGenerator {
+    private provider;
+    constructor(provider: AIProvider);
+    generateTasks(spec: string, context?: ProjectContext): Promise<SpecTask[]>;
+    saveTasks(tasks: SpecTask[], specFilePath: string): Promise<string>;
+    sortByLayer(tasks: SpecTask[]): SpecTask[];
+}
+declare function printTasks(tasks: SpecTask[]): void;
+declare function loadTasksForSpec(specFilePath: string): Promise<SpecTask[] | null>;
+
+declare class GitWorktreeManager {
+    private baseDir;
+    constructor(baseDir: string);
+    private isGitRepo;
+    private sanitizeFeatureName;
+    createWorktree(idea: string): Promise<string | null>;
+}
+
+export { type AIProvider, CONSTITUTION_FILE, ClaudeProvider, type CodeGenMode, type CodeGenOptions, CodeGenerator, CodeReviewer, ConstitutionGenerator, ContextLoader, DEFAULT_MODELS, ENV_KEY_MAP, GeminiProvider, GitWorktreeManager, OpenAICompatibleProvider, PROVIDER_CATALOG, type ProjectContext, type ProviderMeta, SUPPORTED_PROVIDERS, SpecGenerator, SpecRefiner, type SpecTask, TaskGenerator, type TaskLayer, type TaskPriority, createProvider, loadConstitution, loadTasksForSpec, printConstitutionHint, printTasks };

package/dist/index.d.ts

@@ -0,0 +1,151 @@
+import OpenAI from 'openai';
+
+interface ProjectContext {
+    techStack: string[];
+    fileStructure: string[];
+    dependencies: string[];
+    apiStructure: string[];
+    schema?: string;
+    routeSummary?: string;
+    /** Contents of .ai-spec-constitution.md if present */
+    constitution?: string;
+    /** Extracted error handling patterns from source */
+    errorPatterns?: string;
+}
+declare class ContextLoader {
+    private projectRoot;
+    constructor(projectRoot: string);
+    loadProjectContext(): Promise<ProjectContext>;
+    private loadPackageJson;
+    private loadPrismaSchema;
+    private loadFileStructure;
+    private loadConstitution;
+    private loadErrorPatterns;
+    private loadApiStructure;
+}
+
+interface AIProvider {
+    generate(prompt: string, systemInstruction?: string): Promise<string>;
+    readonly providerName: string;
+    readonly modelName: string;
+}
+interface ProviderMeta {
+    /** Human-readable display name */
+    displayName: string;
+    /** Short description shown in model picker */
+    description: string;
+    /** Available models (first is the default) */
+    models: string[];
+    /** Environment variable name for the API key */
+    envKey: string;
+    /**
+     * Base URL for OpenAI-compatible providers.
+     * Undefined means the provider has its own SDK (Gemini / Claude).
+     */
+    baseURL?: string;
+}
+declare const PROVIDER_CATALOG: Record<string, ProviderMeta>;
+declare const SUPPORTED_PROVIDERS: string[];
+declare const DEFAULT_MODELS: Record<string, string>;
+declare const ENV_KEY_MAP: Record<string, string>;
+declare class GeminiProvider implements AIProvider {
+    private genAI;
+    readonly providerName = "gemini";
+    readonly modelName: string;
+    constructor(apiKey: string, modelName?: string);
+    generate(prompt: string, systemInstruction?: string): Promise<string>;
+}
+declare class ClaudeProvider implements AIProvider {
+    private client;
+    readonly providerName = "claude";
+    readonly modelName: string;
+    constructor(apiKey: string, modelName?: string);
+    generate(prompt: string, systemInstruction?: string): Promise<string>;
+}
+declare class OpenAICompatibleProvider implements AIProvider {
+    protected client: OpenAI;
+    readonly providerName: string;
+    readonly modelName: string;
+    constructor(providerName: string, apiKey: string, modelName: string, baseURL?: string);
+    generate(prompt: string, systemInstruction?: string): Promise<string>;
+}
+declare function createProvider(providerName: string, apiKey: string, modelName?: string): AIProvider;
+declare class SpecGenerator {
+    private provider;
+    constructor(provider: AIProvider);
+    generateSpec(idea: string, context?: ProjectContext): Promise<string>;
+}
+
+declare class SpecRefiner {
+    private provider;
+    constructor(provider: AIProvider);
+    refineLoop(initialSpec: string): Promise<string>;
+}
+
+type CodeGenMode = "claude-code" | "api" | "plan";
+interface CodeGenOptions {
+    /** Run claude non-interactively via -p flag (saves tokens, good for automation) */
+    auto?: boolean;
+}
+declare class CodeGenerator {
+    private provider;
+    private mode;
+    constructor(provider: AIProvider, mode?: CodeGenMode);
+    generateCode(specFilePath: string, workingDir: string, context?: ProjectContext, options?: CodeGenOptions): Promise<void>;
+    private isClaudeCLIAvailable;
+    private runClaudeCode;
+    private runApiMode;
+    private runApiModeWithTasks;
+    private generateFiles;
+    private runPlanMode;
+}
+
+declare class CodeReviewer {
+    private provider;
+    constructor(provider: AIProvider);
+    private getGitDiff;
+    private getDiffStats;
+    reviewCode(specContent: string): Promise<string>;
+}
+
+declare const CONSTITUTION_FILE = ".ai-spec-constitution.md";
+declare class ConstitutionGenerator {
+    private provider;
+    constructor(provider: AIProvider);
+    generate(projectRoot: string): Promise<string>;
+    saveConstitution(projectRoot: string, content: string): Promise<string>;
+}
+declare function loadConstitution(projectRoot: string): Promise<string | undefined>;
+declare function printConstitutionHint(exists: boolean): void;
+
+type TaskLayer = "data" | "infra" | "service" | "api" | "test";
+type TaskPriority = "high" | "medium" | "low";
+interface SpecTask {
+    id: string;
+    title: string;
+    description: string;
+    layer: TaskLayer;
+    filesToTouch: string[];
+    acceptanceCriteria: string[];
+    dependencies: string[];
+    priority: TaskPriority;
+}
+declare class TaskGenerator {
+    private provider;
+    constructor(provider: AIProvider);
+    generateTasks(spec: string, context?: ProjectContext): Promise<SpecTask[]>;
+    saveTasks(tasks: SpecTask[], specFilePath: string): Promise<string>;
+    sortByLayer(tasks: SpecTask[]): SpecTask[];
+}
+declare function printTasks(tasks: SpecTask[]): void;
+declare function loadTasksForSpec(specFilePath: string): Promise<SpecTask[] | null>;
+
+declare class GitWorktreeManager {
+    private baseDir;
+    constructor(baseDir: string);
+    private isGitRepo;
+    private sanitizeFeatureName;
+    createWorktree(idea: string): Promise<string | null>;
+}
+
+export { type AIProvider, CONSTITUTION_FILE, ClaudeProvider, type CodeGenMode, type CodeGenOptions, CodeGenerator, CodeReviewer, ConstitutionGenerator, ContextLoader, DEFAULT_MODELS, ENV_KEY_MAP, GeminiProvider, GitWorktreeManager, OpenAICompatibleProvider, PROVIDER_CATALOG, type ProjectContext, type ProviderMeta, SUPPORTED_PROVIDERS, SpecGenerator, SpecRefiner, type SpecTask, TaskGenerator, type TaskLayer, type TaskPriority, createProvider, loadConstitution, loadTasksForSpec, printConstitutionHint, printTasks };