@procedures/fs 0.0.0-stage → 0.2.0

package/dist/types.js

@@ -0,0 +1,197 @@
+/**
+ * Type definitions for client-fs procedures
+ */
+import { z } from "zod";
+// =============================================================================
+// read Types - Read file contents
+// =============================================================================
+export const ReadInputSchema = z.object({
+    /** Path to file to read */
+    path: z.string().describe("Path to file to read"),
+    /** File encoding (default: utf8) */
+    encoding: z.string().optional().default("utf8").describe("File encoding (default: utf8)"),
+});
+// =============================================================================
+// write Types - Write content to file
+// =============================================================================
+export const WriteInputSchema = z.object({
+    /** Path to file to write */
+    path: z.string().describe("Path to file to write"),
+    /** Content to write */
+    content: z.string().describe("Content to write"),
+    /** File encoding (default: utf8) */
+    encoding: z.string().optional().default("utf8").describe("File encoding (default: utf8)"),
+    /** Write mode: write (overwrite) or append (default: write) */
+    mode: z.enum(["write", "append"]).optional().default("write").describe("Write mode: write (overwrite) or append (default: write)"),
+});
+export const FileTypeInputSchema = z.object({
+    /** Path to check */
+    path: z.string().describe("Path to check"),
+});
+// =============================================================================
+// exists Types - Check if file or directory exists
+// =============================================================================
+export const ExistsInputSchema = z.object({
+    /** Path to check */
+    path: z.string().describe("Path to check"),
+});
+export var FileType;
+(function (FileType) {
+    FileType["File"] = "file";
+    FileType["Directory"] = "directory";
+    FileType["Other"] = "other";
+})(FileType || (FileType = {}));
+// =============================================================================
+// mkdir Types - Create directory
+// =============================================================================
+export const MkdirInputSchema = z.object({
+    /** Path of directory to create */
+    path: z.string().describe("Path of directory to create"),
+    /** Create parent directories if needed (default: true) */
+    recursive: z.boolean().optional().default(true).describe("Create parent directories if needed (default: true)"),
+});
+// =============================================================================
+// rm Types - Remove file or directory
+// =============================================================================
+export const RmInputSchema = z.object({
+    /** Path to remove */
+    path: z.string().describe("Path to remove"),
+    /** Remove directories and contents recursively (default: false) */
+    recursive: z.boolean().optional().default(false).describe("Remove directories and contents recursively (default: false)"),
+    /** Ignore errors if path doesn't exist (default: false) */
+    force: z.boolean().optional().default(false).describe("Ignore errors if path doesn't exist (default: false)"),
+});
+// =============================================================================
+// readdir Types - Read directory contents
+// =============================================================================
+export const ReaddirInputSchema = z.object({
+    /** Path of directory to read */
+    path: z.string().describe("Path of directory to read"),
+    /** Read subdirectories recursively (default: false) */
+    recursive: z.boolean().optional().default(false).describe("Read subdirectories recursively (default: false)"),
+    /** Include file stats with each entry (default: false) */
+    includeStats: z.boolean().optional().default(false).describe("Include file stats with each entry (default: false)"),
+});
+// =============================================================================
+// stat Types - Get file or directory stats
+// =============================================================================
+export const StatInputSchema = z.object({
+    /** Path to get stats for */
+    path: z.string().describe("Path to get stats for"),
+});
+// =============================================================================
+// copy Types - Copy file or directory
+// =============================================================================
+export const CopyInputSchema = z.object({
+    /** Source path */
+    src: z.string().describe("Source path"),
+    /** Destination path */
+    dest: z.string().describe("Destination path"),
+    /** Copy directories recursively (default: true) */
+    recursive: z.boolean().optional().default(true).describe("Copy directories recursively (default: true)"),
+    /** Overwrite existing files (default: false) */
+    overwrite: z.boolean().optional().default(false).describe("Overwrite existing files (default: false)"),
+});
+// =============================================================================
+// move Types - Move or rename file/directory
+// =============================================================================
+export const MoveInputSchema = z.object({
+    /** Source path */
+    src: z.string().describe("Source path"),
+    /** Destination path */
+    dest: z.string().describe("Destination path"),
+    /** Overwrite existing files (default: false) */
+    overwrite: z.boolean().optional().default(false).describe("Overwrite existing files (default: false)"),
+});
+// =============================================================================
+// glob Types - Find files matching glob pattern
+// =============================================================================
+export const GlobInputSchema = z.object({
+    /** Glob pattern to match */
+    pattern: z.string().describe("Glob pattern to match"),
+    /** Working directory (default: process.cwd()) */
+    cwd: z.string().optional().describe("Working directory (default: process.cwd())"),
+    /** Return absolute paths (default: false) */
+    absolute: z.boolean().optional().default(false).describe("Return absolute paths (default: false)"),
+    /** Include dotfiles (default: false) */
+    dot: z.boolean().optional().default(false).describe("Include dotfiles (default: false)"),
+    /** Glob patterns of the paths to leave out. The search does not enter the folders that they match. */
+    ignore: z.array(z.string()).optional().describe("Glob patterns of the paths to leave out. The search does not enter the folders that they match."),
+});
+// =============================================================================
+// read.json Types - Read and parse JSON file
+// =============================================================================
+export const ReadJsonInputSchema = z.object({
+    /** Path to JSON file */
+    path: z.string().describe("Path to JSON file"),
+});
+// =============================================================================
+// Output schemas (roadmap 2.1)
+// =============================================================================
+// Loose objects: a field that a schema does not name stays in the result (a strict schema would
+// remove it when the output is validated).
+const fileType = z.enum(FileType).describe("file, directory or other");
+export const StatOutputSchema = z.looseObject({
+    path: z.string().describe("The path"),
+    type: fileType,
+    size: z.number().describe("The size, in bytes"),
+    mtime: z.string().describe("The time of the last change (ISO 8601)"),
+    ctime: z.string().describe("The time of the last status change (ISO 8601)"),
+    atime: z.string().describe("The time of the last access (ISO 8601)"),
+    mode: z.number().describe("The mode bits (type and permissions)"),
+});
+export const ReadOutputSchema = z.looseObject({
+    content: z.string().describe("The content of the file"),
+    path: z.string().describe("The path of the file"),
+    stats: StatOutputSchema.describe("The stats of the file"),
+});
+export const WriteOutputSchema = z.looseObject({
+    path: z.string().describe("The path of the file"),
+    bytesWritten: z.number().describe("The number of bytes written"),
+});
+export const ExistsOutputSchema = z.union([
+    z.looseObject({ exists: z.literal(false).describe("The path does not exist") }),
+    z.looseObject({
+        exists: z.literal(true).describe("The path exists"),
+        stats: StatOutputSchema.describe("The stats of the path"),
+    }),
+]);
+export const MkdirOutputSchema = z.looseObject({
+    path: z.string().describe("The path of the folder"),
+    created: z.boolean().describe("False when the folder existed already"),
+});
+export const RmOutputSchema = z.looseObject({
+    path: z.string().describe("The path"),
+    removed: z.boolean().describe("False when the path did not exist (with force)"),
+});
+export const ReaddirOutputSchema = z.looseObject({
+    path: z.string().describe("The path of the folder"),
+    entries: z
+        .array(z.looseObject({
+        name: z.string().describe("The name of the entry"),
+        path: z.string().describe("The full path of the entry"),
+        type: fileType,
+        stats: StatOutputSchema.optional().describe("The stats, with includeStats"),
+    }))
+        .describe("The entries of the folder"),
+});
+export const CopyOutputSchema = z.looseObject({
+    src: z.string().describe("The source path"),
+    dest: z.string().describe("The destination path"),
+});
+export const MoveOutputSchema = z.looseObject({
+    src: z.string().describe("The old path"),
+    dest: z.string().describe("The new path"),
+});
+export const GlobOutputSchema = z.looseObject({
+    pattern: z.string().describe("The glob pattern"),
+    matches: z
+        .array(z.string())
+        .describe('The matching paths, sorted: relative to cwd with "/" separators, or absolute with absolute: true'),
+});
+export const ReadJsonOutputSchema = z.looseObject({
+    path: z.string().describe("The path of the file"),
+    data: z.unknown().describe("The parsed JSON value"),
+    stats: StatOutputSchema.describe("The stats of the file"),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,80 @@
 {
+  "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/fs",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "File system procedures: read, write, copy, move, glob, exists, mkdir and JSON read and write, callable in process, over RPC or from Claude through MCP.",
+  "keywords": [
+    "filesystem",
+    "fs",
+    "glob",
+    "files",
+    "procedures",
+    "rpc"
+  ],
+  "homepage": "https://mark1russell7.github.io/client/",
+  "bugs": {
+    "url": "https://github.com/mark1russell7/client/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mark1russell7/client.git",
+    "directory": "packages/client-fs"
+  },
+  "license": "MIT",
+  "author": "Mark Russell (https://github.com/mark1russell7)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./module": {
+      "types": "./dist/module.d.ts",
+      "import": "./dist/module.js"
+    },
+    "./register": {
+      "types": "./dist/register.d.ts",
+      "import": "./dist/register.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "./dist/register.js"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "client": {
+    "procedures": "./dist/register.js"
+  },
+  "dependencies": {
+    "@procedures/client": "0.2.0",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "@types/node": "^22.0.0",
+    "@mark1russell7/cue": "^1.0.0",
+    "vitest": "^5.0.3"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .tsbuildinfo",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
 }

package/src/index.ts

@@ -0,0 +1,17 @@
+/**
+ * Client-FS - Filesystem operations as RPC procedures
+ *
+ * Provides fs.read, fs.write, fs.exists, and other filesystem procedures.
+ *
+ * @example
+ * ```typescript
+ * import { fsProcedures } from "@procedures/fs";
+ *
+ * // Or use via client.call
+ * await client.call(["fs", "read"], { path: "./file.txt" });
+ * await client.call(["fs", "write"], { path: "./out.txt", content: "hello" });
+ * ```
+ */
+
+export * from "./procedures/fs.js";
+export * from "./module.js";

package/src/module.ts

@@ -0,0 +1,265 @@
+/**
+ * Module (no side effects): the procedures of this package as data, for `createRegistry()`.
+ *
+ * Procedure Registration for filesystem operations
+ *
+ * Registers fs.* procedures with the client system.
+ * This file is referenced by package.json's client.procedures field.
+ */
+
+import { createProcedure, zodAdapter, defineModule, type Effects, type ProcedureModule, PROCEDURE_REGISTRY, registerModules, type ProcedureRegistry } from "@procedures/client";
+import { read } from "./procedures/fs/read.js";
+import { write } from "./procedures/fs/write.js";
+import { exists } from "./procedures/fs/exists.js";
+import { mkdir } from "./procedures/fs/mkdir.js";
+import { rm } from "./procedures/fs/rm.js";
+import { readdir } from "./procedures/fs/readdir.js";
+import { stat } from "./procedures/fs/stat.js";
+import { copy } from "./procedures/fs/copy.js";
+import { move } from "./procedures/fs/move.js";
+import { glob } from "./procedures/fs/glob.js";
+import { readJson } from "./procedures/fs/json.js";
+import {
+  ReadInputSchema,
+  WriteInputSchema,
+  ExistsInputSchema,
+  MkdirInputSchema,
+  RmInputSchema,
+  ReaddirInputSchema,
+  StatInputSchema,
+  CopyInputSchema,
+  MoveInputSchema,
+  GlobInputSchema,
+  ReadJsonInputSchema,
+  type ReadInput,
+  type ReadOutput,
+  type WriteInput,
+  type WriteOutput,
+  type ExistsInput,
+  type ExistsOutput,
+  type MkdirInput,
+  type MkdirOutput,
+  type RmInput,
+  type RmOutput,
+  type ReaddirInput,
+  type ReaddirOutput,
+  type StatInput,
+  type StatOutput,
+  type CopyInput,
+  type CopyOutput,
+  type MoveInput,
+  type MoveOutput,
+  type GlobInput,
+  type GlobOutput,
+  type ReadJsonInput,
+  type ReadJsonOutput,
+  ReadOutputSchema,
+  WriteOutputSchema,
+  ExistsOutputSchema,
+  MkdirOutputSchema,
+  RmOutputSchema,
+  ReaddirOutputSchema,
+  StatOutputSchema,
+  CopyOutputSchema,
+  MoveOutputSchema,
+  GlobOutputSchema,
+  ReadJsonOutputSchema,
+} from "./types.js";
+
+// =============================================================================
+// Procedure Definitions
+// =============================================================================
+
+/** The effects of a procedure that reads the files of the host and changes nothing. */
+const READS_FILES: Effects = { reads: ["fs"], writes: [] };
+
+const fsReadProcedure = createProcedure()
+  .path(["fs", "read"])
+  .input(zodAdapter<ReadInput>(ReadInputSchema))
+  .output(zodAdapter<ReadOutput>(ReadOutputSchema))
+  .meta({
+    description: "Read file contents",
+    args: ["path"],
+    shorts: { encoding: "e" },
+    output: "json",
+    effects: READS_FILES,
+  })
+  .handler(read)
+  .build();
+
+const fsWriteProcedure = createProcedure()
+  .path(["fs", "write"])
+  .input(zodAdapter<WriteInput>(WriteInputSchema))
+  .output(zodAdapter<WriteOutput>(WriteOutputSchema))
+  .meta({
+    description: "Write content to file",
+    args: ["path", "content"],
+    shorts: { encoding: "e", mode: "m" },
+    output: "json",
+    // It replaces the file, or appends to it. A second append adds the content again.
+    effects: { reads: [], writes: ["fs"] },
+  })
+  .handler(write)
+  .build();
+
+const fsExistsProcedure = createProcedure()
+  .path(["fs", "exists"])
+  .input(zodAdapter<ExistsInput>(ExistsInputSchema))
+  .output(zodAdapter<ExistsOutput>(ExistsOutputSchema))
+  .meta({
+    description: "Check if file or directory exists",
+    args: ["path"],
+    shorts: {},
+    output: "json",
+    effects: READS_FILES,
+  })
+  .handler(exists)
+  .build();
+
+const fsMkdirProcedure = createProcedure()
+  .path(["fs", "mkdir"])
+  .input(zodAdapter<MkdirInput>(MkdirInputSchema))
+  .output(zodAdapter<MkdirOutput>(MkdirOutputSchema))
+  .meta({
+    description: "Create directory",
+    args: ["path"],
+    shorts: { recursive: "r" },
+    output: "json",
+    // It creates only a missing folder. An existing folder gives `created: false`.
+    effects: { reads: ["fs"], writes: ["fs"], destructive: false, idempotent: true },
+  })
+  .handler(mkdir)
+  .build();
+
+const fsRmProcedure = createProcedure()
+  .path(["fs", "rm"])
+  .input(zodAdapter<RmInput>(RmInputSchema))
+  .output(zodAdapter<RmOutput>(RmOutputSchema))
+  .meta({
+    description: "Remove file or directory",
+    args: ["path"],
+    shorts: { recursive: "r", force: "f" },
+    output: "json",
+    effects: { reads: ["fs"], writes: ["fs"], idempotent: true },
+  })
+  .handler(rm)
+  .build();
+
+const fsReaddirProcedure = createProcedure()
+  .path(["fs", "readdir"])
+  .input(zodAdapter<ReaddirInput>(ReaddirInputSchema))
+  .output(zodAdapter<ReaddirOutput>(ReaddirOutputSchema))
+  .meta({
+    description: "Read directory contents",
+    args: ["path"],
+    shorts: { recursive: "r", includeStats: "s" },
+    output: "json",
+    effects: READS_FILES,
+  })
+  .handler(readdir)
+  .build();
+
+const fsStatProcedure = createProcedure()
+  .path(["fs", "stat"])
+  .input(zodAdapter<StatInput>(StatInputSchema))
+  .output(zodAdapter<StatOutput>(StatOutputSchema))
+  .meta({
+    description: "Get file or directory stats",
+    args: ["path"],
+    shorts: {},
+    output: "json",
+    effects: READS_FILES,
+  })
+  .handler(stat)
+  .build();
+
+const fsCopyProcedure = createProcedure()
+  .path(["fs", "copy"])
+  .input(zodAdapter<CopyInput>(CopyInputSchema))
+  .output(zodAdapter<CopyOutput>(CopyOutputSchema))
+  .meta({
+    description: "Copy file or directory",
+    args: ["src", "dest"],
+    shorts: { recursive: "r", overwrite: "o" },
+    output: "json",
+    // With `overwrite`, it replaces the files at the destination
+    effects: { reads: ["fs"], writes: ["fs"], idempotent: true },
+  })
+  .handler(copy)
+  .build();
+
+const fsMoveProcedure = createProcedure()
+  .path(["fs", "move"])
+  .input(zodAdapter<MoveInput>(MoveInputSchema))
+  .output(zodAdapter<MoveOutput>(MoveOutputSchema))
+  .meta({
+    description: "Move or rename file/directory",
+    args: ["src", "dest"],
+    shorts: { overwrite: "o" },
+    output: "json",
+    // With `overwrite`, it replaces the destination. A second call finds no source and changes nothing.
+    effects: { reads: ["fs"], writes: ["fs"], idempotent: true },
+  })
+  .handler(move)
+  .build();
+
+const fsGlobProcedure = createProcedure()
+  .path(["fs", "glob"])
+  .input(zodAdapter<GlobInput>(GlobInputSchema))
+  .output(zodAdapter<GlobOutput>(GlobOutputSchema))
+  .meta({
+    description: "Find files matching glob pattern",
+    args: ["pattern"],
+    shorts: { cwd: "c", absolute: "a", dot: "d" },
+    output: "json",
+    effects: READS_FILES,
+  })
+  .handler(glob)
+  .build();
+
+const fsReadJsonProcedure = createProcedure()
+  .path(["fs", "read.json"])
+  .input(zodAdapter<ReadJsonInput>(ReadJsonInputSchema))
+  .output(zodAdapter<ReadJsonOutput>(ReadJsonOutputSchema))
+  .meta({
+    description: "Read and parse JSON file",
+    args: ["path"],
+    shorts: {},
+    output: "json",
+    effects: READS_FILES,
+  })
+  .handler(readJson)
+  .build();
+
+// =============================================================================
+// Registration
+// =============================================================================
+
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Importing this
+ * file registers nothing. (`register.ts` registers the same procedures in the global registry.)
+ */
+export const fsModule: ProcedureModule = defineModule("@procedures/fs", [
+    fsReadProcedure,
+    fsWriteProcedure,
+    fsExistsProcedure,
+    fsMkdirProcedure,
+    fsRmProcedure,
+    fsReaddirProcedure,
+    fsStatProcedure,
+    fsCopyProcedure,
+    fsMoveProcedure,
+    fsGlobProcedure,
+    fsReadJsonProcedure,
+  ]);
+
+export default fsModule;
+
+/**
+ * This function registers the procedures of @procedures/fs, and of the modules that it requires, in
+ * a registry. The default is the global registry. Importing this file registers nothing: the
+ * `./register` entry starts this function (ARCHITECTURE-PROPOSALS-2026-10, P9).
+ */
+export function registerFsProcedures(registry: ProcedureRegistry = PROCEDURE_REGISTRY): void {
+  registerModules(registry, [fsModule]);
+}

package/src/procedures/fs/copy.ts

@@ -0,0 +1,24 @@
+/**
+ * copy procedure
+ *
+ * Copy file or directory
+ */
+
+import { copyFile, cp, constants } from "node:fs/promises";
+import type { CopyInput, CopyOutput } from "../../types.js";
+
+/**
+ * Copy file or directory
+ */
+export async function copy(input: CopyInput): Promise<CopyOutput> {
+  const { src, dest, recursive, overwrite } = input;
+  const flags = overwrite ? 0 : constants.COPYFILE_EXCL;
+
+  if (recursive) {
+    await cp(src, dest, { recursive, force: overwrite });
+  } else {
+    await copyFile(src, dest, flags);
+  }
+
+  return { src, dest };
+}

package/src/procedures/fs/exists.ts

@@ -0,0 +1,20 @@
+/**
+ * exists procedure
+ *
+ * Check if file or directory exists
+ */
+
+import { type ExistsInput, type ExistsOutput } from "../../types.js";
+import { stat } from "./stat.js";
+
+/**
+ * Check if file or directory exists
+ */
+export async function exists(input: ExistsInput): Promise<ExistsOutput> {
+  try {
+    const stats = await stat(input);
+    return { exists: true, stats };
+  } catch {
+    return { exists: false };
+  }
+}