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

package/dist/utils.d.ts

@@ -2,6 +2,16 @@
  * Internal utility functions for the resources package.
  * These are not exported from the public API.
  */
+/**
+ * Compute a `ValidationIssue.location`: the (absolute) source file path made
+ * relative to the project root. When no project root is known, fall back to the
+ * source path forward-slashed so the location is still useful and stable.
+ *
+ * @param sourceFilePath - Absolute path to the file the issue was found in.
+ * @param projectRoot - Project root, or undefined when none could be determined.
+ * @returns Forward-slashed relative location (or the forward-slashed absolute path).
+ */
+export declare function issueLocation(sourceFilePath: string, projectRoot: string | undefined): string;
 /**
  * Check if a file path matches a glob pattern.
  *

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAoB7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAS1E;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,MAAM,GACnB,sBAAsB,CA6BxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CA6B9E;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAcjE;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAUxD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI7F;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAoB7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAS1E;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,MAAM,GACnB,sBAAsB,CA6BxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CA6B9E;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAcjE;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAUxD"}

package/dist/utils.js

@@ -6,6 +6,20 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { toForwardSlash, safePath } from '@vibe-agent-toolkit/utils';
 import picomatch from 'picomatch';
+/**
+ * Compute a `ValidationIssue.location`: the (absolute) source file path made
+ * relative to the project root. When no project root is known, fall back to the
+ * source path forward-slashed so the location is still useful and stable.
+ *
+ * @param sourceFilePath - Absolute path to the file the issue was found in.
+ * @param projectRoot - Project root, or undefined when none could be determined.
+ * @returns Forward-slashed relative location (or the forward-slashed absolute path).
+ */
+export function issueLocation(sourceFilePath, projectRoot) {
+    return projectRoot === undefined
+        ? toForwardSlash(sourceFilePath)
+        : safePath.relative(projectRoot, sourceFilePath);
+}
 /**
  * Check if a file path matches a glob pattern.
  *

package/dist/utils.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-agent-toolkit/resources",
-  "version": "0.1.38",
+  "version": "0.1.39-rc.10",
   "description": "Markdown resource parsing, validation, and link integrity checking",
   "type": "module",
   "main": "./dist/index.js",
@@ -33,12 +33,13 @@
   "author": "Jeff Dutton",
   "license": "MIT",
   "dependencies": {
-    "@vibe-agent-toolkit/agent-schema": "0.1.38",
-    "@vibe-agent-toolkit/utils": "0.1.38",
+    "@vibe-agent-toolkit/agent-schema": "0.1.39-rc.10",
+    "@vibe-agent-toolkit/utils": "0.1.39-rc.10",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "github-slugger": "^2.0.0",
     "markdown-link-check": "^3.14.2",
+    "parse5": "^7.2.1",
     "picomatch": "^4.0.3",
     "remark-frontmatter": "^5.0.0",
     "remark-gfm": "^4.0.0",

package/src/frontmatter-link-validator.ts

@@ -7,21 +7,31 @@
  * 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, type IssueCode } from '@vibe-agent-toolkit/agent-schema';
+
 import { classifyLink } from './link-parser.js';
-import { validateLink, type ValidateLinkOptions } from './link-validator.js';
+import { validateLink, type FragmentIndex, type ValidateLinkOptions } from './link-validator.js';
 import { walkFrontmatterUriReferences } from './schema-uri-walker.js';
-import type { HeadingNode, ResourceLink, ValidationIssue } from './types.js';
+import type { ResourceLink, ValidationIssue } from './types.js';
+
+/** Map the link-level code emitted by validateLink to its frontmatter-scoped code. */
+const LINK_CODE_TO_FRONTMATTER_CODE: Partial<Record<IssueCode, IssueCode>> = {
+  LINK_BROKEN_FILE: 'FRONTMATTER_LINK_BROKEN',
+  LINK_BROKEN_ANCHOR: 'FRONTMATTER_ANCHOR_MISSING',
+  LINK_TO_GITIGNORED: 'FRONTMATTER_LINK_TO_GITIGNORED',
+  LINK_UNKNOWN: 'FRONTMATTER_UNKNOWN_LINK',
+};
 
 /** A frontmatter-sourced external URL captured for downstream health checking. */
 export interface FrontmatterExternalUrl {
@@ -41,14 +51,14 @@ 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 async function validateFrontmatterLinks(
   frontmatter: Record<string, unknown> | undefined,
   schema: object,
   sourceFilePath: string,
-  headingsByFile: Map<string, HeadingNode[]>,
+  fragmentsByFile: FragmentIndex,
   options?: ValidateLinkOptions,
 ): Promise<FrontmatterLinkValidationResult> {
   if (!frontmatter) return { issues: [], externalUrls: [] };
@@ -79,7 +89,7 @@ export async function validateFrontmatterLinks(
       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));
@@ -89,24 +99,12 @@ export async function validateFrontmatterLinks(
 }
 
 function rewriteIssue(issue: ValidationIssue, dottedPath: string): ValidationIssue {
-  return {
-    ...issue,
-    type: mapType(issue.type),
-    message: `field \`${dottedPath}\`: ${issue.message}`,
-  };
-}
-
-function mapType(originalType: string): string {
-  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 as IssueCode] ?? (issue.code as IssueCode);
+  const message = `field \`${dottedPath}\`: ${issue.message}`;
+  const extras: Partial<Pick<ValidationIssue, 'location' | 'line' | 'link' | 'suggestion'>> = {};
+  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);
 }

package/src/frontmatter-validator.ts

@@ -13,9 +13,11 @@
  * This is the ONLY place in the codebase that should use AJV.
  */
 
+import { createRegistryIssue, type ValidationIssue } from '@vibe-agent-toolkit/agent-schema';
+
 import { createAjvWithUriFormats } from './ajv-factory.js';
 import type { ValidationMode } from './schemas/project-config.js';
-import type { ValidationIssue } from './schemas/validation-result.js';
+import { issueLocation } from './utils.js';
 
 /**
  * Validate frontmatter against a JSON Schema.
@@ -31,6 +33,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
@@ -54,7 +57,8 @@ export function validateFrontmatter(
   schema: object,
   resourcePath: string,
   mode: ValidationMode = 'strict',
-  schemaPath?: string
+  schemaPath?: string,
+  projectRoot?: string,
 ): ValidationIssue[] {
   const issues: ValidationIssue[] = [];
 
@@ -87,13 +91,13 @@ export function validateFrontmatter(
       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;
   }
@@ -108,13 +112,12 @@ export function validateFrontmatter(
   // Format validation errors with helpful messages
   for (const error of validate.errors) {
     const message = formatValidationError(error, frontmatter, mode, schemaPath);
-    issues.push({
-      resourcePath,
-      line: 1,
-      type: 'frontmatter_schema_error',
-      link: '',
-      message,
-    });
+    issues.push(
+      createRegistryIssue('FRONTMATTER_SCHEMA_ERROR', message, {
+        location: issueLocation(resourcePath, projectRoot),
+        line: 1,
+      }),
+    );
   }
 
   return issues;

package/src/html-link-parser.ts

@@ -0,0 +1,140 @@
+/**
+ * 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, type DefaultTreeAdapterMap } from 'parse5';
+
+import { classifyLink, type ParseResult } from './link-parser.js';
+import type { HtmlParseError } from './schemas/resource-metadata.js';
+import type { ResourceLink } from './types.js';
+
+type P5Node = DefaultTreeAdapterMap['node'];
+type P5Element = DefaultTreeAdapterMap['element'];
+type P5ChildNode = DefaultTreeAdapterMap['childNode'];
+
+/** 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 function parseHtmlDocument(source: string): HtmlDocument {
+  const parseErrors: HtmlParseError[] = [];
+  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: P5Node): Generator<P5Element> {
+  if ('tagName' in node) {
+    yield node;
+  }
+  if ('childNodes' in node) {
+    for (const child of node.childNodes as P5ChildNode[]) {
+      yield* walkElements(child);
+    }
+  }
+}
+
+function getAttr(element: P5Element, name: string): string | undefined {
+  return element.attrs.find((a) => a.name === name)?.value;
+}
+
+function makeLink(href: string, line: number | undefined): ResourceLink {
+  return { text: '', href, type: classifyLink(href), ...(line !== undefined && { line }) };
+}
+
+function visitElement(
+  element: P5Element,
+  links: ResourceLink[],
+  anchors: Set<string>,
+): void {
+  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: string): Promise<ParseResult> {
+  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: ResourceLink[] = [];
+  const anchors = new Set<string>();
+
+  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 }),
+  };
+}

package/src/html-transform.ts

@@ -0,0 +1,157 @@
+/**
+ * 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 { parseHtmlDocument, walkElements } from './html-link-parser.js';
+import type { RewriteHref } from './rewriter-helpers.js';
+
+/** Tag name → the single link-bearing attribute we rewrite. */
+const LINK_ATTR_BY_TAG: Record<string, string | undefined> = { a: 'href', img: 'src' };
+
+interface ValueSpan {
+  valueStart: number;
+  valueEnd: number;
+  /** `"` or `'` for quoted attributes; `''` for unquoted. */
+  quote: string;
+}
+
+interface Edit extends ValueSpan {
+  newValue: string;
+}
+
+/**
+ * Chars that force an unquoted HTML attribute value to be quoted. Follows the
+ * WHATWG unquoted-attribute-value rules: whitespace, quotes, `<`, `>`, plus
+ * backtick and `=` (a superset of paths we expect, kept strict for safety).
+ */
+const UNQUOTED_UNSAFE = /[\s"'`<>=]/;
+
+/**
+ * Locate the value sub-range within an attribute's full source span.
+ *
+ * parse5 reports the whole-attribute span (`href="value"`); this finds the
+ * value's absolute offsets and the quote char. Returns undefined for boolean
+ * attributes (no `=`).
+ */
+function valueSpan(attrSource: string, base: number): ValueSpan | undefined {
+  const eq = attrSource.indexOf('=');
+  if (eq === -1) {
+    return undefined;
+  }
+  let i = eq + 1;
+  while (i < attrSource.length && /\s/.test(attrSource.charAt(i))) {
+    i += 1;
+  }
+  if (i >= attrSource.length) {
+    return undefined;
+  }
+  const ch = attrSource.charAt(i);
+  if (ch === '"' || ch === "'") {
+    const close = attrSource.indexOf(ch, i + 1);
+    const end = close === -1 ? attrSource.length : close;
+    return { valueStart: base + i + 1, valueEnd: base + end, quote: ch };
+  }
+  return { valueStart: base + i, valueEnd: base + attrSource.length, quote: '' };
+}
+
+/**
+ * Encode a new value for writing. For quoted attributes the surrounding quotes
+ * stay in the source (we only replace the inner value), so we escape `&` and the
+ * active quote. For originally-unquoted values we keep them bare when safe, else
+ * wrap in double quotes.
+ */
+function encodeValue(newValue: string, quote: string): string {
+  if (quote === '"' || quote === "'") {
+    const amp = newValue.replaceAll('&', '&amp;');
+    return quote === '"' ? amp.replaceAll('"', '&quot;') : amp.replaceAll("'", '&#39;');
+  }
+  if (newValue.length > 0 && !UNQUOTED_UNSAFE.test(newValue)) {
+    return newValue.replaceAll('&', '&amp;');
+  }
+  const escaped = newValue.replaceAll('&', '&amp;').replaceAll('"', '&quot;');
+  return `"${escaped}"`;
+}
+
+/** 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 function rewriteHtmlLinks(
+  source: string,
+  rewriteHref: RewriteHref,
+  onUnapplied?: (info: UnappliedRewrite) => void,
+): string {
+  const { document } = parseHtmlDocument(source);
+  const edits: Edit[] = [];
+
+  for (const element of walkElements(document)) {
+    const attrName = LINK_ATTR_BY_TAG[element.tagName];
+    if (attrName === undefined) {
+      continue;
+    }
+    const attr = element.attrs.find((a) => a.name === attrName);
+    if (attr === undefined) {
+      continue;
+    }
+    // Resolve first so we only record drops that actually lose a wanted edit.
+    const newValue = rewriteHref(attr.value);
+    if (newValue === attr.value) {
+      continue;
+    }
+    const location = element.sourceCodeLocation?.attrs?.[attrName];
+    if (location === undefined) {
+      onUnapplied?.({ tagName: element.tagName, attr: attrName, from: attr.value, to: newValue, reason: 'no-source-location' });
+      continue;
+    }
+    const span = valueSpan(source.slice(location.startOffset, location.endOffset), location.startOffset);
+    if (span === undefined) {
+      onUnapplied?.({ tagName: element.tagName, attr: attrName, from: attr.value, to: newValue, reason: 'unparseable-attribute' });
+      continue;
+    }
+    edits.push({ ...span, newValue });
+  }
+
+  // Apply descending by start offset so earlier edits don't shift later ones.
+  edits.sort((a, b) => b.valueStart - a.valueStart);
+  let result = source;
+  for (const edit of edits) {
+    result = result.slice(0, edit.valueStart) + encodeValue(edit.newValue, edit.quote) + result.slice(edit.valueEnd);
+  }
+  return result;
+}

package/src/index.ts

@@ -83,7 +83,12 @@ export {
 } from './schemas/validation-result.js';
 
 // Export parser interface for advanced use cases
-export { parseMarkdown, type ParseResult } from './link-parser.js';
+export { parseMarkdown, classifyLink, isLocalFileLink, type ParseResult } from './link-parser.js';
+
+export { parseHtml } from './html-link-parser.js';
+// HtmlParseError is Zod-sourced (single source of truth) — see schemas/resource-metadata.ts.
+export type { HtmlParseError } from './schemas/resource-metadata.js';
+export { rewriteHtmlLinks, type UnappliedRewrite } from './html-transform.js';
 
 // Export frontmatter validation
 export { validateFrontmatter } from './frontmatter-validator.js';
@@ -134,4 +139,8 @@ export {
   SkillFileEntrySchema,
   SkillsConfigSchema,
   SkillPackagingConfigSchema,
+  SkillSourceDescriptorSchema,
+  TestConfigSchema,
+  type SkillSourceDescriptor,
+  type TestConfig,
 } from './schemas/project-config.js';