@pm_zhousl/xinyun-ai-init 2.0.0 → 3.0.0

package/scripts/verify-release-gate.js

@@ -5,37 +5,24 @@ const path = require("path");
 
 const root = path.resolve(__dirname, "..");
 const packageJson = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
-const contract = JSON.parse(fs.readFileSync(path.join(root, "test-scenarios", "v2.0.0-behavior-evidence.json"), "utf8"));
-const probePath = path.join(root, "test-scenarios", "v2.0.0-real-host-probe.json");
-const requiredOperations = ["create-or-reuse", "send", "receive", "query-status", "recover", "close", "control-file-read-write"];
+const evidencePath = path.join(root, "test-scenarios", "v3.0.0-behavior-evidence.json");
 
 function main() {
   const errors = [];
-  if (packageJson.name !== "@pm_zhousl/xinyun-ai-init" || packageJson.version !== "2.0.0") errors.push("package identity must be @pm_zhousl/xinyun-ai-init@2.0.0");
-  if (contract.version !== "2.0.0" || contract.evidenceType !== "contract-regression" || contract.scenarios.length !== 15) errors.push("v2 contract evidence is incomplete");
-  if (!contract.scenarios.every((scenario, index) => scenario.scenarioId === 401 + index && scenario.result === "contract-passed")) errors.push("v2 scenarios 401-415 must pass contract validation");
-  if (!contract.sensitiveScan || contract.sensitiveScan.status !== "pass" || contract.sensitiveScan.matches.length !== 0) errors.push("contract sensitive scan is not clean");
-
-  if (!fs.existsSync(probePath)) {
-    errors.push("real host probe is missing; run probe:v2 with verified interaction and Skill-run evidence");
-  } else {
-    const probe = JSON.parse(fs.readFileSync(probePath, "utf8"));
-    if (probe.version !== "2.0.0" || probe.executionModel !== "shared-project-multi-conversation-runtime") errors.push("real host probe contract is incorrect");
-    if (probe.evidenceType !== "real-cross-conversation" || probe.executionMode !== "real-host" || probe.realCrossConversationVerified !== true) errors.push("real host cross-conversation behavior is not verified");
-    if (probe.readyEligible !== true || probe.publishBlocked !== false) errors.push("real host readiness gate is blocked");
-    if (!probe.projectContextId || !probe.projectRootHash || !Array.isArray(probe.verifiedConversationIds) || probe.verifiedConversationIds.length < 2) errors.push("real host project context and conversation identity is incomplete");
-    if (!Array.isArray(probe.verifiedHostOperations) || !requiredOperations.every((item) => probe.verifiedHostOperations.includes(item))) errors.push("seven real host operations are required");
-    if (!Array.isArray(probe.verifiedSkillRunIds) || probe.verifiedSkillRunIds.length < 2) errors.push("at least two real Skill runs in the shared project context are required");
-    if (!probe.crossConversationEventId) errors.push("verified cross-conversation event propagation is required");
-    if (!probe.sensitiveScan || probe.sensitiveScan.status !== "pass" || probe.sensitiveScan.matches.length !== 0) errors.push("real host sensitive scan is not clean");
+  if (packageJson.name !== "@pm_zhousl/xinyun-ai-init" || packageJson.version !== "3.0.0") errors.push("package identity must be @pm_zhousl/xinyun-ai-init@3.0.0");
+  if (!fs.existsSync(evidencePath)) errors.push("v3 behavior evidence is missing");
+  if (fs.existsSync(evidencePath)) {
+    const evidence = JSON.parse(fs.readFileSync(evidencePath, "utf8"));
+    if (evidence.version !== "3.0.0" || evidence.executionModel !== "bundled-skill-runtime") errors.push("v3 evidence contract is incorrect");
+    if (evidence.readyEligible !== false || evidence.realHostVerified !== false) errors.push("unverified host behavior must remain explicitly unverified");
+    if (!evidence.sensitiveScan || evidence.sensitiveScan.status !== "pass" || evidence.sensitiveScan.matches.length !== 0) errors.push("sensitive scan is not clean");
   }
-
-  if (errors.length > 0) {
+  if (errors.length) {
     errors.forEach((message) => console.error(`[xinyun-ai-init release gate] BLOCKED: ${message}`));
     process.exitCode = 2;
     return;
   }
-  console.log(`[xinyun-ai-init release gate] PASS: ${packageJson.name}@${packageJson.version} is eligible for user-authorized publish.`);
+  console.log(`[xinyun-ai-init release gate] PASS: ${packageJson.name}@${packageJson.version} static release evidence is complete; user publish authorization remains separate.`);
 }
 
 main();

package/scripts/verify-rules-tarball-security.js

@@ -7,7 +7,7 @@ const zlib = require("zlib");
 const { spawnSync } = require("child_process");
 
 const root = path.resolve(__dirname, "..");
-const verifyScript = path.join(root, "scripts", "verify-v2-tarball.js");
+const verifyScript = path.join(root, "scripts", "verify-tarball.js");
 
 function writeString(buffer, offset, length, value) {
   buffer.write(String(value), offset, Math.min(length, Buffer.byteLength(String(value))), "utf8");

package/scripts/verify-skill-runtime.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const { spawnSync } = require("child_process");
+
+const root = path.resolve(__dirname, "..");
+const runtime = path.join(root, "init", "xinyun-ai-init", "runtime", "route-skill.js");
+const temp = fs.mkdtempSync(path.join(os.tmpdir(), "xinyun-ai-v3-"));
+const factsPath = path.join(temp, "facts.json");
+const facts = {
+  taskType: "product-major-version-development",
+  framework: "node",
+  riskTerms: ["publish", "token"],
+  permissionScope: ["control-plane-read", "control-plane-write", "business-code-write", "release-review", "shell-read"],
+  requiresConversationSync: true
+};
+fs.writeFileSync(factsPath, `${JSON.stringify(facts)}\n`, "utf8");
+const result = spawnSync(process.execPath, [runtime, "--facts", factsPath], { encoding: "utf8" });
+try {
+  if (result.status !== 0) throw new Error(result.stderr || "route command failed");
+  const route = JSON.parse(result.stdout);
+  const selected = route.selected.map((item) => item.skillId);
+  const required = ["task-analysis", "technical-design", "implementation", "verification", "security-review"];
+  const missing = required.filter((skillId) => !selected.includes(skillId));
+  if (missing.length) throw new Error(`missing selected skills: ${missing.join(",")}`);
+  if (selected.includes("project-owner") || selected.includes("role-session")) throw new Error("role route leaked");
+  console.log(`[PASS] deterministic-route:${selected.join(",")}`);
+  console.log("[PASS] route-fingerprint-present");
+} finally {
+  fs.rmSync(temp, { recursive: true, force: true });
+}

package/scripts/verify-tarball.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const zlib = require("zlib");
+
+function field(buffer, offset, length) {
+  return buffer.toString("utf8", offset, offset + length).replace(/\0.*$/, "").trim();
+}
+
+function fail(message, json) {
+  const result = { status: "error", checks: [{ actual: message }] };
+  if (json) process.stdout.write(`${JSON.stringify(result)}\n`);
+  else console.error(message);
+  process.exitCode = 2;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const tarballIndex = args.indexOf("--tarball");
+  const tarball = tarballIndex >= 0 ? args[tarballIndex + 1] : null;
+  const json = args.includes("--json");
+  if (!tarball || !fs.existsSync(tarball)) return fail("Tarball is missing", json);
+  const data = zlib.gunzipSync(fs.readFileSync(path.resolve(tarball)));
+  for (let offset = 0; offset + 512 <= data.length; offset += 512) {
+    const header = data.subarray(offset, offset + 512);
+    if (header.every((value) => value === 0)) break;
+    const name = field(header, 0, 100);
+    const type = String.fromCharCode(header[156] || 48);
+    const link = field(header, 157, 100);
+    if (name.startsWith("/") || /^[A-Za-z]:[\\/]/.test(name) || name.includes("\\") || name.split("/").includes("..")) return fail(`Unsafe tarball entry: ${name}`, json);
+    if (type === "2" || type === "1") return fail(`Unsafe tar entry: ${name} (${type === "2" ? "symbolic" : "hard"} link)`, json);
+    const size = Number.parseInt(field(header, 124, 12), 8) || 0;
+    offset += Math.ceil(size / 512) * 512;
+    if (link) return fail(`Unsafe tarball entry link: ${name}`, json);
+  }
+  const result = { status: "ok", checks: [{ actual: "tarball entries are safe" }] };
+  if (json) process.stdout.write(`${JSON.stringify(result)}\n`);
+  else console.log("tarball entries are safe");
+}
+
+main();

package/scripts/verify-v3-package.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+
+const root = path.resolve(__dirname, "..");
+const initRoot = path.join(root, "init", "xinyun-ai-init");
+const manifest = JSON.parse(fs.readFileSync(path.join(initRoot, "runtime-manifest.json"), "utf8"));
+const checks = [];
+
+function check(name, condition, detail = "") {
+  checks.push({ name, ok: Boolean(condition), detail });
+}
+
+function readJson(relative) {
+  return JSON.parse(fs.readFileSync(path.join(root, relative), "utf8"));
+}
+
+function walk(dir) {
+  const result = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) result.push(...walk(full));
+    else result.push(full);
+  }
+  return result;
+}
+
+const packageJson = readJson("package.json");
+const version = readJson("init/xinyun-ai-init/version.json");
+const registry = readJson("init/xinyun-ai-init/skills/registry.json");
+const runtimeManifest = readJson("init/xinyun-ai-init/runtime-manifest.json");
+
+check("package-version", packageJson.version === "3.0.0", packageJson.version);
+check("runtime-version", version.version === "3.0.0" && version.schemaVersion === "3");
+check("runtime-model", version.executionModel === "bundled-skill-runtime");
+check("manifest-files", runtimeManifest.runtimeVersion === "3.0.0" && runtimeManifest.files.length === 20);
+check("manifest-files-exist", runtimeManifest.files.every((file) => fs.existsSync(path.join(initRoot, file))));
+check("skill-count", registry.skills.length >= 8);
+check("skill-identities", registry.skills.every((skill) => skill.skillId && skill.name && Number.isInteger(skill.order) && skill.triggers && skill.permissions && skill.tools));
+check("stable-order", registry.skills.every((skill, index, list) => index === 0 || list[index - 1].order < skill.order));
+check("no-role-routing", JSON.stringify(registry).toLowerCase().includes("roleid") === false && JSON.stringify(registry).toLowerCase().includes("allowedroles") === false);
+check("legacy-runtime-removed", version.legacyRuntime === "removed");
+check("cli-offline-path", fs.readFileSync(path.join(root, "bin", "xinyun-ai-init.js"), "utf8").includes("--offline") && fs.readFileSync(path.join(root, "bin", "xinyun-ai-init.js"), "utf8").includes("cacheFresh"));
+
+for (const file of walk(initRoot)) {
+  const relative = path.relative(initRoot, file).replace(/\\/g, "/");
+  if (file.endsWith(".json")) {
+    try {
+      JSON.parse(fs.readFileSync(file, "utf8"));
+      check(`json:${relative}`, true);
+    } catch (error) {
+      check(`json:${relative}`, false, error.message);
+    }
+  }
+  if (file.endsWith(".md")) {
+    const fenceCount = (fs.readFileSync(file, "utf8").match(/```/g) || []).length;
+    check(`markdown:${relative}`, fenceCount % 2 === 0, "unbalanced code fence");
+  }
+}
+
+const legacyPrefixes = ["templates/team/", "templates/role-", "templates/role-session", "templates/provider-session", "rules/v1.", "rules/v2.0.0-single-session"];
+const legacyFiles = walk(initRoot).map((file) => path.relative(initRoot, file).replace(/\\/g, "/"))
+  .filter((file) => legacyPrefixes.some((prefix) => file.startsWith(prefix)));
+check("legacy-files-absent", legacyFiles.length === 0, legacyFiles.join(", "));
+
+for (const item of checks) console.log(`[${item.ok ? "PASS" : "FAIL"}] ${item.name}${item.ok || !item.detail ? "" : `: ${item.detail}`}`);
+const failed = checks.filter((item) => !item.ok);
+console.log(`[v3 package] ${checks.length - failed.length}/${checks.length} checks passed`);
+if (failed.length) process.exitCode = 1;

package/test-scenarios/v3.0.0-behavior-evidence.json

@@ -0,0 +1,25 @@
+{
+  "schemaVersion": 3,
+  "version": "3.0.0",
+  "evidenceType": "contract-regression",
+  "executionMode": "static-package",
+  "executionModel": "bundled-skill-runtime",
+  "realHostVerified": false,
+  "readyEligible": false,
+  "publishBlocked": false,
+  "unverifiedScope": ["real host Skill execution", "real target-project cleanup", "real concurrent route writes"],
+  "scenarios": [
+    {"scenarioId": 601, "name": "bundled concrete Skills", "result": "contract-passed"},
+    {"scenarioId": 602, "name": "deterministic task-fact routing", "result": "contract-passed"},
+    {"scenarioId": 603, "name": "role-free routing", "result": "contract-passed"},
+    {"scenarioId": 604, "name": "minimal runtime manifest", "result": "contract-passed"},
+    {"scenarioId": 605, "name": "offline and cached version check", "result": "contract-passed"},
+    {"scenarioId": 606, "name": "incremental materialization", "result": "contract-passed"},
+    {"scenarioId": 607, "name": "user file conflict preservation", "result": "contract-passed"},
+    {"scenarioId": 608, "name": "v3 migration preview", "result": "contract-passed"},
+    {"scenarioId": 609, "name": "v3 legacy cleanup apply gate", "result": "contract-passed"},
+    {"scenarioId": 610, "name": "authorization boundary", "result": "contract-passed"}
+  ],
+  "sensitiveScan": {"status": "pass", "matches": []},
+  "recordedAt": "2026-10-13T00:00:00.000Z"
+}

package/test-scenarios/v3.0.0-scenarios.md

@@ -0,0 +1,41 @@
+# v3.0.0 Skill Runtime 场景
+
+## 601. Bundled concrete Skills
+
+registry 必须包含项目接管、需求分析、技术设计、实现、验证、安全审查、发布审查和交接同步。
+
+## 602. Deterministic task-fact routing
+
+相同 task facts 和 registry 版本必须产生相同 route fingerprint、选择结果和顺序。
+
+## 603. Role-free routing
+
+路由输入和 registry 不得包含 `roleId`、角色名称或角色优先级。
+
+## 604. Minimal runtime manifest
+
+初始化 manifest 只列出 v3 核心规则、路由器、迁移器、registry 和最小控制面模板。
+
+## 605. Offline and cached version check
+
+`--offline` 或有效 TTL 缓存不得访问 npm registry。
+
+## 606. Incremental materialization
+
+重复执行只更新源哈希变化的托管文件，不递归删除整个初始化目录。
+
+## 607. User file conflict preservation
+
+用户修改过的托管文件默认保留并记录 `conflict`，不得静默覆盖。
+
+## 608. v3 migration preview
+
+没有 `--apply` 时只生成合并和清理预览，不删除旧目录。
+
+## 609. v3 legacy cleanup apply gate
+
+只有清单稳定且明确提供 `--apply` 时才删除已知旧运行目录。
+
+## 610. Authorization boundary
+
+业务修改、数据库、Git 和 npm 发布仍需要独立授权。

package/init/xinyun-ai-init/prompt.md

@@ -1 +0,0 @@
-请执行 `npx --yes @pm_zhousl/xinyun-ai-init@latest --force`，然后读取 `xinyun-ai-init/README.md`，按其中规则初始化或升级当前项目。

package/init/xinyun-ai-init/rules/coordination.md

@@ -1,43 +0,0 @@
-# v2 项目共享上下文与跨对话协调
-
-`xinyun-ai/coordination/` 是多个对话共享的项目控制面，不是业务代码目录。所有事实、任务和结果都属于同一个 `projectContextId`。
-
-## 单写者事件流
-
-- 每个对话拥有独立目录 `streams/<conversationBindingId>/`。
-- 对话先写不可变事件 `events/<eventId>.json`，校验哈希链后原子替换自己的 `head.json`。
-- 一个对话不得写另一个对话的流，也不得让多个对话追加同一个 JSON 数组。
-- 单流 `streamSequence` 严格递增；跨流顺序由消费者游标分别记录，不依赖机器时间形成全局顺序。
-
-## 交互时增量同步
-
-收到用户消息、计划前、写入前、验证前和交付前执行同步检查：
-
-1. 读取对话注册表和所有活动流 head。
-2. 与 `cursors/<consumerConversationId>.json` 的 `streamPositions` 比较。
-3. 没有新序号时静默继续。
-4. 有新序号时读取新增事件，根据受影响任务、域和路径刷新最小事实集合。
-5. 校验事件链、项目身份、任务状态和冲突后更新游标。
-
-head 倒退、事件缺失、哈希断裂、跨项目事件或游标超前时进入 `recovery-required` 或 `blocked`。
-
-## 共享事实与台账
-
-- `project-facts.json` 是可追溯事实物化视图，事实来源必须引用事件和证据。
-- `change-ledger.json` 是变更物化视图，不是多写者追加日志；由已校验事件事务化更新。
-- 有长期价值的任务、决策、修改、Skill、验证、授权、冲突和交接必须写回。
-- 临时推理、闲聊、未确认猜测和敏感信息不得进入共享流。
-
-## 任务租约和冲突
-
-- 写入前创建 `leases/<leaseId>.json`，声明 `taskId`、`ownerConversationId`、`targetKeys` 和 `baselineHashes`。
-- 目标键格式至少包括 `file:`、`api:`、`db:`、`component:` 和 `flow:`。
-- 不同目标允许并行；活动租约目标重叠或基线变化时记录 `conflict-records/<conflictId>.json` 并阻断写入。
-- 租约过期后必须检查事件、文件和事务，不能直接假定工作未发生。
-- 冲突不得由单个对话静默裁决或覆盖；数据库、API、业务流程和跨端冲突继续要求用户确认。
-
-## 状态与恢复
-
-- `taskStatus`、`changeStatus`、`conflictStatus`、`leaseStatus` 和 `cursorStatus` 分域记录，不能互相代替。
-- 事务失败、部分写入或游标无法恢复时保留证据并进入 `recovery-required`。
-- 最终交付前必须再次同步，确保没有相关未消费事件、活动冲突或变化后的基线。

package/init/xinyun-ai-init/rules/directory-self-completion.md

@@ -1,100 +0,0 @@
-# 目录自完善规则
-
-## v2.0.0 当前目录规则
-
-正式任务触发能力补齐时，只在目标项目 `xinyun-ai/` 中更新普通任务、任务图、共享项目上下文、对话绑定、事件流、增量游标、Skill、协调和交接目录。新安装和新任务不得补建 `team/`、角色任务或角色会话目录。旧目录只在迁移清单中登记为 `legacy/read-only`。
-
-首次初始化只创建最小 `xinyun-ai/` 骨架。后续 AI 会话中，如果用户需求、问题排查或项目理解触发了某个端、模块或能力，AI 应自动在 `xinyun-ai/` 下补齐对应目录和基础说明文件。
-
-规则：
-
-- 只补齐当前任务涉及的目录，不为了完整创建所有目录。
-- 只允许补齐 `xinyun-ai/` 内的文档、索引和记录，不修改业务代码。
-- 新目录创建后必须更新 `manifest.json` 和 `index/project-index.json`。
-- 自完善内容必须标注来源、判断依据和状态：`推断`、`已确认`、`待确认`。
-- 如果自完善会改变正式规则、开发流程或代码修改策略，必须先输出方案并等待用户确认。
-- `xinyun-ai/global-review/` 只在新功能、大改、重构、跨端改动、目录 / 规则 / 索引调整、数据库 / API / UI 联动变更或多会话交接复杂任务中按需创建。
-- 首次极速初始化不强制创建 `xinyun-ai/global-review/`。
-- 创建或更新全局审视后，必须同步 `xinyun-ai/global-review/index.json` 和 `xinyun-ai/index/project-index.json`。
-- 全局审视最小字段包括：`reviewId`、触发原因、关联任务、影响层、已确认内容、推断内容、待确认内容、风险点、后续动作、创建时间、更新时间。
-- 识别到端口框架线索时，可按需补齐 `workstreams/<端>/`，记录 ThinkPHP / uni-app / 微信小程序识别证据、证据类型、发现预算、覆盖范围、`未在项目中发现` 或 `状态未知`。
-- 识别到多仓库 Git 结构时，可按需补齐端口 Git 只读索引，记录 `repoRoot`、`path`、`workstream`、`kind`、`parentRepo`、`branch`、`remote`、`status`、`evidence`，不得执行 Git 写操作。
-- 触发字段影响审视时，可按需补齐字段审视记录，记录字段分类、检索根目录、排除项、CodeGraph 状态、证据、可能遗漏位置、兼容方案和确认状态。
-- 首次初始化必须补齐 `xinyun-ai/team/`；升级时发现团队能力缺失，可按方案补齐团队控制文件。
-- 团队目录补齐后必须同步 `manifest.json` 和 `index/project-index.json` 的 team 路径注册。
-- `xinyun-ai/team/**` 属于控制文件，计入实际更新记录，但与业务代码修改分栏统计。
-- 超出预计目录时必须设置 `status=paused`、`pauseReason=out-of-scope`，不得使用 `paused-out-of-scope`。
-- v1.6 初始化或升级触发后，必须补齐任务控制目录和文件：`xinyun-ai/tasks/`、`xinyun-ai/tasks/.idempotency/`、`xinyun-ai/init-result.json`、`xinyun-ai/task-lock.json`、`xinyun-ai/index/managed-baseline.json`、`xinyun-ai/index/capabilities.json`。
-- `manifest.json` 必须登记 `tasking.currentTask`、`tasking.tasksDirectory`、`tasking.idempotencyDirectory`、`tasking.initResult`、`tasking.taskLock`、`tasking.managedBaseline`、`tasking.capabilities`。
-- `index/project-index.json` 必须登记同名 `tasking` 路径、统一状态机枚举和 `statusSource=current-task.md`。
-- 自完善写控制文件时必须使用临时文件完整写入和原子重命名；写入失败时保留原文件，步骤标记为 `failed`。
-- 受管理文件首次写入时记录 `baselineHash`、`templateHash`、`lastAppliedVersion` 和 `managedBy`；文件缺失、不可读、无基线或哈希无法计算时标注 `unknown`，不得覆盖。
-- 能力检测记录可按需补齐到 `xinyun-ai/index/capabilities.json`，必须包含 `capabilityId`、`detectionMethod`、`status`、`evidence`、`fallbackPlan`、`unverifiedScope` 和 `checkedAt`。
-- 补齐任何 Markdown、JSON 或交接记录前必须先脱敏；无法确认是否敏感时按敏感处理并记录 `sensitiveScanStatus=unknown`。
-## v1.7 按需目录补齐
-
-- 框架专项深化触发后，按需创建 `xinyun-ai/frameworks/`、`xinyun-ai/frameworks/framework-profile.md`、`xinyun-ai/frameworks/framework-profile.json`。
-- HTML 迁移准备触发后，按需创建 `xinyun-ai/migrations/html-to-client/`、`migration-scope.md`、`compatibility-matrix.md`、`route-map.md`、`asset-map.md`、`pilot-plan.md`、`open-issues.md`、`migration-record.json`。
-- `framework-profile.json` 和 `migration-record.json` 创建后必须确认 JSON 可解析，并同步 `xinyun-ai/index/project-index.json`。
-- 首次极速初始化不强制创建上述目录；普通咨询也不创建迁移或 profile 记录。
-
-## v1.12 接管恢复目录
-
-When takeover initialization is authorized, create `host-preflight.json`, `index/initialization-recovery.json`, `sessions/manual-bindings.json`, `index/shared-project-snapshot.json`, and `index/initialization-timing.json` under `xinyun-ai/`. Use atomic writes and preserve blocked state on host or permission failure.
-
-## v1.7.1 任务树、归档与 CodeGraph 目录
-
-- 初始化或升级流程必须补齐 `xinyun-ai/tasks/task-index.json`、`xinyun-ai/tasks/archive/`、`xinyun-ai/tasks/.archive-transactions/`、`xinyun-ai/tasks/.archive-tmp/`。
-- 主任务文件路径为 `xinyun-ai/tasks/<taskId>.md`，角色子任务路径为 `xinyun-ai/tasks/<taskId>/subtasks/<roleTaskId>.md`。
-- `manifest.json` 和 `xinyun-ai/index/project-index.json` 必须登记 `taskTree`、`tasking.taskIndex`、`tasking.archiveDirectory`、`tasking.archiveTransactionsDirectory`。
-- 归档事务文件必须使用 `xinyun-ai/tasks/.archive-transactions/<archiveTransactionId>.json`，不得放入业务目录。
-- `.codegraph/` 是工具控制目录，属于一句话初始化授权范围；CodeGraph 状态源为 `manifest.json`，其他控制文件只引用同一 `codeGraphRecordId`。
-- 普通咨询不创建完整主任务、五角色任务树或触发 CodeGraph 初始化。
-
-## v1.7.2 任务可见性目录
-
-- 需要补建角色后续任务时创建 `xinyun-ai/tasks/role-execution/`，不得把 `role-execution` 文件写入业务目录。
-- 同步校验 `task-index.json`、`current-task.md`、`manifest.json` 和 `project-index.json` 的角色执行任务路径与索引。
-- 活动角色任务不可执行时仍保留在 `activeTaskIds`；只有活动列表为空才允许 current-task 为 idle/null。
-- 逐角色临时文件和索引必须原子写入；发现中断、冲突或写入失败时保留恢复记录，不清空活动任务。
-
-## v1.7.3 角色会话绑定目录
-
-- Codex 角色会话绑定触发后，按需补齐 `xinyun-ai/sessions/`、`xinyun-ai/sessions/roles/` 和 `xinyun-ai/sessions/role-session-bindings.json`。
-- 绑定模板来源固定为 `xinyun-ai-init/templates/role-session-binding.template.json`。
-- `manifest.json`、`project-index.json` 和 `task-index.json` 必须登记 `roleSessions`、`roleSessionBindingIds`、`roleSessionBindings`、`provider=codex` 和 `sessionStatus` 枚举。
-- 绑定目录只保存 Codex 宿主返回的真实 `sessionId` 摘要、onboarding 状态、失败原因和 audit，不保存伪造 sessionId。
-- 宿主不支持创建子会话时，仍可补齐本地目录和降级记录，状态使用 `local-degraded-no-fake-session-id`。
-- v1.12.1 provider 绑定记录固定写入 `xinyun-ai/sessions/provider-session-bindings.json`，模板来源为 `xinyun-ai-init/templates/provider-session-binding.template.json`。只有宿主 canonical `providerSessionId`、身份/交互证据和独占占用均通过时才可绑定；未知或普通线程 ID 保持 blocked/pending。
-- v1.13.0 按需补齐 `provider-adapter.json`、`manual-session-recovery.json` 和 `index/initialization-change-report.json`；宿主预检失败时只生成恢复引导和阻断记录，不先执行大规模 CodeGraph 扫描。
-
-## v1.8 按需目录
-
-- 多会话协调任务按需补齐 `xinyun-ai/coordination/`、`contract-snapshots/`、`conflict-records/` 和 `.transactions/`。
-- Skill 路由任务按需补齐 `xinyun-ai/skills/registry.json`、`assignments.json` 和 `usage-records/`；分配字段必须是 `assignmentStatus`。
-- 前端审计按需补齐 `xinyun-ai/frontend-audits/`；临时程序员任务按需补齐 `xinyun-ai/sessions/temporary/`。
-- 普通咨询、首次极速初始化和不涉及这些能力的任务不创建空目录。目录补齐只修改 AI 控制面，不修改业务代码。
-- 普通咨询、首次极速初始化和不涉及这些能力的任务不创建空目录。目录补齐只修改 AI 控制面，不修改业务代码。
-
-## v1.10 项目 AI 接管目录
-
-- `xinyun-ai/project-status.json`
-- `xinyun-ai/preflight-report.json`
-- `xinyun-ai/onboarding-report.json`
-- `xinyun-ai/host-capabilities.json`
-- `xinyun-ai/index/takeover-baseline.json`
-- `xinyun-ai/index/control-plane-index.json`
-- `xinyun-ai/events/events.jsonl`
-
-接管门禁目录必须在业务代码开发前创建或明确记录为 blocked/partial；首次 CLI 仍只创建 `xinyun-ai-init/`，不会直接创建 `xinyun-ai/`。
-
-## v1.9 按需目录
-
-- `xinyun-ai/project-identity.json`
-- `xinyun-ai/sessions/session-candidates.json`
-- `xinyun-ai/technical-landscape.json`
-- `xinyun-ai/packets/requirement-packet.json`
-- `xinyun-ai/packets/technical-impact-packet.json`
-- `xinyun-ai/database/authorization.json`
-
-小改和普通咨询不强制创建技术全景或 packet。创建后同步 manifest、project-index、current-task 和任务引用；只登记当前项目身份，不复制其他项目会话。

package/init/xinyun-ai-init/rules/frameworks/README.md

@@ -1,56 +0,0 @@
-# 框架适配规则
-
-本目录用于按端和框架存放轻量识别规则。
-
-## 目录约定
-
-```md
-frameworks/backend/<language>/<framework>.md
-frameworks/frontend/<framework>.md
-```
-
-首期只集成：
-
-- `backend/php/thinkphp.md`
-- `frontend/uni-app.md`
-- `frontend/wechat-miniprogram.md`
-
-## 执行边界
-
-- 框架适配只用于帮助 AI 定位入口、配置、页面 / 路由、请求封装线索。
-- 不做深度扫描。
-- 不默认创建大量框架说明文件。
-- 框架识别应结合关键配置、入口文件、目录结构、依赖或代码特征交叉判断。
-- 只发现单一线索时，标注为 `推断` 或 `待确认`，不得直接当作已确认框架。
-- 首次初始化只查关键文件、配置文件、入口文件和少量抽样文件。
-- 不为确认框架做全量 grep 或追完整调用链。
-- 如需进一步确认，放到后续任务按需补齐。
-- 未识别到对应框架时，不强行套用该框架规则。
-- 多端项目应分别说明每个端口的框架、入口、启动线索和请求链路线索。
-- 每个端口从端口根目录向下最多发现 3 层目录，最多读取 20 个关键文件。
-- 正向识别必须列出证据路径和证据类型，证据类型包括依赖、配置、入口、目录结构和代码特征。
-- 预算内无识别证据时标注 `未在项目中发现`。
-- 权限不足、路径不可读或超过预算时标注 `状态未知`，同时写明 `覆盖范围：部分` 和未检查范围。
-- 单一线索只能标注 `推断` 或 `待确认`。
-- 不把 uni-app 规则套到原生微信小程序，也不把微信小程序规则套到 uni-app。
-
-## 输出字段
-
-- workstream
-- 框架候选
-- 识别状态：已确认 / 推断 / 待确认 / 未在项目中发现 / 状态未知
-- 覆盖范围：完整 / 部分
-- 发现预算：目录深度 3 层、关键文件 20 个
-- 证据：路径、证据类型、命中内容摘要
-- 未检查范围
-## v1.7 技术栈 profile
-
-- `language`、`runtime`、`platform`、`framework` 必须独立记录，不能把语言或运行时直接当框架。
-- `frameworkStatus=confirmed/inferred/not-found/unknown/detected-unsupported`。
-- `moduleStatus=loaded/not-loaded`。
-- `activation=loaded/not-loaded`。
-- 只有 `frameworkStatus=confirmed` 且存在匹配模块时，才允许 `moduleStatus=loaded` 和 `activation=loaded`。
-- v1.4 轻量识别预算保留为 3 层目录、20 个关键文件。
-- v1.7 深化预算：5 层目录、80 个关键文件、100 条证据。
-- 超预算、权限不足、路径不可读或工具失败时输出 `unknown`、`coverage=partial` 和 `unverifiedScope`，不得伪造 confirmed。
-- 按需生成 `framework-profile.md` 和 `framework-profile.json`，二者状态和证据必须一致。

package/init/xinyun-ai-init/rules/frameworks/backend/php/thinkphp.md

@@ -1,42 +0,0 @@
-# ThinkPHP 轻量识别规则
-
-## 识别线索
-
-- `composer.json` 中存在 `topthink/framework`
-- 存在 `public/index.php` 或 `think`
-- 存在 `app/`、`config/`、`route/`
-- 存在 `app/*/controller`、`app/*/model`、`app/*/service`
-- 关键文件或少量抽样文件中出现 `think\facade`、`think\Request`、`think\Response`
-
-## 接手重点
-
-1. 应用入口：`public/index.php`、`think`
-2. 路由位置：`route/`、`config/route.php`、注解路由线索
-3. 模块结构：`app/<module>/controller`、`model`、`service`、`validate`、`middleware`
-4. 配置位置：`config/`、`.env`
-5. 公共前置逻辑：`middleware`、控制器基类、公共调用位置
-6. 命令任务：`app/command`、`config/console.php`
-7. 异常处理：`app/ExceptionHandle.php` 或项目自定义异常处理
-8. 返回结构：控制器统一响应方法、JSON 返回规范
-
-## 边界
-
-- 只做轻量识别，不追完整调用链。
-- 识别时应结合依赖、入口文件、目录结构和代码特征交叉判断。
-- 只发现单一线索时，标注为 `推断` 或 `待确认`，不得直接当作已确认 ThinkPHP 项目。
-- 首次初始化不为确认 ThinkPHP 做全量 grep。
-- 不把 ThinkPHP 规则套到其他 PHP 框架。
-- 不默认生成大量 ThinkPHP 说明文件。
-- 每个端口从端口根目录向下最多发现 3 层目录，最多读取 20 个关键文件。
-- 正向识别必须输出证据路径和证据类型：依赖、入口、目录结构、配置或代码特征。
-- 预算内无 ThinkPHP 证据时标注 `未在项目中发现`。
-- 超预算、权限不足或路径不可读时标注 `状态未知` 和 `覆盖范围：部分`，并列出未检查范围。
-- 单一线索不能直接确认 ThinkPHP，只能标注 `推断` 或 `待确认`。
-## v1.7 ThinkPHP 深化模块
-
-- ThinkPHP 深化模块只在 `frameworkStatus=confirmed` 且存在 ThinkPHP 匹配证据时启用。
-- 启用后 `moduleStatus=loaded`、`activation=loaded`、`moduleId=backend/php/thinkphp`。
-- 未确认 ThinkPHP、仅发现 PHP/runtime、或已确认其他框架时，必须 `moduleStatus=not-loaded`、`activation=not-loaded`，不得误套 ThinkPHP。
-- v1.7 深化预算：5 层目录、80 个关键文件、100 条证据。
-- 证据类型至少覆盖可用范围内的依赖、入口、路由、Controller、Request/Validate、Service、Model/ORM、Middleware、队列、配置、测试。
-- 输出 `framework-profile.md` / `framework-profile.json` 时必须列出 coverage、unverifiedScope、checkedAt 和无法确认的范围。

package/init/xinyun-ai-init/rules/frameworks/frontend/uni-app.md

@@ -1,36 +0,0 @@
-# uni-app 轻量识别规则
-
-## 识别线索
-
-- `pages.json`
-- `manifest.json`
-- `App.vue`
-- `main.js` / `main.ts`
-- `pages/`、`components/`、`static/`
-- `package.json` 中出现 `@dcloudio`、`uni-app`、`vite-plugin-uni`
-
-## 接手重点
-
-1. 应用入口：`main.js` / `main.ts`、`App.vue`
-2. 页面配置：`pages.json`
-3. 平台配置：`manifest.json`
-4. 页面目录：`pages/`
-5. 分包配置：`subPackages`
-6. 组件目录：`components/`
-7. 静态资源：`static/`
-8. 请求封装：常见 `utils/request`、`common/request`、`api/`
-9. 登录态与缓存：`uni.getStorageSync`、`uni.setStorageSync`
-10. 条件编译：`#ifdef`、`#ifndef`
-
-## 边界
-
-- 只做轻量识别，不默认创建大量框架说明文件。
-- 识别时应结合 `pages.json`、`manifest.json`、入口文件、目录结构和依赖交叉判断。
-- 只发现单一线索时，标注为 `推断` 或 `待确认`，不得直接当作已确认 uni-app 项目。
-- 首次初始化不为确认 uni-app 做全量 grep。
-- 不把 uni-app 规则套到原生微信小程序。
-- 每个端口从端口根目录向下最多发现 3 层目录，最多读取 20 个关键文件。
-- 正向识别必须输出证据路径和证据类型：依赖、配置、入口、目录结构或代码特征。
-- 预算内无 uni-app 证据时标注 `未在项目中发现`。
-- 超预算、权限不足或路径不可读时标注 `状态未知` 和 `覆盖范围：部分`，并列出未检查范围。
-- 不把原生微信小程序规则反向套到 uni-app。

package/init/xinyun-ai-init/rules/frameworks/frontend/wechat-miniprogram.md

@@ -1,36 +0,0 @@
-# 微信小程序轻量识别规则
-
-## 识别线索
-
-- `app.json`
-- `app.js` / `app.ts`
-- `app.wxss`
-- 关键页面或少量抽样页面包含 `.wxml`、`.wxss`、`.js` / `.ts`、`.json`
-- `project.config.json`
-- `sitemap.json`
-
-## 接手重点
-
-1. 应用入口：`app.js` / `app.ts`
-2. 全局配置：`app.json`
-3. 页面路径：`pages`
-4. 分包配置：`subpackages` / `subPackages`
-5. 页面结构：`.wxml`
-6. 页面样式：`.wxss`
-7. 页面逻辑：`.js` / `.ts`
-8. 组件：`components/`
-9. 请求封装：`wx.request` 或项目封装
-10. 登录流程：`wx.login`、用户信息获取、token 缓存
-
-## 边界
-
-- 只做轻量识别，不默认创建大量框架说明文件。
-- 识别时应结合 `app.json`、入口文件、页面结构、项目配置和目录结构交叉判断。
-- 只发现单一线索时，标注为 `推断` 或 `待确认`，不得直接当作已确认微信小程序项目。
-- 首次初始化不为确认微信小程序做全量 grep。
-- 不把微信小程序规则套到 uni-app。
-- 每个端口从端口根目录向下最多发现 3 层目录，最多读取 20 个关键文件。
-- 正向识别必须输出证据路径和证据类型：配置、入口、页面结构、目录结构或代码特征。
-- 预算内无微信小程序证据时标注 `未在项目中发现`。
-- 超预算、权限不足或路径不可读时标注 `状态未知` 和 `覆盖范围：部分`，并列出未检查范围。
-- 不把 uni-app 规则反向套到原生微信小程序。

package/init/xinyun-ai-init/rules/frontend-audit.md

@@ -1,9 +0,0 @@
-# v1.8-C 前端耦合审计与渐进式组件化
-
-适用微信小程序、uni-app 和 HTML。先审计，再决定是否改造；不整站重写，不默认更换 UI 框架，不自动把 HTML 转成小程序或 uni-app。
-
-审计记录必须包含页面/组件路径、平台、框架、`couplingType`、props、events、slots、状态、API、路由、业务流程依赖、`baselineHash`、`decision`、`status`、`coverage`、`evidence` 和 `unverifiedScope`。`couplingType` 使用 `template-style/state-view/api-page/route-page/business-page/cross-platform/shared-component/unknown`。
-
-审计状态使用 `not-started/assessing/partial/completed/blocked/unknown`；处理决定使用 `audit-only/refactor-now/defer/requires-confirmation/out-of-scope`；覆盖使用 `full/partial/unknown`。这些是审计记录的字段，不得与 `taskStatus`、`changeStatus` 或 `conflictStatus` 混用。
-
-`audit-only` 必须零代码 diff。`refactor-now` 必须先有 `planId`、`userConfirmationId`、`permittedPaths`，并保留前后哈希、diff 证据和测试证据；单页面或单组件试点也必须遵守确认门禁。预算超限、权限失败或依赖未知只能输出 `partial/unknown` 和未验证范围，不能宣称完整审计。