@unson/brainbase-mcp 0.41.7 → 0.41.9

package/dist/foundation-graph-http.js

@@ -253,13 +253,17 @@ function createFoundationCatalogRoute(readers, scopeId, context) {
             const variables = await readers.store.list('variable', context);
             const models = await readers.store.list('model', context);
             const philosophies = await readers.listPhilosophies(context);
+            // Philosophies without recorded applicability are still read by the
+            // judgment frame catalog; report them separately rather than as absent.
+            const philosophiesWithoutApplicability = await readers.listUnscopedPhilosophies(context);
             return jsonResponse(200, {
                 contractVersion: FOUNDATION_OVERVIEW_CONTRACT_VERSION,
                 scopeId,
                 objectives,
                 variables,
                 models,
-                philosophies
+                philosophies,
+                philosophies_without_applicability: philosophiesWithoutApplicability
             });
         }
     };

package/dist/graph-foundation-reader.d.ts

@@ -25,7 +25,7 @@ export declare const GRAPH_FOUNDATION_LATEST_SQL = "\nSELECT\n  history.entity_i
  * project.  The project filter is by canonical project code, which is the
  * scope identifier selected by the organization BFF.
  */
-export declare const GRAPH_FOUNDATION_LIST_SQL = "\nSELECT\n  history.entity_id,\n  history.entity_type,\n  history.revision,\n  history.payload,\n  history.project_id,\n  history.role_min,\n  history.sensitivity,\n  history.lifecycle_status,\n  history.storage_digest,\n  history.captured_at,\n  (\n    history.storage_digest = 'sha256:' ||\n      encode(sha256(convert_to(history.payload::text, 'UTF8')), 'hex')\n  ) AS storage_digest_valid,\n  current_entity.id AS current_entity_id,\n  current_entity.entity_type AS current_entity_type,\n  current_entity.payload AS current_payload,\n  current_entity.project_id AS current_project_id,\n  current_entity.role_min AS current_role_min,\n  current_entity.sensitivity AS current_sensitivity,\n  current_entity.lifecycle_status AS current_lifecycle_status,\n  projects.code AS current_project_code,\n  true AS current_visible\nFROM public.graph_entities AS current_entity\nLEFT JOIN public.projects AS projects\n  ON projects.id = current_entity.project_id\nLEFT JOIN LATERAL (\n  SELECT history.*\n  FROM public.graph_foundation_revisions AS history\n  WHERE history.entity_id = current_entity.id\n    AND history.entity_type = current_entity.entity_type\n  ORDER BY history.revision::numeric DESC\n  LIMIT 1\n) AS history ON true\nWHERE ($1::text IS NULL OR current_entity.entity_type = $1)\n  AND ($2::text IS NULL OR projects.code = $2 OR projects.id IS NULL)\n  AND current_entity.entity_type IN ('objective', 'variable', 'model', 'constraint')\nORDER BY current_entity.id, current_entity.entity_type\n";
+export declare const GRAPH_FOUNDATION_LIST_SQL = "\nSELECT\n  history.entity_id,\n  history.entity_type,\n  history.revision,\n  history.payload,\n  history.project_id,\n  history.role_min,\n  history.sensitivity,\n  history.lifecycle_status,\n  history.storage_digest,\n  history.captured_at,\n  (\n    history.storage_digest = 'sha256:' ||\n      encode(sha256(convert_to(history.payload::text, 'UTF8')), 'hex')\n  ) AS storage_digest_valid,\n  current_entity.id AS current_entity_id,\n  current_entity.entity_type AS current_entity_type,\n  current_entity.payload AS current_payload,\n  current_entity.project_id AS current_project_id,\n  current_entity.role_min AS current_role_min,\n  current_entity.sensitivity AS current_sensitivity,\n  current_entity.lifecycle_status AS current_lifecycle_status,\n  projects.code AS current_project_code,\n  true AS current_visible\nFROM public.graph_entities AS current_entity\nLEFT JOIN public.projects AS projects\n  ON projects.id = current_entity.project_id\nLEFT JOIN LATERAL (\n  SELECT history.*\n  FROM public.graph_foundation_revisions AS history\n  WHERE history.entity_id = current_entity.id\n    AND history.entity_type = current_entity.entity_type\n  ORDER BY history.revision::numeric DESC\n  LIMIT 1\n) AS history ON true\nWHERE ($1::text IS NULL OR current_entity.entity_type = $1)\n  AND ($2::text IS NULL OR projects.code = $2 OR projects.id IS NULL)\n  AND current_entity.entity_type IN ('objective', 'variable', 'model', 'constraint')\n  -- A list projects current records only. A retired row is not current, and\n  -- reading it would make one replaced record fail the whole list.\n  AND current_entity.lifecycle_status = 'active'\nORDER BY current_entity.id, current_entity.entity_type\n";
 /**
  * List the newest immutable revision for each philosophy attached to the
  * selected project. The current Graph row is still the authorization
@@ -33,7 +33,29 @@ export declare const GRAPH_FOUNDATION_LIST_SQL = "\nSELECT\n  history.entity_id,
  * Unlike the Foundation list, this query requires a canonical project join so
  * a missing project membership cannot be interpreted as a selected-scope hit.
  */
-export declare const GRAPH_PHILOSOPHY_LIST_SQL = "\nSELECT\n  history.entity_id,\n  history.entity_type,\n  history.revision,\n  history.payload,\n  history.project_id,\n  history.role_min,\n  history.sensitivity,\n  history.lifecycle_status,\n  history.storage_digest,\n  history.captured_at,\n  (\n    history.storage_digest = 'sha256:' ||\n      encode(sha256(convert_to(history.payload::text, 'UTF8')), 'hex')\n  ) AS storage_digest_valid,\n  current_entity.id AS current_entity_id,\n  current_entity.entity_type AS current_entity_type,\n  current_entity.payload AS current_payload,\n  current_entity.project_id AS current_project_id,\n  current_entity.role_min AS current_role_min,\n  current_entity.sensitivity AS current_sensitivity,\n  current_entity.lifecycle_status AS current_lifecycle_status,\n  projects.code AS current_project_code,\n  true AS current_visible\nFROM public.graph_entities AS current_entity\nJOIN public.projects AS projects\n  ON projects.id = current_entity.project_id\nLEFT JOIN LATERAL (\n  SELECT history.*\n  FROM public.graph_foundation_revisions AS history\n  WHERE history.entity_id = current_entity.id\n    AND history.entity_type = current_entity.entity_type\n  ORDER BY history.revision::numeric DESC\n  LIMIT 1\n) AS history ON true\nWHERE current_entity.entity_type = 'philosophy'\n  AND projects.code = $1\n  AND current_entity.payload ? 'judgmentApplicability'\nORDER BY current_entity.id\n";
+export declare const GRAPH_PHILOSOPHY_LIST_SQL = "\nSELECT\n  history.entity_id,\n  history.entity_type,\n  history.revision,\n  history.payload,\n  history.project_id,\n  history.role_min,\n  history.sensitivity,\n  history.lifecycle_status,\n  history.storage_digest,\n  history.captured_at,\n  (\n    history.storage_digest = 'sha256:' ||\n      encode(sha256(convert_to(history.payload::text, 'UTF8')), 'hex')\n  ) AS storage_digest_valid,\n  current_entity.id AS current_entity_id,\n  current_entity.entity_type AS current_entity_type,\n  current_entity.payload AS current_payload,\n  current_entity.project_id AS current_project_id,\n  current_entity.role_min AS current_role_min,\n  current_entity.sensitivity AS current_sensitivity,\n  current_entity.lifecycle_status AS current_lifecycle_status,\n  projects.code AS current_project_code,\n  true AS current_visible\nFROM public.graph_entities AS current_entity\nJOIN public.projects AS projects\n  ON projects.id = current_entity.project_id\nLEFT JOIN LATERAL (\n  SELECT history.*\n  FROM public.graph_foundation_revisions AS history\n  WHERE history.entity_id = current_entity.id\n    AND history.entity_type = current_entity.entity_type\n  ORDER BY history.revision::numeric DESC\n  LIMIT 1\n) AS history ON true\nWHERE current_entity.entity_type = 'philosophy'\n  AND projects.code = $1\n  AND current_entity.lifecycle_status = 'active'\n  AND current_entity.payload ? 'judgmentApplicability'\nORDER BY current_entity.id\n";
+/**
+ * Current philosophies of the selected project that predate recorded
+ * applicability. They are excluded from the verified list above, but the
+ * judgment frame catalog still reads them, so the overview must show them as
+ * "applicability unrecorded" instead of reporting that none are registered.
+ */
+export declare const GRAPH_UNSCOPED_PHILOSOPHY_LIST_SQL = "\nSELECT\n  current_entity.id AS current_entity_id,\n  current_entity.entity_type AS current_entity_type,\n  current_entity.payload AS current_payload,\n  current_entity.project_id AS current_project_id,\n  current_entity.lifecycle_status AS current_lifecycle_status,\n  current_entity.version AS current_version,\n  projects.code AS current_project_code\nFROM public.graph_entities AS current_entity\nJOIN public.projects AS projects\n  ON projects.id = current_entity.project_id\nWHERE current_entity.entity_type = 'philosophy'\n  AND projects.code = $1\n  AND current_entity.lifecycle_status = 'active'\n  AND NOT (current_entity.payload ? 'judgmentApplicability')\nORDER BY current_entity.id\n";
+/** A current philosophy whose judgment applicability has never been recorded. */
+export interface UnscopedPhilosophyRecord {
+    readonly kind: 'philosophy';
+    readonly id: string;
+    /** Current Graph version; there is no verified foundation revision. */
+    readonly version: number;
+    readonly applicability: null;
+    readonly applicability_state: 'unrecorded';
+    readonly payload: {
+        readonly title?: string;
+        readonly statement: string;
+        readonly summary?: string;
+        readonly status?: string;
+    };
+}
 /** Flat row shape returned by GRAPH_FOUNDATION_READ_SQL. */
 export interface GraphFoundationHistoryRow {
     readonly entity_id?: unknown;
@@ -55,6 +77,7 @@ export interface GraphFoundationHistoryRow {
     readonly current_role_min?: unknown;
     readonly current_sensitivity?: unknown;
     readonly current_lifecycle_status?: unknown;
+    readonly current_version?: unknown;
     readonly current_visible?: unknown;
 }
 export interface GraphFoundationQueryResult {
@@ -78,15 +101,21 @@ export interface FoundationObjectiveDetails {
     readonly evaluator_note?: unknown;
     readonly current_state?: unknown;
 }
-/** Runtime shape used by the overview contract for Objective records. */
+/** The words a World Model record gives for where it applies. */
+export interface FoundationModelDetails {
+    readonly applicability_text?: unknown;
+}
+/** Runtime shape used by the overview contract for Objective and World Model records. */
 export interface FoundationOverviewObjectiveRecord extends FoundationCatalogRecord {
-    readonly details?: FoundationObjectiveDetails;
+    readonly details?: FoundationObjectiveDetails | FoundationModelDetails;
 }
 export interface GraphFoundationReaders {
     readonly store: Pick<FoundationRevisionStore, 'read' | 'readLatest' | 'list'>;
     readonly philosophyReader: PhilosophyRevisionReader;
     /** List latest, current-visible philosophy revisions for the selected project. */
     readonly listPhilosophies: (context: FoundationStoreContext) => Promise<PhilosophyRevisionRecord[]>;
+    /** List current philosophies of the selected project without recorded applicability. */
+    readonly listUnscopedPhilosophies: (context: FoundationStoreContext) => Promise<UnscopedPhilosophyRecord[]>;
 }
 /**
  * Create both public read ports over one trusted, transaction-bound context.

package/dist/graph-foundation-reader.js

@@ -141,6 +141,9 @@ LEFT JOIN LATERAL (
 WHERE ($1::text IS NULL OR current_entity.entity_type = $1)
   AND ($2::text IS NULL OR projects.code = $2 OR projects.id IS NULL)
   AND current_entity.entity_type IN ('objective', 'variable', 'model', 'constraint')
+  -- A list projects current records only. A retired row is not current, and
+  -- reading it would make one replaced record fail the whole list.
+  AND current_entity.lifecycle_status = 'active'
 ORDER BY current_entity.id, current_entity.entity_type
 `;
 /**
@@ -188,9 +191,34 @@ LEFT JOIN LATERAL (
 ) AS history ON true
 WHERE current_entity.entity_type = 'philosophy'
   AND projects.code = $1
+  AND current_entity.lifecycle_status = 'active'
   AND current_entity.payload ? 'judgmentApplicability'
 ORDER BY current_entity.id
 `;
+/**
+ * Current philosophies of the selected project that predate recorded
+ * applicability. They are excluded from the verified list above, but the
+ * judgment frame catalog still reads them, so the overview must show them as
+ * "applicability unrecorded" instead of reporting that none are registered.
+ */
+export const GRAPH_UNSCOPED_PHILOSOPHY_LIST_SQL = `
+SELECT
+  current_entity.id AS current_entity_id,
+  current_entity.entity_type AS current_entity_type,
+  current_entity.payload AS current_payload,
+  current_entity.project_id AS current_project_id,
+  current_entity.lifecycle_status AS current_lifecycle_status,
+  current_entity.version AS current_version,
+  projects.code AS current_project_code
+FROM public.graph_entities AS current_entity
+JOIN public.projects AS projects
+  ON projects.id = current_entity.project_id
+WHERE current_entity.entity_type = 'philosophy'
+  AND projects.code = $1
+  AND current_entity.lifecycle_status = 'active'
+  AND NOT (current_entity.payload ? 'judgmentApplicability')
+ORDER BY current_entity.id
+`;
 const FOUNDATION_TYPES = ['objective', 'variable', 'model', 'constraint'];
 const REVISION_PATTERN = /^[1-9]\d*$/u;
 const DIGEST_PATTERN = /^sha256:[0-9a-f]{64}$/u;
@@ -284,7 +312,75 @@ export function createGraphFoundationReaders(options) {
             return createPhilosophyRevisionRecord(validated, id, revision, context.principal);
         });
     }
-    return { store, philosophyReader, listPhilosophies };
+    async function listUnscopedPhilosophies(suppliedContext) {
+        assertTrustedPrincipal(context, suppliedContext);
+        if (selectedProjectCode === undefined) {
+            throw scopeViolation('A selected project is required to list philosophies');
+        }
+        let result;
+        try {
+            result = await query(GRAPH_UNSCOPED_PHILOSOPHY_LIST_SQL, [selectedProjectCode]);
+        }
+        catch {
+            throw corrupt('Graph unscoped philosophy list query failed');
+        }
+        const rows = Array.isArray(result) ? result
+            : 'rows' in result && Array.isArray(result.rows) ? result.rows
+                : null;
+        if (!rows)
+            throw corrupt('Graph unscoped philosophy list query returned an invalid result');
+        const seen = new Set();
+        const records = [];
+        for (const row of rows) {
+            const id = requireString(row.current_entity_id, 'Current philosophy id');
+            if (row.current_entity_type !== 'philosophy')
+                throw corrupt('Graph philosophy list returned another entity type');
+            if (row.current_project_code !== selectedProjectCode) {
+                throw scopeViolation('The current philosophy project is outside the selected project scope');
+            }
+            if (seen.has(id))
+                throw corrupt('Philosophy list returned duplicate entities');
+            seen.add(id);
+            const version = Number(row.current_version);
+            if (!Number.isSafeInteger(version) || version < 1)
+                throw corrupt('Current philosophy version is invalid');
+            const payload = requireObject(row.current_payload, 'Current philosophy payload');
+            if (Object.hasOwn(payload, 'judgmentApplicability')) {
+                throw corrupt('Unscoped philosophy list returned a philosophy with applicability');
+            }
+            // Private philosophies always carry applicability; an owner-only ACL here
+            // is still enforced rather than silently shown.
+            assertPrivatePhilosophyRead(payload, context.principal);
+            // Mirror the judgment frame catalog: superseded or text-less records are
+            // not used for judgment, so they are not shown as usable either.
+            const status = optionalText(payload.status);
+            if (status && /^(superseded|retired|rejected)/u.test(status))
+                continue;
+            const statement = optionalText(payload.statement);
+            if (!statement)
+                continue;
+            const title = optionalText(payload.display_name) ?? optionalText(payload.title);
+            const summary = optionalText(payload.summary);
+            records.push({
+                kind: 'philosophy',
+                id,
+                version,
+                applicability: null,
+                applicability_state: 'unrecorded',
+                payload: {
+                    ...(title ? { title } : {}),
+                    statement,
+                    ...(summary ? { summary } : {}),
+                    ...(status ? { status } : {})
+                }
+            });
+        }
+        return records;
+    }
+    return { store, philosophyReader, listPhilosophies, listUnscopedPhilosophies };
+}
+function optionalText(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
 }
 function createPhilosophyRevisionRecord(validated, id, revision, principal) {
     return {
@@ -525,12 +621,10 @@ function validateFoundationRecord(row, reference, context, selectedProjectCode,
         definition: cloneFoundationDefinition(history.definition),
         digest: digestFoundationDefinition(history.definition)
     };
-    if (reference.type === 'objective') {
-        const details = projectObjectiveDetails(history.payload);
-        if (details !== undefined)
-            return { ...record, details };
-    }
-    return record;
+    const details = reference.type === 'objective'
+        ? projectDetails(history.payload, OBJECTIVE_DETAIL_KEYS)
+        : reference.type === 'model' ? projectDetails(history.payload, MODEL_DETAIL_KEYS) : undefined;
+    return details === undefined ? record : { ...record, details };
 }
 const OBJECTIVE_DETAIL_KEYS = [
     'title',
@@ -540,15 +634,18 @@ const OBJECTIVE_DETAIL_KEYS = [
     'evaluator_note',
     'current_state'
 ];
-function projectObjectiveDetails(payload) {
+// A model's foundation scope carries ids and a registration time; its own words for where it
+// applies live beside the definition.
+const MODEL_DETAIL_KEYS = ['applicability_text'];
+function projectDetails(payload, keys) {
     const nestedDetails = isPlainRecord(payload.details) ? payload.details : undefined;
     const foundation = isPlainRecord(payload.foundation) ? payload.foundation : undefined;
     // Graphify payloads historically carried these descriptive fields at the
     // payload root. Keep the two known nested forms compatible while exposing
-    // only the six fields in the overview contract.
+    // only the listed fields in the overview contract.
     const candidates = [payload, nestedDetails, foundation].filter((candidate) => candidate !== undefined);
     const projected = {};
-    for (const key of OBJECTIVE_DETAIL_KEYS) {
+    for (const key of keys) {
         const source = candidates.find((candidate) => Object.prototype.hasOwnProperty.call(candidate, key));
         if (source !== undefined && source[key] !== undefined)
             projected[key] = source[key];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unson/brainbase-mcp",
-  "version": "0.41.7",
+  "version": "0.41.9",
   "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",
@@ -483,5 +483,5 @@
   "engines": {
     "node": ">=20"
   },
-  "gitHead": "218515bb85c16915c1e509f608f83aa06af3a5d1"
+  "gitHead": "76bf4ebe18b116379d4687272baecdc4a74dbb35"
 }

package/ui/foundation-overview.css

@@ -151,14 +151,6 @@
   line-height: 1.55;
 }
 
-.bb-fov-record-id {
-  display: block;
-  margin-top: 7px;
-  color: var(--bb-color-quiet);
-  font-family: var(--bb-font-mono);
-  font-size: 10px;
-  overflow-wrap: anywhere;
-}
 
 .bb-fov-ref-list {
   display: grid;
@@ -254,4 +246,5 @@
 @media (max-width: 760px) { .bb-fov-objective-ledger { overflow-x: auto; } .bb-fov-objective-ledger .bb-ws-ledger-row { min-width: 760px; } }
 @media (max-width: 480px) { .bb-fov-reading .bb-ws-definition { grid-template-columns: 1fr; gap: 4px; } .bb-fov-reading dd { margin-bottom: 12px; } }
 .bb-fov-philosophy-card .bb-fov-original { border-top: 0; padding-top: 0; }
+.bb-fov-model-card .bb-fov-original { margin-top: 12px; padding-top: 10px; overflow-wrap: anywhere; }
 .bb-fov-objective-ledger .bb-ws-ledger-row:focus-visible { outline: 2px solid var(--bb-color-focus); outline-offset: 2px; }