@mastishk/core 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+# @mastishk/core
+
+Core library for the [Mastishk protocol](https://mastishk.dev) — schema, validation, read, write, graph, traversal, and context injection for persistent AI agent memory.
+
+## Install
+
+```bash
+npm install @mastishk/core
+```
+
+## Usage
+
+```typescript
+import { readNode, writeNode, inject, readMemoryMap } from '@mastishk/core';
+
+// Read a memory node
+const node = await readNode('.mastishk/intent/goal-launch-v1.msk.md');
+
+// Write a new node
+await writeNode('.mastishk/state/task-build-auth.msk.md', {
+  id: 'task-build-auth',
+  type: 'task',
+  layer: 'state',
+  status: 'active',
+  confidence: 1.0,
+  created_by: 'claude-code',
+  created_at: new Date().toISOString(),
+  last_updated_by: 'claude-code',
+  last_updated_at: new Date().toISOString(),
+  dependencies: ['goal-launch-v1'],
+  contradictions: [],
+  body: 'Implement JWT authentication.',
+});
+
+// Get inject context for a task
+const context = await inject('build authentication', '.mastishk');
+// Returns formatted context string ready for an agent system prompt
+```
+
+## API
+
+### `readNode(filePath): Promise<MskNode>`
+Parse a `.msk.md` file into a validated `MskNode`. Throws `MskReadError` if invalid.
+
+### `writeNode(filePath, node): Promise<void>`
+Write a node to disk. State-layer writes are append-only with timestamp headers. Throws `MskWriteError` if validation fails.
+
+### `inject(task, mastishkDir): Promise<string>`
+Tokenise the task, match against node IDs and tags, traverse the DAG at depth 2, and return a formatted context string per spec section 6.3.
+
+### `validate(node): { valid: boolean; errors: string[] }`
+Validate any object against the `MskNodeSchema`.
+
+### `readMemoryMap(filePath) / writeMemoryMap(filePath, map)`
+Read/write the `memory-map.json` DAG index.
+
+### `upsertNode(map, id, entry): MemoryMap`
+Add or update a node in the memory map and rebuild edges.
+
+### `traverse(map, seedIds, options): TraversalResult[]`
+DFS traversal from seed nodes following dependency edges.
+
+### `validateGraph(map) / assertValidGraph(map)`
+Check for cycles, dangling references, and duplicate IDs.
+
+## Protocol
+
+- Spec: [MASTISHK-SPEC.md](https://github.com/mastishk-ai/mastishk/blob/main/MASTISHK-SPEC.md)
+- Website: [mastishk.dev](https://mastishk.dev)
+- License: Apache 2.0

package/dist/graph.d.ts

@@ -0,0 +1,36 @@
+import type { MskLayer, MskType, MskStatus } from './schema.js';
+export interface MemoryMapNode {
+    file: string;
+    layer: MskLayer;
+    type: MskType;
+    status: MskStatus;
+    confidence: number;
+    dependencies: string[];
+    tags?: string[];
+}
+export interface MemoryMapEdge {
+    from: string;
+    to: string;
+    relation: string;
+}
+export interface MemoryMap {
+    version: string;
+    updated_at: string;
+    nodes: Record<string, MemoryMapNode>;
+    edges: MemoryMapEdge[];
+}
+export declare class MskGraphError extends Error {
+    readonly violation: 'cycle' | 'dangling' | 'duplicate';
+    constructor(message: string, violation: 'cycle' | 'dangling' | 'duplicate');
+}
+export declare function createEmptyMemoryMap(): MemoryMap;
+export declare function readMemoryMap(filePath: string): Promise<MemoryMap>;
+export declare function writeMemoryMap(filePath: string, map: MemoryMap): Promise<void>;
+export declare function validateGraph(map: MemoryMap): {
+    valid: boolean;
+    errors: string[];
+};
+export declare function assertValidGraph(map: MemoryMap): void;
+export declare function upsertNode(map: MemoryMap, id: string, entry: MemoryMapNode): MemoryMap;
+export declare function removeNode(map: MemoryMap, id: string): MemoryMap;
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIhE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACrC,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAGD,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;gBAE3C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,UAAU,GAAG,WAAW;CAK3E;AAED,wBAAgB,oBAAoB,IAAI,SAAS,CAOhD;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAQxE;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpF;AAkCD,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAkBlF;AAGD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAQrD;AAeD,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,SAAS,CAGtF;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAGhE"}

package/dist/graph.js

@@ -0,0 +1,116 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+// Spec section 5.2 — typed error for DAG constraint violations
+export class MskGraphError extends Error {
+    violation;
+    constructor(message, violation) {
+        super(message);
+        this.name = 'MskGraphError';
+        this.violation = violation;
+    }
+}
+export function createEmptyMemoryMap() {
+    return {
+        version: '0.1',
+        updated_at: new Date().toISOString(),
+        nodes: {},
+        edges: [],
+    };
+}
+export async function readMemoryMap(filePath) {
+    let raw;
+    try {
+        raw = await readFile(filePath, 'utf-8');
+    }
+    catch (cause) {
+        throw new Error(`Cannot read memory-map.json at "${filePath}"`, { cause });
+    }
+    return JSON.parse(raw);
+}
+export async function writeMemoryMap(filePath, map) {
+    await mkdir(dirname(filePath), { recursive: true });
+    const updated = { ...map, updated_at: new Date().toISOString() };
+    await writeFile(filePath, JSON.stringify(updated, null, 2) + '\n', 'utf-8');
+}
+// Spec section 5.2 — cycle detection via DFS coloring (white/gray/black)
+function findCycle(nodes) {
+    const WHITE = 0, GRAY = 1, BLACK = 2;
+    const color = {};
+    for (const id of Object.keys(nodes))
+        color[id] = WHITE;
+    function dfs(id, path) {
+        color[id] = GRAY;
+        for (const dep of nodes[id]?.dependencies ?? []) {
+            if (!(dep in color))
+                continue; // dangling — caught separately
+            if (color[dep] === GRAY)
+                return [...path, id, dep].join(' → ');
+            if (color[dep] === WHITE) {
+                const cycle = dfs(dep, [...path, id]);
+                if (cycle)
+                    return cycle;
+            }
+        }
+        color[id] = BLACK;
+        return null;
+    }
+    for (const id of Object.keys(nodes)) {
+        if (color[id] === WHITE) {
+            const cycle = dfs(id, []);
+            if (cycle)
+                return cycle;
+        }
+    }
+    return null;
+}
+// Spec section 5.2 — validates no cycles, no dangling refs, unique IDs.
+// Returns { valid, errors } rather than throwing so callers can choose.
+// Use assertValidGraph() to get the typed throw behaviour.
+export function validateGraph(map) {
+    const errors = [];
+    const ids = new Set(Object.keys(map.nodes));
+    // No dangling references in dependencies
+    for (const [id, node] of Object.entries(map.nodes)) {
+        for (const dep of node.dependencies) {
+            if (!ids.has(dep)) {
+                errors.push(`Node "${id}" has dangling dependency: "${dep}"`);
+            }
+        }
+    }
+    // No cycles
+    const cycle = findCycle(map.nodes);
+    if (cycle)
+        errors.push(`Cycle detected: ${cycle}`);
+    return { valid: errors.length === 0, errors };
+}
+// Throws MskGraphError if any constraint is violated. Spec section 5.2.
+export function assertValidGraph(map) {
+    const { valid, errors } = validateGraph(map);
+    if (!valid) {
+        const hasCycle = errors.some((e) => e.startsWith('Cycle'));
+        const hasDangling = errors.some((e) => e.includes('dangling'));
+        const violation = hasCycle ? 'cycle' : hasDangling ? 'dangling' : 'duplicate';
+        throw new MskGraphError(errors.join('; '), violation);
+    }
+}
+// Rebuild edges array from dependencies — keeps edges consistent with node data.
+// SPEC-GAP: spec shows edges with semantic relation types (e.g. "serves") but does
+// not define how they are assigned. We use "depends-on" as the default relation.
+function rebuildEdges(nodes) {
+    const edges = [];
+    for (const [id, node] of Object.entries(nodes)) {
+        for (const dep of node.dependencies) {
+            edges.push({ from: id, to: dep, relation: 'depends-on' });
+        }
+    }
+    return edges;
+}
+export function upsertNode(map, id, entry) {
+    const nodes = { ...map.nodes, [id]: entry };
+    return { ...map, nodes, edges: rebuildEdges(nodes), updated_at: new Date().toISOString() };
+}
+export function removeNode(map, id) {
+    const { [id]: _removed, ...rest } = map.nodes;
+    return { ...map, nodes: rest, edges: rebuildEdges(rest), updated_at: new Date().toISOString() };
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { MskLayerSchema, MskTypeSchema, MskStatusSchema, MskNodeSchema, } from './schema.js';
+export type { MskLayer, MskType, MskStatus, MskNode } from './schema.js';
+export { validate } from './validate.js';
+export { readNode, MskReadError } from './read.js';
+export { writeNode, updateNodeMeta, MskWriteError } from './write.js';
+export { createEmptyMemoryMap, readMemoryMap, writeMemoryMap, validateGraph, assertValidGraph, upsertNode, removeNode, MskGraphError, } from './graph.js';
+export type { MemoryMap, MemoryMapNode, MemoryMapEdge } from './graph.js';
+export { traverse } from './traverse.js';
+export type { TraverseOptions, TraversalResult } from './traverse.js';
+export { inject } from './inject.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEtE,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1E,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { MskLayerSchema, MskTypeSchema, MskStatusSchema, MskNodeSchema, } from './schema.js';
+export { validate } from './validate.js';
+export { readNode, MskReadError } from './read.js';
+export { writeNode, updateNodeMeta, MskWriteError } from './write.js';
+export { createEmptyMemoryMap, readMemoryMap, writeMemoryMap, validateGraph, assertValidGraph, upsertNode, removeNode, MskGraphError, } from './graph.js';
+export { traverse } from './traverse.js';
+export { inject } from './inject.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEtE,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/inject.d.ts

@@ -0,0 +1,2 @@
+export declare function inject(task: string, mastishkDir: string): Promise<string>;
+//# sourceMappingURL=inject.d.ts.map

package/dist/inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../src/inject.ts"],"names":[],"mappings":"AAoDA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0E/E"}

package/dist/inject.js

@@ -0,0 +1,108 @@
+import { join } from 'node:path';
+import { readMemoryMap } from './graph.js';
+import { traverse } from './traverse.js';
+import { readNode } from './read.js';
+const LAYER_ORDER = { intent: 0, state: 1, knowledge: 2, issues: 3 };
+// SPEC-GAP: "token" is not defined by the spec (it is model-specific).
+// We approximate: 1 token ≈ 4 characters.
+const CHARS_PER_TOKEN = 4;
+const TOKEN_BUDGET = 2000;
+const CHAR_BUDGET = TOKEN_BUDGET * CHARS_PER_TOKEN;
+function tokenize(str) {
+    return str.toLowerCase().split(/\W+/).filter(Boolean);
+}
+// Score how well a node's id and tags match the task tokens.
+// SPEC-GAP: spec says match against id, tags, AND body content. Reading all node files
+// for body-content matching is expensive; we match id and tags from memory-map.json only.
+function matchScore(id, node, tokens) {
+    let score = 0;
+    const idParts = id.split('-');
+    for (const token of tokens) {
+        if (idParts.includes(token))
+            score += 2;
+        if (node.tags?.some((t) => t.toLowerCase() === token))
+            score += 1;
+    }
+    return score;
+}
+function firstSentence(text) {
+    const match = text.match(/^[^.!?]+[.!?]?/);
+    return (match?.[0] ?? text).trim();
+}
+async function readBodySafe(mastishkDir, file) {
+    try {
+        const node = await readNode(join(mastishkDir, file));
+        return node.body;
+    }
+    catch {
+        return '';
+    }
+}
+// Spec section 6.3 — render one node line
+function renderNodeLine(id, confidence, body, fullBody) {
+    const content = fullBody ? body : firstSentence(body);
+    return `**${id}** [${confidence.toFixed(1)}] — ${content}`;
+}
+// Spec section 6.2 — inject algorithm
+export async function inject(task, mastishkDir) {
+    const memoryMapPath = join(mastishkDir, 'memory-map.json');
+    const map = await readMemoryMap(memoryMapPath);
+    // Step 1-2: tokenize task, score and rank nodes by match
+    const tokens = tokenize(task);
+    const scored = Object.entries(map.nodes)
+        .map(([id, node]) => ({ id, node, score: matchScore(id, node, tokens) }))
+        .filter((x) => x.score > 0)
+        .sort((a, b) => b.node.confidence - a.node.confidence || b.score - a.score);
+    const seedIds = scored.map((x) => x.id);
+    // Step 3-4: traverse at depth 2, filter active + confidence >= 0.5
+    const traversed = traverse(map, seedIds, { depth: 2, statusFilter: ['active'], minConfidence: 0.5 });
+    // Step 5: sort by layer then confidence
+    traversed.sort((a, b) => {
+        const lo = (LAYER_ORDER[a.node.layer] ?? 99) - (LAYER_ORDER[b.node.layer] ?? 99);
+        return lo !== 0 ? lo : b.node.confidence - a.node.confidence;
+    });
+    // Read bodies for all traversed nodes
+    const bodies = await Promise.all(traversed.map((r) => readBodySafe(mastishkDir, r.node.file)));
+    const nodeData = traversed.map((r, i) => ({ ...r, body: bodies[i] }));
+    // Step 7: enforce 2000-token budget — drop lowest-confidence first
+    const header = `## Mastishk context — ${task}\nGenerated: ${new Date().toISOString()}\n`;
+    let charBudget = CHAR_BUDGET - header.length;
+    // Sort a copy by confidence asc for budget truncation, but keep display order
+    const budgetOrder = [...nodeData].sort((a, b) => a.node.confidence - b.node.confidence);
+    const excluded = new Set();
+    for (const item of budgetOrder) {
+        const line = renderNodeLine(item.id, item.node.confidence, item.body, item.node.confidence >= 0.9);
+        if (charBudget - line.length < 0) {
+            excluded.add(item.id);
+        }
+        else {
+            charBudget -= line.length + 1; // +1 for newline
+        }
+    }
+    const included = nodeData.filter((r) => !excluded.has(r.id));
+    // Step 6: format output per spec section 6.3
+    const byLayer = {
+        intent: included.filter((r) => r.node.layer === 'intent'),
+        state: included.filter((r) => r.node.layer === 'state'),
+        knowledge: included.filter((r) => r.node.layer === 'knowledge'),
+        issues: included.filter((r) => r.node.layer === 'issues'),
+    };
+    function renderSection(title, items) {
+        if (items.length === 0)
+            return '';
+        const lines = items
+            .map((r) => renderNodeLine(r.id, r.node.confidence, r.body, r.node.confidence >= 0.9))
+            .join('\n');
+        return `### ${title}\n${lines}\n`;
+    }
+    const sections = [
+        renderSection('Goals', byLayer.intent),
+        renderSection('Current state', byLayer.state),
+        renderSection('Knowledge', byLayer.knowledge),
+        renderSection('Open issues', byLayer.issues),
+    ]
+        .filter(Boolean)
+        .join('\n');
+    return `${header}\n${sections}`.trimEnd();
+}
+//# sourceMappingURL=inject.js.map

package/dist/inject.js.map

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

package/dist/read.d.ts

@@ -0,0 +1,9 @@
+import type { MskNode } from './schema.js';
+export declare class MskReadError extends Error {
+    readonly filePath: string;
+    readonly validationErrors: string[];
+    readonly rawContent: string;
+    constructor(filePath: string, validationErrors: string[], rawContent: string);
+}
+export declare function readNode(filePath: string): Promise<MskNode>;
+//# sourceMappingURL=read.d.ts.map

package/dist/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM;CAO7E;AAeD,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBjE"}

package/dist/read.js

@@ -0,0 +1,48 @@
+import { readFile } from 'node:fs/promises';
+import matter from 'gray-matter';
+import { validate } from './validate.js';
+export class MskReadError extends Error {
+    filePath;
+    validationErrors;
+    rawContent;
+    constructor(filePath, validationErrors, rawContent) {
+        super(`Invalid .msk.md at "${filePath}": ${validationErrors[0] ?? 'unknown error'}`);
+        this.name = 'MskReadError';
+        this.filePath = filePath;
+        this.validationErrors = validationErrors;
+        this.rawContent = rawContent;
+    }
+}
+// gray-matter uses js-yaml which auto-parses ISO 8601 strings to Date objects.
+// We normalize the known datetime fields back to ISO strings so Zod validation passes.
+function normalizeDateFields(data) {
+    const dateFields = ['created_at', 'last_updated_at', 'expires_at'];
+    const result = { ...data };
+    for (const field of dateFields) {
+        if (result[field] instanceof Date) {
+            result[field] = result[field].toISOString();
+        }
+    }
+    return result;
+}
+export async function readNode(filePath) {
+    let rawContent;
+    try {
+        rawContent = await readFile(filePath, 'utf-8');
+    }
+    catch (cause) {
+        throw new Error(`Cannot read file at "${filePath}"`, { cause });
+    }
+    const { data, content } = matter(rawContent);
+    const normalized = normalizeDateFields(data);
+    const candidate = {
+        ...normalized,
+        body: content.trim(),
+    };
+    const result = validate(candidate);
+    if (!result.valid) {
+        throw new MskReadError(filePath, result.errors, rawContent);
+    }
+    return candidate;
+}
+//# sourceMappingURL=read.js.map

package/dist/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,QAAQ,CAAS;IACjB,gBAAgB,CAAW;IAC3B,UAAU,CAAS;IAE5B,YAAY,QAAgB,EAAE,gBAA0B,EAAE,UAAkB;QAC1E,KAAK,CAAC,uBAAuB,QAAQ,MAAM,gBAAgB,CAAC,CAAC,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;QACrF,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,+EAA+E;AAC/E,uFAAuF;AACvF,SAAS,mBAAmB,CAAC,IAA6B;IACxD,MAAM,UAAU,GAAG,CAAC,YAAY,EAAE,iBAAiB,EAAE,YAAY,CAAU,CAAC;IAC5E,MAAM,MAAM,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IACpD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;YAClC,MAAM,CAAC,KAAK,CAAC,GAAI,MAAM,CAAC,KAAK,CAAU,CAAC,WAAW,EAAE,CAAC;QACxD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAA+B,CAAC,CAAC;IAExE,MAAM,SAAS,GAAG;QAChB,GAAG,UAAU;QACb,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;KACrB,CAAC;IAEF,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,SAAoB,CAAC;AAC9B,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+export declare const MskLayerSchema: z.ZodEnum<["intent", "state", "knowledge", "issues"]>;
+export declare const MskTypeSchema: z.ZodEnum<["goal", "task", "decision", "constraint", "issue", "fact"]>;
+export declare const MskStatusSchema: z.ZodEnum<["active", "resolved", "deprecated", "draft"]>;
+export declare const MskNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<["goal", "task", "decision", "constraint", "issue", "fact"]>;
+    layer: z.ZodEnum<["intent", "state", "knowledge", "issues"]>;
+    status: z.ZodEnum<["active", "resolved", "deprecated", "draft"]>;
+    confidence: z.ZodNumber;
+    created_by: z.ZodString;
+    created_at: z.ZodString;
+    last_updated_by: z.ZodString;
+    last_updated_at: z.ZodString;
+    dependencies: z.ZodArray<z.ZodString, "many">;
+    contradictions: z.ZodArray<z.ZodString, "many">;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    scanned: z.ZodOptional<z.ZodBoolean>;
+    verified: z.ZodOptional<z.ZodBoolean>;
+    expires_at: z.ZodOptional<z.ZodString>;
+    body: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    type: "goal" | "task" | "decision" | "constraint" | "issue" | "fact";
+    layer: "intent" | "state" | "knowledge" | "issues";
+    status: "active" | "resolved" | "deprecated" | "draft";
+    confidence: number;
+    created_by: string;
+    created_at: string;
+    last_updated_by: string;
+    last_updated_at: string;
+    dependencies: string[];
+    contradictions: string[];
+    body: string;
+    tags?: string[] | undefined;
+    scanned?: boolean | undefined;
+    verified?: boolean | undefined;
+    expires_at?: string | undefined;
+}, {
+    id: string;
+    type: "goal" | "task" | "decision" | "constraint" | "issue" | "fact";
+    layer: "intent" | "state" | "knowledge" | "issues";
+    status: "active" | "resolved" | "deprecated" | "draft";
+    confidence: number;
+    created_by: string;
+    created_at: string;
+    last_updated_by: string;
+    last_updated_at: string;
+    dependencies: string[];
+    contradictions: string[];
+    body: string;
+    tags?: string[] | undefined;
+    scanned?: boolean | undefined;
+    verified?: boolean | undefined;
+    expires_at?: string | undefined;
+}>;
+export type MskLayer = z.infer<typeof MskLayerSchema>;
+export type MskType = z.infer<typeof MskTypeSchema>;
+export type MskStatus = z.infer<typeof MskStatusSchema>;
+export type MskNode = z.infer<typeof MskNodeSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,cAAc,uDAAqD,CAAC;AAEjF,eAAO,MAAM,aAAa,wEAAsE,CAAC;AAEjG,eAAO,MAAM,eAAe,0DAAwD,CAAC;AAcrF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBxB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/schema.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+// Spec section 3.2 — YAML frontmatter enums
+export const MskLayerSchema = z.enum(['intent', 'state', 'knowledge', 'issues']);
+export const MskTypeSchema = z.enum(['goal', 'task', 'decision', 'constraint', 'issue', 'fact']);
+export const MskStatusSchema = z.enum(['active', 'resolved', 'deprecated', 'draft']);
+// ISO 8601 datetime — spec requires timestamps in created_at, last_updated_at, expires_at
+const iso8601 = z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$/, 'Must be an ISO 8601 datetime (e.g. 2026-05-12T00:00:00Z)');
+// Spec section 3.1 — id must be kebab-case and unique within the project
+const kebabCase = z.string().regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, 'Must be kebab-case (lowercase letters, numbers, and hyphens only)');
+export const MskNodeSchema = z.object({
+    // --- Required fields (spec section 3.2) ---
+    id: kebabCase,
+    type: MskTypeSchema,
+    layer: MskLayerSchema,
+    status: MskStatusSchema,
+    confidence: z.number().min(0, 'confidence must be >= 0.0').max(1, 'confidence must be <= 1.0'),
+    created_by: z.string().min(1, 'created_by must not be empty'),
+    created_at: iso8601,
+    last_updated_by: z.string().min(1, 'last_updated_by must not be empty'),
+    last_updated_at: iso8601,
+    dependencies: z.array(z.string()),
+    contradictions: z.array(z.string()),
+    // --- Optional fields (spec section 3.2) ---
+    tags: z.array(z.string()).optional(),
+    scanned: z.boolean().optional(),
+    verified: z.boolean().optional(),
+    expires_at: iso8601.optional(),
+    // --- Body content (spec section 3.3) ---
+    // The markdown body following the YAML frontmatter block.
+    // SPEC-GAP: spec says body MUST be valid markdown but does not define it as a named field.
+    // We model it as `body: string` on the node for uniform access after gray-matter parsing.
+    body: z.string(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,4CAA4C;AAE5C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEjF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;AAErF,0FAA0F;AAC1F,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAC9B,kEAAkE,EAClE,0DAA0D,CAC3D,CAAC;AAEF,yEAAyE;AACzE,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAChC,0BAA0B,EAC1B,mEAAmE,CACpE,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,6CAA6C;IAC7C,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,eAAe;IACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;IAC9F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,8BAA8B,CAAC;IAC7D,UAAU,EAAE,OAAO;IACnB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mCAAmC,CAAC;IACvE,eAAe,EAAE,OAAO;IACxB,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAEnC,6CAA6C;IAC7C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE;IAE9B,0CAA0C;IAC1C,0DAA0D;IAC1D,2FAA2F;IAC3F,0FAA0F;IAC1F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC"}

package/dist/traverse.d.ts

@@ -0,0 +1,13 @@
+import type { MemoryMap, MemoryMapNode } from './graph.js';
+export interface TraverseOptions {
+    depth?: number;
+    statusFilter?: string[];
+    minConfidence?: number;
+}
+export interface TraversalResult {
+    id: string;
+    node: MemoryMapNode;
+    depth: number;
+}
+export declare function traverse(map: MemoryMap, seedIds: string[], options?: TraverseOptions): TraversalResult[];
+//# sourceMappingURL=traverse.d.ts.map

package/dist/traverse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse.d.ts","sourceRoot":"","sources":["../src/traverse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3D,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAGD,wBAAgB,QAAQ,CACtB,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,GAAE,eAAoB,GAC5B,eAAe,EAAE,CAgCnB"}

package/dist/traverse.js

@@ -0,0 +1,29 @@
+// Spec section 5.3 — traverse the DAG from seedIds following dependency edges outward.
+export function traverse(map, seedIds, options = {}) {
+    const { depth = 2, statusFilter = ['active'], minConfidence = 0.5, } = options;
+    const visited = new Set();
+    const results = [];
+    function visit(id, currentDepth) {
+        if (visited.has(id))
+            return;
+        if (currentDepth > depth)
+            return;
+        const node = map.nodes[id];
+        if (!node)
+            return;
+        if (!statusFilter.includes(node.status))
+            return;
+        if (node.confidence < minConfidence)
+            return;
+        visited.add(id);
+        results.push({ id, node, depth: currentDepth });
+        for (const depId of node.dependencies) {
+            visit(depId, currentDepth + 1);
+        }
+    }
+    for (const seedId of seedIds) {
+        visit(seedId, 0);
+    }
+    return results;
+}
+//# sourceMappingURL=traverse.js.map

package/dist/traverse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse.js","sourceRoot":"","sources":["../src/traverse.ts"],"names":[],"mappings":"AAeA,uFAAuF;AACvF,MAAM,UAAU,QAAQ,CACtB,GAAc,EACd,OAAiB,EACjB,UAA2B,EAAE;IAE7B,MAAM,EACJ,KAAK,GAAG,CAAC,EACT,YAAY,GAAG,CAAC,QAAQ,CAAC,EACzB,aAAa,GAAG,GAAG,GACpB,GAAG,OAAO,CAAC;IAEZ,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,SAAS,KAAK,CAAC,EAAU,EAAE,YAAoB;QAC7C,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO;QAC5B,IAAI,YAAY,GAAG,KAAK;YAAE,OAAO;QAEjC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO;QAChD,IAAI,IAAI,CAAC,UAAU,GAAG,aAAa;YAAE,OAAO;QAE5C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;QAEhD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtC,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,5 @@
+export declare function validate(node: unknown): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAEA,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAS5E"}

package/dist/validate.js

@@ -0,0 +1,10 @@
+import { MskNodeSchema } from './schema.js';
+export function validate(node) {
+    const result = MskNodeSchema.safeParse(node);
+    if (result.success) {
+        return { valid: true, errors: [] };
+    }
+    const errors = result.error.errors.map((e) => `${e.path.join('.') || '(root)'}: ${e.message}`);
+    return { valid: false, errors };
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CACvD,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC"}

package/dist/write.d.ts

@@ -0,0 +1,9 @@
+import type { MskNode } from './schema.js';
+export declare class MskWriteError extends Error {
+    readonly filePath: string;
+    readonly validationErrors: string[];
+    constructor(filePath: string, validationErrors: string[]);
+}
+export declare function writeNode(filePath: string, node: MskNode): Promise<void>;
+export declare function updateNodeMeta(filePath: string, updates: Partial<Omit<MskNode, 'id' | 'body'>>): Promise<void>;
+//# sourceMappingURL=write.d.ts.map

package/dist/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../src/write.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;gBAExB,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE;CAMzD;AAuBD,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC9E;AAKD,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,CAAC,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/write.js

@@ -0,0 +1,90 @@
+import { writeFile, mkdir, readFile, access } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import matter from 'gray-matter';
+import { validate } from './validate.js';
+import { readNode } from './read.js';
+export class MskWriteError extends Error {
+    filePath;
+    validationErrors;
+    constructor(filePath, validationErrors) {
+        super(`Cannot write invalid node to "${filePath}": ${validationErrors.join('; ')}`);
+        this.name = 'MskWriteError';
+        this.filePath = filePath;
+        this.validationErrors = validationErrors;
+    }
+}
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// Remove undefined-valued keys so they don't appear as `null` in YAML output.
+// SPEC-GAP: spec does not define how optional fields with no value should be serialized.
+function stripUndefined(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined));
+}
+function serialize(node) {
+    const { body, ...rest } = node;
+    const frontmatter = stripUndefined(rest);
+    return matter.stringify(body, frontmatter);
+}
+export async function writeNode(filePath, node) {
+    const result = validate(node);
+    if (!result.valid) {
+        throw new MskWriteError(filePath, result.errors);
+    }
+    // Spec section 7.1: always update last_updated_at before writing.
+    const updatedNode = {
+        ...node,
+        last_updated_at: new Date().toISOString(),
+    };
+    await mkdir(dirname(filePath), { recursive: true });
+    let content;
+    if (node.layer === 'state') {
+        // Spec section 7.2: state layer writes MUST be append-only.
+        const appendHeader = `### ${updatedNode.last_updated_at} — ${updatedNode.last_updated_by}`;
+        if (await fileExists(filePath)) {
+            const raw = await readFile(filePath, 'utf-8');
+            const existingBody = matter(raw).content.trim();
+            const newBody = `${existingBody}\n\n${appendHeader}\n\n${updatedNode.body.trim()}`;
+            content = serialize({ ...updatedNode, body: newBody });
+        }
+        else {
+            // First write to a state node: still wrap in the append header format.
+            const newBody = `${appendHeader}\n\n${updatedNode.body.trim()}`;
+            content = serialize({ ...updatedNode, body: newBody });
+        }
+    }
+    else {
+        // intent, knowledge: replace body content.
+        // SPEC-GAP: spec section 4.3 says knowledge writes MUST "preserve the full frontmatter history"
+        // but does not define the file format for this. We replace body and update frontmatter fields only.
+        // SPEC-GAP: spec section 4.4 says issue nodes must be append-only (never deleted) but does not
+        // explicitly require append-only body content the way section 7.2 does for state. Treating as replace.
+        content = serialize(updatedNode);
+    }
+    await writeFile(filePath, content, 'utf-8');
+}
+// SPEC-GAP: spec does not define a metadata-only update path. This is needed by the
+// CLI `update` command to change status/confidence without triggering state-layer append.
+// Reads the existing file, applies frontmatter-only updates, preserves body exactly.
+export async function updateNodeMeta(filePath, updates) {
+    const existing = await readNode(filePath);
+    const updated = {
+        ...existing,
+        ...updates,
+        id: existing.id,
+        body: existing.body,
+        last_updated_at: new Date().toISOString(),
+    };
+    const result = validate(updated);
+    if (!result.valid) {
+        throw new MskWriteError(filePath, result.errors);
+    }
+    await writeFile(filePath, serialize(updated), 'utf-8');
+}
+//# sourceMappingURL=write.js.map

package/dist/write.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@mastishk/core",
+  "version": "0.1.0",
+  "description": "Core schema, validation, read, write, graph, and inject for the Mastishk protocol.",
+  "license": "Apache-2.0",
+  "author": "Mastishk Protocol Contributors",
+  "homepage": "https://mastishk.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mastishk-ai/mastishk.git",
+    "directory": "src/packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/mastishk-ai/mastishk/issues"
+  },
+  "keywords": [
+    "ai", "agent", "memory", "mcp", "claude", "cursor", "llm",
+    "markdown", "dag", "protocol", "mastishk"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "gray-matter": "^4.0.3",
+    "zod": "^3.23.8"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}