@matteeh/osq 0.2.1 → 0.2.2

package/dist/core/spec/impact-lint.js

@@ -0,0 +1,39 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { readCapabilityOwnership, undeclaredReadFindings, writeWithoutDeltaFindings, } from './capability-impact.js';
+import { frozenTestFindings, verifyWithoutScopeFindings, } from './test-impact.js';
+/** Capability names with a delta spec directory in the change folder. */
+async function readDeltaCapabilities(folderPath) {
+    let entries;
+    try {
+        entries = await fs.readdir(path.join(folderPath, 'specs'), { withFileTypes: true });
+    }
+    catch {
+        return new Set();
+    }
+    return new Set(entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name));
+}
+/** Run every impact check and return the change's own import-graph warnings. */
+export async function collectImpactFindings(input) {
+    const deltaCapabilities = await readDeltaCapabilities(input.folderPath);
+    const ownerships = await readCapabilityOwnership(input.projectRoot, input.config.paths.openspecRoot);
+    const scopedFiles = [...new Set(input.tasks.flatMap((task) => [...task.existingPaths]))].sort();
+    const declared = new Set([...input.reads, ...deltaCapabilities]);
+    return [
+        ...frozenTestFindings(input.tasks, input.importGraph, {
+            maxDepth: input.config.limits.importGraphDepth,
+            maxListed: input.config.limits.maxListedImporters,
+        }),
+        ...(await verifyWithoutScopeFindings(input.projectRoot, input.tasks, input.importGraph)),
+        ...undeclaredReadFindings({
+            proposalPath: input.proposalPath,
+            scopedFiles,
+            importsOf: (file) => input.importGraph.importsOf(file),
+            filesInScope: new Set(scopedFiles),
+            ownerships,
+            declared,
+        }),
+        ...writeWithoutDeltaFindings(input.tasks, ownerships, deltaCapabilities),
+    ];
+}
+//# sourceMappingURL=impact-lint.js.map

package/dist/core/spec/impact-lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact-lint.js","sourceRoot":"","sources":["../../../src/core/spec/impact-lint.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAEL,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAsB1B,yEAAyE;AACzE,KAAK,UAAU,qBAAqB,CAAC,UAAkB;IACrD,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACtF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5F,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAsB;IAChE,MAAM,iBAAiB,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,MAAM,uBAAuB,CAC9C,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAChC,CAAC;IACF,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChG,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,GAAG,iBAAiB,CAAC,CAAC,CAAC;IAEjE,OAAO;QACL,GAAG,kBAAkB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE;YACpD,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB;YAC9C,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB;SAClD,CAAC;QACF,GAAG,CAAC,MAAM,0BAA0B,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QACxF,GAAG,sBAAsB,CAAC;YACxB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,WAAW;YACX,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC;YACtD,YAAY,EAAE,IAAI,GAAG,CAAC,WAAW,CAAC;YAClC,UAAU;YACV,QAAQ;SACT,CAAC;QACF,GAAG,yBAAyB,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,iBAAiB,CAAC;KACzE,CAAC;AACJ,CAAC"}

package/dist/core/spec/import-graph.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Directory names never walked by the import graph, and by the watcher's
+ * repository counts.
+ */
+export declare const IGNORED_DIRS: ReadonlySet<string>;
+/** The files of one repository and the relative imports between them. */
+export interface ImportGraph {
+    /** Sorted project-relative POSIX paths of every JavaScript and TypeScript file. */
+    readonly files: readonly string[];
+    /** Sorted project-relative files this file imports. */
+    importsOf(file: string): readonly string[];
+    /** Sorted project-relative files that import this file. */
+    importersOf(file: string): readonly string[];
+}
+/** One importing file and its distance from the files it reaches. */
+export interface ReachingFile {
+    readonly file: string;
+    readonly depth: number;
+}
+/** Options for `buildImportGraph`. */
+export interface BuildImportGraphOptions {
+    /** Extra repository-relative folders to leave out of the graph. */
+    readonly skip?: readonly string[];
+}
+/**
+ * Build the relative import graph of every JavaScript and TypeScript file
+ * outside ignored folders and `options.skip`. Bare and aliased specifiers are
+ * never resolved.
+ */
+export declare function buildImportGraph(projectRoot: string, options?: BuildImportGraphOptions): Promise<ImportGraph>;
+/** Every file `files` import at any depth, sorted. */
+export declare function reachImports(graph: ImportGraph, files: readonly string[]): string[];
+/** Every file importing one of `files` within `maxDepth` levels, nearest first. */
+export declare function reachImporters(graph: ImportGraph, files: readonly string[], maxDepth: number): ReachingFile[];
+//# sourceMappingURL=import-graph.d.ts.map

package/dist/core/spec/import-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-graph.d.ts","sourceRoot":"","sources":["../../../src/core/spec/import-graph.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAS3C,CAAC;AAYH,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,uDAAuD;IACvD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC3C,2DAA2D;IAC3D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,sCAAsC;AACtC,MAAM,WAAW,uBAAuB;IACtC,mEAAmE;IACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AA6DD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,WAAW,CAAC,CA4BtB;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAWnF;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,MAAM,GACf,YAAY,EAAE,CAoBhB"}

package/dist/core/spec/import-graph.js

@@ -0,0 +1,155 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+/**
+ * Directory names never walked by the import graph, and by the watcher's
+ * repository counts.
+ */
+export const IGNORED_DIRS = new Set([
+    'node_modules',
+    'dist',
+    '.git',
+    '.run',
+    'coverage',
+    '.nyc_output',
+    '.vscode',
+    '.idea',
+]);
+/** Every script extension the graph records, in resolution preference order. */
+const GRAPH_EXTENSIONS = ['.ts', '.tsx', '.mts', '.cts', '.js', '.jsx', '.mjs', '.cjs'];
+/** Extensions TypeScript rewrites to a TypeScript stem. */
+const JS_EXTENSIONS = ['.js', '.jsx', '.mjs', '.cjs'];
+const TS_EXTENSIONS = ['.ts', '.tsx', '.mts', '.cts'];
+/** One pass over file text; captures import, export, and require specifiers. */
+const SPECIFIER_REGEX = /(?:\bfrom\b|\bimport\b|\brequire\b)\s*(?:\(\s*)?['"]([^'"]+)['"]/g;
+function toPosix(value) {
+    return value.split(path.sep).join('/');
+}
+/** True for a JavaScript or TypeScript file the graph records; declarations do not count. */
+function isGraphFile(name) {
+    if (name.endsWith('.d.ts'))
+        return false;
+    return GRAPH_EXTENSIONS.some((extension) => name.endsWith(extension));
+}
+/** Candidate project-relative targets for a relative specifier, in resolve order. */
+function importCandidates(fromDir, specifier) {
+    const base = toPosix(path.normalize(path.join(fromDir, specifier)));
+    const candidates = [base];
+    const lower = base.toLowerCase();
+    const jsExtension = JS_EXTENSIONS.find((extension) => lower.endsWith(extension));
+    if (jsExtension !== undefined) {
+        const stem = base.slice(0, -jsExtension.length);
+        candidates.push(...TS_EXTENSIONS.map((extension) => `${stem}${extension}`));
+    }
+    candidates.push(...GRAPH_EXTENSIONS.map((extension) => `${base}${extension}`));
+    candidates.push(...GRAPH_EXTENSIONS.map((extension) => `${base}/index${extension}`));
+    return candidates;
+}
+/** The graph file a relative specifier resolves to, or null. */
+function resolveGraphSpecifier(files, fromFile, specifier) {
+    if (!specifier.startsWith('.'))
+        return null;
+    for (const candidate of importCandidates(toPosix(path.dirname(fromFile)), specifier)) {
+        if (!candidate.endsWith('.d.ts') && files.has(candidate))
+            return candidate;
+    }
+    return null;
+}
+/** Recursively list graph files outside ignored folders and `skip`. */
+async function listGraphFiles(projectRoot, skip) {
+    const excluded = new Set(skip.map((entry) => entry.replace(/\\/g, '/').replace(/\/+$/, '')));
+    const files = [];
+    const walk = async (dir) => {
+        const entries = await fs.readdir(dir, { withFileTypes: true }).catch(() => []);
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (IGNORED_DIRS.has(entry.name))
+                    continue;
+                if (excluded.has(toPosix(path.relative(projectRoot, fullPath))))
+                    continue;
+                await walk(fullPath);
+            }
+            else if (entry.isFile() && isGraphFile(entry.name)) {
+                files.push(toPosix(path.relative(projectRoot, fullPath)));
+            }
+        }
+    };
+    await walk(projectRoot);
+    return files.sort();
+}
+/**
+ * Build the relative import graph of every JavaScript and TypeScript file
+ * outside ignored folders and `options.skip`. Bare and aliased specifiers are
+ * never resolved.
+ */
+export async function buildImportGraph(projectRoot, options = {}) {
+    const files = await listGraphFiles(projectRoot, options.skip ?? []);
+    const known = new Set(files);
+    const imports = new Map();
+    const importers = new Map();
+    for (const file of files) {
+        const content = await fs.readFile(path.join(projectRoot, file), 'utf8').catch(() => '');
+        const targets = new Set();
+        for (const match of content.matchAll(SPECIFIER_REGEX)) {
+            const specifier = match[1];
+            const resolved = specifier === undefined ? null : resolveGraphSpecifier(known, file, specifier);
+            if (resolved !== null)
+                targets.add(resolved);
+        }
+        const sorted = [...targets].sort();
+        imports.set(file, sorted);
+        for (const target of sorted) {
+            const list = importers.get(target);
+            if (list === undefined)
+                importers.set(target, [file]);
+            else
+                list.push(file);
+        }
+    }
+    for (const list of importers.values())
+        list.sort();
+    return {
+        files,
+        importsOf: (file) => imports.get(file) ?? [],
+        importersOf: (file) => importers.get(file) ?? [],
+    };
+}
+/** Every file `files` import at any depth, sorted. */
+export function reachImports(graph, files) {
+    const reached = new Set();
+    const queue = [...files];
+    for (let index = 0; index < queue.length; index += 1) {
+        for (const target of graph.importsOf(queue[index] ?? '')) {
+            if (reached.has(target))
+                continue;
+            reached.add(target);
+            queue.push(target);
+        }
+    }
+    return [...reached].sort();
+}
+/** Every file importing one of `files` within `maxDepth` levels, nearest first. */
+export function reachImporters(graph, files, maxDepth) {
+    const roots = new Set(files);
+    const depth = new Map();
+    for (const file of roots)
+        depth.set(file, 0);
+    let frontier = [...roots];
+    for (let level = 1; level <= maxDepth && frontier.length > 0; level += 1) {
+        const next = [];
+        for (const file of frontier) {
+            for (const importer of graph.importersOf(file)) {
+                if (depth.has(importer))
+                    continue;
+                depth.set(importer, level);
+                next.push(importer);
+            }
+        }
+        frontier = next;
+    }
+    return [...depth.entries()]
+        .filter(([file]) => !roots.has(file))
+        .map(([file, level]) => ({ file, depth: level }))
+        .sort((a, b) => a.depth - b.depth || (a.file < b.file ? -1 : a.file > b.file ? 1 : 0));
+}
+//# sourceMappingURL=import-graph.js.map

package/dist/core/spec/import-graph.js.map

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

package/dist/core/spec/lint-findings.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The shared lint finding shape.
+ *
+ * Every diagnostic lint produces carries the severity that decides whether it
+ * blocks, the repository-relative file it concerns, the requirement or section
+ * within that file when one applies, and the human-readable message. The
+ * change's own findings decide validity; repository findings are reported but
+ * never block.
+ */
+/** A finding either fails the change (`error`) or merely informs (`warning`). */
+export type LintSeverity = 'error' | 'warning';
+/** Classify an OpenSpec level; `WARNING` and `INFO` are lint warnings. */
+export declare function openSpecSeverity(level: string): LintSeverity;
+export interface LintFinding {
+    readonly severity: LintSeverity;
+    readonly file: string;
+    readonly requirement: string | null;
+    readonly section: string | null;
+    readonly message: string;
+}
+/** The location fields of a finding; the requirement and section default to null. */
+export interface FindingLocation {
+    readonly file: string;
+    readonly requirement?: string | null;
+    readonly section?: string | null;
+}
+export declare function makeFinding(severity: LintSeverity, location: FindingLocation, message: string): LintFinding;
+/**
+ * Accumulates the change's own findings apart from repository findings and
+ * derives the legacy message arrays from the change's own findings in order.
+ */
+export declare class LintFindingSet {
+    private readonly ownFindings;
+    private readonly repositoryFindings;
+    get findings(): readonly LintFinding[];
+    get repository(): readonly LintFinding[];
+    error(location: FindingLocation, message: string): void;
+    warning(location: FindingLocation, message: string): void;
+    addOwn(finding: LintFinding): void;
+    addRepository(finding: LintFinding): void;
+    errors(): string[];
+    warnings(): string[];
+}
+//# sourceMappingURL=lint-findings.d.ts.map

package/dist/core/spec/lint-findings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-findings.d.ts","sourceRoot":"","sources":["../../../src/core/spec/lint-findings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iFAAiF;AACjF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/C,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAG5D;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,GACd,WAAW,CAQb;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IAExD,IAAI,QAAQ,IAAI,SAAS,WAAW,EAAE,CAErC;IAED,IAAI,UAAU,IAAI,SAAS,WAAW,EAAE,CAEvC;IAED,KAAK,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIvD,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIzD,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAIlC,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAIzC,MAAM,IAAI,MAAM,EAAE;IAIlB,QAAQ,IAAI,MAAM,EAAE;CAGrB"}

package/dist/core/spec/lint-findings.js

@@ -0,0 +1,56 @@
+/**
+ * The shared lint finding shape.
+ *
+ * Every diagnostic lint produces carries the severity that decides whether it
+ * blocks, the repository-relative file it concerns, the requirement or section
+ * within that file when one applies, and the human-readable message. The
+ * change's own findings decide validity; repository findings are reported but
+ * never block.
+ */
+/** Classify an OpenSpec level; `WARNING` and `INFO` are lint warnings. */
+export function openSpecSeverity(level) {
+    const lowered = level.toLowerCase();
+    return lowered.includes('warn') || lowered.includes('info') ? 'warning' : 'error';
+}
+export function makeFinding(severity, location, message) {
+    return {
+        severity,
+        file: location.file,
+        requirement: location.requirement ?? null,
+        section: location.section ?? null,
+        message,
+    };
+}
+/**
+ * Accumulates the change's own findings apart from repository findings and
+ * derives the legacy message arrays from the change's own findings in order.
+ */
+export class LintFindingSet {
+    ownFindings = [];
+    repositoryFindings = [];
+    get findings() {
+        return this.ownFindings;
+    }
+    get repository() {
+        return this.repositoryFindings;
+    }
+    error(location, message) {
+        this.ownFindings.push(makeFinding('error', location, message));
+    }
+    warning(location, message) {
+        this.ownFindings.push(makeFinding('warning', location, message));
+    }
+    addOwn(finding) {
+        this.ownFindings.push(finding);
+    }
+    addRepository(finding) {
+        this.repositoryFindings.push(finding);
+    }
+    errors() {
+        return this.ownFindings.filter((f) => f.severity === 'error').map((f) => f.message);
+    }
+    warnings() {
+        return this.ownFindings.filter((f) => f.severity === 'warning').map((f) => f.message);
+    }
+}
+//# sourceMappingURL=lint-findings.js.map

package/dist/core/spec/lint-findings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-findings.js","sourceRoot":"","sources":["../../../src/core/spec/lint-findings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,0EAA0E;AAC1E,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AACpF,CAAC;AAiBD,MAAM,UAAU,WAAW,CACzB,QAAsB,EACtB,QAAyB,EACzB,OAAe;IAEf,OAAO;QACL,QAAQ;QACR,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,IAAI;QACzC,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,IAAI;QACjC,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,cAAc;IACR,WAAW,GAAkB,EAAE,CAAC;IAChC,kBAAkB,GAAkB,EAAE,CAAC;IAExD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,QAAyB,EAAE,OAAe;QAC9C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,CAAC,QAAyB,EAAE,OAAe;QAChD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,CAAC,OAAoB;QACzB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,aAAa,CAAC,OAAoB;QAChC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACtF,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACxF,CAAC;CACF"}

package/dist/core/spec/lint-output.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Text and JSON rendering for `osq lint`.
+ *
+ * A change's own findings print under the change name, repository findings
+ * print once in their own group, and `--json` carries the same fields as one
+ * document. Formatting, deduplication, and document building live here so the
+ * command stays small.
+ */
+import type { LintFinding } from './lint-findings.js';
+/** The repository group header printed once after every change. */
+export declare const REPOSITORY_HEADER = "repository: findings about other changes and living specs; they do not affect the exit code";
+/** The minimal logger surface finding printing needs. */
+export interface FindingLogger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+/** The JSON document `osq lint --json` writes to stdout. */
+export interface LintJsonDocument {
+    readonly valid: boolean;
+    readonly changes: LintJsonChange[];
+    readonly repository: LintFinding[];
+}
+export interface LintJsonChange {
+    readonly change: string;
+    readonly valid: boolean;
+    readonly findings: LintFinding[];
+}
+/** One linted change as the JSON builder consumes it. */
+export interface LintJsonEntry {
+    readonly change: string;
+    readonly valid: boolean;
+    readonly findings: readonly LintFinding[];
+    readonly repository: readonly LintFinding[];
+}
+/** Format one finding as `<prefix>: <severity> <file><qualifier>: <message>`. */
+export declare function formatFinding(prefix: string, finding: LintFinding): string;
+/** Format one change's own finding under the change name. */
+export declare function formatChangeFinding(change: string, finding: LintFinding): string;
+/** Format one repository finding under the fixed `repository` prefix. */
+export declare function formatRepositoryFinding(finding: LintFinding): string;
+/** Drop findings equal in every field, keeping the first occurrence's order. */
+export declare function dedupeFindings(findings: readonly LintFinding[]): LintFinding[];
+/** Print a change's findings and, when valid, its validity line. */
+export declare function printChangeFindings(logger: FindingLogger, change: string, result: {
+    readonly valid: boolean;
+    readonly findings: readonly LintFinding[];
+}): void;
+/** Print the repository group, one line per unique finding, or nothing. */
+export declare function printRepositoryFindings(logger: FindingLogger, findings: readonly LintFinding[]): void;
+/** Build the `osq lint --json` document from every linted change. */
+export declare function buildLintJson(valid: boolean, entries: readonly LintJsonEntry[]): LintJsonDocument;
+//# sourceMappingURL=lint-output.d.ts.map

package/dist/core/spec/lint-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-output.d.ts","sourceRoot":"","sources":["../../../src/core/spec/lint-output.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,gGACiE,CAAC;AAEhG,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,WAAW,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;CAClC;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,SAAS,WAAW,EAAE,CAAC;CAC7C;AAQD,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CAE1E;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CAEhF;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAEpE;AAaD,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,EAAE,CAQ9E;AAYD,oEAAoE;AACpE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,GAC7E,IAAI,CAON;AAED,2EAA2E;AAC3E,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,SAAS,WAAW,EAAE,GAC/B,IAAI,CAQN;AAED,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,gBAAgB,CAUjG"}

package/dist/core/spec/lint-output.js

@@ -0,0 +1,87 @@
+/**
+ * Text and JSON rendering for `osq lint`.
+ *
+ * A change's own findings print under the change name, repository findings
+ * print once in their own group, and `--json` carries the same fields as one
+ * document. Formatting, deduplication, and document building live here so the
+ * command stays small.
+ */
+/** The repository group header printed once after every change. */
+export const REPOSITORY_HEADER = 'repository: findings about other changes and living specs; they do not affect the exit code';
+/** The requirement-or-section qualifier, preferring the requirement. */
+function qualifier(finding) {
+    const name = finding.requirement ?? finding.section;
+    return name === null ? '' : ` (${name})`;
+}
+/** Format one finding as `<prefix>: <severity> <file><qualifier>: <message>`. */
+export function formatFinding(prefix, finding) {
+    return `${prefix}: ${finding.severity} ${finding.file}${qualifier(finding)}: ${finding.message}`;
+}
+/** Format one change's own finding under the change name. */
+export function formatChangeFinding(change, finding) {
+    return formatFinding(change, finding);
+}
+/** Format one repository finding under the fixed `repository` prefix. */
+export function formatRepositoryFinding(finding) {
+    return formatFinding('repository', finding);
+}
+/** True when two findings are equal in every field. */
+function sameFinding(left, right) {
+    return (left.severity === right.severity &&
+        left.file === right.file &&
+        left.requirement === right.requirement &&
+        left.section === right.section &&
+        left.message === right.message);
+}
+/** Drop findings equal in every field, keeping the first occurrence's order. */
+export function dedupeFindings(findings) {
+    const unique = [];
+    for (const finding of findings) {
+        if (!unique.some((existing) => sameFinding(existing, finding))) {
+            unique.push(finding);
+        }
+    }
+    return unique;
+}
+/** Print one finding at the logger level that matches its severity. */
+function printFinding(logger, prefix, finding) {
+    const line = formatFinding(prefix, finding);
+    if (finding.severity === 'error') {
+        logger.error(line);
+    }
+    else {
+        logger.warn(line);
+    }
+}
+/** Print a change's findings and, when valid, its validity line. */
+export function printChangeFindings(logger, change, result) {
+    for (const finding of result.findings) {
+        printFinding(logger, change, finding);
+    }
+    if (result.valid) {
+        logger.info(`${change}: valid`);
+    }
+}
+/** Print the repository group, one line per unique finding, or nothing. */
+export function printRepositoryFindings(logger, findings) {
+    if (findings.length === 0) {
+        return;
+    }
+    logger.info(REPOSITORY_HEADER);
+    for (const finding of findings) {
+        printFinding(logger, 'repository', finding);
+    }
+}
+/** Build the `osq lint --json` document from every linted change. */
+export function buildLintJson(valid, entries) {
+    return {
+        valid,
+        changes: entries.map((entry) => ({
+            change: entry.change,
+            valid: entry.valid,
+            findings: [...entry.findings],
+        })),
+        repository: dedupeFindings(entries.flatMap((entry) => [...entry.repository])),
+    };
+}
+//# sourceMappingURL=lint-output.js.map

package/dist/core/spec/lint-output.js.map

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

package/dist/core/spec/linter.d.ts

@@ -1,8 +1,9 @@
 import type { OsqConfig } from '../foundation/config.js';
+import { type ImportGraph } from './import-graph.js';
+import { type LintFinding } from './lint-findings.js';
+import { OPENSPEC_ERROR_PREFIX } from './openspec-issues.js';
 import { OPENSPEC_EXPECTED_VERSION } from './openspec-version.js';
-export { OPENSPEC_EXPECTED_VERSION };
-/** Prefix applied to every finding surfaced by the OpenSpec validator. */
-export declare const OPENSPEC_ERROR_PREFIX = "openspec:";
+export { OPENSPEC_EXPECTED_VERSION, OPENSPEC_ERROR_PREFIX };
 export interface LintLogger {
     info(msg: string): void;
     verbose(msg: string): void;
@@ -32,9 +33,15 @@ export interface LintResult {
     readonly valid: boolean;
     readonly errors: string[];
     readonly warnings: string[];
+    readonly findings: LintFinding[];
+    readonly repository: LintFinding[];
 }
 export interface LintOptions {
     readonly logger?: LintLogger;
+    /** The change folder being linted, used to attribute OpenSpec issues. */
+    readonly changeFolder?: string;
+    /** A graph built once per lint run; built here when absent. */
+    readonly importGraph?: ImportGraph;
 }
 export interface OpenSpecFindings {
     readonly errors: string[];
@@ -44,6 +51,8 @@ export interface OpenSpecValidationOutcome extends OpenSpecFindings {
     readonly ran: boolean;
     readonly bin: string | null;
     readonly version: string | null;
+    readonly findings: LintFinding[];
+    readonly repository: LintFinding[];
 }
 /**
  * Resolves the project-local OpenSpec binary. Only a binary inside the
@@ -73,7 +82,8 @@ export declare function validateWithOpenSpec(projectRoot: string, config: OsqCon
  * the living base spec at `openspec/specs/<capability>/spec.md`. Applying the
  * delta through the deterministic merge engine reports unmatched MODIFIED,
  * REMOVED, or RENAMED targets; ADDED-only deltas may create a new capability.
+ * Merged results are validated against their living spec's repository findings.
  */
-export declare function verifyDeltaTargets(projectRoot: string, folderPath: string, config: OsqConfig): Promise<string[]>;
+export declare function verifyDeltaTargets(projectRoot: string, folderPath: string, config: OsqConfig, repositoryFindings?: readonly LintFinding[]): Promise<LintFinding[]>;
 export declare function lintChangeFolder(projectRoot: string, folderPath: string, config: OsqConfig, options?: LintOptions): Promise<LintResult>;
 //# sourceMappingURL=linter.d.ts.map

package/dist/core/spec/linter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../../../src/core/spec/linter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAMzD,OAAO,EACL,yBAAyB,EAI1B,MAAM,uBAAuB,CAAC;AAqB/B,OAAO,EAAE,yBAAyB,EAAE,CAAC;AAMrC,0EAA0E;AAC1E,eAAO,MAAM,qBAAqB,cAAc,CAAC;AAEjD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AA8GD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,uEAAuE;IACvE,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AA4CD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,GAClC,OAAO,CAAC,qBAAqB,CAAC,CAuBhC;AAoFD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AA8BD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASxB;AAED,gFAAgF;AAChF,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBxF;AAiDD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CA2DtE;AAuCD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,yBAAyB,CAAC,CAkEpC;AA4DD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAoDnB;AAsGD,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAyNrB"}
+{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../../../src/core/spec/linter.ts"],"names":[],"mappings":"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"}