@codeledger/engine 0.7.2 → 0.7.5

package/dist/broker/completion.d.ts

@@ -0,0 +1,9 @@
+import type { CodeLedgerMemory, BrokerCompletionResponse } from '@codeledger/types';
+/**
+ * Get completion state from the most recent CIC result, if available.
+ *
+ * Reads from `.codeledger/complete-check-result.json` if it exists.
+ * This is a thin adapter — as CIC evolves, this can be enriched.
+ */
+export declare function getCompletionState(_memory: CodeLedgerMemory, cwd: string, taskId?: string): BrokerCompletionResponse;
+//# sourceMappingURL=completion.d.ts.map

package/dist/broker/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/broker/completion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAI3B;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,GACd,wBAAwB,CA4C1B"}

package/dist/broker/completion.js

@@ -0,0 +1,51 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Get completion state from the most recent CIC result, if available.
+ *
+ * Reads from `.codeledger/complete-check-result.json` if it exists.
+ * This is a thin adapter — as CIC evolves, this can be enriched.
+ */
+export function getCompletionState(_memory, cwd, taskId) {
+    const resultPath = join(cwd, '.codeledger', 'complete-check-result.json');
+    if (!existsSync(resultPath)) {
+        return {
+            taskId,
+            completionState: 'unknown',
+            summary: 'No completion check result found. Run `codeledger complete-check --task "..."` to generate one.',
+        };
+    }
+    try {
+        const raw = JSON.parse(readFileSync(resultPath, 'utf-8'));
+        if (typeof raw !== 'object' || raw === null) {
+            return {
+                taskId,
+                completionState: 'unknown',
+                summary: 'Completion check result is not a valid object.',
+            };
+        }
+        const result = raw;
+        return {
+            taskId: taskId ?? (typeof result['task'] === 'string' ? result['task'] : undefined),
+            completionState: typeof result['state'] === 'string' ? result['state'] : 'unknown',
+            verifiedClaims: Array.isArray(result['verifiedClaims'])
+                ? result['verifiedClaims']
+                : undefined,
+            remainingUnchecked: Array.isArray(result['remainingUnchecked'])
+                ? result['remainingUnchecked']
+                : undefined,
+            blockers: Array.isArray(result['blockers'])
+                ? result['blockers']
+                : undefined,
+            summary: typeof result['summary'] === 'string' ? result['summary'] : undefined,
+        };
+    }
+    catch {
+        return {
+            taskId,
+            completionState: 'error',
+            summary: 'Failed to parse completion check result.',
+        };
+    }
+}
+//# sourceMappingURL=completion.js.map

package/dist/broker/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../src/broker/completion.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAyB,EACzB,GAAW,EACX,MAAe;IAEf,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,4BAA4B,CAAC,CAAC;IAE1E,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,MAAM;YACN,eAAe,EAAE,SAAS;YAC1B,OAAO,EAAE,iGAAiG;SAC3G,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QACnE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC5C,OAAO;gBACL,MAAM;gBACN,eAAe,EAAE,SAAS;gBAC1B,OAAO,EAAE,gDAAgD;aAC1D,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,GAA8B,CAAC;QAE9C,OAAO;YACL,MAAM,EAAE,MAAM,IAAI,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACnF,eAAe,EAAE,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;YAClF,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;gBACrD,CAAC,CAAE,MAAM,CAAC,gBAAgB,CAAc;gBACxC,CAAC,CAAC,SAAS;YACb,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;gBAC7D,CAAC,CAAE,MAAM,CAAC,oBAAoB,CAAc;gBAC5C,CAAC,CAAC,SAAS;YACb,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBACzC,CAAC,CAAE,MAAM,CAAC,UAAU,CAAc;gBAClC,CAAC,CAAC,SAAS;YACb,OAAO,EAAE,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;SAC/E,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,MAAM;YACN,eAAe,EAAE,OAAO;YACxB,OAAO,EAAE,0CAA0C;SACpD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/broker/evidence.d.ts

@@ -0,0 +1,11 @@
+import type { CodeLedgerMemory, BrokerEvidenceResponse } from '@codeledger/types';
+/**
+ * Get evidence requirements for a given finding type and optional target.
+ * The target is used to substitute {target} placeholders in commands.
+ */
+export declare function getEvidenceRequirements(memory: CodeLedgerMemory, findingType: string, target?: string): BrokerEvidenceResponse;
+/**
+ * Get only the executable commands for a finding type, ready to run.
+ */
+export declare function getEvidenceCommands(memory: CodeLedgerMemory, findingType: string, target?: string): string[];
+//# sourceMappingURL=evidence.d.ts.map

package/dist/broker/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../src/broker/evidence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAE3B;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,sBAAsB,CAyBxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,EAAE,CAOV"}

package/dist/broker/evidence.js

@@ -0,0 +1,39 @@
+/**
+ * Get evidence requirements for a given finding type and optional target.
+ * The target is used to substitute {target} placeholders in commands.
+ */
+export function getEvidenceRequirements(memory, findingType, target) {
+    const rule = memory.evidence.rules.find((r) => r.findingType === findingType);
+    if (!rule) {
+        return {
+            findingType,
+            requiredChecks: [],
+            minimumTier: undefined,
+            reviewerVisibleFromTier: undefined,
+        };
+    }
+    const checks = rule.requiredChecks.map((c) => ({
+        id: c.id,
+        description: c.description,
+        type: c.type,
+        command: target && c.command ? c.command.replace(/\{target\}/g, target) : c.command,
+    }));
+    return {
+        findingType: rule.findingType,
+        requiredChecks: checks,
+        minimumTier: rule.minimumTier,
+        reviewerVisibleFromTier: rule.reviewerVisibleFromTier,
+    };
+}
+/**
+ * Get only the executable commands for a finding type, ready to run.
+ */
+export function getEvidenceCommands(memory, findingType, target) {
+    const rule = memory.evidence.rules.find((r) => r.findingType === findingType);
+    if (!rule)
+        return [];
+    return rule.requiredChecks
+        .filter((c) => c.command)
+        .map((c) => target ? c.command.replace(/\{target\}/g, target) : c.command);
+}
+//# sourceMappingURL=evidence.js.map

package/dist/broker/evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.js","sourceRoot":"","sources":["../../src/broker/evidence.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAwB,EACxB,WAAmB,EACnB,MAAe;IAEf,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;IAE9E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,WAAW;YACX,cAAc,EAAE,EAAE;YAClB,WAAW,EAAE,SAAS;YACtB,uBAAuB,EAAE,SAAS;SACnC,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7C,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO;KACpF,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,cAAc,EAAE,MAAM;QACtB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;KACtD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAwB,EACxB,WAAmB,EACnB,MAAe;IAEf,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;IAC9E,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,OAAO,IAAI,CAAC,cAAc;SACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAQ,CAAC,CAAC;AACjF,CAAC"}

package/dist/broker/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Context Broker — the system-awareness layer for CodeLedger.
+ *
+ * Gives browser-based and tool-based agents CLI-grade grounded context
+ * by synthesizing ledger state into compact, decision-grade responses.
+ */
+export { resolveTaskContext } from './task-resolution.js';
+export { getValidationStatus, getCleanSurfacesList, getInvalidationState } from './validation.js';
+export { getNeighborhood, getNeighborhoodManifest } from './structural.js';
+export { getEvidenceRequirements, getEvidenceCommands } from './evidence.js';
+export { getCompletionState } from './completion.js';
+export { buildBrokerPreamble } from './preamble.js';
+export { getRecentTruthSummary, getOntologyConcept, getAgentPreamble } from './memory-lookup.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/broker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/broker/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/broker/index.js

@@ -0,0 +1,14 @@
+/**
+ * Context Broker — the system-awareness layer for CodeLedger.
+ *
+ * Gives browser-based and tool-based agents CLI-grade grounded context
+ * by synthesizing ledger state into compact, decision-grade responses.
+ */
+export { resolveTaskContext } from './task-resolution.js';
+export { getValidationStatus, getCleanSurfacesList, getInvalidationState } from './validation.js';
+export { getNeighborhood, getNeighborhoodManifest } from './structural.js';
+export { getEvidenceRequirements, getEvidenceCommands } from './evidence.js';
+export { getCompletionState } from './completion.js';
+export { buildBrokerPreamble } from './preamble.js';
+export { getRecentTruthSummary, getOntologyConcept, getAgentPreamble } from './memory-lookup.js';
+//# sourceMappingURL=index.js.map

package/dist/broker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/broker/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/broker/memory-lookup.d.ts

@@ -0,0 +1,41 @@
+import type { CodeLedgerMemory } from '@codeledger/types';
+import { type BrokerPreambleOptions } from './preamble.js';
+/**
+ * Get a compact summary of recent truth from the ledger.
+ */
+export declare function getRecentTruthSummary(memory: CodeLedgerMemory, query?: string): {
+    acceptedChanges: Array<{
+        id: string;
+        title: string;
+        status: string;
+        summary: string;
+    }>;
+    features: Array<{
+        name: string;
+        maturity: string;
+        concepts: string[];
+    }>;
+    architectureDecisions: Array<{
+        title: string;
+        decision: string;
+    }>;
+};
+/**
+ * Look up a concept by term, returning structured ontology data.
+ */
+export declare function getOntologyConcept(memory: CodeLedgerMemory, term: string): {
+    found: boolean;
+    displayName?: string;
+    description?: string;
+    meanings?: Array<{
+        label: string;
+        description: string;
+    }>;
+    fileHints?: string[];
+    disambiguationPrompt?: string;
+};
+/**
+ * Generate a task-aware agent preamble. Convenience wrapper.
+ */
+export declare function getAgentPreamble(memory: CodeLedgerMemory, taskText: string, options?: BrokerPreambleOptions): string;
+//# sourceMappingURL=memory-lookup.d.ts.map

package/dist/broker/memory-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-lookup.d.ts","sourceRoot":"","sources":["../../src/broker/memory-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEhF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,KAAK,CAAC,EAAE,MAAM,GACb;IACD,eAAe,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvF,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACxE,qBAAqB,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE,CA2CA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,GACX;IACD,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAyBA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,CAER"}

package/dist/broker/memory-lookup.js

@@ -0,0 +1,70 @@
+import { buildBrokerPreamble } from './preamble.js';
+/**
+ * Get a compact summary of recent truth from the ledger.
+ */
+export function getRecentTruthSummary(memory, query) {
+    let changes = memory.recentTruth.acceptedChanges;
+    let features = memory.recentTruth.recentFeatures;
+    let adrs = memory.recentTruth.architectureDecisions;
+    // If query provided, filter to items whose concepts/title/summary match
+    if (query) {
+        const q = query.toLowerCase();
+        changes = changes.filter((c) => c.title.toLowerCase().includes(q) ||
+            c.summary.toLowerCase().includes(q) ||
+            c.concepts.some((cc) => cc.toLowerCase().includes(q)));
+        features = features.filter((f) => f.name.toLowerCase().includes(q) ||
+            f.concepts.some((cc) => cc.toLowerCase().includes(q)));
+        adrs = adrs.filter((a) => a.title.toLowerCase().includes(q) ||
+            a.decision.toLowerCase().includes(q));
+    }
+    return {
+        acceptedChanges: changes.map((c) => ({
+            id: c.id,
+            title: c.title,
+            status: c.status,
+            summary: c.summary,
+        })),
+        features: features.map((f) => ({
+            name: f.name,
+            maturity: f.maturity,
+            concepts: f.concepts,
+        })),
+        architectureDecisions: adrs.map((a) => ({
+            title: a.title,
+            decision: a.decision,
+        })),
+    };
+}
+/**
+ * Look up a concept by term, returning structured ontology data.
+ */
+export function getOntologyConcept(memory, term) {
+    const normalized = term.toLowerCase().trim();
+    // Try alias first
+    const alias = memory.ontology.aliases.find((a) => a.term.toLowerCase() === normalized);
+    const conceptId = alias?.conceptId;
+    const concept = conceptId
+        ? memory.ontology.concepts.find((c) => c.id === conceptId)
+        : memory.ontology.concepts.find((c) => c.displayName.toLowerCase() === normalized);
+    if (!concept) {
+        return { found: false };
+    }
+    return {
+        found: true,
+        displayName: concept.displayName,
+        description: concept.description,
+        meanings: concept.meanings.map((m) => ({
+            label: m.label,
+            description: m.description,
+        })),
+        fileHints: concept.fileHints,
+        disambiguationPrompt: concept.disambiguationPrompt,
+    };
+}
+/**
+ * Generate a task-aware agent preamble. Convenience wrapper.
+ */
+export function getAgentPreamble(memory, taskText, options) {
+    return buildBrokerPreamble(memory, taskText, options);
+}
+//# sourceMappingURL=memory-lookup.js.map

package/dist/broker/memory-lookup.js.map

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

package/dist/broker/preamble.d.ts

@@ -0,0 +1,19 @@
+import type { CodeLedgerMemory } from '@codeledger/types';
+export interface BrokerPreambleOptions {
+    maxRecentTruth?: number;
+    maxSafeZones?: number;
+    maxFileHints?: number;
+    maxFeatures?: number;
+    maxADRs?: number;
+    maxNeighborhoods?: number;
+    anchorIds?: string[];
+}
+/**
+ * Generate a compact, decision-grade preamble suitable for injection
+ * into a browser/web/IDE agent's context window.
+ *
+ * This is the single-call convenience function for agents that just
+ * need a preamble string without parsing the full structured response.
+ */
+export declare function buildBrokerPreamble(memory: CodeLedgerMemory, taskText: string, options?: BrokerPreambleOptions): string;
+//# sourceMappingURL=preamble.d.ts.map

package/dist/broker/preamble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preamble.d.ts","sourceRoot":"","sources":["../../src/broker/preamble.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAGR"}

package/dist/broker/preamble.js

@@ -0,0 +1,13 @@
+import { resolveTaskContext } from './task-resolution.js';
+/**
+ * Generate a compact, decision-grade preamble suitable for injection
+ * into a browser/web/IDE agent's context window.
+ *
+ * This is the single-call convenience function for agents that just
+ * need a preamble string without parsing the full structured response.
+ */
+export function buildBrokerPreamble(memory, taskText, options = {}) {
+    const response = resolveTaskContext(memory, taskText, options);
+    return response.preamble;
+}
+//# sourceMappingURL=preamble.js.map

package/dist/broker/preamble.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preamble.js","sourceRoot":"","sources":["../../src/broker/preamble.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAY1D;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAwB,EACxB,QAAgB,EAChB,UAAiC,EAAE;IAEnC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/D,OAAO,QAAQ,CAAC,QAAQ,CAAC;AAC3B,CAAC"}

package/dist/broker/structural.d.ts

@@ -0,0 +1,10 @@
+import type { CodeLedgerMemory, BrokerNeighborhoodResponse } from '@codeledger/types';
+/**
+ * Look up the wiring neighborhood for a given target anchor.
+ */
+export declare function getNeighborhood(memory: CodeLedgerMemory, target: string): BrokerNeighborhoodResponse;
+/**
+ * Build a compact manifest for a target's neighborhood.
+ */
+export declare function getNeighborhoodManifest(memory: CodeLedgerMemory, target: string): BrokerNeighborhoodResponse;
+//# sourceMappingURL=structural.d.ts.map

package/dist/broker/structural.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural.d.ts","sourceRoot":"","sources":["../../src/broker/structural.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,0BAA0B,EAC3B,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,GACb,0BAA0B,CAoB5B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,GACb,0BAA0B,CAE5B"}

package/dist/broker/structural.js

@@ -0,0 +1,52 @@
+/**
+ * Look up the wiring neighborhood for a given target anchor.
+ */
+export function getNeighborhood(memory, target) {
+    const neighborhood = memory.structure.neighborhoods.find((n) => n.anchor.id === target);
+    if (!neighborhood) {
+        // Try fuzzy match: check if target appears in any anchor ID
+        const fuzzy = memory.structure.neighborhoods.find((n) => n.anchor.id.includes(target) || target.includes(n.anchor.id));
+        if (!fuzzy) {
+            return {
+                target,
+                upstream: [],
+                downstream: [],
+                summary: `No neighborhood found for '${target}'.`,
+            };
+        }
+        return buildResponse(target, fuzzy);
+    }
+    return buildResponse(target, neighborhood);
+}
+/**
+ * Build a compact manifest for a target's neighborhood.
+ */
+export function getNeighborhoodManifest(memory, target) {
+    return getNeighborhood(memory, target);
+}
+function buildResponse(target, neighborhood) {
+    const parts = [`${neighborhood.anchor.type} '${neighborhood.anchor.id}'`];
+    if (neighborhood.upstream.length > 0) {
+        parts.push(`receives from: ${neighborhood.upstream.join(', ')}`);
+    }
+    if (neighborhood.downstream.length > 0) {
+        parts.push(`feeds into: ${neighborhood.downstream.join(', ')}`);
+    }
+    if (neighborhood.immutableWires && neighborhood.immutableWires.length > 0) {
+        parts.push(`immutable wires: ${neighborhood.immutableWires.join(', ')}`);
+    }
+    if (neighborhood.trustReason) {
+        parts.push(`trust: ${neighborhood.trustLevel} — ${neighborhood.trustReason}`);
+    }
+    return {
+        target,
+        upstream: neighborhood.upstream,
+        downstream: neighborhood.downstream,
+        immutableWires: neighborhood.immutableWires,
+        relatedContracts: neighborhood.sharedContracts,
+        relatedTests: neighborhood.relatedTests,
+        trustLevel: neighborhood.trustLevel,
+        summary: parts.join('; '),
+    };
+}
+//# sourceMappingURL=structural.js.map

package/dist/broker/structural.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural.js","sourceRoot":"","sources":["../../src/broker/structural.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAwB,EACxB,MAAc;IAEd,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAExF,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,4DAA4D;QAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAC/C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CACpE,CAAC;QACF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;gBACL,MAAM;gBACN,QAAQ,EAAE,EAAE;gBACZ,UAAU,EAAE,EAAE;gBACd,OAAO,EAAE,8BAA8B,MAAM,IAAI;aAClD,CAAC;QACJ,CAAC;QACD,OAAO,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAwB,EACxB,MAAc;IAEd,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,aAAa,CACpB,MAAc,EACd,YAAoE;IAEpE,MAAM,KAAK,GAAa,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;IAEpF,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,kBAAkB,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,YAAY,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,eAAe,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,YAAY,CAAC,cAAc,IAAI,YAAY,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,oBAAoB,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,UAAU,YAAY,CAAC,UAAU,MAAM,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,OAAO;QACL,MAAM;QACN,QAAQ,EAAE,YAAY,CAAC,QAAQ;QAC/B,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,cAAc,EAAE,YAAY,CAAC,cAAc;QAC3C,gBAAgB,EAAE,YAAY,CAAC,eAAe;QAC9C,YAAY,EAAE,YAAY,CAAC,YAAY;QACvC,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;KAC1B,CAAC;AACJ,CAAC"}

package/dist/broker/task-resolution.d.ts

@@ -0,0 +1,17 @@
+import type { CodeLedgerMemory, BrokerTaskContextResponse } from '@codeledger/types';
+export interface TaskResolutionOptions {
+    maxRecentTruth?: number;
+    maxSafeZones?: number;
+    maxFileHints?: number;
+    maxFeatures?: number;
+    maxADRs?: number;
+    maxNeighborhoods?: number;
+    anchorIds?: string[];
+}
+/**
+ * Resolve a task description into structured context from all ledgers.
+ *
+ * This is the primary broker entry point for task resolution.
+ */
+export declare function resolveTaskContext(memory: CodeLedgerMemory, taskText: string, options?: TaskResolutionOptions): BrokerTaskContextResponse;
+//# sourceMappingURL=task-resolution.d.ts.map

package/dist/broker/task-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-resolution.d.ts","sourceRoot":"","sources":["../../src/broker/task-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,yBAAyB,EAS1B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAuKD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,qBAA0B,GAClC,yBAAyB,CAgG3B"}