@grifhinz/logics-manager 2.4.0 → 2.5.1

package/clients/viewer/index.html

@@ -23,12 +23,28 @@
       <div class="viewer-topbar__meta" id="viewer-meta">Read-only local viewer</div>
     </div>
     <div class="viewer-topbar__actions">
-      <label class="viewer-auto-refresh" title="Toggle automatic refresh">
-        <input id="viewer-auto-refresh" type="checkbox" checked />
-        <span>Auto</span>
-      </label>
-      <button class="btn" data-action="refresh" type="button" title="Refresh viewer data">Refresh</button>
+      <div class="viewer-refresh-menu">
+        <button class="btn" id="viewer-refresh-menu-button" type="button" title="Refresh options" aria-haspopup="menu" aria-expanded="false" aria-controls="viewer-refresh-menu">Refresh</button>
+        <div class="viewer-refresh-menu__panel" id="viewer-refresh-menu" role="menu" aria-label="Refresh options" hidden>
+          <label class="viewer-auto-refresh" title="Toggle automatic refresh">
+            <input id="viewer-auto-refresh" type="checkbox" checked />
+            <span>Auto</span>
+          </label>
+          <label class="viewer-refresh-menu__interval">
+            <span>Interval</span>
+            <select id="viewer-refresh-interval" aria-label="Automatic refresh interval">
+              <option value="5">5 sec</option>
+              <option value="10">10 sec</option>
+              <option value="15" selected>15 sec</option>
+              <option value="30">30 sec</option>
+              <option value="60">60 sec</option>
+            </select>
+          </label>
+          <button class="btn" data-action="refresh" type="button" title="Refresh viewer data now">Now</button>
+        </div>
+      </div>
       <button class="btn" id="viewer-git" type="button" title="Show Git status">Git</button>
+      <button class="btn" id="viewer-cdx" type="button" title="Show CDX status">CDX</button>
       <button class="btn" id="viewer-insights" type="button" title="Show corpus insights">Insights</button>
       <button class="btn" id="viewer-health" type="button" title="Show lint and audit health">Health</button>
     </div>

package/clients/viewer/viewer.css

@@ -51,6 +51,68 @@
   flex: 0 0 auto;
 }
 
+.viewer-topbar__actions button {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+}
+
+.viewer-git-badges {
+  display: inline-flex;
+  align-items: center;
+  gap: 3px;
+  flex: 0 0 auto;
+}
+
+.viewer-git-badge {
+  display: inline-grid;
+  min-width: 16px;
+  height: 16px;
+  place-items: center;
+  border: 1px solid color-mix(in srgb, currentColor 22%, transparent);
+  border-radius: 999px;
+  padding: 0 4px;
+  font-size: 10px;
+  font-weight: 700;
+  line-height: 1;
+}
+
+.viewer-git-badge--commits {
+  background: color-mix(in srgb, var(--vscode-textLink-foreground, #4ea1ff) 24%, transparent);
+  color: var(--vscode-textLink-foreground, #4ea1ff);
+}
+
+.viewer-git-badge--files {
+  background: rgba(245, 158, 11, 0.18);
+  color: #f59e0b;
+}
+
+.viewer-refresh-menu {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+}
+
+.viewer-refresh-menu__panel {
+  position: absolute;
+  top: calc(100% + 6px);
+  right: 0;
+  z-index: 60;
+  display: grid;
+  gap: 10px;
+  min-width: 180px;
+  padding: 10px;
+  border: 1px solid var(--vscode-panel-border, #333333);
+  border-radius: 6px;
+  background: var(--vscode-editorWidget-background, #202020);
+  color: var(--vscode-foreground, #d4d4d4);
+  box-shadow: 0 12px 32px rgba(0, 0, 0, 0.35);
+}
+
+.viewer-refresh-menu__panel[hidden] {
+  display: none !important;
+}
+
 .viewer-auto-refresh {
   display: inline-flex;
   align-items: center;
@@ -69,6 +131,28 @@
   margin: 0;
 }
 
+.viewer-refresh-menu__interval {
+  display: grid;
+  gap: 5px;
+  color: var(--vscode-descriptionForeground, #9da5b4);
+  font-size: 11px;
+  font-weight: 700;
+  text-transform: uppercase;
+}
+
+.viewer-refresh-menu__interval select {
+  width: 100%;
+  height: 30px;
+  border: 1px solid var(--vscode-panel-border, #333333);
+  border-radius: 4px;
+  background: var(--vscode-dropdown-background, var(--vscode-input-background, #1f1f1f));
+  color: var(--vscode-dropdown-foreground, var(--vscode-input-foreground, #e5e5e5));
+  padding: 0 8px;
+  font-size: 12px;
+  font-weight: 400;
+  text-transform: none;
+}
+
 .viewer-update {
   flex: 0 0 auto;
   display: flex;
@@ -308,6 +392,7 @@
 }
 
 .viewer-git,
+.viewer-cdx,
 .viewer-insights,
 .viewer-health {
   display: grid;
@@ -315,6 +400,7 @@
 }
 
 .viewer-git__summary,
+.viewer-cdx__summary,
 .viewer-insights__summary,
 .viewer-health__summary {
   display: grid;
@@ -322,19 +408,469 @@
   gap: 8px;
 }
 
+.viewer-cdx__workspace {
+  display: grid;
+  grid-template-columns: minmax(280px, 1.35fr) minmax(240px, 0.85fr);
+  gap: 12px;
+  align-items: start;
+}
+
+.viewer-cdx__stack {
+  display: grid;
+  gap: 12px;
+  min-width: 0;
+}
+
+.viewer-cdx__card,
+.viewer-cdx__section {
+  min-width: 0;
+  border: 1px solid var(--vscode-panel-border, #333333);
+  border-radius: 6px;
+  background: var(--vscode-editorWidget-background, #202020);
+}
+
+.viewer-cdx__card {
+  padding: 10px;
+}
+
+.viewer-cdx__label,
+.viewer-cdx__meta {
+  color: var(--vscode-descriptionForeground, #aaaaaa);
+  font-size: 12px;
+}
+
+.viewer-cdx__value {
+  margin-top: 4px;
+  font-size: 16px;
+  font-weight: 700;
+  overflow-wrap: anywhere;
+}
+
+.viewer-cdx__section {
+  padding: 12px;
+}
+
+.viewer-cdx__heading {
+  margin: 0 0 10px;
+  font-size: 13px;
+}
+
+.viewer-cdx__list,
+.viewer-cdx__commands {
+  display: grid;
+  gap: 6px;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.viewer-cdx__row,
+.viewer-cdx__entity {
+  min-width: 0;
+  padding: 9px;
+  border: 1px solid color-mix(in srgb, var(--vscode-panel-border, #333333) 72%, transparent);
+  border-radius: 6px;
+  background: color-mix(in srgb, var(--vscode-editorWidget-background, #202020) 76%, transparent);
+  overflow-wrap: anywhere;
+}
+
+.viewer-cdx__row,
+.viewer-cdx__entity-main {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 8px;
+}
+
+.viewer-cdx__row strong,
+.viewer-cdx__entity-main > span {
+  min-width: 0;
+  text-align: right;
+}
+
+.viewer-cdx__entity-status {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: flex-end;
+  gap: 6px;
+  min-width: 110px;
+}
+
+.viewer-cdx__badge {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 20px;
+  max-width: 100%;
+  border: 1px solid color-mix(in srgb, currentColor 28%, transparent);
+  border-radius: 999px;
+  padding: 2px 8px;
+  font-size: 11px;
+  font-weight: 700;
+  line-height: 1.2;
+}
+
+.viewer-cdx__remaining {
+  display: inline-flex;
+  align-items: baseline;
+  gap: 5px;
+  min-height: 24px;
+  border: 1px solid color-mix(in srgb, currentColor 32%, transparent);
+  border-radius: 999px;
+  padding: 3px 9px;
+  font-size: 11px;
+  font-weight: 700;
+  line-height: 1.2;
+}
+
+.viewer-cdx__remaining span {
+  color: currentColor;
+  opacity: 0.8;
+}
+
+.viewer-cdx__remaining strong {
+  font-size: 13px;
+}
+
+.viewer-cdx__remaining--ok {
+  background: rgba(34, 197, 94, 0.14);
+  color: #22c55e;
+}
+
+.viewer-cdx__remaining--warn {
+  background: rgba(245, 158, 11, 0.16);
+  color: #f59e0b;
+}
+
+.viewer-cdx__remaining--bad {
+  background: rgba(239, 68, 68, 0.16);
+  color: #ef4444;
+}
+
+.viewer-cdx__remaining--neutral {
+  background: color-mix(in srgb, var(--vscode-descriptionForeground, #aaaaaa) 14%, transparent);
+  color: var(--vscode-descriptionForeground, #aaaaaa);
+}
+
+.viewer-cdx__badge--ok {
+  background: rgba(34, 197, 94, 0.14);
+  color: #22c55e;
+}
+
+.viewer-cdx__badge--warn {
+  background: rgba(245, 158, 11, 0.16);
+  color: #f59e0b;
+}
+
+.viewer-cdx__badge--bad {
+  background: rgba(239, 68, 68, 0.16);
+  color: #ef4444;
+}
+
+.viewer-cdx__badge--neutral {
+  background: color-mix(in srgb, var(--vscode-descriptionForeground, #aaaaaa) 14%, transparent);
+  color: var(--vscode-descriptionForeground, #aaaaaa);
+}
+
+.viewer-cdx__pills {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin-top: 8px;
+}
+
+.viewer-cdx__table-wrap {
+  min-width: 0;
+  overflow-x: auto;
+}
+
+.viewer-cdx__table {
+  width: 100%;
+  min-width: 920px;
+  border-collapse: collapse;
+  font-size: 12px;
+}
+
+.viewer-cdx__table th,
+.viewer-cdx__table td {
+  padding: 7px 8px;
+  border-bottom: 1px solid color-mix(in srgb, var(--vscode-panel-border, #333333) 72%, transparent);
+  text-align: left;
+  vertical-align: middle;
+  white-space: nowrap;
+}
+
+.viewer-cdx__table th {
+  color: var(--vscode-descriptionForeground, #aaaaaa);
+  font-size: 10px;
+  font-weight: 700;
+}
+
+.viewer-cdx__table td {
+  color: var(--vscode-foreground, #d4d4d4);
+}
+
+.viewer-cdx__table tbody tr:last-child td {
+  border-bottom: 0;
+}
+
+.viewer-cdx__session-name {
+  font-weight: 700;
+}
+
+.viewer-cdx__pill {
+  display: inline-flex;
+  align-items: baseline;
+  gap: 5px;
+  min-width: 0;
+  max-width: 100%;
+  border-radius: 4px;
+  padding: 3px 6px;
+  background: var(--vscode-input-background, #1f1f1f);
+  color: var(--vscode-descriptionForeground, #aaaaaa);
+  font-size: 11px;
+}
+
+.viewer-cdx__pill strong {
+  min-width: 0;
+  color: var(--vscode-foreground, #d4d4d4);
+  overflow-wrap: anywhere;
+}
+
+.viewer-cdx__commands li {
+  display: grid;
+  grid-template-columns: 22px minmax(0, 1fr);
+  align-items: start;
+  gap: 7px;
+}
+
+.viewer-cdx__commands li > span {
+  display: grid;
+  width: 22px;
+  height: 22px;
+  place-items: center;
+  border-radius: 999px;
+  background: var(--vscode-input-background, #1f1f1f);
+  color: var(--vscode-descriptionForeground, #aaaaaa);
+  font-size: 11px;
+  font-weight: 700;
+}
+
+.viewer-cdx__commands code {
+  display: block;
+  min-width: 0;
+  padding: 7px 9px;
+  border-radius: 6px;
+  background: var(--vscode-textCodeBlock-background, #111111);
+  color: var(--vscode-textPreformat-foreground, #d7ba7d);
+  overflow-wrap: anywhere;
+}
+
+.viewer-cdx__state,
+.viewer-cdx__empty {
+  margin: 0;
+  color: var(--vscode-descriptionForeground, #aaaaaa);
+  overflow-wrap: anywhere;
+}
+
+@media (max-width: 860px) {
+  .viewer-cdx__workspace {
+    grid-template-columns: 1fr;
+  }
+}
+
 .viewer-git__section h2 {
   margin-bottom: 8px;
 }
 
+.viewer-git__workspace {
+  display: grid;
+  grid-template-columns: minmax(120px, 0.45fr) minmax(220px, 0.9fr) minmax(280px, 1.3fr);
+  gap: 12px;
+  align-items: start;
+}
+
+.viewer-git__domains {
+  display: grid;
+  gap: 6px;
+}
+
+.viewer-git__domain,
+.viewer-git__file {
+  width: 100%;
+  min-width: 0;
+  border: 1px solid var(--vscode-panel-border, #333333);
+  border-radius: 6px;
+  background: var(--vscode-editorWidget-background, #202020);
+  color: var(--vscode-foreground, #dddddd);
+  font: inherit;
+  text-align: left;
+  cursor: pointer;
+}
+
+.viewer-git__domain {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  padding: 8px 9px;
+}
+
+.viewer-git__domain-label {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  min-width: 0;
+}
+
+.viewer-git__domain.is-active,
+.viewer-git__file.is-active {
+  border-color: var(--vscode-focusBorder, #4ea1ff);
+  background: color-mix(in srgb, var(--vscode-editorWidget-background, #202020) 72%, var(--vscode-textLink-foreground, #4ea1ff));
+}
+
+.viewer-git__content,
+.viewer-git__detail {
+  min-width: 0;
+}
+
+.viewer-git__panel {
+  min-width: 0;
+  padding: 10px;
+  border: 1px solid var(--vscode-panel-border, #333333);
+  border-radius: 6px;
+  background: color-mix(in srgb, var(--vscode-editorWidget-background, #202020) 72%, transparent);
+}
+
+.viewer-git__panel[hidden] {
+  display: none !important;
+}
+
+.viewer-git__panel-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 10px;
+  margin-bottom: 10px;
+  color: var(--vscode-descriptionForeground, #aaaaaa);
+  font-size: 12px;
+  font-weight: 700;
+  text-transform: uppercase;
+}
+
+.viewer-git__panel-header strong {
+  min-width: 0;
+  overflow-wrap: anywhere;
+  text-align: right;
+}
+
 .viewer-git__files li {
   min-width: 0;
+  overflow-wrap: anywhere;
+}
+
+.viewer-git__commits {
+  display: grid;
+  gap: 6px;
+  margin: 10px 0 0;
+  padding: 0;
+  list-style: none;
+}
+
+.viewer-git__commit-row {
+  min-width: 0;
+  padding: 8px 9px;
+  border: 1px solid var(--vscode-panel-border, #333333);
+  border-radius: 6px;
+  background: var(--vscode-editorWidget-background, #202020);
+}
+
+.viewer-git__commit-main,
+.viewer-git__commit-meta {
+  display: flex;
+  gap: 8px;
+  min-width: 0;
+}
+
+.viewer-git__commit-main {
+  align-items: baseline;
+}
+
+.viewer-git__commit-main strong {
+  min-width: 0;
+  overflow-wrap: anywhere;
+}
+
+.viewer-git__commit-meta {
+  align-items: center;
+  flex-wrap: wrap;
+  margin-top: 4px;
+  color: var(--vscode-descriptionForeground, #aaaaaa);
+  font-size: 12px;
+}
+
+.viewer-git__commit-refs {
+  padding: 2px 6px;
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--vscode-editorWidget-background, #202020) 70%, var(--vscode-textLink-foreground, #4ea1ff));
+  color: var(--vscode-textLink-foreground, #4ea1ff);
+}
+
+.viewer-git__file {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
   padding: 7px 9px;
+}
+
+.viewer-git__file-path {
+  min-width: 0;
+  overflow-wrap: anywhere;
+}
+
+.viewer-git__file-kind {
+  flex: 0 0 auto;
+  padding: 2px 6px;
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--vscode-textLink-foreground, #4ea1ff) 18%, transparent);
+  color: var(--vscode-textLink-foreground, #4ea1ff);
+  font-size: 11px;
+}
+
+.viewer-git__detail {
+  padding: 10px;
   border: 1px solid var(--vscode-panel-border, #333333);
   border-radius: 6px;
   background: var(--vscode-editorWidget-background, #202020);
+}
+
+.viewer-git__detail-title {
+  margin-bottom: 8px;
+  color: var(--vscode-descriptionForeground, #aaaaaa);
+  font-size: 12px;
+  font-weight: 700;
+  text-transform: uppercase;
+}
+
+.viewer-git__diff {
+  min-height: 160px;
   overflow-wrap: anywhere;
 }
 
+.viewer-git__diff-meta {
+  margin-bottom: 8px;
+  color: var(--vscode-descriptionForeground, #aaaaaa);
+  font-size: 12px;
+}
+
+.viewer-git__diff pre {
+  max-height: 58vh;
+  overflow: auto;
+  margin: 0;
+  white-space: pre;
+}
+
 .viewer-git__commit,
 .viewer-git__state {
   margin: 0;
@@ -354,6 +890,10 @@
   .viewer-document {
     inset: 8px;
   }
+
+  .viewer-git__workspace {
+    grid-template-columns: 1fr;
+  }
 }
 
 .viewer-document__content a {
@@ -555,8 +1095,13 @@
     flex: 1 1 0;
   }
 
-  .viewer-auto-refresh {
-    flex: 0 0 auto;
+  .viewer-refresh-menu {
+    flex: 1 1 0;
+  }
+
+  .viewer-refresh-menu > .btn {
+    width: 100%;
+    justify-content: center;
   }
 
   .viewer-document {

package/logics_manager/audit.py

@@ -172,9 +172,9 @@ def _has_mermaid_block(text: str) -> bool:
 def _companion_doc_is_mature(doc: "DocMeta") -> bool:
     status = _status_normalized(doc.status)
     if doc.kind.kind == "product":
-        return status in {"active", "validated", "archived"}
+        return status in {"active", "accepted", "validated", "settled", "archived"}
     if doc.kind.kind == "architecture":
-        return status in {"accepted", "superseded", "archived"}
+        return status in {"accepted", "validated", "superseded", "settled", "archived"}
     return False
 
 

package/logics_manager/cli.py

@@ -195,15 +195,21 @@ def _find_executable_paths(command: str) -> list[str]:
 def _print_path_conflict_guidance(paths: list[str]) -> None:
     if len(paths) <= 1:
         return
+    path_lines = [f"  - {path}" for path in paths]
     print(
         "\n".join(
             [
                 "",
                 "Multiple logics-manager executables are on PATH. If --version still shows an older release, an earlier install is taking precedence.",
+                "Detected executables:",
+                *path_lines,
                 "Diagnose with:",
-                "  command -v -a logics-manager",
+                "  type -a logics-manager",
+                "  whence -a logics-manager  # zsh",
                 "  pipx list",
                 "  npm list -g @grifhinz/logics-manager --depth=0",
+                "",
+                "If you recently changed installs in zsh, run `rehash` or open a new terminal before retrying.",
             ]
         )
     )

package/logics_manager/insights.py

@@ -10,7 +10,7 @@ from pathlib import Path
 WORKFLOW_KINDS = ("request", "backlog", "task")
 COMPANION_KINDS = ("product", "architecture")
 OPEN_STATUSES = {"Draft", "Ready", "In progress", "Blocked"}
-CLOSED_STATUSES = {"Done", "Archived"}
+CLOSED_STATUSES = {"Done", "Settled", "Archived"}
 
 
 @dataclass(frozen=True)

package/logics_manager/lint.py

@@ -25,8 +25,8 @@ KINDS = {
     "request": Kind("logics/request", "req", False, ("From version", "Understanding", "Confidence"), ("Draft", "Ready", "In progress", "Blocked", "Done", "Obsolete", "Archived")),
     "backlog": Kind("logics/backlog", "item", True, ("From version", "Understanding", "Confidence", "Progress"), ("Draft", "Ready", "In progress", "Blocked", "Done", "Obsolete", "Archived")),
     "task": Kind("logics/tasks", "task", True, ("From version", "Understanding", "Confidence", "Progress"), ("Draft", "Ready", "In progress", "Blocked", "Done", "Obsolete", "Archived")),
-    "product": Kind("logics/product", "prod", False, ("Date", "Status", "Related request", "Related backlog", "Related task", "Related architecture", "Reminder"), ("Draft", "Proposed", "Active", "Validated", "Rejected", "Superseded", "Archived")),
-    "architecture": Kind("logics/architecture", "adr", False, ("Date", "Status", "Drivers", "Related request", "Related backlog", "Related task", "Reminder"), ("Draft", "Proposed", "Accepted", "Rejected", "Superseded", "Archived")),
+    "product": Kind("logics/product", "prod", False, ("Date", "Status", "Related request", "Related backlog", "Related task", "Related architecture", "Reminder"), ("Draft", "Proposed", "Active", "Accepted", "Validated", "Rejected", "Superseded", "Settled", "Archived")),
+    "architecture": Kind("logics/architecture", "adr", False, ("Date", "Status", "Drivers", "Related request", "Related backlog", "Related task", "Reminder"), ("Draft", "Proposed", "Accepted", "Validated", "Rejected", "Superseded", "Settled", "Archived")),
 }
 
 WORKFLOW_KINDS = {"request", "backlog", "task"}