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
This commit is contained in:
Yaowei ZhengandClaude Opus 4.8 authored and GitHub committed 2026-07-19 14:06:53 +08:00
1 parent 056bed7aeb
commit 45bfae6e94
543 files changed
+92949

No files matched your search

+178
View File
@@ -0,0 +1,178 @@
/**
* Integration tests for the schedule routes: CRUD and permissions (any member can read, only the owner can
* modify, outsiders get 404), 400 validation, 409 on name collision, hand-edited
* invalid files landing in invalidFiles, expired one-shot tasks marked missed
* during reconciliation, and the on-disk file shape.
*/
import fs from "node:fs/promises";
import path from "node:path";
import { afterEach, beforeEach, describe, expect, it } from "vitest";
import { scheduleDir } from "@prismshadow/penguin-core";
import type { ProjectCreateResponse, ScheduleItem, SchedulesResponse } from "../src/api/types.js";
import { apiClient, createTestApp, provisionUser } from "./helpers.js";
import type { TestApp } from "./helpers.js";
const FUTURE = "2099-01-01T09:00:00Z";
describe("schedules api", () => {
let t: TestApp;
let owner: ReturnType<typeof apiClient>;
let member: ReturnType<typeof apiClient>;
let outsider: ReturnType<typeof apiClient>;
let projectId: string;
let base: string;
beforeEach(async () => {
t = await createTestApp();
const a = await provisionUser(t.app, "owner_a");
const b = await provisionUser(t.app, "member_b");
const c = await provisionUser(t.app, "outsider_c");
owner = apiClient(t.app, a.cookie);
member = apiClient(t.app, b.cookie);
outsider = apiClient(t.app, c.cookie);
const created = (await (
await owner.post("/api/projects", { projectId: "owner_a-sched", name: "定时任务项目" })
).json()) as ProjectCreateResponse;
projectId = created.project.projectId;
base = `/api/projects/${projectId}/agents/default_agent/schedules`;
expect(
(await owner.post(`/api/projects/${projectId}/members`, { userId: "member_b" })).status,
).toBe(201);
});
afterEach(async () => {
await t.cleanup();
});
it("POST 创建(仅 owner)并落盘 TOML;GET 列表与单条;DELETE 清理", async () => {
const body = {
name: "daily-report",
prompt: "写日报",
enabled: true,
startAt: FUTURE,
period: "30m",
};
expect((await member.post(base, body)).status).toBe(403);
const createdRes = await owner.post(base, body);
expect(createdRes.status).toBe(201);
const item = (await createdRes.json()) as ScheduleItem;
expect(item).toMatchObject({
name: "daily-report",
prompt: "写日报",
enabled: true,
period: "30m",
status: "active",
queued: false,
creatorUserId: "owner_a",
nextFireAt: "2099-01-01T09:00:00.000Z",
});
// The filename is the identifier; the TOML lands under agent_state/schedule/.
const file = path.join(scheduleDir(t.root, projectId, "default_agent"), "daily-report.toml");
const raw = await fs.readFile(file, "utf8");
expect(raw).toContain('prompt = "写日报"');
expect(raw).toContain('period = "30m"');
// Any member can read; outsiders get 404.
const list = (await (await member.get(base)).json()) as SchedulesResponse;
expect(list.schedules.map((s) => s.name)).toEqual(["daily-report"]);
expect(list.invalidFiles).toEqual([]);
expect((await outsider.get(base)).status).toBe(404);
expect((await member.get(`${base}/daily-report`)).status).toBe(200);
// Name collision returns 409.
expect((await owner.post(base, body)).status).toBe(409);
// Delete (owner only): removes both the file and the state.
expect((await member.delete(`${base}/daily-report`)).status).toBe(403);
expect((await owner.delete(`${base}/daily-report`)).status).toBe(204);
await expect(fs.access(file)).rejects.toThrow();
expect((await owner.delete(`${base}/daily-report`)).status).toBe(404);
});
it("新建 Session 模式可指定 workspace 与成对模型引用并回显", async () => {
// The model reference is given as a pair (provider + modelId), and it must
// resolve within the Project config.
const res = await owner.post(base, {
name: "fresh",
prompt: "p",
enabled: true,
startAt: FUTURE,
workspace: "/tmp/ws",
provider: "deepseek",
modelId: "deepseek-v4-pro",
});
expect(res.status).toBe(201);
expect((await res.json()) as ScheduleItem).toMatchObject({
workspace: "/tmp/ws",
provider: "deepseek",
modelId: "deepseek-v4-pro",
});
});
it("模型引用不可解析(配置里没有)即 400,不落盘", async () => {
const res = await owner.post(base, {
name: "bad-model",
prompt: "p",
enabled: true,
startAt: FUTURE,
provider: "custom",
modelId: "not-configured",
});
expect(res.status).toBe(400);
expect((await owner.get(`${base}/bad-model`)).status).toBe(404);
});
it("PUT 整文件替换(仅 owner);不存在 404", async () => {
const body = { name: "job", prompt: "p1", enabled: false, startAt: FUTURE };
expect((await owner.post(base, body)).status).toBe(201);
expect(
(await member.put(`${base}/job`, { prompt: "p2", enabled: true, startAt: FUTURE })).status,
).toBe(403);
const updated = await owner.put(`${base}/job`, {
prompt: "p2",
enabled: true,
startAt: FUTURE,
sessionId: "session-2099",
});
expect(updated.status).toBe(200);
expect((await updated.json()) as ScheduleItem).toMatchObject({
prompt: "p2",
enabled: true,
sessionId: "session-2099",
status: "active",
});
expect(
(await owner.put(`${base}/nope`, { prompt: "p", enabled: false, startAt: FUTURE })).status,
).toBe(404);
});
it("校验 400:period 低于下限、时刻非法、目标二选一、任务名非法", async () => {
const ok = { prompt: "p", enabled: false, startAt: FUTURE };
const cases = [
{ name: "j1", ...ok, period: "4m" },
{ name: "j2", ...ok, startAt: "someday" },
{ name: "j3", ...ok, sessionId: "s", workspace: "/w" },
{ name: "bad.name", ...ok },
];
for (const body of cases) {
expect((await owner.post(base, body)).status, JSON.stringify(body)).toBe(400);
}
});
it("手编文件:非法进 invalidFiles;过期一次性任务对账标记 missed", async () => {
const dir = scheduleDir(t.root, projectId, "default_agent");
await fs.mkdir(dir, { recursive: true });
await fs.writeFile(path.join(dir, "broken.toml"), "not = toml =", "utf8");
await fs.writeFile(
path.join(dir, "stale.toml"),
`prompt = "s"\nenabled = true\nstart_at = "2020-01-01T00:00:00Z"\n`,
"utf8",
);
const list = (await (await owner.get(base)).json()) as SchedulesResponse;
expect(list.invalidFiles.map((f) => f.name)).toEqual(["broken"]);
const stale = list.schedules.find((s) => s.name === "stale");
expect(stale?.status).toBe("missed");
// For a hand-edited file, the creator falls back to the Project owner.
expect(stale?.creatorUserId).toBe("owner_a");
});
});