@handong66/evidoc-core 0.1.0

package/dist/src/repository.js

@@ -0,0 +1,277 @@
+import { access, readFile, readdir, stat } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { resolveExistingPathInsideRoot } from "./path-safety.js";
+const IGNORED_DIRECTORIES = new Set([
+    ".git",
+    ".opencode-plugin-codex",
+    ".evidoc",
+    "coverage",
+    "dist",
+    "node_modules"
+]);
+const IGNORED_FILE_NAMES = new Set([".DS_Store"]);
+export async function readRepository(root, options = {}) {
+    const files = await listFiles(root);
+    const config = await readConfig(root);
+    const packageManifest = await readPackageManifest(root, files);
+    const { documents, skippedOversized } = await readDocuments(root, files, config, options);
+    const apiOperations = await readApiOperations(root, files, config);
+    const reviewLog = await readReviewLog(root);
+    return {
+        root,
+        files: new Set(files),
+        documents,
+        packageManifest,
+        expectedPackageManager: detectPackageManager(packageManifest, files),
+        apiOperations,
+        config,
+        reviewLog,
+        skippedOversized
+    };
+}
+export async function pathExists(root, candidate) {
+    try {
+        const target = await resolveExistingPathInsideRoot(root, candidate);
+        if (!target)
+            return false;
+        await access(target);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function listFiles(root) {
+    const results = [];
+    async function walk(current) {
+        const entries = await readdir(current, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory() && IGNORED_DIRECTORIES.has(entry.name)) {
+                continue;
+            }
+            if (entry.isFile() && IGNORED_FILE_NAMES.has(entry.name)) {
+                continue;
+            }
+            const absolute = join(current, entry.name);
+            const repoRelative = relative(root, absolute).replaceAll("\\", "/");
+            if (entry.isDirectory()) {
+                await walk(absolute);
+            }
+            else if (entry.isFile()) {
+                results.push(repoRelative);
+            }
+        }
+    }
+    await walk(root);
+    return results.sort();
+}
+async function readPackageManifest(root, files) {
+    if (!files.includes("package.json")) {
+        return undefined;
+    }
+    const raw = await readFile(join(root, "package.json"), "utf8");
+    const parsed = JSON.parse(raw);
+    return {
+        name: parsed.name,
+        version: parsed.version,
+        packageManager: parsed.packageManager,
+        scripts: parsed.scripts ?? {}
+    };
+}
+async function readDocuments(root, files, config, options) {
+    const restrictToChangedFiles = options.changedFiles !== undefined;
+    const changedFiles = new Set(options.changedFiles?.map(normalizePath));
+    const docs = files.filter((file) => isMarkdown(file) && (isIncludedDocument(file, config) || isAgentInstruction(file)));
+    const records = [];
+    let skippedOversized = 0;
+    for (const path of docs) {
+        const size = await fileSize(root, path);
+        if (config.maxFileBytes !== undefined && size > config.maxFileBytes) {
+            skippedOversized += 1;
+            continue;
+        }
+        if (restrictToChangedFiles && !changedFiles.has(path)) {
+            continue;
+        }
+        const text = await readFile(join(root, path), "utf8");
+        if (hasIgnoreFileDirective(text)) {
+            continue;
+        }
+        records.push({
+            path,
+            kind: isAgentInstruction(path) ? "agent_instruction" : "markdown",
+            lineCount: text.split(/\r?\n/).length,
+            text
+        });
+    }
+    return { documents: records, skippedOversized };
+}
+async function readApiOperations(root, files, config) {
+    const configured = config.apiSpecPaths ?? [];
+    const specs = configured.length > 0
+        ? configured.filter((file) => files.includes(file))
+        : files.filter((file) => /(^|\/)(openapi|swagger)\.json$/i.test(file));
+    const operations = [];
+    for (const specPath of specs) {
+        const raw = await readFile(join(root, specPath), "utf8");
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            continue;
+        }
+        const paths = asRecord(asRecord(parsed).paths);
+        for (const [apiPath, methods] of Object.entries(paths)) {
+            if (!apiPath.startsWith("/"))
+                continue;
+            for (const [method, operation] of Object.entries(asRecord(methods))) {
+                const normalizedMethod = method.toUpperCase();
+                if (!isHttpMethod(normalizedMethod))
+                    continue;
+                const operationId = asRecord(operation).operationId;
+                operations.push({
+                    specPath,
+                    method: normalizedMethod,
+                    path: apiPath,
+                    operationId: typeof operationId === "string" ? operationId : undefined,
+                    requestSchemas: extractRequestSchemas(asRecord(operation)),
+                    responseSchemas: extractResponseSchemas(asRecord(operation))
+                });
+            }
+        }
+    }
+    return operations;
+}
+async function readConfig(root) {
+    try {
+        const raw = await readFile(join(root, ".evidoc", "config.json"), "utf8");
+        const parsed = JSON.parse(raw);
+        return {
+            ...parsed,
+            ignorePatterns: parsed.ignorePatterns ?? [],
+            docRoots: parsed.docRoots?.map(normalizePath),
+            apiSpecPaths: parsed.apiSpecPaths?.map(normalizePath)
+        };
+    }
+    catch {
+        return { ignorePatterns: [] };
+    }
+}
+async function readReviewLog(root) {
+    try {
+        const raw = await readFile(join(root, ".evidoc", "review-log.jsonl"), "utf8");
+        const entries = [];
+        for (const line of raw.split(/\r?\n/)) {
+            if (!line.trim())
+                continue;
+            try {
+                const parsed = JSON.parse(line);
+                if (typeof parsed.findingId === "string" && typeof parsed.reviewedAt === "string") {
+                    entries.push(parsed);
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return entries;
+    }
+    catch {
+        return [];
+    }
+}
+function hasIgnoreFileDirective(text) {
+    return text.split(/\r?\n/, 12).some((line) => line.includes("evidoc: ignore-file"));
+}
+function isAgentInstruction(path) {
+    const normalized = normalizePath(path).toLowerCase();
+    const name = normalized.split("/").at(-1);
+    return (name === "agents.md" ||
+        name === "claude.md" ||
+        normalized === ".github/copilot-instructions.md" ||
+        normalized.startsWith(".cursor/rules/"));
+}
+function isMarkdown(path) {
+    const lower = path.toLowerCase();
+    return lower.endsWith(".md") || lower.endsWith(".mdx");
+}
+function isIncludedDocument(path, config) {
+    const normalized = normalizePath(path);
+    if (config.docRoots?.length && !config.docRoots.some((root) => normalized === root || normalized.startsWith(`${root}/`))) {
+        return false;
+    }
+    return !(config.ignorePatterns ?? []).some((pattern) => matchesGlob(normalized, pattern));
+}
+function detectPackageManager(manifest, files) {
+    const declared = manifest?.packageManager?.split("@")[0];
+    if (declared === "npm" || declared === "pnpm" || declared === "yarn" || declared === "bun") {
+        return declared;
+    }
+    if (files.includes("pnpm-lock.yaml"))
+        return "pnpm";
+    if (files.includes("yarn.lock"))
+        return "yarn";
+    if (files.includes("bun.lockb") || files.includes("bun.lock"))
+        return "bun";
+    if (files.includes("package-lock.json"))
+        return "npm";
+    return undefined;
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+function isHttpMethod(value) {
+    return ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS", "TRACE"].includes(value);
+}
+function extractRequestSchemas(operation) {
+    const requestBody = asRecord(operation.requestBody);
+    return extractSchemasFromContent(asRecord(requestBody.content));
+}
+function extractResponseSchemas(operation) {
+    const responses = {};
+    for (const [status, response] of Object.entries(asRecord(operation.responses))) {
+        responses[status] = extractSchemasFromContent(asRecord(asRecord(response).content));
+    }
+    return responses;
+}
+function extractSchemasFromContent(content) {
+    const schemas = new Set();
+    for (const media of Object.values(content)) {
+        const schema = asRecord(asRecord(media).schema);
+        const name = schemaName(schema);
+        if (name)
+            schemas.add(name);
+    }
+    return [...schemas].sort();
+}
+function schemaName(schema) {
+    const ref = schema.$ref;
+    if (typeof ref === "string")
+        return ref.split("/").at(-1);
+    const title = schema.title;
+    return typeof title === "string" ? title : undefined;
+}
+async function fileSize(root, file) {
+    try {
+        return (await stat(join(root, file))).size;
+    }
+    catch {
+        return 0;
+    }
+}
+function normalizePath(path) {
+    return path.replaceAll("\\", "/").replace(/^\.\//, "").replace(/\/+$/, "");
+}
+function matchesGlob(path, pattern) {
+    const normalized = normalizePath(pattern);
+    const escaped = normalized
+        .replace(/[.+^${}()|[\]\\]/g, "\\$&")
+        .replaceAll("**", "__DOUBLE_STAR__")
+        .replaceAll("*", "[^/]*")
+        .replaceAll("__DOUBLE_STAR__", ".*");
+    return new RegExp(`^${escaped}$`).test(path);
+}
+//# sourceMappingURL=repository.js.map

package/dist/src/repository.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,157 @@
+export type DriftStatus = "ok" | "review_needed" | "broken";
+export type DriftSeverity = "low" | "medium" | "high";
+export interface DocumentRecord {
+    path: string;
+    kind: "agent_instruction" | "markdown";
+    lineCount: number;
+    text: string;
+}
+export interface PackageManifest {
+    name?: string;
+    version?: string;
+    packageManager?: string;
+    scripts: Record<string, string>;
+}
+export interface ApiOperation {
+    specPath: string;
+    method: string;
+    path: string;
+    operationId?: string;
+    requestSchemas: string[];
+    responseSchemas: Record<string, string[]>;
+}
+export interface ReviewLogEntry {
+    findingId: string;
+    decision: "accepted" | "false_positive" | "deferred" | "fixed";
+    reviewer: string;
+    reviewedAt: string;
+    expiresAt?: string;
+    note?: string;
+}
+export interface EvidocConfig {
+    docRoots?: string[];
+    ignorePatterns?: string[];
+    severityOverrides?: Record<string, DriftSeverity>;
+    apiSpecPaths?: string[];
+    ownerMapping?: Record<string, string>;
+    reviewTtlDays?: number;
+    requireTestsForSources?: boolean;
+    requireDocsForChangedSources?: boolean;
+    maxFileBytes?: number;
+    concurrency?: number;
+}
+export interface RepositorySnapshot {
+    root: string;
+    files: Set<string>;
+    documents: DocumentRecord[];
+    packageManifest?: PackageManifest;
+    expectedPackageManager?: "npm" | "pnpm" | "yarn" | "bun";
+    apiOperations: ApiOperation[];
+    config: EvidocConfig;
+    reviewLog: ReviewLogEntry[];
+    skippedOversized: number;
+}
+export interface CheckRepositoryOptions {
+    changedFiles?: string[];
+    changedSourceFiles?: string[];
+    undocumentedChangedFiles?: string[];
+    now?: Date;
+}
+export interface DriftEvidence {
+    kind: "agent_instruction" | "api" | "command" | "config" | "coverage" | "frontmatter" | "path" | "review_log" | "symbol";
+    subject: string;
+    expected?: string;
+    actual?: string;
+    detail: string;
+}
+export interface DriftFinding {
+    id: string;
+    ruleId: string;
+    severity: DriftSeverity;
+    status: Exclude<DriftStatus, "ok">;
+    docPath: string;
+    line: number;
+    message: string;
+    evidence: DriftEvidence[];
+    suggestedAction: string;
+    review?: {
+        decision: ReviewLogEntry["decision"];
+        reviewer: string;
+        reviewedAt: string;
+        expiresAt?: string;
+    };
+}
+export interface DriftSummary {
+    documentsScanned: number;
+    findings: number;
+    broken: number;
+    reviewNeeded: number;
+    reviewSuppressed: number;
+    skippedOversized: number;
+    healthScore?: number;
+    byRule: Record<string, number>;
+    bySeverity: Record<DriftSeverity, number>;
+}
+export interface DriftReport {
+    root: string;
+    scannedAt: string;
+    documents: Array<Pick<DocumentRecord, "path" | "kind" | "lineCount">>;
+    findings: DriftFinding[];
+    summary: DriftSummary;
+}
+export type AgentRuntimeEvent = "pre-commit" | "pre-push" | "manual" | "mcp" | "ide";
+export type AgentRuntimeMode = "advisory" | "blocking";
+export type AgentRuntimeScope = "staged" | "worktree" | "full_repository";
+export type AgentRuntimeStatus = "passed" | "review_needed" | "failed";
+export interface AgentRuntimeFinding {
+    fingerprint: string;
+    findingId: string;
+    ruleId: string;
+    status: Exclude<DriftStatus, "ok">;
+    severity: DriftSeverity;
+    location: string;
+    message: string;
+    suggestedAction: string;
+}
+export interface AgentRuntimeContract {
+    schemaVersion: "evidoc.agent-runtime.v1";
+    source: "evidoc";
+    event: AgentRuntimeEvent;
+    mode: AgentRuntimeMode;
+    scope: AgentRuntimeScope;
+    baseline?: string;
+    baselineCommit?: string;
+    status: AgentRuntimeStatus;
+    fingerprint: string;
+    generatedAt: string;
+    scannedAt: string;
+    summary: {
+        findings: number;
+        broken: number;
+        reviewNeeded: number;
+    };
+    findings: AgentRuntimeFinding[];
+    dedupe: {
+        strategy: "runtime.findings[].fingerprint";
+        fingerprintCount: number;
+    };
+    changedFiles?: string[];
+    changedFileFingerprints?: Record<string, string>;
+    affectedDocuments?: string[];
+}
+export interface MultiRepositoryReport {
+    scannedAt: string;
+    repositories: DriftReport[];
+    summary: {
+        repositoriesScanned: number;
+        documentsScanned: number;
+        findings: number;
+        broken: number;
+        reviewNeeded: number;
+        reviewSuppressed: number;
+        skippedOversized: number;
+        healthScore?: number;
+        byRule: Record<string, number>;
+        bySeverity: Record<DriftSeverity, number>;
+    };
+}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

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

package/dist/src/workflow-warnings.d.ts

@@ -0,0 +1,18 @@
+export interface WorkflowLocalActionDefinition {
+    path: string;
+    text: string;
+}
+export interface EvidocWorkflowTextDetection {
+    matches: boolean;
+    localActions: WorkflowLocalActionDefinition[];
+}
+export type WorkflowLocalActionReader = (repoRelativeActionPath: string) => Promise<WorkflowLocalActionDefinition | undefined>;
+export declare function isEvidocWorkflowText(text: string): boolean;
+export declare function detectEvidocWorkflowText(text: string, readLocalAction: WorkflowLocalActionReader, options?: {
+    maxLocalActionDepth?: number;
+}): Promise<EvidocWorkflowTextDetection>;
+export declare function detectRepositoryEvidocWorkflowText(root: string, text: string, options?: {
+    maxLocalActionDepth?: number;
+}): Promise<EvidocWorkflowTextDetection>;
+export declare function workflowLocalActionPaths(text: string): string[];
+export declare function evidocWorkflowWarnings(path: string, text: string, defaultBranch: string | undefined): string[];