stapes-adsa 1.0.0

package/dist/runner.js

@@ -0,0 +1,104 @@
+/**
+ * Runner — orchestrates check execution and produces the v1 --json shape.
+ *
+ * Inputs:
+ *   - root directory (or list of files)
+ *   - list of check names to run (default = all enabled)
+ *   - whether --strict is on (warnings become blocks)
+ *
+ * Output:
+ *   RunReport — see SPEC.md invariant #5 for the JSON shape.
+ */
+import { readFileSync } from "node:fs";
+import { basename } from "node:path";
+import { CHECKS, createProject } from "./checks/index.js";
+import { NAME_COL_WIDTH, walkTsFiles } from "./util.js";
+/** Tool version, read from package.json at runtime. */
+const VERSION = (() => {
+    try {
+        // dist/cli.js → ../package.json
+        const pkgPath = new URL("../package.json", import.meta.url);
+        const raw = readFileSync(pkgPath, "utf8");
+        const pkg = JSON.parse(raw);
+        return pkg.version;
+    }
+    catch {
+        return "0.0.0";
+    }
+})();
+export function run(opts) {
+    const startedAt = new Date().toISOString();
+    const fileList = opts.files && opts.files.length > 0
+        ? opts.files
+        : walkTsFiles(opts.root);
+    const project = createProject();
+    const sourceFiles = fileList.map((f) => {
+        const abs = f.startsWith("/") ? f : `${opts.root}/${f}`;
+        return project.addSourceFileAtPath(abs);
+    });
+    const enabled = (opts.checks && opts.checks.length > 0)
+        ? CHECKS.filter((c) => opts.checks.includes(c.name))
+        : CHECKS.filter((c) => c.defaultEnabled);
+    const allFindings = [];
+    for (const sf of sourceFiles) {
+        for (const check of enabled) {
+            const result = check.run(sf);
+            for (const f of result.findings) {
+                // --strict promotes warnings to blocks
+                if (opts.strict && f.severity === "warn") {
+                    allFindings.push({ ...f, severity: "block" });
+                }
+                else {
+                    allFindings.push(f);
+                }
+            }
+        }
+    }
+    const failed = allFindings.filter((f) => f.severity === "block").length;
+    const warned = allFindings.filter((f) => f.severity === "warn").length;
+    const exitCode = failed > 0 ? 1 : 0;
+    return {
+        startedAt,
+        tool: `stapes-adsa@${VERSION}`,
+        version: VERSION,
+        exitCode,
+        checkCount: enabled.length,
+        failed,
+        warned,
+        findings: allFindings,
+    };
+}
+/** Pretty-print the human-readable summary (no JSON). */
+export function formatHuman(report) {
+    const lines = [];
+    lines.push(`${report.tool}`);
+    lines.push("");
+    if (report.findings.length === 0) {
+        lines.push("✓ no findings");
+        return lines.join("\n");
+    }
+    // Group by check.
+    const byCheck = new Map();
+    for (const f of report.findings) {
+        const arr = byCheck.get(f.check) ?? [];
+        arr.push(f);
+        byCheck.set(f.check, arr);
+    }
+    for (const [check, findings] of byCheck) {
+        const block = findings.filter((f) => f.severity === "block").length;
+        const warn = findings.filter((f) => f.severity === "warn").length;
+        const symbol = block > 0 ? "✗" : warn > 0 ? "⚠" : "✓";
+        lines.push(`${symbol} ${check.padEnd(NAME_COL_WIDTH)} ${findings.length} finding(s)`);
+        for (const f of findings) {
+            lines.push(`  ${f.file}:${f.line}:${f.column}`);
+            lines.push(`    [${f.severity}] ${f.message}`);
+            lines.push(`    ${f.evidence}`);
+        }
+        lines.push("");
+    }
+    lines.push(`${report.failed} block(s), ${report.warned} warning(s).`);
+    return lines.join("\n");
+}
+// Re-export basename for the CLI to use when listing tools.
+export { basename };
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Shared types for stapes-adsa.
+ *
+ * `Finding` is the atomic unit emitted by every check. `CheckResult`
+ * is the per-check aggregate. The runner collects `CheckResult[]`
+ * into the v1 `--json` shape (see runner.ts).
+ */
+/** Severity of a finding. Determines exit code and `--strict` behavior. */
+export type Severity = "block" | "warn";
+/** ADSA path classification. The four-field log contract uses this as the enum. */
+export type AdsaPath = "fast" | "slow";
+/** A single violation reported by a check. */
+export interface Finding {
+    /** Check that produced the finding, e.g. "slow-path-no-log". */
+    check: string;
+    /** Repo-relative path of the source file. */
+    file: string;
+    /** 1-based line number. */
+    line: number;
+    /** 1-based column number. */
+    column: number;
+    /** Human-readable message. No newlines, max 200 chars. */
+    message: string;
+    /** Severity per SPEC.md invariant #8. */
+    severity: Severity;
+    /** Verbatim source snippet (one line, truncated to 200 chars). */
+    evidence: string;
+    /** Optional suggested fix. `--fix` uses this when present and conservative. */
+    suggestedFix?: SuggestedFix;
+}
+/** A safe auto-fix that the runner can apply. */
+export interface SuggestedFix {
+    /** Short label, e.g. "insert slow-path log line". */
+    description: string;
+    /** The exact text to insert at `line`, `column`. */
+    replacement: string;
+    /** 1-based line number where the fix applies. */
+    line: number;
+    /** 1-based column number where the fix applies. */
+    column: number;
+}
+/** A check's aggregate output. */
+export interface CheckResult {
+    /** Check name, e.g. "slow-path-no-log". */
+    name: string;
+    /** All findings produced by this check run. */
+    findings: Finding[];
+    /** Total files inspected by this check. */
+    filesScanned: number;
+    /** Wall-clock duration in milliseconds. */
+    durationMs: number;
+}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * Shared types for stapes-adsa.
+ *
+ * `Finding` is the atomic unit emitted by every check. `CheckResult`
+ * is the per-check aggregate. The runner collects `CheckResult[]`
+ * into the v1 `--json` shape (see runner.ts).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/util.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Utility helpers for the checks and runner.
+ *
+ * - `walkTsFiles` — recursive .ts/.tsx file walker with default exclusions.
+ * - `inferAdsaArea` — deterministic area inference (SPEC.md invariant #9).
+ * - `isInsideLogCall` — true if a node is an argument to a log.*() call.
+ * - `hasAdsaLogCall` — true if a function body contains any matching adsa_path log call.
+ * - `truncate` — evidence truncation to 200 chars.
+ */
+/** Extensions this tool recognises. Anything else is silently skipped. */
+export declare const TS_EXTENSIONS: Set<string>;
+/** Directories always excluded from the scan. */
+export declare const ALWAYS_EXCLUDED_DIRS: Set<string>;
+/** Recursively walk a directory and yield .ts/.tsx paths (relative to root). */
+export declare function walkTsFiles(root: string): string[];
+/**
+ * Deterministic ADSA area inference (SPEC.md invariant #9).
+ *
+ * Order:
+ *   1. Deepest enclosing directory whose name is not `src`/`lib`/etc.
+ *   2. Basename of the file without extension.
+ *   3. "unscoped" fallback.
+ */
+export declare function inferAdsaArea(filePath: string): string;
+/** Width of the check-name column in human-readable output. */
+export declare const NAME_COL_WIDTH = 22;
+/** Width of the severity column in --list output. */
+export declare const SEVERITY_COL_WIDTH = 5;
+/** Truncate a string to `max` chars, appending an ellipsis marker. */
+export declare function truncate(s: string, max?: number): string;
+/** Normalize a path to forward-slash relative form, for stable output. */
+export declare function normalizePath(p: string): string;

package/dist/util.js

@@ -0,0 +1,105 @@
+/**
+ * Utility helpers for the checks and runner.
+ *
+ * - `walkTsFiles` — recursive .ts/.tsx file walker with default exclusions.
+ * - `inferAdsaArea` — deterministic area inference (SPEC.md invariant #9).
+ * - `isInsideLogCall` — true if a node is an argument to a log.*() call.
+ * - `hasAdsaLogCall` — true if a function body contains any matching adsa_path log call.
+ * - `truncate` — evidence truncation to 200 chars.
+ */
+import { readdirSync, statSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+/** Extensions this tool recognises. Anything else is silently skipped. */
+export const TS_EXTENSIONS = new Set([".ts", ".tsx"]);
+/** Directories always excluded from the scan. */
+export const ALWAYS_EXCLUDED_DIRS = new Set([
+    "node_modules",
+    "dist",
+    "build",
+    "out",
+    "coverage",
+    ".git",
+    ".next",
+    ".turbo",
+    ".cache",
+]);
+/** Recursively walk a directory and yield .ts/.tsx paths (relative to root). */
+export function walkTsFiles(root) {
+    const out = [];
+    const stack = [root];
+    while (stack.length > 0) {
+        const dir = stack.pop();
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const name of entries) {
+            if (ALWAYS_EXCLUDED_DIRS.has(name))
+                continue;
+            const full = join(dir, name);
+            let st;
+            try {
+                st = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                stack.push(full);
+                continue;
+            }
+            const dot = name.lastIndexOf(".");
+            if (dot < 0)
+                continue;
+            const ext = name.slice(dot).toLowerCase();
+            if (TS_EXTENSIONS.has(ext))
+                out.push(relative(root, full));
+        }
+    }
+    out.sort();
+    return out;
+}
+/**
+ * Deterministic ADSA area inference (SPEC.md invariant #9).
+ *
+ * Order:
+ *   1. Deepest enclosing directory whose name is not `src`/`lib`/etc.
+ *   2. Basename of the file without extension.
+ *   3. "unscoped" fallback.
+ */
+export function inferAdsaArea(filePath) {
+    const parts = filePath.split(/[\\/]/).filter((p) => p.length > 0);
+    // Drop the filename.
+    const dirs = parts.slice(0, -1);
+    // Find the deepest dir that is meaningful (not generic).
+    const GENERIC = new Set(["src", "lib", "dist", "build", "out", "app", "index"]);
+    let deepest;
+    for (const d of dirs) {
+        if (d && !GENERIC.has(d.toLowerCase()))
+            deepest = d.toLowerCase();
+    }
+    if (deepest)
+        return deepest;
+    // Fallback to file basename without extension.
+    const base = parts[parts.length - 1] ?? "unscoped";
+    const dot = base.lastIndexOf(".");
+    return (dot > 0 ? base.slice(0, dot) : base).toLowerCase();
+}
+/** Width of the check-name column in human-readable output. */
+export const NAME_COL_WIDTH = 22;
+/** Width of the severity column in --list output. */
+export const SEVERITY_COL_WIDTH = 5;
+/** Truncate a string to `max` chars, appending an ellipsis marker. */
+export function truncate(s, max = 200) {
+    if (s.length <= max)
+        return s;
+    return s.slice(0, max - 3) + "...";
+}
+/** Normalize a path to forward-slash relative form, for stable output. */
+export function normalizePath(p) {
+    return p.split(sep).join("/");
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

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

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "stapes-adsa",
+  "version": "1.0.0",
+  "description": "AST-based ADSA (Adaptive Dual-System Architecture) linter for TypeScript. Flags slow paths without logging, fast paths doing I/O, decision points without routing, async boundaries missing the adsa_path log line, and invalid {adsa_path, adsa_area} shapes. Auto-fix safe insertions. Install as pre-commit hook. Stable --json for AI agents. Zero telemetry. MIT.",
+  "license": "MIT",
+  "author": "stapesco <github@stapes.co.za>",
+  "homepage": "https://github.com/stapesco/adsa",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stapesco/adsa.git"
+  },
+  "bugs": {
+    "url": "https://github.com/stapesco/adsa"
+  },
+  "keywords": [
+    "adsa",
+    "fast-path",
+    "slow-path",
+    "logging",
+    "observability",
+    "ast",
+    "ts-morph",
+    "typescript",
+    "linter",
+    "static-analysis",
+    "pre-commit",
+    "git-hooks",
+    "ai-agent",
+    "cli",
+    "npx",
+    "zero-config",
+    "stapes"
+  ],
+  "bin": {
+    "stapes-adsa": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "AGENTS.md",
+    "SKILL.md",
+    "CHANGELOG.md",
+    "SECURITY.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "prebuild": "rm -rf dist",
+    "build": "tsc",
+    "prepublishOnly": "npm run build && npm test",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "dependencies": {
+    "commander": "^11.1.0",
+    "ts-morph": "^22.0.0"
+  }
+}