@miadi/episodic-memory-schema 0.1.1 → 0.3.0

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,13 @@
 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";
+/**
+ * Shared source-reading helpers, exported so downstream packages read paths and
+ * infer identity the same way this package does rather than forking a second,
+ * drifting copy of the traversal validator.
+ */
+export { inferArtifactKind, extractEpisodeNumber, validateRelativePath, tryValidateRelativePath, resolveSiblingPath, resolveChildPath, observationId, pathBasename, } from "./adapters/common.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,YAAY,CAAA;AAC1B,cAAc,gBAAgB,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;AAEvC;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -1,3 +1,13 @@
 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";
+/**
+ * Shared source-reading helpers, exported so downstream packages read paths and
+ * infer identity the same way this package does rather than forking a second,
+ * drifting copy of the traversal validator.
+ */
+export { inferArtifactKind, extractEpisodeNumber, validateRelativePath, tryValidateRelativePath, resolveSiblingPath, resolveChildPath, observationId, pathBasename, } from "./adapters/common.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,YAAY,CAAA;AAC1B,cAAc,gBAAgB,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;AAEvC;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,CAAA"}