@vibe-agent-toolkit/utils 0.1.39-rc.1 → 0.1.39-rc.11

package/dist/fs/file-hash.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Compute the SHA-256 hash of a file's raw bytes.
+ *
+ * Reads the file synchronously and returns the full lowercase hex digest (64
+ * characters). The hash is computed over the raw byte content, so it is stable
+ * across platforms for identical file content and changes whenever the content
+ * changes.
+ *
+ * @param path - Absolute (or relative) path to the file to hash.
+ * @returns Lowercase hex SHA-256 digest string (64 characters).
+ *
+ * @example
+ * const hash = fileContentHash('/path/to/file.txt');
+ * // '2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824'
+ */
+export declare function fileContentHash(path: string): string;
+//# sourceMappingURL=file-hash.d.ts.map

package/dist/fs/file-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-hash.d.ts","sourceRoot":"","sources":["../../src/fs/file-hash.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIpD"}

package/dist/fs/file-hash.js

@@ -0,0 +1,23 @@
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+/**
+ * Compute the SHA-256 hash of a file's raw bytes.
+ *
+ * Reads the file synchronously and returns the full lowercase hex digest (64
+ * characters). The hash is computed over the raw byte content, so it is stable
+ * across platforms for identical file content and changes whenever the content
+ * changes.
+ *
+ * @param path - Absolute (or relative) path to the file to hash.
+ * @returns Lowercase hex SHA-256 digest string (64 characters).
+ *
+ * @example
+ * const hash = fileContentHash('/path/to/file.txt');
+ * // '2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824'
+ */
+export function fileContentHash(path) {
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- path is caller-supplied; callers are responsible for path safety
+    const bytes = readFileSync(path);
+    return createHash('sha256').update(bytes).digest('hex');
+}
+//# sourceMappingURL=file-hash.js.map

package/dist/fs/file-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-hash.js","sourceRoot":"","sources":["../../src/fs/file-hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,uIAAuI;IACvI,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC"}

package/dist/git-url.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Parsed representation of a git URL accepted by `vat audit`.
+ *
+ * - `cloneUrl` is the URL passed to `git clone` (after stripping ref/subpath
+ *   fragments and after expanding GitHub shorthand to a full HTTPS URL).
+ * - `ref` is an optional branch or tag name (deep commit SHAs are not
+ *   guaranteed to work with shallow clone — see design spec for details).
+ * - `subpath` is an optional subdirectory within the cloned repo to audit.
+ */
+export interface ParsedGitUrl {
+    cloneUrl: string;
+    ref?: string;
+    subpath?: string;
+}
+/**
+ * Parse a string into a {@link ParsedGitUrl}.
+ *
+ * Accepted forms:
+ *  - `https://host/owner/repo.git`
+ *  - `https://host/owner/repo.git#ref`
+ *  - `https://host/owner/repo.git#ref:subpath`
+ *  - `https://github.com/owner/repo/tree/<ref>/<subpath>` (GitHub web URL)
+ *  - `owner/repo` (GitHub shorthand → expanded to HTTPS)
+ *  - `git@host:owner/repo.git`
+ *  - `ssh://git@host/owner/repo.git`
+ *
+ * Throws on malformed input.
+ */
+export declare function parseGitUrl(input: string): ParsedGitUrl;
+/**
+ * Detect whether a string should be treated as a git URL (for the polymorphic
+ * `[git-url-or-path]` audit argument). True for:
+ *  - http(s):// URLs
+ *  - ssh:// URLs
+ *  - file:// URLs (used by integration tests against local bare repos)
+ *  - git@host:path scp-style URLs
+ *  - GitHub shorthand `owner/repo` (strict — no extensions, no extra slashes)
+ *
+ * Everything else (including relative paths like `./foo/bar`, absolute paths,
+ * and multi-segment paths like `foo/bar/baz`) is treated as a filesystem path.
+ */
+export declare function isGitUrl(input: string): boolean;
+//# sourceMappingURL=git-url.d.ts.map

package/dist/git-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-url.d.ts","sourceRoot":"","sources":["../src/git-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAyBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAgEvD;AASD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAmB/C"}

package/dist/git-url.js

@@ -0,0 +1,135 @@
+/**
+ * Split a URL with an optional `#ref[:subpath]` fragment into the base URL
+ * and fragment components. Keeps the fragment-handling logic local so the
+ * per-form regexes can stay simple and anchored.
+ */
+function splitFragment(input) {
+    const hashIndex = input.indexOf('#');
+    if (hashIndex === -1) {
+        return { base: input };
+    }
+    const base = input.slice(0, hashIndex);
+    const fragment = input.slice(hashIndex + 1);
+    const colonIndex = fragment.indexOf(':');
+    if (colonIndex === -1) {
+        return { base, ref: fragment };
+    }
+    return {
+        base,
+        ref: fragment.slice(0, colonIndex),
+        subpath: fragment.slice(colonIndex + 1),
+    };
+}
+/**
+ * Parse a string into a {@link ParsedGitUrl}.
+ *
+ * Accepted forms:
+ *  - `https://host/owner/repo.git`
+ *  - `https://host/owner/repo.git#ref`
+ *  - `https://host/owner/repo.git#ref:subpath`
+ *  - `https://github.com/owner/repo/tree/<ref>/<subpath>` (GitHub web URL)
+ *  - `owner/repo` (GitHub shorthand → expanded to HTTPS)
+ *  - `git@host:owner/repo.git`
+ *  - `ssh://git@host/owner/repo.git`
+ *
+ * Throws on malformed input.
+ */
+export function parseGitUrl(input) {
+    const trimmed = input.trim();
+    if (trimmed === '') {
+        throw new Error(`Invalid git URL or path: <empty>.`);
+    }
+    // file:// form: file:///path/to/repo[#ref[:subpath]] — used primarily by
+    // integration tests that clone a local bare repo. `git clone` accepts
+    // file:// natively.
+    if (trimmed.startsWith('file://')) {
+        const { base, ref, subpath } = splitFragment(trimmed);
+        return buildParsed(base, ref, subpath);
+    }
+    // HTTPS .git form: https://host/path.git[#ref[:subpath]]
+    if (/^https?:\/\//.test(trimmed)) {
+        const { base, ref, subpath } = splitFragment(trimmed);
+        if (base.endsWith('.git')) {
+            return buildParsed(base, ref, subpath);
+        }
+        // GitHub web URL: https://github.com/owner/repo/tree/<ref>[/<subpath>]
+        const ghWeb = 
+        // eslint-disable-next-line security/detect-unsafe-regex -- Anchored ^...$ with bounded character classes; the only variable-length group is the trailing subpath. Safe from ReDoS.
+        /^https:\/\/github\.com\/([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)\/tree\/([^/]+)(?:\/(.+))?$/.exec(trimmed);
+        if (ghWeb) {
+            const owner = ghWeb[1] ?? '';
+            const repo = ghWeb[2] ?? '';
+            const webRef = ghWeb[3];
+            const webSubpath = ghWeb[4];
+            return buildParsed(`https://github.com/${owner}/${repo}.git`, webRef, webSubpath);
+        }
+    }
+    // SSH ssh:// form: ssh://git@host/path[#ref[:subpath]]
+    if (trimmed.startsWith('ssh://')) {
+        const { base, ref, subpath } = splitFragment(trimmed);
+        return buildParsed(base, ref, subpath);
+    }
+    // SSH scp-like form: git@host:owner/repo.git[#ref[:subpath]]
+    // Anchored, no alternation with nested quantifiers — safe from ReDoS.
+    if (/^[^@\s]+@[^:\s]+:[^#\s]+/.test(trimmed)) {
+        const { base, ref, subpath } = splitFragment(trimmed);
+        return buildParsed(base, ref, subpath);
+    }
+    // GitHub shorthand: owner/repo[#ref[:subpath]] (single slash in base)
+    const { base, ref, subpath } = splitFragment(trimmed);
+    const shorthand = /^([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)$/.exec(base);
+    if (shorthand) {
+        const owner = shorthand[1] ?? '';
+        const repo = shorthand[2] ?? '';
+        return buildParsed(`https://github.com/${owner}/${repo}.git`, ref, subpath);
+    }
+    throw new Error(`Invalid git URL or path: ${input}. Accepted forms: ` +
+        `https://<host>/<owner>/<repo>.git, ` +
+        `git@<host>:<owner>/<repo>.git, ` +
+        `<owner>/<repo>, or a local filesystem path.`);
+}
+function buildParsed(cloneUrl, ref, subpath) {
+    const result = { cloneUrl };
+    if (ref !== undefined && ref !== '')
+        result.ref = ref;
+    if (subpath !== undefined && subpath !== '')
+        result.subpath = subpath;
+    return result;
+}
+/**
+ * Detect whether a string should be treated as a git URL (for the polymorphic
+ * `[git-url-or-path]` audit argument). True for:
+ *  - http(s):// URLs
+ *  - ssh:// URLs
+ *  - file:// URLs (used by integration tests against local bare repos)
+ *  - git@host:path scp-style URLs
+ *  - GitHub shorthand `owner/repo` (strict — no extensions, no extra slashes)
+ *
+ * Everything else (including relative paths like `./foo/bar`, absolute paths,
+ * and multi-segment paths like `foo/bar/baz`) is treated as a filesystem path.
+ */
+export function isGitUrl(input) {
+    const trimmed = input.trim();
+    if (trimmed === '')
+        return false;
+    if (/^https?:\/\//.test(trimmed))
+        return true;
+    if (trimmed.startsWith('ssh://'))
+        return true;
+    if (trimmed.startsWith('file://'))
+        return true;
+    // Match the same scp-style pattern parseGitUrl uses, including the
+    // requirement of a non-empty path segment after the colon. Without the
+    // trailing `[^#\s]+`, `isGitUrl` would accept inputs like `foo@host:`
+    // that parseGitUrl then rejects with a less-helpful error.
+    if (/^[^@\s]+@[^:\s]+:[^#\s]+/.test(trimmed))
+        return true;
+    // Strict GitHub shorthand: exactly two segments, no extension on second,
+    // no path separators beyond the single /. Strip any `#ref[:subpath]`
+    // fragment first so `owner/repo#main` and `owner/repo#main:sub` are
+    // recognized — `parseGitUrl` handles fragments uniformly across forms.
+    const hashIndex = trimmed.indexOf('#');
+    const base = hashIndex === -1 ? trimmed : trimmed.slice(0, hashIndex);
+    return /^[A-Za-z0-9_-]+\/[A-Za-z0-9_-]+$/.test(base);
+}
+//# sourceMappingURL=git-url.js.map

package/dist/git-url.js.map

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

package/dist/glob/glob-pattern.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Pure string helpers for glob pattern analysis.
+ *
+ * No filesystem access. These are building blocks for higher-level glob
+ * expansion utilities. Glob patterns always use forward slashes by convention —
+ * this module treats `/` as the only path separator (never `\`).
+ *
+ * ### Escape semantics
+ * A backslash immediately preceding a metachar (`*`, `?`, `[`) neutralises it.
+ * Any other backslash is left as-is. The algorithm scans left-to-right and
+ * sets an `escaped` flag when it sees `\`; the *next* character is skipped for
+ * magic detection if `escaped` is true.
+ */
+/**
+ * Returns `true` iff `source` contains at least one unescaped glob metachar
+ * (`*`, `?`, `[`). A backslash immediately before a metachar escapes it.
+ *
+ * @example
+ * isGlob('a/b/*.mjs')    // true  — unescaped *
+ * isGlob('packs/**\/*')  // true  — unescaped **
+ * isGlob('x?.txt')       // true  — unescaped ?
+ * isGlob('files[1].txt') // true  — unescaped [
+ * isGlob('foo\\*.txt')   // false — * is backslash-escaped
+ * isGlob('foo/bar.txt')  // false — no metachar
+ */
+export declare function isGlob(source: string): boolean;
+/**
+ * The longest leading path prefix of `pattern` that contains no glob magic —
+ * i.e. the static directory base suitable as a `cwd` for a glob runner.
+ *
+ * Algorithm:
+ * 1. Split pattern on `/` (glob patterns always use forward slashes).
+ * 2. Accumulate segments until (and **excluding**) the first magic segment.
+ * 3. Join accumulated segments with `/`.
+ * 4. If the very first segment is magic → return `'.'`.
+ * 5. If NO segment is magic (not a glob at all) → return the whole pattern.
+ *
+ * Output always uses forward slashes (pure string ops, no `node:path`).
+ *
+ * @example
+ * staticGlobBase('modules/packs/**\/*')    // 'modules/packs'
+ * staticGlobBase('a/b/*.mjs')              // 'a/b'
+ * staticGlobBase('*.mjs')                  // '.'
+ * staticGlobBase('../mycli/dist/*.mjs')    // '../mycli/dist'
+ * staticGlobBase('foo/bar.txt')            // 'foo/bar.txt'
+ */
+export declare function staticGlobBase(pattern: string): string;
+/**
+ * The sub-pattern remaining after stripping the static base, with no leading
+ * `/`. This is the pattern to pass to a glob runner with `cwd` set to the base.
+ *
+ * Only meaningful when `isGlob(pattern)` is true — for a non-glob input the
+ * return value is `''` (the whole pattern was consumed as the base).
+ *
+ * @example
+ * globMagicRemainder('modules/packs/**\/*')   // '**\/*'
+ * globMagicRemainder('a/b/*.mjs')             // '*.mjs'
+ * globMagicRemainder('*.mjs')                 // '*.mjs'
+ * globMagicRemainder('../mycli/dist/*.mjs')   // '*.mjs'
+ */
+export declare function globMagicRemainder(pattern: string): string;
+//# sourceMappingURL=glob-pattern.d.ts.map

package/dist/glob/glob-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob-pattern.d.ts","sourceRoot":"","sources":["../../src/glob/glob-pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAgB9C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsBtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAY1D"}

package/dist/glob/glob-pattern.js

@@ -0,0 +1,115 @@
+/**
+ * Pure string helpers for glob pattern analysis.
+ *
+ * No filesystem access. These are building blocks for higher-level glob
+ * expansion utilities. Glob patterns always use forward slashes by convention —
+ * this module treats `/` as the only path separator (never `\`).
+ *
+ * ### Escape semantics
+ * A backslash immediately preceding a metachar (`*`, `?`, `[`) neutralises it.
+ * Any other backslash is left as-is. The algorithm scans left-to-right and
+ * sets an `escaped` flag when it sees `\`; the *next* character is skipped for
+ * magic detection if `escaped` is true.
+ */
+import { toForwardSlash } from '../path-utils.js';
+/** The glob metacharacters recognised by this module. */
+const MAGIC_CHARS = new Set(['*', '?', '[']);
+/** Sentinel returned by {@link staticGlobBase} when the first segment is magic. */
+const DOT = '.';
+/**
+ * Returns `true` iff `source` contains at least one unescaped glob metachar
+ * (`*`, `?`, `[`). A backslash immediately before a metachar escapes it.
+ *
+ * @example
+ * isGlob('a/b/*.mjs')    // true  — unescaped *
+ * isGlob('packs/**\/*')  // true  — unescaped **
+ * isGlob('x?.txt')       // true  — unescaped ?
+ * isGlob('files[1].txt') // true  — unescaped [
+ * isGlob('foo\\*.txt')   // false — * is backslash-escaped
+ * isGlob('foo/bar.txt')  // false — no metachar
+ */
+export function isGlob(source) {
+    let escaped = false;
+    for (const ch of source) {
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (ch === '\\') {
+            escaped = true;
+            continue;
+        }
+        if (MAGIC_CHARS.has(ch)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * The longest leading path prefix of `pattern` that contains no glob magic —
+ * i.e. the static directory base suitable as a `cwd` for a glob runner.
+ *
+ * Algorithm:
+ * 1. Split pattern on `/` (glob patterns always use forward slashes).
+ * 2. Accumulate segments until (and **excluding**) the first magic segment.
+ * 3. Join accumulated segments with `/`.
+ * 4. If the very first segment is magic → return `'.'`.
+ * 5. If NO segment is magic (not a glob at all) → return the whole pattern.
+ *
+ * Output always uses forward slashes (pure string ops, no `node:path`).
+ *
+ * @example
+ * staticGlobBase('modules/packs/**\/*')    // 'modules/packs'
+ * staticGlobBase('a/b/*.mjs')              // 'a/b'
+ * staticGlobBase('*.mjs')                  // '.'
+ * staticGlobBase('../mycli/dist/*.mjs')    // '../mycli/dist'
+ * staticGlobBase('foo/bar.txt')            // 'foo/bar.txt'
+ */
+export function staticGlobBase(pattern) {
+    // Glob patterns are always forward-slash; toForwardSlash() satisfies the
+    // no-hardcoded-path-split lint rule while being a no-op in practice.
+    const normalized = toForwardSlash(pattern);
+    const segments = normalized.split('/');
+    const staticSegments = [];
+    for (const segment of segments) {
+        if (isGlob(segment)) {
+            break;
+        }
+        staticSegments.push(segment);
+    }
+    if (staticSegments.length === 0) {
+        return DOT;
+    }
+    if (staticSegments.length === segments.length) {
+        // No magic found — return the whole (normalized) pattern unchanged.
+        return normalized;
+    }
+    return staticSegments.join('/');
+}
+/**
+ * The sub-pattern remaining after stripping the static base, with no leading
+ * `/`. This is the pattern to pass to a glob runner with `cwd` set to the base.
+ *
+ * Only meaningful when `isGlob(pattern)` is true — for a non-glob input the
+ * return value is `''` (the whole pattern was consumed as the base).
+ *
+ * @example
+ * globMagicRemainder('modules/packs/**\/*')   // '**\/*'
+ * globMagicRemainder('a/b/*.mjs')             // '*.mjs'
+ * globMagicRemainder('*.mjs')                 // '*.mjs'
+ * globMagicRemainder('../mycli/dist/*.mjs')   // '*.mjs'
+ */
+export function globMagicRemainder(pattern) {
+    const base = staticGlobBase(pattern);
+    if (base === DOT) {
+        // First segment was magic — the remainder is the full (forward-slash) pattern.
+        return toForwardSlash(pattern);
+    }
+    if (base === toForwardSlash(pattern)) {
+        // No magic at all — degenerate case: remainder is empty.
+        return '';
+    }
+    // Strip the base prefix and the trailing '/' separator.
+    return toForwardSlash(pattern).slice(base.length + 1);
+}
+//# sourceMappingURL=glob-pattern.js.map

package/dist/glob/glob-pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob-pattern.js","sourceRoot":"","sources":["../../src/glob/glob-pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,yDAAyD;AACzD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAE7C,mFAAmF;AACnF,MAAM,GAAG,GAAG,GAAG,CAAC;AAEhB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QACxB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,GAAG,KAAK,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QACD,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,yEAAyE;IACzE,qEAAqE;IACrE,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,cAAc,GAAa,EAAE,CAAC;IAEpC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACpB,MAAM;QACR,CAAC;QACD,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,cAAc,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC9C,oEAAoE;QACpE,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjB,+EAA+E;QAC/E,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,IAAI,KAAK,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,yDAAyD;QACzD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,wDAAwD;IACxD,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export * from './asset-reference.js';
 export * from './fs-utils.js';
 export * from './file-crawler.js';
 export * from './gitignore-checker.js';
+export * from './git-url.js';
 export * from './git-utils.js';
 export * from './project-utils.js';
 export * from './git-tracker.js';
@@ -17,4 +18,12 @@ export * from './test-helpers.js';
 export * from './zod-introspection.js';
 export * from './template.js';
 export * from './skill-targets.js';
+export { type LinkAuthConfig, type Provider, type ProviderAuth, type ProviderCheck, resolveAuthenticatedUrl, type ResolveOutcome, } from './link-auth/resolve.js';
+export type { ProviderMatch } from './link-auth/select-provider.js';
+export type { RewriteRule } from './link-auth/rewrite.js';
+export type { TokenSource } from './link-auth/resolve-token.js';
+export { expandMacro, UnknownMacroError } from './link-auth/expand-macro.js';
+export * from './skill-test/index.js';
+export * from './glob/glob-pattern.js';
+export * from './fs/file-hash.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":"AAAA;;;;;GAKG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,eAAe,CAAC;AAG9B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,gBAAgB,CAAC;AAI/B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,eAAe,CAAC;AAG9B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,eAAe,CAAC;AAG9B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,cAAc,CAAC;AAG7B,cAAc,gBAAgB,CAAC;AAI/B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,eAAe,CAAC;AAG9B,cAAc,oBAAoB,CAAC;AAInC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,uBAAuB,EACvB,KAAK,cAAc,GACpB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAG7E,cAAc,uBAAuB,CAAC;AAGtC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -16,6 +16,8 @@ export * from './fs-utils.js';
 export * from './file-crawler.js';
 // Git ignore checking
 export * from './gitignore-checker.js';
+// Git URL parsing (parse/detect git URLs, GitHub shorthand, SSH forms)
+export * from './git-url.js';
 // Git utilities (using git commands directly)
 export * from './git-utils.js';
 // Project root discovery (canonical: config → git → null).
@@ -31,4 +33,14 @@ export * from './zod-introspection.js';
 export * from './template.js';
 // Skill target resolution (cross-platform flat skill install paths)
 export * from './skill-targets.js';
+// linkAuth pure engine — public API only (issue #113).
+// Internal helpers (rewrite, build-headers, etc.) stay module-private.
+export { resolveAuthenticatedUrl, } from './link-auth/resolve.js';
+export { expandMacro, UnknownMacroError } from './link-auth/expand-macro.js';
+// Skill testing utilities (environment management for headless agent runs)
+export * from './skill-test/index.js';
+// Glob pattern helpers (isGlob, staticGlobBase, globMagicRemainder)
+export * from './glob/glob-pattern.js';
+// Filesystem hashing (sha256 of raw file bytes)
+export * from './fs/file-hash.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;;;;;GAKG;AAEH,8DAA8D;AAC9D,cAAc,gBAAgB,CAAC;AAE/B,gCAAgC;AAChC,cAAc,iBAAiB,CAAC;AAEhC,2DAA2D;AAC3D,cAAc,sBAAsB,CAAC;AAErC,uBAAuB;AACvB,cAAc,eAAe,CAAC;AAE9B,wCAAwC;AACxC,cAAc,mBAAmB,CAAC;AAElC,sBAAsB;AACtB,cAAc,wBAAwB,CAAC;AAEvC,8CAA8C;AAC9C,cAAc,gBAAgB,CAAC;AAE/B,2DAA2D;AAC3D,iEAAiE;AACjE,cAAc,oBAAoB,CAAC;AAEnC,yDAAyD;AACzD,cAAc,kBAAkB,CAAC;AAEjC,oDAAoD;AACpD,cAAc,mBAAmB,CAAC;AAElC,4CAA4C;AAC5C,cAAc,wBAAwB,CAAC;AAEvC,2DAA2D;AAC3D,cAAc,eAAe,CAAC;AAE9B,oEAAoE;AACpE,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8DAA8D;AAC9D,cAAc,gBAAgB,CAAC;AAE/B,gCAAgC;AAChC,cAAc,iBAAiB,CAAC;AAEhC,2DAA2D;AAC3D,cAAc,sBAAsB,CAAC;AAErC,uBAAuB;AACvB,cAAc,eAAe,CAAC;AAE9B,wCAAwC;AACxC,cAAc,mBAAmB,CAAC;AAElC,sBAAsB;AACtB,cAAc,wBAAwB,CAAC;AAEvC,uEAAuE;AACvE,cAAc,cAAc,CAAC;AAE7B,8CAA8C;AAC9C,cAAc,gBAAgB,CAAC;AAE/B,2DAA2D;AAC3D,iEAAiE;AACjE,cAAc,oBAAoB,CAAC;AAEnC,yDAAyD;AACzD,cAAc,kBAAkB,CAAC;AAEjC,oDAAoD;AACpD,cAAc,mBAAmB,CAAC;AAElC,4CAA4C;AAC5C,cAAc,wBAAwB,CAAC;AAEvC,2DAA2D;AAC3D,cAAc,eAAe,CAAC;AAE9B,oEAAoE;AACpE,cAAc,oBAAoB,CAAC;AAEnC,uDAAuD;AACvD,uEAAuE;AACvE,OAAO,EAKL,uBAAuB,GAExB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAE7E,2EAA2E;AAC3E,cAAc,uBAAuB,CAAC;AAEtC,oEAAoE;AACpE,cAAc,wBAAwB,CAAC;AAEvC,gDAAgD;AAChD,cAAc,mBAAmB,CAAC"}

package/dist/link-auth/build-headers.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Render auth-header templates with rendered values, and a structural
+ * redaction helper for serialization.
+ *
+ * `buildHeaders` renders each header value template against a context that
+ * carries `${token}` plus any named captures / vars from the rewrite step.
+ * `redactHeaders` masks `Authorization` values for any caller that needs to
+ * serialize headers into logs, errors, or cache entries — the design's §8
+ * "tokens never leak" claim depends on every such site routing through this.
+ *
+ * Per design issue #113 §4 (auth.headers vocabulary) and §8 (redaction is
+ * structural; Authorization values never appear in serialized output).
+ */
+export declare const REDACTED_VALUE = "<redacted>";
+/**
+ * Render a map of header templates into a map of concrete header values.
+ *
+ * @throws {TemplateMissingVarError} if a header template references an
+ *   unknown context key
+ * @throws {TemplateSyntaxError} from a malformed template expression
+ * @throws {UnknownTransformError} from a template calling an unknown transform
+ */
+export declare function buildHeaders(templates: Record<string, string>, context: Record<string, string>): Record<string, string>;
+/**
+ * Return a copy of `headers` with sensitive values replaced by `REDACTED_VALUE`.
+ * Header-name matching is case-insensitive but exact (no prefix matching) — a
+ * header like `X-Authorization-Foo` is NOT considered sensitive.
+ *
+ * **Input must be a plain key-value object.** A `Headers` instance (Web Fetch
+ * API) or a `Map` yields `[]` from `Object.entries` and would silently no-op
+ * redaction — converting to a plain object is the caller's responsibility.
+ */
+export declare function redactHeaders(headers: Record<string, string>): Record<string, string>;
+//# sourceMappingURL=build-headers.d.ts.map

package/dist/link-auth/build-headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-headers.d.ts","sourceRoot":"","sources":["../../src/link-auth/build-headers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,eAAO,MAAM,cAAc,eAAe,CAAC;AAc3C;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMrF"}

package/dist/link-auth/build-headers.js

@@ -0,0 +1,58 @@
+/**
+ * Render auth-header templates with rendered values, and a structural
+ * redaction helper for serialization.
+ *
+ * `buildHeaders` renders each header value template against a context that
+ * carries `${token}` plus any named captures / vars from the rewrite step.
+ * `redactHeaders` masks `Authorization` values for any caller that needs to
+ * serialize headers into logs, errors, or cache entries — the design's §8
+ * "tokens never leak" claim depends on every such site routing through this.
+ *
+ * Per design issue #113 §4 (auth.headers vocabulary) and §8 (redaction is
+ * structural; Authorization values never appear in serialized output).
+ */
+import { renderTemplate } from './template.js';
+export const REDACTED_VALUE = '<redacted>';
+/**
+ * Header names whose values must be masked when serialized.
+ *
+ * v1 ships only `authorization` because that is the only secret-bearing
+ * header the current macros emit. **Omission is the security risk** — any
+ * future macro that emits a header carrying a secret (`Cookie`,
+ * `Proxy-Authorization`, `X-API-Key`, custom bearer-style headers) must add
+ * that name here, or the token will silently leak through serialization.
+ * Extending the set is not the dangerous edit; forgetting to extend it is.
+ */
+const SENSITIVE_HEADER_NAMES = new Set(['authorization']);
+/**
+ * Render a map of header templates into a map of concrete header values.
+ *
+ * @throws {TemplateMissingVarError} if a header template references an
+ *   unknown context key
+ * @throws {TemplateSyntaxError} from a malformed template expression
+ * @throws {UnknownTransformError} from a template calling an unknown transform
+ */
+export function buildHeaders(templates, context) {
+    const headers = Object.create(null);
+    for (const [name, template] of Object.entries(templates)) {
+        headers[name] = renderTemplate(template, context);
+    }
+    return headers;
+}
+/**
+ * Return a copy of `headers` with sensitive values replaced by `REDACTED_VALUE`.
+ * Header-name matching is case-insensitive but exact (no prefix matching) — a
+ * header like `X-Authorization-Foo` is NOT considered sensitive.
+ *
+ * **Input must be a plain key-value object.** A `Headers` instance (Web Fetch
+ * API) or a `Map` yields `[]` from `Object.entries` and would silently no-op
+ * redaction — converting to a plain object is the caller's responsibility.
+ */
+export function redactHeaders(headers) {
+    const redacted = Object.create(null);
+    for (const [name, value] of Object.entries(headers)) {
+        redacted[name] = SENSITIVE_HEADER_NAMES.has(name.toLowerCase()) ? REDACTED_VALUE : value;
+    }
+    return redacted;
+}
+//# sourceMappingURL=build-headers.js.map

package/dist/link-auth/build-headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-headers.js","sourceRoot":"","sources":["../../src/link-auth/build-headers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;AAE3C;;;;;;;;;GASG;AACH,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;AAE/E;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAiC,EACjC,OAA+B;IAE/B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAA2B,CAAC;IAC9D,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,OAA+B;IAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAA2B,CAAC;IAC/D,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,QAAQ,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3F,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/link-auth/expand-macro.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Macro loader + expander.
+ *
+ * Loads the bundled `macros.yaml` once at module init and exposes
+ * `expandMacro(name, overrides?)` which deep-merges the named macro with any
+ * adopter overrides. The merge is "adopter wins": objects merge recursively,
+ * arrays and primitives are replaced wholesale (no element-wise array merge).
+ *
+ * The shipped macro file is at `link-auth/macros.yaml`, copied into the dist
+ * tree by `packages/dev-tools/src/copy-yaml-assets.ts` during build so the
+ * runtime `fs.readFileSync(new URL('./macros.yaml', import.meta.url))`
+ * resolves in both source-mode (vitest) and built-mode (dist).
+ *
+ * Per design issue #113 §5 (macros are config, not a privileged code path).
+ */
+/**
+ * Thrown when a `use: <name>` references a macro not in the shipped set.
+ * Message lists the available macros so a typo surfaces clearly.
+ */
+export declare class UnknownMacroError extends Error {
+    constructor(name: string, available: readonly string[]);
+}
+/**
+ * Look up a macro by name and deep-merge optional adopter overrides on top.
+ *
+ * Merge semantics:
+ *   - Plain objects merge recursively (sibling keys preserved).
+ *   - Arrays are replaced wholesale (override's array wins; no concat).
+ *   - Primitives are replaced.
+ *   - `undefined` in an override is treated as "not provided" (base wins).
+ *
+ * The returned object and all nested plain objects use null prototypes so
+ * `__proto__` / `constructor` keys can never poison consumers.
+ *
+ * @throws {UnknownMacroError} if `name` is not in the shipped macro set
+ */
+export declare function expandMacro(name: string, overrides?: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=expand-macro.d.ts.map

package/dist/link-auth/expand-macro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-macro.d.ts","sourceRoot":"","sources":["../../src/link-auth/expand-macro.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAwCH;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE;CAIvD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB"}