@dyyz1993/create-agent 2.1.0 → 2.1.2

package/src/lib/copy.ts

@@ -1,9 +1,52 @@
-import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, unlinkSync } from "fs";
-import { join, resolve } from "path";
-import { execSync } from "child_process";
+import {
+	readFileSync,
+	writeFileSync,
+	mkdirSync,
+	existsSync,
+	readdirSync,
+	unlinkSync,
+	chmodSync,
+} from "fs";
+import { join, resolve, extname } from "path";
+import { homedir } from "os";
+import { execFileSync } from "child_process";
+import { getRootDir } from "./templates.js";
 
 const SKIP_DIRS = new Set(["node_modules", "build", "dist", ".git", ".husky", ".trae"]);
-const SKIP_FILES = new Set(["bun.lock", "rpc-browser.js"]);
+const SKIP_FILES = new Set(["bun.lock"]);
+
+const BINARY_EXTENSIONS = new Set([
+	".png",
+	".jpg",
+	".jpeg",
+	".gif",
+	".webp",
+	".ico",
+	".icns",
+	".ttf",
+	".otf",
+	".woff",
+	".woff2",
+	".mp3",
+	".mp4",
+	".wav",
+	".pdf",
+	".zip",
+	".gz",
+]);
+
+export function expandTilde(targetPath: string): string {
+	if (targetPath === "~") return homedir();
+	if (targetPath.startsWith("~/")) return join(homedir(), targetPath.slice(2));
+	return targetPath;
+}
+
+function isBinaryFile(filePath: string, buffer: Buffer): boolean {
+	if (BINARY_EXTENSIONS.has(extname(filePath).toLowerCase())) return true;
+	// A NUL byte in the first 8KB almost certainly means binary content;
+	// reading such a file as utf-8 would silently corrupt it.
+	return buffer.subarray(0, 8192).includes(0);
+}
 
 export interface CopyOptions {
 	projectName: string;
@@ -35,14 +78,20 @@ export function copyAndReplace(srcDir: string, destDir: string, projectName: str
 		} else {
 			if (SKIP_FILES.has(entry.name)) continue;
 
-			let content = readFileSync(srcPath, "utf-8");
+			const raw = readFileSync(srcPath);
+
+			if (isBinaryFile(entry.name, raw)) {
+				writeFileSync(destPath, raw);
+				continue;
+			}
+
+			let content = raw.toString("utf-8");
 
 			content = content.replace(/pi-agent-template/g, projectName);
 			content = content.replace(/Pi Agent Template/g, pascalName);
 			content = content.replace(/Pi Agent/g, pascalName);
 			content = content.replace(/com\.piagent\.template/g, identifier);
 			content = content.replace(/com\.piagent/g, shortId);
-			content = content.replace(/@pi-agent\//g, `@${projectName}/`);
 
 			writeFileSync(destPath, content);
 		}
@@ -66,8 +115,8 @@ function copyTraeRules(monorepoRoot: string, targetDir: string, projectName: str
 	}
 }
 
-function copySharedModules(monorepoRoot: string, targetDir: string, projectName: string): void {
-	const sharedDir = resolve(monorepoRoot, "templates", "shared");
+function copySharedModules(sourceRoot: string, targetDir: string, projectName: string): void {
+	const sharedDir = resolve(sourceRoot, "templates", "shared");
 	if (!existsSync(sharedDir)) return;
 
 	const destSharedDir = join(targetDir, "shared");
@@ -137,76 +186,83 @@ function cleanSharedViteConfig(sharedDir: string): void {
 	}
 }
 
-function resolvePackageVersion(packageName: string): string {
+function resolvePackageVersion(packageName: string, fallbackRange?: string): string {
 	try {
-		return execSync(`npm view ${packageName} version`, { encoding: "utf-8" }).trim();
+		const version = execFileSync("npm", ["view", packageName, "version"], {
+			encoding: "utf-8",
+		}).trim();
+		return `^${version}`;
 	} catch {
-		return "1.0.0";
+		// Offline / registry failure: keep a usable range instead of silently
+		// downgrading the project to an ancient version.
+		if (fallbackRange && fallbackRange !== "workspace:*") {
+			console.warn(`(Could not look up latest ${packageName}; keeping ${fallbackRange})`);
+			return fallbackRange;
+		}
+		const fallback = NPM_FALLBACK_VERSIONS[packageName];
+		if (fallback) {
+			console.warn(`(Could not look up latest ${packageName}; falling back to ${fallback})`);
+			return fallback;
+		}
+		console.warn(`(Could not look up latest ${packageName}; keeping ${String(fallbackRange)})`);
+		return fallbackRange ?? "*";
 	}
 }
 
+// Only used when the registry is unreachable AND no usable range is present;
+// bundled templates carry pinned versions via post-sync-templates.mjs.
+const NPM_FALLBACK_VERSIONS: Record<string, string> = {
+	"@dyyz1993/rpc-core": "^2.2.0",
+	"@dyyz1993/eslint-plugin-rpc": "^1.1.0",
+};
+
 const WORKSPACE_PACKAGES = ["@dyyz1993/rpc-core", "@dyyz1993/eslint-plugin-rpc"];
 
-function updatePackageJson(targetDir: string, _projectName: string): void {
+function updatePackageJson(targetDir: string, projectName: string): void {
 	const rootPkgPath = join(targetDir, "package.json");
 	if (!existsSync(rootPkgPath)) return;
 
 	const rootPkg = JSON.parse(readFileSync(rootPkgPath, "utf-8"));
 
 	delete rootPkg.workspaces;
+	rootPkg.name = projectName;
 
 	for (const depKey of ["dependencies", "devDependencies"] as const) {
 		if (!rootPkg[depKey]) continue;
 		for (const pkgName of WORKSPACE_PACKAGES) {
 			if (!rootPkg[depKey][pkgName]) continue;
-			if (pkgName === "@dyyz1993/rpc-core") {
-				const version = resolvePackageVersion(pkgName);
-				rootPkg[depKey][pkgName] = `^${version}`;
-			} else {
-				delete rootPkg[depKey][pkgName];
-			}
+			rootPkg[depKey][pkgName] = resolvePackageVersion(pkgName, rootPkg[depKey][pkgName]);
 		}
 	}
 
 	writeFileSync(rootPkgPath, JSON.stringify(rootPkg, null, "\t") + "\n");
+}
 
-	const eslintConfigPath = join(targetDir, "eslint.config.mjs");
-	if (existsSync(eslintConfigPath)) {
-		const lines = readFileSync(eslintConfigPath, "utf-8").split("\n");
-		const filteredLines: string[] = [];
-
-		let inRpcSection = false;
-		for (let i = 0; i < lines.length; i++) {
-			const line = lines[i];
-			if (line === undefined) continue;
-
-			if (line.includes("import rpcPlugin") && line.includes("@dyyz1993/eslint-plugin-rpc")) {
-				continue;
-			}
-
-			if (line.includes("RPC") && line.includes("规范规则")) {
-				inRpcSection = true;
-				continue;
-			}
-
-			if (inRpcSection) {
-				if (line.trim().startsWith("'rpc/") || line.trim().startsWith('"rpc/')) {
-					continue;
-				}
-				inRpcSection = false;
-			}
-
-			if (line.includes("rpc: rpcPlugin")) {
-				continue;
-			}
+/**
+ * Shared post-processing after raw template files land in the target project.
+ * Used by both `create` and `update --force`; skipping it used to leave
+ * `workspace:*` deps and `../shared` imports in user projects.
+ */
+export function postProcessTemplate(targetDir: string, projectName: string): void {
+	copySharedModules(getRootDir(), targetDir, projectName);
+	cleanViteConfig(targetDir);
+	updatePackageJson(targetDir, projectName);
+}
 
-			filteredLines.push(line);
+function precheckExternalTools(): void {
+	const missing: string[] = [];
+	for (const tool of ["git", "bun"]) {
+		try {
+			execFileSync(tool, ["--version"], { stdio: "pipe" });
+		} catch {
+			missing.push(tool);
 		}
-
-		let content = filteredLines.join("\n");
-		content = content.replace(/\n\s+plugins:\s*\{\s*\},?\s*\n/g, "\n");
-
-		writeFileSync(eslintConfigPath, content);
+	}
+	if (missing.length > 0) {
+		throw new Error(
+			`Required tools not found: ${missing.join(", ")}. ` +
+				`Install them before creating a project (bun: https://bun.sh).`
+		);
 	}
 }
 
@@ -219,6 +275,8 @@ export async function copyTemplate(options: CopyOptions): Promise<void> {
 		throw new Error(`Directory "${targetDir}" already exists.`);
 	}
 
+	precheckExternalTools();
+
 	const { identifier } = deriveNames(projectName);
 
 	console.log(`Creating project: ${projectName}`);
@@ -229,65 +287,147 @@ export async function copyTemplate(options: CopyOptions): Promise<void> {
 	copyAndReplace(templateDir, targetDir, projectName);
 	if (isMonorepo) {
 		copyTraeRules(localRoot, targetDir, projectName);
-		copySharedModules(localRoot, targetDir, projectName);
-	} else {
-		const publishedShared = resolve(import.meta.dir, "..", "..", "templates", "shared");
-		if (existsSync(publishedShared)) {
-			copyAndReplace(publishedShared, join(targetDir, "shared"), projectName);
-			for (const f of ["http-routes.ts", "logger.ts"]) {
-				const p = join(targetDir, "shared", f);
-				if (existsSync(p)) unlinkSync(p);
-			}
-			const tsconfigPath = join(targetDir, "tsconfig.json");
-			if (existsSync(tsconfigPath)) {
-				let tsconfig = readFileSync(tsconfigPath, "utf-8");
-				tsconfig = tsconfig.replace(/"\.\.\/shared\/\*"/g, '"./shared/*"');
-				tsconfig = tsconfig.replace(/"\.\.\/shared"/g, '"./shared"');
-				writeFileSync(tsconfigPath, tsconfig);
-			}
-			cleanSharedViteConfig(join(targetDir, "shared"));
-		}
 	}
-	cleanViteConfig(targetDir);
-	updatePackageJson(targetDir, projectName);
+	postProcessTemplate(targetDir, projectName);
 
 	console.log("Initializing git...");
-	execSync("git init", { cwd: targetDir, stdio: "pipe" });
+	execFileSync("git", ["init"], { cwd: targetDir, stdio: "pipe" });
 
 	console.log("Installing dependencies...");
-	execSync("bun install", { cwd: targetDir, stdio: "inherit" });
+	execFileSync("bun", ["install"], { cwd: targetDir, stdio: "inherit" });
 
 	console.log("Building browser bundle...");
 	try {
-		execSync("bun run build:browser", { cwd: targetDir, stdio: "pipe" });
+		execFileSync("bun", ["run", "build:browser"], { cwd: targetDir, stdio: "pipe" });
 	} catch {
 		console.log("(build:browser skipped - script not found)");
 	}
 
 	const huskyDir = join(targetDir, ".husky");
 	mkdirSync(huskyDir, { recursive: true });
-	writeFileSync(
-		join(huskyDir, "pre-commit"),
-		[
-			"#!/bin/sh",
-			"bun run lint",
-			'ERRORS=$(bunx tsc --noEmit 2>&1 | grep "error TS" | grep -v "node_modules" || true)',
-			'if [ -n "$ERRORS" ]; then',
-			'  echo "$ERRORS"',
-			"  exit 1",
-			"fi",
-		].join("\n") + "\n"
+
+	const hook = (name: string, content: string) => {
+		const p = join(huskyDir, name);
+		writeFileSync(p, content);
+		chmodSync(p, 0o755);
+	};
+
+	hook(
+		"pre-commit",
+		`#!/bin/sh
+bunx lint-staged
+
+STAGED_TS=$(git diff --cached --name-only --diff-filter=ACMR | grep -c '\\.tsx\\?$' || true)
+
+if [ "$STAGED_TS" -gt 0 ]; then
+  echo "⏳ Type checking..."
+  bunx tsc --noEmit 2>&1 | grep "error TS" | grep -v "node_modules" && exit 1 || true
+fi
+
+echo "✅ Pre-commit checks passed"
+`
 	);
 
-	execSync("git add -A", { cwd: targetDir, stdio: "pipe" });
+	hook(
+		"commit-msg",
+		`#!/bin/sh
+bunx commitlint --edit "$1"
+`
+	);
+
+	hook(
+		"pre-push",
+		`#!/bin/sh
+echo "⏳ Linting..."
+bun run lint || { echo "❌ Lint failed."; exit 1; }
+
+echo "⏳ Checking lockfile sync..."
+git diff --name-only HEAD -- bun.lock | grep -q . && { echo "⚠️  bun.lock has uncommitted changes."; exit 1; }
 
+echo "✅ Pre-push checks passed (full tests run in CI). Pushing..."
+`
+	);
+
+	hook(
+		"prepare-commit-msg",
+		`#!/bin/sh
+COMMIT_MSG_FILE="$1"
+COMMIT_SOURCE="$2"
+
+if [ "$COMMIT_SOURCE" = "merge" ] || [ "$COMMIT_SOURCE" = "squash" ] || [ "$COMMIT_SOURCE" = "commit" ]; then
+  exit 0
+fi
+
+FIRST_LINE=$(head -n1 "$COMMIT_MSG_FILE")
+
+if echo "$FIRST_LINE" | grep -qE '^[a-z]+(\\([^)]+\\))?:'; then
+  exit 0
+fi
+
+STAGED=$(git diff --cached --name-only)
+
+if echo "$STAGED" | grep -q "^src/"; then
+  SCOPE="app"
+elif echo "$STAGED" | grep -q "^components/"; then
+  SCOPE="ui"
+elif echo "$STAGED" | grep -q "^server/"; then
+  SCOPE="server"
+fi
+
+if [ -n "$SCOPE" ]; then
+  sed -i.bak -E "s/^([a-z]+)(\\([^)]+\\))?:/\\1($SCOPE):/" "$COMMIT_MSG_FILE"
+  rm -f "\${COMMIT_MSG_FILE}.bak"
+fi
+`
+	);
+
+	hook(
+		"post-merge",
+		`#!/bin/sh
+echo "⏳ Checking for dependency changes..."
+CHANGED=$(git diff HEAD@{1} --name-only HEAD)
+
+if echo "$CHANGED" | grep -q "bun.lock\\|package.json"; then
+  echo "📦 Dependencies changed, running bun install..."
+  bun install
+fi
+`
+	);
+
+	hook(
+		"post-checkout",
+		`#!/bin/sh
+PREV_HEAD="$1"
+NEW_HEAD="$2"
+IS_BRANCH="$3"
+
+if [ "$IS_BRANCH" = "1" ]; then
+  CHANGED=$(git diff --name-only "$PREV_HEAD" "$NEW_HEAD" 2>/dev/null)
+  if echo "$CHANGED" | grep -q "bun.lock\\|package.json"; then
+    echo "📦 Dependencies changed between branches, running bun install..."
+    bun install
+  fi
+fi
+`
+	);
+
+	console.log("Initializing husky...");
 	try {
-		execSync(`git commit --no-verify -m "feat: init ${projectName} from pi-agent-template"`, {
-			cwd: targetDir,
-			stdio: "pipe",
-		});
+		execFileSync("bun", ["run", "prepare"], { cwd: targetDir, stdio: "pipe" });
+	} catch {
+		console.warn("(husky init skipped - prepare script failed; git hooks not installed)");
+	}
+
+	execFileSync("git", ["add", "-A"], { cwd: targetDir, stdio: "pipe" });
+
+	try {
+		execFileSync(
+			"git",
+			["commit", "--no-verify", "-m", `feat: init ${projectName} from pi-agent-template`],
+			{ cwd: targetDir, stdio: "pipe" }
+		);
 	} catch {
-		console.log("(git commit skipped - no files to commit)");
+		console.log("(git commit skipped - check git user.name / user.email config)");
 	}
 
 	console.log("");

package/src/lib/templates.ts

@@ -27,6 +27,18 @@ const TEMPLATES: TemplateInfo[] = [
     available: true,
     dir: 'templates/agent',
   },
+  {
+    type: 'browser-agent',
+    description: 'Browser automation agent (AI-powered browser control + xbrowser + Desktop/Web)',
+    available: true,
+    dir: 'templates/browser-agent',
+  },
+  {
+    type: 'cowork',
+    description: 'Cowork task collaboration agent (Task orchestration + Progress tracking + Artifacts + Context management)',
+    available: true,
+    dir: 'templates/cowork',
+  },
 ];
 
 export function getTemplateInfo(type: string): TemplateInfo | undefined {

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

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

package/templates/agent/.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/agent/.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/agent/.prettierignore

@@ -0,0 +1,6 @@
+node_modules
+build
+dist
+dist-electron
+pnpm-lock.yaml
+*.min.js

package/templates/agent/.prettierrc

@@ -0,0 +1,9 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

package/templates/agent/CHANGELOG.md

@@ -0,0 +1,15 @@
+# pi-agent-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/agent/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/agent/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-agent-app",
-	"version": "1.0.0",
+	"version": "1.0.2",
 	"description": "Coding agent template with Bash, Rules, and Todo management",
 	"author": {
 		"name": "xuyingzhou",
@@ -67,13 +67,15 @@
 		"electron:build:linux": "vite build && electron-builder --linux",
 		"lint": "eslint .",
 		"lint:fix": "eslint . --fix",
+		"format": "prettier --write .",
+		"format:check": "prettier --check .",
 		"test": "vitest run",
 		"test:watch": "vitest",
 		"test:coverage": "vitest run --coverage",
 		"prepare": "husky"
 	},
 	"dependencies": {
-		"@dyyz1993/rpc-core": "^1.2.0",
+		"@dyyz1993/rpc-core": "^2.2.1",
 		"@tanstack/react-virtual": "^3.13.24",
 		"electrobun": "1.18.1",
 		"lucide-react": "^1.9.0",
@@ -89,7 +91,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",
@@ -116,7 +118,20 @@
 		"typescript-eslint": "^8.0.0",
 		"vite": "^6.0.3",
 		"vitest": "^4.1.5",
-		"ws": "^8.18.0"
+		"ws": "^8.18.0",
+		"@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"