@anthropic-field/core 0.1.0

package/dist/src/utils/workspaceContext.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type Unsubscribe = () => void;
+export interface AddDirectoriesResult {
+    added: string[];
+    failed: Array<{
+        path: string;
+        error: Error;
+    }>;
+}
+/**
+ * WorkspaceContext manages multiple workspace directories and validates paths
+ * against them. This allows the CLI to operate on files from multiple directories
+ * in a single session.
+ */
+export declare class WorkspaceContext {
+    readonly targetDir: string;
+    private directories;
+    private initialDirectories;
+    private onDirectoriesChangedListeners;
+    /**
+     * Creates a new WorkspaceContext with the given initial directory and optional additional directories.
+     * @param targetDir The initial working directory (usually cwd)
+     * @param additionalDirectories Optional array of additional directories to include
+     */
+    constructor(targetDir: string, additionalDirectories?: string[]);
+    /**
+     * Registers a listener that is called when the workspace directories change.
+     * @param listener The listener to call.
+     * @returns A function to unsubscribe the listener.
+     */
+    onDirectoriesChanged(listener: () => void): Unsubscribe;
+    private notifyDirectoriesChanged;
+    /**
+     * Adds a directory to the workspace.
+     * @param directory The directory path to add (can be relative or absolute)
+     * @param basePath Optional base path for resolving relative paths (defaults to cwd)
+     * @throws Error if the directory cannot be added
+     */
+    addDirectory(directory: string): void;
+    /**
+     * Adds multiple directories to the workspace.
+     * Emits a single change event if any directories are added.
+     * @param directories The directory paths to add
+     * @returns Object containing successfully added directories and failures
+     */
+    addDirectories(directories: string[]): AddDirectoriesResult;
+    private resolveAndValidateDir;
+    /**
+     * Gets a copy of all workspace directories.
+     * @returns Array of absolute directory paths
+     */
+    getDirectories(): readonly string[];
+    getInitialDirectories(): readonly string[];
+    setDirectories(directories: readonly string[]): void;
+    /**
+     * Checks if a given path is within any of the workspace directories.
+     * @param pathToCheck The path to validate
+     * @returns True if the path is within the workspace, false otherwise
+     */
+    isPathWithinWorkspace(pathToCheck: string): boolean;
+    /**
+     * Fully resolves a path, including symbolic links.
+     * If the path does not exist, it returns the fully resolved path as it would be
+     * if it did exist.
+     */
+    private fullyResolvedPath;
+    /**
+     * Checks if a path is within a given root directory.
+     * @param pathToCheck The absolute path to check
+     * @param rootDirectory The absolute root directory
+     * @returns True if the path is within the root directory, false otherwise
+     */
+    private isPathWithinRoot;
+    /**
+     * Checks if a file path is a symbolic link that points to a file.
+     */
+    private isFileSymlink;
+}

package/dist/src/utils/workspaceContext.js

@@ -0,0 +1,192 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { isNodeError } from '../utils/errors.js';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { debugLogger } from './debugLogger.js';
+/**
+ * WorkspaceContext manages multiple workspace directories and validates paths
+ * against them. This allows the CLI to operate on files from multiple directories
+ * in a single session.
+ */
+export class WorkspaceContext {
+    targetDir;
+    directories = new Set();
+    initialDirectories;
+    onDirectoriesChangedListeners = new Set();
+    /**
+     * Creates a new WorkspaceContext with the given initial directory and optional additional directories.
+     * @param targetDir The initial working directory (usually cwd)
+     * @param additionalDirectories Optional array of additional directories to include
+     */
+    constructor(targetDir, additionalDirectories = []) {
+        this.targetDir = targetDir;
+        this.addDirectory(targetDir);
+        this.addDirectories(additionalDirectories);
+        this.initialDirectories = new Set(this.directories);
+    }
+    /**
+     * Registers a listener that is called when the workspace directories change.
+     * @param listener The listener to call.
+     * @returns A function to unsubscribe the listener.
+     */
+    onDirectoriesChanged(listener) {
+        this.onDirectoriesChangedListeners.add(listener);
+        return () => {
+            this.onDirectoriesChangedListeners.delete(listener);
+        };
+    }
+    notifyDirectoriesChanged() {
+        // Iterate over a copy of the set in case a listener unsubscribes itself or others.
+        for (const listener of [...this.onDirectoriesChangedListeners]) {
+            try {
+                listener();
+            }
+            catch (e) {
+                // Don't let one listener break others.
+                debugLogger.warn(`Error in WorkspaceContext listener: (${e instanceof Error ? e.message : String(e)})`);
+            }
+        }
+    }
+    /**
+     * Adds a directory to the workspace.
+     * @param directory The directory path to add (can be relative or absolute)
+     * @param basePath Optional base path for resolving relative paths (defaults to cwd)
+     * @throws Error if the directory cannot be added
+     */
+    addDirectory(directory) {
+        const result = this.addDirectories([directory]);
+        if (result.failed.length > 0) {
+            throw result.failed[0].error;
+        }
+    }
+    /**
+     * Adds multiple directories to the workspace.
+     * Emits a single change event if any directories are added.
+     * @param directories The directory paths to add
+     * @returns Object containing successfully added directories and failures
+     */
+    addDirectories(directories) {
+        const result = { added: [], failed: [] };
+        let changed = false;
+        for (const directory of directories) {
+            try {
+                const resolved = this.resolveAndValidateDir(directory);
+                if (!this.directories.has(resolved)) {
+                    this.directories.add(resolved);
+                    changed = true;
+                }
+                result.added.push(directory);
+            }
+            catch (err) {
+                const error = err instanceof Error ? err : new Error(String(err));
+                debugLogger.warn(`[WARN] Skipping unreadable directory: ${directory} (${error.message})`);
+                result.failed.push({ path: directory, error });
+            }
+        }
+        if (changed) {
+            this.notifyDirectoriesChanged();
+        }
+        return result;
+    }
+    resolveAndValidateDir(directory) {
+        const absolutePath = path.resolve(this.targetDir, directory);
+        if (!fs.existsSync(absolutePath)) {
+            throw new Error(`Directory does not exist: ${absolutePath}`);
+        }
+        const stats = fs.statSync(absolutePath);
+        if (!stats.isDirectory()) {
+            throw new Error(`Path is not a directory: ${absolutePath}`);
+        }
+        return fs.realpathSync(absolutePath);
+    }
+    /**
+     * Gets a copy of all workspace directories.
+     * @returns Array of absolute directory paths
+     */
+    getDirectories() {
+        return Array.from(this.directories);
+    }
+    getInitialDirectories() {
+        return Array.from(this.initialDirectories);
+    }
+    setDirectories(directories) {
+        const newDirectories = new Set();
+        for (const dir of directories) {
+            newDirectories.add(this.resolveAndValidateDir(dir));
+        }
+        if (newDirectories.size !== this.directories.size ||
+            ![...newDirectories].every((d) => this.directories.has(d))) {
+            this.directories = newDirectories;
+            this.notifyDirectoriesChanged();
+        }
+    }
+    /**
+     * Checks if a given path is within any of the workspace directories.
+     * @param pathToCheck The path to validate
+     * @returns True if the path is within the workspace, false otherwise
+     */
+    isPathWithinWorkspace(pathToCheck) {
+        try {
+            const fullyResolvedPath = this.fullyResolvedPath(pathToCheck);
+            for (const dir of this.directories) {
+                if (this.isPathWithinRoot(fullyResolvedPath, dir)) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        catch (_error) {
+            return false;
+        }
+    }
+    /**
+     * Fully resolves a path, including symbolic links.
+     * If the path does not exist, it returns the fully resolved path as it would be
+     * if it did exist.
+     */
+    fullyResolvedPath(pathToCheck) {
+        try {
+            return fs.realpathSync(path.resolve(this.targetDir, pathToCheck));
+        }
+        catch (e) {
+            if (isNodeError(e) &&
+                e.code === 'ENOENT' &&
+                e.path &&
+                // realpathSync does not set e.path correctly for symlinks to
+                // non-existent files.
+                !this.isFileSymlink(e.path)) {
+                // If it doesn't exist, e.path contains the fully resolved path.
+                return e.path;
+            }
+            throw e;
+        }
+    }
+    /**
+     * Checks if a path is within a given root directory.
+     * @param pathToCheck The absolute path to check
+     * @param rootDirectory The absolute root directory
+     * @returns True if the path is within the root directory, false otherwise
+     */
+    isPathWithinRoot(pathToCheck, rootDirectory) {
+        const relative = path.relative(rootDirectory, pathToCheck);
+        return (!relative.startsWith(`..${path.sep}`) &&
+            relative !== '..' &&
+            !path.isAbsolute(relative));
+    }
+    /**
+     * Checks if a file path is a symbolic link that points to a file.
+     */
+    isFileSymlink(filePath) {
+        try {
+            return !fs.readlinkSync(filePath).endsWith('/');
+        }
+        catch (_error) {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=workspaceContext.js.map

package/dist/src/utils/workspaceContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceContext.js","sourceRoot":"","sources":["../../../src/utils/workspaceContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAS/C;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IAWhB;IAVH,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,kBAAkB,CAAc;IAChC,6BAA6B,GAAG,IAAI,GAAG,EAAc,CAAC;IAE9D;;;;OAIG;IACH,YACW,SAAiB,EAC1B,wBAAkC,EAAE;QAD3B,cAAS,GAAT,SAAS,CAAQ;QAG1B,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC7B,IAAI,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;QAC3C,IAAI,CAAC,kBAAkB,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACH,oBAAoB,CAAC,QAAoB;QACvC,IAAI,CAAC,6BAA6B,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjD,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,6BAA6B,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC,CAAC;IACJ,CAAC;IAEO,wBAAwB;QAC9B,mFAAmF;QACnF,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,6BAA6B,CAAC,EAAE,CAAC;YAC/D,IAAI,CAAC;gBACH,QAAQ,EAAE,CAAC;YACb,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,uCAAuC;gBACvC,WAAW,CAAC,IAAI,CACd,wCAAwC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CACtF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,SAAiB;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAChD,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC/B,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,WAAqB;QAClC,MAAM,MAAM,GAAyB,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAC/D,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;gBACvD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAC/B,OAAO,GAAG,IAAI,CAAC;gBACjB,CAAC;gBACD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClE,WAAW,CAAC,IAAI,CACd,yCAAyC,SAAS,KAAK,KAAK,CAAC,OAAO,GAAG,CACxE,CAAC;gBACF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAClC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,qBAAqB,CAAC,SAAiB;QAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAE7D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,6BAA6B,YAAY,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,4BAA4B,YAAY,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED,qBAAqB;QACnB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC7C,CAAC;IAED,cAAc,CAAC,WAA8B;QAC3C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;QACzC,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,IACE,cAAc,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,CAAC,IAAI;YAC7C,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAC1D,CAAC;YACD,IAAI,CAAC,WAAW,GAAG,cAAc,CAAC;YAClC,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,qBAAqB,CAAC,WAAmB;QACvC,IAAI,CAAC;YACH,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;YAE9D,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACnC,IAAI,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,GAAG,CAAC,EAAE,CAAC;oBAClD,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,iBAAiB,CAAC,WAAmB;QAC3C,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,IACE,WAAW,CAAC,CAAC,CAAC;gBACd,CAAC,CAAC,IAAI,KAAK,QAAQ;gBACnB,CAAC,CAAC,IAAI;gBACN,6DAA6D;gBAC7D,sBAAsB;gBACtB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,EAC3B,CAAC;gBACD,gEAAgE;gBAChE,OAAO,CAAC,CAAC,IAAI,CAAC;YAChB,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,gBAAgB,CACtB,WAAmB,EACnB,aAAqB;QAErB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QAC3D,OAAO,CACL,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;YACrC,QAAQ,KAAK,IAAI;YACjB,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAC3B,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,QAAgB;QACpC,IAAI,CAAC;YACH,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}