@miadi/episodic-memory-schema 0.1.0 → 0.2.0

package/README.md

@@ -115,10 +115,55 @@ Work the manuscript *implies* but did not complete. Each commission becomes a ca
 
 ---
 
+## Compatibility-first observation
+
+Historical Chronicle sources do not need to satisfy the strict `EpisodicMemory`
+authored schema before they can be inspected. The additive observation API reads
+a source into a deterministic, diagnostic-rich description without rewriting it:
+
+```ts
+import {
+  observeCompositionManifest,
+  observeEpisodeDirectory,
+  observeEpisodeYamlManifest
+} from "@miadi/episodic-memory-schema"
+
+const composition = observeCompositionManifest(compositionJson, {
+  relativePath: "ep097-ceremony-agent-skills/composition.json"
+})
+
+// Parsing YAML is intentionally caller-owned.
+const manifest = observeEpisodeYamlManifest(parsedEpisodeYaml, {
+  relativePath: "2026-06-21-episode-076-plan-to-episode-pipeline/episode.yaml"
+})
+
+// Directory traversal is also caller-owned; pass a read-only snapshot.
+const inferred = observeEpisodeDirectory({
+  entries: ["AGENTS.md", "AUDIO-MANIFEST.md", "source-ledger.md"]
+}, {
+  relativePath: "2026-06-21-episode-075-claude-plans-dothome-concepts"
+})
+```
+
+The result exposes identity candidates, typed source metadata, source-relative
+artifact references, episode relations, compatibility diagnostics, and fields
+that were not structurally projected. Its identity is derived from the source
+path rather than from an episode number alone.
+
+The adapters cover composition manifests, already-parsed `episode.yaml`
+manifests, and caller-supplied directory snapshots. They have no filesystem or
+YAML-parser dependency. Projection into strict `EpisodicMemory` remains a
+separate, explicit future operation; observation never silently promotes or
+modifies source material.
+
+---
+
 ## Versioning
 
-- v0.1.0 (current) — initial schema; expect minor additions before v1.0
-- Schema version is encoded in the `schemaVersion` field, not just the package version
+- v0.2.0 (current) — compatibility-first observation adapters for composition manifests, parsed episode YAML, and descriptor-light directory snapshots
+- v0.1.1 — strict authored episodic-memory types and JSON Schema
+- The package release is `0.2.0`; the authored memory schema remains `episodic-memory.v1.0`
+- Schema version is encoded in the `schemaVersion` field, independently of the package version
 
 ---
 

package/dist/adapters/common.d.ts

@@ -0,0 +1,14 @@
+import type { ArtifactKind, EpisodeSourceFormat } from "../observation.js";
+export type JsonRecord = Record<string, unknown>;
+export declare function isRecord(value: unknown): value is JsonRecord;
+export declare function cloneValue(value: unknown): unknown;
+export declare function cloneRecordExcept(input: JsonRecord, excluded: readonly string[]): Record<string, unknown>;
+export declare function validateRelativePath(value: string): string;
+export declare function tryValidateRelativePath(value: string): string | undefined;
+export declare function observationId(format: EpisodeSourceFormat, relativePath: string): string;
+export declare function resolveSiblingPath(sourceDocumentPath: string, artifactPath: string): string | undefined;
+export declare function resolveChildPath(directoryPath: string, childPath: string): string | undefined;
+export declare function inferArtifactKind(filename: string, defaultKind?: ArtifactKind): ArtifactKind;
+export declare function extractEpisodeNumber(value: string): string | undefined;
+export declare function pathBasename(relativePath: string): string;
+//# sourceMappingURL=common.d.ts.map

package/dist/adapters/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/adapters/common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE1E,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEhD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAE5D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASlD;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAqB1D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMzE;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,mBAAmB,EAC3B,YAAY,EAAE,MAAM,GACnB,MAAM,CAER;AAED,wBAAgB,kBAAkB,CAChC,kBAAkB,EAAE,MAAM,EAC1B,YAAY,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAMpB;AAED,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,YAAsB,GAClC,YAAY,CAQd;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGtE;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAIzD"}

package/dist/adapters/common.js

@@ -0,0 +1,95 @@
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function cloneValue(value) {
+    if (value instanceof Date)
+        return new Date(value.getTime());
+    if (Array.isArray(value))
+        return value.map(cloneValue);
+    if (isRecord(value)) {
+        const clone = {};
+        for (const [key, child] of Object.entries(value))
+            clone[key] = cloneValue(child);
+        return clone;
+    }
+    return value;
+}
+export function cloneRecordExcept(input, excluded) {
+    const result = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (!excluded.includes(key))
+            result[key] = cloneValue(value);
+    }
+    return result;
+}
+export function validateRelativePath(value) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new TypeError("relativePath must be a non-empty relative path");
+    }
+    if (value.startsWith("/") || value.startsWith("\\") || /^[A-Za-z]:[\\/]/.test(value)) {
+        throw new TypeError("relativePath must not be absolute");
+    }
+    if (value.includes("\\")) {
+        throw new TypeError("relativePath must use forward slashes");
+    }
+    const segments = value.split("/");
+    if (segments.some((segment) => segment === "..")) {
+        throw new TypeError("relativePath must not contain '..' traversal");
+    }
+    const normalized = segments
+        .filter((segment) => segment !== "." && segment !== "")
+        .join("/");
+    if (normalized.length === 0) {
+        throw new TypeError("relativePath must identify a source");
+    }
+    return normalized;
+}
+export function tryValidateRelativePath(value) {
+    try {
+        return validateRelativePath(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function observationId(format, relativePath) {
+    return `episode-observation:${format}:${encodeURIComponent(relativePath)}`;
+}
+export function resolveSiblingPath(sourceDocumentPath, artifactPath) {
+    const normalizedArtifact = tryValidateRelativePath(artifactPath);
+    if (normalizedArtifact === undefined)
+        return undefined;
+    const directoryEnd = sourceDocumentPath.lastIndexOf("/");
+    const directory = directoryEnd === -1 ? "" : sourceDocumentPath.slice(0, directoryEnd + 1);
+    return `${directory}${normalizedArtifact}`;
+}
+export function resolveChildPath(directoryPath, childPath) {
+    const normalizedChild = tryValidateRelativePath(childPath);
+    if (normalizedChild === undefined)
+        return undefined;
+    return `${directoryPath}/${normalizedChild}`;
+}
+export function inferArtifactKind(filename, defaultKind = "other") {
+    const lower = filename.toLowerCase();
+    if (/\.(?:mp3|m4a|wav|ogg|flac|aac)$/.test(lower))
+        return "audio";
+    if (/\.(?:png|jpe?g|gif|webp|bmp|svg)$/.test(lower))
+        return "image";
+    if (/(?:transcript|transcription)/.test(lower))
+        return "transcript";
+    if (/\.(?:md|mdx|txt|text|yaml|yml|json|twee|html?|sh)$/.test(lower))
+        return "text";
+    if (defaultKind === "transcript")
+        return "text";
+    return defaultKind;
+}
+export function extractEpisodeNumber(value) {
+    const match = /(?:^|[^a-z0-9])ep(?:isode)?[-_ ]*0*(\d{1,4})(?=$|[^0-9])/i.exec(value);
+    return match?.[1];
+}
+export function pathBasename(relativePath) {
+    const end = relativePath.endsWith("/") ? relativePath.length - 1 : relativePath.length;
+    const start = relativePath.lastIndexOf("/", end - 1);
+    return relativePath.slice(start + 1, end);
+}
+//# sourceMappingURL=common.js.map

package/dist/adapters/common.js.map

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

package/dist/adapters/composition.d.ts

@@ -0,0 +1,7 @@
+import type { EpisodeObservation, ObserveCompositionManifestOptions } from "../observation.js";
+/**
+ * Observe a composition manifest without rewriting it or forcing it into the
+ * strict EpisodicMemory authored shape.
+ */
+export declare function observeCompositionManifest(input: unknown, options: ObserveCompositionManifestOptions): EpisodeObservation;
+//# sourceMappingURL=composition.d.ts.map

package/dist/adapters/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../src/adapters/composition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,kBAAkB,EAGlB,iCAAiC,EAClC,MAAM,mBAAmB,CAAA;AAuB1B;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,iCAAiC,GACzC,kBAAkB,CAoCpB"}

package/dist/adapters/composition.js

@@ -0,0 +1,219 @@
+import { cloneRecordExcept, cloneValue, extractEpisodeNumber, inferArtifactKind, isRecord, observationId, resolveSiblingPath, validateRelativePath, } from "./common.js";
+const STRUCTURALLY_PROJECTED_TOP_LEVEL_FIELDS = new Set([
+    "clips",
+    "texts",
+    "images",
+    "relatedEpisodes",
+    "branchOf",
+]);
+const STRING_METADATA_FIELDS = ["title", "slug", "created", "updated", "notes"];
+/**
+ * Observe a composition manifest without rewriting it or forcing it into the
+ * strict EpisodicMemory authored shape.
+ */
+export function observeCompositionManifest(input, options) {
+    const relativePath = validateRelativePath(options.relativePath);
+    const id = observationId("composition-json", relativePath);
+    const base = {
+        id,
+        zone: options.zone ?? "composition-intake",
+        sourceDocuments: [{ format: "composition-json", relativePath }],
+        identityCandidates: [{ kind: "path", value: relativePath }],
+        sourceMetadata: {},
+        artifacts: [],
+        relations: [],
+        diagnostics: [],
+        unmappedFields: {},
+    };
+    if (!isRecord(input)) {
+        base.diagnostics.push({
+            level: "error",
+            code: "composition.invalid-object",
+            message: "A composition manifest must be a non-array object.",
+            path: relativePath,
+        });
+        return base;
+    }
+    base.identityCandidates = observeIdentity(input, relativePath);
+    base.sourceMetadata = observeSourceMetadata(input, base.diagnostics);
+    base.artifacts.push(...observeArtifacts(input, "clips", "audio", relativePath, base.diagnostics), ...observeArtifacts(input, "texts", "transcript", relativePath, base.diagnostics), ...observeArtifacts(input, "images", "image", relativePath, base.diagnostics));
+    base.relations.push(...observeRelations(input, base.diagnostics));
+    base.unmappedFields = preserveUnmappedFields(input, base.sourceMetadata);
+    return base;
+}
+function observeIdentity(input, relativePath) {
+    const candidates = [];
+    if (typeof input.title === "string" && input.title.length > 0) {
+        candidates.push({ kind: "title", value: input.title });
+    }
+    if (typeof input.slug === "string" && input.slug.length > 0) {
+        candidates.push({ kind: "slug", value: input.slug });
+    }
+    const episodeNumber = extractEpisodeNumber([input.slug, input.title, relativePath]
+        .filter((value) => typeof value === "string")
+        .join(" "));
+    if (episodeNumber !== undefined) {
+        candidates.push({ kind: "episode-number", value: episodeNumber });
+    }
+    candidates.push({ kind: "path", value: relativePath });
+    return candidates;
+}
+function observeSourceMetadata(input, diagnostics) {
+    const metadata = {};
+    for (const field of STRING_METADATA_FIELDS) {
+        const value = input[field];
+        if (value === undefined)
+            continue;
+        if (typeof value === "string") {
+            metadata[field] = value;
+        }
+        else {
+            diagnostics.push({
+                level: "warning",
+                code: "composition.invalid-metadata",
+                message: `Composition field '${field}' must be a string when present.`,
+                path: field,
+            });
+        }
+    }
+    if (input.skillSeeds !== undefined) {
+        if (Array.isArray(input.skillSeeds) &&
+            input.skillSeeds.every((value) => typeof value === "string")) {
+            metadata.skillSeeds = [...input.skillSeeds];
+        }
+        else {
+            diagnostics.push({
+                level: "warning",
+                code: "composition.invalid-metadata",
+                message: "Composition field 'skillSeeds' must be an array of strings when present.",
+                path: "skillSeeds",
+            });
+        }
+    }
+    return metadata;
+}
+function observeArtifacts(input, field, defaultKind, sourceDocumentPath, diagnostics) {
+    const value = input[field];
+    if (value === undefined) {
+        diagnostics.push({
+            level: "info",
+            code: "composition.optional-field-missing",
+            message: `Optional composition field '${field}' is absent.`,
+            path: field,
+        });
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        diagnostics.push({
+            level: "warning",
+            code: "composition.invalid-artifact-list",
+            message: `Composition field '${field}' must be an array when present.`,
+            path: field,
+        });
+        return [];
+    }
+    const artifacts = [];
+    value.forEach((entry, index) => {
+        const entryPath = `${field}[${index}]`;
+        if (!isRecord(entry) || typeof entry.filename !== "string" || entry.filename.length === 0) {
+            diagnostics.push({
+                level: "warning",
+                code: "composition.invalid-artifact",
+                message: "Artifact entries require a non-empty filename.",
+                path: entryPath,
+            });
+            return;
+        }
+        const relativePath = resolveSiblingPath(sourceDocumentPath, entry.filename);
+        if (relativePath === undefined) {
+            diagnostics.push({
+                level: "warning",
+                code: "composition.unsafe-artifact-path",
+                message: "Artifact filenames must be relative and must not contain traversal.",
+                path: `${entryPath}.filename`,
+            });
+            return;
+        }
+        const kind = inferArtifactKind(entry.filename, defaultKind);
+        const metadata = cloneRecordExcept(entry, ["filename", "label", "source"]);
+        const artifact = {
+            id: `artifact:${kind}:${encodeURIComponent(relativePath)}:${index}`,
+            kind,
+            relativePath,
+            metadata,
+        };
+        if (typeof entry.label === "string")
+            artifact.label = entry.label;
+        if (typeof entry.source === "string")
+            artifact.sourceArtifact = entry.source;
+        artifacts.push(artifact);
+    });
+    return artifacts;
+}
+function observeRelations(input, diagnostics) {
+    const relations = [];
+    if (input.relatedEpisodes === undefined) {
+        diagnostics.push({
+            level: "info",
+            code: "composition.optional-field-missing",
+            message: "Optional composition field 'relatedEpisodes' is absent.",
+            path: "relatedEpisodes",
+        });
+    }
+    else if (!Array.isArray(input.relatedEpisodes)) {
+        diagnostics.push({
+            level: "warning",
+            code: "composition.invalid-relation-list",
+            message: "Composition field 'relatedEpisodes' must be an array when present.",
+            path: "relatedEpisodes",
+        });
+    }
+    else {
+        input.relatedEpisodes.forEach((target, index) => {
+            if (typeof target !== "string" || target.length === 0) {
+                diagnostics.push({
+                    level: "warning",
+                    code: "composition.invalid-relation",
+                    message: "Related episode entries must be non-empty strings.",
+                    path: `relatedEpisodes[${index}]`,
+                });
+                return;
+            }
+            relations.push({
+                id: `relation:related-to:${encodeURIComponent(target)}:${index}`,
+                kind: "related-to",
+                target: { kind: "slug", value: target },
+            });
+        });
+    }
+    if (input.branchOf !== undefined) {
+        if (typeof input.branchOf === "string" && input.branchOf.length > 0) {
+            relations.push({
+                id: `relation:branch-of:${encodeURIComponent(input.branchOf)}`,
+                kind: "branch-of",
+                target: { kind: "slug", value: input.branchOf },
+            });
+        }
+        else {
+            diagnostics.push({
+                level: "warning",
+                code: "composition.invalid-branch",
+                message: "Composition field 'branchOf' must be a non-empty string when present.",
+                path: "branchOf",
+            });
+        }
+    }
+    return relations;
+}
+function preserveUnmappedFields(input, metadata) {
+    const mappedMetadataFields = new Set(Object.keys(metadata));
+    const unmapped = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (!STRUCTURALLY_PROJECTED_TOP_LEVEL_FIELDS.has(key) &&
+            !mappedMetadataFields.has(key)) {
+            unmapped[key] = cloneValue(value);
+        }
+    }
+    return unmapped;
+}
+//# sourceMappingURL=composition.js.map

package/dist/adapters/composition.js.map

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

package/dist/adapters/directory.d.ts

@@ -0,0 +1,7 @@
+import type { EpisodeObservation, ObserveEpisodeDirectoryOptions } from "../observation.js";
+/**
+ * Observe a caller-supplied directory snapshot without reading the filesystem.
+ * This provides a conservative fallback for descriptor-light Chronicle folders.
+ */
+export declare function observeEpisodeDirectory(input: unknown, options: ObserveEpisodeDirectoryOptions): EpisodeObservation;
+//# sourceMappingURL=directory.d.ts.map

package/dist/adapters/directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../../src/adapters/directory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,kBAAkB,EAClB,8BAA8B,EAC/B,MAAM,mBAAmB,CAAA;AAwB1B;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,8BAA8B,GACtC,kBAAkB,CAsBpB"}

package/dist/adapters/directory.js

@@ -0,0 +1,175 @@
+import { cloneRecordExcept, extractEpisodeNumber, inferArtifactKind, isRecord, observationId, pathBasename, resolveChildPath, validateRelativePath, } from "./common.js";
+/**
+ * Observe a caller-supplied directory snapshot without reading the filesystem.
+ * This provides a conservative fallback for descriptor-light Chronicle folders.
+ */
+export function observeEpisodeDirectory(input, options) {
+    const relativePath = validateRelativePath(options.relativePath);
+    const base = {
+        id: observationId("directory-inferred", relativePath),
+        zone: options.zone ?? "chronicle",
+        sourceDocuments: [{ format: "directory-inferred", relativePath }],
+        identityCandidates: observeDirectoryIdentity(relativePath),
+        sourceMetadata: {},
+        artifacts: [],
+        relations: [],
+        diagnostics: [],
+        unmappedFields: {},
+    };
+    const projected = projectDirectoryInput(input, relativePath, base.diagnostics);
+    if (projected === undefined)
+        return base;
+    base.unmappedFields = projected.unmappedFields;
+    const entries = normalizeEntries(projected.entries, relativePath, base.diagnostics);
+    base.artifacts = observeDirectoryArtifacts(entries, relativePath, base.diagnostics);
+    observeDescriptorState(entries, base.diagnostics);
+    return base;
+}
+function observeDirectoryIdentity(relativePath) {
+    const basename = pathBasename(relativePath);
+    const candidates = [];
+    if (basename.length > 0)
+        candidates.push({ kind: "slug", value: basename });
+    const episodeNumber = extractEpisodeNumber(relativePath);
+    if (episodeNumber !== undefined) {
+        candidates.push({ kind: "episode-number", value: episodeNumber });
+    }
+    candidates.push({ kind: "path", value: relativePath });
+    return candidates;
+}
+function projectDirectoryInput(input, relativePath, diagnostics) {
+    if (Array.isArray(input)) {
+        return { entries: input, unmappedFields: {} };
+    }
+    if (!isRecord(input)) {
+        diagnostics.push({
+            level: "error",
+            code: "directory.invalid-snapshot",
+            message: "A directory snapshot must be an entry array or an object containing entries.",
+            path: relativePath,
+        });
+        return undefined;
+    }
+    if (!Array.isArray(input.entries)) {
+        diagnostics.push({
+            level: "error",
+            code: "directory.invalid-entries",
+            message: "Directory snapshot field 'entries' must be an array.",
+            path: "entries",
+        });
+        return undefined;
+    }
+    return {
+        entries: input.entries,
+        unmappedFields: cloneRecordExcept(input, ["entries"]),
+    };
+}
+function normalizeEntries(entries, directoryPath, diagnostics) {
+    const normalized = [];
+    entries.forEach((entry, index) => {
+        const entryPath = `entries[${index}]`;
+        if (typeof entry === "string") {
+            const relativePath = validateEntryPath(entry, entryPath, diagnostics);
+            if (relativePath !== undefined) {
+                normalized.push({ relativePath, type: "file", metadata: {}, originalIndex: index });
+            }
+            return;
+        }
+        if (!isRecord(entry) || typeof entry.relativePath !== "string") {
+            diagnostics.push({
+                level: "warning",
+                code: "directory.invalid-entry",
+                message: "Directory entries must be path strings or objects with relativePath.",
+                path: entryPath,
+            });
+            return;
+        }
+        const relativePath = validateEntryPath(entry.relativePath, entryPath, diagnostics);
+        if (relativePath === undefined)
+            return;
+        if (entry.type !== undefined && entry.type !== "file" && entry.type !== "directory") {
+            diagnostics.push({
+                level: "warning",
+                code: "directory.invalid-entry-type",
+                message: "Directory entry type must be 'file' or 'directory' when present.",
+                path: `${entryPath}.type`,
+            });
+            return;
+        }
+        normalized.push({
+            relativePath,
+            type: entry.type ?? "file",
+            metadata: cloneRecordExcept(entry, ["relativePath", "type"]),
+            originalIndex: index,
+        });
+    });
+    normalized.sort((left, right) => {
+        if (left.relativePath < right.relativePath)
+            return -1;
+        if (left.relativePath > right.relativePath)
+            return 1;
+        return left.originalIndex - right.originalIndex;
+    });
+    return normalized;
+}
+function validateEntryPath(value, diagnosticPath, diagnostics) {
+    try {
+        return validateRelativePath(value);
+    }
+    catch {
+        diagnostics.push({
+            level: "warning",
+            code: "directory.unsafe-entry-path",
+            message: "Directory entry paths must be relative and must not contain traversal.",
+            path: diagnosticPath,
+        });
+        return undefined;
+    }
+}
+function observeDirectoryArtifacts(entries, directoryPath, diagnostics) {
+    const artifacts = [];
+    const seen = new Set();
+    for (const entry of entries) {
+        if (entry.type === "directory")
+            continue;
+        if (seen.has(entry.relativePath)) {
+            diagnostics.push({
+                level: "warning",
+                code: "directory.duplicate-entry",
+                message: "Duplicate directory entries are observed only once.",
+                path: entry.relativePath,
+            });
+            continue;
+        }
+        seen.add(entry.relativePath);
+        const relativePath = resolveChildPath(directoryPath, entry.relativePath);
+        if (relativePath === undefined)
+            continue;
+        const kind = inferArtifactKind(entry.relativePath);
+        artifacts.push({
+            id: `artifact:${kind}:${encodeURIComponent(relativePath)}`,
+            kind,
+            relativePath,
+            label: entry.relativePath,
+            metadata: entry.metadata,
+        });
+    }
+    return artifacts;
+}
+function observeDescriptorState(entries, diagnostics) {
+    const fileNames = new Set(entries
+        .filter(({ type }) => type === "file")
+        .map(({ relativePath }) => relativePath.toLowerCase()));
+    const hasDescriptor = fileNames.has("episode.yaml") ||
+        fileNames.has("episode.yml") ||
+        fileNames.has("readme.md") ||
+        fileNames.has("readme.txt");
+    if (!hasDescriptor) {
+        diagnostics.push({
+            level: "info",
+            code: "directory.descriptor-light",
+            message: "No episode.yaml or README descriptor was present; identity is path-derived.",
+        });
+    }
+}
+//# sourceMappingURL=directory.js.map

package/dist/adapters/directory.js.map

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

package/dist/adapters/episode-yaml.d.ts

@@ -0,0 +1,9 @@
+import type { EpisodeObservation, ObserveEpisodeYamlManifestOptions } from "../observation.js";
+/**
+ * Observe an already-parsed episode.yaml manifest.
+ *
+ * YAML parsing remains the caller's responsibility so this schema package does
+ * not impose a parser, loader policy, or filesystem dependency.
+ */
+export declare function observeEpisodeYamlManifest(input: unknown, options: ObserveEpisodeYamlManifestOptions): EpisodeObservation;
+//# sourceMappingURL=episode-yaml.d.ts.map

package/dist/adapters/episode-yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"episode-yaml.d.ts","sourceRoot":"","sources":["../../src/adapters/episode-yaml.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,kBAAkB,EAIlB,iCAAiC,EAClC,MAAM,mBAAmB,CAAA;AAoC1B;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,iCAAiC,GACzC,kBAAkB,CAsCpB"}

package/dist/adapters/episode-yaml.js

@@ -0,0 +1,326 @@
+import { cloneRecordExcept, cloneValue, extractEpisodeNumber, inferArtifactKind, isRecord, observationId, resolveSiblingPath, tryValidateRelativePath, validateRelativePath, } from "./common.js";
+const STRING_METADATA_FIELDS = [
+    ["title", "title"],
+    ["slug", "slug"],
+    ["status", "status"],
+    ["session_title", "sessionTitle"],
+    ["primary_issue", "primaryIssue"],
+    ["created", "created"],
+    ["updated", "updated"],
+    ["notes", "notes"],
+];
+/**
+ * Observe an already-parsed episode.yaml manifest.
+ *
+ * YAML parsing remains the caller's responsibility so this schema package does
+ * not impose a parser, loader policy, or filesystem dependency.
+ */
+export function observeEpisodeYamlManifest(input, options) {
+    const relativePath = validateRelativePath(options.relativePath);
+    const base = {
+        id: observationId("episode-yaml", relativePath),
+        zone: options.zone ?? "chronicle",
+        sourceDocuments: [{ format: "episode-yaml", relativePath }],
+        identityCandidates: [{ kind: "path", value: relativePath }],
+        sourceMetadata: {},
+        artifacts: [],
+        relations: [],
+        diagnostics: [],
+        unmappedFields: {},
+    };
+    if (!isRecord(input)) {
+        base.diagnostics.push({
+            level: "error",
+            code: "episode-yaml.invalid-object",
+            message: "A parsed episode.yaml manifest must be a non-array object.",
+            path: relativePath,
+        });
+        return base;
+    }
+    const metadataProjection = observeMetadata(input, base.diagnostics);
+    base.sourceMetadata = metadataProjection.metadata;
+    base.identityCandidates = observeIdentity(input, relativePath, base.diagnostics);
+    base.artifacts = observeArtifactMap(input.artifacts, relativePath, base.diagnostics);
+    const relationProjection = observeLineage(input.lineage, base.diagnostics);
+    base.relations = relationProjection.relations;
+    base.unmappedFields = preserveUnmappedFields(input, metadataProjection.consumedFields, relationProjection);
+    return base;
+}
+function observeMetadata(input, diagnostics) {
+    const metadata = {};
+    const consumedFields = new Set();
+    for (const [sourceField, targetField] of STRING_METADATA_FIELDS) {
+        const value = input[sourceField];
+        if (value === undefined)
+            continue;
+        if (typeof value === "string") {
+            metadata[targetField] = value;
+            consumedFields.add(sourceField);
+        }
+        else {
+            diagnostics.push({
+                level: "warning",
+                code: "episode-yaml.invalid-metadata",
+                message: `Manifest field '${sourceField}' must be a string when present.`,
+                path: sourceField,
+            });
+        }
+    }
+    if (input.date !== undefined) {
+        if (typeof input.date === "string") {
+            metadata.date = input.date;
+            consumedFields.add("date");
+        }
+        else if (input.date instanceof Date && !Number.isNaN(input.date.getTime())) {
+            metadata.date = input.date.toISOString();
+            consumedFields.add("date");
+        }
+        else {
+            diagnostics.push({
+                level: "warning",
+                code: "episode-yaml.invalid-metadata",
+                message: "Manifest field 'date' must be a string or valid parsed Date.",
+                path: "date",
+            });
+        }
+    }
+    if (input.skillSeeds !== undefined) {
+        if (Array.isArray(input.skillSeeds) &&
+            input.skillSeeds.every((value) => typeof value === "string")) {
+            metadata.skillSeeds = [...input.skillSeeds];
+            consumedFields.add("skillSeeds");
+        }
+        else {
+            diagnostics.push({
+                level: "warning",
+                code: "episode-yaml.invalid-metadata",
+                message: "Manifest field 'skillSeeds' must be an array of strings when present.",
+                path: "skillSeeds",
+            });
+        }
+    }
+    return { metadata, consumedFields };
+}
+function observeIdentity(input, relativePath, diagnostics) {
+    const candidates = [];
+    if (typeof input.title === "string" && input.title.length > 0) {
+        candidates.push({ kind: "title", value: input.title });
+    }
+    if (typeof input.slug === "string" && input.slug.length > 0) {
+        candidates.push({ kind: "slug", value: input.slug });
+    }
+    const explicitNumber = normalizeEpisodeNumber(input.episode);
+    if (explicitNumber !== undefined) {
+        candidates.push({ kind: "episode-number", value: explicitNumber });
+    }
+    else if (input.episode !== undefined) {
+        diagnostics.push({
+            level: "warning",
+            code: "episode-yaml.invalid-episode-identity",
+            message: "Manifest field 'episode' must be a non-negative integer or episode label.",
+            path: "episode",
+        });
+    }
+    else {
+        const inferredNumber = extractEpisodeNumber(relativePath);
+        if (inferredNumber !== undefined) {
+            candidates.push({ kind: "episode-number", value: inferredNumber });
+        }
+    }
+    candidates.push({ kind: "path", value: relativePath });
+    return candidates;
+}
+function normalizeEpisodeNumber(value) {
+    if (typeof value === "number" && Number.isSafeInteger(value) && value >= 0) {
+        return String(value);
+    }
+    if (typeof value !== "string" || value.length === 0)
+        return undefined;
+    if (/^\d+$/.test(value))
+        return String(Number(value));
+    return extractEpisodeNumber(value);
+}
+function observeArtifactMap(value, sourceDocumentPath, diagnostics) {
+    if (value === undefined) {
+        diagnostics.push({
+            level: "info",
+            code: "episode-yaml.optional-field-missing",
+            message: "Optional manifest field 'artifacts' is absent.",
+            path: "artifacts",
+        });
+        return [];
+    }
+    if (!isRecord(value)) {
+        diagnostics.push({
+            level: "warning",
+            code: "episode-yaml.invalid-artifact-map",
+            message: "Manifest field 'artifacts' must be an object when present.",
+            path: "artifacts",
+        });
+        return [];
+    }
+    const artifacts = [];
+    walkArtifactMap(value, [], sourceDocumentPath, diagnostics, artifacts);
+    return artifacts;
+}
+function walkArtifactMap(value, keys, sourceDocumentPath, diagnostics, artifacts) {
+    for (const key of Object.keys(value).sort()) {
+        const child = value[key];
+        const childKeys = [...keys, key];
+        const manifestPath = `artifacts.${childKeys.join(".")}`;
+        if (typeof child === "string") {
+            const relativePath = resolveSiblingPath(sourceDocumentPath, child);
+            if (relativePath === undefined) {
+                diagnostics.push({
+                    level: "warning",
+                    code: "episode-yaml.unsafe-artifact-path",
+                    message: "Artifact paths must be relative and must not contain traversal.",
+                    path: manifestPath,
+                });
+                continue;
+            }
+            const kind = inferArtifactKind(child);
+            artifacts.push({
+                id: `artifact:${kind}:${encodeURIComponent(relativePath)}:${encodeURIComponent(manifestPath)}`,
+                kind,
+                relativePath,
+                label: childKeys.join(" / "),
+                metadata: { manifestPath },
+            });
+            continue;
+        }
+        if (isRecord(child)) {
+            walkArtifactMap(child, childKeys, sourceDocumentPath, diagnostics, artifacts);
+            continue;
+        }
+        diagnostics.push({
+            level: "warning",
+            code: "episode-yaml.invalid-artifact-entry",
+            message: "Artifact map leaves must be relative path strings.",
+            path: manifestPath,
+        });
+    }
+}
+function observeLineage(value, diagnostics) {
+    if (value === undefined) {
+        return { relations: [], unmappedLineage: {}, consumed: false };
+    }
+    if (!isRecord(value)) {
+        diagnostics.push({
+            level: "warning",
+            code: "episode-yaml.invalid-lineage",
+            message: "Manifest field 'lineage' must be an object when present.",
+            path: "lineage",
+        });
+        return { relations: [], unmappedLineage: {}, consumed: false };
+    }
+    const relations = [];
+    const unmappedLineage = {};
+    const mappings = [
+        ["continues_from", "continues-from"],
+        ["relates_to", "related-to"],
+    ];
+    for (const [field, kind] of mappings) {
+        const entries = value[field];
+        if (entries === undefined)
+            continue;
+        if (!Array.isArray(entries)) {
+            diagnostics.push({
+                level: "warning",
+                code: "episode-yaml.invalid-lineage-list",
+                message: `Lineage field '${field}' must be an array when present.`,
+                path: `lineage.${field}`,
+            });
+            unmappedLineage[field] = cloneValue(entries);
+            continue;
+        }
+        const rejectedEntries = [];
+        entries.forEach((entry, index) => {
+            const relation = observeRelationEntry(entry, kind, field, index, diagnostics);
+            if (relation !== undefined)
+                relations.push(relation);
+            else
+                rejectedEntries.push(cloneValue(entry));
+        });
+        if (rejectedEntries.length > 0)
+            unmappedLineage[field] = rejectedEntries;
+    }
+    for (const [key, child] of Object.entries(value)) {
+        if (!mappings.some(([field]) => field === key)) {
+            unmappedLineage[key] = cloneValue(child);
+        }
+    }
+    return { relations, unmappedLineage, consumed: true };
+}
+function observeRelationEntry(entry, kind, field, index, diagnostics) {
+    const path = `lineage.${field}[${index}]`;
+    let target;
+    let metadata;
+    if (typeof entry === "number" || typeof entry === "string") {
+        const episodeNumber = normalizeEpisodeNumber(entry);
+        if (episodeNumber !== undefined) {
+            target = { kind: "episode-number", value: episodeNumber };
+        }
+    }
+    else if (isRecord(entry)) {
+        const episodeNumber = normalizeEpisodeNumber(entry.episode);
+        if (episodeNumber !== undefined) {
+            target = { kind: "episode-number", value: episodeNumber };
+            const remainder = cloneRecordExcept(entry, ["episode"]);
+            if (Object.keys(remainder).length > 0)
+                metadata = remainder;
+        }
+        else if (typeof entry.path === "string" && entry.path.length > 0) {
+            const relativeTargetPath = tryValidateRelativePath(entry.path);
+            if (relativeTargetPath === undefined) {
+                diagnostics.push({
+                    level: "warning",
+                    code: "episode-yaml.unsafe-lineage-path",
+                    message: "Path-only lineage targets must be relative and must not contain traversal.",
+                    path: `${path}.path`,
+                });
+                return undefined;
+            }
+            target = { kind: "path", value: relativeTargetPath };
+            const remainder = cloneRecordExcept(entry, ["path"]);
+            if (Object.keys(remainder).length > 0)
+                metadata = remainder;
+        }
+    }
+    if (target === undefined) {
+        diagnostics.push({
+            level: "warning",
+            code: "episode-yaml.invalid-lineage-entry",
+            message: "Lineage entries require an episode number or path.",
+            path,
+        });
+        return undefined;
+    }
+    const relation = {
+        id: `relation:${kind}:${target.kind}:${encodeURIComponent(target.value)}:${index}`,
+        kind,
+        target,
+    };
+    if (metadata !== undefined)
+        relation.metadata = metadata;
+    return relation;
+}
+function preserveUnmappedFields(input, consumedMetadataFields, lineage) {
+    const unmapped = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (consumedMetadataFields.has(key))
+            continue;
+        if (key === "episode" && normalizeEpisodeNumber(value) !== undefined)
+            continue;
+        if (key === "artifacts" && isRecord(value))
+            continue;
+        if (key === "lineage" && lineage.consumed)
+            continue;
+        unmapped[key] = cloneValue(value);
+    }
+    if (Object.keys(lineage.unmappedLineage).length > 0) {
+        unmapped.lineage = lineage.unmappedLineage;
+    }
+    return unmapped;
+}
+//# sourceMappingURL=episode-yaml.js.map

package/dist/adapters/episode-yaml.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,7 @@
-export * from "./types";
-export * from "./narrative";
+export * from "./types.js";
+export * from "./narrative.js";
+export * from "./observation.js";
+export * from "./adapters/composition.js";
+export * from "./adapters/episode-yaml.js";
+export * from "./adapters/directory.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA"}

package/dist/index.js

@@ -1,3 +1,7 @@
-export * from "./types";
-export * from "./narrative";
+export * from "./types.js";
+export * from "./narrative.js";
+export * from "./observation.js";
+export * from "./adapters/composition.js";
+export * from "./adapters/episode-yaml.js";
+export * from "./adapters/directory.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA"}

package/dist/observation.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Compatibility-first observations of heterogeneous episode sources.
+ *
+ * An observation describes source material without requiring it to satisfy the
+ * authored EpisodicMemory schema. Consumers can inspect the diagnostics and
+ * decide whether a later, explicit projection is appropriate.
+ */
+export type EpisodeSourceZone = "composition-intake" | "chronicle" | "runtime-projection";
+export type EpisodeSourceFormat = "composition-json" | "episode-yaml" | "directory-inferred" | "episodic-memory";
+export interface SourceDocumentRef {
+    format: EpisodeSourceFormat;
+    relativePath: string;
+}
+export interface EpisodeIdentityCandidate {
+    kind: "episode-number" | "slug" | "title" | "path";
+    value: string;
+}
+export type ArtifactKind = "audio" | "transcript" | "image" | "text" | "other";
+export interface ArtifactReference {
+    id: string;
+    kind: ArtifactKind;
+    relativePath: string;
+    label?: string;
+    sourceArtifact?: string;
+    metadata: Record<string, unknown>;
+}
+export type EpisodeRelationKind = "related-to" | "branch-of" | "continues-from";
+export interface EpisodeRelation {
+    id: string;
+    kind: EpisodeRelationKind;
+    target: EpisodeIdentityCandidate;
+    metadata?: Record<string, unknown>;
+}
+export interface CompatibilityDiagnostic {
+    level: "info" | "warning" | "error";
+    code: string;
+    message: string;
+    path?: string;
+}
+export interface EpisodeSourceMetadata {
+    title?: string;
+    slug?: string;
+    created?: string;
+    updated?: string;
+    notes?: string;
+    skillSeeds?: string[];
+    date?: string;
+    status?: string;
+    sessionTitle?: string;
+    primaryIssue?: string;
+}
+export interface EpisodeObservation {
+    id: string;
+    zone: EpisodeSourceZone;
+    sourceDocuments: SourceDocumentRef[];
+    identityCandidates: EpisodeIdentityCandidate[];
+    sourceMetadata: EpisodeSourceMetadata;
+    artifacts: ArtifactReference[];
+    relations: EpisodeRelation[];
+    diagnostics: CompatibilityDiagnostic[];
+    /** Source fields that were preserved but not structurally projected. */
+    unmappedFields: Record<string, unknown>;
+}
+export interface ObserveCompositionManifestOptions {
+    relativePath: string;
+    zone?: "composition-intake";
+}
+export interface ObserveEpisodeYamlManifestOptions {
+    relativePath: string;
+    zone?: "chronicle";
+}
+export interface EpisodeDirectoryEntry {
+    relativePath: string;
+    type?: "file" | "directory";
+    size?: number;
+    modifiedAt?: string;
+}
+export interface EpisodeDirectorySnapshot {
+    entries: readonly (string | EpisodeDirectoryEntry)[];
+}
+export interface ObserveEpisodeDirectoryOptions {
+    relativePath: string;
+    zone?: "chronicle";
+}
+//# sourceMappingURL=observation.d.ts.map

package/dist/observation.d.ts.map

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

package/dist/observation.js

@@ -0,0 +1,9 @@
+/**
+ * Compatibility-first observations of heterogeneous episode sources.
+ *
+ * An observation describes source material without requiring it to satisfy the
+ * authored EpisodicMemory schema. Consumers can inspect the diagnostics and
+ * decide whether a later, explicit projection is appropriate.
+ */
+export {};
+//# sourceMappingURL=observation.js.map

package/dist/observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.js","sourceRoot":"","sources":["../src/observation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/types.d.ts

@@ -15,7 +15,7 @@
  *
  * Plus follow-up commissions — seeds for the next episode.
  */
-import type { NarrativeContribution } from "./narrative";
+import type { NarrativeContribution } from "./narrative.js";
 export declare const SCHEMA_VERSION: "episodic-memory.v1.0";
 export type SchemaVersion = typeof SCHEMA_VERSION;
 export interface EpisodicMemory {

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miadi/episodic-memory-schema",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "TypeScript types and JSON Schema for episodic memory — the durable session-to-session memory layer in the Miadi orchestration kit. Narrative layer is NCP-aligned; provenance layer is W3C PROV-DM and OAIS-informed.",
   "keywords": [
     "miadi",
@@ -18,7 +18,7 @@
   "homepage": "https://github.com/jgwill/Miadi/tree/main/packages/episodic-memory-schema",
   "repository": {
     "type": "git",
-    "url": "https://github.com/jgwill/Miadi.git",
+    "url": "git+https://github.com/jgwill/Miadi.git",
     "directory": "packages/episodic-memory-schema"
   },
   "type": "module",
@@ -42,7 +42,8 @@
   "scripts": {
     "build": "tsc",
     "type-check": "tsc --noEmit",
-    "prepublishOnly": "pnpm build"
+    "test": "npm run build && node --test test/*.test.mjs",
+    "prepublishOnly": "npm run build"
   },
   "devDependencies": {
     "typescript": "^5.4.0"