@formicoidea/labre-framework-cynefin 0.36.0 → 0.37.0

package/dist/estuarine/reading.d.ts

@@ -0,0 +1,34 @@
+import type { ReadingProfile } from '@formicoidea/labre-core/blocks/surface';
+/**
+ * What Estuarine lets the tool read of a constraint (MF3, the reversed
+ * reading).
+ *
+ * One profile, one role, and nothing else: a hexagon is a plain polygon on the
+ * canvas, so the role is the only place that says what it is — and saying it,
+ * with the link to the record beside it, is the whole of what a reading can
+ * honestly offer here.
+ *
+ * Registered from the FLAG-GATED view extension, like every other profile:
+ * reading a board is tooling (ADR 0009).
+ *
+ * ## No relation, no nature, no phase — and no verdict
+ *
+ * Estuarine declares no edge role: an arrow drawn between two hexagons is a
+ * plain connector and carries no verb, so there is no sentence to read off it.
+ * It declares no type-3 tag pack either. And the map's own energy/time plane is
+ * NOT read as a phase in this pass: the three reference curves are not zones
+ * with an id, and reading a "position" off them would be the engine inventing a
+ * fact the declaration does not carry.
+ *
+ * ## Cynefin gets nothing, and that is ADR 0013
+ *
+ * The two frameworks share this package and share nothing here. Cynefin
+ * declares no role at all — its four domains are the participants' judgement
+ * about their own context, and there is no external truth to check — so a free
+ * element on a Cynefin board carries no role and has no reading. A CONSTRAINT
+ * hexagon dropped on such a board does, because the hexagon is an Estuarine
+ * artefact wherever it is drawn. See the amendment of 2026-09-07 to
+ * `docs/adr/0013`: reading is not validation, and this profile carries no rule
+ * and no verdict.
+ */
+export declare const ESTUARINE_READING: ReadingProfile;

package/dist/estuarine/reading.js

@@ -0,0 +1,41 @@
+import { ESTUARINE_ROLE, ESTUARINE_ROLES } from './roles.js';
+/**
+ * What Estuarine lets the tool read of a constraint (MF3, the reversed
+ * reading).
+ *
+ * One profile, one role, and nothing else: a hexagon is a plain polygon on the
+ * canvas, so the role is the only place that says what it is — and saying it,
+ * with the link to the record beside it, is the whole of what a reading can
+ * honestly offer here.
+ *
+ * Registered from the FLAG-GATED view extension, like every other profile:
+ * reading a board is tooling (ADR 0009).
+ *
+ * ## No relation, no nature, no phase — and no verdict
+ *
+ * Estuarine declares no edge role: an arrow drawn between two hexagons is a
+ * plain connector and carries no verb, so there is no sentence to read off it.
+ * It declares no type-3 tag pack either. And the map's own energy/time plane is
+ * NOT read as a phase in this pass: the three reference curves are not zones
+ * with an id, and reading a "position" off them would be the engine inventing a
+ * fact the declaration does not carry.
+ *
+ * ## Cynefin gets nothing, and that is ADR 0013
+ *
+ * The two frameworks share this package and share nothing here. Cynefin
+ * declares no role at all — its four domains are the participants' judgement
+ * about their own context, and there is no external truth to check — so a free
+ * element on a Cynefin board carries no role and has no reading. A CONSTRAINT
+ * hexagon dropped on such a board does, because the hexagon is an Estuarine
+ * artefact wherever it is drawn. See the amendment of 2026-09-07 to
+ * `docs/adr/0013`: reading is not validation, and this profile carries no rule
+ * and no verdict.
+ */
+export const ESTUARINE_READING = {
+    id: 'estuarine',
+    framework: 'cynefin-estuarine',
+    roles: ESTUARINE_ROLES,
+    // Not the map: a reading is about an artefact, never about the frame it is
+    // measured against.
+    appliesTo: ESTUARINE_ROLE.constraint,
+};

package/dist/index.d.ts

@@ -1,2 +1,4 @@
 export { cynefinEstuarineCommandIcons, cynefinEstuarineCommands, } from './commands.js';
 export { cynefinEstuarineTranslationEntries } from './translations.js';
+export { ESTUARINE_ROLE, ESTUARINE_ROLES, type EstuarineRoleId, } from './estuarine/roles.js';
+export { ESTUARINE_READING } from './estuarine/reading.js';

package/dist/index.js

@@ -1,2 +1,7 @@
 export { cynefinEstuarineCommandIcons, cynefinEstuarineCommands, } from './commands.js';
 export { cynefinEstuarineTranslationEntries } from './translations.js';
+// Estuarine's role vocabulary and its reading profile: DATA a host — and the
+// library's own cross-framework guard test — can read without an editor.
+// Cynefin contributes neither, having no role of its own (ADR 0013).
+export { ESTUARINE_ROLE, ESTUARINE_ROLES, } from './estuarine/roles.js';
+export { ESTUARINE_READING } from './estuarine/reading.js';

package/dist/translations.js

@@ -1,6 +1,7 @@
 import { collectTranslationKeys, commandCategoryTranslationEntries, commandTranslationEntries, mergeTranslationEntries, } from '@formicoidea/labre-core/std';
 import { cynefinEstuarineCommands } from './commands.js';
 import { ESTUARINE_NUDGES } from './estuarine/nudges.js';
+import { ESTUARINE_READING } from './estuarine/reading.js';
 import { ESTUARINE_ROLES } from './estuarine/roles.js';
 /**
  * THIS framework's contribution to the translation-key manifest.
@@ -25,4 +26,12 @@ export const cynefinEstuarineTranslationEntries = mergeTranslationEntries(comman
 // registry names no framework category in the bundled distribution, so a
 // host that composed core's manifest alone drew translated entries under
 // English headers (#183).
-commandCategoryTranslationEntries(cynefinEstuarineCommands), collectTranslationKeys('role', ESTUARINE_ROLES), collectTranslationKeys('nudge', ESTUARINE_NUDGES));
+commandCategoryTranslationEntries(cynefinEstuarineCommands), collectTranslationKeys('role', ESTUARINE_ROLES), collectTranslationKeys('nudge', ESTUARINE_NUDGES), 
+// LAST, and the order is load-bearing: a reading profile carries the
+// framework's own `roles`, so walking it reaches every role key the line
+// above already named. `mergeTranslationEntries` keeps the FIRST
+// occurrence, which is what makes each key report the source it comes from.
+// This profile declares no relation, so today it contributes no key of its
+// own — walking it costs nothing and means the day it gains one the
+// manifest already names it.
+collectTranslationKeys('reading', ESTUARINE_READING));

package/dist/view.js

@@ -1,4 +1,4 @@
-import { QualityNudgeExtension, ValidationFrameworkExtension, validationToolbarConfig, } from '@formicoidea/labre-core/blocks/surface';
+import { QualityNudgeExtension, ReadingProfileExtension, ValidationFrameworkExtension, validationToolbarConfig, } from '@formicoidea/labre-core/blocks/surface';
 import { ViewExtensionProvider, } from '@formicoidea/labre-core/ext-loader';
 import { extendTemplateCategory } from '@formicoidea/labre-core/gfx/template';
 import { ToolbarModuleExtension } from '@formicoidea/labre-core/shared/services';
@@ -13,6 +13,7 @@ import { EstuarineRendererExtension } from './estuarine/element-renderer.js';
 import { EstuarineInteraction, EstuarineView } from './estuarine/element-view.js';
 import { EstuarineGhostManager, EstuarineGhostOverlay, } from './estuarine/ghost-overlay.js';
 import { ESTUARINE_NUDGES } from './estuarine/nudges.js';
+import { ESTUARINE_READING } from './estuarine/reading.js';
 import { ESTUARINE_ROLE, ESTUARINE_ROLES } from './estuarine/roles.js';
 import { estuarineToolbarExtension } from './estuarine/toolbar/config.js';
 import { cynefinTemplateCategory, estuarineTemplateCategory, } from './templates/index.js';
@@ -104,6 +105,12 @@ export class CynefinEstuarineViewExtension extends ViewExtensionProvider {
                 id: BlockFlavourIdentifier('custom:affine:surface:estuarine'),
                 config: validationToolbarConfig,
             }));
+            // The reversed reading (MF3): what the board says about a constraint, on
+            // demand. Reading is not validation — this profile carries no rule and no
+            // verdict — which is why it can exist on a package ADR 0013 keeps out of
+            // the validation perimeter (see that ADR's amendment of 2026-09-07). A
+            // free element on a Cynefin board carries no role and stays unreadable.
+            context.register(ReadingProfileExtension(ESTUARINE_READING));
             context.register(cynefinEstuarineSeniorTool);
             context.register(CommandExtension(cynefinEstuarineCommands, cynefinEstuarineCommandIcons));
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@formicoidea/labre-framework-cynefin",
   "description": "Labre cynefin-estuarine framework for @formicoidea/labre-core.",
-  "version": "0.36.0",
+  "version": "0.37.0",
   "type": "module",
   "sideEffects": false,
   "author": "lajola",
@@ -31,7 +31,7 @@
     "dist"
   ],
   "dependencies": {
-    "@formicoidea/labre-core": "0.36.0",
+    "@formicoidea/labre-core": "0.37.0",
     "@preact/signals-core": "^1.8.0",
     "lit": "^3.2.0"
   }