@fenglimg/fabric-shared 2.0.0-rc.33 → 2.0.0-rc.35

package/dist/{chunk-Y2YBFL2G.js → chunk-Z26SD627.js}

@@ -85,7 +85,7 @@ var planContextInputSchema = z2.object({
   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(
-    "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."
+    "Recommended: pass the current client session id (Claude Code: $session_id; Codex: corresponding identifier) \u2014 enables cross-session debt tracking in fabric 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
@@ -313,8 +313,8 @@ var _FabExtractKnowledgeInputBaseSchema = z2.object({
   ),
   // v2.0.0-rc.23 TASK-014 (F8c): optional onboard-slot tag. The S5 slot
   // mechanism reintroduces a Skill-orchestrated "project tone" capture
-  // surface after F8a deleted the auto-`fab scan` baseline pipeline.
-  // fabric-archive's first-run phase reads `fab onboard-coverage` to
+  // surface after F8a deleted the auto-`fabric scan` baseline pipeline.
+  // fabric-archive's first-run phase reads `fabric onboard-coverage` to
   // discover unclaimed slots, then propagates the chosen slot label here
   // so the resulting pending entry counts toward coverage.
   //

package/dist/i18n/index.d.ts

@@ -17,10 +17,10 @@ declare function detectNodeLocale(): Locale;
  *   1. Read `<projectRoot>/.fabric/fabric-config.json` and inspect
  *      `fabric_language`.
  *   2. If the value is `"en"` or `"zh-CN"` (the two concrete Locale members),
- *      return it verbatim — this is the eager-resolved value `fab init` is
+ *      return it verbatim — this is the eager-resolved value `fabric init` is
  *      supposed to write back per KT-DEC-9004.
  *   3. If the value is `"match-existing"` or `"zh-CN-hybrid"` (placeholders
- *      that should NEVER survive `fab init` per KT-DEC-9004's invariant),
+ *      that should NEVER survive `fabric init` per KT-DEC-9004's invariant),
  *      emit a `console.warn` and fall through to `detectNodeLocale()`.
  *   4. If the file is missing, unreadable, malformed JSON, or `fabric_language`
  *      is absent / has any other shape, silently fall through to

package/dist/i18n/index.js

@@ -7,7 +7,7 @@ import {
   normalizeLocale,
   resolveFabricLocale,
   zhCNMessages
-} from "../chunk-Z7UPW75I.js";
+} from "../chunk-S2OX6ZUS.js";
 export {
   PROTECTED_TOKENS,
   createTranslator,

package/dist/{index-Crx0-0-9.d.ts → index-BjssYQb3.d.ts}

@@ -176,6 +176,9 @@ declare const fabricConfigSchema: z.ZodObject<{
     archive_digest_max_sessions: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     review_topic_result_cap: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     review_stale_pending_days: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    reverse_unarchive_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    reverse_unarchive_dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    cite_evict_interval: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     fabric_event_retention_days: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<7>, z.ZodLiteral<30>, z.ZodLiteral<90>]>>;
     onboard_slots_opted_out: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
     hint_broad_top_k: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -210,6 +213,9 @@ declare const fabricConfigSchema: z.ZodObject<{
     archive_digest_max_sessions: number;
     review_topic_result_cap: number;
     review_stale_pending_days: number;
+    reverse_unarchive_enabled: boolean;
+    reverse_unarchive_dry_run: boolean;
+    cite_evict_interval: number;
     onboard_slots_opted_out: string[];
     hint_broad_top_k: number;
     hint_narrow_top_k: number;
@@ -268,6 +274,9 @@ declare const fabricConfigSchema: z.ZodObject<{
     archive_digest_max_sessions?: number | undefined;
     review_topic_result_cap?: number | undefined;
     review_stale_pending_days?: number | undefined;
+    reverse_unarchive_enabled?: boolean | undefined;
+    reverse_unarchive_dry_run?: boolean | undefined;
+    cite_evict_interval?: number | undefined;
     fabric_event_retention_days?: 7 | 30 | 90 | undefined;
     onboard_slots_opted_out?: string[] | undefined;
     hint_broad_top_k?: number | undefined;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AgentsMetaNode, a as AgentsIdentitySource, b as AgentsLayer, c as AgentsTopologyType, H as HumanLockEntry, f as fabricConfigSchema, d as AgentsMeta, L as LedgerEntry } from './index-Crx0-0-9.js';
-export { e as AgentsActivationTier, g as AgentsMetaCountersEnvelope, h as AgentsMetaKnowledgeTypeCounters, i as AgentsMetaNodeActivation, j as AiLedgerEntry, k as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, l as FabricLanguage, m as HumanLedgerEntry, M as McpPayloadLimits, R as RuleDescription, n as RuleDescriptionIndexItem, o as auditModeSchema, p as clientPathsSchema, q as defaultLayerFilterSchema, r as fabricLanguageSchema, s as mcpPayloadLimitsSchema, t as selectionTokenTtlMsSchema } from './index-Crx0-0-9.js';
+import { A as AgentsMetaNode, a as AgentsIdentitySource, b as AgentsLayer, c as AgentsTopologyType, H as HumanLockEntry, f as fabricConfigSchema, d as AgentsMeta, L as LedgerEntry } from './index-BjssYQb3.js';
+export { e as AgentsActivationTier, g as AgentsMetaCountersEnvelope, h as AgentsMetaKnowledgeTypeCounters, i as AgentsMetaNodeActivation, j as AiLedgerEntry, k as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, l as FabricLanguage, m as HumanLedgerEntry, M as McpPayloadLimits, R as RuleDescription, n as RuleDescriptionIndexItem, o as auditModeSchema, p as clientPathsSchema, q as defaultLayerFilterSchema, r as fabricLanguageSchema, s as mcpPayloadLimitsSchema, t as selectionTokenTtlMsSchema } from './index-BjssYQb3.js';
 export { Locale, Messages, PROTECTED_TOKENS, ProtectedToken, TranslationKey, Translator, createTranslator, defaultMessages, detectNodeLocale, enMessages, normalizeLocale, resolveFabricLocale, zhCNMessages } from './i18n/index.js';
 import { z } from 'zod';
 import { Layer, KnowledgeType, StableId } from './schemas/api-contracts.js';
@@ -1344,7 +1344,7 @@ interface PanelFieldMeta {
     format_for_display(value: unknown): string;
 }
 /**
- * Returns the per-field metadata array driving the `fab config` clack panel.
+ * Returns the per-field metadata array driving the `fabric config` clack panel.
  * Group A (2) + Group B (8) + Group C (1) = 11 entries.
  */
 declare function getPanelFields(): readonly PanelFieldMeta[];
@@ -4997,7 +4997,7 @@ declare const editIntentCheckedEventSchema: z.ZodObject<{
     compliant: z.ZodBoolean;
     intent: z.ZodString;
     ledger_entry_id: z.ZodString;
-    ledger_source: z.ZodOptional<z.ZodEnum<["ai", "human"]>>;
+    ledger_source: z.ZodOptional<z.ZodEnum<["ai", "human", "hook"]>>;
     commit_sha: z.ZodOptional<z.ZodString>;
     parent_sha: z.ZodOptional<z.ZodString>;
     parent_ledger_entry_id: z.ZodOptional<z.ZodString>;
@@ -5030,7 +5030,7 @@ declare const editIntentCheckedEventSchema: z.ZodObject<{
     parent_sha?: string | undefined;
     parent_ledger_entry_id?: string | undefined;
     diff_stat?: string | undefined;
-    ledger_source?: "ai" | "human" | undefined;
+    ledger_source?: "ai" | "human" | "hook" | undefined;
 }, {
     path: string;
     id: string;
@@ -5050,7 +5050,7 @@ declare const editIntentCheckedEventSchema: z.ZodObject<{
     parent_sha?: string | undefined;
     parent_ledger_entry_id?: string | undefined;
     diff_stat?: string | undefined;
-    ledger_source?: "ai" | "human" | undefined;
+    ledger_source?: "ai" | "human" | "hook" | undefined;
 }>;
 declare const knowledgeDriftDetectedEventSchema: z.ZodObject<{
     event_type: z.ZodLiteral<"knowledge_drift_detected">;
@@ -5843,6 +5843,46 @@ declare const knowledgeArchiveAttemptedEventSchema: z.ZodObject<{
     session_id?: string | undefined;
     reason?: string | undefined;
 }>;
+declare const knowledgeUnarchivedEventSchema: z.ZodObject<{
+    event_type: z.ZodLiteral<"knowledge_unarchived">;
+    stable_id: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    archive_path: z.ZodOptional<z.ZodString>;
+    restored_to: z.ZodOptional<z.ZodString>;
+    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: "knowledge_unarchived";
+    timestamp: string;
+    stable_id?: string | undefined;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+    reason?: string | undefined;
+    archive_path?: string | undefined;
+    restored_to?: string | undefined;
+}, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "knowledge_unarchived";
+    timestamp: string;
+    stable_id?: string | undefined;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+    reason?: string | undefined;
+    archive_path?: string | undefined;
+    restored_to?: string | undefined;
+}>;
 declare const knowledgeDeferredEventSchema: z.ZodObject<{
     event_type: z.ZodLiteral<"knowledge_deferred">;
     stable_id: z.ZodOptional<z.ZodString>;
@@ -6283,10 +6323,10 @@ declare const eventsRotatedEventSchema: z.ZodObject<{
     schema_version: 1;
     kind: "fabric-event";
     event_type: "events_rotated";
+    archive_path: string;
     cutoff_ts: string;
     archived_count: number;
     kept_count: number;
-    archive_path: string;
     correlation_id?: string | undefined;
     session_id?: string | undefined;
 }, {
@@ -6295,10 +6335,10 @@ declare const eventsRotatedEventSchema: z.ZodObject<{
     schema_version: 1;
     kind: "fabric-event";
     event_type: "events_rotated";
+    archive_path: string;
     cutoff_ts: string;
     archived_count: number;
     kept_count: number;
-    archive_path: string;
     correlation_id?: string | undefined;
     session_id?: string | undefined;
 }>;
@@ -6597,7 +6637,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     compliant: z.ZodBoolean;
     intent: z.ZodString;
     ledger_entry_id: z.ZodString;
-    ledger_source: z.ZodOptional<z.ZodEnum<["ai", "human"]>>;
+    ledger_source: z.ZodOptional<z.ZodEnum<["ai", "human", "hook"]>>;
     commit_sha: z.ZodOptional<z.ZodString>;
     parent_sha: z.ZodOptional<z.ZodString>;
     parent_ledger_entry_id: z.ZodOptional<z.ZodString>;
@@ -6630,7 +6670,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     parent_sha?: string | undefined;
     parent_ledger_entry_id?: string | undefined;
     diff_stat?: string | undefined;
-    ledger_source?: "ai" | "human" | undefined;
+    ledger_source?: "ai" | "human" | "hook" | undefined;
 }, {
     path: string;
     id: string;
@@ -6650,7 +6690,7 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     parent_sha?: string | undefined;
     parent_ledger_entry_id?: string | undefined;
     diff_stat?: string | undefined;
-    ledger_source?: "ai" | "human" | undefined;
+    ledger_source?: "ai" | "human" | "hook" | undefined;
 }>, z.ZodObject<{
     event_type: z.ZodLiteral<"knowledge_drift_detected">;
     revision: z.ZodOptional<z.ZodString>;
@@ -7420,6 +7460,45 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     correlation_id?: string | undefined;
     session_id?: string | undefined;
     reason?: string | undefined;
+}>, z.ZodObject<{
+    event_type: z.ZodLiteral<"knowledge_unarchived">;
+    stable_id: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    archive_path: z.ZodOptional<z.ZodString>;
+    restored_to: z.ZodOptional<z.ZodString>;
+    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: "knowledge_unarchived";
+    timestamp: string;
+    stable_id?: string | undefined;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+    reason?: string | undefined;
+    archive_path?: string | undefined;
+    restored_to?: string | undefined;
+}, {
+    id: string;
+    ts: number;
+    schema_version: 1;
+    kind: "fabric-event";
+    event_type: "knowledge_unarchived";
+    timestamp: string;
+    stable_id?: string | undefined;
+    correlation_id?: string | undefined;
+    session_id?: string | undefined;
+    reason?: string | undefined;
+    archive_path?: string | undefined;
+    restored_to?: string | undefined;
 }>, z.ZodObject<{
     event_type: z.ZodLiteral<"knowledge_deferred">;
     stable_id: z.ZodOptional<z.ZodString>;
@@ -7885,10 +7964,10 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     schema_version: 1;
     kind: "fabric-event";
     event_type: "events_rotated";
+    archive_path: string;
     cutoff_ts: string;
     archived_count: number;
     kept_count: number;
-    archive_path: string;
     correlation_id?: string | undefined;
     session_id?: string | undefined;
 }, {
@@ -7897,10 +7976,10 @@ declare const eventLedgerEventSchema: z.ZodDiscriminatedUnion<"event_type", [z.Z
     schema_version: 1;
     kind: "fabric-event";
     event_type: "events_rotated";
+    archive_path: string;
     cutoff_ts: string;
     archived_count: number;
     kept_count: number;
-    archive_path: string;
     correlation_id?: string | undefined;
     session_id?: string | undefined;
 }>, z.ZodObject<{
@@ -8035,6 +8114,7 @@ type KnowledgeSlugRenamedEvent = z.infer<typeof knowledgeSlugRenamedEventSchema>
 type KnowledgeDemotedEvent = z.infer<typeof knowledgeDemotedEventSchema>;
 type KnowledgeArchivedEvent = z.infer<typeof knowledgeArchivedEventSchema>;
 type KnowledgeArchiveAttemptedEvent = z.infer<typeof knowledgeArchiveAttemptedEventSchema>;
+type KnowledgeUnarchivedEvent = z.infer<typeof knowledgeUnarchivedEventSchema>;
 type KnowledgeDeferredEvent = z.infer<typeof knowledgeDeferredEventSchema>;
 type KnowledgeRejectedEvent = z.infer<typeof knowledgeRejectedEventSchema>;
 type KnowledgeConsumedEvent = z.infer<typeof knowledgeConsumedEventSchema>;
@@ -8051,7 +8131,7 @@ type EventsRotatedEvent = z.infer<typeof eventsRotatedEventSchema>;
 type ServeLockClearedEvent = z.infer<typeof serveLockClearedEventSchema>;
 type KnowledgeEnrichedEvent = z.infer<typeof knowledgeEnrichedEventSchema>;
 type SessionArchiveAttemptedEvent = z.infer<typeof sessionArchiveAttemptedEventSchema>;
-type EventLedgerEvent = KnowledgeContextPlannedEvent | KnowledgeSelectionEvent | KnowledgeSectionsFetchedEvent | EditIntentCheckedEvent | KnowledgeDriftDetectedEvent | McpEventLedgerEvent | ReapplyCompletedEvent | InstallDiffAppliedEvent | 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 EventLedgerEvent = KnowledgeContextPlannedEvent | KnowledgeSelectionEvent | KnowledgeSectionsFetchedEvent | EditIntentCheckedEvent | KnowledgeDriftDetectedEvent | McpEventLedgerEvent | ReapplyCompletedEvent | InstallDiffAppliedEvent | EventLedgerTruncatedEvent | McpConfigMigratedEvent | BootstrapMarkerMigratedEvent | MetaReconciledOnStartupEvent | MetaReconciledEvent | ClaudeSkillPathMigratedEvent | ClaudeHookPathMigratedEvent | CodexSkillPathMigratedEvent | InitScanCompletedEvent | KnowledgeProposedEvent | KnowledgePromoteStartedEvent | KnowledgePromotedEvent | KnowledgePromoteFailedEvent | KnowledgeLayerChangedEvent | KnowledgeSlugRenamedEvent | KnowledgeDemotedEvent | KnowledgeArchivedEvent | KnowledgeArchiveAttemptedEvent | KnowledgeUnarchivedEvent | 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>;
@@ -8086,4 +8166,4 @@ interface ParseCiteLineResult {
  */
 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, type InstallDiffAppliedEvent, 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, bootstrapMarkerMigratedEventSchema, candidateFileEntrySchema, citeContractPolicyActivatedEventSchema, citePolicyActivatedEventSchema, claudeHookPathMigratedEventSchema, claudeSkillPathMigratedEventSchema, codexSkillPathMigratedEventSchema, defaultAgentsMetaCounters, deriveAgentsMetaIdentitySource, deriveAgentsMetaLayer, deriveAgentsMetaStableId, deriveAgentsMetaTopologyType, doctorRunEventSchema, driftDetectedEventSchema, editIntentCheckedEventSchema, eventLedgerEventSchema, eventLedgerTruncatedEventSchema, eventsRotatedEventSchema, fabricConfigSchema, fabricEventSchema, forensicAssertionCoverageSchema, forensicAssertionSchema, forensicCodeSampleSchema, forensicEntryPointSchema, forensicEvidenceAnchorSchema, forensicFrameworkSchema, forensicReadmeSchema, forensicReportSchema, forensicSamplingBudgetSchema, forensicTopologySchema, getPanelFieldByKey, getPanelFields, humanLedgerEntrySchema, humanLockEntrySchema, humanLockFileSchema, initContextDomainGroupSchema, initContextFrameworkSchema, initContextInterviewTrailEntrySchema, initContextInvariantConfidenceSnapshotSchema, initContextInvariantSchema, initContextSchema, initContextSourceEvidenceSchema, initScanCompletedEventSchema, installDiffAppliedEventSchema, 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, metaReconciledEventSchema, metaReconciledOnStartupEventSchema, metaUpdatedEventSchema, onboardSlotSchema, parseCiteLine, pendingAutoArchivedEventSchema, reapplyCompletedEventSchema, relevanceMigrationRunEventSchema, ruleDescriptionIndexItemSchema, ruleDescriptionSchema, serveLockClearedEventSchema, sessionArchiveAttemptedEventSchema, withDerivedAgentsMetaNodeDefaults };
+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, type InstallDiffAppliedEvent, 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, type KnowledgeUnarchivedEvent, 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, bootstrapMarkerMigratedEventSchema, candidateFileEntrySchema, citeContractPolicyActivatedEventSchema, citePolicyActivatedEventSchema, claudeHookPathMigratedEventSchema, claudeSkillPathMigratedEventSchema, codexSkillPathMigratedEventSchema, defaultAgentsMetaCounters, deriveAgentsMetaIdentitySource, deriveAgentsMetaLayer, deriveAgentsMetaStableId, deriveAgentsMetaTopologyType, doctorRunEventSchema, driftDetectedEventSchema, editIntentCheckedEventSchema, eventLedgerEventSchema, eventLedgerTruncatedEventSchema, eventsRotatedEventSchema, fabricConfigSchema, fabricEventSchema, forensicAssertionCoverageSchema, forensicAssertionSchema, forensicCodeSampleSchema, forensicEntryPointSchema, forensicEvidenceAnchorSchema, forensicFrameworkSchema, forensicReadmeSchema, forensicReportSchema, forensicSamplingBudgetSchema, forensicTopologySchema, getPanelFieldByKey, getPanelFields, humanLedgerEntrySchema, humanLockEntrySchema, humanLockFileSchema, initContextDomainGroupSchema, initContextFrameworkSchema, initContextInterviewTrailEntrySchema, initContextInvariantConfidenceSnapshotSchema, initContextInvariantSchema, initContextSchema, initContextSourceEvidenceSchema, initScanCompletedEventSchema, installDiffAppliedEventSchema, isKnowledgeStableId, knowledgeArchiveAttemptedEventSchema, knowledgeArchivedEventSchema, knowledgeConsumedEventSchema, knowledgeContextPlannedEventSchema, knowledgeDeferredEventSchema, knowledgeDemotedEventSchema, knowledgeDriftDetectedEventSchema, knowledgeEnrichedEventSchema, knowledgeLayerChangedEventSchema, knowledgeMetaAutoHealedEventSchema, knowledgePathDangledEventSchema, knowledgePromoteFailedEventSchema, knowledgePromoteStartedEventSchema, knowledgePromotedEventSchema, knowledgeProposedEventSchema, knowledgeRejectedEventSchema, knowledgeScopeDegradedEventSchema, knowledgeSectionsFetchedEventSchema, knowledgeSelectionEventSchema, knowledgeSlugRenamedEventSchema, knowledgeTestIndexSchema, knowledgeTestLinkSchema, knowledgeTestOrphanAnnotationSchema, knowledgeUnarchivedEventSchema, ledgerAppendedEventSchema, ledgerEntrySchema, lockApprovedEventSchema, lockDriftEventSchema, mcpConfigMigratedEventSchema, mcpEventLedgerEventSchema, metaReconciledEventSchema, metaReconciledOnStartupEventSchema, metaUpdatedEventSchema, onboardSlotSchema, parseCiteLine, pendingAutoArchivedEventSchema, reapplyCompletedEventSchema, relevanceMigrationRunEventSchema, ruleDescriptionIndexItemSchema, ruleDescriptionSchema, serveLockClearedEventSchema, sessionArchiveAttemptedEventSchema, withDerivedAgentsMetaNodeDefaults };

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   LEGACY_KB_MARKER_BEGIN,
   LEGACY_KB_MARKER_END,
   LEGACY_KB_REGEX
-} from "./chunk-4OQXR6JW.js";
+} from "./chunk-COWUGYWC.js";
 import {
   PROTECTED_TOKENS,
   createTranslator,
@@ -16,7 +16,7 @@ import {
   normalizeLocale,
   resolveFabricLocale,
   zhCNMessages
-} from "./chunk-Z7UPW75I.js";
+} from "./chunk-S2OX6ZUS.js";
 import {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,
@@ -58,7 +58,7 @@ import {
   planContextInputSchema,
   planContextOutputSchema,
   structuredWarningSchema
-} from "./chunk-Y2YBFL2G.js";
+} from "./chunk-Z26SD627.js";
 import "./chunk-LXNCAKJZ.js";
 
 // src/schemas/agents-meta.ts
@@ -470,6 +470,25 @@ var fabricConfigSchema = z5.object({
   // 7d Signal-B trigger because review specifically targets the long
   // tail. Large repos with slower cadence can raise to 30.
   review_stale_pending_days: z5.number().int().positive().optional().default(14),
+  // v2.0.0-rc.34 TASK-05: reverse-unarchive opt-in. When true, callers of the
+  // `unarchiveKnowledge` primitive (and any future doctor auto-detect lint built
+  // on top) will execute the file move + ledger emit. When false (default),
+  // the same callers MUST short-circuit before any mutation — the primitive is
+  // shipped but inert until explicitly enabled. Opt-in posture mirrors the
+  // archive-flow precedent: destructive-ish file moves stay behind a flag.
+  reverse_unarchive_enabled: z5.boolean().optional().default(false),
+  // v2.0.0-rc.34 TASK-05: forces `unarchiveKnowledge` into dry-run mode even
+  // when called with `options.dryRun=false`. Lets operators preview a
+  // restoration pass before flipping `reverse_unarchive_enabled` to true.
+  reverse_unarchive_dry_run: z5.boolean().optional().default(false),
+  // v2.0.0-rc.34 TASK-06: long-session cite-policy evict window in user-prompt
+  // turns. UserPromptSubmit hook (Claude Code only) maintains a per-session
+  // counter and re-injects the cite contract reminder via
+  // hookSpecificOutput.additionalContext when `turn_count % interval === 0`.
+  // Default 0 = OFF (opt-in). Recommend 10-20 for active sessions; 5 for
+  // high-contract-criticality projects. Other strategies (time-based,
+  // token-budget) deferred to rc.35 per plan locked-decisions 2026-05-26.
+  cite_evict_interval: z5.number().int().min(0).optional().default(0),
   // v2.0.0-rc.22 Scope A T3: sliding-window retention (in days) for the
   // event ledger rotation primitive (`rotateEventLedgerIfNeeded`). Lines
   // whose `ts` is older than `now - fabric_event_retention_days * 86_400_000`
@@ -485,12 +504,12 @@ var fabricConfigSchema = z5.object({
   fabric_event_retention_days: z5.union([z5.literal(7), z5.literal(30), z5.literal(90)]).optional(),
   // v2.0.0-rc.23 TASK-014 (F8c): onboard slot opt-out list. Tracks slot
   // names the user explicitly dismissed during fabric-archive's first-run
-  // onboard phase (or via `fab config dismiss-slot <slot>`). Dismissed
-  // slots are excluded from `fab onboard-coverage`'s `missing` set and the
+  // onboard phase (or via `fabric config dismiss-slot <slot>`). Dismissed
+  // slots are excluded from `fabric onboard-coverage`'s `missing` set and the
   // doctor `Onboard coverage` advisory's recompute, so the user is never
   // re-prompted for slots they consciously declined.
   //
-  // Re-opening a dismissed slot requires `fab config onboard-reset <slot>`
+  // Re-opening a dismissed slot requires `fabric config onboard-reset <slot>`
   // — a deliberate two-command UX to keep the dismiss intent reversible
   // but never silently undone. Schema is intentionally `z.array(z.string())`
   // rather than `z.array(onboardSlotSchema)` so historical configs survive
@@ -937,7 +956,11 @@ var editIntentCheckedEventSchema = z10.object({
   compliant: z10.boolean(),
   intent: z10.string(),
   ledger_entry_id: z10.string(),
-  ledger_source: z10.enum(["ai", "human"]).optional(),
+  // rc.35 TASK-07 (P0-2): add "hook" — emitted by the PreToolUse narrow hook
+  // for every Edit/Write/MultiEdit fire so cite-coverage doctor metrics see
+  // actual edit signals (previously editsTouched was permanently 0 because
+  // no production caller of appendLedgerEntry existed).
+  ledger_source: z10.enum(["ai", "human", "hook"]).optional(),
   commit_sha: z10.string().optional(),
   parent_sha: z10.string().optional(),
   parent_ledger_entry_id: z10.string().optional(),
@@ -1137,6 +1160,17 @@ var knowledgeArchiveAttemptedEventSchema = z10.object({
   timestamp: z10.string().datetime(),
   reason: z10.string().optional()
 });
+var knowledgeUnarchivedEventSchema = z10.object({
+  ...eventLedgerEnvelopeSchema,
+  event_type: z10.literal("knowledge_unarchived"),
+  stable_id: z10.string().optional(),
+  timestamp: z10.string().datetime(),
+  reason: z10.string().optional(),
+  // Pre-move archive path (e.g. ".fabric/.archive/decisions/KT-D-0007--single-cjs-hook.md").
+  archive_path: z10.string().optional(),
+  // Post-move canonical path (e.g. ".fabric/knowledge/team/decisions/KT-D-0007--single-cjs-hook.md").
+  restored_to: z10.string().optional()
+});
 var knowledgeDeferredEventSchema = z10.object({
   ...eventLedgerEnvelopeSchema,
   event_type: z10.literal("knowledge_deferred"),
@@ -1286,7 +1320,7 @@ var eventLedgerEventSchema = z10.discriminatedUnion("event_type", [
   eventLedgerTruncatedEventSchema,
   mcpConfigMigratedEventSchema,
   // v2.0.0-rc.19 TASK-004: bootstrap_marker_migrated — one-time fabric:knowledge-base
-  // → fabric:bootstrap marker rewrite emitted per file by `fab doctor --fix`.
+  // → fabric:bootstrap marker rewrite emitted per file by `fabric doctor --fix`.
   bootstrapMarkerMigratedEventSchema,
   metaReconciledOnStartupEventSchema,
   metaReconciledEventSchema,
@@ -1304,6 +1338,8 @@ var eventLedgerEventSchema = z10.discriminatedUnion("event_type", [
   knowledgeDemotedEventSchema,
   knowledgeArchivedEventSchema,
   knowledgeArchiveAttemptedEventSchema,
+  // v2.0.0-rc.34 TASK-05: reverse of knowledge_archived
+  knowledgeUnarchivedEventSchema,
   knowledgeDeferredEventSchema,
   knowledgeRejectedEventSchema,
   // v2.0 rc.5 TASK-014: knowledge_consumed (consumption tracking)
@@ -1339,18 +1375,18 @@ var eventLedgerEventSchema = z10.discriminatedUnion("event_type", [
   // stale entries to events.archive/events-rotated-YYYY-MM-DD.jsonl.
   eventsRotatedEventSchema,
   // v2.0.0-rc.23 TASK-010 (e): serve_lock_cleared — emitted by
-  // `fab doctor --fix` when a stale `.fabric/.serve.lock` with a dead PID is
+  // `fabric doctor --fix` when a stale `.fabric/.serve.lock` with a dead PID is
   // unlinked.
   serveLockClearedEventSchema,
   // v2.0.0-rc.23 TASK-007 (a-C2): knowledge_enriched — emitted by
-  // `fab doctor --enrich-descriptions` once per modified canonical knowledge
+  // `fabric 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,
   // 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`.
+  // covered_through_ts watermark, and `fabric doctor --archive-history`.
   sessionArchiveAttemptedEventSchema
 ]);
 
@@ -1573,6 +1609,7 @@ export {
   knowledgeTestIndexSchema,
   knowledgeTestLinkSchema,
   knowledgeTestOrphanAnnotationSchema,
+  knowledgeUnarchivedEventSchema,
   ledgerAppendedEventSchema,
   ledgerEntrySchema,
   ledgerQuerySchema,

package/dist/schemas/api-contracts.js

@@ -36,7 +36,7 @@ import {
   planContextInputSchema,
   planContextOutputSchema,
   structuredWarningSchema
-} from "../chunk-Y2YBFL2G.js";
+} from "../chunk-Z26SD627.js";
 export {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,

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

@@ -1,6 +1,6 @@
 /**
  * Canonical Fabric bootstrap content + marker constants — single source of truth
- * consumed by both `fab install` (writer) and the server-side doctor (drift
+ * consumed by both `fabric install` (writer) and the server-side doctor (drift
  * comparator). Mirrors the rc.18 banner-i18n shared-module pattern: shared
  * constants in `packages/shared` so the cross-package boundary stays clean
  * (server has zero dep on cli).
@@ -46,11 +46,11 @@ declare const LEGACY_KB_REGEX: RegExp;
 /**
  * Canonical bootstrap body — byte-locked per rc.19 locked clarification 3.
  * Rendered into the managed block between {@link BOOTSTRAP_MARKER_BEGIN} and
- * {@link BOOTSTRAP_MARKER_END} by `fab install` across all three supported
+ * {@link BOOTSTRAP_MARKER_END} by `fabric install` across all three supported
  * clients (Claude Code, Cursor, Codex CLI).
  *
  * 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(\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";
+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 `fabric install` \u540C\u6B65\u5230\u4E09\u7AEF managed block,**\u4E0D\u8981\u624B\u52A8\u7F16\u8F91\u4E09\u7AEF\u7684 block**,\u53EA\u6539\u8FD9\u91CC + \u91CD\u8DD1 `fabric install`\u3002\n\n## For Developers\n\n\u8FD9\u4E2A\u6587\u4EF6\u662F **AI \u5BA2\u6237\u7AEF\u7684\u7B56\u7565\u4E0E\u89C4\u7EA6\u914D\u7F6E**,\u4E0D\u662F dev onboarding\u3002\u4F60\u4E0D\u9700\u8981\u8BFB Self-archive / Cite / Phase 0.4 \u7B49\u7EC6\u8282\u3002\n\u4F5C\u4E3A dev \u4F60\u53EA\u9700\u8981:\u5728\u6BCF\u4E2A repo \u8DD1\u4E00\u6B21 `fabric install`,\u51FA\u95EE\u9898\u8DD1 `fabric doctor`,\u5728 `.fabric/knowledge/<type>/` \u4E0B\u5199 markdown\u3002\n\u5B8C\u6574 5 \u5206\u949F\u7248 quickstart \u89C1 `docs/USER-QUICKSTART.md`\u3002**\u4E25\u7981\u624B\u52A8\u7F16\u8F91 `.fabric/agents.meta.json`** \u2014 \u6D3E\u751F\u72B6\u6001\u7531 engine \u91CD\u5EFA\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 `fabric 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 `fabric 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**: `fabric 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-4OQXR6JW.js";
+} from "../chunk-COWUGYWC.js";
 export {
   BOOTSTRAP_CANONICAL,
   BOOTSTRAP_MARKER_BEGIN,

package/dist/types/index.d.ts

@@ -1,2 +1,2 @@
-export { e as AgentsActivationTier, a as AgentsIdentitySource, b as AgentsLayer, d as AgentsMeta, g as AgentsMetaCountersEnvelope, h as AgentsMetaKnowledgeTypeCounters, A as AgentsMetaNode, i as AgentsMetaNodeActivation, c as AgentsTopologyType, j as AiLedgerEntry, k as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, l as FabricLanguage, m as HumanLedgerEntry, H as HumanLockEntry, L as LedgerEntry, M as McpPayloadLimits, R as RuleDescription, n as RuleDescriptionIndexItem } from '../index-Crx0-0-9.js';
+export { e as AgentsActivationTier, a as AgentsIdentitySource, b as AgentsLayer, d as AgentsMeta, g as AgentsMetaCountersEnvelope, h as AgentsMetaKnowledgeTypeCounters, A as AgentsMetaNode, i as AgentsMetaNodeActivation, c as AgentsTopologyType, j as AiLedgerEntry, k as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, l as FabricLanguage, m as HumanLedgerEntry, H as HumanLockEntry, L as LedgerEntry, M as McpPayloadLimits, R as RuleDescription, n as RuleDescriptionIndexItem } from '../index-BjssYQb3.js';
 import 'zod';

package/package.json

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