@specverse/engines 5.0.2 → 5.1.0

package/dist/ai/commands/fill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../../src/ai/commands/fill.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAiFvG,wBAAsB,YAAY,CAChC,SAAS,EAAE,WAAW,EACtB,YAAY,EAAE,gBAAgB,EAC9B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,YAAY,CAAC,CAyGvB;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../../src/ai/commands/fill.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AA4FvG,wBAAsB,YAAY,CAChC,SAAS,EAAE,WAAW,EACtB,YAAY,EAAE,gBAAgB,EAC9B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,YAAY,CAAC,CA0GvB;AAED,eAAe,YAAY,CAAC"}

package/dist/ai/commands/fill.js

@@ -6,7 +6,15 @@ import { getTemplate } from './template.js';
 import { existsSync, readdirSync, readFileSync } from 'fs';
 import { join, resolve, dirname } from 'path';
 import { execSync } from 'child_process';
-import { fileURLToPath } from 'url';
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+/** Resolve @specverse/entities/schema/<name>. Same resolver pattern as
+ *  template.ts + the MCP generator.
+ */
+function resolveEntitiesSchemaFile(name) {
+    const pkg = require.resolve('@specverse/entities/package.json');
+    return join(dirname(pkg), 'schema', name);
+}
 function getDirectoryStructure(dirPath, maxDepth = 3) {
     try {
         // Use ls to get directory structure
@@ -80,12 +88,13 @@ function getKeyFilesContent(dirPath) {
 export async function fillTemplate(operation, requirements, options = {}) {
     try {
         const template = await getTemplate(operation, options);
-        // Construct schema paths based on package installation (like ai docs does)
-        const __filename = fileURLToPath(import.meta.url);
-        const __dirname = dirname(__filename);
-        const schemaDir = resolve(__dirname, '../../../schema');
-        const aiSchemaPath = join(schemaDir, 'SPECVERSE-V3.1-SCHEMA-AI.yaml');
-        const referenceSchemaPath = join(schemaDir, 'MINIMAL-SYNTAX-REFERENCE.specly');
+        // Schema paths — both files live in @specverse/entities/schema/,
+        // populated by entities' build (compose-schema + json-to-yaml-schema +
+        // generate-minimal-syntax-reference). Unified with template.ts and
+        // the MCP generator on the same filenames (the old V3.1-prefixed name
+        // that used to live in specverse-lang is retired).
+        const aiSchemaPath = resolveEntitiesSchemaFile('SPECVERSE-SCHEMA-AI.yaml');
+        const referenceSchemaPath = resolveEntitiesSchemaFile('MINIMAL-SYNTAX-REFERENCE.specly');
         // Prepare variables for substitution
         let variables = {
             requirements: requirements.requirements,

package/dist/ai/commands/fill.js.map

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

package/dist/ai/commands/template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../src/ai/commands/template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGvF,wBAAsB,WAAW,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyHjH;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../src/ai/commands/template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAevF,wBAAsB,WAAW,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwHjH;AAED,eAAe,WAAW,CAAC"}

package/dist/ai/commands/template.js

@@ -3,10 +3,20 @@
  * Get raw prompt template for specified operation
  */
 import { readFile } from 'node:fs/promises';
-import { join, dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { join, dirname } from 'node:path';
+import { createRequire } from 'node:module';
 import * as yaml from 'js-yaml';
 import { resolvePromptPath, validatePromptPath } from '../prompt-loader.js';
+const require = createRequire(import.meta.url);
+/** Resolve a file under @specverse/entities/schema/. The schema dir is
+ *  populated by entities' build (compose-schema + json-to-yaml-schema +
+ *  generate-minimal-syntax-reference). Same resolution path the MCP
+ *  generator uses for specverse://schema.
+ */
+function resolveEntitiesSchemaFile(name) {
+    const pkg = require.resolve('@specverse/entities/package.json');
+    return join(dirname(pkg), 'schema', name);
+}
 export async function getTemplate(operation, options = {}) {
     try {
         // Resolve prompt path based on version
@@ -21,12 +31,11 @@ export async function getTemplate(operation, options = {}) {
         const templatePath = join(promptDir, `${operation}.prompt.yaml`);
         const templateContent = await readFile(templatePath, 'utf8');
         const templateData = yaml.load(templateContent);
-        // Construct schema paths (always available, even for raw templates)
-        const __filename = fileURLToPath(import.meta.url);
-        const __dirname = dirname(__filename);
-        const schemaDir = resolve(__dirname, '../../../schema');
-        const aiSchemaPath = join(schemaDir, 'SPECVERSE-SCHEMA-AI.yaml');
-        const referenceExamplePath = join(schemaDir, 'MINIMAL-SYNTAX-REFERENCE.specly');
+        // Schema paths for prompt template variables. Both files live in
+        // @specverse/entities/schema/ — the AI-guidance YAML next to the
+        // JSON Schema, the minimal-syntax example next to both.
+        const aiSchemaPath = resolveEntitiesSchemaFile('SPECVERSE-SCHEMA-AI.yaml');
+        const referenceExamplePath = resolveEntitiesSchemaFile('MINIMAL-SYNTAX-REFERENCE.specly');
         // Build comprehensive system prompt from all system sections
         let systemPrompt = '';
         if (templateData.system?.role) {

package/dist/ai/commands/template.js.map

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

package/dist/bundles/deriveCatalog.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Derive a bundle's catalog by scanning its content facet directories.
+ *
+ * Entry point for the pluggable-bundle catalog subsystem. Called from each
+ * bundle's top-level `index.ts` (e.g. `entities/src/core/models/index.ts`)
+ * to produce a `CatalogEntry[]` that replaces hand-maintained `docs/index.ts`
+ * + `tests/index.ts` arrays.
+ *
+ * Results are cached per bundle directory — safe to call from module-load
+ * paths; subsequent calls for the same bundle return the cached array.
+ *
+ * See: specverse-self/docs/proposals/PLUGGABLE-BUNDLE-MODEL.md
+ */
+import { CatalogEntry, DeriveCatalogOptions } from './types.js';
+export declare function deriveCatalog(bundleDir: string, options?: DeriveCatalogOptions): CatalogEntry[];
+/** Clear the cache — primarily for tests that mutate fixture content between runs. */
+export declare function clearCatalogCache(): void;
+//# sourceMappingURL=deriveCatalog.d.ts.map

package/dist/bundles/deriveCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deriveCatalog.d.ts","sourceRoot":"","sources":["../../src/bundles/deriveCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EACL,YAAY,EACZ,oBAAoB,EAIrB,MAAM,YAAY,CAAC;AAIpB,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,oBAAyB,GACjC,YAAY,EAAE,CAyChB;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/bundles/deriveCatalog.js

@@ -0,0 +1,263 @@
+/**
+ * Derive a bundle's catalog by scanning its content facet directories.
+ *
+ * Entry point for the pluggable-bundle catalog subsystem. Called from each
+ * bundle's top-level `index.ts` (e.g. `entities/src/core/models/index.ts`)
+ * to produce a `CatalogEntry[]` that replaces hand-maintained `docs/index.ts`
+ * + `tests/index.ts` arrays.
+ *
+ * Results are cached per bundle directory — safe to call from module-load
+ * paths; subsequent calls for the same bundle return the cached array.
+ *
+ * See: specverse-self/docs/proposals/PLUGGABLE-BUNDLE-MODEL.md
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
+import { basename, dirname, extname, join, relative, resolve } from 'path';
+import { DEFAULT_FACETS, } from './types.js';
+const cache = new Map();
+export function deriveCatalog(bundleDir, options = {}) {
+    // Normalise to absolute so cache hits work across relative callers.
+    const root = resolve(bundleDir);
+    const cacheKey = JSON.stringify({
+        root,
+        additional: options.additionalReferences,
+        facets: options.facets,
+    });
+    const cached = cache.get(cacheKey);
+    if (cached)
+        return cached;
+    const facets = {
+        ...DEFAULT_FACETS,
+        ...(options.facets ?? {}),
+    };
+    const entries = [];
+    for (const facet of Object.keys(facets)) {
+        const facetDir = join(root, facet);
+        if (!existsSync(facetDir) || !statSync(facetDir).isDirectory())
+            continue;
+        const pattern = facets[facet];
+        const regex = globToRegExp(pattern.glob);
+        for (const abs of walkFiles(facetDir)) {
+            const relFromFacet = relative(facetDir, abs);
+            if (!regex.test(relFromFacet))
+                continue;
+            const entry = buildEntry(abs, root, pattern.category);
+            entries.push(entry);
+        }
+    }
+    // Mixed mode: caller-supplied external references appended after derived.
+    if (options.additionalReferences) {
+        entries.push(...options.additionalReferences);
+    }
+    cache.set(cacheKey, entries);
+    return entries;
+}
+/** Clear the cache — primarily for tests that mutate fixture content between runs. */
+export function clearCatalogCache() {
+    cache.clear();
+}
+// ── Title / description extraction ────────────────────────────────────────
+function buildEntry(filePath, bundleRoot, category) {
+    const relPath = './' + relative(bundleRoot, filePath).replaceAll('\\', '/');
+    const ext = extname(filePath).toLowerCase();
+    let title = '';
+    let description;
+    if (ext === '.specly') {
+        // Look for colocated `<basename>.md` as the doc.
+        const mdPath = join(dirname(filePath), basename(filePath, '.specly') + '.md');
+        if (existsSync(mdPath)) {
+            const md = readMdLeading(mdPath);
+            title = md.title;
+            description = md.description;
+        }
+        if (!title)
+            title = humanize(basename(filePath, '.specly'));
+    }
+    else if (ext === '.qnt') {
+        // Leading `//` comment block.
+        const c = readQuintLeading(filePath);
+        title = c.title || humanize(basename(filePath, '.qnt'));
+        description = c.description;
+    }
+    else if (ext === '.ts' || ext === '.tsx' || ext === '.js' || ext === '.mjs') {
+        // Test file — extract leading JSDoc-style comment.
+        const c = readJSDocLeading(filePath);
+        title = c.title || humanize(basename(filePath).replace(/\.(test|spec)\.\w+$/, ''));
+        description = c.description;
+    }
+    else {
+        title = humanize(basename(filePath, ext));
+    }
+    const entry = { title, category, path: relPath };
+    if (description)
+        entry.description = description;
+    return entry;
+}
+function readMdLeading(mdPath) {
+    let content;
+    try {
+        content = readFileSync(mdPath, 'utf8');
+    }
+    catch {
+        return { title: '' };
+    }
+    const lines = content.split('\n');
+    let title = '';
+    let description;
+    let seenH1 = false;
+    for (const line of lines) {
+        if (!seenH1) {
+            const h1 = line.match(/^#\s+(.+)$/);
+            if (h1) {
+                title = h1[1].trim();
+                seenH1 = true;
+                continue;
+            }
+            continue;
+        }
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        if (trimmed.startsWith('#'))
+            break; // next heading — description ends
+        if (trimmed.startsWith('```'))
+            break; // code fence — not prose
+        if (trimmed.startsWith('>'))
+            continue; // blockquote — skip
+        description = trimmed.replace(/^\*\*|\*\*$/g, '').replace(/\[([^\]]+)\]\([^)]+\)/g, '$1');
+        break;
+    }
+    return { title, description };
+}
+function readQuintLeading(qntPath) {
+    let content;
+    try {
+        content = readFileSync(qntPath, 'utf8');
+    }
+    catch {
+        return { title: '' };
+    }
+    const commentLines = [];
+    for (const line of content.split('\n')) {
+        const t = line.trim();
+        if (t.startsWith('//')) {
+            commentLines.push(t.replace(/^\/\/\s?/, ''));
+            continue;
+        }
+        if (t === '') {
+            if (commentLines.length)
+                continue;
+            continue;
+        }
+        break; // first non-comment, non-blank line ends the prolog
+    }
+    const [titleLine, ...rest] = commentLines.filter(Boolean);
+    return {
+        title: (titleLine ?? '').trim(),
+        description: rest.length ? rest.join(' ').trim() : undefined,
+    };
+}
+function readJSDocLeading(filePath) {
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf8');
+    }
+    catch {
+        return { title: '' };
+    }
+    const match = content.match(/^\s*\/\*\*([\s\S]*?)\*\//);
+    if (!match)
+        return { title: '' };
+    const lines = match[1]
+        .split('\n')
+        .map((l) => l.replace(/^\s*\*\s?/, '').trim())
+        .filter((l) => !l.startsWith('@'));
+    const nonEmpty = lines.filter(Boolean);
+    const [titleLine, ...rest] = nonEmpty;
+    return {
+        title: (titleLine ?? '').trim(),
+        description: rest.length ? rest.join(' ').trim() : undefined,
+    };
+}
+function humanize(slug) {
+    return slug
+        .replace(/[-_]+/g, ' ')
+        .replace(/\b\w/g, (c) => c.toUpperCase());
+}
+// ── Filesystem walking + glob matching ────────────────────────────────────
+function* walkFiles(dir) {
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const full = join(dir, entry);
+        let s;
+        try {
+            s = statSync(full);
+        }
+        catch {
+            continue;
+        }
+        if (s.isDirectory())
+            yield* walkFiles(full);
+        else if (s.isFile())
+            yield full;
+    }
+}
+/**
+ * Minimal glob → RegExp for the patterns we support:
+ *   `**` → any path segments (including none)
+ *   `*`  → non-separator run
+ *   `{a,b}` → alternation
+ * Paths use forward slashes for matching regardless of OS.
+ */
+function globToRegExp(glob) {
+    let re = '';
+    let i = 0;
+    while (i < glob.length) {
+        const ch = glob[i];
+        if (ch === '*' && glob[i + 1] === '*') {
+            // `**` or `**/`
+            if (glob[i + 2] === '/') {
+                re += '(?:.*/)?';
+                i += 3;
+            }
+            else {
+                re += '.*';
+                i += 2;
+            }
+        }
+        else if (ch === '*') {
+            re += '[^/]*';
+            i += 1;
+        }
+        else if (ch === '{') {
+            const end = glob.indexOf('}', i);
+            if (end === -1) {
+                re += '\\{';
+                i += 1;
+                continue;
+            }
+            const alts = glob.slice(i + 1, end).split(',').map(escapeRegex);
+            re += '(?:' + alts.join('|') + ')';
+            i = end + 1;
+        }
+        else if ('/.?+^$()[]\\'.includes(ch)) {
+            re += '\\' + ch;
+            i += 1;
+        }
+        else {
+            re += ch;
+            i += 1;
+        }
+    }
+    return new RegExp('^' + re + '$');
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=deriveCatalog.js.map

package/dist/bundles/deriveCatalog.js.map

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

package/dist/bundles/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @specverse/engines/bundles
+ *
+ * Pluggable-bundle catalog subsystem. Scans a bundle's content facet
+ * directories and returns a unified `CatalogEntry[]` summary. Designed to
+ * replace hand-maintained catalog files per bundle — content is primary,
+ * catalog is derived.
+ *
+ * See: specverse-self/docs/proposals/PLUGGABLE-BUNDLE-MODEL.md
+ */
+export { deriveCatalog, clearCatalogCache } from './deriveCatalog.js';
+export { DEFAULT_FACETS, type CatalogEntry, type CatalogCategory, type DeriveCatalogOptions, type FacetName as CatalogFacetName, type FacetPattern, } from './types.js';
+export { validateBundle, validateBundles } from './validate.js';
+export type { FacetName as ValidateFacetName, FacetIssue, FacetResult, BundleReport, WorkspaceReport, ValidateOptions, } from './validate.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bundles/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EACL,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,SAAS,IAAI,gBAAgB,EAClC,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChE,YAAY,EACV,SAAS,IAAI,iBAAiB,EAC9B,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAC"}

package/dist/bundles/index.js

@@ -0,0 +1,15 @@
+/**
+ * @specverse/engines/bundles
+ *
+ * Pluggable-bundle catalog subsystem. Scans a bundle's content facet
+ * directories and returns a unified `CatalogEntry[]` summary. Designed to
+ * replace hand-maintained catalog files per bundle — content is primary,
+ * catalog is derived.
+ *
+ * See: specverse-self/docs/proposals/PLUGGABLE-BUNDLE-MODEL.md
+ */
+export { deriveCatalog, clearCatalogCache } from './deriveCatalog.js';
+export { DEFAULT_FACETS, } from './types.js';
+// ── Bundle validation ────────────────────────────────────────────────
+export { validateBundle, validateBundles } from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/bundles/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bundles/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EACL,cAAc,GAMf,MAAM,YAAY,CAAC;AAEpB,wEAAwE;AACxE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/bundles/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Types for the pluggable-bundle catalog subsystem.
+ *
+ * A "bundle" is a self-contained package of schema + implementation + content
+ * (examples, tests, behaviour specs). This module's job is producing a
+ * `CatalogEntry[]` summary of a bundle's content by scanning its content
+ * facet directories (`__examples__/`, `__tests__/`, `__behaviour__/`).
+ *
+ * See: specverse-self/docs/proposals/PLUGGABLE-BUNDLE-MODEL.md
+ */
+/**
+ * CatalogEntry and CatalogCategory are defined canonically in
+ * `@specverse/types/entity-module` (which also aliases them as
+ * `EntityDocReference` and `EntityTestReference` for consumer naming
+ * intent). Re-exported here so consumers who import from
+ * `@specverse/engines/bundles` have everything they need from one path.
+ */
+import type { CatalogCategory, CatalogEntry } from '@specverse/types';
+export type { CatalogCategory, CatalogEntry } from '@specverse/types';
+/** A content facet that the catalog scanner knows how to walk. */
+export type FacetName = '__examples__' | '__tests__' | '__behaviour__';
+/**
+ * How a facet is scanned. `glob` is a `fast-glob`-compatible pattern relative
+ * to the facet directory; `category` is assigned to every entry the scanner
+ * emits for this facet.
+ */
+export interface FacetPattern {
+    glob: string;
+    category: CatalogCategory;
+}
+/** Configuration for `deriveCatalog`. All fields are optional. */
+export interface DeriveCatalogOptions {
+    /**
+     * Mixed-mode entries: hand-written references the scanner can't discover
+     * (e.g. external guides outside the bundle). Appended to the derived set
+     * with no de-duplication.
+     */
+    additionalReferences?: CatalogEntry[];
+    /**
+     * Override scanning behaviour per facet. Default is the production table
+     * exported as `DEFAULT_FACETS`. Use this only when a bundle deviates from
+     * the standard layout.
+     */
+    facets?: Partial<Record<FacetName, FacetPattern>>;
+}
+/**
+ * Default facet patterns used when `DeriveCatalogOptions.facets` isn't
+ * provided. Tight patterns (extension-specific) so non-content files (e.g. a
+ * stray `grammar.yaml` physically nested inside `__behaviour__/`) cannot leak
+ * into the catalog regardless of directory depth.
+ */
+export declare const DEFAULT_FACETS: Record<FacetName, FacetPattern>;
+//# sourceMappingURL=types.d.ts.map

package/dist/bundles/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bundles/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEtE,kEAAkE;AAClE,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,WAAW,GAAG,eAAe,CAAC;AAEvE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED,kEAAkE;AAClE,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,YAAY,EAAE,CAAC;IAEtC;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,YAAY,CAI1D,CAAC"}

package/dist/bundles/types.js

@@ -0,0 +1,22 @@
+/**
+ * Types for the pluggable-bundle catalog subsystem.
+ *
+ * A "bundle" is a self-contained package of schema + implementation + content
+ * (examples, tests, behaviour specs). This module's job is producing a
+ * `CatalogEntry[]` summary of a bundle's content by scanning its content
+ * facet directories (`__examples__/`, `__tests__/`, `__behaviour__/`).
+ *
+ * See: specverse-self/docs/proposals/PLUGGABLE-BUNDLE-MODEL.md
+ */
+/**
+ * Default facet patterns used when `DeriveCatalogOptions.facets` isn't
+ * provided. Tight patterns (extension-specific) so non-content files (e.g. a
+ * stray `grammar.yaml` physically nested inside `__behaviour__/`) cannot leak
+ * into the catalog regardless of directory depth.
+ */
+export const DEFAULT_FACETS = {
+    __examples__: { glob: '**/*.specly', category: 'example' },
+    __tests__: { glob: '**/*.test.{ts,tsx,js,mjs}', category: 'test' },
+    __behaviour__: { glob: '**/*.qnt', category: 'behaviour' },
+};
+//# sourceMappingURL=types.js.map

package/dist/bundles/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bundles/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA0CH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAoC;IAC7D,YAAY,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE;IAC1D,SAAS,EAAE,EAAE,IAAI,EAAE,2BAA2B,EAAE,QAAQ,EAAE,MAAM,EAAE;IAClE,aAAa,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE;CAC3D,CAAC"}

package/dist/bundles/validate.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Validate a bundle's facets and return a structured report.
+ *
+ * v1 covers four facets: catalog (derived-vs-scan consistency), schema
+ * (JSON Schema validity), examples (parse via @specverse/engines/parser),
+ * tests (inventory only — execution remains vitest's job). Behaviour,
+ * inference, conventions, generators arrive in later iterations.
+ *
+ * Programmatic API for now. A `spv validate-bundle` CLI wrapper is a
+ * separate concern once the underlying validation shape settles.
+ *
+ * See: specverse-self/docs/proposals/PLUGGABLE-BUNDLE-MODEL.md
+ */
+export type FacetName = 'catalog' | 'schema' | 'examples' | 'tests' | 'docs' | 'behaviour';
+export interface FacetIssue {
+    severity: 'error' | 'warning';
+    message: string;
+    location?: string;
+}
+export interface FacetResult {
+    facet: FacetName;
+    status: 'pass' | 'fail' | 'skip';
+    duration: number;
+    issues: FacetIssue[];
+    metrics?: Record<string, number | string>;
+}
+export interface BundleReport {
+    bundle: string;
+    path: string;
+    facets: FacetResult[];
+    totals: {
+        pass: number;
+        fail: number;
+        skip: number;
+    };
+    duration: number;
+}
+export interface WorkspaceReport {
+    bundles: BundleReport[];
+    totals: {
+        pass: number;
+        fail: number;
+        skip: number;
+    };
+    duration: number;
+}
+export interface ValidateOptions {
+    /** Override schema path. Defaults to @specverse/entities composed schema. */
+    schemaPath?: string;
+}
+/** Validate one bundle. */
+export declare function validateBundle(bundleDir: string, options?: ValidateOptions): Promise<BundleReport>;
+/** Validate several bundles. Reports aggregate. */
+export declare function validateBundles(bundleDirs: string[], options?: ValidateOptions): Promise<WorkspaceReport>;
+//# sourceMappingURL=validate.d.ts.map