@fenglimg/fabric-server 1.8.0-rc.3 → 2.0.0-rc.1

package/dist/{http-PXFWUKCA.js → http-CHCOF6DJ.js}

@@ -1,5 +1,4 @@
 import {
-  AGENTS_MD_RESOURCE_URI,
   EVENT_LEDGER_PATH,
   LEDGER_PATH,
   LEGACY_LEDGER_PATH,
@@ -15,7 +14,7 @@ import {
   readEventLedger,
   runDoctorReport,
   sha256
-} from "./chunk-ZZGARZL5.js";
+} from "./chunk-NRWDWAVO.js";
 
 // src/http.ts
 import { randomUUID as randomUUID2 } from "crypto";
@@ -967,7 +966,7 @@ async function createScanReport(targetInput = process.cwd()) {
   const framework = detectFramework(target);
   const readmeQuality = getReadmeQuality(target);
   const hasContributing = existsSync(join2(target, "CONTRIBUTING.md"));
-  const hasExistingFabric = existsSync(join2(target, ".fabric", "bootstrap", "README.md")) || existsSync(join2(target, ".fabric"));
+  const hasExistingFabric = existsSync(join2(target, ".fabric"));
   const walkResult = walkFiles(target, DEFAULT_IGNORES);
   return {
     target,
@@ -1044,13 +1043,13 @@ function toPosixPath(path) {
 function buildRecommendations(input) {
   const recommendations = [];
   if (!input.hasExistingFabric) {
-    recommendations.push("L0: Run fab init to scaffold .fabric/bootstrap/README.md with TODO markers.");
+    recommendations.push("L0: Run `fab init` to scaffold the .fabric/ knowledge layout (decisions, pitfalls, guidelines, models, processes).");
   }
   if (input.readmeQuality === "stub") {
-    recommendations.push("L0: Expand README.md before promoting project facts into Fabric references.");
+    recommendations.push("L0: Expand README.md before promoting project facts into Fabric knowledge entries.");
   }
   if (!input.hasContributing) {
-    recommendations.push("L0: Add CONTRIBUTING.md or leave a bootstrap TODO reference for contribution flow.");
+    recommendations.push("L0: Add CONTRIBUTING.md or capture contribution-flow guidance under .fabric/knowledge/processes/.");
   }
   if (input.framework.kind === "unknown") {
     recommendations.push("L1: Add tech-stack TODOs manually because no framework marker was detected.");
@@ -1221,17 +1220,7 @@ function handleCacheWatcherEvent(relativePath, projectRoot, sessions, timers) {
     );
     return;
   }
-  if (normalized === ".fabric/bootstrap/README.md") {
-    contextCache.invalidate("file_watch", projectRoot);
-    clearTimeout(timers.getAgentsMdTimer());
-    timers.setAgentsMdTimer(
-      setTimeout(() => {
-        notifyAllSessions(sessions, "resource_updated", AGENTS_MD_RESOURCE_URI);
-      }, NOTIFY_DEBOUNCE_MS)
-    );
-    return;
-  }
-  if (normalized.startsWith(".fabric/rules/") && normalized.endsWith(".md")) {
+  if (normalized.startsWith(".fabric/knowledge/") && normalized.endsWith(".md")) {
     contextCache.invalidate("file_watch", projectRoot);
     invalidateRuleSyncCooldown(projectRoot);
   }
@@ -1245,8 +1234,8 @@ function createFabricHttpApp(options) {
   const cacheWatcher = chokidar2.watch(
     [
       ".fabric/agents.meta.json",
-      ".fabric/bootstrap/README.md",
-      ".fabric/rules/**/*.md"
+      ".fabric/knowledge/**/*.md",
+      ".fabric/knowledge/pending/**/*.md"
     ],
     {
       cwd: projectRoot,

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Server } from 'node:http';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { AgentsMeta, RuleTestIndex, AgentsLayer, AgentsTopologyType } from '@fenglimg/fabric-shared';
+import { AgentsMeta, RuleTestIndex, AgentsLayer, AgentsTopologyType, Layer, KnowledgeType, StableId, AgentsMetaCounters, EventLedgerEventInput, EventLedgerEvent } from '@fenglimg/fabric-shared';
 import { IOFabricError } from '@fenglimg/fabric-shared/errors';
 
 interface InFlightTracker {
@@ -98,11 +98,43 @@ declare function isSameRuleTestIndex(left: RuleTestIndex, right: RuleTestIndex):
 declare function stableStringify(value: unknown): string;
 
 /**
- * Shared constants used across the server package.
+ * v2.0 KnowledgeIdAllocator
+ *
+ * Wraps the pure `allocateKnowledgeId` allocator with persistence: it reads
+ * `agents.meta.json`, advances the counter for the requested (layer, type)
+ * pair, and writes the updated meta atomically (write-to-tmp + rename) so
+ * concurrent readers always see a consistent file.
+ *
+ * Counters are MONOTONIC across the lifetime of the meta file: deleting a
+ * knowledge entry does NOT free its counter slot, so previously-allocated
+ * stable_ids remain unique even after their files are removed.
+ *
+ * Key invariants:
+ *   - Counters envelope is initialized to zeros if absent (v1.x meta compat).
+ *   - Each allocate() call performs read → mutate → atomic-write in sequence.
+ *   - The returned id is guaranteed to differ from every previously-returned
+ *     id for the same meta path.
  */
-/** MCP resource URI for the project's bootstrap README (L0 rules) file. */
-declare const AGENTS_MD_RESOURCE_URI = "fabric://bootstrap-readme";
+declare class KnowledgeIdAllocator {
+    private readonly metaPath;
+    constructor(metaPath: string);
+    /**
+     * Allocate the next stable_id for the given (layer, type) pair and persist
+     * the advanced counter to `agents.meta.json`.
+     */
+    allocate(layer: Layer, type: KnowledgeType): Promise<StableId>;
+    /**
+     * Returns the current counters envelope, defaulting to all-zero slots when
+     * the meta file is absent or pre-v2.0 (counters key missing).
+     */
+    getCounters(): Promise<AgentsMetaCounters>;
+    private readMeta;
+    private normalizeCounters;
+    private writeMetaAtomic;
+}
 
+type StoredEventLedgerEvent = EventLedgerEvent;
+declare function appendEventLedgerEvent(projectRoot: string, event: EventLedgerEventInput): Promise<StoredEventLedgerEvent>;
 /**
  * Synchronously fsync the event ledger file to ensure OS page-cache buffers are
  * flushed to durable storage. Must be called AFTER in-flight drain but BEFORE
@@ -113,6 +145,12 @@ declare const AGENTS_MD_RESOURCE_URI = "fabric://bootstrap-readme";
  */
 declare function flushAndSyncEventLedger(projectRoot: string): void;
 
+/**
+ * Shared constants used across the server package.
+ */
+/** MCP resource URI for the project's bootstrap README (L0 rules) file. */
+declare const AGENTS_MD_RESOURCE_URI = "fabric://bootstrap-readme";
+
 /**
  * rule-sync.ts — Rule-sync orchestrator framework (R28, TASK-011)
  *
@@ -142,8 +180,8 @@ interface StructuredWarning {
 /**
  * Granular ledger event shape for rule-sync operations.
  * These are returned in RuleSyncReport and also appended to the event ledger
- * using the nearest available ledger event type (rule_drift_detected /
- * baseline_synced). The shape below is what callers receive in `.events`.
+ * using the nearest available ledger event type (knowledge_drift_detected).
+ * The shape below is what callers receive in `.events`.
  */
 interface RuleSyncLedgerEvent {
     type: "rule_content_changed" | "rule_added" | "rule_removed";
@@ -243,4 +281,4 @@ declare function startHttpServer(options: {
     dev?: boolean;
 }): Promise<Server>;
 
-export { AGENTS_MD_RESOURCE_URI, type AcquireOptions, type DoctorFixReport, type DoctorIssue, type DoctorReport, EVENT_LEDGER_PATH, type InFlightTracker, LEDGER_PATH, LEGACY_LEDGER_PATH, type LedgerEvent, type LockState, type ReconcileRulesOptions, type RuleMetaBuildResult, type RuleMetaBuildSource, type RuleSyncLedgerEvent, type RuleSyncOptions, type RuleSyncReport, ServeLockHeldError, type ShutdownHandlerDeps, type StructuredWarning, type WriteRuleMetaOptions, acquireLock, buildRuleMeta, checkLockOrThrow, computeRuleTestIndex, computeRulesBasedAgentsMeta, createFabricServer, createInFlightTracker, createShutdownHandler, deriveRuleMetaLayer, deriveRuleMetaTopologyType, ensureRulesFresh, flushAndSyncEventLedger, formatPreexistingRootMessage, getEventLedgerPath, getLedgerPath, getLegacyLedgerPath, isSameRuleTestIndex, readLockState, reconcileRules, releaseLock, runDoctorFix, runDoctorReport, stableStringify, startHttpServer, startStdioServer, writeRuleMeta };
+export { AGENTS_MD_RESOURCE_URI, type AcquireOptions, type DoctorFixReport, type DoctorIssue, type DoctorReport, EVENT_LEDGER_PATH, type InFlightTracker, KnowledgeIdAllocator, LEDGER_PATH, LEGACY_LEDGER_PATH, type LedgerEvent, type LockState, type ReconcileRulesOptions, type RuleMetaBuildResult, type RuleMetaBuildSource, type RuleSyncLedgerEvent, type RuleSyncOptions, type RuleSyncReport, ServeLockHeldError, type ShutdownHandlerDeps, type StructuredWarning, type WriteRuleMetaOptions, acquireLock, appendEventLedgerEvent, buildRuleMeta, checkLockOrThrow, computeRuleTestIndex, computeRulesBasedAgentsMeta, createFabricServer, createInFlightTracker, createShutdownHandler, deriveRuleMetaLayer, deriveRuleMetaTopologyType, ensureRulesFresh, flushAndSyncEventLedger, formatPreexistingRootMessage, getEventLedgerPath, getLedgerPath, getLegacyLedgerPath, isSameRuleTestIndex, readLockState, reconcileRules, releaseLock, runDoctorFix, runDoctorReport, stableStringify, startHttpServer, startStdioServer, writeRuleMeta };