@miadi/episodic-memory-schema 0.5.1 → 0.6.1

package/dist/adapters/common.d.ts

@@ -1,4 +1,4 @@
-import type { ArtifactKind, EpisodeSourceFormat } from "../observation.js";
+import type { ArtifactKind, CaptureProvenance, 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;
@@ -6,6 +6,42 @@ export declare function cloneRecordExcept(input: JsonRecord, excluded: readonly
 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 interface StableArtifactIdInput {
+    kind: ArtifactKind;
+    /**
+     * A key belonging to the artifact itself — a content hash is ideal. Supplied
+     * by the caller because hashing is I/O, and this package does no I/O.
+     */
+    stableKey?: string;
+    /** Used when no `stableKey` is given: the device and the instant it began. */
+    capture?: CaptureProvenance;
+}
+/**
+ * The capture identity of a take: which device, and which instant it began.
+ *
+ * One device cannot start two recordings in the same second — the recording
+ * spec refuses a second start while one is active — so this pair identifies a
+ * take without consulting the file. Returns undefined when either half is
+ * missing, because half an identity is not a weaker identity, it is none.
+ */
+export declare function captureStableKey(capture: CaptureProvenance): string | undefined;
+/**
+ * An artifact id derived from the artifact's own properties.
+ *
+ * Adapters mint ids from the containing document's path, which means an
+ * artifact has no identity until some manifest names it — a recording that
+ * exists on a device is nameless until it is written into a manifest, and the
+ * same take referenced from two manifests becomes two ids. This derivation
+ * gives an artifact an identity it carries on its own, before and independent of
+ * any document.
+ *
+ * Throws when no key can be resolved, mirroring `validateRelativePath`; use
+ * `tryStableArtifactId` where an absence should be handled rather than raised.
+ */
+export declare function stableArtifactId(input: StableArtifactIdInput): string;
+export declare function tryStableArtifactId(input: StableArtifactIdInput): string | undefined;
+/** Whether an id was derived from the artifact itself rather than from a document. */
+export declare function isStableArtifactId(id: string): boolean;
 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;

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

@@ -1 +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,CAUd;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGtE;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAIzD"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/adapters/common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,mBAAmB,CAAA;AAE1B,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;AAUD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,YAAY,CAAA;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAK/E;AASD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAWrE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAMpF;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAGtD;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,CAUd;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

@@ -55,6 +55,72 @@ export function tryValidateRelativePath(value) {
 export function observationId(format, relativePath) {
     return `episode-observation:${format}:${encodeURIComponent(relativePath)}`;
 }
+/**
+ * Marks an id derived from the artifact itself rather than from the document
+ * that named it. `encodeURIComponent` escapes "@" to "%40", so no path-derived
+ * id can ever begin its key segment with this sentinel — the two id namespaces
+ * are disjoint by construction, and existing ids keep their exact spelling.
+ */
+const SELF_DERIVED_KEY_SENTINEL = "@";
+/**
+ * The capture identity of a take: which device, and which instant it began.
+ *
+ * One device cannot start two recordings in the same second — the recording
+ * spec refuses a second start while one is active — so this pair identifies a
+ * take without consulting the file. Returns undefined when either half is
+ * missing, because half an identity is not a weaker identity, it is none.
+ */
+export function captureStableKey(capture) {
+    const device = capture.device?.trim();
+    const startedAt = capture.startedAt?.trim();
+    if (!device || !startedAt)
+        return undefined;
+    return `capture:${device}@${startedAt}`;
+}
+function resolveStableKey(input) {
+    const explicit = input.stableKey?.trim();
+    if (explicit)
+        return explicit;
+    if (input.capture)
+        return captureStableKey(input.capture);
+    return undefined;
+}
+/**
+ * An artifact id derived from the artifact's own properties.
+ *
+ * Adapters mint ids from the containing document's path, which means an
+ * artifact has no identity until some manifest names it — a recording that
+ * exists on a device is nameless until it is written into a manifest, and the
+ * same take referenced from two manifests becomes two ids. This derivation
+ * gives an artifact an identity it carries on its own, before and independent of
+ * any document.
+ *
+ * Throws when no key can be resolved, mirroring `validateRelativePath`; use
+ * `tryStableArtifactId` where an absence should be handled rather than raised.
+ */
+export function stableArtifactId(input) {
+    if (typeof input.kind !== "string" || input.kind.length === 0) {
+        throw new TypeError("stableArtifactId requires an artifact kind");
+    }
+    const key = resolveStableKey(input);
+    if (key === undefined) {
+        throw new TypeError("stableArtifactId requires a stableKey, or a capture carrying both device and startedAt");
+    }
+    return `artifact:${input.kind}:${SELF_DERIVED_KEY_SENTINEL}${encodeURIComponent(key)}`;
+}
+export function tryStableArtifactId(input) {
+    try {
+        return stableArtifactId(input);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Whether an id was derived from the artifact itself rather than from a document. */
+export function isStableArtifactId(id) {
+    const key = id.split(":").slice(2).join(":");
+    return id.startsWith("artifact:") && key.startsWith(SELF_DERIVED_KEY_SENTINEL);
+}
 export function resolveSiblingPath(sourceDocumentPath, artifactPath) {
     const normalizedArtifact = tryValidateRelativePath(artifactPath);
     if (normalizedArtifact === undefined)

package/dist/adapters/common.js.map

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

package/dist/index.d.ts

@@ -13,4 +13,10 @@ export * from "./adapters/segment-grammar.js";
  * drifting copy of the traversal validator.
  */
 export { inferArtifactKind, extractEpisodeNumber, validateRelativePath, tryValidateRelativePath, resolveSiblingPath, resolveChildPath, observationId, pathBasename, } from "./adapters/common.js";
+/**
+ * Artifact identity derived from the artifact itself, so a take has a name
+ * before any manifest gives it one. Document-derived ids are unchanged.
+ */
+export { stableArtifactId, tryStableArtifactId, isStableArtifactId, captureStableKey, } from "./adapters/common.js";
+export type { StableArtifactIdInput } 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;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAE7C;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,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,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAE7C;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,CAAA;AAE7B;;;GAGG;AACH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -13,4 +13,9 @@ export * from "./adapters/segment-grammar.js";
  * drifting copy of the traversal validator.
  */
 export { inferArtifactKind, extractEpisodeNumber, validateRelativePath, tryValidateRelativePath, resolveSiblingPath, resolveChildPath, observationId, pathBasename, } from "./adapters/common.js";
+/**
+ * Artifact identity derived from the artifact itself, so a take has a name
+ * before any manifest gives it one. Document-derived ids are unchanged.
+ */
+export { stableArtifactId, tryStableArtifactId, isStableArtifactId, captureStableKey, } 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;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAE7C;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,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,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAE7C;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,CAAA;AAE7B;;;GAGG;AACH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA"}

package/dist/observation.d.ts

@@ -15,13 +15,140 @@ export interface EpisodeIdentityCandidate {
     kind: "episode-number" | "slug" | "title" | "path";
     value: string;
 }
-export type ArtifactKind = "audio" | "transcript" | "image" | "text" | "midi" | "video" | "other";
+/**
+ * The kinds, as a value rather than only as a type.
+ *
+ * A TypeScript union vanishes at compile time. The device side of this contract
+ * — `gmtermux`'s recorder — is plain JavaScript, so a union it cannot import is
+ * a contract it cannot check: a misspelled `"capture"` reaches the manifest and
+ * is indistinguishable from an absence. Every axis below is therefore published
+ * as a frozen array with its type derived FROM the array, so the value and the
+ * type cannot drift apart the way two hand-kept copies would.
+ */
+export declare const ARTIFACT_KINDS: readonly ["audio", "transcript", "image", "text", "midi", "video", "other"];
+export type ArtifactKind = (typeof ARTIFACT_KINDS)[number];
+/** Narrows an unvalidated string to {@link ArtifactKind}. */
+export declare function isArtifactKind(value: unknown): value is ArtifactKind;
+/**
+ * How an artifact came to exist — the axis that says what you must never lose.
+ *
+ * `captured` is unrepeatable: a device, an instant, one chance. A take that is
+ * deleted is gone, because the moment it recorded will not happen twice.
+ * `derived` is regenerable from something else that is still held — a
+ * transcript, a rendered mix, a thumbnail. `authored` was written elsewhere by
+ * someone, then brought in: a downloaded deep-search markdown, an imported doc.
+ *
+ * Flattening these three loses the only property that distinguishes an
+ * irreplaceable recording from a file that can be rebuilt on demand.
+ */
+export declare const ARTIFACT_ORIGINS: readonly ["captured", "derived", "authored"];
+export type ArtifactOrigin = (typeof ARTIFACT_ORIGINS)[number];
+/**
+ * Narrows an unvalidated string to {@link ArtifactOrigin}.
+ *
+ * This is the guard that matters most: `origin` is the only field saying what
+ * must never be lost, and a value that fails this check must be treated as
+ * unknown — never defaulted to `"derived"`, which would mark an unrepeatable
+ * take as regenerable.
+ */
+export declare function isArtifactOrigin(value: unknown): value is ArtifactOrigin;
+/**
+ * What a capture records about itself, per `gmtermux/rispecs/recording.spec.md`:
+ * "the filename, the instants it started and stopped, its duration in seconds,
+ * its size, and the device that made it."
+ *
+ * An audio take is the sharpest case of this shape, not its only one — a camera
+ * roll, a film take, and a live MIDI performance are all a device, an instant,
+ * and one chance. Nothing here is specific to audio.
+ *
+ * Every field is optional because provenance is observed, not demanded. A take
+ * whose device is unknown is still a take; an absent field is an absence, not
+ * an error, and must not be filled in with a guess.
+ */
+export interface CaptureProvenance {
+    /** The device that made the capture, as it named itself. */
+    device?: string;
+    /** ISO 8601 instant the capture began. */
+    startedAt?: string;
+    /** ISO 8601 instant the capture finished. */
+    stoppedAt?: string;
+    /** Duration of the finished take. Segments joined by a pause are one duration. */
+    durationSeconds?: number;
+    /** Size of the finished file in bytes. */
+    bytes?: number;
+}
 export interface ArtifactReference {
     id: string;
     kind: ArtifactKind;
     relativePath: string;
     label?: string;
+    /**
+     * The derived-from pointer: the artifact this one was made from. This is the
+     * `origin: "derived"` lineage edge — a transcript points at the audio it was
+     * transcribed from, a mixdown at its session. Absent on a `captured` artifact,
+     * which was made from a moment rather than from another artifact.
+     */
     sourceArtifact?: string;
+    /**
+     * How this artifact came to exist. Absent means unknown — an absence, not an
+     * error. Sources predating this field say nothing about origin, and a reader
+     * must not infer one from the file extension.
+     */
+    origin?: ArtifactOrigin;
+    /**
+     * Capture provenance, meaningful when `origin` is `"captured"`. Absent on a
+     * derived or authored artifact, and absent on a capture whose source document
+     * never recorded it.
+     */
+    capture?: CaptureProvenance;
+    metadata: Record<string, unknown>;
+}
+/**
+ * What a set gathers.
+ *
+ * Composition, Episode, Melody and Film are siblings at the same level — none is
+ * an extension of another, and none is a special case of a recording. `inquiry`
+ * is the IAIP folder. Absent means the gathering was observed without being
+ * classified — an absence, not an error — and `other` is a set whose source
+ * named a kind this list does not carry yet.
+ */
+export declare const ARTIFACT_SET_KINDS: readonly ["inquiry", "composition", "episode", "melody", "film", "other"];
+export type ArtifactSetKind = (typeof ARTIFACT_SET_KINDS)[number];
+/** Narrows an unvalidated string to {@link ArtifactSetKind}. */
+export declare function isArtifactSetKind(value: unknown): value is ArtifactSetKind;
+/**
+ * A directory that gathers artifacts and carries its own identity.
+ *
+ * A set is the same concept as a leaf artifact at a larger scale: an IAIP
+ * inquiry folder (`ep<NNN>-<slug>-<YYMMDD>-<uuid>`), a composition folder, a
+ * melody, and a film are all sets — things you can point at, relate, and lose.
+ * Nothing here is shaped around audio; a film set is not a recording with extra
+ * fields, it is a peer.
+ *
+ * Members are held as artifact ids rather than inlined references, so a set can
+ * name an artifact that a different document observed — and so a set can hold
+ * another set, ids being uniform across both scales.
+ *
+ * Observation only: nothing here scans a filesystem to discover members.
+ */
+export interface ArtifactSet {
+    id: string;
+    /** Directory name as it appears on disk — the inquiry vessel's own name. */
+    name: string;
+    /** Short stable name when the directory name is not itself one. */
+    slug?: string;
+    /** Path to the directory, relative to the observed root. */
+    relativePath: string;
+    kind?: ArtifactSetKind;
+    /** How the gathering came to exist; same axis and same absence rule as a leaf. */
+    origin?: ArtifactOrigin;
+    label?: string;
+    /**
+     * Artifact ids gathered here. An empty array is meaningful: `scaffoldVessel`
+     * creates a named, empty inquiry directory on purpose, and that emptiness is
+     * the state of the inquiry, not missing data.
+     */
+    members: string[];
     metadata: Record<string, unknown>;
 }
 export type EpisodeRelationKind = "related-to" | "branch-of" | "continues-from";
@@ -31,6 +158,52 @@ export interface EpisodeRelation {
     target: EpisodeIdentityCandidate;
     metadata?: Record<string, unknown>;
 }
+/**
+ * Membership direction. Both are carried because a source document states one
+ * or the other, and observation does not invent the inverse it did not read.
+ */
+export declare const ARTIFACT_RELATION_KINDS: readonly ["member-of", "gathers"];
+export type ArtifactRelationKind = (typeof ARTIFACT_RELATION_KINDS)[number];
+/** Narrows an unvalidated string to {@link ArtifactRelationKind}. */
+export declare function isArtifactRelationKind(value: unknown): value is ArtifactRelationKind;
+/**
+ * What can sit on the container end of a membership edge. Composition, Episode,
+ * Melody and Film are named at the same level because they are peers under one
+ * root; `artifact-set` covers a gathering whose kind is unclassified, and
+ * `artifact` lets a set be a member of another set.
+ */
+export declare const ARTIFACT_RELATION_TARGET_KINDS: readonly ["episode", "composition", "melody", "film", "artifact-set", "artifact"];
+export type ArtifactRelationTargetKind = (typeof ARTIFACT_RELATION_TARGET_KINDS)[number];
+/** Narrows an unvalidated string to {@link ArtifactRelationTargetKind}. */
+export declare function isArtifactRelationTargetKind(value: unknown): value is ArtifactRelationTargetKind;
+/**
+ * The other end of a membership edge.
+ *
+ * `id` is present when the target is already an observed artifact, set, or node;
+ * `identity` carries an unresolved episode candidate instead. Both may be
+ * absent-but-one: a target naming neither identifies nothing, which callers
+ * should diagnose rather than store.
+ */
+export interface ArtifactRelationTarget {
+    kind: ArtifactRelationTargetKind;
+    id?: string;
+    identity?: EpisodeIdentityCandidate;
+}
+/**
+ * An artifact ↔ container edge, which `EpisodeRelation` cannot express: that
+ * relation targets an episode identity from an episode, so it has no way to say
+ * "this recording belongs to that composition".
+ *
+ * A pure observation concern — reading an edge a source stated. No I/O.
+ */
+export interface ArtifactRelation {
+    id: string;
+    kind: ArtifactRelationKind;
+    /** The artifact or artifact-set this edge starts from, by id. */
+    artifactId: string;
+    target: ArtifactRelationTarget;
+    metadata?: Record<string, unknown>;
+}
 export interface CompatibilityDiagnostic {
     level: "info" | "warning" | "error";
     code: string;
@@ -95,6 +268,17 @@ export interface EpisodeObservation {
     sourceMetadata: EpisodeSourceMetadata;
     artifacts: ArtifactReference[];
     relations: EpisodeRelation[];
+    /**
+     * Sets observed in the source. Absent means the source named no gathering —
+     * an absence, not an empty result. The adapters in this package do not infer
+     * sets from directory shape, so today only callers supply these.
+     */
+    artifactSets?: ArtifactSet[];
+    /**
+     * Membership edges the source stated. Absent means none were stated; it is
+     * never a claim that an artifact belongs nowhere.
+     */
+    artifactRelations?: ArtifactRelation[];
     diagnostics: CompatibilityDiagnostic[];
     /** Present only for sources carrying musical metadata. */
     musical?: CompositionMusicalMetadata;

package/dist/observation.d.ts.map

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

package/dist/observation.js

@@ -5,5 +5,100 @@
  * authored EpisodicMemory schema. Consumers can inspect the diagnostics and
  * decide whether a later, explicit projection is appropriate.
  */
-export {};
+/**
+ * The kinds, as a value rather than only as a type.
+ *
+ * A TypeScript union vanishes at compile time. The device side of this contract
+ * — `gmtermux`'s recorder — is plain JavaScript, so a union it cannot import is
+ * a contract it cannot check: a misspelled `"capture"` reaches the manifest and
+ * is indistinguishable from an absence. Every axis below is therefore published
+ * as a frozen array with its type derived FROM the array, so the value and the
+ * type cannot drift apart the way two hand-kept copies would.
+ */
+export const ARTIFACT_KINDS = Object.freeze([
+    "audio",
+    "transcript",
+    "image",
+    "text",
+    "midi",
+    "video",
+    "other",
+]);
+/** Narrows an unvalidated string to {@link ArtifactKind}. */
+export function isArtifactKind(value) {
+    return typeof value === "string" && ARTIFACT_KINDS.includes(value);
+}
+/**
+ * How an artifact came to exist — the axis that says what you must never lose.
+ *
+ * `captured` is unrepeatable: a device, an instant, one chance. A take that is
+ * deleted is gone, because the moment it recorded will not happen twice.
+ * `derived` is regenerable from something else that is still held — a
+ * transcript, a rendered mix, a thumbnail. `authored` was written elsewhere by
+ * someone, then brought in: a downloaded deep-search markdown, an imported doc.
+ *
+ * Flattening these three loses the only property that distinguishes an
+ * irreplaceable recording from a file that can be rebuilt on demand.
+ */
+export const ARTIFACT_ORIGINS = Object.freeze(["captured", "derived", "authored"]);
+/**
+ * Narrows an unvalidated string to {@link ArtifactOrigin}.
+ *
+ * This is the guard that matters most: `origin` is the only field saying what
+ * must never be lost, and a value that fails this check must be treated as
+ * unknown — never defaulted to `"derived"`, which would mark an unrepeatable
+ * take as regenerable.
+ */
+export function isArtifactOrigin(value) {
+    return typeof value === "string" && ARTIFACT_ORIGINS.includes(value);
+}
+/**
+ * What a set gathers.
+ *
+ * Composition, Episode, Melody and Film are siblings at the same level — none is
+ * an extension of another, and none is a special case of a recording. `inquiry`
+ * is the IAIP folder. Absent means the gathering was observed without being
+ * classified — an absence, not an error — and `other` is a set whose source
+ * named a kind this list does not carry yet.
+ */
+export const ARTIFACT_SET_KINDS = Object.freeze([
+    "inquiry",
+    "composition",
+    "episode",
+    "melody",
+    "film",
+    "other",
+]);
+/** Narrows an unvalidated string to {@link ArtifactSetKind}. */
+export function isArtifactSetKind(value) {
+    return typeof value === "string" && ARTIFACT_SET_KINDS.includes(value);
+}
+/**
+ * Membership direction. Both are carried because a source document states one
+ * or the other, and observation does not invent the inverse it did not read.
+ */
+export const ARTIFACT_RELATION_KINDS = Object.freeze(["member-of", "gathers"]);
+/** Narrows an unvalidated string to {@link ArtifactRelationKind}. */
+export function isArtifactRelationKind(value) {
+    return typeof value === "string" && ARTIFACT_RELATION_KINDS.includes(value);
+}
+/**
+ * What can sit on the container end of a membership edge. Composition, Episode,
+ * Melody and Film are named at the same level because they are peers under one
+ * root; `artifact-set` covers a gathering whose kind is unclassified, and
+ * `artifact` lets a set be a member of another set.
+ */
+export const ARTIFACT_RELATION_TARGET_KINDS = Object.freeze([
+    "episode",
+    "composition",
+    "melody",
+    "film",
+    "artifact-set",
+    "artifact",
+]);
+/** Narrows an unvalidated string to {@link ArtifactRelationTargetKind}. */
+export function isArtifactRelationTargetKind(value) {
+    return (typeof value === "string" &&
+        ARTIFACT_RELATION_TARGET_KINDS.includes(value));
+}
 //# sourceMappingURL=observation.js.map

package/dist/observation.js.map

@@ -1 +1 @@
-{"version":3,"file":"observation.js","sourceRoot":"","sources":["../src/observation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}
+{"version":3,"file":"observation.js","sourceRoot":"","sources":["../src/observation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuBH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,OAAO;IACP,YAAY;IACZ,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;CACC,CAAC,CAAA;AAIX,6DAA6D;AAC7D,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,cAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC3F,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC,CAAA;AAI3F;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,gBAAsC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC7F,CAAC;AAuDD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,SAAS;IACT,aAAa;IACb,SAAS;IACT,QAAQ;IACR,MAAM;IACN,OAAO;CACC,CAAC,CAAA;AAIX,gEAAgE;AAChE,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,kBAAwC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC/F,CAAC;AA+CD;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,SAAS,CAAU,CAAC,CAAA;AAIvF,qEAAqE;AACrE,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,uBAA6C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACpG,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1D,SAAS;IACT,aAAa;IACb,QAAQ;IACR,MAAM;IACN,cAAc;IACd,UAAU;CACF,CAAC,CAAA;AAIX,2EAA2E;AAC3E,MAAM,UAAU,4BAA4B,CAC1C,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACxB,8BAAoD,CAAC,QAAQ,CAAC,KAAK,CAAC,CACtE,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miadi/episodic-memory-schema",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "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",
@@ -39,15 +39,16 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "prepublishOnly": "npm run build"
+  },
   "devDependencies": {
     "typescript": "^5.4.0"
   },
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "build": "tsc",
-    "type-check": "tsc --noEmit",
-    "test": "npm run build && node --test test/*.test.mjs"
   }
-}
+}