@webpieces/nx-webpieces-rules 0.4.970 → 0.4.972

package/src/executors/visualize-runtime-goal/executor.d.ts

@@ -1,27 +0,0 @@
-/**
- * Visualize Runtime Goal Executor (#1239)
- *
- * Renders the hand-authored runtime PROPOSAL, architecture/runtime-dependencies-goal.json, with the
- * same shared runtime renderer as visualize-runtime, into its own files:
- * tmp/webpieces/runtime-architecture-goal.{dot,html}. It never generates anything from source first,
- * never writes either JSON input, and never overwrites the current page.
- *
- * The page carries Goal vs Current when the saved current graph is usable; otherwise that mode says
- * why. A missing goal fails with its expected path and how to start one — the current graph is never
- * rendered in its place.
- *
- * `--prepare` is the one explicit, WRITING step: it recomputes the goal's derived levels, self-queue
- * flags, contract queues and maxLevel with the generator's own level machinery, saves the goal, and
- * then views it.
- *
- * Usage: nx run architecture:visualize-runtime-goal [--prepare]
- */
-import type { ExecutorContext } from '@nx/devkit';
-export interface VisualizeRuntimeGoalOptions {
-    /** Recompute and SAVE the goal's derived levels before viewing. Viewing alone never writes. */
-    prepare?: boolean;
-}
-export interface ExecutorResult {
-    success: boolean;
-}
-export default function runExecutor(options: VisualizeRuntimeGoalOptions, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/visualize-runtime-goal/executor.js

@@ -1,99 +0,0 @@
-"use strict";
-/**
- * Visualize Runtime Goal Executor (#1239)
- *
- * Renders the hand-authored runtime PROPOSAL, architecture/runtime-dependencies-goal.json, with the
- * same shared runtime renderer as visualize-runtime, into its own files:
- * tmp/webpieces/runtime-architecture-goal.{dot,html}. It never generates anything from source first,
- * never writes either JSON input, and never overwrites the current page.
- *
- * The page carries Goal vs Current when the saved current graph is usable; otherwise that mode says
- * why. A missing goal fails with its expected path and how to start one — the current graph is never
- * rendered in its place.
- *
- * `--prepare` is the one explicit, WRITING step: it recomputes the goal's derived levels, self-queue
- * flags, contract queues and maxLevel with the generator's own level machinery, saves the goal, and
- * then views it.
- *
- * Usage: nx run architecture:visualize-runtime-goal [--prepare]
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = runExecutor;
-const tslib_1 = require("tslib");
-const fs = tslib_1.__importStar(require("fs"));
-const path = tslib_1.__importStar(require("path"));
-const rules_config_1 = require("@webpieces/rules-config");
-const graph_loader_1 = require("../../lib/graph-loader");
-const graph_impact_1 = require("../../lib/graph-impact");
-const graph_edge_diff_1 = require("../../lib/graph-edge-diff");
-const saved_snapshot_1 = require("../../lib/saved-snapshot");
-const runtime_visualizer_1 = require("../../lib/runtime-visualizer");
-const runtime_config_1 = require("../../lib/runtime-config");
-const graph_visualizer_1 = require("../../lib/graph-visualizer");
-const runtime_goal_view_1 = require("../../lib/runtime-goal-view");
-const runtime_goal_file_1 = require("../../lib/runtime-goal-file");
-const toError_1 = require("../../toError");
-// webpieces-disable no-function-outside-class -- Nx executor entry point: Nx requires a default-exported function
-async function runExecutor(options, context) {
-    const workspaceRoot = context.root;
-    const goalFile = new runtime_goal_file_1.RuntimeGoalFile();
-    const snapshot = new saved_snapshot_1.SavedSnapshot();
-    console.log('\n🎯 Runtime Goal Visualization\n');
-    console.log(new runtime_goal_file_1.RuntimeGoalProvenance().message());
-    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- Nx command rendering boundary; success:false propagates failure to Nx
-    try {
-        const goal = options.prepare === true ? prepared(goalFile, workspaceRoot) : goalFile.load(workspaceRoot);
-        reportDrift(goalFile, goal);
-        const config = (0, runtime_config_1.loadRuntimeConfig)(workspaceRoot);
-        const projects = fs.existsSync(path.join(workspaceRoot, graph_loader_1.DEFAULT_GRAPH_PATH)) ? snapshot.loadProjects(workspaceRoot, graph_loader_1.DEFAULT_GRAPH_PATH).projects : null;
-        const vizOptions = new runtime_visualizer_1.RuntimeVizOptions(config.showExternalNodes, projects, workspaceRoot, runtime_visualizer_1.RuntimePageKind.GOAL);
-        const inputs = new runtime_goal_view_1.RuntimeComparisonInputs(snapshot, goalFile);
-        const comparison = inputs.view(inputs.current(workspaceRoot), goal, vizOptions);
-        console.log(comparison.available ? `Goal vs Current: ${comparison.summary}` : `Goal vs Current unavailable: ${comparison.reason}`);
-        const vizPaths = (0, runtime_visualizer_1.writeRuntimeVisualization)(goal, workspaceRoot, 'Goal / Proposed Runtime Architecture', vizOptions, comparison);
-        console.log(`✅ Generated: ${vizPaths.dotPath}`);
-        console.log(`✅ Generated: ${vizPaths.htmlPath}`);
-        if (projects !== null)
-            console.log(await new graph_impact_1.ImpactRefresh().run(path.dirname(vizPaths.htmlPath), workspaceRoot, projects, graph_impact_1.VISUALIZE_IMPACT_KINDS, new graph_edge_diff_1.LiveGraphSource()));
-        else {
-            new graph_impact_1.ImpactSidecar().remove(path.dirname(vizPaths.htmlPath));
-            console.log('Impact and framework metadata unavailable: no saved project graph. Proposed services carry their goal facts only.');
-        }
-        console.log('\n🌐 Opening visualization in browser...');
-        if (new graph_visualizer_1.GraphVisualizer().openVisualization(vizPaths.htmlPath))
-            console.log('✅ Browser opened');
-        else
-            console.log(`⚠️  Could not auto-open. Open manually: ${vizPaths.htmlPath}`);
-        return { success: true };
-    }
-    catch (err) {
-        const error = (0, toError_1.toError)(err);
-        const rendered = error instanceof rules_config_1.RuleFailError ? (0, rules_config_1.renderRuleFailForHuman)(error) : error.message;
-        console.error(`❌ Runtime goal visualization failed for ${goalFile.goalPath}:`, rendered);
-        return { success: false };
-    }
-}
-// webpieces-disable no-function-outside-class -- executor step helper, sibling of runExecutor
-function prepared(goalFile, workspaceRoot) {
-    const preparation = goalFile.prepare(workspaceRoot);
-    if (!preparation.written)
-        console.log(`✅ ${goalFile.goalPath} derived facts already consistent; nothing written.`);
-    else if (preparation.changes.length === 0)
-        console.log(`✍️  Prepared ${goalFile.goalPath}: rewrote explanatory levelBecause text only.`);
-    else
-        console.log(`✍️  Prepared ${goalFile.goalPath}:\n  ${preparation.changes.join('\n  ')}`);
-    return preparation.graph;
-}
-// webpieces-disable no-function-outside-class -- executor step helper, sibling of runExecutor
-function reportDrift(goalFile, goal) {
-    const drift = goalFile.drift(goal);
-    if (drift.cycle !== null) {
-        console.warn(`⚠️  ${drift.cycle}\n  Rendered with its saved levels. ${goalFile.cycleOption().text}`);
-        return;
-    }
-    if (drift.differences.length === 0)
-        return;
-    console.warn(`⚠️  ${goalFile.goalPath} saves derived facts that disagree with its relationships (rendered as saved):\n  ` +
-        `${drift.differences.join('\n  ')}\n  Recompute them explicitly: ${runtime_goal_file_1.RUNTIME_GOAL_PREPARE_COMMAND}`);
-}
-//# sourceMappingURL=executor.js.map

package/src/executors/visualize-runtime-goal/executor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/visualize-runtime-goal/executor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Visualize Runtime Goal Executor (#1239)\n *\n * Renders the hand-authored runtime PROPOSAL, architecture/runtime-dependencies-goal.json, with the\n * same shared runtime renderer as visualize-runtime, into its own files:\n * tmp/webpieces/runtime-architecture-goal.{dot,html}. It never generates anything from source first,\n * never writes either JSON input, and never overwrites the current page.\n *\n * The page carries Goal vs Current when the saved current graph is usable; otherwise that mode says\n * why. A missing goal fails with its expected path and how to start one — the current graph is never\n * rendered in its place.\n *\n * `--prepare` is the one explicit, WRITING step: it recomputes the goal's derived levels, self-queue\n * flags, contract queues and maxLevel with the generator's own level machinery, saves the goal, and\n * then views it.\n *\n * Usage: nx run architecture:visualize-runtime-goal [--prepare]\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport type { ExecutorContext } from '@nx/devkit';\nimport { RuleFailError, renderRuleFailForHuman } from '@webpieces/rules-config';\nimport { DEFAULT_GRAPH_PATH } from '../../lib/graph-loader';\nimport { ImpactRefresh, ImpactSidecar, VISUALIZE_IMPACT_KINDS } from '../../lib/graph-impact';\nimport { LiveGraphSource } from '../../lib/graph-edge-diff';\nimport { SavedSnapshot } from '../../lib/saved-snapshot';\nimport { writeRuntimeVisualization, RuntimeVizOptions, RuntimePageKind } from '../../lib/runtime-visualizer';\nimport { loadRuntimeConfig } from '../../lib/runtime-config';\nimport { GraphVisualizer } from '../../lib/graph-visualizer';\nimport { RuntimeComparisonInputs } from '../../lib/runtime-goal-view';\nimport { RuntimeGoalFile, RuntimeGoalProvenance, RUNTIME_GOAL_PREPARE_COMMAND } from '../../lib/runtime-goal-file';\nimport type { RuntimeGraph } from '../../lib/runtime-graph-model';\nimport { toError } from '../../toError';\n\nexport interface VisualizeRuntimeGoalOptions {\n    /** Recompute and SAVE the goal's derived levels before viewing. Viewing alone never writes. */\n    prepare?: boolean;\n}\n\nexport interface ExecutorResult {\n    success: boolean;\n}\n\n// webpieces-disable no-function-outside-class -- Nx executor entry point: Nx requires a default-exported function\nexport default async function runExecutor(\n    options: VisualizeRuntimeGoalOptions,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    const workspaceRoot = context.root;\n    const goalFile = new RuntimeGoalFile();\n    const snapshot = new SavedSnapshot();\n\n    console.log('\\n🎯 Runtime Goal Visualization\\n');\n    console.log(new RuntimeGoalProvenance().message());\n\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- Nx command rendering boundary; success:false propagates failure to Nx\n    try {\n        const goal = options.prepare === true ? prepared(goalFile, workspaceRoot) : goalFile.load(workspaceRoot);\n        reportDrift(goalFile, goal);\n        const config = loadRuntimeConfig(workspaceRoot);\n        const projects = fs.existsSync(path.join(workspaceRoot, DEFAULT_GRAPH_PATH)) ? snapshot.loadProjects(workspaceRoot, DEFAULT_GRAPH_PATH).projects : null;\n        const vizOptions = new RuntimeVizOptions(config.showExternalNodes, projects, workspaceRoot, RuntimePageKind.GOAL);\n        const inputs = new RuntimeComparisonInputs(snapshot, goalFile);\n        const comparison = inputs.view(inputs.current(workspaceRoot), goal, vizOptions);\n        console.log(comparison.available ? `Goal vs Current: ${comparison.summary}` : `Goal vs Current unavailable: ${comparison.reason}`);\n        const vizPaths = writeRuntimeVisualization(goal, workspaceRoot, 'Goal / Proposed Runtime Architecture', vizOptions, comparison);\n        console.log(`✅ Generated: ${vizPaths.dotPath}`);\n        console.log(`✅ Generated: ${vizPaths.htmlPath}`);\n        if (projects !== null) console.log(await new ImpactRefresh().run(path.dirname(vizPaths.htmlPath), workspaceRoot, projects, VISUALIZE_IMPACT_KINDS, new LiveGraphSource()));\n        else { new ImpactSidecar().remove(path.dirname(vizPaths.htmlPath)); console.log('Impact and framework metadata unavailable: no saved project graph. Proposed services carry their goal facts only.'); }\n\n        console.log('\\n🌐 Opening visualization in browser...');\n        if (new GraphVisualizer().openVisualization(vizPaths.htmlPath)) console.log('✅ Browser opened');\n        else console.log(`⚠️  Could not auto-open. Open manually: ${vizPaths.htmlPath}`);\n        return { success: true };\n    } catch (err: unknown) {\n        const error = toError(err);\n        const rendered = error instanceof RuleFailError ? renderRuleFailForHuman(error) : error.message;\n        console.error(`❌ Runtime goal visualization failed for ${goalFile.goalPath}:`, rendered);\n        return { success: false };\n    }\n}\n\n// webpieces-disable no-function-outside-class -- executor step helper, sibling of runExecutor\nfunction prepared(goalFile: RuntimeGoalFile, workspaceRoot: string): RuntimeGraph {\n    const preparation = goalFile.prepare(workspaceRoot);\n    if (!preparation.written) console.log(`✅ ${goalFile.goalPath} derived facts already consistent; nothing written.`);\n    else if (preparation.changes.length === 0) console.log(`✍️  Prepared ${goalFile.goalPath}: rewrote explanatory levelBecause text only.`);\n    else console.log(`✍️  Prepared ${goalFile.goalPath}:\\n  ${preparation.changes.join('\\n  ')}`);\n    return preparation.graph;\n}\n\n// webpieces-disable no-function-outside-class -- executor step helper, sibling of runExecutor\nfunction reportDrift(goalFile: RuntimeGoalFile, goal: RuntimeGraph): void {\n    const drift = goalFile.drift(goal);\n    if (drift.cycle !== null) {\n        console.warn(`⚠️  ${drift.cycle}\\n  Rendered with its saved levels. ${goalFile.cycleOption().text}`);\n        return;\n    }\n    if (drift.differences.length === 0) return;\n    console.warn(\n        `⚠️  ${goalFile.goalPath} saves derived facts that disagree with its relationships (rendered as saved):\\n  ` +\n            `${drift.differences.join('\\n  ')}\\n  Recompute them explicitly: ${RUNTIME_GOAL_PREPARE_COMMAND}`,\n    );\n}\n"]}

package/src/executors/visualize-runtime-goal/schema.json

@@ -1,13 +0,0 @@
-{
-    "$schema": "http://json-schema.org/schema",
-    "title": "Visualize Runtime Goal Executor",
-    "description": "View the hand-authored runtime goal (architecture/runtime-dependencies-goal.json) as DOT + HTML, with Goal vs Current. Viewing never writes; --prepare explicitly recomputes the goal's derived levels first.",
-    "type": "object",
-    "properties": {
-        "prepare": {
-            "type": "boolean",
-            "description": "Recompute and save the goal's derived levels, self-queue flags, contract queues and maxLevel before viewing."
-        }
-    },
-    "required": []
-}