cxgrd 0.1.0

package/dist/check/parsers/tsc-cli.js

@@ -0,0 +1,22 @@
+/** Fallback parser for `tsc --noEmit` stdout when programmatic API is unavailable. */
+const TSC_LINE = /^(?<file>.+)\((?<line>\d+),(?<column>\d+)\):\s+(?<severity>error|warning)\s+(?<code>TS\d+):\s+(?<message>.+)$/;
+export function parseTscCliOutput(output) {
+    const issues = [];
+    for (const line of output.split('\n')) {
+        const match = line.trim().match(TSC_LINE);
+        if (!match?.groups)
+            continue;
+        issues.push({
+            severity: match.groups.severity === 'error' ? 'error' : 'warning',
+            message: match.groups.message,
+            file: match.groups.file,
+            line: Number.parseInt(match.groups.line, 10),
+            column: Number.parseInt(match.groups.column, 10),
+            code: match.groups.code,
+            source: 'compiler',
+            language: 'typescript',
+        });
+    }
+    return issues;
+}
+//# sourceMappingURL=tsc-cli.js.map

package/dist/check/parsers/tsc-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsc-cli.js","sourceRoot":"","sources":["../../../src/check/parsers/tsc-cli.ts"],"names":[],"mappings":"AAEA,sFAAsF;AACtF,MAAM,QAAQ,GACZ,+GAA+G,CAAC;AAElH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,EAAE,MAAM;YAAE,SAAS;QAE7B,MAAM,CAAC,IAAI,CAAC;YACV,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YACjE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;YAC7B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;YACvB,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5C,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YAChD,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;YACvB,MAAM,EAAE,UAAU;YAClB,QAAQ,EAAE,YAAY;SACvB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/check/project-tooling.d.ts

@@ -0,0 +1,18 @@
+export interface TypeScriptProject {
+    configPath: string;
+    rootDir: string;
+}
+export interface RustWorkspace {
+    manifestPath: string;
+    rootDir: string;
+}
+export interface PythonProject {
+    rootDir: string;
+    configPath?: string;
+}
+export declare function discoverTypeScriptProjects(projectRoot: string): Promise<TypeScriptProject[]>;
+export declare function discoverRustWorkspaces(projectRoot: string): Promise<RustWorkspace[]>;
+export declare function discoverPythonProjects(projectRoot: string): Promise<PythonProject[]>;
+export declare function projectOverlapsScope(projectDir: string, projectRoot: string, scopeFiles: Set<string> | null): boolean;
+export declare function pathExists(path: string): Promise<boolean>;
+//# sourceMappingURL=project-tooling.d.ts.map

package/dist/check/project-tooling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-tooling.d.ts","sourceRoot":"","sources":["../../src/check/project-tooling.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmDD,wBAAsB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAMlG;AAED,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAM1F;AAED,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAyB1F;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,GAC7B,OAAO,CAiBT;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D"}

package/dist/check/project-tooling.js

@@ -0,0 +1,105 @@
+import { readdir, stat } from 'fs/promises';
+import { join, dirname, relative } from 'path';
+const IGNORE_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '.next',
+    'target',
+    '.cg',
+    'coverage',
+    '.venv',
+    'venv',
+    '__pycache__',
+]);
+async function walkForFiles(root, matcher, maxDepth = 6) {
+    const found = [];
+    async function walk(dir, depth) {
+        if (depth > maxDepth)
+            return;
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.isDirectory() && IGNORE_DIRS.has(entry.name)) {
+                continue;
+            }
+            const fullPath = join(dir, entry.name);
+            if (entry.isFile() && matcher(entry.name)) {
+                found.push(fullPath);
+            }
+            else if (entry.isDirectory()) {
+                await walk(fullPath, depth + 1);
+            }
+        }
+    }
+    await walk(root, 0);
+    return found;
+}
+export async function discoverTypeScriptProjects(projectRoot) {
+    const configs = await walkForFiles(projectRoot, (name) => name === 'tsconfig.json');
+    return configs.map((configPath) => ({
+        configPath,
+        rootDir: dirname(configPath),
+    }));
+}
+export async function discoverRustWorkspaces(projectRoot) {
+    const manifests = await walkForFiles(projectRoot, (name) => name === 'Cargo.toml');
+    return manifests.map((manifestPath) => ({
+        manifestPath,
+        rootDir: dirname(manifestPath),
+    }));
+}
+export async function discoverPythonProjects(projectRoot) {
+    const roots = new Set();
+    const pyproject = await walkForFiles(projectRoot, (name) => name === 'pyproject.toml');
+    for (const path of pyproject) {
+        roots.add(dirname(path));
+    }
+    const requirements = await walkForFiles(projectRoot, (name) => name === 'requirements.txt');
+    for (const path of requirements) {
+        roots.add(dirname(path));
+    }
+    // If .py files exist at root but no config, still allow pyright at project root
+    if (roots.size === 0) {
+        const pyFiles = await walkForFiles(projectRoot, (name) => name.endsWith('.py'));
+        if (pyFiles.length > 0) {
+            roots.add(projectRoot);
+        }
+    }
+    return [...roots].map((rootDir) => ({
+        rootDir,
+        configPath: pyproject.find((p) => dirname(p) === rootDir),
+    }));
+}
+export function projectOverlapsScope(projectDir, projectRoot, scopeFiles) {
+    if (!scopeFiles) {
+        return true;
+    }
+    if (scopeFiles.size === 0) {
+        return false;
+    }
+    const relProject = relative(projectRoot, projectDir).replace(/\\/g, '/') || '.';
+    const prefix = relProject === '.' ? '' : `${relProject}/`;
+    for (const file of scopeFiles) {
+        if (relProject === '.' || file.startsWith(prefix) || file === relProject) {
+            return true;
+        }
+    }
+    return false;
+}
+export async function pathExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=project-tooling.js.map

package/dist/check/project-tooling.js.map

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

package/dist/check/run-command.d.ts

@@ -0,0 +1,8 @@
+export interface CommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export declare function runCommand(command: string, args: string[], cwd: string, timeoutMs?: number): Promise<CommandResult>;
+export declare function commandExists(command: string): Promise<boolean>;
+//# sourceMappingURL=run-command.d.ts.map

package/dist/check/run-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.d.ts","sourceRoot":"","sources":["../../src/check/run-command.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,SAAS,SAAU,GAClB,OAAO,CAAC,aAAa,CAAC,CA0CxB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQrE"}

package/dist/check/run-command.js

@@ -0,0 +1,50 @@
+import { spawn } from 'child_process';
+export function runCommand(command, args, cwd, timeoutMs = 120000) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd,
+            shell: process.platform === 'win32',
+            env: process.env,
+        });
+        let stdout = '';
+        let stderr = '';
+        let settled = false;
+        const timer = setTimeout(() => {
+            if (!settled) {
+                child.kill();
+                reject(new Error(`Command timed out after ${timeoutMs}ms: ${command} ${args.join(' ')}`));
+            }
+        }, timeoutMs);
+        child.stdout?.on('data', (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr?.on('data', (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on('error', (err) => {
+            settled = true;
+            clearTimeout(timer);
+            reject(err);
+        });
+        child.on('close', (code) => {
+            settled = true;
+            clearTimeout(timer);
+            resolve({
+                stdout,
+                stderr,
+                exitCode: code ?? 1,
+            });
+        });
+    });
+}
+export async function commandExists(command) {
+    try {
+        const checkCmd = process.platform === 'win32' ? 'where' : 'which';
+        const result = await runCommand(checkCmd, [command], process.cwd(), 10000);
+        return result.exitCode === 0;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=run-command.js.map

package/dist/check/run-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.js","sourceRoot":"","sources":["../../src/check/run-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAQtC,MAAM,UAAU,UAAU,CACxB,OAAe,EACf,IAAc,EACd,GAAW,EACX,SAAS,GAAG,MAAO;IAEnB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACjC,GAAG;YACH,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;YACnC,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,KAAK,CAAC,IAAI,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA2B,SAAS,OAAO,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5F,CAAC;QACH,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACjC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACjC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC;gBACN,MAAM;gBACN,MAAM;gBACN,QAAQ,EAAE,IAAI,IAAI,CAAC;aACpB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,KAAM,CAAC,CAAC;QAC5E,OAAO,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/check/scope.d.ts

@@ -0,0 +1,11 @@
+export declare function normalizeProjectPath(projectRoot: string, filePath: string): string;
+/**
+ * Resolve which project-relative paths are in scope for this check run.
+ * Returns null when scope is "all" (no file filter).
+ */
+export declare function resolveScopeFiles(projectRoot: string, scope: 'all' | 'staged' | 'changed'): Set<string> | null;
+export declare function issueInScope(issueFile: string | undefined, scopeFiles: Set<string> | null, projectRoot: string): boolean;
+export declare function filterIssuesByScope<T extends {
+    file?: string;
+}>(issues: T[], scopeFiles: Set<string> | null, projectRoot: string): T[];
+//# sourceMappingURL=scope.d.ts.map

package/dist/check/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/check/scope.ts"],"names":[],"mappings":"AAGA,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMlF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAClC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAepB;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAC9B,WAAW,EAAE,MAAM,GAClB,OAAO,CAcT;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7D,MAAM,EAAE,CAAC,EAAE,EACX,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAC9B,WAAW,EAAE,MAAM,GAClB,CAAC,EAAE,CAKL"}

package/dist/check/scope.js

@@ -0,0 +1,46 @@
+import { relative } from 'path';
+import { ChangeDetector } from '../utils/change-detector';
+export function normalizeProjectPath(projectRoot, filePath) {
+    const rel = relative(projectRoot, filePath);
+    if (!rel || rel.startsWith('..')) {
+        return filePath.replace(/\\/g, '/');
+    }
+    return rel.replace(/\\/g, '/');
+}
+/**
+ * Resolve which project-relative paths are in scope for this check run.
+ * Returns null when scope is "all" (no file filter).
+ */
+export function resolveScopeFiles(projectRoot, scope) {
+    if (scope === 'all') {
+        return null;
+    }
+    const detector = new ChangeDetector(projectRoot);
+    const changed = detector.getChangedFiles();
+    const raw = scope === 'staged' ? changed.stagedFiles : [...new Set([...changed.stagedFiles, ...changed.unstaged])];
+    const scoped = new Set();
+    for (const file of raw) {
+        scoped.add(normalizeProjectPath(projectRoot, file));
+    }
+    return scoped;
+}
+export function issueInScope(issueFile, scopeFiles, projectRoot) {
+    if (!scopeFiles) {
+        return true;
+    }
+    if (!issueFile) {
+        return false;
+    }
+    const normalized = normalizeProjectPath(projectRoot, issueFile);
+    if (scopeFiles.has(normalized)) {
+        return true;
+    }
+    return [...scopeFiles].some((scoped) => normalized.startsWith(scoped) || scoped.startsWith(normalized));
+}
+export function filterIssuesByScope(issues, scopeFiles, projectRoot) {
+    if (!scopeFiles) {
+        return issues;
+    }
+    return issues.filter((issue) => issueInScope(issue.file, scopeFiles, projectRoot));
+}
+//# sourceMappingURL=scope.js.map

package/dist/check/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/check/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,UAAU,oBAAoB,CAAC,WAAmB,EAAE,QAAgB;IACxE,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,WAAmB,EACnB,KAAmC;IAEnC,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,eAAe,EAAE,CAAC;IAC3C,MAAM,GAAG,GACP,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEzG,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,SAA6B,EAC7B,UAA8B,EAC9B,WAAmB;IAEnB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,UAAU,GAAG,oBAAoB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAChE,IAAI,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CACzB,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAW,EACX,UAA8B,EAC9B,WAAmB;IAEnB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;AACrF,CAAC"}

package/dist/check/scope.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scope.test.d.ts.map

package/dist/check/scope.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.test.d.ts","sourceRoot":"","sources":["../../src/check/scope.test.ts"],"names":[],"mappings":""}

package/dist/check/scope.test.js

@@ -0,0 +1,15 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { issueInScope, normalizeProjectPath } from './scope';
+describe('scope', () => {
+    it('normalizes absolute paths to project-relative', () => {
+        const rel = normalizeProjectPath('C:/proj', 'C:/proj/cli/src/index.ts');
+        assert.equal(rel, 'cli/src/index.ts');
+    });
+    it('filters issues to scoped files', () => {
+        const scope = new Set(['cli/src/foo.ts']);
+        assert.equal(issueInScope('cli/src/foo.ts', scope, 'C:/proj'), true);
+        assert.equal(issueInScope('website/app/page.tsx', scope, 'C:/proj'), false);
+    });
+});
+//# sourceMappingURL=scope.test.js.map

package/dist/check/scope.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.test.js","sourceRoot":"","sources":["../../src/check/scope.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE7D,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACrB,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,GAAG,GAAG,oBAAoB,CAAC,SAAS,EAAE,0BAA0B,CAAC,CAAC;QACxE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CACV,YAAY,CAAC,gBAAgB,EAAE,KAAK,EAAE,SAAS,CAAC,EAChD,IAAI,CACL,CAAC;QACF,MAAM,CAAC,KAAK,CACV,YAAY,CAAC,sBAAsB,EAAE,KAAK,EAAE,SAAS,CAAC,EACtD,KAAK,CACN,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/check/strict-mode.d.ts

@@ -0,0 +1,5 @@
+import type { CheckIssue, CompilerRunSummary } from './types';
+import type { CompilerLanguage } from '../toolchain/types';
+export declare function collectStrictModeIssues(summaries: CompilerRunSummary[], languagesInScope: CompilerLanguage[]): CheckIssue[];
+export declare function getSkippedLanguagesInScope(summaries: CompilerRunSummary[], languagesInScope: CompilerLanguage[]): CompilerLanguage[];
+//# sourceMappingURL=strict-mode.d.ts.map

package/dist/check/strict-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict-mode.d.ts","sourceRoot":"","sources":["../../src/check/strict-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAQ3D,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,kBAAkB,EAAE,EAC/B,gBAAgB,EAAE,gBAAgB,EAAE,GACnC,UAAU,EAAE,CAwBd;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,kBAAkB,EAAE,EAC/B,gBAAgB,EAAE,gBAAgB,EAAE,GACnC,gBAAgB,EAAE,CAKpB"}

package/dist/check/strict-mode.js

@@ -0,0 +1,32 @@
+const SKIP_HINTS = {
+    typescript: 'bundled TypeScript should always run — please report a bug if you see this',
+    python: 'pip install pyright',
+    rust: 'install Rust from https://rustup.rs/',
+};
+export function collectStrictModeIssues(summaries, languagesInScope) {
+    const issues = [];
+    for (const lang of languagesInScope) {
+        const runs = summaries.filter((s) => s.language === lang);
+        const allSkipped = runs.length === 0 || runs.every((s) => s.skipped);
+        if (!allSkipped) {
+            continue;
+        }
+        const skipReason = runs.find((s) => s.skipReason)?.skipReason;
+        const hint = skipReason ?? SKIP_HINTS[lang];
+        issues.push({
+            severity: 'error',
+            source: 'compiler',
+            language: lang,
+            code: 'CXGRD_STRICT_SKIP',
+            message: `Strict mode: ${lang} verification did not run (${hint}). Run \`cxgrd doctor\` for setup help.`,
+        });
+    }
+    return issues;
+}
+export function getSkippedLanguagesInScope(summaries, languagesInScope) {
+    return languagesInScope.filter((lang) => {
+        const runs = summaries.filter((s) => s.language === lang);
+        return runs.length === 0 || runs.every((s) => s.skipped);
+    });
+}
+//# sourceMappingURL=strict-mode.js.map

package/dist/check/strict-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict-mode.js","sourceRoot":"","sources":["../../src/check/strict-mode.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,GAAqC;IACnD,UAAU,EAAE,4EAA4E;IACxF,MAAM,EAAE,qBAAqB;IAC7B,IAAI,EAAE,sCAAsC;CAC7C,CAAC;AAEF,MAAM,UAAU,uBAAuB,CACrC,SAA+B,EAC/B,gBAAoC;IAEpC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;QAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAErE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;QAC9D,MAAM,IAAI,GAAG,UAAU,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QAE5C,MAAM,CAAC,IAAI,CAAC;YACV,QAAQ,EAAE,OAAO;YACjB,MAAM,EAAE,UAAU;YAClB,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,gBAAgB,IAAI,8BAA8B,IAAI,yCAAyC;SACzG,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,SAA+B,EAC/B,gBAAoC;IAEpC,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACtC,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/check/strict-mode.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=strict-mode.test.d.ts.map

package/dist/check/strict-mode.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict-mode.test.d.ts","sourceRoot":"","sources":["../../src/check/strict-mode.test.ts"],"names":[],"mappings":""}

package/dist/check/strict-mode.test.js

@@ -0,0 +1,53 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { collectStrictModeIssues, getSkippedLanguagesInScope } from './strict-mode';
+describe('strict mode', () => {
+    it('flags skipped python when project uses python', () => {
+        const summaries = [
+            {
+                language: 'python',
+                tool: 'pyright',
+                projectRoot: '.',
+                passed: true,
+                errorCount: 0,
+                warningCount: 0,
+                skipped: true,
+                skipReason: 'pyright not found',
+            },
+        ];
+        const issues = collectStrictModeIssues(summaries, ['python']);
+        assert.equal(issues.length, 1);
+        assert.equal(issues[0].code, 'CXGRD_STRICT_SKIP');
+    });
+    it('does not flag typescript when verifier ran', () => {
+        const summaries = [
+            {
+                language: 'typescript',
+                tool: 'typescript',
+                projectRoot: 'cli',
+                passed: true,
+                errorCount: 0,
+                warningCount: 0,
+                skipped: false,
+            },
+        ];
+        const issues = collectStrictModeIssues(summaries, ['typescript', 'python']);
+        assert.equal(issues.length, 1);
+        assert.equal(issues[0].language, 'python');
+    });
+    it('lists skipped languages for warnings', () => {
+        const summaries = [
+            {
+                language: 'rust',
+                tool: 'cargo',
+                projectRoot: '.',
+                passed: true,
+                errorCount: 0,
+                warningCount: 0,
+                skipped: true,
+            },
+        ];
+        assert.deepEqual(getSkippedLanguagesInScope(summaries, ['rust']), ['rust']);
+    });
+});
+//# sourceMappingURL=strict-mode.test.js.map

package/dist/check/strict-mode.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict-mode.test.js","sourceRoot":"","sources":["../../src/check/strict-mode.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAGpF,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,SAAS,GAAyB;YACtC;gBACE,QAAQ,EAAE,QAAQ;gBAClB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,GAAG;gBAChB,MAAM,EAAE,IAAI;gBACZ,UAAU,EAAE,CAAC;gBACb,YAAY,EAAE,CAAC;gBACf,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,mBAAmB;aAChC;SACF,CAAC;QACF,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,SAAS,GAAyB;YACtC;gBACE,QAAQ,EAAE,YAAY;gBACtB,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,KAAK;gBAClB,MAAM,EAAE,IAAI;gBACZ,UAAU,EAAE,CAAC;gBACb,YAAY,EAAE,CAAC;gBACf,OAAO,EAAE,KAAK;aACf;SACF,CAAC;QACF,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,EAAE,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC5E,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,SAAS,GAAyB;YACtC;gBACE,QAAQ,EAAE,MAAM;gBAChB,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,GAAG;gBAChB,MAAM,EAAE,IAAI;gBACZ,UAAU,EAAE,CAAC;gBACb,YAAY,EAAE,CAAC;gBACf,OAAO,EAAE,IAAI;aACd;SACF,CAAC;QACF,MAAM,CAAC,SAAS,CAAC,0BAA0B,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/check/structural-checks.d.ts

@@ -0,0 +1,3 @@
+import type { CheckIssue } from './types';
+export declare function runStructuralChecks(graph: any, arch: any): CheckIssue[];
+//# sourceMappingURL=structural-checks.d.ts.map

package/dist/check/structural-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-checks.d.ts","sourceRoot":"","sources":["../../src/check/structural-checks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,UAAU,EAAE,CA0CvE"}

package/dist/check/structural-checks.js

@@ -0,0 +1,111 @@
+export function runStructuralChecks(graph, arch) {
+    const issues = [];
+    const circularDeps = findCircularDependencies(graph);
+    for (const cycle of circularDeps) {
+        issues.push({
+            severity: 'error',
+            message: `Circular dependency detected: ${cycle.join(' → ')}`,
+            source: 'structural',
+        });
+    }
+    const orphanedFiles = findOrphanedFiles(graph);
+    for (const file of orphanedFiles.slice(0, 5)) {
+        issues.push({
+            severity: 'warning',
+            message: `Orphaned file: ${file}`,
+            file,
+            source: 'structural',
+        });
+    }
+    const violations = findArchitectureViolations(graph, arch);
+    for (const violation of violations.slice(0, 5)) {
+        issues.push({
+            severity: 'warning',
+            message: violation.message,
+            file: violation.file,
+            source: 'structural',
+        });
+    }
+    const unusedImports = findUnusedImports(graph);
+    for (const unused of unusedImports.slice(0, 3)) {
+        issues.push({
+            severity: 'info',
+            message: `Potentially unused import: ${unused}`,
+            source: 'structural',
+        });
+    }
+    return issues;
+}
+function findCircularDependencies(graph) {
+    const cycles = [];
+    const visited = new Set();
+    const recursionStack = new Set();
+    function dfs(node, path) {
+        visited.add(node);
+        recursionStack.add(node);
+        path.push(node);
+        const fileNode = graph.files?.[node];
+        if (fileNode?.dependencies) {
+            for (const dep of fileNode.dependencies) {
+                if (recursionStack.has(dep.to)) {
+                    const cycleStart = path.indexOf(dep.to);
+                    cycles.push(path.slice(cycleStart).concat([dep.to]));
+                }
+                else if (!visited.has(dep.to)) {
+                    dfs(dep.to, path);
+                }
+            }
+        }
+        path.pop();
+        recursionStack.delete(node);
+    }
+    for (const file of Object.keys(graph.files || {})) {
+        if (!visited.has(file)) {
+            dfs(file, []);
+        }
+    }
+    return cycles;
+}
+function findOrphanedFiles(graph) {
+    const allFiles = Object.keys(graph.files || {});
+    const referenced = new Set();
+    const referencers = new Set();
+    for (const [filePath, node] of Object.entries(graph.files || {})) {
+        const fileNode = node;
+        referencers.add(filePath);
+        for (const dep of fileNode.dependencies || []) {
+            referenced.add(dep.to);
+        }
+    }
+    return allFiles.filter((f) => !referenced.has(f) && !referencers.has(f));
+}
+function findArchitectureViolations(graph, arch) {
+    const violations = [];
+    const utilFiles = arch?.layers?.util || [];
+    const serviceFiles = arch?.layers?.service || [];
+    for (const utilFile of utilFiles) {
+        const node = graph.files?.[utilFile];
+        if (node?.dependencies) {
+            for (const dep of node.dependencies) {
+                if (serviceFiles.some((sf) => dep.to.includes(sf))) {
+                    violations.push({
+                        message: 'Util layer file imports from service layer',
+                        file: utilFile,
+                    });
+                }
+            }
+        }
+    }
+    return violations;
+}
+function findUnusedImports(graph) {
+    const unused = [];
+    for (const [filePath, node] of Object.entries(graph.files || {})) {
+        const fileNode = node;
+        if (fileNode.dependencies?.length > 20) {
+            unused.push(`${filePath} (many imports: ${fileNode.dependencies.length})`);
+        }
+    }
+    return unused;
+}
+//# sourceMappingURL=structural-checks.js.map

package/dist/check/structural-checks.js.map

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

package/dist/check/types.d.ts

@@ -0,0 +1,40 @@
+import type { CompilerLanguage } from '../toolchain/types';
+export type IssueSeverity = 'error' | 'warning' | 'info';
+export interface CheckIssue {
+    severity: IssueSeverity;
+    message: string;
+    file?: string;
+    line?: number;
+    column?: number;
+    code?: string;
+    source: 'structural' | 'compiler';
+    language?: string;
+}
+export interface CheckResult {
+    passed: boolean;
+    issues: CheckIssue[];
+    summary: string;
+    compilerSummary: CompilerRunSummary[];
+    /** Languages in scope whose compiler was skipped (informational when not strict). */
+    skippedLanguages: CompilerLanguage[];
+}
+export interface CompilerRunSummary {
+    language: string;
+    tool: string;
+    projectRoot: string;
+    passed: boolean;
+    errorCount: number;
+    warningCount: number;
+    skipped: boolean;
+    skipReason?: string;
+}
+export type CheckScope = 'all' | 'staged' | 'changed';
+export interface CheckOptions {
+    projectPath: string;
+    scope: CheckScope;
+    skipStructural: boolean;
+    skipCompiler: boolean;
+    /** Fail when a detected language's compiler did not run (e.g. Pyright missing). */
+    strict: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/check/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/check/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,GAAG,UAAU,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,kBAAkB,EAAE,CAAC;IACtC,qFAAqF;IACrF,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,mFAAmF;IACnF,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/check/types.js

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

package/dist/check/types.js.map

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

package/dist/check/verifiers/python.d.ts

@@ -0,0 +1,7 @@
+import type { CheckIssue, CompilerRunSummary } from '../types';
+import type { PythonProject } from '../project-tooling';
+export declare function verifyPythonProject(project: PythonProject, projectRoot: string): Promise<{
+    issues: CheckIssue[];
+    summary: CompilerRunSummary;
+}>;
+//# sourceMappingURL=python.d.ts.map