wabachi 0.1.0

package/dist/runtime/typescriptProvider.js

@@ -0,0 +1,289 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import ts from "typescript";
+import { OBSERVATION_SCHEMA_VERSION, } from "./observation.js";
+/**
+ * Compiler-authoritative semantic evidence provider (Issue #7). Discovers
+ * the workspace's TypeScript project configuration, builds a Program using
+ * full TypeScript compiler/TypeChecker semantics, and emits both lossless
+ * raw evidence and normalized observations (Issue #5 envelope) for
+ * declarations/symbols, references, imports/exports, type relationships,
+ * extends/implements, and statically resolvable calls.
+ */
+export function createTypeScriptProvider() {
+    return {
+        identity: { id: "typescript", version: ts.version, determinism: "deterministic" },
+        async isAvailable(context) {
+            return findTsconfig(context.workspaceRoot) !== undefined;
+        },
+        async execute(context) {
+            const startedAt = new Date().toISOString();
+            const tsconfigPath = findTsconfig(context.workspaceRoot);
+            if (tsconfigPath === undefined) {
+                throw new Error("no tsconfig.json found in workspace");
+            }
+            const configFile = ts.readConfigFile(tsconfigPath, ts.sys.readFile);
+            if (configFile.error) {
+                throw new Error(formatDiagnostic(configFile.error));
+            }
+            const parsed = ts.parseJsonConfigFileContent(configFile.config, ts.sys, path.dirname(tsconfigPath));
+            const program = ts.createProgram({
+                rootNames: parsed.fileNames,
+                options: parsed.options,
+            });
+            const checker = program.getTypeChecker();
+            const rootFileNames = new Set(parsed.fileNames.map((file) => path.resolve(file)));
+            const sourceFiles = program
+                .getSourceFiles()
+                .filter((sf) => !sf.isDeclarationFile && rootFileNames.has(path.resolve(sf.fileName)));
+            const collector = new ObservationCollector(checker, context);
+            for (const sourceFile of sourceFiles) {
+                collector.visitSourceFile(sourceFile);
+            }
+            const diagnostics = ts.getPreEmitDiagnostics(program).map((diagnostic) => formatDiagnosticEntry(diagnostic));
+            const metaRelativePath = "meta.json";
+            const meta = {
+                typescriptVersion: ts.version,
+                tsconfigPath: path.relative(context.workspaceRoot, tsconfigPath),
+                compilerOptions: sanitizeCompilerOptions(parsed.options),
+                rootFiles: parsed.fileNames.map((file) => path.relative(context.workspaceRoot, file)).sort(),
+                diagnosticCount: diagnostics.length,
+            };
+            await writeFile(path.join(context.artifactRoot, metaRelativePath), `${JSON.stringify(meta, null, 2)}\n`, "utf8");
+            const diagnosticsRelativePath = "diagnostics.json";
+            await writeFile(path.join(context.artifactRoot, diagnosticsRelativePath), `${JSON.stringify(diagnostics, null, 2)}\n`, "utf8");
+            const observationsRelativePath = "observations.jsonl";
+            const observationsLines = collector.observations.map((observation) => JSON.stringify(observation));
+            await writeFile(path.join(context.artifactRoot, observationsRelativePath), observationsLines.length > 0 ? `${observationsLines.join("\n")}\n` : "", "utf8");
+            const nativeDir = "native";
+            await mkdir(path.join(context.artifactRoot, nativeDir), { recursive: true });
+            const nativeArtifacts = [];
+            for (const [relPath, symbols] of collector.nativeBySourceFile) {
+                const nativeRelativePath = path.join(nativeDir, `${sanitizeFileName(relPath)}.json`);
+                await writeFile(path.join(context.artifactRoot, nativeRelativePath), `${JSON.stringify(symbols, null, 2)}\n`, "utf8");
+                nativeArtifacts.push(nativeRelativePath);
+            }
+            return {
+                status: "ok",
+                artifacts: [metaRelativePath, diagnosticsRelativePath, observationsRelativePath, ...nativeArtifacts],
+                observationArtifacts: [observationsRelativePath],
+                startedAt,
+                finishedAt: new Date().toISOString(),
+            };
+        },
+    };
+}
+function findTsconfig(workspaceRoot) {
+    const candidate = path.join(workspaceRoot, "tsconfig.json");
+    return ts.sys.fileExists(candidate) ? candidate : undefined;
+}
+function sanitizeCompilerOptions(options) {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(options)) {
+        if (key === "configFilePath")
+            continue;
+        if (typeof value === "object" && value !== null)
+            continue;
+        sanitized[key] = value;
+    }
+    return sanitized;
+}
+function sanitizeFileName(relPath) {
+    return relPath.replace(/[\\/]/gu, "__");
+}
+function formatDiagnostic(diagnostic) {
+    return ts.flattenDiagnosticMessageText(diagnostic.messageText, "\n");
+}
+function formatDiagnosticEntry(diagnostic) {
+    const entry = {
+        category: ts.DiagnosticCategory[diagnostic.category],
+        code: diagnostic.code,
+        message: ts.flattenDiagnosticMessageText(diagnostic.messageText, "\n"),
+    };
+    if (diagnostic.file && diagnostic.start !== undefined) {
+        const { line, character } = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);
+        entry.file = diagnostic.file.fileName;
+        entry.line = line + 1;
+        entry.column = character + 1;
+    }
+    return entry;
+}
+/** Declarations that carry a symbol worth emitting as a `defines` observation. */
+const NAMED_DECLARATION_KINDS = new Set([
+    ts.SyntaxKind.ClassDeclaration,
+    ts.SyntaxKind.InterfaceDeclaration,
+    ts.SyntaxKind.TypeAliasDeclaration,
+    ts.SyntaxKind.EnumDeclaration,
+    ts.SyntaxKind.FunctionDeclaration,
+    ts.SyntaxKind.MethodDeclaration,
+    ts.SyntaxKind.MethodSignature,
+    ts.SyntaxKind.PropertyDeclaration,
+    ts.SyntaxKind.PropertySignature,
+    ts.SyntaxKind.GetAccessor,
+    ts.SyntaxKind.SetAccessor,
+    ts.SyntaxKind.VariableDeclaration,
+    ts.SyntaxKind.ModuleDeclaration,
+]);
+class ObservationCollector {
+    checker;
+    observations = [];
+    nativeBySourceFile = new Map();
+    repository;
+    workspaceRoot;
+    providerIdentity;
+    constructor(checker, context) {
+        this.checker = checker;
+        this.repository = context.repository;
+        this.workspaceRoot = context.workspaceRoot;
+        this.providerIdentity = { id: "typescript", version: ts.version, determinism: "deterministic" };
+    }
+    visitSourceFile(sourceFile) {
+        const relPath = path.relative(this.workspaceRoot, sourceFile.fileName);
+        const nativeEntries = [];
+        this.nativeBySourceFile.set(relPath, nativeEntries);
+        const visit = (node) => {
+            if (NAMED_DECLARATION_KINDS.has(node.kind)) {
+                this.emitDefinition(sourceFile, node, nativeEntries);
+            }
+            if (ts.isClassDeclaration(node) || ts.isInterfaceDeclaration(node)) {
+                this.emitHeritage(sourceFile, node);
+            }
+            if (ts.isImportDeclaration(node)) {
+                this.emitImport(sourceFile, node);
+            }
+            if (ts.isExportDeclaration(node) || ts.isExportAssignment(node)) {
+                this.emitExport(sourceFile, node);
+            }
+            if (ts.isCallExpression(node)) {
+                this.emitCall(sourceFile, node);
+            }
+            ts.forEachChild(node, visit);
+        };
+        for (const statement of sourceFile.statements) {
+            if (hasExportModifier(statement)) {
+                this.emitModifierExport(sourceFile, statement);
+            }
+        }
+        ts.forEachChild(sourceFile, visit);
+    }
+    span(sourceFile, node) {
+        const start = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
+        const end = sourceFile.getLineAndCharacterOfPosition(node.getEnd());
+        return `L${start.line + 1}C${start.character + 1}-L${end.line + 1}C${end.character + 1}`;
+    }
+    evidence(sourceFile, node) {
+        return { path: path.relative(this.workspaceRoot, sourceFile.fileName), span: this.span(sourceFile, node) };
+    }
+    push(predicate, subject, object, source, native) {
+        this.observations.push({
+            schemaVersion: OBSERVATION_SCHEMA_VERSION,
+            subject,
+            predicate,
+            object,
+            provider: this.providerIdentity,
+            repository: this.repository,
+            source,
+            determinism: "deterministic",
+            providerNative: native,
+        });
+    }
+    emitDefinition(sourceFile, node, nativeEntries) {
+        if (node.name === undefined || !isIdentifierLike(node.name))
+            return;
+        const symbol = this.checker.getSymbolAtLocation(node.name);
+        const name = node.name.getText(sourceFile);
+        const kind = ts.SyntaxKind[node.kind];
+        const span = this.span(sourceFile, node);
+        const qualifiedName = symbol ? this.checker.getFullyQualifiedName(symbol) : name;
+        const symbolFlags = symbol ? (ts.SymbolFlags[symbol.flags] ?? symbol.flags) : undefined;
+        const typeText = symbol ? safeTypeToString(this.checker, symbol, node) : undefined;
+        nativeEntries.push({ kind, name, qualifiedName, symbolFlags, type: typeText, span });
+        const relPath = path.relative(this.workspaceRoot, sourceFile.fileName);
+        this.push("defines", { id: relPath, kind: "module" }, { id: qualifiedName, kind }, this.evidence(sourceFile, node), { kind, name, qualifiedName, symbolFlags, type: typeText, span });
+    }
+    emitHeritage(sourceFile, node) {
+        if (node.name === undefined)
+            return;
+        const subjectSymbol = this.checker.getSymbolAtLocation(node.name);
+        const subjectName = subjectSymbol
+            ? this.checker.getFullyQualifiedName(subjectSymbol)
+            : node.name.getText(sourceFile);
+        const subjectKind = ts.SyntaxKind[node.kind];
+        for (const clause of node.heritageClauses ?? []) {
+            const predicate = clause.token === ts.SyntaxKind.ExtendsKeyword ? "extends" : "implements";
+            for (const typeExpr of clause.types) {
+                const objectName = typeExpr.expression.getText(sourceFile);
+                const objectSymbol = this.checker.getSymbolAtLocation(typeExpr.expression);
+                const qualifiedObjectName = objectSymbol ? this.checker.getFullyQualifiedName(objectSymbol) : objectName;
+                this.push(predicate, { id: subjectName, kind: subjectKind }, { id: qualifiedObjectName, kind: "type-reference" }, this.evidence(sourceFile, typeExpr), { subjectKind, subject: subjectName, predicate, object: qualifiedObjectName });
+            }
+        }
+    }
+    emitImport(sourceFile, node) {
+        const moduleSpecifier = node.moduleSpecifier.getText(sourceFile).replace(/^['"]|['"]$/gu, "");
+        const relPath = path.relative(this.workspaceRoot, sourceFile.fileName);
+        this.push("imports", { id: relPath, kind: "module" }, { id: moduleSpecifier, kind: "module" }, this.evidence(sourceFile, node), { text: node.getText(sourceFile) });
+    }
+    emitExport(sourceFile, node) {
+        const relPath = path.relative(this.workspaceRoot, sourceFile.fileName);
+        const moduleSpecifier = ts.isExportDeclaration(node) && node.moduleSpecifier
+            ? node.moduleSpecifier.getText(sourceFile).replace(/^['"]|['"]$/gu, "")
+            : undefined;
+        this.push("exports", { id: relPath, kind: "module" }, { id: moduleSpecifier ?? relPath, kind: "module" }, this.evidence(sourceFile, node), { text: node.getText(sourceFile) });
+    }
+    emitModifierExport(sourceFile, statement) {
+        const relPath = path.relative(this.workspaceRoot, sourceFile.fileName);
+        const names = declaredNames(statement);
+        for (const name of names.length > 0 ? names : [relPath]) {
+            this.push("exports", { id: relPath, kind: "module" }, { id: name, kind: "declaration" }, this.evidence(sourceFile, statement), { text: statement.getText(sourceFile).slice(0, 200) });
+        }
+    }
+    emitCall(sourceFile, node) {
+        const signature = this.checker.getResolvedSignature(node);
+        const declaration = signature?.declaration;
+        const calleeText = node.expression.getText(sourceFile);
+        const relPath = path.relative(this.workspaceRoot, sourceFile.fileName);
+        if (!declaration || !declaration.getSourceFile()) {
+            // Unresolved call target (e.g. dynamic/ambient): record what the compiler can see without inventing a resolution.
+            return;
+        }
+        const symbol = this.checker.getSymbolAtLocation(node.expression);
+        const calleeName = symbol ? this.checker.getFullyQualifiedName(symbol) : calleeText;
+        this.push("calls", { id: `${relPath}#${this.span(sourceFile, node)}`, kind: "call-site" }, { id: calleeName, kind: "function" }, this.evidence(sourceFile, node), { calleeText });
+    }
+}
+function isIdentifierLike(node) {
+    return ts.isIdentifier(node);
+}
+function hasExportModifier(node) {
+    const modifiers = ts.canHaveModifiers(node) ? ts.getModifiers(node) : undefined;
+    return modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword) ?? false;
+}
+function declaredNames(statement) {
+    if (ts.isVariableStatement(statement)) {
+        return statement.declarationList.declarations
+            .map((decl) => (ts.isIdentifier(decl.name) ? decl.name.text : undefined))
+            .filter((name) => name !== undefined);
+    }
+    if ((ts.isClassDeclaration(statement) ||
+        ts.isInterfaceDeclaration(statement) ||
+        ts.isFunctionDeclaration(statement) ||
+        ts.isTypeAliasDeclaration(statement) ||
+        ts.isEnumDeclaration(statement) ||
+        ts.isModuleDeclaration(statement)) &&
+        statement.name !== undefined &&
+        ts.isIdentifier(statement.name)) {
+        return [statement.name.text];
+    }
+    return [];
+}
+function safeTypeToString(checker, symbol, node) {
+    try {
+        const type = checker.getTypeOfSymbolAtLocation(symbol, node);
+        return checker.typeToString(type);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=typescriptProvider.js.map

package/dist/runtime/typescriptProvider.js.map

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

package/dist/runtime/workflow.d.ts

@@ -0,0 +1,30 @@
+import { type FactNormalizationResult } from "./facts.js";
+import { type ProviderMatrix, type ProviderMatrixArtifactPaths } from "./matrix.js";
+import type { CorrelationResult } from "./correlation.js";
+import type { Provider, ProviderIdentity } from "./provider.js";
+import { type RunResult } from "./run.js";
+export declare const MATRIX_WORKFLOW_SCHEMA_VERSION: 1;
+export interface MatrixWorkflowOptions {
+    readonly source: string;
+    /** A full, explicit commit SHA; symbolic refs are deliberately rejected. */
+    readonly revision: string;
+    readonly runRoot: string;
+    readonly providers: readonly Provider[];
+    readonly additionOrder?: readonly ProviderIdentity[];
+}
+export interface MatrixWorkflowResult extends RunResult {
+    readonly observationPath: string;
+    readonly normalizedFactsPath: string;
+    readonly correlationPath: string;
+    readonly matrix: ProviderMatrix;
+    readonly matrixPaths: ProviderMatrixArtifactPaths;
+}
+/**
+ * Executes providers once, then builds every downstream artifact exclusively
+ * from the persisted observation/fact artifacts. No model or provider is
+ * consulted during matrix generation.
+ */
+export declare function runProviderMatrix(options: MatrixWorkflowOptions): Promise<MatrixWorkflowResult>;
+/** Public type anchor for callers that persist the result for later review. */
+export type MatrixNormalizationResult = FactNormalizationResult;
+export type MatrixCorrelation = CorrelationResult;

package/dist/runtime/workflow.js

@@ -0,0 +1,153 @@
+import { createReadStream, createWriteStream } from "node:fs";
+import { mkdir, readFile, unlink, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { pipeline as pipelineCallback } from "node:stream";
+import { createGzip } from "node:zlib";
+import { promisify } from "node:util";
+import { FACT_SCHEMA_VERSION, normalizeFacts, validateObservationEnvelope, } from "./facts.js";
+import { buildProviderMatrix, writeNormalizedFactsArtifact, writeProviderMatrixArtifacts, } from "./matrix.js";
+import { OBSERVATION_SCHEMA_VERSION } from "./observation.js";
+import { writeManifest } from "./manifest.js";
+import { run } from "./run.js";
+const pipeline = promisify(pipelineCallback);
+export const MATRIX_WORKFLOW_SCHEMA_VERSION = 1;
+/**
+ * Executes providers once, then builds every downstream artifact exclusively
+ * from the persisted observation/fact artifacts. No model or provider is
+ * consulted during matrix generation.
+ */
+export async function runProviderMatrix(options) {
+    assertCommitSha(options.revision);
+    const runRoot = path.resolve(options.runRoot);
+    const configuredProviderIdentities = options.providers.map((provider) => provider.identity);
+    const configuredAdditionOrder = options.additionOrder ?? configuredProviderIdentities;
+    await mkdir(runRoot, { recursive: true });
+    await writeJson(path.join(runRoot, "config.json"), {
+        schemaVersion: MATRIX_WORKFLOW_SCHEMA_VERSION,
+        command: "matrix",
+        source: options.source,
+        revision: options.revision.toLowerCase(),
+        nodeOptions: process.env.NODE_OPTIONS ?? "default",
+        providers: configuredProviderIdentities.map((provider) => provider.id),
+        additionOrder: configuredAdditionOrder.map((provider) => provider.id),
+    });
+    const runResult = await run({
+        source: options.source,
+        revision: options.revision.toLowerCase(),
+        runRoot,
+        providers: options.providers,
+    });
+    if (runResult.manifest.repository.commitSha !== options.revision.toLowerCase()) {
+        throw new Error(`resolved commit ${runResult.manifest.repository.commitSha} does not equal requested SHA ${options.revision}`);
+    }
+    const observations = await readObservationArtifacts(runRoot, runResult);
+    const observationPath = path.join(runRoot, "normalized", "observations.json");
+    await writeJson(observationPath, {
+        schemaVersion: OBSERVATION_SCHEMA_VERSION,
+        repository: runResult.manifest.repository,
+        observations,
+    });
+    const normalized = normalizeFacts(observations, {
+        providers: runResult.manifest.providers.map((entry) => entry.identity),
+        includeComparisons: false,
+    });
+    const normalizedFactsPath = path.join(runRoot, "normalized", "facts.json");
+    await writeNormalizedFactsArtifact(normalizedFactsPath, normalized);
+    const correlationPath = path.join(runRoot, "normalized", "correlation.json");
+    await writeJson(correlationPath, {
+        schemaVersion: 1,
+        inputFactSchemaVersion: FACT_SCHEMA_VERSION,
+        repository: runResult.manifest.repository,
+        providers: runResult.manifest.providers.map((entry) => entry.identity),
+        correlation: normalized.correlation,
+    });
+    const manifestIdentityById = new Map(runResult.manifest.providers.map((entry) => [entry.identity.id, entry.identity]));
+    const mappedAdditionOrder = configuredAdditionOrder
+        .map((configured) => manifestIdentityById.get(configured.id))
+        .filter((identity) => identity !== undefined);
+    const matrix = buildProviderMatrix(normalized, {
+        providers: runResult.manifest.providers.map((entry) => entry.identity),
+        additionOrder: mappedAdditionOrder.length > 0 ? mappedAdditionOrder : undefined,
+    });
+    const matrixPaths = await writeProviderMatrixArtifacts(runRoot, matrix);
+    const retainedManifest = await retainRawProviderArtifacts(runRoot, runResult.manifest);
+    await writeManifest(runRoot, retainedManifest);
+    return {
+        ...runResult,
+        manifest: retainedManifest,
+        observationPath,
+        normalizedFactsPath,
+        correlationPath,
+        matrix,
+        matrixPaths,
+    };
+}
+/**
+ * Raw provider output can exceed ordinary repository file limits. gzip is
+ * lossless, keeps the original relative path in the suffix, and is recorded
+ * in the manifest rather than silently replacing evidence.
+ */
+async function retainRawProviderArtifacts(runRoot, manifest) {
+    const providers = [];
+    for (const entry of manifest.providers) {
+        if (entry.result.status !== "ok") {
+            providers.push(entry);
+            continue;
+        }
+        const retainedArtifacts = [];
+        for (const relativePath of entry.result.artifacts) {
+            const sourcePath = path.join(runRoot, "raw", entry.identity.id, relativePath);
+            const retainedPath = `${relativePath}.gz`;
+            const destinationPath = path.join(runRoot, "raw", entry.identity.id, retainedPath);
+            await pipeline(createReadStream(sourcePath), createGzip(), createWriteStream(destinationPath));
+            await unlink(sourcePath);
+            retainedArtifacts.push(retainedPath);
+        }
+        providers.push({
+            ...entry,
+            result: { ...entry.result, retainedArtifacts },
+        });
+    }
+    return { ...manifest, providers };
+}
+async function readObservationArtifacts(runRoot, result) {
+    const observations = [];
+    for (const entry of result.manifest.providers) {
+        if (entry.result.status !== "ok")
+            continue;
+        for (const relativePath of entry.result.observationArtifacts ?? []) {
+            if (path.isAbsolute(relativePath) || relativePath.split(path.sep).includes("..")) {
+                throw new Error(`provider ${entry.identity.id} returned an unsafe observation artifact path`);
+            }
+            const filePath = path.join(runRoot, "raw", entry.identity.id, relativePath);
+            const content = await readFile(filePath, "utf8");
+            const values = relativePath.endsWith(".jsonl")
+                ? content
+                    .split("\n")
+                    .filter((line) => line.trim().length > 0)
+                    .map((line) => JSON.parse(line))
+                : JSON.parse(content);
+            if (!Array.isArray(values))
+                throw new Error(`observation artifact is not an array: ${filePath}`);
+            for (const value of values) {
+                const validation = validateObservationEnvelope(value);
+                const structuralErrors = validation.errors.filter((error) => error !== "predicate is not a supported observation predicate");
+                if (structuralErrors.length > 0) {
+                    throw new Error(`invalid observation in ${filePath}: ${structuralErrors.join("; ")}`);
+                }
+                observations.push(value);
+            }
+        }
+    }
+    return observations;
+}
+function assertCommitSha(value) {
+    if (!/^[0-9a-f]{40}$/iu.test(value)) {
+        throw new Error("matrix requires an explicit 40-character commit SHA via --revision");
+    }
+}
+async function writeJson(filePath, value) {
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+//# sourceMappingURL=workflow.js.map

package/dist/runtime/workflow.js.map

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

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "wabachi",
+  "version": "0.1.0",
+  "description": "Repository analysis and Architecture Canon tooling for deterministic codebase understanding.",
+  "type": "module",
+  "bin": {
+    "wabachi": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/chmod-bin.mjs",
+    "start": "node dist/index.js",
+    "test": "node --test --import tsx src/**/*.test.ts scripts/**/*.test.mjs",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint 'src/**/*.ts' 'scripts/**/*.mjs' 'eslint.config.mjs'",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "smoke-test": "node scripts/smoke-test.mjs",
+    "test:package": "pnpm run build && node scripts/run-package-suite.mjs",
+    "governance:actions": "node scripts/validate-action-pins.mjs",
+    "verify": "pnpm run format:check && pnpm run lint && pnpm run typecheck && pnpm test && pnpm run governance:actions && pnpm run test:package",
+    "prepack": "pnpm run build",
+    "prepublishOnly": "pnpm run typecheck && pnpm test"
+  },
+  "dependencies": {
+    "@sourcegraph/scip-typescript": "0.4.0",
+    "typescript": "^6.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^26.5.1",
+    "eslint": "10.8.1",
+    "js-yaml": "^4.1.0",
+    "prettier": "3.9.6",
+    "tsx": "^4.23.12",
+    "typescript-eslint": "8.67.0"
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "packageManager": "pnpm@11.18.0",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "executableFiles": [
+      "dist/index.js"
+    ]
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yohn-jp/wabachi.git"
+  },
+  "homepage": "https://github.com/yohn-jp/wabachi#readme",
+  "bugs": {
+    "url": "https://github.com/yohn-jp/wabachi/issues"
+  },
+  "keywords": [
+    "architecture",
+    "codebase",
+    "repository-analysis",
+    "scip",
+    "typescript",
+    "developer-tools",
+    "ai-agents"
+  ],
+  "main": "dist/index.js",
+  "types": "./dist/index.d.ts"
+}