businesslens 0.2.2

package/.output/server/node_modules/vue-router/package.json

@@ -0,0 +1,226 @@
+{
+  "name": "vue-router",
+  "version": "5.1.0",
+  "homepage": "https://router.vuejs.org",
+  "bugs": {
+    "url": "https://github.com/vuejs/router/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Eduardo San Martin Morote",
+    "email": "posva13@gmail.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vuejs/router.git"
+  },
+  "funding": "https://github.com/sponsors/posva",
+  "files": [
+    "dist",
+    "index.cjs",
+    "README.md",
+    "route.schema.json",
+    "vue-router-auto-resolver.d.mts",
+    "vue-router-auto-routes.d.mts",
+    "vue-router-auto.d.ts",
+    "vue-router.node.mjs",
+    "vetur/attributes.json",
+    "vetur/tags.json"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "index.cjs",
+  "module": "dist/vue-router.js",
+  "types": "dist/vue-router.d.ts",
+  "typesVersions": {
+    "*": {
+      "vite": [
+        "./dist/unplugin/vite.d.mts"
+      ],
+      "unplugin": [
+        "./dist/unplugin/index.d.mts"
+      ],
+      "unplugin/*": [
+        "./dist/unplugin/*.d.mts"
+      ],
+      "volar/*": [
+        "./dist/volar/*.d.cts"
+      ]
+    }
+  },
+  "unpkg": "dist/vue-router.global.js",
+  "jsdelivr": "dist/vue-router.global.js",
+  "exports": {
+    ".": {
+      "types": "./dist/vue-router.d.ts",
+      "node": {
+        "import": {
+          "production": "./vue-router.node.mjs",
+          "development": "./vue-router.node.mjs",
+          "default": "./vue-router.node.mjs"
+        },
+        "require": {
+          "production": "./dist/vue-router.prod.cjs",
+          "development": "./dist/vue-router.cjs",
+          "default": "./dist/vue-router.prod.cjs"
+        }
+      },
+      "import": "./dist/vue-router.js",
+      "require": "./index.cjs"
+    },
+    "./vetur/*": "./vetur/*",
+    "./package.json": "./package.json",
+    "./experimental": {
+      "types": "./dist/experimental/index.d.ts",
+      "import": "./dist/experimental/index.js"
+    },
+    "./experimental/pinia-colada": {
+      "types": "./dist/experimental/pinia-colada.d.ts",
+      "import": "./dist/experimental/pinia-colada.js"
+    },
+    "./auto-resolver": {
+      "types": "./vue-router-auto-resolver.d.mts"
+    },
+    "./auto-routes": {
+      "types": "./vue-router-auto-routes.d.mts"
+    },
+    "./auto": {
+      "types": "./vue-router-auto.d.ts",
+      "node": {
+        "import": {
+          "production": "./vue-router.node.mjs",
+          "development": "./vue-router.node.mjs",
+          "default": "./vue-router.node.mjs"
+        },
+        "require": {
+          "production": "./dist/vue-router.prod.cjs",
+          "development": "./dist/vue-router.cjs",
+          "default": "./dist/vue-router.prod.cjs"
+        }
+      },
+      "import": "./dist/vue-router.js",
+      "require": "./index.cjs"
+    },
+    "./vite": {
+      "types": "./dist/unplugin/vite.d.mts",
+      "import": "./dist/unplugin/vite.mjs",
+      "require": "./dist/unplugin/vite.cjs"
+    },
+    "./unplugin": {
+      "types": "./dist/unplugin/index.d.mts",
+      "import": "./dist/unplugin/index.mjs",
+      "require": "./dist/unplugin/index.cjs"
+    },
+    "./unplugin/*": "./dist/unplugin/*",
+    "./volar/sfc-route-blocks": {
+      "types": "./dist/volar/sfc-route-blocks.d.cts",
+      "default": "./dist/volar/sfc-route-blocks.cjs"
+    },
+    "./volar/sfc-typed-router": {
+      "types": "./dist/volar/sfc-typed-router.d.cts",
+      "default": "./dist/volar/sfc-typed-router.cjs"
+    },
+    "./dist/*": "./dist/*"
+  },
+  "dependencies": {
+    "@babel/generator": "^8.0.0-rc.4",
+    "@vue-macros/common": "^3.1.1",
+    "@vue/devtools-api": "^8.1.2",
+    "ast-walker-scope": "^0.9.0",
+    "chokidar": "^5.0.0",
+    "json5": "^2.2.3",
+    "local-pkg": "^1.1.2",
+    "magic-string": "^0.30.21",
+    "mlly": "^1.8.2",
+    "muggle-string": "^0.4.1",
+    "pathe": "^2.0.3",
+    "picomatch": "^4.0.3",
+    "scule": "^1.3.0",
+    "tinyglobby": "^0.2.16",
+    "unplugin": "^3.0.0",
+    "unplugin-utils": "^0.3.1",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@babel/types": "^8.0.0-rc.4",
+    "@pinia/colada": "^1.3.1",
+    "@playwright/test": "^1.59.1",
+    "@rollup/plugin-commonjs": "^28.0.9",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-replace": "^6.0.3",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@standard-schema/spec": "^1.1.0",
+    "@types/babel__generator": "^7.27.0",
+    "@types/nightwatch": "^2.3.32",
+    "@types/picomatch": "^4.0.2",
+    "@typescript/native-preview": "7.0.0-dev.20260106.1",
+    "@vitejs/plugin-vue": "^6.0.6",
+    "@vue/compiler-sfc": "^3.5.34",
+    "@vue/language-core": "^3.2.1",
+    "@vue/server-renderer": "^3.5.34",
+    "@vue/test-utils": "^2.4.10",
+    "browserstack-local": "^1.5.13",
+    "chromedriver": "^148.0.3",
+    "connect-history-api-fallback": "^2.0.0",
+    "dotenv": "^17.4.2",
+    "faked-promise": "^2.2.2",
+    "geckodriver": "^6.1.0",
+    "happy-dom": "^20.9.0",
+    "nightwatch": "^3.15.0",
+    "nightwatch-helpers": "^1.2.0",
+    "pinia": "^3.0.4",
+    "rimraf": "^6.1.3",
+    "rollup": "^4.57.1",
+    "rollup-plugin-typescript2": "^0.36.0",
+    "tsdown": "^0.22.0",
+    "tsup": "^8.5.1",
+    "valibot": "^1.4.1",
+    "vite": "^8.0.13",
+    "vue": "^3.5.34",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@pinia/colada": ">=0.21.2",
+    "@vue/compiler-sfc": "^3.5.34",
+    "pinia": "^3.0.4",
+    "vite": "^7.0.0 || ^8.0.0",
+    "vue": "^3.5.34"
+  },
+  "peerDependenciesMeta": {
+    "@vue/compiler-sfc": {
+      "optional": true
+    },
+    "pinia": {
+      "optional": true
+    },
+    "@pinia/colada": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    }
+  },
+  "vetur": {
+    "tags": "vetur/tags.json",
+    "attributes": "vetur/attributes.json"
+  },
+  "scripts": {
+    "dev": "vitest --ui",
+    "build": "tsdown",
+    "build:old": "rimraf dist && rollup -c rollup.config.mjs",
+    "build:playground": "vue-tsc --noEmit && vite build --config playground/vite.config.ts",
+    "build:e2e": "vue-tsc --noEmit && vite build --config e2e/vite.config.mjs",
+    "build:size": "pnpm run build && rollup -c size-checks/rollup.config.mjs",
+    "dev:e2e": "vite --config e2e/vite.config.mjs",
+    "test:types": "tsc --build tsconfig.json ./test-dts/tsconfig.experimental.json",
+    "test:unit": "vitest --coverage run",
+    "test": "pnpm run build && pnpm run '/^(unit|test:types)$/' && pnpm run '/^test:(e2e|e2e:hmr)$/'",
+    "test:e2e": "pnpm run test:e2e:headless",
+    "test:e2e:hmr": "pnpm exec playwright test",
+    "test:e2e:headless": "node e2e/runner.mjs --env chrome-headless",
+    "test:e2e:native": "node e2e/runner.mjs --env chrome",
+    "test:e2e:ci": "node e2e/runner.mjs --env chrome-headless --retries 2",
+    "test:e2e:bs": "node e2e/runner.mjs --local -e android5 --tag browserstack",
+    "test:e2e:bs-test": "node e2e/runner.mjs --local --env browserstack.local_chrome --tag browserstack"
+  }
+}

package/.output/server/node_modules/vue-router/vue-router.node.mjs

@@ -0,0 +1,2 @@
+global.__VUE_PROD_DEVTOOLS__ = false
+export * from './dist/vue-router.js'

package/.output/server/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "businesslens-prod",
+  "version": "0.2.2",
+  "type": "module",
+  "private": true,
+  "dependencies": {
+    "@babel/parser": "7.29.7",
+    "@iconify/utils": "3.1.4",
+    "@vue-flow/core": "1.48.2",
+    "@vue/compiler-core": "3.5.39",
+    "@vue/compiler-dom": "3.5.39",
+    "@vue/compiler-ssr": "3.5.39",
+    "@vue/devtools-api": "8.1.5",
+    "@vue/devtools-kit": "8.1.5",
+    "@vue/devtools-shared": "8.1.5",
+    "@vue/reactivity": "3.5.39",
+    "@vue/runtime-core": "3.5.39",
+    "@vue/runtime-dom": "3.5.39",
+    "@vue/server-renderer": "3.5.39",
+    "@vue/shared": "3.5.39",
+    "ajv": "8.17.1",
+    "ajv-formats": "3.0.1",
+    "birpc": "2.9.0",
+    "consola": "3.4.2",
+    "devalue": "5.8.1",
+    "entities": "7.0.1",
+    "estree-walker": "2.0.2",
+    "fast-deep-equal": "3.1.3",
+    "fast-uri": "3.1.3",
+    "hookable": "6.1.1",
+    "json-schema-traverse": "1.0.0",
+    "perfect-debounce": "2.1.0",
+    "source-map-js": "1.2.1",
+    "tailwindcss": "4.2.1",
+    "ufo": "1.6.4",
+    "unhead": "2.1.15",
+    "vue": "3.5.39",
+    "vue-bundle-renderer": "2.3.1",
+    "vue-router": "5.1.0"
+  }
+}

package/README.md

@@ -0,0 +1,114 @@
+# BusinessLens
+
+BusinessLens turns source-backed software analysis into a local, navigable
+product report. Point the CLI at one validated JSON file and explore its
+actors, domains, journeys, scenarios, repository evidence, topology, coverage,
+and limitations in the browser.
+
+## Run a report
+
+Requires Node.js 22.13 or newer.
+
+```sh
+npx businesslens --report ./report.json
+```
+
+BusinessLens validates the report before starting, binds to `127.0.0.1`, uses
+port 3000 or the next available port, and opens the browser. Useful options:
+
+```sh
+npx businesslens --report ./report.json --port 4173 --no-open
+npx businesslens --help
+```
+
+## Included reports
+
+This repository preserves four source-backed reports in the v2 single-file
+format:
+
+- `reports/argo-cd/report.json`
+- `reports/argo-workflows/report.json`
+- `reports/gitea/report.json`
+- `reports/vibe-trading/report.json`
+
+Run one from a source checkout:
+
+```sh
+pnpm install
+pnpm build
+node bin/businesslens.mjs --report ./reports/gitea/report.json
+```
+
+For Nuxt development, pass the absolute report path through runtime config:
+
+```sh
+NUXT_REPORT_PATH="$PWD/reports/gitea/report.json" pnpm dev
+```
+
+## Report contract
+
+Each `reports/<report-id>/` directory contains exactly one `report.json` using
+schema version `2.0.0`. It includes:
+
+- report identity and generation metadata;
+- source repository, optional logo, branch or tag, and pinned commit;
+- actors and product domains;
+- user journeys with entry points and repository evidence;
+- source-backed scenarios with triggers, ordered observable steps, outcomes,
+  and edge cases;
+- analysis coverage, unmapped areas, and limitations.
+
+Validate every tracked report:
+
+```sh
+pnpm validate
+```
+
+Validate one file:
+
+```sh
+node .agents/skills/businesslens-validate-report/scripts/validate-report.mjs \
+  ./reports/gitea/report.json
+```
+
+## Repository-analysis skills
+
+Agents that support `AGENTS.md` and the Agent Skills convention can use the
+workflows under `.agents/skills/`:
+
+- `$businesslens-analyze-repository` safely inventories a public HTTPS Git
+  checkout and creates a v2 `report.json` without executing target code.
+- `$businesslens-validate-report` checks schema and semantic integrity.
+- `$businesslens-add-report` imports a validated file without replacing an
+  existing report.
+
+## Development tooling
+
+The repository keeps shared MCP configuration for Codex, Claude, and other
+MCP-compatible development clients. It provides Nuxt UI documentation tools
+and a pinned Chrome DevTools integration without changing a contributor's
+sandbox or approval policy.
+
+The Chrome integration expects a browser debugging endpoint on port `9222`.
+For example, on macOS:
+
+```sh
+open -na "Google Chrome" --args \
+  --remote-debugging-port=9222 \
+  --user-data-dir=/tmp/businesslens-chrome
+```
+
+## Development and verification
+
+```sh
+pnpm install
+pnpm check
+```
+
+Before publishing, inspect and smoke-test the exact npm artifact:
+
+```sh
+pnpm pack
+npx --package ./businesslens-0.2.2.tgz businesslens \
+  --report ./reports/gitea/report.json --no-open
+```

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,28 @@
+# Third-party notices
+
+## Nuxt UI Landing Template
+
+Portions of the BusinessLens landing-page structure and visual components are
+adapted from the [Nuxt UI Landing Template](https://github.com/nuxt-ui-templates/landing).
+
+MIT License
+
+Copyright (c) 2025 Nuxt UI Templates
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/bin/businesslens.mjs

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { readFile, stat } from "node:fs/promises";
+import { createServer } from "node:net";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { readReportFile } from "../packages/report-schema/validate.mjs";
+
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+
+function usage() {
+  return `BusinessLens
+
+Run a source-backed software report locally.
+
+Usage:
+  businesslens --report <report.json> [options]
+
+Options:
+  --report <path>  Path to a BusinessLens v2 report.json file
+  --port <number>  Preferred local port (default: 3000)
+  --host <host>    Host interface to bind (default: 127.0.0.1)
+  --no-open        Do not open the report in a browser
+  --help, -h       Show this help
+  --version, -v    Show the installed version`;
+}
+
+function parseArguments(argv) {
+  const options = { report: "", port: 3000, host: "127.0.0.1", open: true };
+  for (let index = 0; index < argv.length; index += 1) {
+    const argument = argv[index];
+    if (argument === "--help" || argument === "-h") return { ...options, help: true };
+    if (argument === "--version" || argument === "-v") return { ...options, version: true };
+    if (argument === "--no-open") {
+      options.open = false;
+      continue;
+    }
+    if (["--report", "--port", "--host"].includes(argument)) {
+      const value = argv[index + 1];
+      if (!value || value.startsWith("--")) throw new Error(`${argument} requires a value.`);
+      options[argument.slice(2)] = argument === "--port" ? Number(value) : value;
+      index += 1;
+      continue;
+    }
+    throw new Error(`Unknown option: ${argument}`);
+  }
+  if (!options.report) throw new Error("--report <report.json> is required.");
+  if (!Number.isInteger(options.port) || options.port < 1 || options.port > 65535) {
+    throw new Error("--port must be an integer between 1 and 65535.");
+  }
+  if (!options.host.trim()) throw new Error("--host cannot be empty.");
+  return options;
+}
+
+async function availablePort(preferredPort, host) {
+  for (let port = preferredPort; port <= Math.min(65535, preferredPort + 20); port += 1) {
+    const available = await new Promise((accept) => {
+      const probe = createServer();
+      probe.unref();
+      probe.once("error", () => accept(false));
+      probe.listen({ port, host }, () => probe.close(() => accept(true)));
+    });
+    if (available) return port;
+  }
+  throw new Error(`No available port found between ${preferredPort} and ${Math.min(65535, preferredPort + 20)}.`);
+}
+
+function openBrowser(url) {
+  const command = process.platform === "darwin"
+    ? ["open", [url]]
+    : process.platform === "win32"
+      ? ["cmd", ["/c", "start", "", url]]
+      : ["xdg-open", [url]];
+  const opener = spawn(command[0], command[1], { detached: true, stdio: "ignore" });
+  opener.unref();
+  opener.once("error", () => {});
+}
+
+async function waitUntilReady(url, child) {
+  for (let attempt = 0; attempt < 100; attempt += 1) {
+    if (child.exitCode !== null) throw new Error(`BusinessLens server exited with code ${child.exitCode}.`);
+    try {
+      const response = await fetch(`${url}/api/report`);
+      if (response.ok) return;
+    } catch {
+      // The server is still starting.
+    }
+    await new Promise(resolveDelay => setTimeout(resolveDelay, 100));
+  }
+  throw new Error("BusinessLens did not become ready within 10 seconds.");
+}
+
+async function main() {
+  let options;
+  try {
+    options = parseArguments(process.argv.slice(2));
+  } catch (error) {
+    console.error(`Error: ${error.message}\n\n${usage()}`);
+    process.exitCode = 2;
+    return;
+  }
+
+  if (options.help) {
+    console.log(usage());
+    return;
+  }
+  if (options.version) {
+    const packageJson = JSON.parse(await readFile(resolve(packageRoot, "package.json"), "utf8"));
+    console.log(packageJson.version);
+    return;
+  }
+
+  const reportPath = resolve(process.cwd(), options.report);
+  try {
+    const file = await stat(reportPath);
+    if (!file.isFile()) throw new Error("path is not a regular file");
+  } catch (error) {
+    console.error(`Cannot read report ${reportPath}: ${error.message}`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const validation = await readReportFile(reportPath);
+  if (validation.errors.length || !validation.report) {
+    console.error(`Report validation failed:\n${validation.errors.map(error => `- ${error}`).join("\n")}`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const serverEntry = resolve(packageRoot, ".output/server/index.mjs");
+  try {
+    await stat(serverEntry);
+  } catch {
+    console.error("BusinessLens server assets are missing. Reinstall the package or run pnpm build in a source checkout.");
+    process.exitCode = 1;
+    return;
+  }
+
+  let port;
+  try {
+    port = await availablePort(options.port, options.host);
+  } catch (error) {
+    console.error(error.message);
+    process.exitCode = 1;
+    return;
+  }
+  const browserHost = ["0.0.0.0", "::"].includes(options.host) ? "127.0.0.1" : options.host;
+  const urlHost = browserHost.includes(":") ? `[${browserHost}]` : browserHost;
+  const url = `http://${urlHost}:${port}`;
+  const child = spawn(process.execPath, [serverEntry], {
+    env: {
+      ...process.env,
+      NITRO_HOST: options.host,
+      NITRO_PORT: String(port),
+      NUXT_REPORT_PATH: reportPath,
+    },
+    stdio: "inherit",
+  });
+
+  const stop = (signal) => {
+    if (child.exitCode === null) child.kill(signal);
+  };
+  process.once("SIGINT", () => stop("SIGINT"));
+  process.once("SIGTERM", () => stop("SIGTERM"));
+
+  try {
+    await waitUntilReady(url, child);
+    console.log(`BusinessLens is viewing ${validation.report.source.repository} at ${url}`);
+    if (port !== options.port) console.log(`Port ${options.port} was unavailable; using ${port}.`);
+    if (options.open) openBrowser(url);
+  } catch (error) {
+    console.error(error.message);
+    stop("SIGTERM");
+    process.exitCode = 1;
+  }
+
+  const exitCode = child.exitCode ?? await new Promise(resolveExit => child.once("exit", code => resolveExit(code)));
+  if (exitCode && !process.exitCode) process.exitCode = exitCode;
+}
+
+await main();

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "businesslens",
+  "version": "0.2.2",
+  "description": "Run source-backed BusinessLens software reports locally from a single JSON file.",
+  "type": "module",
+  "bin": {
+    "businesslens": "bin/businesslens.mjs"
+  },
+  "files": [
+    ".output",
+    "bin",
+    "packages/report-schema",
+    "README.md",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "keywords": [
+    "businesslens",
+    "software-analysis",
+    "user-journeys",
+    "repository-analysis"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/businesslens/cli.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@11.9.0",
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "dev": "nuxt dev",
+    "build": "nuxt build",
+    "prepack": "pnpm build",
+    "dev:prepare": "nuxt prepare",
+    "validate": "node scripts/validate-reports.mjs",
+    "lint": "eslint .",
+    "typecheck": "nuxt typecheck",
+    "test": "vitest run",
+    "check": "pnpm dev:prepare && pnpm validate && pnpm lint && pnpm typecheck && pnpm test && pnpm build"
+  },
+  "dependencies": {
+    "ajv": "8.17.1",
+    "ajv-formats": "3.0.1",
+    "hookable": "6.1.1"
+  },
+  "devDependencies": {
+    "@fontsource-variable/inter": "5.2.8",
+    "@nuxt/ui": "4.9.0",
+    "@vue-flow/background": "1.3.2",
+    "@vue-flow/controls": "1.1.3",
+    "@vue-flow/core": "1.48.2",
+    "@vue-flow/minimap": "1.5.4",
+    "nuxt": "4.4.8",
+    "vue": "3.5.39",
+    "vue-router": "5.1.0",
+    "@iconify-json/lucide": "1.2.117",
+    "@nuxt/eslint": "1.16.0",
+    "@types/node": "24.10.4",
+    "eslint": "9.39.4",
+    "tailwindcss": "4.2.1",
+    "typescript": "5.9.3",
+    "vitest": "4.1.9",
+    "vue-tsc": "3.3.7"
+  }
+}