@osovv/vv-opencode 1.3.6-rc.5 → 1.3.6-rc.7

package/dist/lib/spec-lint.d.ts

@@ -0,0 +1,57 @@
+export declare const LINT_VERSION = 1;
+export type SpecLintArtifactKind = "spec" | "plan" | "design-context";
+export type SpecLintSeverity = "error" | "warning";
+export interface SpecLintFinding {
+    severity: SpecLintSeverity;
+    rule: string;
+    message: string;
+    file: string;
+    line: number;
+}
+export interface SpecLintVerdict {
+    version: number;
+    file: string;
+    kind: SpecLintArtifactKind | "unknown";
+    ok: boolean;
+    findings: SpecLintFinding[];
+}
+export interface SpecLintArtifactInput {
+    file: string;
+    content: string;
+}
+export interface SpecLintOptions {
+    /** Skip cross-file rules even when plan and spec inputs are both present. */
+    skipCrossFile?: boolean;
+}
+interface XmlNode {
+    name: string;
+    line: number;
+    attribs: Record<string, string>;
+    children: XmlNode[];
+    text: string;
+    cdataCount: number;
+}
+interface ParseResult {
+    root: XmlNode | null;
+    findings: SpecLintFinding[];
+}
+/**
+ * Strict XML parse over htmlparser2's xmlMode Tokenizer event stream.
+ * The low-level tokenizer is used directly (not Parser) because the Parser
+ * silently drops unmatched closing tags and implies closes at end-of-input;
+ * strict artifacts need both violation classes reported. Builds a positioned
+ * element tree and reports well-formedness violations: tokenizer errors,
+ * mismatched or unmatched closing tags, unclosed elements, stray top-level
+ * content, multiple roots, and content after the root element.
+ */
+export declare function parseSpecXml(content: string, file: string): ParseResult;
+/** True when a file label sits under an archive/ directory. */
+export declare function isSpecArchivePath(file: string): boolean;
+export declare function detectSpecArtifactKind(rootName: string): SpecLintArtifactKind | "unknown";
+/**
+ * Lint a set of spec-package artifacts together. Plans resolve their linked
+ * spec among the provided inputs by path or basename for cross-file subset
+ * checks; a plan without its spec yields a warning, not an error.
+ */
+export declare function lintSpecArtifacts(inputs: SpecLintArtifactInput[], options?: SpecLintOptions): SpecLintVerdict[];
+export {};