npm - @grifhinz/logics-manager - Versions diffs - 2.2.0 → 2.3.1 - Mend

@grifhinz/logics-manager 2.2.0 → 2.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (43) hide show

package/README.md +95 -1
package/VERSION +1 -1
package/clients/README.md +9 -0
package/clients/shared-web/media/css/board.css +658 -0
package/clients/shared-web/media/css/details.css +457 -0
package/clients/shared-web/media/css/layout.css +123 -0
package/clients/shared-web/media/css/toolbar.css +576 -0
package/clients/shared-web/media/harnessApi.js +324 -0
package/clients/shared-web/media/hostApi.js +213 -0
package/clients/shared-web/media/hostApiContract.js +55 -0
package/clients/shared-web/media/icon.png +0 -0
package/clients/shared-web/media/layoutController.js +246 -0
package/clients/shared-web/media/logics.svg +7 -0
package/clients/shared-web/media/logicsModel.js +910 -0
package/clients/shared-web/media/main.css +112 -0
package/clients/shared-web/media/main.js +3 -0
package/clients/shared-web/media/mainApp.js +1005 -0
package/clients/shared-web/media/mainCore.js +604 -0
package/clients/shared-web/media/mainInteractionHandlers.js +324 -0
package/clients/shared-web/media/mainInteractions.js +378 -0
package/clients/shared-web/media/renderBoard.js +3 -0
package/clients/shared-web/media/renderBoardApp.js +1339 -0
package/clients/shared-web/media/renderDetails.js +685 -0
package/clients/shared-web/media/renderMarkdown.js +449 -0
package/clients/shared-web/media/toolsPanelLayout.js +172 -0
package/clients/shared-web/media/uiStatus.js +54 -0
package/clients/shared-web/media/webviewChrome.js +405 -0
package/clients/shared-web/media/webviewPersistence.js +116 -0
package/clients/shared-web/media/webviewSelectors.js +491 -0
package/clients/viewer/README.md +5 -0
package/clients/viewer/browser-host.js +847 -0
package/clients/viewer/index.html +237 -0
package/clients/viewer/viewer.css +433 -0
package/logics_manager/assist.py +9 -142
package/logics_manager/assist_handoff.py +132 -0
package/logics_manager/assist_surface.py +38 -0
package/logics_manager/cli.py +78 -5
package/logics_manager/flow.py +126 -24
package/logics_manager/flow_evidence.py +63 -0
package/logics_manager/update_check.py +138 -0
package/logics_manager/viewer.py +533 -0
package/package.json +12 -6
package/pyproject.toml +1 -1

package/clients/shared-web/media/harnessApi.js ADDED Viewed

@@ -0,0 +1,324 @@
+(() => {
+  window.createCdxLogicsHarnessApi = function createCdxLogicsHarnessApi(options) {
+    const {
+      isHarnessMode,
+      harnessBridge,
+      markdownApi,
+      escapeHtml,
+      showStatus,
+      projectGithubUrl
+    } = options;
+    let currentRoot = null;
+    let harnessRootHandle = null;
+    let canResetProjectRoot = false;
+    function encodePathForUrl(relativePath) {
+      return relativePath
+        .split("/")
+        .filter((part) => part.length > 0)
+        .map((part) => encodeURIComponent(part))
+        .join("/");
+    }
+    function getItemRelativePath(item) {
+      if (!item) {
+        return "";
+      }
+      if (typeof item.relPath === "string" && item.relPath.trim()) {
+        return item.relPath.trim().replace(/\\/g, "/").replace(/^\.?\//, "");
+      }
+      if (typeof item.path === "string" && item.path.trim()) {
+        const normalizedPath = item.path.replace(/\\/g, "/");
+        if (currentRoot && normalizedPath.startsWith(currentRoot)) {
+          const relative = normalizedPath.slice(currentRoot.length).replace(/^\/+/, "");
+          if (relative) {
+            return relative;
+          }
+        }
+        if (!normalizedPath.startsWith("/") && !normalizedPath.includes(":")) {
+          return normalizedPath.replace(/^\.?\//, "");
+        }
+      }
+      return "";
+    }
+    function buildHarnessDocUrl(item) {
+      const relativePath = getItemRelativePath(item);
+      if (!relativePath) {
+        return "";
+      }
+      return `/${encodePathForUrl(relativePath)}`;
+    }
+    async function readHarnessFileFromHandle(relativePath) {
+      if (!harnessRootHandle || typeof harnessRootHandle.getDirectoryHandle !== "function") {
+        return null;
+      }
+      const segments = relativePath
+        .split("/")
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0 && part !== ".");
+      if (!segments.length || segments.includes("..")) {
+        return null;
+      }
+      const filename = segments[segments.length - 1];
+      if (!filename) {
+        return null;
+      }
+      let directoryHandle = harnessRootHandle;
+      for (const segment of segments.slice(0, -1)) {
+        directoryHandle = await directoryHandle.getDirectoryHandle(segment, { create: false });
+      }
+      const fileHandle = await directoryHandle.getFileHandle(filename, { create: false });
+      const file = await fileHandle.getFile();
+      return file.text();
+    }
+    function openHarnessContentTab(item, mode, sourceLabel, content) {
+      const popup = window.open("", "_blank", "noopener,noreferrer");
+      if (!popup) {
+        showStatus("Popup blocked by the browser. Enable popups for harness preview.", "warn");
+        return false;
+      }
+      const editMode = mode === "edit";
+      const body = editMode
+        ? `<!doctype html><html lang="en"><head><meta charset="UTF-8" /><title>${escapeHtml(
+            item && item.title ? item.title : "Logics item"
+          )}</title><style>body{font-family:system-ui,sans-serif;margin:20px;line-height:1.45;}code{background:#f4f4f4;padding:2px 4px;border-radius:4px;}</style></head><body><h1>${escapeHtml(
+            item && item.title ? item.title : "Logics item"
+          )}</h1><p>Source: <code>${escapeHtml(sourceLabel || "unknown")}</code></p><textarea style="width:100%;height:70vh;font:13px ui-monospace,SFMono-Regular,Menlo,monospace;">${escapeHtml(
+            content || ""
+          )}</textarea><p style="font-size:12px;opacity:0.8;">Harness edit mode is preview-only (saving is disabled).</p></body></html>`
+        : markdownApi.buildReadPreviewDocument(item, sourceLabel, content);
+      popup.document.open();
+      popup.document.write(body);
+      popup.document.close();
+      return true;
+    }
+    async function resolveHarnessItemContent(item) {
+      const relativePath = getItemRelativePath(item);
+      if (!relativePath) {
+        return { relativePath: "", content: "", source: "", error: "missing-path" };
+      }
+      if (harnessRootHandle) {
+        try {
+          const content = await readHarnessFileFromHandle(relativePath);
+          if (typeof content === "string") {
+            return { relativePath, content, source: `filesystem:${currentRoot || "selected-root"}`, error: "" };
+          }
+        } catch (error) {
+          const reason = error instanceof Error ? error.message : String(error);
+          showStatus(`Could not read from selected root (${reason}). Falling back to server path.`, "warn");
+        }
+      }
+      const target = `/${encodePathForUrl(relativePath)}`;
+      try {
+        const response = await fetch(target);
+        if (!response.ok) {
+          throw new Error(`HTTP ${response.status}`);
+        }
+        const content = await response.text();
+        return { relativePath, content, source: target, error: "" };
+      } catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        return { relativePath, content: "", source: target, error: reason };
+      }
+    }
+    function openHarnessInfoTab(item, heading, message) {
+      const popup = window.open("", "_blank", "noopener,noreferrer");
+      if (!popup) {
+        showStatus("Popup blocked by the browser. Enable popups for harness preview.", "warn");
+        return;
+      }
+      const safeTitle = escapeHtml(item && item.title ? item.title : "Logics item");
+      const safeHeading = escapeHtml(heading);
+      const safeMessage = escapeHtml(message);
+      popup.document.open();
+      popup.document.write(`<!doctype html><html lang="en"><head><meta charset="UTF-8" /><title>${safeTitle}</title><style>body{font-family:system-ui,sans-serif;margin:24px;line-height:1.5;}code{background:#f4f4f4;padding:2px 4px;border-radius:4px;}</style></head><body><h1>${safeHeading}</h1><p>${safeMessage}</p></body></html>`);
+      popup.document.close();
+    }
+    async function openHarnessEditTab(item) {
+      const target = buildHarnessDocUrl(item);
+      if (!target) {
+        openHarnessInfoTab(item, "Edit view unavailable", "No file path is available for this mocked item in harness mode.");
+        showStatus("No file path available for this item in harness mode.", "warn");
+        return;
+      }
+      const resolved = await resolveHarnessItemContent(item);
+      if (!resolved.error) {
+        const opened = openHarnessContentTab(item, "edit", resolved.source, resolved.content);
+        if (opened) {
+          showStatus(`Opened edit tab for ${resolved.relativePath} (${resolved.source}).`, "info");
+        }
+        return;
+      }
+      const opened = window.open(target, "_blank", "noopener,noreferrer");
+      if (!opened) {
+        showStatus("Popup blocked by the browser. Enable popups to open files from harness mode.", "warn");
+        return;
+      }
+      showStatus(`Opened ${target} in a new tab.`, "info");
+    }
+    async function openHarnessReadTab(item) {
+      const target = buildHarnessDocUrl(item);
+      if (!target) {
+        openHarnessInfoTab(item, "Read view unavailable", "No file path is available for this mocked item in harness mode.");
+        showStatus("No file path available for this item in harness mode.", "warn");
+        return;
+      }
+      const resolved = await resolveHarnessItemContent(item);
+      if (!resolved.error) {
+        const opened = openHarnessContentTab(item, "read", resolved.relativePath || resolved.source, resolved.content);
+        if (opened) {
+          showStatus(`Opened read preview for ${resolved.relativePath} (${resolved.source}).`, "info");
+        }
+        return;
+      }
+      const opened = window.open(target, "_blank", "noopener,noreferrer");
+      if (!opened) {
+        showStatus("Popup blocked by the browser. Enable popups for harness preview.", "warn");
+        return;
+      }
+      const reason = resolved.error || "preview unavailable";
+      showStatus(`Preview unavailable (${reason}). Opened raw file instead.`, "warn");
+    }
+    function openHarnessItem(item, mode) {
+      if (mode === "read") {
+        void openHarnessReadTab(item);
+      } else {
+        void openHarnessEditTab(item);
+      }
+    }
+    function pickDirectoryFromInput() {
+      return new Promise((resolve) => {
+        const input = document.createElement("input");
+        let settled = false;
+        const finalize = (value) => {
+          if (settled) {
+            return;
+          }
+          settled = true;
+          window.removeEventListener("focus", onWindowFocus, true);
+          input.remove();
+          resolve(value);
+        };
+        const onWindowFocus = () => {
+          window.setTimeout(() => {
+            if (settled) {
+              return;
+            }
+            const files = input.files;
+            if (!files || files.length === 0) {
+              finalize(null);
+            }
+          }, 0);
+        };
+        input.type = "file";
+        input.multiple = true;
+        input.webkitdirectory = true;
+        input.style.display = "none";
+        input.addEventListener("change", () => {
+          const files = input.files;
+          if (!files || files.length === 0) {
+            finalize(null);
+            return;
+          }
+          const first = files[0];
+          const relative = typeof first.webkitRelativePath === "string" ? first.webkitRelativePath : "";
+          const rootName = relative.split("/")[0] || first.name;
+          finalize(rootName || null);
+        });
+        document.body.appendChild(input);
+        window.addEventListener("focus", onWindowFocus, true);
+        input.click();
+      });
+    }
+    function applyHarnessRoot(rootLabel, nextHandle = null) {
+      currentRoot = rootLabel || null;
+      harnessRootHandle = nextHandle || null;
+      canResetProjectRoot = Boolean(rootLabel);
+      if (harnessBridge && typeof harnessBridge.setProjectRootLabel === "function") {
+        harnessBridge.setProjectRootLabel(rootLabel || null);
+      }
+    }
+    async function handleHarnessChangeProjectRoot() {
+      try {
+        if (typeof window.showDirectoryPicker === "function") {
+          const directoryHandle = await window.showDirectoryPicker({ mode: "read" });
+          const label = directoryHandle && directoryHandle.name ? directoryHandle.name : "selected-folder";
+          applyHarnessRoot(label, directoryHandle);
+          showStatus(`Harness project root set to "${label}".`, "info");
+          return;
+        }
+      } catch (error) {
+        if (!(error && error.name === "AbortError")) {
+          const reason = error instanceof Error ? error.message : String(error);
+          showStatus(`Directory picker unavailable (${reason}). Trying fallback.`, "warn");
+        } else {
+          showStatus("Project root selection canceled.", "warn");
+          return;
+        }
+      }
+      const fallbackRoot = await pickDirectoryFromInput();
+      if (fallbackRoot) {
+        applyHarnessRoot(fallbackRoot, null);
+        showStatus(`Harness project root set to "${fallbackRoot}" (directory selection fallback).`, "info");
+        return;
+      }
+      const manual = window.prompt(
+        "Directory picker unavailable. Enter a root hint/path for harness mode:",
+        currentRoot || ""
+      );
+      if (manual && manual.trim()) {
+        applyHarnessRoot(manual.trim(), null);
+        showStatus(`Harness project root set to "${manual.trim()}".`, "info");
+        return;
+      }
+      showStatus("Project root selection canceled.", "warn");
+    }
+    return {
+      isHarnessMode,
+      getCurrentRoot() {
+        return currentRoot;
+      },
+      setCurrentRoot(value) {
+        currentRoot = value || null;
+      },
+      canResetProjectRoot() {
+        return canResetProjectRoot;
+      },
+      setCanResetProjectRoot(value) {
+        canResetProjectRoot = Boolean(value);
+      },
+      applyHarnessRoot,
+      handleHarnessChangeProjectRoot,
+      openHarnessItem,
+      about() {
+        const opened = window.open(projectGithubUrl, "_blank", "noopener,noreferrer");
+        if (!opened) {
+          showStatus("Popup blocked by the browser. Enable popups to open project page.", "warn");
+        }
+      }
+    };
+  };
+})();

package/clients/shared-web/media/hostApi.js ADDED Viewed

@@ -0,0 +1,213 @@
+(() => {
+  window.createCdxLogicsHostApi = function createCdxLogicsHostApi(options) {
+    const {
+      vscode,
+      debugLog,
+      showStatus,
+      isHarnessMode,
+      handleHarnessChangeProjectRoot,
+      applyHarnessRoot,
+      openHarnessItem,
+      harnessBridge,
+      setCanResetProjectRoot,
+      projectGithubUrl
+    } = options;
+    function post(message) {
+      debugLog("host:post", message);
+      vscode.postMessage(message);
+    }
+    function invokeHostOnly(type, payload, label) {
+      if (isHarnessMode) {
+        showStatus(`${label} requires the VS Code extension host. Action forwarded to harness mock.`, "warn");
+      }
+      post({ type, ...payload });
+    }
+    function confirmLifecycleAction(item, action) {
+      if (!item) {
+        return false;
+      }
+      const itemLabel = item.title ? `${item.id} (${item.title})` : item.id;
+      if (action === "obsolete") {
+        return window.confirm(
+          `Mark ${itemLabel} as obsolete?\n\nThis is a more cautionary lifecycle change and should only be used when the item should no longer be pursued.`
+        );
+      }
+      return window.confirm(`Mark ${itemLabel} as done?`);
+    }
+    const api = {
+      post,
+      ready() {
+        post({ type: "ready" });
+      },
+      refresh() {
+        post({ type: "refresh" });
+      },
+      createItem(kind) {
+        invokeHostOnly("create-item", { kind }, "Create item");
+      },
+      newRequest() {
+        invokeHostOnly("new-request", {}, "New Request");
+      },
+      createCompanionDoc(id, preferredKind) {
+        invokeHostOnly("create-companion-doc", { id, preferredKind }, "Create companion doc");
+      },
+      renameEntry(id) {
+        invokeHostOnly("rename-entry", { id }, "Rename entry");
+      },
+      addReference(id) {
+        invokeHostOnly("add-reference", { id }, "Add reference");
+      },
+      addUsedBy(id) {
+        invokeHostOnly("add-used-by", { id }, "Add used-by link");
+      },
+      fixDocs() {
+        invokeHostOnly("fix-docs", {}, "Fix Logics");
+      },
+      newGuidedRequest() {
+        invokeHostOnly("new-request-guided", {}, "New Request");
+      },
+      launchCodexOverlay() {
+        invokeHostOnly("launch-codex-overlay", {}, "Launch Codex");
+      },
+      launchClaude() {
+        invokeHostOnly("launch-claude", {}, "Launch Claude");
+      },
+      bootstrapLogics() {
+        invokeHostOnly("bootstrap-logics", {}, "Bootstrap Logics");
+      },
+      updateLogicsKit() {
+        invokeHostOnly("update-logics-kit", {}, "Update Logics Kit");
+      },
+      syncCodexOverlay() {
+        invokeHostOnly("sync-codex-overlay", {}, "Publish Global Codex Kit");
+      },
+      repairLogicsKit() {
+        invokeHostOnly("repair-logics-kit", {}, "Repair Logics Kit");
+      },
+      checkEnvironment() {
+        invokeHostOnly("check-environment", {}, "Check Environment");
+      },
+      checkHybridRuntime() {
+        invokeHostOnly("check-hybrid-runtime", {}, "Check Hybrid Runtime");
+      },
+      openHybridInsights() {
+        invokeHostOnly("open-hybrid-insights", {}, "Hybrid Insights");
+      },
+      openLogicsInsights() {
+        invokeHostOnly("open-logics-insights", {}, "Logics Insights");
+      },
+      assistCommitAll() {
+        invokeHostOnly("assist-commit-all", {}, "Commit All Changes");
+      },
+      assistNextStep() {
+        invokeHostOnly("assist-next-step", {}, "Suggest Next Step");
+      },
+      assistTriage(id) {
+        invokeHostOnly("assist-triage", id ? { id } : {}, "Triage Item");
+      },
+      assistDiffRisk() {
+        invokeHostOnly("assist-diff-risk", {}, "Assess Diff Risk");
+      },
+      assistSummarizeValidation() {
+        invokeHostOnly("assist-summarize-validation", {}, "Summarize Validation");
+      },
+      assistSummarizeChangelog() {
+        invokeHostOnly("assist-summarize-changelog", {}, "Generate Changelog Summary");
+      },
+      assistPrepareRelease() {
+        invokeHostOnly("assist-prepare-release", {}, "Prepare Release");
+      },
+      assistPublishRelease() {
+        invokeHostOnly("assist-publish-release", {}, "Publish Release");
+      },
+      assistValidationChecklist() {
+        invokeHostOnly("assist-validation-checklist", {}, "Validation Checklist");
+      },
+      assistDocConsistency() {
+        invokeHostOnly("assist-doc-consistency", {}, "Doc Consistency");
+      },
+      openOnboarding() {
+        invokeHostOnly("open-onboarding", {}, "Getting Started");
+      },
+      selectAgent() {
+        invokeHostOnly("select-agent", {}, "Select Agent");
+      },
+      injectPrompt(prompt, options) {
+        if (!prompt) {
+          return;
+        }
+        invokeHostOnly("inject-prompt", { prompt, options }, "Copy for Assistant");
+      },
+      promote(id) {
+        invokeHostOnly("promote", { id }, "Promote");
+      },
+      markDone(item) {
+        if (!confirmLifecycleAction(item, "done")) {
+          return;
+        }
+        invokeHostOnly("mark-done", { id: item.id }, "Mark as done");
+      },
+      markObsolete(item) {
+        if (!confirmLifecycleAction(item, "obsolete")) {
+          return;
+        }
+        invokeHostOnly("mark-obsolete", { id: item.id }, "Mark as obsolete");
+      },
+      changeStatus(item) {
+        if (!item) {
+          return;
+        }
+        invokeHostOnly("change-status", { id: item.id }, "Change status");
+      },
+      async changeProjectRoot() {
+        if (isHarnessMode) {
+          await handleHarnessChangeProjectRoot();
+          return;
+        }
+        post({ type: "change-project-root" });
+      },
+      resetProjectRoot() {
+        if (isHarnessMode) {
+          applyHarnessRoot(null);
+          if (harnessBridge && typeof harnessBridge.resetProjectRoot === "function") {
+            harnessBridge.resetProjectRoot();
+          }
+          setCanResetProjectRoot(false);
+          showStatus("Harness project root reset to default mock workspace.", "info");
+          return;
+        }
+        post({ type: "reset-project-root" });
+      },
+      about() {
+        if (isHarnessMode) {
+          const opened = window.open(projectGithubUrl, "_blank", "noopener,noreferrer");
+          if (!opened) {
+            showStatus("Popup blocked by the browser. Enable popups to open project page.", "warn");
+          }
+          return;
+        }
+        post({ type: "about" });
+      },
+      openItem(item, mode) {
+        if (!item) {
+          return;
+        }
+        if (isHarnessMode) {
+          if (typeof openHarnessItem === "function") {
+            openHarnessItem(item, mode);
+          }
+          return;
+        }
+        post({ type: mode, id: item.id });
+      }
+    };
+    if (typeof window.assertCdxLogicsHostApiContract === "function") {
+      window.assertCdxLogicsHostApiContract(api);
+    }
+    return api;
+  };
+})();

package/clients/shared-web/media/hostApiContract.js ADDED Viewed

@@ -0,0 +1,55 @@
+(() => {
+  const HOST_API_METHODS = [
+    "post",
+    "ready",
+    "refresh",
+    "createItem",
+    "newRequest",
+    "createCompanionDoc",
+    "renameEntry",
+    "addReference",
+    "addUsedBy",
+    "fixDocs",
+    "newGuidedRequest",
+    "launchCodexOverlay",
+    "launchClaude",
+    "bootstrapLogics",
+    "updateLogicsKit",
+    "syncCodexOverlay",
+    "repairLogicsKit",
+    "checkEnvironment",
+    "checkHybridRuntime",
+    "openHybridInsights",
+    "openLogicsInsights",
+    "assistCommitAll",
+    "assistNextStep",
+    "assistTriage",
+    "assistDiffRisk",
+    "assistSummarizeValidation",
+    "assistSummarizeChangelog",
+    "assistPrepareRelease",
+    "assistPublishRelease",
+    "assistValidationChecklist",
+    "assistDocConsistency",
+    "openOnboarding",
+    "selectAgent",
+    "injectPrompt",
+    "promote",
+    "markDone",
+    "markObsolete",
+    "changeStatus",
+    "changeProjectRoot",
+    "resetProjectRoot",
+    "about",
+    "openItem"
+  ];
+  window.CDX_LOGICS_HOST_API_METHODS = HOST_API_METHODS;
+  window.assertCdxLogicsHostApiContract = function assertCdxLogicsHostApiContract(api) {
+    const missing = HOST_API_METHODS.filter((method) => typeof api?.[method] !== "function");
+    if (missing.length > 0) {
+      throw new Error(`Logics host API is missing required method(s): ${missing.join(", ")}`);
+    }
+    return api;
+  };
+})();

package/clients/shared-web/media/icon.png ADDED Viewed

Binary file