superskill 0.2.0

package/dist/lib/search-engine.test.js

@@ -0,0 +1,120 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdir, writeFile, rm } from "fs/promises";
+import { tmpdir } from "os";
+import { join } from "path";
+import { searchText, searchStructured } from "./search-engine.js";
+describe("search-engine", () => {
+    let vaultRoot;
+    beforeEach(async () => {
+        vaultRoot = join(tmpdir(), `search-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        await mkdir(vaultRoot, { recursive: true });
+    });
+    afterEach(async () => {
+        await rm(vaultRoot, { recursive: true, force: true });
+    });
+    describe("searchText", () => {
+        beforeEach(async () => {
+            await writeFile(join(vaultRoot, "doc1.md"), "# Hello World\n\nThis is a test document.");
+            await writeFile(join(vaultRoot, "doc2.md"), "# Another Doc\n\nNo matching content here.");
+            await mkdir(join(vaultRoot, "subdir"), { recursive: true });
+            await writeFile(join(vaultRoot, "subdir/nested.md"), "# Nested Hello\n\nHello from nested path.");
+            await mkdir(join(vaultRoot, ".obsidian"), { recursive: true });
+            await writeFile(join(vaultRoot, ".obsidian/config"), "hello in hidden");
+        });
+        it("finds matching documents", async () => {
+            const results = await searchText(vaultRoot, "Hello");
+            expect(results.length).toBeGreaterThan(0);
+            expect(results.some(r => r.path === "doc1.md")).toBe(true);
+        });
+        it("is case insensitive", async () => {
+            const results = await searchText(vaultRoot, "HELLO");
+            expect(results.length).toBeGreaterThan(0);
+        });
+        it("respects limit parameter", async () => {
+            const results = await searchText(vaultRoot, "Hello", { limit: 1 });
+            expect(results.length).toBeLessThanOrEqual(1);
+        });
+        it("filters by path", async () => {
+            const results = await searchText(vaultRoot, "Hello", { pathFilter: "subdir" });
+            expect(results.every(r => r.path.startsWith("subdir"))).toBe(true);
+        });
+        it("excludes hidden directories", async () => {
+            const results = await searchText(vaultRoot, "hello");
+            expect(results.every(r => !r.path.startsWith(".obsidian"))).toBe(true);
+        });
+        it("returns empty array for no matches", async () => {
+            const results = await searchText(vaultRoot, "zzzznomatchxxxx");
+            expect(results).toEqual([]);
+        });
+        it("rejects traversal attack in pathFilter", async () => {
+            await expect(searchText(vaultRoot, "test", { pathFilter: "../outside" })).rejects.toThrow();
+        });
+        it("rejects absolute path in pathFilter", async () => {
+            await expect(searchText(vaultRoot, "test", { pathFilter: "/etc/passwd" })).rejects.toThrow();
+        });
+        it("returns path, snippet, and line number", async () => {
+            const results = await searchText(vaultRoot, "World");
+            expect(results.length).toBeGreaterThan(0);
+            expect(results[0].path).toBeDefined();
+            expect(results[0].snippet).toBeDefined();
+            expect(results[0].line).toBeGreaterThan(0);
+        });
+        it("handles special regex characters safely", async () => {
+            await writeFile(join(vaultRoot, "special.md"), "Content with $pecial ch@rs");
+            const results = await searchText(vaultRoot, "$pecial");
+            expect(results.length).toBeGreaterThan(0);
+        });
+    });
+    describe("searchStructured", () => {
+        beforeEach(async () => {
+            await writeFile(join(vaultRoot, "task1.md"), "---\ntype: task\nstatus: in-progress\nproject: test-project\ntags:\n  - urgent\n  - backend\n---\n\n# Task 1\n\nTask one content.");
+            await writeFile(join(vaultRoot, "task2.md"), "---\ntype: task\nstatus: done\nproject: other-project\ntags:\n  - frontend\n---\n\n# Task 2\n\nTask two content.");
+            await writeFile(join(vaultRoot, "note.md"), "---\ntype: index\n---\n\n# Note\n\nJust a note.");
+        });
+        it("filters by single frontmatter field", async () => {
+            const results = await searchStructured(vaultRoot, { type: "task" });
+            expect(results.length).toBe(2);
+        });
+        it("filters by multiple fields", async () => {
+            const results = await searchStructured(vaultRoot, { type: "task", status: "done" });
+            expect(results.length).toBe(1);
+            expect(results[0].path).toBe("task2.md");
+        });
+        it("filters by array field value", async () => {
+            const results = await searchStructured(vaultRoot, { tags: "urgent" });
+            expect(results.length).toBe(1);
+            expect(results[0].path).toBe("task1.md");
+        });
+        it("respects limit parameter", async () => {
+            const results = await searchStructured(vaultRoot, { type: "task" }, { limit: 1 });
+            expect(results.length).toBeLessThanOrEqual(1);
+        });
+        it("returns empty array for no matches", async () => {
+            const results = await searchStructured(vaultRoot, { type: "nonexistent" });
+            expect(results).toEqual([]);
+        });
+        it("excludes hidden directories", async () => {
+            await mkdir(join(vaultRoot, ".hidden"), { recursive: true });
+            await writeFile(join(vaultRoot, ".hidden/secret.md"), "---\ntype: secret\n---\n\n# Secret");
+            const results = await searchStructured(vaultRoot, { type: "secret" });
+            expect(results.every(r => !r.path.startsWith("."))).toBe(true);
+        });
+        it("returns path and snippet", async () => {
+            const results = await searchStructured(vaultRoot, { type: "task" });
+            expect(results.length).toBeGreaterThan(0);
+            expect(results[0].path).toBeDefined();
+            expect(results[0].snippet).toBeDefined();
+        });
+        it("handles files without frontmatter", async () => {
+            await writeFile(join(vaultRoot, "plain.md"), "Just plain text");
+            const results = await searchStructured(vaultRoot, { type: "task" });
+            expect(results.every(r => r.path !== "plain.md")).toBe(true);
+        });
+        it("handles malformed YAML gracefully", async () => {
+            await writeFile(join(vaultRoot, "bad.md"), "---\ninvalid: yaml: content\n---\n\n# Bad");
+            const results = await searchStructured(vaultRoot, { type: "task" });
+            expect(results.every(r => r.path !== "bad.md")).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=search-engine.test.js.map

package/dist/lib/search-engine.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-engine.test.js","sourceRoot":"","sources":["../../src/lib/search-engine.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAElE,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAI,SAAiB,CAAC;IAEtB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/F,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,UAAU,CAAC,KAAK,IAAI,EAAE;YACpB,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,2CAA2C,CAAC,CAAC;YACzF,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,4CAA4C,CAAC,CAAC;YAC1F,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,EAAE,2CAA2C,CAAC,CAAC;YAClG,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACxC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;YACnC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACxC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YACnE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iBAAiB,EAAE,KAAK,IAAI,EAAE;YAC/B,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC/E,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;YAC3C,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;YAClD,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;YAC/D,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;YACtD,MAAM,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC9F,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;YACnD,MAAM,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC/F,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;YACtD,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACtC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;YACzC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;YACvD,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,4BAA4B,CAAC,CAAC;YAC7E,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACvD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,UAAU,CAAC,KAAK,IAAI,EAAE;YACpB,MAAM,SAAS,CACb,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAC3B,mIAAmI,CACpI,CAAC;YACF,MAAM,SAAS,CACb,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAC3B,kHAAkH,CACnH,CAAC;YACF,MAAM,SAAS,CACb,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,EAC1B,iDAAiD,CAClD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;YACnD,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACpE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;YAC1C,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACpF,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;YAC5C,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACxC,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAClF,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;YAClD,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;YAC3E,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;YAC3C,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,MAAM,SAAS,CACb,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,EACpC,oCAAoC,CACrC,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACxC,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACpE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACtC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,iBAAiB,CAAC,CAAC;YAChE,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACpE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,2CAA2C,CAAC,CAAC;YACxF,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACpE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/session-registry.d.ts

@@ -0,0 +1,59 @@
+export interface Session {
+    id: string;
+    tool: string;
+    project: string | null;
+    task_summary: string | null;
+    files_touched: string[];
+    started_at: string;
+    last_heartbeat: string;
+    completed_at: string | null;
+    status: "active" | "stale" | "completed";
+}
+export interface SessionRegistry {
+    sessions: Session[];
+}
+interface Conflict {
+    session_id: string;
+    tool: string;
+    overlapping_files: string[];
+    task_summary: string | null;
+}
+/**
+ * Manages the session registry for multi-agent coordination.
+ * Uses PID lockfiles for safe concurrent access.
+ */
+export declare class SessionRegistryManager {
+    private readonly ttlHours;
+    private readonly registryPath;
+    private readonly locksDir;
+    constructor(vaultPath: string, ttlHours: number);
+    /**
+     * Register a new session. Returns session ID and any conflicts.
+     */
+    register(tool: string, project: string | null, taskSummary?: string | null, filesTouched?: string[]): Promise<{
+        session_id: string;
+        conflicts: Conflict[];
+    }>;
+    /**
+     * Update heartbeat for a session. Returns false if session not found.
+     */
+    heartbeat(sessionId: string): Promise<boolean>;
+    /**
+     * Mark a session as completed.
+     */
+    complete(sessionId: string, summary?: string): Promise<void>;
+    /**
+     * List active sessions. Persists stale status changes.
+     */
+    listActive(): Promise<Session[]>;
+    private cleanOldCompleted;
+    private cleanStale;
+    private readRegistry;
+    private writeRegistry;
+    /**
+     * PID-based lockfile for safe concurrent writes.
+     * Times out after 2 seconds with retry.
+     */
+    private withLock;
+}
+export {};

package/dist/lib/session-registry.js

@@ -0,0 +1,231 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later OR Commercial
+import { readFile, writeFile, mkdir, unlink, stat, open } from "fs/promises";
+import { resolve, dirname } from "path";
+import { randomBytes } from "crypto";
+/**
+ * Manages the session registry for multi-agent coordination.
+ * Uses PID lockfiles for safe concurrent access.
+ */
+export class SessionRegistryManager {
+    ttlHours;
+    registryPath;
+    locksDir;
+    constructor(vaultPath, ttlHours) {
+        this.ttlHours = ttlHours;
+        this.registryPath = resolve(vaultPath, "coordination/session-registry.json");
+        this.locksDir = resolve(vaultPath, "coordination/locks");
+    }
+    /**
+     * Register a new session. Returns session ID and any conflicts.
+     */
+    async register(tool, project, taskSummary = null, filesTouched = []) {
+        const sessionId = `${tool}-${randomBytes(4).toString("hex")}`;
+        const now = new Date().toISOString();
+        const session = {
+            id: sessionId,
+            tool,
+            project,
+            task_summary: taskSummary,
+            files_touched: filesTouched,
+            started_at: now,
+            last_heartbeat: now,
+            completed_at: null,
+            status: "active",
+        };
+        return await this.withLock(async () => {
+            const registry = await this.readRegistry();
+            this.cleanStale(registry);
+            this.cleanOldCompleted(registry);
+            // Detect conflicts (use Set for O(n+m) intersection)
+            const conflicts = [];
+            if (filesTouched.length > 0) {
+                const touchedSet = new Set(filesTouched);
+                for (const existing of registry.sessions) {
+                    if (existing.status !== "active")
+                        continue;
+                    const overlap = existing.files_touched.filter((f) => touchedSet.has(f));
+                    if (overlap.length > 0) {
+                        conflicts.push({
+                            session_id: existing.id,
+                            tool: existing.tool,
+                            overlapping_files: overlap,
+                            task_summary: existing.task_summary,
+                        });
+                    }
+                }
+            }
+            registry.sessions.push(session);
+            await this.writeRegistry(registry);
+            return { session_id: sessionId, conflicts };
+        });
+    }
+    /**
+     * Update heartbeat for a session. Returns false if session not found.
+     */
+    async heartbeat(sessionId) {
+        return await this.withLock(async () => {
+            const registry = await this.readRegistry();
+            const session = registry.sessions.find((s) => s.id === sessionId);
+            if (!session)
+                return false;
+            session.last_heartbeat = new Date().toISOString();
+            await this.writeRegistry(registry);
+            return true;
+        });
+    }
+    /**
+     * Mark a session as completed.
+     */
+    async complete(sessionId, summary) {
+        await this.withLock(async () => {
+            const registry = await this.readRegistry();
+            const session = registry.sessions.find((s) => s.id === sessionId);
+            if (session) {
+                session.status = "completed";
+                session.completed_at = new Date().toISOString();
+                if (summary)
+                    session.task_summary = summary;
+            }
+            this.cleanOldCompleted(registry);
+            await this.writeRegistry(registry);
+        });
+    }
+    /**
+     * List active sessions. Persists stale status changes.
+     */
+    async listActive() {
+        return await this.withLock(async () => {
+            const registry = await this.readRegistry();
+            const hadStale = this.cleanStale(registry);
+            if (hadStale) {
+                await this.writeRegistry(registry);
+            }
+            return registry.sessions.filter((s) => s.status === "active");
+        });
+    }
+    cleanOldCompleted(registry) {
+        const cutoff = Date.now() - 24 * 60 * 60 * 1000;
+        registry.sessions = registry.sessions.filter((s) => {
+            if (s.status !== "completed")
+                return true;
+            const ts = s.completed_at ?? s.started_at;
+            if (typeof ts !== "string")
+                return false;
+            const time = new Date(ts).getTime();
+            return !isNaN(time) && time > cutoff;
+        });
+    }
+    cleanStale(registry) {
+        let changed = false;
+        const cutoff = Date.now() - this.ttlHours * 60 * 60 * 1000;
+        for (const session of registry.sessions) {
+            if (session.status === "active" &&
+                new Date(session.last_heartbeat).getTime() < cutoff) {
+                session.status = "stale";
+                changed = true;
+            }
+        }
+        return changed;
+    }
+    async readRegistry() {
+        try {
+            const raw = await readFile(this.registryPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            // Schema validation: ensure sessions is an array of valid objects
+            if (!parsed || !Array.isArray(parsed.sessions)) {
+                return { sessions: [] };
+            }
+            // Filter out malformed entries
+            const validSessions = parsed.sessions.filter((s) => typeof s === "object" &&
+                s !== null &&
+                typeof s.id === "string" &&
+                typeof s.tool === "string" &&
+                typeof s.status === "string" &&
+                typeof s.started_at === "string" &&
+                typeof s.last_heartbeat === "string" &&
+                !isNaN(new Date(s.last_heartbeat).getTime()) &&
+                Array.isArray(s.files_touched));
+            return { sessions: validSessions };
+        }
+        catch (e) {
+            if (e?.code !== "ENOENT") {
+                console.error("[session-registry] Error reading registry:", e.message);
+            }
+            return { sessions: [] };
+        }
+    }
+    async writeRegistry(registry) {
+        await mkdir(dirname(this.registryPath), { recursive: true });
+        await writeFile(this.registryPath, JSON.stringify(registry, null, 2), "utf-8");
+    }
+    /**
+     * PID-based lockfile for safe concurrent writes.
+     * Times out after 2 seconds with retry.
+     */
+    async withLock(fn) {
+        const lockPath = resolve(this.locksDir, "session-registry.lock");
+        await mkdir(this.locksDir, { recursive: true });
+        const maxRetries = 8;
+        const retryDelay = 100;
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            try {
+                const lockContent = JSON.stringify({
+                    pid: process.pid,
+                    tool: "superskill",
+                    timestamp: new Date().toISOString(),
+                });
+                const fd = await open(lockPath, "wx");
+                try {
+                    await fd.write(Buffer.from(lockContent, "utf-8"));
+                }
+                finally {
+                    await fd.close();
+                }
+                // Lock acquired — run the function
+                try {
+                    return await fn();
+                }
+                finally {
+                    await unlink(lockPath).catch(() => { });
+                }
+            }
+            catch (e) {
+                if (e.code === "EEXIST") {
+                    // Lock exists — check if it's stale
+                    try {
+                        const lockStat = await stat(lockPath);
+                        const lockAge = Date.now() - lockStat.mtimeMs;
+                        if (lockAge > 5000) {
+                            // Lock is stale (>5s), force remove
+                            await unlink(lockPath).catch(() => { });
+                            continue;
+                        }
+                        // Lock is fresh — check if PID is alive
+                        const lockData = JSON.parse(await readFile(lockPath, "utf-8"));
+                        try {
+                            process.kill(lockData.pid, 0);
+                            // PID is alive — wait and retry
+                        }
+                        catch {
+                            // PID is dead — remove stale lock
+                            await unlink(lockPath).catch(() => { });
+                            continue;
+                        }
+                    }
+                    catch {
+                        // Can't read lock — try to remove it
+                        await unlink(lockPath).catch(() => { });
+                        continue;
+                    }
+                    // Wait before retrying
+                    await new Promise((r) => setTimeout(r, retryDelay));
+                }
+                else {
+                    throw e;
+                }
+            }
+        }
+        throw new Error("Failed to acquire lock after retries");
+    }
+}
+//# sourceMappingURL=session-registry.js.map

package/dist/lib/session-registry.js.map

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

package/dist/lib/session-registry.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/session-registry.test.js

@@ -0,0 +1,199 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdir, writeFile as fspWriteFile, rm, readFile as fspReadFile } from "fs/promises";
+import { tmpdir } from "os";
+import { join } from "path";
+import { SessionRegistryManager } from "./session-registry.js";
+describe("SessionRegistryManager", () => {
+    let vaultRoot;
+    let manager;
+    beforeEach(async () => {
+        vaultRoot = join(tmpdir(), `session-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        await mkdir(vaultRoot, { recursive: true });
+        manager = new SessionRegistryManager(vaultRoot, 1);
+    });
+    afterEach(async () => {
+        await rm(vaultRoot, { recursive: true, force: true });
+    });
+    describe("register", () => {
+        it("creates session with generated ID", async () => {
+            const result = await manager.register("claude-code", "test-project");
+            expect(result.session_id).toMatch(/^claude-code-[a-f0-9]{8}$/);
+        });
+        it("creates session with all fields", async () => {
+            const result = await manager.register("opencode", "my-project", "Doing work", ["file1.ts", "file2.ts"]);
+            expect(result.session_id).toMatch(/^opencode-/);
+        });
+        it("detects file conflicts", async () => {
+            await manager.register("claude-code", "proj", "Task 1", ["a.ts", "b.ts"]);
+            const result = await manager.register("opencode", "proj", "Task 2", ["b.ts", "c.ts"]);
+            expect(result.conflicts.length).toBe(1);
+            expect(result.conflicts[0].overlapping_files).toContain("b.ts");
+        });
+        it("returns empty conflicts when no overlap", async () => {
+            await manager.register("claude-code", "proj", "Task 1", ["a.ts"]);
+            const result = await manager.register("opencode", "proj", "Task 2", ["b.ts"]);
+            expect(result.conflicts).toEqual([]);
+        });
+        it("returns empty conflicts when first session has no files", async () => {
+            await manager.register("claude-code", "proj", "Task 1", []);
+            const result = await manager.register("opencode", "proj", "Task 2", ["b.ts"]);
+            expect(result.conflicts).toEqual([]);
+        });
+        it("cleans stale sessions on register", async () => {
+            const oldManager = new SessionRegistryManager(vaultRoot, 0);
+            await oldManager.register("claude-code", "proj", "Old session");
+            await new Promise(r => setTimeout(r, 10));
+            const newManager = new SessionRegistryManager(vaultRoot, 0.000001);
+            await newManager.register("opencode", "proj", "New session");
+            const active = await newManager.listActive();
+            expect(active.every(s => s.status === "active")).toBe(true);
+        });
+        it("persists session to registry file", async () => {
+            await manager.register("claude-code", "test-project");
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            const raw = await fspReadFile(registryPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            expect(parsed.sessions.length).toBe(1);
+            expect(parsed.sessions[0].tool).toBe("claude-code");
+        });
+    });
+    describe("heartbeat", () => {
+        it("updates heartbeat timestamp", async () => {
+            const { session_id } = await manager.register("claude-code", "proj");
+            await new Promise(r => setTimeout(r, 10));
+            const result = await manager.heartbeat(session_id);
+            expect(result).toBe(true);
+        });
+        it("returns false for missing session", async () => {
+            const result = await manager.heartbeat("nonexistent-id");
+            expect(result).toBe(false);
+        });
+        it("persists heartbeat to file", async () => {
+            const { session_id } = await manager.register("claude-code", "proj");
+            await manager.heartbeat(session_id);
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            const raw = await fspReadFile(registryPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            const session = parsed.sessions.find((s) => s.id === session_id);
+            expect(session.last_heartbeat).toBeDefined();
+        });
+    });
+    describe("complete", () => {
+        it("marks session as completed", async () => {
+            const { session_id } = await manager.register("claude-code", "proj");
+            await manager.complete(session_id);
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            const raw = await fspReadFile(registryPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            const session = parsed.sessions.find((s) => s.id === session_id);
+            expect(session.status).toBe("completed");
+            expect(session.completed_at).toBeDefined();
+        });
+        it("updates task summary when provided", async () => {
+            const { session_id } = await manager.register("claude-code", "proj", "Old summary");
+            await manager.complete(session_id, "New summary");
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            const raw = await fspReadFile(registryPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            const session = parsed.sessions.find((s) => s.id === session_id);
+            expect(session.task_summary).toBe("New summary");
+        });
+        it("removes old completed sessions", async () => {
+            const { session_id } = await manager.register("claude-code", "proj");
+            await manager.complete(session_id);
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            let raw = await fspReadFile(registryPath, "utf-8");
+            let parsed = JSON.parse(raw);
+            const session = parsed.sessions.find((s) => s.id === session_id);
+            session.completed_at = new Date(Date.now() - 25 * 60 * 60 * 1000).toISOString();
+            await fspWriteFile(registryPath, JSON.stringify(parsed));
+            await manager.register("opencode", "proj");
+            raw = await fspReadFile(registryPath, "utf-8");
+            parsed = JSON.parse(raw);
+            expect(parsed.sessions.find((s) => s.id === session_id)).toBeUndefined();
+        });
+    });
+    describe("listActive", () => {
+        it("returns only active sessions", async () => {
+            const { session_id } = await manager.register("claude-code", "proj");
+            await manager.register("opencode", "proj2");
+            await manager.complete(session_id);
+            const active = await manager.listActive();
+            expect(active.length).toBe(1);
+            expect(active[0].tool).toBe("opencode");
+        });
+        it("returns empty array when no active sessions", async () => {
+            const active = await manager.listActive();
+            expect(active).toEqual([]);
+        });
+        it("persists stale status changes", async () => {
+            const staleManager = new SessionRegistryManager(vaultRoot, 0.000001);
+            await staleManager.register("claude-code", "proj");
+            await new Promise(r => setTimeout(r, 20));
+            const active = await staleManager.listActive();
+            expect(active).toEqual([]);
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            const raw = await fspReadFile(registryPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            expect(parsed.sessions[0].status).toBe("stale");
+        });
+    });
+    describe("withLock", () => {
+        it("prevents concurrent access", async () => {
+            const promises = [];
+            for (let i = 0; i < 5; i++) {
+                promises.push(manager.register(`tool-${i}`, "proj"));
+            }
+            const results = await Promise.all(promises);
+            expect(results.every(r => r.session_id)).toBe(true);
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            const raw = await fspReadFile(registryPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            expect(parsed.sessions.length).toBe(5);
+        });
+        it("removes stale locks", async () => {
+            const locksDir = join(vaultRoot, "coordination/locks");
+            await mkdir(locksDir, { recursive: true });
+            const lockPath = join(locksDir, "session-registry.lock");
+            await fspWriteFile(lockPath, JSON.stringify({ pid: 999999999, timestamp: new Date().toISOString() }));
+            const { session_id } = await manager.register("claude-code", "proj");
+            expect(session_id).toBeDefined();
+        });
+    });
+    describe("readRegistry validation", () => {
+        it("handles malformed session entries", async () => {
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            await mkdir(join(vaultRoot, "coordination"), { recursive: true });
+            const now = new Date().toISOString();
+            const malformedData = {
+                sessions: [
+                    { id: "valid-1", tool: "test", status: "active", started_at: now, last_heartbeat: now, files_touched: [] },
+                    { id: 123, tool: "bad" },
+                    null,
+                    "string not object",
+                    { id: "valid-2", tool: "test", status: "active", started_at: "bad-date", last_heartbeat: "2024-01-01T00:00:00Z", files_touched: [] },
+                ]
+            };
+            await fspWriteFile(registryPath, JSON.stringify(malformedData));
+            const active = await manager.listActive();
+            const validIds = active.map(s => s.id);
+            expect(validIds).toContain("valid-1");
+            expect(validIds).not.toContain("valid-2");
+        });
+        it("handles non-array sessions field", async () => {
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            await mkdir(join(vaultRoot, "coordination"), { recursive: true });
+            await fspWriteFile(registryPath, JSON.stringify({ sessions: "not-an-array" }));
+            const active = await manager.listActive();
+            expect(active).toEqual([]);
+        });
+        it("handles missing sessions field", async () => {
+            const registryPath = join(vaultRoot, "coordination/session-registry.json");
+            await mkdir(join(vaultRoot, "coordination"), { recursive: true });
+            await fspWriteFile(registryPath, JSON.stringify({}));
+            const active = await manager.listActive();
+            expect(active).toEqual([]);
+        });
+    });
+});
+//# sourceMappingURL=session-registry.test.js.map