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

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,
@@ -6,8 +14,9 @@ import {
   detectNodeLocale,
   enMessages,
   normalizeLocale,
+  resolveFabricLocale,
   zhCNMessages
-} from "./chunk-GYIALPMW.js";
+} from "./chunk-E5LHOWTN.js";
 import {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,
@@ -27,6 +36,9 @@ import {
   ProposedReasonSchema,
   StableIdSchema,
   annotateIntentRequestSchema,
+  citeContractMetricsSchema,
+  citeCoverageReportSchema,
+  citeLayerTypeBreakdownSchema,
   fabExtractKnowledgeAnnotations,
   fabReviewAnnotations,
   formatKnowledgeId,
@@ -46,16 +58,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 +1080,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 +1109,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 +1144,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 +1204,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 +1223,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 +1351,10 @@ export {
   auditModeSchema,
   bootstrapMarkerMigratedEventSchema,
   candidateFileEntrySchema,
+  citeContractMetricsSchema,
+  citeContractPolicyActivatedEventSchema,
+  citeCoverageReportSchema,
+  citeLayerTypeBreakdownSchema,
   citePolicyActivatedEventSchema,
   claudeHookPathMigratedEventSchema,
   claudeSkillPathMigratedEventSchema,
@@ -1324,6 +1449,7 @@ export {
   metaUpdatedEventSchema,
   normalizeLocale,
   onboardSlotSchema,
+  parseCiteLine,
   parseKnowledgeId,
   pendingAutoArchivedEventSchema,
   planContextAnnotations,
@@ -1333,9 +1459,11 @@ export {
   planContextOutputSchema,
   reapplyCompletedEventSchema,
   relevanceMigrationRunEventSchema,
+  resolveFabricLocale,
   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.26",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",