opencastle 0.28.0 → 0.30.0

package/src/dashboard/src/styles/dashboard.css

@@ -275,7 +275,6 @@ body {
   background: var(--bg-secondary);
   border: 1px solid var(--border-color);
   border-radius: 12px;
-  overflow: hidden;
   transition: border-color var(--transition-fast);
 }
 
@@ -1880,15 +1879,18 @@ body {
   bottom: 100%;
   left: 50%;
   transform: translateX(-50%);
-  padding: 0.375rem 0.625rem;
+  padding: 0.5rem 0.875rem;
   background: var(--bg-primary);
   border: 1px solid rgba(255, 255, 255, 0.12);
   border-radius: 6px;
-  font-size: 0.75rem;
+  font-size: 0.8125rem;
   color: var(--text-primary);
-  max-width: 280px;
+  max-width: 420px;
+  min-width: 180px;
   white-space: normal;
   text-align: left;
+  line-height: 1.5;
+  word-break: break-word;
   z-index: 100;
   pointer-events: none;
   box-shadow: 0 4px 12px rgba(0, 0, 0, 0.4);
@@ -1906,15 +1908,18 @@ body {
   bottom: 100%;
   left: 50%;
   transform: translateX(-50%);
-  padding: 0.375rem 0.625rem;
+  padding: 0.5rem 0.875rem;
   background: var(--bg-primary);
   border: 1px solid rgba(255, 255, 255, 0.12);
   border-radius: 6px;
-  font-size: 0.75rem;
+  font-size: 0.8125rem;
   color: var(--text-primary);
-  max-width: 280px;
+  max-width: 420px;
+  min-width: 180px;
   white-space: normal;
   text-align: left;
+  line-height: 1.5;
+  word-break: break-word;
   z-index: 100;
   pointer-events: none;
   box-shadow: 0 4px 12px rgba(0, 0, 0, 0.4);
@@ -2269,3 +2274,464 @@ body {
   margin-bottom: 0.5rem;
   font-style: italic;
 }
+
+/* ── View Management ───────────────────────────────────── */
+.view-home,
+.view-convoy-detail {
+  display: flex;
+  flex-direction: column;
+  gap: 20px;
+}
+
+[data-view-hidden] {
+  display: none !important;
+}
+
+/* ── Breadcrumbs ───────────────────────────────────────── */
+.breadcrumbs {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 0.8125rem;
+  color: var(--text-tertiary);
+  flex-wrap: wrap;
+  padding: 0;
+  margin-bottom: -8px;
+}
+
+.breadcrumbs__link {
+  color: var(--text-secondary);
+  text-decoration: none;
+  transition: color var(--transition-fast);
+  border-bottom: 1px solid transparent;
+}
+
+.breadcrumbs__link:hover {
+  color: var(--text-accent);
+  border-bottom-color: rgba(167, 139, 250, 0.4);
+}
+
+.breadcrumbs__link:focus-visible {
+  outline: 2px solid var(--accent-blue);
+  outline-offset: 2px;
+  border-radius: 2px;
+}
+
+.breadcrumbs__separator {
+  color: var(--text-tertiary);
+  opacity: 0.5;
+  user-select: none;
+  font-size: 0.75rem;
+}
+
+.breadcrumbs__current {
+  color: var(--text-accent);
+  font-weight: 500;
+  max-width: 320px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+/* ── Convoy List Section ───────────────────────────────── */
+.convoy-list-section {
+  background: var(--bg-secondary);
+  border: 1px solid var(--border-color);
+  border-radius: 12px;
+  transition: border-color var(--transition-fast);
+}
+
+.convoy-list-section:hover {
+  border-color: rgba(255, 255, 255, 0.1);
+}
+
+.convoy-list-section__header {
+  padding: 20px 24px 12px;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.convoy-list-section__header h2,
+.convoy-list-section__header .convoy-list-section__title {
+  font-size: 0.9375rem;
+  font-weight: 600;
+  color: var(--text-primary);
+  margin: 0;
+}
+
+.convoy-list-section__desc {
+  font-size: 0.75rem;
+  color: var(--text-tertiary);
+  margin-top: 2px;
+}
+
+/* ── Convoy List Filters ─────────────────────────────── */
+.convoy-list-filters {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 10px;
+  align-items: flex-end;
+  padding: 14px 24px;
+  background: rgba(255, 255, 255, 0.01);
+  border-bottom: 1px solid var(--border-color);
+}
+
+.convoy-list-filters__group {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+
+.convoy-list-filters__group label {
+  font-size: 0.6875rem;
+  font-weight: 500;
+  color: var(--text-tertiary);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.convoy-list-filters__input,
+.convoy-list-filters__select,
+.convoy-list-filters__date {
+  height: 34px;
+  padding: 0 10px;
+  font-size: 0.8125rem;
+  color: var(--text-primary);
+  background: var(--bg-tertiary);
+  border: 1px solid var(--border-color);
+  border-radius: 8px;
+  outline: none;
+  font-family: inherit;
+  transition: border-color var(--transition-fast);
+  color-scheme: dark;
+}
+
+.convoy-list-filters__input:focus,
+.convoy-list-filters__select:focus,
+.convoy-list-filters__date:focus {
+  border-color: var(--border-accent);
+}
+
+.convoy-list-filters__input {
+  width: 180px;
+}
+
+.convoy-list-filters__date {
+  width: 150px;
+}
+
+.convoy-list-filters__select {
+  min-width: 140px;
+  cursor: pointer;
+  appearance: none;
+  -webkit-appearance: none;
+  background-image: url("data:image/svg+xml,%3Csvg width='10' height='6' viewBox='0 0 10 6' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M1 1l4 4 4-4' stroke='%235a5a6e' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E");
+  background-repeat: no-repeat;
+  background-position: right 10px center;
+  padding-right: 28px;
+}
+
+.convoy-list-filters__reset {
+  height: 34px;
+  padding: 0 14px;
+  font-size: 0.75rem;
+  font-weight: 500;
+  font-family: inherit;
+  color: var(--text-secondary);
+  background: rgba(255, 255, 255, 0.06);
+  border: none;
+  border-radius: 8px;
+  cursor: pointer;
+  transition: background var(--transition-fast), color var(--transition-fast);
+  align-self: flex-end;
+  white-space: nowrap;
+}
+
+.convoy-list-filters__reset:hover {
+  background: rgba(255, 255, 255, 0.10);
+  color: var(--text-primary);
+}
+
+.convoy-list-filters__reset:focus-visible {
+  outline: 2px solid var(--accent-blue);
+  outline-offset: 2px;
+}
+
+/* ── Convoy List Table ───────────────────────────────── */
+.convoy-list-table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 0.8125rem;
+}
+
+.convoy-list-table thead {
+  position: sticky;
+  top: 0;
+}
+
+.convoy-list-table th {
+  padding: 10px 16px;
+  font-size: 0.6875rem;
+  font-weight: 600;
+  color: var(--text-tertiary);
+  text-align: left;
+  text-transform: uppercase;
+  letter-spacing: 0.06em;
+  background: var(--bg-tertiary);
+  border-bottom: 1px solid var(--border-color);
+  white-space: nowrap;
+}
+
+.convoy-list-table td {
+  padding: 10px 16px;
+  color: var(--text-secondary);
+  border-bottom: 1px solid rgba(255, 255, 255, 0.03);
+  white-space: nowrap;
+}
+
+.convoy-list-table tr {
+  cursor: pointer;
+  transition: background var(--transition-fast);
+}
+
+.convoy-list-table tbody tr:hover td {
+  background: rgba(167, 139, 250, 0.05);
+  color: var(--text-primary);
+}
+
+.convoy-list-table tbody tr:hover td:first-child {
+  color: var(--text-accent);
+}
+
+.convoy-list-table .td-convoy-name {
+  font-weight: 600;
+  color: var(--text-primary);
+  max-width: 240px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+/* ── Convoy List Empty ───────────────────────────────── */
+.convoy-list-empty {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: 10px;
+  padding: 48px 24px;
+  text-align: center;
+  color: var(--text-tertiary);
+}
+
+.convoy-list-empty__icon {
+  font-size: 2rem;
+  opacity: 0.35;
+}
+
+.convoy-list-empty__text {
+  font-size: 0.875rem;
+  color: var(--text-tertiary);
+  max-width: 300px;
+  line-height: 1.5;
+}
+
+/* ── Convoy Detail Hero ──────────────────────────────── */
+.convoy-detail-hero {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  padding: 24px;
+  background: var(--bg-secondary);
+  border: 1px solid var(--border-color);
+  border-radius: 12px;
+  position: relative;
+}
+
+.convoy-detail-hero::before {
+  content: '';
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  height: 2px;
+  background: var(--gradient-accent);
+  opacity: 0.6;
+  pointer-events: none;
+}
+
+.convoy-detail-hero__top {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+
+.convoy-detail-hero__title {
+  font-size: 1.5rem;
+  font-weight: 700;
+  color: var(--text-primary);
+  letter-spacing: -0.02em;
+  line-height: 1.25;
+  margin: 0;
+}
+
+.convoy-detail-hero__status {
+  flex-shrink: 0;
+}
+
+.convoy-detail-hero__status .status-badge {
+  padding: 0.25rem 0.875rem;
+  font-size: 0.75rem;
+  border-radius: 8px;
+}
+
+.convoy-detail-hero__meta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 20px;
+  padding-top: 4px;
+  border-top: 1px solid var(--border-color);
+}
+
+.convoy-detail-hero__meta-item {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
+
+.convoy-detail-hero__meta-label {
+  font-size: 0.6875rem;
+  font-weight: 500;
+  color: var(--text-tertiary);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.convoy-detail-hero__meta-value {
+  font-size: 0.875rem;
+  color: var(--text-secondary);
+  font-variant-numeric: tabular-nums;
+}
+
+/* ── Task Row Enhancement ────────────────────────────── */
+.task-row--clickable {
+  cursor: pointer;
+  transition: background var(--transition-fast);
+}
+
+.task-row--clickable:hover td {
+  background: rgba(167, 139, 250, 0.04);
+}
+
+.task-row--clickable td:first-child {
+  position: relative;
+}
+
+.task-row--clickable td:first-child::before {
+  content: '';
+  position: absolute;
+  left: 0;
+  top: 0;
+  bottom: 0;
+  width: 2px;
+  background: transparent;
+  transition: background var(--transition-fast);
+}
+
+.task-row--clickable:hover td:first-child::before {
+  background: var(--border-accent);
+}
+
+.task-detail-expand {
+  background: var(--bg-tertiary);
+  border-bottom: 1px solid var(--border-color);
+}
+
+.task-detail-expand__inner {
+  padding: 16px 20px;
+}
+
+.task-detail-expand__grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
+  gap: 12px 24px;
+}
+
+.task-detail-expand__field {
+  display: flex;
+  flex-direction: column;
+  gap: 3px;
+}
+
+.task-detail-expand__label {
+  font-size: 0.6875rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--text-tertiary);
+}
+
+.task-detail-expand__value {
+  font-size: 0.8125rem;
+  color: var(--text-secondary);
+  word-break: break-word;
+  font-variant-numeric: tabular-nums;
+}
+
+.task-detail-expand__value code {
+  font-family: 'SF Mono', 'Fira Code', 'Cascadia Code', monospace;
+  font-size: 0.75rem;
+  background: rgba(255, 255, 255, 0.06);
+  padding: 1px 6px;
+  border-radius: 4px;
+  color: var(--text-accent);
+}
+
+/* ── Responsive: Convoy List Filters ────────────────── */
+@media (max-width: 768px) {
+  .convoy-list-filters {
+    padding: 12px 16px;
+    gap: 8px;
+  }
+
+  .convoy-list-filters__input,
+  .convoy-list-filters__select,
+  .convoy-list-filters__date {
+    width: 100%;
+    min-width: unset;
+  }
+
+  .convoy-list-filters__group {
+    flex: 1 1 calc(50% - 4px);
+  }
+
+  .convoy-list-filters__reset {
+    flex: 1 1 100%;
+    width: 100%;
+  }
+
+  .convoy-list-section__header {
+    padding: 16px 16px 12px;
+  }
+}
+
+@media (max-width: 480px) {
+  .convoy-list-filters__group {
+    flex: 1 1 100%;
+  }
+
+  .convoy-detail-hero__title {
+    font-size: 1.25rem;
+  }
+
+  .convoy-detail-hero {
+    padding: 16px;
+  }
+
+  .task-detail-expand__grid {
+    grid-template-columns: 1fr;
+  }
+
+  .breadcrumbs__current {
+    max-width: 180px;
+  }
+}

package/src/orchestrator/agents/team-lead.agent.md

@@ -109,6 +109,19 @@ When calling `runSubagent`, always specify which custom agent to use by name: *"
 
 **After each sub-agent returns**, log the delegation record before doing anything else (before review, before verification). This is a **⛔ hard gate** — do NOT proceed to review or any other action until the delegation is logged. Use the **observability-logging** skill's delegation record command (`--mechanism sub-agent`).
 
+### Empty Output Handling
+
+If a sub-agent returns empty, minimal, or off-topic output:
+
+1. **Never fall back to writing content yourself** — Rule #1 still applies
+2. **Retry with an explicit prompt** — Restate the objective with:
+   - Exact deliverables expected (e.g., "Return the full revised text, not a summary")
+   - The Output Contract from the agent's definition (paste it into the prompt)
+   - An example of what good output looks like
+3. **Escalate the model** — If the Economy-tier agent fails twice, re-delegate to a Standard-tier agent (e.g., use Developer or UI/UX Expert for content tasks that require codebase context)
+4. **Log the failure** — Even if retry succeeds, log the empty-output attempt as a delegation with `outcome: failed` and `failure_reason: empty_output`
+5. **Max 3 attempts** — After 3 empty returns → DLQ the task to `.opencastle/AGENT-FAILURES.md`
+
 > **`model` and `tier` must come from the agent registry** — not the Team Lead's own model. Look up the agent in [agent-registry.md](../.opencastle/agents/agent-registry.md) and use their assigned model and tier. For example, delegating to Developer → `"model":"claude-sonnet-4-6","tier":"quality"`, not the Team Lead's `claude-opus-4-6`.
 
 ### Background Agents — Delegate Session

package/src/orchestrator/prompts/brainstorm.prompt.md

@@ -38,6 +38,7 @@ Research before proposing. Gather data, don't guess:
 2. **Check documentation** — read `.opencastle/project.instructions.md`, `.opencastle/project/decisions.md`, `.opencastle/KNOWN-ISSUES.md` for constraints
 3. **Check lessons learned** — read `.opencastle/LESSONS-LEARNED.md` for pitfalls in this area
 4. **Identify affected layers** — which apps, libs, data stores, and third-party services are involved?
+5. **Research unknown topics** — if the request involves a real-world person, place, organization, or topic you don't have confident knowledge about, **search the internet** using any available web search or fetch tools (e.g. `fetch_webpage`, web search MCP, or similar) to gather accurate facts. Never fabricate content about real-world subjects.
 
 ### 3. Generate Alternatives
 

package/src/orchestrator/prompts/fix-prd.prompt.md

@@ -0,0 +1,58 @@
+---
+description: 'Fix validation errors in a PRD. Goal is the broken PRD markdown; context is the error list from the validation step.'
+agent: 'Team Lead (OpenCastle)'
+output: prd
+---
+
+<!-- ⚠️ This file is managed by OpenCastle. Edits will be overwritten on update. Customize in the .opencastle/ directory instead. -->
+
+# Fix PRD
+
+You are the Team Lead. The PRD below failed validation. Fix **every reported issue** and output a complete, corrected PRD.
+
+## Failing PRD
+
+{{goal}}
+
+## Validation Errors
+
+{{context}}
+
+---
+
+## Fix Instructions
+
+1. Read every reported issue before making changes.
+2. Fix **all** reported issues — do not partially fix.
+3. Do not change the intent, goals, or scope of the feature. Only fix what the validator flagged.
+4. Preserve all content that is not part of the reported issues.
+
+### Common Fix Patterns
+
+**Missing sections**
+- Add the missing section with concrete, specific content — not placeholder text
+- If the section needs real data you cannot infer, write a reasonable default and mark with `<!-- TODO: verify -->`
+
+**Vague acceptance criteria**
+- Replace subjective language ("looks good", "feels responsive") with measurable conditions ("renders within 200ms", "meets WCAG 2.2 AA contrast ratio")
+- Replace modal verbs ("should", "might", "could") with definitive language ("must", "will")
+
+**Broad implementation scope**
+- Replace broad paths (`src/`, `the frontend`) with specific file names or subdirectory names
+- Remove glob patterns (`*`, `**`) from scope tables — use actual directory or file names
+
+**File partition conflicts**
+- If two parallel workstreams claim the same file, move one to a later phase with explicit dependency
+- Or split the file's responsibilities across the two workstreams so each touches distinct files
+
+**Missing dependency declarations**
+- Add `depends on: Phase N` to phases that require output from earlier phases
+
+**Placeholder text**
+- Replace template filler ("2–3 sentences about…", "Description here") with real content derived from the feature description
+
+---
+
+## Output
+
+Return the **complete corrected PRD** as raw Markdown starting with the `#` heading. Do not wrap the output in a code fence. Do not add explanatory prose before or after the PRD.

package/src/orchestrator/prompts/generate-convoy.prompt.md

@@ -151,6 +151,13 @@ Enables continuous re-execution triggered by file changes, cron, or git push.
 | `cron` | `schedule` (5-field cron) | Re-run on cron schedule |
 | `git-push` | `branch` | Re-run when new commits are pushed |
 
+### Content Research Rule
+
+When writing task `prompt` fields that involve creating content about real-world people, places, organizations, or topics — **include an explicit instruction in the prompt** telling the agent to search the internet first using any available web search or fetch tools (e.g. `fetch_webpage`, web search MCP). Agents must never fabricate bios, descriptions, histories, statistics, or any factual claims. If web search is unavailable, the prompt should instruct the agent to use placeholder text clearly marked as `[NEEDS RESEARCH]` rather than inventing content.
+
+Example prompt suffix to include when content research is needed:
+> "Before writing any content about [topic], search the internet for accurate information. Do not make up facts, descriptions, or biographical details. Use verified sources only."
+
 ### Task Fields
 
 | Field | Type | Required | Default | Description |
@@ -302,6 +309,29 @@ For complex tasks, consider using `steps` to break the prompt into sequential su
 >
 > **Strong prompt:** "Write unit tests for `libs/auth/src/server.ts` covering token refresh, expiry edge cases, and invalid signatures. Place tests in `libs/auth/src/__tests__/server.test.ts`. Follow the existing test conventions. Achieve ≥ 95 % coverage for `server.ts`. Run the project's test command with coverage and fix any failures."
 
+### Chain Mode (Subset Generation)
+
+When the `{{context}}` field contains a JSON object with `"mode": "chain_subset"`, you are generating ONE convoy spec that is part of a larger convoy chain. The context will look like:
+
+```json
+{
+  "mode": "chain_subset",
+  "group_name": "database-setup",
+  "group_description": "Schema changes and migrations",
+  "group_phases": [1],
+  "depends_on_groups": [],
+  "total_groups": 3,
+  "group_index": 1
+}
+```
+
+When this context is present:
+- **Only** generate tasks for the phases listed in `group_phases`. Do not include tasks from other phases.
+- Use `version: 1` — this spec is a single convoy, not a pipeline.
+- Derive the convoy `name` from `group_name` (e.g., "Database Setup").
+- Derive the `branch` from the PRD's feature name, but it will be overridden by the pipeline anyway.
+- Keep all other conventions (prompts, files, gates, etc.) the same as for single-spec generation.
+
 ### 6. Validate Before Outputting
 
 Before presenting the YAML, mentally verify:

package/src/orchestrator/prompts/generate-prd.prompt.md

@@ -20,6 +20,12 @@ You are the Team Lead. Convert the feature request below into a structured Produ
 
 ---
 
+## Research Before Writing
+
+If the feature request involves a specific person, place, organization, topic, or any real-world subject you are not confident you have accurate knowledge about — **you MUST search the internet first** using any available web search or fetch tools (e.g. `fetch_webpage`, web search MCP, or similar). Use the search results to gather accurate facts, names, dates, descriptions, and other details.
+
+**Never fabricate or hallucinate content** about real-world subjects. If you cannot verify a claim through web search, state what is unknown rather than inventing plausible-sounding text. This applies to all content: bios, descriptions, histories, statistics, quotes, and any factual claims.
+
 ## Required PRD Structure
 
 Produce the PRD in Markdown using **exactly** the sections below. Do not skip or merge sections. Do not wrap the output in a code fence — output raw Markdown starting directly with the `#` heading.
@@ -118,3 +124,35 @@ Measurable, binary checks that confirm the feature is shippable:
 - **[Open question]**: [What needs to be decided before implementation can start]
 
 If there are no risks or open questions, write "None identified."
+
+## Complexity Assessment
+
+Produce a fenced JSON block with the following fields. This is consumed programmatically by the pipeline to decide whether to generate a single convoy spec or a convoy chain.
+
+```json
+{
+  "total_tasks": 12,
+  "total_phases": 4,
+  "domains": ["database", "api", "frontend", "testing"],
+  "estimated_duration_minutes": 120,
+  "complexity": "low",
+  "recommended_strategy": "single",
+  "chain_rationale": "",
+  "convoy_groups": [
+    {
+      "name": "full-implementation",
+      "description": "All phases in a single convoy",
+      "phases": [1, 2, 3, 4],
+      "depends_on": []
+    }
+  ]
+}
+```
+
+**Strategy decision rules:**
+- Use `"single"` when: total tasks ≤ 8, or total phases ≤ 3, or all tasks are tightly coupled with heavy cross-phase file sharing.
+- Use `"chain"` when: total tasks > 8 AND total phases > 3 AND domains have natural boundaries (e.g., database changes are independent from frontend components from test suites) — AND splitting would improve failure isolation, observability, or retry granularity.
+- When `"single"`: provide exactly one convoy group covering all phases.
+- When `"chain"`: provide 2–4 convoy groups with explicit `depends_on` order. Each group should cover a coherent domain boundary.
+- `complexity` values: `"low"` (1–4 tasks), `"medium"` (5–8 tasks), `"high"` (9+ tasks).
+- `chain_rationale` is only filled when `recommended_strategy` is `"chain"` — explain WHY splitting benefits this specific feature.

package/dist/cli/convoy/log-merge.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=log-merge.test.d.ts.map

package/dist/cli/convoy/log-merge.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"log-merge.test.d.ts","sourceRoot":"","sources":["../../../src/cli/convoy/log-merge.test.ts"],"names":[],"mappings":""}