@dyyz1993/create-agent 2.1.0 → 2.1.2

package/templates/cowork/src/shared/modules/file.ts

@@ -0,0 +1,40 @@
+/**
+ * File 模块 — 文件系统操作
+ */
+export interface FileMethods {
+  "file.findProjectRoot": {
+    params: Record<string, never>;
+    result: { path: string };
+  };
+  "file.listDir": {
+    params: { path: string };
+    result: {
+      entries: { name: string; path: string; type: "file" | "directory"; size?: number }[];
+      basePath: string;
+    };
+  };
+  "file.createFile": {
+    params: { dirPath: string; name: string };
+    result: { path: string };
+  };
+  "file.createDir": {
+    params: { dirPath: string; name: string };
+    result: { path: string };
+  };
+  "file.rename": {
+    params: { oldPath: string; newName: string };
+    result: { newPath: string };
+  };
+  "file.delete": {
+    params: { path: string };
+    result: { ok: boolean };
+  };
+  "file.copy": {
+    params: { srcPath: string; destDir: string };
+    result: { path: string };
+  };
+  "file.readFile": {
+    params: { path: string };
+    result: { content: string; size: number };
+  };
+}

package/templates/cowork/src/shared/modules/output.ts

@@ -0,0 +1,20 @@
+/**
+ * Output 模块 — 产出物管理（Artifacts）
+ */
+
+export interface Output {
+	id: string;
+	name: string;
+	kind: "file" | "snippet" | "link";
+	path?: string;
+	content?: string;
+	size?: number;
+	taskId?: string;
+	createdAt: number;
+}
+
+export interface OutputMethods {
+	"output.list": { params: {}; result: { outputs: Output[] } };
+	"output.add": { params: { name: string; kind: Output["kind"]; path?: string; content?: string; taskId?: string }; result: { output: Output } };
+	"output.remove": { params: { id: string }; result: { ok: boolean } };
+}

package/templates/cowork/src/shared/modules/preview.ts

@@ -0,0 +1,44 @@
+/**
+ * Preview 模块 — 内嵌浏览器预览（Code Tab）
+ *
+ * Web 端用 iframe，桌面端用 Electrobun BrowserView（Phase 2）。
+ * 后端负责桌面端窗口管理 + URL 加载；Web 端返回 useIframe 信号让前端渲染 iframe。
+ */
+
+export type NavState = 'loading' | 'ready' | 'error';
+
+export interface PreviewTab {
+	id: string;
+	url: string;
+	title: string;
+	state: NavState;
+	canGoBack: boolean;
+	canGoForward: boolean;
+}
+
+export interface PreviewMethods {
+	'preview.open': {
+		params: { url: string; tabId?: string };
+		result: { tab: PreviewTab; useIframe: boolean };
+	};
+	'preview.navigate': {
+		params: { tabId: string; action: 'back' | 'forward' | 'reload' };
+		result: { ok: boolean };
+	};
+	'preview.close': {
+		params: { tabId: string };
+		result: { ok: boolean };
+	};
+	'preview.list': {
+		params: Record<string, never>;
+		result: { tabs: PreviewTab[] };
+	};
+	'preview.history': {
+		params: Record<string, never>;
+		result: { urls: string[] };
+	};
+}
+
+export interface PreviewEvents {
+	'preview.navState': PreviewTab;
+}

package/templates/cowork/src/shared/modules/system.ts

@@ -0,0 +1,8 @@
+/**
+ * System 模块 — 基础连通性 & 调试
+ */
+export interface SystemMethods {
+  "system.ping": { params: {}; result: { pong: boolean; timestamp: number; platform: string } };
+  "system.hello": { params: { name?: string }; result: { message: string; timestamp: number } };
+  "system.echo": { params: unknown; result: unknown };
+}

package/templates/cowork/src/shared/modules/task.ts

@@ -0,0 +1,31 @@
+/**
+ * Task 模块 — 任务管理（Cowork 核心）
+ *
+ * 替代 session 模块，提供更丰富的任务状态机：
+ * queued → analyzing → executing → waiting_input → review → completed / failed
+ */
+
+export type TaskStatus = "queued" | "analyzing" | "executing" | "waiting_input" | "review" | "completed" | "failed";
+
+export interface Step {
+	label: string;
+	status: "pending" | "running" | "done" | "error";
+	detail?: string;
+}
+
+export interface Task {
+	id: string;
+	title: string;
+	status: TaskStatus;
+	progress?: { steps: Step[] };
+	createdAt: number;
+	updatedAt: number;
+}
+
+export interface TaskMethods {
+	"task.list": { params: {}; result: { tasks: Task[] } };
+	"task.create": { params: { title: string }; result: { task: Task } };
+	"task.get": { params: { id: string }; result: { task: Task | null } };
+	"task.update": { params: { id: string; patch: Partial<Pick<Task, "title" | "status" | "progress">> }; result: { task: Task } };
+	"task.delete": { params: { id: string }; result: { ok: boolean } };
+}

package/templates/cowork/src/shared/modules/timer.ts

@@ -0,0 +1,11 @@
+/**
+ * Timer 模块 — 定时器 & 事件推送
+ */
+export interface TimerMethods {
+  "timer.start": { params: {}; result: { started?: boolean; alreadyRunning?: boolean } };
+  "timer.stop": { params: {}; result: { stopped: boolean } };
+}
+
+export interface TimerEvents {
+  "timer.tick": { count: number; timestamp: number };
+}

package/templates/cowork/src/shared/register-all-handlers.ts

@@ -0,0 +1,36 @@
+import { RPCServer, type Transport } from "@dyyz1993/rpc-core";
+import type { HandlerOptions } from "./rpc-schema";
+import * as handlers from "./handlers/index";
+
+type RegisterFn = (server: RPCServer, options: HandlerOptions) => void;
+
+/**
+ * 自动注册所有 handlers — 从 handlers/index.ts barrel 导入
+ *
+ * 新增模块：在 handlers/ 创建文件，并在 handlers/index.ts 加一行 export
+ */
+export function registerAllHandlers(server: RPCServer, options: HandlerOptions): void {
+  for (const mod of Object.values(handlers) as RegisterFn[]) {
+    mod(server, options);
+  }
+}
+
+const noopTransport: Transport = {
+  send: async () => {},
+  onMessage: () => () => {},
+  onError: () => () => {},
+  onDisconnect: () => () => {},
+  isConnected: () => false,
+  close: () => {},
+};
+
+let _cachedMethods: string[] | null = null;
+
+export function discoverMethodNames(): string[] {
+  if (_cachedMethods) return _cachedMethods;
+  const server = new RPCServer(noopTransport);
+  registerAllHandlers(server, { platform: "web" });
+  _cachedMethods = server.getRegisteredMethods();
+  server.close();
+  return _cachedMethods!;
+}

package/templates/cowork/src/shared/rpc-schema.ts

@@ -0,0 +1,38 @@
+import type { AnyMethods } from '@dyyz1993/rpc-core';
+import type { SystemMethods } from './modules/system';
+import type { FileMethods } from './modules/file';
+import type { TimerMethods, TimerEvents } from './modules/timer';
+import type { ChatMethods, ChatEvents } from './modules/chat';
+import type { TaskMethods } from './modules/task';
+import type { ContextMethods } from './modules/context';
+import type { OutputMethods } from './modules/output';
+import type { PreviewMethods, PreviewEvents } from './modules/preview';
+
+/**
+ * RPC 方法定义 — 前后端共享的唯一类型入口
+ *
+ * Cowork 模块组合：system + chat + file + timer + task + context + output + preview
+ */
+export interface RPCMethods
+	extends
+		AnyMethods,
+		SystemMethods,
+		FileMethods,
+		TimerMethods,
+		ChatMethods,
+		TaskMethods,
+		ContextMethods,
+		OutputMethods,
+		PreviewMethods {}
+
+/**
+ * RPC 事件定义
+ */
+export interface RPCEvents extends TimerEvents, ChatEvents, PreviewEvents {}
+
+/**
+ * Handler 注册选项
+ */
+export interface HandlerOptions {
+	platform: 'desktop' | 'web';
+}

package/templates/cowork/tailwind.config.js

@@ -0,0 +1,15 @@
+/** @type {import('tailwindcss').Config} */
+export default {
+	darkMode: "class",
+	content: ["./index.html", "./src/mainview/**/*.{html,js,ts,jsx,tsx}"],
+	theme: {
+		extend: {
+			colors: {
+				gray: {
+					850: "#1f2937",
+				},
+			},
+		},
+	},
+	plugins: [],
+};

package/templates/cowork/tsconfig.ipc.json

@@ -0,0 +1,14 @@
+{
+	"extends": "./tsconfig.json",
+	"compilerOptions": {
+		"noUnusedLocals": false,
+		"noUnusedParameters": false,
+		"skipLibCheck": true,
+		"noUncheckedIndexedAccess": true,
+		"noImplicitReturns": true,
+		"noFallthroughCasesInSwitch": true,
+		"strict": true
+	},
+	"include": ["src/bun", "src/gateway/ipc-transport.ts", "src/shared"],
+	"exclude": ["node_modules", "dist", "build", "**/__tests__/**", "**/*.test.ts", "**/*.test.tsx"]
+}

package/templates/cowork/tsconfig.json

@@ -0,0 +1,36 @@
+{
+	"compilerOptions": {
+		"target": "ES2020",
+		"useDefineForClassFields": true,
+		"lib": ["ES2020", "DOM", "DOM.Iterable"],
+		"module": "ESNext",
+		"skipLibCheck": true,
+		"moduleResolution": "bundler",
+		"allowImportingTsExtensions": true,
+		"isolatedModules": true,
+		"moduleDetection": "force",
+		"noEmit": true,
+		"jsx": "react-jsx",
+		"strict": true,
+		"noUnusedLocals": true,
+		"noUnusedParameters": true,
+		"noFallthroughCasesInSwitch": true,
+		"baseUrl": ".",
+		"paths": {
+			"@dyyz1993/rpc-core": ["../../packages/rpc-core/src/index.ts"],
+			"@shared/*": ["../shared/*"]
+		},
+		"noUncheckedIndexedAccess": true,
+		"noImplicitReturns": true
+	},
+	"include": ["src", "../shared"],
+	"exclude": [
+		"node_modules",
+		"dist",
+		"build",
+		"../../package/dist",
+		"**/__tests__/**",
+		"**/*.test.ts",
+		"**/*.test.tsx"
+	]
+}

package/templates/cowork/vite.config.ts

@@ -0,0 +1,3 @@
+import { createViteConfig } from "../shared/vite-base.config";
+
+export default createViteConfig(__dirname);

package/templates/cowork/vitest.config.ts

@@ -0,0 +1,3 @@
+import { createVitestConfig } from "../shared/vitest-base.config";
+
+export default createVitestConfig(__dirname);

package/templates/general/.husky/commit-msg

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npx --no -- commitlint --edit "$1"

package/templates/general/.husky/pre-commit

@@ -0,0 +1,11 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+# Secret detection
+if git diff --cached --name-only --diff-filter=ACM -z | xargs -0 grep -ilE '(password|secret|api.key|private.key|token|credential).*=.*[A-Za-z0-9]{16,}' 2>/dev/null; then
+  echo "⚠️  Potential secrets detected in staged files!"
+  echo "Please review and remove any sensitive data before committing."
+  exit 1
+fi
+
+npx lint-staged

package/templates/general/.husky/pre-push

@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+echo "⏳ Running lint..."
+pnpm run lint
+echo "✅ Pre-push checks passed. Pushing..."

package/templates/general/CHANGELOG.md

@@ -0,0 +1,15 @@
+# pi-general-app
+
+## 1.0.2
+
+### Patch Changes
+
+- Updated dependencies [[`29d2171`](https://github.com/dyyz1993/pi-agent-template/commit/29d217148f6e0b496cc06716e11847b3e522e266)]:
+  - @dyyz1993/rpc-core@2.2.1
+
+## 1.0.1
+
+### Patch Changes
+
+- Updated dependencies [[`29d2171`](https://github.com/dyyz1993/pi-agent-template/commit/29d217148f6e0b496cc06716e11847b3e522e266), [`724470a`](https://github.com/dyyz1993/pi-agent-template/commit/724470a784b48a66591e06299fab8ad72f023962)]:
+  - @dyyz1993/rpc-core@3.0.0

package/templates/general/commitlint.config.js

@@ -0,0 +1,8 @@
+export default {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [2, 'always', ['feat', 'fix', 'docs', 'style', 'refactor', 'test', 'chore', 'revert', 'perf']],
+    'subject-max-length': [2, 'always', 80],
+    'subject-case': [0],
+  },
+};

package/templates/general/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-general-app",
-	"version": "1.0.0",
+	"version": "1.0.2",
 	"description": "Electrobun app with React, Tailwind CSS, and Vite HMR",
 	"scripts": {
 		"start": "vite build && electrobun dev",
@@ -14,13 +14,15 @@
 		"build:linux": "vite build && electrobun build --env=canary",
 		"lint": "eslint .",
 		"lint:fix": "eslint . --fix",
+		"format": "prettier --write .",
+		"format:check": "prettier --check .",
 		"prepare": "husky",
 		"test": "vitest run",
 		"test:watch": "vitest",
 		"test:coverage": "vitest run --coverage"
 	},
 	"dependencies": {
-		"@dyyz1993/rpc-core": "^1.2.0",
+		"@dyyz1993/rpc-core": "^2.2.1",
 		"@tanstack/react-virtual": "^3.13.24",
 		"electrobun": "1.18.1",
 		"i18next": "^24.2.2",
@@ -36,7 +38,7 @@
 		"zustand": "^5.0.12"
 	},
 	"devDependencies": {
-		"@dyyz1993/eslint-plugin-rpc": "workspace:*",
+		"@dyyz1993/eslint-plugin-rpc": "^1.1.0",
 		"@eslint/js": "^9.0.0",
 		"@testing-library/jest-dom": "^6.9.1",
 		"@testing-library/react": "^16.3.2",
@@ -61,7 +63,20 @@
 		"typescript": "^5.7.2",
 		"typescript-eslint": "^8.0.0",
 		"vite": "^6.0.3",
-		"vitest": "^4.1.5"
+		"vitest": "^4.1.5",
+		"@commitlint/cli": "^19.8.1",
+		"@commitlint/config-conventional": "^19.8.1",
+		"prettier": "^3.5.3",
+		"lint-staged": "^15.5.2"
+	},
+	"lint-staged": {
+		"*.{ts,tsx}": [
+			"eslint --fix",
+			"prettier --write"
+		],
+		"*.{json,md,css,html}": [
+			"prettier --write"
+		]
 	},
 	"overrides": {
 		"minimatch": "^10.0.1"

package/templates/general/src/mainview/__tests__/hooks/use-input-history.test.ts

@@ -0,0 +1,125 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { renderHook, act } from "@testing-library/react";
+import { useInputHistory } from "../../hooks/use-input-history";
+
+describe("useInputHistory", () => {
+	beforeEach(() => {
+		window.localStorage.clear();
+	});
+
+	it("saveToHistory stores entry", () => {
+		const { result } = renderHook(() => useInputHistory("test-session"));
+		act(() => {
+			result.current.saveToHistory("hello");
+		});
+		expect(result.current.hasPrev).toBe(true);
+	});
+
+	it("saveToHistory ignores empty", () => {
+		const { result } = renderHook(() => useInputHistory("test-session"));
+		act(() => {
+			result.current.saveToHistory("  ");
+		});
+		expect(result.current.hasPrev).toBe(false);
+	});
+
+	it("navigatePrev returns items", () => {
+		const { result } = renderHook(() => useInputHistory("test-session"));
+		act(() => {
+			result.current.saveToHistory("first");
+			result.current.saveToHistory("second");
+		});
+		let value: string | null = null;
+		act(() => {
+			value = result.current.navigatePrev();
+		});
+		expect(value).toBe("second");
+
+		act(() => {
+			value = result.current.navigatePrev();
+		});
+		expect(value).toBe("first");
+	});
+
+	it("navigateNext returns empty string at end", () => {
+		const { result } = renderHook(() => useInputHistory("test-session"));
+		act(() => {
+			result.current.saveToHistory("hello");
+		});
+		act(() => {
+			result.current.navigatePrev();
+		});
+		let value: string | null = null;
+		act(() => {
+			value = result.current.navigateNext();
+		});
+		expect(value).toBe("");
+	});
+
+	it("clearHistory removes all", () => {
+		const { result } = renderHook(() => useInputHistory("test-session"));
+		act(() => {
+			result.current.saveToHistory("a");
+			result.current.saveToHistory("b");
+		});
+		act(() => {
+			result.current.clearHistory();
+		});
+		expect(result.current.hasPrev).toBe(false);
+	});
+
+	it("deduplicates entries", () => {
+		const { result } = renderHook(() => useInputHistory("test-session"));
+		act(() => {
+			result.current.saveToHistory("hello");
+			result.current.saveToHistory("hello");
+		});
+		let count = 0;
+		while (result.current.hasPrev) {
+			act(() => {
+				result.current.navigatePrev();
+			});
+			count++;
+			if (count > 20) break;
+		}
+		expect(count).toBe(1);
+	});
+
+	it("respects max 10 items", () => {
+		const { result } = renderHook(() => useInputHistory("test-session"));
+		act(() => {
+			for (let i = 0; i < 15; i++) {
+				result.current.saveToHistory(`item-${i}`);
+			}
+		});
+		let count = 0;
+		while (result.current.hasPrev) {
+			act(() => {
+				result.current.navigatePrev();
+			});
+			count++;
+			if (count > 20) break;
+		}
+		expect(count).toBe(10);
+	});
+
+	it("resetIndex goes back to -1", () => {
+		const { result } = renderHook(() => useInputHistory("test-session"));
+		act(() => {
+			result.current.saveToHistory("first");
+			result.current.saveToHistory("second");
+			result.current.saveToHistory("third");
+		});
+		act(() => {
+			result.current.navigatePrev();
+		});
+		act(() => {
+			result.current.navigatePrev();
+		});
+		expect(result.current.hasNext).toBe(true);
+		act(() => {
+			result.current.resetIndex();
+		});
+		expect(result.current.hasNext).toBe(false);
+	});
+});

package/templates/general/src/mainview/__tests__/setup.ts

@@ -1,37 +1,40 @@
-import "@testing-library/jest-dom/vitest";
+import { expect } from "vitest";
+import * as matchers from "@testing-library/jest-dom/matchers";
+
+expect.extend(matchers);
 
 Object.defineProperty(window, "matchMedia", {
-  writable: true,
-  value: (query: string) => ({
-    matches: false,
-    media: query,
-    onchange: null,
-    addListener: () => {},
-    removeListener: () => {},
-    addEventListener: () => {},
-    removeEventListener: () => {},
-    dispatchEvent: () => false,
-  }),
+	writable: true,
+	value: (query: string) => ({
+		matches: false,
+		media: query,
+		onchange: null,
+		addListener: () => {},
+		removeListener: () => {},
+		addEventListener: () => {},
+		removeEventListener: () => {},
+		dispatchEvent: () => false,
+	}),
 });
 
 const localStorageMock = (() => {
-  let store: Record<string, string> = {};
-  return {
-    getItem: (key: string) => store[key] ?? null,
-    setItem: (key: string, value: string) => {
-      store[key] = String(value);
-    },
-    removeItem: (key: string) => {
-      delete store[key];
-    },
-    clear: () => {
-      store = {};
-    },
-    get length() {
-      return Object.keys(store).length;
-    },
-    key: (i: number) => Object.keys(store)[i] ?? null,
-  };
+	let store: Record<string, string> = {};
+	return {
+		getItem: (key: string) => store[key] ?? null,
+		setItem: (key: string, value: string) => {
+			store[key] = String(value);
+		},
+		removeItem: (key: string) => {
+			delete store[key];
+		},
+		clear: () => {
+			store = {};
+		},
+		get length() {
+			return Object.keys(store).length;
+		},
+		key: (i: number) => Object.keys(store)[i] ?? null,
+	};
 })();
 
 Object.defineProperty(window, "localStorage", { value: localStorageMock });