@metaobjectsdev/sdk 0.5.0-rc.1

package/dist/records/core.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+export const RecordType = z.enum([
+    "convention",
+    "decision",
+    "principle",
+    "glossary",
+    "failure",
+]);
+export const RecordSource = z.enum([
+    "ts-ast",
+    "drizzle",
+    "prisma",
+    "openapi",
+    "human",
+    "claude",
+    "llm-from-commits",
+    "llm-from-prs",
+    "ingest:ts-ast",
+    "ingest:drizzle",
+    "ingest:zod",
+]);
+export const RecordCore = z.object({
+    schema_version: z.literal(1),
+    type: RecordType,
+    id: z.string().regex(/^[a-z0-9][a-z0-9-]*$/),
+    title: z.string(),
+    confidence: z.number().min(0).max(1),
+    source: RecordSource,
+    captured_at: z.string().datetime(),
+    last_validated_against_commit: z.string(),
+    superseded_by: z.string().optional(),
+    evidence: z
+        .object({
+        commits: z.array(z.string()).optional(),
+        prs: z.array(z.string()).optional(),
+        conversation_id: z.string().optional(),
+    })
+        .optional(),
+    deviations: z
+        .array(z.object({
+        when: z.string().datetime(),
+        why: z.string(),
+        conversation_id: z.string().optional(),
+    }))
+        .default([]),
+});
+//# sourceMappingURL=core.js.map

package/dist/records/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/records/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC;IAC/B,YAAY;IACZ,UAAU;IACV,WAAW;IACX,UAAU;IACV,SAAS;CACV,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC;IACjC,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,SAAS;IACT,OAAO;IACP,QAAQ;IACR,kBAAkB;IAClB,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,YAAY;CACb,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5B,IAAI,EAAE,UAAU;IAChB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sBAAsB,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,MAAM,EAAE,YAAY;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,6BAA6B,EAAE,CAAC,CAAC,MAAM,EAAE;IACzC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACvC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACnC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACvC,CAAC;SACD,QAAQ,EAAE;IACb,UAAU,EAAE,CAAC;SACV,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACvC,CAAC,CACH;SACA,OAAO,CAAC,EAAE,CAAC;CACf,CAAC,CAAC"}

package/dist/records/decision.d.ts

@@ -0,0 +1,90 @@
+import { z } from "zod";
+export declare const DecisionRecord: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    title: z.ZodString;
+    confidence: z.ZodNumber;
+    source: z.ZodEnum<["ts-ast", "drizzle", "prisma", "openapi", "human", "claude", "llm-from-commits", "llm-from-prs", "ingest:ts-ast", "ingest:drizzle", "ingest:zod"]>;
+    captured_at: z.ZodString;
+    last_validated_against_commit: z.ZodString;
+    superseded_by: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodObject<{
+        commits: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        prs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        conversation_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        commits?: string[] | undefined;
+        prs?: string[] | undefined;
+        conversation_id?: string | undefined;
+    }, {
+        commits?: string[] | undefined;
+        prs?: string[] | undefined;
+        conversation_id?: string | undefined;
+    }>>;
+    deviations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        when: z.ZodString;
+        why: z.ZodString;
+        conversation_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        when: string;
+        why: string;
+        conversation_id?: string | undefined;
+    }, {
+        when: string;
+        why: string;
+        conversation_id?: string | undefined;
+    }>, "many">>;
+} & {
+    type: z.ZodLiteral<"decision">;
+    rationale: z.ZodString;
+    alternatives_considered: z.ZodArray<z.ZodString, "many">;
+    scope: z.ZodUnion<[z.ZodLiteral<"global">, z.ZodArray<z.ZodString, "many">]>;
+}, "strip", z.ZodTypeAny, {
+    type: "decision";
+    schema_version: 1;
+    id: string;
+    title: string;
+    confidence: number;
+    source: "ts-ast" | "drizzle" | "prisma" | "openapi" | "human" | "claude" | "llm-from-commits" | "llm-from-prs" | "ingest:ts-ast" | "ingest:drizzle" | "ingest:zod";
+    captured_at: string;
+    last_validated_against_commit: string;
+    deviations: {
+        when: string;
+        why: string;
+        conversation_id?: string | undefined;
+    }[];
+    rationale: string;
+    alternatives_considered: string[];
+    scope: string[] | "global";
+    superseded_by?: string | undefined;
+    evidence?: {
+        commits?: string[] | undefined;
+        prs?: string[] | undefined;
+        conversation_id?: string | undefined;
+    } | undefined;
+}, {
+    type: "decision";
+    schema_version: 1;
+    id: string;
+    title: string;
+    confidence: number;
+    source: "ts-ast" | "drizzle" | "prisma" | "openapi" | "human" | "claude" | "llm-from-commits" | "llm-from-prs" | "ingest:ts-ast" | "ingest:drizzle" | "ingest:zod";
+    captured_at: string;
+    last_validated_against_commit: string;
+    rationale: string;
+    alternatives_considered: string[];
+    scope: string[] | "global";
+    superseded_by?: string | undefined;
+    evidence?: {
+        commits?: string[] | undefined;
+        prs?: string[] | undefined;
+        conversation_id?: string | undefined;
+    } | undefined;
+    deviations?: {
+        when: string;
+        why: string;
+        conversation_id?: string | undefined;
+    }[] | undefined;
+}>;
+export type DecisionRecord = z.infer<typeof DecisionRecord>;
+//# sourceMappingURL=decision.d.ts.map

package/dist/records/decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../src/records/decision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/records/decision.js

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import { RecordCore } from "./core.js";
+export const DecisionRecord = RecordCore.extend({
+    type: z.literal("decision"),
+    rationale: z.string(),
+    alternatives_considered: z.array(z.string()),
+    scope: z.union([z.literal("global"), z.array(z.string())]),
+});
+//# sourceMappingURL=decision.js.map

package/dist/records/decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../src/records/decision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,uBAAuB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;CAC3D,CAAC,CAAC"}

package/dist/records/failure.d.ts

@@ -0,0 +1,93 @@
+import { z } from "zod";
+export declare const FailureRecord: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    title: z.ZodString;
+    confidence: z.ZodNumber;
+    source: z.ZodEnum<["ts-ast", "drizzle", "prisma", "openapi", "human", "claude", "llm-from-commits", "llm-from-prs", "ingest:ts-ast", "ingest:drizzle", "ingest:zod"]>;
+    captured_at: z.ZodString;
+    last_validated_against_commit: z.ZodString;
+    superseded_by: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodObject<{
+        commits: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        prs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        conversation_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        commits?: string[] | undefined;
+        prs?: string[] | undefined;
+        conversation_id?: string | undefined;
+    }, {
+        commits?: string[] | undefined;
+        prs?: string[] | undefined;
+        conversation_id?: string | undefined;
+    }>>;
+    deviations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        when: z.ZodString;
+        why: z.ZodString;
+        conversation_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        when: string;
+        why: string;
+        conversation_id?: string | undefined;
+    }, {
+        when: string;
+        why: string;
+        conversation_id?: string | undefined;
+    }>, "many">>;
+} & {
+    type: z.ZodLiteral<"failure">;
+    what_was_tried: z.ZodString;
+    why_it_failed: z.ZodString;
+    do_not_repeat_in: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    related_decisions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "failure";
+    schema_version: 1;
+    id: string;
+    title: string;
+    confidence: number;
+    source: "ts-ast" | "drizzle" | "prisma" | "openapi" | "human" | "claude" | "llm-from-commits" | "llm-from-prs" | "ingest:ts-ast" | "ingest:drizzle" | "ingest:zod";
+    captured_at: string;
+    last_validated_against_commit: string;
+    deviations: {
+        when: string;
+        why: string;
+        conversation_id?: string | undefined;
+    }[];
+    what_was_tried: string;
+    why_it_failed: string;
+    superseded_by?: string | undefined;
+    evidence?: {
+        commits?: string[] | undefined;
+        prs?: string[] | undefined;
+        conversation_id?: string | undefined;
+    } | undefined;
+    do_not_repeat_in?: string[] | undefined;
+    related_decisions?: string[] | undefined;
+}, {
+    type: "failure";
+    schema_version: 1;
+    id: string;
+    title: string;
+    confidence: number;
+    source: "ts-ast" | "drizzle" | "prisma" | "openapi" | "human" | "claude" | "llm-from-commits" | "llm-from-prs" | "ingest:ts-ast" | "ingest:drizzle" | "ingest:zod";
+    captured_at: string;
+    last_validated_against_commit: string;
+    what_was_tried: string;
+    why_it_failed: string;
+    superseded_by?: string | undefined;
+    evidence?: {
+        commits?: string[] | undefined;
+        prs?: string[] | undefined;
+        conversation_id?: string | undefined;
+    } | undefined;
+    deviations?: {
+        when: string;
+        why: string;
+        conversation_id?: string | undefined;
+    }[] | undefined;
+    do_not_repeat_in?: string[] | undefined;
+    related_decisions?: string[] | undefined;
+}>;
+export type FailureRecord = z.infer<typeof FailureRecord>;
+//# sourceMappingURL=failure.d.ts.map

package/dist/records/failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure.d.ts","sourceRoot":"","sources":["../../src/records/failure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/records/failure.js

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import { RecordCore } from "./core.js";
+export const FailureRecord = RecordCore.extend({
+    type: z.literal("failure"),
+    what_was_tried: z.string(),
+    why_it_failed: z.string(),
+    do_not_repeat_in: z.array(z.string()).optional(),
+    related_decisions: z.array(z.string()).optional(),
+});
+//# sourceMappingURL=failure.js.map

package/dist/records/failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure.js","sourceRoot":"","sources":["../../src/records/failure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAChD,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC"}

package/dist/records/glossary.d.ts

@@ -0,0 +1,111 @@
+import { z } from "zod";
+export declare const GlossaryRecord: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    title: z.ZodString;
+    confidence: z.ZodNumber;
+    source: z.ZodEnum<["ts-ast", "drizzle", "prisma", "openapi", "human", "claude", "llm-from-commits", "llm-from-prs", "ingest:ts-ast", "ingest:drizzle", "ingest:zod"]>;
+    captured_at: z.ZodString;
+    last_validated_against_commit: z.ZodString;
+    superseded_by: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodObject<{
+        commits: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        prs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        conversation_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        commits?: string[] | undefined;
+        prs?: string[] | undefined;
+        conversation_id?: string | undefined;
+    }, {
+        commits?: string[] | undefined;
+        prs?: string[] | undefined;
+        conversation_id?: string | undefined;
+    }>>;
+    deviations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        when: z.ZodString;
+        why: z.ZodString;
+        conversation_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        when: string;
+        why: string;
+        conversation_id?: string | undefined;
+    }, {
+        when: string;
+        why: string;
+        conversation_id?: string | undefined;
+    }>, "many">>;
+} & {
+    type: z.ZodLiteral<"glossary">;
+    term: z.ZodString;
+    synonyms: z.ZodArray<z.ZodString, "many">;
+    definition: z.ZodString;
+    code_anchors: z.ZodObject<{
+        entity: z.ZodOptional<z.ZodString>;
+        files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        entity?: string | undefined;
+        files?: string[] | undefined;
+    }, {
+        entity?: string | undefined;
+        files?: string[] | undefined;
+    }>;
+    see_also: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "glossary";
+    schema_version: 1;
+    id: string;
+    title: string;
+    confidence: number;
+    source: "ts-ast" | "drizzle" | "prisma" | "openapi" | "human" | "claude" | "llm-from-commits" | "llm-from-prs" | "ingest:ts-ast" | "ingest:drizzle" | "ingest:zod";
+    captured_at: string;
+    last_validated_against_commit: string;
+    deviations: {
+        when: string;
+        why: string;
+        conversation_id?: string | undefined;
+    }[];
+    term: string;
+    synonyms: string[];
+    definition: string;
+    code_anchors: {
+        entity?: string | undefined;
+        files?: string[] | undefined;
+    };
+    see_also: string[];
+    superseded_by?: string | undefined;
+    evidence?: {
+        commits?: string[] | undefined;
+        prs?: string[] | undefined;
+        conversation_id?: string | undefined;
+    } | undefined;
+}, {
+    type: "glossary";
+    schema_version: 1;
+    id: string;
+    title: string;
+    confidence: number;
+    source: "ts-ast" | "drizzle" | "prisma" | "openapi" | "human" | "claude" | "llm-from-commits" | "llm-from-prs" | "ingest:ts-ast" | "ingest:drizzle" | "ingest:zod";
+    captured_at: string;
+    last_validated_against_commit: string;
+    term: string;
+    synonyms: string[];
+    definition: string;
+    code_anchors: {
+        entity?: string | undefined;
+        files?: string[] | undefined;
+    };
+    see_also: string[];
+    superseded_by?: string | undefined;
+    evidence?: {
+        commits?: string[] | undefined;
+        prs?: string[] | undefined;
+        conversation_id?: string | undefined;
+    } | undefined;
+    deviations?: {
+        when: string;
+        why: string;
+        conversation_id?: string | undefined;
+    }[] | undefined;
+}>;
+export type GlossaryRecord = z.infer<typeof GlossaryRecord>;
+//# sourceMappingURL=glossary.d.ts.map

package/dist/records/glossary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../../src/records/glossary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/records/glossary.js

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import { RecordCore } from "./core.js";
+export const GlossaryRecord = RecordCore.extend({
+    type: z.literal("glossary"),
+    term: z.string(),
+    synonyms: z.array(z.string()),
+    definition: z.string(),
+    code_anchors: z.object({
+        entity: z.string().optional(),
+        files: z.array(z.string()).optional(),
+    }),
+    see_also: z.array(z.string()),
+});
+//# sourceMappingURL=glossary.js.map

package/dist/records/glossary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.js","sourceRoot":"","sources":["../../src/records/glossary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;QACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KACtC,CAAC;IACF,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC9B,CAAC,CAAC"}

package/dist/records/principle.d.ts

@@ -0,0 +1,99 @@
+import { z } from "zod";
+export declare const PrincipleRecord: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    title: z.ZodString;
+    confidence: z.ZodNumber;
+    source: z.ZodEnum<["ts-ast", "drizzle", "prisma", "openapi", "human", "claude", "llm-from-commits", "llm-from-prs", "ingest:ts-ast", "ingest:drizzle", "ingest:zod"]>;
+    captured_at: z.ZodString;
+    last_validated_against_commit: z.ZodString;
+    superseded_by: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodObject<{
+        commits: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        prs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        conversation_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        commits?: string[] | undefined;
+        prs?: string[] | undefined;
+        conversation_id?: string | undefined;
+    }, {
+        commits?: string[] | undefined;
+        prs?: string[] | undefined;
+        conversation_id?: string | undefined;
+    }>>;
+    deviations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        when: z.ZodString;
+        why: z.ZodString;
+        conversation_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        when: string;
+        why: string;
+        conversation_id?: string | undefined;
+    }, {
+        when: string;
+        why: string;
+        conversation_id?: string | undefined;
+    }>, "many">>;
+} & {
+    type: z.ZodLiteral<"principle">;
+    statement: z.ZodString;
+    rationale: z.ZodString;
+    scope: z.ZodArray<z.ZodString, "many">;
+    examples: z.ZodArray<z.ZodString, "many">;
+    counter_examples: z.ZodArray<z.ZodString, "many">;
+    enforcement: z.ZodDefault<z.ZodEnum<["advisory", "block"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "principle";
+    schema_version: 1;
+    id: string;
+    title: string;
+    confidence: number;
+    source: "ts-ast" | "drizzle" | "prisma" | "openapi" | "human" | "claude" | "llm-from-commits" | "llm-from-prs" | "ingest:ts-ast" | "ingest:drizzle" | "ingest:zod";
+    captured_at: string;
+    last_validated_against_commit: string;
+    deviations: {
+        when: string;
+        why: string;
+        conversation_id?: string | undefined;
+    }[];
+    examples: string[];
+    rationale: string;
+    scope: string[];
+    statement: string;
+    counter_examples: string[];
+    enforcement: "advisory" | "block";
+    superseded_by?: string | undefined;
+    evidence?: {
+        commits?: string[] | undefined;
+        prs?: string[] | undefined;
+        conversation_id?: string | undefined;
+    } | undefined;
+}, {
+    type: "principle";
+    schema_version: 1;
+    id: string;
+    title: string;
+    confidence: number;
+    source: "ts-ast" | "drizzle" | "prisma" | "openapi" | "human" | "claude" | "llm-from-commits" | "llm-from-prs" | "ingest:ts-ast" | "ingest:drizzle" | "ingest:zod";
+    captured_at: string;
+    last_validated_against_commit: string;
+    examples: string[];
+    rationale: string;
+    scope: string[];
+    statement: string;
+    counter_examples: string[];
+    superseded_by?: string | undefined;
+    evidence?: {
+        commits?: string[] | undefined;
+        prs?: string[] | undefined;
+        conversation_id?: string | undefined;
+    } | undefined;
+    deviations?: {
+        when: string;
+        why: string;
+        conversation_id?: string | undefined;
+    }[] | undefined;
+    enforcement?: "advisory" | "block" | undefined;
+}>;
+export type PrincipleRecord = z.infer<typeof PrincipleRecord>;
+//# sourceMappingURL=principle.d.ts.map

package/dist/records/principle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"principle.d.ts","sourceRoot":"","sources":["../../src/records/principle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/records/principle.js

@@ -0,0 +1,12 @@
+import { z } from "zod";
+import { RecordCore } from "./core.js";
+export const PrincipleRecord = RecordCore.extend({
+    type: z.literal("principle"),
+    statement: z.string(),
+    rationale: z.string(),
+    scope: z.array(z.string()),
+    examples: z.array(z.string()),
+    counter_examples: z.array(z.string()),
+    enforcement: z.enum(["advisory", "block"]).default("advisory"),
+});
+//# sourceMappingURL=principle.js.map

package/dist/records/principle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"principle.js","sourceRoot":"","sources":["../../src/records/principle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACrC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;CAC/D,CAAC,CAAC"}

package/dist/storage/errors.d.ts

@@ -0,0 +1,14 @@
+export declare class MetaForgeRecordNotFoundError extends Error {
+    readonly path: string;
+    constructor(path: string);
+}
+export declare class MetaForgeAlreadyPromotedError extends Error {
+    readonly path: string;
+    constructor(path: string);
+}
+export declare class MetaForgeRecordParseError extends Error {
+    readonly path: string;
+    readonly cause: unknown;
+    constructor(path: string, cause: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/storage/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/storage/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,4BAA6B,SAAQ,KAAK;aACzB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIzC;AAED,qBAAa,6BAA8B,SAAQ,KAAK;aAC1B,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIzC;AAED,qBAAa,yBAA0B,SAAQ,KAAK;aAEhC,IAAI,EAAE,MAAM;aACH,KAAK,EAAE,OAAO;gBADvB,IAAI,EAAE,MAAM,EACH,KAAK,EAAE,OAAO;CAK1C"}

package/dist/storage/errors.js

@@ -0,0 +1,27 @@
+export class MetaForgeRecordNotFoundError extends Error {
+    path;
+    constructor(path) {
+        super(`Record not found: ${path}`);
+        this.path = path;
+        this.name = "MetaForgeRecordNotFoundError";
+    }
+}
+export class MetaForgeAlreadyPromotedError extends Error {
+    path;
+    constructor(path) {
+        super(`A canonical record already exists at: ${path}`);
+        this.path = path;
+        this.name = "MetaForgeAlreadyPromotedError";
+    }
+}
+export class MetaForgeRecordParseError extends Error {
+    path;
+    cause;
+    constructor(path, cause) {
+        super(`Failed to parse record at ${path}: ${cause instanceof Error ? cause.message : String(cause)}`);
+        this.path = path;
+        this.cause = cause;
+        this.name = "MetaForgeRecordParseError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/storage/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/storage/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACzB;IAA5B,YAA4B,IAAY;QACtC,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;QADT,SAAI,GAAJ,IAAI,CAAQ;QAEtC,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAC1B;IAA5B,YAA4B,IAAY;QACtC,KAAK,CAAC,yCAAyC,IAAI,EAAE,CAAC,CAAC;QAD7B,SAAI,GAAJ,IAAI,CAAQ;QAEtC,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAEhC;IACS;IAF3B,YACkB,IAAY,EACH,KAAc;QAEvC,KAAK,CAAC,6BAA6B,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAHtF,SAAI,GAAJ,IAAI,CAAQ;QACH,UAAK,GAAL,KAAK,CAAS;QAGvC,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF"}

package/dist/storage/index.d.ts

@@ -0,0 +1,7 @@
+export { readRecord, recordExists } from "./read.js";
+export { writeRecord, removeRecord } from "./write.js";
+export { listRecords } from "./list.js";
+export type { ListOptions } from "./list.js";
+export { promoteRecord, supersede } from "./lifecycle.js";
+export { MetaForgeRecordNotFoundError, MetaForgeAlreadyPromotedError, MetaForgeRecordParseError, } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,aAAa,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,6 @@
+export { readRecord, recordExists } from "./read.js";
+export { writeRecord, removeRecord } from "./write.js";
+export { listRecords } from "./list.js";
+export { promoteRecord, supersede } from "./lifecycle.js";
+export { MetaForgeRecordNotFoundError, MetaForgeAlreadyPromotedError, MetaForgeRecordParseError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,aAAa,CAAC"}

package/dist/storage/lifecycle.d.ts

@@ -0,0 +1,5 @@
+import type { AnyRecord } from "../records/any.js";
+import type { RecordType } from "../records/core.js";
+export declare function promoteRecord(metaRoot: string, type: RecordType, id: string): Promise<void>;
+export declare function supersede(metaRoot: string, oldId: string, newRecord: AnyRecord): Promise<void>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/storage/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/storage/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMrD,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/storage/lifecycle.js

@@ -0,0 +1,27 @@
+import { readRecord, recordExists } from "./read.js";
+import { writeRecord, removeRecord } from "./write.js";
+import { MetaForgeAlreadyPromotedError, MetaForgeRecordNotFoundError } from "./errors.js";
+import { recordPath } from "../paths.js";
+export async function promoteRecord(metaRoot, type, id) {
+    if (!(await recordExists(metaRoot, type, id, { pending: true }))) {
+        throw new MetaForgeRecordNotFoundError(recordPath(metaRoot, type, id, { pending: true }));
+    }
+    if (await recordExists(metaRoot, type, id)) {
+        throw new MetaForgeAlreadyPromotedError(recordPath(metaRoot, type, id));
+    }
+    const record = await readRecord(metaRoot, type, id, { pending: true });
+    await writeRecord(metaRoot, record);
+    await removeRecord(metaRoot, type, id, { pending: true });
+}
+export async function supersede(metaRoot, oldId, newRecord) {
+    if (!(await recordExists(metaRoot, newRecord.type, oldId))) {
+        throw new MetaForgeRecordNotFoundError(recordPath(metaRoot, newRecord.type, oldId));
+    }
+    // Write the new record first, so a failure leaves the old record intact.
+    await writeRecord(metaRoot, newRecord);
+    // Then update the old record to mark it superseded.
+    const old = await readRecord(metaRoot, newRecord.type, oldId);
+    const updated = { ...old, superseded_by: newRecord.id };
+    await writeRecord(metaRoot, updated);
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/storage/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/storage/lifecycle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,IAAgB,EAChB,EAAU;IAEV,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,4BAA4B,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,MAAM,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,6BAA6B,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,MAAM,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAgB,EAChB,KAAa,EACb,SAAoB;IAEpB,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,4BAA4B,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACtF,CAAC;IACD,yEAAyE;IACzE,MAAM,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACvC,oDAAoD;IACpD,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,EAAE,GAAG,GAAG,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC;IACxD,MAAM,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC"}