@metaobjectsdev/sdk 0.7.0-rc.1 → 0.7.0-rc.3

package/dist/memory.js

@@ -60,21 +60,25 @@ async function collectMetadataPaths(repoRoot) {
             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))));
+                paths.push(...(await listMetadataFiles(join(pkgRoot, DEFAULT_METADATA_DIR))));
             }
             return paths;
         }
     }
     // Single-package path: scan metaobjects/ at the project root
-    return listJsonFiles(join(repoRoot, DEFAULT_METADATA_DIR));
+    return listMetadataFiles(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.
+ * Recursively list metadata files (*.json, *.yaml, *.yml) 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.
+ *
+ * Format selection (parsing) happens downstream in `FileSource` from
+ * `@metaobjectsdev/metadata`, which infers the parser from file extension.
  */
-async function listJsonFiles(dir) {
+async function listMetadataFiles(dir) {
     let entries;
     try {
         entries = await readdir(dir);
@@ -92,14 +96,17 @@ async function listJsonFiles(dir) {
         if (s.isDirectory()) {
             subdirs.push(full);
         }
-        else if (s.isFile() && entry.endsWith(".json")) {
+        else if (s.isFile() && isMetadataFile(entry)) {
             paths.push(full);
         }
     }
     // Recurse into subdirectories after collecting files at this level
     for (const sub of subdirs.sort()) {
-        paths.push(...(await listJsonFiles(sub)));
+        paths.push(...(await listMetadataFiles(sub)));
     }
     return paths;
 }
+function isMetadataFile(name) {
+    return name.endsWith(".json") || name.endsWith(".yaml") || name.endsWith(".yml");
+}
 //# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaobjectsdev/sdk",
-  "version": "0.7.0-rc.1",
+  "version": "0.7.0-rc.3",
   "description": "Workspace helpers and agent-docs utilities for MetaObjects projects.",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,7 +38,7 @@
 "access": "public"
 },
 "dependencies": {
-  "@metaobjectsdev/metadata": "0.7.0-rc.1",
+  "@metaobjectsdev/metadata": "0.7.0-rc.3",
   "zod": "^3.23.0"
 },
 "devDependencies": {

package/src/forge-types.ts

@@ -104,6 +104,7 @@ export type ForgeAttr = (typeof FORGE_ATTRS)[number];
 
 import {
   type ChildRule,
+  type MetaDataTypeProvider,
   type TypeDefinition,
   TypeId,
   TypeRegistry,
@@ -138,30 +139,47 @@ function def(
   };
 }
 
+/**
+ * The Meta Forge provider — registers Meta Forge's five descriptive top-level
+ * types (decision, principle, convention, glossary, failure) plus their
+ * subtypes. Composed AFTER `metaobjects-core-types` so the structural attr
+ * type is available for forge child rules.
+ *
+ * Use via `composeRegistry([...coreProviders, forgeTypesProvider])` or via
+ * `loadMemory()`'s default bundle (forge is included by default).
+ */
+export const forgeTypesProvider: MetaDataTypeProvider = {
+  id: "metaobjects-forge",
+  dependencies: ["metaobjects-core-types"],
+  description: "Meta Forge descriptive top-level types (decision, principle, convention, glossary, failure).",
+  registerTypes(registry: TypeRegistry): void {
+    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));
+    }
+  },
+};
+
 /**
  * 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).
+ * Thin back-compat wrapper over `forgeTypesProvider.registerTypes`; prefer
+ * the provider directly for new code (composes correctly with other providers).
  */
 export function registerForgeTypes(registry: TypeRegistry): void {
-  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));
-  }
+  forgeTypesProvider.registerTypes(registry);
 }

package/src/index.ts

@@ -70,15 +70,22 @@ export {
   FORGE_ATTR_WHAT_WAS_TRIED,
   FORGE_ATTR_WHY_IT_FAILED,
   FORGE_ATTRS,
-  // Registration helper
+  // Registration helper + provider
   registerForgeTypes,
+  forgeTypesProvider,
 } from "./forge-types.js";
 export type { ForgeType, ForgeAttr } 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";
+export {
+  loadMemory,
+  defaultLoadMemoryProviders,
+  DEFAULT_METADATA_DIR,
+  DEFAULT_METAOBJECTS_DIR,
+} from "./memory.js";
+export type { LoadMemoryOptions } from "./memory.js";
 
 // Workspace discovery — finds peer metadata packages in a monorepo
 export { discoverWorkspace, resolveExtendsOrder, packageLabel } from "./workspace.js";

package/src/memory.ts

@@ -1,13 +1,14 @@
 import { join } from "node:path";
 import { readdir, stat } from "node:fs/promises";
 import {
+  composeRegistry,
+  coreProviders,
   MetaDataLoader,
-  TypeRegistry,
-  registerCoreTypes,
+  type MetaDataTypeProvider,
   type MetaRoot,
 } from "@metaobjectsdev/metadata";
 import { FileSource } from "@metaobjectsdev/metadata/core";
-import { registerForgeTypes } from "./forge-types.js";
+import { forgeTypesProvider } from "./forge-types.js";
 import { discoverWorkspace, resolveExtendsOrder } from "./workspace.js";
 
 /**
@@ -23,6 +24,36 @@ export const DEFAULT_METADATA_DIR = "metaobjects";
  */
 export const DEFAULT_METAOBJECTS_DIR = ".metaobjects";
 
+/**
+ * Options for {@link loadMemory}. Consumers can supply additional
+ * {@link MetaDataTypeProvider}s to extend the metamodel with their own
+ * subtypes/attrs (e.g. a `template.toolcall` subtype).
+ */
+export interface LoadMemoryOptions {
+  /**
+   * Consumer-supplied providers. Composed AFTER the default core providers
+   * (core-types + db + documentation + forge) unless `replaceDefaults: true`
+   * is set. Use this to register additional subtypes or extend existing
+   * ones without forking the loader.
+   */
+  providers?: readonly MetaDataTypeProvider[];
+  /**
+   * Skip the default core providers; supply your own full set. Advanced —
+   * use only when you need to compose a custom metamodel from scratch.
+   * Throws if `providers` is absent or empty.
+   */
+  replaceDefaults?: boolean;
+}
+
+/** Default provider bundle threaded by {@link loadMemory} when no options
+ *  override is supplied. Exposed for tests/inspection; callers shouldn't need
+ *  to spread this manually — `loadMemory(root, { providers: [mine] })`
+ *  composes `[...defaultLoadMemoryProviders, mine]` automatically. */
+export const defaultLoadMemoryProviders: readonly MetaDataTypeProvider[] = [
+  ...coreProviders,
+  forgeTypesProvider,
+];
+
 /**
  * Load all metadata files from `<repoRoot>/metaobjects/` into a single
  * MetaData. If `<repoRoot>/.meta/package.meta.json` declares `extends:` deps
@@ -31,18 +62,35 @@ export const DEFAULT_METAOBJECTS_DIR = ".metaobjects";
  *
  * Excludes `_pending/`. Registers metaobjects core types plus Meta Forge's
  * descriptive top-level types (decision, principle, etc.) so mixed content
- * parses without warnings.
+ * parses without warnings. Consumer-supplied providers (via
+ * {@link LoadMemoryOptions.providers}) are composed AFTER the defaults so
+ * they may depend on core/forge ids.
  *
  * 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.
+ * @param options Optional {@link LoadMemoryOptions} — supply additional
+ *   providers or replace the default bundle entirely.
  */
-export async function loadMemory(repoRoot: string): Promise<MetaRoot> {
-  const registry = new TypeRegistry();
-  registerCoreTypes(registry);
-  registerForgeTypes(registry);
+export async function loadMemory(
+  repoRoot: string,
+  options?: LoadMemoryOptions,
+): Promise<MetaRoot> {
+  const extra = options?.providers ?? [];
+  let providers: readonly MetaDataTypeProvider[];
+  if (options?.replaceDefaults === true) {
+    if (extra.length === 0) {
+      throw new Error(
+        "loadMemory: `replaceDefaults: true` requires at least one provider in `providers`.",
+      );
+    }
+    providers = extra;
+  } else {
+    providers = [...defaultLoadMemoryProviders, ...extra];
+  }
+  const registry = composeRegistry(providers);
 
   // Collect all metadata file paths to load. Order matters for the parser's
   // deferred-resolution pass (it parses in array order, then resolves supers
@@ -74,23 +122,27 @@ async function collectMetadataPaths(repoRoot: string): Promise<string[]> {
       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))));
+        paths.push(...(await listMetadataFiles(join(pkgRoot, DEFAULT_METADATA_DIR))));
       }
       return paths;
     }
   }
 
   // Single-package path: scan metaobjects/ at the project root
-  return listJsonFiles(join(repoRoot, DEFAULT_METADATA_DIR));
+  return listMetadataFiles(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.
+ * Recursively list metadata files (*.json, *.yaml, *.yml) 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.
+ *
+ * Format selection (parsing) happens downstream in `FileSource` from
+ * `@metaobjectsdev/metadata`, which infers the parser from file extension.
  */
-async function listJsonFiles(dir: string): Promise<string[]> {
+async function listMetadataFiles(dir: string): Promise<string[]> {
   let entries: string[];
   try {
     entries = await readdir(dir);
@@ -105,13 +157,17 @@ async function listJsonFiles(dir: string): Promise<string[]> {
     const s = await stat(full);
     if (s.isDirectory()) {
       subdirs.push(full);
-    } else if (s.isFile() && entry.endsWith(".json")) {
+    } else if (s.isFile() && isMetadataFile(entry)) {
       paths.push(full);
     }
   }
   // Recurse into subdirectories after collecting files at this level
   for (const sub of subdirs.sort()) {
-    paths.push(...(await listJsonFiles(sub)));
+    paths.push(...(await listMetadataFiles(sub)));
   }
   return paths;
 }
+
+function isMetadataFile(name: string): boolean {
+  return name.endsWith(".json") || name.endsWith(".yaml") || name.endsWith(".yml");
+}