stapes-adsa 1.0.0

package/dist/cli.js.map

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

package/dist/column.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Helpers for converting node positions into (line, column) coordinates.
+ *
+ * ts-morph's `getStart()` returns a numeric offset; `getStartLineNumber()`
+ * returns the 1-based line. We compute the 1-based column by subtracting
+ * the start of the line from the start offset.
+ */
+import type { Node } from "ts-morph";
+/** 1-based column number for the start of the given node. */
+export declare function startColumn(node: Node): number;

package/dist/column.js

@@ -0,0 +1,30 @@
+/**
+ * Helpers for converting node positions into (line, column) coordinates.
+ *
+ * ts-morph's `getStart()` returns a numeric offset; `getStartLineNumber()`
+ * returns the 1-based line. We compute the 1-based column by subtracting
+ * the start of the line from the start offset.
+ */
+/** ASCII code for newline. Extracted to avoid the magic-number heuristic. */
+const NEWLINE_CODE = 10;
+/** 1-based column number for the start of the given node. */
+export function startColumn(node) {
+    const sf = node.getSourceFile();
+    const line = node.getStartLineNumber();
+    // ts-morph v22+ exposes the line-start offset via compiler internals.
+    // Walk the source text to find the start-of-line position.
+    const text = sf.getFullText();
+    let lineStart = 0;
+    let currentLine = 1;
+    for (let i = 0; i < text.length; i++) {
+        if (currentLine === line) {
+            lineStart = i;
+            break;
+        }
+        if (text.charCodeAt(i) === NEWLINE_CODE) {
+            currentLine++;
+        }
+    }
+    return node.getStart() - lineStart + 1;
+}
+//# sourceMappingURL=column.js.map

package/dist/column.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column.js","sourceRoot":"","sources":["../src/column.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,6EAA6E;AAC7E,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB,6DAA6D;AAC7D,MAAM,UAAU,WAAW,CAAC,IAAU;IACpC,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACvC,sEAAsE;IACtE,2DAA2D;IAC3D,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9B,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,SAAS,GAAG,CAAC,CAAC;YACd,MAAM;QACR,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,YAAY,EAAE,CAAC;YACxC,WAAW,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,EAAE,GAAG,SAAS,GAAG,CAAC,CAAC;AACzC,CAAC"}

package/dist/fix.d.ts

@@ -0,0 +1,34 @@
+/**
+ * --fix — apply safe auto-fixes to findings produced by the runner.
+ *
+ * Conservative subset (SPEC.md invariant #7):
+ *   - Insert slow-path log line at top of a function body
+ *     (slow-path-no-log + async-no-log findings)
+ *   - NEVER modify a file with fast-path-with-io / decision-router /
+ *     log-schema findings — those require refactor / developer judgment.
+ *
+ * Dry-run by default. Pass `--fix-confirm` to actually write files.
+ *
+ * Output is a FixReport — list of per-file outcomes.
+ */
+import type { Finding } from "./types.js";
+export interface FixReport {
+    applied: number;
+    skipped: number;
+    failed: number;
+    files: FileFixReport[];
+}
+export interface FileFixReport {
+    file: string;
+    status: "applied" | "skipped" | "failed";
+    reason?: string;
+    findingsBefore: number;
+    findingsAfter: number;
+}
+export interface FixOptions {
+    /** If false (dry-run), no files are written. */
+    write: boolean;
+}
+export declare function applyFixes(findings: Finding[], opts: FixOptions): FixReport;
+export declare const __FIXABLE_CHECKS: ReadonlySet<string>;
+export declare const __ALL_CHECK_NAMES: string[];

package/dist/fix.js

@@ -0,0 +1,110 @@
+/**
+ * --fix — apply safe auto-fixes to findings produced by the runner.
+ *
+ * Conservative subset (SPEC.md invariant #7):
+ *   - Insert slow-path log line at top of a function body
+ *     (slow-path-no-log + async-no-log findings)
+ *   - NEVER modify a file with fast-path-with-io / decision-router /
+ *     log-schema findings — those require refactor / developer judgment.
+ *
+ * Dry-run by default. Pass `--fix-confirm` to actually write files.
+ *
+ * Output is a FixReport — list of per-file outcomes.
+ */
+import { readFileSync, writeFileSync } from "node:fs";
+import { CHECKS } from "./checks/index.js";
+/** Fixable check names — the conservative subset. */
+const FIXABLE_CHECKS = new Set([
+    "slow-path-no-log",
+    "async-no-log",
+]);
+export function applyFixes(findings, opts) {
+    const byFile = new Map();
+    for (const f of findings) {
+        if (!FIXABLE_CHECKS.has(f.check))
+            continue;
+        const arr = byFile.get(f.file) ?? [];
+        arr.push(f);
+        byFile.set(f.file, arr);
+    }
+    const report = {
+        applied: 0,
+        skipped: 0,
+        failed: 0,
+        files: [],
+    };
+    for (const [file, fileFindings] of byFile) {
+        const beforeCount = fileFindings.length;
+        const fixable = fileFindings.filter((f) => f.suggestedFix);
+        if (fixable.length === 0) {
+            report.files.push({
+                file,
+                status: "skipped",
+                reason: "no suggestedFix on findings",
+                findingsBefore: beforeCount,
+                findingsAfter: beforeCount,
+            });
+            report.skipped += beforeCount;
+            continue;
+        }
+        if (!opts.write) {
+            report.files.push({
+                file,
+                status: "skipped",
+                reason: "dry-run (--fix-confirm not set)",
+                findingsBefore: beforeCount,
+                findingsAfter: beforeCount,
+            });
+            report.skipped += fixable.length;
+            continue;
+        }
+        try {
+            const src = readFileSync(file, "utf8");
+            const lines = src.split("\n");
+            // Apply insertions in reverse line order so earlier insertions don't shift later line numbers.
+            const sortedFixes = [...fixable].sort((a, b) => (b.suggestedFix.line - a.suggestedFix.line));
+            for (const f of sortedFixes) {
+                const fix = f.suggestedFix;
+                // Insert the replacement text at `line`, `column`.
+                // Line is 1-based, column is 1-based.
+                const li = fix.line - 1;
+                if (li < 0 || li >= lines.length) {
+                    report.failed++;
+                    continue;
+                }
+                const lineText = lines[li] ?? "";
+                // Compute insertion offset: column - 1 (0-based), but clamp to line length.
+                const colIdx = Math.max(0, Math.min(lineText.length, fix.column - 1));
+                const before = lineText.slice(0, colIdx);
+                const after = lineText.slice(colIdx);
+                const replacement = fix.replacement.replace(/\n$/, "");
+                // If the replacement is multi-line, split and insert.
+                const newLines = replacement.split("\n");
+                lines.splice(li, 1, before + newLines[0], ...newLines.slice(1), after);
+            }
+            writeFileSync(file, lines.join("\n"));
+            report.applied += fixable.length;
+            report.files.push({
+                file,
+                status: "applied",
+                findingsBefore: beforeCount,
+                findingsAfter: beforeCount - fixable.length,
+            });
+        }
+        catch (err) {
+            report.failed += fixable.length;
+            report.files.push({
+                file,
+                status: "failed",
+                reason: err instanceof Error ? err.message : String(err),
+                findingsBefore: beforeCount,
+                findingsAfter: beforeCount,
+            });
+        }
+    }
+    return report;
+}
+// Re-export for unit tests to enumerate fixable checks.
+export const __FIXABLE_CHECKS = FIXABLE_CHECKS;
+export const __ALL_CHECK_NAMES = CHECKS.map((c) => c.name);
+//# sourceMappingURL=fix.js.map

package/dist/fix.js.map

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

package/dist/hook-install.d.ts

@@ -0,0 +1,36 @@
+/**
+ * --init / --uninstall — install or remove a marker-block pre-commit hook.
+ *
+ * Behaviour (matches stapes-precommit):
+ *   - Reads .git/hooks/pre-commit if it exists.
+ *   - If our marker block is already present, --init is a no-op.
+ *   - If a foreign hook (Husky, lefthook) is present, our block is
+ *     appended inside our marker so the foreign hook still runs.
+ *   - --uninstall removes only our marker block, leaves the rest.
+ */
+export interface InitResult {
+    hookPath: string;
+    status: "created" | "appended" | "already-installed";
+}
+/**
+ * Install the pre-commit hook. Idempotent.
+ *
+ * Returns the path and a status string:
+ *   - "created": hook file did not exist, created with our block
+ *   - "appended": hook file existed with a foreign hook, appended our block
+ *   - "already-installed": our marker was already present, no-op
+ */
+export declare function installHook(repoRoot: string): InitResult;
+export interface UninstallResult {
+    hookPath: string;
+    status: "removed" | "deleted" | "not-installed";
+}
+/**
+ * Remove our marker block from the pre-commit hook. If the file ends up
+ * empty after removal, delete it. Foreign hooks are left untouched.
+ */
+export declare function uninstallHook(repoRoot: string): UninstallResult;
+/** Test helper — also exported for the unit tests. */
+export declare const __MARKER_START = "# >>> stapes-adsa hook >>>";
+export declare const __MARKER_END = "# <<< stapes-adsa hook <<<";
+export declare const __HOOK_BODY = "#!/usr/bin/env sh\n# >>> stapes-adsa hook >>>\n# This block is managed by 'stapes-adsa --init'. Do not edit.\n# To remove, run 'stapes-adsa --uninstall'.\nset -e\nnpx --no-install stapes-adsa --run --json\n# <<< stapes-adsa hook <<<\n";

package/dist/hook-install.js

@@ -0,0 +1,94 @@
+/**
+ * --init / --uninstall — install or remove a marker-block pre-commit hook.
+ *
+ * Behaviour (matches stapes-precommit):
+ *   - Reads .git/hooks/pre-commit if it exists.
+ *   - If our marker block is already present, --init is a no-op.
+ *   - If a foreign hook (Husky, lefthook) is present, our block is
+ *     appended inside our marker so the foreign hook still runs.
+ *   - --uninstall removes only our marker block, leaves the rest.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+/** Marker block delimiters. Keep stable. */
+const MARKER_START = "# >>> stapes-adsa hook >>>";
+const MARKER_END = "# <<< stapes-adsa hook <<<";
+/** Path to the hook script we install. Runs `stapes-adsa` via npx. */
+const HOOK_BODY = `#!/usr/bin/env sh
+${MARKER_START}
+# This block is managed by 'stapes-adsa --init'. Do not edit.
+# To remove, run 'stapes-adsa --uninstall'.
+set -e
+npx --no-install stapes-adsa --run --json
+${MARKER_END}
+`;
+/**
+ * Install the pre-commit hook. Idempotent.
+ *
+ * Returns the path and a status string:
+ *   - "created": hook file did not exist, created with our block
+ *   - "appended": hook file existed with a foreign hook, appended our block
+ *   - "already-installed": our marker was already present, no-op
+ */
+export function installHook(repoRoot) {
+    const gitDir = join(repoRoot, ".git");
+    if (!existsSync(gitDir)) {
+        throw new Error(`not a git repository: ${repoRoot}`);
+    }
+    const hooksDir = join(gitDir, "hooks");
+    mkdirSync(hooksDir, { recursive: true });
+    const hookPath = join(hooksDir, "pre-commit");
+    if (!existsSync(hookPath)) {
+        writeFileSync(hookPath, HOOK_BODY, { mode: 0o755 });
+        return { hookPath, status: "created" };
+    }
+    const existing = readFileSync(hookPath, "utf8");
+    if (existing.includes(MARKER_START)) {
+        return { hookPath, status: "already-installed" };
+    }
+    // Append our block inside our marker. Use a newline separator
+    // so the foreign hook runs first.
+    const next = existing.trimEnd() + "\n\n" + HOOK_BODY;
+    writeFileSync(hookPath, next, { mode: 0o755 });
+    return { hookPath, status: "appended" };
+}
+/**
+ * Remove our marker block from the pre-commit hook. If the file ends up
+ * empty after removal, delete it. Foreign hooks are left untouched.
+ */
+export function uninstallHook(repoRoot) {
+    const hookPath = join(repoRoot, ".git", "hooks", "pre-commit");
+    if (!existsSync(hookPath)) {
+        return { hookPath, status: "not-installed" };
+    }
+    const existing = readFileSync(hookPath, "utf8");
+    if (!existing.includes(MARKER_START)) {
+        return { hookPath, status: "not-installed" };
+    }
+    // Strip our marker block (inclusive of surrounding blank lines).
+    const blockStart = existing.indexOf(MARKER_START);
+    let blockEnd = existing.indexOf(MARKER_END, blockStart);
+    if (blockEnd >= 0) {
+        blockEnd += MARKER_END.length;
+    }
+    else {
+        blockEnd = existing.length;
+    }
+    let remaining = existing.slice(0, blockStart) + existing.slice(blockEnd);
+    // Tidy up trailing blank lines but keep one newline at EOF if anything remains.
+    remaining = remaining.replace(/\n+$/, "");
+    // If only the shebang line that we wrote remains, delete the file.
+    // (We wrote the shebang as part of HOOK_BODY, so "only shebang" means "only ours".)
+    const shebangOnly = /^#!.*\n?$/.test(remaining.trimEnd()) || /^#!.*$/.test(remaining);
+    if (remaining.length === 0 || shebangOnly) {
+        unlinkSync(hookPath);
+        return { hookPath, status: "deleted" };
+    }
+    writeFileSync(hookPath, remaining + "\n", { mode: 0o755 });
+    return { hookPath, status: "removed" };
+}
+/** Test helper — also exported for the unit tests. */
+export const __MARKER_START = MARKER_START;
+export const __MARKER_END = MARKER_END;
+export const __HOOK_BODY = HOOK_BODY;
+//# sourceMappingURL=hook-install.js.map

package/dist/hook-install.js.map

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

package/dist/lib/instrument.d.ts

@@ -0,0 +1,49 @@
+/**
+ * `withAdsaLogging` — a reference runtime helper.
+ *
+ * Wrap any async operation to get automatic `{adsa_path: "slow"}`
+ * logging when it does I/O, and `{adsa_path: "fast"}` logging when
+ * the predicate returns true without performing the operation.
+ *
+ * Usage:
+ *
+ *   import { withAdsaLogging } from "stapes-adsa/lib/instrument";
+ *
+ *   const result = await withAdsaLogging(
+ *     "permission",
+ *     async () => isAdmin(userId),       // fast predicate
+ *     async () => loadPermissions(userId) // slow path
+ *   );
+ *
+ *   // Logs: { adsa_path: "fast", adsa_area: "permission", adsa_reason: "predicate_true" }
+ *   //    or { adsa_path: "slow", adsa_area: "permission", adsa_reason: "predicate_false" }
+ *
+ * The wrapper is intentionally minimal. It exists so engineers don't have
+ * to remember the four-field log shape. Real-world code may use pino,
+ * winston, bunyan, or a custom logger — pass yours via `log`.
+ */
+export interface LoggerLike {
+    info: (obj: Record<string, unknown>, msg?: string) => void;
+    warn?: (obj: Record<string, unknown>, msg?: string) => void;
+    debug?: (obj: Record<string, unknown>, msg?: string) => void;
+}
+export interface WithAdsaLoggingOptions<TFastResult, TSlowResult> {
+    area: string;
+    predicate: () => Promise<TFastResult> | TFastResult;
+    slowPath: () => Promise<TSlowResult> | TSlowResult;
+    log?: LoggerLike;
+    /** Force the slow path even if the predicate succeeds. Useful for tests. */
+    forceSlow?: boolean;
+}
+export type WithAdsaLoggingResult<TFastResult, TSlowResult> = {
+    path: "fast";
+    value: TFastResult;
+} | {
+    path: "slow";
+    value: TSlowResult;
+};
+/**
+ * Route between a fast predicate and a slow path, emitting the
+ * ADSA log line on each invocation.
+ */
+export declare function withAdsaLogging<TFastResult, TSlowResult>(opts: WithAdsaLoggingOptions<TFastResult, TSlowResult>): Promise<WithAdsaLoggingResult<TFastResult, TSlowResult>>;

package/dist/lib/instrument.js

@@ -0,0 +1,53 @@
+/**
+ * `withAdsaLogging` — a reference runtime helper.
+ *
+ * Wrap any async operation to get automatic `{adsa_path: "slow"}`
+ * logging when it does I/O, and `{adsa_path: "fast"}` logging when
+ * the predicate returns true without performing the operation.
+ *
+ * Usage:
+ *
+ *   import { withAdsaLogging } from "stapes-adsa/lib/instrument";
+ *
+ *   const result = await withAdsaLogging(
+ *     "permission",
+ *     async () => isAdmin(userId),       // fast predicate
+ *     async () => loadPermissions(userId) // slow path
+ *   );
+ *
+ *   // Logs: { adsa_path: "fast", adsa_area: "permission", adsa_reason: "predicate_true" }
+ *   //    or { adsa_path: "slow", adsa_area: "permission", adsa_reason: "predicate_false" }
+ *
+ * The wrapper is intentionally minimal. It exists so engineers don't have
+ * to remember the four-field log shape. Real-world code may use pino,
+ * winston, bunyan, or a custom logger — pass yours via `log`.
+ */
+/** Minimal console-based logger used when none is supplied. */
+const defaultLogger = {
+    info: (obj) => {
+        process.stdout.write(JSON.stringify(obj) + "\n");
+    },
+};
+/**
+ * Route between a fast predicate and a slow path, emitting the
+ * ADSA log line on each invocation.
+ */
+export async function withAdsaLogging(opts) {
+    const log = opts.log ?? defaultLogger;
+    if (!opts.forceSlow) {
+        try {
+            const value = await opts.predicate();
+            log.info({ adsa_path: "fast", adsa_area: opts.area, adsa_reason: "predicate_true" }, "adsa fast path");
+            return { path: "fast", value };
+        }
+        catch (err) {
+            log.info({ adsa_path: "slow", adsa_area: opts.area, adsa_reason: "predicate_threw" }, "adsa slow path (predicate threw)");
+            const value = await opts.slowPath();
+            return { path: "slow", value };
+        }
+    }
+    log.info({ adsa_path: "slow", adsa_area: opts.area, adsa_reason: "force_slow" }, "adsa slow path");
+    const value = await opts.slowPath();
+    return { path: "slow", value };
+}
+//# sourceMappingURL=instrument.js.map

package/dist/lib/instrument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrument.js","sourceRoot":"","sources":["../../src/lib/instrument.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAQH,+DAA+D;AAC/D,MAAM,aAAa,GAAe;IAChC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;QACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACnD,CAAC;CACF,CAAC;AAeF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAsD;IAEtD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,aAAa,CAAC;IACtC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACrC,GAAG,CAAC,IAAI,CACN,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,gBAAgB,EAAE,EAC1E,gBAAgB,CACjB,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,IAAI,CACN,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,iBAAiB,EAAE,EAC3E,kCAAkC,CACnC,CAAC;YACF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACjC,CAAC;IACH,CAAC;IACD,GAAG,CAAC,IAAI,CACN,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,EACtE,gBAAgB,CACjB,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;IACpC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACjC,CAAC"}

package/dist/patterns.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ADSA pattern definitions.
+ *
+ * These constants are the contract between the linter and the framework
+ * described in SKILL.md. Changing them is a breaking change.
+ *
+ * - MARKER_PATTERNS: explicit declarations of fast/slow on a function.
+ * - IO_PATTERNS: call shapes that count as "I/O" inside a fast path.
+ * - LOG_FIELD_NAMES: the four-field {adsa_path, adsa_area, adsa_reason?, adsa_save_pct?}
+ *   contract. Validated by the `log-schema` check.
+ */
+/** Function-name suffix that explicitly marks a fast path. */
+export declare const FAST_NAME_REGEX: RegExp;
+/** Function-name suffix that explicitly marks a slow path. */
+export declare const SLOW_NAME_REGEX: RegExp;
+/** JSDoc tag that explicitly marks a fast path. */
+export declare const ADSA_FAST_TAG = "@adsa:fast";
+/** JSDoc tag that explicitly marks a slow path. */
+export declare const ADSA_SLOW_TAG = "@adsa:slow";
+/** Inline single-line comment that marks a path. */
+export declare const ADSA_INLINE_FAST: RegExp;
+export declare const ADSA_INLINE_SLOW: RegExp;
+/**
+ * Call shapes that count as I/O. Used by `fast-path-with-io` and `decision-router`.
+ * Match is against the *full* callee text (e.g. `fetch(...)`, `db.query(...)`).
+ */
+export declare const IO_CALLEE_PATTERNS: RegExp[];
+/**
+ * Required fields on a valid {adsa_path, ...} log call.
+ * Validated by the `log-schema` check.
+ */
+export declare const LOG_REQUIRED_FIELDS: readonly ["adsa_path", "adsa_area"];
+/** Optional fields. Their presence is allowed; their absence is allowed. */
+export declare const LOG_OPTIONAL_FIELDS: readonly ["adsa_reason", "adsa_save_pct"];
+/** Valid values for adsa_path. Anything else is a schema violation. */
+export declare const ADSA_PATH_VALUES: ReadonlyArray<"fast" | "slow">;

package/dist/patterns.js

@@ -0,0 +1,72 @@
+/**
+ * ADSA pattern definitions.
+ *
+ * These constants are the contract between the linter and the framework
+ * described in SKILL.md. Changing them is a breaking change.
+ *
+ * - MARKER_PATTERNS: explicit declarations of fast/slow on a function.
+ * - IO_PATTERNS: call shapes that count as "I/O" inside a fast path.
+ * - LOG_FIELD_NAMES: the four-field {adsa_path, adsa_area, adsa_reason?, adsa_save_pct?}
+ *   contract. Validated by the `log-schema` check.
+ */
+/** Function-name suffix that explicitly marks a fast path. */
+export const FAST_NAME_REGEX = /(?:^|[_$])(?:Fast|fast)(?:Path|path)?(?:$|[^a-zA-Z0-9_$])/;
+/** Function-name suffix that explicitly marks a slow path. */
+export const SLOW_NAME_REGEX = /(?:^|[_$])(?:Slow|slow)(?:Path|path)?(?:$|[^a-zA-Z0-9_$])/;
+/** JSDoc tag that explicitly marks a fast path. */
+export const ADSA_FAST_TAG = "@adsa:fast";
+/** JSDoc tag that explicitly marks a slow path. */
+export const ADSA_SLOW_TAG = "@adsa:slow";
+/** Inline single-line comment that marks a path. */
+export const ADSA_INLINE_FAST = /^\s*\/\/\s*adsa:\s*fast\b/i;
+export const ADSA_INLINE_SLOW = /^\s*\/\/\s*adsa:\s*slow\b/i;
+/**
+ * Call shapes that count as I/O. Used by `fast-path-with-io` and `decision-router`.
+ * Match is against the *full* callee text (e.g. `fetch(...)`, `db.query(...)`).
+ */
+export const IO_CALLEE_PATTERNS = [
+    // Network
+    /\bfetch\s*\(/,
+    /\baxios\s*\(/,
+    /\bgot\s*\(/,
+    /\bnode-fetch\b/,
+    /\bhttp\.(get|post|put|delete|patch|request)\s*\(/,
+    /\bhttps\.(get|post|put|delete|patch|request)\s*\(/,
+    // DB clients
+    /\bdb\.(query|execute|find|findOne|findMany|insert|update|delete|raw|select)\s*\(/i,
+    // ORM call shapes — `db.<table>.<verb>(`, `prisma.<model>.<verb>(`, `sql.<table>(`
+    /\bdb\.\w+\.(query|execute|find|findOne|findMany|findUnique|findFirst|create|update|delete|upsert|insert|aggregate|count|groupBy|raw|select)\s*\(/i,
+    /\bknex\s*\(/,
+    /\bprisma\.\w+\.(find|findUnique|findMany|findFirst|create|update|delete|upsert|insert|aggregate|count|groupBy)\s*\(/i,
+    /\bsql\.\w+\s*\(/i,
+    /\bsql\.\w+\s*\(/i,
+    /\bpg\.(query|connect)\s*\(/,
+    /\bmysql\.(query|connect)\s*\(/,
+    // Cache / KV
+    /\bredis\.(get|set|del|hget|hset|lpush|rpush|sadd|srem|zadd|zrem|eval)\s*\(/i,
+    /\bmemcached\.(get|set|del)\s*\(/i,
+    // File system
+    /\bfs\.(readFile|writeFile|appendFile|unlink|mkdir|rm|readdir|stat|access)\s*\(/i,
+    /\bfs\.promises\.(readFile|writeFile|appendFile|unlink|mkdir|rm|readdir|stat|access)\s*\(/i,
+    /\bfsPromises\.(readFile|writeFile|appendFile|unlink|mkdir|rm|readdir|stat|access)\s*\(/i,
+    // Queue / message
+    /\bkafka\.(produce|publish|send|consume|subscribe)\s*\(/i,
+    /\bsqs\.(sendMessage|receiveMessage)\s*\(/i,
+    /\bsns\.(publish)\s*\(/i,
+    /\bnats\.(publish|subscribe|request)\s*\(/i,
+    /\bamqp\.(publish|consume)\s*\(/i,
+    // External RPC
+    /\bgrpc\.(unary|client)\b/i,
+    // Generic await of any identifier that *might* be I/O (heuristic).
+    /\bawait\s+\w+/,
+];
+/**
+ * Required fields on a valid {adsa_path, ...} log call.
+ * Validated by the `log-schema` check.
+ */
+export const LOG_REQUIRED_FIELDS = ["adsa_path", "adsa_area"];
+/** Optional fields. Their presence is allowed; their absence is allowed. */
+export const LOG_OPTIONAL_FIELDS = ["adsa_reason", "adsa_save_pct"];
+/** Valid values for adsa_path. Anything else is a schema violation. */
+export const ADSA_PATH_VALUES = ["fast", "slow"];
+//# sourceMappingURL=patterns.js.map

package/dist/patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.js","sourceRoot":"","sources":["../src/patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,eAAe,GAAG,2DAA2D,CAAC;AAE3F,8DAA8D;AAC9D,MAAM,CAAC,MAAM,eAAe,GAAG,2DAA2D,CAAC;AAE3F,mDAAmD;AACnD,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC;AAE1C,mDAAmD;AACnD,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC;AAE1C,oDAAoD;AACpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AAC7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAa;IAC1C,UAAU;IACV,cAAc;IACd,cAAc;IACd,YAAY;IACZ,gBAAgB;IAChB,kDAAkD;IAClD,mDAAmD;IACnD,aAAa;IACb,mFAAmF;IACnF,mFAAmF;IACnF,mJAAmJ;IACnJ,aAAa;IACb,sHAAsH;IACtH,kBAAkB;IAClB,kBAAkB;IAClB,4BAA4B;IAC5B,+BAA+B;IAC/B,aAAa;IACb,6EAA6E;IAC7E,kCAAkC;IAClC,cAAc;IACd,iFAAiF;IACjF,2FAA2F;IAC3F,yFAAyF;IACzF,kBAAkB;IAClB,yDAAyD;IACzD,2CAA2C;IAC3C,wBAAwB;IACxB,2CAA2C;IAC3C,iCAAiC;IACjC,eAAe;IACf,2BAA2B;IAC3B,mEAAmE;IACnE,eAAe;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,WAAW,EAAE,WAAW,CAAU,CAAC;AAEvE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,aAAa,EAAE,eAAe,CAAU,CAAC;AAE7E,uEAAuE;AACvE,MAAM,CAAC,MAAM,gBAAgB,GAAmC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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 { basename } from "node:path";
+import type { Finding } from "./types.js";
+/** Stable JSON shape per SPEC.md invariant #5. */
+export interface RunReport {
+    startedAt: string;
+    tool: string;
+    version: string;
+    exitCode: 0 | 1 | 2;
+    checkCount: number;
+    failed: number;
+    warned: number;
+    findings: Finding[];
+}
+/** Runner options. */
+export interface RunnerOptions {
+    root: string;
+    checks?: string[];
+    strict?: boolean;
+    files?: string[];
+}
+export declare function run(opts: RunnerOptions): RunReport;
+/** Pretty-print the human-readable summary (no JSON). */
+export declare function formatHuman(report: RunReport): string;
+export { basename };