@unson/brainbase-mcp 0.23.5 → 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.5",
+  "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": "98835ea4b24370a96ea81e80716653b416bcd7c3"
+  "gitHead": "5dd3fb22d8a4b559ccb0e0ee14a6e9cdac6a4b4a"
 }

package/ui/judgment-history.js

@@ -606,7 +606,9 @@ function aggregateNormalJudgmentHistory(home, { now = new Date(), period = PERIO
       confirmedOutcomes: null,
     },
     visibleCount: 0,
-    totalCount: home.coverage?.total ?? (home.coverage?.complete === true && home.records.length === 0 ? 0 : null),
+    retrievedCount: 0,
+    countComplete: false,
+    totalCount: home.status === 'available' && home.coverage?.complete === true ? nonNegativeInteger(home.coverage?.total) : null,
     period: normalizedPeriod(period),
     query: text(query),
     status: home.status,
@@ -660,7 +662,10 @@ function aggregateNormalJudgmentHistory(home, { now = new Date(), period = PERIO
     }
   }
   const metricsUnconfirmed = home.status === 'partial' && rows.length === 0;
-  const judgments = metricsUnconfirmed ? null : rows.length;
+  // A page length is a retrieved count, never proof of the whole range.
+  const countComplete = home.status === 'available' && home.coverage?.complete === true
+    && nonNegativeInteger(home.coverage?.total) !== null && !needle;
+  const judgments = countComplete ? home.coverage.total : null;
   const referenceCount = metricsUnconfirmed || referencesUnconfirmed ? null : references.size;
   const confirmedOutcomes = metricsUnconfirmed
     ? null
@@ -680,7 +685,9 @@ function aggregateNormalJudgmentHistory(home, { now = new Date(), period = PERIO
       confirmedOutcomes,
     },
     visibleCount: rows.length,
-    totalCount: home.coverage?.total ?? (home.coverage?.complete === true && home.records.length === 0 ? 0 : null),
+    retrievedCount: rows.length,
+    countComplete,
+    totalCount: home.status === 'available' && home.coverage?.complete === true ? nonNegativeInteger(home.coverage?.total) : null,
   };
 }
 
@@ -1328,7 +1335,7 @@ function paginationControls(doc, aggregate, onNext) {
   const total = aggregate?.totalCount;
   if (!pagination?.hasNext && total === null) return null;
   const wrap = makeWorkspaceElement(doc, 'div', { className: 'bb-jh-pagination' });
-  const count = total === null ? '同じ範囲の件数は未確認' : `同じ範囲の件数: ${total}件`;
+  const count = total === null ? '同じ範囲の件数は未確認' : `${aggregate.query ? '検索前の全件数' : '同じ範囲の件数'}: ${total}件`;
   wrap.append(makeWorkspaceElement(doc, 'span', { className: 'bb-jh-pagination-count', text: count }));
   if (pagination?.hasNext) {
     wrap.append(workspaceButton(doc, { text: '次のページ', variant: 'quiet', onClick: onNext, attrs: { 'data-action': 'next-page' } }));
@@ -1709,7 +1716,12 @@ export function createJudgmentHistoryUI({
     const stats = aggregate.stats ?? {};
     const metricCount = (value, suffix) => value === null || value === undefined ? '未確認' : `${value}${suffix}`;
     wrapper.append(workspaceMetrics(doc, normalMode() ? [
-      { label: '判断件数', value: metricCount(stats.judgments, '件'), note: 'この期間・絞り込みの履歴' },
+      {
+        label: aggregate.query ? '表示対象' : aggregate.countComplete ? '判断件数' : '取得済み',
+        value: metricCount(aggregate.countComplete ? stats.judgments : aggregate.retrievedCount, '件'),
+        note: aggregate.countComplete ? 'この期間・絞り込みの全件数'
+          : aggregate.query ? '取得済み履歴の検索結果・全件数未確認' : '全件数未確認',
+      },
       { label: '使った参照', value: metricCount(stats.references, '件'), note: '当時の記録にある一意の参照' },
       { label: '確認済みの結果', value: metricCount(stats.confirmedOutcomes, '件'), note: '成果が確認済みと記録された判断' },
     ] : [
@@ -1717,8 +1729,8 @@ export function createJudgmentHistoryUI({
       { label: 'そこで使った参照', value: metricCount(stats.references, '件'), note: '代理判断に含まれる一意の参照' },
       { label: '判断回数にすると', value: metricCount(stats.equivalent, '回分相当'), note: '代理判断1件を1回分として表示' },
     ], { ariaLabel: '判断履歴の集計' }));
-    const emptyText = state.home?.status === 'partial'
-      ? 'この期間に取得できた判断履歴はありません。未接続・一部取得のため0件とは確認できません。'
+    const emptyText = state.home?.status === 'partial' || (normalMode() && !aggregate.countComplete)
+      ? 'この期間に取得できた判断履歴はありません。全件数が未確認のため0件とは確認できません。'
       : 'この期間の判断履歴はありません。';
     wrapper.append(workspaceLedger(doc, {
       className: 'bb-jh-ledger',