@platformos/platformos-graph 0.0.19 → 0.1.0

package/dist/graph/edge-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-sources.js","sourceRoot":"","sources":["../../src/graph/edge-sources.ts"],"names":[],"mappings":";;AAiBA,oCASC;AAiBD,oDAKC;AA/CD,qEAKuC;AAEvC;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAAC,GAAc,EAAE,OAAkB;IAC7D,QAAQ,IAAA,+BAAW,EAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC;QAClC,KAAK,sCAAkB,CAAC,MAAM,CAAC;QAC/B,KAAK,sCAAkB,CAAC,IAAI,CAAC;QAC7B,KAAK,sCAAkB,CAAC,OAAO;YAC7B,OAAO,IAAI,CAAC;QACd;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACI,KAAK,UAAU,oBAAoB,CACxC,EAAsB,EACtB,OAAkB;IAElB,OAAO,IAAA,sCAAkB,EAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;AAChF,CAAC"}

package/dist/graph/edge-sources.spec.d.ts

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

package/dist/graph/edge-sources.spec.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const platformos_check_common_1 = require("@platformos/platformos-check-common");
+const platformos_common_1 = require("@platformos/platformos-common");
+const test_1 = require("@platformos/platformos-check-common/dist/test");
+const index_1 = require("../index");
+/**
+ * TASK-9.17: `enumerateEdgeSources` is the SINGLE canonical "what are the
+ * edge-source liquid files under a project root" primitive. The supervisor's
+ * GraphCache consumes it for BOTH the fingerprint domain and the build's entry
+ * points, so its definition must never silently drift from the file-type
+ * classifier (`getFileType` ← `FILE_TYPE_DIRS`).
+ *
+ * The load-bearing guard is EQUIVALENCE-TO-THE-CLASSIFIER: the SCOPED walk (only
+ * `APP_SOURCE_SUBTREES`, the TASK-9.15 Phase-3A perf win) must gather the exact
+ * same set a WHOLE-TREE walk filtered by `isEdgeSource` would. If a partial
+ * location is added to the classifier but its subtree is not walkable, the
+ * whole-tree walk finds files the scoped walk misses → this test fails, catching
+ * the drift before it under-reports dependents.
+ */
+(0, vitest_1.describe)('Unit: enumerateEdgeSources (canonical edge-source enumeration)', () => {
+    const rootUri = platformos_check_common_1.path.normalize('file:/');
+    const uri = (rel) => platformos_check_common_1.path.join(rootUri, rel);
+    // Edge sources under every canonical location a Page/Layout/Partial can live.
+    const EDGE_SOURCES = [
+        'app/views/pages/home.liquid', // Page (modern app/ root)
+        'app/views/layouts/application.liquid', // Layout
+        'app/views/partials/card.liquid', // Partial (views/partials)
+        'app/lib/helper.liquid', // Partial (lib)
+        'marketplace_builder/views/pages/legacy.liquid', // Page (legacy root)
+        'modules/shop/public/views/partials/widget.liquid', // Partial (top-level module, public)
+        'modules/shop/private/lib/secret.liquid', // Partial (top-level module, PRIVATE access level)
+        'app/modules/blog/private/views/pages/post.liquid', // Page (nested app/modules)
+    ];
+    // Files that are NOT edge sources: leaves, non-liquid, and a bundled
+    // non-platformOS sibling that must never be walked.
+    const NON_EDGE_SOURCES = {
+        'app/graphql/get_posts.graphql': 'query { records { results { id } } }',
+        'app/schema/blog_post.yml': 'name: blog_post',
+        'app/assets/logo.css': 'body {}',
+        'react-app/src/components/Widget.liquid': 'noise that is never a source',
+        'README.md': '# project',
+    };
+    const makeFs = () => {
+        const files = { ...NON_EDGE_SOURCES };
+        for (const rel of EDGE_SOURCES)
+            files[rel] = '<div></div>';
+        return new test_1.MockFileSystem(files, rootUri);
+    };
+    const sorted = (uris) => [...uris].sort();
+    (0, vitest_1.it)('gathers exactly the edge sources across all source roots (nothing else)', async () => {
+        const fs = makeFs();
+        (0, vitest_1.expect)(sorted(await (0, index_1.enumerateEdgeSources)(fs, rootUri))).toEqual(sorted(EDGE_SOURCES.map(uri)));
+    });
+    (0, vitest_1.it)('the scoped walk equals a whole-tree walk filtered by the classifier (no drift)', async () => {
+        const fs = makeFs();
+        const scoped = sorted(await (0, index_1.enumerateEdgeSources)(fs, rootUri));
+        const wholeTree = sorted((await everyFileUnder(fs, rootUri)).filter((u) => (0, index_1.isEdgeSource)(u, rootUri)));
+        (0, vitest_1.expect)(scoped).toEqual(wholeTree);
+    });
+    (0, vitest_1.it)('isEdgeSource is exactly the Layout/Page/Partial classification', () => {
+        const EDGE_SOURCE_TYPES = [
+            platformos_common_1.PlatformOSFileType.Layout,
+            platformos_common_1.PlatformOSFileType.Page,
+            platformos_common_1.PlatformOSFileType.Partial,
+        ];
+        for (const rel of EDGE_SOURCES) {
+            const u = uri(rel);
+            (0, vitest_1.expect)((0, index_1.isEdgeSource)(u, rootUri)).toBe(true);
+            (0, vitest_1.expect)(EDGE_SOURCE_TYPES).toContain((0, platformos_common_1.getFileType)(u, rootUri));
+        }
+        for (const rel of Object.keys(NON_EDGE_SOURCES)) {
+            const u = uri(rel);
+            (0, vitest_1.expect)((0, index_1.isEdgeSource)(u, rootUri)).toBe(false);
+            (0, vitest_1.expect)(EDGE_SOURCE_TYPES).not.toContain((0, platformos_common_1.getFileType)(u, rootUri));
+        }
+    });
+    /**
+     * The reason the classification is anchored on the root. Unanchored, a directory
+     * named like a platformOS one ANYWHERE in the path classified: these three files
+     * are not part of the app, and counting them in the fingerprint domain made the
+     * supervisor's GraphCache rebuild on edits to files the app never reads.
+     */
+    (0, vitest_1.it)('does not admit a platformOS-looking path outside the app subtrees', async () => {
+        const outside = {
+            'tmp/app/views/partials/scratch.liquid': '<div></div>',
+            'seed/post_import/app/views/pages/fixture.liquid': '<div></div>',
+            'node_modules/pkg/app/lib/helper.liquid': '<div></div>',
+        };
+        for (const rel of Object.keys(outside))
+            (0, vitest_1.expect)((0, index_1.isEdgeSource)(uri(rel), rootUri)).toBe(false);
+        // Control: the same three spellings ARE found when they sit at the real root, so
+        // the silence above is the anchoring, not the fixture or the walk.
+        const files = { ...outside };
+        for (const rel of EDGE_SOURCES)
+            files[rel] = '<div></div>';
+        const fs = new test_1.MockFileSystem(files, rootUri);
+        (0, vitest_1.expect)(sorted(await (0, index_1.enumerateEdgeSources)(fs, rootUri))).toEqual(sorted(EDGE_SOURCES.map(uri)));
+    });
+    (0, vitest_1.it)('never yields a non-platformOS sibling (a bundled react-app/ is skipped)', async () => {
+        const fs = makeFs();
+        const result = await (0, index_1.enumerateEdgeSources)(fs, rootUri);
+        (0, vitest_1.expect)(result).not.toContain(uri('react-app/src/components/Widget.liquid'));
+    });
+});
+/**
+ * Every file under `baseUri`, by brute-force recursion into every directory.
+ *
+ * Deliberately written HERE, and deliberately NOT `walkAppSourceFiles`: that is the walk
+ * `enumerateEdgeSources` is built on, so using it for the control too would compare the
+ * mechanism against itself and the equivalence assertion above would hold no matter how
+ * wrong `APP_SOURCE_SUBTREES` became. An independent walk is the entire value of that test.
+ *
+ * (It replaces check-common's `recursiveReadDirectory`, which master removed from
+ * production once the anchored walk superseded it. Its only remaining purpose was to be
+ * this control, and a control belongs next to the test that needs it rather than in a
+ * shipped package's public API.)
+ */
+async function everyFileUnder(fs, baseUri) {
+    const entries = await fs.readDirectory(baseUri).catch(() => []);
+    const nested = await Promise.all(entries.map(async ([uri, type]) => type === platformos_common_1.FileType.Directory ? everyFileUnder(fs, uri) : [uri]));
+    return nested.flat();
+}
+//# sourceMappingURL=edge-sources.spec.js.map

package/dist/graph/edge-sources.spec.js.map

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

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

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

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":";;AAAA,iFAAwE;AACxE,mCAA8C;AAC9C,oCAAiD;AACjD,kDAA+C;AAE/C,iDAA+D;AAE/D;;;;;;GAMG;AACH,MAAM,EAAE,EAAE,EAAE,GAAG,IAAA,8BAAe,GAAE,CAAC;AAEjC,2DAA2D;AAC3D,SAAS,OAAO,CAAC,MAAc,EAAE,OAAe;IAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,KAAK,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,SAAS,CAChB,SAAiB,EACjB,WAA6B,EAC7B,SAAiB,EACjB,IAAuB,EACvB,IAAe;IAEf,OAAO;QACL,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE;QAC9C,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE;QAC1B,IAAI,EAAE,QAAQ;QACd,IAAI;QACJ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,OAAe,EAAE,SAAiB,EAAE,OAAe;IACxE,OAAO,IAAA,6BAAqB,EAAC,OAAO,EAAE,SAAS,EAAE,MAAM,IAAA,2BAAY,EAAC,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AACnG,CAAC;AAED,IAAA,iBAAQ,EAAC,qEAAqE,EAAE,GAAG,EAAE;IACnF,MAAM,OAAO,GAAG,8BAAS,CAAC,IAAI,CAAC,2BAAY,EAAE,gBAAgB,CAAC,CAAC;IAC/D,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,8BAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAExE,IAAA,WAAE,EAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,SAAS,GAAG,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,iCAAiC;QACtF,MAAM,OAAO,GAAG;;GAEjB,CAAC;QAEA,IAAA,eAAM,EAAC,MAAM,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YACzD,SAAS,CACP,SAAS,EACT,OAAO,CAAC,OAAO,EAAE,iCAAiC,CAAC,EACnD,CAAC,CAAC,6BAA6B,CAAC,EAChC,UAAU,CACX;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,SAAS,GAAG,CAAC,CAAC,8BAA8B,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG;;GAEjB,CAAC;QAEA,IAAA,eAAM,EAAC,MAAM,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YACzD,SAAS,CACP,SAAS,EACT,OAAO,CAAC,OAAO,EAAE,oCAAoC,CAAC,EACtD,CAAC,CAAC,gCAAgC,CAAC,EACnC,UAAU,CACX;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,SAAS,GAAG,CAAC,CAAC,8BAA8B,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,kDAAkD,CAAC;QAEnE,IAAA,eAAM,EAAC,MAAM,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YACzD,SAAS,CACP,SAAS,EACT,OAAO,CAAC,OAAO,EAAE,kDAAkD,CAAC,EACpE,CAAC,CAAC,gCAAgC,CAAC,EACnC,QAAQ,EACR,CAAC,OAAO,EAAE,OAAO,CAAC,CACnB;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,wEAAwE,EAAE,GAAG,EAAE;IACtF,IAAA,WAAE,EAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,OAAO,GAAG,8BAAS,CAAC,IAAI,CAAC,2BAAY,EAAE,eAAe,CAAC,CAAC;QAC9D,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,8BAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,MAAM,SAAS,GAAG,CAAC,CAAC,8BAA8B,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,+BAA+B,CAAC;QAEhD,IAAA,eAAM,EAAC,MAAM,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YACzD,SAAS,CACP,SAAS,EACT,OAAO,CAAC,OAAO,EAAE,+BAA+B,CAAC,EACjD,CAAC,CAAC,yCAAyC,CAAC,EAC5C,SAAS,CACV;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,OAAO,GAAG,8BAAS,CAAC,IAAI,CAAC,2BAAY,EAAE,eAAe,CAAC,CAAC;QAC9D,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,8BAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,MAAM,SAAS,GAAG,CAAC,CAAC,8BAA8B,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG;;GAEjB,CAAC;QAEA,IAAA,eAAM,EAAC,MAAM,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YACzD,SAAS,CACP,SAAS,EACT,OAAO,CAAC,OAAO,EAAE,4CAA4C,CAAC,EAC9D,CAAC,CAAC,qCAAqC,CAAC,EACxC,SAAS,EACT,CAAC,IAAI,CAAC,CACP;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QACzF,MAAM,OAAO,GAAG,8BAAS,CAAC,IAAI,CAAC,2BAAY,EAAE,cAAc,CAAC,CAAC;QAC7D,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,8BAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,MAAM,SAAS,GAAG,CAAC,CAAC,8BAA8B,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG;;;sCAGkB,CAAC;QAEnC,IAAA,eAAM,EAAC,MAAM,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YACzD,SAAS,CACP,SAAS,EACT,OAAO,CAAC,OAAO,EAAE,kDAAkD,CAAC,EACpE,CAAC,CAAC,iDAAiD,CAAC,EACpD,UAAU,CACX;YACD,SAAS,CACP,SAAS,EACT,OAAO,CAAC,OAAO,EAAE,uCAAuC,CAAC,EACzD,CAAC,CAAC,qDAAqD,CAAC,EACxD,QAAQ,CACT;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,yDAAyD,EAAE,GAAG,EAAE;IACvE,MAAM,OAAO,GAAG,8BAAS,CAAC,IAAI,CAAC,2BAAY,EAAE,gBAAgB,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,8BAAS,CAAC,IAAI,CAAC,OAAO,EAAE,8BAA8B,CAAC,CAAC;IAE1E,IAAA,WAAE,EAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,IAAA,eAAM,EAAC,MAAM,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,2BAA2B,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,IAAA,eAAM,EAAC,MAAM,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,yBAAyB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,IAAA,eAAM,EAAC,MAAM,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,2BAA2B,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,yEAAyE,EAAE,GAAG,EAAE;IACvF,MAAM,OAAO,GAAG,8BAAS,CAAC,IAAI,CAAC,2BAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC,iCAAiC;IACjG,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,8BAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACxE,MAAM,SAAS,GAAG,CAAC,CAAC,8BAA8B,CAAC,CAAC;IAEpD,+EAA+E;IAC/E,MAAM,OAAO,GAAG,CAAC,OAAe,EAAoB,EAAE,CAAC;QACrD,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;KACrD,CAAC;IAEF,IAAA,WAAE,EAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,OAAO,GAAG;;;;WAIT,CAAC;QAER,IAAA,eAAM,EAAC,MAAM,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YACzD,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,gCAAgC,CAAC,EAAE,QAAQ,CAAC;SACtF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,OAAO,GAAG;;;WAGT,CAAC;QAER,IAAA,eAAM,EAAC,MAAM,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YACzD,SAAS,CACP,SAAS,EACT,OAAO,CAAC,OAAO,CAAC,EAChB,CAAC,CAAC,gDAAgD,CAAC,EACnD,QAAQ,CACT;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,OAAO,GAAG;;;;WAIT,CAAC;QAER,IAAA,eAAM,EAAC,MAAM,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,OAAO,GAAG;;;WAGT,CAAC;QAER,IAAA,eAAM,EAAC,MAAM,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,OAAO,GAAG;;;WAGT,CAAC;QAER,IAAA,eAAM,EAAC,MAAM,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/graph/module.d.ts

@@ -1,7 +1,75 @@
 import { UriString } from '@platformos/platformos-check-common';
-import { AssetModule, AppGraph, AppModule, 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 `{% 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;
+/**
+ * Create (or fetch the cached) GraphQL module for an already-resolved
+ * `.graphql` URI — used for `{% graphql op = 'name' %}` targets resolved by
+ * `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,11 +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");
 /**
@@ -28,48 +34,153 @@ 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);
     }
 }
+/**
+ * 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: [],
+    });
+}
+/** 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) {
-    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)) {
+    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: "Asset" /* ModuleType.Asset */,
         kind: 'unused',
+        uri: platformos_check_common_1.path.join(appGraph.rootUri, canonical),
         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`);
+/**
+ * Create (or fetch the cached) Liquid Partial module for an ALREADY-RESOLVED
+ * 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 */,
-        uri: uri,
+        // Normalize to forward slashes so module keys match the rest of the graph
+        // (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: [],
+    });
+}
+/**
+ * Create (or fetch the cached) GraphQL module for an already-resolved
+ * `.graphql` URI — used for `{% graphql op = 'name' %}` targets resolved by
+ * `DocumentsLocator`. A leaf node (no outgoing edges).
+ */
+function getGraphQLModuleByUri(appGraph, uri) {
+    return module(appGraph, {
+        type: "GraphQL" /* ModuleType.GraphQL */,
+        kind: 'graphql',
+        // Normalize to forward slashes — see getPartialModuleByUri.
+        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: [],
     });
@@ -80,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: [],
     });
@@ -89,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: [],
     });