@theihtisham/agent-shadow-brain 7.1.0 → 7.1.4

package/dist/brain/project-feedback.js

@@ -0,0 +1,289 @@
+import * as fs from 'node:fs';
+import { matchesFileIdentity } from './file-identity.js';
+import { randomUUID } from 'node:crypto';
+import { GlobalBrain } from './global-brain.js';
+import { adaptiveQueryKeywords } from './context-retrieval.js';
+import { requireMemoryIdentifier } from './memory-inspection.js';
+import { ensureProjectDirectory, projectLocalPath, projectRoot, readProjectFile } from './project-kit-paths.js';
+export class ProjectFeedbackError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'ProjectFeedbackError';
+    }
+}
+const FILENAME = '.shadow-brain/memory-feedback.json';
+const LOCKFILE = '.shadow-brain/memory-feedback.lock';
+const MAX_RECORDS = 500;
+const MAX_BYTES = 2 * 1024 * 1024;
+const MAX_TASK = 1000;
+const MAX_REASON = 600;
+const MAX_EVIDENCE = 3;
+const MAX_EVIDENCE_CHARS = 180;
+const RATINGS = { useful: 0.08, 'not-useful': -0.04, incorrect: -0.12 };
+const GENERIC_TASK_TERMS = new Set([
+    'add', 'analyze', 'build', 'check', 'debug', 'edit', 'explain', 'find', 'fix', 'implement', 'inspect',
+    'investigate', 'look', 'make', 'modify', 'please', 'repair', 'research', 'review', 'show', 'test', 'trace',
+    'understand', 'update', 'verify', 'work',
+]);
+function isReporter(value) {
+    return value === 'user' || value === 'agent';
+}
+function rating(value) {
+    return typeof value === 'string' && Object.hasOwn(RATINGS, value);
+}
+function text(value, max, label) {
+    if (typeof value !== 'string' || value.length > max || /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/u.test(value)) {
+        throw new TypeError(label + ' must be nonempty text of at most ' + max + ' characters.');
+    }
+    const normalized = value.replace(/\s+/gu, ' ').trim();
+    if (!normalized)
+        throw new TypeError(label + ' must be nonempty text.');
+    return normalized;
+}
+function references(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || value.length > MAX_EVIDENCE)
+        throw new TypeError('Provide up to three evidence references.');
+    return [...new Set(value.map(item => text(item, MAX_EVIDENCE_CHARS, 'Evidence reference')))];
+}
+function normalizedTask(task) {
+    return task.normalize('NFKC').replace(/\s+/gu, ' ').trim().toLowerCase();
+}
+function recordKey(memoryId, task, reporter) {
+    return JSON.stringify([memoryId, normalizedTask(task), reporter]);
+}
+function isDate(value) {
+    return typeof value === 'string' && Number.isFinite(Date.parse(value)) && new Date(value).toISOString() === value;
+}
+function object(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new TypeError('Feedback must be an object.');
+    return value;
+}
+function fields(value, allowed) {
+    if (Object.keys(value).some(key => !allowed.includes(key)))
+        throw new TypeError('Unknown feedback field.');
+}
+function parseRecord(input, projectId) {
+    const entry = object(input);
+    fields(entry, ['id', 'projectId', 'memoryId', 'task', 'rating', 'reason', 'evidence', 'reporter', 'createdAt', 'updatedAt']);
+    requireMemoryIdentifier(entry.id, 'feedback id');
+    requireMemoryIdentifier(entry.memoryId, 'memoryId');
+    if (entry.projectId !== projectId || !rating(entry.rating) || !isReporter(entry.reporter) ||
+        !isDate(entry.createdAt) || !isDate(entry.updatedAt) || entry.createdAt > entry.updatedAt || !Array.isArray(entry.evidence)) {
+        throw new TypeError('Invalid project feedback record.');
+    }
+    return {
+        id: entry.id, projectId, memoryId: entry.memoryId, task: text(entry.task, MAX_TASK, 'Task'), rating: entry.rating,
+        reason: text(entry.reason, MAX_REASON, 'Reason'), evidence: references(entry.evidence), reporter: entry.reporter,
+        createdAt: entry.createdAt, updatedAt: entry.updatedAt,
+    };
+}
+function parseSnapshot(bytes, projectId) {
+    const snapshot = object(JSON.parse(bytes.toString('utf8')));
+    fields(snapshot, ['schemaVersion', 'revision', 'updatedAt', 'enabled', 'records']);
+    if (snapshot.schemaVersion !== 1 || typeof snapshot.revision !== 'number' || !Number.isSafeInteger(snapshot.revision) ||
+        snapshot.revision < 1 || !isDate(snapshot.updatedAt) || typeof snapshot.enabled !== 'boolean' ||
+        !Array.isArray(snapshot.records) || snapshot.records.length > MAX_RECORDS)
+        throw new TypeError('Invalid project feedback snapshot.');
+    const records = snapshot.records.map(record => parseRecord(record, projectId));
+    const ids = new Set(records.map(record => record.id));
+    const keys = new Set(records.map(record => recordKey(record.memoryId, record.task, record.reporter)));
+    if (ids.size !== records.length || keys.size !== records.length || records.some(record => record.updatedAt > snapshot.updatedAt)) {
+        throw new TypeError('Invalid project feedback record sequence.');
+    }
+    return { schemaVersion: 1, revision: snapshot.revision, updatedAt: snapshot.updatedAt, enabled: snapshot.enabled, records };
+}
+function parseCommand(input, reporter) {
+    const command = object(input);
+    if (!isReporter(reporter))
+        throw new TypeError('Feedback reporter must be assigned by the caller.');
+    if (command.kind === 'upsert') {
+        fields(command, ['kind', 'memoryId', 'task', 'rating', 'reason', 'evidence']);
+        requireMemoryIdentifier(command.memoryId, 'memoryId');
+        if (!rating(command.rating))
+            throw new TypeError('Choose useful, not-useful, or incorrect.');
+        return { kind: 'upsert', memoryId: command.memoryId, task: text(command.task, MAX_TASK, 'Task'),
+            rating: command.rating, reason: text(command.reason, MAX_REASON, 'Reason'), evidence: references(command.evidence) };
+    }
+    if (reporter !== 'user')
+        throw new TypeError('Agent feedback can only add or update an observed outcome.');
+    if (command.kind === 'remove') {
+        fields(command, ['kind', 'id']);
+        requireMemoryIdentifier(command.id, 'feedback id');
+        return { kind: 'remove', id: command.id };
+    }
+    if (command.kind === 'toggle') {
+        fields(command, ['kind', 'enabled']);
+        if (typeof command.enabled !== 'boolean')
+            throw new TypeError('Feedback enabled must be a boolean.');
+        return { kind: 'toggle', enabled: command.enabled };
+    }
+    throw new TypeError('Unknown feedback operation.');
+}
+/** Small, project-local sidecar for reported memory outcomes. */
+export class ProjectFeedbackStore {
+    constructor(root, brain) {
+        this.brain = brain;
+        this.root = projectRoot(root);
+        this.projectId = GlobalBrain.projectIdFor(this.root);
+        this.filePath = projectLocalPath(this.root, FILENAME);
+    }
+    get() {
+        try {
+            const bytes = readProjectFile(this.root, FILENAME, MAX_BYTES);
+            return bytes ? parseSnapshot(bytes, this.projectId) : { schemaVersion: 1, revision: 0, updatedAt: null, enabled: true, records: [] };
+        }
+        catch {
+            throw new ProjectFeedbackError('PROJECT_FEEDBACK_INVALID_STORE', 'Project feedback must be a regular, bounded schema-1 file for this project.');
+        }
+    }
+    checkRevision(snapshot, expected) {
+        if (snapshot.revision !== expected)
+            throw new ProjectFeedbackError('PROJECT_FEEDBACK_CONFLICT', 'Project feedback changed. Refresh and retry.');
+        if (snapshot.revision === Number.MAX_SAFE_INTEGER)
+            throw new ProjectFeedbackError('PROJECT_FEEDBACK_INVALID_STORE', 'Feedback revision reached its limit.');
+    }
+    checkMemory(command) {
+        if (command.kind === 'upsert' && this.brain.getEntry(command.memoryId)?.projectId !== this.projectId) {
+            throw new ProjectFeedbackError('PROJECT_FEEDBACK_NOT_FOUND', 'Memory was not found in the selected project.');
+        }
+    }
+    async update(command, expectedRevision, reporter) {
+        const input = parseCommand(command, reporter);
+        if (!Number.isSafeInteger(expectedRevision) || expectedRevision < 0)
+            throw new TypeError('A current feedback revision is required.');
+        this.checkMemory(input);
+        this.checkRevision(this.get(), expectedRevision);
+        ensureProjectDirectory(this.root, '.shadow-brain');
+        const lock = projectLocalPath(this.root, LOCKFILE);
+        let fd;
+        try {
+            fd = fs.openSync(lock, 'wx', 0o600);
+        }
+        catch (error) {
+            if (error.code === 'EEXIST')
+                throw new ProjectFeedbackError('PROJECT_FEEDBACK_CONFLICT', 'A project feedback write is in progress.');
+            throw new ProjectFeedbackError('PROJECT_FEEDBACK_WRITE_FAILED', 'Could not acquire the project feedback lock.');
+        }
+        const owner = fs.fstatSync(fd, { bigint: true });
+        try {
+            const snapshot = this.get();
+            this.checkRevision(snapshot, expectedRevision);
+            this.checkMemory(input);
+            if (input.kind === 'toggle' && snapshot.enabled === input.enabled)
+                return snapshot;
+            const now = new Date().toISOString();
+            const at = snapshot.updatedAt && snapshot.updatedAt > now ? snapshot.updatedAt : now;
+            if (input.kind === 'toggle')
+                snapshot.enabled = input.enabled;
+            else if (input.kind === 'remove') {
+                const index = snapshot.records.findIndex(record => record.id === input.id);
+                if (index < 0)
+                    throw new ProjectFeedbackError('PROJECT_FEEDBACK_NOT_FOUND', 'Feedback record was not found in the selected project.');
+                snapshot.records.splice(index, 1);
+            }
+            else {
+                const { memoryId, task, rating: outcome, reason, evidence = [] } = input;
+                const key = recordKey(memoryId, task, reporter);
+                const index = snapshot.records.findIndex(record => recordKey(record.memoryId, record.task, record.reporter) === key);
+                if (index < 0 && snapshot.records.length >= MAX_RECORDS) {
+                    throw new ProjectFeedbackError('PROJECT_FEEDBACK_CONFLICT', 'Feedback has reached 500 records. Remove a record before adding another task outcome.');
+                }
+                const previous = index < 0 ? undefined : snapshot.records.splice(index, 1)[0];
+                snapshot.records.push({ id: previous?.id ?? randomUUID(), projectId: this.projectId, memoryId, task, rating: outcome, reason, evidence,
+                    reporter, createdAt: previous?.createdAt ?? at, updatedAt: at });
+            }
+            snapshot.updatedAt = at;
+            snapshot.revision++;
+            this.replace(snapshot);
+            return snapshot;
+        }
+        finally {
+            fs.closeSync(fd);
+            const current = fs.lstatSync(lock, { throwIfNoEntry: false, bigint: true });
+            if (matchesFileIdentity(lock, owner, current))
+                fs.unlinkSync(lock);
+        }
+    }
+    replace(snapshot) {
+        const payload = JSON.stringify(snapshot) + '\n';
+        if (Buffer.byteLength(payload) > MAX_BYTES)
+            throw new ProjectFeedbackError('PROJECT_FEEDBACK_WRITE_FAILED', 'Project feedback exceeds its file limit.');
+        const filename = projectLocalPath(this.root, FILENAME);
+        const temporary = filename + '.' + randomUUID() + '.tmp';
+        let created = false;
+        try {
+            const fd = fs.openSync(temporary, 'wx', 0o600);
+            created = true;
+            try {
+                fs.writeFileSync(fd, payload);
+                fs.fsyncSync(fd);
+            }
+            finally {
+                fs.closeSync(fd);
+            }
+            projectLocalPath(this.root, FILENAME);
+            if (snapshot.revision === 1)
+                fs.linkSync(temporary, filename);
+            else
+                fs.renameSync(temporary, filename);
+        }
+        catch {
+            throw new ProjectFeedbackError('PROJECT_FEEDBACK_WRITE_FAILED', 'Could not save project feedback.');
+        }
+        finally {
+            if (created) {
+                try {
+                    fs.unlinkSync(temporary);
+                }
+                catch (error) {
+                    if (error.code !== 'ENOENT')
+                        throw error;
+                }
+            }
+        }
+    }
+}
+function substantiveTerms(terms) {
+    return new Set(terms.filter(term => !GENERIC_TASK_TERMS.has(term)));
+}
+function similarity(left, right) {
+    const overlap = [...left].filter(term => right.has(term)).length;
+    return overlap / (left.size + right.size - overlap);
+}
+/** Compute task-local signals. Retrieval applies them only to already matched, eligible candidates. */
+export function projectFeedbackInfluence(snapshot, projectId, queryTerms) {
+    const influences = new Map();
+    const query = substantiveTerms(queryTerms);
+    if (snapshot?.enabled !== true || !query.size)
+        return influences;
+    const eligible = new Map();
+    const recent = [...snapshot.records].reverse().sort((a, b) => b.updatedAt.localeCompare(a.updatedAt))
+        .filter(record => record.projectId === projectId && rating(record.rating) && isReporter(record.reporter));
+    const userReports = new Map(recent.filter(record => record.reporter === 'user')
+        .map(record => [JSON.stringify([record.memoryId, normalizedTask(record.task)]), record]));
+    for (const record of recent) {
+        const group = eligible.get(record.memoryId) ?? [];
+        if (group.length >= 3)
+            continue;
+        const task = normalizedTask(record.task);
+        if (group.some(item => item.task === task))
+            continue;
+        const match = similarity(query, substantiveTerms(adaptiveQueryKeywords(record.task)));
+        if (match < 0.34)
+            continue;
+        const userReport = userReports.get(JSON.stringify([record.memoryId, task]));
+        group.push({ task, record: userReport ?? record, similarity: match });
+        eligible.set(record.memoryId, group);
+    }
+    for (const [memoryId, group] of eligible) {
+        const mean = group.reduce((sum, item) => sum + RATINGS[item.record.rating] * item.similarity * (item.record.reporter === 'agent' ? 0.5 : 1), 0) / group.length;
+        influences.set(memoryId, { adjustment: Math.round(Math.max(-0.12, Math.min(0.08, mean)) * 1000) / 1000,
+            recordIds: group.map(item => item.record.id), reporterKinds: [...new Set(group.map(item => item.record.reporter))] });
+    }
+    return influences;
+}
+//# sourceMappingURL=project-feedback.js.map

package/dist/brain/project-feedback.js.map

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

package/dist/brain/project-hub-contract.d.ts

@@ -0,0 +1,326 @@
+import { z } from 'zod';
+export declare const HUB_LIMITS: Readonly<{
+    pdfBytes: number;
+    pages: 60;
+    pageChars: 8000;
+    extractedChars: 180000;
+    extractionMs: 20000;
+    documents: 30;
+    rooms: 100;
+    roomRecords: 500;
+    lessons: 200;
+    operations: 20000;
+    artifactBytes: number;
+    leaseMs: number;
+}>;
+export declare class ProjectHubError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(code: string, message: string, status: number);
+}
+export declare const hubId: z.ZodString;
+export declare const hubActor: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        agent: "agent";
+        user: "user";
+    }>;
+}, z.core.$strict>;
+export type HubActor = z.infer<typeof hubActor>;
+export declare const HUB_OPERATOR: Readonly<{
+    readonly id: "Operator";
+    readonly kind: "user";
+}>;
+export declare const reviewInput: z.ZodObject<{
+    page: z.ZodNumber;
+    decision: z.ZodEnum<{
+        approve: "approve";
+        reject: "reject";
+    }>;
+    key: z.ZodString;
+}, z.core.$strict>;
+export declare const roomInput: z.ZodObject<{
+    goal: z.ZodString;
+    key: z.ZodString;
+}, z.core.$strict>;
+declare const messageType: z.ZodEnum<{
+    decision: "decision";
+    answer: "answer";
+    status: "status";
+    idea: "idea";
+    proposal: "proposal";
+    critique: "critique";
+    question: "question";
+    handoff: "handoff";
+}>;
+declare const targetType: z.ZodEnum<{
+    artifact: "artifact";
+    message: "message";
+}>;
+declare const result: z.ZodEnum<{
+    partial: "partial";
+    pass: "pass";
+    fail: "fail";
+}>;
+export declare const agentRoomActionInput: z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<"task">;
+    title: z.ZodString;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"claim">;
+    taskId: z.ZodString;
+    revision: z.ZodNumber;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"renew">;
+    taskId: z.ZodString;
+    revision: z.ZodNumber;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"release">;
+    taskId: z.ZodString;
+    revision: z.ZodNumber;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"message">;
+    type: z.ZodEnum<{
+        decision: "decision";
+        answer: "answer";
+        status: "status";
+        idea: "idea";
+        proposal: "proposal";
+        critique: "critique";
+        question: "question";
+        handoff: "handoff";
+    }>;
+    text: z.ZodString;
+    replyTo: z.ZodOptional<z.ZodString>;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"artifact">;
+    taskId: z.ZodString;
+    revision: z.ZodNumber;
+    path: z.ZodString;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"ack">;
+    targetType: z.ZodEnum<{
+        artifact: "artifact";
+        message: "message";
+    }>;
+    targetId: z.ZodString;
+    sha256: z.ZodOptional<z.ZodString>;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"outcome">;
+    taskId: z.ZodString;
+    artifactId: z.ZodOptional<z.ZodString>;
+    result: z.ZodEnum<{
+        partial: "partial";
+        pass: "pass";
+        fail: "fail";
+    }>;
+    check: z.ZodString;
+    evidence: z.ZodString;
+    key: z.ZodString;
+}, z.core.$strict>], "kind">;
+export declare const roomActionInput: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"task">;
+    title: z.ZodString;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"claim">;
+    taskId: z.ZodString;
+    revision: z.ZodNumber;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"renew">;
+    taskId: z.ZodString;
+    revision: z.ZodNumber;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"release">;
+    taskId: z.ZodString;
+    revision: z.ZodNumber;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"message">;
+    type: z.ZodEnum<{
+        decision: "decision";
+        answer: "answer";
+        status: "status";
+        idea: "idea";
+        proposal: "proposal";
+        critique: "critique";
+        question: "question";
+        handoff: "handoff";
+    }>;
+    text: z.ZodString;
+    replyTo: z.ZodOptional<z.ZodString>;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"artifact">;
+    taskId: z.ZodString;
+    revision: z.ZodNumber;
+    path: z.ZodString;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"ack">;
+    targetType: z.ZodEnum<{
+        artifact: "artifact";
+        message: "message";
+    }>;
+    targetId: z.ZodString;
+    sha256: z.ZodOptional<z.ZodString>;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"outcome">;
+    taskId: z.ZodString;
+    artifactId: z.ZodOptional<z.ZodString>;
+    result: z.ZodEnum<{
+        partial: "partial";
+        pass: "pass";
+        fail: "fail";
+    }>;
+    check: z.ZodString;
+    evidence: z.ZodString;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"accept">;
+    artifactId: z.ZodString;
+    key: z.ZodString;
+}, z.core.$strict>], "kind">;
+export declare const lessonInput: z.ZodObject<{
+    outcomeId: z.ZodString;
+    title: z.ZodString;
+    text: z.ZodString;
+    key: z.ZodString;
+}, z.core.$strict>;
+export declare const lessonActionInput: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"evaluate">;
+    baseline: z.ZodBoolean;
+    candidate: z.ZodBoolean;
+    control: z.ZodBoolean;
+    evidence: z.ZodString;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"promote">;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"rollback">;
+    key: z.ZodString;
+}, z.core.$strict>], "kind">;
+export declare function hubInput<T>(schema: z.ZodType<T>, raw: unknown): T;
+export interface HubDocument {
+    id: string;
+    name: string;
+    sha256: string;
+    status: 'ready' | 'needs-ocr' | 'failed' | 'extracting';
+    pageCount: number;
+    parser: string;
+    error: string | null;
+    bytes: number;
+    createdAt: string;
+    attempts: number;
+    failures: Array<{
+        error: string;
+        at: string;
+    }>;
+}
+export interface HubPage {
+    page: number;
+    text: string;
+    status: 'pending' | 'needs-ocr' | 'approved' | 'rejected';
+    memoryId: string | null;
+    citation: string;
+    truncated: boolean;
+}
+export interface HubRoom {
+    id: string;
+    goal: string;
+    createdAt: string;
+    createdBy: HubActor;
+}
+export interface HubTask {
+    id: string;
+    roomId: string;
+    title: string;
+    status: 'open' | 'claimed' | 'completed';
+    revision: number;
+    owner: HubActor | null;
+    leaseUntil: string | null;
+    artifactId: string | null;
+}
+export interface HubMessage {
+    id: string;
+    roomId: string;
+    type: z.infer<typeof messageType>;
+    text: string;
+    replyTo: string | null;
+    author: HubActor;
+    createdAt: string;
+}
+export interface HubArtifact {
+    id: string;
+    roomId: string;
+    taskId: string;
+    path: string;
+    sha256: string;
+    bytes: number;
+    version: number;
+    status: 'submitted' | 'accepted' | 'proposal';
+    author: HubActor;
+    createdAt: string;
+}
+export interface HubOutcome {
+    id: string;
+    roomId: string;
+    taskId: string;
+    artifactId: string | null;
+    result: z.infer<typeof result>;
+    check: string;
+    evidence: string;
+    provenance: 'user-report' | 'agent-report';
+    author: HubActor;
+    createdAt: string;
+}
+export interface HubAck {
+    id: string;
+    roomId: string;
+    targetType: z.infer<typeof targetType>;
+    targetId: string;
+    sha256: string | null;
+    author: HubActor;
+    createdAt: string;
+}
+export interface HubEvaluation {
+    baseline: boolean;
+    candidate: boolean;
+    control: boolean;
+    evidence: string;
+    provenance: 'user-report';
+    method: 'operator-reported-comparison';
+    createdAt: string;
+}
+export interface HubLesson {
+    id: string;
+    outcomeId: string;
+    title: string;
+    text: string;
+    status: 'candidate' | 'evaluated' | 'promoted' | 'rolled-back';
+    evaluation: HubEvaluation | null;
+    memoryId: string | null;
+    createdAt: string;
+    author: HubActor;
+}
+export interface HubEvent {
+    id: string;
+    cursor: number;
+    roomId: string;
+    kind: string;
+    targetId: string;
+    actor: HubActor;
+    createdAt: string;
+}
+export {};
+//# sourceMappingURL=project-hub-contract.d.ts.map

package/dist/brain/project-hub-contract.d.ts.map

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