@vibe-agent-toolkit/resources 0.1.38 → 0.1.39-rc.10

package/README.md

@@ -47,7 +47,7 @@ console.log(`Errors: ${result.errorCount}, Warnings: ${result.warningCount}`);
 // Show any issues
 for (const issue of result.issues) {
   console.log(`${issue.severity.toUpperCase()}: ${issue.message}`);
-  if (issue.line) console.log(`  at ${issue.resourcePath}:${issue.line}`);
+  if (issue.line) console.log(`  at ${issue.location}:${issue.line}`);
 }
 ```
 
@@ -546,27 +546,35 @@ interface ValidationResult {
 
 A single validation issue found during link validation.
 
+`ValidationIssue` is the unified issue shape every VAT validator emits (defined
+in `@vibe-agent-toolkit/agent-schema`). Each issue carries a registry `code`
+(see [Validation Codes](../../docs/validation-codes.md)) and a resolved
+`severity`.
+
 ```typescript
 interface ValidationIssue {
-  severity: ValidationSeverity;      // Issue severity level
-  resourcePath: string;              // Absolute path to the resource containing the issue
-  line?: number;                     // Line number where the issue occurs
-  type: string;                      // Issue type identifier (e.g., 'broken_file', 'broken_anchor')
-  link: string;                      // The problematic link
+  code: string;                      // Registry code, e.g. 'LINK_BROKEN_FILE', 'EXTERNAL_URL_DEAD'
+  severity: SeverityLevel;           // Resolved severity (after config overrides)
   message: string;                   // Human-readable description
+  location?: string;                 // Project-relative path of the file containing the issue
+  line?: number;                     // Line number where the issue occurs
+  link?: string;                     // The problematic link (when applicable)
+  fix?: string;                      // Fix hint from the code registry
+  reference?: string;                // Anchor into docs/validation-codes.md
   suggestion?: string;               // Optional suggestion for fixing
 }
 ```
 
-### ValidationSeverity
+### SeverityLevel
 
 ```typescript
-type ValidationSeverity = 'error' | 'warning' | 'info';
+type SeverityLevel = 'error' | 'warning' | 'info' | 'ignore';
 ```
 
 - `error` - Critical issue that should block usage (e.g., broken file link)
-- `warning` - Non-critical issue that should be addressed (e.g., questionable link format)
-- `info` - Informational message (e.g., external URL not validated)
+- `warning` - Non-critical issue that should be addressed (e.g., dead external URL)
+- `info` - Informational message
+- `ignore` - Suppressed; the issue is not emitted (set via `validation.severity` config)
 
 ## Frontmatter Support
 
@@ -721,19 +729,19 @@ vat resources validate docs/ --frontmatter-schema schema.json
 
 ### Validation Result
 
-Frontmatter validation results are included in `ValidationResult`:
+Frontmatter findings are emitted into the same unified `result.issues` array as
+link findings — each carries a `FRONTMATTER_*` registry code (e.g.
+`FRONTMATTER_MISSING`, `FRONTMATTER_SCHEMA_ERROR`, `FRONTMATTER_INVALID_YAML`)
+and a resolved `severity`. There is no separate `frontmatterValidation` field.
 
 ```typescript
-interface ValidationResult {
-  // ... existing fields
-  frontmatterValidation?: {
-    valid: boolean;
-    errors: Array<{
-      resourcePath: string;
-      message: string;
-      field?: string;
-    }>;
-  };
+const result = await registry.validate();
+
+const frontmatterIssues = result.issues.filter((i) =>
+  i.code.startsWith('FRONTMATTER_'),
+);
+for (const issue of frontmatterIssues) {
+  console.log(`[${issue.severity}] ${issue.code} at ${issue.location}: ${issue.message}`);
 }
 ```
 
@@ -889,9 +897,10 @@ const warnings = result.issues.filter(i => i.severity === 'warning');
 // Group by resource
 const issuesByResource = new Map<string, ValidationIssue[]>();
 for (const issue of result.issues) {
-  const issues = issuesByResource.get(issue.resourcePath) ?? [];
+  const key = issue.location ?? '(unknown)';
+  const issues = issuesByResource.get(key) ?? [];
   issues.push(issue);
-  issuesByResource.set(issue.resourcePath, issues);
+  issuesByResource.set(key, issues);
 }
 
 // Show summary
@@ -926,7 +935,7 @@ async function validateDocs() {
     console.error(`\nValidation failed with ${result.errorCount} errors\n`);
 
     for (const issue of result.issues.filter(i => i.severity === 'error')) {
-      console.error(`${issue.resourcePath}:${issue.line ?? '?'}`);
+      console.error(`${issue.location ?? '(unknown)'}:${issue.line ?? '?'}`);
       console.error(`  ${issue.message}`);
       if (issue.suggestion) {
         console.error(`  Suggestion: ${issue.suggestion}`);

package/dist/frontmatter-link-validator.d.ts

@@ -7,18 +7,18 @@
  * frontmatter-specific type codes plus a list of external URLs the registry
  * can fold into its existing external URL collection.
  *
- * Type mapping:
- *   broken_file        -> frontmatter_link_broken
- *   broken_anchor      -> frontmatter_anchor_missing
- *   link_to_gitignored -> frontmatter_link_to_gitignored
- *   unknown_link       -> frontmatter_unknown_link
+ * Code mapping:
+ *   LINK_BROKEN_FILE    -> FRONTMATTER_LINK_BROKEN
+ *   LINK_BROKEN_ANCHOR  -> FRONTMATTER_ANCHOR_MISSING
+ *   LINK_TO_GITIGNORED  -> FRONTMATTER_LINK_TO_GITIGNORED
+ *   LINK_UNKNOWN        -> FRONTMATTER_UNKNOWN_LINK
  *
  * Skipped (no issue, no external):
  *   email (mailto:)
  *   anchor-only (validated as anchor in current file via validateLink)
  */
-import { type ValidateLinkOptions } from './link-validator.js';
-import type { HeadingNode, ValidationIssue } from './types.js';
+import { type FragmentIndex, type ValidateLinkOptions } from './link-validator.js';
+import type { ValidationIssue } from './types.js';
 /** A frontmatter-sourced external URL captured for downstream health checking. */
 export interface FrontmatterExternalUrl {
     url: string;
@@ -35,8 +35,8 @@ export interface FrontmatterLinkValidationResult {
  * @param frontmatter - Parsed frontmatter (or undefined)
  * @param schema - JSON Schema for the collection
  * @param sourceFilePath - Absolute path to the source file
- * @param headingsByFile - Heading trees (for anchor validation)
+ * @param fragmentsByFile - Fragment index (file path → set of valid fragments) for anchor validation
  * @param options - Same shape as validateLink (projectRoot, gitTracker, ...)
  */
-export declare function validateFrontmatterLinks(frontmatter: Record<string, unknown> | undefined, schema: object, sourceFilePath: string, headingsByFile: Map<string, HeadingNode[]>, options?: ValidateLinkOptions): Promise<FrontmatterLinkValidationResult>;
+export declare function validateFrontmatterLinks(frontmatter: Record<string, unknown> | undefined, schema: object, sourceFilePath: string, fragmentsByFile: FragmentIndex, options?: ValidateLinkOptions): Promise<FrontmatterLinkValidationResult>;
 //# sourceMappingURL=frontmatter-link-validator.d.ts.map

package/dist/frontmatter-link-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter-link-validator.d.ts","sourceRoot":"","sources":["../src/frontmatter-link-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAgB,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7E,kFAAkF;AAClF,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,YAAY,EAAE,sBAAsB,EAAE,CAAC;CACxC;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAChD,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,EAC1C,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,+BAA+B,CAAC,CAoC1C"}
+{"version":3,"file":"frontmatter-link-validator.d.ts","sourceRoot":"","sources":["../src/frontmatter-link-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEjG,OAAO,KAAK,EAAgB,eAAe,EAAE,MAAM,YAAY,CAAC;AAUhE,kFAAkF;AAClF,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,YAAY,EAAE,sBAAsB,EAAE,CAAC;CACxC;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAChD,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,aAAa,EAC9B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,+BAA+B,CAAC,CAoC1C"}

package/dist/frontmatter-link-validator.js

@@ -7,29 +7,37 @@
  * frontmatter-specific type codes plus a list of external URLs the registry
  * can fold into its existing external URL collection.
  *
- * Type mapping:
- *   broken_file        -> frontmatter_link_broken
- *   broken_anchor      -> frontmatter_anchor_missing
- *   link_to_gitignored -> frontmatter_link_to_gitignored
- *   unknown_link       -> frontmatter_unknown_link
+ * Code mapping:
+ *   LINK_BROKEN_FILE    -> FRONTMATTER_LINK_BROKEN
+ *   LINK_BROKEN_ANCHOR  -> FRONTMATTER_ANCHOR_MISSING
+ *   LINK_TO_GITIGNORED  -> FRONTMATTER_LINK_TO_GITIGNORED
+ *   LINK_UNKNOWN        -> FRONTMATTER_UNKNOWN_LINK
  *
  * Skipped (no issue, no external):
  *   email (mailto:)
  *   anchor-only (validated as anchor in current file via validateLink)
  */
+import { createRegistryIssue } from '@vibe-agent-toolkit/agent-schema';
 import { classifyLink } from './link-parser.js';
 import { validateLink } from './link-validator.js';
 import { walkFrontmatterUriReferences } from './schema-uri-walker.js';
+/** Map the link-level code emitted by validateLink to its frontmatter-scoped code. */
+const LINK_CODE_TO_FRONTMATTER_CODE = {
+    LINK_BROKEN_FILE: 'FRONTMATTER_LINK_BROKEN',
+    LINK_BROKEN_ANCHOR: 'FRONTMATTER_ANCHOR_MISSING',
+    LINK_TO_GITIGNORED: 'FRONTMATTER_LINK_TO_GITIGNORED',
+    LINK_UNKNOWN: 'FRONTMATTER_UNKNOWN_LINK',
+};
 /**
  * Validate every URI-family frontmatter value against the file system.
  *
  * @param frontmatter - Parsed frontmatter (or undefined)
  * @param schema - JSON Schema for the collection
  * @param sourceFilePath - Absolute path to the source file
- * @param headingsByFile - Heading trees (for anchor validation)
+ * @param fragmentsByFile - Fragment index (file path → set of valid fragments) for anchor validation
  * @param options - Same shape as validateLink (projectRoot, gitTracker, ...)
  */
-export async function validateFrontmatterLinks(frontmatter, schema, sourceFilePath, headingsByFile, options) {
+export async function validateFrontmatterLinks(frontmatter, schema, sourceFilePath, fragmentsByFile, options) {
     if (!frontmatter)
         return { issues: [], externalUrls: [] };
     const captures = walkFrontmatterUriReferences(frontmatter, schema);
@@ -55,7 +63,7 @@ export async function validateFrontmatterLinks(frontmatter, schema, sourceFilePa
             type: linkType,
             line: 1, // Frontmatter per-field line numbers are post-v1.
         };
-        const issue = await validateLink(syntheticLink, sourceFilePath, headingsByFile, options);
+        const issue = await validateLink(syntheticLink, sourceFilePath, fragmentsByFile, options);
         if (!issue)
             continue;
         issues.push(rewriteIssue(issue, capture.dottedPath));
@@ -63,24 +71,17 @@ export async function validateFrontmatterLinks(frontmatter, schema, sourceFilePa
     return { issues, externalUrls };
 }
 function rewriteIssue(issue, dottedPath) {
-    return {
-        ...issue,
-        type: mapType(issue.type),
-        message: `field \`${dottedPath}\`: ${issue.message}`,
-    };
-}
-function mapType(originalType) {
-    switch (originalType) {
-        case 'broken_file':
-            return 'frontmatter_link_broken';
-        case 'broken_anchor':
-            return 'frontmatter_anchor_missing';
-        case 'link_to_gitignored':
-            return 'frontmatter_link_to_gitignored';
-        case 'unknown_link':
-            return 'frontmatter_unknown_link';
-        default:
-            return originalType;
-    }
+    const mappedCode = LINK_CODE_TO_FRONTMATTER_CODE[issue.code] ?? issue.code;
+    const message = `field \`${dottedPath}\`: ${issue.message}`;
+    const extras = {};
+    if (issue.location !== undefined)
+        extras.location = issue.location;
+    if (issue.line !== undefined)
+        extras.line = issue.line;
+    if (issue.link !== undefined)
+        extras.link = issue.link;
+    if (issue.suggestion !== undefined)
+        extras.suggestion = issue.suggestion;
+    return createRegistryIssue(mappedCode, message, extras);
 }
 //# sourceMappingURL=frontmatter-link-validator.js.map

package/dist/frontmatter-link-validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter-link-validator.js","sourceRoot":"","sources":["../src/frontmatter-link-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAA4B,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAetE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,WAAgD,EAChD,MAAc,EACd,cAAsB,EACtB,cAA0C,EAC1C,OAA6B;IAE7B,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAE1D,MAAM,QAAQ,GAAG,4BAA4B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACnE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAEnE,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,YAAY,GAA6B,EAAE,CAAC;IAElD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAE7C,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC5B,YAAY,CAAC,IAAI,CAAC;gBAChB,GAAG,EAAE,OAAO,CAAC,KAAK;gBAClB,UAAU,EAAE,cAAc;gBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,KAAK,OAAO;YAAE,SAAS;QAEnC,MAAM,aAAa,GAAiB;YAClC,IAAI,EAAE,OAAO,CAAC,UAAU;YACxB,IAAI,EAAE,OAAO,CAAC,KAAK;YACnB,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,EAAE,kDAAkD;SAC5D,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;QACzF,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,YAAY,CAAC,KAAsB,EAAE,UAAkB;IAC9D,OAAO;QACL,GAAG,KAAK;QACR,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;QACzB,OAAO,EAAE,WAAW,UAAU,OAAO,KAAK,CAAC,OAAO,EAAE;KACrD,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,YAAoB;IACnC,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,aAAa;YAChB,OAAO,yBAAyB,CAAC;QACnC,KAAK,eAAe;YAClB,OAAO,4BAA4B,CAAC;QACtC,KAAK,oBAAoB;YACvB,OAAO,gCAAgC,CAAC;QAC1C,KAAK,cAAc;YACjB,OAAO,0BAA0B,CAAC;QACpC;YACE,OAAO,YAAY,CAAC;IACxB,CAAC;AACH,CAAC"}
+{"version":3,"file":"frontmatter-link-validator.js","sourceRoot":"","sources":["../src/frontmatter-link-validator.ts"],"names":[],"mappings":"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"}

package/dist/frontmatter-validator.d.ts

@@ -12,8 +12,8 @@
  *
  * This is the ONLY place in the codebase that should use AJV.
  */
+import { type ValidationIssue } from '@vibe-agent-toolkit/agent-schema';
 import type { ValidationMode } from './schemas/project-config.js';
-import type { ValidationIssue } from './schemas/validation-result.js';
 /**
  * Validate frontmatter against a JSON Schema.
  *
@@ -28,6 +28,7 @@ import type { ValidationIssue } from './schemas/validation-result.js';
  * @param resourcePath - File path for error reporting
  * @param mode - Validation mode: 'strict' (default) or 'permissive'
  * @param schemaPath - Path to schema file (for error context)
+ * @param projectRoot - Project root for computing relative issue locations
  * @returns Array of validation issues (empty if valid)
  *
  * @example
@@ -46,5 +47,5 @@ import type { ValidationIssue } from './schemas/validation-result.js';
  * );
  * ```
  */
-export declare function validateFrontmatter(frontmatter: Record<string, unknown> | undefined, schema: object, resourcePath: string, mode?: ValidationMode, schemaPath?: string): ValidationIssue[];
+export declare function validateFrontmatter(frontmatter: Record<string, unknown> | undefined, schema: object, resourcePath: string, mode?: ValidationMode, schemaPath?: string, projectRoot?: string): ValidationIssue[];
 //# sourceMappingURL=frontmatter-validator.d.ts.map

package/dist/frontmatter-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter-validator.d.ts","sourceRoot":"","sources":["../src/frontmatter-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAChD,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE,cAAyB,EAC/B,UAAU,CAAC,EAAE,MAAM,GAClB,eAAe,EAAE,CA+DnB"}
+{"version":3,"file":"frontmatter-validator.d.ts","sourceRoot":"","sources":["../src/frontmatter-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAG7F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAGlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAChD,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE,cAAyB,EAC/B,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,eAAe,EAAE,CA8DnB"}

package/dist/frontmatter-validator.js

@@ -12,7 +12,9 @@
  *
  * This is the ONLY place in the codebase that should use AJV.
  */
+import { createRegistryIssue } from '@vibe-agent-toolkit/agent-schema';
 import { createAjvWithUriFormats } from './ajv-factory.js';
+import { issueLocation } from './utils.js';
 /**
  * Validate frontmatter against a JSON Schema.
  *
@@ -27,6 +29,7 @@ import { createAjvWithUriFormats } from './ajv-factory.js';
  * @param resourcePath - File path for error reporting
  * @param mode - Validation mode: 'strict' (default) or 'permissive'
  * @param schemaPath - Path to schema file (for error context)
+ * @param projectRoot - Project root for computing relative issue locations
  * @returns Array of validation issues (empty if valid)
  *
  * @example
@@ -45,7 +48,7 @@ import { createAjvWithUriFormats } from './ajv-factory.js';
  * );
  * ```
  */
-export function validateFrontmatter(frontmatter, schema, resourcePath, mode = 'strict', schemaPath) {
+export function validateFrontmatter(frontmatter, schema, resourcePath, mode = 'strict', schemaPath, projectRoot) {
     const issues = [];
     // In permissive mode, clone schema and set additionalProperties: true
     let effectiveSchema = schema;
@@ -72,13 +75,7 @@ export function validateFrontmatter(frontmatter, schema, resourcePath, mode = 's
             // Build context message with schema path and validation mode
             const schemaContext = schemaPath ? ` (schema: ${schemaPath}, mode: ${mode})` : '';
             const requiredFields = schemaRequires.join(', ');
-            issues.push({
-                resourcePath,
-                line: 1,
-                type: 'frontmatter_missing',
-                link: '',
-                message: `No frontmatter found in file. Schema requires: ${requiredFields}${schemaContext}`,
-            });
+            issues.push(createRegistryIssue('FRONTMATTER_MISSING', `No frontmatter found in file. Schema requires: ${requiredFields}${schemaContext}`, { location: issueLocation(resourcePath, projectRoot), line: 1 }));
         }
         return issues;
     }
@@ -90,13 +87,10 @@ export function validateFrontmatter(frontmatter, schema, resourcePath, mode = 's
     // Format validation errors with helpful messages
     for (const error of validate.errors) {
         const message = formatValidationError(error, frontmatter, mode, schemaPath);
-        issues.push({
-            resourcePath,
+        issues.push(createRegistryIssue('FRONTMATTER_SCHEMA_ERROR', message, {
+            location: issueLocation(resourcePath, projectRoot),
             line: 1,
-            type: 'frontmatter_schema_error',
-            link: '',
-            message,
-        });
+        }));
     }
     return issues;
 }

package/dist/frontmatter-validator.js.map

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

package/dist/html-link-parser.d.ts

@@ -0,0 +1,47 @@
+/**
+ * HTML resource parser.
+ *
+ * Parses local HTML files into the shared `ParseResult` shape:
+ * - `<a href>` and `<img src>` links (classified by `classifyLink`)
+ * - `id` / `name` attributes as fragment anchors
+ * - well-formedness diagnostics from parse5's `onParseError`
+ *
+ * Uses parse5 (WHATWG-conformant). The parse5 document + element walker are
+ * exported so the link rewriter (html-transform.ts) shares one parser path.
+ *
+ * Non-goal: `<base href>` is not honored — relative links are resolved against
+ * the file's own directory, not a document base.
+ */
+import { type DefaultTreeAdapterMap } from 'parse5';
+import { type ParseResult } from './link-parser.js';
+import type { HtmlParseError } from './schemas/resource-metadata.js';
+type P5Node = DefaultTreeAdapterMap['node'];
+type P5Element = DefaultTreeAdapterMap['element'];
+/** A parsed parse5 document together with any well-formedness diagnostics. */
+export interface HtmlDocument {
+    document: DefaultTreeAdapterMap['document'];
+    parseErrors: HtmlParseError[];
+}
+/**
+ * Parse an HTML source string with source-location info and collect parser
+ * errors. Shared by `parseHtml` (link/anchor extraction) and `rewriteHtmlLinks`
+ * (attribute offset splicing).
+ */
+export declare function parseHtmlDocument(source: string): HtmlDocument;
+/**
+ * Depth-first walk yielding every element node in the tree.
+ *
+ * Deliberate gap: a `<template>` element's content lives in its separate
+ * `content` fragment (not `childNodes`), so links inside `<template>` are not
+ * walked, and foreign-content (SVG/MathML) subtrees are not special-cased.
+ * Both are rare in the content link graph we rewrite.
+ */
+export declare function walkElements(node: P5Node): Generator<P5Element>;
+/**
+ * Parse an HTML file into a `ParseResult`.
+ *
+ * @param filePath - Absolute path to the HTML file.
+ */
+export declare function parseHtml(filePath: string): Promise<ParseResult>;
+export {};
+//# sourceMappingURL=html-link-parser.d.ts.map

package/dist/html-link-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-link-parser.d.ts","sourceRoot":"","sources":["../src/html-link-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAS,KAAK,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AAE3D,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE,KAAK,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC5C,KAAK,SAAS,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;AAGlD,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC5C,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAW9D;AAED;;;;;;;GAOG;AACH,wBAAiB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,CAShE;AAuCD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA2BtE"}

package/dist/html-link-parser.js

@@ -0,0 +1,111 @@
+/**
+ * HTML resource parser.
+ *
+ * Parses local HTML files into the shared `ParseResult` shape:
+ * - `<a href>` and `<img src>` links (classified by `classifyLink`)
+ * - `id` / `name` attributes as fragment anchors
+ * - well-formedness diagnostics from parse5's `onParseError`
+ *
+ * Uses parse5 (WHATWG-conformant). The parse5 document + element walker are
+ * exported so the link rewriter (html-transform.ts) shares one parser path.
+ *
+ * Non-goal: `<base href>` is not honored — relative links are resolved against
+ * the file's own directory, not a document base.
+ */
+import { readFile, stat } from 'node:fs/promises';
+import { parse } from 'parse5';
+import { classifyLink } from './link-parser.js';
+/**
+ * Parse an HTML source string with source-location info and collect parser
+ * errors. Shared by `parseHtml` (link/anchor extraction) and `rewriteHtmlLinks`
+ * (attribute offset splicing).
+ */
+export function parseHtmlDocument(source) {
+    const parseErrors = [];
+    const document = parse(source, {
+        sourceCodeLocationInfo: true,
+        onParseError: (err) => {
+            // parse5's ParserError extends Location which always has startLine: number.
+            // We always include line since it is always present.
+            parseErrors.push({ message: err.code, line: err.startLine });
+        },
+    });
+    return { document, parseErrors };
+}
+/**
+ * Depth-first walk yielding every element node in the tree.
+ *
+ * Deliberate gap: a `<template>` element's content lives in its separate
+ * `content` fragment (not `childNodes`), so links inside `<template>` are not
+ * walked, and foreign-content (SVG/MathML) subtrees are not special-cased.
+ * Both are rare in the content link graph we rewrite.
+ */
+export function* walkElements(node) {
+    if ('tagName' in node) {
+        yield node;
+    }
+    if ('childNodes' in node) {
+        for (const child of node.childNodes) {
+            yield* walkElements(child);
+        }
+    }
+}
+function getAttr(element, name) {
+    return element.attrs.find((a) => a.name === name)?.value;
+}
+function makeLink(href, line) {
+    return { text: '', href, type: classifyLink(href), ...(line !== undefined && { line }) };
+}
+function visitElement(element, links, anchors) {
+    const line = element.sourceCodeLocation?.startLine;
+    if (element.tagName === 'a') {
+        const href = getAttr(element, 'href');
+        if (href !== undefined) {
+            links.push(makeLink(href, line));
+        }
+        const name = getAttr(element, 'name');
+        if (name !== undefined && name !== '') {
+            anchors.add(name);
+        }
+    }
+    else if (element.tagName === 'img') {
+        const src = getAttr(element, 'src');
+        if (src !== undefined) {
+            links.push(makeLink(src, line));
+        }
+    }
+    const id = getAttr(element, 'id');
+    if (id !== undefined && id !== '') {
+        anchors.add(id);
+    }
+}
+/**
+ * Parse an HTML file into a `ParseResult`.
+ *
+ * @param filePath - Absolute path to the HTML file.
+ */
+export async function parseHtml(filePath) {
+    const [content, stats] = await Promise.all([
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- filePath is a user-provided path parameter
+        readFile(filePath, 'utf-8'),
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- filePath is a user-provided path parameter
+        stat(filePath),
+    ]);
+    const { document, parseErrors } = parseHtmlDocument(content);
+    const links = [];
+    const anchors = new Set();
+    for (const element of walkElements(document)) {
+        visitElement(element, links, anchors);
+    }
+    const anchorList = [...anchors];
+    return {
+        links,
+        headings: [],
+        content,
+        sizeBytes: stats.size,
+        estimatedTokenCount: Math.ceil(content.length / 4),
+        ...(anchorList.length > 0 && { anchors: anchorList }),
+        ...(parseErrors.length > 0 && { parseErrors }),
+    };
+}
+//# sourceMappingURL=html-link-parser.js.map

package/dist/html-link-parser.js.map

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

package/dist/html-transform.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Structure-preserving HTML link rewriter.
+ *
+ * Rewrites `<a href>` and `<img src>` attribute VALUES in place by splicing the
+ * original source string at parse5-reported offsets. The document is never
+ * re-serialized (parse5's serializer normalizes whitespace, quotes, void
+ * elements, and the doctype), so unchanged input round-trips byte-for-byte.
+ *
+ * Uses the same `RewriteHref` callback model as `rewriteBodyLinks` — callers
+ * supply per-href target resolution; this module owns only the splice mechanics.
+ *
+ * Non-goal: `<base href>` is not honored. Relative hrefs are resolved by the
+ * caller against the file's own directory; a `<base>` element that would
+ * override that in a browser is ignored.
+ */
+import type { RewriteHref } from './rewriter-helpers.js';
+/** A wanted link rewrite that could not be spliced back into the source. */
+export interface UnappliedRewrite {
+    tagName: string;
+    attr: string;
+    /** The original attribute value the rewrite targeted. */
+    from: string;
+    /** The value the rewrite wanted to write. */
+    to: string;
+    /**
+     * Why the splice could not be located:
+     * - `no-source-location` — parse5 omitted the attribute's offsets (synthesized
+     *   during error recovery on malformed input).
+     * - `unparseable-attribute` — the attribute's source span had no locatable
+     *   value (e.g. an unterminated quote).
+     */
+    reason: 'no-source-location' | 'unparseable-attribute';
+}
+/**
+ * Rewrite `<a href>` / `<img src>` values in `source` using `rewriteHref`.
+ * Returns `source` unchanged (byte-for-byte) when no value changes.
+ *
+ * A rewrite that is wanted (the href resolves to a new value) but cannot be
+ * spliced back — because parse5 omitted the source location or the attribute
+ * span is unparseable — is reported via `onUnapplied` rather than dropped
+ * silently. Malformed pages are exactly the ones that hit this path, so the
+ * caller can surface it instead of shipping a stale link.
+ */
+export declare function rewriteHtmlLinks(source: string, rewriteHref: RewriteHref, onUnapplied?: (info: UnappliedRewrite) => void): string;
+//# sourceMappingURL=html-transform.d.ts.map

package/dist/html-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-transform.d.ts","sourceRoot":"","sources":["../src/html-transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAqEzD,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX;;;;;;OAMG;IACH,MAAM,EAAE,oBAAoB,GAAG,uBAAuB,CAAC;CACxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,EACxB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,GAC7C,MAAM,CAsCR"}