@joekytc/dsh-swarm 0.1.2 → 0.2.0

package/skills/llm-wiki-skill/workbench/server/src/wiki-init.ts

@@ -0,0 +1,188 @@
+import { execFile } from "node:child_process";
+import { copyFile, mkdir, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import path from "node:path";
+import { promisify } from "node:util";
+
+import { DEFAULT_KNOWLEDGE_BASE_ROOT } from "./config.js";
+import { expandUserPath, registerExternalKnowledgeBase } from "./knowledge-bases.js";
+
+const execFileAsync = promisify(execFile);
+
+export interface CreateWikiResult {
+	name: string;
+	path: string;
+	stdout: string;
+	stderr: string;
+}
+
+export interface InitExistingWikiResult {
+	path: string;
+	stdout: string;
+	stderr: string;
+	backedUpFiles: string[];
+}
+
+export class InitConflictError extends Error {
+	statusCode = 409;
+	constructor(public conflicts: string[]) {
+		super(`目标目录已有将被初始化覆盖的文件：${conflicts.join(", ")}`);
+	}
+}
+
+const INIT_WRITTEN_FILES = [
+	".gitignore",
+	".wiki-schema.md",
+	"index.md",
+	"log.md",
+	path.join("wiki", "overview.md"),
+	"purpose.md",
+	".wiki-cache.json",
+];
+
+export function truncateOutput(text: string): string {
+	return text.length > 4096 ? text.slice(0, 4096) + "\n...[truncated]" : text;
+}
+
+export function validateWikiName(name: string): string {
+	const trimmed = name.trim();
+	if (!trimmed) throw new Error("知识库名不能为空");
+	if (trimmed.includes("/") || trimmed.includes("\\")) {
+		throw new Error("知识库名不能包含路径分隔符");
+	}
+	if (trimmed === "." || trimmed === "..") {
+		throw new Error("知识库名不能是 . 或 ..");
+	}
+	return trimmed;
+}
+
+function assertInside(baseDir: string, target: string): void {
+	const resolvedBase = path.resolve(baseDir);
+	const resolvedTarget = path.resolve(target);
+	if (resolvedTarget !== resolvedBase && !resolvedTarget.startsWith(resolvedBase + path.sep)) {
+		throw new Error("目标路径不在默认知识库根目录内");
+	}
+}
+
+async function fileExists(filePath: string): Promise<boolean> {
+	const info = await stat(filePath).catch(() => null);
+	return Boolean(info?.isFile());
+}
+
+export function initScriptCandidates(homeDir = homedir()): string[] {
+	const skillDirs = [
+		path.join(homeDir, ".codex", "skills", "llm-wiki"),
+		path.join(homeDir, ".codex", "skills", "llm-wiki-skill"),
+		path.join(homeDir, ".claude", "skills", "llm-wiki-skill"),
+		path.join(homeDir, ".claude", "skills", "llm-wiki"),
+	];
+	return skillDirs.flatMap((skillDir) => [
+		path.join(skillDir, "init-wiki.sh"),
+		path.join(skillDir, "scripts", "init-wiki.sh"),
+	]);
+}
+
+async function findInitScript(): Promise<string | null> {
+	const candidates = initScriptCandidates();
+	for (const candidate of candidates) {
+		if (await fileExists(candidate)) return candidate;
+	}
+	return null;
+}
+
+export async function createWiki(nameInput: string, purposeInput: string): Promise<CreateWikiResult> {
+	const name = validateWikiName(nameInput);
+	const scriptPath = await findInitScript();
+	if (!scriptPath) {
+		throw new Error("llm-wiki 未安装。请先安装到 ~/.codex/skills/llm-wiki/ 或 ~/.claude/skills/llm-wiki-skill/。");
+	}
+
+	const targetPath = path.join(DEFAULT_KNOWLEDGE_BASE_ROOT, name);
+	assertInside(DEFAULT_KNOWLEDGE_BASE_ROOT, targetPath);
+	await mkdir(DEFAULT_KNOWLEDGE_BASE_ROOT, { recursive: true });
+
+	const { stdout, stderr } = await execFileAsync(
+		scriptPath,
+		[targetPath, purposeInput.trim() || name, "中文"],
+		{
+			timeout: 60_000,
+			env: {
+				HOME: homedir(),
+				PATH: process.env.PATH ?? "/usr/bin:/bin:/usr/sbin:/sbin",
+			},
+			maxBuffer: 1024 * 1024,
+		},
+	);
+
+	return {
+		name,
+		path: targetPath,
+		stdout: truncateOutput(stdout),
+		stderr: truncateOutput(stderr),
+	};
+}
+
+export async function initExistingWiki(
+	rawPath: string,
+	purposeInput: string,
+	overwrite = false,
+): Promise<InitExistingWikiResult> {
+	const absolutePath = path.resolve(expandUserPath(rawPath));
+	const info = await stat(absolutePath).catch(() => null);
+	if (!info?.isDirectory()) throw new Error(`目标路径不是目录：${absolutePath}`);
+
+	const purpose = purposeInput.trim();
+	if (!purpose) throw new Error("研究方向不能为空");
+
+	const conflicts = await findInitConflicts(absolutePath);
+	if (conflicts.length > 0 && !overwrite) {
+		throw new InitConflictError(conflicts);
+	}
+
+	const backedUpFiles =
+		conflicts.length > 0 ? await backupConflicts(absolutePath, conflicts) : [];
+	const scriptPath = await findInitScript();
+	if (!scriptPath) {
+		throw new Error("llm-wiki 未安装。请先安装到 ~/.codex/skills/llm-wiki/ 或 ~/.claude/skills/llm-wiki-skill/。");
+	}
+
+	const { stdout, stderr } = await execFileAsync(scriptPath, [absolutePath, purpose, "中文"], {
+		timeout: 60_000,
+		env: {
+			HOME: homedir(),
+			PATH: process.env.PATH ?? "/usr/bin:/bin:/usr/sbin:/sbin",
+		},
+		maxBuffer: 1024 * 1024,
+	});
+
+	await registerExternalKnowledgeBase(absolutePath);
+	return {
+		path: absolutePath,
+		stdout: truncateOutput(stdout),
+		stderr: truncateOutput(stderr),
+		backedUpFiles,
+	};
+}
+
+async function findInitConflicts(targetPath: string): Promise<string[]> {
+	const conflicts: string[] = [];
+	for (const relPath of INIT_WRITTEN_FILES) {
+		const info = await stat(path.join(targetPath, relPath)).catch(() => null);
+		if (info?.isFile()) conflicts.push(relPath);
+	}
+	return conflicts;
+}
+
+async function backupConflicts(targetPath: string, conflicts: string[]): Promise<string[]> {
+	const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+	const backupRoot = path.join(targetPath, ".llm-wiki-agent-backup", timestamp);
+	const backedUp: string[] = [];
+	for (const relPath of conflicts) {
+		const src = path.join(targetPath, relPath);
+		const dest = path.join(backupRoot, relPath);
+		await mkdir(path.dirname(dest), { recursive: true });
+		await copyFile(src, dest);
+		backedUp.push(dest);
+	}
+	return backedUp;
+}

package/skills/llm-wiki-skill/workbench/server/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "types": ["node"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["dist", "node_modules"]
+}

package/skills/llm-wiki-skill/workbench/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "resolveJsonModule": true
+  },
+  "files": []
+}

package/skills/llm-wiki-skill/workbench/web/README.md

@@ -0,0 +1,73 @@
+# React + TypeScript + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
+
+## React Compiler
+
+The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
+
+```js
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+
+      // Remove tseslint.configs.recommended and replace with this
+      tseslint.configs.recommendedTypeChecked,
+      // Alternatively, use this for stricter rules
+      tseslint.configs.strictTypeChecked,
+      // Optionally, add this for stylistic rules
+      tseslint.configs.stylisticTypeChecked,
+
+      // Other configs...
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```
+
+You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
+
+```js
+// eslint.config.js
+import reactX from 'eslint-plugin-react-x'
+import reactDom from 'eslint-plugin-react-dom'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+      // Enable lint rules for React
+      reactX.configs['recommended-typescript'],
+      // Enable lint rules for React DOM
+      reactDom.configs.recommended,
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```

package/skills/llm-wiki-skill/workbench/web/components.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/index.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "iconLibrary": "lucide"
+}

package/skills/llm-wiki-skill/workbench/web/eslint.config.js

@@ -0,0 +1,22 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import tseslint from 'typescript-eslint'
+import { defineConfig, globalIgnores } from 'eslint/config'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      js.configs.recommended,
+      tseslint.configs.recommended,
+      reactHooks.configs.flat.recommended,
+      reactRefresh.configs.vite,
+    ],
+    languageOptions: {
+      globals: globals.browser,
+    },
+  },
+])

package/skills/llm-wiki-skill/workbench/web/index.html

@@ -0,0 +1,16 @@
+<!doctype html>
+<html lang="zh-CN" data-theme="light" data-paper="clean" data-userbubble="soft" data-hand="on" data-density="cozy" data-accent="terracotta">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link href="https://fonts.googleapis.com/css2?family=Caveat:wght@500;600;700&family=JetBrains+Mono:wght@400;500;600;700&family=Plus+Jakarta+Sans:wght@400;500;600;700;800&display=swap" rel="stylesheet" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>llm-wiki-agent</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/skills/llm-wiki-skill/workbench/web/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@llm-wiki-agent/web",
+  "private": true,
+  "version": "0.0.1",
+  "type": "module",
+  "description": "llm-wiki-agent 前端：Vite + React + shadcn/ui",
+  "license": "MIT",
+  "scripts": {
+    "dev": "vite",
+    "prebuild": "npm run build -w @llm-wiki/graph-engine",
+    "build": "tsc -b && vite build",
+    "lint": "eslint .",
+    "preview": "vite preview",
+    "test": "npm run test:unit && npm run test:dom",
+    "test:unit": "node --import tsx --test test/*.test.ts",
+    "test:dom": "node --test-concurrency=1 --import tsx --import ./test/setup-dom.ts --test test/*.test.tsx",
+    "visual:paper": "node --import tsx test/visual/paper-ui.ts",
+    "pretypecheck": "npm run build -w @llm-wiki/graph-engine",
+    "typecheck": "tsc -b --noEmit"
+  },
+  "dependencies": {
+    "@llm-wiki/graph-engine": "0.0.0",
+    "@tailwindcss/vite": "^4.0.0",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
+    "lucide-react": "^1.16.0",
+    "radix-ui": "^1.4.3",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "react-markdown": "^9.1.0",
+    "remark-gfm": "^4.0.1",
+    "tailwind-merge": "^2.5.4",
+    "tailwindcss": "^4.0.0",
+    "tw-animate-css": "^1.4.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^24.12.3",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.1",
+    "eslint": "^10.3.0",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-react-refresh": "^0.5.2",
+    "globals": "^17.6.0",
+    "jsdom": "^29.1.1",
+    "playwright": "^1.61.0",
+    "typescript": "~6.0.2",
+    "typescript-eslint": "^8.59.2",
+    "vite": "^8.0.12"
+  }
+}