speckeeper 0.10.1 → 0.11.1

package/dist/{config-api-CLVjdgIP.d.ts → config-api-coyCX1SB.d.ts}

@@ -848,6 +848,26 @@ declare function getSpecsFromConfig(specs: SpecEntry[] | undefined, modelId: str
  * Pure function — no global state.
  */
 declare function findModelTypeFromConfig(specs: SpecEntry[] | undefined, specId: string): string | null;
+/**
+ * Load spec data from a YAML or JSON file.
+ * Supports two formats:
+ *  - Single-model shorthand: `{ model: "term", specs: [...] }`
+ *  - Multi-model entries: `{ entries: [{ model: "...", specs: [...] }, ...] }`
+ *
+ * Each spec is validated against the model's Zod schema.
+ *
+ * @param yamlPath - Path to the .yaml / .yml / .json file
+ * @param models - Array of Model instances to resolve `model` field against
+ */
+declare function loadYamlSpecs(yamlPath: string, models: Model<any>[]): SpecModule;
+/**
+ * Load all YAML / JSON spec files from a directory.
+ * Scans for `*.yaml`, `*.yml`, `*.json` files, excluding `_models/` subdirectory.
+ *
+ * @param dirPath - Directory to scan (typically `design/`)
+ * @param models - Array of Model instances
+ */
+declare function loadYamlDir(dirPath: string, models: Model<any>[]): SpecModule[];
 
 /** Artifact scan configuration */
 interface ArtifactConfig {
@@ -1080,4 +1100,4 @@ declare function createLintRule<T>(config: {
  */
 declare function loadSpeckeeperConfig(configPath?: string): Promise<ResolvedSpeckeeperConfig | null>;
 
-export { type SpeckeeperConfigInput as $, type ArtifactConfig as A, type BaseModelInstance as B, type CheckContext as C, type DDLValidationMapping as D, type ExportContext as E, type ModelDefinitionInput as F, type ModelLevel as G, RELATION_TYPES as H, type InferModelType as I, type JsonSchemaExporter as J, type ReferenceDefinition as K, type LintContext as L, type ModelDefinition as M, ReferenceDefinitionSchema as N, type OpenAPIValidationMapping as O, type Relation as P, RelationSchema as Q, RELATION_CONSTRAINTS as R, type SourceConfig as S, type RelationValidationError as T, RelationsFieldSchema as U, type RenderContext as V, type Renderer as W, type ResolvedSpeckeeperConfig as X, type SourceMatch as Y, type SourceScanner as Z, type SpecModule as _, type CheckResult$1 as a, buildRegistryFromConfig as a0, createLintRule as a1, createMarkdownExporter as a2, createMermaidExporter as a3, defineConfig as a4, defineModel as a5, defineSpecs as a6, detectCycles as a7, findModelTypeFromConfig as a8, getLevelIndex as a9, getSpecsFromConfig as aa, inferModelIdFromSpecId as ab, loadSpeckeeperConfig as ac, mergeSpecs as ad, validateRelationLevel as ae, type MetaModelRegistry as b, type LintRule$1 as c, type LintIssue as d, type SpecEntry as e, type CheckError as f, CheckErrorSchema as g, type CheckResult as h, CheckResultSchema as i, type CheckWarning as j, CheckWarningSchema as k, type CoverageChecker as l, type CoverageResult as m, type DeepValidationConfig as n, type DeepValidationRule as o, type Exporter as p, type ExternalChecker as q, LintIssueSchema as r, type LintResult as s, type LintRule as t, type LookupKeyConfig as u, type MarkdownExporter as v, type MergedDesign as w, type MermaidExporter as x, type MetaModelConfig as y, Model as z };
+export { type SpeckeeperConfigInput as $, type ArtifactConfig as A, type BaseModelInstance as B, type CheckContext as C, type DDLValidationMapping as D, type ExportContext as E, type ModelDefinitionInput as F, type ModelLevel as G, RELATION_TYPES as H, type InferModelType as I, type JsonSchemaExporter as J, type ReferenceDefinition as K, type LintContext as L, type ModelDefinition as M, ReferenceDefinitionSchema as N, type OpenAPIValidationMapping as O, type Relation as P, RelationSchema as Q, RELATION_CONSTRAINTS as R, type SourceConfig as S, type RelationValidationError as T, RelationsFieldSchema as U, type RenderContext as V, type Renderer as W, type ResolvedSpeckeeperConfig as X, type SourceMatch as Y, type SourceScanner as Z, type SpecModule as _, type CheckResult$1 as a, buildRegistryFromConfig as a0, createLintRule as a1, createMarkdownExporter as a2, createMermaidExporter as a3, defineConfig as a4, defineModel as a5, defineSpecs as a6, detectCycles as a7, findModelTypeFromConfig as a8, getLevelIndex as a9, getSpecsFromConfig as aa, inferModelIdFromSpecId as ab, loadSpeckeeperConfig as ac, loadYamlDir as ad, loadYamlSpecs as ae, mergeSpecs as af, validateRelationLevel as ag, type MetaModelRegistry as b, type LintRule$1 as c, type LintIssue as d, type SpecEntry as e, type CheckError as f, CheckErrorSchema as g, type CheckResult as h, CheckResultSchema as i, type CheckWarning as j, CheckWarningSchema as k, type CoverageChecker as l, type CoverageResult as m, type DeepValidationConfig as n, type DeepValidationRule as o, type Exporter as p, type ExternalChecker as q, LintIssueSchema as r, type LintResult as s, type LintRule as t, type LookupKeyConfig as u, type MarkdownExporter as v, type MergedDesign as w, type MermaidExporter as x, type MetaModelConfig as y, Model as z };

package/dist/dsl/index.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { t as LintRule, p as Exporter, l as CoverageChecker, A as ArtifactConfig, Y as SourceMatch, Z as SourceScanner, n as DeepValidationConfig, h as CheckResult, S as SourceConfig } from '../config-api-CLVjdgIP.js';
+import { t as LintRule, p as Exporter, l as CoverageChecker, A as ArtifactConfig, Y as SourceMatch, Z as SourceScanner, n as DeepValidationConfig, h as CheckResult, S as SourceConfig } from '../config-api-coyCX1SB.js';
 
 /**
  * Core DSL — Base spec schema

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { C as CheckContext, a as CheckResult, E as ExportContext, M as ModelDefinition, b as MetaModelRegistry, L as LintContext, c as LintRule, d as LintIssue, S as SourceConfig, e as SpecEntry } from './config-api-CLVjdgIP.js';
-export { A as ArtifactConfig, B as BaseModelInstance, f as CheckError, g as CheckErrorSchema, h as CheckResult, i as CheckResultSchema, j as CheckWarning, k as CheckWarningSchema, l as CoverageChecker, m as CoverageResult, D as DDLValidationMapping, n as DeepValidationConfig, o as DeepValidationRule, p as Exporter, q as ExternalChecker, I as InferModelType, J as JsonSchemaExporter, r as LintIssueSchema, s as LintResult, t as LintRule, u as LookupKeyConfig, v as MarkdownExporter, w as MergedDesign, x as MermaidExporter, y as MetaModelConfig, z as Model, F as ModelDefinitionInput, G as ModelLevel, O as OpenAPIValidationMapping, R as RELATION_CONSTRAINTS, H as RELATION_TYPES, K as ReferenceDefinition, N as ReferenceDefinitionSchema, P as Relation, Q as RelationSchema, T as RelationValidationError, U as RelationsFieldSchema, V as RenderContext, W as Renderer, X as ResolvedSpeckeeperConfig, Y as SourceMatch, Z as SourceScanner, _ as SpecModule, $ as SpeckeeperConfigInput, a0 as buildRegistryFromConfig, a1 as createLintRule, a2 as createMarkdownExporter, a3 as createMermaidExporter, a4 as defineConfig, a5 as defineModel, a6 as defineSpecs, a7 as detectCycles, a8 as findModelTypeFromConfig, a9 as getLevelIndex, aa as getSpecsFromConfig, ab as inferModelIdFromSpecId, ac as loadSpeckeeperConfig, ad as mergeSpecs, ae as validateRelationLevel } from './config-api-CLVjdgIP.js';
+import { C as CheckContext, a as CheckResult, E as ExportContext, M as ModelDefinition, b as MetaModelRegistry, L as LintContext, c as LintRule, d as LintIssue, S as SourceConfig, e as SpecEntry } from './config-api-coyCX1SB.js';
+export { A as ArtifactConfig, B as BaseModelInstance, f as CheckError, g as CheckErrorSchema, h as CheckResult, i as CheckResultSchema, j as CheckWarning, k as CheckWarningSchema, l as CoverageChecker, m as CoverageResult, D as DDLValidationMapping, n as DeepValidationConfig, o as DeepValidationRule, p as Exporter, q as ExternalChecker, I as InferModelType, J as JsonSchemaExporter, r as LintIssueSchema, s as LintResult, t as LintRule, u as LookupKeyConfig, v as MarkdownExporter, w as MergedDesign, x as MermaidExporter, y as MetaModelConfig, z as Model, F as ModelDefinitionInput, G as ModelLevel, O as OpenAPIValidationMapping, R as RELATION_CONSTRAINTS, H as RELATION_TYPES, K as ReferenceDefinition, N as ReferenceDefinitionSchema, P as Relation, Q as RelationSchema, T as RelationValidationError, U as RelationsFieldSchema, V as RenderContext, W as Renderer, X as ResolvedSpeckeeperConfig, Y as SourceMatch, Z as SourceScanner, _ as SpecModule, $ as SpeckeeperConfigInput, a0 as buildRegistryFromConfig, a1 as createLintRule, a2 as createMarkdownExporter, a3 as createMermaidExporter, a4 as defineConfig, a5 as defineModel, a6 as defineSpecs, a7 as detectCycles, a8 as findModelTypeFromConfig, a9 as getLevelIndex, aa as getSpecsFromConfig, ab as inferModelIdFromSpecId, ac as loadSpeckeeperConfig, ad as loadYamlDir, ae as loadYamlSpecs, af as mergeSpecs, ag as validateRelationLevel } from './config-api-coyCX1SB.js';
 
 declare const PhaseSchema: z.ZodEnum<["REQ", "HLD", "LLD", "IMPL", "OPS", "CI"]>;
 type Phase = z.infer<typeof PhaseSchema>;

package/dist/index.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'fs';
-import { resolve, join, dirname } from 'path';
+import { readFileSync, readdirSync, statSync, existsSync, mkdirSync, writeFileSync } from 'fs';
+import { extname, join, resolve, dirname } from 'path';
 import { parse } from 'yaml';
 import { createHash } from 'crypto';
 import { glob } from 'glob';
@@ -645,6 +645,78 @@ function findModelTypeFromConfig(specs, specId) {
   }
   return null;
 }
+function isMultiModelFormat(data) {
+  return "entries" in data && Array.isArray(data.entries);
+}
+function resolveModel(modelId, models, filePath) {
+  const found = models.find((m) => m.id === modelId);
+  if (!found) {
+    const available = models.map((m) => m.id).join(", ");
+    throw new Error(
+      `Unknown model "${modelId}" in ${filePath}. Available models: ${available}`
+    );
+  }
+  return found;
+}
+function validateSpecs(model, specs, filePath) {
+  const validated = [];
+  for (let i = 0; i < specs.length; i++) {
+    const raw = specs[i];
+    const result = model.safeParse(raw);
+    if (!result.success) {
+      const specId = raw?.id ?? `[index ${i}]`;
+      const issues = result.error.issues.map((iss) => `  - ${iss.path.join(".")}: ${iss.message}`).join("\n");
+      throw new Error(
+        `Validation failed for spec "${specId}" (model: ${model.id}) in ${filePath}:
+${issues}`
+      );
+    }
+    validated.push(result.data);
+  }
+  return validated;
+}
+function loadYamlSpecs(yamlPath, models) {
+  const ext = extname(yamlPath).toLowerCase();
+  const raw = readFileSync(yamlPath, "utf-8");
+  let data;
+  try {
+    data = ext === ".json" ? JSON.parse(raw) : parse(raw);
+  } catch (err) {
+    throw new Error(
+      `Failed to parse ${yamlPath}: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  const groups = isMultiModelFormat(data) ? data.entries : [data];
+  const entries = groups.map((group) => {
+    const model = resolveModel(group.model, models, yamlPath);
+    const validatedData = validateSpecs(model, group.specs, yamlPath);
+    return { model, data: validatedData };
+  });
+  return { entries };
+}
+function loadYamlDir(dirPath, models) {
+  const YAML_EXTENSIONS = /* @__PURE__ */ new Set([".yaml", ".yml", ".json"]);
+  const results = [];
+  let entries;
+  try {
+    entries = readdirSync(dirPath);
+  } catch {
+    return results;
+  }
+  for (const entry of entries) {
+    if (entry === "_models") continue;
+    const fullPath = join(dirPath, entry);
+    const ext = extname(entry).toLowerCase();
+    if (!YAML_EXTENSIONS.has(ext)) continue;
+    try {
+      if (!statSync(fullPath).isFile()) continue;
+    } catch {
+      continue;
+    }
+    results.push(loadYamlSpecs(fullPath, models));
+  }
+  return results;
+}
 
 // src/core/model-registry.ts
 var globalRegistry = {
@@ -1180,6 +1252,6 @@ function generateSpecsPath(baseDir, category, filename) {
   return join(baseDir, category, filename);
 }
 
-export { CheckErrorSchema, CheckResultSchema, CheckWarningSchema, ConcretizationSlotSchema, ID_PATTERNS, LinkSchema, LintIssueSchema, Model, PhaseSchema, PrioritySchema, RELATION_CONSTRAINTS, RELATION_TYPES, ReferenceDefinitionSchema, RelationSchema, RelationsFieldSchema, batchWriteFiles, buildRegistryFromConfig, checkBatchDrift, checkExternalSsot, checkFileDrift, checkReferenceIntegrity, computeHash, createAPIRefId, createActorId, createBatchRefId, createBoundaryId, createComponentId, createDTORequirementId, createEntityId, createErrorCaseId, createEventRequirementId, createFormId, createIaCRefId, createLayerId, createLintRule, createMarkdownExporter, createMermaidExporter, createProcessFlowId, createRelationId, createRequirementId, createRuleId, createScreenId, createStateId, createTableRefId, createTermId, createTransitionId, createUIComponentId, createUseCaseId, defineConfig, defineModel, defineSpecs, detectCycles, ensureDir, exportAllModels, exportMarkdown, exportMermaid, findConfigFile, findDefinitionFiles, findFiles, findModelTypeFromConfig, findTypeScriptFiles, generateDocsPath, generateSpecsPath, getAllInstances, getAllModelDefinitions, getAllModelInstances, getExpectedOutputDirs, getGlobalModelRegistry, getLevelIndex, getModelDefinition, getModelInstance, getModelRegistryStats, getOutputPaths, getSpecsFromConfig, inferModelIdFromSpecId, lintAllModels, lintModel, loadConfig, loadSpeckeeperConfig, mergeSpecs, registerModelDefinition, registerModelDefinitions, registerModelInstance, resetModelInstances, resetModelRegistry, resolveReference, validateConfig, validateOutputPaths, validateRelationLevel, writeFile, writeJsonFile };
+export { CheckErrorSchema, CheckResultSchema, CheckWarningSchema, ConcretizationSlotSchema, ID_PATTERNS, LinkSchema, LintIssueSchema, Model, PhaseSchema, PrioritySchema, RELATION_CONSTRAINTS, RELATION_TYPES, ReferenceDefinitionSchema, RelationSchema, RelationsFieldSchema, batchWriteFiles, buildRegistryFromConfig, checkBatchDrift, checkExternalSsot, checkFileDrift, checkReferenceIntegrity, computeHash, createAPIRefId, createActorId, createBatchRefId, createBoundaryId, createComponentId, createDTORequirementId, createEntityId, createErrorCaseId, createEventRequirementId, createFormId, createIaCRefId, createLayerId, createLintRule, createMarkdownExporter, createMermaidExporter, createProcessFlowId, createRelationId, createRequirementId, createRuleId, createScreenId, createStateId, createTableRefId, createTermId, createTransitionId, createUIComponentId, createUseCaseId, defineConfig, defineModel, defineSpecs, detectCycles, ensureDir, exportAllModels, exportMarkdown, exportMermaid, findConfigFile, findDefinitionFiles, findFiles, findModelTypeFromConfig, findTypeScriptFiles, generateDocsPath, generateSpecsPath, getAllInstances, getAllModelDefinitions, getAllModelInstances, getExpectedOutputDirs, getGlobalModelRegistry, getLevelIndex, getModelDefinition, getModelInstance, getModelRegistryStats, getOutputPaths, getSpecsFromConfig, inferModelIdFromSpecId, lintAllModels, lintModel, loadConfig, loadSpeckeeperConfig, loadYamlDir, loadYamlSpecs, mergeSpecs, registerModelDefinition, registerModelDefinitions, registerModelInstance, resetModelInstances, resetModelRegistry, resolveReference, validateConfig, validateOutputPaths, validateRelationLevel, writeFile, writeJsonFile };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map