Initialize repository with harness code and assets

Initial import of all source code, config, and README assets: the
packages workspace (cli, core, server, web, docs, landing, skills),
build scripts, tooling config, and CI workflows.

Includes the data-layout revision made on this branch: the local data
root defaults to ~/.penguin/data (PENGUIN_HOME still overrides; the
installer keeps its binaries in ~/.penguin), and every Agent lives
under <project>/agents/<agent>/ — path helpers, the three
agent-enumeration scans, the system prompt, built-in Skills, tests
and docs all follow the new layout.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018ihk8iQuo3kv2aPjAYEPuR

packages/web/test/file-path.test.ts

@@ -0,0 +1,117 @@
+/**
+ * file-path.ts unit tests: whether inline code in message text looks like a file path,
+ * and all branches of normalizing body paths to a Workspace-relative path (toWorkspaceRelative).
+ */
+import { describe, expect, it } from "vitest";
+import { isFilePathLike, toWorkspaceRelative } from "../src/lib/file-path";
+
+describe("isFilePathLike", () => {
+  it("相对路径 + 图片扩展名 → 命中", () => {
+    expect(isFilePathLike("./foo/bar.png")).toBe(true);
+  });
+
+  it("无斜杠的裸文件名 + 已知扩展名 → 命中", () => {
+    expect(isFilePathLike("report.pdf")).toBe(true);
+  });
+
+  it("多级相对路径 + 代码扩展名 → 命中", () => {
+    expect(isFilePathLike("src/lib/format.ts")).toBe(true);
+  });
+
+  it("前后空白会被裁剪，不影响命中", () => {
+    expect(isFilePathLike("  ./agentmind-architecture-minimal.png  ")).toBe(true);
+  });
+
+  it("裸词（无扩展名）→ 不命中", () => {
+    expect(isFilePathLike("hello")).toBe(false);
+  });
+
+  it("未知扩展名 → 不命中", () => {
+    expect(isFilePathLike("archive.xyz")).toBe(false);
+  });
+
+  it("版本号（数字扩展名）→ 不命中", () => {
+    expect(isFilePathLike("v1.2")).toBe(false);
+  });
+
+  it("URL（含 scheme）→ 不命中，即使结尾像扩展名", () => {
+    expect(isFilePathLike("https://example.com/report.pdf")).toBe(false);
+  });
+
+  it("裸域名（www 前缀）→ 不命中", () => {
+    expect(isFilePathLike("www.example.com")).toBe(false);
+  });
+
+  it("含空格的长句子（句中带点）→ 不命中", () => {
+    expect(isFilePathLike("See the report.pdf attached in this message.")).toBe(false);
+  });
+
+  it("空字符串 → 不命中", () => {
+    expect(isFilePathLike("")).toBe(false);
+  });
+});
+
+describe("toWorkspaceRelative", () => {
+  const WS = "/home/user/workspaces/tmp-1";
+
+  it("绝对路径命中 Workspace 前缀 → 剥前缀返回相对路径", () => {
+    expect(toWorkspaceRelative(`${WS}/report.pdf`, WS)).toBe("report.pdf");
+    expect(toWorkspaceRelative(`${WS}/sub/dir/a.txt`, WS)).toBe("sub/dir/a.txt");
+  });
+
+  it("绝对路径未命中前缀 / 等于 Workspace 本身 / 无 Workspace → null", () => {
+    expect(toWorkspaceRelative("/etc/passwd.txt", WS)).toBe(null);
+    // Sibling directory shares the prefix string but differs by a separator: not a match.
+    expect(toWorkspaceRelative(`${WS}-other/a.txt`, WS)).toBe(null);
+    expect(toWorkspaceRelative(WS, WS)).toBe(null);
+    expect(toWorkspaceRelative("/a/b.txt", null)).toBe(null);
+    expect(toWorkspaceRelative("/a/b.txt", "")).toBe(null);
+  });
+
+  it("绝对路径剥前缀后继续词法归一（含 .. 越根 → null）", () => {
+    expect(toWorkspaceRelative(`${WS}/sub/../a.txt`, WS)).toBe("a.txt");
+    expect(toWorkspaceRelative(`${WS}/../escape.txt`, WS)).toBe(null);
+  });
+
+  it("Windows 风格 Workspace：盘符/反斜杠绝对路径剥前缀并统一转 '/'", () => {
+    const win = "C:\\Users\\me\\ws";
+    expect(toWorkspaceRelative("C:\\Users\\me\\ws\\sub\\a.txt", win)).toBe("sub/a.txt");
+    expect(toWorkspaceRelative("D:\\other\\a.txt", win)).toBe(null);
+    expect(toWorkspaceRelative("C:\\Users\\me\\ws", win)).toBe(null);
+  });
+
+  it("POSIX 文件名里的反斜杠不做全局替换（仅 Windows 前缀命中时转换）", () => {
+    expect(toWorkspaceRelative("dir\\name.txt", WS)).toBe("dir\\name.txt");
+  });
+
+  it("相对路径词法归一：./ 与空段剔除、.. 弹栈", () => {
+    expect(toWorkspaceRelative("./foo/bar.png", WS)).toBe("foo/bar.png");
+    expect(toWorkspaceRelative("a/./b//c.txt", WS)).toBe("a/b/c.txt");
+    expect(toWorkspaceRelative("a/../b.txt", WS)).toBe("b.txt");
+  });
+
+  it("相对路径 .. 越出 Workspace 根 → null", () => {
+    expect(toWorkspaceRelative("../a.txt", WS)).toBe(null);
+    expect(toWorkspaceRelative("a/../../b.txt", WS)).toBe(null);
+  });
+
+  it("~ 开头（家目录）→ null", () => {
+    expect(toWorkspaceRelative("~/docs/a.txt", WS)).toBe(null);
+  });
+
+  it("纯文件名原样返回；Workspace 为 null 的相对路径照常归一", () => {
+    expect(toWorkspaceRelative("report.pdf", WS)).toBe("report.pdf");
+    expect(toWorkspaceRelative("sub/a.txt", null)).toBe("sub/a.txt");
+  });
+
+  it("空 / 纯空白 / 归一后为空（'.'）/ 超长（>512）→ null", () => {
+    expect(toWorkspaceRelative("", WS)).toBe(null);
+    expect(toWorkspaceRelative("   ", WS)).toBe(null);
+    expect(toWorkspaceRelative(".", WS)).toBe(null);
+    expect(toWorkspaceRelative(`a/${"x".repeat(512)}.txt`, WS)).toBe(null);
+  });
+
+  it("前后空白先裁剪再归一", () => {
+    expect(toWorkspaceRelative(`  ${WS}/a.txt  `, WS)).toBe("a.txt");
+  });
+});