@unson/brainbase-mcp 0.23.6 → 0.23.7

package/dist/canonical-task-service.d.ts

@@ -12,6 +12,14 @@ export interface CanonicalTaskContext extends JsonRecord {
     /** Opaque host-policy scope, not authority or task input. */
     storageScope?: string;
 }
+/** Conditions to review; this metadata is not evidence of completion. */
+export interface CanonicalTaskCompletionContract {
+    goal: string;
+    criteria: Array<{
+        id: string;
+        condition: string;
+    }>;
+}
 export interface CanonicalTaskRecord extends JsonRecord {
     id: string;
     version: number;
@@ -29,11 +37,13 @@ export interface CanonicalTaskRecord extends JsonRecord {
     project_codes?: string[];
     /** What the work is for, in a few words (one per task); null when unlabelled. */
     purpose_label?: string | null;
+    completion_contract?: CanonicalTaskCompletionContract | null;
     created_at?: string | null;
     updated_at?: string | null;
     web_url?: string | null;
 }
 export interface CanonicalTaskCreateInput extends JsonRecord {
+    completion_contract?: unknown;
     title: string;
     description?: string | null;
     priority?: CanonicalTaskPriority | string | null;
@@ -46,6 +56,7 @@ export interface CanonicalTaskCreateInput extends JsonRecord {
     purpose_label?: string | null;
 }
 export interface CanonicalTaskUpdateInput extends JsonRecord {
+    completion_contract?: unknown;
     title?: string;
     description?: string | null;
     priority?: CanonicalTaskPriority | string | null;

package/dist/canonical-task-service.js

@@ -26,6 +26,7 @@ const DEFAULT_LIMIT = 20;
 const MAX_LIMIT = 100;
 const RESERVED_IDEMPOTENCY_PREFIXES = ['api:', 'workflow:'];
 const CREATE_FIELDS = new Set([
+    'completion_contract',
     'title',
     'description',
     'priority',
@@ -38,6 +39,7 @@ const CREATE_FIELDS = new Set([
     'purpose_label',
 ]);
 const MUTABLE_FIELDS = new Set([
+    'completion_contract',
     'expected_version',
     'title',
     'description',
@@ -79,6 +81,39 @@ const MAX_PURPOSE_LABEL_LENGTH = 30;
 function normalizePurposeLabel(value) {
     return normalizeString(value, 'purpose_label', { max: MAX_PURPOSE_LABEL_LENGTH });
 }
+function normalizeCompletionContract(value) {
+    if (value == null)
+        return null;
+    const object = (candidate, keys) => {
+        if (!candidate || typeof candidate !== 'object' || Array.isArray(candidate)
+            || ![Object.prototype, null].includes(Object.getPrototypeOf(candidate))
+            || Object.keys(candidate).some((key) => !keys.includes(key))) {
+            fail('validation_error', 'completion_contract contains an invalid object');
+        }
+        return candidate;
+    };
+    const text = (candidate, field) => {
+        if (typeof candidate !== 'string')
+            fail('validation_error', `${field} must be a string`);
+        return normalizeString(candidate, field, { required: true, max: 2000, multiline: true });
+    };
+    const contract = object(value, ['goal', 'criteria']);
+    const goal = text(contract.goal, 'completion_contract.goal');
+    if (!Array.isArray(contract.criteria) || contract.criteria.length < 1 || contract.criteria.length > 50) {
+        fail('validation_error', 'completion_contract.criteria must contain 1 to 50 conditions');
+    }
+    const ids = new Set();
+    const criteria = Array.from(contract.criteria, (candidate) => {
+        const criterion = object(candidate, ['id', 'condition']);
+        if (typeof criterion.id !== 'string' || !/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/u.test(criterion.id)
+            || ids.has(criterion.id)) {
+            fail('validation_error', 'completion_contract criterion id is invalid or duplicated');
+        }
+        ids.add(criterion.id);
+        return { id: criterion.id, condition: text(criterion.condition, 'completion_contract.criteria.condition') };
+    });
+    return { goal, criteria };
+}
 function normalizeIsoDate(value, field) {
     const text = normalizeString(value, field);
     if (text == null)
@@ -635,7 +670,9 @@ export class CanonicalTaskService {
         if (!isCanonicalTaskPriority(priority))
             fail('validation_error', 'priority is invalid', 400, { field: 'priority' });
         const purposeLabel = normalizePurposeLabel(input.purpose_label);
+        const completionContract = normalizeCompletionContract(input.completion_contract);
         return {
+            ...(completionContract ? { completion_contract: completionContract } : {}),
             title,
             description: normalizeString(input.description, 'description', { max: 10000, multiline: true }),
             priority,
@@ -656,6 +693,8 @@ export class CanonicalTaskService {
         if (unknownFields.length > 0)
             fail('validation_error', 'Task update contains unsupported fields', 400, { fields: unknownFields });
         const patch = {};
+        if ('completion_contract' in input)
+            patch.completion_contract = normalizeCompletionContract(input.completion_contract);
         if ('title' in input)
             patch.title = normalizeString(input.title, 'title', { required: true, max: MAX_TITLE_LENGTH });
         if ('description' in input)
@@ -857,6 +896,12 @@ export class CanonicalTaskService {
             response.project_codes = [];
         if (response.purpose_label === undefined)
             response.purpose_label = null;
+        try {
+            response.completion_contract = normalizeCompletionContract(response.completion_contract);
+        }
+        catch {
+            fail('task_store_invalid', 'Stored Task completion contract is invalid', 503);
+        }
         return response;
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unson/brainbase-mcp",
-  "version": "0.23.6",
+  "version": "0.23.7",
   "description": "Local-first Brainbase judgment OS that lets supported AI agents reuse a user's approved goals, priorities, decisions, and judgment criteria.",
   "type": "module",
   "license": "MIT",
@@ -423,5 +423,5 @@
   "engines": {
     "node": ">=20"
   },
-  "gitHead": "d475d6282eda01482255c0a234999e194560d3c8"
+  "gitHead": "5dd3fb22d8a4b559ccb0e0ee14a6e9cdac6a4b4a"
 }