@platformos/platformos-graph 0.0.20 → 0.1.0

package/dist/graph/extract.spec.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const platformos_check_common_1 = require("@platformos/platformos-check-common");
+const vitest_1 = require("vitest");
+const index_1 = require("../index");
+const toSourceCode_1 = require("../toSourceCode");
+const test_helpers_1 = require("./test-helpers");
+/**
+ * `extractFileReferences` is the per-file primitive a `validate_code`-style
+ * consumer uses: parse an in-flight buffer with `toSourceCode`, then resolve its
+ * outgoing dependency edges against the on-disk project — WITHOUT building the
+ * whole app graph. The buffer is never read from disk, so these specs pass the
+ * content inline (and even use a `sourceUri` for a file that does not exist).
+ */
+const { fs } = (0, test_helpers_1.getDependencies)();
+/** The exact source range of `snippet` within `source`. */
+function rangeOf(source, snippet) {
+    const start = source.indexOf(snippet);
+    if (start < 0)
+        throw new Error(`snippet not found: ${snippet}`);
+    return [start, start + snippet.length];
+}
+function directRef(sourceUri, sourceRange, targetUri, kind, args) {
+    return {
+        source: { uri: sourceUri, range: sourceRange },
+        target: { uri: targetUri },
+        type: 'direct',
+        kind,
+        ...(args ? { args } : {}),
+    };
+}
+async function extract(rootUri, sourceUri, content) {
+    return (0, index_1.extractFileReferences)(rootUri, sourceUri, await (0, toSourceCode_1.toSourceCode)(sourceUri, content), { fs });
+}
+(0, vitest_1.describe)('extractFileReferences: resolves a single buffer against the project', () => {
+    const rootUri = platformos_check_common_1.path.join(test_helpers_1.fixturesRoot, 'function-edges');
+    const p = (part) => platformos_check_common_1.path.join(rootUri, ...part.split('/'));
+    (0, vitest_1.it)('resolves a {% function %} edge to the canonical lib URI', async () => {
+        const sourceUri = p('app/views/pages/draft.liquid'); // not on disk — in-flight buffer
+        const content = `{% liquid
+  function items = 'queries/list'
+%}`;
+        (0, vitest_1.expect)(await extract(rootUri, sourceUri, content)).toEqual([
+            directRef(sourceUri, rangeOf(content, "function items = 'queries/list'"), p('app/lib/queries/list.liquid'), 'function'),
+        ]);
+    });
+    (0, vitest_1.it)('resolves a target that does not exist on disk (path-based resolution)', async () => {
+        const sourceUri = p('app/views/pages/draft.liquid');
+        const content = `{% liquid
+  function ghost = 'queries/missing'
+%}`;
+        (0, vitest_1.expect)(await extract(rootUri, sourceUri, content)).toEqual([
+            directRef(sourceUri, rangeOf(content, "function ghost = 'queries/missing'"), p('app/lib/queries/missing.liquid'), 'function'),
+        ]);
+    });
+    (0, vitest_1.it)('captures the named-argument names at a render call site', async () => {
+        const sourceUri = p('app/views/pages/draft.liquid');
+        const content = "{% render 'card', title: page.title, count: 3 %}";
+        (0, vitest_1.expect)(await extract(rootUri, sourceUri, content)).toEqual([
+            directRef(sourceUri, rangeOf(content, "{% render 'card', title: page.title, count: 3 %}"), p('app/views/partials/card.liquid'), 'render', ['title', 'count']),
+        ]);
+    });
+});
+(0, vitest_1.describe)('extractFileReferences: kinds and resolution match the full graph build', () => {
+    (0, vitest_1.it)('tags include edges with kind "include"', async () => {
+        const rootUri = platformos_check_common_1.path.join(test_helpers_1.fixturesRoot, 'include-edges');
+        const p = (part) => platformos_check_common_1.path.join(rootUri, ...part.split('/'));
+        const sourceUri = p('app/views/pages/draft.liquid');
+        const content = "{% include 'shared/header' %}";
+        (0, vitest_1.expect)(await extract(rootUri, sourceUri, content)).toEqual([
+            directRef(sourceUri, rangeOf(content, "{% include 'shared/header' %}"), p('app/views/partials/shared/header.liquid'), 'include'),
+        ]);
+    });
+    (0, vitest_1.it)('resolves a {% graphql %} edge to the .graphql operation file', async () => {
+        const rootUri = platformos_check_common_1.path.join(test_helpers_1.fixturesRoot, 'graphql-edges');
+        const p = (part) => platformos_check_common_1.path.join(rootUri, ...part.split('/'));
+        const sourceUri = p('app/views/pages/draft.liquid');
+        const content = `{% liquid
+  graphql posts = 'blog_posts/find', id: '1'
+%}`;
+        (0, vitest_1.expect)(await extract(rootUri, sourceUri, content)).toEqual([
+            directRef(sourceUri, rangeOf(content, "graphql posts = 'blog_posts/find', id: '1'"), p('app/graphql/blog_posts/find.graphql'), 'graphql', ['id']),
+        ]);
+    });
+    (0, vitest_1.it)('resolves module-namespaced render + function targets in declaration order', async () => {
+        const rootUri = platformos_check_common_1.path.join(test_helpers_1.fixturesRoot, 'module-edges');
+        const p = (part) => platformos_check_common_1.path.join(rootUri, ...part.split('/'));
+        const sourceUri = p('app/views/pages/draft.liquid');
+        const content = `{% liquid
+  function items = 'modules/my_module/queries/get'
+%}
+{% render 'modules/my_module/card' %}`;
+        (0, vitest_1.expect)(await extract(rootUri, sourceUri, content)).toEqual([
+            directRef(sourceUri, rangeOf(content, "function items = 'modules/my_module/queries/get'"), p('modules/my_module/public/lib/queries/get.liquid'), 'function'),
+            directRef(sourceUri, rangeOf(content, "{% render 'modules/my_module/card' %}"), p('modules/my_module/public/views/partials/card.liquid'), 'render'),
+        ]);
+    });
+});
+(0, vitest_1.describe)('extractFileReferences: only statically resolvable edges', () => {
+    const rootUri = platformos_check_common_1.path.join(test_helpers_1.fixturesRoot, 'function-edges');
+    const sourceUri = platformos_check_common_1.path.join(rootUri, 'app/views/pages/draft.liquid');
+    (0, vitest_1.it)('skips dynamic render targets', async () => {
+        (0, vitest_1.expect)(await extract(rootUri, sourceUri, '{% render partial_name %}')).toEqual([]);
+    });
+    (0, vitest_1.it)('returns nothing for an unparseable buffer instead of throwing', async () => {
+        (0, vitest_1.expect)(await extract(rootUri, sourceUri, '{% render %}{% endif %}')).toEqual([]);
+    });
+    (0, vitest_1.it)('returns nothing for a buffer with no references', async () => {
+        (0, vitest_1.expect)(await extract(rootUri, sourceUri, '<h1>{{ page.title }}</h1>')).toEqual([]);
+    });
+});
+(0, vitest_1.describe)('extractFileReferences: layout-association edges (frontmatter `layout:`)', () => {
+    const rootUri = platformos_check_common_1.path.join(test_helpers_1.fixturesRoot, 'function-edges'); // no layouts here → default path
+    const p = (part) => platformos_check_common_1.path.join(rootUri, ...part.split('/'));
+    const sourceUri = p('app/views/pages/draft.liquid');
+    // The whole frontmatter block: start through the closing `---` line + newline.
+    const fmRange = (content) => [
+        0,
+        content.indexOf('\n', content.indexOf('---', 3)) + 1,
+    ];
+    (0, vitest_1.it)('emits a layout edge for an explicit frontmatter layout', async () => {
+        const content = `---
+slug: draft
+layout: theme
+---
+<h1>x</h1>`;
+        (0, vitest_1.expect)(await extract(rootUri, sourceUri, content)).toEqual([
+            directRef(sourceUri, fmRange(content), p('app/views/layouts/theme.liquid'), 'layout'),
+        ]);
+    });
+    (0, vitest_1.it)('resolves a module-prefixed layout', async () => {
+        const content = `---
+layout: modules/core/admin
+---
+<h1>x</h1>`;
+        (0, vitest_1.expect)(await extract(rootUri, sourceUri, content)).toEqual([
+            directRef(sourceUri, fmRange(content), p('modules/core/public/views/layouts/admin.liquid'), 'layout'),
+        ]);
+    });
+    (0, vitest_1.it)('emits no edge for an explicitly empty layout', async () => {
+        const content = `---
+slug: draft
+layout: ''
+---
+<h1>x</h1>`;
+        (0, vitest_1.expect)(await extract(rootUri, sourceUri, content)).toEqual([]);
+    });
+    (0, vitest_1.it)('emits no edge when layout is omitted (no implicit default)', async () => {
+        const content = `---
+slug: draft
+---
+<h1>x</h1>`;
+        (0, vitest_1.expect)(await extract(rootUri, sourceUri, content)).toEqual([]);
+    });
+    (0, vitest_1.it)('emits no edge for a dynamic layout value', async () => {
+        const content = `---
+layout: "{{ context.constants.LAYOUT }}"
+---
+<h1>x</h1>`;
+        (0, vitest_1.expect)(await extract(rootUri, sourceUri, content)).toEqual([]);
+    });
+});
+//# sourceMappingURL=extract.spec.js.map

package/dist/graph/extract.spec.js.map

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

package/dist/graph/module.d.ts

@@ -1,15 +1,53 @@
 import { UriString } from '@platformos/platformos-check-common';
-import { AssetModule, AppGraph, AppModule, GraphQLModule, LiquidModule } from '../types';
+import { AssetModule, AppGraph, AppModule, GraphQLModule, LiquidModule, SchemaModule } from '../types';
 export declare function getModule(appGraph: AppGraph, uri: UriString): AppModule | undefined;
+/**
+ * Create (or fetch the cached) asset module for an already-resolved URI.
+ *
+ * Preferred over {@link getAssetModule} whenever the file is known, for the same
+ * reason as {@link getPartialModuleByUri}: it does not reconstruct a path from a
+ * name, so a nested or module asset keeps the location it actually has.
+ *
+ * Gated on {@link isSupportedAsset} HERE rather than at each call site, so a new
+ * caller cannot forget the gate and mint an Asset node for a value that is not an
+ * asset file.
+ */
+export declare function getAssetModuleByUri(appGraph: AppGraph, uri: string): AssetModule | undefined;
+/**
+ * Whether `nameOrUri` refers to a supported asset file (by extension).
+ *
+ * The single gate for admitting an asset, whether the subject is a reference (the
+ * string inside `{{ 'app.js' | asset_url }}`) or a resolved URI. It preserves the
+ * graph's historical behavior of ignoring an `asset_url`-family filter applied to
+ * a value that is not an asset file. Exported so the traversal can skip the
+ * filesystem probe for a non-asset value BEFORE resolving it; the module
+ * factories gate on it again, so neither layer depends on the other remembering.
+ */
+export declare function isSupportedAsset(nameOrUri: string): boolean;
+/**
+ * Create (or fetch the cached) asset module for an asset REFERENCE — the string
+ * inside `{{ 'app.js' | asset_url }}`, which may carry a `modules/<name>/` prefix.
+ *
+ * Assets live under the same roots as every other file type: `app/assets/` or
+ * `modules/<name>/{public,private}/assets/`. Those come from platformos-common, so the
+ * graph resolves a reference to the same place the linter and the platform do.
+ *
+ * The FIRST candidate is used as the canonical location: this is sync and has no
+ * filesystem, so it cannot tell which candidate exists. Prefer
+ * {@link getAssetModuleByUri} — the traversal resolves through `DocumentsLocator`,
+ * which can.
+ */
 export declare function getAssetModule(appGraph: AppGraph, asset: string): AssetModule | undefined;
-export declare function getPartialModule(appGraph: AppGraph, partial: string): LiquidModule;
 /**
  * Create (or fetch the cached) Liquid Partial module for an ALREADY-RESOLVED
- * full URI — used for `{% function %}` / `{% include %}` targets whose URI is
- * resolved canonically by `DocumentsLocator` (which handles lib paths, module
- * prefixes, and extensions). Unlike {@link getPartialModule}, it does not
- * reconstruct the path from a name. Commands/queries/lib helpers are all
- * `Partial` kind, consistent with check-common's file-type classification.
+ * full URI — used for `{% render %}` / `{% include %}` / `{% function %}` /
+ * `{% background %}` targets whose URI is resolved canonically by
+ * `DocumentsLocator` (which handles lib paths, module prefixes, and extensions).
+ * It keys the node by that URI verbatim (normalized), never reconstructing a path
+ * from a name: partials have two search roots (`views/partials`, `lib`) and two
+ * extensions, so a name-derived path is a guess, and guessing split a `lib/`
+ * partial into two nodes. Commands/queries/lib helpers are all `Partial` kind,
+ * consistent with check-common's file-type classification.
  */
 export declare function getPartialModuleByUri(appGraph: AppGraph, uri: string): LiquidModule;
 /**
@@ -18,5 +56,20 @@ export declare function getPartialModuleByUri(appGraph: AppGraph, uri: string):
  * `DocumentsLocator`. A leaf node (no outgoing edges).
  */
 export declare function getGraphQLModuleByUri(appGraph: AppGraph, uri: string): GraphQLModule;
+/**
+ * Create (or fetch the cached) Schema module for an already-resolved
+ * `custom_model_type`/schema URI — discovered during a full `buildAppGraph`.
+ * A leaf node; its `table` (the model `name:`) is populated during traversal.
+ */
+export declare function getSchemaModule(appGraph: AppGraph, uri: string): SchemaModule;
 export declare function getLayoutModule(appGraph: AppGraph, layoutUri: string | false | undefined): LiquidModule | undefined;
+/**
+ * Create (or fetch the cached) Layout module for an already-resolved layout URI
+ * — used for the frontmatter `layout:` association edge, whose target is
+ * resolved by `DocumentsLocator` (`'layout'` type: `app/views/layouts`, module
+ * prefixes, `.html.liquid`/`.liquid`). Distinct from {@link getLayoutModule} only
+ * in that the latter accepts the `string | false | undefined` a frontmatter read
+ * yields; both normalize, so both key the same node.
+ */
+export declare function getLayoutModuleByUri(appGraph: AppGraph, uri: string): LiquidModule;
 export declare function getPageModule(appGraph: AppGraph, pageUri: string): LiquidModule;

package/dist/graph/module.js

@@ -1,13 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getModule = getModule;
+exports.getAssetModuleByUri = getAssetModuleByUri;
+exports.isSupportedAsset = isSupportedAsset;
 exports.getAssetModule = getAssetModule;
-exports.getPartialModule = getPartialModule;
 exports.getPartialModuleByUri = getPartialModuleByUri;
 exports.getGraphQLModuleByUri = getGraphQLModuleByUri;
+exports.getSchemaModule = getSchemaModule;
 exports.getLayoutModule = getLayoutModule;
+exports.getLayoutModuleByUri = getLayoutModuleByUri;
 exports.getPageModule = getPageModule;
 const platformos_check_common_1 = require("@platformos/platformos-check-common");
+const platformos_common_1 = require("@platformos/platformos-common");
 const types_1 = require("../types");
 const utils_1 = require("../utils");
 /**
@@ -30,69 +34,120 @@ function getModule(appGraph, uri) {
     if (cache.has(uri)) {
         return cache.get(uri);
     }
-    const relativePath = platformos_check_common_1.path.relative(uri, appGraph.rootUri);
-    switch (true) {
-        case (0, platformos_check_common_1.isLayout)(uri):
+    // One anchored classification, not four unanchored ones: a file's type is its
+    // position relative to the project root, and the graph has that root.
+    switch ((0, platformos_common_1.getFileType)(uri, appGraph.rootUri)) {
+        case platformos_common_1.PlatformOSFileType.Layout:
             return getLayoutModule(appGraph, uri);
-        case (0, platformos_check_common_1.isPage)(uri):
+        case platformos_common_1.PlatformOSFileType.Page:
             return getPageModule(appGraph, uri);
-        case (0, platformos_check_common_1.isPartial)(uri):
-            return getPartialModule(appGraph, platformos_check_common_1.path.basename(uri, '.liquid'));
-        case relativePath.startsWith('assets') || relativePath.startsWith('modules'):
-            return getAssetModule(appGraph, platformos_check_common_1.path.basename(uri));
+        case platformos_common_1.PlatformOSFileType.Partial:
+            // The URI is already resolved, so it is used as-is. Reducing it to a
+            // `basename` and rebuilding a path from that loses any subdirectory and any
+            // module prefix — `app/views/partials/ui/card.liquid` came back as
+            // `app/views/partials/card.liquid`, a node for a file that need not exist,
+            // and `app/lib/can/x.liquid` was split from the same file resolved as an
+            // edge target (which comes through getPartialModuleByUri).
+            return getPartialModuleByUri(appGraph, uri);
+        case platformos_common_1.PlatformOSFileType.Asset:
+            return getAssetModuleByUri(appGraph, uri);
     }
 }
-function getAssetModule(appGraph, asset) {
-    const extension = (0, utils_1.extname)(asset);
-    const SUPPORTED_ASSET_EXTENSIONS = [
-        ...types_1.SUPPORTED_ASSET_IMAGE_EXTENSIONS,
-        'js',
-        'css',
-        'svg',
-        'pdf',
-        'woff',
-        'woff2',
-        'ttf',
-        'eot',
-    ];
-    if (!SUPPORTED_ASSET_EXTENSIONS.includes(extension)) {
+/**
+ * Create (or fetch the cached) asset module for an already-resolved URI.
+ *
+ * Preferred over {@link getAssetModule} whenever the file is known, for the same
+ * reason as {@link getPartialModuleByUri}: it does not reconstruct a path from a
+ * name, so a nested or module asset keeps the location it actually has.
+ *
+ * Gated on {@link isSupportedAsset} HERE rather than at each call site, so a new
+ * caller cannot forget the gate and mint an Asset node for a value that is not an
+ * asset file.
+ */
+function getAssetModuleByUri(appGraph, uri) {
+    if (!isSupportedAsset(uri))
         return undefined;
-    }
     return module(appGraph, {
         type: "Asset" /* ModuleType.Asset */,
         kind: 'unused',
+        // Normalize to forward slashes — see getPartialModuleByUri.
+        uri: platformos_check_common_1.path.normalize(uri),
         dependencies: [],
         references: [],
-        uri: platformos_check_common_1.path.join(appGraph.rootUri, 'assets', asset),
     });
 }
-function getPartialModule(appGraph, partial) {
-    const uri = platformos_check_common_1.path.join(appGraph.rootUri, 'app/views/partials', `${partial}.liquid`);
+/** File extensions the graph treats as assets (the `asset_url` edge gate). */
+const SUPPORTED_ASSET_EXTENSIONS = [
+    ...types_1.SUPPORTED_ASSET_IMAGE_EXTENSIONS,
+    'js',
+    'css',
+    'svg',
+    'pdf',
+    'woff',
+    'woff2',
+    'ttf',
+    'eot',
+];
+/**
+ * Whether `nameOrUri` refers to a supported asset file (by extension).
+ *
+ * The single gate for admitting an asset, whether the subject is a reference (the
+ * string inside `{{ 'app.js' | asset_url }}`) or a resolved URI. It preserves the
+ * graph's historical behavior of ignoring an `asset_url`-family filter applied to
+ * a value that is not an asset file. Exported so the traversal can skip the
+ * filesystem probe for a non-asset value BEFORE resolving it; the module
+ * factories gate on it again, so neither layer depends on the other remembering.
+ */
+function isSupportedAsset(nameOrUri) {
+    return SUPPORTED_ASSET_EXTENSIONS.includes((0, utils_1.extname)(nameOrUri));
+}
+/**
+ * Create (or fetch the cached) asset module for an asset REFERENCE — the string
+ * inside `{{ 'app.js' | asset_url }}`, which may carry a `modules/<name>/` prefix.
+ *
+ * Assets live under the same roots as every other file type: `app/assets/` or
+ * `modules/<name>/{public,private}/assets/`. Those come from platformos-common, so the
+ * graph resolves a reference to the same place the linter and the platform do.
+ *
+ * The FIRST candidate is used as the canonical location: this is sync and has no
+ * filesystem, so it cannot tell which candidate exists. Prefer
+ * {@link getAssetModuleByUri} — the traversal resolves through `DocumentsLocator`,
+ * which can.
+ */
+function getAssetModule(appGraph, asset) {
+    if (!isSupportedAsset(asset))
+        return undefined;
+    const [canonical] = (0, platformos_common_1.nameToPaths)(platformos_common_1.PlatformOSFileType.Asset, asset);
+    if (!canonical)
+        return undefined;
     return module(appGraph, {
-        type: "Liquid" /* ModuleType.Liquid */,
-        kind: "partial" /* LiquidModuleKind.Partial */,
-        uri: uri,
+        type: "Asset" /* ModuleType.Asset */,
+        kind: 'unused',
+        uri: platformos_check_common_1.path.join(appGraph.rootUri, canonical),
         dependencies: [],
         references: [],
     });
 }
 /**
  * Create (or fetch the cached) Liquid Partial module for an ALREADY-RESOLVED
- * full URI — used for `{% function %}` / `{% include %}` targets whose URI is
- * resolved canonically by `DocumentsLocator` (which handles lib paths, module
- * prefixes, and extensions). Unlike {@link getPartialModule}, it does not
- * reconstruct the path from a name. Commands/queries/lib helpers are all
- * `Partial` kind, consistent with check-common's file-type classification.
+ * full URI — used for `{% render %}` / `{% include %}` / `{% function %}` /
+ * `{% background %}` targets whose URI is resolved canonically by
+ * `DocumentsLocator` (which handles lib paths, module prefixes, and extensions).
+ * It keys the node by that URI verbatim (normalized), never reconstructing a path
+ * from a name: partials have two search roots (`views/partials`, `lib`) and two
+ * extensions, so a name-derived path is a guess, and guessing split a `lib/`
+ * partial into two nodes. Commands/queries/lib helpers are all `Partial` kind,
+ * consistent with check-common's file-type classification.
  */
 function getPartialModuleByUri(appGraph, uri) {
     return module(appGraph, {
         type: "Liquid" /* ModuleType.Liquid */,
         kind: "partial" /* LiquidModuleKind.Partial */,
         // Normalize to forward slashes so module keys match the rest of the graph
-        // (getPartialModule/getAssetModule build URIs via path.join, which
-        // normalizes). DocumentsLocator returns `Utils.joinPath(...).toString()`
-        // unnormalized, which on Windows keeps backslashes and breaks key/edge
-        // matching against the normalized URIs everywhere else.
+        // (getAssetModule builds its URI via path.join, which normalizes).
+        // DocumentsLocator returns `Utils.joinPath(...).toString()` unnormalized,
+        // which on Windows keeps backslashes and breaks key/edge matching against the
+        // normalized URIs everywhere else.
         uri: platformos_check_common_1.path.normalize(uri),
         dependencies: [],
         references: [],
@@ -111,6 +166,23 @@ function getGraphQLModuleByUri(appGraph, uri) {
         uri: platformos_check_common_1.path.normalize(uri),
         dependencies: [],
         references: [],
+        // Always present (empty = no table declared); populated during traversal.
+        tables: [],
+    });
+}
+/**
+ * Create (or fetch the cached) Schema module for an already-resolved
+ * `custom_model_type`/schema URI — discovered during a full `buildAppGraph`.
+ * A leaf node; its `table` (the model `name:`) is populated during traversal.
+ */
+function getSchemaModule(appGraph, uri) {
+    return module(appGraph, {
+        type: "Schema" /* ModuleType.Schema */,
+        kind: 'schema',
+        // Normalize to forward slashes — see getPartialModuleByUri.
+        uri: platformos_check_common_1.path.normalize(uri),
+        dependencies: [],
+        references: [],
     });
 }
 function getLayoutModule(appGraph, layoutUri) {
@@ -119,7 +191,29 @@ function getLayoutModule(appGraph, layoutUri) {
     return module(appGraph, {
         type: "Liquid" /* ModuleType.Liquid */,
         kind: "layout" /* LiquidModuleKind.Layout */,
-        uri: layoutUri,
+        // Normalize so a layout discovered as an entry point keys identically to the
+        // same file resolved as a frontmatter `layout:` edge target (which comes
+        // through getLayoutModuleByUri, also normalized) — one node, never a split
+        // identity. See getPartialModuleByUri for why DocumentsLocator/fs URIs must
+        // be normalized.
+        uri: platformos_check_common_1.path.normalize(layoutUri),
+        dependencies: [],
+        references: [],
+    });
+}
+/**
+ * Create (or fetch the cached) Layout module for an already-resolved layout URI
+ * — used for the frontmatter `layout:` association edge, whose target is
+ * resolved by `DocumentsLocator` (`'layout'` type: `app/views/layouts`, module
+ * prefixes, `.html.liquid`/`.liquid`). Distinct from {@link getLayoutModule} only
+ * in that the latter accepts the `string | false | undefined` a frontmatter read
+ * yields; both normalize, so both key the same node.
+ */
+function getLayoutModuleByUri(appGraph, uri) {
+    return module(appGraph, {
+        type: "Liquid" /* ModuleType.Liquid */,
+        kind: "layout" /* LiquidModuleKind.Layout */,
+        uri: platformos_check_common_1.path.normalize(uri),
         dependencies: [],
         references: [],
     });
@@ -128,7 +222,9 @@ function getPageModule(appGraph, pageUri) {
     return module(appGraph, {
         type: "Liquid" /* ModuleType.Liquid */,
         kind: "page" /* LiquidModuleKind.Page */,
-        uri: pageUri,
+        // Normalize for the same node-identity reason as getLayoutModule / the other
+        // factories (see getPartialModuleByUri).
+        uri: platformos_check_common_1.path.normalize(pageUri),
         dependencies: [],
         references: [],
     });

package/dist/graph/module.js.map

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

package/dist/graph/module.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/graph/module.spec.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const module_1 = require("./module");
+/**
+ * Node-identity invariant (code-review F10): a file must resolve to ONE module
+ * regardless of which producer creates it. Entry-point factories
+ * (getLayoutModule/getPageModule) take a URI straight from directory discovery,
+ * while edge-target factories (getLayoutModuleByUri/getPartialModuleByUri) take a
+ * DocumentsLocator-resolved URI; both normalize, so a Windows-style backslash
+ * URI from one and a forward-slash URI from the other key to the SAME cached
+ * node — never a split identity that would drop an incoming edge.
+ */
+(0, vitest_1.describe)('module factories: normalized node identity', () => {
+    const newGraph = () => ({ rootUri: 'file:///project', entryPoints: [], modules: {} });
+    (0, vitest_1.it)('dedupes an entry-point layout with the same layout resolved as an edge target', () => {
+        const graph = newGraph();
+        // As if discovered by directory traversal on Windows (backslashes)…
+        const entry = (0, module_1.getLayoutModule)(graph, 'file:///project\\app\\views\\layouts\\theme.liquid');
+        // …and as if resolved from a page's frontmatter `layout:` (forward slashes).
+        const edgeTarget = (0, module_1.getLayoutModuleByUri)(graph, 'file:///project/app/views/layouts/theme.liquid');
+        (0, vitest_1.expect)(entry).toBe(edgeTarget); // same cached object — one node
+        (0, vitest_1.expect)(entry?.uri).toEqual('file:///project/app/views/layouts/theme.liquid');
+    });
+    (0, vitest_1.it)('dedupes an entry-point page regardless of separator style', () => {
+        const graph = newGraph();
+        const first = (0, module_1.getPageModule)(graph, 'file:///project\\app\\views\\pages\\index.liquid');
+        const second = (0, module_1.getPageModule)(graph, 'file:///project/app/views/pages/index.liquid');
+        (0, vitest_1.expect)(first).toBe(second);
+        (0, vitest_1.expect)(first.uri).toEqual('file:///project/app/views/pages/index.liquid');
+    });
+    (0, vitest_1.it)('dedupes a partial across separator styles too (regression guard for the shared contract)', () => {
+        const graph = newGraph();
+        const a = (0, module_1.getPartialModuleByUri)(graph, 'file:///project\\app\\views\\partials\\card.liquid');
+        const b = (0, module_1.getPartialModuleByUri)(graph, 'file:///project/app/views/partials/card.liquid');
+        (0, vitest_1.expect)(a).toBe(b);
+        (0, vitest_1.expect)(a.uri).toEqual('file:///project/app/views/partials/card.liquid');
+    });
+});
+/**
+ * `getModule` (the entry-point dispatcher) must key a partial by its OWN
+ * resolved URI — like it does for layouts/pages/assets — NOT by rebuilding the
+ * path from the basename. Rebuilding from the basename forced every partial into
+ * `app/views/partials/<basename>.liquid`, which mis-keyed any `lib/` or nested
+ * partial (e.g. `app/lib/can/payment_request.liquid` → the phantom
+ * `app/views/partials/payment_request.liquid`), splitting it from the same file
+ * resolved as an edge target and losing its edges in the full build.
+ */
+(0, vitest_1.describe)('getModule: partial entry point keys by its own URI', () => {
+    const newGraph = () => ({ rootUri: 'file:///project', entryPoints: [], modules: {} });
+    (0, vitest_1.it)('keys a lib partial at its own URI, not app/views/partials/<basename>', () => {
+        const graph = newGraph();
+        const uri = 'file:///project/app/lib/can/payment_request.liquid';
+        (0, vitest_1.expect)((0, module_1.getModule)(graph, uri)?.uri).toEqual(uri);
+    });
+    (0, vitest_1.it)('keys a nested lib partial at its own URI', () => {
+        const graph = newGraph();
+        const uri = 'file:///project/app/lib/queries/v2/projects/find.liquid';
+        (0, vitest_1.expect)((0, module_1.getModule)(graph, uri)?.uri).toEqual(uri);
+    });
+    (0, vitest_1.it)('a lib partial entry point and the same file resolved as an edge target are ONE node', () => {
+        const graph = newGraph();
+        const uri = 'file:///project/app/lib/commands/create.liquid';
+        const entry = (0, module_1.getModule)(graph, uri);
+        const edgeTarget = (0, module_1.getPartialModuleByUri)(graph, uri);
+        (0, vitest_1.expect)(entry).toBe(edgeTarget);
+    });
+    (0, vitest_1.it)('a flat app/views/partials partial is unaffected', () => {
+        const graph = newGraph();
+        const uri = 'file:///project/app/views/partials/card.liquid';
+        (0, vitest_1.expect)((0, module_1.getModule)(graph, uri)?.uri).toEqual(uri);
+    });
+});
+//# sourceMappingURL=module.spec.js.map

package/dist/graph/module.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.spec.js","sourceRoot":"","sources":["../../src/graph/module.spec.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAE9C,qCAMkB;AAElB;;;;;;;;GAQG;AACH,IAAA,iBAAQ,EAAC,4CAA4C,EAAE,GAAG,EAAE;IAC1D,MAAM,QAAQ,GAAG,GAAa,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAEhG,IAAA,WAAE,EAAC,+EAA+E,EAAE,GAAG,EAAE;QACvF,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,oEAAoE;QACpE,MAAM,KAAK,GAAG,IAAA,wBAAe,EAAC,KAAK,EAAE,oDAAoD,CAAC,CAAC;QAC3F,6EAA6E;QAC7E,MAAM,UAAU,GAAG,IAAA,6BAAoB,EACrC,KAAK,EACL,gDAAgD,CACjD,CAAC;QAEF,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,gCAAgC;QAChE,IAAA,eAAM,EAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAA,sBAAa,EAAC,KAAK,EAAE,kDAAkD,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,IAAA,sBAAa,EAAC,KAAK,EAAE,8CAA8C,CAAC,CAAC;QAEpF,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAA,eAAM,EAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,0FAA0F,EAAE,GAAG,EAAE;QAClG,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,IAAA,8BAAqB,EAAC,KAAK,EAAE,oDAAoD,CAAC,CAAC;QAC7F,MAAM,CAAC,GAAG,IAAA,8BAAqB,EAAC,KAAK,EAAE,gDAAgD,CAAC,CAAC;QAEzF,IAAA,eAAM,EAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAA,eAAM,EAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,IAAA,iBAAQ,EAAC,oDAAoD,EAAE,GAAG,EAAE;IAClE,MAAM,QAAQ,GAAG,GAAa,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAEhG,IAAA,WAAE,EAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,oDAAoD,CAAC;QACjE,IAAA,eAAM,EAAC,IAAA,kBAAS,EAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,yDAAyD,CAAC;QACtE,IAAA,eAAM,EAAC,IAAA,kBAAS,EAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,qFAAqF,EAAE,GAAG,EAAE;QAC7F,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,gDAAgD,CAAC;QAC7D,MAAM,KAAK,GAAG,IAAA,kBAAS,EAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,IAAA,8BAAqB,EAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACrD,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,gDAAgD,CAAC;QAC7D,IAAA,eAAM,EAAC,IAAA,kBAAS,EAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}