@felixdotgo/aidlc-kit 0.1.0 → 0.2.0

package/dist/assets/ui/dashboard.css

@@ -0,0 +1,414 @@
+/*
+ * AI-DLC dashboard theme layer, loaded after the vendored Bulma 1.0.3.
+ *
+ * - Keeps Bulma's default palette (primary teal, link blue).
+ * - Flat, enterprise look: white canvas, 1px hairline borders, small radii,
+ *   no elevation except overlays (drawer, modal, toast).
+ * - Dark mode follows the system automatically: Bulma switches its scheme
+ *   variables inside `@media (prefers-color-scheme: dark)`, and every colour
+ *   below is expressed through `--bulma-*` variables so it follows along.
+ *   Never override scheme lightness (`--bulma-*-l`) on a bare `:root` here:
+ *   it has the same specificity as Bulma's media-query block and would pin
+ *   one scheme.
+ * - Custom components use the `ad-` prefix to avoid clashing with Bulma.
+ */
+
+:root {
+  --bulma-family-primary: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif;
+  --bulma-family-secondary: var(--bulma-family-primary);
+  --bulma-family-code: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;
+  --bulma-radius: 4px;
+  --bulma-radius-small: 3px;
+  --bulma-radius-medium: 4px;
+  --bulma-radius-large: 6px;
+  --ad-radius: 4px;
+  --ad-ring: 0 0 0 1px var(--bulma-border-weak);
+  --ad-ring-strong: 0 0 0 1px var(--bulma-border);
+  --ad-shadow-sm: none;
+  --ad-shadow: none;
+  --ad-shadow-lg: 0 8px 24px -4px hsla(221, 30%, 10%, 0.22), 0 0 1px hsla(221, 30%, 10%, 0.3);
+  --ad-surface: var(--bulma-scheme-main);
+  --ad-canvas: var(--bulma-scheme-main);
+  --ad-subtle: var(--bulma-scheme-main-bis);
+  --ad-muted: var(--bulma-text-weak);
+  --ad-log-bg: hsl(222, 22%, 9%);
+  --ad-log-fg: hsl(220, 14%, 86%);
+  --ad-transition: 160ms ease;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --ad-shadow-lg: 0 12px 32px -6px hsla(0, 0%, 0%, 0.7), 0 0 0 1px hsla(0, 0%, 100%, 0.06);
+    --ad-surface: var(--bulma-scheme-main);
+    --ad-canvas: var(--bulma-scheme-main);
+    --ad-subtle: var(--bulma-scheme-main-bis);
+    --ad-log-bg: hsl(222, 25%, 6%);
+  }
+}
+
+html { background-color: var(--ad-canvas); scroll-padding-top: 5rem; }
+body { min-height: 100vh; font-feature-settings: "cv11", "ss01"; -webkit-font-smoothing: antialiased; }
+code { border-radius: var(--bulma-radius-small); font-size: 0.85em; }
+[hidden] { display: none !important; }
+:focus-visible { outline: 2px solid var(--bulma-link); outline-offset: 2px; }
+
+/* ---------- App header ---------- */
+.ad-header {
+  position: sticky; top: 0; z-index: 30;
+  background: var(--ad-surface);
+  border-bottom: 1px solid var(--bulma-border-weak);
+}
+.ad-header-inner { display: flex; align-items: center; gap: 1rem; min-height: 3.75rem; flex-wrap: wrap; padding-block: 0.5rem; }
+.ad-brand { display: flex; align-items: center; gap: 0.5rem; color: var(--bulma-text-strong); font-weight: 700; font-size: 1.1rem; letter-spacing: -0.01em; }
+.ad-brand:hover { color: var(--bulma-text-strong); }
+.ad-logo {
+  display: inline-grid; place-items: center; width: 1.75rem; height: 1.75rem; border-radius: var(--ad-radius);
+  background: var(--bulma-primary); color: var(--bulma-primary-invert); font-size: 0.9rem; font-weight: 800;
+}
+.ad-header-actions { margin-left: auto; display: flex; align-items: center; gap: 0.5rem; flex-wrap: wrap; }
+.ad-main { padding-block: 1.5rem 3rem; padding-inline: 0; }
+
+/* ---------- Keyboard hint ---------- */
+kbd, .ad-kbd {
+  display: inline-block; min-width: 1.25rem; padding: 0 0.3rem; margin-left: 0.4rem;
+  font-family: var(--bulma-family-code); font-size: 0.7rem; line-height: 1.25rem; text-align: center;
+  color: inherit; opacity: 0.75; border: 1px solid currentColor; border-radius: 0.3rem;
+}
+
+/* ---------- Generic dot / pill ---------- */
+.ad-dot { display: inline-block; width: 0.5rem; height: 0.5rem; border-radius: 999px; background: currentColor; flex: none; }
+.ad-pill {
+  display: inline-flex; align-items: center; gap: 0.375rem; white-space: nowrap;
+  padding: 0.0625rem 0.45rem; border-radius: var(--bulma-radius-small); font-size: 0.72rem; font-weight: 600; line-height: 1.4;
+  background: var(--bulma-scheme-main-ter); color: var(--bulma-text);
+  border: 1px solid var(--bulma-border-weak);
+}
+.ad-pill.is-info { background: var(--bulma-info-soft); color: var(--bulma-info-bold); border-color: transparent; }
+.ad-pill.is-success { background: var(--bulma-success-soft); color: var(--bulma-success-bold); border-color: transparent; }
+.ad-pill.is-warning { background: var(--bulma-warning-soft); color: var(--bulma-warning-bold); border-color: transparent; }
+.ad-pill.is-danger { background: var(--bulma-danger-soft); color: var(--bulma-danger-bold); border-color: transparent; }
+.ad-pill.is-primary { background: var(--bulma-primary-soft); color: var(--bulma-primary-bold); border-color: transparent; }
+.ad-pill.is-link { background: var(--bulma-link-soft); color: var(--bulma-link-bold); border-color: transparent; }
+.ad-pill.is-ghost { background: transparent; color: var(--ad-muted); }
+.ad-pill.is-live .ad-dot { animation: ad-pulse 1.8s ease-in-out infinite; }
+@keyframes ad-pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.35; } }
+
+/* ---------- Soft buttons (Bulma's is-light stays bright in dark mode) ---------- */
+.button.ad-soft { border-color: transparent; }
+.button.ad-soft.is-warning { background: var(--bulma-warning-soft); color: var(--bulma-warning-bold); }
+.button.ad-soft.is-link { background: var(--bulma-link-soft); color: var(--bulma-link-bold); }
+.button.ad-soft.is-danger { background: var(--bulma-danger-soft); color: var(--bulma-danger-bold); }
+.button.ad-soft:hover { filter: brightness(0.96); }
+@media (prefers-color-scheme: dark) { .button.ad-soft:hover { filter: brightness(1.2); } }
+
+/* ---------- Stat cards ---------- */
+.ad-stats { display: grid; grid-template-columns: repeat(auto-fit, minmax(9.5rem, 1fr)); gap: 0.875rem; margin-bottom: 1.5rem; }
+.ad-stat {
+  display: flex; flex-direction: column; gap: 0.25rem; padding: 0.9rem 1rem; border-radius: var(--ad-radius);
+  background: var(--ad-surface); box-shadow: var(--ad-ring), var(--ad-shadow-sm); position: relative; overflow: hidden;
+  color: inherit; text-align: left; border: 0; font: inherit; cursor: pointer; transition: box-shadow var(--ad-transition), background var(--ad-transition);
+}
+.ad-stat:hover { box-shadow: var(--ad-ring-strong); background: var(--ad-subtle); }
+.ad-stat[aria-pressed="true"] { box-shadow: 0 0 0 2px var(--ad-accent, var(--bulma-link)); }
+.ad-stat::before { content: ""; position: absolute; inset: 0 auto 0 0; width: 3px; background: var(--ad-accent, var(--bulma-border)); }
+.ad-stat-label { font-size: 0.75rem; font-weight: 600; text-transform: uppercase; letter-spacing: 0.05em; color: var(--ad-muted); display: flex; align-items: center; gap: 0.4rem; }
+.ad-stat-label .ad-dot { color: var(--ad-accent, var(--ad-muted)); }
+.ad-stat-value { font-size: 1.6rem; font-weight: 700; line-height: 1.1; color: var(--bulma-text-strong); font-variant-numeric: tabular-nums; }
+.ad-stat.is-info { --ad-accent: var(--bulma-info); }
+.ad-stat.is-warning { --ad-accent: var(--bulma-warning); }
+.ad-stat.is-success { --ad-accent: var(--bulma-success); }
+.ad-stat.is-danger { --ad-accent: var(--bulma-danger); }
+.ad-stat.is-primary { --ad-accent: var(--bulma-primary); }
+
+/* ---------- Needs your review ---------- */
+.ad-attention {
+  margin-bottom: 1.5rem; border-radius: var(--ad-radius); overflow: hidden;
+  background: var(--ad-surface); box-shadow: 0 0 0 1px var(--bulma-warning), var(--ad-shadow-sm);
+}
+.ad-attention-head {
+  display: flex; align-items: center; gap: 0.6rem; padding: 0.7rem 1rem;
+  background: var(--bulma-warning-soft); color: var(--bulma-warning-bold); font-weight: 700; font-size: 0.9rem;
+}
+.ad-attention-head .ad-count { margin-left: auto; }
+.ad-attention-list { list-style: none; margin: 0; padding: 0; }
+.ad-attention-item { display: flex; align-items: center; gap: 0.75rem; padding: 0.65rem 1rem; border-top: 1px solid var(--bulma-border-weak); flex-wrap: wrap; }
+.ad-attention-item .ad-title { font-weight: 600; color: var(--bulma-text-strong); flex: 1 1 14rem; min-width: 0; }
+.ad-attention-item .ad-actions { margin-left: auto; }
+
+/* ---------- Toolbar ---------- */
+.ad-toolbar { display: flex; align-items: center; gap: 0.625rem; margin-bottom: 1rem; flex-wrap: wrap; }
+.ad-search { position: relative; flex: 1 1 16rem; max-width: 26rem; }
+.ad-search .input { padding-left: 2.1rem; padding-right: 2.2rem; }
+.ad-search-icon { position: absolute; left: 0.7rem; top: 50%; transform: translateY(-50%); color: var(--ad-muted); pointer-events: none; z-index: 5; }
+.ad-search kbd { position: absolute; right: 0.6rem; top: 50%; transform: translateY(-50%); margin: 0; color: var(--ad-muted); pointer-events: none; }
+.ad-toolbar .select select { min-width: 9rem; }
+.ad-toolbar-end { margin-left: auto; display: flex; align-items: center; gap: 0.625rem; }
+.ad-segmented { display: inline-flex; padding: 0.2rem; gap: 0.2rem; border-radius: var(--bulma-radius); background: var(--ad-subtle); box-shadow: inset 0 0 0 1px var(--bulma-border-weak); }
+.ad-segmented button {
+  border: 0; background: transparent; color: var(--ad-muted); font: inherit; font-size: 0.82rem; font-weight: 600;
+  padding: 0.3rem 0.8rem; border-radius: calc(var(--bulma-radius) - 0.15rem); cursor: pointer; transition: background var(--ad-transition), color var(--ad-transition);
+}
+.ad-segmented button:hover { color: var(--bulma-text-strong); }
+.ad-segmented button.is-active { background: var(--ad-surface); color: var(--bulma-text-strong); box-shadow: var(--ad-ring); }
+.ad-result-count { font-size: 0.8rem; color: var(--ad-muted); }
+
+/* ---------- Kanban ---------- */
+.ad-board { display: grid; grid-template-columns: repeat(5, minmax(15rem, 1fr)); gap: 0.75rem; overflow-x: auto; padding-bottom: 0.5rem; align-items: start; }
+.ad-column {
+  display: flex; flex-direction: column; min-height: 12rem; max-height: calc(100vh - 14rem); border-radius: var(--ad-radius);
+  background: var(--ad-subtle);
+}
+.ad-column-head { display: flex; align-items: center; gap: 0.5rem; padding: 0.75rem 0.875rem 0.5rem; }
+.ad-column-title { font-size: 0.75rem; font-weight: 700; text-transform: uppercase; letter-spacing: 0.05em; color: var(--ad-muted); }
+.ad-column-head .ad-step-index { color: var(--ad-muted); font-size: 0.72rem; font-variant-numeric: tabular-nums; }
+.ad-count {
+  margin-left: auto; min-width: 1.5rem; padding: 0 0.45rem; border-radius: 999px; text-align: center;
+  font-size: 0.72rem; font-weight: 700; line-height: 1.35rem; background: var(--ad-surface); color: var(--ad-muted); box-shadow: var(--ad-ring);
+}
+.ad-column-body { display: flex; flex-direction: column; gap: 0.5rem; padding: 0.25rem 0.625rem 0.75rem; overflow-y: auto; }
+.ad-column-empty { margin: 0.5rem 0.25rem; padding: 1.25rem 0.5rem; border: 1px dashed var(--bulma-border); border-radius: var(--bulma-radius); text-align: center; font-size: 0.8rem; color: var(--ad-muted); }
+
+/* ---------- Task card ---------- */
+.ad-card {
+  position: relative; display: flex; flex-direction: column; gap: 0.5rem; padding: 0.8rem 0.875rem 0.8rem 1rem;
+  border-radius: var(--ad-radius); background: var(--ad-surface); box-shadow: var(--ad-ring);
+  transition: box-shadow var(--ad-transition), background var(--ad-transition);
+}
+.ad-card::before { content: ""; position: absolute; left: 0; top: 0; bottom: 0; width: 3px; border-radius: var(--ad-radius) 0 0 var(--ad-radius); background: var(--ad-status-color, var(--bulma-border)); }
+.ad-card:hover { box-shadow: var(--ad-ring-strong); background: var(--ad-subtle); }
+.ad-card.is-attention { box-shadow: 0 0 0 1px var(--bulma-warning); }
+.ad-card-top { display: flex; align-items: center; gap: 0.5rem; }
+.ad-card-id { font-family: var(--bulma-family-code); font-size: 0.72rem; color: var(--ad-muted); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; min-width: 0; }
+.ad-card-id:hover { color: var(--bulma-link); }
+.ad-card-top .ad-pill { margin-left: auto; }
+.ad-card-title { font-weight: 600; font-size: 0.92rem; line-height: 1.35; color: var(--bulma-text-strong); word-break: break-word; }
+.ad-card-title a { color: inherit; }
+.ad-card-title a:hover { color: var(--bulma-link); }
+.ad-card-meta { display: flex; flex-wrap: wrap; gap: 0.35rem; align-items: center; }
+.ad-card-foot { display: flex; align-items: center; gap: 0.5rem; font-size: 0.75rem; color: var(--ad-muted); }
+.ad-card-foot .ad-areas { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; min-width: 0; }
+.ad-card-foot .button { margin-left: auto; }
+
+[data-status="active"] { --ad-status-color: var(--bulma-info); }
+[data-status="blocked_on_user"] { --ad-status-color: var(--bulma-warning); }
+[data-status="paused"] { --ad-status-color: var(--bulma-border); }
+[data-status="done"] { --ad-status-color: var(--bulma-success); }
+[data-status="closed"], [data-status="superseded"], [data-handoff="true"] { --ad-status-color: var(--bulma-danger); }
+
+/* ---------- Phase stepper (mini, horizontal) ---------- */
+.ad-steps { display: flex; gap: 3px; width: 100%; }
+.ad-steps > span { flex: 1; height: 4px; border-radius: 999px; background: var(--bulma-border-weak); }
+.ad-steps > span.is-complete { background: var(--bulma-primary); }
+.ad-steps > span.is-current { background: var(--bulma-primary); box-shadow: 0 0 0 2px var(--bulma-primary-soft); }
+.ad-steps.is-done > span { background: var(--bulma-success); }
+
+/* ---------- Phase stepper (horizontal, detail page and side panel) ---------- */
+.ad-stepper {
+  list-style: none; display: flex; margin: 0 0 1.25rem; padding: 0.85rem 1rem; overflow-x: auto;
+  border-radius: var(--ad-radius); background: var(--ad-surface); box-shadow: var(--ad-ring);
+}
+.ad-stepper li { flex: 1 0 auto; display: flex; align-items: center; gap: 0.6rem; }
+.ad-stepper li::after { content: ""; flex: 1 1 auto; min-width: 1.5rem; height: 2px; margin: 0 0.75rem 0 0.25rem; background: var(--bulma-border-weak); }
+.ad-stepper li:last-child { flex: 0 0 auto; min-width: 0; }
+.ad-stepper li:last-child::after { display: none; }
+.ad-stepper li.is-complete::after { background: var(--bulma-primary); }
+.ad-stepper-marker {
+  flex: none; display: grid; place-items: center; width: 1.5rem; height: 1.5rem; border-radius: 999px;
+  font-size: 0.72rem; font-weight: 700; background: var(--ad-surface); color: var(--ad-muted); box-shadow: inset 0 0 0 2px var(--bulma-border);
+}
+.ad-stepper li.is-complete .ad-stepper-marker { background: var(--bulma-primary); color: var(--bulma-primary-invert); box-shadow: none; }
+.ad-stepper li.is-current .ad-stepper-marker { color: var(--bulma-primary-bold); box-shadow: inset 0 0 0 2px var(--bulma-primary), 0 0 0 3px var(--bulma-primary-soft); }
+.ad-stepper-text { display: flex; flex-direction: column; line-height: 1.25; white-space: nowrap; }
+.ad-stepper-text strong { font-size: 0.85rem; text-transform: capitalize; color: var(--bulma-text-strong); }
+.ad-stepper li:not(.is-current):not(.is-complete) .ad-stepper-text strong { color: var(--ad-muted); font-weight: 500; }
+.ad-stepper-text small { font-size: 0.72rem; color: var(--ad-muted); }
+.ad-stepper li.is-current .ad-stepper-text small { color: var(--bulma-primary-bold); font-weight: 600; }
+
+/* ---------- List view ---------- */
+.ad-table-wrap { border-radius: var(--ad-radius); background: var(--ad-surface); box-shadow: var(--ad-ring); overflow-x: auto; }
+.ad-table { width: 100%; margin: 0 !important; background: transparent; font-size: 0.875rem; }
+.ad-table th { font-size: 0.72rem; font-weight: 700; text-transform: uppercase; letter-spacing: 0.05em; color: var(--ad-muted) !important; background: var(--ad-subtle); white-space: nowrap; border-color: var(--bulma-border-weak) !important; }
+.ad-table td { vertical-align: middle; border-color: var(--bulma-border-weak) !important; }
+.ad-table tbody tr { transition: background var(--ad-transition); }
+.ad-table tbody tr:hover { background: var(--ad-subtle); }
+.ad-table tbody tr:last-child td { border-bottom: 0; }
+.ad-table .ad-steps { min-width: 6rem; }
+.ad-table td.is-empty { text-align: center; color: var(--ad-muted); padding: 2rem; }
+
+/* ---------- Empty states ---------- */
+.ad-empty { text-align: center; padding: 3.5rem 1rem; border-radius: var(--ad-radius); background: var(--ad-surface); box-shadow: var(--ad-ring); }
+.ad-empty-icon { font-size: 2.25rem; line-height: 1; margin-bottom: 0.75rem; }
+.ad-empty h2 { font-size: 1.1rem; font-weight: 700; color: var(--bulma-text-strong); margin-bottom: 0.35rem; }
+.ad-empty p { color: var(--ad-muted); margin-bottom: 1.25rem; }
+.ad-no-match { display: none; text-align: center; padding: 1.5rem; color: var(--ad-muted); }
+.ad-no-match.is-visible { display: block; }
+
+/* ---------- Panels (detail page) ---------- */
+.ad-panel { border-radius: var(--ad-radius); background: var(--ad-surface); box-shadow: var(--ad-ring); margin-bottom: 1rem; overflow: hidden; }
+.ad-panel-head { display: flex; align-items: center; gap: 0.6rem; padding: 0.65rem 1.1rem; border-bottom: 1px solid var(--bulma-border-weak); }
+.ad-panel-head h2, .ad-panel-head h3 { font-size: 0.75rem; font-weight: 700; text-transform: uppercase; letter-spacing: 0.05em; color: var(--ad-muted); margin: 0; }
+.ad-panel-head .ad-count, .ad-panel-head .ad-panel-tools { margin-left: auto; }
+.ad-panel-tools { display: flex; gap: 0.4rem; }
+.ad-panel-body { padding: 1rem 1.1rem; }
+.ad-panel-body.is-flush { padding: 0; }
+.ad-panel .ad-table th:first-child, .ad-panel .ad-table td:first-child { padding-left: 1.1rem; }
+.ad-panel .ad-table th:last-child, .ad-panel .ad-table td:last-child { padding-right: 1.1rem; }
+.ad-panel .ad-empty-line { padding: 1rem 1.1rem; color: var(--ad-muted); font-size: 0.875rem; }
+.ad-panel.is-warning { box-shadow: 0 0 0 1px var(--bulma-warning); }
+.ad-panel.is-warning > .ad-panel-head { background: var(--bulma-warning-soft); color: var(--bulma-warning-bold); border-bottom-color: transparent; }
+.ad-panel.is-warning > .ad-panel-head h2, .ad-panel.is-warning > .ad-panel-head h3 { color: inherit; }
+.ad-panel.is-danger { box-shadow: 0 0 0 1px var(--bulma-danger); }
+.ad-panel.is-danger > .ad-panel-head { background: var(--bulma-danger-soft); color: var(--bulma-danger-bold); border-bottom-color: transparent; }
+.ad-panel.is-danger > .ad-panel-head h2 { color: inherit; }
+.ad-panel.is-success { box-shadow: 0 0 0 1px var(--bulma-success); }
+
+/* ---------- Detail page header ---------- */
+.ad-breadcrumb { display: inline-flex; align-items: center; gap: 0.35rem; font-size: 0.85rem; color: var(--ad-muted); margin-bottom: 0.75rem; }
+.ad-breadcrumb:hover { color: var(--bulma-link); }
+.ad-page-title { font-size: 1.5rem; font-weight: 700; letter-spacing: -0.02em; line-height: 1.25; color: var(--bulma-text-strong); margin-bottom: 0.5rem; word-break: break-word; }
+.ad-page-sub { display: flex; flex-wrap: wrap; align-items: center; gap: 0.5rem; margin-bottom: 1rem; }
+.ad-page-sub code { color: var(--ad-muted); background: var(--bulma-scheme-main-ter); }
+
+/* ---------- Meta list (sidebar) ---------- */
+.ad-meta { display: grid; grid-template-columns: auto 1fr; gap: 0.55rem 1rem; margin: 0; font-size: 0.85rem; }
+.ad-meta dt { color: var(--ad-muted); font-weight: 500; }
+.ad-meta dd { margin: 0; color: var(--bulma-text-strong); text-align: right; word-break: break-word; min-width: 0; }
+.ad-sticky { position: sticky; top: 5rem; }
+
+/* ---------- Gate view ---------- */
+.ad-gate-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(12rem, 1fr)); gap: 0.75rem; margin-bottom: 1rem; }
+.ad-gate-cell { padding: 0.65rem 0.8rem; border-radius: var(--bulma-radius); background: var(--ad-subtle); box-shadow: var(--ad-ring); }
+.ad-gate-cell small { display: block; font-size: 0.7rem; font-weight: 600; text-transform: uppercase; letter-spacing: 0.05em; color: var(--ad-muted); margin-bottom: 0.15rem; }
+.ad-gate-cell span { font-size: 0.875rem; color: var(--bulma-text-strong); }
+.ad-subhead { font-size: 0.75rem; font-weight: 700; text-transform: uppercase; letter-spacing: 0.05em; color: var(--ad-muted); margin: 1rem 0 0.5rem; }
+.ad-plain-list { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 0.35rem; font-size: 0.875rem; }
+.ad-plain-list li { display: flex; align-items: baseline; gap: 0.5rem; flex-wrap: wrap; }
+.ad-callout { display: flex; gap: 0.6rem; align-items: flex-start; margin-top: 1rem; padding: 0.75rem 0.9rem; border-radius: var(--bulma-radius); background: var(--bulma-warning-soft); color: var(--bulma-warning-bold); font-weight: 600; font-size: 0.9rem; }
+
+/* ---------- Artifacts accordion ---------- */
+.ad-artifact { border-top: 1px solid var(--bulma-border-weak); }
+.ad-artifact:first-child { border-top: 0; }
+.ad-artifact > summary {
+  display: flex; align-items: center; gap: 0.6rem; padding: 0.8rem 1.1rem; cursor: pointer; list-style: none;
+  font-weight: 600; color: var(--bulma-text-strong); transition: background var(--ad-transition);
+}
+.ad-artifact > summary::-webkit-details-marker { display: none; }
+.ad-artifact > summary::before { content: "›"; display: inline-block; width: 0.75rem; font-size: 1.1rem; line-height: 1; color: var(--ad-muted); transition: transform var(--ad-transition); }
+.ad-artifact[open] > summary::before { transform: rotate(90deg); }
+.ad-artifact > summary:hover { background: var(--ad-subtle); }
+.ad-artifact > summary code { margin-left: auto; font-weight: 400; color: var(--ad-muted); background: transparent; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; max-width: 60%; }
+.ad-artifact .artifact { padding: 0.25rem 1.25rem 1.25rem 2.5rem; max-height: 40rem; overflow: auto; }
+.content.artifact { font-size: 0.92rem; }
+.content.artifact h1, .content.artifact h2, .content.artifact h3 { margin-top: 1.25em; margin-bottom: 0.5em; }
+.content.artifact h1 { font-size: 1.35rem; }
+.content.artifact h2 { font-size: 1.1rem; padding-bottom: 0.3rem; border-bottom: 1px solid var(--bulma-border-weak); }
+.content.artifact h3 { font-size: 1rem; }
+.content.artifact table { font-size: 0.82rem; }
+.content.artifact pre { background: var(--bulma-scheme-main-ter); padding: 0.75rem 1rem; border-radius: var(--bulma-radius); overflow: auto; }
+.content.artifact blockquote { border-left-color: var(--bulma-primary); background: var(--bulma-scheme-main-ter); }
+
+/* ---------- Terminal log ---------- */
+.ad-terminal { border-radius: var(--ad-radius); overflow: hidden; background: var(--ad-log-bg); margin-bottom: 1rem; }
+.ad-terminal-head { display: flex; align-items: center; gap: 0.5rem; padding: 0.55rem 0.9rem; background: hsla(0, 0%, 100%, 0.04); border-bottom: 1px solid hsla(0, 0%, 100%, 0.06); color: hsl(220, 10%, 70%); font-size: 0.8rem; }
+.ad-terminal-head .ad-lights { display: none; }
+.ad-terminal-head .ad-lights span { width: 0.65rem; height: 0.65rem; border-radius: 999px; background: hsl(0, 0%, 35%); }
+.ad-terminal-head .ad-lights span:nth-child(1) { background: hsl(4, 85%, 62%); }
+.ad-terminal-head .ad-lights span:nth-child(2) { background: hsl(40, 90%, 58%); }
+.ad-terminal-head .ad-lights span:nth-child(3) { background: hsl(140, 55%, 50%); }
+.ad-terminal-head strong { color: hsl(220, 14%, 90%); font-weight: 600; }
+.ad-terminal-tools { margin-left: auto; display: flex; gap: 0.35rem; }
+.ad-terminal-tools button {
+  font: inherit; font-size: 0.72rem; padding: 0.15rem 0.55rem; border-radius: 0.35rem; cursor: pointer;
+  color: hsl(220, 10%, 78%); background: hsla(0, 0%, 100%, 0.06); border: 1px solid hsla(0, 0%, 100%, 0.1);
+}
+.ad-terminal-tools button:hover { background: hsla(0, 0%, 100%, 0.12); color: #fff; }
+.ad-terminal-tools button[aria-pressed="true"] { color: hsl(171, 80%, 60%); border-color: hsla(171, 80%, 60%, 0.4); }
+.log-panel {
+  height: 24rem; overflow: auto; padding: 0.75rem 0.9rem; margin: 0;
+  font-family: var(--bulma-family-code); font-size: 0.78rem; line-height: 1.55; color: var(--ad-log-fg); white-space: pre-wrap; word-break: break-word;
+}
+.ad-log-line { display: grid; grid-template-columns: auto auto 1fr; gap: 0.75rem; }
+.ad-log-time { color: hsl(220, 10%, 50%); }
+.ad-log-type { color: hsl(200, 80%, 66%); min-width: 8ch; }
+.ad-log-line.is-error .ad-log-type, .ad-log-line.is-error .ad-log-text { color: hsl(0, 85%, 70%); }
+.ad-log-line.is-warn .ad-log-type { color: hsl(40, 90%, 62%); }
+.ad-log-line.is-ok .ad-log-type { color: hsl(140, 55%, 60%); }
+.ad-log-line.is-agent .ad-log-type { color: hsl(171, 80%, 55%); }
+.ad-log-muted { color: hsl(220, 10%, 50%); font-style: italic; }
+
+/* ---------- Toasts ---------- */
+.ad-toasts { position: fixed; right: 1rem; bottom: 1rem; z-index: 100; display: flex; flex-direction: column; gap: 0.5rem; max-width: min(26rem, calc(100vw - 2rem)); pointer-events: none; }
+.ad-toast {
+  pointer-events: auto; display: flex; align-items: flex-start; gap: 0.65rem; padding: 0.75rem 0.9rem; border-radius: var(--bulma-radius-medium);
+  background: var(--ad-surface); color: var(--bulma-text-strong); box-shadow: var(--ad-ring), var(--ad-shadow-lg);
+  border-left: 4px solid var(--ad-accent, var(--bulma-info)); font-size: 0.875rem; animation: ad-toast-in 200ms ease-out;
+}
+.ad-toast.is-success { --ad-accent: var(--bulma-success); }
+.ad-toast.is-danger { --ad-accent: var(--bulma-danger); }
+.ad-toast.is-warning { --ad-accent: var(--bulma-warning); }
+.ad-toast-icon { flex: none; font-weight: 800; color: var(--ad-accent, var(--bulma-info)); }
+.ad-toast-body { flex: 1; min-width: 0; word-break: break-word; }
+.ad-toast-body small { display: block; color: var(--ad-muted); margin-top: 0.15rem; }
+.ad-toast-close { flex: none; border: 0; background: transparent; color: var(--ad-muted); cursor: pointer; font-size: 1rem; line-height: 1; padding: 0; }
+.ad-toast.is-leaving { opacity: 0; transform: translateY(0.5rem); transition: opacity 200ms, transform 200ms; }
+@keyframes ad-toast-in { from { opacity: 0; transform: translateY(0.5rem); } to { opacity: 1; transform: none; } }
+
+/* ---------- Modals ---------- */
+.modal-background { background-color: hsla(221, 39%, 8%, 0.45); }
+.modal-card { width: min(44rem, calc(100vw - 2rem)); border-radius: var(--ad-radius); box-shadow: var(--ad-shadow-lg); }
+.modal-card-head, .modal-card-foot { background: var(--ad-surface); border-color: var(--bulma-border-weak); padding: 0.9rem 1.25rem; }
+.modal-card-head { box-shadow: none; }
+.modal-card-title { font-size: 1.05rem; font-weight: 700; }
+.modal-card-body { background: var(--ad-surface); }
+.modal-card-foot { justify-content: flex-end; gap: 0.5rem; }
+.modal-card-foot .ad-foot-start { margin-right: auto; font-size: 0.8rem; color: var(--ad-muted); }
+.modal.is-active .modal-card { animation: ad-modal-in 140ms ease-out; }
+@keyframes ad-modal-in { from { opacity: 0; transform: translateY(0.5rem); } to { opacity: 1; transform: none; } }
+.ad-field-hint { display: flex; justify-content: space-between; gap: 1rem; margin-top: 0.4rem; font-size: 0.75rem; color: var(--ad-muted); }
+.ad-field-hint .is-over { color: var(--bulma-danger); font-weight: 600; }
+
+/* ---------- Task side panel (drawer, JIRA-style) ---------- */
+.ad-drawer { position: fixed; inset: 0; z-index: 40; }
+.ad-drawer-backdrop { position: absolute; inset: 0; background: hsla(221, 39%, 8%, 0.35); opacity: 0; transition: opacity 200ms ease; }
+.ad-drawer-panel {
+  position: absolute; top: 0; right: 0; height: 100%; width: clamp(40rem, 55vw, 72rem); max-width: 100vw;
+  display: flex; flex-direction: column; background: var(--ad-surface); border-left: 1px solid var(--bulma-border-weak);
+  box-shadow: var(--ad-shadow-lg); transform: translateX(100%); transition: transform 200ms ease; outline: none;
+}
+.ad-drawer.is-open .ad-drawer-backdrop { opacity: 1; }
+.ad-drawer.is-open .ad-drawer-panel { transform: none; }
+.ad-drawer-head {
+  flex: none; display: flex; align-items: center; gap: 0.75rem; padding: 0.7rem 1.25rem;
+  border-bottom: 1px solid var(--bulma-border-weak); background: var(--ad-surface);
+}
+.ad-drawer-id { font-size: 0.8rem; color: var(--ad-muted); background: transparent; padding: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; min-width: 0; }
+.ad-drawer-head .button { margin-left: auto; }
+.ad-drawer-body { flex: 1 1 auto; overflow-y: auto; padding: 1.25rem 1.5rem 2rem; overscroll-behavior: contain; }
+/* The detail layout stacks in one column inside the panel; Details goes last. */
+.ad-drawer-body .columns { display: block; margin: 0; }
+.ad-drawer-body .column { width: auto; padding: 0; }
+.ad-drawer-body .ad-sticky { position: static; }
+.ad-drawer-body .ad-page-title { font-size: 1.3rem; }
+
+/* ---------- Footer help ---------- */
+.ad-help { margin-top: 2rem; padding-top: 1rem; border-top: 1px solid var(--bulma-border-weak); font-size: 0.8rem; color: var(--ad-muted); line-height: 1.6; }
+.ad-help code { font-size: 0.78rem; }
+
+/* ---------- Responsive ---------- */
+@media screen and (max-width: 1023px) {
+  .ad-board { grid-template-columns: repeat(5, minmax(16rem, 80vw)); scroll-snap-type: x mandatory; }
+  .ad-column { scroll-snap-align: start; max-height: none; }
+  .ad-sticky { position: static; }
+}
+@media screen and (max-width: 768px) {
+  .ad-toolbar-end { margin-left: 0; width: 100%; justify-content: space-between; }
+  .ad-search { max-width: none; }
+  .ad-header-actions .ad-hide-mobile { display: none; }
+  .ad-page-title { font-size: 1.3rem; }
+  .ad-drawer-panel { width: 100vw; }
+  .ad-drawer-body { padding: 1rem; }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  *, *::before, *::after { animation: none !important; transition: none !important; }
+}

package/dist/services/aidlc-coordination/Dockerfile

@@ -1,10 +1,18 @@
-FROM node:24-bookworm-slim
+FROM node:24-bookworm-slim AS build
 WORKDIR /app
 RUN apt-get update && apt-get install -y --no-install-recommends python3 make g++ && rm -rf /var/lib/apt/lists/*
 COPY package.json package-lock.json ./
 RUN npm ci --omit=dev
-COPY src ./src
-RUN mkdir -p /data
+
+FROM node:24-bookworm-slim
+WORKDIR /app
+ENV NODE_ENV=production
 ENV MCP_STATE_HOST=0.0.0.0 MCP_STATE_PORT=8787 MCP_STATE_SQLITE_PATH=/data/mcp-state.db
+COPY --from=build /app/node_modules ./node_modules
+COPY package.json package-lock.json ./
+COPY src ./src
+RUN mkdir -p /data && chown -R node:node /data
+USER node
 EXPOSE 8787
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 CMD node -e "fetch('http://127.0.0.1:8787/healthz').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"
 CMD ["node", "src/server.mjs"]

package/dist/services/aidlc-coordination/compose.yaml

@@ -9,6 +9,12 @@ services:
       MCP_STATE_DATABASE: sqlite
       MCP_STATE_SQLITE_PATH: /data/mcp-state.db
       MCP_STATE_AUTH_TOKEN: ${MCP_STATE_AUTH_TOKEN:?set MCP_STATE_AUTH_TOKEN in .env before starting the service}
+    healthcheck:
+      test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:8787/healthz').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"]
+      interval: 30s
+      timeout: 3s
+      start_period: 5s
+      retries: 3
 
   postgres:
     image: postgres:16-alpine
@@ -40,6 +46,12 @@ services:
       MCP_FLEET_LEAD_TOKEN: ${MCP_FLEET_LEAD_TOKEN:?set MCP_FLEET_LEAD_TOKEN in .env}
       MCP_FLEET_REVIEWER_TOKEN: ${MCP_FLEET_REVIEWER_TOKEN:?set MCP_FLEET_REVIEWER_TOKEN in .env}
       MCP_FLEET_WORKER_TOKENS: ${MCP_FLEET_WORKER_TOKENS:?set MCP_FLEET_WORKER_TOKENS JSON in .env}
+    healthcheck:
+      test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:8787/healthz').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"]
+      interval: 30s
+      timeout: 3s
+      start_period: 5s
+      retries: 3
 
 volumes:
   aidlc-coordination-data:

package/dist/services/aidlc-coordination/package-lock.json

@@ -4,7 +4,9 @@
   "requires": true,
   "packages": {
     "": {
-      "bin": { "aidlc-fleet": "src/fleet-run.mjs" },
+      "bin": {
+        "aidlc-fleet": "src/fleet-run.mjs"
+      },
       "dependencies": {
         "@modelcontextprotocol/express": "^2.0.0",
         "@modelcontextprotocol/node": "^2.0.0",

package/dist/services/aidlc-coordination/package.json

@@ -2,12 +2,16 @@
   "name": "@felixdotgo/aidlc-coordination",
   "private": true,
   "type": "module",
-  "bin": { "aidlc-fleet": "src/fleet-run.mjs" },
-  "engines": { "node": ">=20" },
+  "bin": {
+    "aidlc-fleet": "src/fleet-run.mjs"
+  },
+  "engines": {
+    "node": ">=20"
+  },
   "scripts": {
     "start": "node src/server.mjs",
     "test": "node --test test/*.test.mjs",
-    "lint": "node --check src/repository.mjs && node --check src/coordination.mjs && node --check src/fleet.mjs && node --check src/fleet-client.mjs && node --check src/fleet-run.mjs && node --check src/server.mjs"
+    "lint": "node -e \"const { readdirSync } = require('node:fs'); const { execFileSync } = require('node:child_process'); for (const file of readdirSync('src').filter((name) => name.endsWith('.mjs'))) execFileSync(process.execPath, ['--check', 'src/' + file], { stdio: 'inherit' });\""
   },
   "dependencies": {
     "@modelcontextprotocol/express": "^2.0.0",
@@ -17,5 +21,6 @@
     "express": "^5.2.1",
     "pg": "^8.23.0",
     "zod": "^4.4.3"
-  }
+  },
+  "version": "0.2.0"
 }

package/dist/services/aidlc-coordination/src/lifecycle-core.mjs

@@ -29,7 +29,7 @@ const lockRecord = (path) => {
   try {
     const value = JSON.parse(readFileSync(path, "utf8"));
     return typeof value.token === "string" && Number.isInteger(value.pid) && value.pid > 0 && Number.isFinite(value.createdAt) ? value : undefined;
-  } catch { return undefined; }
+  } catch { return undefined; } /* intentional: unreadable record is treated as absent */
 };
 const processAlive = (pid) => {
   try { process.kill(pid, 0); return true; }
@@ -307,6 +307,60 @@ export const readyTaskItems = (task) => {
   return { ready, blocked };
 };
 
+/* Parallel work partition: owned paths overlap by path segment (`a` overlaps `a/b`, not `ab`).
+ * Two open items can run concurrently unless one is a direct or transitive dependency of the other. */
+const ownedPathKey = (path) => String(path).replace(/\/+$/, "");
+export const pathOverlaps = (left, right) => { const a = ownedPathKey(left), b = ownedPathKey(right); return a === b || a.startsWith(`${b}/`) || b.startsWith(`${a}/`); };
+export const pathsOverlap = (left = [], right = []) => left.some((a) => right.some((b) => pathOverlaps(a, b)));
+const itemAncestors = (task) => {
+  const byId = new Map(task.tasks.map((item) => [item.id, item])); const memo = new Map();
+  const walk = (id, trail = new Set()) => { if (memo.has(id)) return memo.get(id); const found = new Set(); if (trail.has(id)) return found; trail.add(id); for (const dep of byId.get(id)?.dependsOn ?? []) { if (!byId.has(dep)) continue; found.add(dep); for (const deeper of walk(dep, trail)) found.add(deeper); } trail.delete(id); memo.set(id, found); return found; };
+  return (id) => walk(id);
+};
+export const concurrentItemPairs = (task) => {
+  const open = task.tasks.filter((item) => !["done", "deferred"].includes(item.status)); const ancestors = itemAncestors(task); const pairs = [];
+  for (let i = 0; i < open.length; i += 1) for (let j = i + 1; j < open.length; j += 1) { const a = open[i], b = open[j]; if (!ancestors(a.id).has(b.id) && !ancestors(b.id).has(a.id)) pairs.push([a, b]); }
+  return pairs;
+};
+/** Approve-plan partition check. `strict` (enabled loop) makes findings ERRORs; otherwise WARNs. */
+export const partitionDiagnostics = (task, { strict = true } = {}) => {
+  const level = strict ? "ERROR" : "WARN"; const diagnostics = [];
+  const unscoped = task.tasks.filter((item) => !["done", "deferred"].includes(item.status) && !(Array.isArray(item.ownedPaths) && item.ownedPaths.length));
+  if (unscoped.length) diagnostics.push({ level, code: "PARTITION_SCOPE", message: `Build items need owned paths (--owns) for parallel workers: ${unscoped.map((item) => item.id).join(", ")}` });
+  for (const [a, b] of concurrentItemPairs(task)) {
+    const shared = (a.ownedPaths ?? []).filter((path) => (b.ownedPaths ?? []).some((other) => pathOverlaps(path, other)));
+    if (shared.length) diagnostics.push({ level, code: "PARTITION_OVERLAP", message: `Items ${a.id} and ${b.id} can run concurrently but both own ${shared.join(", ")}; split the paths or add --depends-on` });
+  }
+  return diagnostics;
+};
+/** The partition check is strict when the loop is enabled: `loop.mode` local/fleet in the project config, or
+ * running inside a fleet-enabled coordination service. A missing config means the default `off`; an
+ * unreadable or corrupt config fails closed (strict). */
+export const loopPartitionStrict = (root) => {
+  if (process.env.MCP_FLEET_ENABLED === "1") return true;
+  if (root === undefined) return false;
+  const path = join(resolve(root), ".agents", "config.json");
+  if (!existsSync(path)) return false;
+  try { const mode = JSON.parse(readFileSync(path, "utf8"))?.loop?.mode; return mode === "local" || mode === "fleet"; }
+  catch { return true; }
+};
+/** Pick the next dispatchable batch: dependency-ready items in plan order, at most `capacity`,
+ * skipping items that overlap each other, `busyPaths`, or are listed in `exclude`. Never throws for overlap. */
+export const selectBuildBatch = (task, { capacity = Infinity, busyPaths = [], exclude = [] } = {}) => {
+  const byId = new Map(task.tasks.map((item) => [item.id, item])); const selected = []; const deferred = []; const taken = [];
+  for (const id of readyTaskItems(task).ready) {
+    const owned = byId.get(id)?.ownedPaths ?? [];
+    if (exclude.includes(id)) { deferred.push({ id, reason: "unresolved assignment" }); continue; }
+    if (!owned.length) { deferred.push({ id, reason: "no owned paths" }); continue; }
+    if (pathsOverlap(owned, busyPaths)) { deferred.push({ id, reason: "busy path held by an active assignment" }); continue; }
+    const clash = taken.find((entry) => pathsOverlap(owned, entry.owned));
+    if (clash) { deferred.push({ id, reason: `overlaps ${clash.id}` }); continue; }
+    if (selected.length >= capacity) { deferred.push({ id, reason: "capacity" }); continue; }
+    selected.push(id); taken.push({ id, owned });
+  }
+  return { selected, deferred };
+};
+
 export const nextAction = (task, root) => {
   const rootSuffix = root === undefined ? "" : ` --root ${JSON.stringify(resolve(root))}`;
   const script = (name) => root === undefined ? `node .agents/aidlc/scripts/${name}` : `node ${JSON.stringify(join(resolve(root), ".agents/aidlc/scripts", name))}`;
@@ -357,13 +411,14 @@ export const searchLessons = (root, state, query, areas = [], limit = 5) => { co
 
 export const listTaskSummaries = (state, options = {}) => { const active = Object.values(state.tasks).map((task) => ({ id: task.id, title: task.title, phase: task.phase, gate: task.gate, status: task.status, risk: task.risk, areas: task.areas, updatedAt: task.updatedAt, source: "active" })); const archived = options.includeArchive ? Object.values(state.archive ?? {}).map((task) => ({ id: task.id, title: task.title, phase: task.phase, gate: task.gate, status: task.status, risk: task.risk, areas: task.areas, updatedAt: task.updatedAt, source: "archive" })) : []; const queryTokens = tokens(options.query ?? ""); const statusSet = new Set(options.statuses ?? []); const filtered = [...active, ...archived].filter((item) => (!statusSet.size || statusSet.has(item.status)) && (!queryTokens.length || queryTokens.every((token) => tokens(`${item.id} ${item.title} ${item.areas.join(" ")}`).includes(token)))).sort((a, b) => b.updatedAt.localeCompare(a.updatedAt) || a.id.localeCompare(b.id)); const cursor = Math.max(0, options.cursor ?? 0); const limit = Math.max(1, Math.min(options.limit ?? 20, 100)); const items = filtered.slice(cursor, cursor + limit); return { items, nextCursor: cursor + items.length < filtered.length ? String(cursor + items.length) : null, total: filtered.length }; };
 
-export const renderWorkplan = (task) => { const decisions = task.decisions.length ? task.decisions.map((item) => `- [${item.status === "approved" ? "x" : " "}] ${item.id} — ${item.label}${item.resolution ? ` — ${item.resolution}` : ""}`).join("\n") : "- None"; const tasks = task.tasks.length ? task.tasks.map((item) => `- [${item.status === "done" ? "x" : item.status === "in_progress" ? "~" : " "}] ${item.id} — ${item.label}`).join("\n") : "- None"; const lifecycle = [`- Status: \`${task.status}\``, task.handoff ? `- Handoff: \`${task.handoff.kind}\` — ${task.handoff.reason}` : "", task.closure ? `- Closure: ${task.closure.reason}` : "", task.predecessorTaskId ? `- Predecessor: \`${task.predecessorTaskId}\`` : "", task.successorTaskId ? `- Successor: \`${task.successorTaskId}\`` : "", task.lessonDisposition ? `- Lessons: \`${task.lessonDisposition.status}\`` : ""].filter(Boolean).join("\n"); return `# Workplan — ${task.title} (\`${task.id}\`)\n\n> Generated from canonical JSON state.\n\n## Lifecycle\n${lifecycle}\n\n## 🧩 Decisions (Approve plan — before implementation)\n${decisions}\n\n## 🧩 Tasks (Review implementation — work items)\n${tasks}\n`; };
+const workplanScope = (item) => { const parts = [item.ownedPaths?.length ? `owns: ${item.ownedPaths.join(", ")}` : "", item.dependsOn?.length ? `after: ${item.dependsOn.join(", ")}` : ""].filter(Boolean); return parts.length ? ` — ${parts.join(" · ")}` : ""; };
+export const renderWorkplan = (task) => { const decisions = task.decisions.length ? task.decisions.map((item) => `- [${item.status === "approved" ? "x" : " "}] ${item.id} — ${item.label}${item.resolution ? ` — ${item.resolution}` : ""}`).join("\n") : "- None"; const tasks = task.tasks.length ? task.tasks.map((item) => `- [${item.status === "done" ? "x" : item.status === "in_progress" ? "~" : " "}] ${item.id} — ${item.label}${workplanScope(item)}`).join("\n") : "- None"; const lifecycle = [`- Status: \`${task.status}\``, task.handoff ? `- Handoff: \`${task.handoff.kind}\` — ${task.handoff.reason}` : "", task.closure ? `- Closure: ${task.closure.reason}` : "", task.predecessorTaskId ? `- Predecessor: \`${task.predecessorTaskId}\`` : "", task.successorTaskId ? `- Successor: \`${task.successorTaskId}\`` : "", task.lessonDisposition ? `- Lessons: \`${task.lessonDisposition.status}\`` : ""].filter(Boolean).join("\n"); return `# Workplan — ${task.title} (\`${task.id}\`)\n\n> Generated from canonical JSON state.\n\n## Lifecycle\n${lifecycle}\n\n## 🧩 Decisions (Approve plan — before implementation)\n${decisions}\n\n## 🧩 Tasks (Review implementation — work items)\n${tasks}\n`; };
 export const renderViews = (root, state = loadState(root), selected = Object.values(state.tasks)) => { for (const task of selected) { if (!task.artifacts.workplan) continue; assertNoSymlinkPath(root, task.artifacts.workplan); writeAtomic(join(resolve(root), task.artifacts.workplan), renderWorkplan(task)); } };
 
 const safeArtifactTarget = (root, path) => { assertNoSymlinkPath(root, path); return join(resolve(root), path); };
-const artifactContent = (root, path) => { if (!path) return undefined; try { const target = safeArtifactTarget(root, path); return existsSync(target) ? readFileSync(target, "utf8") : undefined; } catch { return undefined; } };
+const artifactContent = (root, path) => { if (!path) return undefined; try { const target = safeArtifactTarget(root, path); return existsSync(target) ? readFileSync(target, "utf8") : undefined; } catch { return undefined; } /* intentional: unreadable/unsafe artifact is treated as absent */ };
 const artifactDiagnostics = (root, task, names) => names.flatMap((name) => { const path = task.artifacts[name]; if (!path) return [{ level: "ERROR", code: "ARTIFACT_REFERENCE", message: `${name} artifact is not referenced` }]; try { return existsSync(safeArtifactTarget(root, path)) ? [] : [{ level: "ERROR", code: "ARTIFACT_MISSING", message: `${path} does not exist` }]; } catch (error) { return [{ level: "ERROR", code: "ARTIFACT_UNSAFE", message: error instanceof Error ? error.message : String(error) }]; } });
-export const checkGate = (root, state, taskId, gate) => { const task = state.tasks[taskId]; if (!task) return [{ level: "ERROR", code: "TASK_UNKNOWN", message: `Unknown active task: ${taskId}` }]; const diagnostics = []; if (task.gate !== gate) diagnostics.push({ level: "ERROR", code: "GATE_STATE", message: `Task is at ${task.gate}, not ${gate}` }); if (["closed", "superseded"].includes(task.status)) diagnostics.push({ level: "ERROR", code: "TASK_TERMINAL", message: `Terminal task cannot approve ${gate}` }); if (task.handoff) diagnostics.push({ level: "ERROR", code: "TASK_HANDOFF", message: `Task has unresolved handoff: ${task.handoff.reason}` }); if (task.id !== taskId) diagnostics.push({ level: "ERROR", code: "TASK_ID", message: "Task key and id differ" }); if (!task.title.trim() || !task.areas.length) diagnostics.push({ level: "ERROR", code: "TASK_FIELDS", message: "Task title and affected areas are required" }); if (gate === "G0_confirm") { diagnostics.push(...artifactDiagnostics(root, task, ["intent"])); const content = artifactContent(root, task.artifacts.intent); if (content !== undefined) for (const heading of ["## 📋 Problem", "## 🗺️ Affected areas", "## 💭 Assumptions", "## ❓ Open questions", "## 🎯 Scope"]) if (!content.includes(heading)) diagnostics.push({ level: "ERROR", code: "INTENT_HEADING", message: `Intent is missing ${heading}` }); } if (gate === "G1_review") { diagnostics.push(...artifactDiagnostics(root, task, ["intent", "design", "workplan"])); diagnostics.push(...transitionDiagnostics(task, "build").filter((item) => item.code === "UNRESOLVED_DECISION")); const content = artifactContent(root, task.artifacts.design); if (content !== undefined) for (const heading of ["## 🧩 Solution per affected area", "## 📌 Spec traceability", "## 🔗 Cross-service contracts", "## ⚠️ Risks / edge cases"]) if (!content.includes(heading)) diagnostics.push({ level: "ERROR", code: "DESIGN_HEADING", message: `Design is missing ${heading}` }); } if (gate === "G2_codereview") { diagnostics.push(...artifactDiagnostics(root, task, ["intent", "design", "workplan"])); if (task.tasks.some((item) => !["done", "deferred"].includes(item.status))) diagnostics.push({ level: "ERROR", code: "TASKS_OPEN", message: "Build tasks remain open" }); for (const area of task.areas) if (!hasAreaVerification(task, area)) diagnostics.push({ level: "ERROR", code: "VERIFY_EVIDENCE", message: `Latest post-G1 verification evidence must pass for affected area: ${area}` }); if (!hasReview(task)) diagnostics.push({ level: "ERROR", code: "REVIEW_EVIDENCE", message: "Latest post-G1 code-review evidence must pass" }); const bounds = repairBounds(task); if (!isLegacyG2Wait(task) && (bounds.verifyExhausted || bounds.reviewExhausted)) diagnostics.push({ level: "ERROR", code: "REPAIR_BOUND", message: "Repair bound exhausted; record a durable handoff instead of presenting G2" }); } if (!diagnostics.length) diagnostics.push({ level: "INFO", code: "GATE_OK", message: `${gate} checks passed for ${taskId}` }); return diagnostics; };
+export const checkGate = (root, state, taskId, gate) => { const task = state.tasks[taskId]; if (!task) return [{ level: "ERROR", code: "TASK_UNKNOWN", message: `Unknown active task: ${taskId}` }]; const diagnostics = []; if (task.gate !== gate) diagnostics.push({ level: "ERROR", code: "GATE_STATE", message: `Task is at ${task.gate}, not ${gate}` }); if (["closed", "superseded"].includes(task.status)) diagnostics.push({ level: "ERROR", code: "TASK_TERMINAL", message: `Terminal task cannot approve ${gate}` }); if (task.handoff) diagnostics.push({ level: "ERROR", code: "TASK_HANDOFF", message: `Task has unresolved handoff: ${task.handoff.reason}` }); if (task.id !== taskId) diagnostics.push({ level: "ERROR", code: "TASK_ID", message: "Task key and id differ" }); if (!task.title.trim() || !task.areas.length) diagnostics.push({ level: "ERROR", code: "TASK_FIELDS", message: "Task title and affected areas are required" }); if (gate === "G0_confirm") { diagnostics.push(...artifactDiagnostics(root, task, ["intent"])); const content = artifactContent(root, task.artifacts.intent); if (content !== undefined) for (const heading of ["## 📋 Problem", "## 🗺️ Affected areas", "## 💭 Assumptions", "## ❓ Open questions", "## 🎯 Scope"]) if (!content.includes(heading)) diagnostics.push({ level: "ERROR", code: "INTENT_HEADING", message: `Intent is missing ${heading}` }); } if (gate === "G1_review") { diagnostics.push(...artifactDiagnostics(root, task, ["intent", "design", "workplan"])); diagnostics.push(...transitionDiagnostics(task, "build").filter((item) => item.code === "UNRESOLVED_DECISION")); const content = artifactContent(root, task.artifacts.design); if (content !== undefined) for (const heading of ["## 🧩 Solution per affected area", "## 📌 Spec traceability", "## 🔗 Cross-service contracts", "## ⚠️ Risks / edge cases"]) if (!content.includes(heading)) diagnostics.push({ level: "ERROR", code: "DESIGN_HEADING", message: `Design is missing ${heading}` }); diagnostics.push(...partitionDiagnostics(task, { strict: loopPartitionStrict(root) })); } if (gate === "G2_codereview") { diagnostics.push(...artifactDiagnostics(root, task, ["intent", "design", "workplan"])); if (task.tasks.some((item) => !["done", "deferred"].includes(item.status))) diagnostics.push({ level: "ERROR", code: "TASKS_OPEN", message: "Build tasks remain open" }); for (const area of task.areas) if (!hasAreaVerification(task, area)) diagnostics.push({ level: "ERROR", code: "VERIFY_EVIDENCE", message: `Latest post-G1 verification evidence must pass for affected area: ${area}` }); if (!hasReview(task)) diagnostics.push({ level: "ERROR", code: "REVIEW_EVIDENCE", message: "Latest post-G1 code-review evidence must pass" }); const bounds = repairBounds(task); if (!isLegacyG2Wait(task) && (bounds.verifyExhausted || bounds.reviewExhausted)) diagnostics.push({ level: "ERROR", code: "REPAIR_BOUND", message: "Repair bound exhausted; record a durable handoff instead of presenting G2" }); } if (!diagnostics.some((item) => item.level === "ERROR")) diagnostics.push({ level: "INFO", code: "GATE_OK", message: `${gate} checks passed for ${taskId}` }); return diagnostics; };
 const gateTarget = { G0_confirm: "plan", G1_review: "build", G2_codereview: "wrap" };
 export const approveAndAdvance = (root, state, taskId, gate, source, recordedAt = new Date().toISOString()) => { const task = state.tasks[taskId]; if (!task) throw new Error(`Unknown active task: ${taskId}`); if (["closed", "superseded"].includes(task.status) || task.handoff) throw new Error(`Terminal or handed-off task cannot approve ${gate}`); const target = gateTarget[gate]; if (!target) throw new Error(`Gate ${gate} cannot be approved`); if (task.phase === target) return { task, nextAction: nextAction(task, root), idempotent: true }; if (task.gate !== gate || task.status !== "blocked_on_user") throw new Error(`Task must be blocked_on_user at ${gate}`); const errors = checkGate(root, state, taskId, gate).filter((item) => item.level === "ERROR"); if (errors.length) throw new Error(errors.map((item) => item.message).join("; ")); task.evidence.push({ kind: "approval", gate, result: "pass", source, recordedAt }); transitionTask(state, taskId, target); return { task, nextAction: nextAction(task, root), idempotent: false }; };
 export const formatDiagnostics = (diagnostics) => diagnostics.map((item) => `${item.level} ${item.code}: ${item.message}`).join("\n");