@mclawnet/swarm 0.1.5 → 0.1.6

package/dist/__tests__/project-files.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=project-files.test.d.ts.map

package/dist/__tests__/project-files.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-files.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/project-files.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/project-files.test.js

@@ -0,0 +1,143 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, rmSync, symlinkSync, existsSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { PROJECT_FILE_WHITELIST, ProjectFilesError, isWhitelistedRelPath, listProjectFiles, readProjectFile, writeProjectFile, } from "../project-files.js";
+let workDir;
+beforeEach(() => {
+    workDir = mkdtempSync(join(tmpdir(), "clawnet-project-files-"));
+});
+afterEach(() => {
+    rmSync(workDir, { recursive: true, force: true });
+});
+describe("isWhitelistedRelPath", () => {
+    it("accepts the four canonical paths", () => {
+        for (const p of PROJECT_FILE_WHITELIST)
+            expect(isWhitelistedRelPath(p)).toBe(true);
+    });
+    it("rejects everything else", () => {
+        for (const p of [
+            "claude.md", // wrong case
+            "../CLAUDE.md", // traversal
+            ".claude/rules/x.md", // not in P1 whitelist
+            ".git/config",
+            "",
+            "CLAUDE.md/", // trailing slash mismatch
+        ])
+            expect(isWhitelistedRelPath(p)).toBe(false);
+    });
+});
+describe("listProjectFiles", () => {
+    it("returns whitelist entries with exists=false when nothing on disk", () => {
+        const files = listProjectFiles(workDir);
+        expect(files).toHaveLength(PROJECT_FILE_WHITELIST.length);
+        for (const f of files) {
+            expect(f.exists).toBe(false);
+            expect(f.loadedByCli).toBe(true);
+        }
+    });
+    it("reports size + mtime for files that exist", () => {
+        writeFileSync(join(workDir, "CLAUDE.md"), "hi");
+        const files = listProjectFiles(workDir);
+        const claude = files.find((f) => f.relPath === "CLAUDE.md");
+        expect(claude.exists).toBe(true);
+        expect(claude.size).toBe(2);
+        expect(typeof claude.mtime).toBe("number");
+    });
+    it("does not throw when workDir was deleted out from under us", () => {
+        rmSync(workDir, { recursive: true, force: true });
+        const files = listProjectFiles(workDir);
+        expect(files.every((f) => !f.exists)).toBe(true);
+    });
+});
+describe("readProjectFile", () => {
+    it("returns empty content + valid etag for a missing file", () => {
+        const r = readProjectFile(workDir, "CLAUDE.md");
+        expect(r.content).toBe("");
+        expect(r.etag).toMatch(/^[0-9a-f]{12}$/);
+        expect(r.mtime).toBe(0);
+    });
+    it("reads existing file content", () => {
+        writeFileSync(join(workDir, "CLAUDE.md"), "always reply in chinese\n");
+        const r = readProjectFile(workDir, "CLAUDE.md");
+        expect(r.content).toBe("always reply in chinese\n");
+        expect(r.mtime).toBeGreaterThan(0);
+    });
+    it("rejects non-whitelisted paths", () => {
+        expect(() => readProjectFile(workDir, "../etc/passwd")).toThrow(ProjectFilesError);
+        expect(() => readProjectFile(workDir, ".git/config")).toThrow(ProjectFilesError);
+    });
+    it("rejects symlinks pointing outside workDir", () => {
+        // Create an outside-workDir target that definitely exists.
+        const outside = mkdtempSync(join(tmpdir(), "clawnet-outside-"));
+        const target = join(outside, "leaked.md");
+        writeFileSync(target, "secret");
+        mkdirSync(join(workDir, ".claude"));
+        try {
+            symlinkSync(target, join(workDir, ".claude", "CLAUDE.md"));
+        }
+        catch {
+            rmSync(outside, { recursive: true, force: true });
+            return; // skip on platforms where we can't symlink
+        }
+        try {
+            expect(() => readProjectFile(workDir, ".claude/CLAUDE.md")).toThrow(ProjectFilesError);
+        }
+        finally {
+            rmSync(outside, { recursive: true, force: true });
+        }
+    });
+});
+describe("writeProjectFile", () => {
+    it("creates the file when it does not exist", () => {
+        const r = writeProjectFile(workDir, "CLAUDE.md", "hello");
+        expect(r.content).toBe("hello\n"); // md gets trailing newline
+        expect(readFileSync(join(workDir, "CLAUDE.md"), "utf-8")).toBe("hello\n");
+    });
+    it("creates .claude/ directory automatically", () => {
+        writeProjectFile(workDir, ".claude/settings.json", '{"foo":1}');
+        expect(existsSync(join(workDir, ".claude"))).toBe(true);
+        expect(readFileSync(join(workDir, ".claude", "settings.json"), "utf-8")).toBe('{"foo":1}');
+    });
+    it("rejects invalid JSON for .json files", () => {
+        expect(() => writeProjectFile(workDir, ".claude/settings.json", "{not json")).toThrow(ProjectFilesError);
+        expect(existsSync(join(workDir, ".claude", "settings.json"))).toBe(false);
+    });
+    it("normalizes empty JSON to '{}'", () => {
+        writeProjectFile(workDir, ".claude/settings.json", "");
+        const txt = readFileSync(join(workDir, ".claude", "settings.json"), "utf-8");
+        expect(txt).toBe("{}\n");
+    });
+    it("etag mismatch returns 409 with current content", () => {
+        writeProjectFile(workDir, "CLAUDE.md", "v1");
+        expect(() => writeProjectFile(workDir, "CLAUDE.md", "v2", { ifMatchEtag: "stale-etag" })).toThrow(ProjectFilesError);
+        try {
+            writeProjectFile(workDir, "CLAUDE.md", "v2", { ifMatchEtag: "stale-etag" });
+        }
+        catch (err) {
+            const e = err;
+            expect(e.status).toBe(409);
+            expect(e.details?.currentContent).toBe("v1\n");
+        }
+    });
+    it("etag match permits the write", () => {
+        const first = writeProjectFile(workDir, "CLAUDE.md", "v1");
+        const second = writeProjectFile(workDir, "CLAUDE.md", "v2", { ifMatchEtag: first.etag });
+        expect(second.content).toBe("v2\n");
+        expect(second.etag).not.toBe(first.etag);
+    });
+    it("rejects non-whitelisted writes", () => {
+        expect(() => writeProjectFile(workDir, "../escape.md", "x")).toThrow(ProjectFilesError);
+    });
+    it("write is atomic (no partial file visible if rename fails — smoke check via tmp cleanup)", () => {
+        writeProjectFile(workDir, "CLAUDE.md", "atomic");
+        // Confirm no `.tmp` siblings remain.
+        const entries = readFileSync(join(workDir, "CLAUDE.md"), "utf-8");
+        expect(entries).toBe("atomic\n");
+        // The tmp pattern is `.<hex>.tmp` — none should remain.
+        const dirents = require("node:fs").readdirSync(workDir);
+        for (const d of dirents)
+            expect(d).not.toMatch(/^\..*\.tmp$/);
+    });
+});
+//# sourceMappingURL=project-files.test.js.map

package/dist/__tests__/project-files.test.js.map

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

package/dist/__tests__/projects-fs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=projects-fs.test.d.ts.map

package/dist/__tests__/projects-fs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects-fs.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/projects-fs.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/projects-fs.test.js

@@ -0,0 +1,107 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { TaskStore, projectRoot } from "@mclawnet/task";
+import { listAllProjectSummaries, loadProjectSummary, loadSwarmSummaries, resolveWorkDir, } from "../projects-fs.js";
+let home;
+let workDir;
+beforeEach(async () => {
+    home = mkdtempSync(join(tmpdir(), "swarm-projects-fs-"));
+    workDir = mkdtempSync(join(tmpdir(), "swarm-projects-fs-wd-"));
+    const root = projectRoot(workDir, home);
+    mkdirSync(root, { recursive: true });
+    writeFileSync(join(root, "meta.json"), JSON.stringify({
+        version: 1, workDir, createdAt: "2026-05-09T00:00:00Z",
+    }));
+    await new TaskStore({ workDir, home }).create({
+        teamName: "dev", subject: "task A",
+    });
+});
+afterEach(() => {
+    rmSync(home, { recursive: true, force: true });
+    rmSync(workDir, { recursive: true, force: true });
+});
+describe("projects-fs", () => {
+    it("listAllProjectSummaries returns one summary with task count 1", () => {
+        const summaries = listAllProjectSummaries(home);
+        expect(summaries).toHaveLength(1);
+        expect(summaries[0].workDir).toBe(workDir);
+        expect(summaries[0].taskCount).toBe(1);
+        expect(summaries[0].taskCounts.pending).toBe(1);
+    });
+    it("resolveWorkDir round-trips an encodedCwd", () => {
+        const enc = listAllProjectSummaries(home)[0].encodedCwd;
+        expect(resolveWorkDir(home, enc)).toBe(workDir);
+    });
+    it("loadProjectSummary returns null for unknown encodedCwd", () => {
+        expect(loadProjectSummary(home, "-not-a-real-dir")).toBeNull();
+    });
+    it("loadSwarmSummaries returns [] when no swarms exist", () => {
+        expect(loadSwarmSummaries(home, workDir)).toEqual([]);
+    });
+    it("rejects unsafe encodedCwd containing slashes or ..", () => {
+        expect(resolveWorkDir(home, "../etc")).toBeNull();
+        expect(resolveWorkDir(home, "a/b")).toBeNull();
+        expect(resolveWorkDir(home, "")).toBeNull();
+    });
+    it("loadSwarmSummaries returns one summary mapping snapshot fields", () => {
+        // Build a minimal recovery.json snapshot under
+        // <projectRoot>/swarms/<swarmId>/recovery.json — this is the actual
+        // filename that loadSwarmSnapshot() reads (see persistence.ts).
+        // Note: persistence.ts derives its own home from CLAWNET_HOME, so we
+        // must set it here to point swarm-side resolution at our temp dir.
+        const swarmId = "swarm-test-1";
+        const swarmsDir = join(projectRoot(workDir, home), "swarms", swarmId);
+        mkdirSync(swarmsDir, { recursive: true });
+        const snapshot = {
+            id: swarmId,
+            hubSessionId: "hub-1",
+            workDir,
+            teamName: "dev",
+            roles: [
+                { instanceId: "queen-0", roleName: "queen", status: "ready" },
+                { instanceId: "worker-0", roleName: "worker", status: "ready" },
+            ],
+            plan: null,
+            nextInstanceSeq: {},
+            savedAt: 12345,
+            status: "active",
+        };
+        writeFileSync(join(swarmsDir, "recovery.json"), JSON.stringify(snapshot));
+        const prevHome = process.env.CLAWNET_HOME;
+        process.env.CLAWNET_HOME = home;
+        try {
+            const summaries = loadSwarmSummaries(home, workDir);
+            expect(summaries).toHaveLength(1);
+            expect(summaries[0]).toEqual({
+                swarmId,
+                teamName: "dev",
+                status: "active",
+                roleCount: 2,
+                savedAt: 12345,
+            });
+        }
+        finally {
+            if (prevHome === undefined)
+                delete process.env.CLAWNET_HOME;
+            else
+                process.env.CLAWNET_HOME = prevHome;
+        }
+    });
+    it("counts non-pending task statuses correctly", async () => {
+        // beforeEach already created one pending task. Add a second task and
+        // mutate it to in_progress via TaskStore.update() so the
+        // `if (t.status in counts)` branch at projects-fs.ts:90 is exercised
+        // for a non-pending status.
+        const store = new TaskStore({ workDir, home });
+        const second = await store.create({ teamName: "dev", subject: "task B" });
+        await store.update(second.id, { status: "in_progress" });
+        const summaries = listAllProjectSummaries(home);
+        expect(summaries).toHaveLength(1);
+        expect(summaries[0].taskCount).toBe(2);
+        expect(summaries[0].taskCounts.pending).toBe(1);
+        expect(summaries[0].taskCounts.in_progress).toBe(1);
+    });
+});
+//# sourceMappingURL=projects-fs.test.js.map

package/dist/__tests__/projects-fs.test.js.map

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

package/dist/index.d.ts

@@ -13,4 +13,8 @@ export type { SessionAdapter, HubAdapter, SwarmInstance, RoleInstance, SwarmActi
 export type { RoleDefinition, DelegationMap, DelegationEntry } from "./roles/types.js";
 export { initTemplates, listTemplates, loadTemplate } from "./templates/template-loader.js";
 export type { TemplateDefinition, TemplateRoleSpec } from "./templates/types.js";
+export { listProjectDirs, resolveWorkDir, loadProjectSummary, loadSwarmSummaries, listAllProjectSummaries, } from "./projects-fs.js";
+export type { TaskStatus, TaskCounts, ProjectSummary, SwarmSummary, } from "./projects-fs.js";
+export { PROJECT_FILE_WHITELIST, isWhitelistedRelPath, listProjectFiles, readProjectFile, writeProjectFile, ProjectFilesError, } from "./project-files.js";
+export type { ProjectFileRelPath, ProjectFileEntry, ProjectFileContent, } from "./project-files.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":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxG,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,IAAI,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhG,YAAY,EACV,cAAc,EACd,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEvF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC5F,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxG,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,IAAI,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhG,YAAY,EACV,cAAc,EACd,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEvF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC5F,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,OAAO,EACL,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -8,4 +8,6 @@ export { InboxStore } from "./inbox-store.js";
 export { InboxRelay } from "./inbox-relay.js";
 export { InboxWatcher } from "./inbox-watcher.js";
 export { initTemplates, listTemplates, loadTemplate } from "./templates/template-loader.js";
+export { listProjectDirs, resolveWorkDir, loadProjectSummary, loadSwarmSummaries, listAllProjectSummaries, } from "./projects-fs.js";
+export { PROJECT_FILE_WHITELIST, isWhitelistedRelPath, listProjectFiles, readProjectFile, writeProjectFile, ProjectFilesError, } from "./project-files.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,6EAA6E;AAE7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxG,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAgD,MAAM,oBAAoB,CAAC;AAiBhG,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxG,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAgD,MAAM,oBAAoB,CAAC;AAiBhG,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAG5F,OAAO,EACL,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/project-files.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Project files endpoint helpers.
+ *
+ * Surfaces a fixed whitelist of files inside a project's `workDir` (CLAUDE.md
+ * and .claude/settings*.json) so the UI can read/write them without giving
+ * blanket FS access.
+ *
+ * Why a hard-coded whitelist (no globs in P1):
+ *   The Claude CLI auto-loads exactly these paths from cwd. Limiting to the
+ *   exact set lets us audit every read/write and rules out mistakes like a
+ *   user typing `relPath=../../etc/passwd` or `.git/config`. Phase 2 may add
+ *   `.claude/rules/*.md`, which will require a careful prefix-glob design.
+ *
+ * Defense-in-depth path checks:
+ *   1. relPath must be in WHITELIST (exact string match)
+ *   2. Resolved absolute path must live under realpath(workDir)
+ *   3. realpath() resolves symlinks, so a symlink inside .claude/ that
+ *      points outside workDir is still rejected by check (2).
+ */
+export declare const PROJECT_FILE_WHITELIST: readonly ["CLAUDE.md", ".claude/CLAUDE.md", ".claude/settings.json", ".claude/settings.local.json"];
+export type ProjectFileRelPath = (typeof PROJECT_FILE_WHITELIST)[number];
+export interface ProjectFileEntry {
+    relPath: ProjectFileRelPath;
+    exists: boolean;
+    size?: number;
+    mtime?: number;
+    loadedByCli: true;
+}
+export interface ProjectFileContent {
+    relPath: ProjectFileRelPath;
+    content: string;
+    mtime: number;
+    etag: string;
+}
+export declare class ProjectFilesError extends Error {
+    status: number;
+    details?: Record<string, unknown> | undefined;
+    constructor(status: number, message: string, details?: Record<string, unknown> | undefined);
+}
+/** Type guard — narrows an arbitrary string to the whitelist union. */
+export declare function isWhitelistedRelPath(rel: string): rel is ProjectFileRelPath;
+/** List the whitelist with stat info for present files. Never throws. */
+export declare function listProjectFiles(workDir: string): ProjectFileEntry[];
+/**
+ * Read a whitelisted file. Returns content="" + etag of empty string when
+ * the file does not exist, so the editor UI can populate a blank textarea
+ * with a valid etag for first-write conflict detection.
+ */
+export declare function readProjectFile(workDir: string, relPath: string): ProjectFileContent;
+export interface WriteOptions {
+    ifMatchEtag?: string;
+}
+/**
+ * Atomic write: validates JSON syntax for `.json` files, ensures parent
+ * `.claude/` exists, writes to a tmp sibling, then renames. Returns the
+ * post-write content snapshot. On etag mismatch throws 409 with the current
+ * server-side content so the UI can render a 3-way diff.
+ */
+export declare function writeProjectFile(workDir: string, relPath: string, newContent: string, opts?: WriteOptions): ProjectFileContent;
+//# sourceMappingURL=project-files.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-files.d.ts","sourceRoot":"","sources":["../src/project-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAcH,eAAO,MAAM,sBAAsB,qGAKzB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAEjC,MAAM,EAAE,MAAM;IAEd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,MAAM,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAK3C;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAE3E;AA8CD,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAmCpE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAmBpF;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,YAAiB,GACtB,kBAAkB,CA6DpB"}

package/dist/project-files.js

@@ -0,0 +1,214 @@
+/**
+ * Project files endpoint helpers.
+ *
+ * Surfaces a fixed whitelist of files inside a project's `workDir` (CLAUDE.md
+ * and .claude/settings*.json) so the UI can read/write them without giving
+ * blanket FS access.
+ *
+ * Why a hard-coded whitelist (no globs in P1):
+ *   The Claude CLI auto-loads exactly these paths from cwd. Limiting to the
+ *   exact set lets us audit every read/write and rules out mistakes like a
+ *   user typing `relPath=../../etc/passwd` or `.git/config`. Phase 2 may add
+ *   `.claude/rules/*.md`, which will require a careful prefix-glob design.
+ *
+ * Defense-in-depth path checks:
+ *   1. relPath must be in WHITELIST (exact string match)
+ *   2. Resolved absolute path must live under realpath(workDir)
+ *   3. realpath() resolves symlinks, so a symlink inside .claude/ that
+ *      points outside workDir is still rejected by check (2).
+ */
+import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, statSync, writeFileSync, } from "node:fs";
+import { createHash, randomBytes } from "node:crypto";
+import { dirname, join, sep } from "node:path";
+export const PROJECT_FILE_WHITELIST = [
+    "CLAUDE.md",
+    ".claude/CLAUDE.md",
+    ".claude/settings.json",
+    ".claude/settings.local.json",
+];
+export class ProjectFilesError extends Error {
+    status;
+    details;
+    constructor(status, message, details) {
+        super(message);
+        this.status = status;
+        this.details = details;
+        this.name = "ProjectFilesError";
+    }
+}
+/** Type guard — narrows an arbitrary string to the whitelist union. */
+export function isWhitelistedRelPath(rel) {
+    return PROJECT_FILE_WHITELIST.includes(rel);
+}
+/**
+ * Resolve `relPath` against `workDir` and verify the result is still inside
+ * workDir even after symlink resolution. Throws ProjectFilesError on any
+ * violation. Returns the absolute path (which may not exist yet — caller
+ * decides whether absence is OK).
+ */
+function resolveSafe(workDir, relPath) {
+    // workDir itself must exist for any of this to make sense.
+    let workDirReal;
+    try {
+        workDirReal = realpathSync(workDir);
+    }
+    catch {
+        throw new ProjectFilesError(404, "workDir does not exist on disk");
+    }
+    const candidate = join(workDirReal, relPath);
+    // For an existing file, realpath the file. For a not-yet-existing file,
+    // realpath the *parent* (which we may need to mkdir later) — this still
+    // catches symlink escapes from intermediate components.
+    let probe;
+    if (existsSync(candidate)) {
+        probe = realpathSync(candidate);
+    }
+    else {
+        // Walk up to the first existing ancestor and realpath it; that's enough
+        // to ensure we won't end up writing outside workDir even after rename().
+        let parent = dirname(candidate);
+        while (!existsSync(parent))
+            parent = dirname(parent);
+        probe = realpathSync(parent);
+    }
+    if (probe !== workDirReal && !probe.startsWith(workDirReal + sep)) {
+        throw new ProjectFilesError(403, "Path resolves outside workDir", {
+            relPath,
+        });
+    }
+    return candidate;
+}
+function computeEtag(content) {
+    return createHash("sha256").update(content).digest("hex").slice(0, 12);
+}
+/** List the whitelist with stat info for present files. Never throws. */
+export function listProjectFiles(workDir) {
+    const out = [];
+    for (const rel of PROJECT_FILE_WHITELIST) {
+        let abs;
+        try {
+            abs = resolveSafe(workDir, rel);
+        }
+        catch {
+            // workDir missing or path escape — surface as "not exists" rather than
+            // erroring the whole list call (e.g. a project whose workDir was deleted
+            // on disk should still be navigable).
+            out.push({ relPath: rel, exists: false, loadedByCli: true });
+            continue;
+        }
+        if (!existsSync(abs)) {
+            out.push({ relPath: rel, exists: false, loadedByCli: true });
+            continue;
+        }
+        try {
+            const st = statSync(abs);
+            if (!st.isFile()) {
+                out.push({ relPath: rel, exists: false, loadedByCli: true });
+                continue;
+            }
+            out.push({
+                relPath: rel,
+                exists: true,
+                size: st.size,
+                mtime: st.mtime.getTime(),
+                loadedByCli: true,
+            });
+        }
+        catch {
+            out.push({ relPath: rel, exists: false, loadedByCli: true });
+        }
+    }
+    return out;
+}
+/**
+ * Read a whitelisted file. Returns content="" + etag of empty string when
+ * the file does not exist, so the editor UI can populate a blank textarea
+ * with a valid etag for first-write conflict detection.
+ */
+export function readProjectFile(workDir, relPath) {
+    if (!isWhitelistedRelPath(relPath)) {
+        throw new ProjectFilesError(400, "relPath not in whitelist", { relPath });
+    }
+    const abs = resolveSafe(workDir, relPath);
+    if (!existsSync(abs)) {
+        return { relPath, content: "", mtime: 0, etag: computeEtag("") };
+    }
+    const st = statSync(abs);
+    if (!st.isFile()) {
+        throw new ProjectFilesError(400, "Path is not a regular file", { relPath });
+    }
+    const content = readFileSync(abs, "utf-8");
+    return {
+        relPath,
+        content,
+        mtime: st.mtime.getTime(),
+        etag: computeEtag(content),
+    };
+}
+/**
+ * Atomic write: validates JSON syntax for `.json` files, ensures parent
+ * `.claude/` exists, writes to a tmp sibling, then renames. Returns the
+ * post-write content snapshot. On etag mismatch throws 409 with the current
+ * server-side content so the UI can render a 3-way diff.
+ */
+export function writeProjectFile(workDir, relPath, newContent, opts = {}) {
+    if (!isWhitelistedRelPath(relPath)) {
+        throw new ProjectFilesError(400, "relPath not in whitelist", { relPath });
+    }
+    // Optimistic-concurrency check happens BEFORE any FS mutation.
+    if (opts.ifMatchEtag !== undefined) {
+        const current = readProjectFile(workDir, relPath);
+        if (current.etag !== opts.ifMatchEtag) {
+            throw new ProjectFilesError(409, "etag mismatch", {
+                relPath,
+                currentEtag: current.etag,
+                currentContent: current.content,
+                currentMtime: current.mtime,
+            });
+        }
+    }
+    // Validate JSON before touching disk so we never leave broken settings.json.
+    if (relPath.endsWith(".json")) {
+        if (newContent.trim().length === 0) {
+            // Empty JSON → store as `{}` so the file remains valid for CLI consumers.
+            newContent = "{}\n";
+        }
+        else {
+            try {
+                JSON.parse(newContent);
+            }
+            catch (err) {
+                throw new ProjectFilesError(400, "Invalid JSON", {
+                    relPath,
+                    parseError: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    else if (relPath.endsWith(".md")) {
+        // Ensure trailing newline — POSIX text-file convention; avoids editors
+        // appending a newline on next manual edit and producing spurious diffs.
+        if (newContent.length > 0 && !newContent.endsWith("\n")) {
+            newContent = newContent + "\n";
+        }
+    }
+    const abs = resolveSafe(workDir, relPath);
+    const parent = dirname(abs);
+    if (!existsSync(parent)) {
+        mkdirSync(parent, { recursive: true });
+    }
+    // tmp file lives in the same directory so rename() is atomic on the same FS.
+    // randomBytes avoids collisions if two writes race; the loser gets EEXIST on
+    // its own tmp (very unlikely) and retries via the API layer.
+    const tmp = join(parent, `.${randomBytes(6).toString("hex")}.tmp`);
+    writeFileSync(tmp, newContent, "utf-8");
+    renameSync(tmp, abs);
+    const st = statSync(abs);
+    return {
+        relPath,
+        content: newContent,
+        mtime: st.mtime.getTime(),
+        etag: computeEtag(newContent),
+    };
+}
+//# sourceMappingURL=project-files.js.map

package/dist/project-files.js.map

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

package/dist/projects-fs.d.ts

@@ -0,0 +1,28 @@
+export type TaskStatus = "pending" | "in_progress" | "completed" | "cancelled";
+export interface TaskCounts {
+    pending: number;
+    in_progress: number;
+    completed: number;
+    cancelled: number;
+}
+export interface ProjectSummary {
+    encodedCwd: string;
+    workDir: string;
+    createdAt: string | null;
+    swarmCount: number;
+    taskCount: number;
+    taskCounts: TaskCounts;
+}
+export interface SwarmSummary {
+    swarmId: string;
+    teamName: string;
+    status: string;
+    roleCount: number;
+    savedAt: number | null;
+}
+export declare function listProjectDirs(home?: string): string[];
+export declare function resolveWorkDir(home: string, encodedCwd: string): string | null;
+export declare function loadProjectSummary(home: string, encodedCwd: string): ProjectSummary | null;
+export declare function loadSwarmSummaries(home: string, workDir: string): SwarmSummary[];
+export declare function listAllProjectSummaries(home?: string): ProjectSummary[];
+//# sourceMappingURL=projects-fs.d.ts.map

package/dist/projects-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects-fs.d.ts","sourceRoot":"","sources":["../src/projects-fs.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,CAAC;AAC/E,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,UAAU,CAAC;CACxB;AACD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAkBD,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAMvD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY9E;AAiBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAkB1F;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAiBhF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CAKvE"}

package/dist/projects-fs.js

@@ -0,0 +1,111 @@
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { TaskStore, projectRoot } from "@mclawnet/task";
+import { loadSwarmSnapshot } from "./persistence.js";
+function getHome(homeOverride) {
+    return homeOverride ?? process.env.CLAWNET_HOME ?? homedir();
+}
+function projectsDir(home) {
+    return join(home, ".clawnet", "projects");
+}
+function isSafeEncoded(encoded) {
+    if (!encoded)
+        return false;
+    if (encoded.includes("/") || encoded.includes("\\"))
+        return false;
+    if (encoded.includes("\0"))
+        return false;
+    if (encoded === "." || encoded === ".." || encoded.includes(".."))
+        return false;
+    return true;
+}
+export function listProjectDirs(home) {
+    const dir = projectsDir(getHome(home));
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name);
+}
+export function resolveWorkDir(home, encodedCwd) {
+    if (!isSafeEncoded(encodedCwd))
+        return null;
+    const dirs = listProjectDirs(home);
+    if (!dirs.includes(encodedCwd))
+        return null;
+    const metaPath = join(projectsDir(home), encodedCwd, "meta.json");
+    if (!existsSync(metaPath))
+        return null;
+    try {
+        const meta = JSON.parse(readFileSync(metaPath, "utf-8"));
+        return typeof meta.workDir === "string" ? meta.workDir : null;
+    }
+    catch {
+        return null;
+    }
+}
+function readMetaCreatedAt(home, encodedCwd) {
+    const metaPath = join(projectsDir(home), encodedCwd, "meta.json");
+    if (!existsSync(metaPath))
+        return null;
+    try {
+        const meta = JSON.parse(readFileSync(metaPath, "utf-8"));
+        return meta.createdAt ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function emptyCounts() {
+    return { pending: 0, in_progress: 0, completed: 0, cancelled: 0 };
+}
+export function loadProjectSummary(home, encodedCwd) {
+    const workDir = resolveWorkDir(home, encodedCwd);
+    if (!workDir)
+        return null;
+    const store = new TaskStore({ workDir, home });
+    const tasks = store.list();
+    const counts = emptyCounts();
+    for (const t of tasks) {
+        if (t.status in counts)
+            counts[t.status] += 1;
+    }
+    const swarms = loadSwarmSummaries(home, workDir);
+    return {
+        encodedCwd,
+        workDir,
+        createdAt: readMetaCreatedAt(home, encodedCwd),
+        swarmCount: swarms.length,
+        taskCount: tasks.length,
+        taskCounts: counts,
+    };
+}
+export function loadSwarmSummaries(home, workDir) {
+    const swarmsRoot = join(projectRoot(workDir, home), "swarms");
+    if (!existsSync(swarmsRoot))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(swarmsRoot, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const snap = loadSwarmSnapshot(workDir, entry.name);
+        if (!snap)
+            continue;
+        out.push({
+            swarmId: snap.id,
+            teamName: snap.teamName,
+            status: snap.status ?? "unknown",
+            roleCount: snap.roles?.length ?? 0,
+            savedAt: snap.savedAt ?? null,
+        });
+    }
+    return out;
+}
+export function listAllProjectSummaries(home) {
+    const h = getHome(home);
+    return listProjectDirs(h)
+        .map((e) => loadProjectSummary(h, e))
+        .filter((s) => !!s);
+}
+//# sourceMappingURL=projects-fs.js.map

package/dist/projects-fs.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mclawnet/swarm",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "type": "module",
   "exports": {
     ".": {
@@ -19,10 +19,10 @@
   "dependencies": {
     "proper-lockfile": "^4.1.2",
     "@mclawnet/logger": "0.1.6",
+    "@mclawnet/memory": "0.1.5",
     "@mclawnet/skill-manager": "0.1.4",
-    "@mclawnet/task": "0.1.1",
-    "@mclawnet/shared": "0.1.3",
-    "@mclawnet/memory": "0.1.5"
+    "@mclawnet/shared": "0.1.4",
+    "@mclawnet/task": "0.1.1"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7",