@ctxo/cli 0.7.1 → 0.8.0

package/dist/atomic-write-AQNYJFAG.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import {
+  atomicWrite,
+  sweepStaleTmpFiles
+} from "./chunk-6EKERTJ7.js";
+export {
+  atomicWrite,
+  sweepStaleTmpFiles
+};
+//# sourceMappingURL=atomic-write-AQNYJFAG.js.map

package/dist/{chunk-WXA2JJLH.js → chunk-2TVHKCCU.js}

@@ -132,8 +132,9 @@ var JsonIndexReader = class {
       if (entry.isSymbolicLink()) continue;
       const fullPath = join(dir, entry.name);
       if (entry.isDirectory()) {
+        if (entry.name === "communities.history") continue;
         files.push(...this.collectJsonFiles(fullPath, visited));
-      } else if (entry.name.endsWith(".json") && entry.name !== "co-changes.json") {
+      } else if (entry.name.endsWith(".json") && entry.name !== "co-changes.json" && entry.name !== "communities.json" && entry.name !== "drift-events.json" && entry.name !== "boundary-violations.json") {
         files.push(fullPath);
       }
     }
@@ -145,4 +146,4 @@ export {
   DetailLevelSchema,
   JsonIndexReader
 };
-//# sourceMappingURL=chunk-WXA2JJLH.js.map
+//# sourceMappingURL=chunk-2TVHKCCU.js.map

package/dist/chunk-2TVHKCCU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/storage/json-index-reader.ts","../src/core/types.ts"],"sourcesContent":["import { readFileSync, readdirSync, existsSync, realpathSync } from 'node:fs';\nimport { join, relative } from 'node:path';\nimport { FileIndexSchema, type FileIndex } from '../../core/types.js';\n\nexport class JsonIndexReader {\n  private readonly indexDir: string;\n\n  constructor(ctxoRoot: string) {\n    this.indexDir = join(ctxoRoot, 'index');\n  }\n\n  readAll(): FileIndex[] {\n    if (!existsSync(this.indexDir)) {\n      return [];\n    }\n\n    const jsonFiles = this.collectJsonFiles(this.indexDir);\n    const results: FileIndex[] = [];\n\n    for (const filePath of jsonFiles) {\n      const parsed = this.readSingle(filePath);\n      if (parsed) {\n        results.push(parsed);\n      }\n    }\n\n    return results;\n  }\n\n  readSingle(absolutePath: string): FileIndex | undefined {\n    try {\n      const raw = readFileSync(absolutePath, 'utf-8');\n      const data: unknown = JSON.parse(raw);\n      const result = FileIndexSchema.safeParse(data);\n\n      if (!result.success) {\n        const rel = relative(this.indexDir, absolutePath);\n        console.error(\n          `[ctxo:json-reader] Invalid schema in ${rel}: ${result.error.message}`,\n        );\n        return undefined;\n      }\n\n      return result.data;\n    } catch (err) {\n      const rel = relative(this.indexDir, absolutePath);\n      console.error(\n        `[ctxo:json-reader] Failed to read ${rel}: ${(err as Error).message}`,\n      );\n      return undefined;\n    }\n  }\n\n  private collectJsonFiles(dir: string, visited: Set<string> = new Set()): string[] {\n    const realDir = realpathSync(dir);\n    if (visited.has(realDir)) return []; // Guard against symlink loops\n    visited.add(realDir);\n\n    const files: string[] = [];\n\n    for (const entry of readdirSync(dir, { withFileTypes: true })) {\n      if (entry.isSymbolicLink()) continue; // Skip symlinks entirely\n\n      const fullPath = join(dir, entry.name);\n      if (entry.isDirectory()) {\n        // Skip non-FileIndex directories under .ctxo/index/\n        if (entry.name === 'communities.history') continue;\n        files.push(...this.collectJsonFiles(fullPath, visited));\n      } else if (\n        entry.name.endsWith('.json') &&\n        entry.name !== 'co-changes.json' &&\n        entry.name !== 'communities.json' &&\n        entry.name !== 'drift-events.json' &&\n        entry.name !== 'boundary-violations.json'\n      ) {\n        files.push(fullPath);\n      }\n    }\n\n    return files;\n  }\n}\n","import { z } from 'zod';\n\n// ── Symbol Kinds ────────────────────────────────────────────────\n\nexport const SYMBOL_KINDS = [\n  'function',\n  'class',\n  'interface',\n  'method',\n  'variable',\n  'type',\n] as const;\n\nexport const SymbolKindSchema = z.enum(SYMBOL_KINDS);\nexport type SymbolKind = z.infer<typeof SymbolKindSchema>;\n\n// ── Edge Kinds ──────────────────────────────────────────────────\n\nexport const EDGE_KINDS = [\n  'imports',\n  'calls',\n  'extends',\n  'implements',\n  'uses',\n] as const;\n\nexport const EdgeKindSchema = z.enum(EDGE_KINDS);\nexport type EdgeKind = z.infer<typeof EdgeKindSchema>;\n\n// ── Detail Levels ───────────────────────────────────────────────\n\nexport const DETAIL_LEVELS = [1, 2, 3, 4] as const;\n\nexport const DetailLevelSchema = z.union([\n  z.literal(1),\n  z.literal(2),\n  z.literal(3),\n  z.literal(4),\n]);\nexport type DetailLevel = z.infer<typeof DetailLevelSchema>;\n\n// ── Symbol ID ───────────────────────────────────────────────────\n\n/**\n * Format: \"<relativeFile>::<name>::<kind>\"\n * Example: \"src/foo.ts::myFn::function\"\n */\nexport const SymbolIdSchema = z\n  .string()\n  .min(1)\n  .refine(\n    (value) => {\n      const parts = value.split('::');\n      if (parts.length !== 3) return false;\n      const [file, name, kind] = parts;\n      if (!file || !name || !kind) return false;\n      return SymbolKindSchema.safeParse(kind).success;\n    },\n    { message: 'Symbol ID must match format \"<file>::<name>::<kind>\"' },\n  );\nexport type SymbolId = z.infer<typeof SymbolIdSchema>;\n\n// ── Symbol Node ─────────────────────────────────────────────────\n\nexport const SymbolNodeSchema = z\n  .object({\n    symbolId: SymbolIdSchema,\n    name: z.string().min(1),\n    kind: SymbolKindSchema,\n    startLine: z.number().int().nonnegative(),\n    endLine: z.number().int().nonnegative(),\n    startOffset: z.number().int().nonnegative().optional(),\n    endOffset: z.number().int().nonnegative().optional(),\n  })\n  .refine((node) => node.endLine >= node.startLine, {\n    message: 'endLine must be >= startLine',\n  });\nexport type SymbolNode = z.infer<typeof SymbolNodeSchema>;\n\n// ── Graph Edge ──────────────────────────────────────────────────\n\nexport const GraphEdgeSchema = z.object({\n  from: SymbolIdSchema,\n  to: SymbolIdSchema,\n  kind: EdgeKindSchema,\n  typeOnly: z.boolean().optional(),\n});\nexport type GraphEdge = z.infer<typeof GraphEdgeSchema>;\n\n// ── Commit Intent ───────────────────────────────────────────────\n\nexport const CommitIntentSchema = z.object({\n  hash: z.string().min(1),\n  message: z.string(),\n  date: z.string().min(1),\n  kind: z.literal('commit'),\n});\nexport type CommitIntent = z.infer<typeof CommitIntentSchema>;\n\n// ── Anti-Pattern ────────────────────────────────────────────────\n\nexport const AntiPatternSchema = z.object({\n  hash: z.string().min(1),\n  message: z.string(),\n  date: z.string().min(1),\n});\nexport type AntiPattern = z.infer<typeof AntiPatternSchema>;\n\n// ── File Index ──────────────────────────────────────────────────\n\nexport const ComplexityMetricsSchema = z.object({\n  symbolId: z.string().min(1),\n  cyclomatic: z.number().nonnegative(),\n});\n\nexport const FileIndexSchema = z.object({\n  file: z.string().min(1),\n  lastModified: z.number().nonnegative(),\n  contentHash: z.string().optional(),\n  symbols: z.array(SymbolNodeSchema),\n  edges: z.array(GraphEdgeSchema),\n  complexity: z.array(ComplexityMetricsSchema).optional(),\n  intent: z.array(CommitIntentSchema),\n  antiPatterns: z.array(AntiPatternSchema),\n});\nexport type FileIndex = z.infer<typeof FileIndexSchema>;\n\n// ── Logic-Slice Result ──────────────────────────────────────────\n\nexport interface LogicSliceResult {\n  readonly root: SymbolNode;\n  readonly dependencies: readonly SymbolNode[];\n  readonly edges: readonly GraphEdge[];\n}\n\n// ── Formatted Slice ─────────────────────────────────────────────\n\nexport interface TruncationInfo {\n  readonly truncated: true;\n  readonly reason: 'token_budget_exceeded';\n}\n\nexport interface FormattedSlice {\n  readonly root: SymbolNode;\n  readonly dependencies: readonly SymbolNode[];\n  readonly edges: readonly GraphEdge[];\n  readonly level: DetailLevel;\n  readonly levelDescription?: string;\n  readonly truncation?: TruncationInfo;\n}\n\n// ── Complexity & Churn ──────────────────────────────────────────\n\nexport interface ComplexityMetrics {\n  readonly symbolId: string;\n  readonly cyclomatic: number;\n}\n\nexport interface ChurnData {\n  readonly filePath: string;\n  readonly commitCount: number;\n}\n\nexport const SCORE_BANDS = ['low', 'medium', 'high'] as const;\nexport type ScoreBand = (typeof SCORE_BANDS)[number];\n\nexport interface ChangeIntelligenceScore {\n  readonly symbolId: string;\n  readonly complexity: number;\n  readonly churn: number;\n  readonly composite: number;\n  readonly band: ScoreBand;\n}\n\n// ── Why-Context Result ──────────────────────────────────────────\n\nexport interface WhyContextResult {\n  readonly commitHistory: readonly CommitIntent[];\n  readonly antiPatternWarnings: readonly AntiPattern[];\n  readonly changeIntelligence?: ChangeIntelligenceScore;\n}\n\n// ── Co-Change Analysis ─────────────────────────────────────────\n\nexport interface CoChangeEntry {\n  readonly file1: string;\n  readonly file2: string;\n  readonly sharedCommits: number;\n  readonly frequency: number;\n}\n\nexport interface CoChangeMatrix {\n  readonly version: 1;\n  readonly timestamp: number;\n  readonly entries: readonly CoChangeEntry[];\n}\n\n// ── Commit Record (from git adapter) ────────────────────────────\n\nexport interface CommitRecord {\n  readonly hash: string;\n  readonly message: string;\n  readonly date: string;\n  readonly author: string;\n}\n\n// ── Blame Line (from git adapter) ───────────────────────────────\n\nexport interface BlameLine {\n  readonly hash: string;\n  readonly lineNumber: number;\n  readonly author: string;\n  readonly date: string;\n}\n\n// ── Search Types ───────────────────────────────────────────────\n\nexport interface SearchResult {\n  symbolId: string;\n  name: string;\n  kind: string;\n  filePath: string;\n  /** BM25 relevance score (higher = more relevant) */\n  relevanceScore: number;\n  /** PageRank importance score (0-1) */\n  importanceScore: number;\n  /** Final combined score after all boosts */\n  combinedScore: number;\n}\n\nexport interface SearchMetrics {\n  porterHits: number;\n  trigramHits: number;\n  phase2Activated: boolean;\n  fuzzyApplied: boolean;\n  latencyMs: number;\n}\n\nexport interface FuzzyCorrection {\n  originalQuery: string;\n  correctedQuery: string;\n  corrections: Array<{\n    original: string;\n    corrected: string;\n    distance: number;\n  }>;\n}\n\nexport interface SearchResponse {\n  query: string;\n  results: SearchResult[];\n  metrics: SearchMetrics;\n  fuzzyCorrection?: FuzzyCorrection;\n}\n\n// ── Community Detection ────────────────────────────────────────\n\nexport interface CommunityEntry {\n  readonly symbolId: string;\n  readonly communityId: number;\n  readonly communityLabel: string;\n}\n\nexport interface GodNode {\n  readonly symbolId: string;\n  readonly bridgedCommunities: readonly number[];\n  readonly centralityScore: number;\n}\n\nexport const EDGE_QUALITY = ['full', 'syntax-only', 'mixed'] as const;\nexport type EdgeQuality = (typeof EDGE_QUALITY)[number];\n\nexport interface CommunitySnapshot {\n  readonly version: 1;\n  readonly computedAt: string;\n  readonly commitSha: string;\n  readonly modularity: number;\n  readonly communities: readonly CommunityEntry[];\n  readonly godNodes: readonly GodNode[];\n  readonly edgeQuality: EdgeQuality;\n  readonly crossClusterEdges: number;\n}\n\nexport interface DriftEvent {\n  readonly symbolId: string;\n  readonly movedFrom: { readonly id: number; readonly label: string };\n  readonly movedTo: { readonly id: number; readonly label: string };\n  readonly firstSeenInNewCluster: string;\n}\n\nexport interface BoundaryViolation {\n  readonly from: {\n    readonly symbolId: string;\n    readonly communityId: number;\n    readonly label: string;\n  };\n  readonly to: {\n    readonly symbolId: string;\n    readonly communityId: number;\n    readonly label: string;\n  };\n  readonly edgeKind: EdgeKind;\n  readonly historicalEdgesBetweenClusters: number;\n  readonly severity: 'high' | 'medium';\n}\n\n// ── Persisted architectural artifacts ──────────────────────────\n// Written by `ctxo index` next to communities.json so the static\n// HTML visualizer can render Architecture views without re-running\n// detectors in the browser.\n\nexport type ConfidenceLevel = 'high' | 'medium' | 'low';\n\nexport interface DriftEventsArtifact {\n  readonly version: 1;\n  readonly computedAt: string;\n  readonly commitSha: string;\n  readonly confidence: ConfidenceLevel;\n  readonly snapshotsAvailable: number;\n  readonly hint?: string;\n  readonly events: readonly DriftEvent[];\n}\n\nexport interface BoundaryViolationsArtifact {\n  readonly version: 1;\n  readonly computedAt: string;\n  readonly commitSha: string;\n  readonly confidence: ConfidenceLevel;\n  readonly snapshotsAvailable: number;\n  readonly hint?: string;\n  readonly violations: readonly BoundaryViolation[];\n}\n"],"mappings":";;;AAAA,SAAS,cAAc,aAAa,YAAY,oBAAoB;AACpE,SAAS,MAAM,gBAAgB;;;ACD/B,SAAS,SAAS;AAIX,IAAM,eAAe;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,mBAAmB,EAAE,KAAK,YAAY;AAK5C,IAAM,aAAa;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,iBAAiB,EAAE,KAAK,UAAU;AAOxC,IAAM,oBAAoB,EAAE,MAAM;AAAA,EACvC,EAAE,QAAQ,CAAC;AAAA,EACX,EAAE,QAAQ,CAAC;AAAA,EACX,EAAE,QAAQ,CAAC;AAAA,EACX,EAAE,QAAQ,CAAC;AACb,CAAC;AASM,IAAM,iBAAiB,EAC3B,OAAO,EACP,IAAI,CAAC,EACL;AAAA,EACC,CAAC,UAAU;AACT,UAAM,QAAQ,MAAM,MAAM,IAAI;AAC9B,QAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,UAAM,CAAC,MAAM,MAAM,IAAI,IAAI;AAC3B,QAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAM,QAAO;AACpC,WAAO,iBAAiB,UAAU,IAAI,EAAE;AAAA,EAC1C;AAAA,EACA,EAAE,SAAS,uDAAuD;AACpE;AAKK,IAAM,mBAAmB,EAC7B,OAAO;AAAA,EACN,UAAU;AAAA,EACV,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,MAAM;AAAA,EACN,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EACxC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EACtC,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS;AAAA,EACrD,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS;AACrD,CAAC,EACA,OAAO,CAAC,SAAS,KAAK,WAAW,KAAK,WAAW;AAAA,EAChD,SAAS;AACX,CAAC;AAKI,IAAM,kBAAkB,EAAE,OAAO;AAAA,EACtC,MAAM;AAAA,EACN,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,UAAU,EAAE,QAAQ,EAAE,SAAS;AACjC,CAAC;AAKM,IAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,SAAS,EAAE,OAAO;AAAA,EAClB,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,MAAM,EAAE,QAAQ,QAAQ;AAC1B,CAAC;AAKM,IAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,SAAS,EAAE,OAAO;AAAA,EAClB,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;AACxB,CAAC;AAKM,IAAM,0BAA0B,EAAE,OAAO;AAAA,EAC9C,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EAC1B,YAAY,EAAE,OAAO,EAAE,YAAY;AACrC,CAAC;AAEM,IAAM,kBAAkB,EAAE,OAAO;AAAA,EACtC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,cAAc,EAAE,OAAO,EAAE,YAAY;AAAA,EACrC,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,SAAS,EAAE,MAAM,gBAAgB;AAAA,EACjC,OAAO,EAAE,MAAM,eAAe;AAAA,EAC9B,YAAY,EAAE,MAAM,uBAAuB,EAAE,SAAS;AAAA,EACtD,QAAQ,EAAE,MAAM,kBAAkB;AAAA,EAClC,cAAc,EAAE,MAAM,iBAAiB;AACzC,CAAC;;;ADxHM,IAAM,kBAAN,MAAsB;AAAA,EACV;AAAA,EAEjB,YAAY,UAAkB;AAC5B,SAAK,WAAW,KAAK,UAAU,OAAO;AAAA,EACxC;AAAA,EAEA,UAAuB;AACrB,QAAI,CAAC,WAAW,KAAK,QAAQ,GAAG;AAC9B,aAAO,CAAC;AAAA,IACV;AAEA,UAAM,YAAY,KAAK,iBAAiB,KAAK,QAAQ;AACrD,UAAM,UAAuB,CAAC;AAE9B,eAAW,YAAY,WAAW;AAChC,YAAM,SAAS,KAAK,WAAW,QAAQ;AACvC,UAAI,QAAQ;AACV,gBAAQ,KAAK,MAAM;AAAA,MACrB;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,WAAW,cAA6C;AACtD,QAAI;AACF,YAAM,MAAM,aAAa,cAAc,OAAO;AAC9C,YAAM,OAAgB,KAAK,MAAM,GAAG;AACpC,YAAM,SAAS,gBAAgB,UAAU,IAAI;AAE7C,UAAI,CAAC,OAAO,SAAS;AACnB,cAAM,MAAM,SAAS,KAAK,UAAU,YAAY;AAChD,gBAAQ;AAAA,UACN,wCAAwC,GAAG,KAAK,OAAO,MAAM,OAAO;AAAA,QACtE;AACA,eAAO;AAAA,MACT;AAEA,aAAO,OAAO;AAAA,IAChB,SAAS,KAAK;AACZ,YAAM,MAAM,SAAS,KAAK,UAAU,YAAY;AAChD,cAAQ;AAAA,QACN,qCAAqC,GAAG,KAAM,IAAc,OAAO;AAAA,MACrE;AACA,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEQ,iBAAiB,KAAa,UAAuB,oBAAI,IAAI,GAAa;AAChF,UAAM,UAAU,aAAa,GAAG;AAChC,QAAI,QAAQ,IAAI,OAAO,EAAG,QAAO,CAAC;AAClC,YAAQ,IAAI,OAAO;AAEnB,UAAM,QAAkB,CAAC;AAEzB,eAAW,SAAS,YAAY,KAAK,EAAE,eAAe,KAAK,CAAC,GAAG;AAC7D,UAAI,MAAM,eAAe,EAAG;AAE5B,YAAM,WAAW,KAAK,KAAK,MAAM,IAAI;AACrC,UAAI,MAAM,YAAY,GAAG;AAEvB,YAAI,MAAM,SAAS,sBAAuB;AAC1C,cAAM,KAAK,GAAG,KAAK,iBAAiB,UAAU,OAAO,CAAC;AAAA,MACxD,WACE,MAAM,KAAK,SAAS,OAAO,KAC3B,MAAM,SAAS,qBACf,MAAM,SAAS,sBACf,MAAM,SAAS,uBACf,MAAM,SAAS,4BACf;AACA,cAAM,KAAK,QAAQ;AAAA,MACrB;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/chunk-6EKERTJ7.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+
+// src/adapters/storage/atomic-write.ts
+import { readdirSync, renameSync, statSync, unlinkSync, writeFileSync, existsSync } from "fs";
+import { join } from "path";
+
+// src/core/logger.ts
+function isDebugEnabled(namespace) {
+  const debugEnv = process.env["DEBUG"] ?? "";
+  if (!debugEnv) return false;
+  const patterns = debugEnv.split(",").map((p) => p.trim());
+  return patterns.some((p) => {
+    if (p === "*" || p === "ctxo:*") return true;
+    if (p === namespace) return true;
+    if (p.endsWith(":*") && namespace.startsWith(p.slice(0, -1))) return true;
+    return false;
+  });
+}
+function createLogger(namespace) {
+  const prefix = `[${namespace}]`;
+  return {
+    debug(message, ...args) {
+      if (isDebugEnabled(namespace)) {
+        console.error(`${prefix} DEBUG ${message}`, ...args);
+      }
+    },
+    info(message, ...args) {
+      console.error(`${prefix} ${message}`, ...args);
+    },
+    warn(message, ...args) {
+      console.error(`${prefix} WARN ${message}`, ...args);
+    },
+    error(message, ...args) {
+      console.error(`${prefix} ERROR ${message}`, ...args);
+    }
+  };
+}
+
+// src/adapters/storage/atomic-write.ts
+var log = createLogger("ctxo:storage");
+var TMP_SUFFIX_RE = /\.\d+\.tmp$/;
+var TMP_STALE_THRESHOLD_MS = 6e4;
+function atomicWrite(targetPath, content) {
+  const tmpPath = `${targetPath}.${process.pid}.tmp`;
+  writeFileSync(tmpPath, content, "utf-8");
+  renameSync(tmpPath, targetPath);
+}
+function sweepStaleTmpFiles(dir, now = Date.now()) {
+  if (!existsSync(dir)) return 0;
+  let cleaned = 0;
+  try {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      if (entry.isSymbolicLink()) continue;
+      if (entry.isDirectory()) {
+        cleaned += sweepStaleTmpFiles(join(dir, entry.name), now);
+        continue;
+      }
+      if (!TMP_SUFFIX_RE.test(entry.name)) continue;
+      const full = join(dir, entry.name);
+      try {
+        const age = now - statSync(full).mtimeMs;
+        if (age < TMP_STALE_THRESHOLD_MS) continue;
+        unlinkSync(full);
+        cleaned++;
+      } catch (err) {
+        log.error(`failed to sweep ${entry.name}: ${err.message}`);
+      }
+    }
+  } catch (err) {
+    log.error(`failed to scan ${dir}: ${err.message}`);
+  }
+  return cleaned;
+}
+
+export {
+  createLogger,
+  atomicWrite,
+  sweepStaleTmpFiles
+};
+//# sourceMappingURL=chunk-6EKERTJ7.js.map

package/dist/chunk-6EKERTJ7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/storage/atomic-write.ts","../src/core/logger.ts"],"sourcesContent":["import { readdirSync, renameSync, statSync, unlinkSync, writeFileSync, existsSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { createLogger } from '../../core/logger.js';\n\nconst log = createLogger('ctxo:storage');\n\nconst TMP_SUFFIX_RE = /\\.\\d+\\.tmp$/;\nconst TMP_STALE_THRESHOLD_MS = 60_000; // anything older than 60 s is from a dead process\n\nexport function atomicWrite(targetPath: string, content: string): void {\n  const tmpPath = `${targetPath}.${process.pid}.tmp`;\n  writeFileSync(tmpPath, content, 'utf-8');\n  renameSync(tmpPath, targetPath);\n}\n\n/**\n * Remove orphaned .<pid>.tmp files left behind when a previous write crashed\n * (SIGKILL / power loss / ENOSPC). Only files older than a threshold are\n * removed so we never race a concurrent writer.\n *\n * Safe to call on every startup — walks the supplied directory non-recursively.\n */\nexport function sweepStaleTmpFiles(dir: string, now: number = Date.now()): number {\n  if (!existsSync(dir)) return 0;\n  let cleaned = 0;\n  try {\n    for (const entry of readdirSync(dir, { withFileTypes: true })) {\n      if (entry.isSymbolicLink()) continue;\n      if (entry.isDirectory()) {\n        cleaned += sweepStaleTmpFiles(join(dir, entry.name), now);\n        continue;\n      }\n      if (!TMP_SUFFIX_RE.test(entry.name)) continue;\n      const full = join(dir, entry.name);\n      try {\n        const age = now - statSync(full).mtimeMs;\n        if (age < TMP_STALE_THRESHOLD_MS) continue;\n        unlinkSync(full);\n        cleaned++;\n      } catch (err) {\n        log.error(`failed to sweep ${entry.name}: ${(err as Error).message}`);\n      }\n    }\n  } catch (err) {\n    log.error(`failed to scan ${dir}: ${(err as Error).message}`);\n  }\n  return cleaned;\n}\n","/**\n * Structured logger for Ctxo — all output goes to stderr (stdout reserved for MCP JSON-RPC).\n *\n * Supports debug mode via DEBUG environment variable:\n *   DEBUG=ctxo:*          — all debug output\n *   DEBUG=ctxo:git        — only git adapter debug\n *   DEBUG=ctxo:index      — only indexing debug\n *   DEBUG=ctxo:mcp        — only MCP handler debug\n *   DEBUG=ctxo:storage    — only storage adapter debug\n *   DEBUG=ctxo:masking    — only masking pipeline debug\n *\n * Always outputs: info, warn, error (regardless of DEBUG).\n * Only outputs debug when matching namespace is enabled.\n */\n\nfunction isDebugEnabled(namespace: string): boolean {\n  const debugEnv = process.env['DEBUG'] ?? '';\n  if (!debugEnv) return false;\n  const patterns = debugEnv.split(',').map(p => p.trim());\n  return patterns.some(p => {\n    if (p === '*' || p === 'ctxo:*') return true;\n    if (p === namespace) return true;\n    if (p.endsWith(':*') && namespace.startsWith(p.slice(0, -1))) return true;\n    return false;\n  });\n}\n\nexport interface Logger {\n  debug(message: string, ...args: unknown[]): void;\n  info(message: string, ...args: unknown[]): void;\n  warn(message: string, ...args: unknown[]): void;\n  error(message: string, ...args: unknown[]): void;\n}\n\nexport function createLogger(namespace: string): Logger {\n  const prefix = `[${namespace}]`;\n\n  return {\n    debug(message: string, ...args: unknown[]) {\n      if (isDebugEnabled(namespace)) {\n        console.error(`${prefix} DEBUG ${message}`, ...args);\n      }\n    },\n    info(message: string, ...args: unknown[]) {\n      console.error(`${prefix} ${message}`, ...args);\n    },\n    warn(message: string, ...args: unknown[]) {\n      console.error(`${prefix} WARN ${message}`, ...args);\n    },\n    error(message: string, ...args: unknown[]) {\n      console.error(`${prefix} ERROR ${message}`, ...args);\n    },\n  };\n}\n"],"mappings":";;;AAAA,SAAS,aAAa,YAAY,UAAU,YAAY,eAAe,kBAAkB;AACzF,SAAS,YAAY;;;ACcrB,SAAS,eAAe,WAA4B;AAClD,QAAM,WAAW,QAAQ,IAAI,OAAO,KAAK;AACzC,MAAI,CAAC,SAAU,QAAO;AACtB,QAAM,WAAW,SAAS,MAAM,GAAG,EAAE,IAAI,OAAK,EAAE,KAAK,CAAC;AACtD,SAAO,SAAS,KAAK,OAAK;AACxB,QAAI,MAAM,OAAO,MAAM,SAAU,QAAO;AACxC,QAAI,MAAM,UAAW,QAAO;AAC5B,QAAI,EAAE,SAAS,IAAI,KAAK,UAAU,WAAW,EAAE,MAAM,GAAG,EAAE,CAAC,EAAG,QAAO;AACrE,WAAO;AAAA,EACT,CAAC;AACH;AASO,SAAS,aAAa,WAA2B;AACtD,QAAM,SAAS,IAAI,SAAS;AAE5B,SAAO;AAAA,IACL,MAAM,YAAoB,MAAiB;AACzC,UAAI,eAAe,SAAS,GAAG;AAC7B,gBAAQ,MAAM,GAAG,MAAM,UAAU,OAAO,IAAI,GAAG,IAAI;AAAA,MACrD;AAAA,IACF;AAAA,IACA,KAAK,YAAoB,MAAiB;AACxC,cAAQ,MAAM,GAAG,MAAM,IAAI,OAAO,IAAI,GAAG,IAAI;AAAA,IAC/C;AAAA,IACA,KAAK,YAAoB,MAAiB;AACxC,cAAQ,MAAM,GAAG,MAAM,SAAS,OAAO,IAAI,GAAG,IAAI;AAAA,IACpD;AAAA,IACA,MAAM,YAAoB,MAAiB;AACzC,cAAQ,MAAM,GAAG,MAAM,UAAU,OAAO,IAAI,GAAG,IAAI;AAAA,IACrD;AAAA,EACF;AACF;;;ADhDA,IAAM,MAAM,aAAa,cAAc;AAEvC,IAAM,gBAAgB;AACtB,IAAM,yBAAyB;AAExB,SAAS,YAAY,YAAoB,SAAuB;AACrE,QAAM,UAAU,GAAG,UAAU,IAAI,QAAQ,GAAG;AAC5C,gBAAc,SAAS,SAAS,OAAO;AACvC,aAAW,SAAS,UAAU;AAChC;AASO,SAAS,mBAAmB,KAAa,MAAc,KAAK,IAAI,GAAW;AAChF,MAAI,CAAC,WAAW,GAAG,EAAG,QAAO;AAC7B,MAAI,UAAU;AACd,MAAI;AACF,eAAW,SAAS,YAAY,KAAK,EAAE,eAAe,KAAK,CAAC,GAAG;AAC7D,UAAI,MAAM,eAAe,EAAG;AAC5B,UAAI,MAAM,YAAY,GAAG;AACvB,mBAAW,mBAAmB,KAAK,KAAK,MAAM,IAAI,GAAG,GAAG;AACxD;AAAA,MACF;AACA,UAAI,CAAC,cAAc,KAAK,MAAM,IAAI,EAAG;AACrC,YAAM,OAAO,KAAK,KAAK,MAAM,IAAI;AACjC,UAAI;AACF,cAAM,MAAM,MAAM,SAAS,IAAI,EAAE;AACjC,YAAI,MAAM,uBAAwB;AAClC,mBAAW,IAAI;AACf;AAAA,MACF,SAAS,KAAK;AACZ,YAAI,MAAM,mBAAmB,MAAM,IAAI,KAAM,IAAc,OAAO,EAAE;AAAA,MACtE;AAAA,IACF;AAAA,EACF,SAAS,KAAK;AACZ,QAAI,MAAM,kBAAkB,GAAG,KAAM,IAAc,OAAO,EAAE;AAAA,EAC9D;AACA,SAAO;AACT;","names":[]}