@jennie-shawn/starwork 0.1.0-alpha.0

package/cli/test/init.test.js

@@ -0,0 +1,436 @@
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const test = require("node:test");
+const assert = require("node:assert/strict");
+const { execFileSync, spawnSync } = require("node:child_process");
+
+const root = path.resolve(__dirname, "..", "..");
+const bin = path.join(root, "cli", "bin", "starwork.js");
+
+function tempDir() {
+  return fs.mkdtempSync(path.join(os.tmpdir(), "starwork-init-test-"));
+}
+
+function runInit(args) {
+  return execFileSync(process.execPath, [bin, "init", ...args], {
+    cwd: root,
+    encoding: "utf8"
+  });
+}
+
+function runDoctor(args) {
+  return spawnSync(process.execPath, [bin, "doctor", ...args], {
+    cwd: root,
+    encoding: "utf8"
+  });
+}
+
+function runCommand(args) {
+  return spawnSync(process.execPath, [bin, ...args], {
+    cwd: root,
+    encoding: "utf8"
+  });
+}
+
+function readJson(file) {
+  return JSON.parse(fs.readFileSync(file, "utf8"));
+}
+
+test("dry-run does not write files", () => {
+  const dir = tempDir();
+  const output = runInit(["--type", "single-light", "--pack", "general", "--target", dir, "--dry-run"]);
+
+  assert.match(output, /初始化预览/);
+  assert.equal(fs.existsSync(path.join(dir, "AGENTS.md")), false);
+  assert.equal(fs.existsSync(path.join(dir, ".starwork", "workspace.json")), false);
+});
+
+test("creates a single-light workspace with general pack", () => {
+  const dir = tempDir();
+  runInit(["--type", "single-light", "--pack", "general", "--target", dir, "--yes"]);
+
+  const state = readJson(path.join(dir, ".starwork", "workspace.json"));
+  assert.equal(state.workspace_type, "single-light");
+  assert.equal(state.kit, "local-starter");
+  assert.equal(state.packs[0].id, "general");
+  assert.equal(fs.existsSync(path.join(dir, "AGENTS.md")), true);
+  assert.equal(fs.existsSync(path.join(dir, "输出", "确认成果", "README.md")), true);
+  assert.equal(fs.existsSync(path.join(dir, "_系统", "身份", "README.md")), true);
+  assert.equal(fs.existsSync(path.join(dir, "_系统", "教训", "README.md")), true);
+});
+
+test("creates a single-matter workspace with content creator pack", () => {
+  const dir = tempDir();
+  runInit(["--type", "single-matter", "--pack", "content-creator", "--target", dir, "--yes"]);
+
+  const state = readJson(path.join(dir, ".starwork", "workspace.json"));
+  const agents = fs.readFileSync(path.join(dir, "AGENTS.md"), "utf8");
+  assert.equal(state.workspace_type, "single-matter");
+  assert.equal(state.packs[0].id, "content-creator");
+  assert.equal(state.paths.formal_source, "发布记录/");
+  assert.match(agents, /自媒体内容生产流/);
+  assert.equal(fs.existsSync(path.join(dir, "事项", "注册表.md")), true);
+  assert.equal(fs.existsSync(path.join(dir, "发布记录", "README.md")), true);
+  assert.equal(fs.existsSync(path.join(dir, ".starwork", "packs", "content-creator", "templates", "content-brief.md")), true);
+});
+
+test("creates a hub workspace with hub management pack", () => {
+  const dir = tempDir();
+  runInit(["--type", "hub", "--target", dir, "--yes"]);
+
+  const state = readJson(path.join(dir, ".starwork", "workspace.json"));
+  assert.equal(state.workspace_type, "hub");
+  assert.equal(state.kit, "hub");
+  assert.equal(state.packs[0].id, "hub-management");
+  assert.equal(fs.existsSync(path.join(dir, "项目", "registry.json")), true);
+  assert.equal(fs.existsSync(path.join(dir, "知识", "README.md")), true);
+  assert.equal(fs.existsSync(path.join(dir, ".incoming", "README.md")), true);
+});
+
+test("does not overwrite existing user files", () => {
+  const dir = tempDir();
+  fs.writeFileSync(path.join(dir, "README.md"), "# Existing\n", "utf8");
+
+  runInit(["--type", "single-light", "--pack", "general", "--target", dir, "--yes"]);
+
+  assert.equal(fs.readFileSync(path.join(dir, "README.md"), "utf8"), "# Existing\n");
+  assert.equal(fs.existsSync(path.join(dir, "README.starwork-new.md")), true);
+});
+
+test("doctor passes on a single-light workspace with general pack", () => {
+  const dir = tempDir();
+  runInit(["--type", "single-light", "--pack", "general", "--target", dir, "--yes"]);
+
+  const result = runDoctor(["--target", dir]);
+
+  assert.equal(result.status, 0);
+  assert.match(result.stdout, /Workspace is healthy/);
+});
+
+test("doctor passes on a single-matter workspace with content creator pack", () => {
+  const dir = tempDir();
+  runInit(["--type", "single-matter", "--pack", "content-creator", "--target", dir, "--yes"]);
+
+  const result = runDoctor(["--target", dir, "--json"]);
+  const report = JSON.parse(result.stdout);
+
+  assert.equal(result.status, 0);
+  assert.equal(report.ok, true);
+  assert.equal(report.workspace.workspace_type, "single-matter");
+  assert.deepEqual(report.workspace.packs, ["content-creator"]);
+});
+
+test("doctor passes on a hub workspace", () => {
+  const dir = tempDir();
+  runInit(["--type", "hub", "--target", dir, "--yes"]);
+
+  const result = runDoctor(["--target", dir]);
+
+  assert.equal(result.status, 0);
+  assert.match(result.stdout, /Workspace is healthy/);
+});
+
+test("spawn creates a matter project from a hub", () => {
+  const hub = tempDir();
+  const target = tempDir();
+  runInit(["--type", "hub", "--target", hub, "--yes"]);
+
+  const spawn = runCommand(["spawn", "--hub", hub, "--name", "Content Site", "--id", "content-site", "--target", target, "--mode", "matter", "--yes"]);
+  const state = readJson(path.join(target, ".starwork", "workspace.json"));
+  const sync = readJson(path.join(target, ".core-sync.json"));
+  const registry = readJson(path.join(hub, "项目", "registry.json"));
+  const doctor = runDoctor(["--target", target, "--json"]);
+  const report = JSON.parse(doctor.stdout);
+
+  assert.equal(spawn.status, 0);
+  assert.equal(state.workspace_type, "satellite-matter");
+  assert.equal(state.kit, "satellite-matter");
+  assert.equal(state.hub.project_id, "content-site");
+  assert.equal(sync.project_id, "content-site");
+  assert.equal(registry.projects[0].id, "content-site");
+  assert.equal(registry.projects[0].path, path.resolve(target));
+  assert.equal(fs.lstatSync(path.join(target, "知识")).isSymbolicLink(), true);
+  assert.equal(fs.lstatSync(path.join(target, ".agents", "skills")).isSymbolicLink(), true);
+  assert.equal(doctor.status, 0);
+});
+
+test("spawn creates a starter project from a hub", () => {
+  const hub = tempDir();
+  const target = tempDir();
+  runInit(["--type", "hub", "--target", hub, "--yes"]);
+
+  const spawn = runCommand(["spawn", "--hub", hub, "--name", "Quick Project", "--id", "quick-project", "--target", target, "--mode", "starter", "--yes"]);
+  const state = readJson(path.join(target, ".starwork", "workspace.json"));
+  const doctor = runDoctor(["--target", target, "--json"]);
+  const report = JSON.parse(doctor.stdout);
+
+  assert.equal(spawn.status, 0);
+  assert.equal(state.workspace_type, "satellite-starter");
+  assert.equal(state.kit, "satellite-starter");
+  assert.equal(fs.existsSync(path.join(target, "事项")), false);
+  assert.equal(doctor.status, 0);
+});
+
+test("spawn creates a customized project from a blueprint", () => {
+  const hub = tempDir();
+  const target = tempDir();
+  const blueprintDir = tempDir();
+  fs.mkdirSync(path.join(blueprintDir, "rules"), { recursive: true });
+  fs.mkdirSync(path.join(blueprintDir, "seed", "会议纪要"), { recursive: true });
+  fs.writeFileSync(path.join(blueprintDir, "rules", "file-boundaries.md"), "正式成果放在 {{paths.formal_source}}。\n", "utf8");
+  fs.writeFileSync(path.join(blueprintDir, "rules", "workflow.md"), "当前推进放在 {{paths.business_work_area}}。\n", "utf8");
+  fs.writeFileSync(path.join(blueprintDir, "seed", "会议纪要", "README.md"), "# 会议纪要\n\n项目：{{project.name}}\n", "utf8");
+  fs.writeFileSync(path.join(blueprintDir, "blueprint.json"), `${JSON.stringify({
+    schema: "starwork.spawn_blueprint.v0.1",
+    name: "Blueprint Project",
+    project_id: "blueprint-project",
+    description: "用 blueprint 生成的定制项目。",
+    base: {
+      mode: "matter",
+      kit: "satellite-matter",
+      language: "zh"
+    },
+    paths: {
+      formal_source: "交付物/确认版本/",
+      business_work_area: "事项/"
+    },
+    folders: [
+      "资料库/",
+      "会议纪要/",
+      "版本记录/",
+      "交付物/确认版本/"
+    ],
+    agent_rules: [
+      { slot: "project.file_boundaries", from: "rules/file-boundaries.md" },
+      { slot: "project.workflow", from: "rules/workflow.md" }
+    ],
+    seed: [
+      { from: "seed/会议纪要/README.md", to: "会议纪要/README.md", on_conflict: "error" }
+    ]
+  }, null, 2)}\n`, "utf8");
+  runInit(["--type", "hub", "--target", hub, "--yes"]);
+
+  const spawn = runCommand(["spawn", "--hub", hub, "--target", target, "--blueprint", path.join(blueprintDir, "blueprint.json"), "--yes"]);
+  const state = readJson(path.join(target, ".starwork", "workspace.json"));
+  const agents = fs.readFileSync(path.join(target, "AGENTS.md"), "utf8");
+  const projectStatus = fs.readFileSync(path.join(target, "_系统", "上下文", "当前项目.md"), "utf8");
+  const seed = fs.readFileSync(path.join(target, "会议纪要", "README.md"), "utf8");
+  const registry = readJson(path.join(hub, "项目", "registry.json"));
+  const doctor = runDoctor(["--target", target, "--json"]);
+  const report = JSON.parse(doctor.stdout);
+
+  assert.equal(spawn.status, 0);
+  assert.equal(state.workspace_type, "satellite-matter");
+  assert.equal(state.paths.formal_source, "交付物/确认版本/");
+  assert.equal(state.customization.type, "spawn_blueprint");
+  assert.equal(state.customization.agent_rules[0].slot, "project.file_boundaries");
+  assert.equal(fs.existsSync(path.join(target, "资料库")), true);
+  assert.equal(fs.existsSync(path.join(target, "交付物", "确认版本")), true);
+  assert.match(agents, /StarWork Blueprint: project\.file_boundaries/);
+  assert.match(agents, /正式成果放在 交付物\/确认版本\//);
+  assert.match(projectStatus, /工作区定制/);
+  assert.match(seed, /项目：Blueprint Project/);
+  assert.equal(registry.projects[0].customized, true);
+  assert.equal(doctor.status, 0);
+  assert(report.checks.some((check) => check.id === "blueprint.folder.exists" && check.level === "pass"));
+  assert(report.checks.some((check) => check.id === "blueprint.rule.injected" && check.level === "pass"));
+});
+
+test("spawn blueprint dry-run does not write target or registry", () => {
+  const hub = tempDir();
+  const target = tempDir();
+  const blueprintDir = tempDir();
+  fs.writeFileSync(path.join(blueprintDir, "blueprint.json"), `${JSON.stringify({
+    schema: "starwork.spawn_blueprint.v0.1",
+    name: "Dry Blueprint",
+    base: {
+      mode: "starter",
+      kit: "satellite-starter",
+      language: "zh"
+    },
+    paths: {
+      formal_source: "交付物/",
+      business_work_area: "参考资料/"
+    },
+    folders: ["交付物/"]
+  }, null, 2)}\n`, "utf8");
+  runInit(["--type", "hub", "--target", hub, "--yes"]);
+
+  const result = runCommand(["spawn", "--hub", hub, "--target", target, "--blueprint", path.join(blueprintDir, "blueprint.json"), "--dry-run"]);
+  const registry = readJson(path.join(hub, "项目", "registry.json"));
+
+  assert.equal(result.status, 0);
+  assert.match(result.stdout, /Blueprint/);
+  assert.equal(fs.existsSync(path.join(target, ".starwork", "workspace.json")), false);
+  assert.deepEqual(registry.projects, []);
+});
+
+test("spawn blueprint rejects unsafe paths", () => {
+  const hub = tempDir();
+  const target = tempDir();
+  const blueprintDir = tempDir();
+  fs.writeFileSync(path.join(blueprintDir, "blueprint.json"), `${JSON.stringify({
+    schema: "starwork.spawn_blueprint.v0.1",
+    name: "Unsafe Blueprint",
+    base: {
+      mode: "matter",
+      kit: "satellite-matter",
+      language: "zh"
+    },
+    paths: {
+      formal_source: "../escape/",
+      business_work_area: "事项/"
+    }
+  }, null, 2)}\n`, "utf8");
+  runInit(["--type", "hub", "--target", hub, "--yes"]);
+
+  const result = runCommand(["spawn", "--hub", hub, "--target", target, "--blueprint", path.join(blueprintDir, "blueprint.json"), "--yes"]);
+
+  assert.equal(result.status, 1);
+  assert.match(result.stderr, /不能跳出工作区/);
+});
+
+test("spawn refuses duplicate registry id", () => {
+  const hub = tempDir();
+  const first = tempDir();
+  const second = tempDir();
+  runInit(["--type", "hub", "--target", hub, "--yes"]);
+  runCommand(["spawn", "--hub", hub, "--name", "First", "--id", "same-id", "--target", first, "--yes"]);
+
+  const duplicate = runCommand(["spawn", "--hub", hub, "--name", "Second", "--id", "same-id", "--target", second, "--yes"]);
+
+  assert.equal(duplicate.status, 1);
+  assert.match(duplicate.stderr, /已存在项目 ID/);
+});
+
+test("spawn refuses non-hub workspaces", () => {
+  const workspace = tempDir();
+  const target = tempDir();
+  runInit(["--type", "single-light", "--pack", "general", "--target", workspace, "--yes"]);
+
+  const result = runCommand(["spawn", "--hub", workspace, "--name", "Nope", "--id", "nope", "--target", target, "--yes"]);
+
+  assert.equal(result.status, 1);
+  assert.match(result.stderr, /多项目管理中枢/);
+});
+
+test("spawn refuses non-empty target directories", () => {
+  const hub = tempDir();
+  const target = tempDir();
+  fs.writeFileSync(path.join(target, "existing.txt"), "user content\n", "utf8");
+  runInit(["--type", "hub", "--target", hub, "--yes"]);
+
+  const result = runCommand(["spawn", "--hub", hub, "--name", "Existing", "--id", "existing", "--target", target, "--yes"]);
+
+  assert.equal(result.status, 1);
+  assert.match(result.stderr, /目标目录已有内容/);
+});
+
+test("doctor fails when AGENTS.md is missing", () => {
+  const dir = tempDir();
+  runInit(["--type", "single-light", "--pack", "general", "--target", dir, "--yes"]);
+  fs.rmSync(path.join(dir, "AGENTS.md"));
+
+  const result = runDoctor(["--target", dir]);
+
+  assert.equal(result.status, 1);
+  assert.match(result.stdout, /core\.entry_rules\.exists/);
+});
+
+test("doctor fails when the formal source is missing", () => {
+  const dir = tempDir();
+  runInit(["--type", "single-light", "--pack", "general", "--target", dir, "--yes"]);
+  fs.rmSync(path.join(dir, "输出", "确认成果"), { recursive: true, force: true });
+
+  const result = runDoctor(["--target", dir, "--json"]);
+  const report = JSON.parse(result.stdout);
+
+  assert.equal(result.status, 1);
+  assert.equal(report.ok, false);
+  assert(report.checks.some((check) => check.id === "core.formal_source.exists" && check.level === "fail"));
+});
+
+test("doctor fails when pack seed is missing", () => {
+  const dir = tempDir();
+  runInit(["--type", "single-matter", "--pack", "content-creator", "--target", dir, "--yes"]);
+  fs.rmSync(path.join(dir, "选题池", "README.md"));
+
+  const result = runDoctor(["--target", dir, "--json"]);
+  const report = JSON.parse(result.stdout);
+
+  assert.equal(result.status, 1);
+  assert(report.checks.some((check) => check.id === "pack.seed.installed" && check.level === "fail"));
+});
+
+test("doctor fails outside a StarWork workspace", () => {
+  const dir = tempDir();
+
+  const result = runDoctor(["--target", dir]);
+
+  assert.equal(result.status, 1);
+  assert.match(result.stdout, /不是 StarWork 工作台/);
+});
+
+test("adapt creates a Claude adapter and records it in workspace state", () => {
+  const dir = tempDir();
+  runInit(["--type", "single-light", "--pack", "general", "--target", dir, "--yes"]);
+
+  const result = runCommand(["adapt", "claude", "--target", dir, "--yes"]);
+  const state = readJson(path.join(dir, ".starwork", "workspace.json"));
+  const claude = fs.readFileSync(path.join(dir, "CLAUDE.md"), "utf8");
+
+  assert.equal(result.status, 0);
+  assert.match(claude, /StarWork Adapter for Claude Code/);
+  assert.equal(state.adapters[0].id, "claude");
+});
+
+test("adapt creates Cursor rules", () => {
+  const dir = tempDir();
+  runInit(["--type", "single-light", "--pack", "general", "--target", dir, "--yes"]);
+
+  const result = runCommand(["adapt", "--agent", "cursor", "--target", dir, "--yes"]);
+  const cursorRule = fs.readFileSync(path.join(dir, ".cursor", "rules", "starwork.mdc"), "utf8");
+
+  assert.equal(result.status, 0);
+  assert.match(cursorRule, /alwaysApply: true/);
+  assert.match(cursorRule, /AGENTS\.md/);
+});
+
+test("pack install adds content creator pack to an existing workspace", () => {
+  const dir = tempDir();
+  runInit(["--type", "single-light", "--pack", "general", "--target", dir, "--yes"]);
+
+  const install = runCommand(["pack", "install", "content-creator", "--target", dir, "--yes"]);
+  const state = readJson(path.join(dir, ".starwork", "workspace.json"));
+  const agents = fs.readFileSync(path.join(dir, "AGENTS.md"), "utf8");
+  const doctor = runDoctor(["--target", dir]);
+
+  assert.equal(install.status, 0);
+  assert.deepEqual(state.packs.map((pack) => pack.id), ["general", "content-creator"]);
+  assert.equal(state.paths.formal_source, "发布记录/");
+  assert.equal(fs.existsSync(path.join(dir, "发布记录", "README.md")), true);
+  assert.equal(fs.existsSync(path.join(dir, ".starwork", "packs", "content-creator", "templates", "content-brief.md")), true);
+  assert.match(agents, /StarWork Pack: content-creator/);
+  assert.equal(doctor.status, 0);
+});
+
+test("pack install refuses unsupported workspace types", () => {
+  const dir = tempDir();
+  runInit(["--type", "hub", "--target", dir, "--yes"]);
+
+  const result = runCommand(["pack", "install", "content-creator", "--target", dir, "--yes"]);
+
+  assert.equal(result.status, 1);
+  assert.match(result.stderr, /不支持工作区类型 hub/);
+});
+
+test("pack install skips already installed packs", () => {
+  const dir = tempDir();
+  runInit(["--type", "single-light", "--pack", "general", "--target", dir, "--yes"]);
+
+  const result = runCommand(["pack", "install", "general", "--target", dir, "--yes"]);
+
+  assert.equal(result.status, 0);
+  assert.match(result.stdout, /已安装/);
+});

package/core/README.md

@@ -0,0 +1,51 @@
+# StarWork Core
+
+StarWork Core 是面向 AI 协作项目的工作区协议。
+
+先读：[StarWork Core v0.1 协议总览](./core-v0.1-protocol.md)。
+
+Core v0.1 定义：
+
+- Agent 开始工作前先读什么
+- 项目状态和当前工作分别放在哪里
+- 过程材料如何与正式事实源分离
+- 轻量的 `references/outputs` 工作区如何与 Matter 工作区并存
+- CLI、Adapters、Packs 和模板如何基于同一套协议工作
+
+## 仓库维护模型
+
+Core 用“一套基线 + 可组合的 profile 和 capability”来维护：
+
+```text
+product/core/
+├── baseline/       # 每个 Core 工作区都必须遵守的共同语义
+├── profiles/       # 语言、路径和模板映射，例如 zh 与 en
+├── capabilities/   # 可选能力，例如 Starter Mode 和 Matter Mode
+├── presets/        # 面向用户状态的组合配方
+└── kits/           # 由 preset 组装出来的可复制模板包
+```
+
+## 维护规则
+
+- 共同规则改 `baseline/`。
+- 路径、模板语言、CLI 提问和用户可见名称改 `profiles/`。
+- 可选行为改 `capabilities/`。
+- 面向用户的组合状态改 `presets/`。
+- `kits/` 是生成或组装结果，不是协议事实源。
+
+## Hub + Satellite 模型
+
+多项目模式由 `main-repo-sync` 表达，不拆成 `shared-identity` 和 `shared-lessons` 这类局部开关。
+
+在这个模型里：
+
+- Hub 维护可复用规则、身份、教训、知识、共享 skills、项目注册元数据、跨项目联络和回写审核。
+- Satellite 工作区维护自己的项目状态、当前工作、过程材料、项目决策和正式事实源。
+- 快照、只读链接、`.core-sync.json` 和审核队列共同定义同步边界。
+- Hub 可以读取 Satellite 状态，但不会把状态正文复制进 registry。
+
+## v0.1 范围
+
+Core v0.1 故意保持小。它先冻结最小工作区语义，再让 CLI、Packs 和 Adapters 在其上增加自动化。
+
+Core 不包含自媒体内容创作者的专属工作流逻辑。那部分属于 `product/packs/content-creator/`。

package/core/baseline/README.md

@@ -0,0 +1,12 @@
+# Baseline
+
+`baseline/` 是 Core 共同语义的事实源。
+
+无论用户使用哪种语言、哪种路径、启用哪些能力，每个 StarWork Core 工作区都必须遵守这里定义的含义。
+
+## 文件
+
+- `spec.md`：基线定义和必需行为
+- `roles.md`：标准角色
+- `file-boundaries.md`：不同内容应该写到哪里
+- `health-check.md`：未来 CLI `doctor` 的检查规则

package/core/baseline/file-boundaries.md

@@ -0,0 +1,25 @@
+# File Boundaries v0.1
+
+## 必需基线文件
+
+| 文件角色 | 应该写这里 | 不应该写这里 |
+|---|---|---|
+| `agent.entry_rules` | Agent 在这个工作区应该如何工作。 | 项目状态、任务历史、草稿正文。 |
+| `system.context.project_status` | 目标、阶段、重点、风险、正式事实源位置。 | 单次会话笔记、草稿正文、详细事项进度。 |
+| `system.tasks.current_work` | 当前任务、活跃事项、阻塞点、等待确认的问题。 | 长期背景、完整设计稿、项目历史。 |
+
+## 可选能力文件
+
+| 能力 | 边界 |
+|---|---|
+| `decisions` | 只记录会影响后续工作的高影响、已确认决策。 |
+| `starter-outputs` | `references/` 是只读原始资料；`outputs/drafts/` 是未确认 AI 草稿；`outputs/final/` 是用户确认成果。 |
+| `matter-mode` | 事项目录是过程工作区；成熟内容必须晋升到项目正式事实源。 |
+| `local-identity` | 项目本地身份参考，只能在用户确认后修改。 |
+| `local-lessons` | 项目本地可复用教训，不是普通复盘流水。 |
+| `main-repo-sync` | Hub 资源通过快照、只读链接、元数据和审核队列进入卫星项目；Hub registry 不存项目进度正文。 |
+| `skill-mount` | 共享 skills 从主库软链接挂载，不复制成独立分叉。 |
+
+## 正式事实源规则
+
+每个工作区都必须声明正式事实源放在哪里。Core 不要求该目录一定叫 `product/`。

package/core/baseline/health-check.md

@@ -0,0 +1,27 @@
+# Core Health Check v0.1
+
+一个工作区满足以下条件时，可视为 Core v0.1 健康：
+
+- `agent.entry_rules` 存在。
+- `system.context.project_status` 存在。
+- `system.tasks.current_work` 存在。
+- 入口规则或项目状态中声明了正式事实源。
+- 已启用的可选能力文件遵守自身边界。
+- 使用 `main-repo-sync` 的卫星项目包含 `.core-sync.json`。
+
+## 警告项
+
+检查器遇到以下情况应给出警告：
+
+- 当前工作文件包含大段项目历史。
+- 项目状态文件包含任务级流水，不论实际路径映射成 `_系统/上下文/项目状态.md`、`_系统/上下文/当前项目.md` 还是英文路径。
+- 决策记录写入会议纪要或局部草稿选择。
+- `references/` 被当成生成成果来改写。
+- Matter 草稿被当成正式事实源。
+- 卫星项目在未确认情况下修改主库快照或软链接 skill。
+
+## 兼容性
+
+`system.context.project_status` 是角色，不是强制文件名。
+
+对当前由 Hub 管理的中文卫星项目，`_系统/上下文/当前项目.md` 是兼容事实源。中文本地单项目 Kit 使用 `_系统/上下文/项目状态.md`。检查器和 adapter 必须读取 profile / preset 声明，不能假设所有工作区都使用同一个文件名。

package/core/baseline/roles.md

@@ -0,0 +1,26 @@
+# Core Roles v0.1
+
+## 标准角色
+
+| 标准角色 | 是否必需 | 说明 |
+|---|---:|---|
+| `agent.entry_rules` | 是 | 所有 Agent 进入项目时必须读取的工作规则。 |
+| `system.context.project_status` | 是 | 变化较慢的项目状态。 |
+| `system.tasks.current_work` | 是 | 当前工作、阻塞点和下一次交接入口。 |
+| `system.context.decisions` | 否 | 高影响决策记录。 |
+| `work.starter.references` | 否 | Starter Mode 中默认只读的原始资料。 |
+| `work.starter.outputs_drafts` | 否 | 等待用户审阅的 AI 草稿。 |
+| `work.starter.outputs_final` | 否 | 用户确认后的成果。 |
+| `work.matters.registry` | 否 | Matter Mode 的事项索引。 |
+| `identity.local` | 否 | 项目本地身份参考。 |
+| `lessons.local` | 否 | 项目本地可复用教训。 |
+| `main_repo.sync_metadata` | 否 | 卫星项目与主库同步的元数据。 |
+| `main_repo.knowledge_link` | 否 | 只读共享知识链接。 |
+| `main_repo.internal_protocols` | 否 | 从主库复制的内部协议快照。 |
+| `main_repo.skill_mounts` | 否 | 通过软链接挂载的共享 skills。 |
+
+## 规则
+
+Profiles 负责把标准角色映射到具体路径。Capabilities 可以要求或推荐额外角色，但不能改变 baseline 角色的含义。
+
+`system.context.project_status` 刻意使用角色名，而不是绑定单一文件名。Preset 可以把它映射到 `project-status.md`、`current-projects.md` 或其他声明文件，但一个工作区只能有一个项目状态事实源。

package/core/baseline/spec.md

@@ -0,0 +1,47 @@
+# Core Baseline v0.1
+
+## 定义
+
+StarWork Core Baseline 是人和 AI Agent 共同使用一个工作区时的最小语义契约。
+
+它定义角色、边界和健康检查。它不定义具体业务领域、不绑定某个 Agent Runtime，也不强制唯一的语言路径结构。
+
+## 必需角色
+
+一个 Core v0.1 工作区必须提供这些角色：
+
+| 角色 | 用途 |
+|---|---|
+| `agent.entry_rules` | 跨 Agent 的工作规则入口。 |
+| `system.context.project_status` | 稳定的项目状态和正式事实源指针。 |
+| `system.tasks.current_work` | 下一次 Agent 会话进入当前工作的入口。 |
+
+## 必需行为
+
+- Agent 修改工作区前必须先读入口规则。
+- 当前工作必须有稳定入口文件。
+- 项目必须声明正式事实源在哪里。
+- 过程材料不能被悄悄当成正式事实源。
+- 只读参考层不能在没有用户明确确认的情况下被改写。
+
+## 可选能力
+
+Capabilities 可以增加文件和行为，但不能重新定义 baseline 的含义：
+
+- `starter-outputs`
+- `matter-mode`
+- `decisions`
+- `local-identity`
+- `local-lessons`
+- `main-repo-sync`
+- `skill-mount`
+
+## 不做什么
+
+Core v0.1 不定义：
+
+- Pack 专属工作流
+- CLI 命令实现
+- 特定 Agent Runtime 行为
+- 强制性的机器可读 manifest
+- 所有用户都必须拥有事项目录

package/core/capabilities/README.md

@@ -0,0 +1,15 @@
+# Capabilities
+
+Capabilities 是 Core 的可选能力，可以通过 presets 组合。
+
+它们不能重新定义 baseline 角色的含义。
+
+## v0.1 包含
+
+- `starter-outputs`：`references/` + `outputs/`
+- `matter-mode`：事项工作区与事项维护要求
+- `decisions`：高影响决策记录
+- `local-identity`：项目本地身份
+- `local-lessons`：项目本地教训
+- `main-repo-sync`：主库与卫星项目的同步模型
+- `skill-mount`：通过软链接挂载共享 skills

package/core/capabilities/decisions/capability.md

@@ -0,0 +1,26 @@
+# Capability: decisions v0.1
+
+`decisions` 能力为工作区增加高影响决策记录。
+
+## 规则
+
+决策记录文件是可选文件。中文 profile 默认映射为 `_系统/上下文/决策.md`，英文 profile 可映射为 `decisions.md`。它不是会议纪要、任务日志，也不是草稿历史。
+
+只有同时满足以下条件时，才写入一条决策：
+
+1. 这个判断已经被确认。
+2. 它会影响未来工作，而不只是影响某个局部草稿。
+3. 未来 Agent 需要读到它，才能避免重复争论或重走旧路。
+
+## 示例
+
+适合写入：
+
+- Core v0.1 支持 Starter Mode 和 Matter Mode。
+- Matter Mode 是可选能力，不是 baseline 必需项。
+
+不适合写入：
+
+- 某次讨论了三个方案。
+- 这个草稿使用 B 版本。
+- 明天需要问用户。