@vibe-agent-toolkit/agent-skills 0.1.39-rc.1 → 0.1.39-rc.10

package/dist/files-config.d.ts

@@ -5,6 +5,7 @@
  * - Merging defaults + per-skill entries (additive, per-skill wins on dest collision)
  * - Matching auto-discovered links to files entries
  * - Computing deferred paths for validation
+ * - Copying declared build artifacts into a skill output dir (every build path)
  */
 import type { SkillFileEntry } from '@vibe-agent-toolkit/resources';
 export type { SkillFileEntry } from '@vibe-agent-toolkit/resources';
@@ -36,13 +37,88 @@ export declare function mergeFilesConfig(defaults: SkillFileEntry[] | undefined,
  */
 export declare function matchLinkToFiles(linkTarget: string, files: SkillFileEntry[]): FilesMatchResult | null;
 /**
- * Compute the set of paths that should be treated as "deferred" during
- * source-time validation. These are paths from files config entries where
- * the file may not exist yet (build artifacts).
+ * Structured deferred path sets returned by {@link computeDeferredPaths}.
  *
- * Both source and dest paths are included because:
- * - source may be a build artifact that doesn't exist at validation time
- * - dest is the target location that won't exist until build time
+ * - `destPaths` — files: dest paths that are always deferred (the target
+ *   location won't exist until build time).
+ * - `sourcePaths` — files: source paths that are deferred ONLY when the
+ *   target does not yet exist on disk (i.e. genuine build artifacts). A
+ *   source that already exists on disk and is gitignored is a leak and must
+ *   NOT be deferred — let it fall through to the gitignore branch.
  */
-export declare function computeDeferredPaths(files: SkillFileEntry[]): Set<string>;
+export interface DeferredPaths {
+    /** files: dest paths — always deferred (won't exist until build). */
+    destPaths: Set<string>;
+    /** files: source paths — deferred ONLY when the target does not yet exist (build artifact). */
+    sourcePaths: Set<string>;
+}
+/**
+ * Options for {@link computeDeferredPaths}.
+ *
+ * - `skillDir`    — absolute path to the directory containing SKILL.md.
+ *                   `files:` dest values are authored relative to this dir.
+ * - `projectRoot` — absolute path to the project root (git / config root).
+ *                   `files:` source values are authored relative to this dir.
+ */
+export interface ComputeDeferredPathsOpts {
+    skillDir: string;
+    projectRoot: string;
+}
+/**
+ * Compute the structured sets of paths that should be treated as "deferred"
+ * during source-time validation. These are paths from files config entries
+ * where the file may not exist yet (build artifacts).
+ *
+ * Both sets contain **project-root-relative, forward-slash** paths so they
+ * match the `rel` value computed in `checkDeferred()` inside walk-link-graph:
+ *
+ * ```ts
+ * const rel = toForwardSlash(safePath.relative(projectRoot, targetPath));
+ * ```
+ *
+ * - `dest` is authored relative to `skillDir` (mirroring `skill-packager.ts`
+ *   `resolve(skillDir, entry.dest)`). We resolve it to an absolute path and
+ *   then make it relative to `projectRoot`.
+ * - `source` is authored relative to `projectRoot`. We resolve it with the
+ *   exact expression `skill-packager.ts` uses —
+ *   `resolve(join(projectRoot, entry.source))` — so an absolute-looking source
+ *   is rooted UNDER `projectRoot` identically to what the packager copies.
+ *   (A bare `resolve(projectRoot, source)` would let a leading slash escape the
+ *   root, yielding a `../`-prefixed path that never matches the walker's `rel`.)
+ *   Resolving then re-relativising is a no-op for clean relative paths but
+ *   correctly strips any leading `./`.
+ *
+ * - dest paths are always deferred (target won't exist until build)
+ * - source paths are deferred only when the target does not yet exist on disk
+ */
+export declare function computeDeferredPaths(files: SkillFileEntry[], opts: ComputeDeferredPathsOpts): DeferredPaths;
+/** Options for {@link applyFilesConfig}. */
+export interface ApplyFilesConfigOptions {
+    /** Merged `files:` entries to copy. */
+    filesConfig: SkillFileEntry[];
+    /** Absolute project root; each `source` resolves relative to it. */
+    projectRoot: string;
+    /** Absolute skill output dir; each `dest` resolves relative to it. */
+    skillOutputDir: string;
+    /**
+     * Absolute source paths already materialized by link traversal — skipped so
+     * a linked-and-copied asset isn't copied twice. Defaults to none (copy all).
+     */
+    bundledFiles?: string[];
+}
+/**
+ * Copy each `files:` entry's `source` → `dest` into the skill output directory.
+ *
+ * This is the single copy primitive shared by every build path so that
+ * build-provided artifacts (a bundled engine, generated data, a catalog) are
+ * VAT-managed end-to-end: the shared-pool `vat skills build` packager and the
+ * Claude plugin marketplace build both call it, instead of the latter relying on
+ * an external inject script VAT can't see. `source` is resolved the same way the
+ * packager does (`resolve(join(projectRoot, source))`, so an absolute-looking
+ * source roots UNDER the project). Returns the dest paths actually copied.
+ *
+ * @throws if a declared `source` does not exist — a declared build artifact must
+ * be present at copy time (callers that defer existence validate it upstream).
+ */
+export declare function applyFilesConfig(opts: ApplyFilesConfigOptions): Promise<string[]>;
 //# sourceMappingURL=files-config.d.ts.map

package/dist/files-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files-config.d.ts","sourceRoot":"","sources":["../src/files-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC;IACzB,+BAA+B;IAC/B,KAAK,EAAE,cAAc,CAAC;CACvB;AAaD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EAAE,GAAG,SAAS,EACtC,QAAQ,EAAE,cAAc,EAAE,GAAG,SAAS,GACrC,cAAc,EAAE,CA6ClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,cAAc,EAAE,GACtB,gBAAgB,GAAG,IAAI,CAkBzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAOzE"}
+{"version":3,"file":"files-config.d.ts","sourceRoot":"","sources":["../src/files-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC;IACzB,+BAA+B;IAC/B,KAAK,EAAE,cAAc,CAAC;CACvB;AAaD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EAAE,GAAG,SAAS,EACtC,QAAQ,EAAE,cAAc,EAAE,GAAG,SAAS,GACrC,cAAc,EAAE,CA6ClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,cAAc,EAAE,GACtB,gBAAgB,GAAG,IAAI,CAkBzB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,+FAA+F;IAC/F,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EAAE,EACvB,IAAI,EAAE,wBAAwB,GAC7B,aAAa,CAgBf;AAED,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,uCAAuC;IACvC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBvF"}

package/dist/files-config.js

@@ -5,8 +5,12 @@
  * - Merging defaults + per-skill entries (additive, per-skill wins on dest collision)
  * - Matching auto-discovered links to files entries
  * - Computing deferred paths for validation
+ * - Copying declared build artifacts into a skill output dir (every build path)
  */
-import { toForwardSlash } from '@vibe-agent-toolkit/utils';
+import { existsSync } from 'node:fs';
+import { copyFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { toForwardSlash, safePath } from '@vibe-agent-toolkit/utils';
 /**
  * Normalize a path for comparison: strip leading ./ and normalize slashes.
  */
@@ -91,20 +95,76 @@ export function matchLinkToFiles(linkTarget, files) {
     return null;
 }
 /**
- * Compute the set of paths that should be treated as "deferred" during
- * source-time validation. These are paths from files config entries where
- * the file may not exist yet (build artifacts).
+ * Compute the structured sets of paths that should be treated as "deferred"
+ * during source-time validation. These are paths from files config entries
+ * where the file may not exist yet (build artifacts).
  *
- * Both source and dest paths are included because:
- * - source may be a build artifact that doesn't exist at validation time
- * - dest is the target location that won't exist until build time
+ * Both sets contain **project-root-relative, forward-slash** paths so they
+ * match the `rel` value computed in `checkDeferred()` inside walk-link-graph:
+ *
+ * ```ts
+ * const rel = toForwardSlash(safePath.relative(projectRoot, targetPath));
+ * ```
+ *
+ * - `dest` is authored relative to `skillDir` (mirroring `skill-packager.ts`
+ *   `resolve(skillDir, entry.dest)`). We resolve it to an absolute path and
+ *   then make it relative to `projectRoot`.
+ * - `source` is authored relative to `projectRoot`. We resolve it with the
+ *   exact expression `skill-packager.ts` uses —
+ *   `resolve(join(projectRoot, entry.source))` — so an absolute-looking source
+ *   is rooted UNDER `projectRoot` identically to what the packager copies.
+ *   (A bare `resolve(projectRoot, source)` would let a leading slash escape the
+ *   root, yielding a `../`-prefixed path that never matches the walker's `rel`.)
+ *   Resolving then re-relativising is a no-op for clean relative paths but
+ *   correctly strips any leading `./`.
+ *
+ * - dest paths are always deferred (target won't exist until build)
+ * - source paths are deferred only when the target does not yet exist on disk
  */
-export function computeDeferredPaths(files) {
-    const paths = new Set();
+export function computeDeferredPaths(files, opts) {
+    const destPaths = new Set();
+    const sourcePaths = new Set();
     for (const entry of files) {
-        paths.add(normalizePath(entry.source));
-        paths.add(normalizePath(entry.dest));
+        // dest is authored relative to skillDir (skill-packager: resolve(skillDir, dest))
+        destPaths.add(toForwardSlash(safePath.relative(opts.projectRoot, safePath.resolve(opts.skillDir, entry.dest))));
+        // source is authored relative to projectRoot. Mirror skill-packager exactly:
+        // resolve(join(projectRoot, source)) so absolute-looking sources root under
+        // projectRoot rather than escaping it.
+        sourcePaths.add(toForwardSlash(safePath.relative(opts.projectRoot, safePath.resolve(safePath.join(opts.projectRoot, entry.source)))));
+    }
+    return { destPaths, sourcePaths };
+}
+/**
+ * Copy each `files:` entry's `source` → `dest` into the skill output directory.
+ *
+ * This is the single copy primitive shared by every build path so that
+ * build-provided artifacts (a bundled engine, generated data, a catalog) are
+ * VAT-managed end-to-end: the shared-pool `vat skills build` packager and the
+ * Claude plugin marketplace build both call it, instead of the latter relying on
+ * an external inject script VAT can't see. `source` is resolved the same way the
+ * packager does (`resolve(join(projectRoot, source))`, so an absolute-looking
+ * source roots UNDER the project). Returns the dest paths actually copied.
+ *
+ * @throws if a declared `source` does not exist — a declared build artifact must
+ * be present at copy time (callers that defer existence validate it upstream).
+ */
+export async function applyFilesConfig(opts) {
+    const bundledFileSet = new Set((opts.bundledFiles ?? []).map((f) => toForwardSlash(f)));
+    const copied = [];
+    for (const fileEntry of opts.filesConfig) {
+        const absoluteSource = safePath.resolve(safePath.join(opts.projectRoot, fileEntry.source));
+        if (bundledFileSet.has(toForwardSlash(absoluteSource)))
+            continue;
+        const absoluteDest = safePath.join(opts.skillOutputDir, fileEntry.dest);
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- source path from validated config
+        if (!existsSync(absoluteSource)) {
+            throw new Error(`files: source '${fileEntry.source}' does not exist (resolved to ${absoluteSource}).`);
+        }
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- dest path from validated config
+        await mkdir(dirname(absoluteDest), { recursive: true });
+        await copyFile(absoluteSource, absoluteDest);
+        copied.push(fileEntry.dest);
     }
-    return paths;
+    return copied;
 }
 //# sourceMappingURL=files-config.js.map

package/dist/files-config.js.map

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

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export { buildAgentSkill, type BuildOptions, type BuildResult } from './builder.
 export { extractH1Title, packageSkill, packageSkills, ZipSizeLimitError, type PackageSkillOptions, type PackageSkillResult, type PackagingTarget, type SkillBuildSpec, type SkillMetadata, } from './skill-packager.js';
 export { walkLinkGraph, type ExcludeRule, type LinkGraphResult, type LinkResolution, type WalkableRegistry, type WalkLinkGraphOptions, } from './walk-link-graph.js';
 export { getTargetSubdir, CONTENT_TYPE_ROUTING_MAP, type TargetSubdirCategory, } from './content-type-routing.js';
-export { mergeFilesConfig, matchLinkToFiles, computeDeferredPaths, type FilesMatchResult, } from './files-config.js';
+export { applyFilesConfig, mergeFilesConfig, matchLinkToFiles, computeDeferredPaths, type ApplyFilesConfigOptions, type ComputeDeferredPathsOpts, type DeferredPaths, type FilesMatchResult, } from './files-config.js';
 export { AgentSkillFrontmatterJsonSchema, AgentSkillFrontmatterSchema, VATAgentSkillFrontmatterSchema, type AgentSkillFrontmatter, type VATAgentSkillFrontmatter, } from './schemas/agent-skill-frontmatter.js';
 export { MarketplaceManifestJsonSchema, MarketplaceManifestSchema, type MarketplaceManifest } from './schemas/marketplace-manifest.js';
 export { PluginJsonSchema, type PluginJson } from './schemas/plugin-json.js';
@@ -23,9 +23,13 @@ export { crawlAndResolveRegistry, validateSkillForPackaging, type ExcludedRefere
 export { createIssue, NAVIGATION_FILE_PATTERNS, VALIDATION_RULES, VALIDATION_THRESHOLDS, type RuleCategory, type ValidationRule, type ValidationRuleCode, } from './validators/validation-rules.js';
 export type { ValidationResult, ValidateOptions, ResourceFormat, Surface, } from './validators/types.js';
 export { importSkillToAgent, type ImportOptions, type ImportResult, } from './import.js';
+export { cloneGitSource, type GitCloneResult } from './skill-source/git-clone.js';
+export { resolveSkillSource, type ResolveSkillSourceOptions } from './skill-source/resolve-skill-source.js';
+export type { SkillSource, ResolvedSkillSource, ResolveSkillSourceContext, } from './skill-source/types.js';
 export type { EvidenceRecord, EvidenceSource, EvidenceConfidence, EvidenceLocation, PatternDefinition, Observation, } from './evidence/index.js';
 export { PATTERN_REGISTRY, getPatternDefinition, assertPatternRegistered, deriveObservationsFromEvidence, } from './evidence/index.js';
 export type { DeriveObservationsOptions, DerivationSubject } from './evidence/index.js';
 export type { AnyInventory, BaseInventory, ComponentRef, DeclaredList, HookRef, InstallInventory, LspRef, MarketplaceInventory, McpRef, ParseError as InventoryParseError, PluginInventory, PluginRef, ResolvedReference, SkillInventory, } from './inventory/index.js';
 export { isInstallInventory, isMarketplaceInventory, isPluginInventory, isSkillInventory, serializeInventory, serializeInventoryShallow, INVENTORY_SCHEMA_VERSION, detectDeclaredButMissing, detectMarketplacePluginSourceMissing, detectPresentButUndeclared, detectReferenceTargetMissing, } from './inventory/index.js';
+export * from './skill-test/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -6,7 +6,7 @@ export { buildAgentSkill } from './builder.js';
 export { extractH1Title, packageSkill, packageSkills, ZipSizeLimitError, } from './skill-packager.js';
 export { walkLinkGraph, } from './walk-link-graph.js';
 export { getTargetSubdir, CONTENT_TYPE_ROUTING_MAP, } from './content-type-routing.js';
-export { mergeFilesConfig, matchLinkToFiles, computeDeferredPaths, } from './files-config.js';
+export { applyFilesConfig, mergeFilesConfig, matchLinkToFiles, computeDeferredPaths, } from './files-config.js';
 export { AgentSkillFrontmatterJsonSchema, AgentSkillFrontmatterSchema, VATAgentSkillFrontmatterSchema, } from './schemas/agent-skill-frontmatter.js';
 export { MarketplaceManifestJsonSchema, MarketplaceManifestSchema } from './schemas/marketplace-manifest.js';
 export { PluginJsonSchema } from './schemas/plugin-json.js';
@@ -22,6 +22,11 @@ export { detectResourceFormat, enumerateSurfaces } from './validators/format-det
 export { crawlAndResolveRegistry, validateSkillForPackaging, } from './validators/packaging-validator.js';
 export { createIssue, NAVIGATION_FILE_PATTERNS, VALIDATION_RULES, VALIDATION_THRESHOLDS, } from './validators/validation-rules.js';
 export { importSkillToAgent, } from './import.js';
+// Skill source primitives
+export { cloneGitSource } from './skill-source/git-clone.js';
+// Unified skill-source resolution (spec §11c)
+export { resolveSkillSource } from './skill-source/resolve-skill-source.js';
 export { PATTERN_REGISTRY, getPatternDefinition, assertPatternRegistered, deriveObservationsFromEvidence, } from './evidence/index.js';
 export { isInstallInventory, isMarketplaceInventory, isPluginInventory, isSkillInventory, serializeInventory, serializeInventoryShallow, INVENTORY_SCHEMA_VERSION, detectDeclaredButMissing, detectMarketplacePluginSourceMissing, detectPresentButUndeclared, detectReferenceTargetMissing, } from './inventory/index.js';
+export * from './skill-test/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAuC,MAAM,cAAc,CAAC;AAEpF,OAAO,EACL,cAAc,EACd,YAAY,EACZ,aAAa,EACb,iBAAiB,GAMlB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,aAAa,GAMd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,wBAAwB,GAEzB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GAErB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,+BAA+B,EAC/B,2BAA2B,EAC3B,8BAA8B,GAG/B,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,6BAA6B,EAAE,yBAAyB,EAA4B,MAAM,mCAAmC,CAAC;AAEvI,OAAO,EAAE,gBAAgB,EAAmB,MAAM,0BAA0B,CAAC;AAE7E,OAAO,EACL,gBAAgB,GAEjB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACpG,OAAO,EAAE,wBAAwB,EAAyB,MAAM,sCAAsC,CAAC;AACvG,OAAO,EAAE,8BAA8B,EAAE,MAAM,2CAA2C,CAAC;AAC3F,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GAEnB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,QAAQ,EAA+B,MAAM,mCAAmC,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC3F,OAAO,EACL,uBAAuB,EACvB,yBAAyB,GAK1B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,WAAW,EACX,wBAAwB,EACxB,gBAAgB,EAChB,qBAAqB,GAItB,MAAM,kCAAkC,CAAC;AAQ1C,OAAO,EACL,kBAAkB,GAGnB,MAAM,aAAa,CAAC;AAWrB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAoB7B,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,oCAAoC,EACpC,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAuC,MAAM,cAAc,CAAC;AAEpF,OAAO,EACL,cAAc,EACd,YAAY,EACZ,aAAa,EACb,iBAAiB,GAMlB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,aAAa,GAMd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,wBAAwB,GAEzB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GAKrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,+BAA+B,EAC/B,2BAA2B,EAC3B,8BAA8B,GAG/B,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,6BAA6B,EAAE,yBAAyB,EAA4B,MAAM,mCAAmC,CAAC;AAEvI,OAAO,EAAE,gBAAgB,EAAmB,MAAM,0BAA0B,CAAC;AAE7E,OAAO,EACL,gBAAgB,GAEjB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACpG,OAAO,EAAE,wBAAwB,EAAyB,MAAM,sCAAsC,CAAC;AACvG,OAAO,EAAE,8BAA8B,EAAE,MAAM,2CAA2C,CAAC;AAC3F,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GAEnB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,QAAQ,EAA+B,MAAM,mCAAmC,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC3F,OAAO,EACL,uBAAuB,EACvB,yBAAyB,GAK1B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,WAAW,EACX,wBAAwB,EACxB,gBAAgB,EAChB,qBAAqB,GAItB,MAAM,kCAAkC,CAAC;AAQ1C,OAAO,EACL,kBAAkB,GAGnB,MAAM,aAAa,CAAC;AAErB,0BAA0B;AAC1B,OAAO,EAAE,cAAc,EAAuB,MAAM,6BAA6B,CAAC;AAElF,8CAA8C;AAC9C,OAAO,EAAE,kBAAkB,EAAkC,MAAM,wCAAwC,CAAC;AAgB5G,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAoB7B,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,oCAAoC,EACpC,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAE9B,cAAc,uBAAuB,CAAC"}

package/dist/post-build-checks.d.ts

@@ -6,18 +6,18 @@
  */
 import { type ValidationIssue } from '@vibe-agent-toolkit/agent-schema';
 /**
- * Check that every file in the packaged output is referenced from some markdown file.
+ * Check that every file in the packaged output is referenced from some markdown or HTML file.
  *
  * Two-pass detection:
- * 1. Walk `[text](href)` link graph from SKILL.md (strict, transitive).
+ * 1. Walk formal link graph from SKILL.md (strict, transitive, covers .md and .html/.htm).
  * 2. For files not covered by pass 1, check whether their output-relative path
- *    is mentioned anywhere in packaged markdown (code blocks, prose, etc.).
+ *    is mentioned anywhere in packaged content files (markdown or HTML).
  *    Authors often document CLI scripts via invocation examples rather than
- *    markdown links, and that counts as documented.
+ *    formal links, and that counts as documented.
  */
 export declare function checkUnreferencedFiles(outputDir: string): Promise<ValidationIssue[]>;
 /**
- * Check that every local file link in packaged markdown files resolves to a file
+ * Check that every local file link in packaged markdown and HTML files resolves to a file
  * that exists in the packaged output.
  */
 export declare function checkBrokenPackagedLinks(outputDir: string): Promise<ValidationIssue[]>;

package/dist/post-build-checks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"post-build-checks.d.ts","sourceRoot":"","sources":["../src/post-build-checks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,kCAAkC,CAAC;AA4JvF;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA4B1F;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA6B5F"}
+{"version":3,"file":"post-build-checks.d.ts","sourceRoot":"","sources":["../src/post-build-checks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,kCAAkC,CAAC;AA0OxE;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAmC1F;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAe5F"}

package/dist/post-build-checks.js

@@ -4,11 +4,12 @@
  * Run after packageSkill() completes — all files are copied, all links rewritten.
  * Detects unreferenced files and broken links in the packaged output.
  */
-import { existsSync, readdirSync } from 'node:fs';
+import { existsSync, readdirSync, statSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
-import { CODE_REGISTRY } from '@vibe-agent-toolkit/agent-schema';
+import { parseHtml } from '@vibe-agent-toolkit/resources';
 import { safePath, toForwardSlash } from '@vibe-agent-toolkit/utils';
+import { evaluate, makeRuleContext, materializeIssue } from './validators/rule-engine/index.js';
 /**
  * Regex matching markdown inline links: [text](href).
  * Negated character classes [^\]\\] and [^)] are non-backtracking by design.
@@ -76,38 +77,105 @@ function extractLocalLinks(content) {
     return links;
 }
 /**
- * Walk the markdown link graph starting at SKILL.md and return the set of
+ * Extract local file hrefs from a content file — markdown or HTML.
+ *
+ * For markdown: regex-matches `[text](href)` links, skipping code blocks.
+ * For HTML/HTM: uses `parseHtml` (parse5-based) and returns `local_file` hrefs only.
+ * Fragments are stripped from all returned hrefs.
+ */
+async function extractLocalHrefs(filePath) {
+    if (filePath.endsWith('.html') || filePath.endsWith('.htm')) {
+        const result = await parseHtml(filePath);
+        return result.links
+            .filter(link => link.type === 'local_file')
+            .map(link => {
+            const [withoutFragment] = link.href.split('#');
+            return withoutFragment ?? '';
+        })
+            .filter(href => href.length > 0);
+    }
+    // Markdown: read content and regex-match
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- filePath from walkDir
+    const content = await readFile(filePath, 'utf-8');
+    return extractLocalLinks(content);
+}
+/**
+ * Check hrefs from a content file against allFileSet and return PACKAGED_BROKEN_LINK
+ * issues for any that don't resolve to a file in the packaged output.
+ *
+ * Shared by markdown and HTML broken-link checks to eliminate duplicate resolve/emit logic.
+ */
+function collectBrokenLinkIssues(sourceFile, hrefs, allFileSet, outputDir) {
+    const issues = [];
+    const relativeSourcePath = toForwardSlash(safePath.relative(outputDir, sourceFile));
+    for (const href of hrefs) {
+        const resolved = toForwardSlash(safePath.resolve(dirname(sourceFile), href));
+        if (!allFileSet.has(resolved)) {
+            // A navigational directory link (href ending in `/`, classified `local_directory`)
+            // is a valid target if the directory itself exists on disk — walkDir populates
+            // allFileSet with FILES only, so directory paths are never in the set.
+            // Note: a NO-SLASH link (`[Concepts](concepts)`, classified `local_file`) that
+            // happens to resolve to a directory is a different case — it matches the
+            // link-rewrite bundled-link rule (skill-packager.ts buildRewriteRules) and
+            // renders with an undefined `link.resource.*`. Fixing that is the
+            // link-rewrite engine's job, tracked under #129 (slice 3, built-path
+            // unification). The slash form (`concepts/`, `local_directory`) survives
+            // rewrite verbatim and is the realistic navigational case this guard covers.
+            // eslint-disable-next-line security/detect-non-literal-fs-filename -- resolved is a normalized path from a validated output directory
+            const isExistingDirectory = statSync(resolved, { throwIfNoEntry: false })?.isDirectory() === true;
+            if (isExistingDirectory) {
+                continue;
+            }
+            // Built-path edge extraction: a link whose target is absent from the
+            // packaged output. The engine resolves this to PACKAGED_BROKEN_LINK
+            // (a link-rewriter bug) rather than LINK_MISSING_TARGET via phase: 'built'.
+            const code = evaluate(makeRuleContext({ subject: 'edge', phase: 'built', existsAtSource: false }));
+            if (code !== null) {
+                issues.push(materializeIssue(code, {
+                    location: relativeSourcePath,
+                    detail: `link: ${href} from ${relativeSourcePath}`,
+                }));
+            }
+        }
+    }
+    return issues;
+}
+/**
+ * Walk the markdown and HTML link graph starting at SKILL.md and return the set of
  * referenced file paths (normalized to forward slashes).
  *
- * SKILL.md itself is always included as the root.
+ * SKILL.md itself is always included as the root. Traversal follows `.md`, `.html`,
+ * and `.htm` links transitively so an HTML file referenced only by another HTML file
+ * is not reported as unreferenced.
  */
 async function collectReferencedPaths(outputDir, allFileSet) {
     const referenced = new Set();
     const skillMdPath = safePath.join(outputDir, 'SKILL.md');
-    const mdQueue = [skillMdPath];
+    const fileQueue = [skillMdPath];
     const visited = new Set();
     // SKILL.md itself is the root — always referenced
     referenced.add(toForwardSlash(skillMdPath));
-    while (mdQueue.length > 0) {
-        const mdFile = mdQueue.shift();
-        if (!mdFile)
+    while (fileQueue.length > 0) {
+        const filePath = fileQueue.shift();
+        if (!filePath)
             break;
-        const normalized = toForwardSlash(mdFile);
+        const normalized = toForwardSlash(filePath);
         if (visited.has(normalized))
             continue;
         visited.add(normalized);
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- mdFile from walkDir output
-        if (!existsSync(mdFile))
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- filePath from walkDir output
+        if (!existsSync(filePath))
             continue;
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- mdFile validated above
-        const content = await readFile(mdFile, 'utf-8');
-        const links = extractLocalLinks(content);
-        for (const href of links) {
-            const resolved = toForwardSlash(safePath.resolve(dirname(mdFile), href));
+        const hrefs = await extractLocalHrefs(filePath);
+        for (const href of hrefs) {
+            const resolved = toForwardSlash(safePath.resolve(dirname(filePath), href));
             referenced.add(resolved);
-            // If it's a markdown file in the output, traverse it transitively
-            if (resolved.endsWith('.md') && allFileSet.has(resolved) && !visited.has(resolved)) {
-                mdQueue.push(resolved);
+            // Traverse .md, .html, and .htm files transitively
+            const isTraversable = (resolved.endsWith('.md') || resolved.endsWith('.html') || resolved.endsWith('.htm')) &&
+                allFileSet.has(resolved) &&
+                !visited.has(resolved);
+            if (isTraversable) {
+                fileQueue.push(resolved);
             }
         }
     }
@@ -115,22 +183,22 @@ async function collectReferencedPaths(outputDir, allFileSet) {
 }
 /**
  * Record packaged files whose output-relative path appears anywhere in any
- * packaged markdown — inside code blocks (`` ```bash\nnode scripts/cli.mjs `` ``),
- * inline code spans, or prose — as "documented" references.
+ * packaged content file (markdown or HTML) — inside code blocks, inline code
+ * spans, or prose — as "documented" references.
  *
  * A file that a skill author chose to bundle but never documents is the real
  * problem this check exists to catch; documentation by code-block invocation
  * is still documentation. By contrast, `collectReferencedPaths` is intentionally
- * strict (only `[text](href)` links) because it also walks the transitive link
+ * strict (only formal link syntax) because it also walks the transitive link
  * graph, which would be unbounded if we followed substring hits.
  */
-async function addMentionReferences(outputDir, referenced, candidates, mdFiles) {
-    if (candidates.length === 0 || mdFiles.length === 0) {
+async function addMentionReferences(outputDir, referenced, candidates, contentFiles) {
+    if (candidates.length === 0 || contentFiles.length === 0) {
         return;
     }
     const contents = await Promise.all(
-    // eslint-disable-next-line security/detect-non-literal-fs-filename -- mdFile from walkDir
-    mdFiles.map(f => readFile(f, 'utf-8')));
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- contentFile from walkDir
+    contentFiles.map(f => readFile(f, 'utf-8')));
     const haystack = contents.join('\n');
     for (const candidate of candidates) {
         const relativePath = toForwardSlash(safePath.relative(outputDir, candidate));
@@ -140,68 +208,58 @@ async function addMentionReferences(outputDir, referenced, candidates, mdFiles)
     }
 }
 /**
- * Check that every file in the packaged output is referenced from some markdown file.
+ * Check that every file in the packaged output is referenced from some markdown or HTML file.
  *
  * Two-pass detection:
- * 1. Walk `[text](href)` link graph from SKILL.md (strict, transitive).
+ * 1. Walk formal link graph from SKILL.md (strict, transitive, covers .md and .html/.htm).
  * 2. For files not covered by pass 1, check whether their output-relative path
- *    is mentioned anywhere in packaged markdown (code blocks, prose, etc.).
+ *    is mentioned anywhere in packaged content files (markdown or HTML).
  *    Authors often document CLI scripts via invocation examples rather than
- *    markdown links, and that counts as documented.
+ *    formal links, and that counts as documented.
  */
 export async function checkUnreferencedFiles(outputDir) {
     const allFiles = walkDir(outputDir);
     const allFileSet = new Set(allFiles.map(f => toForwardSlash(f)));
     const referenced = await collectReferencedPaths(outputDir, allFileSet);
-    // Second pass: treat any path mention in packaged markdown as documentation.
+    // Second pass: treat any path mention in packaged content files as documentation.
     const candidates = allFiles.filter(f => !referenced.has(toForwardSlash(f)));
-    const mdFiles = allFiles.filter(f => f.endsWith('.md'));
-    await addMentionReferences(outputDir, referenced, candidates, mdFiles);
+    const contentFiles = allFiles.filter(f => f.endsWith('.md') || f.endsWith('.html') || f.endsWith('.htm'));
+    await addMentionReferences(outputDir, referenced, candidates, contentFiles);
     // Find unreferenced files
     const issues = [];
     for (const file of allFiles) {
         const normalized = toForwardSlash(file);
         if (!referenced.has(normalized)) {
             const relativePath = toForwardSlash(safePath.relative(outputDir, file));
-            issues.push({
-                severity: CODE_REGISTRY.PACKAGED_UNREFERENCED_FILE.defaultSeverity,
-                code: 'PACKAGED_UNREFERENCED_FILE',
-                message: `Packaged file not referenced from any markdown: ${relativePath}`,
-                location: relativePath,
-                fix: CODE_REGISTRY.PACKAGED_UNREFERENCED_FILE.fix,
-                reference: CODE_REGISTRY.PACKAGED_UNREFERENCED_FILE.reference,
-            });
+            // Built-path file extraction: a packaged file reachable by neither link
+            // nor mention nor files: declaration. The engine resolves this to
+            // PACKAGED_UNREFERENCED_FILE for a skill-bundled copy at the built phase.
+            const code = evaluate(makeRuleContext({
+                subject: 'file',
+                phase: 'built',
+                copyRole: 'skill-bundled',
+                reachableFromSkillMd: false,
+                referencedHow: 'none',
+            }));
+            if (code !== null) {
+                issues.push(materializeIssue(code, { location: relativePath, detail: relativePath }));
+            }
         }
     }
     return issues;
 }
 /**
- * Check that every local file link in packaged markdown files resolves to a file
+ * Check that every local file link in packaged markdown and HTML files resolves to a file
  * that exists in the packaged output.
  */
 export async function checkBrokenPackagedLinks(outputDir) {
     const allFiles = walkDir(outputDir);
-    const mdFiles = allFiles.filter(f => f.endsWith('.md'));
+    const linkableFiles = allFiles.filter(f => f.endsWith('.md') || f.endsWith('.html') || f.endsWith('.htm'));
     const allFileSet = new Set(allFiles.map(f => toForwardSlash(f)));
     const issues = [];
-    for (const mdFile of mdFiles) {
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- mdFile from walkDir
-        const content = await readFile(mdFile, 'utf-8');
-        const links = extractLocalLinks(content);
-        const relativeMdPath = toForwardSlash(safePath.relative(outputDir, mdFile));
-        for (const href of links) {
-            const resolved = toForwardSlash(safePath.resolve(dirname(mdFile), href));
-            if (!allFileSet.has(resolved)) {
-                issues.push({
-                    severity: CODE_REGISTRY.PACKAGED_BROKEN_LINK.defaultSeverity,
-                    code: 'PACKAGED_BROKEN_LINK',
-                    message: `Broken link in packaged output: ${href} (from ${relativeMdPath})`,
-                    location: relativeMdPath,
-                    fix: CODE_REGISTRY.PACKAGED_BROKEN_LINK.fix,
-                    reference: CODE_REGISTRY.PACKAGED_BROKEN_LINK.reference,
-                });
-            }
-        }
+    for (const sourceFile of linkableFiles) {
+        const hrefs = await extractLocalHrefs(sourceFile);
+        issues.push(...collectBrokenLinkIssues(sourceFile, hrefs, allFileSet, outputDir));
     }
     return issues;
 }