@telorun/analyzer 0.1.3 → 0.1.4

package/dist/adapters/node-adapter.d.ts

@@ -9,6 +9,8 @@ export declare class NodeAdapter implements ManifestAdapter {
         source: string;
     }>;
     resolveRelative(base: string, relative: string): string;
+    expandGlob(base: string, patterns: string[]): Promise<string[]>;
+    resolveOwnerOf(fileUrl: string): Promise<string | null>;
 }
 /** @deprecated Use `new NodeAdapter(cwd)` instead */
 export declare function createNodeAdapter(cwd?: string): ManifestAdapter;

package/dist/adapters/node-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/node-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6B,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9E,gFAAgF;AAChF,qBAAa,WAAY,YAAW,eAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,GAAE,MAAsB;IAExD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAUxB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IASlE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;CAKxD;AAED,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,GAAG,eAAe,CAE9E"}
+{"version":3,"file":"node-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/node-adapter.ts"],"names":[],"mappings":"AAIA,OAAO,EAA6B,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAM9E,gFAAgF;AAChF,qBAAa,WAAY,YAAW,eAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,GAAE,MAAsB;IAExD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAUxB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IASlE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAKjD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAc/D,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAoB9D;AAED,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,GAAG,eAAe,CAE9E"}

package/dist/adapters/node-adapter.js

@@ -1,6 +1,11 @@
 import * as fs from "fs/promises";
 import * as path from "path";
+import { fileURLToPath } from "url";
+import { minimatch } from "minimatch";
 import { DEFAULT_MANIFEST_FILENAME } from "../types.js";
+function toFilePath(url) {
+    return url.startsWith("file://") ? fileURLToPath(url) : url;
+}
 /** Node.js fs-based ManifestAdapter for local files. Not browser-compatible. */
 export class NodeAdapter {
     cwd;
@@ -15,17 +20,50 @@ export class NodeAdapter {
             (!url.includes("://") && !url.includes("@")));
     }
     async read(url) {
-        const filePath = url.startsWith("file://") ? new URL(url).pathname : url;
+        const filePath = toFilePath(url);
         const stat = await fs.stat(filePath).catch(() => null);
         const resolvedPath = stat?.isDirectory() ? path.join(filePath, DEFAULT_MANIFEST_FILENAME) : filePath;
         const text = await fs.readFile(resolvedPath, "utf8");
         return { text, source: resolvedPath };
     }
     resolveRelative(base, relative) {
-        const basePath = base.startsWith("file://") ? new URL(base).pathname : base;
-        const baseDir = path.dirname(path.resolve(this.cwd, basePath));
+        const baseDir = path.dirname(path.resolve(this.cwd, toFilePath(base)));
         return path.resolve(baseDir, relative);
     }
+    async expandGlob(base, patterns) {
+        const baseDir = path.dirname(path.resolve(this.cwd, toFilePath(base)));
+        const entries = await fs.readdir(baseDir, { recursive: true, encoding: "utf8" });
+        const normalizedPatterns = patterns.map((p) => p.replace(/\\/g, "/").replace(/^\.\//, ""));
+        const matched = [];
+        for (const entry of entries) {
+            const normalized = entry.replace(/\\/g, "/");
+            if (normalizedPatterns.some((p) => minimatch(normalized, p))) {
+                matched.push(path.resolve(baseDir, entry));
+            }
+        }
+        return matched.sort();
+    }
+    async resolveOwnerOf(fileUrl) {
+        const resolved = path.resolve(this.cwd, toFilePath(fileUrl));
+        let dir = path.dirname(resolved);
+        while (true) {
+            const candidate = path.join(dir, DEFAULT_MANIFEST_FILENAME);
+            if (candidate !== resolved) {
+                try {
+                    await fs.access(candidate);
+                    return candidate;
+                }
+                catch {
+                    // telo.yaml not found at this level
+                }
+            }
+            const parent = path.dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+        return null;
+    }
 }
 /** @deprecated Use `new NodeAdapter(cwd)` instead */
 export function createNodeAdapter(cwd = process.cwd()) {

package/dist/builtins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../src/builtins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,eAAO,MAAM,eAAe,EAAE,kBAAkB,EA4G/C,CAAC"}
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../src/builtins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,eAAO,MAAM,eAAe,EAAE,kBAAkB,EAgH/C,CAAC"}

package/dist/builtins.js

@@ -94,6 +94,10 @@ export const KERNEL_BUILTINS = [
                         ],
                     },
                 },
+                include: {
+                    type: "array",
+                    items: { type: "string" },
+                },
                 exports: {
                     type: "object",
                     properties: {

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 export { HttpAdapter } from "./adapters/http-adapter.js";
-export { createNodeAdapter, NodeAdapter } from "./adapters/node-adapter.js";
 export { RegistryAdapter } from "./adapters/registry-adapter.js";
 export { AnalysisRegistry } from "./analysis-registry.js";
 export { StaticAnalyzer } from "./analyzer.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC3E,YAAY,EACR,kBAAkB,EAClB,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAChE,QAAQ,EACR,aAAa,EACb,KAAK,EACR,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC3E,YAAY,EACR,kBAAkB,EAClB,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAChE,QAAQ,EACR,aAAa,EACb,KAAK,EACR,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,5 +1,4 @@
 export { HttpAdapter } from "./adapters/http-adapter.js";
-export { createNodeAdapter, NodeAdapter } from "./adapters/node-adapter.js";
 export { RegistryAdapter } from "./adapters/registry-adapter.js";
 export { AnalysisRegistry } from "./analysis-registry.js";
 export { StaticAnalyzer } from "./analyzer.js";

package/dist/manifest-loader.d.ts

@@ -1,5 +1,5 @@
 import { type ResourceManifest } from "@telorun/sdk";
-import type { LoadOptions, LoaderInitOptions, ManifestAdapter } from "./types.js";
+import { type LoadOptions, type LoaderInitOptions, type ManifestAdapter } from "./types.js";
 export declare class Loader {
     private static readonly moduleCache;
     protected adapters: ManifestAdapter[];
@@ -8,6 +8,13 @@ export declare class Loader {
     private pick;
     resolveEntryPoint(url: string): Promise<string>;
     loadModule(url: string, options?: LoadOptions): Promise<ResourceManifest[]>;
+    private resolveIncludes;
+    private loadPartialFile;
+    loadModuleForFile(fileUrl: string): Promise<{
+        ownerUrl: string;
+        manifests: ResourceManifest[];
+        sourceManifests: Map<string, ResourceManifest[]>;
+    } | null>;
     loadModuleGraph(entryUrl: string, onError?: (url: string, error: Error) => void): Promise<Map<string, ResourceManifest[]>>;
     loadManifests(entryUrl: string): Promise<ResourceManifest[]>;
 }

package/dist/manifest-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest-loader.d.ts","sourceRoot":"","sources":["../src/manifest-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAKtE,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,EAGhB,MAAM,YAAY,CAAC;AAEpB,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAG/B;IAEJ,SAAS,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAC;gBAE1B,sBAAsB,GAAE,eAAe,EAAE,GAAG,iBAAsB;IAiB9E,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAKxC,OAAO,CAAC,IAAI;IAMN,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAgF3E,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,GAC5C,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAsCrC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAoDnE"}
+{"version":3,"file":"manifest-loader.d.ts","sourceRoot":"","sources":["../src/manifest-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAKtE,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAGrB,MAAM,YAAY,CAAC;AAIpB,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAG/B;IAEJ,SAAS,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAC;gBAE1B,sBAAsB,GAAE,eAAe,EAAE,GAAG,iBAAsB;IAiB9E,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAKxC,OAAO,CAAC,IAAI;IAMN,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAmGnE,eAAe;YAoBf,eAAe;IAgEvB,iBAAiB,CACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,gBAAgB,EAAE,CAAC;QAC9B,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;KAClD,GAAG,IAAI,CAAC;IAiCH,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,GAC5C,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAsCrC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAoDnE"}

package/dist/manifest-loader.js

@@ -3,6 +3,8 @@ import { isMap, isPair, isScalar, isSeq, parseAllDocuments } from "yaml";
 import { HttpAdapter } from "./adapters/http-adapter.js";
 import { RegistryAdapter } from "./adapters/registry-adapter.js";
 import { precompileDoc } from "./precompile.js";
+import { DEFAULT_MANIFEST_FILENAME, } from "./types.js";
+const SYSTEM_KINDS = new Set(["Kernel.Module", "Kernel.Import", "Kernel.Definition"]);
 export class Loader {
     static moduleCache = new Map();
     adapters;
@@ -105,9 +107,126 @@ export class Loader {
                 }
             }
         }
-        Loader.moduleCache.set(cacheKey, { text, manifests: resolved });
+        // Expand include directives — load partial files into the same module scope.
+        // Results with includes are NOT cached because partial file content is not
+        // tracked in the cache key — the cache would serve stale data if a partial changes.
+        let hasIncludes = false;
+        if (moduleManifest) {
+            const includePatterns = moduleManifest.include;
+            if (includePatterns?.length) {
+                hasIncludes = true;
+                const adapter = this.pick(source);
+                const includedFiles = await this.resolveIncludes(source, includePatterns, adapter);
+                for (const includedUrl of includedFiles) {
+                    const partialManifests = await this.loadPartialFile(includedUrl, moduleName, options);
+                    resolved.push(...partialManifests);
+                }
+            }
+        }
+        if (!hasIncludes) {
+            Loader.moduleCache.set(cacheKey, { text, manifests: resolved });
+        }
         return cloneManifestArray(resolved);
     }
+    async resolveIncludes(ownerSource, patterns, adapter) {
+        const hasGlobs = patterns.some((p) => /[*?{}\[\]]/.test(p));
+        if (hasGlobs) {
+            if (!adapter.expandGlob) {
+                throw new Error(`Include patterns in '${ownerSource}' contain globs but the adapter for this source ` +
+                    `does not support glob expansion. Use explicit file paths instead of patterns like: ` +
+                    patterns.filter((p) => /[*?{}\[\]]/.test(p)).join(", "));
+            }
+            return adapter.expandGlob(ownerSource, patterns);
+        }
+        // Literal relative paths — deduplicate in case the same file appears under multiple patterns.
+        return [...new Set(patterns.map((p) => adapter.resolveRelative(ownerSource, p)))];
+    }
+    async loadPartialFile(url, ownerModuleName, options) {
+        const { text, source } = await this.pick(url).read(url);
+        const parsedDocuments = parseAllDocuments(text);
+        const rawDocs = parsedDocuments.map((d) => d.toJSON());
+        const offsets = documentLineOffsets(text);
+        const lineOffsets = buildLineOffsets(text);
+        const resolved = [];
+        let docIdx = 0;
+        for (const rawDoc of rawDocs) {
+            const currentDocIdx = docIdx++;
+            const sourceLine = offsets[currentDocIdx] ?? 0;
+            const positionIndex = buildPositionIndex(parsedDocuments[currentDocIdx], lineOffsets);
+            if (rawDoc === null || rawDoc === undefined)
+                continue;
+            const kind = rawDoc.kind;
+            if (kind && SYSTEM_KINDS.has(kind)) {
+                throw new Error(`Included file '${source}' contains '${kind}' which is not allowed in partial files. ` +
+                    `Only the owner telo.yaml may declare ${kind} resources.`);
+            }
+            let compiledDocs;
+            if (options?.compile) {
+                try {
+                    const result = precompileDoc(rawDoc);
+                    compiledDocs = Array.isArray(result) ? result : [result];
+                }
+                catch (error) {
+                    throw new Error(`Failed to compile manifest in ${source}: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+            else {
+                compiledDocs = [rawDoc];
+            }
+            for (const doc of compiledDocs) {
+                if (doc === null || doc === undefined)
+                    continue;
+                const manifest = doc;
+                const metadata = {
+                    ...manifest.metadata,
+                    source,
+                    sourceLine,
+                    ...(ownerModuleName && !manifest.metadata?.module ? { module: ownerModuleName } : {}),
+                };
+                Object.defineProperty(metadata, "positionIndex", {
+                    value: positionIndex,
+                    enumerable: false,
+                    writable: true,
+                    configurable: true,
+                });
+                resolved.push({ ...manifest, metadata });
+            }
+        }
+        return resolved;
+    }
+    async loadModuleForFile(fileUrl) {
+        // Try loading as a regular module first (it might be a telo.yaml itself).
+        // Use loadManifests (not loadModule) so imported definitions are included —
+        // otherwise the analyzer won't know about kinds from Kernel.Import sources.
+        try {
+            const docs = await this.loadModule(fileUrl);
+            const hasModule = docs.some((d) => d.kind === "Kernel.Module");
+            if (hasModule) {
+                const { source } = await this.pick(fileUrl).read(fileUrl);
+                const manifests = await this.loadManifests(fileUrl);
+                return { ownerUrl: source, manifests, sourceManifests: groupBySource(manifests) };
+            }
+        }
+        catch (err) {
+            // If the file looks like an owner manifest (named telo.yaml), rethrow —
+            // a broken owner shouldn't silently fall through to parent lookup.
+            const normalized = fileUrl.replace(/\\/g, "/");
+            if (normalized.endsWith(`/${DEFAULT_MANIFEST_FILENAME}`) || normalized === DEFAULT_MANIFEST_FILENAME) {
+                throw err;
+            }
+            // Otherwise fall through to owner lookup — this is likely a partial file
+        }
+        // Find the owning telo.yaml via parent-directory traversal
+        const adapter = this.pick(fileUrl);
+        if (!adapter.resolveOwnerOf)
+            return null;
+        const ownerUrl = await adapter.resolveOwnerOf(fileUrl);
+        if (!ownerUrl)
+            return null;
+        // Load the owner module (which will load included files via include expansion)
+        const manifests = await this.loadManifests(ownerUrl);
+        return { ownerUrl, manifests, sourceManifests: groupBySource(manifests) };
+    }
     async loadModuleGraph(entryUrl, onError) {
         const visited = new Set([entryUrl]);
         const result = new Map();
@@ -224,6 +343,19 @@ function cloneManifestValue(value) {
     }
     return value;
 }
+function groupBySource(manifests) {
+    const map = new Map();
+    for (const m of manifests) {
+        const src = m.metadata?.source ?? "unknown";
+        let list = map.get(src);
+        if (!list) {
+            list = [];
+            map.set(src, list);
+        }
+        list.push(m);
+    }
+    return map;
+}
 function documentLineOffsets(text) {
     const offsets = [0];
     const lines = text.split("\n");

package/dist/types.d.ts

@@ -42,6 +42,14 @@ export interface ManifestAdapter {
         source: string;
     }>;
     resolveRelative(base: string, relative: string): string;
+    /** Expand glob patterns relative to a base source. Returns sources in the same
+     *  format as read().source — suitable to pass back into read() / resolveRelative().
+     *  Optional — only filesystem-capable adapters implement this. */
+    expandGlob?(base: string, patterns: string[]): Promise<string[]>;
+    /** Walk parent directories from fileUrl looking for the nearest telo.yaml.
+     *  Returns the source in the same format as read().source, or null if none found.
+     *  Optional — only filesystem-capable adapters implement this. */
+    resolveOwnerOf?(fileUrl: string): Promise<string | null>;
 }
 export interface LoadOptions {
     /** When true, each YAML document is passed through the CEL precompiler before being

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;qHACqH;AACrH,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE9F,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,cAAc,CAAC;AAErD,MAAM,WAAW,QAAQ;IACvB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,QAAQ,CAAC;IAChB,GAAG,EAAE,QAAQ,CAAC;CACf;AAED;;oDAEoD;AACpD,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE/C;6EAC6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CACzD;AAED,MAAM,WAAW,WAAW;IAC1B;;;+EAG2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,aAAa,CAAC,EAAE,eAAe,EAAE,CAAC;IAClC,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,0DAA0D;IAC1D,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;gEAKgE;AAChE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,qBAAqB,EAAE,aAAa,CAAC;IACtD,WAAW,CAAC,EAAE,OAAO,0BAA0B,EAAE,kBAAkB,CAAC;CACrE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;qHACqH;AACrH,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE9F,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,cAAc,CAAC;AAErD,MAAM,WAAW,QAAQ;IACvB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,QAAQ,CAAC;IAChB,GAAG,EAAE,QAAQ,CAAC;CACf;AAED;;oDAEoD;AACpD,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE/C;6EAC6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAExD;;sEAEkE;IAClE,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEjE;;sEAEkE;IAClE,cAAc,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,WAAW;IAC1B;;;+EAG2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,aAAa,CAAC,EAAE,eAAe,EAAE,CAAC;IAClC,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,0DAA0D;IAC1D,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;gEAKgE;AAChE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,qBAAqB,EAAE,aAAa,CAAC;IACtD,WAAW,CAAC,EAAE,OAAO,0BAA0B,EAAE,kBAAkB,CAAC;CACrE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/analyzer",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Telo Analyzer - Static manifest validator for Telo manifests.",
   "keywords": [
     "telo",
@@ -39,8 +39,8 @@
     "@marcbachmann/cel-js": "^7.5.3",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
-    "yaml": "^2.8.3",
     "jsonpath-plus": "^10.3.0",
+    "yaml": "^2.8.3",
     "@telorun/sdk": "0.2.8"
   },
   "devDependencies": {

package/src/builtins.ts

@@ -96,6 +96,10 @@ export const KERNEL_BUILTINS: ResourceDefinition[] = [
             ],
           },
         },
+        include: {
+          type: "array",
+          items: { type: "string" },
+        },
         exports: {
           type: "object",
           properties: {

package/src/index.ts

@@ -1,5 +1,4 @@
 export { HttpAdapter } from "./adapters/http-adapter.js";
-export { createNodeAdapter, NodeAdapter } from "./adapters/node-adapter.js";
 export { RegistryAdapter } from "./adapters/registry-adapter.js";
 export { AnalysisRegistry } from "./analysis-registry.js";
 export { StaticAnalyzer } from "./analyzer.js";

package/src/manifest-loader.ts

@@ -3,14 +3,17 @@ import { isMap, isPair, isScalar, isSeq, parseAllDocuments, type Document } from
 import { HttpAdapter } from "./adapters/http-adapter.js";
 import { RegistryAdapter } from "./adapters/registry-adapter.js";
 import { precompileDoc } from "./precompile.js";
-import type {
-  LoadOptions,
-  LoaderInitOptions,
-  ManifestAdapter,
-  Position,
-  PositionIndex,
+import {
+  DEFAULT_MANIFEST_FILENAME,
+  type LoadOptions,
+  type LoaderInitOptions,
+  type ManifestAdapter,
+  type Position,
+  type PositionIndex,
 } from "./types.js";
 
+const SYSTEM_KINDS = new Set(["Kernel.Module", "Kernel.Import", "Kernel.Definition"]);
+
 export class Loader {
   private static readonly moduleCache = new Map<
     string,
@@ -128,10 +131,152 @@ export class Loader {
       }
     }
 
-    Loader.moduleCache.set(cacheKey, { text, manifests: resolved });
+    // Expand include directives — load partial files into the same module scope.
+    // Results with includes are NOT cached because partial file content is not
+    // tracked in the cache key — the cache would serve stale data if a partial changes.
+    let hasIncludes = false;
+    if (moduleManifest) {
+      const includePatterns = (moduleManifest as any).include as string[] | undefined;
+      if (includePatterns?.length) {
+        hasIncludes = true;
+        const adapter = this.pick(source);
+        const includedFiles = await this.resolveIncludes(source, includePatterns, adapter);
+        for (const includedUrl of includedFiles) {
+          const partialManifests = await this.loadPartialFile(includedUrl, moduleName, options);
+          resolved.push(...partialManifests);
+        }
+      }
+    }
+
+    if (!hasIncludes) {
+      Loader.moduleCache.set(cacheKey, { text, manifests: resolved });
+    }
     return cloneManifestArray(resolved);
   }
 
+  private async resolveIncludes(
+    ownerSource: string,
+    patterns: string[],
+    adapter: ManifestAdapter,
+  ): Promise<string[]> {
+    const hasGlobs = patterns.some((p) => /[*?{}\[\]]/.test(p));
+    if (hasGlobs) {
+      if (!adapter.expandGlob) {
+        throw new Error(
+          `Include patterns in '${ownerSource}' contain globs but the adapter for this source ` +
+            `does not support glob expansion. Use explicit file paths instead of patterns like: ` +
+            patterns.filter((p) => /[*?{}\[\]]/.test(p)).join(", "),
+        );
+      }
+      return adapter.expandGlob(ownerSource, patterns);
+    }
+    // Literal relative paths — deduplicate in case the same file appears under multiple patterns.
+    return [...new Set(patterns.map((p) => adapter.resolveRelative(ownerSource, p)))];
+  }
+
+  private async loadPartialFile(
+    url: string,
+    ownerModuleName: string | undefined,
+    options?: LoadOptions,
+  ): Promise<ResourceManifest[]> {
+    const { text, source } = await this.pick(url).read(url);
+
+    const parsedDocuments = parseAllDocuments(text);
+    const rawDocs = parsedDocuments.map((d) => d.toJSON());
+    const offsets = documentLineOffsets(text);
+    const lineOffsets = buildLineOffsets(text);
+    const resolved: ResourceManifest[] = [];
+    let docIdx = 0;
+
+    for (const rawDoc of rawDocs) {
+      const currentDocIdx = docIdx++;
+      const sourceLine = offsets[currentDocIdx] ?? 0;
+      const positionIndex = buildPositionIndex(parsedDocuments[currentDocIdx], lineOffsets);
+      if (rawDoc === null || rawDoc === undefined) continue;
+
+      const kind = rawDoc.kind as string | undefined;
+      if (kind && SYSTEM_KINDS.has(kind)) {
+        throw new Error(
+          `Included file '${source}' contains '${kind}' which is not allowed in partial files. ` +
+            `Only the owner telo.yaml may declare ${kind} resources.`,
+        );
+      }
+
+      let compiledDocs: unknown[];
+      if (options?.compile) {
+        try {
+          const result = precompileDoc(rawDoc);
+          compiledDocs = Array.isArray(result) ? result : [result];
+        } catch (error) {
+          throw new Error(
+            `Failed to compile manifest in ${source}: ${error instanceof Error ? error.message : String(error)}`,
+          );
+        }
+      } else {
+        compiledDocs = [rawDoc];
+      }
+
+      for (const doc of compiledDocs) {
+        if (doc === null || doc === undefined) continue;
+        const manifest = doc as ResourceManifest;
+        const metadata = {
+          ...manifest.metadata,
+          source,
+          sourceLine,
+          ...(ownerModuleName && !manifest.metadata?.module ? { module: ownerModuleName } : {}),
+        };
+        Object.defineProperty(metadata, "positionIndex", {
+          value: positionIndex,
+          enumerable: false,
+          writable: true,
+          configurable: true,
+        });
+        resolved.push({ ...manifest, metadata });
+      }
+    }
+
+    return resolved;
+  }
+
+  async loadModuleForFile(
+    fileUrl: string,
+  ): Promise<{
+    ownerUrl: string;
+    manifests: ResourceManifest[];
+    sourceManifests: Map<string, ResourceManifest[]>;
+  } | null> {
+    // Try loading as a regular module first (it might be a telo.yaml itself).
+    // Use loadManifests (not loadModule) so imported definitions are included —
+    // otherwise the analyzer won't know about kinds from Kernel.Import sources.
+    try {
+      const docs = await this.loadModule(fileUrl);
+      const hasModule = docs.some((d) => d.kind === "Kernel.Module");
+      if (hasModule) {
+        const { source } = await this.pick(fileUrl).read(fileUrl);
+        const manifests = await this.loadManifests(fileUrl);
+        return { ownerUrl: source, manifests, sourceManifests: groupBySource(manifests) };
+      }
+    } catch (err) {
+      // If the file looks like an owner manifest (named telo.yaml), rethrow —
+      // a broken owner shouldn't silently fall through to parent lookup.
+      const normalized = fileUrl.replace(/\\/g, "/");
+      if (normalized.endsWith(`/${DEFAULT_MANIFEST_FILENAME}`) || normalized === DEFAULT_MANIFEST_FILENAME) {
+        throw err;
+      }
+      // Otherwise fall through to owner lookup — this is likely a partial file
+    }
+
+    // Find the owning telo.yaml via parent-directory traversal
+    const adapter = this.pick(fileUrl);
+    if (!adapter.resolveOwnerOf) return null;
+    const ownerUrl = await adapter.resolveOwnerOf(fileUrl);
+    if (!ownerUrl) return null;
+
+    // Load the owner module (which will load included files via include expansion)
+    const manifests = await this.loadManifests(ownerUrl);
+    return { ownerUrl, manifests, sourceManifests: groupBySource(manifests) };
+  }
+
   async loadModuleGraph(
     entryUrl: string,
     onError?: (url: string, error: Error) => void,
@@ -253,6 +398,20 @@ function cloneManifestValue<T>(value: T): T {
   return value;
 }
 
+function groupBySource(manifests: ResourceManifest[]): Map<string, ResourceManifest[]> {
+  const map = new Map<string, ResourceManifest[]>();
+  for (const m of manifests) {
+    const src = (m.metadata?.source as string) ?? "unknown";
+    let list = map.get(src);
+    if (!list) {
+      list = [];
+      map.set(src, list);
+    }
+    list.push(m);
+  }
+  return map;
+}
+
 function documentLineOffsets(text: string): number[] {
   const offsets = [0];
   const lines = text.split("\n");

package/src/types.ts

@@ -45,6 +45,16 @@ export interface ManifestAdapter {
   supports(url: string): boolean;
   read(url: string): Promise<{ text: string; source: string }>;
   resolveRelative(base: string, relative: string): string;
+
+  /** Expand glob patterns relative to a base source. Returns sources in the same
+   *  format as read().source — suitable to pass back into read() / resolveRelative().
+   *  Optional — only filesystem-capable adapters implement this. */
+  expandGlob?(base: string, patterns: string[]): Promise<string[]>;
+
+  /** Walk parent directories from fileUrl looking for the nearest telo.yaml.
+   *  Returns the source in the same format as read().source, or null if none found.
+   *  Optional — only filesystem-capable adapters implement this. */
+  resolveOwnerOf?(fileUrl: string): Promise<string | null>;
 }
 
 export interface LoadOptions {

package/src/adapters/node-adapter.ts

@@ -1,38 +0,0 @@
-import * as fs from "fs/promises";
-import * as path from "path";
-import { DEFAULT_MANIFEST_FILENAME, type ManifestAdapter } from "../types.js";
-
-/** Node.js fs-based ManifestAdapter for local files. Not browser-compatible. */
-export class NodeAdapter implements ManifestAdapter {
-  constructor(private readonly cwd: string = process.cwd()) {}
-
-  supports(url: string): boolean {
-    return (
-      url.startsWith("file://") ||
-      url.startsWith("/") ||
-      url.startsWith("./") ||
-      url.startsWith("../") ||
-      (!url.includes("://") && !url.includes("@"))
-    );
-  }
-
-  async read(url: string): Promise<{ text: string; source: string }> {
-    const filePath = url.startsWith("file://") ? new URL(url).pathname : url;
-    const stat = await fs.stat(filePath).catch(() => null);
-    const resolvedPath =
-      stat?.isDirectory() ? path.join(filePath, DEFAULT_MANIFEST_FILENAME) : filePath;
-    const text = await fs.readFile(resolvedPath, "utf8");
-    return { text, source: resolvedPath };
-  }
-
-  resolveRelative(base: string, relative: string): string {
-    const basePath = base.startsWith("file://") ? new URL(base).pathname : base;
-    const baseDir = path.dirname(path.resolve(this.cwd, basePath));
-    return path.resolve(baseDir, relative);
-  }
-}
-
-/** @deprecated Use `new NodeAdapter(cwd)` instead */
-export function createNodeAdapter(cwd: string = process.cwd()): ManifestAdapter {
-  return new NodeAdapter(cwd);
-}