briefed 0.1.0

package/dist/extract/env.d.ts

@@ -0,0 +1,17 @@
+export interface EnvVar {
+    name: string;
+    source: string;
+    hasDefault: boolean;
+    required: boolean;
+    description: string | null;
+    category: string;
+}
+/**
+ * Extract environment variables the project expects.
+ * Sources: .env.example, .env.sample, process.env references, config files.
+ */
+export declare function extractEnvVars(root: string): EnvVar[];
+/**
+ * Format env vars for skeleton inclusion.
+ */
+export declare function formatEnvVars(vars: EnvVar[]): string;

package/dist/extract/env.js

@@ -0,0 +1,142 @@
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+import { glob } from "glob";
+/**
+ * Extract environment variables the project expects.
+ * Sources: .env.example, .env.sample, process.env references, config files.
+ */
+export function extractEnvVars(root) {
+    const vars = new Map();
+    // 1. Parse .env.example / .env.sample
+    const envFiles = [".env.example", ".env.sample", ".env.template", ".env.defaults"];
+    for (const ef of envFiles) {
+        const path = join(root, ef);
+        if (existsSync(path)) {
+            parseEnvFile(readFileSync(path, "utf-8"), ef, vars);
+        }
+    }
+    // 2. Scan source files for process.env / os.environ references
+    const sourceFiles = glob.sync("**/*.{ts,tsx,js,jsx,py}", {
+        cwd: root,
+        ignore: ["node_modules/**", "dist/**", "venv/**", ".venv/**", "test/**", "*.test.*"],
+    });
+    for (const f of sourceFiles) {
+        let content;
+        try {
+            content = readFileSync(join(root, f), "utf-8");
+        }
+        catch {
+            continue;
+        }
+        // JavaScript/TypeScript: process.env.VAR_NAME
+        const jsEnvRegex = /process\.env\.(\w+)/g;
+        for (const match of content.matchAll(jsEnvRegex)) {
+            addVar(vars, match[1], f, false);
+        }
+        // JavaScript/TypeScript: process.env['VAR_NAME'] or process.env["VAR_NAME"]
+        const jsEnvBracket = /process\.env\[['"](\w+)['"]\]/g;
+        for (const match of content.matchAll(jsEnvBracket)) {
+            addVar(vars, match[1], f, false);
+        }
+        // Python: os.environ['VAR'] or os.environ.get('VAR') or os.getenv('VAR')
+        const pyEnvRegex = /(?:os\.environ\[['"](\w+)['"]\]|os\.environ\.get\(\s*['"](\w+)['"]|os\.getenv\(\s*['"](\w+)['"])/g;
+        for (const match of content.matchAll(pyEnvRegex)) {
+            const name = match[1] || match[2] || match[3];
+            addVar(vars, name, f, match[0].includes(".get(") || match[0].includes("getenv"));
+        }
+    }
+    // 3. Check config files (next.config, vite.config, etc.)
+    const configFiles = glob.sync("{next,vite,nuxt,astro}.config.{ts,js,mjs}", { cwd: root });
+    for (const f of configFiles) {
+        try {
+            const content = readFileSync(join(root, f), "utf-8");
+            const envRefs = content.matchAll(/process\.env\.(\w+)/g);
+            for (const match of envRefs) {
+                addVar(vars, match[1], f, false);
+            }
+        }
+        catch { /* skip */ }
+    }
+    return [...vars.values()];
+}
+function parseEnvFile(content, source, vars) {
+    let lastComment = "";
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("#")) {
+            lastComment = trimmed.slice(1).trim();
+            continue;
+        }
+        const match = trimmed.match(/^(\w+)\s*=\s*(.*)/);
+        if (match) {
+            const name = match[1];
+            const value = match[2].trim();
+            const hasDefault = value.length > 0 && value !== '""' && value !== "''";
+            vars.set(name, {
+                name,
+                source,
+                hasDefault,
+                required: !hasDefault,
+                description: lastComment || null,
+                category: categorizeEnvVar(name),
+            });
+            lastComment = "";
+        }
+    }
+}
+function addVar(vars, name, source, hasDefault) {
+    if (vars.has(name))
+        return; // .env.example takes precedence
+    // Skip common Node/system vars
+    if (["NODE_ENV", "PATH", "HOME", "USER", "PWD", "SHELL", "TERM"].includes(name))
+        return;
+    vars.set(name, {
+        name,
+        source,
+        hasDefault,
+        required: !hasDefault,
+        description: null,
+        category: categorizeEnvVar(name),
+    });
+}
+function categorizeEnvVar(name) {
+    const n = name.toUpperCase();
+    if (n.includes("DATABASE") || n.includes("DB_") || n.includes("POSTGRES") ||
+        n.includes("MYSQL") || n.includes("MONGO") || n.includes("REDIS"))
+        return "database";
+    if (n.includes("AUTH") || n.includes("JWT") || n.includes("SESSION") ||
+        n.includes("SECRET") || n.includes("OAUTH") || n.includes("TOKEN"))
+        return "auth";
+    if (n.includes("API") || n.includes("URL") || n.includes("ENDPOINT") ||
+        n.includes("HOST") || n.includes("PORT"))
+        return "api";
+    if (n.includes("AWS") || n.includes("S3") || n.includes("CLOUD") ||
+        n.includes("STRIPE") || n.includes("SENDGRID") || n.includes("TWILIO"))
+        return "services";
+    return "config";
+}
+/**
+ * Format env vars for skeleton inclusion.
+ */
+export function formatEnvVars(vars) {
+    if (vars.length === 0)
+        return "";
+    const lines = ["Environment variables:"];
+    const byCategory = new Map();
+    for (const v of vars) {
+        if (!byCategory.has(v.category))
+            byCategory.set(v.category, []);
+        byCategory.get(v.category).push(v);
+    }
+    for (const [cat, catVars] of byCategory) {
+        const names = catVars.map((v) => {
+            let s = v.name;
+            if (v.required)
+                s += " (required)";
+            return s;
+        });
+        lines.push(`  ${cat}: ${names.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=env.js.map

package/dist/extract/env.js.map

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

package/dist/extract/error-patterns.d.ts

@@ -0,0 +1,15 @@
+export interface ErrorPattern {
+    file: string;
+    pattern: ErrorPatternType;
+    detail: string;
+}
+export type ErrorPatternType = "try_catch_style" | "error_class" | "result_type" | "guard_return" | "error_propagation" | "validation_style";
+/**
+ * Detect the project's error handling patterns.
+ * Research shows AI generates 2x more error handling bugs — knowing the project's
+ * patterns prevents silent failures and inconsistent error handling.
+ */
+export declare function detectErrorPatterns(filePaths: string[]): {
+    patterns: ErrorPattern[];
+    summary: string[];
+};

package/dist/extract/error-patterns.js

@@ -0,0 +1,107 @@
+import { readFileSync } from "fs";
+import { extname } from "path";
+/**
+ * Detect the project's error handling patterns.
+ * Research shows AI generates 2x more error handling bugs — knowing the project's
+ * patterns prevents silent failures and inconsistent error handling.
+ */
+export function detectErrorPatterns(filePaths) {
+    const patterns = [];
+    const stats = {
+        tryCatch: 0,
+        customErrors: 0,
+        resultTypes: 0,
+        guardReturns: 0,
+        throws: 0,
+        zodValidation: 0,
+        manualValidation: 0,
+        filesScanned: 0,
+    };
+    for (const filePath of filePaths) {
+        const ext = extname(filePath);
+        if (![".ts", ".tsx", ".js", ".jsx", ".py", ".go", ".rs"].includes(ext))
+            continue;
+        let content;
+        try {
+            content = readFileSync(filePath, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        stats.filesScanned++;
+        // Custom error classes
+        const customErrorMatch = content.match(/class\s+(\w+Error)\s+extends\s+(\w+Error|Error)/g);
+        if (customErrorMatch) {
+            stats.customErrors += customErrorMatch.length;
+            for (const m of customErrorMatch) {
+                const nameMatch = m.match(/class\s+(\w+)/);
+                if (nameMatch) {
+                    patterns.push({
+                        file: filePath,
+                        pattern: "error_class",
+                        detail: nameMatch[1],
+                    });
+                }
+            }
+        }
+        // Result/Either types
+        if (content.includes("Result<") || content.includes("Either<") ||
+            content.includes("Result[") || content.includes("-> Result")) {
+            stats.resultTypes++;
+            patterns.push({
+                file: filePath,
+                pattern: "result_type",
+                detail: "Uses Result/Either type for error propagation",
+            });
+        }
+        // try/catch patterns
+        const tryCatchCount = (content.match(/\btry\s*\{/g) || []).length;
+        stats.tryCatch += tryCatchCount;
+        // Guard clause returns (early return on validation failure)
+        const guardMatches = content.match(/if\s*\([^)]*\)\s*(?:return|throw|raise)\b/g);
+        if (guardMatches) {
+            stats.guardReturns += guardMatches.length;
+        }
+        // throw new / raise patterns
+        const throwCount = (content.match(/throw\s+new\s+\w+/g) || []).length;
+        const raiseCount = (content.match(/raise\s+\w+/g) || []).length;
+        stats.throws += throwCount + raiseCount;
+        // Zod/Joi/Yup validation
+        if (content.includes(".parse(") || content.includes(".safeParse(") ||
+            content.includes("z.object(") || content.includes("Joi.object(") ||
+            content.includes("yup.object(")) {
+            stats.zodValidation++;
+        }
+        // Manual validation (typeof checks, instanceof)
+        const manualChecks = (content.match(/typeof\s+\w+\s*[!=]==?\s*['"]|instanceof\s+\w+/g) || []).length;
+        if (manualChecks > 3) {
+            stats.manualValidation++;
+        }
+    }
+    // Generate summary of detected patterns
+    const summary = [];
+    if (stats.customErrors > 0) {
+        const names = [...new Set(patterns.filter((p) => p.pattern === "error_class").map((p) => p.detail))];
+        summary.push(`Custom error classes: ${names.slice(0, 5).join(", ")}${names.length > 5 ? ` +${names.length - 5} more` : ""}`);
+    }
+    if (stats.resultTypes > 0) {
+        summary.push("Uses Result/Either types for error propagation (not exceptions)");
+    }
+    if (stats.tryCatch > stats.throws * 2 && stats.tryCatch > 5) {
+        summary.push("Prefers try/catch wrapping over throwing");
+    }
+    else if (stats.throws > stats.tryCatch && stats.throws > 3) {
+        summary.push("Throws errors to callers (expects upstream catch)");
+    }
+    if (stats.guardReturns > 5) {
+        summary.push("Uses guard clauses (early returns on validation failure)");
+    }
+    if (stats.zodValidation > 0) {
+        summary.push("Uses schema validation (Zod/Joi/Yup) for input validation");
+    }
+    else if (stats.manualValidation > 3) {
+        summary.push("Uses manual type checking for validation (typeof/instanceof)");
+    }
+    return { patterns, summary };
+}
+//# sourceMappingURL=error-patterns.js.map

package/dist/extract/error-patterns.js.map

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

package/dist/extract/frontend.d.ts

@@ -0,0 +1,30 @@
+export interface PageRoute {
+    path: string;
+    file: string;
+    layout: string | null;
+    isProtected: boolean;
+}
+export interface ComponentInfo {
+    name: string;
+    file: string;
+    props: string[];
+    children: boolean;
+    hooks: string[];
+    stateManagement: string[];
+}
+export interface FrontendInfo {
+    framework: string | null;
+    pages: PageRoute[];
+    components: ComponentInfo[];
+    stateStores: string[];
+    styling: string | null;
+    uiLibrary: string | null;
+}
+/**
+ * Extract frontend-specific context: pages, components, state, styling.
+ */
+export declare function extractFrontend(root: string): FrontendInfo;
+/**
+ * Format frontend info for skeleton inclusion.
+ */
+export declare function formatFrontend(info: FrontendInfo): string;

package/dist/extract/frontend.js

@@ -0,0 +1,244 @@
+import { readFileSync } from "fs";
+import { glob } from "glob";
+import { join, basename, dirname, extname } from "path";
+/**
+ * Extract frontend-specific context: pages, components, state, styling.
+ */
+export function extractFrontend(root) {
+    const info = {
+        framework: null,
+        pages: [],
+        components: [],
+        stateStores: [],
+        styling: null,
+        uiLibrary: null,
+    };
+    // Detect framework + styling + UI library from package.json
+    const pkgPath = join(root, "package.json");
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+        if (deps["next"])
+            info.framework = "next";
+        else if (deps["nuxt"])
+            info.framework = "nuxt";
+        else if (deps["@sveltejs/kit"])
+            info.framework = "sveltekit";
+        else if (deps["svelte"])
+            info.framework = "svelte";
+        else if (deps["vue"])
+            info.framework = "vue";
+        else if (deps["react"])
+            info.framework = "react";
+        else if (deps["@angular/core"])
+            info.framework = "angular";
+        if (deps["tailwindcss"])
+            info.styling = "tailwind";
+        else if (deps["styled-components"])
+            info.styling = "styled-components";
+        else if (deps["sass"] || deps["node-sass"])
+            info.styling = "scss";
+        else if (deps["@emotion/react"])
+            info.styling = "emotion";
+        if (deps["@shadcn/ui"] || deps["class-variance-authority"])
+            info.uiLibrary = "shadcn";
+        else if (deps["@mui/material"])
+            info.uiLibrary = "mui";
+        else if (deps["@chakra-ui/react"])
+            info.uiLibrary = "chakra";
+        else if (deps["@radix-ui/react-dialog"])
+            info.uiLibrary = "radix";
+        else if (deps["antd"])
+            info.uiLibrary = "antd";
+    }
+    catch { /* not a JS project */ }
+    // Extract pages
+    info.pages = extractPages(root, info.framework);
+    // Extract components
+    info.components = extractComponents(root);
+    // Extract state stores
+    info.stateStores = extractStateStores(root);
+    return info;
+}
+function extractPages(root, framework) {
+    const pages = [];
+    if (framework === "next") {
+        // Next.js App Router pages
+        const appPages = glob.sync("{src/app,app}/**/page.{tsx,jsx,ts,js}", { cwd: root });
+        for (const f of appPages) {
+            const path = "/" + dirname(f).replace(/^(?:src\/)?app\/?/, "").replace(/\(.*?\)\/?/g, "");
+            const content = tryRead(join(root, f));
+            const layoutFile = findLayout(root, f);
+            const isProtected = content?.includes("auth") || content?.includes("session") ||
+                content?.includes("getServerSession") || content?.includes("redirect") || false;
+            pages.push({
+                path: path || "/",
+                file: f,
+                layout: layoutFile,
+                isProtected,
+            });
+        }
+        // Next.js Pages Router
+        const pagesDir = glob.sync("pages/**/*.{tsx,jsx,ts,js}", {
+            cwd: root,
+            ignore: ["pages/api/**", "pages/_*"],
+        });
+        for (const f of pagesDir) {
+            const path = "/" + f.replace(/^pages\//, "").replace(/\.\w+$/, "").replace(/\/index$/, "");
+            pages.push({ path: path || "/", file: f, layout: null, isProtected: false });
+        }
+    }
+    if (framework === "vue" || framework === "nuxt") {
+        const vuePages = glob.sync("{pages,src/pages,src/views}/**/*.vue", { cwd: root });
+        for (const f of vuePages) {
+            const path = "/" + f.replace(/^(?:src\/)?(?:pages|views)\//, "").replace(/\.vue$/, "").replace(/\/index$/, "");
+            pages.push({ path, file: f, layout: null, isProtected: false });
+        }
+    }
+    if (framework === "sveltekit" || framework === "svelte") {
+        const sveltePages = glob.sync("src/routes/**/+page.svelte", { cwd: root });
+        for (const f of sveltePages) {
+            const path = "/" + dirname(f).replace(/^src\/routes\/?/, "").replace(/\(.*?\)\/?/g, "");
+            pages.push({ path: path || "/", file: f, layout: null, isProtected: false });
+        }
+    }
+    return pages;
+}
+function extractComponents(root) {
+    const components = [];
+    const componentFiles = glob.sync("{src/components,components,src/ui,app/components}/**/*.{tsx,jsx,vue,svelte}", {
+        cwd: root,
+        ignore: ["node_modules/**", "*.test.*", "*.spec.*", "*.stories.*"],
+    });
+    for (const f of componentFiles.slice(0, 50)) { // limit to 50
+        const content = tryRead(join(root, f));
+        if (!content)
+            continue;
+        const name = basename(f, extname(f));
+        const ext = extname(f);
+        const props = [];
+        const hooks = [];
+        let children = false;
+        if ([".tsx", ".jsx"].includes(ext)) {
+            // React props
+            const propsMatch = content.match(/(?:interface|type)\s+\w*Props\w*\s*(?:=\s*)?{([^}]*)}/);
+            if (propsMatch) {
+                const propLines = propsMatch[1].matchAll(/(\w+)\s*[?:]?\s*:/g);
+                for (const p of propLines)
+                    props.push(p[1]);
+                if (propsMatch[1].includes("children"))
+                    children = true;
+            }
+            // React hooks
+            const hookMatches = content.matchAll(/\buse(\w+)\s*\(/g);
+            for (const h of hookMatches) {
+                const hookName = `use${h[1]}`;
+                if (!hooks.includes(hookName))
+                    hooks.push(hookName);
+            }
+        }
+        if (ext === ".vue") {
+            // Vue props
+            const vueProps = content.matchAll(/(\w+)\s*:\s*{\s*type:\s*(\w+)/g);
+            for (const p of vueProps)
+                props.push(p[1]);
+        }
+        components.push({
+            name,
+            file: f,
+            props: props.slice(0, 10),
+            children,
+            hooks: hooks.slice(0, 8),
+            stateManagement: [],
+        });
+    }
+    return components;
+}
+function extractStateStores(root) {
+    const stores = [];
+    // Zustand stores
+    const zustandFiles = glob.sync("**/*.{ts,tsx,js,jsx}", {
+        cwd: root,
+        ignore: ["node_modules/**", "dist/**"],
+    });
+    for (const f of zustandFiles) {
+        const content = tryRead(join(root, f));
+        if (!content)
+            continue;
+        if (content.includes("create(") && (content.includes("zustand") || content.includes("from 'zustand'"))) {
+            const nameMatch = content.match(/export\s+(?:const|let)\s+use(\w+)/);
+            if (nameMatch)
+                stores.push(`zustand:use${nameMatch[1]}`);
+        }
+        // Redux slices
+        if (content.includes("createSlice(")) {
+            const nameMatch = content.match(/name:\s*['"](\w+)['"]/);
+            if (nameMatch)
+                stores.push(`redux:${nameMatch[1]}`);
+        }
+        // React Context
+        if (content.includes("createContext(")) {
+            const nameMatch = content.match(/(?:export\s+)?const\s+(\w+Context)\s*=/);
+            if (nameMatch)
+                stores.push(`context:${nameMatch[1]}`);
+        }
+    }
+    return stores;
+}
+function findLayout(root, pageFile) {
+    let dir = dirname(join(root, pageFile));
+    while (dir.includes("app")) {
+        const layoutFile = glob.sync("layout.{tsx,jsx,ts,js}", { cwd: dir });
+        if (layoutFile.length > 0)
+            return join(dir, layoutFile[0]).replace(root + "/", "").replace(root + "\\", "");
+        dir = dirname(dir);
+    }
+    return null;
+}
+function tryRead(path) {
+    try {
+        return readFileSync(path, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Format frontend info for skeleton inclusion.
+ */
+export function formatFrontend(info) {
+    const lines = [];
+    if (info.framework) {
+        let header = `Frontend: ${info.framework}`;
+        if (info.styling)
+            header += ` + ${info.styling}`;
+        if (info.uiLibrary)
+            header += ` + ${info.uiLibrary}`;
+        lines.push(header);
+    }
+    if (info.pages.length > 0) {
+        lines.push("Pages:");
+        for (const p of info.pages.slice(0, 20)) {
+            let line = `  ${p.path}`;
+            if (p.isProtected)
+                line += " (auth)";
+            lines.push(line);
+        }
+        if (info.pages.length > 20)
+            lines.push(`  ... +${info.pages.length - 20} more`);
+    }
+    if (info.components.length > 0) {
+        lines.push(`Components: ${info.components.length} in total`);
+        const withProps = info.components.filter((c) => c.props.length > 0).slice(0, 10);
+        for (const c of withProps) {
+            lines.push(`  <${c.name}> props: ${c.props.join(", ")}`);
+        }
+    }
+    if (info.stateStores.length > 0) {
+        lines.push(`State: ${info.stateStores.join(", ")}`);
+    }
+    if (lines.length === 0)
+        return "";
+    return lines.join("\n");
+}
+//# sourceMappingURL=frontend.js.map

package/dist/extract/frontend.js.map

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

package/dist/extract/gotchas.d.ts

@@ -0,0 +1,12 @@
+export interface Gotcha {
+    file: string;
+    line: number;
+    category: GotchaCategory;
+    text: string;
+}
+export type GotchaCategory = "important_comment" | "guard_clause" | "state_transition" | "ordering_dep" | "side_effect" | "soft_delete" | "unique_constraint" | "cross_entity_read";
+/**
+ * Extract gotchas from a source file.
+ * These are non-obvious constraints that cause bugs when AI misses them.
+ */
+export declare function extractGotchas(filePath: string): Gotcha[];