@fenglimg/fabric-shared 2.0.0-rc.23 → 2.0.0-rc.25

package/dist/{chunk-GDYPVGWT.js → chunk-3RSYWMQU.js}

@@ -84,7 +84,9 @@ var planContextInputSchema = z2.object({
   detected_entities: z2.record(z2.array(z2.string())).optional().describe("Optional path-keyed detected entities for the requirement profile"),
   client_hash: z2.string().optional().describe("Revision hash from a prior fab_plan_context response; enables stale detection"),
   correlation_id: z2.string().optional().describe("Optional caller-provided correlation id for Event Ledger records"),
-  session_id: z2.string().optional().describe("Optional caller-provided session id for Event Ledger records"),
+  session_id: z2.string().optional().describe(
+    "Recommended: pass the current client session id (Claude Code: $session_id; Codex: corresponding identifier) \u2014 enables cross-session debt tracking in fab doctor and accurate archive-hint cross-session count. Falls back gracefully if omitted."
+  ),
   // v2.0-rc.5 A3 (TASK-007): `include_deprecated` removed — it was a no-op
   // placeholder (MaturitySchema has no `deprecated` value). When the maturity
   // enum widens we re-introduce the flag as part of that protocol bump.
@@ -526,6 +528,57 @@ var fabReviewAnnotations = {
   openWorldHint: false,
   title: "Review pending knowledge entries"
 };
+var citeContractMetricsSchema = z2.object({
+  decisions_cited: z2.number().int().nonnegative(),
+  pitfalls_cited: z2.number().int().nonnegative(),
+  contract_with: z2.number().int().nonnegative(),
+  contract_missing: z2.number().int().nonnegative(),
+  hard_violated: z2.number().int().nonnegative(),
+  cite_id_unresolved: z2.number().int().nonnegative(),
+  skip_count: z2.record(z2.string(), z2.number().int().nonnegative())
+});
+var citeLayerTypeBreakdownSchema = z2.object({
+  team: z2.record(z2.string(), z2.number().int().nonnegative()),
+  personal: z2.record(z2.string(), z2.number().int().nonnegative())
+});
+var citeCoverageReportSchema = z2.object({
+  status: z2.enum(["ok", "skipped"]),
+  marker_ts: z2.number().int().nonnegative(),
+  marker_emitted_now: z2.boolean(),
+  since_ts: z2.number().int().nonnegative(),
+  client_filter: z2.enum(["cc", "codex", "cursor", "all"]),
+  // v2.0.0-rc.24 TASK-08: layer filter discriminator. Optional so pre-TASK-10
+  // CLI callers (which never set the flag) still parse. Defaults to "all" at
+  // the service layer.
+  layer_filter: z2.enum(["team", "personal", "all"]).optional(),
+  metrics: z2.object({
+    edits_touched: z2.number().int().nonnegative(),
+    qualifying_cites: z2.number().int().nonnegative(),
+    recalled_unverified: z2.number().int().nonnegative(),
+    expected_but_missed: z2.number().int().nonnegative(),
+    total_turns: z2.number().int().nonnegative()
+  }),
+  per_client: z2.record(
+    z2.string(),
+    z2.object({
+      edits_touched: z2.number().int().nonnegative().optional(),
+      qualifying_cites: z2.number().int().nonnegative().optional(),
+      recalled_unverified: z2.number().int().nonnegative().optional(),
+      expected_but_missed: z2.number().int().nonnegative().optional(),
+      total_turns: z2.number().int().nonnegative().optional()
+    })
+  ).optional(),
+  dismissed_reason_histogram: z2.record(z2.string(), z2.number().int().nonnegative()).optional(),
+  none_reason_histogram: z2.record(z2.string(), z2.number().int().nonnegative()).optional(),
+  // v2.0.0-rc.24 TASK-08: contract-policy audit metrics. Status discriminates
+  // populated vs degraded modes. contract_metrics + per_layer_type are emitted
+  // (zeroed) in degraded modes so the renderer iterates one stable shape.
+  contract_metrics_status: z2.enum(["ok", "skipped:bootstrap_drift", "awaiting_marker"]).optional(),
+  contract_metrics: citeContractMetricsSchema.optional(),
+  per_layer_type: citeLayerTypeBreakdownSchema.optional(),
+  contract_marker_ts: z2.number().int().nonnegative().optional(),
+  generated_at: z2.string()
+});
 var ledgerSourceSchema = z2.enum(["ai", "human"]);
 var timestampFilterSchema = z2.preprocess((value) => {
   if (value === void 0 || value === null || value === "") {
@@ -654,6 +707,9 @@ export {
   FabReviewOutputSchema,
   FabReviewOutputShape,
   fabReviewAnnotations,
+  citeContractMetricsSchema,
+  citeLayerTypeBreakdownSchema,
+  citeCoverageReportSchema,
   ledgerSourceSchema,
   ledgerQuerySchema,
   historyStateQuerySchema,

package/dist/{chunk-IP6VWOVE.js → chunk-4OQXR6JW.js}

@@ -14,15 +14,45 @@ var BOOTSTRAP_CANONICAL = `# Fabric Bootstrap
 - **\`.fabric/agents.meta.json\` \u4E25\u7981\u624B\u52A8\u7F16\u8F91**;engine \u4F1A\u81EA\u52A8\u540C\u6B65\u6D3E\u751F\u72B6\u6001,\u663E\u5F0F reconcile \u8DD1 \`fab doctor --fix\`\u3002
 
 ## \u77E5\u8BC6\u5E93(KB)
-- **Discovery**:SessionStart hook \u5217 broad-scoped \u6761\u76EE;edit \u6587\u4EF6\u65F6 PreToolUse hook \u53EF\u80FD\u89E6\u53D1 narrow hint\u3002
+- **Discovery**:SessionStart hook \u5217 broad-scoped \u6761\u76EE(\u542B personal layer \`KP-*\` \u6761\u76EE,\u5F15\u7528\u65B9\u5F0F\u76F8\u540C);edit \u6587\u4EF6\u65F6 PreToolUse hook \u53EF\u80FD\u89E6\u53D1 narrow hint\u3002
 - **Usage**:\u4E24\u6B65\u5F0F\u2014\u2014\`fab_plan_context(paths=[...])\` \u8FD4\u56DE \`selection_token\` + \u5019\u9009 entries,\u518D \`fab_get_knowledge_sections({ selection_token, ai_selected_stable_ids: [<id>...] })\` \u62C9\u5168\u6587;\`selection_token\` \u5FC5\u987B\u6765\u81EA\u6700\u8FD1\u4E00\u6B21 \`fab_plan_context\`,\u4E0D\u53EF\u51ED\u7A7A\u7F16\u9020\u3002
+- **session_id**: \u8C03\u7528 \`fab_plan_context\` \u65F6, \u52A1\u5FC5\u628A\u5F53\u524D client session id \u4F5C\u4E3A \`session_id\` \u53C2\u6570\u4F20\u5165(Claude Code \u7684 session id \u5728 stdin payload \u4E2D, Codex \u7684\u5BF9\u5E94 identifier \u540C\u7406)\u3002\u8FD9\u80FD\u8BA9 \`fab doctor --archive-history\` \u4E0E archive-hint hook \u51C6\u786E\u8BC6\u522B\u8DE8\u4F1A\u8BDD debt \u72B6\u6001\u3002
 - **Write flows**:\`fabric-archive\` / \`fabric-review\` / \`fabric-import\` \u4E09\u4E2A Skills\u3002
 - **Language**:\u6E32\u67D3\u6309 \`.fabric/fabric-config.json\` \u7684 \`fabric_language\` \u5B57\u6BB5\u3002
 
+## Self-archive policy
+
+- **\u89E6\u53D1**: \u672C\u4F1A\u8BDD\u51FA\u73B0\u4EE5\u4E0B\u4EFB\u4E00\u4FE1\u53F7, \u5728\u8BE5 turn \u56DE\u590D\u672B\u5C3E\u81EA\u4E3B\u8C03\u7528 \`fabric-archive\` skill (E3-strong mode):
+  1. **Normative \u8BED\u8A00** \u2014 \u7528\u6237\u6D88\u606F\u51FA\u73B0 \`\u4EE5\u540E\` / \`always\` / \`never\` / \`from now on\` / \`\u4E0B\u6B21\u6CE8\u610F\` / \`\u8BB0\u4E00\u4E0B\` / \`\u6C38\u8FDC\u4E0D\u8981\`
+  2. **Wrong-turn-and-revert** \u2014 AI \u5C1D\u8BD5 path X, \u53CD\u601D\u540E\u6539\u8D70 path Y (\u5C24\u5176\u5F53 path X \u662F\u975E\u663E\u7136\u8E29\u5751)
+  3. **Decision confirmation** \u2014 \u7528\u6237\u5728 \u22652 \u5019\u9009\u4E2D\u6743\u8861\u540E\u7ED9\u51FA rationale \u9501\u5B9A\u65B9\u5411
+  4. **Explicit dismissal with reason** \u2014 \u7528\u6237\u62D2\u4E86\u67D0\u5EFA\u8BAE**\u5E76**\u8BF4\u4E86\u539F\u56E0
+
+- **Anti-trigger** (\u660E\u786E\u4E0D\u89E6\u53D1):
+  - \u7528\u6237\u7EAF\u8BE2\u95EE (\u65E0 normative \u8868\u8FBE)
+  - \u7B80\u5355 refactor / typo fix
+  - AI \u81EA\u5DF1\u4EA7\u751F\u7684'\u6D1E\u5BDF' (\u5FC5\u987B\u7531\u7528\u6237\u6D88\u606F\u4E2D\u4FE1\u53F7\u89E6\u53D1)
+
+- **Anti-loop \u4E09\u6761\u9632\u62A4**:
+  - \u540C turn \u6700\u591A\u81EA\u8C03 1 \u6B21
+  - \u540C session \u540C outcome \u4E0D\u91CD\u590D (\u82E5 user_dismissed, \u672C\u4F1A\u8BDD\u4E0D\u518D\u81EA\u8C03\u76F8\u540C\u4E3B\u9898)
+  - Phase 0.5 viability gate \u515C\u5E95 (skill \u5185\u90E8\u4ECD\u8DD1 gate, AI \u5224\u9519\u4E0D\u4F1A\u4E71\u5199 pending)
+
+- **\u5448\u73B0\u6A21\u677F** (turn \u672B\u5C3E\u63D2\u5165, \u4E24\u884C: \u5148 marker \u884C\u4F9B Phase 0.4 \u68C0\u6D4B, \u518D user-facing \u63D0\u793A):
+  \`\`\`
+  self-archive policy triggered by signal: <Normative|Wrong-turn-and-revert|Decision confirmation|Explicit dismissal>
+  \u987A\u624B\u5F52\u6863: \u6CE8\u610F\u5230\u4F60\u8BF4 \`<\u89E6\u53D1\u77ED\u8BED>\`, \u5DF2\u8C03\u7528 fabric-archive \u6293 N \u6761\u5019\u9009 \u2192 .fabric/knowledge/pending/...
+  \u82E5\u4E0D\u8BE5\u8BB0, \u7B54 '\u64A4\u9500' \u6211\u4F1A\u8C03 fab_review reject\u3002
+  \`\`\`
+  \u7B2C\u4E00\u884C\u662F Phase 0.4 Trigger Gate \u7528\u6765\u8BC6\u522B E3 \u5165\u53E3\u7684 structured marker (verbatim \u5B57\u7B26\u4E32 \`self-archive policy triggered by signal\`, \u540E\u63A5\u5192\u53F7 + \u89E6\u53D1\u4FE1\u53F7\u540D)\u3002\u7B2C\u4E8C\u884C\u8D77\u662F\u7ED9\u7528\u6237\u770B\u7684\u4E2D\u6587\u63D0\u793A\u3002\u4E24\u884C\u90FD\u5FC5\u987B\u51FA\u73B0; \u7F3A marker \u884C Phase 0.4 \u65E0\u6CD5\u8DEF\u7531\u5230 E3_ai_self_trigger\u3002
+
 ## Cite policy
 
 - **\u89E6\u53D1**: \u505A edit / decide / propose plan \u4E4B\u524D,**\u56DE\u590D\u9996\u884C**\u5FC5\u987B\u5199 \`KB: <id> (<\u22648\u5B57 \u7528\u6CD5>) [planned|recalled|chained-from <id>|dismissed:<reason>]\` \u6216 \`KB: none [<reason>]\`\u3002
 - **\`[recalled]\` \u9A8C\u8BC1**: \u5FC5\u987B\u7D27\u8DDF\u4E24\u6B65\u8C03\u7528\u2014\u2014\u5148 \`fab_plan_context(paths=[...])\` \u62FF \`selection_token\`,\u518D \`fab_get_knowledge_sections({ selection_token, ai_selected_stable_ids: [<id>] })\`,\u9632\u6B62\u7F16\u9020 id\u3002
+- **contract \u8BED\u6CD5**: decisions/pitfalls \u7C7B\u5F15\u7528\u5FC5\u987B\u5728\u5C3E\u6BB5\u52A0 contract: \`\u2192 <operator> [<operator> ...]\`,operator \u2208 {\`edit:<glob>\` \`!edit:<glob>\` \`require:<symbol>\` \`forbid:<symbol>\` \`skip:<reason>\`}\u3002\u4F8B:\`KB: K-001 (auth) [planned] \u2192 edit:src/auth/**/*.ts !edit:src/legacy/**\`\u3002
+- **skip reason \u8BCD\u5178**: \`sequencing | conditional | semantic | aesthetic | architectural | other:<text>\`\u3002
+- **type \u8DEF\u7531**: models \u7C7B\u5F15\u7528\u4E3A reference cite,\u4E0D\u9700\u8981 contract;guidelines/processes \u7C7B\u6682\u4E0D\u5F3A\u5236,\u63A8\u540E LLM-judge\u3002
 - **\u7528\u6237\u53E3\u5934\u63D0\u89C4\u5219\u6CA1\u7ED9 id**: \u5148\u8C03 \`fab_extract_knowledge\` \u6216 \`search_context\` \u53CD\u67E5\u3002
 - **dismissed reason**: \u679A\u4E3E \`scope-mismatch | outdated | not-applicable | other:<text>\`\u3002
 - **\`KB: none\` sentinel**: \u679A\u4E3E\u4E24\u79CD\u5408\u89C4\u7406\u7531\u2014\u2014\`[no-relevant]\` \u5DF2\u8C03 \`fab_plan_context\`(\u6216 hook \u8F93\u51FA\u53EF\u89C1)\u4F46\u65E0\u53EF\u7528\u6761\u76EE;\`[not-applicable]\` \u5F53\u524D\u52A8\u4F5C\u4E0D\u5728 cite \u8303\u56F4(\u7EAF\u63A2\u7D22 / Bash \u53EA\u8BFB / \u7528\u6237\u95EE\u7B54)\u3002\u88F8 \`KB: none\`(\u65E0\u540E\u7F00)\u4ECD\u7136 valid,\u5F52\u7C7B\u4E3A \`[unspecified]\`(legacy \u517C\u5BB9,\u9F13\u52B1\u540E\u7EED\u8865\u6CE8)\u3002

package/dist/{chunk-GYIALPMW.js → chunk-AFUQKKGR.js}

@@ -119,6 +119,41 @@ var enMessages = {
   "doctor.cite.none.not-applicable": "Not applicable",
   "doctor.cite.none.unspecified": "Unspecified",
   "doctor.cite.status.skipped": "Cite policy not yet activated for this workspace.",
+  // v2.0.0-rc.24 TASK-09: cite-coverage contract-policy renderer keys.
+  // Companion schema: packages/shared/src/schemas/api-contracts.ts
+  // citeCoverageReportSchema. Consumer: TASK-10 CLI doctor --cite-coverage.
+  "cite-coverage.contract.header": "Contract check",
+  "cite-coverage.contract.decisions_cited": "Decisions cited",
+  "cite-coverage.contract.pitfalls_cited": "Pitfalls cited",
+  "cite-coverage.contract.with": "With contract",
+  "cite-coverage.contract.missing": "Missing contract",
+  "cite-coverage.contract.hard_violated": "Hard violations (operator did not match session edits)",
+  "cite-coverage.contract.cite_id_unresolved": "Unresolved cite IDs",
+  "cite-coverage.contract.skip_count": "Skip bucket",
+  "cite-coverage.contract.status.ok": "ok",
+  "cite-coverage.contract.status.skipped_bootstrap_drift": "skipped (bootstrap drift \u2014 run `fab install`)",
+  "cite-coverage.contract.status.awaiting_marker": "awaiting first marker emit",
+  // Singular knowledge-type labels (verbatim alignment with KnowledgeTypeSchema)
+  // plus the sixth "unresolved" bucket.
+  "cite-coverage.contract.type.decision": "decision",
+  "cite-coverage.contract.type.pitfall": "pitfall",
+  "cite-coverage.contract.type.model": "model",
+  "cite-coverage.contract.type.guideline": "guideline",
+  "cite-coverage.contract.type.process": "process",
+  "cite-coverage.contract.type.unresolved": "unresolved",
+  // Layer labels (per_layer_type headers + layer_filter banner).
+  "cite-coverage.layer.team": "team",
+  "cite-coverage.layer.personal": "personal",
+  "cite-coverage.layer.team_review": "[team \u2014 review]",
+  "cite-coverage.layer.personal_fyi": "[personal \u2014 fyi]",
+  // skip_reason vocabulary (bootstrap-docs canonical; renderer falls back to
+  // the raw key for unknown buckets — operators data-drive extensions).
+  "cite-coverage.skip.sequencing": "sequencing constraint",
+  "cite-coverage.skip.conditional": "conditional branch",
+  "cite-coverage.skip.semantic": "semantic rule",
+  "cite-coverage.skip.aesthetic": "style / aesthetic",
+  "cite-coverage.skip.architectural": "architectural layer",
+  "cite-coverage.skip.other": "other",
   "cli.doctor.args.target.description": "Target project path. Defaults to --target, then EXTERNAL_FIXTURE_PATH, then cwd.",
   "cli.doctor.args.fix.description": "Repair derived Fabric state (meta + indexes).",
   "cli.doctor.args.json.description": "Print the doctor report as JSON.",
@@ -130,9 +165,12 @@ var enMessages = {
   "cli.doctor.args.cite-coverage.description": "Generate cite policy adherence report (read-only; skips standard inspections)",
   "cli.doctor.args.since.description": "Time window for cite coverage (e.g. 7d, 24h, 30m)",
   "cli.doctor.args.client.description": "Filter cite coverage by client (cc|codex|cursor|all)",
+  // v2.0.0-rc.24 TASK-10: --layer filters cite contract audit by KB layer (team|personal|all).
+  "cli.doctor.args.layer.description": "Filter cite contract audit by KB layer (team|personal|all)",
   "cli.doctor.errors.cite-coverage-mutex": "--cite-coverage cannot be combined with --fix or --fix-knowledge",
   "cli.doctor.errors.invalid-since": "Invalid --since value: {input}. Expected duration like 7d, 24h, 30m or epoch ms.",
   "cli.doctor.errors.invalid-client": "Invalid --client value: {input}. Expected cc, codex, cursor, or all.",
+  "cli.doctor.errors.invalid-layer": "Invalid --layer value: {input}. Expected team, personal, or all.",
   // rc.23 TASK-007 (a-C2): --enrich-descriptions flag set. Back-fills the
   // four description-grade frontmatter fields on canonical knowledge entries.
   "cli.doctor.args.enrich-descriptions.description": "Back-fill missing intent_clues / tech_stack / impact / must_read_if on canonical knowledge entries (read-only by default; pair with --auto to write stubs).",
@@ -140,6 +178,18 @@ var enMessages = {
   "cli.doctor.args.dry-run.description": "With --enrich-descriptions --auto: preview the would-be changes without writing to disk.",
   "cli.doctor.errors.enrich-descriptions-mutex": "--enrich-descriptions cannot be combined with --fix, --fix-knowledge, or --cite-coverage. Run them separately.",
   "doctor.enrich.allComplete": "All canonical knowledge entries already declare intent_clues / tech_stack / impact / must_read_if.",
+  // v2.0.0-rc.25 TASK-10: --archive-history flag set. Read-only audit of
+  // session_archive_attempted events; mutually exclusive with the other
+  // mutation/report surfaces.
+  "cli.doctor.args.archive-history.description": "Render per-session archive attempt history (read-only; reads session_archive_attempted events).",
+  "cli.doctor.errors.archive-history-mutex": "--archive-history cannot be combined with --fix, --fix-knowledge, --cite-coverage, or --enrich-descriptions. Run them separately.",
+  "doctor.archive-history.header": "Archive history (last {sinceLabel}, {count} session{plural})",
+  "doctor.archive-history.empty": "No archive history yet within the --since={sinceLabel} window.",
+  "doctor.archive-history.table.session": "Session",
+  "doctor.archive-history.table.lastAttempt": "Last attempt",
+  "doctor.archive-history.table.outcome": "Outcome",
+  "doctor.archive-history.table.candidates": "Candidates",
+  "doctor.archive-history.table.coveredGap": "Covered gap",
   "cli.hooks.description": "Manage Fabric Git hook templates.",
   "cli.hooks.install.description": "Install the Fabric Husky pre-commit hook template.",
   "cli.hooks.install.args.target.description": "Target project path, default is the current working directory.",
@@ -669,6 +719,39 @@ var zhCNMessages = {
   "doctor.cite.none.not-applicable": "\u4E0D\u5728\u8303\u56F4",
   "doctor.cite.none.unspecified": "\u672A\u6CE8\u660E",
   "doctor.cite.status.skipped": "\u672C\u5DE5\u4F5C\u533A Cite policy \u5C1A\u672A\u6FC0\u6D3B\u3002",
+  // v2.0.0-rc.24 TASK-09: cite-coverage 合约审计渲染键（contract-policy 审计窗口）。
+  // 配套 schema：packages/shared/src/schemas/api-contracts.ts citeCoverageReportSchema。
+  // 渲染器消费方：TASK-10 CLI doctor --cite-coverage（layer / type / skip / status / contract）。
+  "cite-coverage.contract.header": "\u5E94\u7528\u5951\u7EA6\u6821\u9A8C",
+  "cite-coverage.contract.decisions_cited": "decisions \u5F15\u7528",
+  "cite-coverage.contract.pitfalls_cited": "pitfalls \u5F15\u7528",
+  "cite-coverage.contract.with": "\u5DF2\u9644\u5951\u7EA6",
+  "cite-coverage.contract.missing": "\u7F3A\u5951\u7EA6",
+  "cite-coverage.contract.hard_violated": "\u786C\u6027\u8FDD\u89C4\uFF08\u64CD\u4F5C\u7B26\u672A\u5339\u914D session \u7F16\u8F91\uFF09",
+  "cite-coverage.contract.cite_id_unresolved": "\u5F15\u7528 ID \u4E0D\u5B58\u5728",
+  "cite-coverage.contract.skip_count": "skip \u6876",
+  "cite-coverage.contract.status.ok": "\u6B63\u5E38",
+  "cite-coverage.contract.status.skipped_bootstrap_drift": "\u5DF2\u8DF3\u8FC7\uFF08bootstrap drift \u2014 \u8BF7\u8FD0\u884C fab install\uFF09",
+  "cite-coverage.contract.status.awaiting_marker": "\u7B49\u5F85\u9996\u6B21 marker emit",
+  // 单数知识类型（与 KnowledgeTypeSchema 枚举字面量逐字对齐）+ 第六桶 unresolved。
+  "cite-coverage.contract.type.decision": "decision",
+  "cite-coverage.contract.type.pitfall": "pitfall",
+  "cite-coverage.contract.type.model": "model",
+  "cite-coverage.contract.type.guideline": "guideline",
+  "cite-coverage.contract.type.process": "process",
+  "cite-coverage.contract.type.unresolved": "unresolved",
+  // 知识层标签（per_layer_type 表头 + layer_filter 标识）。
+  "cite-coverage.layer.team": "team",
+  "cite-coverage.layer.personal": "personal",
+  "cite-coverage.layer.team_review": "[team \u2014 \u9700\u590D\u6838]",
+  "cite-coverage.layer.personal_fyi": "[personal \u2014 fyi]",
+  // skip_reason 标准词表（bootstrap 文档定义；运营方可继续扩展词条，渲染器对未知键回退到原始 key）。
+  "cite-coverage.skip.sequencing": "\u987A\u5E8F\u7EA6\u675F",
+  "cite-coverage.skip.conditional": "\u6761\u4EF6\u5206\u652F",
+  "cite-coverage.skip.semantic": "\u8BED\u4E49\u7EA6\u675F",
+  "cite-coverage.skip.aesthetic": "\u7F8E\u5B66/\u98CE\u683C",
+  "cite-coverage.skip.architectural": "\u67B6\u6784\u5C42",
+  "cite-coverage.skip.other": "\u5176\u4ED6",
   "cli.doctor.args.target.description": "\u76EE\u6807\u9879\u76EE\u8DEF\u5F84\u3002\u9ED8\u8BA4\u4F9D\u6B21\u4F7F\u7528 --target\u3001EXTERNAL_FIXTURE_PATH\u3001\u5F53\u524D\u76EE\u5F55\u3002",
   "cli.doctor.args.fix.description": "\u4FEE\u590D Fabric \u6D3E\u751F\u72B6\u6001\uFF08meta + \u7D22\u5F15\uFF09\u3002",
   "cli.doctor.args.json.description": "\u4EE5 JSON \u8F93\u51FA doctor \u62A5\u544A\u3002",
@@ -680,15 +763,28 @@ var zhCNMessages = {
   "cli.doctor.args.cite-coverage.description": "Cite \u653F\u7B56\u5408\u89C4\u62A5\u544A(\u53EA\u8BFB;\u8DF3\u8FC7\u6807\u51C6\u68C0\u67E5)",
   "cli.doctor.args.since.description": "Cite \u8986\u76D6\u7387\u7EDF\u8BA1\u7A97\u53E3(\u5982 7d, 24h, 30m)",
   "cli.doctor.args.client.description": "\u6309\u5BA2\u6237\u7AEF\u8FC7\u6EE4(cc|codex|cursor|all)",
+  // v2.0.0-rc.24 TASK-10: --layer 过滤 cite 合约审计的知识层 (team|personal|all)。
+  "cli.doctor.args.layer.description": "\u6309\u77E5\u8BC6\u5C42\u8FC7\u6EE4 cite \u5408\u7EA6\u5BA1\u8BA1 (team|personal|all)",
   "cli.doctor.errors.cite-coverage-mutex": "--cite-coverage \u4E0D\u80FD\u4E0E --fix \u6216 --fix-knowledge \u540C\u65F6\u4F7F\u7528",
   "cli.doctor.errors.invalid-since": "--since \u53D6\u503C\u65E0\u6548: {input}\u3002\u9884\u671F\u683C\u5F0F 7d / 24h / 30m \u6216 epoch ms\u3002",
   "cli.doctor.errors.invalid-client": "--client \u53D6\u503C\u65E0\u6548: {input}\u3002\u9884\u671F cc / codex / cursor / all\u3002",
+  "cli.doctor.errors.invalid-layer": "--layer \u53D6\u503C\u65E0\u6548: {input}\u3002\u9884\u671F team / personal / all\u3002",
   // rc.23 TASK-007 (a-C2): --enrich-descriptions 回填四个 description 字段。
   "cli.doctor.args.enrich-descriptions.description": "\u56DE\u586B\u6B63\u5F0F\u77E5\u8BC6\u6761\u76EE\u7F3A\u5931\u7684 intent_clues / tech_stack / impact / must_read_if \u5B57\u6BB5\uFF08\u9ED8\u8BA4\u53EA\u8BFB;\u642D\u914D --auto \u5199\u5165 stub\uFF09\u3002",
   "cli.doctor.args.auto.description": "\u4E0E --enrich-descriptions \u642D\u914D\uFF1A\u4E3A\u7F3A\u5931\u5B57\u6BB5\u5199\u5165\u786E\u5B9A\u6027 stub \u503C\u3002\u4E0D\u52A0 --auto \u4EC5\u505A\u53EA\u8BFB\u626B\u63CF\u3002",
   "cli.doctor.args.dry-run.description": "\u4E0E --enrich-descriptions --auto \u642D\u914D\uFF1A\u4EC5\u9884\u89C8\u6539\u52A8\u8BA1\u5212,\u4E0D\u5199\u5165\u78C1\u76D8\u3002",
   "cli.doctor.errors.enrich-descriptions-mutex": "--enrich-descriptions \u4E0D\u80FD\u4E0E --fix / --fix-knowledge / --cite-coverage \u540C\u65F6\u4F7F\u7528,\u8BF7\u5206\u522B\u8FD0\u884C\u3002",
   "doctor.enrich.allComplete": "\u6240\u6709\u6B63\u5F0F\u77E5\u8BC6\u6761\u76EE\u5747\u5DF2\u5305\u542B intent_clues / tech_stack / impact / must_read_if\u3002",
+  // v2.0.0-rc.25 TASK-10: --archive-history 子命令——按 session 维度审计归档尝试记录。
+  "cli.doctor.args.archive-history.description": "\u6309 session \u7EF4\u5EA6\u6E32\u67D3\u5F52\u6863\u5C1D\u8BD5\u5386\u53F2(\u53EA\u8BFB;\u8BFB\u53D6 session_archive_attempted \u4E8B\u4EF6)\u3002",
+  "cli.doctor.errors.archive-history-mutex": "--archive-history \u4E0D\u80FD\u4E0E --fix / --fix-knowledge / --cite-coverage / --enrich-descriptions \u540C\u65F6\u4F7F\u7528,\u8BF7\u5206\u522B\u8FD0\u884C\u3002",
+  "doctor.archive-history.header": "\u5F52\u6863\u5386\u53F2(\u6700\u8FD1 {sinceLabel},{count} \u4E2A\u4F1A\u8BDD)",
+  "doctor.archive-history.empty": "\u6682\u65E0\u5F52\u6863\u5386\u53F2\u8BB0\u5F55 (--since={sinceLabel} \u7A97\u53E3\u5185)\u3002",
+  "doctor.archive-history.table.session": "\u4F1A\u8BDD",
+  "doctor.archive-history.table.lastAttempt": "\u6700\u8FD1\u5C1D\u8BD5",
+  "doctor.archive-history.table.outcome": "\u7ED3\u679C",
+  "doctor.archive-history.table.candidates": "\u5019\u9009\u6570",
+  "doctor.archive-history.table.coveredGap": "\u8986\u76D6\u8DDD\u4ECA",
   "cli.hooks.description": "\u7BA1\u7406 Fabric Git \u94A9\u5B50\u6A21\u677F\u3002",
   "cli.hooks.install.description": "\u5B89\u88C5 Fabric Husky pre-commit \u94A9\u5B50\u6A21\u677F\u3002",
   "cli.hooks.install.args.target.description": "\u76EE\u6807\u9879\u76EE\u8DEF\u5F84\uFF0C\u9ED8\u8BA4\u4E3A\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\u3002",

package/dist/i18n/index.js

@@ -6,7 +6,7 @@ import {
   enMessages,
   normalizeLocale,
   zhCNMessages
-} from "../chunk-GYIALPMW.js";
+} from "../chunk-AFUQKKGR.js";
 export {
   PROTECTED_TOKENS,
   createTranslator,

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { AgentsActivationTier, AgentsMetaCountersEnvelope, AgentsMetaKnowledgeTy
 export { Locale, Messages, PROTECTED_TOKENS, ProtectedToken, TranslationKey, Translator, createTranslator, defaultMessages, detectNodeLocale, enMessages, normalizeLocale, zhCNMessages } from './i18n/index.js';
 import { z } from 'zod';
 import { Layer, KnowledgeType, StableId } from './schemas/api-contracts.js';
-export { FabExtractKnowledgeInput, FabExtractKnowledgeInputSchema, FabExtractKnowledgeInputShape, FabExtractKnowledgeOutput, FabExtractKnowledgeOutputSchema, FabReviewInput, FabReviewInputSchema, FabReviewInputShape, FabReviewOutput, FabReviewOutputSchema, FabReviewOutputShape, KNOWLEDGE_TYPE_CODES, KnowledgeEntryFrontmatter, KnowledgeEntryFrontmatterSchema, KnowledgeTypeCode, KnowledgeTypeSchema, LayerSchema, Maturity, MaturitySchema, PROPOSED_REASON_DESCRIPTIONS, ProposedReason, ProposedReasonSchema, StableIdSchema, annotateIntentRequestSchema, fabExtractKnowledgeAnnotations, fabReviewAnnotations, formatKnowledgeId, historyStateQuerySchema, humanLockApproveRequestSchema, humanLockFileParamsSchema, knowledgeSectionsAnnotations, knowledgeSectionsInputSchema, knowledgeSectionsOutputSchema, ledgerQuerySchema, ledgerSourceSchema, parseKnowledgeId, planContextAnnotations, planContextHintNarrowEntrySchema, planContextHintOutputSchema, planContextInputSchema, planContextOutputSchema, structuredWarningSchema } from './schemas/api-contracts.js';
+export { CiteContractMetrics, CiteCoverageReport, CiteLayerTypeBreakdown, FabExtractKnowledgeInput, FabExtractKnowledgeInputSchema, FabExtractKnowledgeInputShape, FabExtractKnowledgeOutput, FabExtractKnowledgeOutputSchema, FabReviewInput, FabReviewInputSchema, FabReviewInputShape, FabReviewOutput, FabReviewOutputSchema, FabReviewOutputShape, KNOWLEDGE_TYPE_CODES, KnowledgeEntryFrontmatter, KnowledgeEntryFrontmatterSchema, KnowledgeTypeCode, KnowledgeTypeSchema, LayerSchema, Maturity, MaturitySchema, PROPOSED_REASON_DESCRIPTIONS, ProposedReason, ProposedReasonSchema, StableIdSchema, annotateIntentRequestSchema, citeContractMetricsSchema, citeCoverageReportSchema, citeLayerTypeBreakdownSchema, fabExtractKnowledgeAnnotations, fabReviewAnnotations, formatKnowledgeId, historyStateQuerySchema, humanLockApproveRequestSchema, humanLockFileParamsSchema, knowledgeSectionsAnnotations, knowledgeSectionsInputSchema, knowledgeSectionsOutputSchema, ledgerQuerySchema, ledgerSourceSchema, parseKnowledgeId, planContextAnnotations, planContextHintNarrowEntrySchema, planContextHintOutputSchema, planContextInputSchema, planContextOutputSchema, structuredWarningSchema } from './schemas/api-contracts.js';
 export { BOOTSTRAP_CANONICAL, BOOTSTRAP_MARKER_BEGIN, BOOTSTRAP_MARKER_END, BOOTSTRAP_REGEX, LEGACY_KB_MARKER_BEGIN, LEGACY_KB_MARKER_END, LEGACY_KB_REGEX } from './templates/bootstrap-canonical.js';
 
 declare const ONBOARD_SLOT_NAMES: readonly ["tech-stack-decision", "architecture-pattern", "code-style-tone", "build-system-idiom", "domain-vocabulary"];
@@ -1091,8 +1091,8 @@ declare const knowledgeTestIndexSchema: z.ZodObject<{
         previous_test_hash?: string | undefined;
     }>, "many">;
 }, "strict", z.ZodTypeAny, {
-    schema_version: 1;
     generated_at: string;
+    schema_version: 1;
     links: {
         rule_stable_id: string;
         rule_file: string;
@@ -1113,8 +1113,8 @@ declare const knowledgeTestIndexSchema: z.ZodObject<{
     revision?: string | undefined;
     previous_revision?: string | undefined;
 }, {
-    schema_version: 1;
     generated_at: string;
+    schema_version: 1;
     links: {
         rule_stable_id: string;
         rule_file: string;
@@ -1321,14 +1321,14 @@ declare const clientPathsSchema: z.ZodObject<{
     cursor: z.ZodOptional<z.ZodString>;
     codexCLI: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
+    cursor?: string | undefined;
     claudeCodeCLI?: string | undefined;
     claudeCodeDesktop?: string | undefined;
-    cursor?: string | undefined;
     codexCLI?: string | undefined;
 }, {
+    cursor?: string | undefined;
     claudeCodeCLI?: string | undefined;
     claudeCodeDesktop?: string | undefined;
-    cursor?: string | undefined;
     codexCLI?: string | undefined;
 }>;
 declare const mcpPayloadLimitsSchema: z.ZodOptional<z.ZodObject<{
@@ -1350,14 +1350,14 @@ declare const fabricConfigSchema: z.ZodObject<{
         cursor: z.ZodOptional<z.ZodString>;
         codexCLI: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
+        cursor?: string | undefined;
         claudeCodeCLI?: string | undefined;
         claudeCodeDesktop?: string | undefined;
-        cursor?: string | undefined;
         codexCLI?: string | undefined;
     }, {
+        cursor?: string | undefined;
         claudeCodeCLI?: string | undefined;
         claudeCodeDesktop?: string | undefined;
-        cursor?: string | undefined;
         codexCLI?: string | undefined;
     }>>;
     scanIgnores: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -1417,9 +1417,9 @@ declare const fabricConfigSchema: z.ZodObject<{
     review_stale_pending_days: number;
     onboard_slots_opted_out: string[];
     clientPaths?: {
+        cursor?: string | undefined;
         claudeCodeCLI?: string | undefined;
         claudeCodeDesktop?: string | undefined;
-        cursor?: string | undefined;
         codexCLI?: string | undefined;
     } | undefined;
     scanIgnores?: string[] | undefined;
@@ -1431,9 +1431,9 @@ declare const fabricConfigSchema: z.ZodObject<{
     fabric_event_retention_days?: 7 | 30 | 90 | undefined;
 }, {
     clientPaths?: {
+        cursor?: string | undefined;
         claudeCodeCLI?: string | undefined;
         claudeCodeDesktop?: string | undefined;
-        cursor?: string | undefined;
         codexCLI?: string | undefined;
     } | undefined;
     scanIgnores?: string[] | undefined;
@@ -6247,6 +6247,31 @@ declare const assistantTurnObservedEventSchema: z.ZodObject<{
     kb_line_raw: z.ZodNullable<z.ZodString>;
     cite_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     cite_tags: z.ZodDefault<z.ZodArray<z.ZodEnum<["planned", "recalled", "chained-from", "dismissed", "none"]>, "many">>;
+    cite_commitments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        operators: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<["edit", "not_edit", "require", "forbid"]>;
+            target: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }, {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }>, "many">;
+        skip_reason: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        operators: {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }[];
+        skip_reason: string | null;
+    }, {
+        operators: {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }[];
+        skip_reason: string | null;
+    }>, "many">>;
     client: z.ZodOptional<z.ZodEnum<["cc", "codex", "cursor"]>>;
     turn_id: z.ZodString;
     envelope_index: z.ZodOptional<z.ZodNumber>;
@@ -6267,10 +6292,17 @@ declare const assistantTurnObservedEventSchema: z.ZodObject<{
     kb_line_raw: string | null;
     cite_ids: string[];
     cite_tags: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[];
+    cite_commitments: {
+        operators: {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }[];
+        skip_reason: string | null;
+    }[];
     turn_id: string;
     correlation_id?: string | undefined;
     session_id?: string | undefined;
-    client?: "cursor" | "cc" | "codex" | undefined;
+    client?: "cc" | "codex" | "cursor" | undefined;
     envelope_index?: number | undefined;
 }, {
     id: string;
@@ -6285,7 +6317,14 @@ declare const assistantTurnObservedEventSchema: z.ZodObject<{
     session_id?: string | undefined;
     cite_ids?: string[] | undefined;
     cite_tags?: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[] | undefined;
-    client?: "cursor" | "cc" | "codex" | undefined;
+    cite_commitments?: {
+        operators: {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }[];
+        skip_reason: string | null;
+    }[] | undefined;
+    client?: "cc" | "codex" | "cursor" | undefined;
     envelope_index?: number | undefined;
 }>;
 declare const citePolicyActivatedEventSchema: z.ZodObject<{
@@ -6319,6 +6358,31 @@ declare const citePolicyActivatedEventSchema: z.ZodObject<{
     correlation_id?: string | undefined;
     session_id?: string | undefined;
 }>;
+declare const citeContractPolicyActivatedEventSchema: z.ZodObject<{
+    event_type: z.ZodLiteral<"cite_contract_policy_activated">;
+    kind: z.ZodLiteral<"fabric-event">;
+    id: z.ZodString;
+    ts: z.ZodNumber;
+    schema_version: z.ZodLiteral<1>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    session_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "cite_contract_policy_activated";
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "cite_contract_policy_activated";
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}>;
 declare const eventsRotatedEventSchema: z.ZodObject<{
     event_type: z.ZodLiteral<"events_rotated">;
     cutoff_ts: z.ZodString;
@@ -6464,6 +6528,43 @@ declare const knowledgeEnrichedEventSchema: z.ZodObject<{
     correlation_id?: string | undefined;
     session_id?: string | undefined;
 }>;
+declare const sessionArchiveAttemptedEventSchema: z.ZodObject<{
+    event_type: z.ZodLiteral<"session_archive_attempted">;
+    outcome: z.ZodEnum<["proposed", "viability_failed", "user_dismissed", "skipped_no_signal"]>;
+    covered_through_ts: z.ZodNumber;
+    candidates_proposed: z.ZodDefault<z.ZodNumber>;
+    knowledge_proposed_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    kind: z.ZodLiteral<"fabric-event">;
+    id: z.ZodString;
+    ts: z.ZodNumber;
+    schema_version: z.ZodLiteral<1>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    session_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "session_archive_attempted";
+    outcome: "proposed" | "viability_failed" | "user_dismissed" | "skipped_no_signal";
+    covered_through_ts: number;
+    candidates_proposed: number;
+    knowledge_proposed_ids: string[];
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "session_archive_attempted";
+    outcome: "proposed" | "viability_failed" | "user_dismissed" | "skipped_no_signal";
+    covered_through_ts: number;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+    candidates_proposed?: number | undefined;
+    knowledge_proposed_ids?: string[] | undefined;
+}>;
 declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.ZodObject<{
     event_type: z.ZodLiteral<"knowledge_context_planned">;
     target_paths: z.ZodArray<z.ZodString, "many">;
@@ -7682,6 +7783,31 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     kb_line_raw: z.ZodNullable<z.ZodString>;
     cite_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     cite_tags: z.ZodDefault<z.ZodArray<z.ZodEnum<["planned", "recalled", "chained-from", "dismissed", "none"]>, "many">>;
+    cite_commitments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        operators: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<["edit", "not_edit", "require", "forbid"]>;
+            target: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }, {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }>, "many">;
+        skip_reason: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        operators: {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }[];
+        skip_reason: string | null;
+    }, {
+        operators: {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }[];
+        skip_reason: string | null;
+    }>, "many">>;
     client: z.ZodOptional<z.ZodEnum<["cc", "codex", "cursor"]>>;
     turn_id: z.ZodString;
     envelope_index: z.ZodOptional<z.ZodNumber>;
@@ -7702,10 +7828,17 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     kb_line_raw: string | null;
     cite_ids: string[];
     cite_tags: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[];
+    cite_commitments: {
+        operators: {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }[];
+        skip_reason: string | null;
+    }[];
     turn_id: string;
     correlation_id?: string | undefined;
     session_id?: string | undefined;
-    client?: "cursor" | "cc" | "codex" | undefined;
+    client?: "cc" | "codex" | "cursor" | undefined;
     envelope_index?: number | undefined;
 }, {
     id: string;
@@ -7720,7 +7853,14 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     session_id?: string | undefined;
     cite_ids?: string[] | undefined;
     cite_tags?: ("none" | "planned" | "recalled" | "chained-from" | "dismissed")[] | undefined;
-    client?: "cursor" | "cc" | "codex" | undefined;
+    cite_commitments?: {
+        operators: {
+            kind: "require" | "edit" | "not_edit" | "forbid";
+            target: string;
+        }[];
+        skip_reason: string | null;
+    }[] | undefined;
+    client?: "cc" | "codex" | "cursor" | undefined;
     envelope_index?: number | undefined;
 }>, z.ZodObject<{
     event_type: z.ZodLiteral<"cite_policy_activated">;
@@ -7752,6 +7892,30 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     policy_version: string;
     correlation_id?: string | undefined;
     session_id?: string | undefined;
+}>, z.ZodObject<{
+    event_type: z.ZodLiteral<"cite_contract_policy_activated">;
+    kind: z.ZodLiteral<"fabric-event">;
+    id: z.ZodString;
+    ts: z.ZodNumber;
+    schema_version: z.ZodLiteral<1>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    session_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "cite_contract_policy_activated";
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "cite_contract_policy_activated";
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
 }>, z.ZodObject<{
     event_type: z.ZodLiteral<"knowledge_meta_auto_healed">;
     previous_revision_hash: z.ZodString;
@@ -7893,6 +8057,42 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     added_fields: ("intent_clues" | "tech_stack" | "impact" | "must_read_if")[];
     correlation_id?: string | undefined;
     session_id?: string | undefined;
+}>, z.ZodObject<{
+    event_type: z.ZodLiteral<"session_archive_attempted">;
+    outcome: z.ZodEnum<["proposed", "viability_failed", "user_dismissed", "skipped_no_signal"]>;
+    covered_through_ts: z.ZodNumber;
+    candidates_proposed: z.ZodDefault<z.ZodNumber>;
+    knowledge_proposed_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    kind: z.ZodLiteral<"fabric-event">;
+    id: z.ZodString;
+    ts: z.ZodNumber;
+    schema_version: z.ZodLiteral<1>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    session_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "session_archive_attempted";
+    outcome: "proposed" | "viability_failed" | "user_dismissed" | "skipped_no_signal";
+    covered_through_ts: number;
+    candidates_proposed: number;
+    knowledge_proposed_ids: string[];
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+}, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "session_archive_attempted";
+    outcome: "proposed" | "viability_failed" | "user_dismissed" | "skipped_no_signal";
+    covered_through_ts: number;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+    candidates_proposed?: number | undefined;
+    knowledge_proposed_ids?: string[] | undefined;
 }>]>;
 type KnowledgeContextPlannedEvent = z.infer<typeof knowledgeContextPlannedEventSchema>;
 type KnowledgeSelectionEvent = z.infer<typeof knowledgeSelectionEventSchema>;
@@ -7929,13 +8129,39 @@ type DoctorRunEvent = z.infer<typeof doctorRunEventSchema>;
 type RelevanceMigrationRunEvent = z.infer<typeof relevanceMigrationRunEventSchema>;
 type AssistantTurnObservedEvent = z.infer<typeof assistantTurnObservedEventSchema>;
 type CitePolicyActivatedEvent = z.infer<typeof citePolicyActivatedEventSchema>;
+type CiteContractPolicyActivatedEvent = z.infer<typeof citeContractPolicyActivatedEventSchema>;
 type KnowledgeMetaAutoHealedEvent = z.infer<typeof knowledgeMetaAutoHealedEventSchema>;
 type EventsRotatedEvent = z.infer<typeof eventsRotatedEventSchema>;
 type ServeLockClearedEvent = z.infer<typeof serveLockClearedEventSchema>;
 type KnowledgeEnrichedEvent = z.infer<typeof knowledgeEnrichedEventSchema>;
-type EventLedgerEvent = KnowledgeContextPlannedEvent | KnowledgeSelectionEvent | KnowledgeSectionsFetchedEvent | EditIntentCheckedEvent | KnowledgeDriftDetectedEvent | McpEventLedgerEvent | ReapplyCompletedEvent | EventLedgerTruncatedEvent | McpConfigMigratedEvent | BootstrapMarkerMigratedEvent | MetaReconciledOnStartupEvent | MetaReconciledEvent | ClaudeSkillPathMigratedEvent | ClaudeHookPathMigratedEvent | CodexSkillPathMigratedEvent | InitScanCompletedEvent | KnowledgeProposedEvent | KnowledgePromoteStartedEvent | KnowledgePromotedEvent | KnowledgePromoteFailedEvent | KnowledgeLayerChangedEvent | KnowledgeSlugRenamedEvent | KnowledgeDemotedEvent | KnowledgeArchivedEvent | KnowledgeArchiveAttemptedEvent | KnowledgeDeferredEvent | KnowledgeRejectedEvent | KnowledgeConsumedEvent | KnowledgeScopeDegradedEvent | PendingAutoArchivedEvent | KnowledgePathDangledEvent | DoctorRunEvent | RelevanceMigrationRunEvent | AssistantTurnObservedEvent | CitePolicyActivatedEvent | KnowledgeMetaAutoHealedEvent | EventsRotatedEvent | ServeLockClearedEvent | KnowledgeEnrichedEvent;
+type SessionArchiveAttemptedEvent = z.infer<typeof sessionArchiveAttemptedEventSchema>;
+type EventLedgerEvent = KnowledgeContextPlannedEvent | KnowledgeSelectionEvent | KnowledgeSectionsFetchedEvent | EditIntentCheckedEvent | KnowledgeDriftDetectedEvent | McpEventLedgerEvent | ReapplyCompletedEvent | EventLedgerTruncatedEvent | McpConfigMigratedEvent | BootstrapMarkerMigratedEvent | MetaReconciledOnStartupEvent | MetaReconciledEvent | ClaudeSkillPathMigratedEvent | ClaudeHookPathMigratedEvent | CodexSkillPathMigratedEvent | InitScanCompletedEvent | KnowledgeProposedEvent | KnowledgePromoteStartedEvent | KnowledgePromotedEvent | KnowledgePromoteFailedEvent | KnowledgeLayerChangedEvent | KnowledgeSlugRenamedEvent | KnowledgeDemotedEvent | KnowledgeArchivedEvent | KnowledgeArchiveAttemptedEvent | KnowledgeDeferredEvent | KnowledgeRejectedEvent | KnowledgeConsumedEvent | KnowledgeScopeDegradedEvent | PendingAutoArchivedEvent | KnowledgePathDangledEvent | DoctorRunEvent | RelevanceMigrationRunEvent | AssistantTurnObservedEvent | CitePolicyActivatedEvent | CiteContractPolicyActivatedEvent | KnowledgeMetaAutoHealedEvent | EventsRotatedEvent | ServeLockClearedEvent | KnowledgeEnrichedEvent | SessionArchiveAttemptedEvent;
 type EventLedgerEventType = EventLedgerEvent["event_type"];
 type EventLedgerEventInputFor<T extends EventLedgerEvent> = T extends EventLedgerEvent ? Omit<T, "kind" | "id" | "ts" | "schema_version" | "correlation_id" | "session_id"> & Partial<Pick<T, "id" | "ts" | "correlation_id" | "session_id">> : never;
 type EventLedgerEventInput = EventLedgerEventInputFor<EventLedgerEvent>;
 
-export { AGENTS_META_IDENTITY_SOURCES, AGENTS_META_LAYERS, AGENTS_META_TOPOLOGY_TYPES, AgentsIdentitySource, AgentsLayer, AgentsMeta, type AgentsMetaCounters, AgentsMetaCountersSchema, AgentsMetaNode, AgentsTopologyType, type AssistantTurnObservedEvent, type BootstrapMarkerMigratedEvent, type CandidateFileEntry, type CandidateFileFamily, type CitePolicyActivatedEvent, type ClaudeHookPathMigratedEvent, type ClaudeSkillPathMigratedEvent, type CodexSkillPathMigratedEvent, type DoctorRunEvent, type DriftDetectedEvent, type EditIntentCheckedEvent, type EventLedgerEvent, type EventLedgerEventInput, type EventLedgerEventType, type EventLedgerTruncatedEvent, type EventsRotatedEvent, type FabricConfigSchemaShape, type FabricEvent, type ForensicAssertion, type ForensicAssertionConfidence, type ForensicAssertionCoverage, type ForensicAssertionType, type ForensicCodeSample, type ForensicEntryPoint, type ForensicEvidenceAnchor, type ForensicFramework, type ForensicReadme, type ForensicReport, type ForensicSamplingBudget, type ForensicTopology, HumanLockEntry, type HumanLockFile, type InitContext, type InitContextDomainGroup, type InitContextFramework, type InitContextInterviewTrailEntry, type InitContextInvariant, type InitContextInvariantConfidenceSnapshot, type InitContextSourceEvidence, type InitScanCompletedEvent, KNOWLEDGE_TEST_INDEX_SCHEMA_VERSION, type KnowledgeArchiveAttemptedEvent, type KnowledgeArchivedEvent, type KnowledgeConsumedEvent, type KnowledgeContextPlannedEvent, type KnowledgeDeferredEvent, type KnowledgeDemotedEvent, type KnowledgeDriftDetectedEvent, type KnowledgeEnrichedEvent, type KnowledgeLayerChangedEvent, type KnowledgeMetaAutoHealedEvent, type KnowledgePathDangledEvent, type KnowledgePromoteFailedEvent, type KnowledgePromoteStartedEvent, type KnowledgePromotedEvent, type KnowledgeProposedEvent, type KnowledgeRejectedEvent, type KnowledgeScopeDegradedEvent, type KnowledgeSectionsFetchedEvent, type KnowledgeSelectionEvent, type KnowledgeSlugRenamedEvent, type KnowledgeTestIndex, type KnowledgeTestLink, type KnowledgeTestOrphanAnnotation, KnowledgeType, Layer, type LedgerAppendedEvent, LedgerEntry, type LockApprovedEvent, type LockDriftEvent, type McpConfigMigratedEvent, type McpEventLedgerEvent, type MetaReconciledEvent, type MetaReconciledOnStartupEvent, type MetaUpdatedEvent, ONBOARD_SLOT_NAMES, ONBOARD_SLOT_TOTAL, type OnboardSlot, type PanelFieldGroup, type PanelFieldMeta, type PendingAutoArchivedEvent, type ReapplyCompletedEvent, type RelevanceMigrationRunEvent, type ServeLockClearedEvent, StableId, type ValidateResult, agentsIdentitySourceSchema, agentsLayerSchema, agentsMetaNodeSchema, agentsMetaSchema, agentsTopologyTypeSchema, aiLedgerEntrySchema, allocateKnowledgeId, assistantTurnObservedEventSchema, auditModeSchema, bootstrapMarkerMigratedEventSchema, candidateFileEntrySchema, citePolicyActivatedEventSchema, claudeHookPathMigratedEventSchema, claudeSkillPathMigratedEventSchema, clientPathsSchema, codexSkillPathMigratedEventSchema, defaultAgentsMetaCounters, defaultLayerFilterSchema, deriveAgentsMetaIdentitySource, deriveAgentsMetaLayer, deriveAgentsMetaStableId, deriveAgentsMetaTopologyType, doctorRunEventSchema, driftDetectedEventSchema, editIntentCheckedEventSchema, eventLedgerEventSchema, eventLedgerTruncatedEventSchema, eventsRotatedEventSchema, fabricConfigSchema, fabricEventSchema, fabricLanguageSchema, forensicAssertionCoverageSchema, forensicAssertionSchema, forensicCodeSampleSchema, forensicEntryPointSchema, forensicEvidenceAnchorSchema, forensicFrameworkSchema, forensicReadmeSchema, forensicReportSchema, forensicSamplingBudgetSchema, forensicTopologySchema, getPanelFieldByKey, getPanelFields, humanLedgerEntrySchema, humanLockEntrySchema, humanLockFileSchema, initContextDomainGroupSchema, initContextFrameworkSchema, initContextInterviewTrailEntrySchema, initContextInvariantConfidenceSnapshotSchema, initContextInvariantSchema, initContextSchema, initContextSourceEvidenceSchema, initScanCompletedEventSchema, isKnowledgeStableId, knowledgeArchiveAttemptedEventSchema, knowledgeArchivedEventSchema, knowledgeConsumedEventSchema, knowledgeContextPlannedEventSchema, knowledgeDeferredEventSchema, knowledgeDemotedEventSchema, knowledgeDriftDetectedEventSchema, knowledgeEnrichedEventSchema, knowledgeLayerChangedEventSchema, knowledgeMetaAutoHealedEventSchema, knowledgePathDangledEventSchema, knowledgePromoteFailedEventSchema, knowledgePromoteStartedEventSchema, knowledgePromotedEventSchema, knowledgeProposedEventSchema, knowledgeRejectedEventSchema, knowledgeScopeDegradedEventSchema, knowledgeSectionsFetchedEventSchema, knowledgeSelectionEventSchema, knowledgeSlugRenamedEventSchema, knowledgeTestIndexSchema, knowledgeTestLinkSchema, knowledgeTestOrphanAnnotationSchema, ledgerAppendedEventSchema, ledgerEntrySchema, lockApprovedEventSchema, lockDriftEventSchema, mcpConfigMigratedEventSchema, mcpEventLedgerEventSchema, mcpPayloadLimitsSchema, metaReconciledEventSchema, metaReconciledOnStartupEventSchema, metaUpdatedEventSchema, onboardSlotSchema, pendingAutoArchivedEventSchema, reapplyCompletedEventSchema, relevanceMigrationRunEventSchema, ruleDescriptionIndexItemSchema, ruleDescriptionSchema, serveLockClearedEventSchema, withDerivedAgentsMetaNodeDefaults };
+type CiteTag = "planned" | "recalled" | "chained-from" | "dismissed" | "none";
+type CiteCommitmentOperatorKind = "edit" | "not_edit" | "require" | "forbid";
+interface CiteCommitmentOperator {
+    kind: CiteCommitmentOperatorKind;
+    target: string;
+}
+interface CiteCommitment {
+    operators: CiteCommitmentOperator[];
+    skip_reason: string | null;
+}
+interface ParseCiteLineResult {
+    cite_ids: string[];
+    cite_tags: CiteTag[];
+    cite_commitments: CiteCommitment[];
+}
+/**
+ * Parse one or more newline-separated `KB:` cite lines into structured
+ * arrays matching the assistant_turn_observed event-ledger fields.
+ *
+ * Tolerates whitespace, CR/LF line endings, blank lines, and non-KB
+ * interleaved prose. Index contract documented above.
+ */
+declare function parseCiteLine(raw: string): ParseCiteLineResult;
+
+export { AGENTS_META_IDENTITY_SOURCES, AGENTS_META_LAYERS, AGENTS_META_TOPOLOGY_TYPES, AgentsIdentitySource, AgentsLayer, AgentsMeta, type AgentsMetaCounters, AgentsMetaCountersSchema, AgentsMetaNode, AgentsTopologyType, type AssistantTurnObservedEvent, type BootstrapMarkerMigratedEvent, type CandidateFileEntry, type CandidateFileFamily, type CiteCommitment, type CiteCommitmentOperator, type CiteCommitmentOperatorKind, type CiteContractPolicyActivatedEvent, type CitePolicyActivatedEvent, type CiteTag, type ClaudeHookPathMigratedEvent, type ClaudeSkillPathMigratedEvent, type CodexSkillPathMigratedEvent, type DoctorRunEvent, type DriftDetectedEvent, type EditIntentCheckedEvent, type EventLedgerEvent, type EventLedgerEventInput, type EventLedgerEventType, type EventLedgerTruncatedEvent, type EventsRotatedEvent, type FabricConfigSchemaShape, type FabricEvent, type ForensicAssertion, type ForensicAssertionConfidence, type ForensicAssertionCoverage, type ForensicAssertionType, type ForensicCodeSample, type ForensicEntryPoint, type ForensicEvidenceAnchor, type ForensicFramework, type ForensicReadme, type ForensicReport, type ForensicSamplingBudget, type ForensicTopology, HumanLockEntry, type HumanLockFile, type InitContext, type InitContextDomainGroup, type InitContextFramework, type InitContextInterviewTrailEntry, type InitContextInvariant, type InitContextInvariantConfidenceSnapshot, type InitContextSourceEvidence, type InitScanCompletedEvent, KNOWLEDGE_TEST_INDEX_SCHEMA_VERSION, type KnowledgeArchiveAttemptedEvent, type KnowledgeArchivedEvent, type KnowledgeConsumedEvent, type KnowledgeContextPlannedEvent, type KnowledgeDeferredEvent, type KnowledgeDemotedEvent, type KnowledgeDriftDetectedEvent, type KnowledgeEnrichedEvent, type KnowledgeLayerChangedEvent, type KnowledgeMetaAutoHealedEvent, type KnowledgePathDangledEvent, type KnowledgePromoteFailedEvent, type KnowledgePromoteStartedEvent, type KnowledgePromotedEvent, type KnowledgeProposedEvent, type KnowledgeRejectedEvent, type KnowledgeScopeDegradedEvent, type KnowledgeSectionsFetchedEvent, type KnowledgeSelectionEvent, type KnowledgeSlugRenamedEvent, type KnowledgeTestIndex, type KnowledgeTestLink, type KnowledgeTestOrphanAnnotation, KnowledgeType, Layer, type LedgerAppendedEvent, LedgerEntry, type LockApprovedEvent, type LockDriftEvent, type McpConfigMigratedEvent, type McpEventLedgerEvent, type MetaReconciledEvent, type MetaReconciledOnStartupEvent, type MetaUpdatedEvent, ONBOARD_SLOT_NAMES, ONBOARD_SLOT_TOTAL, type OnboardSlot, type PanelFieldGroup, type PanelFieldMeta, type ParseCiteLineResult, type PendingAutoArchivedEvent, type ReapplyCompletedEvent, type RelevanceMigrationRunEvent, type ServeLockClearedEvent, type SessionArchiveAttemptedEvent, StableId, type ValidateResult, agentsIdentitySourceSchema, agentsLayerSchema, agentsMetaNodeSchema, agentsMetaSchema, agentsTopologyTypeSchema, aiLedgerEntrySchema, allocateKnowledgeId, assistantTurnObservedEventSchema, auditModeSchema, bootstrapMarkerMigratedEventSchema, candidateFileEntrySchema, citeContractPolicyActivatedEventSchema, citePolicyActivatedEventSchema, claudeHookPathMigratedEventSchema, claudeSkillPathMigratedEventSchema, clientPathsSchema, codexSkillPathMigratedEventSchema, defaultAgentsMetaCounters, defaultLayerFilterSchema, deriveAgentsMetaIdentitySource, deriveAgentsMetaLayer, deriveAgentsMetaStableId, deriveAgentsMetaTopologyType, doctorRunEventSchema, driftDetectedEventSchema, editIntentCheckedEventSchema, eventLedgerEventSchema, eventLedgerTruncatedEventSchema, eventsRotatedEventSchema, fabricConfigSchema, fabricEventSchema, fabricLanguageSchema, forensicAssertionCoverageSchema, forensicAssertionSchema, forensicCodeSampleSchema, forensicEntryPointSchema, forensicEvidenceAnchorSchema, forensicFrameworkSchema, forensicReadmeSchema, forensicReportSchema, forensicSamplingBudgetSchema, forensicTopologySchema, getPanelFieldByKey, getPanelFields, humanLedgerEntrySchema, humanLockEntrySchema, humanLockFileSchema, initContextDomainGroupSchema, initContextFrameworkSchema, initContextInterviewTrailEntrySchema, initContextInvariantConfidenceSnapshotSchema, initContextInvariantSchema, initContextSchema, initContextSourceEvidenceSchema, initScanCompletedEventSchema, isKnowledgeStableId, knowledgeArchiveAttemptedEventSchema, knowledgeArchivedEventSchema, knowledgeConsumedEventSchema, knowledgeContextPlannedEventSchema, knowledgeDeferredEventSchema, knowledgeDemotedEventSchema, knowledgeDriftDetectedEventSchema, knowledgeEnrichedEventSchema, knowledgeLayerChangedEventSchema, knowledgeMetaAutoHealedEventSchema, knowledgePathDangledEventSchema, knowledgePromoteFailedEventSchema, knowledgePromoteStartedEventSchema, knowledgePromotedEventSchema, knowledgeProposedEventSchema, knowledgeRejectedEventSchema, knowledgeScopeDegradedEventSchema, knowledgeSectionsFetchedEventSchema, knowledgeSelectionEventSchema, knowledgeSlugRenamedEventSchema, knowledgeTestIndexSchema, knowledgeTestLinkSchema, knowledgeTestOrphanAnnotationSchema, ledgerAppendedEventSchema, ledgerEntrySchema, lockApprovedEventSchema, lockDriftEventSchema, mcpConfigMigratedEventSchema, mcpEventLedgerEventSchema, mcpPayloadLimitsSchema, metaReconciledEventSchema, metaReconciledOnStartupEventSchema, metaUpdatedEventSchema, onboardSlotSchema, parseCiteLine, pendingAutoArchivedEventSchema, reapplyCompletedEventSchema, relevanceMigrationRunEventSchema, ruleDescriptionIndexItemSchema, ruleDescriptionSchema, serveLockClearedEventSchema, sessionArchiveAttemptedEventSchema, withDerivedAgentsMetaNodeDefaults };

package/dist/index.js

@@ -1,4 +1,12 @@
-import "./chunk-LXNCAKJZ.js";
+import {
+  BOOTSTRAP_CANONICAL,
+  BOOTSTRAP_MARKER_BEGIN,
+  BOOTSTRAP_MARKER_END,
+  BOOTSTRAP_REGEX,
+  LEGACY_KB_MARKER_BEGIN,
+  LEGACY_KB_MARKER_END,
+  LEGACY_KB_REGEX
+} from "./chunk-4OQXR6JW.js";
 import {
   PROTECTED_TOKENS,
   createTranslator,
@@ -7,7 +15,7 @@ import {
   enMessages,
   normalizeLocale,
   zhCNMessages
-} from "./chunk-GYIALPMW.js";
+} from "./chunk-AFUQKKGR.js";
 import {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,
@@ -27,6 +35,9 @@ import {
   ProposedReasonSchema,
   StableIdSchema,
   annotateIntentRequestSchema,
+  citeContractMetricsSchema,
+  citeCoverageReportSchema,
+  citeLayerTypeBreakdownSchema,
   fabExtractKnowledgeAnnotations,
   fabReviewAnnotations,
   formatKnowledgeId,
@@ -46,16 +57,8 @@ import {
   planContextInputSchema,
   planContextOutputSchema,
   structuredWarningSchema
-} from "./chunk-GDYPVGWT.js";
-import {
-  BOOTSTRAP_CANONICAL,
-  BOOTSTRAP_MARKER_BEGIN,
-  BOOTSTRAP_MARKER_END,
-  BOOTSTRAP_REGEX,
-  LEGACY_KB_MARKER_BEGIN,
-  LEGACY_KB_MARKER_END,
-  LEGACY_KB_REGEX
-} from "./chunk-IP6VWOVE.js";
+} from "./chunk-3RSYWMQU.js";
+import "./chunk-LXNCAKJZ.js";
 
 // src/schemas/agents-meta.ts
 import { z } from "zod";
@@ -1076,6 +1079,24 @@ var assistantTurnObservedEventSchema = z10.object({
   kb_line_raw: z10.string().nullable(),
   cite_ids: z10.array(z10.string()).default([]),
   cite_tags: z10.array(z10.enum(["planned", "recalled", "chained-from", "dismissed", "none"])).default([]),
+  // v2.0.0-rc.24 TASK-01: per-cite contract commitments. Index-aligned with
+  // cite_ids/cite_tags (commitments[i] belongs to cite_ids[i]). Each slot
+  // carries `operators[]` (kind + glob target) or `skip_reason` when the cite
+  // cannot be operator-ized. Old rc.20-rc.23 events naturally parse with an
+  // empty array via `.default([])` and are excluded from contract-policy
+  // audits by the marker-gate (see cite_contract_policy_activated below).
+  // Mirrors the rc.20 cite_tags parallel-array evolution exactly.
+  cite_commitments: z10.array(
+    z10.object({
+      operators: z10.array(
+        z10.object({
+          kind: z10.enum(["edit", "not_edit", "require", "forbid"]),
+          target: z10.string()
+        })
+      ),
+      skip_reason: z10.string().nullable()
+    })
+  ).default([]),
   client: z10.enum(["cc", "codex", "cursor"]).optional(),
   turn_id: z10.string(),
   envelope_index: z10.number().int().nonnegative().optional(),
@@ -1087,6 +1108,10 @@ var citePolicyActivatedEventSchema = z10.object({
   policy_version: z10.string(),
   timestamp: z10.string().datetime()
 });
+var citeContractPolicyActivatedEventSchema = z10.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z10.literal("cite_contract_policy_activated")
+});
 var eventsRotatedEventSchema = z10.object({
   ...eventLedgerEnvelopeSchema,
   event_type: z10.literal("events_rotated"),
@@ -1118,6 +1143,14 @@ var knowledgeEnrichedEventSchema = z10.object({
   mode: z10.enum(["auto", "interactive"]),
   timestamp: z10.string().datetime()
 });
+var sessionArchiveAttemptedEventSchema = z10.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z10.literal("session_archive_attempted"),
+  outcome: z10.enum(["proposed", "viability_failed", "user_dismissed", "skipped_no_signal"]),
+  covered_through_ts: z10.number().int().nonnegative(),
+  candidates_proposed: z10.number().int().nonnegative().default(0),
+  knowledge_proposed_ids: z10.array(z10.string()).default([])
+});
 var eventLedgerEventSchema = z10.discriminatedUnion("event_type", [
   knowledgeContextPlannedEventSchema,
   knowledgeSelectionEventSchema,
@@ -1170,6 +1203,10 @@ var eventLedgerEventSchema = z10.discriminatedUnion("event_type", [
   // v2.0.0-rc.20 TASK-02: cite_policy_activated — session/policy-bump
   // marker recording when a given policy_version became active.
   citePolicyActivatedEventSchema,
+  // v2.0.0-rc.24 TASK-01: cite_contract_policy_activated — drift-gated
+  // idempotent marker opening the contract-policy audit window. Distinct
+  // from cite_policy_activated so contract metrics get their own window.
+  citeContractPolicyActivatedEventSchema,
   // v2.0.0-rc.22 Scope D T-D1: knowledge_meta_auto_healed — emitted by
   // loadActiveMeta when read-path drift triggers an in-place meta rebuild.
   knowledgeMetaAutoHealedEventSchema,
@@ -1185,8 +1222,91 @@ var eventLedgerEventSchema = z10.discriminatedUnion("event_type", [
   // `fab doctor --enrich-descriptions` once per modified canonical knowledge
   // file when one or more of the four rc.23 description-grade frontmatter
   // fields is back-filled.
-  knowledgeEnrichedEventSchema
+  knowledgeEnrichedEventSchema,
+  // v2.0.0-rc.25 TASK-01: session_archive_attempted — emitted by the
+  // fabric-archive skill at the end of every invocation. Drives Phase 0.0
+  // cross-session digest, outcome-based rescan filter (skips user_dismissed),
+  // covered_through_ts watermark, and `fab doctor --archive-history`.
+  sessionArchiveAttemptedEventSchema
+]);
+
+// src/cite-line-parser.ts
+var ID_RE = /^K[TP]-[A-Z]+-\d+$/;
+var SENTINEL_RE = /^KB:\s*none\b\s*(?:\[[^\]]*\])?\s*$/i;
+var FULL_RE = /^KB:\s+(K[TP]-[A-Z]+-\d+)(?:\s+\(([^)]*)\))?(?:\s+\[([^\]]+)\])?(?:\s+→\s*(.+))?\s*$/;
+var ALLOWED_TAGS = /* @__PURE__ */ new Set([
+  "planned",
+  "recalled",
+  "chained-from",
+  "dismissed",
+  "none"
 ]);
+function parseTag(rawTag) {
+  if (!rawTag) return "none";
+  const head = rawTag.trim().split(/[\s:]+/)[0].toLowerCase();
+  return ALLOWED_TAGS.has(head) ? head : "none";
+}
+function parseContractTail(tail) {
+  const result = { operators: [], skip_reason: null };
+  if (!tail) return result;
+  const tokens = tail.trim().split(/\s+/).filter((t) => t.length > 0);
+  for (const token of tokens) {
+    const skipMatch = token.match(/^skip:(.+)$/i);
+    if (skipMatch) {
+      if (result.skip_reason === null) result.skip_reason = skipMatch[1];
+      continue;
+    }
+    const notEditMatch = token.match(/^!edit:(.+)$/i);
+    if (notEditMatch) {
+      result.operators.push({ kind: "not_edit", target: notEditMatch[1] });
+      continue;
+    }
+    const opMatch = token.match(/^(edit|require|forbid):(.+)$/i);
+    if (opMatch) {
+      result.operators.push({
+        kind: opMatch[1].toLowerCase(),
+        target: opMatch[2]
+      });
+    }
+  }
+  return result;
+}
+function parseLine(line) {
+  const trimmed = line.trim();
+  if (trimmed.length === 0) return null;
+  if (SENTINEL_RE.test(trimmed)) {
+    return { id: null, tag: "none", commitment: null };
+  }
+  const fullMatch = trimmed.match(FULL_RE);
+  if (fullMatch) {
+    const id = fullMatch[1];
+    if (!ID_RE.test(id)) return null;
+    return {
+      id,
+      tag: parseTag(fullMatch[3]),
+      commitment: parseContractTail(fullMatch[4])
+    };
+  }
+  return null;
+}
+function parseCiteLine(raw) {
+  const result = {
+    cite_ids: [],
+    cite_tags: [],
+    cite_commitments: []
+  };
+  if (typeof raw !== "string") return result;
+  for (const line of raw.split(/\r?\n/)) {
+    const parsed = parseLine(line);
+    if (!parsed) continue;
+    result.cite_tags.push(parsed.tag);
+    if (parsed.id !== null) result.cite_ids.push(parsed.id);
+    if (parsed.commitment !== null) {
+      result.cite_commitments.push(parsed.commitment);
+    }
+  }
+  return result;
+}
 export {
   AGENTS_META_IDENTITY_SOURCES,
   AGENTS_META_LAYERS,
@@ -1230,6 +1350,10 @@ export {
   auditModeSchema,
   bootstrapMarkerMigratedEventSchema,
   candidateFileEntrySchema,
+  citeContractMetricsSchema,
+  citeContractPolicyActivatedEventSchema,
+  citeCoverageReportSchema,
+  citeLayerTypeBreakdownSchema,
   citePolicyActivatedEventSchema,
   claudeHookPathMigratedEventSchema,
   claudeSkillPathMigratedEventSchema,
@@ -1324,6 +1448,7 @@ export {
   metaUpdatedEventSchema,
   normalizeLocale,
   onboardSlotSchema,
+  parseCiteLine,
   parseKnowledgeId,
   pendingAutoArchivedEventSchema,
   planContextAnnotations,
@@ -1336,6 +1461,7 @@ export {
   ruleDescriptionIndexItemSchema,
   ruleDescriptionSchema,
   serveLockClearedEventSchema,
+  sessionArchiveAttemptedEventSchema,
   structuredWarningSchema,
   withDerivedAgentsMetaNodeDefaults,
   zhCNMessages

package/dist/schemas/api-contracts.d.ts

@@ -1630,6 +1630,208 @@ declare const fabReviewAnnotations: {
     readonly openWorldHint: false;
     readonly title: "Review pending knowledge entries";
 };
+declare const citeContractMetricsSchema: z.ZodObject<{
+    decisions_cited: z.ZodNumber;
+    pitfalls_cited: z.ZodNumber;
+    contract_with: z.ZodNumber;
+    contract_missing: z.ZodNumber;
+    hard_violated: z.ZodNumber;
+    cite_id_unresolved: z.ZodNumber;
+    skip_count: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    decisions_cited: number;
+    pitfalls_cited: number;
+    contract_with: number;
+    contract_missing: number;
+    hard_violated: number;
+    cite_id_unresolved: number;
+    skip_count: Record<string, number>;
+}, {
+    decisions_cited: number;
+    pitfalls_cited: number;
+    contract_with: number;
+    contract_missing: number;
+    hard_violated: number;
+    cite_id_unresolved: number;
+    skip_count: Record<string, number>;
+}>;
+type CiteContractMetrics = z.infer<typeof citeContractMetricsSchema>;
+declare const citeLayerTypeBreakdownSchema: z.ZodObject<{
+    team: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    personal: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    personal: Record<string, number>;
+    team: Record<string, number>;
+}, {
+    personal: Record<string, number>;
+    team: Record<string, number>;
+}>;
+type CiteLayerTypeBreakdown = z.infer<typeof citeLayerTypeBreakdownSchema>;
+declare const citeCoverageReportSchema: z.ZodObject<{
+    status: z.ZodEnum<["ok", "skipped"]>;
+    marker_ts: z.ZodNumber;
+    marker_emitted_now: z.ZodBoolean;
+    since_ts: z.ZodNumber;
+    client_filter: z.ZodEnum<["cc", "codex", "cursor", "all"]>;
+    layer_filter: z.ZodOptional<z.ZodEnum<["team", "personal", "all"]>>;
+    metrics: z.ZodObject<{
+        edits_touched: z.ZodNumber;
+        qualifying_cites: z.ZodNumber;
+        recalled_unverified: z.ZodNumber;
+        expected_but_missed: z.ZodNumber;
+        total_turns: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        edits_touched: number;
+        qualifying_cites: number;
+        recalled_unverified: number;
+        expected_but_missed: number;
+        total_turns: number;
+    }, {
+        edits_touched: number;
+        qualifying_cites: number;
+        recalled_unverified: number;
+        expected_but_missed: number;
+        total_turns: number;
+    }>;
+    per_client: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        edits_touched: z.ZodOptional<z.ZodNumber>;
+        qualifying_cites: z.ZodOptional<z.ZodNumber>;
+        recalled_unverified: z.ZodOptional<z.ZodNumber>;
+        expected_but_missed: z.ZodOptional<z.ZodNumber>;
+        total_turns: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        edits_touched?: number | undefined;
+        qualifying_cites?: number | undefined;
+        recalled_unverified?: number | undefined;
+        expected_but_missed?: number | undefined;
+        total_turns?: number | undefined;
+    }, {
+        edits_touched?: number | undefined;
+        qualifying_cites?: number | undefined;
+        recalled_unverified?: number | undefined;
+        expected_but_missed?: number | undefined;
+        total_turns?: number | undefined;
+    }>>>;
+    dismissed_reason_histogram: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    none_reason_histogram: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    contract_metrics_status: z.ZodOptional<z.ZodEnum<["ok", "skipped:bootstrap_drift", "awaiting_marker"]>>;
+    contract_metrics: z.ZodOptional<z.ZodObject<{
+        decisions_cited: z.ZodNumber;
+        pitfalls_cited: z.ZodNumber;
+        contract_with: z.ZodNumber;
+        contract_missing: z.ZodNumber;
+        hard_violated: z.ZodNumber;
+        cite_id_unresolved: z.ZodNumber;
+        skip_count: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        decisions_cited: number;
+        pitfalls_cited: number;
+        contract_with: number;
+        contract_missing: number;
+        hard_violated: number;
+        cite_id_unresolved: number;
+        skip_count: Record<string, number>;
+    }, {
+        decisions_cited: number;
+        pitfalls_cited: number;
+        contract_with: number;
+        contract_missing: number;
+        hard_violated: number;
+        cite_id_unresolved: number;
+        skip_count: Record<string, number>;
+    }>>;
+    per_layer_type: z.ZodOptional<z.ZodObject<{
+        team: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        personal: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        personal: Record<string, number>;
+        team: Record<string, number>;
+    }, {
+        personal: Record<string, number>;
+        team: Record<string, number>;
+    }>>;
+    contract_marker_ts: z.ZodOptional<z.ZodNumber>;
+    generated_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "ok" | "skipped";
+    marker_ts: number;
+    marker_emitted_now: boolean;
+    since_ts: number;
+    client_filter: "all" | "cc" | "codex" | "cursor";
+    metrics: {
+        edits_touched: number;
+        qualifying_cites: number;
+        recalled_unverified: number;
+        expected_but_missed: number;
+        total_turns: number;
+    };
+    generated_at: string;
+    layer_filter?: "personal" | "team" | "all" | undefined;
+    per_client?: Record<string, {
+        edits_touched?: number | undefined;
+        qualifying_cites?: number | undefined;
+        recalled_unverified?: number | undefined;
+        expected_but_missed?: number | undefined;
+        total_turns?: number | undefined;
+    }> | undefined;
+    dismissed_reason_histogram?: Record<string, number> | undefined;
+    none_reason_histogram?: Record<string, number> | undefined;
+    contract_metrics_status?: "ok" | "skipped:bootstrap_drift" | "awaiting_marker" | undefined;
+    contract_metrics?: {
+        decisions_cited: number;
+        pitfalls_cited: number;
+        contract_with: number;
+        contract_missing: number;
+        hard_violated: number;
+        cite_id_unresolved: number;
+        skip_count: Record<string, number>;
+    } | undefined;
+    per_layer_type?: {
+        personal: Record<string, number>;
+        team: Record<string, number>;
+    } | undefined;
+    contract_marker_ts?: number | undefined;
+}, {
+    status: "ok" | "skipped";
+    marker_ts: number;
+    marker_emitted_now: boolean;
+    since_ts: number;
+    client_filter: "all" | "cc" | "codex" | "cursor";
+    metrics: {
+        edits_touched: number;
+        qualifying_cites: number;
+        recalled_unverified: number;
+        expected_but_missed: number;
+        total_turns: number;
+    };
+    generated_at: string;
+    layer_filter?: "personal" | "team" | "all" | undefined;
+    per_client?: Record<string, {
+        edits_touched?: number | undefined;
+        qualifying_cites?: number | undefined;
+        recalled_unverified?: number | undefined;
+        expected_but_missed?: number | undefined;
+        total_turns?: number | undefined;
+    }> | undefined;
+    dismissed_reason_histogram?: Record<string, number> | undefined;
+    none_reason_histogram?: Record<string, number> | undefined;
+    contract_metrics_status?: "ok" | "skipped:bootstrap_drift" | "awaiting_marker" | undefined;
+    contract_metrics?: {
+        decisions_cited: number;
+        pitfalls_cited: number;
+        contract_with: number;
+        contract_missing: number;
+        hard_violated: number;
+        cite_id_unresolved: number;
+        skip_count: Record<string, number>;
+    } | undefined;
+    per_layer_type?: {
+        personal: Record<string, number>;
+        team: Record<string, number>;
+    } | undefined;
+    contract_marker_ts?: number | undefined;
+}>;
+type CiteCoverageReport = z.infer<typeof citeCoverageReportSchema>;
 declare const ledgerSourceSchema: z.ZodEnum<["ai", "human"]>;
 declare const ledgerQuerySchema: z.ZodObject<{
     source: z.ZodOptional<z.ZodEnum<["ai", "human"]>>;
@@ -1736,4 +1938,4 @@ declare function parseKnowledgeId(id: string): {
     counter: number;
 } | null;
 
-export { type FabExtractKnowledgeInput, FabExtractKnowledgeInputSchema, FabExtractKnowledgeInputShape, type FabExtractKnowledgeOutput, FabExtractKnowledgeOutputSchema, type FabReviewInput, FabReviewInputSchema, FabReviewInputShape, type FabReviewOutput, FabReviewOutputSchema, FabReviewOutputShape, KNOWLEDGE_TYPE_CODES, type KnowledgeEntryFrontmatter, KnowledgeEntryFrontmatterSchema, type KnowledgeType, type KnowledgeTypeCode, KnowledgeTypeSchema, type Layer, LayerSchema, type Maturity, MaturitySchema, PROPOSED_REASON_DESCRIPTIONS, type ProposedReason, ProposedReasonSchema, type StableId, StableIdSchema, annotateIntentRequestSchema, fabExtractKnowledgeAnnotations, fabReviewAnnotations, formatKnowledgeId, historyStateQuerySchema, humanLockApproveRequestSchema, humanLockFileParamsSchema, knowledgeSectionsAnnotations, knowledgeSectionsInputSchema, knowledgeSectionsOutputSchema, ledgerQuerySchema, ledgerSourceSchema, parseKnowledgeId, planContextAnnotations, planContextHintNarrowEntrySchema, planContextHintOutputSchema, planContextInputSchema, planContextOutputSchema, structuredWarningSchema };
+export { type CiteContractMetrics, type CiteCoverageReport, type CiteLayerTypeBreakdown, type FabExtractKnowledgeInput, FabExtractKnowledgeInputSchema, FabExtractKnowledgeInputShape, type FabExtractKnowledgeOutput, FabExtractKnowledgeOutputSchema, type FabReviewInput, FabReviewInputSchema, FabReviewInputShape, type FabReviewOutput, FabReviewOutputSchema, FabReviewOutputShape, KNOWLEDGE_TYPE_CODES, type KnowledgeEntryFrontmatter, KnowledgeEntryFrontmatterSchema, type KnowledgeType, type KnowledgeTypeCode, KnowledgeTypeSchema, type Layer, LayerSchema, type Maturity, MaturitySchema, PROPOSED_REASON_DESCRIPTIONS, type ProposedReason, ProposedReasonSchema, type StableId, StableIdSchema, annotateIntentRequestSchema, citeContractMetricsSchema, citeCoverageReportSchema, citeLayerTypeBreakdownSchema, fabExtractKnowledgeAnnotations, fabReviewAnnotations, formatKnowledgeId, historyStateQuerySchema, humanLockApproveRequestSchema, humanLockFileParamsSchema, knowledgeSectionsAnnotations, knowledgeSectionsInputSchema, knowledgeSectionsOutputSchema, ledgerQuerySchema, ledgerSourceSchema, parseKnowledgeId, planContextAnnotations, planContextHintNarrowEntrySchema, planContextHintOutputSchema, planContextInputSchema, planContextOutputSchema, structuredWarningSchema };

package/dist/schemas/api-contracts.js

@@ -15,6 +15,9 @@ import {
   ProposedReasonSchema,
   StableIdSchema,
   annotateIntentRequestSchema,
+  citeContractMetricsSchema,
+  citeCoverageReportSchema,
+  citeLayerTypeBreakdownSchema,
   fabExtractKnowledgeAnnotations,
   fabReviewAnnotations,
   formatKnowledgeId,
@@ -33,7 +36,7 @@ import {
   planContextInputSchema,
   planContextOutputSchema,
   structuredWarningSchema
-} from "../chunk-GDYPVGWT.js";
+} from "../chunk-3RSYWMQU.js";
 export {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,
@@ -51,6 +54,9 @@ export {
   ProposedReasonSchema,
   StableIdSchema,
   annotateIntentRequestSchema,
+  citeContractMetricsSchema,
+  citeCoverageReportSchema,
+  citeLayerTypeBreakdownSchema,
   fabExtractKnowledgeAnnotations,
   fabReviewAnnotations,
   formatKnowledgeId,

package/dist/templates/bootstrap-canonical.d.ts

@@ -49,8 +49,8 @@ declare const LEGACY_KB_REGEX: RegExp;
  * {@link BOOTSTRAP_MARKER_END} by `fab install` across all three supported
  * clients (Claude Code, Cursor, Codex CLI).
  *
- * Length guarantee: ≥ 400 bytes.
+ * Length guarantee: ≥ 800 bytes (rc.24: grew from ≥400 with cite-contract syntax).
  */
-declare const BOOTSTRAP_CANONICAL = "# Fabric Bootstrap\n\n\u672C\u9879\u76EE\u4F7F\u7528 Fabric \u7BA1\u7406\u8DE8\u5BA2\u6237\u7AEF AI \u77E5\u8BC6\u4E0E\u884C\u4E3A\u89C4\u5219\u3002\u672C\u6587\u4EF6\u7531 `fab install` \u540C\u6B65\u5230\u4E09\u7AEF managed block,**\u4E0D\u8981\u624B\u52A8\u7F16\u8F91\u4E09\u7AEF\u7684 block**,\u53EA\u6539\u8FD9\u91CC + \u91CD\u8DD1 `fab install`\u3002\n\n## \u884C\u4E3A\u89C4\u5219\n- **\u4FEE\u6539\u4EFB\u4F55\u6587\u4EF6\u524D**:\u4E24\u6B65\u8C03\u7528\u2014\u2014\u5148 `fab_plan_context(paths=[<\u88AB\u6539\u6587\u4EF6>])` \u62FF\u5230 `selection_token` \u4E0E\u5019\u9009 `entries`(\u6311 `selectable===true` \u7684 `stable_id`),\u518D `fab_get_knowledge_sections({ selection_token, ai_selected_stable_ids: [<id>...] })` \u53D6\u89C4\u5219\u6B63\u6587\u3002\n- **`.fabric/agents.meta.json` \u4E25\u7981\u624B\u52A8\u7F16\u8F91**;engine \u4F1A\u81EA\u52A8\u540C\u6B65\u6D3E\u751F\u72B6\u6001,\u663E\u5F0F reconcile \u8DD1 `fab doctor --fix`\u3002\n\n## \u77E5\u8BC6\u5E93(KB)\n- **Discovery**:SessionStart hook \u5217 broad-scoped \u6761\u76EE;edit \u6587\u4EF6\u65F6 PreToolUse hook \u53EF\u80FD\u89E6\u53D1 narrow hint\u3002\n- **Usage**:\u4E24\u6B65\u5F0F\u2014\u2014`fab_plan_context(paths=[...])` \u8FD4\u56DE `selection_token` + \u5019\u9009 entries,\u518D `fab_get_knowledge_sections({ selection_token, ai_selected_stable_ids: [<id>...] })` \u62C9\u5168\u6587;`selection_token` \u5FC5\u987B\u6765\u81EA\u6700\u8FD1\u4E00\u6B21 `fab_plan_context`,\u4E0D\u53EF\u51ED\u7A7A\u7F16\u9020\u3002\n- **Write flows**:`fabric-archive` / `fabric-review` / `fabric-import` \u4E09\u4E2A Skills\u3002\n- **Language**:\u6E32\u67D3\u6309 `.fabric/fabric-config.json` \u7684 `fabric_language` \u5B57\u6BB5\u3002\n\n## Cite policy\n\n- **\u89E6\u53D1**: \u505A edit / decide / propose plan \u4E4B\u524D,**\u56DE\u590D\u9996\u884C**\u5FC5\u987B\u5199 `KB: <id> (<\u22648\u5B57 \u7528\u6CD5>) [planned|recalled|chained-from <id>|dismissed:<reason>]` \u6216 `KB: none [<reason>]`\u3002\n- **`[recalled]` \u9A8C\u8BC1**: \u5FC5\u987B\u7D27\u8DDF\u4E24\u6B65\u8C03\u7528\u2014\u2014\u5148 `fab_plan_context(paths=[...])` \u62FF `selection_token`,\u518D `fab_get_knowledge_sections({ selection_token, ai_selected_stable_ids: [<id>] })`,\u9632\u6B62\u7F16\u9020 id\u3002\n- **\u7528\u6237\u53E3\u5934\u63D0\u89C4\u5219\u6CA1\u7ED9 id**: \u5148\u8C03 `fab_extract_knowledge` \u6216 `search_context` \u53CD\u67E5\u3002\n- **dismissed reason**: \u679A\u4E3E `scope-mismatch | outdated | not-applicable | other:<text>`\u3002\n- **`KB: none` sentinel**: \u679A\u4E3E\u4E24\u79CD\u5408\u89C4\u7406\u7531\u2014\u2014`[no-relevant]` \u5DF2\u8C03 `fab_plan_context`(\u6216 hook \u8F93\u51FA\u53EF\u89C1)\u4F46\u65E0\u53EF\u7528\u6761\u76EE;`[not-applicable]` \u5F53\u524D\u52A8\u4F5C\u4E0D\u5728 cite \u8303\u56F4(\u7EAF\u63A2\u7D22 / Bash \u53EA\u8BFB / \u7528\u6237\u95EE\u7B54)\u3002\u88F8 `KB: none`(\u65E0\u540E\u7F00)\u4ECD\u7136 valid,\u5F52\u7C7B\u4E3A `[unspecified]`(legacy \u517C\u5BB9,\u9F13\u52B1\u540E\u7EED\u8865\u6CE8)\u3002\n- **\u7A3D\u6838**: `fab doctor --cite-coverage [--since=7d] [--client=cc|codex|all]` \u8F93\u51FA cite \u8986\u76D6\u7387,\u542B `KB: none` sentinel \u62C6\u5206\u3002\u672C\u89C4\u5219\u4E0D\u963B\u65AD\u4F60\u5DE5\u4F5C,\u53EA\u8BB0\u5F55\u3002\n";
+declare const BOOTSTRAP_CANONICAL = "# Fabric Bootstrap\n\n\u672C\u9879\u76EE\u4F7F\u7528 Fabric \u7BA1\u7406\u8DE8\u5BA2\u6237\u7AEF AI \u77E5\u8BC6\u4E0E\u884C\u4E3A\u89C4\u5219\u3002\u672C\u6587\u4EF6\u7531 `fab install` \u540C\u6B65\u5230\u4E09\u7AEF managed block,**\u4E0D\u8981\u624B\u52A8\u7F16\u8F91\u4E09\u7AEF\u7684 block**,\u53EA\u6539\u8FD9\u91CC + \u91CD\u8DD1 `fab install`\u3002\n\n## \u884C\u4E3A\u89C4\u5219\n- **\u4FEE\u6539\u4EFB\u4F55\u6587\u4EF6\u524D**:\u4E24\u6B65\u8C03\u7528\u2014\u2014\u5148 `fab_plan_context(paths=[<\u88AB\u6539\u6587\u4EF6>])` \u62FF\u5230 `selection_token` \u4E0E\u5019\u9009 `entries`(\u6311 `selectable===true` \u7684 `stable_id`),\u518D `fab_get_knowledge_sections({ selection_token, ai_selected_stable_ids: [<id>...] })` \u53D6\u89C4\u5219\u6B63\u6587\u3002\n- **`.fabric/agents.meta.json` \u4E25\u7981\u624B\u52A8\u7F16\u8F91**;engine \u4F1A\u81EA\u52A8\u540C\u6B65\u6D3E\u751F\u72B6\u6001,\u663E\u5F0F reconcile \u8DD1 `fab doctor --fix`\u3002\n\n## \u77E5\u8BC6\u5E93(KB)\n- **Discovery**:SessionStart hook \u5217 broad-scoped \u6761\u76EE(\u542B personal layer `KP-*` \u6761\u76EE,\u5F15\u7528\u65B9\u5F0F\u76F8\u540C);edit \u6587\u4EF6\u65F6 PreToolUse hook \u53EF\u80FD\u89E6\u53D1 narrow hint\u3002\n- **Usage**:\u4E24\u6B65\u5F0F\u2014\u2014`fab_plan_context(paths=[...])` \u8FD4\u56DE `selection_token` + \u5019\u9009 entries,\u518D `fab_get_knowledge_sections({ selection_token, ai_selected_stable_ids: [<id>...] })` \u62C9\u5168\u6587;`selection_token` \u5FC5\u987B\u6765\u81EA\u6700\u8FD1\u4E00\u6B21 `fab_plan_context`,\u4E0D\u53EF\u51ED\u7A7A\u7F16\u9020\u3002\n- **session_id**: \u8C03\u7528 `fab_plan_context` \u65F6, \u52A1\u5FC5\u628A\u5F53\u524D client session id \u4F5C\u4E3A `session_id` \u53C2\u6570\u4F20\u5165(Claude Code \u7684 session id \u5728 stdin payload \u4E2D, Codex \u7684\u5BF9\u5E94 identifier \u540C\u7406)\u3002\u8FD9\u80FD\u8BA9 `fab doctor --archive-history` \u4E0E archive-hint hook \u51C6\u786E\u8BC6\u522B\u8DE8\u4F1A\u8BDD debt \u72B6\u6001\u3002\n- **Write flows**:`fabric-archive` / `fabric-review` / `fabric-import` \u4E09\u4E2A Skills\u3002\n- **Language**:\u6E32\u67D3\u6309 `.fabric/fabric-config.json` \u7684 `fabric_language` \u5B57\u6BB5\u3002\n\n## Self-archive policy\n\n- **\u89E6\u53D1**: \u672C\u4F1A\u8BDD\u51FA\u73B0\u4EE5\u4E0B\u4EFB\u4E00\u4FE1\u53F7, \u5728\u8BE5 turn \u56DE\u590D\u672B\u5C3E\u81EA\u4E3B\u8C03\u7528 `fabric-archive` skill (E3-strong mode):\n  1. **Normative \u8BED\u8A00** \u2014 \u7528\u6237\u6D88\u606F\u51FA\u73B0 `\u4EE5\u540E` / `always` / `never` / `from now on` / `\u4E0B\u6B21\u6CE8\u610F` / `\u8BB0\u4E00\u4E0B` / `\u6C38\u8FDC\u4E0D\u8981`\n  2. **Wrong-turn-and-revert** \u2014 AI \u5C1D\u8BD5 path X, \u53CD\u601D\u540E\u6539\u8D70 path Y (\u5C24\u5176\u5F53 path X \u662F\u975E\u663E\u7136\u8E29\u5751)\n  3. **Decision confirmation** \u2014 \u7528\u6237\u5728 \u22652 \u5019\u9009\u4E2D\u6743\u8861\u540E\u7ED9\u51FA rationale \u9501\u5B9A\u65B9\u5411\n  4. **Explicit dismissal with reason** \u2014 \u7528\u6237\u62D2\u4E86\u67D0\u5EFA\u8BAE**\u5E76**\u8BF4\u4E86\u539F\u56E0\n\n- **Anti-trigger** (\u660E\u786E\u4E0D\u89E6\u53D1):\n  - \u7528\u6237\u7EAF\u8BE2\u95EE (\u65E0 normative \u8868\u8FBE)\n  - \u7B80\u5355 refactor / typo fix\n  - AI \u81EA\u5DF1\u4EA7\u751F\u7684'\u6D1E\u5BDF' (\u5FC5\u987B\u7531\u7528\u6237\u6D88\u606F\u4E2D\u4FE1\u53F7\u89E6\u53D1)\n\n- **Anti-loop \u4E09\u6761\u9632\u62A4**:\n  - \u540C turn \u6700\u591A\u81EA\u8C03 1 \u6B21\n  - \u540C session \u540C outcome \u4E0D\u91CD\u590D (\u82E5 user_dismissed, \u672C\u4F1A\u8BDD\u4E0D\u518D\u81EA\u8C03\u76F8\u540C\u4E3B\u9898)\n  - Phase 0.5 viability gate \u515C\u5E95 (skill \u5185\u90E8\u4ECD\u8DD1 gate, AI \u5224\u9519\u4E0D\u4F1A\u4E71\u5199 pending)\n\n- **\u5448\u73B0\u6A21\u677F** (turn \u672B\u5C3E\u63D2\u5165, \u4E24\u884C: \u5148 marker \u884C\u4F9B Phase 0.4 \u68C0\u6D4B, \u518D user-facing \u63D0\u793A):\n  ```\n  self-archive policy triggered by signal: <Normative|Wrong-turn-and-revert|Decision confirmation|Explicit dismissal>\n  \u987A\u624B\u5F52\u6863: \u6CE8\u610F\u5230\u4F60\u8BF4 `<\u89E6\u53D1\u77ED\u8BED>`, \u5DF2\u8C03\u7528 fabric-archive \u6293 N \u6761\u5019\u9009 \u2192 .fabric/knowledge/pending/...\n  \u82E5\u4E0D\u8BE5\u8BB0, \u7B54 '\u64A4\u9500' \u6211\u4F1A\u8C03 fab_review reject\u3002\n  ```\n  \u7B2C\u4E00\u884C\u662F Phase 0.4 Trigger Gate \u7528\u6765\u8BC6\u522B E3 \u5165\u53E3\u7684 structured marker (verbatim \u5B57\u7B26\u4E32 `self-archive policy triggered by signal`, \u540E\u63A5\u5192\u53F7 + \u89E6\u53D1\u4FE1\u53F7\u540D)\u3002\u7B2C\u4E8C\u884C\u8D77\u662F\u7ED9\u7528\u6237\u770B\u7684\u4E2D\u6587\u63D0\u793A\u3002\u4E24\u884C\u90FD\u5FC5\u987B\u51FA\u73B0; \u7F3A marker \u884C Phase 0.4 \u65E0\u6CD5\u8DEF\u7531\u5230 E3_ai_self_trigger\u3002\n\n## Cite policy\n\n- **\u89E6\u53D1**: \u505A edit / decide / propose plan \u4E4B\u524D,**\u56DE\u590D\u9996\u884C**\u5FC5\u987B\u5199 `KB: <id> (<\u22648\u5B57 \u7528\u6CD5>) [planned|recalled|chained-from <id>|dismissed:<reason>]` \u6216 `KB: none [<reason>]`\u3002\n- **`[recalled]` \u9A8C\u8BC1**: \u5FC5\u987B\u7D27\u8DDF\u4E24\u6B65\u8C03\u7528\u2014\u2014\u5148 `fab_plan_context(paths=[...])` \u62FF `selection_token`,\u518D `fab_get_knowledge_sections({ selection_token, ai_selected_stable_ids: [<id>] })`,\u9632\u6B62\u7F16\u9020 id\u3002\n- **contract \u8BED\u6CD5**: decisions/pitfalls \u7C7B\u5F15\u7528\u5FC5\u987B\u5728\u5C3E\u6BB5\u52A0 contract: `\u2192 <operator> [<operator> ...]`,operator \u2208 {`edit:<glob>` `!edit:<glob>` `require:<symbol>` `forbid:<symbol>` `skip:<reason>`}\u3002\u4F8B:`KB: K-001 (auth) [planned] \u2192 edit:src/auth/**/*.ts !edit:src/legacy/**`\u3002\n- **skip reason \u8BCD\u5178**: `sequencing | conditional | semantic | aesthetic | architectural | other:<text>`\u3002\n- **type \u8DEF\u7531**: models \u7C7B\u5F15\u7528\u4E3A reference cite,\u4E0D\u9700\u8981 contract;guidelines/processes \u7C7B\u6682\u4E0D\u5F3A\u5236,\u63A8\u540E LLM-judge\u3002\n- **\u7528\u6237\u53E3\u5934\u63D0\u89C4\u5219\u6CA1\u7ED9 id**: \u5148\u8C03 `fab_extract_knowledge` \u6216 `search_context` \u53CD\u67E5\u3002\n- **dismissed reason**: \u679A\u4E3E `scope-mismatch | outdated | not-applicable | other:<text>`\u3002\n- **`KB: none` sentinel**: \u679A\u4E3E\u4E24\u79CD\u5408\u89C4\u7406\u7531\u2014\u2014`[no-relevant]` \u5DF2\u8C03 `fab_plan_context`(\u6216 hook \u8F93\u51FA\u53EF\u89C1)\u4F46\u65E0\u53EF\u7528\u6761\u76EE;`[not-applicable]` \u5F53\u524D\u52A8\u4F5C\u4E0D\u5728 cite \u8303\u56F4(\u7EAF\u63A2\u7D22 / Bash \u53EA\u8BFB / \u7528\u6237\u95EE\u7B54)\u3002\u88F8 `KB: none`(\u65E0\u540E\u7F00)\u4ECD\u7136 valid,\u5F52\u7C7B\u4E3A `[unspecified]`(legacy \u517C\u5BB9,\u9F13\u52B1\u540E\u7EED\u8865\u6CE8)\u3002\n- **\u7A3D\u6838**: `fab doctor --cite-coverage [--since=7d] [--client=cc|codex|all]` \u8F93\u51FA cite \u8986\u76D6\u7387,\u542B `KB: none` sentinel \u62C6\u5206\u3002\u672C\u89C4\u5219\u4E0D\u963B\u65AD\u4F60\u5DE5\u4F5C,\u53EA\u8BB0\u5F55\u3002\n";
 
 export { BOOTSTRAP_CANONICAL, BOOTSTRAP_MARKER_BEGIN, BOOTSTRAP_MARKER_END, BOOTSTRAP_REGEX, LEGACY_KB_MARKER_BEGIN, LEGACY_KB_MARKER_END, LEGACY_KB_REGEX };

package/dist/templates/bootstrap-canonical.js

@@ -6,7 +6,7 @@ import {
   LEGACY_KB_MARKER_BEGIN,
   LEGACY_KB_MARKER_END,
   LEGACY_KB_REGEX
-} from "../chunk-IP6VWOVE.js";
+} from "../chunk-4OQXR6JW.js";
 export {
   BOOTSTRAP_CANONICAL,
   BOOTSTRAP_MARKER_BEGIN,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-shared",
-  "version": "2.0.0-rc.23",
+  "version": "2.0.0-rc.25",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",