codesift-mcp 0.9.0 → 0.9.10

package/dist/tools/pg-introspection.d.ts

@@ -0,0 +1,90 @@
+/** Minimal subset of the pg Client API we actually use. */
+export interface PgClientLike {
+    connect(): Promise<void>;
+    query(sql: string, params?: unknown[]): Promise<{
+        rows: Record<string, unknown>[];
+    }>;
+    end(): Promise<void>;
+}
+/** Success shape: the Client constructor wrapped in a plain object. */
+export interface PgClientCtor {
+    ClientCtor: new (cfg: {
+        connectionString: string;
+        connectionTimeoutMillis: number;
+    }) => PgClientLike;
+}
+/** Error shape returned when pg is absent or the import fails. */
+export interface PgLoadError {
+    error: string;
+}
+export declare function loadPgClient(): Promise<PgClientCtor | PgLoadError>;
+/** A column as seen by live PG introspection. */
+export interface PgColumn {
+    name: string;
+    type: string;
+    nullable: boolean;
+}
+/** A table as seen by live PG introspection. */
+export interface PgTableInfo {
+    name: string;
+    columns: PgColumn[];
+    primary_key: string[];
+    indexes: string[];
+}
+/** A foreign-key relationship as seen by live PG introspection. */
+export interface PgRelationship {
+    from_table: string;
+    from_column: string;
+    to_table: string;
+    to_column: string;
+}
+/** Result of a successful (or partially successful) introspection. */
+export interface PgIntrospectResult {
+    tables: PgTableInfo[];
+    relationships: PgRelationship[];
+    warnings: string[];
+}
+/** Structured error shape — never leaks the connection string. */
+export interface PgIntrospectError {
+    error: string;
+}
+export interface IntrospectPgOptions {
+    schema?: string;
+    timeoutMs?: number;
+    /**
+     * Test seam: inject a Client constructor instead of loading the real `pg`
+     * module. Production callers omit this — the real `pg` Client is loaded via
+     * {@link loadPgClient}. Underscore-prefixed to signal "internal / test only".
+     * The `pg` dynamic import uses a runtime string specifier with `@vite-ignore`,
+     * which bypasses Vite/vitest module mocking, so DI is the only deterministic
+     * way to drive a vi.fn-controlled Client through the production code path.
+     */
+    _clientCtor?: PgClientCtor["ClientCtor"];
+}
+/**
+ * Replace every occurrence of the connection string — and, separately, its
+ * password component — with "[REDACTED]" inside arbitrary text.
+ *
+ * Why password-separately: a thrown driver error often echoes only the host
+ * portion or a re-assembled URL with the password but a different surrounding
+ * shape, so a single full-string replace can miss the secret. Parsing the URL
+ * and replacing the password token independently closes that gap.
+ *
+ * Never throws — a malformed connStr just falls back to the full-string replace.
+ */
+export declare function redactConnStr(text: string, connStr: string): string;
+/**
+ * Introspect a live PostgreSQL database's schema over a fresh connection.
+ *
+ * Opens a new Client, sets a statement timeout, reads columns / primary keys /
+ * indexes / foreign keys from information_schema + pg_catalog, and maps them to
+ * {@link PgTableInfo}[] / {@link PgRelationship}[]. The whole call is bounded by
+ * a wall-clock race (default 10s). The connection is always closed in a finally
+ * block. No connection-string material ever appears in the returned object, a
+ * warning, an error message, or a log.
+ *
+ * @returns {@link PgIntrospectResult} on success, or {@link PgIntrospectError}
+ *   (with a redacted message) on any failure. Never throws, never logs secrets.
+ */
+export declare function introspectPgSchema(connStr: string, opts?: IntrospectPgOptions): Promise<PgIntrospectResult | PgIntrospectError>;
+//# sourceMappingURL=pg-introspection.d.ts.map

package/dist/tools/pg-introspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-introspection.d.ts","sourceRoot":"","sources":["../../src/tools/pg-introspection.ts"],"names":[],"mappings":"AAOA,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC;IACrF,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,KAAK,GAAG,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,uBAAuB,EAAE,MAAM,CAAA;KAAE,KAAK,YAAY,CAAC;CACtG;AAED,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAaD,wBAAsB,YAAY,IAAI,OAAO,CAAC,YAAY,GAAG,WAAW,CAAC,CAexE;AAeD,iDAAiD;AACjD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,aAAa,EAAE,cAAc,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC;CAC1C;AAoDD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA4BnE;AAuBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,kBAAkB,GAAG,iBAAiB,CAAC,CAIjD"}

package/dist/tools/pg-introspection.js

@@ -0,0 +1,288 @@
+/**
+ * PostgreSQL introspection tools.
+ * `pg` is an optional dependency — all imports are dynamic so the module
+ * loads cleanly even when `pg` is not installed.
+ */
+import { buildRelationships, buildTables } from "./pg-introspect-formatters.js";
+export async function loadPgClient() {
+    try {
+        // Dynamic import keeps pg entirely optional at the type level.
+        // We use a specifier string stored in a variable so tsc does not attempt
+        // to resolve "pg" as a static module (avoids TS2307 when @types/pg is
+        // absent from node_modules at type-check time).
+        const pgSpecifier = "pg";
+        const mod = (await import(/* @vite-ignore */ pgSpecifier));
+        // Handle both ESM default-export and CJS named-export shapes.
+        const ClientCtor = mod.default?.Client ?? mod.Client;
+        if (!ClientCtor)
+            return { error: "pg not installed. Run: npm install pg" };
+        return { ClientCtor };
+    }
+    catch {
+        return { error: "pg not installed. Run: npm install pg" };
+    }
+}
+/** Whole-call wall-clock cap (ms). Overridable via opts.timeoutMs. */
+const DEFAULT_TIMEOUT_MS = 10_000;
+/** Per-connection + per-statement cap (ms). */
+const STATEMENT_TIMEOUT_MS = 5000;
+const MAX_TIMEOUT_MS = 60_000;
+const MAX_CATALOG_ROWS = 100_000;
+const COLUMNS_SQL = `
+  SELECT table_name, column_name, data_type, is_nullable
+  FROM information_schema.columns
+  WHERE table_schema = $1
+  ORDER BY table_name, ordinal_position
+  LIMIT 100001`;
+const PK_SQL = `
+  SELECT kcu.table_name, kcu.column_name
+  FROM information_schema.table_constraints tc
+  JOIN information_schema.key_column_usage kcu
+    ON tc.constraint_name = kcu.constraint_name
+   AND tc.table_schema = kcu.table_schema
+  WHERE tc.constraint_type = 'PRIMARY KEY'
+    AND tc.table_schema = $1
+  ORDER BY kcu.table_name, kcu.ordinal_position
+  LIMIT 100001`;
+const INDEX_SQL = `
+  SELECT tablename AS table_name, indexname AS index_name
+  FROM pg_catalog.pg_indexes
+  WHERE schemaname = $1
+  ORDER BY tablename, indexname
+  LIMIT 100001`;
+const FK_SQL = `
+  SELECT
+    kcu.table_name        AS from_table,
+    kcu.column_name       AS from_column,
+    ccu.table_name        AS to_table,
+    ccu.column_name       AS to_column
+  FROM information_schema.referential_constraints rc
+  JOIN information_schema.key_column_usage kcu
+    ON rc.constraint_name = kcu.constraint_name
+   AND rc.constraint_schema = kcu.table_schema
+  JOIN information_schema.key_column_usage ccu
+    ON rc.unique_constraint_name = ccu.constraint_name
+   AND rc.unique_constraint_schema = ccu.table_schema
+   AND kcu.ordinal_position = ccu.ordinal_position
+  WHERE rc.constraint_schema = $1
+  ORDER BY kcu.table_name, kcu.column_name
+  LIMIT 100001`;
+/**
+ * Replace every occurrence of the connection string — and, separately, its
+ * password component — with "[REDACTED]" inside arbitrary text.
+ *
+ * Why password-separately: a thrown driver error often echoes only the host
+ * portion or a re-assembled URL with the password but a different surrounding
+ * shape, so a single full-string replace can miss the secret. Parsing the URL
+ * and replacing the password token independently closes that gap.
+ *
+ * Never throws — a malformed connStr just falls back to the full-string replace.
+ */
+export function redactConnStr(text, connStr) {
+    let out = text;
+    if (connStr) {
+        // 1. Replace the whole connection string verbatim.
+        out = out.split(connStr).join("[REDACTED]");
+        // 2. Replace the password component on its own (covers re-assembled forms).
+        try {
+            const url = new URL(connStr);
+            if (url.password) {
+                out = out.split(url.password).join("[REDACTED]");
+                try {
+                    out = out.split(decodeURIComponent(url.password)).join("[REDACTED]");
+                }
+                catch {
+                    // Keep the encoded-token redaction above when decoding is malformed.
+                }
+            }
+            // Also scrub a bare user:pass@ authority fragment if present in text.
+            if (url.username && url.password) {
+                out = out.split(`${url.username}:${url.password}`).join("[REDACTED]");
+            }
+        }
+        catch {
+            // Non-URL conn string (e.g. libpq keyword form). Best-effort: pull a
+            // password=... token out and scrub its value.
+            const password = extractLibpqPassword(connStr);
+            if (password)
+                out = out.split(password).join("[REDACTED]");
+        }
+    }
+    return out;
+}
+function extractLibpqPassword(connStr) {
+    const match = /password\s*=\s*/i.exec(connStr);
+    if (!match)
+        return undefined;
+    let index = match.index + match[0].length;
+    const quote = connStr[index] === "'" || connStr[index] === '"' ? connStr[index++] : undefined;
+    let value = "";
+    while (index < connStr.length) {
+        const char = connStr[index++];
+        if (char === "\\" && index < connStr.length)
+            value += connStr[index++];
+        else if (quote ? char === quote : /\s/.test(char ?? ""))
+            break;
+        else
+            value += char;
+    }
+    return value || undefined;
+}
+/** Coerce any thrown value to a message string, then redact it. */
+function redactError(err, connStr) {
+    const raw = err instanceof Error ? (err.message ?? String(err)) : String(err);
+    return redactConnStr(raw, connStr);
+}
+/**
+ * Introspect a live PostgreSQL database's schema over a fresh connection.
+ *
+ * Opens a new Client, sets a statement timeout, reads columns / primary keys /
+ * indexes / foreign keys from information_schema + pg_catalog, and maps them to
+ * {@link PgTableInfo}[] / {@link PgRelationship}[]. The whole call is bounded by
+ * a wall-clock race (default 10s). The connection is always closed in a finally
+ * block. No connection-string material ever appears in the returned object, a
+ * warning, an error message, or a log.
+ *
+ * @returns {@link PgIntrospectResult} on success, or {@link PgIntrospectError}
+ *   (with a redacted message) on any failure. Never throws, never logs secrets.
+ */
+export async function introspectPgSchema(connStr, opts = {}) {
+    const prepared = await prepareIntrospection(connStr, opts);
+    if ("error" in prepared)
+        return prepared;
+    return runWithTimeout(prepared.client, connStr, prepared.schema, prepared.timeoutMs);
+}
+async function prepareIntrospection(connStr, opts) {
+    const validated = validateOptions(connStr, opts);
+    if ("error" in validated)
+        return validated;
+    let ClientCtor = opts._clientCtor;
+    if (!ClientCtor) {
+        const loaded = await loadPgClient();
+        if ("error" in loaded)
+            return { error: loaded.error };
+        ClientCtor = loaded.ClientCtor;
+    }
+    return createClient(ClientCtor, connStr, validated.schema, validated.timeoutMs);
+}
+function validateOptions(connStr, opts) {
+    if (typeof connStr !== "string" || connStr.trim() === "") {
+        return { error: "connStr is required and must be a non-empty string" };
+    }
+    const schema = opts.schema && opts.schema.trim() !== "" ? opts.schema : "public";
+    if (!/^[A-Za-z_][A-Za-z0-9_$]{0,62}$/.test(schema)) {
+        return { error: "schema must be a valid PostgreSQL identifier" };
+    }
+    const timeoutMs = typeof opts.timeoutMs === "number" && Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0
+        ? Math.min(opts.timeoutMs, MAX_TIMEOUT_MS)
+        : DEFAULT_TIMEOUT_MS;
+    return { schema, timeoutMs };
+}
+function createClient(ClientCtor, connStr, schema, timeoutMs) {
+    try {
+        const client = new ClientCtor({
+            connectionString: connStr,
+            connectionTimeoutMillis: STATEMENT_TIMEOUT_MS,
+        });
+        return { client, schema, timeoutMs };
+    }
+    catch (err) {
+        redactError(err, connStr);
+        return { error: "PostgreSQL introspection failed" };
+    }
+}
+async function runWithTimeout(client, connStr, schema, timeoutMs) {
+    let timer;
+    let timedOut = false;
+    const timeoutError = new Error("pg introspection timed out");
+    const timeout = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => {
+            timedOut = true;
+            reject(timeoutError);
+        }, timeoutMs);
+    });
+    const introspectionPromise = runIntrospection(client, connStr, schema);
+    try {
+        return await Promise.race([introspectionPromise, timeout]);
+    }
+    catch (err) {
+        redactError(err, connStr);
+        if (err === timeoutError)
+            return { error: "pg introspection timed out" };
+        return { error: "PostgreSQL introspection failed" };
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+        if (timedOut) {
+            introspectionPromise.catch(() => undefined);
+            await settleCleanup(client);
+        }
+    }
+}
+async function settleCleanup(client) {
+    let timer;
+    const deadline = new Promise((resolve) => {
+        timer = setTimeout(resolve, 100);
+    });
+    await Promise.race([closeClient(client), deadline]);
+    if (timer)
+        clearTimeout(timer);
+}
+/**
+ * The actual connect → query → map flow. Split out so the timeout race in
+ * {@link introspectPgSchema} stays readable. Always closes the client on the
+ * non-timeout paths (success / connect-failure / query-failure).
+ */
+async function runIntrospection(client, connStr, schema) {
+    try {
+        await client.connect();
+        // FIRST query after connect — bound every subsequent statement.
+        await client.query(`SET statement_timeout = ${STATEMENT_TIMEOUT_MS}`);
+        return await queryCatalog(client, schema);
+    }
+    catch (err) {
+        // Redact before the error escapes runIntrospection so the caller's catch
+        // (and the timeout race) never sees raw connection material.
+        throw new Error(redactError(err, connStr));
+    }
+    finally {
+        // Always close — connect-success, query-failure, or connect-failure paths.
+        // end() itself may throw; swallow + redact so cleanup never leaks secrets.
+        await closeClient(client);
+    }
+}
+async function queryCatalog(client, schema) {
+    const results = await Promise.all([
+        client.query(COLUMNS_SQL, [schema]), client.query(PK_SQL, [schema]),
+        client.query(INDEX_SQL, [schema]), client.query(FK_SQL, [schema]),
+    ]);
+    if (results.some(({ rows }) => rows.length > MAX_CATALOG_ROWS)) {
+        throw new Error(`pg introspection exceeded ${MAX_CATALOG_ROWS} catalog rows`);
+    }
+    const [columns, primaryKeys, indexes, foreignKeys] = results;
+    if (!columns || !primaryKeys || !indexes || !foreignKeys) {
+        throw new Error("PostgreSQL catalog query returned an incomplete result set");
+    }
+    return {
+        tables: buildTables(columns.rows, primaryKeys.rows, indexes.rows),
+        relationships: buildRelationships(foreignKeys.rows), warnings: [],
+    };
+}
+const closePromises = new WeakMap();
+function closeClient(client) {
+    const existing = closePromises.get(client);
+    if (existing)
+        return existing;
+    try {
+        const closing = client.end().catch(() => undefined);
+        closePromises.set(client, closing);
+        return closing;
+    }
+    catch {
+        const completed = Promise.resolve();
+        closePromises.set(client, completed);
+        return completed;
+    }
+}
+//# sourceMappingURL=pg-introspection.js.map

package/dist/tools/pg-introspection.js.map

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

package/dist/tools/php-active-record-tools.d.ts

@@ -0,0 +1,22 @@
+export interface ActiveRecordModel {
+    name: string;
+    file: string;
+    table_name: string | null;
+    relations: {
+        name: string;
+        type: "hasOne" | "hasMany" | "manyMany";
+        target_class: string;
+    }[];
+    rules: string[];
+    behaviors: string[];
+    methods: string[];
+}
+export interface ActiveRecordAnalysis {
+    models: ActiveRecordModel[];
+    total: number;
+}
+export declare function analyzeActiveRecord(repo: string, options?: {
+    model_name?: string;
+    file_pattern?: string;
+}): Promise<ActiveRecordAnalysis>;
+//# sourceMappingURL=php-active-record-tools.d.ts.map

package/dist/tools/php-active-record-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"php-active-record-tools.d.ts","sourceRoot":"","sources":["../../src/tools/php-active-record-tools.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7F,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAgHD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,oBAAoB,CAAC,CA6F/B"}

package/dist/tools/php-active-record-tools.js

@@ -0,0 +1,165 @@
+/**
+ * PHP/Yii2-specific code intelligence tools.
+ *
+ * Implementation module extracted from the legacy php-tools facade.
+ */
+import { getCodeIndex } from "./index-tools.js";
+import { extractPhpNamespace, extractPhpUseImports, resolvePhpClassReference } from "./php-import-utils.js";
+/**
+ * Names of class roots that we treat as "this is an ActiveRecord". The check
+ * is done on the LAST namespace segment so prefixed forms (yii\\db\\ActiveRecord,
+ * \\yii\\db\\ActiveRecord, app\\models\\ActiveRecord) all match. Includes
+ * yii\\base\\Model because Yii2 form models extending Model share the
+ * rules() / behaviors() lifecycle that analyzeActiveRecord introspects;
+ * downstream callers can filter by tableName() presence if they need a
+ * stricter "real DB-backed AR" criterion.
+ */
+const AR_ROOT_NAMES = new Set(["ActiveRecord", "Model", "BaseActiveRecord"]);
+function phpClassFqcn(cls) {
+    const name = cls.name.replace(/^\\/, "");
+    if (name.includes("\\"))
+        return name;
+    const namespace = extractPhpNamespace(cls.source);
+    return namespace ? `${namespace}\\${name}` : name;
+}
+function resolveParentClass(parentFqcn, current, index) {
+    const currentNamespace = extractPhpNamespace(current.source);
+    const currentImports = extractPhpUseImports(current.source);
+    const rawNormalized = parentFqcn.replace(/^\\/, "");
+    const rawLast = rawNormalized.split(/[\\]+/).pop() ?? rawNormalized;
+    if (rawNormalized.includes("\\")) {
+        const exactRaw = index.symbols.find((s) => s.kind === "class" && phpClassFqcn(s) === rawNormalized);
+        if (exactRaw)
+            return exactRaw;
+    }
+    const normalized = resolvePhpClassReference(parentFqcn, {
+        namespace: currentNamespace,
+        imports: currentImports,
+    });
+    const last = normalized.split(/[\\]+/).pop() ?? normalized;
+    if (normalized.includes("\\")) {
+        const exact = index.symbols.find((s) => s.kind === "class" && phpClassFqcn(s) === normalized);
+        if (exact)
+            return exact;
+    }
+    return index.symbols.find((s) => s.kind === "class" && (s.name === last || s.name === rawLast));
+}
+function isActiveRecordHierarchy(cls, index, visited = new Set(), depth = 0) {
+    if (depth > 5)
+        return false;
+    const clsKey = phpClassFqcn(cls);
+    if (visited.has(clsKey))
+        return false;
+    visited.add(clsKey);
+    const exts = cls.extends ?? [];
+    for (const baseFqcn of exts) {
+        // Last segment of FQCN (handles "\\yii\\db\\ActiveRecord" and aliases).
+        const last = baseFqcn.split(/[\\\\]+/).pop() ?? baseFqcn;
+        if (AR_ROOT_NAMES.has(last))
+            return true;
+        // Look up the base class as an indexed symbol and recurse.
+        const baseSym = resolveParentClass(baseFqcn, cls, index);
+        if (baseSym && isActiveRecordHierarchy(baseSym, index, visited, depth + 1)) {
+            return true;
+        }
+    }
+    // Fallback for older indexes (e.g. before the v2.0.0 extractor bump): if
+    // `extends` is missing on this symbol, try the legacy regex against
+    // `source` so we don't regress on unindexed projects.
+    if (!cls.extends && cls.source) {
+        return /extends\s+(?:ActiveRecord|Model|\\yii\\db\\ActiveRecord)\b/.test(cls.source);
+    }
+    return false;
+}
+export async function analyzeActiveRecord(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    // Find PHP class symbols in model files
+    const classSymbols = index.symbols.filter((s) => {
+        if (s.kind !== "class")
+            return false;
+        if (!s.file.endsWith(".php"))
+            return false;
+        if (options?.model_name && s.name !== options.model_name)
+            return false;
+        if (options?.file_pattern && !s.file.includes(options.file_pattern))
+            return false;
+        return true;
+    });
+    const models = [];
+    for (const cls of classSymbols) {
+        if (!cls.source)
+            continue;
+        if (!isActiveRecordHierarchy(cls, index))
+            continue;
+        const model = {
+            name: cls.name,
+            file: cls.file,
+            table_name: null,
+            relations: [],
+            rules: [],
+            behaviors: [],
+            methods: [],
+        };
+        // Extract tableName() return value
+        const tableMatch = /function\s+tableName\s*\([^)]*\)[^{]*\{[^}]*return\s+['"]([^'"]+)['"]/s.exec(cls.source);
+        if (tableMatch)
+            model.table_name = tableMatch[1];
+        // Find child method symbols
+        const methods = index.symbols.filter((s) => s.parent === cls.id && s.kind === "method");
+        model.methods = methods.map((m) => m.name);
+        // Extract relations from getX() methods that return hasOne/hasMany.
+        // Two-pass detection:
+        //   Pass 1: find the primary `->hasOne(Target::class, ...)` or
+        //           `->hasMany(Target::class, ...)` call.
+        //   Pass 2: scan the rest of the source for modifiers:
+        //             ->via('relation')         (Yii2 2.0.13+ junction table via relation)
+        //             ->viaTable('tbl', [...])  (direct junction table)
+        //             ->inverseOf('relation')   (bidirectional relation)
+        //           The presence of `via` or `viaTable` upgrades the relation type
+        //           to `manyMany`. `inverseOf` is decorative and doesn't change type.
+        for (const m of methods) {
+            if (!m.name.startsWith("get") || !m.source)
+                continue;
+            const relName = m.name.slice(3);
+            const primaryRe = /->(hasOne|hasMany)\s*\(\s*([\w\\]+)(?:::class)?/;
+            const primaryMatch = primaryRe.exec(m.source);
+            if (!primaryMatch)
+                continue;
+            const baseType = primaryMatch[1] === "hasOne" ? "hasOne" : "hasMany";
+            const targetClass = primaryMatch[2];
+            // Scan the method source for junction-table modifiers on the same chain.
+            // If found, the semantic type is manyMany even though the primary call was hasMany.
+            const hasJunction = /->(?:via|viaTable)\s*\(/.test(m.source);
+            const type = hasJunction ? "manyMany" : baseType;
+            model.relations.push({
+                name: relName.charAt(0).toLowerCase() + relName.slice(1),
+                type,
+                target_class: targetClass,
+            });
+        }
+        // Extract rule validators (loose regex on rules() method source)
+        const rulesMethod = methods.find((m) => m.name === "rules");
+        if (rulesMethod?.source) {
+            const ruleMatches = rulesMethod.source.matchAll(/\[\s*\[?['"]?[\w,\s'"]+['"]?\]?\s*,\s*['"]([\w]+)['"]/g);
+            for (const rm of ruleMatches) {
+                if (rm[1] && !model.rules.includes(rm[1]))
+                    model.rules.push(rm[1]);
+            }
+        }
+        // Extract behaviors from behaviors() method
+        const behaviorsMethod = methods.find((m) => m.name === "behaviors");
+        if (behaviorsMethod?.source) {
+            const bMatches = behaviorsMethod.source.matchAll(/([A-Z]\w+Behavior)(?:::class)?/g);
+            for (const bm of bMatches) {
+                if (bm[1] && !model.behaviors.includes(bm[1]))
+                    model.behaviors.push(bm[1]);
+            }
+        }
+        models.push(model);
+    }
+    return { models, total: models.length };
+}
+// ---------------------------------------------------------------------------
+//# sourceMappingURL=php-active-record-tools.js.map

package/dist/tools/php-active-record-tools.js.map

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

package/dist/tools/php-event-tools.d.ts

@@ -0,0 +1,21 @@
+export interface PhpEventChain {
+    event_name: string;
+    triggers: {
+        file: string;
+        line: number;
+        context: string;
+    }[];
+    listeners: {
+        file: string;
+        line: number;
+        context: string;
+    }[];
+}
+export declare function tracePhpEvent(repo: string, options?: {
+    event_name?: string;
+}): Promise<{
+    events: PhpEventChain[];
+    total: number;
+    warnings?: string[];
+}>;
+//# sourceMappingURL=php-event-tools.d.ts.map

package/dist/tools/php-event-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"php-event-tools.d.ts","sourceRoot":"","sources":["../../src/tools/php-event-tools.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC9D;AAyHD,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA8G1E"}