pi-harness-runtime 1.1.325 → 1.1.327
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.
- package/package.json +1 -1
- package/packages/a2a-adapter/package.json +1 -1
- package/packages/agent-policy/package.json +1 -1
- package/packages/architecture-generator/package.json +1 -1
- package/packages/auth/package.json +1 -1
- package/packages/autonomous-refactor/package.json +1 -1
- package/packages/autonomous-runtime/package.json +1 -1
- package/packages/cache-strategy/package.json +1 -1
- package/packages/capability-registry/package.json +1 -1
- package/packages/checkpoint/package.json +1 -1
- package/packages/cli-plugin-sdk/package.json +1 -1
- package/packages/clipboard/package.json +1 -1
- package/packages/clipboard-plugin/package.json +1 -1
- package/packages/code-generation/package.json +1 -1
- package/packages/code-review/package.json +1 -1
- package/packages/codex-adapter/package.json +1 -1
- package/packages/codex-watcher/package.json +1 -1
- package/packages/config-capture/package.json +1 -1
- package/packages/context-compiler/package.json +1 -1
- package/packages/context-discovery/package.json +1 -1
- package/packages/context-manager/package.json +1 -1
- package/packages/cookie-sanitizer/package.json +1 -1
- package/packages/cost-optimizer/package.json +1 -1
- package/packages/dependency-analyzer/package.json +1 -1
- package/packages/django-plugin/package.json +1 -1
- package/packages/doc-generator/package.json +1 -1
- package/packages/durable-review/package.json +1 -1
- package/packages/e2e-tester/package.json +1 -1
- package/packages/evaluation-engine/package.json +1 -1
- package/packages/evaluation-runner/package.json +1 -1
- package/packages/event-bus/package.json +1 -1
- package/packages/event-store/package.json +1 -1
- package/packages/experience-replay/package.json +1 -1
- package/packages/feedback-collector/package.json +1 -1
- package/packages/file-copy-helper/package.json +1 -1
- package/packages/framework-detector/package.json +1 -1
- package/packages/framework-plugin-sdk/package.json +1 -1
- package/packages/frappe-plugin/package.json +1 -1
- package/packages/generic-web-plugin/package.json +1 -1
- package/packages/health-monitor/package.json +1 -1
- package/packages/intent-analyzer/package.json +1 -1
- package/packages/jev-judge/package.json +1 -1
- package/packages/knowledge-graph/package.json +1 -1
- package/packages/knowledge-retrieval/package.json +1 -1
- package/packages/laravel-plugin/package.json +1 -1
- package/packages/learning-engine/package.json +1 -1
- package/packages/mcp-adapter/package.json +1 -1
- package/packages/memory-engine/package.json +1 -1
- package/packages/milestone-manager/package.json +1 -1
- package/packages/model-registry/package.json +1 -1
- package/packages/nextjs-plugin/package.json +1 -1
- package/packages/notification/package.json +1 -1
- package/packages/observability/package.json +1 -1
- package/packages/okf-indexer/package.json +1 -1
- package/packages/paperclip-integration/package.json +1 -1
- package/packages/performance-optimizer/package.json +1 -1
- package/packages/privilege-broker/package.json +1 -1
- package/packages/project-analyzer/package.json +1 -1
- package/packages/project-bootstrap/package.json +1 -1
- package/packages/projection-engine/package.json +1 -1
- package/packages/prompt-compiler/package.json +1 -1
- package/packages/prompt-versioning/package.json +1 -1
- package/packages/provider-adapter-sdk/package.json +1 -1
- package/packages/provider-router/package.json +1 -1
- package/packages/provider-selector/package.json +1 -1
- package/packages/providers/package.json +1 -1
- package/packages/qdrant-skills/package.json +1 -1
- package/packages/quota-manager/package.json +1 -1
- package/packages/rate-limiter/package.json +1 -1
- package/packages/react-vite-plugin/package.json +1 -1
- package/packages/release-manager/package.json +1 -1
- package/packages/requirement-compiler/package.json +1 -1
- package/packages/runtime/package.json +1 -1
- package/packages/scheduler/package.json +1 -1
- package/packages/scheduler-adapter/package.json +1 -1
- package/packages/session/package.json +1 -1
- package/packages/session-api/package.json +1 -1
- package/packages/session-export/package.json +1 -1
- package/packages/shared-context/package.json +1 -1
- package/packages/skill-mcp-client/package.json +1 -1
- package/packages/skill-registry/package.json +1 -1
- package/packages/skills/package.json +1 -1
- package/packages/sprint-planner/package.json +1 -1
- package/packages/subscription-engine/package.json +1 -1
- package/packages/task-compiler/package.json +1 -1
- package/packages/telegram/package.json +1 -1
- package/packages/tencentdb-memory/package.json +1 -1
- package/packages/tencentdb-sync/package.json +1 -1
- package/packages/test-data-generator/package.json +1 -1
- package/packages/test-generator/package.json +1 -1
- package/packages/todo-bd-sync/package.json +1 -1
- package/packages/token-estimation/package.json +1 -1
- package/packages/token-optimizer/package.json +1 -1
- package/packages/trajectory/package.json +1 -1
- package/packages/tui/package.json +1 -1
- package/packages/types/package.json +1 -1
- package/packages/webmcp-tester/package.json +1 -1
- package/packages/wiki/dist/index.d.ts +134 -0
- package/packages/wiki/dist/index.d.ts.map +1 -0
- package/packages/wiki/dist/index.js +466 -0
- package/packages/wiki/dist/index.js.map +1 -0
- package/packages/wiki/dist/storage.d.ts +150 -0
- package/packages/wiki/dist/storage.d.ts.map +1 -0
- package/packages/wiki/dist/storage.js +646 -0
- package/packages/wiki/dist/storage.js.map +1 -0
- package/packages/wiki/dist/types.d.ts +189 -0
- package/packages/wiki/dist/types.d.ts.map +1 -0
- package/packages/wiki/dist/types.js +30 -0
- package/packages/wiki/dist/types.js.map +1 -0
- package/packages/wiki/package.json +22 -0
- package/packages/wiki/src/index.ts +602 -0
- package/packages/wiki/src/storage.ts +743 -0
- package/packages/wiki/src/types.ts +263 -0
- package/packages/wiki/test/basic.test.ts +242 -0
- package/packages/workflow-events/package.json +1 -1
- package/packages/workspace-scanner/package.json +1 -1
- package/packages/worktree/package.json +1 -1
- package/packages/write-review/package.json +1 -1
|
@@ -0,0 +1,466 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Wiki Package - Main API
|
|
3
|
+
*
|
|
4
|
+
* Implements LLM Wiki integration per wiki/llm-wiki-integration-minimax-plan.md
|
|
5
|
+
*/
|
|
6
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
7
|
+
import { join, resolve } from "node:path";
|
|
8
|
+
import { randomUUID } from "node:crypto";
|
|
9
|
+
import { createWikiStorage, computeHash, now, parseFrontmatter, } from "./storage.js";
|
|
10
|
+
import { toSourceRef } from "./types.js";
|
|
11
|
+
// ============================================================================
|
|
12
|
+
// Feature Flag
|
|
13
|
+
// ============================================================================
|
|
14
|
+
/**
|
|
15
|
+
* Check if wiki feature is enabled
|
|
16
|
+
*/
|
|
17
|
+
export function isWikiEnabled() {
|
|
18
|
+
return process.env.HARNESS_KNOWLEDGE_WIKI === "1";
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Require wiki to be enabled
|
|
22
|
+
*/
|
|
23
|
+
function requireWiki() {
|
|
24
|
+
if (!isWikiEnabled()) {
|
|
25
|
+
throw new Error("Wiki feature is disabled. Set HARNESS_KNOWLEDGE_WIKI=1 to enable.");
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
// ============================================================================
|
|
29
|
+
// Wiki Manager
|
|
30
|
+
// ============================================================================
|
|
31
|
+
/**
|
|
32
|
+
* Wiki manager - main API for wiki operations
|
|
33
|
+
*/
|
|
34
|
+
export class WikiManager {
|
|
35
|
+
storage;
|
|
36
|
+
config;
|
|
37
|
+
constructor(storage) {
|
|
38
|
+
this.storage = storage;
|
|
39
|
+
this.config = storage.getConfig();
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* Get wiki configuration
|
|
43
|
+
*/
|
|
44
|
+
getConfig() {
|
|
45
|
+
return this.config;
|
|
46
|
+
}
|
|
47
|
+
// ========================================================================
|
|
48
|
+
// Initialization
|
|
49
|
+
// ========================================================================
|
|
50
|
+
/**
|
|
51
|
+
* Initialize wiki structure
|
|
52
|
+
*/
|
|
53
|
+
initialize() {
|
|
54
|
+
requireWiki();
|
|
55
|
+
return this.storage.initialize();
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Check if wiki is initialized
|
|
59
|
+
*/
|
|
60
|
+
isInitialized() {
|
|
61
|
+
return existsSync(this.config.knowledgeDir);
|
|
62
|
+
}
|
|
63
|
+
// ========================================================================
|
|
64
|
+
// Source Ingestion
|
|
65
|
+
// ========================================================================
|
|
66
|
+
/**
|
|
67
|
+
* Ingest a source file and create snapshot
|
|
68
|
+
* Returns existing snapshot if same requestId was already processed
|
|
69
|
+
*/
|
|
70
|
+
ingestSource(sourcePath, requestId) {
|
|
71
|
+
requireWiki();
|
|
72
|
+
// Validate source path
|
|
73
|
+
const resolvedPath = resolve(sourcePath);
|
|
74
|
+
if (!existsSync(resolvedPath)) {
|
|
75
|
+
throw new Error(`Source file not found: ${sourcePath}`);
|
|
76
|
+
}
|
|
77
|
+
// Check for duplicate request
|
|
78
|
+
if (requestId) {
|
|
79
|
+
const operations = this.storage.getRecentOperations(1000);
|
|
80
|
+
const existingOp = operations.find((op) => op.requestId === requestId && op.status === "success");
|
|
81
|
+
if (existingOp) {
|
|
82
|
+
// Find the snapshot from the existing operation
|
|
83
|
+
const details = existingOp.details;
|
|
84
|
+
if (details.snapshotId) {
|
|
85
|
+
const snapshot = this.storage.getSnapshot(details.snapshotId);
|
|
86
|
+
if (snapshot) {
|
|
87
|
+
return { snapshot, operation: existingOp, existing: true };
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
// Read content
|
|
93
|
+
const content = readFileSync(resolvedPath, "utf8");
|
|
94
|
+
// Log operation
|
|
95
|
+
const operation = this.storage.logOperation("ingest", { sourcePath }, requestId);
|
|
96
|
+
try {
|
|
97
|
+
// Create snapshot
|
|
98
|
+
const snapshot = this.storage.createSnapshot(resolvedPath, content, operation.id);
|
|
99
|
+
// Update operation with snapshot ID for future deduplication
|
|
100
|
+
this.storage.updateOperationDetails(operation.id, { snapshotId: snapshot.id });
|
|
101
|
+
// Complete operation
|
|
102
|
+
this.storage.completeOperation(operation.id, "success");
|
|
103
|
+
return { snapshot, operation, existing: false };
|
|
104
|
+
}
|
|
105
|
+
catch (err) {
|
|
106
|
+
const error = err instanceof Error ? err.message : String(err);
|
|
107
|
+
this.storage.completeOperation(operation.id, "failed", error);
|
|
108
|
+
throw err;
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
/**
|
|
112
|
+
* Get source snapshot
|
|
113
|
+
*/
|
|
114
|
+
getSnapshot(snapshotId) {
|
|
115
|
+
requireWiki();
|
|
116
|
+
return this.storage.getSnapshot(snapshotId);
|
|
117
|
+
}
|
|
118
|
+
// ========================================================================
|
|
119
|
+
// Page Operations
|
|
120
|
+
// ========================================================================
|
|
121
|
+
/**
|
|
122
|
+
* Create a new wiki page
|
|
123
|
+
*/
|
|
124
|
+
createPage(params) {
|
|
125
|
+
requireWiki();
|
|
126
|
+
const id = `page-${randomUUID().slice(0, 8)}`;
|
|
127
|
+
const timestamp = now();
|
|
128
|
+
const frontmatter = {
|
|
129
|
+
id,
|
|
130
|
+
title: params.title,
|
|
131
|
+
kind: params.kind,
|
|
132
|
+
projectId: this.config.projectId,
|
|
133
|
+
status: "proposed",
|
|
134
|
+
createdAt: timestamp,
|
|
135
|
+
updatedAt: timestamp,
|
|
136
|
+
sources: (params.sources ?? []).map(toSourceRef),
|
|
137
|
+
relatedPages: params.relatedPages ?? [],
|
|
138
|
+
codeVersion: params.codeVersion,
|
|
139
|
+
};
|
|
140
|
+
const page = {
|
|
141
|
+
frontmatter,
|
|
142
|
+
body: params.body,
|
|
143
|
+
rawFrontmatter: "",
|
|
144
|
+
};
|
|
145
|
+
this.storage.savePage(page);
|
|
146
|
+
return page;
|
|
147
|
+
}
|
|
148
|
+
/**
|
|
149
|
+
* Update an existing page
|
|
150
|
+
*/
|
|
151
|
+
updatePage(pageId, updates) {
|
|
152
|
+
requireWiki();
|
|
153
|
+
const existing = this.storage.loadPage(pageId);
|
|
154
|
+
if (!existing) {
|
|
155
|
+
throw new Error(`Page not found: ${pageId}`);
|
|
156
|
+
}
|
|
157
|
+
const updatedFrontmatter = {
|
|
158
|
+
...existing.frontmatter,
|
|
159
|
+
...updates,
|
|
160
|
+
sources: updates.sources ? updates.sources.map(toSourceRef) : existing.frontmatter.sources,
|
|
161
|
+
updatedAt: now(),
|
|
162
|
+
};
|
|
163
|
+
const page = {
|
|
164
|
+
frontmatter: updatedFrontmatter,
|
|
165
|
+
body: updates.body ?? existing.body,
|
|
166
|
+
rawFrontmatter: existing.rawFrontmatter,
|
|
167
|
+
};
|
|
168
|
+
this.storage.savePage(page);
|
|
169
|
+
return page;
|
|
170
|
+
}
|
|
171
|
+
/**
|
|
172
|
+
* Load a wiki page
|
|
173
|
+
*/
|
|
174
|
+
loadPage(pageId) {
|
|
175
|
+
requireWiki();
|
|
176
|
+
return this.storage.loadPage(pageId);
|
|
177
|
+
}
|
|
178
|
+
/**
|
|
179
|
+
* Delete a wiki page
|
|
180
|
+
*/
|
|
181
|
+
deletePage(pageId) {
|
|
182
|
+
requireWiki();
|
|
183
|
+
this.storage.deletePage(pageId);
|
|
184
|
+
}
|
|
185
|
+
/**
|
|
186
|
+
* Get all pages
|
|
187
|
+
*/
|
|
188
|
+
getAllPages() {
|
|
189
|
+
requireWiki();
|
|
190
|
+
return this.storage.getAllPages();
|
|
191
|
+
}
|
|
192
|
+
// ========================================================================
|
|
193
|
+
// Search
|
|
194
|
+
// ========================================================================
|
|
195
|
+
/**
|
|
196
|
+
* Search wiki pages
|
|
197
|
+
*/
|
|
198
|
+
search(query, filters, limit = 10) {
|
|
199
|
+
requireWiki();
|
|
200
|
+
return this.storage.search(query, filters, limit);
|
|
201
|
+
}
|
|
202
|
+
/**
|
|
203
|
+
* Get page index
|
|
204
|
+
*/
|
|
205
|
+
getIndex() {
|
|
206
|
+
requireWiki();
|
|
207
|
+
return this.storage.getIndex();
|
|
208
|
+
}
|
|
209
|
+
// ========================================================================
|
|
210
|
+
// Staged Changes
|
|
211
|
+
// ========================================================================
|
|
212
|
+
/**
|
|
213
|
+
* Stage a change for later application
|
|
214
|
+
*/
|
|
215
|
+
stageChange(pageId, expectedRevision, newContent) {
|
|
216
|
+
requireWiki();
|
|
217
|
+
const existing = this.storage.loadPage(pageId);
|
|
218
|
+
if (!existing) {
|
|
219
|
+
throw new Error(`Page not found: ${pageId}`);
|
|
220
|
+
}
|
|
221
|
+
const change = {
|
|
222
|
+
pageId,
|
|
223
|
+
expectedRevision,
|
|
224
|
+
newContent,
|
|
225
|
+
operationId: "",
|
|
226
|
+
};
|
|
227
|
+
this.storage.stageChange(change);
|
|
228
|
+
return change;
|
|
229
|
+
}
|
|
230
|
+
/**
|
|
231
|
+
* Get staged change for a page
|
|
232
|
+
*/
|
|
233
|
+
getStagedChange(pageId) {
|
|
234
|
+
requireWiki();
|
|
235
|
+
return this.storage.getStagedChange(pageId);
|
|
236
|
+
}
|
|
237
|
+
/**
|
|
238
|
+
* Clear staged change
|
|
239
|
+
*/
|
|
240
|
+
clearStagedChange(pageId) {
|
|
241
|
+
requireWiki();
|
|
242
|
+
this.storage.clearStagedChange(pageId);
|
|
243
|
+
}
|
|
244
|
+
// ========================================================================
|
|
245
|
+
// Apply Changes
|
|
246
|
+
// ========================================================================
|
|
247
|
+
/**
|
|
248
|
+
* Apply staged change with conflict detection
|
|
249
|
+
*/
|
|
250
|
+
applyChange(pageId, _requestId) {
|
|
251
|
+
requireWiki();
|
|
252
|
+
const staged = this.storage.getStagedChange(pageId);
|
|
253
|
+
if (!staged) {
|
|
254
|
+
throw new Error(`No staged change for page: ${pageId}`);
|
|
255
|
+
}
|
|
256
|
+
const existing = this.storage.loadPage(pageId);
|
|
257
|
+
if (!existing) {
|
|
258
|
+
throw new Error(`Page not found: ${pageId}`);
|
|
259
|
+
}
|
|
260
|
+
// Check for conflicts - hash entire page content to detect any changes
|
|
261
|
+
const currentRevision = computeHash((existing.rawFrontmatter || "") + "\n" + existing.body);
|
|
262
|
+
if (staged.expectedRevision !== currentRevision) {
|
|
263
|
+
throw new Error(`Conflict: page was modified. Expected revision ${staged.expectedRevision}, found ${currentRevision}`);
|
|
264
|
+
}
|
|
265
|
+
// Parse new content
|
|
266
|
+
const parsed = parseFrontmatter(staged.newContent);
|
|
267
|
+
if (!parsed.frontmatter) {
|
|
268
|
+
throw new Error("Invalid page content: missing frontmatter");
|
|
269
|
+
}
|
|
270
|
+
// Create updated page
|
|
271
|
+
const page = {
|
|
272
|
+
frontmatter: {
|
|
273
|
+
...parsed.frontmatter,
|
|
274
|
+
id: pageId,
|
|
275
|
+
updatedAt: now(),
|
|
276
|
+
},
|
|
277
|
+
body: parsed.body,
|
|
278
|
+
rawFrontmatter: parsed.raw,
|
|
279
|
+
};
|
|
280
|
+
this.storage.savePage(page);
|
|
281
|
+
this.storage.clearStagedChange(pageId);
|
|
282
|
+
return page;
|
|
283
|
+
}
|
|
284
|
+
// ========================================================================
|
|
285
|
+
// Lint
|
|
286
|
+
// ========================================================================
|
|
287
|
+
/**
|
|
288
|
+
* Run lint checks on wiki
|
|
289
|
+
*/
|
|
290
|
+
lint(scope) {
|
|
291
|
+
requireWiki();
|
|
292
|
+
const findings = [];
|
|
293
|
+
if (scope === undefined || scope === "all" || scope === "pages") {
|
|
294
|
+
findings.push(...this.lintPages());
|
|
295
|
+
}
|
|
296
|
+
if (scope === undefined || scope === "all" || scope === "links") {
|
|
297
|
+
findings.push(...this.lintLinks());
|
|
298
|
+
}
|
|
299
|
+
if (scope === undefined || scope === "all" || scope === "freshness") {
|
|
300
|
+
findings.push(...this.lintFreshness());
|
|
301
|
+
}
|
|
302
|
+
return findings;
|
|
303
|
+
}
|
|
304
|
+
/**
|
|
305
|
+
* Lint page structure
|
|
306
|
+
*/
|
|
307
|
+
lintPages() {
|
|
308
|
+
const findings = [];
|
|
309
|
+
const pages = this.storage.getAllPages();
|
|
310
|
+
for (const page of pages) {
|
|
311
|
+
// Check required frontmatter fields
|
|
312
|
+
if (!page.frontmatter.id) {
|
|
313
|
+
findings.push({
|
|
314
|
+
severity: "error",
|
|
315
|
+
category: "structure",
|
|
316
|
+
pageId: page.frontmatter.id,
|
|
317
|
+
message: "Missing id in frontmatter",
|
|
318
|
+
});
|
|
319
|
+
}
|
|
320
|
+
if (!page.frontmatter.title) {
|
|
321
|
+
findings.push({
|
|
322
|
+
severity: "error",
|
|
323
|
+
category: "structure",
|
|
324
|
+
pageId: page.frontmatter.id,
|
|
325
|
+
message: "Missing title in frontmatter",
|
|
326
|
+
});
|
|
327
|
+
}
|
|
328
|
+
if (!page.frontmatter.kind) {
|
|
329
|
+
findings.push({
|
|
330
|
+
severity: "error",
|
|
331
|
+
category: "structure",
|
|
332
|
+
pageId: page.frontmatter.id,
|
|
333
|
+
message: "Missing kind in frontmatter",
|
|
334
|
+
});
|
|
335
|
+
}
|
|
336
|
+
// Check for missing sources in non-reference pages
|
|
337
|
+
if (page.frontmatter.kind !== "reference" &&
|
|
338
|
+
page.frontmatter.sources.length === 0) {
|
|
339
|
+
findings.push({
|
|
340
|
+
severity: "warning",
|
|
341
|
+
category: "evidence",
|
|
342
|
+
pageId: page.frontmatter.id,
|
|
343
|
+
message: "Page has no source citations",
|
|
344
|
+
});
|
|
345
|
+
}
|
|
346
|
+
// Check for verified status without evidence
|
|
347
|
+
if (page.frontmatter.status === "verified" && !page.frontmatter.verification) {
|
|
348
|
+
findings.push({
|
|
349
|
+
severity: "warning",
|
|
350
|
+
category: "evidence",
|
|
351
|
+
pageId: page.frontmatter.id,
|
|
352
|
+
message: "Page has 'verified' status but no verification evidence",
|
|
353
|
+
});
|
|
354
|
+
}
|
|
355
|
+
}
|
|
356
|
+
return findings;
|
|
357
|
+
}
|
|
358
|
+
/**
|
|
359
|
+
* Lint link validity
|
|
360
|
+
*/
|
|
361
|
+
lintLinks() {
|
|
362
|
+
const findings = [];
|
|
363
|
+
const pages = this.storage.getAllPages();
|
|
364
|
+
const pageIds = new Set(pages.map((p) => p.frontmatter.id));
|
|
365
|
+
for (const page of pages) {
|
|
366
|
+
// Check related pages exist
|
|
367
|
+
for (const relatedId of page.frontmatter.relatedPages) {
|
|
368
|
+
if (!pageIds.has(relatedId)) {
|
|
369
|
+
findings.push({
|
|
370
|
+
severity: "warning",
|
|
371
|
+
category: "links",
|
|
372
|
+
pageId: page.frontmatter.id,
|
|
373
|
+
message: `Related page not found: ${relatedId}`,
|
|
374
|
+
});
|
|
375
|
+
}
|
|
376
|
+
}
|
|
377
|
+
// Check source snapshots exist
|
|
378
|
+
for (const source of page.frontmatter.sources) {
|
|
379
|
+
if (!this.storage.getSnapshot(source.sourceId)) {
|
|
380
|
+
findings.push({
|
|
381
|
+
severity: "warning",
|
|
382
|
+
category: "links",
|
|
383
|
+
pageId: page.frontmatter.id,
|
|
384
|
+
message: `Source snapshot not found: ${source.sourceId}`,
|
|
385
|
+
});
|
|
386
|
+
}
|
|
387
|
+
}
|
|
388
|
+
}
|
|
389
|
+
return findings;
|
|
390
|
+
}
|
|
391
|
+
/**
|
|
392
|
+
* Lint freshness
|
|
393
|
+
*/
|
|
394
|
+
lintFreshness() {
|
|
395
|
+
const findings = [];
|
|
396
|
+
const pages = this.storage.getAllPages();
|
|
397
|
+
const nowTime = Date.now();
|
|
398
|
+
const staleThreshold = 30 * 24 * 60 * 60 * 1000; // 30 days
|
|
399
|
+
for (const page of pages) {
|
|
400
|
+
const updatedTime = new Date(page.frontmatter.updatedAt).getTime();
|
|
401
|
+
const age = nowTime - updatedTime;
|
|
402
|
+
// Flag old pages without verification
|
|
403
|
+
if (page.frontmatter.status !== "verified" &&
|
|
404
|
+
page.frontmatter.status !== "superseded" &&
|
|
405
|
+
age > staleThreshold) {
|
|
406
|
+
findings.push({
|
|
407
|
+
severity: "info",
|
|
408
|
+
category: "freshness",
|
|
409
|
+
pageId: page.frontmatter.id,
|
|
410
|
+
message: `Page has not been updated in ${Math.floor(age / (24 * 60 * 60 * 1000))} days`,
|
|
411
|
+
});
|
|
412
|
+
}
|
|
413
|
+
// Check if sources have changed
|
|
414
|
+
for (const source of page.frontmatter.sources) {
|
|
415
|
+
const snapshot = this.storage.getSnapshot(source.sourceId);
|
|
416
|
+
if (snapshot) {
|
|
417
|
+
const snapTime = new Date(snapshot.capturedAt).getTime();
|
|
418
|
+
if (snapTime < updatedTime) {
|
|
419
|
+
findings.push({
|
|
420
|
+
severity: "warning",
|
|
421
|
+
category: "freshness",
|
|
422
|
+
pageId: page.frontmatter.id,
|
|
423
|
+
message: `Source ${source.sourceId} was captured before page was last updated`,
|
|
424
|
+
suggestion: "Consider re-ingesting source to verify content is current",
|
|
425
|
+
});
|
|
426
|
+
}
|
|
427
|
+
}
|
|
428
|
+
}
|
|
429
|
+
}
|
|
430
|
+
return findings;
|
|
431
|
+
}
|
|
432
|
+
// ========================================================================
|
|
433
|
+
// Operations
|
|
434
|
+
// ========================================================================
|
|
435
|
+
/**
|
|
436
|
+
* Get recent operations
|
|
437
|
+
*/
|
|
438
|
+
getRecentOperations(limit = 50) {
|
|
439
|
+
requireWiki();
|
|
440
|
+
return this.storage.getRecentOperations(limit);
|
|
441
|
+
}
|
|
442
|
+
}
|
|
443
|
+
// ============================================================================
|
|
444
|
+
// Factory
|
|
445
|
+
// ============================================================================
|
|
446
|
+
/**
|
|
447
|
+
* Create wiki manager for a workspace
|
|
448
|
+
*/
|
|
449
|
+
export function createWikiManager(workspaceRoot, projectId) {
|
|
450
|
+
const storage = createWikiStorage(workspaceRoot, projectId);
|
|
451
|
+
return new WikiManager(storage);
|
|
452
|
+
}
|
|
453
|
+
// Re-export storage class
|
|
454
|
+
export { WikiStorage, createWikiStorage } from "./storage.js";
|
|
455
|
+
/**
|
|
456
|
+
* Check if wiki exists in workspace
|
|
457
|
+
*/
|
|
458
|
+
export function wikiExists(workspaceRoot) {
|
|
459
|
+
const wikiRoot = join(workspaceRoot, "wiki");
|
|
460
|
+
return existsSync(join(wikiRoot, "knowledge"));
|
|
461
|
+
}
|
|
462
|
+
// ============================================================================
|
|
463
|
+
// Exports
|
|
464
|
+
// ============================================================================
|
|
465
|
+
export * from "./types.js";
|
|
466
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Wiki Storage - File-based persistence for wiki pages
|
|
3
|
+
*
|
|
4
|
+
* Handles atomic writes, transactions, and consistency.
|
|
5
|
+
*/
|
|
6
|
+
import type { WikiConfig, WikiPage, WikiPageFrontmatter, SourceSnapshot, WikiOperation, PageIndexEntry, WikiInitResult, WikiOperationType, WikiSearchFilters, WikiSearchResult, StagedChange } from "./types.js";
|
|
7
|
+
/**
|
|
8
|
+
* Compute SHA-256 hash of content
|
|
9
|
+
*/
|
|
10
|
+
export declare function computeHash(content: string): string;
|
|
11
|
+
/**
|
|
12
|
+
* Get current ISO timestamp
|
|
13
|
+
*/
|
|
14
|
+
export declare function now(): string;
|
|
15
|
+
/**
|
|
16
|
+
* Parse YAML frontmatter from markdown content
|
|
17
|
+
*/
|
|
18
|
+
export declare function parseFrontmatter(content: string): {
|
|
19
|
+
frontmatter: WikiPageFrontmatter | null;
|
|
20
|
+
body: string;
|
|
21
|
+
raw: string;
|
|
22
|
+
};
|
|
23
|
+
/**
|
|
24
|
+
* Serialize frontmatter to YAML string
|
|
25
|
+
*/
|
|
26
|
+
export declare function serializeFrontmatter(frontmatter: WikiPageFrontmatter): string;
|
|
27
|
+
/**
|
|
28
|
+
* Combine frontmatter and body into full page content
|
|
29
|
+
*/
|
|
30
|
+
export declare function combinePage(frontmatter: WikiPageFrontmatter, body: string): string;
|
|
31
|
+
/**
|
|
32
|
+
* Wiki storage manager
|
|
33
|
+
*/
|
|
34
|
+
export declare class WikiStorage {
|
|
35
|
+
private config;
|
|
36
|
+
private index;
|
|
37
|
+
private indexMtime;
|
|
38
|
+
private operations;
|
|
39
|
+
private stagedChanges;
|
|
40
|
+
constructor(config: WikiConfig);
|
|
41
|
+
/**
|
|
42
|
+
* Get wiki configuration
|
|
43
|
+
*/
|
|
44
|
+
getConfig(): WikiConfig;
|
|
45
|
+
/**
|
|
46
|
+
* Initialize wiki structure
|
|
47
|
+
*/
|
|
48
|
+
initialize(): WikiInitResult;
|
|
49
|
+
/**
|
|
50
|
+
* Ensure directory structure exists
|
|
51
|
+
*/
|
|
52
|
+
private ensureStructure;
|
|
53
|
+
/**
|
|
54
|
+
* Load page index from disk (if changed since last load)
|
|
55
|
+
*/
|
|
56
|
+
private loadIndex;
|
|
57
|
+
/**
|
|
58
|
+
* Save page index to disk (atomic)
|
|
59
|
+
*/
|
|
60
|
+
private saveIndex;
|
|
61
|
+
/**
|
|
62
|
+
* Load operations from log
|
|
63
|
+
*/
|
|
64
|
+
private loadOperations;
|
|
65
|
+
/**
|
|
66
|
+
* Append operation to log
|
|
67
|
+
*/
|
|
68
|
+
private appendOperation;
|
|
69
|
+
/**
|
|
70
|
+
* Load staged changes
|
|
71
|
+
*/
|
|
72
|
+
private loadStaged;
|
|
73
|
+
/**
|
|
74
|
+
* Save staged changes (atomic)
|
|
75
|
+
*/
|
|
76
|
+
private saveStaged;
|
|
77
|
+
/**
|
|
78
|
+
* Create immutable source snapshot
|
|
79
|
+
*/
|
|
80
|
+
createSnapshot(originalPath: string, content: string, operationId: string): SourceSnapshot;
|
|
81
|
+
/**
|
|
82
|
+
* Get source snapshot by ID
|
|
83
|
+
*/
|
|
84
|
+
getSnapshot(snapshotId: string): SourceSnapshot | null;
|
|
85
|
+
/**
|
|
86
|
+
* Save a wiki page
|
|
87
|
+
*/
|
|
88
|
+
savePage(page: WikiPage): void;
|
|
89
|
+
/**
|
|
90
|
+
* Load a wiki page
|
|
91
|
+
*/
|
|
92
|
+
loadPage(pageId: string): WikiPage | null;
|
|
93
|
+
/**
|
|
94
|
+
* Validate page ID to prevent path traversal attacks
|
|
95
|
+
*/
|
|
96
|
+
private validatePageId;
|
|
97
|
+
/**
|
|
98
|
+
* Delete a wiki page
|
|
99
|
+
*/
|
|
100
|
+
deletePage(pageId: string): void;
|
|
101
|
+
/**
|
|
102
|
+
* Get all pages
|
|
103
|
+
*/
|
|
104
|
+
getAllPages(): WikiPage[];
|
|
105
|
+
/**
|
|
106
|
+
* Stage a change for later application
|
|
107
|
+
*/
|
|
108
|
+
stageChange(change: StagedChange): void;
|
|
109
|
+
/**
|
|
110
|
+
* Get staged change for a page
|
|
111
|
+
*/
|
|
112
|
+
getStagedChange(pageId: string): StagedChange | undefined;
|
|
113
|
+
/**
|
|
114
|
+
* Clear staged change
|
|
115
|
+
*/
|
|
116
|
+
clearStagedChange(pageId: string): void;
|
|
117
|
+
/**
|
|
118
|
+
* Get all staged changes
|
|
119
|
+
*/
|
|
120
|
+
getAllStagedChanges(): StagedChange[];
|
|
121
|
+
/**
|
|
122
|
+
* Log an operation
|
|
123
|
+
*/
|
|
124
|
+
logOperation(type: WikiOperationType, details: Record<string, unknown>, requestId?: string): WikiOperation;
|
|
125
|
+
/**
|
|
126
|
+
* Update operation status
|
|
127
|
+
*/
|
|
128
|
+
completeOperation(opId: string, status: WikiOperation["status"], error?: string): void;
|
|
129
|
+
/**
|
|
130
|
+
* Update operation details (before completion)
|
|
131
|
+
*/
|
|
132
|
+
updateOperationDetails(opId: string, details: Record<string, unknown>): void;
|
|
133
|
+
/**
|
|
134
|
+
* Get recent operations
|
|
135
|
+
*/
|
|
136
|
+
getRecentOperations(limit?: number): WikiOperation[];
|
|
137
|
+
/**
|
|
138
|
+
* Search wiki pages
|
|
139
|
+
*/
|
|
140
|
+
search(query: string, filters?: WikiSearchFilters, limit?: number): WikiSearchResult[];
|
|
141
|
+
/**
|
|
142
|
+
* Get page index
|
|
143
|
+
*/
|
|
144
|
+
getIndex(): PageIndexEntry[];
|
|
145
|
+
}
|
|
146
|
+
/**
|
|
147
|
+
* Create wiki storage for a workspace
|
|
148
|
+
*/
|
|
149
|
+
export declare function createWikiStorage(workspaceRoot: string, projectId: string): WikiStorage;
|
|
150
|
+
//# sourceMappingURL=storage.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}
|