@vibe-agent-toolkit/utils 0.1.39-rc.10 → 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/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

@@ -24,4 +24,6 @@ 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,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"}
+{"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

@@ -39,4 +39,8 @@ 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,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"}
+{"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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-agent-toolkit/utils",
-  "version": "0.1.39-rc.10",
+  "version": "0.1.39-rc.11",
   "type": "module",
   "description": "Core utility functions with no external dependencies",
   "keywords": [