feature-architect-agent 1.0.0

package/dist/services/Scanner.d.ts

@@ -0,0 +1,17 @@
+import type { ScanConfig } from '../types/index.js';
+export declare class ScannerService {
+    private defaultExclude;
+    private defaultInclude;
+    scan(config?: Partial<ScanConfig>): Promise<string[]>;
+    scanWithStats(config?: Partial<ScanConfig>): Promise<{
+        files: string[];
+        stats: ScanStats;
+    }>;
+    private getLanguage;
+}
+export interface ScanStats {
+    total: number;
+    byLanguage: Record<string, number>;
+    byDirectory: Record<string, number>;
+}
+//# sourceMappingURL=Scanner.d.ts.map

package/dist/services/Scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scanner.d.ts","sourceRoot":"","sources":["../../src/services/Scanner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,qBAAa,cAAc;IACzB,OAAO,CAAC,cAAc,CAapB;IAEF,OAAO,CAAC,cAAc,CAOpB;IAEI,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiBrD,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC;IAwBjG,OAAO,CAAC,WAAW;CAWpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC"}

package/dist/services/Scanner.js

@@ -0,0 +1,75 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScannerService = void 0;
+const path_1 = __importDefault(require("path"));
+const glob_1 = require("glob");
+class ScannerService {
+    defaultExclude = [
+        'node_modules/**',
+        '.git/**',
+        'dist/**',
+        'build/**',
+        'coverage/**',
+        '.next/**',
+        'out/**',
+        '**/*.test.ts',
+        '**/*.test.js',
+        '**/*.spec.ts',
+        '**/*.spec.js',
+        '**/.*'
+    ];
+    defaultInclude = [
+        '**/*.ts',
+        '**/*.tsx',
+        '**/*.js',
+        '**/*.jsx',
+        '**/*.sql',
+        '**/*.prisma'
+    ];
+    async scan(config) {
+        const root = config?.root || process.cwd();
+        const include = config?.include || this.defaultInclude;
+        const exclude = config?.exclude || this.defaultExclude;
+        const patterns = include.map(p => `!(${exclude.map(e => e.replace(/\*\*/g, '')).join('|')})/${p}`);
+        const files = await (0, glob_1.glob)(include, {
+            cwd: root,
+            ignore: exclude,
+            absolute: true,
+            nodir: true
+        });
+        return files.sort();
+    }
+    async scanWithStats(config) {
+        const files = await this.scan(config);
+        const stats = {
+            total: files.length,
+            byLanguage: {},
+            byDirectory: {}
+        };
+        for (const file of files) {
+            const ext = path_1.default.extname(file);
+            const lang = this.getLanguage(ext);
+            stats.byLanguage[lang] = (stats.byLanguage[lang] || 0) + 1;
+            const dir = path_1.default.relative(process.cwd(), path_1.default.dirname(file));
+            const dirParts = dir.split(path_1.default.sep);
+            const topLevel = dirParts[0] || 'root';
+            stats.byDirectory[topLevel] = (stats.byDirectory[topLevel] || 0) + 1;
+        }
+        return { files, stats };
+    }
+    getLanguage(ext) {
+        const map = {
+            '.ts': 'TypeScript',
+            '.tsx': 'TypeScript React',
+            '.js': 'JavaScript',
+            '.jsx': 'JavaScript React',
+            '.sql': 'SQL',
+            '.prisma': 'Prisma'
+        };
+        return map[ext] || 'Other';
+    }
+}
+exports.ScannerService = ScannerService;

package/dist/types/index.d.ts

@@ -0,0 +1,90 @@
+export interface ScanConfig {
+    root: string;
+    include: string[];
+    exclude: string[];
+}
+export interface CodebasePatterns {
+    apiRoutes: APIRoute[];
+    databaseSchemas: DatabaseSchema[];
+    components: Component[];
+    types: TypeDefinition[];
+    utilities: Utility[];
+}
+export interface APIRoute {
+    file: string;
+    line: number;
+    method: string;
+    path: string;
+    handler: string;
+}
+export interface DatabaseSchema {
+    file: string;
+    line: number;
+    type: 'table' | 'view' | 'migration';
+    name: string;
+    definition?: string;
+}
+export interface Component {
+    file: string;
+    line: number;
+    name: string;
+    type: string;
+    props?: string;
+}
+export interface TypeDefinition {
+    file: string;
+    line: number;
+    name: string;
+    kind: 'interface' | 'type' | 'enum';
+}
+export interface Utility {
+    file: string;
+    line: number;
+    name: string;
+    exportType: 'named' | 'default';
+}
+export interface CodebaseContext {
+    project: {
+        name: string;
+        type: string;
+        root: string;
+    };
+    summary: {
+        totalFiles: number;
+        languages: Record<string, number>;
+        frameworks: string[];
+        patterns: number;
+    };
+    frameworks: {
+        backend?: string;
+        frontend?: string;
+        database?: string;
+        orm?: string;
+    };
+    patterns: CodebasePatterns;
+    metadata: {
+        version: string;
+        analyzedAt: string;
+        hash: string;
+    };
+}
+export interface FeaturePlan {
+    id: string;
+    feature: string;
+    slug: string;
+    createdAt: string;
+    markdown: string;
+}
+export interface AIConfig {
+    provider: 'claude' | 'openai' | 'gemini' | 'opencode' | 'ollama';
+    model?: string;
+    apiKey?: string;
+    endpoint?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+export interface GenerateOptions {
+    temperature?: number;
+    maxTokens?: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+// Core type definitions for Feature Architect Agent
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/logger.d.ts

@@ -0,0 +1,22 @@
+export declare const colors: {
+    reset: string;
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    gray: string;
+    bright: string;
+};
+export declare function log(message: string): void;
+export declare function info(message: string): void;
+export declare function success(message: string): void;
+export declare function warn(message: string): void;
+export declare function error(message: string): void;
+export declare function dim(message: string): void;
+export declare function header(message: string): void;
+export declare function bullet(message: string, indent?: number): void;
+export declare function check(message: string): void;
+export declare function cross(message: string): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM;;;;;;;;;;CAUlB,CAAC;AAEF,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,IAAI,CAGhE;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C"}

package/dist/utils/logger.js

@@ -0,0 +1,56 @@
+"use strict";
+// Simple logger utilities (chalk replacement for minimal dependencies)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.colors = void 0;
+exports.log = log;
+exports.info = info;
+exports.success = success;
+exports.warn = warn;
+exports.error = error;
+exports.dim = dim;
+exports.header = header;
+exports.bullet = bullet;
+exports.check = check;
+exports.cross = cross;
+exports.colors = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+    bright: '\x1b[1m'
+};
+function log(message) {
+    console.log(message);
+}
+function info(message) {
+    console.log(`${exports.colors.blue}${message}${exports.colors.reset}`);
+}
+function success(message) {
+    console.log(`${exports.colors.green}${message}${exports.colors.reset}`);
+}
+function warn(message) {
+    console.log(`${exports.colors.yellow}${message}${exports.colors.reset}`);
+}
+function error(message) {
+    console.error(`${exports.colors.red}${message}${exports.colors.reset}`);
+}
+function dim(message) {
+    console.log(`${exports.colors.gray}${message}${exports.colors.reset}`);
+}
+function header(message) {
+    console.log(`\n${exports.colors.bright}${exports.colors.cyan}${message}${exports.colors.reset}\n`);
+}
+function bullet(message, indent = 0) {
+    const prefix = '  '.repeat(indent);
+    console.log(`${prefix}${exports.colors.cyan}•${exports.colors.reset} ${message}`);
+}
+function check(message) {
+    console.log(`${exports.colors.green}✓${exports.colors.reset} ${message}`);
+}
+function cross(message) {
+    console.log(`${exports.colors.red}✗${exports.colors.reset} ${message}`);
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "feature-architect-agent",
+  "version": "1.0.0",
+  "description": "AI-powered feature planning agent - generates complete technical specifications",
+  "main": "dist/index.js",
+  "bin": {
+    "feature-architect": "./bin/feature-architect.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "src/config"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node bin/feature-architect.js",
+    "plan": "node bin/feature-architect.js plan",
+    "prepublishOnly": "npm run build",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "cli",
+    "ai",
+    "feature-planning",
+    "architecture",
+    "documentation",
+    "codebase-analysis"
+  ],
+  "author": "sahilshaikh-cyber",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^12.1.0",
+    "chalk": "^5.4.1",
+    "ora": "^8.1.1",
+    "inquirer": "^9.3.7",
+    "glob": "^11.0.0",
+    "dotenv": "^16.4.7"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "@types/inquirer": "^9.0.7",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/config/api.config.ts

@@ -0,0 +1,79 @@
+/**
+ * Built-in API Configuration for Internal Team Use
+ *
+ * This file contains the pre-configured API key for team use.
+ * The package is published to a private registry for internal team access.
+ *
+ * SECURITY: This file is included in the published package.
+ * Only publish to PRIVATE npm registries (GitHub Packages, npm private, etc.)
+ */
+
+export const API_CONFIG = {
+  /**
+   * Built-in OpenAI API Key for team use
+   * Replace with your actual team API key
+   */
+  openai: {
+    apiKey: process.env.TEAM_OPENAI_API_KEY || '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',
+    baseURL: 'https://api.openai.com/v1',
+  },
+
+  /**
+   * Built-in Anthropic API Key (optional)
+   */
+  anthropic: {
+    apiKey: process.env.TEAM_ANTHROPIC_API_KEY || '',
+    baseURL: 'https://api.anthropic.com',
+  },
+
+  /**
+   * Built-in Google API Key (optional)
+   */
+  google: {
+    apiKey: process.env.TEAM_GOOGLE_API_KEY || '',
+  },
+
+  /**
+   * Default provider to use when no user key is set
+   */
+  defaultProvider: 'openai' as const,
+};
+
+/**
+ * Get the built-in API key for a provider
+ */
+export function getBuiltinKey(provider: 'openai' | 'anthropic' | 'google'): string | undefined {
+  switch (provider) {
+    case 'openai':
+      return API_CONFIG.openai.apiKey || undefined;
+    case 'anthropic':
+      return API_CONFIG.anthropic.apiKey || undefined;
+    case 'google':
+      return API_CONFIG.google.apiKey || undefined;
+    default:
+      return undefined;
+  }
+}
+
+/**
+ * Check if a built-in key is available
+ */
+export function hasBuiltinKey(provider: 'openai' | 'anthropic' | 'google'): boolean {
+  const key = getBuiltinKey(provider);
+  return !!key && key !== '' && !key.startsWith('sk-');
+}
+
+/**
+ * Get the best available API key (user env var first, then built-in)
+ */
+export function getApiKey(provider: 'openai' | 'anthropic' | 'google'): string | undefined {
+  // First check user's environment variable
+  const userKey = process.env[`${provider.toUpperCase()}_API_KEY`];
+  if (userKey) return userKey;
+
+  // Then check generic AI_API_KEY
+  if (process.env.AI_API_KEY) return process.env.AI_API_KEY;
+
+  // Finally fall back to built-in key
+  return getBuiltinKey(provider);
+}