forked from farhoodlabs/paperclip
3c73ed26b5
## Thinking Path > - Paperclip orchestrates AI agents for zero-human companies > - The plugin system is the extension boundary for optional product capabilities > - Rich plugins need more than a worker entrypoint: they need scoped database storage, local project folders, managed agents/routines, host navigation, and reusable UI components > - The LLM Wiki work exposed those missing host surfaces while keeping plugin code outside the core control plane > - This pull request expands the core plugin host, SDK, server APIs, and UI bridge so plugins can declare and use those surfaces > - The benefit is that future plugins can integrate with Paperclip through documented, validated contracts instead of bespoke server or UI imports ## What Changed - Added plugin-managed database namespaces and migration tracking, including Drizzle schema/migration files and SQL validation for namespace isolation. - Added server support for plugin local folders, managed agents, managed routines, scoped plugin APIs, and plugin operation visibility. - Expanded shared plugin manifest/types/validators and SDK host/testing/UI exports for richer plugin surfaces. - Added reusable UI pieces for file trees, managed routines, resizable sidebars, route sidebars, and plugin bridge initialization. - Updated plugin docs and example plugins to use the expanded host and SDK surface. ## Verification - `pnpm install --frozen-lockfile` - `pnpm run preflight:workspace-links && pnpm exec vitest run packages/shared/src/validators/plugin.test.ts server/src/__tests__/plugin-database.test.ts server/src/__tests__/plugin-local-folders.test.ts server/src/__tests__/plugin-managed-agents.test.ts server/src/__tests__/plugin-managed-routines.test.ts server/src/__tests__/plugin-orchestration-apis.test.ts ui/src/api/plugins.test.ts ui/src/components/FileTree.test.tsx ui/src/components/ResizableSidebarPane.test.tsx ui/src/pages/PluginPage.test.tsx ui/src/plugins/bridge.test.ts` passed: 11 files, 67 tests. - Confirmed this PR changes 89 files and does not include `pnpm-lock.yaml` or `.github/workflows/*`. ## Risks - Medium: this expands plugin host contracts across db/shared/server/ui and includes a new core migration (`0076_useful_elektra.sql`). - The plugin database namespace validator is intentionally restrictive; plugin authors may need follow-up affordances for SQL patterns that remain blocked. - Merge this before the LLM Wiki plugin PR so the plugin can resolve the new SDK and host APIs. > For core feature work, check [`ROADMAP.md`](ROADMAP.md) first and discuss it in `#dev` before opening the PR. Feature PRs that overlap with planned core work may need to be redirected — check the roadmap first. See `CONTRIBUTING.md`. ## Model Used - OpenAI Codex, GPT-5 coding agent, tool-enabled shell/git/GitHub workflow. Context window size was not exposed by the runtime. ## Checklist - [x] I have included a thinking path that traces from project context to this change - [x] I have specified the model used (with version and capability details) - [x] I have checked ROADMAP.md and confirmed this PR does not duplicate planned core work - [x] I have run tests locally and they pass - [x] I have added or updated tests where applicable - [x] If this change affects the UI, I have included before/after screenshots - [x] I have updated relevant documentation to reflect my changes - [x] I have considered and documented any risks above - [x] I will address all Greptile and reviewer comments before requesting merge --------- Co-authored-by: Paperclip <noreply@paperclip.ing>
191 lines
5.1 KiB
TypeScript
191 lines
5.1 KiB
TypeScript
// @vitest-environment jsdom
|
|
|
|
import { act } from "react";
|
|
import { createRoot, type Root } from "react-dom/client";
|
|
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
|
|
import { FileTree, buildFileTree } from "./FileTree";
|
|
|
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
(globalThis as any).IS_REACT_ACT_ENVIRONMENT = true;
|
|
|
|
describe("FileTree", () => {
|
|
let container: HTMLDivElement;
|
|
let root: Root;
|
|
|
|
beforeEach(() => {
|
|
container = document.createElement("div");
|
|
document.body.appendChild(container);
|
|
root = createRoot(container);
|
|
});
|
|
|
|
afterEach(() => {
|
|
act(() => {
|
|
root.unmount();
|
|
});
|
|
container.remove();
|
|
});
|
|
|
|
function row(path: string) {
|
|
return container.querySelector(`[data-file-tree-path="${path}"]`) as HTMLDivElement | null;
|
|
}
|
|
|
|
it("selects file rows and expands directory rows", () => {
|
|
const onSelectFile = vi.fn();
|
|
const onToggleDir = vi.fn();
|
|
const nodes = buildFileTree({
|
|
"README.md": "",
|
|
"docs/guide.md": "",
|
|
});
|
|
|
|
act(() => {
|
|
root.render(
|
|
<FileTree
|
|
nodes={nodes}
|
|
selectedFile="README.md"
|
|
expandedDirs={new Set(["docs"])}
|
|
onSelectFile={onSelectFile}
|
|
onToggleDir={onToggleDir}
|
|
/>,
|
|
);
|
|
});
|
|
|
|
expect(row("README.md")?.getAttribute("aria-selected")).toBe("true");
|
|
|
|
act(() => {
|
|
row("docs/guide.md")?.click();
|
|
});
|
|
expect(onSelectFile).toHaveBeenCalledWith("docs/guide.md");
|
|
|
|
act(() => {
|
|
row("docs")?.click();
|
|
});
|
|
expect(onToggleDir).toHaveBeenCalledWith("docs");
|
|
});
|
|
|
|
it("marks partially selected directories as indeterminate", () => {
|
|
const nodes = buildFileTree({
|
|
"docs/a.md": "",
|
|
"docs/b.md": "",
|
|
});
|
|
|
|
act(() => {
|
|
root.render(
|
|
<FileTree
|
|
nodes={nodes}
|
|
selectedFile={null}
|
|
expandedDirs={new Set(["docs"])}
|
|
checkedFiles={new Set(["docs/a.md"])}
|
|
onSelectFile={() => {}}
|
|
onToggleDir={() => {}}
|
|
onToggleCheck={() => {}}
|
|
/>,
|
|
);
|
|
});
|
|
|
|
const input = row("docs")?.querySelector("input[type='checkbox']") as HTMLInputElement | null;
|
|
expect(input?.checked).toBe(false);
|
|
expect(input?.indeterminate).toBe(true);
|
|
expect(row("docs")?.getAttribute("aria-checked")).toBe("mixed");
|
|
});
|
|
|
|
it("renders file badges and host-only file extras", () => {
|
|
const nodes = buildFileTree({
|
|
"wiki/very-long-page-slug.md": "",
|
|
});
|
|
|
|
act(() => {
|
|
root.render(
|
|
<FileTree
|
|
nodes={nodes}
|
|
selectedFile={null}
|
|
expandedDirs={new Set(["wiki"])}
|
|
onSelectFile={() => {}}
|
|
onToggleDir={() => {}}
|
|
fileBadges={{
|
|
"wiki/very-long-page-slug.md": {
|
|
label: "fresh",
|
|
status: "ok",
|
|
tooltip: "Synced",
|
|
},
|
|
}}
|
|
renderFileExtra={(node) => (
|
|
node.kind === "file" ? <span data-testid="file-extra">{node.name.length} chars</span> : null
|
|
)}
|
|
/>,
|
|
);
|
|
});
|
|
|
|
expect(container.textContent).toContain("fresh");
|
|
expect(container.querySelector("[title='Synced']")).not.toBeNull();
|
|
expect(container.querySelector("[data-testid='file-extra']")?.textContent).toBe("22 chars");
|
|
});
|
|
|
|
it("wraps long labels by default and can opt back into truncation", () => {
|
|
const nodes = buildFileTree({
|
|
"wiki/extremely-long-page-slug-that-wraps-on-mobile.md": "",
|
|
});
|
|
|
|
act(() => {
|
|
root.render(
|
|
<FileTree
|
|
nodes={nodes}
|
|
selectedFile={null}
|
|
expandedDirs={new Set(["wiki"])}
|
|
onSelectFile={() => {}}
|
|
onToggleDir={() => {}}
|
|
/>,
|
|
);
|
|
});
|
|
|
|
expect(row("wiki/extremely-long-page-slug-that-wraps-on-mobile.md")?.innerHTML).toContain("break-all");
|
|
|
|
act(() => {
|
|
root.render(
|
|
<FileTree
|
|
nodes={nodes}
|
|
selectedFile={null}
|
|
expandedDirs={new Set(["wiki"])}
|
|
onSelectFile={() => {}}
|
|
onToggleDir={() => {}}
|
|
wrapLabels={false}
|
|
/>,
|
|
);
|
|
});
|
|
|
|
expect(row("wiki/extremely-long-page-slug-that-wraps-on-mobile.md")?.innerHTML).toContain("truncate");
|
|
});
|
|
|
|
it("supports tree keyboard expansion and checkbox toggling", () => {
|
|
const onToggleDir = vi.fn();
|
|
const onToggleCheck = vi.fn();
|
|
const nodes = buildFileTree({
|
|
"docs/a.md": "",
|
|
});
|
|
|
|
act(() => {
|
|
root.render(
|
|
<FileTree
|
|
nodes={nodes}
|
|
selectedFile={null}
|
|
expandedDirs={new Set()}
|
|
onSelectFile={() => {}}
|
|
onToggleDir={onToggleDir}
|
|
onToggleCheck={onToggleCheck}
|
|
/>,
|
|
);
|
|
});
|
|
|
|
const docsRow = row("docs");
|
|
act(() => {
|
|
docsRow?.focus();
|
|
docsRow?.dispatchEvent(new KeyboardEvent("keydown", { key: "ArrowRight", bubbles: true }));
|
|
});
|
|
expect(onToggleDir).toHaveBeenCalledWith("docs");
|
|
|
|
act(() => {
|
|
docsRow?.dispatchEvent(new KeyboardEvent("keydown", { key: " ", bubbles: true }));
|
|
});
|
|
expect(onToggleCheck).toHaveBeenCalledWith("docs", "dir");
|
|
});
|
|
});
|