@planweave-ai/runtime 0.1.0 → 0.1.1

package/dist/projectGraph/index.js

@@ -0,0 +1,9 @@
+export { compileProjectGraph } from "./compileProjectGraph.js";
+export { parseProjectTaskRefKey, projectCanvasEdgeKey, projectCrossTaskEdgeKey, projectTaskRefKey } from "./projectGraphKeys.js";
+export { loadProjectGraph, loadProjectGraphForWorkspace, projectGraphPath, writeProjectGraph } from "./loadProjectGraph.js";
+export { materializeProjectGraph } from "./materializeProjectGraph.js";
+export { defaultCanvasProjectGraph, projectGraphFromLegacyRegistry } from "./migration.js";
+export { projectGraphManifestSchema, projectGraphManifestSchema as projectGraphSchema } from "./schema.js";
+export { projectCanvasWorkspace, resolveProjectCanvasWorkspace } from "./projectGraphWorkspace.js";
+export { projectGraphEdgeTypes, projectGraphNodeTypes, projectGraphNodeTypes as projectGraphCanvasNodeTypes, supportedProjectGraphVersion, supportedProjectGraphVersion as projectGraphVersion } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/projectGraph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/projectGraph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACjI,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC5H,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,0BAA0B,EAAE,0BAA0B,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC3G,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AACnG,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,IAAI,2BAA2B,EACpD,4BAA4B,EAC5B,4BAA4B,IAAI,mBAAmB,EACpD,MAAM,YAAY,CAAC"}

package/dist/projectGraph/loadProjectGraph.d.ts

@@ -0,0 +1,7 @@
+import type { ProjectWorkspace } from "../types.js";
+import type { LoadedProjectGraph, ProjectGraphManifest } from "./types.js";
+export declare function projectGraphPath(workspace: ProjectWorkspace): string;
+export declare function loadProjectGraphForWorkspace(workspaceRef: ProjectWorkspace): Promise<LoadedProjectGraph>;
+export declare function loadProjectGraph(projectRoot: string): Promise<LoadedProjectGraph>;
+export declare function writeProjectGraph(workspace: ProjectWorkspace, manifest: ProjectGraphManifest): Promise<ProjectGraphManifest>;
+//# sourceMappingURL=loadProjectGraph.d.ts.map

package/dist/projectGraph/loadProjectGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadProjectGraph.d.ts","sourceRoot":"","sources":["../../src/projectGraph/loadProjectGraph.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,aAAa,CAAC;AAIrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAkB3E,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAEpE;AA0CD,wBAAsB,4BAA4B,CAAC,YAAY,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAsC9G;AAED,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAEvF;AAED,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAIlI"}

package/dist/projectGraph/loadProjectGraph.js

@@ -0,0 +1,102 @@
+import { access } from "node:fs/promises";
+import { constants } from "node:fs";
+import { join } from "node:path";
+import { readJsonFile, writeJsonFile } from "../json.js";
+import { resolveProjectWorkspace } from "../project.js";
+import { normalizeRegistry } from "../desktop/canvasRegistry.js";
+import { defaultCanvasProjectGraph, projectGraphFromLegacyRegistry } from "./migration.js";
+import { projectGraphManifestSchema } from "./schema.js";
+const defaultCanvasId = "default";
+function issue(code, message, path) {
+    return { code, message, path };
+}
+async function exists(path) {
+    try {
+        await access(path, constants.R_OK);
+        return true;
+    }
+    catch (error) {
+        void error;
+        return false;
+    }
+}
+export function projectGraphPath(workspace) {
+    return join(workspace.workspaceRoot, "project-graph.json");
+}
+function projectGraphWorkspace(workspace) {
+    const workspaceRoot = join(workspace.planweaveHome, "projects", workspace.id);
+    return {
+        ...workspace,
+        workspaceRoot,
+        projectFile: join(workspaceRoot, "project.json"),
+        packageDir: join(workspaceRoot, "package"),
+        manifestFile: join(workspaceRoot, "package", "manifest.json"),
+        stateFile: join(workspaceRoot, "state.json"),
+        resultsDir: join(workspaceRoot, "results"),
+        projectPromptFile: join(workspaceRoot, "policy", "project-prompt.md")
+    };
+}
+async function manifestTitle(workspace) {
+    try {
+        const raw = await readJsonFile(workspace.manifestFile);
+        if (raw && typeof raw === "object" && !Array.isArray(raw) && "project" in raw) {
+            const project = raw.project;
+            if (project && typeof project === "object" && !Array.isArray(project) && typeof project.title === "string") {
+                return project.title.trim() || "任务画布";
+            }
+        }
+    }
+    catch (error) {
+        void error;
+        return "任务画布";
+    }
+    return "任务画布";
+}
+async function defaultProjectGraph(workspace) {
+    return defaultCanvasProjectGraph(workspace, await manifestTitle(workspace));
+}
+async function legacyProjectGraph(workspace) {
+    const registryFile = join(workspace.workspaceRoot, "desktop", "canvases.json");
+    const registry = normalizeRegistry(await readJsonFile(registryFile));
+    return projectGraphFromLegacyRegistry(registry);
+}
+export async function loadProjectGraphForWorkspace(workspaceRef) {
+    const workspace = projectGraphWorkspace(workspaceRef);
+    const path = projectGraphPath(workspace);
+    if (await exists(path)) {
+        return {
+            workspace,
+            manifest: projectGraphManifestSchema.parse(await readJsonFile(path)),
+            source: "project_graph",
+            diagnostics: []
+        };
+    }
+    const registryFile = join(workspace.workspaceRoot, "desktop", "canvases.json");
+    if (await exists(registryFile)) {
+        return {
+            workspace,
+            manifest: await legacyProjectGraph(workspace),
+            source: "legacy_registry",
+            diagnostics: [
+                issue("project_graph_missing_legacy_registry_used", "Project graph manifest is missing; derived canvas graph from legacy desktop canvas registry.", "project-graph.json")
+            ]
+        };
+    }
+    return {
+        workspace,
+        manifest: await defaultProjectGraph(workspace),
+        source: "legacy_default_canvas",
+        diagnostics: [
+            issue("project_graph_missing_default_canvas_used", "Project graph manifest is missing; derived canvas graph from the default package workspace.", "project-graph.json")
+        ]
+    };
+}
+export async function loadProjectGraph(projectRoot) {
+    return loadProjectGraphForWorkspace(await resolveProjectWorkspace(projectRoot));
+}
+export async function writeProjectGraph(workspace, manifest) {
+    const parsed = projectGraphManifestSchema.parse(manifest);
+    await writeJsonFile(projectGraphPath(workspace), parsed);
+    return parsed;
+}
+//# sourceMappingURL=loadProjectGraph.js.map

package/dist/projectGraph/loadProjectGraph.js.map

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

package/dist/projectGraph/materializeProjectGraph.d.ts

@@ -0,0 +1,9 @@
+import type { ProjectGraphSource } from "./types.js";
+export type MaterializeProjectGraphResult = {
+    path: string;
+    created: boolean;
+    source: ProjectGraphSource;
+    canvasCount: number;
+};
+export declare function materializeProjectGraph(projectRoot: string): Promise<MaterializeProjectGraphResult>;
+//# sourceMappingURL=materializeProjectGraph.d.ts.map

package/dist/projectGraph/materializeProjectGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializeProjectGraph.d.ts","sourceRoot":"","sources":["../../src/projectGraph/materializeProjectGraph.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,6BAA6B,GAAG;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAWF,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAmBzG"}

package/dist/projectGraph/materializeProjectGraph.js

@@ -0,0 +1,35 @@
+import { constants } from "node:fs";
+import { access } from "node:fs/promises";
+import { loadProjectGraph } from "./loadProjectGraph.js";
+import { projectGraphPath, writeProjectGraph } from "./loadProjectGraph.js";
+import { resolveProjectWorkspace } from "../project.js";
+async function assertInitializedWorkspace(projectRoot) {
+    const workspace = await resolveProjectWorkspace(projectRoot);
+    try {
+        await Promise.all([access(workspace.projectFile, constants.R_OK), access(workspace.manifestFile, constants.R_OK), access(workspace.stateFile, constants.R_OK)]);
+    }
+    catch {
+        throw new Error(`PlanWeave workspace has not been initialized. Run 'planweave init --project-graph --json' first.`);
+    }
+}
+export async function materializeProjectGraph(projectRoot) {
+    await assertInitializedWorkspace(projectRoot);
+    const loaded = await loadProjectGraph(projectRoot);
+    const path = projectGraphPath(loaded.workspace);
+    if (loaded.source === "project_graph") {
+        return {
+            path,
+            created: false,
+            source: loaded.source,
+            canvasCount: loaded.manifest.canvases.length
+        };
+    }
+    await writeProjectGraph(loaded.workspace, loaded.manifest);
+    return {
+        path,
+        created: true,
+        source: loaded.source,
+        canvasCount: loaded.manifest.canvases.length
+    };
+}
+//# sourceMappingURL=materializeProjectGraph.js.map

package/dist/projectGraph/materializeProjectGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializeProjectGraph.js","sourceRoot":"","sources":["../../src/projectGraph/materializeProjectGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAUxD,KAAK,UAAU,0BAA0B,CAAC,WAAmB;IAC3D,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,WAAW,CAAC,CAAC;IAC7D,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClK,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,kGAAkG,CAAC,CAAC;IACtH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,WAAmB;IAC/D,MAAM,0BAA0B,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,MAAM,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;QACtC,OAAO;YACL,IAAI;YACJ,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM;SAC7C,CAAC;IACJ,CAAC;IACD,MAAM,iBAAiB,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3D,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM;KAC7C,CAAC;AACJ,CAAC"}

package/dist/projectGraph/migration.d.ts

@@ -0,0 +1,6 @@
+import type { ProjectWorkspace } from "../types.js";
+import type { TaskCanvasRegistry } from "../desktop/canvasRegistry.js";
+import type { ProjectGraphManifest } from "./types.js";
+export declare function projectGraphFromLegacyRegistry(registry: TaskCanvasRegistry): ProjectGraphManifest;
+export declare function defaultCanvasProjectGraph(workspace: ProjectWorkspace, title: string): ProjectGraphManifest;
+//# sourceMappingURL=migration.d.ts.map

package/dist/projectGraph/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/projectGraph/migration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAUvD,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,kBAAkB,GAAG,oBAAoB,CAcjG;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAgB1G"}

package/dist/projectGraph/migration.js

@@ -0,0 +1,41 @@
+import { isAbsolute, relative } from "node:path";
+import { supportedProjectGraphVersion } from "./types.js";
+function toWorkspaceRelative(workspace, path) {
+    if (!isAbsolute(path)) {
+        return path.split("\\").join("/");
+    }
+    return relative(workspace.workspaceRoot, path).split("\\").join("/");
+}
+export function projectGraphFromLegacyRegistry(registry) {
+    return {
+        version: supportedProjectGraphVersion,
+        canvases: registry.canvases.map((canvas) => ({
+            id: canvas.canvasId,
+            type: "canvas",
+            title: canvas.name,
+            packageDir: canvas.packageDir,
+            stateFile: canvas.stateFile,
+            resultsDir: canvas.resultsDir
+        })),
+        edges: [],
+        crossTaskEdges: []
+    };
+}
+export function defaultCanvasProjectGraph(workspace, title) {
+    return {
+        version: supportedProjectGraphVersion,
+        canvases: [
+            {
+                id: "default",
+                type: "canvas",
+                title,
+                packageDir: toWorkspaceRelative(workspace, workspace.packageDir),
+                stateFile: toWorkspaceRelative(workspace, workspace.stateFile),
+                resultsDir: toWorkspaceRelative(workspace, workspace.resultsDir)
+            }
+        ],
+        edges: [],
+        crossTaskEdges: []
+    };
+}
+//# sourceMappingURL=migration.js.map

package/dist/projectGraph/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["../../src/projectGraph/migration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAIjD,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE1D,SAAS,mBAAmB,CAAC,SAA2B,EAAE,IAAY;IACpE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,QAA4B;IACzE,OAAO;QACL,OAAO,EAAE,4BAA4B;QACrC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC3C,EAAE,EAAE,MAAM,CAAC,QAAQ;YACnB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,MAAM,CAAC,IAAI;YAClB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC,CAAC;QACH,KAAK,EAAE,EAAE;QACT,cAAc,EAAE,EAAE;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,SAA2B,EAAE,KAAa;IAClF,OAAO;QACL,OAAO,EAAE,4BAA4B;QACrC,QAAQ,EAAE;YACR;gBACE,EAAE,EAAE,SAAS;gBACb,IAAI,EAAE,QAAQ;gBACd,KAAK;gBACL,UAAU,EAAE,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC;gBAChE,SAAS,EAAE,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC;gBAC9D,UAAU,EAAE,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC;aACjE;SACF;QACD,KAAK,EAAE,EAAE;QACT,cAAc,EAAE,EAAE;KACnB,CAAC;AACJ,CAAC"}

package/dist/projectGraph/projectGraphKeys.d.ts

@@ -0,0 +1,6 @@
+import type { ProjectCanvasEdge, ProjectCrossTaskEdge, ProjectTaskRef, ProjectTaskRefString } from "./types.js";
+export declare function projectTaskRefKey(ref: ProjectTaskRef): ProjectTaskRefString;
+export declare function parseProjectTaskRefKey(ref: ProjectTaskRefString): ProjectTaskRef;
+export declare function projectCanvasEdgeKey(edge: ProjectCanvasEdge): string;
+export declare function projectCrossTaskEdgeKey(edge: ProjectCrossTaskEdge): string;
+//# sourceMappingURL=projectGraphKeys.d.ts.map

package/dist/projectGraph/projectGraphKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectGraphKeys.d.ts","sourceRoot":"","sources":["../../src/projectGraph/projectGraphKeys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEhH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,oBAAoB,CAE3E;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,oBAAoB,GAAG,cAAc,CAShF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAEpE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAE1E"}

package/dist/projectGraph/projectGraphKeys.js

@@ -0,0 +1,20 @@
+export function projectTaskRefKey(ref) {
+    return `${ref.canvasId}::${ref.taskId}`;
+}
+export function parseProjectTaskRefKey(ref) {
+    const separator = ref.indexOf("::");
+    if (separator <= 0 || separator === ref.length - 2) {
+        throw new Error(`Invalid project task ref '${ref}'. Expected '<canvas-id>::<task-id>'.`);
+    }
+    return {
+        canvasId: ref.slice(0, separator),
+        taskId: ref.slice(separator + 2)
+    };
+}
+export function projectCanvasEdgeKey(edge) {
+    return `${edge.from}\u0000${edge.type}\u0000${edge.to}`;
+}
+export function projectCrossTaskEdgeKey(edge) {
+    return `${projectTaskRefKey(edge.from)}\u0000${edge.type}\u0000${projectTaskRefKey(edge.to)}`;
+}
+//# sourceMappingURL=projectGraphKeys.js.map

package/dist/projectGraph/projectGraphKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectGraphKeys.js","sourceRoot":"","sources":["../../src/projectGraph/projectGraphKeys.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,GAAmB;IACnD,OAAO,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAyB;IAC9D,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,uCAAuC,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;QACjC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAuB;IAC1D,OAAO,GAAG,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAA0B;IAChE,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,SAAS,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AAChG,CAAC"}

package/dist/projectGraph/projectGraphWorkspace.d.ts

@@ -0,0 +1,5 @@
+import type { ProjectCanvasNode } from "./types.js";
+import type { ProjectWorkspace } from "../types.js";
+export declare function projectCanvasWorkspace(projectWorkspace: ProjectWorkspace, canvas: ProjectCanvasNode): ProjectWorkspace;
+export declare function resolveProjectCanvasWorkspace(projectRoot: string, canvasId: string): Promise<ProjectWorkspace>;
+//# sourceMappingURL=projectGraphWorkspace.d.ts.map

package/dist/projectGraph/projectGraphWorkspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectGraphWorkspace.d.ts","sourceRoot":"","sources":["../../src/projectGraph/projectGraphWorkspace.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAepD,wBAAgB,sBAAsB,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,GAAG,gBAAgB,CAetH;AAED,wBAAsB,6BAA6B,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAOpH"}

package/dist/projectGraph/projectGraphWorkspace.js

@@ -0,0 +1,38 @@
+import { dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { loadProjectGraph } from "./loadProjectGraph.js";
+function fromWorkspaceRelative(workspace, path) {
+    return isAbsolute(path) ? path : join(workspace.workspaceRoot, path);
+}
+function assertWorkspaceChild(projectWorkspace, path) {
+    const workspaceRoot = resolve(projectWorkspace.workspaceRoot);
+    const target = resolve(path);
+    const relativeTarget = relative(workspaceRoot, target);
+    if (!relativeTarget || relativeTarget.startsWith("..") || isAbsolute(relativeTarget)) {
+        throw new Error(`Project canvas path '${path}' is outside the PlanWeave workspace.`);
+    }
+}
+export function projectCanvasWorkspace(projectWorkspace, canvas) {
+    const packageDir = fromWorkspaceRelative(projectWorkspace, canvas.packageDir);
+    const stateFile = fromWorkspaceRelative(projectWorkspace, canvas.stateFile);
+    const resultsDir = fromWorkspaceRelative(projectWorkspace, canvas.resultsDir);
+    assertWorkspaceChild(projectWorkspace, packageDir);
+    assertWorkspaceChild(projectWorkspace, stateFile);
+    assertWorkspaceChild(projectWorkspace, resultsDir);
+    return {
+        ...projectWorkspace,
+        workspaceRoot: canvas.id === "default" ? projectWorkspace.workspaceRoot : dirname(packageDir),
+        packageDir,
+        manifestFile: join(packageDir, "manifest.json"),
+        stateFile,
+        resultsDir
+    };
+}
+export async function resolveProjectCanvasWorkspace(projectRoot, canvasId) {
+    const { workspace, manifest } = await loadProjectGraph(projectRoot);
+    const canvas = manifest.canvases.find((candidate) => candidate.id === canvasId);
+    if (!canvas) {
+        throw new Error(`Project canvas '${canvasId}' does not exist.`);
+    }
+    return projectCanvasWorkspace(workspace, canvas);
+}
+//# sourceMappingURL=projectGraphWorkspace.js.map

package/dist/projectGraph/projectGraphWorkspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectGraphWorkspace.js","sourceRoot":"","sources":["../../src/projectGraph/projectGraphWorkspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAIzD,SAAS,qBAAqB,CAAC,SAA2B,EAAE,IAAY;IACtE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,oBAAoB,CAAC,gBAAkC,EAAE,IAAY;IAC5E,MAAM,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,cAAc,GAAG,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACvD,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,uCAAuC,CAAC,CAAC;IACvF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,gBAAkC,EAAE,MAAyB;IAClG,MAAM,UAAU,GAAG,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9E,MAAM,SAAS,GAAG,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5E,MAAM,UAAU,GAAG,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9E,oBAAoB,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IACnD,oBAAoB,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;IAClD,oBAAoB,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IACnD,OAAO;QACL,GAAG,gBAAgB;QACnB,aAAa,EAAE,MAAM,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QAC7F,UAAU;QACV,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC;QAC/C,SAAS;QACT,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,WAAmB,EAAE,QAAgB;IACvF,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAChF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,mBAAmB,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,sBAAsB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACnD,CAAC"}

package/dist/projectGraph/runtimeAggregation.d.ts

@@ -0,0 +1,30 @@
+import type { ProjectWorkspace, TaskStatus, ValidationIssue } from "../types.js";
+import type { CompiledProjectGraph, LoadedProjectGraph, ProjectCanvasNode } from "./types.js";
+export type ProjectCanvasRuntimeSnapshot = {
+    taskCount: number;
+    taskStatusById: Map<string, TaskStatus>;
+    complete: boolean;
+};
+export type ProjectCanvasRuntimeContext = {
+    canvasId: string;
+    canvasName: string;
+    projectCanvas: ProjectCanvasNode;
+    runtimeSnapshot: ProjectCanvasRuntimeSnapshot;
+    workspace: ProjectWorkspace;
+};
+export type ProjectCanvasRuntimeAggregationContext = {
+    loaded: LoadedProjectGraph;
+    graph: CompiledProjectGraph;
+    orderedCanvasIds: string[];
+    canvases: ProjectCanvasRuntimeContext[];
+    canvasesById: Map<string, ProjectCanvasRuntimeContext>;
+    runtimeSnapshotsByCanvas: Map<string, ProjectCanvasRuntimeSnapshot>;
+    notes: string[];
+};
+export declare function projectGraphDiagnosticNote(diagnostic: ValidationIssue): string;
+export declare function projectCanvasExecutionOrder(graph: CompiledProjectGraph): string[];
+export declare function loadProjectCanvasRuntimeAggregation(projectRootOrWorkspace: string | ProjectWorkspace): Promise<ProjectCanvasRuntimeAggregationContext>;
+export declare function projectBlockersForTask(context: ProjectCanvasRuntimeAggregationContext, canvasId: string, taskId: string): string[];
+export declare function projectBlockerReasonForTask(context: ProjectCanvasRuntimeAggregationContext, canvasId: string, taskId: string): string | null;
+export declare function currentProjectCanvasForWorkspace(context: ProjectCanvasRuntimeAggregationContext, workspace: ProjectWorkspace): ProjectCanvasRuntimeContext | null;
+//# sourceMappingURL=runtimeAggregation.d.ts.map

package/dist/projectGraph/runtimeAggregation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeAggregation.d.ts","sourceRoot":"","sources":["../../src/projectGraph/runtimeAggregation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAIjF,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,iBAAiB,EAAkB,MAAM,YAAY,CAAC;AAE9G,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,iBAAiB,CAAC;IACjC,eAAe,EAAE,4BAA4B,CAAC;IAC9C,SAAS,EAAE,gBAAgB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,sCAAsC,GAAG;IACnD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,oBAAoB,CAAC;IAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,2BAA2B,EAAE,CAAC;IACxC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IACvD,wBAAwB,EAAE,GAAG,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;IACpE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAUF,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAE9E;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAyBjF;AAkBD,wBAAsB,mCAAmC,CACvD,sBAAsB,EAAE,MAAM,GAAG,gBAAgB,GAChD,OAAO,CAAC,sCAAsC,CAAC,CA+CjD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,sCAAsC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAUlI;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,sCAAsC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG5I;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,sCAAsC,EAC/C,SAAS,EAAE,gBAAgB,GAC1B,2BAA2B,GAAG,IAAI,CAQpC"}

package/dist/projectGraph/runtimeAggregation.js

@@ -0,0 +1,128 @@
+import { resolve } from "node:path";
+import { compileTaskGraph } from "../graph/compileTaskGraph.js";
+import { loadPackage } from "../package/loadPackage.js";
+import { ensureStateForManifest, readState } from "../state.js";
+import { compileProjectGraph } from "./compileProjectGraph.js";
+import { loadProjectGraph, loadProjectGraphForWorkspace } from "./loadProjectGraph.js";
+import { projectCanvasWorkspace } from "./projectGraphWorkspace.js";
+function emptyRuntimeSnapshot() {
+    return {
+        taskCount: 0,
+        taskStatusById: new Map(),
+        complete: false
+    };
+}
+export function projectGraphDiagnosticNote(diagnostic) {
+    return `${diagnostic.code}${diagnostic.path ? ` [${diagnostic.path}]` : ""}: ${diagnostic.message}`;
+}
+export function projectCanvasExecutionOrder(graph) {
+    const visited = new Set();
+    const visiting = new Set();
+    const ordered = [];
+    const visit = (canvasId) => {
+        if (visited.has(canvasId)) {
+            return;
+        }
+        if (visiting.has(canvasId)) {
+            return;
+        }
+        visiting.add(canvasId);
+        for (const dependency of graph.canvasDependenciesByCanvas.get(canvasId) ?? []) {
+            visit(dependency);
+        }
+        visiting.delete(canvasId);
+        visited.add(canvasId);
+        ordered.push(canvasId);
+    };
+    for (const canvasId of graph.canvasIdsInOrder) {
+        visit(canvasId);
+    }
+    return ordered;
+}
+function taskRefLabel(ref) {
+    return `${ref.canvasId}:${ref.taskId}`;
+}
+async function canvasRuntimeSnapshot(workspace) {
+    const { manifest } = await loadPackage(workspace);
+    const graph = compileTaskGraph(manifest);
+    const state = ensureStateForManifest(manifest, await readState(workspace.stateFile));
+    const taskStatusById = new Map(graph.taskNodesInManifestOrder.map((taskId) => [taskId, state.tasks[taskId]?.status ?? "planned"]));
+    return {
+        taskCount: graph.taskNodesInManifestOrder.length,
+        taskStatusById,
+        complete: graph.taskNodesInManifestOrder.every((taskId) => state.tasks[taskId]?.status === "implemented")
+    };
+}
+export async function loadProjectCanvasRuntimeAggregation(projectRootOrWorkspace) {
+    const loaded = typeof projectRootOrWorkspace === "string"
+        ? await loadProjectGraph(projectRootOrWorkspace)
+        : await loadProjectGraphForWorkspace(projectRootOrWorkspace);
+    const graph = await compileProjectGraph(loaded);
+    const orderedCanvasIds = projectCanvasExecutionOrder(graph);
+    const notes = [
+        "Project graph dependencies gate ready queues; canvases without upstream blockers may run in parallel.",
+        ...graph.diagnostics.warnings.map((warning) => `Warning: ${projectGraphDiagnosticNote(warning)}`),
+        ...graph.diagnostics.errors.map((error) => `Error: ${projectGraphDiagnosticNote(error)}`)
+    ];
+    const canvases = [];
+    const canvasesById = new Map();
+    const runtimeSnapshotsByCanvas = new Map();
+    for (const canvasId of orderedCanvasIds) {
+        const projectCanvas = graph.canvasesById.get(canvasId);
+        if (!projectCanvas) {
+            continue;
+        }
+        let workspace;
+        try {
+            workspace = projectCanvasWorkspace(loaded.workspace, projectCanvas);
+        }
+        catch (caught) {
+            notes.push(`Error: ${canvasId}: ${caught instanceof Error ? caught.message : String(caught)}`);
+            runtimeSnapshotsByCanvas.set(canvasId, emptyRuntimeSnapshot());
+            continue;
+        }
+        let runtimeSnapshot = emptyRuntimeSnapshot();
+        try {
+            runtimeSnapshot = await canvasRuntimeSnapshot(workspace);
+        }
+        catch (caught) {
+            notes.push(`Error: ${canvasId}: ${caught instanceof Error ? caught.message : String(caught)}`);
+        }
+        const context = {
+            canvasId,
+            canvasName: projectCanvas.title,
+            projectCanvas,
+            runtimeSnapshot,
+            workspace
+        };
+        canvases.push(context);
+        canvasesById.set(canvasId, context);
+        runtimeSnapshotsByCanvas.set(canvasId, runtimeSnapshot);
+    }
+    return { loaded, graph, orderedCanvasIds, canvases, canvasesById, runtimeSnapshotsByCanvas, notes };
+}
+export function projectBlockersForTask(context, canvasId, taskId) {
+    const canvasBlockers = (context.graph.canvasDependenciesByCanvas.get(canvasId) ?? [])
+        .filter((dependencyCanvasId) => !(context.runtimeSnapshotsByCanvas.get(dependencyCanvasId)?.complete ?? false))
+        .map((dependencyCanvasId) => `canvas:${dependencyCanvasId}`);
+    const taskBlockers = context.graph
+        .crossTaskDependencies({ canvasId, taskId })
+        .filter((dependency) => dependency.canvasId !== canvasId)
+        .filter((dependency) => context.runtimeSnapshotsByCanvas.get(dependency.canvasId)?.taskStatusById.get(dependency.taskId) !== "implemented")
+        .map(taskRefLabel);
+    return Array.from(new Set([...canvasBlockers, ...taskBlockers]));
+}
+export function projectBlockerReasonForTask(context, canvasId, taskId) {
+    const blockers = projectBlockersForTask(context, canvasId, taskId);
+    return blockers.length > 0 ? `Project graph blockers are not complete: ${blockers.join(", ")}.` : null;
+}
+export function currentProjectCanvasForWorkspace(context, workspace) {
+    for (const canvasId of context.graph.canvasIdsInOrder) {
+        const canvas = context.canvasesById.get(canvasId);
+        if (canvas && resolve(canvas.workspace.packageDir) === resolve(workspace.packageDir)) {
+            return canvas;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=runtimeAggregation.js.map

package/dist/projectGraph/runtimeAggregation.js.map

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

package/dist/projectGraph/schema.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+export declare const projectGraphManifestSchema: z.ZodObject<{
+    version: z.ZodLiteral<"plan-project/v1">;
+    canvases: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"canvas">;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        packageDir: z.ZodString;
+        stateFile: z.ZodString;
+        resultsDir: z.ZodString;
+    }, z.core.$strict>>;
+    edges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        type: z.ZodEnum<{
+            depends_on: "depends_on";
+        }>;
+    }, z.core.$strict>>>;
+    crossTaskEdges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        from: z.ZodObject<{
+            canvasId: z.ZodString;
+            taskId: z.ZodString;
+        }, z.core.$strict>;
+        to: z.ZodObject<{
+            canvasId: z.ZodString;
+            taskId: z.ZodString;
+        }, z.core.$strict>;
+        type: z.ZodEnum<{
+            depends_on: "depends_on";
+        }>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type ParsedProjectGraphManifest = z.infer<typeof projectGraphManifestSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/projectGraph/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/projectGraph/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2CxB,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAO5B,CAAC;AAEZ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/projectGraph/schema.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { projectGraphEdgeTypes, supportedProjectGraphVersion } from "./types.js";
+const canvasIdSchema = z
+    .string()
+    .min(1)
+    .regex(/^[A-Za-z0-9][A-Za-z0-9._-]*$/, "Canvas id must be CLI-safe: start with a letter or number, then use only letters, numbers, dots, underscores, or hyphens.");
+const projectTaskRefSchema = z
+    .object({
+    canvasId: canvasIdSchema,
+    taskId: z.string().min(1)
+})
+    .strict();
+const projectCanvasNodeSchema = z
+    .object({
+    id: canvasIdSchema,
+    type: z.literal("canvas"),
+    title: z.string().min(1),
+    description: z.string().optional(),
+    packageDir: z.string().min(1),
+    stateFile: z.string().min(1),
+    resultsDir: z.string().min(1)
+})
+    .strict();
+const projectCanvasEdgeSchema = z
+    .object({
+    from: canvasIdSchema,
+    to: canvasIdSchema,
+    type: z.enum(projectGraphEdgeTypes)
+})
+    .strict();
+const projectCrossTaskEdgeSchema = z
+    .object({
+    from: projectTaskRefSchema,
+    to: projectTaskRefSchema,
+    type: z.enum(projectGraphEdgeTypes)
+})
+    .strict();
+export const projectGraphManifestSchema = z
+    .object({
+    version: z.literal(supportedProjectGraphVersion),
+    canvases: z.array(projectCanvasNodeSchema).min(1),
+    edges: z.array(projectCanvasEdgeSchema).default([]),
+    crossTaskEdges: z.array(projectCrossTaskEdgeSchema).default([])
+})
+    .strict();
+//# sourceMappingURL=schema.js.map

package/dist/projectGraph/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/projectGraph/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAEjF,MAAM,cAAc,GAAG,CAAC;KACrB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,KAAK,CAAC,8BAA8B,EAAE,2HAA2H,CAAC,CAAC;AAEtK,MAAM,oBAAoB,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1B,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,uBAAuB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9B,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,uBAAuB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,IAAI,EAAE,cAAc;IACpB,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC;CACpC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,0BAA0B,GAAG,CAAC;KACjC,MAAM,CAAC;IACN,IAAI,EAAE,oBAAoB;IAC1B,EAAE,EAAE,oBAAoB;IACxB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC;CACpC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,4BAA4B,CAAC;IAChD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAChE,CAAC;KACD,MAAM,EAAE,CAAC"}