@fenglimg/fabric-cli 2.2.0-rc.9 → 2.3.0-rc.1

package/dist/chunk-NLNH64A3.js

@@ -1,43 +0,0 @@
-#!/usr/bin/env node
-
-// src/colors.ts
-import pc from "picocolors";
-import stringWidth from "string-width";
-function isColorEnabled() {
-  if (process.env.NO_COLOR) {
-    return false;
-  }
-  const force = process.env.FORCE_COLOR;
-  if (force !== void 0) {
-    return force !== "0" && force.toLowerCase() !== "false";
-  }
-  return Boolean(process.stdout.isTTY);
-}
-function colorize(painter) {
-  return (value) => isColorEnabled() ? painter(value) : value;
-}
-var paint = {
-  success: colorize(pc.green),
-  warn: colorize(pc.yellow),
-  error: colorize(pc.red),
-  drift: colorize(pc.magenta),
-  ai: colorize(pc.blue),
-  human: colorize(pc.cyan),
-  muted: colorize(pc.dim)
-};
-var symbol = {
-  get ok() {
-    return isColorEnabled() ? paint.success("[ok] \u2713") : "[ok]";
-  },
-  get warn() {
-    return isColorEnabled() ? paint.warn("[warn] !") : "[warn]";
-  },
-  get error() {
-    return isColorEnabled() ? paint.error("[error] x") : "[error]";
-  }
-};
-
-export {
-  paint,
-  symbol
-};

package/dist/chunk-QFIVFZRH.js

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-
-// src/store/project-config-io.ts
-import {
-  projectConfigPath,
-  loadProjectConfig,
-  saveProjectConfig
-} from "@fenglimg/fabric-shared";
-
-export {
-  loadProjectConfig,
-  saveProjectConfig
-};

package/dist/doctor-MDTZWKBK.js

@@ -1,24 +0,0 @@
-#!/usr/bin/env node
-import {
-  doctorCommand,
-  doctor_default,
-  parseSinceDuration,
-  renderDoctorFilteredHelp,
-  renderTldrHeader
-} from "./chunk-E7HJUU34.js";
-import "./chunk-3D7B2UAZ.js";
-import "./chunk-WA3DYGSY.js";
-import "./chunk-NLNH64A3.js";
-import "./chunk-PTGQAZEW.js";
-import "./chunk-EOT63RDH.js";
-import "./chunk-QPAW6IYT.js";
-import "./chunk-QFIVFZRH.js";
-import "./chunk-FNHDQTPC.js";
-import "./chunk-HORSMSZL.js";
-export {
-  doctor_default as default,
-  doctorCommand,
-  parseSinceDuration,
-  renderDoctorFilteredHelp,
-  renderTldrHeader
-};

package/dist/metrics-HMFH4YHK.js

@@ -1,135 +0,0 @@
-#!/usr/bin/env node
-import {
-  getProjectTranslator
-} from "./chunk-HORSMSZL.js";
-
-// src/commands/metrics.ts
-import { resolve } from "path";
-import { defineCommand } from "citty";
-import { readMetrics } from "@fenglimg/fabric-server";
-function parseSinceArg(raw, t) {
-  if (raw === void 0 || raw.length === 0) return 0;
-  const match = /^(\d+)([smhd]?)$/u.exec(raw);
-  if (match === null) {
-    throw new Error(t("cli.metrics.invalid-since", { raw }));
-  }
-  const n = Number.parseInt(match[1], 10);
-  const unit = match[2] ?? "s";
-  const multipliers = { s: 1e3, m: 6e4, h: 36e5, d: 864e5 };
-  return n * (multipliers[unit] ?? 1e3);
-}
-function aggregate(rows, sinceMs, now) {
-  const cutoff = sinceMs > 0 ? now.getTime() - sinceMs : 0;
-  const filtered = rows.filter((r) => {
-    if (cutoff === 0) return true;
-    const ts = Date.parse(r.timestamp);
-    return Number.isFinite(ts) && ts >= cutoff;
-  });
-  const totals = {};
-  const perEntryConsumed = {};
-  for (const row of filtered) {
-    for (const [name, count] of Object.entries(row.counters)) {
-      if (name.startsWith("knowledge_consumed:")) {
-        const id = name.slice("knowledge_consumed:".length);
-        perEntryConsumed[id] = (perEntryConsumed[id] ?? 0) + count;
-        totals["knowledge_consumed"] = (totals["knowledge_consumed"] ?? 0) + count;
-        continue;
-      }
-      totals[name] = (totals[name] ?? 0) + count;
-    }
-  }
-  return {
-    // Stable token (NOT localized) so the --json contract is locale-independent;
-    // renderText localizes "all-time" at presentation time only.
-    windowDescription: sinceMs > 0 ? formatDuration(sinceMs) : "all-time",
-    rowCount: filtered.length,
-    totals,
-    perEntryConsumed,
-    rangeStart: filtered[0]?.timestamp ?? null,
-    rangeEnd: filtered[filtered.length - 1]?.timestamp ?? null
-  };
-}
-function formatDuration(ms) {
-  if (ms >= 864e5) return `${Math.round(ms / 864e5)}d`;
-  if (ms >= 36e5) return `${Math.round(ms / 36e5)}h`;
-  if (ms >= 6e4) return `${Math.round(ms / 6e4)}m`;
-  return `${Math.round(ms / 1e3)}s`;
-}
-function renderText(agg, t) {
-  const lines = [];
-  const windowDisplay = agg.windowDescription === "all-time" ? t("cli.metrics.window-all-time") : agg.windowDescription;
-  lines.push(t("cli.metrics.window", { window: windowDisplay }));
-  if (agg.rangeStart && agg.rangeEnd) {
-    lines.push(
-      t("cli.metrics.rows-range", {
-        count: String(agg.rowCount),
-        start: agg.rangeStart,
-        end: agg.rangeEnd
-      })
-    );
-  } else {
-    lines.push(t("cli.metrics.rows", { count: String(agg.rowCount) }));
-  }
-  lines.push("");
-  if (Object.keys(agg.totals).length === 0) {
-    lines.push(t("cli.metrics.no-activity"));
-    return lines.join("\n");
-  }
-  lines.push("  counter                              total");
-  lines.push("  ------------------------------------ ----------");
-  const sorted = Object.entries(agg.totals).sort((a, b) => b[1] - a[1]);
-  for (const [name, count] of sorted) {
-    lines.push(`  ${name.padEnd(36)} ${String(count).padStart(10)}`);
-  }
-  const perEntrySorted = Object.entries(agg.perEntryConsumed).sort((a, b) => b[1] - a[1]).slice(0, 10);
-  if (perEntrySorted.length > 0) {
-    lines.push("");
-    lines.push("  Top per-entry consumed (knowledge_consumed:<id>)");
-    lines.push("  ------------------------------------ ----------");
-    for (const [id, count] of perEntrySorted) {
-      lines.push(`  ${id.padEnd(36)} ${String(count).padStart(10)}`);
-    }
-  }
-  return lines.join("\n");
-}
-var metricsCommand = defineCommand({
-  meta: {
-    name: "metrics",
-    description: "Print a text dashboard of Fabric counter activity from .fabric/metrics.jsonl",
-    hidden: true
-  },
-  args: {
-    json: {
-      type: "boolean",
-      description: "Emit machine-readable JSON instead of the text table.",
-      default: false
-    },
-    target: {
-      type: "string",
-      description: "Project root (defaults to the current working directory)."
-    },
-    since: {
-      type: "string",
-      description: "Limit to rows within a recent window. Examples: 24h, 7d, 30m, 90s. Omit for all-time."
-    }
-  },
-  async run({ args }) {
-    const projectRoot = resolve(args.target ?? process.cwd());
-    const t = getProjectTranslator(projectRoot);
-    const sinceMs = parseSinceArg(args.since, t);
-    const rows = await readMetrics(projectRoot);
-    const aggregated = aggregate(rows, sinceMs, /* @__PURE__ */ new Date());
-    if (args.json === true) {
-      process.stdout.write(`${JSON.stringify(aggregated)}
-`);
-    } else {
-      process.stdout.write(`${renderText(aggregated, t)}
-`);
-    }
-  }
-});
-var metrics_default = metricsCommand;
-export {
-  metrics_default as default,
-  metricsCommand
-};

package/dist/scope-explain-HLJZ2M33.js

@@ -1,48 +0,0 @@
-#!/usr/bin/env node
-import {
-  scopeExplain
-} from "./chunk-EOT63RDH.js";
-import {
-  getProjectTranslator
-} from "./chunk-HORSMSZL.js";
-
-// src/commands/scope-explain.ts
-import { defineCommand } from "citty";
-import { FabricError } from "@fenglimg/fabric-shared/errors";
-var scope_explain_default = defineCommand({
-  meta: {
-    name: "scope-explain",
-    description: "[DEPRECATED] Use 'fabric info scope <path>' instead"
-  },
-  args: {
-    scope: {
-      type: "positional",
-      required: true,
-      description: "Scope coordinate (e.g. team, project:x, personal)"
-    }
-  },
-  run({ args }) {
-    console.error("\u26A0\uFE0F  DEPRECATED: 'fabric scope-explain' is deprecated. Use 'fabric info scope <path>' instead.");
-    const projectRoot = process.cwd();
-    let result;
-    try {
-      result = scopeExplain(projectRoot, args.scope);
-    } catch (error) {
-      if (error instanceof FabricError) {
-        console.error(`${error.message}
-\u2192 ${error.actionHint}`);
-        process.exitCode = 1;
-        return;
-      }
-      throw error;
-    }
-    if (result === null) {
-      console.log(getProjectTranslator(projectRoot)("cli.cmd.no-global-config"));
-      return;
-    }
-    console.log(JSON.stringify(result, null, 2));
-  }
-});
-export {
-  scope_explain_default as default
-};

package/dist/status-4R3TM4FJ.js

@@ -1,37 +0,0 @@
-#!/usr/bin/env node
-import {
-  projectStatus,
-  warnUnknownFlags
-} from "./chunk-27HK6H5Y.js";
-import "./chunk-QPAW6IYT.js";
-import "./chunk-QFIVFZRH.js";
-import "./chunk-FNHDQTPC.js";
-
-// src/commands/status.ts
-import { defineCommand } from "citty";
-var status_default = defineCommand({
-  meta: { name: "status", description: "[DEPRECATED] Use 'fabric info' instead" },
-  args: {
-    // F27: `--json` machine-readable output (was silently ignored pre-F27).
-    json: { type: "boolean", description: "Emit machine-readable JSON instead of text" }
-  },
-  run({ args }) {
-    warnUnknownFlags(["json"]);
-    console.error("\u26A0\uFE0F  DEPRECATED: 'fabric status' is deprecated. Use 'fabric info' instead.");
-    const status = projectStatus(process.cwd());
-    if (args.json === true) {
-      console.log(JSON.stringify(status, null, 2));
-      return;
-    }
-    console.log(`uid:            ${status.uid ?? "(no global config)"}`);
-    const projectIdLabel = status.project_id ?? (status.is_fabric_project ? "(unset)" : "(not a Fabric project)");
-    console.log(`project_id:     ${projectIdLabel}`);
-    console.log(`mounted stores: ${status.mounted.length > 0 ? status.mounted.join(", ") : "(none)"}`);
-    console.log(`required:       ${status.required.length > 0 ? status.required.join(", ") : "(none)"}`);
-    console.log(`default write:  ${status.default_write_store ?? status.active_write_store ?? "(none \u2014 personal scope only)"}`);
-    console.log(`write routes:   ${status.write_routes.length}`);
-  }
-});
-export {
-  status_default as default
-};

package/dist/whoami-ITGEFWH4.js

@@ -1,49 +0,0 @@
-#!/usr/bin/env node
-import {
-  warnUnknownFlags,
-  whoami
-} from "./chunk-27HK6H5Y.js";
-import "./chunk-QPAW6IYT.js";
-import "./chunk-QFIVFZRH.js";
-import "./chunk-FNHDQTPC.js";
-import {
-  getProjectTranslator
-} from "./chunk-HORSMSZL.js";
-
-// src/commands/whoami.ts
-import { defineCommand } from "citty";
-var whoami_default = defineCommand({
-  meta: { name: "whoami", description: "[DEPRECATED] Use 'fabric info --global' instead" },
-  args: {
-    // F27: `--json` machine-readable output (was silently ignored — the command
-    // declared no args, so citty swallowed the flag and still printed text).
-    json: { type: "boolean", description: "Emit machine-readable JSON instead of text" }
-  },
-  run({ args }) {
-    warnUnknownFlags(["json"]);
-    console.error("\u26A0\uFE0F  DEPRECATED: 'fabric whoami' is deprecated. Use 'fabric info --global' instead.");
-    const info = whoami();
-    if (args.json === true) {
-      console.log(JSON.stringify(info, null, 2));
-      return;
-    }
-    const t = getProjectTranslator();
-    if (info === null) {
-      console.log(t("cli.cmd.no-global-config"));
-      return;
-    }
-    console.log(t("cli.whoami.uid", { uid: info.uid }));
-    if (info.stores.length === 0) {
-      console.log(t("cli.whoami.stores-none"));
-      return;
-    }
-    console.log(t("cli.whoami.stores-label"));
-    const localOnly = t("cli.shared.local-only");
-    for (const store of info.stores) {
-      console.log(`  ${store.alias}	${store.store_uuid}${store.local_only ? `	${localOnly}` : ""}`);
-    }
-  }
-});
-export {
-  whoami_default as default
-};

package/templates/skills/fabric/SKILL.md

@@ -1,100 +0,0 @@
----
-name: fabric
-description: Fabric 入口层路由 — 参考 maestro 的顺序协调方式，把用户意图分派到 fabric-archive/review/import/store/sync/audit/connect。Triggers fabric/知识库/归档/审批/store/同步/关联/审计.
----
-
-# fabric — Fabric Skill Router
-
-这是 Fabric 相关 skills 的入口层。它只负责理解用户意图、选择正确的下游 skill、按顺序直接调用；不直接读写 `~/.fabric` store，不自行解析 store 树，也不替代底层 `fabric-*` skills 的安全门。
-
-## Routing Contract
-
-1. 先判断用户要做的是哪类 Fabric 工作。
-2. 只调用一个最合适的下游 skill；只有用户明确要求一组维护动作时，才按顺序调用多个。
-3. 每一步完成后读取结果，再决定是否继续下一步。不要并发委派，也不要用 CSV/wave worker。
-4. 如果目标涉及写入、审批、退役或关联，必须走对应下游 skill 的既有写路径；本入口 skill 不直接修改 `knowledge/`。
-5. Store 状态只通过 `fabric info`、`fabric store ...`、`fabric sync`、MCP 工具或下游 skill 获取。MUST NOT 直接遍历或执行 `~/.fabric/stores/` 内容；store 是 data-only。
-
-## Intent Map
-
-<!-- fabric:router-intent:begin -->
-<!-- 本块由 `fabric install` 从 7 个 leaf skill 的 description Triggers 子句生成。严禁手编;改 leaf description 后重跑 `fabric install`。 -->
-
-| 用户意图(leaf description Triggers) | 下游 skill |
-| --- | --- |
-| 以后/always/never/下次/记一下;wrong-turn-revert;decision-confirm;dismissal-reason;/fabric-archive | `fabric-archive` |
-| 审批/驳回/复审/重审/approve/reject/review pending | `fabric-review` |
-| 导入历史/bootstrap fabric/mine changelog/挖掘 commit | `fabric-import` |
-| 同步知识库/sync stores/fabric-sync/解决 store 冲突/rebase 冲突 | `fabric-sync` |
-| 创建 store/挂载 store/绑定知识库/store 列表/切换写库/set up knowledge store | `fabric-store` |
-| 审计知识库/清理陈旧知识/知识库体检/deprecate 条目/prune stale knowledge/知识库瘦身/淘汰旧决策 | `fabric-audit` |
-| 连接知识/找关联条目/建知识图谱/link related entries/补 related 边/知识库连通性 | `fabric-connect` |
-
-`S_CLASSIFY` 的 `task_type` 枚举:`archive | review | import | sync | store | audit | connect`
-<!-- fabric:router-intent:end -->
-
-## State Machine
-
-### S_CLASSIFY
-
-提取：
-
-```json
-{
-  "task_type": "<Intent Map task_type 枚举之一>",
-  "scope": "project|store|entry|paths|null",
-  "write_intent": true,
-  "confidence": "high|medium|low"
-}
-```
-
-低置信度时问 1 个短问题；不要一次性列长菜单。若用户只是说“fabric 帮我处理一下”，默认先运行 `fabric-audit` 做只读体检，再根据输出建议下一步。
-
-### S_EXECUTE
-
-按 `Intent Map` 直接调用下游 skill，例如：
-
-- `fabric-archive "{用户原始意图}"`
-- `fabric-review "{用户原始意图}"`
-- `fabric-import "{用户原始意图}"`
-- `fabric-store "{用户原始意图}"`
-- `fabric-sync "{用户原始意图}"`
-- `fabric-audit "{用户原始意图}"`
-- `fabric-connect "{用户原始意图}"`
-
-执行前加载下游 skill 的 `SKILL.md`，只读取完成当前任务所需的 `ref/` 文件。下游 skill 有更具体约束时，以下游约束为准。
-
-### S_CHAIN
-
-只有这些组合可以自动串联：
-
-| 组合意图 | 顺序 |
-| --- | --- |
-| “同步后审 pending” | `fabric-sync` -> `fabric-review` |
-| “审计并处理陈旧知识” | `fabric-audit` -> `fabric-review` |
-| “导入历史并审批” | `fabric-import` -> `fabric-review` |
-| “建立 store 后导入” | `fabric-store` -> `fabric-import` |
-| “找关联并落盘” | `fabric-connect` -> `fabric-review` |
-
-每个步骤结束后读结果。若前一步失败或给出需要用户决策的冲突，停止并报告；不要猜测继续。
-
-## Guardrails
-
-- 写入 pending 只走 active write store，并在回复里说明写入目标。
-- 引用 KB id 前必须实际读取正文；多 store read-set 中使用 `<store-alias>:<id>`。
-- pending backlog 超过 10 条时，优先建议 `fabric-review`。
-- 完成一批 Edit 或显著 decision 后，建议 `fabric-archive`。
-- 不要推荐 `fabric doctor --fix` 作为 pending 审批路径；审批走 `fabric-review`。
-- 不要把知识写到项目本地 `.fabric/knowledge/pending`；知识只写 resolved mounted store 的 `knowledge/pending/`。
-- MUST preserve protected tokens exactly: `MUST`, `NEVER`。
-
-## Report
-
-回复格式保持短：
-
-```text
-Fabric route: <downstream-skill>
-Reason: <why this skill>
-Result: <one-line result or blocker>
-Next: <optional next skill/action>
-```

package/templates/skills/fabric-audit/SKILL.md

@@ -1,63 +0,0 @@
----
-name: fabric-audit
-description: 知识库语义淘汰门面 — 审计 KB 健康并以 deprecate-over-delete + rescue-before-delete 收口陈旧/孤儿/被取代条目。引擎是 `fabric doctor`；本 skill 按用户意图挑动作并守「不硬删、先抢救」红线。Triggers 审计知识库/清理陈旧知识/知识库体检/deprecate 条目/prune stale knowledge/知识库瘦身/淘汰旧决策.
----
-
-# fabric-audit — 知识库语义淘汰
-
-知识库 *维护期* 的对话入口:体检 KB,把陈旧 / 孤儿 / 被取代的条目按 **语义淘汰** 收口 —— 而不是一删了之。CLI (`fabric doctor`) 是引擎(跑 lint、算 health、给 orphan/stale 信号);本 skill 按用户意图挑动作,并守两条红线:**deprecate-over-delete** 与 **rescue-before-delete**。
-
-写新条目用 `fabric-archive`;批量审 pending 用 `fabric-review`;本 skill 专管 *已归档条目的退役*。
-
-## When to use
-
-- 「审计 / 体检知识库」「知识库健康度怎样?」
-- 「清理陈旧知识」「这些旧决策还要吗?」「知识库瘦身」
-- 发布 / 大重构前想把过时知识收口。
-- doctor 报了 orphan / stale / 低 health,想逐条处置。
-
-## When NOT to use
-
-- 写 / 提议新知识条目 → `fabric-archive`。
-- 批量审 pending draft → `fabric-review`（内部走 `fab_review action="list"` / `pending_path`）。
-- store 运维 / 同步 → `fabric-store` / `fabric-sync`。
-
-## 两条红线
-
-1. **deprecate-over-delete**:陈旧 ≠ 该删。一条「当时为什么这么决策」的 decision/pitfall 即使方案已换,其 **rationale 仍是知识**。退役 = 降 maturity / 标记 deprecated(保留正文 + 记录被什么取代),而非 `rm`。删除只用于「从未成立 / 纯噪声 / 重复」的条目。
-2. **rescue-before-delete**:任何 *打算删* 的条目,删前必做抢救检查 —— 它是否携带别处没有的独特 rationale / 反例 / 边界?有则先 **merge 进取代它的条目**(或在新条目加 `related` 边指回),再删空壳。抢救检查没做过,不许删。
-
-## 意图 → 动作映射
-
-| 意图 | 动作 |
-|---|---|
-| 体检 / 健康度 | `fabric doctor`(读 lint + health rollup);零阻断,只报告 |
-| 找孤儿 / 陈旧条目 | `fabric doctor`(消费 orphan / stale / orphan-demote 信号) |
-| 退役一条陈旧条目 | **不删** → 降 maturity(proven→verified→draft)或在 frontmatter 标 deprecated + 记 superseded-by;经 `fabric-review` 落盘 |
-| 删一条「从未成立 / 重复」条目 | 先跑 rescue 检查(独特 rationale?有则 merge/加 related);确认空壳后才删 |
-| 被取代但有价值 | rescue:把独特 rationale merge 进取代条目,新条目加 `related` 边指回,再退役旧条目 |
-
-## 流程(逐条处置)
-
-1. `fabric doctor` 取 KB health + orphan/stale 候选清单(引擎给信号,本 skill 不自算)。
-2. 对每个候选判 **三态**:still-valid(留) / superseded(退役,走 deprecate) / never-valid(删,走 rescue 检查)。
-3. superseded → deprecate:降 maturity 或标 deprecated + `superseded-by`,保留正文 rationale。
-4. never-valid → rescue-before-delete:独特知识?有则 merge + `related`,无则删空壳。
-5. 处置经 `fabric-review` skill 落盘(本 skill 给决策,review 做写入),保持单一写路径。
-
-## Scope re-assignment(迁移 / backfill 后纠偏)
-
-`fabric store backfill-scope` 给老条目补 `semantic_scope`,**默认把所有 team-layer 条目标成 `semantic_scope: team`** —— over-broad 的保守默认,会让项目专属知识错误地暴露给所有项目。审计时按下面的测试纠偏:
-
-- **team-scope 判定测试**:「换一个**没有本 app 代码**的不同 repo,这条知识还成立吗?」—— 成立才是 `team`。
-  - app **内部**跨功能 / 跨玩法复用的共享组件(同一 app 多处用)**≠ team** —— 它仍绑这个项目,应是 `project:<id>`。**跨玩法复用 ≠ 跨项目复用**(如语音房 VoiceRoom 被多个玩法共用,仍是 `project:<id>`)。
-- **纠偏动作**:把被默认成 team 的项目专属条目降级 ——
-  `fabric store re-scope <store> --to project:<id> --id <id>`
-- 完整判定树 / worked examples 见单一真源:`fabric-archive/ref/phase-3-7-semantic-scope.md`(本 skill 不重述,避免镜像漂移)。
-
-## Constraints
-
-- 本 skill **只读 + 给处置建议**;实际写入(降级 / 标记 / 删)经 `fabric-review` 的写路径,不自行改 store `knowledge/`。
-- NEVER 绕过 rescue 检查直接删;删前 MUST 先跑抢救检查。删是最后手段,默认是 deprecate。
-- store counters 派生态严禁手改;退役动作改的是 store `knowledge/<type>/` 下 markdown 的 frontmatter(maturity / deprecated / superseded-by),再 `fabric doctor --fix` reconcile。
-- health / orphan / stale 一律取自 `fabric doctor` 的 JSON 输出,不在 skill 内重算(单一真源)。

package/templates/skills/fabric-connect/SKILL.md

@@ -1,48 +0,0 @@
----
-name: fabric-connect
-description: 知识图谱关联门面 — 发现 KB 条目间隐藏关联并回写 H2 `related` 图边。读 fab_recall 看候选, 按语义/共路径/共引提议 related 边, 经 fabric-review 写路径落盘。Triggers 连接知识/找关联条目/建知识图谱/link related entries/补 related 边/知识库连通性.
----
-
-# fabric-connect — 知识图谱关联
-
-把孤立的 KB 条目连成图:发现彼此**隐藏关联**(同一决策的正反面、pitfall↔规避它的 guideline、被取代↔取代),回写到 frontmatter 的 `related: [<stable_id>...]` 图边(v2.2 H2)。下游 `fab_recall include_related:true` 据此一跳拉回连通知识。
-
-`related` 是**有向引用**(A.related=[B] 表示「读 A 时也该看 B」),按需补反向边(B.related=[A])。
-
-## When to use
-
-- 「把这些知识连起来」「找出相关条目」「补 related 边」
-- 「知识库连通性怎样?」「有哪些孤岛条目?」
-- 新增一批条目后想建立彼此引用。
-
-## When NOT to use
-
-- 写新条目 → `fabric-archive`。
-- 审 pending / 退役陈旧 → `fabric-review` / `fabric-audit`。
-- 检索时临时拉关联 → 直接 `fab_recall include_related:true`(无需建边)。
-
-## 关联类型(提议 related 边的判据)
-
-| 类型 | 例 |
-|---|---|
-| 互补 | decision「用 JWT」 ↔ pitfall「JWT 过期未刷新踩坑」 |
-| 规避 | pitfall「sprite 黑边」 ↔ guideline「premultiplyAlpha 正确设置」 |
-| 取代 | 旧 decision ↔ 取代它的新 decision(配合 deprecated/superseded-by) |
-| 同域 | 同一子系统 / 共 relevance_paths 的条目 |
-| 引用链 | A 的 rationale 依赖 B 的结论 |
-
-## 流程
-
-1. `fab_recall(paths=[...])` 拿候选 + 现有 `related`(读 description.related 看已连状态)。
-2. 对候选两两/成簇判隐藏关联(用上表判据);只提议**高置信**边,不为「话题相邻」乱连(噪声边稀释图价值)。
-3. 每条提议 = `(源 id, 目标 id, 类型, 一句理由)`;按需提议反向边。
-4. 落盘经 `fabric-review` 写路径:在源条目 frontmatter 的 `related` inline 数组追加目标 stable_id;`fabric doctor --fix` reconcile 进 agents.meta。
-5. 回报新增/反向边数 + 连通性变化(孤岛减少)。
-
-## Constraints
-
-- 本 skill **只提议 + 经 review 写路径落盘**;不自行改 store `knowledge/`,不手改 store counters(派生态)。
-- `related` MUST 只填**真实存在的 stable_id**(先 `fab_recall` 验证目标在库);NEVER 编造 / 指向 pending。
-- **稀疏优于稠密**:宁缺毋滥。只连高置信关联;低置信「相邻」不连(图的信噪比比覆盖率重要)。
-- 反向边按需补,不强制双向(有向语义:A 该带出 B ≠ B 该带出 A)。
-- 写 `related` 复用 H2 字段(`fabric-review` 的 modify 路径);schema 已支持,无需迁移。