@vibe-agent-toolkit/utils 0.1.12 → 0.1.14

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export * from './fs-utils.js';
 export * from './file-crawler.js';
 export * from './gitignore-checker.js';
 export * from './git-utils.js';
+export * from './project-utils.js';
 export * from './git-tracker.js';
 export * from './test-helpers.js';
 export * from './zod-introspection.js';

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,eAAe,CAAC;AAG9B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,eAAe,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,eAAe,CAAC;AAG9B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -16,6 +16,8 @@ export * from './file-crawler.js';
 export * from './gitignore-checker.js';
 // Git utilities (using git commands directly)
 export * from './git-utils.js';
+// Project root discovery (workspace root -> git root -> fallback)
+export * from './project-utils.js';
 // Git tracking cache (for efficient git-ignore checking)
 export * from './git-tracker.js';
 // Test helpers for isolated test output directories

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,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,yDAAyD;AACzD,cAAc,kBAAkB,CAAC;AAEjC,oDAAoD;AACpD,cAAc,mBAAmB,CAAC;AAElC,4CAA4C;AAC5C,cAAc,wBAAwB,CAAC;AAEvC,2DAA2D;AAC3D,cAAc,eAAe,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,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,kEAAkE;AAClE,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"}

package/dist/project-utils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Project root discovery utilities.
+ *
+ * Finds the project root directory using a layered detection strategy:
+ * workspace root (monorepo) -> git root -> directory fallback.
+ */
+/**
+ * Find the project root for boundary enforcement.
+ *
+ * Detection order:
+ * 1. Walk up from startDir looking for package.json with "workspaces" (monorepo root)
+ * 2. Fall back to git repository root
+ * 3. Fall back to startDir itself (tests / standalone)
+ *
+ * @param startDir - Directory to start searching from (e.g., dirname of SKILL.md)
+ * @returns Project root directory
+ */
+export declare function findProjectRoot(startDir: string): string;
+//# sourceMappingURL=project-utils.d.ts.map

package/dist/project-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-utils.d.ts","sourceRoot":"","sources":["../src/project-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA+BxD"}

package/dist/project-utils.js

@@ -0,0 +1,52 @@
+/**
+ * Project root discovery utilities.
+ *
+ * Finds the project root directory using a layered detection strategy:
+ * workspace root (monorepo) -> git root -> directory fallback.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { gitFindRoot } from './git-utils.js';
+const PACKAGE_JSON_FILENAME = 'package.json';
+/**
+ * Find the project root for boundary enforcement.
+ *
+ * Detection order:
+ * 1. Walk up from startDir looking for package.json with "workspaces" (monorepo root)
+ * 2. Fall back to git repository root
+ * 3. Fall back to startDir itself (tests / standalone)
+ *
+ * @param startDir - Directory to start searching from (e.g., dirname of SKILL.md)
+ * @returns Project root directory
+ */
+export function findProjectRoot(startDir) {
+    let currentDir = resolve(startDir);
+    const resolvedStartDir = currentDir;
+    // 1. Walk up looking for workspace root (package.json with "workspaces")
+    while (currentDir !== dirname(currentDir)) {
+        const packageJsonPath = join(currentDir, PACKAGE_JSON_FILENAME);
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Walking up from validated startDir
+        if (existsSync(packageJsonPath)) {
+            try {
+                // eslint-disable-next-line security/detect-non-literal-fs-filename -- Walking up from validated startDir
+                const content = readFileSync(packageJsonPath, 'utf-8');
+                const parsed = JSON.parse(content);
+                if (typeof parsed === 'object' && parsed !== null && 'workspaces' in parsed) {
+                    return currentDir;
+                }
+            }
+            catch {
+                // Invalid JSON - skip this package.json
+            }
+        }
+        currentDir = dirname(currentDir);
+    }
+    // 2. Fall back to git root
+    const gitRoot = gitFindRoot(resolvedStartDir);
+    if (gitRoot !== null) {
+        return gitRoot;
+    }
+    // 3. Fall back to start directory
+    return resolvedStartDir;
+}
+//# sourceMappingURL=project-utils.js.map

package/dist/project-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-utils.js","sourceRoot":"","sources":["../src/project-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,qBAAqB,GAAG,cAAc,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,IAAI,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,gBAAgB,GAAG,UAAU,CAAC;IAEpC,yEAAyE;IACzE,OAAO,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;QAChE,yGAAyG;QACzG,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,yGAAyG;gBACzG,MAAM,OAAO,GAAG,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;gBACvD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC5C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,YAAY,IAAI,MAAM,EAAE,CAAC;oBAC5E,OAAO,UAAU,CAAC;gBACpB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,wCAAwC;YAC1C,CAAC;QACH,CAAC;QACD,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IAED,2BAA2B;IAC3B,MAAM,OAAO,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAC9C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,kCAAkC;IAClC,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/package.json

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