@unson/brainbase-mcp 0.5.0 → 0.7.0

package/dist/decision-adapter.d.ts

@@ -0,0 +1,145 @@
+import { JudgmentDAGProblemSnapshotReference, JudgmentDAGVersionReference } from './judgment-dag-composition.js';
+import type { CanonicalEntity, DecisionRecord, PersonalOs } from './types.js';
+import type { FoundationRevision } from './ontology-foundation.js';
+/** Public version of the adapter contract. It is independent from the old organization route. */
+export declare const DECISION_ADAPTER_VERSION: "decision-adapter.v1";
+/** The sidecar contains references and compatibility metadata, never canonical definitions. */
+export declare const DECISION_ADAPTER_SIDECAR: "evidence/decision-adapter.json";
+export type DecisionAdapterAction = 'create' | 'read';
+export interface DecisionAdapterContext {
+    /** Identity resolved by a trusted host boundary; it is never taken from a request body. */
+    readonly principal: string;
+}
+export interface DecisionAdapterObjectiveReference extends FoundationRevision {
+    readonly type: 'objective';
+}
+/**
+ * Conditions required for a newly recorded Decision. All three references are
+ * immutable locators; the adapter does not copy their definitions.
+ */
+export interface DecisionAdapterConditions {
+    readonly problem_snapshot: JudgmentDAGProblemSnapshotReference;
+    readonly method: JudgmentDAGVersionReference;
+    readonly objective_refs: readonly DecisionAdapterObjectiveReference[];
+}
+export interface DecisionAdapterDecisionRequest {
+    readonly decision_id?: string;
+    readonly title: string;
+    readonly decision: string;
+    readonly topic?: string;
+    readonly rationale?: string;
+    readonly effectiveAt?: string;
+    readonly tags?: readonly string[];
+    readonly conditions: DecisionAdapterConditions;
+}
+export interface DecisionAdapterAiDecisionLogRequest {
+    /** Canonical Decision ID to which this AI log is attached. */
+    readonly decision_id?: string;
+    /** Compatibility alias used by some legacy callers. */
+    readonly related_decision_id?: string;
+    readonly summary: string;
+    readonly decision_type?: string;
+    readonly rationale?: string;
+    readonly confidence?: number;
+    readonly related_entity_id?: string;
+    readonly references?: readonly string[];
+    readonly conditions: DecisionAdapterConditions;
+}
+/** Required old response keys. Additional organization guard fields are intentionally not synthesized. */
+export interface DecisionAdapterLegacyDecisionResponse {
+    readonly decision_id: string;
+    readonly event_id: string;
+}
+export interface DecisionAdapterLegacyAiDecisionResponse {
+    readonly ai_decision_id: string;
+    readonly event_id: string;
+}
+export interface DecisionAdapterAiLogRecord {
+    readonly ai_decision_id: string;
+    readonly event_id: string;
+    readonly summary: string;
+    readonly decision_type?: string;
+    readonly rationale?: string;
+    readonly confidence?: number;
+    readonly related_entity_id?: string;
+    readonly references?: readonly string[];
+    readonly conditions: DecisionAdapterConditions;
+    readonly created_at: string;
+}
+export interface DecisionAdapterReadResult {
+    readonly decision: DecisionRecord;
+    /** Missing for a legacy record that predates a canonical Graph entity. */
+    readonly graph_entity?: CanonicalEntity;
+    readonly condition_status: 'recorded' | 'unrecorded';
+    readonly conditions?: DecisionAdapterConditions;
+    /** This adapter never infers authority from a Decision or its conditions. */
+    readonly authority_status: 'unrecorded';
+    readonly ai_logs: readonly DecisionAdapterAiLogRecord[];
+}
+export interface DecisionAdapterConditionValidator {
+    /**
+     * Resolve exact Problem/Objective references against the current trusted
+     * ACL and canonical store. Returning false is a fail-closed denial.
+     */
+    validate(input: {
+        readonly conditions: DecisionAdapterConditions;
+        readonly context: DecisionAdapterContext;
+    }): void | boolean | Promise<void | boolean>;
+}
+export interface DecisionAdapterAuthorizationRequest {
+    readonly action: DecisionAdapterAction;
+    readonly context: DecisionAdapterContext;
+    readonly current: PersonalOs;
+    readonly decision?: DecisionRecord;
+    readonly graph_entity?: CanonicalEntity;
+}
+export interface DecisionAdapterAuthorizationPolicy {
+    authorize(input: DecisionAdapterAuthorizationRequest): void | boolean | Promise<void | boolean>;
+}
+export interface DecisionAdapterStoreOptions {
+    readonly dataDir: string;
+    readonly sidecarPath?: string;
+    /** Trusted reference provider. The store only validates shape when omitted. */
+    readonly conditionValidator?: DecisionAdapterConditionValidator;
+    /** Organization-specific policy is injected here; no tenant/RACI is in OSS. */
+    readonly authorization?: DecisionAdapterAuthorizationPolicy;
+}
+export interface DecisionAdapterStore {
+    createDecision(input: DecisionAdapterDecisionRequest, context: DecisionAdapterContext): Promise<DecisionAdapterLegacyDecisionResponse>;
+    createAiDecisionLog(input: DecisionAdapterAiDecisionLogRequest, context: DecisionAdapterContext): Promise<DecisionAdapterLegacyAiDecisionResponse>;
+    readDecision(input: {
+        readonly decision_id: string;
+    }, context: DecisionAdapterContext): Promise<DecisionAdapterReadResult>;
+}
+/** The public port is deliberately the same small surface as the store. */
+export interface DecisionAdapterPort extends DecisionAdapterStore {
+}
+export type DecisionAdapterErrorCode = 'validation_error' | 'authorization_denied' | 'condition_unavailable' | 'decision_conflict' | 'decision_not_found' | 'graph_unsupported' | 'store_corrupt' | 'readback_mismatch';
+export declare class DecisionAdapterError extends Error {
+    readonly code: DecisionAdapterErrorCode;
+    constructor(code: DecisionAdapterErrorCode, message: string);
+}
+/**
+ * Personal canonical implementation. It never creates a second Decision
+ * store: `decisions.jsonl` and the Graph entity remain the canonical records.
+ */
+export declare class GraphDecisionAdapterStore implements DecisionAdapterPort {
+    private readonly dataDir;
+    private readonly sidecarPath;
+    private readonly conditionValidator?;
+    private readonly authorization?;
+    constructor(options: DecisionAdapterStoreOptions);
+    createDecision(input: DecisionAdapterDecisionRequest, context: DecisionAdapterContext): Promise<DecisionAdapterLegacyDecisionResponse>;
+    createAiDecisionLog(input: DecisionAdapterAiDecisionLogRequest, context: DecisionAdapterContext): Promise<DecisionAdapterLegacyAiDecisionResponse>;
+    readDecision(input: {
+        readonly decision_id: string;
+    }, context: DecisionAdapterContext): Promise<DecisionAdapterReadResult>;
+    private mutateSidecar;
+    private loadCurrent;
+    private loadSnapshot;
+    private validateConditions;
+    private authorize;
+}
+export declare function createDecisionAdapter(options: DecisionAdapterStoreOptions): DecisionAdapterPort;
+export declare const createGraphDecisionAdapter: typeof createDecisionAdapter;
+export declare function validateDecisionAdapterConditions(value: DecisionAdapterConditions): void;