@aiassesstech/jessie 0.5.1 → 0.6.1

package/dist/ea/sweep-state.js

@@ -0,0 +1,145 @@
+/**
+ * EA Sweep State — Persistence & Deduplication
+ *
+ * SPEC: SPEC-jessie-executive-assistant-activation-v1.0 §3.1, IH2
+ *
+ * Tracks processed message IDs to prevent re-processing, triage
+ * statistics, Grillo assessment counts, and sweep metadata.
+ * Persists to .jessie-data/ea-sweep-state.json.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const DEFAULT_STATS = {
+    autoResolved: 0,
+    escalated: 0,
+    archived: 0,
+    tasksCreated: 0,
+    grilloAssessments: {
+        green: 0,
+        yellow: 0,
+        red: 0,
+        recuse: 0,
+        unavailable: 0,
+        degraded: false,
+        consecutiveTimeouts: 0,
+        lastAssessmentHash: '',
+        lastRubricVersion: '',
+    },
+};
+const MAX_MESSAGE_AGE_MS = 7 * 24 * 60 * 60 * 1000;
+export class EaSweepState {
+    data;
+    filePath;
+    constructor(dataDir) {
+        this.filePath = path.join(dataDir, 'ea-sweep-state.json');
+        this.data = this.load();
+    }
+    get state() {
+        return this.data;
+    }
+    isProcessed(messageId) {
+        return this.data.processedMessageIds.includes(messageId);
+    }
+    markProcessed(messageId) {
+        if (!this.data.processedMessageIds.includes(messageId)) {
+            this.data.processedMessageIds.push(messageId);
+        }
+    }
+    recordSweep(stats) {
+        this.data.lastSweepAt = new Date().toISOString();
+        if (stats.autoResolved)
+            this.data.triageStats.autoResolved += stats.autoResolved;
+        if (stats.escalated)
+            this.data.triageStats.escalated += stats.escalated;
+        if (stats.archived)
+            this.data.triageStats.archived += stats.archived;
+        if (stats.tasksCreated)
+            this.data.triageStats.tasksCreated += stats.tasksCreated;
+    }
+    recordGrilloAssessment(verdict, assessmentHash, rubricVersion) {
+        const ga = this.data.triageStats.grilloAssessments;
+        ga[verdict]++;
+        if (verdict === 'unavailable') {
+            ga.consecutiveTimeouts++;
+            if (ga.consecutiveTimeouts >= 2) {
+                ga.degraded = true;
+            }
+        }
+        else {
+            ga.consecutiveTimeouts = 0;
+            ga.degraded = false;
+        }
+        if (assessmentHash)
+            ga.lastAssessmentHash = assessmentHash;
+        if (rubricVersion)
+            ga.lastRubricVersion = rubricVersion;
+    }
+    setGogHealthy(healthy) {
+        this.data.gogHealthy = healthy;
+    }
+    setFleetDeferred(deferred, reason) {
+        this.data.fleetAttentionDeferred = deferred;
+        this.data.lastDeferralReason = reason;
+    }
+    isGrilloDegraded() {
+        return this.data.triageStats.grilloAssessments.degraded;
+    }
+    clearGrilloDegraded() {
+        this.data.triageStats.grilloAssessments.degraded = false;
+        this.data.triageStats.grilloAssessments.consecutiveTimeouts = 0;
+    }
+    pruneOldMessages() {
+        const cutoff = Date.now() - MAX_MESSAGE_AGE_MS;
+        const before = this.data.processedMessageIds.length;
+        this.data.processedMessageIds = this.data.processedMessageIds.filter((id) => {
+            const ts = parseInt(id.split('_').pop() ?? '0', 10);
+            return isNaN(ts) || ts > cutoff;
+        });
+        if (this.data.processedMessageIds.length < before) {
+            console.log(`[jessie:ea] Pruned ${before - this.data.processedMessageIds.length} old message IDs`);
+        }
+    }
+    save() {
+        const dir = path.dirname(this.filePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        const tmp = this.filePath + '.tmp';
+        fs.writeFileSync(tmp, JSON.stringify(this.data, null, 2), 'utf-8');
+        fs.renameSync(tmp, this.filePath);
+    }
+    load() {
+        try {
+            if (fs.existsSync(this.filePath)) {
+                const raw = fs.readFileSync(this.filePath, 'utf-8');
+                const parsed = JSON.parse(raw);
+                return {
+                    lastSweepAt: parsed.lastSweepAt ?? null,
+                    processedMessageIds: parsed.processedMessageIds ?? [],
+                    triageStats: {
+                        ...DEFAULT_STATS,
+                        ...(parsed.triageStats ?? {}),
+                        grilloAssessments: {
+                            ...DEFAULT_STATS.grilloAssessments,
+                            ...(parsed.triageStats?.grilloAssessments ?? {}),
+                        },
+                    },
+                    gogHealthy: parsed.gogHealthy ?? true,
+                    fleetAttentionDeferred: parsed.fleetAttentionDeferred ?? false,
+                    lastDeferralReason: parsed.lastDeferralReason,
+                };
+            }
+        }
+        catch {
+            console.warn('[jessie:ea] Failed to load sweep state, starting fresh');
+        }
+        return {
+            lastSweepAt: null,
+            processedMessageIds: [],
+            triageStats: { ...DEFAULT_STATS, grilloAssessments: { ...DEFAULT_STATS.grilloAssessments } },
+            gogHealthy: true,
+            fleetAttentionDeferred: false,
+        };
+    }
+}
+//# sourceMappingURL=sweep-state.js.map

package/dist/ea/sweep-state.js.map

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

package/dist/knowledge/knowledge-store.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Jessie Knowledge Store — Compounding Fleet Intelligence
+ *
+ * SPEC-fleet-knowledge-base-v1.2 §3.2.3:
+ * Manages wiki/ directory within Jessie's workspace. All articles have
+ * cryptographic provenance via SHA-256 hash chains. Write operations use
+ * atomic temp-file → rename pattern (IH1) to avoid hashless windows.
+ *
+ * Write operations are executed by Sam via the compilation pipeline.
+ * KnowledgeStore itself is the persistence layer — it does not call LLMs.
+ */
+import type { SourceReference } from './provenance.js';
+import type { WikiCategory } from '@aiassesstech/fleet-bus';
+export interface WikiArticle {
+    slug: string;
+    title: string;
+    category: WikiCategory;
+    lastUpdated: string;
+    tags: string[];
+    summary: string;
+    sources: SourceReference[];
+    contentHash: string;
+    compilationEvent: string;
+    derivedRatio: number;
+}
+export interface WikiIndex {
+    version: number;
+    lastCompiled: string;
+    lastHealthCheck: string | null;
+    articles: WikiArticle[];
+    totalArticles: number;
+}
+export declare class KnowledgeStore {
+    readonly wikiDir: string;
+    readonly outputsDir: string;
+    readonly archiveDir: string;
+    readonly baseDir: string;
+    private readonly indexPath;
+    private index;
+    constructor(workspaceDir: string);
+    initialize(): Promise<void>;
+    getIndex(): WikiIndex;
+    getArticle(slug: string): WikiArticle | null;
+    getArticleContent(slug: string): string | null;
+    getArticleContentHash(slug: string): string | null;
+    listArticles(): WikiArticle[];
+    writeArticle(slug: string, content: string, meta: Omit<WikiArticle, 'slug' | 'contentHash' | 'derivedRatio'>): WikiArticle;
+    saveOutput(filename: string, content: string, expiresInDays?: number): string;
+    getStaleArticlesByCategory(defaults: Record<string, number>, overrides?: Record<string, number>): WikiArticle[];
+    getHighDerivedArticles(threshold?: number): WikiArticle[];
+    archiveExpiredOutputs(): string[];
+    recordHealthCheck(): void;
+    writeProbeArticle(slug: string, content: string): void;
+    readProbeArticle(slug: string): string | null;
+    deleteProbeArticle(slug: string): boolean;
+    private resolveArticlePath;
+    private updateIndexEntry;
+    private createEmptyIndex;
+    private parseIndex;
+    private writeIndex;
+}
+//# sourceMappingURL=knowledge-store.d.ts.map

package/dist/knowledge/knowledge-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-store.d.ts","sourceRoot":"","sources":["../../src/knowledge/knowledge-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,KAAK,CAAY;gBAEb,YAAY,EAAE,MAAM;IAS1B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBjC,QAAQ,IAAI,SAAS;IAIrB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAI5C,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM9C,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAUlD,YAAY,IAAI,WAAW,EAAE;IAI7B,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,cAAc,CAAC,GAC/D,WAAW;IAqDd,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,SAAK,GAAG,MAAM;IAkBzE,0BAA0B,CACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACrC,WAAW,EAAE;IAUhB,sBAAsB,CAAC,SAAS,SAAM,GAAG,WAAW,EAAE;IAItD,qBAAqB,IAAI,MAAM,EAAE;IAkCjC,iBAAiB,IAAI,IAAI;IAKzB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAKtD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM7C,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOzC,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,UAAU;CA0BnB"}

package/dist/knowledge/knowledge-store.js

@@ -0,0 +1,248 @@
+/**
+ * Jessie Knowledge Store — Compounding Fleet Intelligence
+ *
+ * SPEC-fleet-knowledge-base-v1.2 §3.2.3:
+ * Manages wiki/ directory within Jessie's workspace. All articles have
+ * cryptographic provenance via SHA-256 hash chains. Write operations use
+ * atomic temp-file → rename pattern (IH1) to avoid hashless windows.
+ *
+ * Write operations are executed by Sam via the compilation pipeline.
+ * KnowledgeStore itself is the persistence layer — it does not call LLMs.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { computeContentHash } from './provenance.js';
+export class KnowledgeStore {
+    wikiDir;
+    outputsDir;
+    archiveDir;
+    baseDir;
+    indexPath;
+    index;
+    constructor(workspaceDir) {
+        this.baseDir = workspaceDir;
+        this.wikiDir = path.join(workspaceDir, 'wiki');
+        this.outputsDir = path.join(workspaceDir, 'outputs');
+        this.archiveDir = path.join(this.outputsDir, 'archive');
+        this.indexPath = path.join(this.wikiDir, 'INDEX.md');
+        this.index = this.createEmptyIndex();
+    }
+    async initialize() {
+        for (const dir of [
+            this.wikiDir,
+            this.outputsDir,
+            this.archiveDir,
+            path.join(this.wikiDir, '.probes'),
+        ]) {
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+        }
+        if (fs.existsSync(this.indexPath)) {
+            this.index = this.parseIndex();
+        }
+        else {
+            this.writeIndex();
+        }
+    }
+    getIndex() {
+        return this.index;
+    }
+    getArticle(slug) {
+        return this.index.articles.find(a => a.slug === slug) ?? null;
+    }
+    getArticleContent(slug) {
+        const articlePath = this.resolveArticlePath(slug);
+        if (!fs.existsSync(articlePath))
+            return null;
+        return fs.readFileSync(articlePath, 'utf-8');
+    }
+    getArticleContentHash(slug) {
+        const content = this.getArticleContent(slug);
+        if (!content)
+            return null;
+        // Strip the content_hash line before hashing — the hash was computed
+        // over the file content without this line (IH1: can't hash a string
+        // that contains its own hash).
+        const withoutHashLine = content.replace(/^content_hash:.*\n/m, '');
+        return computeContentHash(withoutHashLine);
+    }
+    listArticles() {
+        return this.index.articles.filter(a => !a.slug.startsWith('.probes/'));
+    }
+    writeArticle(slug, content, meta) {
+        const articlePath = this.resolveArticlePath(slug);
+        const dir = path.dirname(articlePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        const derivedCount = meta.sources.filter(s => s.type === 'derived').length;
+        const derivedRatio = meta.sources.length > 0
+            ? derivedCount / meta.sources.length
+            : 0;
+        const frontmatterFields = [
+            '---',
+            `title: "${meta.title}"`,
+            `slug: "${slug}"`,
+            `category: "${meta.category}"`,
+            `updated: "${meta.lastUpdated}"`,
+            `tags: [${meta.tags.map(t => `"${t}"`).join(', ')}]`,
+            'sources:',
+            ...meta.sources.map(s => `  - path: "${s.path}"\n    sha256: "${s.sha256}"\n    type: "${s.type}"`),
+            `compilation_event: "${meta.compilationEvent}"`,
+        ];
+        // IH1: Compute content_hash over the complete file content deterministically
+        // before the first write. Avoids the hashless-window race with Mark's
+        // wiki-integrity check by using atomic write (temp file + rename).
+        const bodyWithFrontmatterNoHash = [...frontmatterFields, '---', ''].join('\n') + content;
+        const contentHash = computeContentHash(bodyWithFrontmatterNoHash);
+        const fullContent = [
+            ...frontmatterFields,
+            `content_hash: "${contentHash}"`,
+            '---',
+            '',
+        ].join('\n') + content;
+        const tmpPath = articlePath + `.tmp.${Date.now()}`;
+        fs.writeFileSync(tmpPath, fullContent);
+        fs.renameSync(tmpPath, articlePath);
+        const article = {
+            slug,
+            ...meta,
+            contentHash,
+            derivedRatio,
+        };
+        this.updateIndexEntry(article);
+        return article;
+    }
+    saveOutput(filename, content, expiresInDays = 90) {
+        const outputPath = path.join(this.outputsDir, filename);
+        const expiresAt = new Date(Date.now() + expiresInDays * 24 * 60 * 60 * 1000).toISOString();
+        const frontmatter = [
+            '---',
+            `created: "${new Date().toISOString()}"`,
+            `expires_at: "${expiresAt}"`,
+            '---',
+            '',
+        ].join('\n');
+        fs.writeFileSync(outputPath, frontmatter + content);
+        return outputPath;
+    }
+    getStaleArticlesByCategory(defaults, overrides = {}) {
+        const thresholds = { ...defaults, ...overrides };
+        return this.index.articles.filter(a => {
+            const maxDays = thresholds[a.category] ?? 14;
+            const ageDays = (Date.now() - new Date(a.lastUpdated).getTime())
+                / (1000 * 60 * 60 * 24);
+            return ageDays > maxDays;
+        });
+    }
+    getHighDerivedArticles(threshold = 0.5) {
+        return this.index.articles.filter(a => a.derivedRatio > threshold);
+    }
+    archiveExpiredOutputs() {
+        const archived = [];
+        const now = Date.now();
+        let files;
+        try {
+            files = fs.readdirSync(this.outputsDir)
+                .filter(f => f.endsWith('.md') && f !== 'archive');
+        }
+        catch {
+            return archived;
+        }
+        for (const file of files) {
+            const filePath = path.join(this.outputsDir, file);
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const expiresMatch = content.match(/expires_at:\s*"(.+?)"/);
+            if (expiresMatch) {
+                const expiresAt = new Date(expiresMatch[1]).getTime();
+                if (expiresAt < now) {
+                    const monthDir = path.join(this.archiveDir, new Date().toISOString().slice(0, 7));
+                    if (!fs.existsSync(monthDir)) {
+                        fs.mkdirSync(monthDir, { recursive: true });
+                    }
+                    fs.renameSync(filePath, path.join(monthDir, file));
+                    archived.push(file);
+                }
+            }
+        }
+        return archived;
+    }
+    recordHealthCheck() {
+        this.index.lastHealthCheck = new Date().toISOString();
+        this.writeIndex();
+    }
+    writeProbeArticle(slug, content) {
+        const probePath = path.join(this.wikiDir, '.probes', `${slug}.md`);
+        fs.writeFileSync(probePath, content);
+    }
+    readProbeArticle(slug) {
+        const probePath = path.join(this.wikiDir, '.probes', `${slug}.md`);
+        if (!fs.existsSync(probePath))
+            return null;
+        return fs.readFileSync(probePath, 'utf-8');
+    }
+    deleteProbeArticle(slug) {
+        const probePath = path.join(this.wikiDir, '.probes', `${slug}.md`);
+        if (!fs.existsSync(probePath))
+            return false;
+        fs.unlinkSync(probePath);
+        return true;
+    }
+    resolveArticlePath(slug) {
+        return path.join(this.wikiDir, `${slug}.md`);
+    }
+    updateIndexEntry(article) {
+        const existing = this.index.articles.findIndex(a => a.slug === article.slug);
+        if (existing >= 0) {
+            this.index.articles[existing] = article;
+        }
+        else {
+            this.index.articles.push(article);
+        }
+        this.index.totalArticles = this.index.articles.length;
+        this.index.lastCompiled = new Date().toISOString();
+        this.writeIndex();
+    }
+    createEmptyIndex() {
+        return {
+            version: 1,
+            lastCompiled: new Date().toISOString(),
+            lastHealthCheck: null,
+            articles: [],
+            totalArticles: 0,
+        };
+    }
+    parseIndex() {
+        try {
+            const content = fs.readFileSync(this.indexPath, 'utf-8');
+            const jsonMatch = content.match(/```json\n([\s\S]*?)\n```/);
+            if (jsonMatch)
+                return JSON.parse(jsonMatch[1]);
+        }
+        catch { /* fall through */ }
+        return this.createEmptyIndex();
+    }
+    writeIndex() {
+        const visibleArticles = this.index.articles.filter(a => !a.slug.startsWith('.probes/'));
+        const content = [
+            '# Jessie Knowledge Base — Index',
+            '',
+            `Last compiled: ${this.index.lastCompiled}`,
+            `Last health check: ${this.index.lastHealthCheck ?? 'never'}`,
+            `Total articles: ${visibleArticles.length}`,
+            '',
+            '## Articles',
+            '',
+            ...visibleArticles.map(a => `- **[[${a.slug}]]** — ${a.summary} *(${a.category}, updated: ${a.lastUpdated})*`),
+            '',
+            '## Machine-Readable Index',
+            '',
+            '```json',
+            JSON.stringify(this.index, null, 2),
+            '```',
+        ].join('\n');
+        fs.writeFileSync(this.indexPath, content);
+    }
+}
+//# sourceMappingURL=knowledge-store.js.map

package/dist/knowledge/knowledge-store.js.map

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

package/dist/knowledge/provenance.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Cryptographic provenance utilities for the Fleet Knowledge Base.
+ *
+ * SPEC-fleet-knowledge-base-v1.2 §3.2.1:
+ * Every wiki article is anchored to its source material via SHA-256 hash chains.
+ * Sources are classified as raw (originating fleet signal) or derived (prior wiki).
+ */
+export interface SourceReference {
+    path: string;
+    sha256: string;
+    type: 'raw' | 'derived';
+}
+export declare function computeFileHash(filePath: string): string;
+export declare function computeContentHash(content: string): string;
+export declare function classifySource(sourcePath: string): 'raw' | 'derived';
+//# sourceMappingURL=provenance.d.ts.map

package/dist/knowledge/provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../../src/knowledge/provenance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC;CACzB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAKpE"}

package/dist/knowledge/provenance.js

@@ -0,0 +1,23 @@
+/**
+ * Cryptographic provenance utilities for the Fleet Knowledge Base.
+ *
+ * SPEC-fleet-knowledge-base-v1.2 §3.2.1:
+ * Every wiki article is anchored to its source material via SHA-256 hash chains.
+ * Sources are classified as raw (originating fleet signal) or derived (prior wiki).
+ */
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+export function computeFileHash(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return crypto.createHash('sha256').update(content).digest('hex');
+}
+export function computeContentHash(content) {
+    return crypto.createHash('sha256').update(content).digest('hex');
+}
+export function classifySource(sourcePath) {
+    if (sourcePath.startsWith('wiki/') || sourcePath.startsWith('intel/')) {
+        return 'derived';
+    }
+    return 'raw';
+}
+//# sourceMappingURL=provenance.js.map

package/dist/knowledge/provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.js","sourceRoot":"","sources":["../../src/knowledge/provenance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAQ9B,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,IAAI,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/knowledge/verify-provenance.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared provenance verification utility (IH3).
+ *
+ * Used by both Grillo's assessment tool and Mighty Mark's wiki-integrity
+ * check to ensure identical verification logic.
+ *
+ * SPEC-fleet-knowledge-base-v1.2 §3.7
+ */
+import type { KnowledgeStore } from './knowledge-store.js';
+export interface ProvenanceVerificationResult {
+    valid: boolean;
+    staleSources: string[];
+    missingSources: string[];
+    contentHashMatch: boolean;
+}
+export declare function verifyArticleProvenance(slug: string, store: KnowledgeStore): ProvenanceVerificationResult;
+//# sourceMappingURL=verify-provenance.d.ts.map

package/dist/knowledge/verify-provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-provenance.d.ts","sourceRoot":"","sources":["../../src/knowledge/verify-provenance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,sBAAsB,CAAC;AAExE,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,cAAc,GACpB,4BAA4B,CA8B9B"}

package/dist/knowledge/verify-provenance.js

@@ -0,0 +1,38 @@
+/**
+ * Shared provenance verification utility (IH3).
+ *
+ * Used by both Grillo's assessment tool and Mighty Mark's wiki-integrity
+ * check to ensure identical verification logic.
+ *
+ * SPEC-fleet-knowledge-base-v1.2 §3.7
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { computeFileHash } from './provenance.js';
+export function verifyArticleProvenance(slug, store) {
+    const article = store.getArticle(slug);
+    if (!article) {
+        return { valid: false, staleSources: [], missingSources: [slug], contentHashMatch: false };
+    }
+    const storedHash = article.contentHash;
+    const actualHash = store.getArticleContentHash(slug);
+    const contentHashMatch = storedHash === actualHash;
+    const staleSources = [];
+    const missingSources = [];
+    for (const source of article.sources) {
+        const sourcePath = path.resolve(store.baseDir, source.path);
+        if (!fs.existsSync(sourcePath)) {
+            missingSources.push(source.path);
+            continue;
+        }
+        const currentHash = computeFileHash(sourcePath);
+        if (currentHash !== source.sha256) {
+            staleSources.push(source.path);
+        }
+    }
+    const valid = contentHashMatch
+        && staleSources.length === 0
+        && missingSources.length === 0;
+    return { valid, staleSources, missingSources, contentHashMatch };
+}
+//# sourceMappingURL=verify-provenance.js.map

package/dist/knowledge/verify-provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-provenance.js","sourceRoot":"","sources":["../../src/knowledge/verify-provenance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,eAAe,EAAsB,MAAM,iBAAiB,CAAC;AAUtE,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,KAAqB;IAErB,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC;IAC7F,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IACvC,MAAM,UAAU,GAAG,KAAK,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,gBAAgB,GAAG,UAAU,KAAK,UAAU,CAAC;IAEnD,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,cAAc,GAAa,EAAE,CAAC;IAEpC,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACjC,SAAS;QACX,CAAC;QACD,MAAM,WAAW,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,WAAW,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,gBAAgB;WACzB,YAAY,CAAC,MAAM,KAAK,CAAC;WACzB,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC;IAEjC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC;AACnE,CAAC"}

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAgEH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,QA6lBxC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAoFH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,QAwxBxC"}