@grifhinz/logics-manager 2.0.0

package/package.json

@@ -0,0 +1,162 @@
+{
+  "name": "@grifhinz/logics-manager",
+  "displayName": "Logics Orchestrator",
+  "description": "Visual orchestration for Logics workflows inside VS Code.",
+  "version": "2.0.0",
+  "publisher": "cdx-logics",
+  "icon": "media/icon.png",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AlexAgo83/logics-manager.git"
+  },
+  "engines": {
+    "vscode": "^1.86.0"
+  },
+  "categories": [
+    "Other"
+  ],
+  "main": "./dist/extension.js",
+  "bin": {
+    "logics-manager": "./scripts/npm/logics-manager.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "README.md",
+    "LICENSE",
+    "VERSION",
+    "pyproject.toml",
+    "scripts/logics-manager.py",
+    "scripts/npm/",
+    "logics_manager/*.py",
+    "logics_manager/**/*.py"
+  ],
+  "contributes": {
+    "viewsContainers": {
+      "panel": [
+        {
+          "id": "logics",
+          "title": "Logics",
+          "icon": "media/logics.svg"
+        }
+      ]
+    },
+    "views": {
+      "logics": [
+        {
+          "id": "logics.orchestrator",
+          "name": "Orchestrator",
+          "icon": "media/logics.svg",
+          "type": "webview"
+        }
+      ]
+    },
+    "commands": [
+      {
+        "command": "logics.refresh",
+        "title": "Logics: Refresh"
+      },
+      {
+        "command": "logics.refreshAgents",
+        "title": "Logics: Refresh Agents"
+      },
+      {
+        "command": "logics.selectAgent",
+        "title": "Logics: Select Agent"
+      },
+      {
+        "command": "logics.open",
+        "title": "Logics: Open Item"
+      },
+      {
+        "command": "logics.promote",
+        "title": "Logics: Promote Item"
+      },
+      {
+        "command": "logics.newRequest",
+        "title": "Logics: New Request"
+      },
+      {
+        "command": "logics.createCompanionDoc",
+        "title": "Logics: Create Companion Doc"
+      },
+      {
+        "command": "logics.checkEnvironment",
+        "title": "Logics: Check Environment"
+      },
+      {
+        "command": "logics.openHybridInsights",
+        "title": "Logics: Open Hybrid Insights"
+      },
+      {
+        "command": "logics.openLogicsInsights",
+        "title": "Logics: Open Logics Insights"
+      },
+      {
+        "command": "logics.assistTriage",
+        "title": "Logics: Triage Item"
+      },
+      {
+        "command": "logics.assistDiffRisk",
+        "title": "Logics: Assess Diff Risk"
+      },
+      {
+        "command": "logics.assistValidationChecklist",
+        "title": "Logics: Build Validation Checklist"
+      },
+      {
+        "command": "logics.assistDocConsistency",
+        "title": "Logics: Review Doc Consistency"
+      }
+    ]
+  },
+  "scripts": {
+    "postinstall": "npm run compile",
+    "bundle:extension": "node scripts/build/package-extension.mjs",
+    "watch:bundle": "node scripts/build/package-extension.mjs --watch",
+    "watch:types": "tsc -watch -p ./",
+    "compile": "tsc -p ./ && npm run bundle:extension",
+    "watch": "npm run watch:bundle",
+    "test": "vitest run",
+    "test:coverage:src": "node scripts/run-plugin-coverage.mjs src",
+    "test:coverage:media": "node scripts/run-plugin-coverage.mjs media",
+    "test:coverage": "npm run test:coverage:src && npm run test:coverage:media",
+    "test:smoke": "node tests/run_extension_smoke_checks.mjs",
+    "test:npm-cli": "node scripts/npm/logics-manager.mjs --help",
+    "test:lifecycle": "node tests/run_plugin_lifecycle_checks.mjs",
+    "test:watch": "vitest",
+    "lint": "npm run lint:ts && npm run lint:es",
+    "lint:ts": "tsc -p ./ --noEmit",
+    "lint:es": "eslint src/**/*.ts",
+    "lint:logics": "node scripts/run-python.mjs -m logics_manager lint",
+    "audit:logics": "node scripts/run-python.mjs -m logics_manager audit && node scripts/run-python.mjs -m logics_manager lint",
+    "audit:ci": "node scripts/check-npm-audit.mjs",
+    "logics:finish:task": "node scripts/run-python.mjs -m logics_manager flow finish task",
+    "ci:fast": "npm run compile && npm run lint && npm run test:coverage && npm run test:smoke && npm run lint:logics && npm run package:ci",
+    "ci:check": "node scripts/ci-check.mjs",
+    "dev": "npm run compile && code --extensionDevelopmentPath=.",
+    "debug:webview": "node debug/webview/server.mjs",
+    "package:ci": "node scripts/build/package-ci.mjs",
+    "package": "npm run compile && node scripts/build/package-release.mjs",
+    "install:vsix": "npm run package && node scripts/build/install-vsix.mjs",
+    "publish:npm": "node scripts/release/publish-npm.mjs",
+    "release:changelog:resolve": "node scripts/release/resolve-release-changelog.mjs --validate-current",
+    "release:changelog:validate": "node scripts/release/resolve-release-changelog.mjs --validate-current --require-curated"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/vscode": "^1.86.0",
+    "@typescript-eslint/eslint-plugin": "^8.58.1",
+    "@typescript-eslint/parser": "^8.58.1",
+    "@vitest/coverage-v8": "^4.1.2",
+    "esbuild": "^0.25.10",
+    "eslint": "^10.2.0",
+    "jsdom": "^25.0.1",
+    "mermaid": "^11.14.0",
+    "typescript": "^5.3.3",
+    "vitest": "^4.1.2",
+    "yaml": "^2.8.3",
+    "yauzl": "^3.2.0"
+  }
+}

package/pyproject.toml

@@ -0,0 +1,15 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "logics-manager"
+version = "2.0.0"
+description = "Canonical Logics CLI"
+requires-python = ">=3.10"
+
+[project.scripts]
+logics-manager = "logics_manager.cli:main"
+
+[tool.setuptools]
+packages = ["logics_manager"]

package/scripts/logics-manager.py

@@ -0,0 +1,15 @@
+#!/usr/bin/env python3
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parents[1]
+if str(REPO_ROOT) not in sys.path:
+    sys.path.insert(0, str(REPO_ROOT))
+
+from logics_manager.cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main(sys.argv[1:]))

package/scripts/npm/logics-manager.mjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+export function buildCandidates(platform = process.platform) {
+  return platform === "win32"
+    ? [
+        { command: "python3", argsPrefix: [] },
+        { command: "python", argsPrefix: [] },
+        { command: "py", argsPrefix: ["-3"] },
+        { command: "py", argsPrefix: [] }
+      ]
+    : [
+        { command: "python3", argsPrefix: [] },
+        { command: "python", argsPrefix: [] }
+      ];
+}
+
+export function isMissingCommandError(error) {
+  const detail = `${error?.message || ""}\n${error?.stderr || ""}\n${error?.stdout || ""}`.toLowerCase();
+  return (
+    detail.includes("enoent") ||
+    detail.includes("not recognized as an internal or external command") ||
+    detail.includes("command not found") ||
+    detail.includes("python was not found") ||
+    detail.includes("cannot find the file specified")
+  );
+}
+
+export function parsePythonVersion(text) {
+  const match = text.match(/Python\s+(\d+)\.(\d+)(?:\.(\d+))?/i);
+  if (!match) {
+    return null;
+  }
+  return {
+    major: Number.parseInt(match[1], 10),
+    minor: Number.parseInt(match[2], 10)
+  };
+}
+
+export function isSupportedPythonVersion(version) {
+  return version.major > 3 || (version.major === 3 && version.minor >= 10);
+}
+
+export function resolvePythonLauncher(candidate, spawn = spawnSync) {
+  const result = spawn(candidate.command, [...candidate.argsPrefix, "--version"], {
+    encoding: "utf8"
+  });
+  if (result.error || result.status !== 0) {
+    return null;
+  }
+
+  const versionText = `${result.stdout || ""}\n${result.stderr || ""}`.trim();
+  const version = parsePythonVersion(versionText);
+  if (!version || !isSupportedPythonVersion(version)) {
+    return null;
+  }
+
+  return candidate;
+}
+
+export function runLogicsManager(argv = process.argv.slice(2), platform = process.platform, spawn = spawnSync) {
+  const candidates = buildCandidates(platform);
+  const wrapperDir = dirname(fileURLToPath(import.meta.url));
+  const packageRoot = resolve(wrapperDir, "..", "..");
+  const scriptPath = resolve(packageRoot, "scripts", "logics-manager.py");
+  for (const candidate of candidates) {
+    const launcher = resolvePythonLauncher(candidate, spawn);
+    if (!launcher) {
+      continue;
+    }
+
+    const result = spawn(launcher.command, [...launcher.argsPrefix, scriptPath, ...argv], {
+      stdio: "inherit"
+    });
+    if (result.status === 0) {
+      return 0;
+    }
+    if (isMissingCommandError(result.error)) {
+      continue;
+    }
+    return result.status ?? 1;
+  }
+
+  console.error(
+    platform === "win32"
+      ? "Python 3.10+ interpreter not found. Install Python 3.10 or newer and ensure `python3`, `python`, or `py` is available on PATH."
+      : "Python 3.10+ interpreter not found. Install Python 3.10 or newer and ensure `python3` or `python` is available on PATH."
+  );
+  return 1;
+}
+
+if (import.meta.url === pathToFileURL(process.argv[1]).href) {
+  process.exit(runLogicsManager());
+}