@appport/assessment 0.0.0-stage → 0.1.0

package/dist/files.js

@@ -0,0 +1,219 @@
+/**
+ * The repository walker: which files an assessment reads, and which it does not and why.
+ *
+ * Safety properties (docs in spec/assessment-1.md §4):
+ * - Only paths inside the supplied root are read. Symbolic links are never followed, whether they point inside or outside
+ *   the root; each is reported as skipped.
+ * - Nothing is written, executed or fetched. Git identity is read from `.git` files, never by running `git`.
+ * - Every file is either scanned or reported as skipped with a reason; nothing is dropped silently.
+ * - Paths in results are repository-relative with `/` separators, and all lists are sorted, so results never depend on
+ *   filesystem traversal order.
+ */
+import { closeSync, constants, fstatSync, lstatSync, openSync, readFileSync, readSync, readdirSync, realpathSync } from "node:fs";
+import { join, relative, resolve, sep } from "node:path";
+/** Directories never descended into: dependencies, vendored code, build output and VCS metadata. */
+export const DEFAULT_EXCLUDED_DIRECTORIES = [".git", ".hg", ".svn", "node_modules", "vendor", "dist", "build", "out", "target", ".next", ".turbo", "coverage", "__pycache__", ".venv"];
+/** Files larger than this are not read. */
+export const DEFAULT_MAX_FILE_BYTES = 1_048_576;
+export class RepositoryError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "RepositoryError";
+    }
+}
+const toPosix = (p) => p.split(sep).join("/");
+/** Resolves and checks the repository root. */
+export function repositoryRoot(path) {
+    let root;
+    try {
+        root = realpathSync(resolve(path));
+    }
+    catch {
+        throw new RepositoryError(`repository path does not exist: ${path}`);
+    }
+    if (!lstatSync(root).isDirectory())
+        throw new RepositoryError(`repository path is not a directory: ${path}`);
+    return root;
+}
+/** True when `absolute` lies inside `root` (or is it). */
+export function isInside(root, absolute) {
+    const rel = relative(root, absolute);
+    return rel === "" || (!rel.startsWith("..") && !rel.startsWith(sep) && !/^[A-Za-z]:/.test(rel));
+}
+/**
+ * A minimal `.gitignore` interpreter for the root file: blank lines and comments, `dir/` patterns, `*`/`?` globs, and
+ * leading-`/` anchoring. Negation (`!`), `**` and character classes are not interpreted; such patterns are returned as
+ * unsupported and not applied, so a file they would exclude is scanned and the limitation is reported.
+ */
+export function parseIgnore(text) {
+    const matchers = [];
+    const unsupported = [];
+    for (const raw of text.split(/\r?\n/)) {
+        const line = raw.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        if (line.startsWith("!") || line.includes("**") || /\[.*\]/.test(line) || line.includes("\\")) {
+            unsupported.push(line);
+            continue;
+        }
+        const directoryOnly = line.endsWith("/");
+        let pattern = directoryOnly ? line.slice(0, -1) : line;
+        const anchored = pattern.startsWith("/") || pattern.includes("/");
+        pattern = pattern.replace(/^\//, "");
+        const source = pattern.split("").map((c) => (c === "*" ? "[^/]*" : c === "?" ? "[^/]" : c.replace(/[.+^${}()|]/g, "\\$&"))).join("");
+        const regex = new RegExp(anchored ? `^${source}$` : `(^|/)${source}$`);
+        matchers.push((path, isDirectory) => (!directoryOnly || isDirectory) && regex.test(path));
+    }
+    return { matchers, unsupported };
+}
+/** Whether a file's leading bytes contain a NUL, the conventional binary test. */
+function isBinary(absolute) {
+    const fd = openSync(absolute, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
+    try {
+        const buffer = Buffer.alloc(8000);
+        const read = readSync(fd, buffer, 0, buffer.length, 0);
+        return buffer.subarray(0, read).includes(0);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/** Walks the repository deterministically. */
+export function walkRepository(root, options = {}) {
+    const maxBytes = options.maxFileBytes ?? DEFAULT_MAX_FILE_BYTES;
+    const excluded = new Set(options.excludedDirectories ?? DEFAULT_EXCLUDED_DIRECTORIES);
+    const files = [];
+    const skipped = [];
+    let ignore = { matchers: [], unsupported: [] };
+    try {
+        const gitignore = join(root, ".gitignore");
+        if (lstatSync(gitignore).isFile())
+            ignore = parseIgnore(readFileSync(gitignore, "utf8"));
+    }
+    catch {
+        /* no root .gitignore */
+    }
+    const ignored = (path, isDirectory) => ignore.matchers.some((m) => m(path, isDirectory));
+    const visit = (directory) => {
+        let entries;
+        try {
+            entries = readdirSync(directory).sort();
+        }
+        catch {
+            skipped.push({ path: toPosix(relative(root, directory)) || ".", reason: "unreadable" });
+            return;
+        }
+        for (const name of entries) {
+            const absolute = join(directory, name);
+            const path = toPosix(relative(root, absolute));
+            let stat;
+            try {
+                stat = lstatSync(absolute);
+            }
+            catch {
+                skipped.push({ path, reason: "unreadable" });
+                continue;
+            }
+            if (stat.isSymbolicLink()) {
+                skipped.push({ path, reason: "symlink" });
+                continue;
+            }
+            if (stat.isDirectory()) {
+                if (excluded.has(name))
+                    skipped.push({ path, reason: "excluded-directory" });
+                else if (ignored(path, true))
+                    skipped.push({ path, reason: "ignored" });
+                else
+                    visit(absolute);
+                continue;
+            }
+            if (!stat.isFile()) {
+                skipped.push({ path, reason: "special-file" });
+                continue;
+            }
+            if (ignored(path, false)) {
+                skipped.push({ path, reason: "ignored" });
+                continue;
+            }
+            if (stat.size > maxBytes) {
+                skipped.push({ path, reason: "too-large" });
+                continue;
+            }
+            try {
+                if (isBinary(absolute)) {
+                    skipped.push({ path, reason: "binary" });
+                    continue;
+                }
+            }
+            catch {
+                skipped.push({ path, reason: "unreadable" });
+                continue;
+            }
+            files.push({ path, size: stat.size });
+        }
+    };
+    visit(root);
+    const order = (a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
+    return { files: files.sort(order), skipped: skipped.sort(order), unsupportedIgnorePatterns: [...ignore.unsupported].sort() };
+}
+/**
+ * Reads a repository file as UTF-8, refusing anything that is not a regular file inside the root at the moment it is
+ * opened (the descriptor is checked, so a file replaced by a link after the walk is not followed).
+ */
+export function readRepositoryFile(root, path) {
+    const absolute = resolve(root, path);
+    if (!isInside(root, absolute))
+        throw new RepositoryError(`path escapes the repository root: ${path}`);
+    if (lstatSync(absolute).isSymbolicLink())
+        throw new RepositoryError(`refusing to follow a symbolic link: ${path}`);
+    const fd = openSync(absolute, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
+    try {
+        if (!fstatSync(fd).isFile())
+            throw new RepositoryError(`not a regular file: ${path}`);
+        return readFileSync(fd, "utf8");
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/** The repository's identity from `.git` files, if present. Never runs git; credentials in remote URLs are removed. */
+export function gitIdentity(root) {
+    const git = join(root, ".git");
+    try {
+        if (!lstatSync(git).isDirectory())
+            return {};
+    }
+    catch {
+        return {};
+    }
+    const read = (p) => {
+        try {
+            const absolute = join(git, p);
+            if (lstatSync(absolute).isSymbolicLink())
+                return undefined;
+            return readFileSync(absolute, "utf8");
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const out = {};
+    const head = read("HEAD")?.trim();
+    if (head?.startsWith("ref: ")) {
+        out.ref = head.slice(5);
+        const direct = read(out.ref)?.trim();
+        const packed = read("packed-refs")?.split("\n").find((l) => l.endsWith(` ${out.ref}`))?.split(" ")[0];
+        const revision = direct ?? packed;
+        if (revision && /^[0-9a-f]{40,64}$/.test(revision))
+            out.revision = revision;
+    }
+    else if (head && /^[0-9a-f]{40,64}$/.test(head)) {
+        out.revision = head;
+    }
+    const config = read("config");
+    const origin = config?.match(/\[remote "origin"\][^[]*?url\s*=\s*(\S+)/)?.[1];
+    if (origin)
+        out.repository = origin.replace(/^(https?:\/\/)[^@/]+@/, "$1");
+    return out;
+}
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

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

package/dist/go.d.ts

@@ -0,0 +1,103 @@
+/**
+ * A static reader for Go source: tokens, top-level declarations and the facts inside function bodies. It does not
+ * type-check, resolve generics, evaluate constants or build an AST beyond what the assessment needs, and it never runs
+ * the Go toolchain. What it does not understand is reported, not guessed (spec/assessment-1.md §5.2).
+ */
+export interface Token {
+    kind: "ident" | "string" | "rune" | "number" | "punct";
+    value: string;
+    line: number;
+    /** Last line of the token; differs from `line` only for raw strings. */
+    endLine: number;
+}
+export declare class SourceSyntaxError extends Error {
+    readonly line: number;
+    constructor(message: string, line: number);
+}
+/** Tokenizes Go source. Comments are dropped; an unterminated literal or comment is a syntax error. */
+export declare function tokenizeGo(text: string): Token[];
+/** The generated-code marker Go tooling recognizes (`go help generate`). */
+export declare const GENERATED_HEADER: RegExp;
+export declare function isGeneratedGo(text: string): boolean;
+export interface GoImport {
+    /** The local name: the alias, or the last path element (a guess for packages whose name differs from it). */
+    name: string;
+    path: string;
+    line: number;
+    aliased: boolean;
+}
+export interface GoFunction {
+    name: string;
+    /** Receiver type name without pointer or type parameters, for methods. */
+    receiverType?: string;
+    receiverName?: string;
+    params: string;
+    results: string;
+    startLine: number;
+    endLine: number;
+    /** Token index range of the body, `{` … `}` inclusive; absent for a declaration without a body. */
+    body?: [number, number];
+}
+export interface GoField {
+    name: string;
+    type: string;
+    embedded: boolean;
+    line: number;
+}
+export interface GoType {
+    name: string;
+    kind: "struct" | "interface" | "other";
+    fields: GoField[];
+    /** Interface method names. */
+    methods: string[];
+    /** Interface method signatures, parameters and results as source text. */
+    signatures: Array<{
+        name: string;
+        params: string;
+        results: string;
+    }>;
+    startLine: number;
+    endLine: number;
+}
+export interface GoValueDecl {
+    name: string;
+    keyword: "var" | "const";
+    startLine: number;
+    endLine: number;
+    range: [number, number];
+}
+export interface GoFile {
+    packageName: string;
+    imports: GoImport[];
+    functions: GoFunction[];
+    types: GoType[];
+    values: GoValueDecl[];
+    tokens: Token[];
+}
+/** Parses the declarations of one Go file. */
+export declare function parseGo(source: string): GoFile;
+export interface Call {
+    /** The selector chain: `["s", "Store", "GetMemo"]` for `s.Store.GetMemo(…)`, `["f"]` for `f(…)`. */
+    chain: string[];
+    line: number;
+}
+export interface BodyFacts {
+    calls: Call[];
+    /** Two-element selectors that are not calls, e.g. `codes.NotFound`. */
+    selectors: Call[];
+    strings: Array<{
+        value: string;
+        line: number;
+        endLine: number;
+    }>;
+    /** Lines of `go` statements. */
+    goStatements: number[];
+}
+/** The calls, selectors, string literals and `go` statements in a token range. */
+export declare function bodyFacts(tokens: Token[], [from, to]: [number, number]): BodyFacts;
+/**
+ * The parameter (or result) types of a signature, with names removed: `ctx context.Context, a, b int` →
+ * `["context.Context", "int", "int"]`. Go requires a list to name all of its parameters or none.
+ */
+export declare function signatureTypes(list: string): string[];
+//# sourceMappingURL=go.d.ts.map

package/dist/go.d.ts.map

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