pi-harness-runtime 1.1.324 → 1.1.326

package/packages/wiki/dist/types.d.ts

@@ -0,0 +1,189 @@
+/**
+ * Wiki Package Types
+ *
+ * Implements LLM Wiki integration per wiki/llm-wiki-integration-minimax-plan.md
+ */
+/**
+ * Wiki page status lifecycle
+ */
+export type PageStatus = "proposed" | "implemented" | "verified" | "stale" | "superseded";
+/**
+ * Page kind categories
+ */
+export type PageKind = "concept" | "decision" | "incident" | "plan" | "verification" | "reference";
+/**
+ * Source reference in page frontmatter
+ */
+export interface SourceRef {
+    sourceId: string;
+    path: string;
+    contentHash: string;
+    capturedAt: string;
+    redacted: boolean;
+}
+/**
+ * Wiki page frontmatter
+ */
+export interface WikiPageFrontmatter {
+    id: string;
+    title: string;
+    kind: PageKind;
+    projectId: string;
+    status: PageStatus;
+    createdAt: string;
+    updatedAt: string;
+    sources: SourceRef[];
+    relatedPages: string[];
+    codeVersion?: string;
+    supersedes?: string;
+    supersededBy?: string;
+    verification?: {
+        evidence: string;
+        scope?: string;
+        version?: string;
+    };
+}
+/**
+ * Wiki page content
+ */
+export interface WikiPage {
+    frontmatter: WikiPageFrontmatter;
+    body: string;
+    rawFrontmatter: string;
+}
+/**
+ * Immutable source snapshot (stored in raw/ directory)
+ */
+export interface SourceSnapshot {
+    id: string;
+    originalPath: string;
+    contentHash: string;
+    capturedAt: string;
+    content: string;
+    redacted: boolean;
+    operationId: string;
+}
+/**
+ * Convert SourceSnapshot to SourceRef for frontmatter
+ */
+export declare function toSourceRef(snap: SourceSnapshot): SourceRef;
+/**
+ * Wiki operation types
+ */
+export type WikiOperationType = "init" | "ingest" | "synthesize" | "apply" | "lint" | "verify";
+/**
+ * Operation status
+ */
+export type OperationStatus = "pending" | "success" | "failed" | "conflict";
+/**
+ * Operation log entry
+ */
+export interface WikiOperation {
+    id: string;
+    type: WikiOperationType;
+    status: OperationStatus;
+    startedAt: string;
+    completedAt?: string;
+    requestId?: string;
+    details: Record<string, unknown>;
+    error?: string;
+}
+/**
+ * Staged change for apply operation
+ */
+export interface StagedChange {
+    pageId: string;
+    expectedRevision: string;
+    newContent: string;
+    operationId: string;
+}
+/**
+ * Page index entry (lightweight, for search)
+ */
+export interface PageIndexEntry {
+    id: string;
+    title: string;
+    kind: PageKind;
+    status: PageStatus;
+    tags: string[];
+    summary: string;
+    updatedAt: string;
+    codeVersion?: string;
+}
+/**
+ * Search filters
+ */
+export interface WikiSearchFilters {
+    kinds?: PageKind[];
+    statuses?: PageStatus[];
+    tags?: string[];
+    sourceIds?: string[];
+    updatedAfter?: string;
+    updatedBefore?: string;
+}
+/**
+ * Search result
+ */
+export interface WikiSearchResult {
+    page: PageIndexEntry;
+    relevance: number;
+    matchedOn: ("title" | "body" | "tags" | "kind" | "source")[];
+    snippets: string[];
+}
+/**
+ * Lint finding severity
+ */
+export type LintSeverity = "error" | "warning" | "info";
+/**
+ * Lint finding category
+ */
+export type LintCategory = "structure" | "links" | "freshness" | "evidence" | "duplicates" | "semantic";
+/**
+ * Lint finding
+ */
+export interface LintFinding {
+    severity: LintSeverity;
+    category: LintCategory;
+    pageId?: string;
+    message: string;
+    location?: {
+        line?: number;
+        path?: string;
+    };
+    suggestion?: string;
+    modelAssisted?: boolean;
+}
+/**
+ * Wiki configuration
+ */
+export interface WikiConfig {
+    wikiRoot: string;
+    rawDir: string;
+    knowledgeDir: string;
+    harnessDir: string;
+    indexFile: string;
+    logFile: string;
+    schemaFile: string;
+    projectId: string;
+}
+/**
+ * Wiki initialization result
+ */
+export interface WikiInitResult {
+    created: boolean;
+    existing: boolean;
+    config: WikiConfig;
+}
+/**
+ * Default wiki directory names
+ */
+export declare const WIKI_DIRS: {
+    readonly RAW: "raw";
+    readonly KNOWLEDGE: "knowledge";
+    readonly HARNESS: ".harness";
+    readonly INDEX: "index.json";
+    readonly LOG: "log.jsonl";
+    readonly SCHEMA: "SCHEMA.md";
+    readonly INDEX_MD: "index.md";
+};
+//# sourceMappingURL=types.d.ts.map

package/packages/wiki/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/packages/wiki/dist/types.js

@@ -0,0 +1,30 @@
+/**
+ * Wiki Package Types
+ *
+ * Implements LLM Wiki integration per wiki/llm-wiki-integration-minimax-plan.md
+ */
+/**
+ * Convert SourceSnapshot to SourceRef for frontmatter
+ */
+export function toSourceRef(snap) {
+    return {
+        sourceId: snap.id,
+        path: snap.originalPath,
+        contentHash: snap.contentHash,
+        capturedAt: snap.capturedAt,
+        redacted: snap.redacted,
+    };
+}
+/**
+ * Default wiki directory names
+ */
+export const WIKI_DIRS = {
+    RAW: "raw",
+    KNOWLEDGE: "knowledge",
+    HARNESS: ".harness",
+    INDEX: "index.json",
+    LOG: "log.jsonl",
+    SCHEMA: "SCHEMA.md",
+    INDEX_MD: "index.md",
+};
+//# sourceMappingURL=types.js.map

package/packages/wiki/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuFH;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAoB;IAC9C,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,EAAE;QACjB,IAAI,EAAE,IAAI,CAAC,YAAY;QACvB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC;AACJ,CAAC;AAqJD;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,GAAG,EAAE,KAAK;IACV,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,UAAU;IACnB,KAAK,EAAE,YAAY;IACnB,GAAG,EAAE,WAAW;IAChB,MAAM,EAAE,WAAW;IACnB,QAAQ,EAAE,UAAU;CACZ,CAAC"}

package/packages/wiki/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@pi-harness/wiki",
+  "version": "1.1.326",
+  "description": "LLM Wiki integration for pi-harness-runtime",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test test/*.test.ts"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0"
+  }
+}