coaiajs 0.4.3 → 0.5.0

package/dist/src/narrative/argument-hygiene.js

@@ -0,0 +1,155 @@
+/**
+ * COAIA Narrative - Argument Hygiene
+ *
+ * A malformed tool call must not become chart content.
+ *
+ * On 2026-07-30 a live store was found carrying seven observations whose bodies
+ * ended in `</currentReality>` followed by a `<parameter name="dueDate">` block:
+ * the raw text of a call whose argument tags never parsed, persisted verbatim as
+ * if it were prose. The call did not fail — it wrote, and every consumer that
+ * renders current reality has shown that tag ever since.
+ *
+ * The check belongs here, at the write boundary. Anything that reaches the JSONL
+ * is already in every reader's render, so a read-side filter arrives too late.
+ * A body carrying plainly unparsed call syntax is refused with the offending
+ * fragment named, so the caller can retry with the text it meant to record.
+ */
+import { ALL_TOOL_DEFINITIONS } from './tool-definitions.js';
+/**
+ * Tool-call machinery that has no business inside a text body. These are the
+ * tags a call is *made of*, not tags a chart can legitimately talk about in the
+ * same breath as its own content.
+ */
+const CALL_MACHINERY = [
+    {
+        reason: 'a tool-call parameter tag',
+        pattern: /<\s*\/?\s*(?:[A-Za-z][\w.-]*:)?parameter\b/i
+    },
+    {
+        reason: 'a tool-call invoke tag',
+        pattern: /<\s*\/?\s*(?:[A-Za-z][\w.-]*:)?invoke\b/i
+    },
+    {
+        reason: 'a tool-call function_calls tag',
+        pattern: /<\s*\/?\s*(?:[A-Za-z][\w.-]*:)?function_calls\b/i
+    }
+];
+/**
+ * Every argument name this package declares, gathered from the tool schemas so
+ * the vocabulary cannot drift from the tools themselves. A bare closing tag for
+ * one of these names inside a text body is a parse that failed, not prose.
+ */
+const ARGUMENT_NAMES = (() => {
+    const names = new Set();
+    const walk = (node) => {
+        if (!node || typeof node !== 'object')
+            return;
+        const record = node;
+        const properties = record.properties;
+        if (properties && typeof properties === 'object' && !Array.isArray(properties)) {
+            for (const [key, child] of Object.entries(properties)) {
+                if (/^[A-Za-z_][A-Za-z0-9_-]*$/.test(key))
+                    names.add(key);
+                walk(child);
+            }
+        }
+        if (record.items)
+            walk(record.items);
+    };
+    for (const tool of ALL_TOOL_DEFINITIONS)
+        walk(tool.inputSchema);
+    // Longest first, so a report names `</currentReality>` rather than a shorter
+    // suffix that happens to match inside it.
+    return [...names].sort((a, b) => b.length - a.length);
+})();
+const ARGUMENT_CLOSING_TAG = new RegExp(`<\\s*/\\s*(${ARGUMENT_NAMES.join('|')})\\s*>`, 'i');
+/** Quote back enough of the offending text to be recognisable, not the whole body. */
+function quoteFragment(text, index, matchLength) {
+    const close = text.indexOf('>', index + matchLength - 1);
+    const end = close !== -1 && close - index < 80 ? close + 1 : Math.min(text.length, index + 60);
+    const fragment = text.slice(index, end).replace(/\s+/g, ' ').trim();
+    return end < text.length && close === -1 ? `${fragment}…` : fragment;
+}
+/**
+ * Return the first unparsed-call-syntax fragment in `text`, or null if the text
+ * is ordinary prose. Angle brackets on their own are fine — `<div>`, `a < b`,
+ * `<rootDir>` all pass. Only call machinery and argument closing tags are refused.
+ */
+export function findUnparsedCallSyntax(text) {
+    if (typeof text !== 'string' || !text.includes('<'))
+        return null;
+    // Report the earliest fragment, not the first pattern that happens to match.
+    // The earliest one is where the prose ended and the call text began — the place
+    // the caller needs to look.
+    let earliest = null;
+    const consider = (index, length, reason) => {
+        if (!earliest || index < earliest.index)
+            earliest = { index, length, reason };
+    };
+    for (const { reason, pattern } of CALL_MACHINERY) {
+        const match = pattern.exec(text);
+        if (match)
+            consider(match.index, match[0].length, reason);
+    }
+    const closing = ARGUMENT_CLOSING_TAG.exec(text);
+    if (closing)
+        consider(closing.index, closing[0].length, `a closing tag for the '${closing[1]}' argument`);
+    if (!earliest)
+        return null;
+    const hit = earliest;
+    return {
+        fragment: quoteFragment(text, hit.index, hit.length),
+        reason: hit.reason,
+        index: hit.index
+    };
+}
+/**
+ * Walk any argument value — string, array, or object — and return the first
+ * location carrying unparsed call syntax.
+ */
+export function findUnparsedCallSyntaxIn(value, path = '') {
+    if (typeof value === 'string') {
+        const hit = findUnparsedCallSyntax(value);
+        return hit ? { ...hit, path: path || 'value' } : null;
+    }
+    if (Array.isArray(value)) {
+        for (let index = 0; index < value.length; index++) {
+            const found = findUnparsedCallSyntaxIn(value[index], `${path}[${index}]`);
+            if (found)
+                return found;
+        }
+        return null;
+    }
+    if (value && typeof value === 'object') {
+        for (const [key, child] of Object.entries(value)) {
+            const found = findUnparsedCallSyntaxIn(child, path ? `${path}.${key}` : key);
+            if (found)
+                return found;
+        }
+        return null;
+    }
+    return null;
+}
+/** The message a caller sees: what was refused, where, and what to do next. */
+export function describeUnparsedCallSyntax(location) {
+    return [
+        `Malformed call refused — nothing was written.`,
+        ``,
+        `\`${location.path}\` carries unparsed call syntax, not prose:`,
+        `    ${location.fragment}`,
+        `That is ${location.reason}.`,
+        ``,
+        `The argument tags of this call did not parse, so raw call text arrived as the`,
+        `value. Storing it would put a tag into the chart where a sentence belongs.`,
+        `Re-send the call with \`${location.path}\` holding only the text meant to be recorded.`
+    ].join('\n');
+}
+/** Throw unless `value` is free of unparsed call syntax. Used at the store's edge. */
+export function assertNoUnparsedCallSyntax(value, path) {
+    const location = findUnparsedCallSyntaxIn(value, path);
+    if (location)
+        throw new Error(describeUnparsedCallSyntax(location));
+}
+/** The argument-name vocabulary, exported so the scrubber reports what the server refuses. */
+export const KNOWN_ARGUMENT_NAMES = ARGUMENT_NAMES;
+//# sourceMappingURL=argument-hygiene.js.map

package/dist/src/narrative/argument-hygiene.js.map

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

package/dist/src/narrative/contract.d.ts

@@ -0,0 +1,200 @@
+/**
+ * COAIA Narrative — the store read contract.
+ *
+ * WHAT THIS IS FOR
+ *
+ * This package owns the writes. Anything that renders a chart store was, until now,
+ * re-deriving the store's shape by hand — entity-kind strings, the `${chartId}_chart`
+ * naming scheme, which metadata key holds the MMOT trail. That knowledge living in two
+ * places is not a style problem: when it drifts, a renderer does not break, it quietly
+ * renders LESS. A chart holding real work looks identical to an empty one.
+ *
+ * HOW IT AVOIDS BEING THE THING IT WARNS ABOUT
+ *
+ * The first draft of this module re-implemented record classification by hand, and a
+ * review measured it returning 73 entities where the writer's own parser returned 76 —
+ * it dropped the legacy `type:"narrative_beat"` dialect and reported the losses as
+ * corruption. Duplication relocated rather than removed.
+ *
+ * So classification is NOT defined here. `./jsonl-records.js` holds the single
+ * definition, and both the writer (jsonl-preservation.ts) and this contract import it.
+ * What this module adds on top is the two things the writer's parser genuinely does not
+ * offer a renderer: per-line TOLERANCE (parseJsonlMemory throws on one bad line, which
+ * is correct for a writer and fatal for a surface), and the selectors/naming below.
+ *
+ * THREE RULES THIS MODULE KEEPS
+ *
+ * 1. Zero I/O. No `fs`, no `process`, no network. Callers own reading; this owns shape.
+ * 2. Never imports the server. The package's `main` IS the MCP bootstrap — importing the
+ *    package root starts a stdio server — which is why this lives behind its own subpath.
+ * 3. Tolerant by construction, honest about what it skipped.
+ */
+import type { Entity } from '../types.js';
+/** Bumped when a shape changes in a way a reader must notice. */
+export declare const CONTRACT_VERSION = 2;
+/**
+ * Every entityType this package writes. `test-contract.js` scans this package's own
+ * source and fails if a kind is written that this list does not publish — so the
+ * contract cannot fall behind the writer without the suite going red.
+ */
+export declare const ENTITY_TYPES: {
+    readonly chart: "structural_tension_chart";
+    readonly desiredOutcome: "desired_outcome";
+    readonly currentReality: "current_reality";
+    readonly actionStep: "action_step";
+    readonly narrativeBeat: "narrative_beat";
+    readonly wampumBelt: "wampum_belt";
+};
+export type EntityType = (typeof ENTITY_TYPES)[keyof typeof ENTITY_TYPES];
+/**
+ * `EntityType | (string & {})` rather than `EntityType | string`: the latter collapses
+ * to plain `string`, which silently permits `e.entityType === 'strucutral_tension_chart'`
+ * — a typo that compiles clean and renders nothing. This form keeps autocomplete AND
+ * keeps the comparison checked, while still accepting kinds written by a newer writer.
+ */
+export type EntityTypeLike = EntityType | (string & {});
+/**
+ * MMOT phases, as the writer accepts them. `'full'` is included deliberately: it is the
+ * tool's DEFAULT (`phase: string = 'full'`) and appears in live stores. An earlier draft
+ * omitted it, which would have made a phase rail built from this list silently drop
+ * every default-phase evaluation.
+ */
+export declare const MMOT_PHASES: readonly ["full", "acknowledge", "analyze", "update", "recommit"];
+export type MmotPhase = (typeof MMOT_PHASES)[number];
+export declare const isMmotPhase: (v: unknown) => v is MmotPhase;
+/**
+ * Fritz's creating phases, carried on a chart as `metadata.phase`. Published alongside
+ * MMOT_PHASES because both occupy the key `phase` in different records, and a reader
+ * that assumes one vocabulary when it holds the other gets a confident wrong answer.
+ */
+export declare const CREATING_PHASES: readonly ["germination", "assimilation", "completion"];
+export type CreatingPhase = (typeof CREATING_PHASES)[number];
+export type Direction = 'North' | 'South' | 'East' | 'West';
+export declare const chartEntityName: (chartId: string) => string;
+export declare const desiredOutcomeName: (chartId: string) => string;
+export declare const currentRealityName: (chartId: string) => string;
+/** MMOT narrative beats are named `${chartId}_mmot_${epochMs}`. */
+export declare const mmotBeatPrefix: (chartId: string) => string;
+export declare const isMmotBeatName: (name: string, chartId: string) => boolean;
+/** One entry in a chart's MMOT trail (`chart.metadata.mmotEvaluations`). */
+export interface MmotEvaluation {
+    phase: MmotPhase | (string & {});
+    assessment: string;
+    direction?: Direction | (string & {});
+    timestamp?: string;
+}
+export interface StoreEntity {
+    name: string;
+    entityType: EntityTypeLike;
+    observations?: string[];
+    metadata?: Record<string, unknown>;
+    type: string;
+}
+export interface StoreRelation {
+    from: string;
+    to: string;
+    relationType: string;
+    metadata?: Record<string, unknown>;
+    type: 'relation';
+}
+export interface ParsedStore {
+    /** Keyed by entity name; a later record for the same name supersedes an earlier one. */
+    entities: Map<string, StoreEntity>;
+    relations: StoreRelation[];
+    /**
+     * Lines that were not valid JSON, or were valid JSON that the writer's own predicates
+     * do not classify as any known record. NOT a corruption count on its own — see the
+     * warning on `parseStore` about what this can and cannot detect.
+     */
+    skipped: number;
+}
+/**
+ * Parse raw JSONL store content. Pure: give it a string, get records back.
+ *
+ * Classification is delegated to the writer's own predicates, so every dialect the
+ * writer round-trips — including the legacy top-level `type:"narrative_beat"` form — is
+ * read here identically. The only behaviour added is per-line tolerance: one unparseable
+ * line is skipped rather than throwing away the whole store, which is what a live
+ * surface needs and what `parseJsonlMemory` deliberately does not do.
+ *
+ * WHAT `skipped` CANNOT TELL YOU. Since writeJsonlMemoryFile became atomic (temp +
+ * rename) a reader should never see a torn file at all, and `skipped > 0` now genuinely
+ * suggests a foreign or damaged line. But a store truncated by something OTHER than this
+ * package can still be a syntactically perfect PREFIX — every whole line parses, and the
+ * result is simply a smaller store with `skipped === 0`. No reader can detect that from
+ * content alone. If that matters to a caller, compare entity counts across reads.
+ */
+export declare function parseStore(raw: string): ParsedStore;
+/** The writer's `Entity` shape, for callers already holding a KnowledgeGraph. */
+export type { Entity };
+/** Read a string-valued metadata key, or undefined when absent or the wrong type. */
+export declare function metaString(e: StoreEntity | undefined, key: string): string | undefined;
+/** A step or chart is complete when `metadata.completionStatus` is exactly true. */
+export declare const isComplete: (e: StoreEntity | undefined) => boolean;
+export declare const getChartEntity: (s: ParsedStore, chartId: string) => StoreEntity | undefined;
+export declare const getDesiredOutcome: (s: ParsedStore, chartId: string) => StoreEntity | undefined;
+export declare const getCurrentReality: (s: ParsedStore, chartId: string) => StoreEntity | undefined;
+/**
+ * FLAT action steps only — `action_step` entities carrying this chart's id.
+ *
+ * Read the name literally: this is NOT "the chart's work". Only steps passed in the
+ * `actionSteps[]` array at chart creation become `action_step` entities. `add_action_step`
+ * creates a TELESCOPED CHILD CHART instead, and its step is that child's desired outcome.
+ * In the live seat store, 49 of 71 charts carry a parent — most work is telescoped and
+ * invisible here. Use `getWork` unless you specifically want the flat ones.
+ */
+export declare function getFlatActionSteps(s: ParsedStore, chartId: string): StoreEntity[];
+/**
+ * Charts telescoped beneath this one — full charts whose `parentChart` points back here.
+ */
+export declare function getChildCharts(s: ParsedStore, chartId: string): StoreEntity[];
+/** One unit of work on a chart, whether it is a flat step or a telescoped child. */
+export interface WorkItem {
+    /** Entity name for a flat step; the CHILD CHART's id for a telescoped one. */
+    id: string;
+    title: string;
+    completed: boolean;
+    dueDate?: string;
+    updatedAt?: string;
+    telescoped: boolean;
+    /** The underlying record, for callers that need more than the summary. */
+    entity: StoreEntity;
+}
+/**
+ * Everything a chart is actually holding: flat action steps PLUS telescoped children,
+ * in one list. This is what a progress indicator or a chart view wants — counting only
+ * flat steps is precisely the bug that made get_chart_progress report 0/0 for charts
+ * full of telescoped work.
+ */
+export declare function getWork(s: ParsedStore, chartId: string): WorkItem[];
+export declare function getMmotBeats(s: ParsedStore, chartId: string): StoreEntity[];
+/**
+ * The chart's MMOT trail, normalized. Lives on the CHART entity's metadata, not on
+ * current reality — the two are separate records, and a caller may write the trail
+ * while deliberately leaving current reality alone.
+ */
+export declare function getMmotEvaluations(chart: StoreEntity | undefined): MmotEvaluation[];
+/**
+ * A content-derived revision token for the WHOLE store — newest timestamp, plus the
+ * record counts.
+ *
+ * The counts are not decoration. Two mutations this package performs move no timestamp
+ * a chart-scoped scan would see: `updateActionProgress` stamps the step but not the
+ * chart, and `removeActionStep` stamps nothing at all. A token built only from
+ * `max(updatedAt)` therefore holds steady across a progress update AND across a
+ * deletion — so a renderer caching on it serves a removed action step forever. Folding
+ * in `entities.size` and `relations.length` makes a deletion move the token.
+ *
+ * Still derived from content, never from a file mtime: an mtime changes when the store
+ * is rewritten with identical bytes, which makes every reader refetch for nothing and
+ * makes a real change indistinguishable from a no-op rewrite.
+ */
+export declare function storeRevision(s: ParsedStore): string;
+/**
+ * Revision across a specific set of entities. Narrower than `storeRevision` and subject
+ * to the blind spots described there — a progress update or a deletion may not move it.
+ * Prefer `storeRevision` for cache keys; use this only when a per-chart token is
+ * genuinely required and its limits are understood.
+ */
+export declare function revisionOf(entities: Array<StoreEntity | undefined>): string;
+//# sourceMappingURL=contract.d.ts.map

package/dist/src/narrative/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/narrative/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,aAAa,CAAC;AAQvD,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAMlC;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;CAOf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAExD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,mEAAoE,CAAC;AAC7F,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,eAAO,MAAM,WAAW,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,SAC2B,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,eAAe,wDAAyD,CAAC;AACtF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAM5D,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,WAAuB,CAAC;AACvE,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,WAAiC,CAAC;AACpF,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,WAAiC,CAAC;AAEpF,mEAAmE;AACnE,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,WAAuB,CAAC;AACtE,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,YAClB,CAAC;AAM3C,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,cAAc,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,wFAAwF;IACxF,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAkCnD;AAED,iFAAiF;AACjF,YAAY,EAAE,MAAM,EAAE,CAAC;AAQvB,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGtF;AAED,oFAAoF;AACpF,eAAO,MAAM,UAAU,GAAI,GAAG,WAAW,GAAG,SAAS,KAAG,OAClB,CAAC;AAEvC,eAAO,MAAM,cAAc,GAAI,GAAG,WAAW,EAAE,SAAS,MAAM,4BACpB,CAAC;AAC3C,eAAO,MAAM,iBAAiB,GAAI,GAAG,WAAW,EAAE,SAAS,MAAM,4BACpB,CAAC;AAC9C,eAAO,MAAM,iBAAiB,GAAI,GAAG,WAAW,EAAE,SAAS,MAAM,4BACpB,CAAC;AAE9C;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAQjF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAQ7E;AAED,oFAAoF;AACpF,MAAM,WAAW,QAAQ;IACvB,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,0EAA0E;IAC1E,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,CA8BnE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAQ3E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,cAAc,EAAE,CAYnF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAOpD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,MAAM,CAO3E"}

package/dist/src/narrative/contract.js

@@ -0,0 +1,274 @@
+/**
+ * COAIA Narrative — the store read contract.
+ *
+ * WHAT THIS IS FOR
+ *
+ * This package owns the writes. Anything that renders a chart store was, until now,
+ * re-deriving the store's shape by hand — entity-kind strings, the `${chartId}_chart`
+ * naming scheme, which metadata key holds the MMOT trail. That knowledge living in two
+ * places is not a style problem: when it drifts, a renderer does not break, it quietly
+ * renders LESS. A chart holding real work looks identical to an empty one.
+ *
+ * HOW IT AVOIDS BEING THE THING IT WARNS ABOUT
+ *
+ * The first draft of this module re-implemented record classification by hand, and a
+ * review measured it returning 73 entities where the writer's own parser returned 76 —
+ * it dropped the legacy `type:"narrative_beat"` dialect and reported the losses as
+ * corruption. Duplication relocated rather than removed.
+ *
+ * So classification is NOT defined here. `./jsonl-records.js` holds the single
+ * definition, and both the writer (jsonl-preservation.ts) and this contract import it.
+ * What this module adds on top is the two things the writer's parser genuinely does not
+ * offer a renderer: per-line TOLERANCE (parseJsonlMemory throws on one bad line, which
+ * is correct for a writer and fatal for a surface), and the selectors/naming below.
+ *
+ * THREE RULES THIS MODULE KEEPS
+ *
+ * 1. Zero I/O. No `fs`, no `process`, no network. Callers own reading; this owns shape.
+ * 2. Never imports the server. The package's `main` IS the MCP bootstrap — importing the
+ *    package root starts a stdio server — which is why this lives behind its own subpath.
+ * 3. Tolerant by construction, honest about what it skipped.
+ */
+import { isEntityRecord, isLegacyNarrativeBeatRecord, isRelationRecord, normalizeLegacyNarrativeBeat, } from './jsonl-records.js';
+/** Bumped when a shape changes in a way a reader must notice. */
+export const CONTRACT_VERSION = 2;
+// ---------------------------------------------------------------------------
+// Entity kinds
+// ---------------------------------------------------------------------------
+/**
+ * Every entityType this package writes. `test-contract.js` scans this package's own
+ * source and fails if a kind is written that this list does not publish — so the
+ * contract cannot fall behind the writer without the suite going red.
+ */
+export const ENTITY_TYPES = {
+    chart: 'structural_tension_chart',
+    desiredOutcome: 'desired_outcome',
+    currentReality: 'current_reality',
+    actionStep: 'action_step',
+    narrativeBeat: 'narrative_beat',
+    wampumBelt: 'wampum_belt',
+};
+/**
+ * MMOT phases, as the writer accepts them. `'full'` is included deliberately: it is the
+ * tool's DEFAULT (`phase: string = 'full'`) and appears in live stores. An earlier draft
+ * omitted it, which would have made a phase rail built from this list silently drop
+ * every default-phase evaluation.
+ */
+export const MMOT_PHASES = ['full', 'acknowledge', 'analyze', 'update', 'recommit'];
+export const isMmotPhase = (v) => typeof v === 'string' && MMOT_PHASES.includes(v);
+/**
+ * Fritz's creating phases, carried on a chart as `metadata.phase`. Published alongside
+ * MMOT_PHASES because both occupy the key `phase` in different records, and a reader
+ * that assumes one vocabulary when it holds the other gets a confident wrong answer.
+ */
+export const CREATING_PHASES = ['germination', 'assimilation', 'completion'];
+// ---------------------------------------------------------------------------
+// Naming scheme
+// ---------------------------------------------------------------------------
+export const chartEntityName = (chartId) => `${chartId}_chart`;
+export const desiredOutcomeName = (chartId) => `${chartId}_desired_outcome`;
+export const currentRealityName = (chartId) => `${chartId}_current_reality`;
+/** MMOT narrative beats are named `${chartId}_mmot_${epochMs}`. */
+export const mmotBeatPrefix = (chartId) => `${chartId}_mmot_`;
+export const isMmotBeatName = (name, chartId) => name.startsWith(mmotBeatPrefix(chartId));
+// ---------------------------------------------------------------------------
+// Parsing
+// ---------------------------------------------------------------------------
+/**
+ * Parse raw JSONL store content. Pure: give it a string, get records back.
+ *
+ * Classification is delegated to the writer's own predicates, so every dialect the
+ * writer round-trips — including the legacy top-level `type:"narrative_beat"` form — is
+ * read here identically. The only behaviour added is per-line tolerance: one unparseable
+ * line is skipped rather than throwing away the whole store, which is what a live
+ * surface needs and what `parseJsonlMemory` deliberately does not do.
+ *
+ * WHAT `skipped` CANNOT TELL YOU. Since writeJsonlMemoryFile became atomic (temp +
+ * rename) a reader should never see a torn file at all, and `skipped > 0` now genuinely
+ * suggests a foreign or damaged line. But a store truncated by something OTHER than this
+ * package can still be a syntactically perfect PREFIX — every whole line parses, and the
+ * result is simply a smaller store with `skipped === 0`. No reader can detect that from
+ * content alone. If that matters to a caller, compare entity counts across reads.
+ */
+export function parseStore(raw) {
+    const entities = new Map();
+    const relations = [];
+    let skipped = 0;
+    for (const line of raw.split('\n')) {
+        if (line.trim() === '')
+            continue;
+        let record;
+        try {
+            const parsed = JSON.parse(line);
+            if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+                skipped++;
+                continue;
+            }
+            record = parsed;
+        }
+        catch {
+            skipped++;
+            continue;
+        }
+        if (isEntityRecord(record)) {
+            entities.set(record.name, record);
+        }
+        else if (isRelationRecord(record)) {
+            relations.push(record);
+        }
+        else if (isLegacyNarrativeBeatRecord(record)) {
+            const normalized = normalizeLegacyNarrativeBeat(record);
+            entities.set(normalized.name, normalized);
+        }
+        else {
+            skipped++;
+        }
+    }
+    return { entities, relations, skipped };
+}
+// ---------------------------------------------------------------------------
+// Selectors
+// ---------------------------------------------------------------------------
+const meta = (e) => (e && e.metadata) || {};
+/** Read a string-valued metadata key, or undefined when absent or the wrong type. */
+export function metaString(e, key) {
+    const v = meta(e)[key];
+    return typeof v === 'string' ? v : undefined;
+}
+/** A step or chart is complete when `metadata.completionStatus` is exactly true. */
+export const isComplete = (e) => meta(e)['completionStatus'] === true;
+export const getChartEntity = (s, chartId) => s.entities.get(chartEntityName(chartId));
+export const getDesiredOutcome = (s, chartId) => s.entities.get(desiredOutcomeName(chartId));
+export const getCurrentReality = (s, chartId) => s.entities.get(currentRealityName(chartId));
+/**
+ * FLAT action steps only — `action_step` entities carrying this chart's id.
+ *
+ * Read the name literally: this is NOT "the chart's work". Only steps passed in the
+ * `actionSteps[]` array at chart creation become `action_step` entities. `add_action_step`
+ * creates a TELESCOPED CHILD CHART instead, and its step is that child's desired outcome.
+ * In the live seat store, 49 of 71 charts carry a parent — most work is telescoped and
+ * invisible here. Use `getWork` unless you specifically want the flat ones.
+ */
+export function getFlatActionSteps(s, chartId) {
+    const out = [];
+    for (const e of s.entities.values()) {
+        if (e.entityType === ENTITY_TYPES.actionStep && meta(e)['chartId'] === chartId) {
+            out.push(e);
+        }
+    }
+    return out;
+}
+/**
+ * Charts telescoped beneath this one — full charts whose `parentChart` points back here.
+ */
+export function getChildCharts(s, chartId) {
+    const out = [];
+    for (const e of s.entities.values()) {
+        if (e.entityType === ENTITY_TYPES.chart && meta(e)['parentChart'] === chartId) {
+            out.push(e);
+        }
+    }
+    return out;
+}
+/**
+ * Everything a chart is actually holding: flat action steps PLUS telescoped children,
+ * in one list. This is what a progress indicator or a chart view wants — counting only
+ * flat steps is precisely the bug that made get_chart_progress report 0/0 for charts
+ * full of telescoped work.
+ */
+export function getWork(s, chartId) {
+    const out = [];
+    for (const e of getFlatActionSteps(s, chartId)) {
+        out.push({
+            id: e.name,
+            title: e.observations?.[0] ?? e.name,
+            completed: isComplete(e),
+            dueDate: metaString(e, 'dueDate'),
+            updatedAt: metaString(e, 'updatedAt'),
+            telescoped: false,
+            entity: e,
+        });
+    }
+    for (const e of getChildCharts(s, chartId)) {
+        const childId = metaString(e, 'chartId') ?? e.name.replace(/_chart$/, '');
+        const childOutcome = getDesiredOutcome(s, childId);
+        out.push({
+            id: childId,
+            title: childOutcome?.observations?.[0] ?? childId,
+            completed: isComplete(e),
+            dueDate: metaString(e, 'dueDate'),
+            updatedAt: metaString(e, 'updatedAt'),
+            telescoped: true,
+            entity: e,
+        });
+    }
+    return out;
+}
+export function getMmotBeats(s, chartId) {
+    const out = [];
+    for (const e of s.entities.values()) {
+        if (e.entityType === ENTITY_TYPES.narrativeBeat && isMmotBeatName(e.name, chartId)) {
+            out.push(e);
+        }
+    }
+    return out;
+}
+/**
+ * The chart's MMOT trail, normalized. Lives on the CHART entity's metadata, not on
+ * current reality — the two are separate records, and a caller may write the trail
+ * while deliberately leaving current reality alone.
+ */
+export function getMmotEvaluations(chart) {
+    const raw = meta(chart)['mmotEvaluations'];
+    if (!Array.isArray(raw))
+        return [];
+    return raw.map((ev) => {
+        const r = (ev || {});
+        return {
+            phase: String(r['phase'] ?? ''),
+            assessment: String(r['assessment'] ?? ''),
+            direction: typeof r['direction'] === 'string' ? r['direction'] : undefined,
+            timestamp: typeof r['timestamp'] === 'string' ? r['timestamp'] : undefined,
+        };
+    });
+}
+/**
+ * A content-derived revision token for the WHOLE store — newest timestamp, plus the
+ * record counts.
+ *
+ * The counts are not decoration. Two mutations this package performs move no timestamp
+ * a chart-scoped scan would see: `updateActionProgress` stamps the step but not the
+ * chart, and `removeActionStep` stamps nothing at all. A token built only from
+ * `max(updatedAt)` therefore holds steady across a progress update AND across a
+ * deletion — so a renderer caching on it serves a removed action step forever. Folding
+ * in `entities.size` and `relations.length` makes a deletion move the token.
+ *
+ * Still derived from content, never from a file mtime: an mtime changes when the store
+ * is rewritten with identical bytes, which makes every reader refetch for nothing and
+ * makes a real change indistinguishable from a no-op rewrite.
+ */
+export function storeRevision(s) {
+    let newest = '';
+    for (const e of s.entities.values()) {
+        const u = metaString(e, 'updatedAt') ?? metaString(e, 'createdAt') ?? '';
+        if (u > newest)
+            newest = u;
+    }
+    return `${newest}|${s.entities.size}|${s.relations.length}`;
+}
+/**
+ * Revision across a specific set of entities. Narrower than `storeRevision` and subject
+ * to the blind spots described there — a progress update or a deletion may not move it.
+ * Prefer `storeRevision` for cache keys; use this only when a per-chart token is
+ * genuinely required and its limits are understood.
+ */
+export function revisionOf(entities) {
+    let revision = '';
+    for (const e of entities) {
+        const u = metaString(e, 'updatedAt') ?? metaString(e, 'createdAt') ?? '';
+        if (u > revision)
+            revision = u;
+    }
+    return revision;
+}
+//# sourceMappingURL=contract.js.map

package/dist/src/narrative/contract.js.map

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