briefed 0.1.0

package/dist/extract/schema.js

@@ -0,0 +1,192 @@
+import { readFileSync } from "fs";
+import { join } from "path";
+import { glob } from "glob";
+/**
+ * Extract database schema from ORM definition files.
+ * Supports: Prisma, Drizzle, Django models, SQLAlchemy, TypeORM entities.
+ */
+export function extractSchemas(root) {
+    const models = [];
+    // Prisma
+    const prismaFiles = glob.sync("**/schema.prisma", { cwd: root, ignore: ["node_modules/**"] });
+    for (const f of prismaFiles) {
+        models.push(...parsePrisma(readFileSync(join(root, f), "utf-8"), f));
+    }
+    // Drizzle
+    const drizzleFiles = glob.sync("**/{schema,db}.{ts,js}", { cwd: root, ignore: ["node_modules/**", "dist/**"] });
+    for (const f of drizzleFiles) {
+        const content = readFileSync(join(root, f), "utf-8");
+        if (content.includes("pgTable") || content.includes("mysqlTable") || content.includes("sqliteTable")) {
+            models.push(...parseDrizzle(content, f));
+        }
+    }
+    // Django models
+    const djangoFiles = glob.sync("**/models.py", { cwd: root, ignore: ["venv/**", ".venv/**"] });
+    for (const f of djangoFiles) {
+        const content = readFileSync(join(root, f), "utf-8");
+        if (content.includes("models.Model")) {
+            models.push(...parseDjango(content, f));
+        }
+    }
+    // TypeORM entities
+    const typeormFiles = glob.sync("**/*.entity.{ts,js}", { cwd: root, ignore: ["node_modules/**", "dist/**"] });
+    for (const f of typeormFiles) {
+        models.push(...parseTypeORM(readFileSync(join(root, f), "utf-8"), f));
+    }
+    return models;
+}
+function parsePrisma(content, source) {
+    const models = [];
+    const modelRegex = /model\s+(\w+)\s*\{([\s\S]*?)\n\}/g;
+    for (const match of content.matchAll(modelRegex)) {
+        const name = match[1];
+        const body = match[2];
+        const fields = [];
+        const relations = [];
+        for (const line of body.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith("//") || trimmed.startsWith("@@"))
+                continue;
+            const fieldMatch = trimmed.match(/^(\w+)\s+(\w+)(\[\])?([\?!]?)\s*(.*)/);
+            if (fieldMatch) {
+                const [, fname, ftype, isArray, optional, rest] = fieldMatch;
+                const isRelation = /^[A-Z]/.test(ftype) && ftype !== "String" && ftype !== "Int" &&
+                    ftype !== "Float" && ftype !== "Boolean" && ftype !== "DateTime" &&
+                    ftype !== "Json" && ftype !== "Bytes" && ftype !== "BigInt" && ftype !== "Decimal";
+                if (isRelation) {
+                    relations.push({
+                        field: fname,
+                        target: ftype,
+                        type: isArray ? "one-to-many" : "one-to-one",
+                    });
+                }
+                else {
+                    fields.push({
+                        name: fname,
+                        type: isArray ? `${ftype}[]` : ftype,
+                        optional: optional === "?",
+                        unique: rest.includes("@unique"),
+                        default: rest.match(/@default\((.+?)\)/)?.[1] || null,
+                        isPk: rest.includes("@id"),
+                    });
+                }
+            }
+        }
+        models.push({ name, fields, relations, source });
+    }
+    return models;
+}
+function parseDrizzle(content, source) {
+    const models = [];
+    const tableRegex = /(?:export\s+const\s+)?(\w+)\s*=\s*(?:pgTable|mysqlTable|sqliteTable)\s*\(\s*['"](\w+)['"]\s*,\s*\{([\s\S]*?)\}\s*\)/g;
+    for (const match of content.matchAll(tableRegex)) {
+        const varName = match[1];
+        const tableName = match[2];
+        const body = match[3];
+        const fields = [];
+        const fieldRegex = /(\w+)\s*:\s*(\w+)\s*\(\s*['"]?(\w+)?['"]?\s*\)/g;
+        for (const fm of body.matchAll(fieldRegex)) {
+            fields.push({
+                name: fm[1],
+                type: fm[2],
+                optional: body.includes(`${fm[1]}`) && body.includes(".default("),
+                unique: false,
+                default: null,
+                isPk: fm[2] === "serial" || body.includes(`${fm[1]}`) && body.includes(".primaryKey()"),
+            });
+        }
+        models.push({ name: tableName, fields, relations: [], source });
+    }
+    return models;
+}
+function parseDjango(content, source) {
+    const models = [];
+    const classRegex = /class\s+(\w+)\s*\(.*?models\.Model.*?\)\s*:([\s\S]*?)(?=\nclass\s|\n\S|$)/g;
+    for (const match of content.matchAll(classRegex)) {
+        const name = match[1];
+        const body = match[2];
+        const fields = [];
+        const relations = [];
+        const fieldRegex = /(\w+)\s*=\s*models\.(\w+)\s*\(/g;
+        for (const fm of body.matchAll(fieldRegex)) {
+            const fieldType = fm[2];
+            if (["ForeignKey", "OneToOneField", "ManyToManyField"].includes(fieldType)) {
+                const targetMatch = body.slice(fm.index).match(/models\.\w+\(\s*['"]?(\w+)/);
+                relations.push({
+                    field: fm[1],
+                    target: targetMatch?.[1] || "unknown",
+                    type: fieldType === "ManyToManyField" ? "many-to-many" : fieldType === "OneToOneField" ? "one-to-one" : "one-to-many",
+                });
+            }
+            else {
+                fields.push({
+                    name: fm[1],
+                    type: fieldType,
+                    optional: body.includes("null=True") || body.includes("blank=True"),
+                    unique: body.includes("unique=True"),
+                    default: null,
+                    isPk: fieldType === "AutoField" || fm[1] === "id",
+                });
+            }
+        }
+        models.push({ name, fields, relations, source });
+    }
+    return models;
+}
+function parseTypeORM(content, source) {
+    const models = [];
+    const classMatch = content.match(/class\s+(\w+)/);
+    if (!classMatch)
+        return models;
+    const name = classMatch[1];
+    const fields = [];
+    const relations = [];
+    const colRegex = /@(?:Column|PrimaryGeneratedColumn|PrimaryColumn)\s*\(([^)]*)\)\s*\n\s*(\w+)\s*[!?]?\s*:\s*(\w+)/g;
+    for (const m of content.matchAll(colRegex)) {
+        fields.push({
+            name: m[2],
+            type: m[3],
+            optional: m[0].includes("nullable: true"),
+            unique: m[0].includes("unique: true"),
+            default: null,
+            isPk: m[0].includes("PrimaryGeneratedColumn") || m[0].includes("PrimaryColumn"),
+        });
+    }
+    const relRegex = /@(?:ManyToOne|OneToMany|OneToOne|ManyToMany)\s*\([^)]*\)\s*\n\s*(\w+)\s*[!?]?\s*:\s*(\w+)/g;
+    for (const m of content.matchAll(relRegex)) {
+        const relType = m[0].includes("ManyToMany") ? "many-to-many" : m[0].includes("OneToMany") ? "one-to-many" : "one-to-one";
+        relations.push({ field: m[1], target: m[2], type: relType });
+    }
+    models.push({ name, fields, relations, source });
+    return models;
+}
+/**
+ * Format schemas for skeleton inclusion.
+ */
+export function formatSchemas(models) {
+    if (models.length === 0)
+        return "";
+    const lines = ["Database schema:"];
+    for (const m of models) {
+        const fieldList = m.fields
+            .map((f) => {
+            let s = `${f.name}: ${f.type}`;
+            if (f.isPk)
+                s += " (pk)";
+            if (f.unique)
+                s += " (unique)";
+            if (f.optional)
+                s += "?";
+            if (f.default)
+                s += ` = ${f.default}`;
+            return s;
+        })
+            .join(", ");
+        const relList = m.relations
+            .map((r) => `${r.field} → ${r.target} (${r.type})`)
+            .join(", ");
+        lines.push(`  ${m.name}: ${fieldList}${relList ? ` | ${relList}` : ""}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=schema.js.map

package/dist/extract/schema.js.map

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

package/dist/extract/scripts.d.ts

@@ -0,0 +1,18 @@
+export interface ProjectScripts {
+    build: string | null;
+    dev: string | null;
+    test: string | null;
+    lint: string | null;
+    start: string | null;
+    deploy: string | null;
+    other: Record<string, string>;
+}
+/**
+ * Extract build/test/dev commands from package.json, Makefile, etc.
+ * Claude needs to know how to run things.
+ */
+export declare function extractScripts(root: string): ProjectScripts;
+/**
+ * Format scripts for skeleton inclusion.
+ */
+export declare function formatScripts(scripts: ProjectScripts): string;

package/dist/extract/scripts.js

@@ -0,0 +1,104 @@
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+/**
+ * Extract build/test/dev commands from package.json, Makefile, etc.
+ * Claude needs to know how to run things.
+ */
+export function extractScripts(root) {
+    const scripts = {
+        build: null,
+        dev: null,
+        test: null,
+        lint: null,
+        start: null,
+        deploy: null,
+        other: {},
+    };
+    // package.json
+    const pkgPath = join(root, "package.json");
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+            const s = pkg.scripts || {};
+            scripts.build = s.build || null;
+            scripts.dev = s.dev || s.serve || s.start?.includes("--watch") ? (s.dev || s.serve) : null;
+            scripts.test = s.test || s["test:unit"] || null;
+            scripts.lint = s.lint || s["lint:fix"] || null;
+            scripts.start = s.start || null;
+            scripts.deploy = s.deploy || s.release || null;
+            // Collect other interesting scripts
+            for (const [name, cmd] of Object.entries(s)) {
+                if (["build", "dev", "test", "lint", "start", "deploy", "serve", "postinstall", "prepare", "precommit"].includes(name))
+                    continue;
+                if (typeof cmd === "string" && name.length < 20) {
+                    scripts.other[name] = cmd;
+                }
+            }
+        }
+        catch { /* skip */ }
+    }
+    // Makefile
+    const makefilePath = join(root, "Makefile");
+    if (existsSync(makefilePath)) {
+        try {
+            const content = readFileSync(makefilePath, "utf-8");
+            const targets = content.matchAll(/^(\w[\w-]*)\s*:/gm);
+            for (const match of targets) {
+                const target = match[1];
+                if (target === "build" && !scripts.build)
+                    scripts.build = `make build`;
+                if (target === "test" && !scripts.test)
+                    scripts.test = `make test`;
+                if (target === "dev" && !scripts.dev)
+                    scripts.dev = `make dev`;
+                if (target === "lint" && !scripts.lint)
+                    scripts.lint = `make lint`;
+                if (target === "deploy" && !scripts.deploy)
+                    scripts.deploy = `make deploy`;
+            }
+        }
+        catch { /* skip */ }
+    }
+    // Go
+    if (existsSync(join(root, "go.mod"))) {
+        if (!scripts.build)
+            scripts.build = "go build ./...";
+        if (!scripts.test)
+            scripts.test = "go test ./...";
+    }
+    // Rust
+    if (existsSync(join(root, "Cargo.toml"))) {
+        if (!scripts.build)
+            scripts.build = "cargo build";
+        if (!scripts.test)
+            scripts.test = "cargo test";
+    }
+    // Python
+    if (existsSync(join(root, "pyproject.toml"))) {
+        if (!scripts.test)
+            scripts.test = "pytest";
+    }
+    return scripts;
+}
+/**
+ * Format scripts for skeleton inclusion.
+ */
+export function formatScripts(scripts) {
+    const lines = ["Commands:"];
+    if (scripts.build)
+        lines.push(`  build: ${scripts.build}`);
+    if (scripts.dev)
+        lines.push(`  dev: ${scripts.dev}`);
+    if (scripts.test)
+        lines.push(`  test: ${scripts.test}`);
+    if (scripts.lint)
+        lines.push(`  lint: ${scripts.lint}`);
+    if (scripts.start)
+        lines.push(`  start: ${scripts.start}`);
+    if (scripts.deploy)
+        lines.push(`  deploy: ${scripts.deploy}`);
+    if (lines.length === 1)
+        return ""; // no scripts found
+    return lines.join("\n");
+}
+//# sourceMappingURL=scripts.js.map

package/dist/extract/scripts.js.map

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

package/dist/extract/security.d.ts

@@ -0,0 +1,20 @@
+export interface SecurityWarning {
+    file: string;
+    line: number;
+    type: SecurityIssueType;
+    detail: string;
+}
+export type SecurityIssueType = "api_key" | "password" | "secret" | "private_key" | "connection_string" | "token" | "sensitive_file";
+/**
+ * Check if a file should be excluded from context output for security reasons.
+ */
+export declare function isSensitiveFile(filePath: string): boolean;
+/**
+ * Scan a file for sensitive data patterns.
+ * Returns warnings but does NOT include the actual secret values.
+ */
+export declare function scanForSecrets(filePath: string): SecurityWarning[];
+/**
+ * Redact sensitive values from text before including in context.
+ */
+export declare function redactSecrets(text: string): string;

package/dist/extract/security.js

@@ -0,0 +1,95 @@
+import { readFileSync } from "fs";
+import { basename } from "path";
+/** Files that should NEVER be included in context output */
+const SENSITIVE_FILENAMES = new Set([
+    ".env",
+    ".env.local",
+    ".env.production",
+    ".env.development",
+    "credentials.json",
+    "service-account.json",
+    "secrets.yaml",
+    "secrets.yml",
+    ".npmrc",
+    ".pypirc",
+    "id_rsa",
+    "id_ed25519",
+    ".pem",
+    ".key",
+]);
+/** Patterns that indicate sensitive values in code */
+const SECRET_PATTERNS = [
+    { regex: /(?:api[_-]?key|apikey)\s*[:=]\s*['"][^'"]{8,}/i, type: "api_key", label: "API key" },
+    { regex: /(?:password|passwd|pwd)\s*[:=]\s*['"][^'"]+/i, type: "password", label: "password" },
+    { regex: /(?:secret|client_secret)\s*[:=]\s*['"][^'"]{8,}/i, type: "secret", label: "secret" },
+    { regex: /-----BEGIN (?:RSA |EC |DSA )?PRIVATE KEY-----/i, type: "private_key", label: "private key" },
+    { regex: /(?:postgres|mysql|mongodb|redis):\/\/\w+:[^@]+@/i, type: "connection_string", label: "connection string with credentials" },
+    { regex: /(?:bearer|token)\s+[a-zA-Z0-9_\-.]{20,}/i, type: "token", label: "auth token" },
+    { regex: /(?:aws_secret_access_key|AWS_SECRET)\s*[:=]\s*['"]?[A-Za-z0-9/+=]{20,}/i, type: "secret", label: "AWS secret key" },
+    { regex: /(?:ghp_|github_pat_)[a-zA-Z0-9]{30,}/i, type: "token", label: "GitHub token" },
+    { regex: /sk-[a-zA-Z0-9]{20,}/i, type: "api_key", label: "OpenAI/Stripe secret key" },
+];
+/**
+ * Check if a file should be excluded from context output for security reasons.
+ */
+export function isSensitiveFile(filePath) {
+    const name = basename(filePath);
+    if (SENSITIVE_FILENAMES.has(name))
+        return true;
+    if (name.endsWith(".pem") || name.endsWith(".key") || name.endsWith(".p12"))
+        return true;
+    if (name.startsWith(".env"))
+        return true;
+    return false;
+}
+/**
+ * Scan a file for sensitive data patterns.
+ * Returns warnings but does NOT include the actual secret values.
+ */
+export function scanForSecrets(filePath) {
+    const warnings = [];
+    // Skip binary files
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Skip comments that reference secrets generically
+            if (line.trim().startsWith("//") || line.trim().startsWith("#")) {
+                // Still check for actual hardcoded values in comments
+                if (!line.includes("=") && !line.includes(":"))
+                    continue;
+            }
+            for (const pattern of SECRET_PATTERNS) {
+                if (pattern.regex.test(line)) {
+                    // Don't flag env var references (process.env.X, os.environ, etc.)
+                    if (line.includes("process.env") || line.includes("os.environ") ||
+                        line.includes("${") || line.includes("getenv")) {
+                        continue;
+                    }
+                    warnings.push({
+                        file: filePath,
+                        line: i + 1,
+                        type: pattern.type,
+                        detail: `Possible ${pattern.label} found — not included in context output`,
+                    });
+                }
+            }
+        }
+    }
+    catch {
+        // Can't read file — skip
+    }
+    return warnings;
+}
+/**
+ * Redact sensitive values from text before including in context.
+ */
+export function redactSecrets(text) {
+    let result = text;
+    for (const pattern of SECRET_PATTERNS) {
+        result = result.replace(pattern.regex, `[REDACTED ${pattern.label}]`);
+    }
+    return result;
+}
+//# sourceMappingURL=security.js.map

package/dist/extract/security.js.map

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

package/dist/extract/signatures.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Extracted symbol from a source file.
+ * Represents exports, functions, classes, types — the structural skeleton.
+ */
+export interface Symbol {
+    name: string;
+    kind: SymbolKind;
+    signature: string;
+    description: string | null;
+    exported: boolean;
+    line: number;
+}
+export type SymbolKind = "function" | "class" | "interface" | "type" | "enum" | "variable" | "method" | "component" | "route" | "unknown";
+/**
+ * Import reference found in a file.
+ */
+export interface ImportRef {
+    source: string;
+    names: string[];
+    isRelative: boolean;
+}
+export interface FileExtraction {
+    path: string;
+    symbols: Symbol[];
+    imports: ImportRef[];
+    lineCount: number;
+}
+/**
+ * Extract symbols and imports from a source file.
+ * Uses regex-based extraction (fast, no WASM dependency).
+ * Covers TypeScript, JavaScript, Python, Go, Rust, Java.
+ */
+export declare function extractFile(filePath: string, rootPath: string): FileExtraction;