@agentlip/workspace 0.1.0 → 0.1.1-rc.1

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @agentlip/workspace - Workspace discovery + initialization
+ *
+ * Provides upward workspace discovery with security boundaries:
+ * - Starts at cwd (or provided path)
+ * - Walks upward until .agentlip/db.sqlite3 exists
+ * - Stops at filesystem boundary OR user home directory
+ * - Initializes workspace at starting directory if not found
+ */
+/**
+ * Result of workspace discovery
+ */
+export interface WorkspaceDiscoveryResult {
+    /** Absolute path to workspace root directory */
+    root: string;
+    /** Absolute path to db.sqlite3 file */
+    dbPath: string;
+    /** Whether workspace was discovered (true) or needs initialization (false) */
+    discovered: boolean;
+}
+/**
+ * Result of workspace initialization
+ */
+export interface WorkspaceInitResult {
+    /** Absolute path to workspace root directory */
+    root: string;
+    /** Absolute path to db.sqlite3 file */
+    dbPath: string;
+    /** Whether workspace was newly created (true) or already existed (false) */
+    created: boolean;
+}
+/**
+ * Discover workspace root by walking upward from startPath.
+ *
+ * Stops at:
+ * - Filesystem boundary (device ID change)
+ * - User home directory (never traverse above home)
+ *
+ * @param startPath - Directory to start search from (defaults to cwd)
+ * @returns Discovery result or null if no workspace found within boundary
+ */
+export declare function discoverWorkspaceRoot(startPath?: string): Promise<WorkspaceDiscoveryResult | null>;
+/**
+ * Ensure workspace is initialized at workspaceRoot.
+ * Creates .agentlip/ directory and empty db.sqlite3 file if they don't exist.
+ *
+ * @param workspaceRoot - Directory to initialize workspace in
+ * @returns Init result indicating whether workspace was newly created
+ */
+export declare function ensureWorkspaceInitialized(workspaceRoot: string): Promise<WorkspaceInitResult>;
+/**
+ * Discover workspace or initialize if not found.
+ *
+ * Combines discovery + initialization:
+ * - First tries to discover workspace by walking upward
+ * - If not found, initializes workspace at startPath
+ *
+ * @param startPath - Directory to start search from (defaults to cwd)
+ * @returns Discovery result (never null)
+ */
+export declare function discoverOrInitWorkspace(startPath?: string): Promise<WorkspaceDiscoveryResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAsD1C;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAyC9B;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,wBAAwB,CAAC,CAiBnC"}

package/dist/index.js

@@ -0,0 +1,146 @@
+/**
+ * @agentlip/workspace - Workspace discovery + initialization
+ *
+ * Provides upward workspace discovery with security boundaries:
+ * - Starts at cwd (or provided path)
+ * - Walks upward until .agentlip/db.sqlite3 exists
+ * - Stops at filesystem boundary OR user home directory
+ * - Initializes workspace at starting directory if not found
+ */
+import { promises as fs } from 'node:fs';
+import { join, dirname, resolve } from 'node:path';
+import { homedir } from 'node:os';
+const WORKSPACE_MARKER = '.agentlip';
+const DB_FILENAME = 'db.sqlite3';
+/**
+ * Discover workspace root by walking upward from startPath.
+ *
+ * Stops at:
+ * - Filesystem boundary (device ID change)
+ * - User home directory (never traverse above home)
+ *
+ * @param startPath - Directory to start search from (defaults to cwd)
+ * @returns Discovery result or null if no workspace found within boundary
+ */
+export async function discoverWorkspaceRoot(startPath) {
+    const start = resolve(startPath ?? process.cwd());
+    const home = resolve(homedir());
+    // Get initial filesystem device ID
+    const startStat = await fs.lstat(start);
+    const startDevice = startStat.dev;
+    let current = start;
+    while (true) {
+        // Check if .agentlip/db.sqlite3 exists at current level
+        const workspaceDir = join(current, WORKSPACE_MARKER);
+        const dbPath = join(workspaceDir, DB_FILENAME);
+        try {
+            await fs.access(dbPath);
+            // Found it!
+            return {
+                root: current,
+                dbPath,
+                discovered: true
+            };
+        }
+        catch {
+            // Not found, continue upward
+        }
+        // Check boundary conditions before going up
+        const parent = dirname(current);
+        // Reached filesystem root (parent === current)
+        if (parent === current) {
+            return null;
+        }
+        // Stop traversal at user home directory (security boundary)
+        if (current === home) {
+            return null;
+        }
+        // Check filesystem boundary (device ID change)
+        try {
+            const parentStat = await fs.lstat(parent);
+            if (parentStat.dev !== startDevice) {
+                // Crossed filesystem boundary
+                return null;
+            }
+        }
+        catch {
+            // Can't stat parent - stop here
+            return null;
+        }
+        current = parent;
+    }
+}
+/**
+ * Ensure workspace is initialized at workspaceRoot.
+ * Creates .agentlip/ directory and empty db.sqlite3 file if they don't exist.
+ *
+ * @param workspaceRoot - Directory to initialize workspace in
+ * @returns Init result indicating whether workspace was newly created
+ */
+export async function ensureWorkspaceInitialized(workspaceRoot) {
+    const root = resolve(workspaceRoot);
+    const workspaceDir = join(root, WORKSPACE_MARKER);
+    const dbPath = join(workspaceDir, DB_FILENAME);
+    let created = false;
+    // Check if db already exists
+    try {
+        await fs.access(dbPath);
+        // Already initialized
+        return { root, dbPath, created: false };
+    }
+    catch {
+        // Need to initialize
+    }
+    // Create .agentlip directory with mode 0700 (owner rwx only)
+    try {
+        await fs.mkdir(workspaceDir, { mode: 0o700, recursive: true });
+    }
+    catch (err) {
+        // If directory already exists, that's fine
+        if (err.code !== 'EEXIST') {
+            throw err;
+        }
+    }
+    // Create empty db.sqlite3 with mode 0600 (owner rw only)
+    try {
+        const handle = await fs.open(dbPath, 'wx', 0o600); // x = fail if exists
+        await handle.close();
+        created = true;
+    }
+    catch (err) {
+        if (err.code === 'EEXIST') {
+            // File was created between our check and now - that's fine
+            created = false;
+        }
+        else {
+            throw err;
+        }
+    }
+    return { root, dbPath, created };
+}
+/**
+ * Discover workspace or initialize if not found.
+ *
+ * Combines discovery + initialization:
+ * - First tries to discover workspace by walking upward
+ * - If not found, initializes workspace at startPath
+ *
+ * @param startPath - Directory to start search from (defaults to cwd)
+ * @returns Discovery result (never null)
+ */
+export async function discoverOrInitWorkspace(startPath) {
+    const start = resolve(startPath ?? process.cwd());
+    // Try discovery first
+    const discovered = await discoverWorkspaceRoot(start);
+    if (discovered) {
+        return discovered;
+    }
+    // No workspace found - initialize at start path
+    const initialized = await ensureWorkspaceInitialized(start);
+    return {
+        root: initialized.root,
+        dbPath: initialized.dbPath,
+        discovered: false
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentlip/workspace",
-  "version": "0.1.0",
+  "version": "0.1.1-rc.1",
   "description": "Workspace discovery and initialization for Agentlip",
   "type": "module",
   "license": "MIT",
@@ -17,13 +17,19 @@
     "access": "public"
   },
   "files": [
+    "dist/**/*",
     "src/**/*.ts",
     "!src/**/*.test.ts"
   ],
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
   },
   "scripts": {
+    "build": "tsc -p tsconfig.build.json",
     "test": "bun test",
     "verify": "bun verify.ts"
   }