@ekkos/cli 1.3.7 → 1.3.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,59 @@
1
+ export interface LocalLivingDocsManagerOptions {
2
+ targetPath: string;
3
+ apiUrl?: string;
4
+ apiKey?: string | null;
5
+ timeZone?: string;
6
+ pollIntervalMs?: number;
7
+ flushDebounceMs?: number;
8
+ onLog?: (message: string) => void;
9
+ }
10
+ export declare class LocalLivingDocsManager {
11
+ private readonly targetPath;
12
+ private readonly apiUrl?;
13
+ private readonly apiKey?;
14
+ private readonly timeZone;
15
+ private readonly pollIntervalMs;
16
+ private readonly flushDebounceMs;
17
+ private readonly onLog?;
18
+ private repoRoot;
19
+ private watchRoot;
20
+ private scopePath;
21
+ private systems;
22
+ private watcher;
23
+ private pollTimer;
24
+ private flushTimer;
25
+ private initialCompilePromise;
26
+ private snapshot;
27
+ private pendingFiles;
28
+ private compileChain;
29
+ private stopped;
30
+ constructor(options: LocalLivingDocsManagerOptions);
31
+ start(): void;
32
+ stop(): void;
33
+ private log;
34
+ private enqueue;
35
+ private refreshSystems;
36
+ private startWatcher;
37
+ private buildSnapshot;
38
+ private scheduleFlush;
39
+ private processPendingFiles;
40
+ private findAffectedSystems;
41
+ /**
42
+ * Pull server-compiled (Gemini Pro) docs from the platform registry.
43
+ * These are richer than local mechanical docs — narrative architecture,
44
+ * data flow, gotchas, connected systems, conventions.
45
+ *
46
+ * Only overwrites local docs that are locally-compiled (not server-compiled).
47
+ * Runs on every startup (fast — single API call, writes only changed files).
48
+ */
49
+ private syncServerCompiledDocs;
50
+ private compileStaleSystems;
51
+ private collectSystemFiles;
52
+ private compileSystem;
53
+ /**
54
+ * Metadata-only patch for server-compiled docs.
55
+ * Updates ONLY the approved local-mutable frontmatter fields without touching the body.
56
+ * Fields: activity_status, days_since_last_change, last_compiled_at, compiled_timezone, recompile_reason
57
+ */
58
+ private patchServerDocMetadata;
59
+ }