@pylabmit/agent-cmdb 1.5.0

package/dist/doctor.d.ts

@@ -0,0 +1,9 @@
+import type { ControlPlane, DoctorReport } from './types.js';
+export declare function runDoctor(options: {
+    controlPlane: ControlPlane;
+    storeDir: string;
+    brainDir?: string;
+    now?: string;
+}): Promise<DoctorReport>;
+export declare function formatDoctorReport(report: DoctorReport): string;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI7D,wBAAsB,SAAS,CAAC,OAAO,EAAE;IACvC,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,YAAY,CAAC,CAsCxB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAgB/D"}

package/dist/doctor.js

@@ -0,0 +1,170 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readdir, rm, writeFile } from 'node:fs/promises';
+import { join, relative, resolve } from 'node:path';
+import { readBrainIndex } from './brain.js';
+import { listChanges, listEvidence } from './store.js';
+import { validateControlPlane } from './validator.js';
+const staleThresholdMs = 604_800_000;
+export async function runDoctor(options) {
+    const checkedAt = options.now ?? new Date().toISOString();
+    const nowMs = parseTimestamp(checkedAt);
+    const issues = validateControlPlane(options.controlPlane);
+    const errors = [];
+    const warnings = [];
+    const store = await inspectStore(options.storeDir, errors);
+    const brain = options.brainDir
+        ? await inspectBrain(options.brainDir, nowMs, errors, warnings)
+        : {
+            configured: false,
+            indexReadable: false,
+            entityCount: 0,
+            staleEntityCount: 0,
+            orphanedFiles: []
+        };
+    const controlPlaneErrors = issues.filter((issue) => issue.severity === 'error').length;
+    const controlPlaneWarnings = issues.filter((issue) => issue.severity === 'warning').length;
+    if (controlPlaneErrors > 0) {
+        errors.push(`Control plane has ${controlPlaneErrors} validation error${controlPlaneErrors === 1 ? '' : 's'}.`);
+    }
+    if (controlPlaneWarnings > 0) {
+        warnings.push(`Control plane has ${controlPlaneWarnings} validation warning${controlPlaneWarnings === 1 ? '' : 's'}.`);
+    }
+    return {
+        ok: errors.length === 0 && warnings.length === 0,
+        checkedAt,
+        errors,
+        warnings,
+        controlPlane: {
+            errors: controlPlaneErrors,
+            warnings: controlPlaneWarnings
+        },
+        store,
+        brain
+    };
+}
+export function formatDoctorReport(report) {
+    const status = report.ok ? 'PASS' : 'ATTENTION';
+    return [
+        `Agent CMDB Doctor - ${status}`,
+        `Checked: ${report.checkedAt}`,
+        '',
+        `Control plane: ${report.controlPlane.errors} errors, ${report.controlPlane.warnings} warnings`,
+        `Store: writable=${report.store.writable}, evidence=${report.store.evidenceCount}, changes=${report.store.changesCount}`,
+        `Brain: configured=${report.brain.configured}, entities=${report.brain.entityCount}, stale=${report.brain.staleEntityCount}, orphaned=${report.brain.orphanedFiles.length}`,
+        '',
+        'Warnings:',
+        ...(report.warnings.length > 0 ? report.warnings.map((warning) => `- ${warning}`) : ['- None']),
+        '',
+        'Errors:',
+        ...(report.errors.length > 0 ? report.errors.map((error) => `- ${error}`) : ['- None'])
+    ].join('\n');
+}
+async function inspectStore(storeDir, errors) {
+    const writable = await checkWritableDirectory(storeDir);
+    if (!writable) {
+        errors.push(`Store directory is not writable: ${storeDir}.`);
+    }
+    try {
+        const evidence = await listEvidence(storeDir);
+        const changes = await listChanges(storeDir);
+        return {
+            writable,
+            evidenceCount: evidence.length,
+            changesCount: changes.length,
+            lastWriteAt: latestTimestamp([
+                ...evidence.map((record) => record.capturedAt),
+                ...changes.map((record) => record.changedAt)
+            ])
+        };
+    }
+    catch (error) {
+        errors.push(`Store health check failed: ${error instanceof Error ? error.message : String(error)}`);
+        return {
+            writable,
+            evidenceCount: 0,
+            changesCount: 0
+        };
+    }
+}
+async function inspectBrain(brainDir, nowMs, errors, warnings) {
+    try {
+        const index = await readBrainIndex(brainDir);
+        const staleEntityCount = index.entities.filter((entity) => {
+            const lastUpdated = Date.parse(entity.lastUpdated);
+            return Number.isNaN(lastUpdated) || nowMs - lastUpdated > staleThresholdMs;
+        }).length;
+        const indexedFiles = new Set(index.entities.map((entity) => entity.filePath));
+        const orphanedFiles = (await listMarkdownFiles(join(brainDir, 'entities')))
+            .filter((filePath) => !indexedFiles.has(filePath))
+            .sort();
+        if (staleEntityCount > 0) {
+            warnings.push(`Brain has ${staleEntityCount} stale ${staleEntityCount === 1 ? 'entity' : 'entities'}.`);
+        }
+        if (orphanedFiles.length > 0) {
+            warnings.push(`Brain has ${orphanedFiles.length} orphaned markdown ${orphanedFiles.length === 1 ? 'file' : 'files'}.`);
+        }
+        return {
+            configured: true,
+            indexReadable: true,
+            entityCount: index.entities.length,
+            staleEntityCount,
+            orphanedFiles
+        };
+    }
+    catch (error) {
+        errors.push(`Brain health check failed: ${error instanceof Error ? error.message : String(error)}`);
+        return {
+            configured: true,
+            indexReadable: false,
+            entityCount: 0,
+            staleEntityCount: 0,
+            orphanedFiles: []
+        };
+    }
+}
+async function checkWritableDirectory(dir) {
+    const probePath = join(dir, `.doctor-${process.pid}-${randomUUID()}.tmp`);
+    try {
+        await mkdir(dir, { recursive: true });
+        await writeFile(probePath, 'ok', { encoding: 'utf8', flag: 'wx' });
+        await rm(probePath, { force: true });
+        return true;
+    }
+    catch {
+        await rm(probePath, { force: true }).catch(() => undefined);
+        return false;
+    }
+}
+async function listMarkdownFiles(root) {
+    try {
+        const entries = await readdir(root, { withFileTypes: true });
+        const nested = await Promise.all(entries.map(async (entry) => {
+            const absolutePath = join(root, entry.name);
+            if (entry.isDirectory()) {
+                return listMarkdownFiles(absolutePath);
+            }
+            if (entry.isFile() && entry.name.endsWith('.md')) {
+                return [relative(resolve(root, '..', '..'), absolutePath).replaceAll('\\', '/')];
+            }
+            return [];
+        }));
+        return nested.flat();
+    }
+    catch (error) {
+        if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+}
+function latestTimestamp(values) {
+    return values.sort().at(-1);
+}
+function parseTimestamp(value) {
+    const timestamp = Date.parse(value);
+    if (Number.isNaN(timestamp)) {
+        throw new Error('Doctor now must be an ISO timestamp.');
+    }
+    return timestamp;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/duration.d.ts

@@ -0,0 +1,2 @@
+export declare function parseDuration(ttl: string): number;
+//# sourceMappingURL=duration.d.ts.map

package/dist/duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../src/duration.ts"],"names":[],"mappings":"AASA,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOjD"}

package/dist/duration.js

@@ -0,0 +1,15 @@
+const durationPattern = /^([1-9]\d*)([smhd])$/;
+const unitMs = {
+    s: 1_000,
+    m: 60_000,
+    h: 3_600_000,
+    d: 86_400_000
+};
+export function parseDuration(ttl) {
+    const match = durationPattern.exec(ttl);
+    if (!match) {
+        throw new Error('Duration must be a positive integer followed by s, m, h, or d.');
+    }
+    return Number(match[1]) * unitMs[match[2]];
+}
+//# sourceMappingURL=duration.js.map

package/dist/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../src/duration.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAE/C,MAAM,MAAM,GAA2B;IACrC,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,UAAU;CACd,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/engine.d.ts

@@ -0,0 +1,12 @@
+export { ControlPlaneLoadError, defaultControlPlanePath, loadControlPlane, loadDefaultControlPlane, multiAgentExampleControlPlanePath } from './loader.js';
+export { evaluatePolicy, policiesConflict, policyMatches, policyShadows } from './policy-engine.js';
+export { ensureProfile, ensureSource, inspectProfile, resolveSourceRoute } from './route-resolver.js';
+export { ensureGraphNode, resolveGraphNeighbors } from './graph-engine.js';
+export { preflightAction } from './preflight-action.js';
+export { generateReadinessReport, getObject, listObjects, validateControlPlane } from './validator.js';
+export * from './brain.js';
+export * from './digest.js';
+export * from './doctor.js';
+export * from './duration.js';
+export * from './freshness.js';
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,iCAAiC,EAClC,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,cAAc,EACd,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,uBAAuB,EACvB,SAAS,EACT,WAAW,EACX,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/engine.js

@@ -0,0 +1,12 @@
+export { ControlPlaneLoadError, defaultControlPlanePath, loadControlPlane, loadDefaultControlPlane, multiAgentExampleControlPlanePath } from './loader.js';
+export { evaluatePolicy, policiesConflict, policyMatches, policyShadows } from './policy-engine.js';
+export { ensureProfile, ensureSource, inspectProfile, resolveSourceRoute } from './route-resolver.js';
+export { ensureGraphNode, resolveGraphNeighbors } from './graph-engine.js';
+export { preflightAction } from './preflight-action.js';
+export { generateReadinessReport, getObject, listObjects, validateControlPlane } from './validator.js';
+export * from './brain.js';
+export * from './digest.js';
+export * from './doctor.js';
+export * from './duration.js';
+export * from './freshness.js';
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,iCAAiC,EAClC,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,cAAc,EACd,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,uBAAuB,EACvB,SAAS,EACT,WAAW,EACX,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/freshness.d.ts

@@ -0,0 +1,3 @@
+import type { ControlPlane, SourceFreshnessInput } from './types.js';
+export declare function sourceFreshnessFromBrain(controlPlane: ControlPlane, brainDir: string): Promise<SourceFreshnessInput[]>;
+//# sourceMappingURL=freshness.d.ts.map

package/dist/freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.d.ts","sourceRoot":"","sources":["../src/freshness.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAErE,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAgBjC"}

package/dist/freshness.js

@@ -0,0 +1,19 @@
+import { readBrainIndex } from './brain.js';
+export async function sourceFreshnessFromBrain(controlPlane, brainDir) {
+    const index = await readBrainIndex(brainDir);
+    return controlPlane.sources
+        .filter((source) => source.freshnessTtl)
+        .flatMap((source) => {
+        const entityId = source.brainEntityId ?? source.id;
+        const entity = index.entities.find((candidate) => candidate.id === entityId);
+        return entity
+            ? [
+                {
+                    sourceId: source.id,
+                    lastUpdated: entity.lastUpdated
+                }
+            ]
+            : [];
+    });
+}
+//# sourceMappingURL=freshness.js.map

package/dist/freshness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.js","sourceRoot":"","sources":["../src/freshness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,YAA0B,EAC1B,QAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC7C,OAAO,YAAY,CAAC,OAAO;SACxB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC;SACvC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QAClB,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;QAC7E,OAAO,MAAM;YACX,CAAC,CAAC;gBACE;oBACE,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACnB,WAAW,EAAE,MAAM,CAAC,WAAW;iBAChC;aACF;YACH,CAAC,CAAC,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/graph-engine.d.ts

@@ -0,0 +1,4 @@
+import type { AgentProfile, CmdbObject, ControlPlane, GraphResult, PolicyRule, SourceRef } from './types.js';
+export declare function resolveGraphNeighbors(controlPlane: ControlPlane, nodeId: string): GraphResult;
+export declare function ensureGraphNode(controlPlane: ControlPlane, nodeId: string): CmdbObject | SourceRef | AgentProfile | PolicyRule;
+//# sourceMappingURL=graph-engine.d.ts.map

package/dist/graph-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-engine.d.ts","sourceRoot":"","sources":["../src/graph-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE7G,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAc7F;AAED,wBAAgB,eAAe,CAAC,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,UAAU,CAc9H"}

package/dist/graph-engine.js

@@ -0,0 +1,36 @@
+export function resolveGraphNeighbors(controlPlane, nodeId) {
+    const normalizedNodeId = requireNonEmptyString(nodeId, 'Graph node id');
+    const node = ensureGraphNode(controlPlane, normalizedNodeId);
+    const neighbors = controlPlane.relationships
+        .filter((relationship) => relationship.from === normalizedNodeId || relationship.to === normalizedNodeId)
+        .map((relationship) => {
+        const otherId = relationship.from === normalizedNodeId ? relationship.to : relationship.from;
+        return {
+            relationship,
+            node: ensureGraphNode(controlPlane, otherId)
+        };
+    });
+    return { node, neighbors };
+}
+export function ensureGraphNode(controlPlane, nodeId) {
+    const object = controlPlane.objects.find((candidate) => candidate.id === nodeId);
+    if (object)
+        return object;
+    const source = controlPlane.sources.find((candidate) => candidate.id === nodeId || `source.${candidate.id}` === nodeId);
+    if (source)
+        return source;
+    const profile = controlPlane.profiles.find((candidate) => candidate.id === nodeId || `profile.${candidate.id}` === nodeId);
+    if (profile)
+        return profile;
+    const policy = controlPlane.policies.find((candidate) => candidate.id === nodeId || `policy.${candidate.id}` === nodeId);
+    if (policy)
+        return policy;
+    throw new Error(`Unknown graph node: ${nodeId}.`);
+}
+function requireNonEmptyString(value, label) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new Error(`${label} must be a non-empty string.`);
+    }
+    return value;
+}
+//# sourceMappingURL=graph-engine.js.map

package/dist/graph-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-engine.js","sourceRoot":"","sources":["../src/graph-engine.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,YAA0B,EAAE,MAAc;IAC9E,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,eAAe,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,YAAY,CAAC,aAAa;SACzC,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,KAAK,gBAAgB,IAAI,YAAY,CAAC,EAAE,KAAK,gBAAgB,CAAC;SACxG,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE;QACpB,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC;QAC7F,OAAO;YACL,YAAY;YACZ,IAAI,EAAE,eAAe,CAAC,YAAY,EAAE,OAAO,CAAC;SAC7C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,YAA0B,EAAE,MAAc;IACxE,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACjF,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,MAAM,IAAI,UAAU,SAAS,CAAC,EAAE,EAAE,KAAK,MAAM,CAAC,CAAC;IACxH,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,MAAM,IAAI,WAAW,SAAS,CAAC,EAAE,EAAE,KAAK,MAAM,CAAC,CAAC;IAC3H,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,MAAM,IAAI,UAAU,SAAS,CAAC,EAAE,EAAE,KAAK,MAAM,CAAC,CAAC;IACzH,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,GAAG,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc,EAAE,KAAa;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,8BAA8B,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/interface.d.ts

@@ -0,0 +1,34 @@
+import type { AgentCmdbReport, BrainEntity, BrainEntityKind, BrainReadResult, BrainSearchQuery, BrainWriteInput, ChangeInput, ChangeQuery, ChangeRecord, ControlPlane, DigestResult, EvidenceInput, EvidenceQuery, EvidenceRecord, PreflightRequest, PreflightResult, ResolvedSourceRoute, SourceRouteRequest, ValidationIssue } from './types.js';
+export interface AgentCmdbHealth {
+    ok: boolean;
+    errors: number;
+    warnings: number;
+    issues: ValidationIssue[];
+}
+export interface IAgentCMDB {
+    preflight(request: PreflightRequest): PreflightResult;
+    resolveRoute(request: SourceRouteRequest): ResolvedSourceRoute;
+    logEvidence(input: EvidenceInput): Promise<EvidenceRecord>;
+    listEvidence(query?: EvidenceQuery): Promise<EvidenceRecord[]>;
+    logChange(input: ChangeInput): Promise<ChangeRecord>;
+    listChanges(query?: ChangeQuery): Promise<ChangeRecord[]>;
+    validate(): ValidationIssue[];
+    report(): AgentCmdbReport;
+    health(): AgentCmdbHealth;
+    readEntity(entityId: string): Promise<BrainReadResult>;
+    writeEntity(input: BrainWriteInput): Promise<BrainEntity>;
+    createEntity(entity: Omit<BrainEntity, 'lastUpdated' | 'lastUpdatedBy'>, content: string, actor: string): Promise<BrainEntity>;
+    deleteEntity(entityId: string, actor: string, reason: string): Promise<void>;
+    searchEntities(query: BrainSearchQuery): Promise<BrainEntity[]>;
+    listEntities(kind?: BrainEntityKind): Promise<BrainEntity[]>;
+    generateDailyDigest(profile: string, date?: string): Promise<DigestResult>;
+    generateWeeklyDigest(profile: string, weekStart?: string): Promise<DigestResult>;
+}
+export interface AgentCmdbOptions {
+    configPath?: string;
+    controlPlane?: ControlPlane;
+    storeDir?: string;
+    brainDir?: string;
+}
+export declare function createAgentCmdb(options?: AgentCmdbOptions): IAgentCMDB;
+//# sourceMappingURL=interface.d.ts.map

package/dist/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAAC;IACtD,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,mBAAmB,CAAC;IAC/D,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3D,YAAY,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC/D,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACrD,WAAW,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC1D,QAAQ,IAAI,eAAe,EAAE,CAAC;IAC9B,MAAM,IAAI,eAAe,CAAC;IAC1B,MAAM,IAAI,eAAe,CAAC;IAC1B,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACvD,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D,YAAY,CACV,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,eAAe,CAAC,EAC1D,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAChE,YAAY,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7D,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3E,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,UAAU,CAiF1E"}

package/dist/interface.js

@@ -0,0 +1,91 @@
+import { createEntity, deleteEntity, initBrainDir, listEntities, readEntity, searchEntities, writeEntity } from './brain.js';
+import { generateDailyDigest, generateWeeklyDigest } from './digest.js';
+import { generateReadinessReport, validateControlPlane } from './validator.js';
+import { loadDefaultControlPlane, loadControlPlane } from './loader.js';
+import { preflightAction } from './preflight-action.js';
+import { resolveSourceRoute } from './route-resolver.js';
+import { appendChange, appendEvidence, listChanges, listEvidence } from './store.js';
+export function createAgentCmdb(options = {}) {
+    const controlPlane = options.controlPlane ?? (options.configPath ? loadControlPlane(options.configPath) : loadDefaultControlPlane());
+    const storeDir = options.storeDir ?? process.env.AGENT_CMDB_STORE_DIR ?? 'agent-cmdb/state';
+    const brainDir = options.brainDir;
+    return {
+        preflight(request) {
+            return preflightAction(controlPlane, request);
+        },
+        resolveRoute(request) {
+            return resolveSourceRoute(controlPlane, request);
+        },
+        logEvidence(input) {
+            return appendEvidence(storeDir, input);
+        },
+        listEvidence(query = {}) {
+            return listEvidence(storeDir, query);
+        },
+        logChange(input) {
+            return appendChange(storeDir, input);
+        },
+        listChanges(query = {}) {
+            return listChanges(storeDir, query);
+        },
+        validate() {
+            return validateControlPlane(controlPlane);
+        },
+        report() {
+            return generateReadinessReport(controlPlane);
+        },
+        health() {
+            const issues = validateControlPlane(controlPlane);
+            const errors = issues.filter((issue) => issue.severity === 'error').length;
+            const warnings = issues.filter((issue) => issue.severity === 'warning').length;
+            return {
+                ok: errors === 0,
+                errors,
+                warnings,
+                issues
+            };
+        },
+        async readEntity(entityId) {
+            return readEntity(await requireBrainDir(brainDir), entityId);
+        },
+        async writeEntity(input) {
+            return writeEntity(await requireBrainDir(brainDir), storeDir, input);
+        },
+        async createEntity(entity, content, actor) {
+            return createEntity(await requireBrainDir(brainDir), storeDir, entity, content, actor);
+        },
+        async deleteEntity(entityId, actor, reason) {
+            return deleteEntity(await requireBrainDir(brainDir), storeDir, entityId, actor, reason);
+        },
+        async searchEntities(query) {
+            return searchEntities(await requireBrainDir(brainDir), query);
+        },
+        async listEntities(kind) {
+            return listEntities(await requireBrainDir(brainDir), kind);
+        },
+        async generateDailyDigest(profile, date) {
+            return generateDailyDigest({
+                profile,
+                date,
+                storeDir,
+                brainDir: await requireBrainDir(brainDir)
+            });
+        },
+        async generateWeeklyDigest(profile, weekStart) {
+            return generateWeeklyDigest({
+                profile,
+                weekStart,
+                storeDir,
+                brainDir: await requireBrainDir(brainDir)
+            });
+        }
+    };
+}
+async function requireBrainDir(brainDir) {
+    if (!brainDir) {
+        throw new Error('Brain not configured. Pass brainDir to createAgentCmdb.');
+    }
+    await initBrainDir(brainDir);
+    return brainDir;
+}
+//# sourceMappingURL=interface.js.map

package/dist/interface.js.map

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

package/dist/loader.d.ts

@@ -0,0 +1,9 @@
+import type { ControlPlane } from './types.js';
+export declare const defaultControlPlanePath: string;
+export declare const multiAgentExampleControlPlanePath: string;
+export declare class ControlPlaneLoadError extends Error {
+    constructor(message: string);
+}
+export declare function loadControlPlane(filePath: string): ControlPlane;
+export declare function loadDefaultControlPlane(): ControlPlane;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,YAAY,EAKb,MAAM,YAAY,CAAC;AAIpB,eAAO,MAAM,uBAAuB,QAAsE,CAAC;AAC3G,eAAO,MAAM,iCAAiC,QAM7C,CAAC;AAEF,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAY/D;AAED,wBAAgB,uBAAuB,IAAI,YAAY,CAEtD"}