@vibe-agent-toolkit/agent-skills 0.1.41-rc.7 → 0.1.41

package/dist/validators/validation-rules.js

@@ -1,14 +1,19 @@
 /**
  * Validation rules for Claude Code skills
  *
- * Based on Anthropic's official guidance and research findings:
- * - SKILL.md recommended: ≤500 lines
- * - Total skill size: ≤2000 lines
- * - File count: ≤6 files
- * - Reference depth: ≤2 levels
+ * Thresholds and their provenance — do not read this list as "Anthropic says so".
+ * Only the first is Anthropic's; the rest are VAT's, and two of them Anthropic
+ * actively contradicts. The full audit is in the comment above
+ * VALIDATION_THRESHOLDS below; read it before tuning any number here.
+ *
+ * - SKILL.md recommended: ≤500 lines  (Anthropic's, verbatim)
+ * - Total skill size: ≤2000 lines     (VAT's; Anthropic counter-signals it)
+ * - File count: ≤6 files              (VAT's; Anthropic counter-signals it)
+ * - Reference depth: ≤2 levels        (VAT's; Anthropic's rule is ONE level)
  *
  * References:
  * - https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices
+ * - docs/external/anthropic-skill-authoring-best-practices.md (dated cache of the above)
  * - https://github.com/anthropics/skills (official examples)
  */
 /**
@@ -34,12 +39,11 @@ export const VALIDATION_RULES = {
         message: (ctx) => `Link points outside project: ${ctx['href'] ?? 'unknown'}`,
         fix: 'Keep skills self-contained - move referenced files into the project',
     },
-    FILENAME_COLLISION: {
-        code: 'FILENAME_COLLISION',
-        category: 'required',
-        message: (ctx) => `Multiple files have same basename: ${ctx['filename'] ?? 'unknown'}`,
-        fix: 'Enable path-based naming: packagingOptions.usePathNames: true',
-    },
+    // FILENAME_COLLISION is deliberately absent: it lives in CODE_REGISTRY and is
+    // emitted by the packager (see `filenameCollisionIssue` in skill-packager.ts).
+    // The entry that used to sit here was never emitted by anything and its fix
+    // hint named `packagingOptions.usePathNames`, an option that does not exist —
+    // a second, stale definition of one code is worse than none.
     WINDOWS_BACKSLASH_IN_PATH: {
         code: 'WINDOWS_BACKSLASH_IN_PATH',
         category: 'required',
@@ -73,7 +77,12 @@ export const VALIDATION_RULES = {
         category: 'best_practice',
         message: (ctx) => `Skill includes ${Number(ctx['fileCount'] ?? 0)} files (recommended ≤6)`,
         fix: 'Split into focused sub-skills or use progressive disclosure',
-        example: 'Official skills use 1-5 files',
+        // This used to read "Official skills use 1-5 files", which is false: Anthropic's
+        // own pdf/ example in the best-practices doc ships 7 (SKILL.md, FORMS.md,
+        // reference.md, examples.md + 3 scripts). 6 is a VAT maintainability heuristic,
+        // not a vendor limit — and Anthropic explicitly says to "Bundle comprehensive
+        // resources … no context penalty until accessed".
+        example: 'VAT heuristic, not an Anthropic limit — Anthropic\'s own pdf/ example ships 7 files',
     },
     REFERENCE_TOO_DEEP: {
         code: 'REFERENCE_TOO_DEEP',
@@ -112,31 +121,42 @@ export const VALIDATION_RULES = {
         // that restates the `files:` map is the symptom this text used to cause.
         fix: 'Add a markdown link from SKILL.md or a linked resource, or declare it under skills.config.<name>.files as a source/dest pair',
     },
-    PACKAGED_TEST_INPUT: {
-        code: 'PACKAGED_TEST_INPUT',
-        category: 'best_practice',
-        message: (ctx) => `Declared test input packaged into the shipped skill: ${ctx['relativePath'] ?? 'unknown'}`,
-        fix: 'Remove the files: entry mapping the eval suite into the bundle — test input is read from source, never shipped',
-    },
-    PACKAGED_BROKEN_LINK: {
-        code: 'PACKAGED_BROKEN_LINK',
-        category: 'best_practice',
-        message: (ctx) => `Broken link in packaged output: ${ctx['href'] ?? 'unknown'} (from ${ctx['mdPath'] ?? 'unknown'})`,
-        fix: 'Indicates a link-rewriting bug — the source link was valid but the packaged link is broken',
-    },
 };
 /**
- * Validation thresholds (based on Anthropic guidance)
+ * Validation thresholds — mostly VAT's, not Anthropic's (see the audit below)
+ *
+ * @vendor-claim reviewed=2026-07-30 verify=Re-fetch https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices and diff it against docs/external/anthropic-skill-authoring-best-practices.md
+ *
+ * The original header ("based on Anthropic guidance") overstated the provenance.
+ * Of the six numbers here, the repo's own cached copy of Anthropic's guidance
+ * supports only RECOMMENDED_SKILL_LINES (500), and it explicitly *disclaims*
+ * MAX_DESCRIPTION_CHARS_CLAUDE_CODE (250) — Anthropic documents a 1024-character
+ * maximum, while 250 is VAT's own reading of where the Claude Code `/skills`
+ * listing truncates. MAX_TOTAL_LINES, MAX_FILE_COUNT, MAX_REFERENCE_DEPTH and
+ * MIN_DESCRIPTION_LENGTH are VAT-originated.
  *
- * @vendor-claim reviewed=2026-04-18 verify=Re-fetch https://platform.claude.com/docs/en/docs/agents-and-tools/agent-skills/best-practices and diff it against docs/external/anthropic-skill-authoring-best-practices.md
+ * Re-verified against the live page on 2026-07-30. That pass sharpened two of
+ * those verdicts from "unsupported" to "contradicted", which is a stronger claim:
  *
- * The header above overstates the provenance. Of the six numbers here, the repo's
- * own cached copy of Anthropic's guidance supports only RECOMMENDED_SKILL_LINES
- * (500), and it explicitly *disclaims* MAX_DESCRIPTION_CHARS_CLAUDE_CODE (250) —
- * Anthropic documents a 1024-character maximum, while 250 is VAT's own reading of
- * where the Claude Code `/skills` listing truncates. MAX_TOTAL_LINES,
- * MAX_FILE_COUNT, MAX_REFERENCE_DEPTH and MIN_DESCRIPTION_LENGTH are
- * VAT-originated. The date above is the cache's Fetched date, not a later review.
+ * - MAX_REFERENCE_DEPTH (2) is CONTRADICTED, not merely VAT-originated. Anthropic:
+ *   "Keep references one level deep from SKILL.md", and their "Bad example: Too
+ *   deep" is literally `SKILL.md → advanced.md → details.md` — the exact chain
+ *   REFERENCE_TOO_DEEP's own `example` string above blesses as "2 hops, OK". VAT
+ *   is deliberately one hop laxer than the vendor here; that is a product
+ *   decision, not an oversight, but nothing in this file may imply Anthropic
+ *   endorses 2.
+ * - MAX_TOTAL_LINES (2000) and MAX_FILE_COUNT (6) are COUNTER-SIGNALLED, not just
+ *   silent. Anthropic's runtime-environment guidance says "Bundle comprehensive
+ *   resources: Include complete API docs, extensive examples, large datasets; no
+ *   context penalty until accessed", and "No context penalty for large files".
+ *   Their own pdf/ example ships 7 files, one past MAX_FILE_COUNT. VAT flags large
+ *   bundles as a maintainability/reviewability signal, which the vendor does not.
+ * - MIN_DESCRIPTION_LENGTH (50) stays SILENT-not-contradicted: Anthropic rejects
+ *   vague descriptions ("Helps with documents") on specificity, never on length.
+ *
+ * The `reviewed=` date above is now a real review date, not the cache's Fetched
+ * date. Do not resolve any of these divergences by editing a number here — the
+ * values decide what fires on adopter trees and are the repo owner's call.
  */
 export const VALIDATION_THRESHOLDS = {
     /** Recommended maximum lines for SKILL.md */
@@ -156,18 +176,152 @@ export const VALIDATION_THRESHOLDS = {
     MAX_DESCRIPTION_CHARS_CLAUDE_CODE: 250,
 };
 /**
- * Navigation file patterns to detect
+ * Navigation file patterns to detect.
+ *
+ * ONE canonical spelling per name. Every consumer matches these
+ * **case-insensitively** — via {@link isNavigationBasename} /
+ * {@link isNeverPackagedBasename} for basename lookups, or via
+ * {@link toAnyDepthGlobs} for glob lanes.
+ *
+ * This list used to enumerate spellings (`README.md` *and* `readme.md`,
+ * `index.md` *and* `INDEX.md`, …) and that approach provably cannot win: it
+ * never contained `Readme.md`, the single most common real spelling, nor
+ * `ReadMe.md` or `README.MD`. Do not re-add a second spelling of any name —
+ * matching handles case, and a duplicate implies enumeration still matters.
  */
 export const NAVIGATION_FILE_PATTERNS = [
     'README.md',
-    'readme.md',
     'index.md',
-    'INDEX.md',
     'toc.md',
-    'TOC.md',
     'overview.md',
-    'OVERVIEW.md',
 ];
+/**
+ * Repo-internal agent-instruction files. Deliberately a SEPARATE list from
+ * {@link NAVIGATION_FILE_PATTERNS}: a README is real content at the wrong
+ * granularity, whereas these files are guidance *about the repository they live
+ * in* and are meaningless — or actively misleading — once copied into a
+ * distributed bundle.
+ *
+ * Two distinct harms, both observed:
+ *
+ * 1. **Silent mis-resolution.** Two packages' `CLAUDE.md` files bundled under
+ *    `resourceNaming: basename` collide on one destination; one wins, and every
+ *    link to either source then resolves to the winner's content.
+ * 2. **Unintended instruction loading.** Claude Code loads `CLAUDE.md` files
+ *    found in subdirectories *under the working directory* on demand, when it
+ *    reads a file in that directory. A skill installed project-locally (e.g.
+ *    `.claude/skills/<name>/`) is under the working directory, so a bundled
+ *    `CLAUDE.md` is read as instructions the moment the agent opens a reference
+ *    beside it. (Skills installed outside the cwd — `~/.claude/skills`, plugin
+ *    directories — are not affected by this second harm. `AGENTS.md` and
+ *    `GEMINI.md` are not loaded as memory by Claude Code — it reads `CLAUDE.md`,
+ *    and picks up an `AGENTS.md` only where a `CLAUDE.md` imports it explicitly
+ *    (`@AGENTS.md`) or `/init` incorporates it — so they are listed here for the
+ *    portability and collision reasons, and treated identically to `CLAUDE.md`.)
+ *
+ * @vendor-claim reviewed=2026-08-02 verify=Re-read https://code.claude.com/docs/en/memory — "How CLAUDE.md files load" for harm 2, and the "AGENTS.md" section for the AGENTS.md/GEMINI.md sentence
+ */
+export const AGENT_INSTRUCTION_FILE_PATTERNS = [
+    'CLAUDE.md',
+    'CLAUDE.local.md',
+    'AGENTS.md',
+    'GEMINI.md',
+];
+/**
+ * Basenames a GLOB `files:` entry never packages into a **skill bundle**.
+ *
+ * Two tiers, deliberately composed here rather than merged at the source:
+ *
+ * - {@link AGENT_INSTRUCTION_FILE_PATTERNS} — never packaged on ANY surface.
+ * - {@link NAVIGATION_FILE_PATTERNS} — never packaged into a *skill bundle*, and
+ *   **only** there. A plugin-root `README.md` is the plugin's front page (measured
+ *   2026-08-02: 50 of 86 installed plugins ship one; 57 of 94 when first measured),
+ *   so the plugin tree-copy must import the agent-instruction list alone. Merging
+ *   the two lists would strip the front page off three in five real plugins. The
+ *   population moves as plugins are installed and removed — the ratio is the load-
+ *   bearing part, so re-measure before citing the count as current.
+ *
+ * Only globs consult this list. Naming `source: README.md` explicitly is an
+ * unambiguous instruction to ship that file; a glob is a net, not a declaration,
+ * and does not get to launder an exemption for a file it never named.
+ */
+export const NEVER_PACKAGE_IN_SKILL_BUNDLE = [
+    ...AGENT_INSTRUCTION_FILE_PATTERNS,
+    ...NAVIGATION_FILE_PATTERNS,
+];
+/**
+ * Build a case-insensitive basename predicate over a fixed pattern list.
+ *
+ * THE matcher every never-package lane shares. Two lanes ask this question — a
+ * glob lane (crawler include/exclude patterns) and a basename lane (`files:`
+ * expansion, broken-link remediation) — and they must not be able to drift: the
+ * glob lane's patterns come from {@link toAnyDepthGlobs} over the same arrays,
+ * and its verdict is asserted equal to this predicate's in the unit tests.
+ *
+ * `toLowerCase()` (not `toLocaleLowerCase()`) is deliberate: the ASCII-only
+ * basenames here must fold identically under every locale, and the Turkish
+ * dotless-i rule would otherwise break `INDEX.md` on a `tr-TR` host.
+ */
+function basenameMatcher(patterns) {
+    const lowered = new Set(patterns.map((pattern) => pattern.toLowerCase()));
+    return (name) => lowered.has(name.toLowerCase());
+}
+/**
+ * Is this basename a navigation file (README/index/toc/overview, any case)?
+ *
+ * Skill-bundle scope only — see {@link NEVER_PACKAGE_IN_SKILL_BUNDLE}.
+ */
+export const isNavigationBasename = basenameMatcher(NAVIGATION_FILE_PATTERNS);
+/**
+ * Is this basename a repo-internal agent-instruction file (CLAUDE.md/AGENTS.md/…, any case)?
+ *
+ * Case-insensitivity is not cosmetic here: on APFS and NTFS, `Claude.md` and
+ * `claude.md` satisfy Claude Code's project-local instruction lookup exactly as
+ * `CLAUDE.md` does, so a case-sensitive check leaves the harm fully reachable.
+ */
+export const isAgentInstructionBasename = basenameMatcher(AGENT_INSTRUCTION_FILE_PATTERNS);
+/**
+ * Is this basename one a GLOB `files:` entry never packages into a skill bundle?
+ *
+ * The basename-lane counterpart of {@link toAnyDepthGlobs}; both read
+ * {@link NEVER_PACKAGE_IN_SKILL_BUNDLE}. Any lane doing a `Set.has(basename)`
+ * against that constant must call this instead — a raw Set is case-sensitive and
+ * is exactly the gap this exists to close.
+ */
+export const isNeverPackagedBasename = basenameMatcher(NEVER_PACKAGE_IN_SKILL_BUNDLE);
+/**
+ * Fold one literal basename into a case-insensitive glob.
+ *
+ * `CLAUDE.md` → `[cC][lL][aA][uU][dD][eE].[mM][dD]`. Bracket classes rather than a
+ * matcher-level `nocase` flag because these patterns travel INTO crawls whose
+ * other patterns (caller excludes, `skills/<dir>/**`) must stay case-sensitive —
+ * picomatch's `nocase` applies to every pattern compiled in the same call, so it
+ * would silently widen those too.
+ */
+function toCaseInsensitiveGlob(name) {
+    return [...name]
+        .map((char) => {
+        const lower = char.toLowerCase();
+        const upper = char.toUpperCase();
+        return lower === upper ? char : `[${lower}${upper}]`;
+    })
+        .join('');
+}
+/**
+ * Expand basenames into globs matching them at the tree root AND at any depth,
+ * **regardless of case**.
+ *
+ * `**\/name` alone is not portable across matchers for a root-level hit, so both
+ * depths are emitted. Shared by the presence detector's include globs and the
+ * plugin tree-copy's exclude globs so the two can never drift apart — and folded
+ * to case-insensitive so neither can be evaded by spelling the file `Claude.md`.
+ */
+export function toAnyDepthGlobs(patterns) {
+    return patterns.flatMap((name) => {
+        const glob = toCaseInsensitiveGlob(name);
+        return [glob, `**/${glob}`];
+    });
+}
 /**
  * Create a validation issue from a rule
  */

package/dist/validators/validation-rules.js.map

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

package/dist/validators/walker-to-issues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"walker-to-issues.d.ts","sourceRoot":"","sources":["../../src/validators/walker-to-issues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA2C5D;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,SAAS,cAAc,EAAE,EACrC,YAAY,EAAE,MAAM,GACnB,eAAe,EAAE,CAmBnB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,YAAY,EAAE,MAAM,GACnB,eAAe,EAAE,CAKnB"}
+{"version":3,"file":"walker-to-issues.d.ts","sourceRoot":"","sources":["../../src/validators/walker-to-issues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA2D5D;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,SAAS,cAAc,EAAE,EACrC,YAAY,EAAE,MAAM,GACnB,eAAe,EAAE,CAmBnB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,YAAY,EAAE,MAAM,GACnB,eAAe,EAAE,CAKnB"}

package/dist/validators/walker-to-issues.js

@@ -14,28 +14,41 @@ import { evaluate, makeRuleContext, materializeIssue } from './rule-engine/index
  * emitted (the engine returns `null` for a non-typed-slot directory). A
  * `files:` typed-slot source resolving to a directory is an error, but that
  * check lives in packaging-validator, not here.
+ *
+ * `existsAtSource` is READ FROM the walker's record, never assumed. The engine
+ * gates `LINK_TO_GITIGNORED_FILE` on "gitignored AND exists"; hardcoding
+ * existence here made that guard unreachable, so a walker that mislabelled a
+ * missing target as gitignored got its mislabel rubber-stamped into an error
+ * about a file that is not there.
  */
-function exclusionToContext(reason) {
+function exclusionToContext(reason, targetExists) {
     switch (reason) {
         case 'depth-exceeded':
             return makeRuleContext({ subject: 'edge', droppedByDepth: true });
         case 'outside-project':
             return makeRuleContext({ subject: 'edge', outsideProject: true });
         case 'gitignored':
-            return makeRuleContext({ subject: 'edge', gitignored: true, existsAtSource: true });
+            return makeRuleContext({ subject: 'edge', gitignored: true, existsAtSource: targetExists });
         case 'skill-definition':
             return makeRuleContext({ subject: 'edge', crossSkillDefinition: true });
         case 'directory-target':
             return makeRuleContext({ subject: 'edge', fileKind: 'directory' });
         case 'navigation-file':
             return makeRuleContext({ subject: 'edge', fileKind: 'nav' });
+        case 'agent-instruction-file':
+            return makeRuleContext({ subject: 'edge', fileKind: 'agent-instruction' });
         case 'missing-target':
-            return makeRuleContext({ subject: 'edge', phase: 'source', existsAtSource: false });
+            return makeRuleContext({ subject: 'edge', phase: 'source', existsAtSource: targetExists });
         case 'pattern-matched':
             return makeRuleContext({ subject: 'edge', patternExcluded: true });
-        default:
-            // Exhaustive — every excludeReason is handled above.
-            return makeRuleContext({ subject: 'edge' });
+        default: {
+            // Exhaustiveness guard, NOT a fallback. A `default:` arm that returns a
+            // context is precisely what disables TypeScript's exhaustiveness check:
+            // a newly added excludeReason would compile and be silently dropped into
+            // a no-op context. Assigning to `never` makes it a compile error instead.
+            const _exhaustive = reason;
+            throw new Error(`Unhandled walker excludeReason: ${String(_exhaustive)}`);
+        }
     }
 }
 /**
@@ -48,7 +61,7 @@ export function walkerExclusionsToIssues(exclusions, locationRoot) {
     for (const r of exclusions) {
         if (!r.excludeReason)
             continue;
-        const code = evaluate(exclusionToContext(r.excludeReason));
+        const code = evaluate(exclusionToContext(r.excludeReason, r.targetExists));
         if (code === null)
             continue;
         // Anchor to the file CONTAINING the link, not the target. For a

package/dist/validators/walker-to-issues.js.map

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

package/dist/walk-link-graph.d.ts

@@ -28,10 +28,19 @@ export interface LinkResolution {
     sourcePath: string;
     /** 1-based line of the link within {@link LinkResolution.sourcePath}, when known */
     sourceLine?: number | undefined;
+    /**
+     * Whether the link TARGET existed on disk when the walker classified it.
+     *
+     * Recorded rather than re-derived downstream. The verdict engine gates
+     * `LINK_TO_GITIGNORED_FILE` on "gitignored AND exists at source"; a
+     * translation front-end that hardcodes existence turns that guard into dead
+     * code, so the one place that actually stat'ed the path carries the answer.
+     */
+    targetExists: boolean;
     /** Whether the file will be bundled */
     bundled: boolean;
     /** Reason it was excluded (only set when bundled is false) */
-    excludeReason?: 'depth-exceeded' | 'pattern-matched' | 'directory-target' | 'outside-project' | 'navigation-file' | 'skill-definition' | 'gitignored' | 'missing-target' | undefined;
+    excludeReason?: 'depth-exceeded' | 'pattern-matched' | 'directory-target' | 'outside-project' | 'navigation-file' | 'agent-instruction-file' | 'skill-definition' | 'gitignored' | 'missing-target' | undefined;
     /** The rule that matched (only set for pattern-matched exclusions) */
     matchedRule?: ExcludeRule | undefined;
     /** Link text from the source markdown */

package/dist/walk-link-graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"walk-link-graph.d.ts","sourceRoot":"","sources":["../src/walk-link-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAgB,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACvG,OAAO,EAAE,KAAK,UAAU,EAA0C,MAAM,2BAA2B,CAAC;AAKpG;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,YAAY,GAAG,gBAAgB,GAAG,SAAS,CAAC;IACrL,sEAAsE;IACtE,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAMD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;IAC1D,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;IACrC,oEAAoE;IACpE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iEAAiE;IACjE,kBAAkB,EAAE,cAAc,EAAE,CAAC;IACrC,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;;;;;;;;;;;;;;OAgBG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAkUD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,oBAAoB,GAC5B,eAAe,CAgDjB"}
+{"version":3,"file":"walk-link-graph.d.ts","sourceRoot":"","sources":["../src/walk-link-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAgB,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACvG,OAAO,EAAE,KAAK,UAAU,EAA0C,MAAM,2BAA2B,CAAC;AAKpG;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC;;;;;;;OAOG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,wBAAwB,GAAG,kBAAkB,GAAG,YAAY,GAAG,gBAAgB,GAAG,SAAS,CAAC;IAChN,sEAAsE;IACtE,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAMD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;IAC1D,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;IACrC,oEAAoE;IACpE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iEAAiE;IACjE,kBAAkB,EAAE,cAAc,EAAE,CAAC;IACrC,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;;;;;;;;;;;;;;OAgBG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAoaD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,oBAAoB,GAC5B,eAAe,CAgDjB"}