sandstream-kit 1.0.0

package/dist/analyze.d.ts

@@ -0,0 +1,19 @@
+import { type DetectedStack } from "./stack-detector.js";
+export interface AnalysisReport {
+    stack: DetectedStack;
+    commitPrefixes: Array<{
+        prefix: string;
+        count: number;
+    }>;
+    testRunners: string[];
+    ciFiles: string[];
+    deployTargets: string[];
+    databaseClients: string[];
+    hasClaudeMd: boolean;
+    hasRulesMd: boolean;
+    fileCount: number;
+    scriptCount: number;
+}
+export declare function analyzeRepo(cwd?: string): Promise<AnalysisReport>;
+export declare function renderClaudeMd(report: AnalysisReport): string;
+export declare function renderRulesMd(report: AnalysisReport): string;

package/dist/analyze.js

@@ -0,0 +1,311 @@
+import { readFile, readdir, access, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { detectStack } from "./stack-detector.js";
+import { exec } from "./utils/exec.js";
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function gitCommitPrefixes(cwd, limit = 200) {
+    try {
+        const { stdout } = await exec("git", ["log", `--max-count=${limit}`, "--pretty=%s"], { cwd, timeout: 5000 });
+        const counts = new Map();
+        for (const line of stdout.split("\n")) {
+            // Conventional-commit prefix: word, optional scope, then `:`
+            const m = line.match(/^([a-z]+)(\([^)]+\))?:/i);
+            if (m) {
+                const key = m[1].toLowerCase();
+                counts.set(key, (counts.get(key) ?? 0) + 1);
+            }
+        }
+        return [...counts.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 10)
+            .map(([prefix, count]) => ({ prefix, count }));
+    }
+    catch {
+        return [];
+    }
+}
+async function detectTestRunners(cwd) {
+    const runners = [];
+    const pkgPath = join(cwd, "package.json");
+    if (await fileExists(pkgPath)) {
+        try {
+            const pkg = JSON.parse(await readFile(pkgPath, "utf-8"));
+            const all = { ...pkg.dependencies, ...pkg.devDependencies };
+            if (all["vitest"])
+                runners.push("vitest");
+            if (all["jest"])
+                runners.push("jest");
+            if (all["@playwright/test"] || all["playwright"])
+                runners.push("playwright");
+            if (all["cypress"])
+                runners.push("cypress");
+            if (all["mocha"])
+                runners.push("mocha");
+            if (all["ava"])
+                runners.push("ava");
+        }
+        catch {
+            // ignore
+        }
+    }
+    if (await fileExists(join(cwd, "pytest.ini")))
+        runners.push("pytest");
+    if (await fileExists(join(cwd, "pyproject.toml"))) {
+        try {
+            const txt = await readFile(join(cwd, "pyproject.toml"), "utf-8");
+            if (/pytest/.test(txt))
+                runners.push("pytest");
+        }
+        catch {
+            // ignore
+        }
+    }
+    if (await fileExists(join(cwd, "Cargo.toml")))
+        runners.push("cargo-test");
+    if (await fileExists(join(cwd, "go.mod")))
+        runners.push("go-test");
+    return runners;
+}
+async function detectCiFiles(cwd) {
+    const ci = [];
+    const ghDir = join(cwd, ".github", "workflows");
+    if (await fileExists(ghDir)) {
+        try {
+            const entries = await readdir(ghDir);
+            for (const e of entries) {
+                if (e.endsWith(".yml") || e.endsWith(".yaml")) {
+                    ci.push(`.github/workflows/${e}`);
+                }
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    if (await fileExists(join(cwd, ".gitlab-ci.yml")))
+        ci.push(".gitlab-ci.yml");
+    if (await fileExists(join(cwd, "circleci", "config.yml")))
+        ci.push("circleci/config.yml");
+    return ci;
+}
+async function detectDeployTargets(cwd) {
+    const targets = [];
+    if (await fileExists(join(cwd, "vercel.json")))
+        targets.push("vercel");
+    if (await fileExists(join(cwd, ".vercel")))
+        targets.push("vercel");
+    if (await fileExists(join(cwd, "netlify.toml")))
+        targets.push("netlify");
+    if (await fileExists(join(cwd, "fly.toml")))
+        targets.push("fly");
+    if (await fileExists(join(cwd, "railway.toml")))
+        targets.push("railway");
+    if (await fileExists(join(cwd, "render.yaml")))
+        targets.push("render");
+    if (await fileExists(join(cwd, "wrangler.toml")) || await fileExists(join(cwd, "wrangler.jsonc")))
+        targets.push("cloudflare-workers");
+    if (await fileExists(join(cwd, "Dockerfile")))
+        targets.push("docker");
+    if (await fileExists(join(cwd, "amplify.yml")))
+        targets.push("aws-amplify");
+    if (await fileExists(join(cwd, "sst.config.ts")) || await fileExists(join(cwd, "sst.config.js")))
+        targets.push("sst");
+    return [...new Set(targets)];
+}
+async function detectDatabaseClients(cwd) {
+    const clients = [];
+    const pkgPath = join(cwd, "package.json");
+    if (await fileExists(pkgPath)) {
+        try {
+            const pkg = JSON.parse(await readFile(pkgPath, "utf-8"));
+            const all = { ...pkg.dependencies, ...pkg.devDependencies };
+            if (all["@prisma/client"] || all["prisma"])
+                clients.push("prisma");
+            if (all["drizzle-orm"])
+                clients.push("drizzle");
+            if (all["@supabase/supabase-js"])
+                clients.push("supabase");
+            if (all["pg"] || all["postgres"])
+                clients.push("postgres");
+            if (all["mongoose"] || all["mongodb"])
+                clients.push("mongodb");
+            if (all["typeorm"])
+                clients.push("typeorm");
+            if (all["kysely"])
+                clients.push("kysely");
+        }
+        catch {
+            // ignore
+        }
+    }
+    return [...new Set(clients)];
+}
+async function countFiles(cwd) {
+    try {
+        const { stdout } = await exec("git", ["ls-files"], { cwd, timeout: 5000 });
+        return stdout.split("\n").filter(Boolean).length;
+    }
+    catch {
+        return 0;
+    }
+}
+async function countScripts(cwd) {
+    const scriptsDir = join(cwd, "scripts");
+    try {
+        await access(scriptsDir);
+        const entries = await readdir(scriptsDir);
+        let count = 0;
+        for (const e of entries) {
+            const st = await stat(join(scriptsDir, e));
+            if (st.isFile())
+                count++;
+        }
+        return count;
+    }
+    catch {
+        return 0;
+    }
+}
+export async function analyzeRepo(cwd = process.cwd()) {
+    const [stack, commitPrefixes, testRunners, ciFiles, deployTargets, databaseClients, hasClaudeMd, hasRulesMd, fileCount, scriptCount,] = await Promise.all([
+        detectStack(cwd),
+        gitCommitPrefixes(cwd),
+        detectTestRunners(cwd),
+        detectCiFiles(cwd),
+        detectDeployTargets(cwd),
+        detectDatabaseClients(cwd),
+        fileExists(join(cwd, "CLAUDE.md")),
+        fileExists(join(cwd, "RULES.md")),
+        countFiles(cwd),
+        countScripts(cwd),
+    ]);
+    return {
+        stack,
+        commitPrefixes,
+        testRunners,
+        ciFiles,
+        deployTargets,
+        databaseClients,
+        hasClaudeMd,
+        hasRulesMd,
+        fileCount,
+        scriptCount,
+    };
+}
+export function renderClaudeMd(report) {
+    const { stack, testRunners, deployTargets, databaseClients, scriptCount } = report;
+    const lines = [
+        "# CLAUDE.md",
+        "",
+        "Project context for Claude Code and other AI coding agents.",
+        "",
+        "## Stack",
+        "",
+    ];
+    const stackBits = [];
+    if (stack.language !== "unknown")
+        stackBits.push(`- **Language**: ${stack.language}`);
+    if (stack.framework)
+        stackBits.push(`- **Framework**: ${stack.framework}`);
+    if (databaseClients.length)
+        stackBits.push(`- **Database clients**: ${databaseClients.join(", ")}`);
+    if (stack.services.length)
+        stackBits.push(`- **Services**: ${stack.services.join(", ")}`);
+    if (testRunners.length)
+        stackBits.push(`- **Tests**: ${testRunners.join(", ")}`);
+    if (deployTargets.length)
+        stackBits.push(`- **Deploy**: ${deployTargets.join(", ")}`);
+    lines.push(...stackBits);
+    lines.push("", "## Development", "");
+    const pkgManager = stack.tools["pnpm"] ? "pnpm"
+        : stack.tools["yarn"] ? "yarn"
+            : stack.tools["bun"] ? "bun"
+                : "npm";
+    lines.push(`- Install deps: \`${pkgManager} install\``);
+    if (testRunners.length) {
+        lines.push(`- Run tests: \`${pkgManager} test\``);
+    }
+    if (stack.framework === "nextjs") {
+        lines.push(`- Dev server: \`${pkgManager} dev\``);
+        lines.push(`- Build: \`${pkgManager} run build\``);
+    }
+    if (scriptCount > 0) {
+        lines.push(`- Custom scripts: see \`scripts/\` (${scriptCount} file(s))`);
+    }
+    lines.push("", "## Conventions", "");
+    if (report.commitPrefixes.length > 0) {
+        lines.push("Recent commit-message prefixes (top in this repo):");
+        lines.push("");
+        for (const { prefix, count } of report.commitPrefixes.slice(0, 5)) {
+            lines.push(`- \`${prefix}\` (${count}×)`);
+        }
+        lines.push("");
+        lines.push("Match the existing pattern when writing commit messages.");
+    }
+    else {
+        lines.push("No conventional-commit prefixes detected. Pick a style and document it here.");
+    }
+    lines.push("", "## Secrets & env", "");
+    lines.push("- Configured via `.kit.toml` (see `kit check`).", "- Regenerate `.env.local` with `kit secrets`.", "- Never commit `.env*` files; only `.env.template` is tracked.");
+    lines.push("", "## CI", "");
+    if (report.ciFiles.length) {
+        lines.push("Active workflows:");
+        lines.push("");
+        for (const f of report.ciFiles)
+            lines.push(`- \`${f}\``);
+    }
+    else {
+        lines.push("No CI workflows detected.");
+    }
+    lines.push("", "---", "_Generated by `kit analyze` — edit freely; the generator only writes a draft._", "");
+    return lines.join("\n");
+}
+export function renderRulesMd(report) {
+    const { stack, testRunners, deployTargets } = report;
+    const lines = [
+        "# RULES.md",
+        "",
+        "Hard rules for this codebase. Agents and contributors must follow these.",
+        "",
+        "## Always",
+        "",
+        "- Run tests before committing (`kit check` runs the suite).",
+        "- Use the package manager already in use; don't switch lock files.",
+        "- Keep `.env*` out of git. Use `kit secrets` to materialize them locally.",
+    ];
+    if (deployTargets.includes("vercel")) {
+        lines.push("- Production env vars live in Vercel; never hard-code keys in code.");
+    }
+    if (deployTargets.includes("fly") || deployTargets.includes("railway")) {
+        lines.push("- Deployment platform secrets are the source of truth — sync via `kit secrets sync`.");
+    }
+    if (stack.framework === "nextjs") {
+        lines.push("- Server-only env vars must NOT have a `NEXT_PUBLIC_` prefix.");
+    }
+    if (stack.services.includes("supabase")) {
+        lines.push("- All Postgres tables require RLS policies. Never disable RLS.");
+        lines.push("- The `service_role` key must NEVER reach the browser.");
+    }
+    if (stack.services.includes("stripe")) {
+        lines.push("- Use test-mode keys in development; only Vercel/production has live keys.");
+        lines.push("- Webhook handlers must verify the `Stripe-Signature` header.");
+    }
+    lines.push("", "## Never", "");
+    lines.push("- Commit plaintext API keys, tokens, or `.env.local`.", "- `git push --force` against the default branch.", "- Skip pre-commit hooks (`--no-verify`) unless explicitly approved.", "- Run destructive SQL (`DROP TABLE`, unbounded `DELETE`) without an approval gate.");
+    if (testRunners.length) {
+        lines.push("- Mark a task complete with failing tests — `" + testRunners[0] + "` must be green.");
+    }
+    lines.push("", "## When in doubt", "");
+    lines.push("- Run `kit check` for a complete posture overview.", "- Open an issue rather than committing speculative work.");
+    lines.push("", "---", "_Generated by `kit analyze` — edit to match team policy._", "");
+    return lines.join("\n");
+}
+//# sourceMappingURL=analyze.js.map

package/dist/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../src/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAsB,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAgBvC,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,GAAW,EACX,KAAK,GAAG,GAAG;IAEX,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAC3B,KAAK,EACL,CAAC,KAAK,EAAE,eAAe,KAAK,EAAE,EAAE,aAAa,CAAC,EAC9C,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CACvB,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,6DAA6D;YAC7D,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAChD,IAAI,CAAC,EAAE,CAAC;gBACN,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC/B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;aACzB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aAC3B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;aACZ,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,GAAW;IAC1C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC1C,IAAI,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAGtD,CAAC;YACF,MAAM,GAAG,GAAG,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC;YAC5D,IAAI,GAAG,CAAC,QAAQ,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1C,IAAI,GAAG,CAAC,MAAM,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtC,IAAI,GAAG,CAAC,kBAAkB,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC7E,IAAI,GAAG,CAAC,SAAS,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5C,IAAI,GAAG,CAAC,OAAO,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,GAAG,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtE,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC,CAAC;YACjE,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1E,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACnE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,GAAW;IACtC,MAAM,EAAE,GAAa,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAChD,IAAI,MAAM,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;YACrC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC9C,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7E,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;QACvD,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACjC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,GAAW;IAC5C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvE,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnE,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzE,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjE,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzE,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvE,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAC/F,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrC,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtE,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC5E,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAC9F,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,GAAW;IAC9C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC1C,IAAI,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAGtD,CAAC;YACF,MAAM,GAAG,GAAG,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC;YAC5D,IAAI,GAAG,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnE,IAAI,GAAG,CAAC,aAAa,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAChD,IAAI,GAAG,CAAC,uBAAuB,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC3D,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC3D,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/D,IAAI,GAAG,CAAC,SAAS,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5C,IAAI,GAAG,CAAC,QAAQ,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,GAAW;IACnC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAC3B,KAAK,EACL,CAAC,UAAU,CAAC,EACZ,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CACvB,CAAC;QACF,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,GAAW;IACrC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3C,IAAI,EAAE,CAAC,MAAM,EAAE;gBAAE,KAAK,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC3D,MAAM,CACJ,KAAK,EACL,cAAc,EACd,WAAW,EACX,OAAO,EACP,aAAa,EACb,eAAe,EACf,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,EACZ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpB,WAAW,CAAC,GAAG,CAAC;QAChB,iBAAiB,CAAC,GAAG,CAAC;QACtB,iBAAiB,CAAC,GAAG,CAAC;QACtB,aAAa,CAAC,GAAG,CAAC;QAClB,mBAAmB,CAAC,GAAG,CAAC;QACxB,qBAAqB,CAAC,GAAG,CAAC;QAC1B,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAClC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACjC,UAAU,CAAC,GAAG,CAAC;QACf,YAAY,CAAC,GAAG,CAAC;KAClB,CAAC,CAAC;IAEH,OAAO;QACL,KAAK;QACL,cAAc;QACd,WAAW;QACX,OAAO;QACP,aAAa;QACb,eAAe;QACf,WAAW;QACX,UAAU;QACV,SAAS;QACT,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IACnF,MAAM,KAAK,GAAa;QACtB,aAAa;QACb,EAAE;QACF,6DAA6D;QAC7D,EAAE;QACF,UAAU;QACV,EAAE;KACH,CAAC;IAEF,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,SAAS,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtF,IAAI,KAAK,CAAC,SAAS;QAAE,SAAS,CAAC,IAAI,CAAC,oBAAoB,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3E,IAAI,eAAe,CAAC,MAAM;QAAE,SAAS,CAAC,IAAI,CAAC,2BAA2B,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpG,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM;QAAE,SAAS,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1F,IAAI,WAAW,CAAC,MAAM;QAAE,SAAS,CAAC,IAAI,CAAC,gBAAgB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjF,IAAI,aAAa,CAAC,MAAM;QAAE,SAAS,CAAC,IAAI,CAAC,iBAAiB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtF,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IAEzB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM;QAC7C,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM;YAC9B,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;gBAC5B,CAAC,CAAC,KAAK,CAAC;IACV,KAAK,CAAC,IAAI,CAAC,qBAAqB,UAAU,YAAY,CAAC,CAAC;IACxD,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,kBAAkB,UAAU,SAAS,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,mBAAmB,UAAU,QAAQ,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,cAAc,UAAU,cAAc,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,uCAAuC,WAAW,WAAW,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACrC,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAClE,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,OAAO,KAAK,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CACR,0DAA0D,CAC3D,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CACR,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CACR,iDAAiD,EACjD,+CAA+C,EAC/C,gEAAgE,CACjE,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IAC5B,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,IAAI,CACR,EAAE,EACF,KAAK,EACL,gFAAgF,EAChF,EAAE,CACH,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAsB;IAClD,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;IACrD,MAAM,KAAK,GAAa;QACtB,YAAY;QACZ,EAAE;QACF,0EAA0E;QAC1E,EAAE;QACF,WAAW;QACX,EAAE;QACF,6DAA6D;QAC7D,oEAAoE;QACpE,2EAA2E;KAC5E,CAAC;IACF,IAAI,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC,sFAAsF,CAAC,CAAC;IACrG,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;QAC7E,KAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;QACzF,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CACR,uDAAuD,EACvD,kDAAkD,EAClD,qEAAqE,EACrE,oFAAoF,CACrF,CAAC;IACF,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CACR,+CAA+C,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,kBAAkB,CACtF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CACR,oDAAoD,EACpD,0DAA0D,CAC3D,CAAC;IAEF,KAAK,CAAC,IAAI,CACR,EAAE,EACF,KAAK,EACL,2DAA2D,EAC3D,EAAE,CACH,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/apm-instrumentor.d.ts

@@ -0,0 +1,119 @@
+export interface TraceSpan {
+    id: string;
+    traceId: string;
+    parentId?: string;
+    name: string;
+    operation: string;
+    duration: number;
+    startTime: string;
+    endTime: string;
+    status: "success" | "error" | "pending";
+    tags: Record<string, unknown>;
+    logs: Array<{
+        timestamp: string;
+        message: string;
+    }>;
+}
+export interface Trace {
+    id: string;
+    name: string;
+    startTime: string;
+    endTime: string;
+    duration: number;
+    spans: TraceSpan[];
+    status: "success" | "error" | "pending";
+}
+export interface PerformanceMetric {
+    name: string;
+    value: number;
+    unit: string;
+    timestamp: string;
+}
+export interface ServiceMetrics {
+    serviceName: string;
+    requestCount: number;
+    errorCount: number;
+    averageResponseTime: number;
+    p95ResponseTime: number;
+    p99ResponseTime: number;
+    throughput: number;
+}
+export declare class APMInstrumentor {
+    private traces;
+    private spans;
+    private metrics;
+    private serviceName;
+    constructor(serviceName?: string);
+    /**
+     * Start a new trace.
+     */
+    startTrace(name: string): Trace;
+    /**
+     * End a trace.
+     */
+    endTrace(traceId: string, status?: "success" | "error"): Trace | null;
+    /**
+     * Start a span within a trace.
+     */
+    startSpan(traceId: string, name: string, operation: string, parentId?: string): TraceSpan;
+    /**
+     * End a span.
+     */
+    endSpan(spanId: string, status?: "success" | "error"): TraceSpan | null;
+    /**
+     * Add tag to span.
+     */
+    addTag(spanId: string, key: string, value: unknown): void;
+    /**
+     * Add log entry to span.
+     */
+    addLog(spanId: string, message: string): void;
+    /**
+     * Get trace by ID.
+     */
+    getTrace(traceId: string): Trace | null;
+    /**
+     * Get recent traces.
+     */
+    getRecentTraces(limit?: number): Trace[];
+    /**
+     * Get slow traces (above or equal to threshold).
+     */
+    getSlowTraces(thresholdMs?: number): Trace[];
+    /**
+     * Record performance metric.
+     */
+    recordMetric(name: string, value: number, unit?: string): void;
+    /**
+     * Get service metrics.
+     */
+    getServiceMetrics(): ServiceMetrics;
+    /**
+     * Get metrics by name.
+     */
+    getMetricsByName(name: string): PerformanceMetric[];
+    /**
+     * Get all metrics.
+     */
+    getAllMetrics(): PerformanceMetric[];
+    /**
+     * Get metric statistics.
+     */
+    getMetricStats(name: string): {
+        min: number;
+        max: number;
+        average: number;
+        count: number;
+    } | null;
+    /**
+     * Check service health based on metrics.
+     */
+    checkHealth(): {
+        healthy: boolean;
+        status: string;
+        metrics: ServiceMetrics;
+    };
+    getTraceCache(): Map<string, Trace>;
+    getSpanCache(): Map<string, TraceSpan>;
+    getMetricsCache(): PerformanceMetric[];
+}