@metaobjectsdev/sdk 0.5.0-rc.1

package/dist/config.d.ts

@@ -0,0 +1,113 @@
+import { z } from "zod";
+export declare const ConfigSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    pending_in_git: z.ZodDefault<z.ZodBoolean>;
+    confidence_thresholds: z.ZodDefault<z.ZodObject<{
+        pending_promote: z.ZodDefault<z.ZodNumber>;
+        drift_warn: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        pending_promote: number;
+        drift_warn: number;
+    }, {
+        pending_promote?: number | undefined;
+        drift_warn?: number | undefined;
+    }>>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"path">;
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        kind: "path";
+    }, {
+        path: string;
+        kind: "path";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"package">;
+        package: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "package";
+        package: string;
+    }, {
+        kind: "package";
+        package: string;
+    }>]>, "many">>;
+    extract: z.ZodDefault<z.ZodObject<{
+        metaignore: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        metaignore?: string | undefined;
+    }, {
+        metaignore?: string | undefined;
+    }>>;
+    migrate: z.ZodOptional<z.ZodObject<{
+        outDir: z.ZodOptional<z.ZodString>;
+        databaseUrl: z.ZodOptional<z.ZodString>;
+        dialect: z.ZodOptional<z.ZodEnum<["sqlite", "postgres"]>>;
+        onAmbiguous: z.ZodOptional<z.ZodEnum<["abort", "rename", "drop-add"]>>;
+        allow: z.ZodOptional<z.ZodArray<z.ZodEnum<["drop-column", "drop-table", "type-change", "drop-index", "drop-fk", "nullable-to-not-null"]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        outDir?: string | undefined;
+        databaseUrl?: string | undefined;
+        dialect?: "sqlite" | "postgres" | undefined;
+        onAmbiguous?: "abort" | "rename" | "drop-add" | undefined;
+        allow?: ("drop-column" | "drop-table" | "type-change" | "drop-index" | "drop-fk" | "nullable-to-not-null")[] | undefined;
+    }, {
+        outDir?: string | undefined;
+        databaseUrl?: string | undefined;
+        dialect?: "sqlite" | "postgres" | undefined;
+        onAmbiguous?: "abort" | "rename" | "drop-add" | undefined;
+        allow?: ("drop-column" | "drop-table" | "type-change" | "drop-index" | "drop-fk" | "nullable-to-not-null")[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    schema_version: 1;
+    pending_in_git: boolean;
+    confidence_thresholds: {
+        pending_promote: number;
+        drift_warn: number;
+    };
+    sources: ({
+        path: string;
+        kind: "path";
+    } | {
+        kind: "package";
+        package: string;
+    })[];
+    extract: {
+        metaignore?: string | undefined;
+    };
+    migrate?: {
+        outDir?: string | undefined;
+        databaseUrl?: string | undefined;
+        dialect?: "sqlite" | "postgres" | undefined;
+        onAmbiguous?: "abort" | "rename" | "drop-add" | undefined;
+        allow?: ("drop-column" | "drop-table" | "type-change" | "drop-index" | "drop-fk" | "nullable-to-not-null")[] | undefined;
+    } | undefined;
+}, {
+    schema_version: 1;
+    pending_in_git?: boolean | undefined;
+    confidence_thresholds?: {
+        pending_promote?: number | undefined;
+        drift_warn?: number | undefined;
+    } | undefined;
+    sources?: ({
+        path: string;
+        kind: "path";
+    } | {
+        kind: "package";
+        package: string;
+    })[] | undefined;
+    extract?: {
+        metaignore?: string | undefined;
+    } | undefined;
+    migrate?: {
+        outDir?: string | undefined;
+        databaseUrl?: string | undefined;
+        dialect?: "sqlite" | "postgres" | undefined;
+        onAmbiguous?: "abort" | "rename" | "drop-add" | undefined;
+        allow?: ("drop-column" | "drop-table" | "type-change" | "drop-index" | "drop-fk" | "nullable-to-not-null")[] | undefined;
+    } | undefined;
+}>;
+export type Config = z.infer<typeof ConfigSchema>;
+export declare const DEFAULT_CONFIG: Config;
+export declare function loadConfig(metaRoot: string): Promise<Config>;
+export declare function saveConfig(metaRoot: string, config: Config): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,cAAc,EAAE,MAAkD,CAAC;AAIhF,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGlE;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhF"}

package/dist/config.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+const DialectEnum = z.enum(["sqlite", "postgres"]);
+const OnAmbiguousEnum = z.enum(["abort", "rename", "drop-add"]);
+const AllowTokenEnum = z.enum([
+    "drop-column",
+    "drop-table",
+    "type-change",
+    "drop-index",
+    "drop-fk",
+    "nullable-to-not-null",
+]);
+const MigrateBlock = z.object({
+    outDir: z.string(),
+    databaseUrl: z.string(),
+    dialect: DialectEnum,
+    onAmbiguous: OnAmbiguousEnum,
+    allow: z.array(AllowTokenEnum),
+}).partial();
+export const ConfigSchema = z.object({
+    schema_version: z.literal(1),
+    pending_in_git: z.boolean().default(true),
+    confidence_thresholds: z
+        .object({
+        pending_promote: z.number().min(0).max(1).default(0.8),
+        drift_warn: z.number().min(0).max(1).default(0.7),
+    })
+        .default({}),
+    sources: z
+        .array(z.union([
+        z.object({ kind: z.literal("path"), path: z.string() }),
+        z.object({ kind: z.literal("package"), package: z.string() }),
+    ]))
+        .default([]),
+    extract: z
+        .object({
+        metaignore: z.string().optional(),
+    })
+        .default({}),
+    migrate: MigrateBlock.optional(),
+});
+export const DEFAULT_CONFIG = ConfigSchema.parse({ schema_version: 1 });
+const CONFIG_FILE = "config.json";
+export async function loadConfig(metaRoot) {
+    const raw = await readFile(join(metaRoot, CONFIG_FILE), "utf8");
+    return ConfigSchema.parse(JSON.parse(raw));
+}
+export async function saveConfig(metaRoot, config) {
+    ConfigSchema.parse(config); // validate before writing
+    await writeFile(join(metaRoot, CONFIG_FILE), JSON.stringify(config, null, 2) + "\n", "utf8");
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/forge-types.d.ts

@@ -0,0 +1,47 @@
+export declare const FORGE_TYPE_DECISION = "decision";
+export declare const FORGE_TYPE_PRINCIPLE = "principle";
+export declare const FORGE_TYPE_CONVENTION = "convention";
+export declare const FORGE_TYPE_GLOSSARY = "glossary";
+export declare const FORGE_TYPE_FAILURE = "failure";
+export declare const FORGE_TYPES: readonly ["decision", "principle", "convention", "glossary", "failure"];
+export type ForgeType = (typeof FORGE_TYPES)[number];
+export declare const FORGE_DECISION_SUBTYPES: readonly ["base", "global", "scoped"];
+export declare const FORGE_PRINCIPLE_SUBTYPES: readonly ["base", "advisory", "enforced"];
+export declare const FORGE_CONVENTION_SUBTYPES: readonly ["base"];
+export declare const FORGE_GLOSSARY_SUBTYPES: readonly ["base"];
+export declare const FORGE_FAILURE_SUBTYPES: readonly ["base"];
+export declare const FORGE_ATTR_CONFIDENCE = "forgeConfidence";
+export declare const FORGE_ATTR_SOURCE = "forgeSource";
+export declare const FORGE_ATTR_CAPTURED_AT = "forgeCapturedAt";
+export declare const FORGE_ATTR_LAST_VALIDATED_COMMIT = "forgeLastValidatedCommit";
+export declare const FORGE_ATTR_PRIMARY_LOCATION = "forgePrimaryLocation";
+export declare const FORGE_ATTR_OCCURRENCES = "forgeOccurrences";
+export declare const FORGE_ATTR_RATIONALE = "forgeRationale";
+export declare const FORGE_ATTR_ALTERNATIVES = "forgeAlternatives";
+export declare const FORGE_ATTR_SCOPE = "forgeScope";
+export declare const FORGE_ATTR_STATEMENT = "forgeStatement";
+export declare const FORGE_ATTR_ENFORCEMENT = "forgeEnforcement";
+export declare const FORGE_ATTR_PATTERN_DESCRIPTION = "forgePatternDescription";
+export declare const FORGE_ATTR_EXAMPLES = "forgeExamples";
+export declare const FORGE_ATTR_COUNTER_EXAMPLES = "forgeCounterExamples";
+export declare const FORGE_ATTR_APPLIES_TO = "forgeAppliesTo";
+export declare const FORGE_ATTR_TERM = "forgeTerm";
+export declare const FORGE_ATTR_SYNONYMS = "forgeSynonyms";
+export declare const FORGE_ATTR_DEFINITION = "forgeDefinition";
+export declare const FORGE_ATTR_CODE_ANCHORS = "forgeCodeAnchors";
+export declare const FORGE_ATTR_SEE_ALSO = "forgeSeeAlso";
+export declare const FORGE_ATTR_WHAT_WAS_TRIED = "forgeWhatWasTried";
+export declare const FORGE_ATTR_WHY_IT_FAILED = "forgeWhyItFailed";
+export declare const FORGE_ATTRS: readonly ["forgeConfidence", "forgeSource", "forgeCapturedAt", "forgeLastValidatedCommit", "forgePrimaryLocation", "forgeOccurrences", "forgeRationale", "forgeAlternatives", "forgeScope", "forgeStatement", "forgeEnforcement", "forgePatternDescription", "forgeExamples", "forgeCounterExamples", "forgeAppliesTo", "forgeTerm", "forgeSynonyms", "forgeDefinition", "forgeCodeAnchors", "forgeSeeAlso", "forgeWhatWasTried", "forgeWhyItFailed"];
+export type ForgeAttr = (typeof FORGE_ATTRS)[number];
+import { TypeRegistry } from "@metaobjectsdev/metadata";
+/**
+ * Register Meta Forge's five descriptive top-level types into the given
+ * registry. Must be called AFTER `registerCoreTypes()`.
+ *
+ * Each type accepts `attr` children for expanded-form @forge* attributes.
+ * Loader's default permissive mode tolerates these new types as children
+ * of the metadata wrapper (unknowns are warned, not errored).
+ */
+export declare function registerForgeTypes(registry: TypeRegistry): void;
+//# sourceMappingURL=forge-types.d.ts.map

package/dist/forge-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-types.d.ts","sourceRoot":"","sources":["../src/forge-types.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAC9C,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAChD,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAClD,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAC9C,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C,eAAO,MAAM,WAAW,yEAMd,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAMrD,eAAO,MAAM,uBAAuB,uCAAwC,CAAC;AAC7E,eAAO,MAAM,wBAAwB,2CAA4C,CAAC;AAClF,eAAO,MAAM,yBAAyB,mBAAoB,CAAC;AAC3D,eAAO,MAAM,uBAAuB,mBAAoB,CAAC;AACzD,eAAO,MAAM,sBAAsB,mBAAoB,CAAC;AAOxD,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AACvD,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAC/C,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AACxD,eAAO,MAAM,gCAAgC,6BAA6B,CAAC;AAG3E,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAClE,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAGzD,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AACrD,eAAO,MAAM,uBAAuB,sBAAsB,CAAC;AAC3D,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAG7C,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AACrD,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAGzD,eAAO,MAAM,8BAA8B,4BAA4B,CAAC;AACxE,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AACnD,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAClE,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AAGtD,eAAO,MAAM,eAAe,cAAc,CAAC;AAC3C,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AACnD,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AACvD,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAC1D,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAGlD,eAAO,MAAM,yBAAyB,sBAAsB,CAAC;AAC7D,eAAO,MAAM,wBAAwB,qBAAqB,CAAC;AAE3D,eAAO,MAAM,WAAW,ubAuBd,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAMrD,OAAO,EAIL,YAAY,EAIb,MAAM,0BAA0B,CAAC;AA4BlC;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAkB/D"}

package/dist/forge-types.js

@@ -0,0 +1,133 @@
+// Meta Forge type + attribute name constants. Centralized for typo-safety
+// per CLAUDE.md ("Named constants for metamodel strings — always") and so
+// downstream readers (codegen prompts, MCP exposers) have one source of
+// truth. See SP5 §4 for the design rationale.
+// ---------------------------------------------------------------------------
+// New top-level types registered by registerForgeTypes()
+// ---------------------------------------------------------------------------
+export const FORGE_TYPE_DECISION = "decision";
+export const FORGE_TYPE_PRINCIPLE = "principle";
+export const FORGE_TYPE_CONVENTION = "convention";
+export const FORGE_TYPE_GLOSSARY = "glossary";
+export const FORGE_TYPE_FAILURE = "failure";
+export const FORGE_TYPES = [
+    FORGE_TYPE_DECISION,
+    FORGE_TYPE_PRINCIPLE,
+    FORGE_TYPE_CONVENTION,
+    FORGE_TYPE_GLOSSARY,
+    FORGE_TYPE_FAILURE,
+];
+// ---------------------------------------------------------------------------
+// Subtypes per type (open lists; "base" is always valid)
+// ---------------------------------------------------------------------------
+export const FORGE_DECISION_SUBTYPES = ["base", "global", "scoped"];
+export const FORGE_PRINCIPLE_SUBTYPES = ["base", "advisory", "enforced"];
+export const FORGE_CONVENTION_SUBTYPES = ["base"];
+export const FORGE_GLOSSARY_SUBTYPES = ["base"];
+export const FORGE_FAILURE_SUBTYPES = ["base"];
+// ---------------------------------------------------------------------------
+// @forge* attribute names (camelCase, no separator)
+// ---------------------------------------------------------------------------
+// Universal (any forge-related node)
+export const FORGE_ATTR_CONFIDENCE = "forgeConfidence";
+export const FORGE_ATTR_SOURCE = "forgeSource";
+export const FORGE_ATTR_CAPTURED_AT = "forgeCapturedAt";
+export const FORGE_ATTR_LAST_VALIDATED_COMMIT = "forgeLastValidatedCommit";
+// Object/entity
+export const FORGE_ATTR_PRIMARY_LOCATION = "forgePrimaryLocation";
+export const FORGE_ATTR_OCCURRENCES = "forgeOccurrences";
+// Decision
+export const FORGE_ATTR_RATIONALE = "forgeRationale";
+export const FORGE_ATTR_ALTERNATIVES = "forgeAlternatives";
+export const FORGE_ATTR_SCOPE = "forgeScope";
+// Principle
+export const FORGE_ATTR_STATEMENT = "forgeStatement";
+export const FORGE_ATTR_ENFORCEMENT = "forgeEnforcement";
+// Convention
+export const FORGE_ATTR_PATTERN_DESCRIPTION = "forgePatternDescription";
+export const FORGE_ATTR_EXAMPLES = "forgeExamples";
+export const FORGE_ATTR_COUNTER_EXAMPLES = "forgeCounterExamples";
+export const FORGE_ATTR_APPLIES_TO = "forgeAppliesTo";
+// Glossary
+export const FORGE_ATTR_TERM = "forgeTerm";
+export const FORGE_ATTR_SYNONYMS = "forgeSynonyms";
+export const FORGE_ATTR_DEFINITION = "forgeDefinition";
+export const FORGE_ATTR_CODE_ANCHORS = "forgeCodeAnchors";
+export const FORGE_ATTR_SEE_ALSO = "forgeSeeAlso";
+// Failure
+export const FORGE_ATTR_WHAT_WAS_TRIED = "forgeWhatWasTried";
+export const FORGE_ATTR_WHY_IT_FAILED = "forgeWhyItFailed";
+export const FORGE_ATTRS = [
+    FORGE_ATTR_CONFIDENCE,
+    FORGE_ATTR_SOURCE,
+    FORGE_ATTR_CAPTURED_AT,
+    FORGE_ATTR_LAST_VALIDATED_COMMIT,
+    FORGE_ATTR_PRIMARY_LOCATION,
+    FORGE_ATTR_OCCURRENCES,
+    FORGE_ATTR_RATIONALE,
+    FORGE_ATTR_ALTERNATIVES,
+    FORGE_ATTR_SCOPE,
+    FORGE_ATTR_STATEMENT,
+    FORGE_ATTR_ENFORCEMENT,
+    FORGE_ATTR_PATTERN_DESCRIPTION,
+    FORGE_ATTR_EXAMPLES,
+    FORGE_ATTR_COUNTER_EXAMPLES,
+    FORGE_ATTR_APPLIES_TO,
+    FORGE_ATTR_TERM,
+    FORGE_ATTR_SYNONYMS,
+    FORGE_ATTR_DEFINITION,
+    FORGE_ATTR_CODE_ANCHORS,
+    FORGE_ATTR_SEE_ALSO,
+    FORGE_ATTR_WHAT_WAS_TRIED,
+    FORGE_ATTR_WHY_IT_FAILED,
+];
+// ---------------------------------------------------------------------------
+// registerForgeTypes
+// ---------------------------------------------------------------------------
+import { TypeId, TypeRegistry, MetaData, TYPE_ATTR, CHILD_RULE_WILDCARD, } from "@metaobjectsdev/metadata";
+/** Minimal concrete MetaData subclass used for all forge descriptive nodes. */
+class MetaForgeNode extends MetaData {
+}
+function wildcardOf(childType) {
+    return {
+        childType,
+        childSubType: CHILD_RULE_WILDCARD,
+        childName: CHILD_RULE_WILDCARD,
+    };
+}
+function def(type, subType, description, childRules) {
+    return {
+        typeId: new TypeId(type, subType),
+        description,
+        factory: (typeId, name) => new MetaForgeNode(typeId, name),
+        childRules,
+        attributes: [],
+    };
+}
+/**
+ * Register Meta Forge's five descriptive top-level types into the given
+ * registry. Must be called AFTER `registerCoreTypes()`.
+ *
+ * Each type accepts `attr` children for expanded-form @forge* attributes.
+ * Loader's default permissive mode tolerates these new types as children
+ * of the metadata wrapper (unknowns are warned, not errored).
+ */
+export function registerForgeTypes(registry) {
+    const forgeChildRules = [wildcardOf(TYPE_ATTR)];
+    for (const subType of FORGE_DECISION_SUBTYPES) {
+        registry.register(def(FORGE_TYPE_DECISION, subType, `Forge decision (${subType})`, forgeChildRules));
+    }
+    for (const subType of FORGE_PRINCIPLE_SUBTYPES) {
+        registry.register(def(FORGE_TYPE_PRINCIPLE, subType, `Forge principle (${subType})`, forgeChildRules));
+    }
+    for (const subType of FORGE_CONVENTION_SUBTYPES) {
+        registry.register(def(FORGE_TYPE_CONVENTION, subType, `Forge convention (${subType})`, forgeChildRules));
+    }
+    for (const subType of FORGE_GLOSSARY_SUBTYPES) {
+        registry.register(def(FORGE_TYPE_GLOSSARY, subType, `Forge glossary entry (${subType})`, forgeChildRules));
+    }
+    for (const subType of FORGE_FAILURE_SUBTYPES) {
+        registry.register(def(FORGE_TYPE_FAILURE, subType, `Forge failure record (${subType})`, forgeChildRules));
+    }
+}
+//# sourceMappingURL=forge-types.js.map

package/dist/forge-types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export { RecordCore, RecordType, RecordSource } from "./records/core.js";
+export { ConventionRecord } from "./records/convention.js";
+export { DecisionRecord } from "./records/decision.js";
+export { PrincipleRecord } from "./records/principle.js";
+export { GlossaryRecord } from "./records/glossary.js";
+export { FailureRecord } from "./records/failure.js";
+export { AnyRecord } from "./records/any.js";
+export { readRecord, recordExists, writeRecord, removeRecord, listRecords, promoteRecord, supersede, MetaForgeRecordNotFoundError, MetaForgeAlreadyPromotedError, MetaForgeRecordParseError, } from "./storage/index.js";
+export type { ListOptions } from "./storage/index.js";
+export { recordPath, resolveMetaRoot } from "./paths.js";
+export { ConfigSchema, DEFAULT_CONFIG, loadConfig, saveConfig } from "./config.js";
+export type { Config } from "./config.js";
+export { FORGE_TYPE_DECISION, FORGE_TYPE_PRINCIPLE, FORGE_TYPE_CONVENTION, FORGE_TYPE_GLOSSARY, FORGE_TYPE_FAILURE, FORGE_TYPES, FORGE_DECISION_SUBTYPES, FORGE_PRINCIPLE_SUBTYPES, FORGE_CONVENTION_SUBTYPES, FORGE_GLOSSARY_SUBTYPES, FORGE_FAILURE_SUBTYPES, FORGE_ATTR_CONFIDENCE, FORGE_ATTR_SOURCE, FORGE_ATTR_CAPTURED_AT, FORGE_ATTR_LAST_VALIDATED_COMMIT, FORGE_ATTR_PRIMARY_LOCATION, FORGE_ATTR_OCCURRENCES, FORGE_ATTR_RATIONALE, FORGE_ATTR_ALTERNATIVES, FORGE_ATTR_SCOPE, FORGE_ATTR_STATEMENT, FORGE_ATTR_ENFORCEMENT, FORGE_ATTR_PATTERN_DESCRIPTION, FORGE_ATTR_EXAMPLES, FORGE_ATTR_COUNTER_EXAMPLES, FORGE_ATTR_APPLIES_TO, FORGE_ATTR_TERM, FORGE_ATTR_SYNONYMS, FORGE_ATTR_DEFINITION, FORGE_ATTR_CODE_ANCHORS, FORGE_ATTR_SEE_ALSO, FORGE_ATTR_WHAT_WAS_TRIED, FORGE_ATTR_WHY_IT_FAILED, FORGE_ATTRS, registerForgeTypes, } from "./forge-types.js";
+export type { ForgeType, ForgeAttr } from "./forge-types.js";
+export { loadMemory, DEFAULT_METADATA_DIR, DEFAULT_METAOBJECTS_DIR } from "./memory.js";
+export { discoverWorkspace, resolveExtendsOrder, packageLabel } from "./workspace.js";
+export type { Workspace, WorkspacePackage } from "./workspace.js";
+export { PackageManifestSchema, readPackageManifest, resolveMetaobjectsPackage, PACKAGE_MANIFEST_FILE, } from "./package.js";
+export type { PackageManifest } from "./package.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,EACL,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,SAAS,EACT,4BAA4B,EAC5B,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACnF,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAK1C,OAAO,EAEL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EAEX,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EAEtB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,gCAAgC,EAChC,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,8BAA8B,EAC9B,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,WAAW,EAEX,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAK7D,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAGxF,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtF,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOlE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,39 @@
+// Records
+export { RecordCore, RecordType, RecordSource } from "./records/core.js";
+export { ConventionRecord } from "./records/convention.js";
+export { DecisionRecord } from "./records/decision.js";
+export { PrincipleRecord } from "./records/principle.js";
+export { GlossaryRecord } from "./records/glossary.js";
+export { FailureRecord } from "./records/failure.js";
+export { AnyRecord } from "./records/any.js";
+// Storage
+export { readRecord, recordExists, writeRecord, removeRecord, listRecords, promoteRecord, supersede, MetaForgeRecordNotFoundError, MetaForgeAlreadyPromotedError, MetaForgeRecordParseError, } from "./storage/index.js";
+// Paths
+export { recordPath, resolveMetaRoot } from "./paths.js";
+// Config
+export { ConfigSchema, DEFAULT_CONFIG, loadConfig, saveConfig } from "./config.js";
+// Meta Forge metadata types + attribute name constants (registered into a
+// TypeRegistry to let Loader parse decision/principle/etc. children + the
+// @forge* attribute namespace).
+export { 
+// Type names
+FORGE_TYPE_DECISION, FORGE_TYPE_PRINCIPLE, FORGE_TYPE_CONVENTION, FORGE_TYPE_GLOSSARY, FORGE_TYPE_FAILURE, FORGE_TYPES, 
+// Subtypes
+FORGE_DECISION_SUBTYPES, FORGE_PRINCIPLE_SUBTYPES, FORGE_CONVENTION_SUBTYPES, FORGE_GLOSSARY_SUBTYPES, FORGE_FAILURE_SUBTYPES, 
+// Attribute names
+FORGE_ATTR_CONFIDENCE, FORGE_ATTR_SOURCE, FORGE_ATTR_CAPTURED_AT, FORGE_ATTR_LAST_VALIDATED_COMMIT, FORGE_ATTR_PRIMARY_LOCATION, FORGE_ATTR_OCCURRENCES, FORGE_ATTR_RATIONALE, FORGE_ATTR_ALTERNATIVES, FORGE_ATTR_SCOPE, FORGE_ATTR_STATEMENT, FORGE_ATTR_ENFORCEMENT, FORGE_ATTR_PATTERN_DESCRIPTION, FORGE_ATTR_EXAMPLES, FORGE_ATTR_COUNTER_EXAMPLES, FORGE_ATTR_APPLIES_TO, FORGE_ATTR_TERM, FORGE_ATTR_SYNONYMS, FORGE_ATTR_DEFINITION, FORGE_ATTR_CODE_ANCHORS, FORGE_ATTR_SEE_ALSO, FORGE_ATTR_WHAT_WAS_TRIED, FORGE_ATTR_WHY_IT_FAILED, FORGE_ATTRS, 
+// Registration helper
+registerForgeTypes, } from "./forge-types.js";
+// Memory loader — read metaobjects/ into a MetaData tree
+// (workspace-aware: walks extends: deps via pnpm-workspace.yaml or
+//  package.json workspaces field if present)
+export { loadMemory, DEFAULT_METADATA_DIR, DEFAULT_METAOBJECTS_DIR } from "./memory.js";
+// Workspace discovery — finds peer metadata packages in a monorepo
+export { discoverWorkspace, resolveExtendsOrder, packageLabel } from "./workspace.js";
+// Package manifest — the v0.3 package.meta.json model. Three-field manifest
+// (name, version, extends) that defines a metadata package's identity and
+// upstream dependencies. The package's metadata tree IS its public API;
+// there is no exports field. See docs/strategy/2026-05-12-v0.3-ai-first-
+// metadata-loading.md.
+export { PackageManifestSchema, readPackageManifest, resolveMetaobjectsPackage, PACKAGE_MANIFEST_FILE, } from "./package.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,UAAU;AACV,OAAO,EACL,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,SAAS,EACT,4BAA4B,EAC5B,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAG5B,QAAQ;AACR,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEzD,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGnF,0EAA0E;AAC1E,0EAA0E;AAC1E,gCAAgC;AAChC,OAAO;AACL,aAAa;AACb,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW;AACX,WAAW;AACX,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB;AACtB,kBAAkB;AAClB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,gCAAgC,EAChC,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,8BAA8B,EAC9B,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,WAAW;AACX,sBAAsB;AACtB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAG1B,yDAAyD;AACzD,mEAAmE;AACnE,6CAA6C;AAC7C,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAExF,mEAAmE;AACnE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGtF,4EAA4E;AAC5E,0EAA0E;AAC1E,wEAAwE;AACxE,yEAAyE;AACzE,uBAAuB;AACvB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,cAAc,CAAC"}

package/dist/memory.d.ts

@@ -0,0 +1,30 @@
+import { type MetaRoot } from "@metaobjectsdev/metadata";
+/**
+ * Default directory name (relative to project root) where metadata JSON files
+ * are scanned. Scaffold via `meta init`; the directory is committed to git.
+ */
+export declare const DEFAULT_METADATA_DIR = "metaobjects";
+/**
+ * Default directory name (relative to project root) for MetaObjects' own
+ * runtime state: config.json, .gen-state/, package.meta.json, agent docs.
+ * Scaffold via `meta init`; most contents are committed to git.
+ */
+export declare const DEFAULT_METAOBJECTS_DIR = ".metaobjects";
+/**
+ * Load all metadata files from `<repoRoot>/metaobjects/` into a single
+ * MetaData. If `<repoRoot>/.meta/package.meta.json` declares `extends:` deps
+ * and a workspace can be discovered (pnpm-workspace.yaml or package.json
+ * workspaces), peer packages are loaded too in topological dep-first order.
+ *
+ * Excludes `_pending/`. Registers metaobjects core types plus Meta Forge's
+ * descriptive top-level types (decision, principle, etc.) so mixed content
+ * parses without warnings.
+ *
+ * Throws if `metaobjects/` doesn't exist (callers should run `meta init`).
+ *
+ * @param repoRoot The project's working-directory root (e.g. process.cwd()).
+ *   `loadMemory` resolves `metaobjects/` and (if workspace-aware) the
+ *   transitive `extends:` graph automatically.
+ */
+export declare function loadMemory(repoRoot: string): Promise<MetaRoot>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,QAAQ,EACd,MAAM,0BAA0B,CAAC;AAIlC;;;GAGG;AACH,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,iBAAiB,CAAC;AAEtD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAmBpE"}

package/dist/memory.js

@@ -0,0 +1,105 @@
+import { join } from "node:path";
+import { readdir, stat } from "node:fs/promises";
+import { FileMetaDataLoader } from "@metaobjectsdev/metadata/core";
+import { TypeRegistry, registerCoreTypes, } from "@metaobjectsdev/metadata";
+import { registerForgeTypes } from "./forge-types.js";
+import { discoverWorkspace, resolveExtendsOrder } from "./workspace.js";
+/**
+ * Default directory name (relative to project root) where metadata JSON files
+ * are scanned. Scaffold via `meta init`; the directory is committed to git.
+ */
+export const DEFAULT_METADATA_DIR = "metaobjects";
+/**
+ * Default directory name (relative to project root) for MetaObjects' own
+ * runtime state: config.json, .gen-state/, package.meta.json, agent docs.
+ * Scaffold via `meta init`; most contents are committed to git.
+ */
+export const DEFAULT_METAOBJECTS_DIR = ".metaobjects";
+/**
+ * Load all metadata files from `<repoRoot>/metaobjects/` into a single
+ * MetaData. If `<repoRoot>/.meta/package.meta.json` declares `extends:` deps
+ * and a workspace can be discovered (pnpm-workspace.yaml or package.json
+ * workspaces), peer packages are loaded too in topological dep-first order.
+ *
+ * Excludes `_pending/`. Registers metaobjects core types plus Meta Forge's
+ * descriptive top-level types (decision, principle, etc.) so mixed content
+ * parses without warnings.
+ *
+ * Throws if `metaobjects/` doesn't exist (callers should run `meta init`).
+ *
+ * @param repoRoot The project's working-directory root (e.g. process.cwd()).
+ *   `loadMemory` resolves `metaobjects/` and (if workspace-aware) the
+ *   transitive `extends:` graph automatically.
+ */
+export async function loadMemory(repoRoot) {
+    const registry = new TypeRegistry();
+    registerCoreTypes(registry);
+    registerForgeTypes(registry);
+    // Collect all metadata file paths to load. Order matters for the parser's
+    // deferred-resolution pass (it parses in array order, then resolves supers
+    // against the merged tree afterwards) — dep packages first, current last.
+    const paths = await collectMetadataPaths(repoRoot);
+    const loader = new FileMetaDataLoader({ registry });
+    const result = await loader.loadFiles(paths);
+    if (result.errors.length > 0) {
+        const first = result.errors[0];
+        throw first;
+    }
+    return result.root;
+}
+// Dep packages' metaobjects/ files first (topological order), then current.
+async function collectMetadataPaths(repoRoot) {
+    const currentMetaDir = join(repoRoot, ".meta");
+    const ws = await discoverWorkspace(repoRoot);
+    // Workspace path: walk extends, load dep metaobjects/ dirs first
+    if (ws !== undefined) {
+        const currentPkg = ws.packages.find((p) => p.metaDir === currentMetaDir);
+        if (currentPkg !== undefined && currentPkg.manifest.extends.length > 0) {
+            const ordered = resolveExtendsOrder(ws, currentMetaDir);
+            const paths = [];
+            for (const pkg of ordered) {
+                // Each workspace package's metadata lives alongside its .meta/ dir
+                const pkgRoot = join(pkg.metaDir, "..");
+                paths.push(...(await listJsonFiles(join(pkgRoot, DEFAULT_METADATA_DIR))));
+            }
+            return paths;
+        }
+    }
+    // Single-package path: scan metaobjects/ at the project root
+    return listJsonFiles(join(repoRoot, DEFAULT_METADATA_DIR));
+}
+/**
+ * Recursively list *.json files under a directory, excluding _pending/ at
+ * any level. Subdirectories (e.g. projections/) are walked depth-first.
+ * Files within a directory are sorted alphabetically for deterministic load
+ * order; subdirectories are visited after files at the same level.
+ */
+async function listJsonFiles(dir) {
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch (err) {
+        throw new Error(`loadMemory: cannot read ${dir}: ${err.message}`);
+    }
+    const paths = [];
+    const subdirs = [];
+    for (const entry of entries) {
+        if (entry === "_pending")
+            continue;
+        const full = join(dir, entry);
+        const s = await stat(full);
+        if (s.isDirectory()) {
+            subdirs.push(full);
+        }
+        else if (s.isFile() && entry.endsWith(".json")) {
+            paths.push(full);
+        }
+    }
+    // Recurse into subdirectories after collecting files at this level
+    for (const sub of subdirs.sort()) {
+        paths.push(...(await listJsonFiles(sub)));
+    }
+    return paths;
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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