opencastle 0.10.1 → 0.10.3

package/src/cli/update.ts

@@ -7,7 +7,7 @@ import { TECH_PLUGINS, TEAM_PLUGINS } from '../orchestrator/plugins/index.js'
 import { IDE_ADAPTERS, VALID_IDES } from './adapters/index.js'
 import { getRequiredMcpEnvVars, updateSkillMatrixFile } from './stack-config.js'
 import { rebuildMcpConfig } from './mcp.js'
-import { detectRepoInfo, mergeStackIntoRepoInfo } from './detect.js'
+import { detectRepoInfo, mergeStackIntoRepoInfo, buildDetectedToolsSet } from './detect.js'
 import type { CliContext, IdeChoice, TechTool, TeamTool, StackConfig } from './types.js'
 
 export default async function update({
@@ -75,13 +75,7 @@ export default async function update({
   let removedTools: string[] = []
 
   if (wantsReconfigure) {
-    const detectedTools = new Set([
-      ...(repoInfo.cms ?? []),
-      ...(repoInfo.databases ?? []),
-      ...(repoInfo.deployment ?? []),
-      ...(repoInfo.monorepo ? [repoInfo.monorepo] : []),
-      ...((repoInfo.frameworks ?? []).map((f) => (f === 'next' ? 'nextjs' : f))),
-    ])
+    const detectedTools = buildDetectedToolsSet(repoInfo)
 
     const currentTech = new Set(oldStack?.techTools ?? [])
     const currentTeam = new Set(oldStack?.teamTools ?? [])

package/src/dashboard/node_modules/.vite/deps/_metadata.json

@@ -1,25 +1,25 @@
 {
-  "hash": "3f0edba6",
+  "hash": "815792e6",
   "configHash": "30f8ea04",
-  "lockfileHash": "46ec4540",
-  "browserHash": "a491603a",
+  "lockfileHash": "44ee7e5a",
+  "browserHash": "2bd8086a",
   "optimized": {
     "astro > cssesc": {
       "src": "../../../../../node_modules/cssesc/cssesc.js",
       "file": "astro___cssesc.js",
-      "fileHash": "53bab571",
+      "fileHash": "de3913dc",
       "needsInterop": true
     },
     "astro > aria-query": {
       "src": "../../../../../node_modules/aria-query/lib/index.js",
       "file": "astro___aria-query.js",
-      "fileHash": "b89dc7f1",
+      "fileHash": "4d9cf017",
       "needsInterop": true
     },
     "astro > axobject-query": {
       "src": "../../../../../node_modules/axobject-query/lib/index.js",
       "file": "astro___axobject-query.js",
-      "fileHash": "184eaa9e",
+      "fileHash": "fe9c9069",
       "needsInterop": true
     }
   },

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

@@ -97,10 +97,11 @@ Synchronous — blocks until result. Use when:
 
 Call with a detailed prompt including objective, file paths, acceptance criteria, and what to return in the result.
 
-**After each sub-agent returns**, log immediately:
+**After each sub-agent returns**, log the delegation record before doing anything else (before review, before verification):
 ```bash
-echo '{"timestamp":"...","session_id":"<branch>","agent":"...","model":"...","tier":"...","mechanism":"sub-agent","outcome":"...","retries":0,"phase":N,"file_partition":["..."]}' >> .github/customizations/logs/delegations.ndjson
+echo '{"timestamp":"<ISO-NOW>","session_id":"<branch>","agent":"<name>","model":"<model>","tier":"<tier>","mechanism":"sub-agent","linear_issue":"<issue-or-N/A>","outcome":"<success|partial|failed>","retries":0,"phase":<N>,"file_partition":["<paths>"]}' >> .github/customizations/logs/delegations.ndjson
 ```
+Verify: `tail -1 .github/customizations/logs/delegations.ndjson`
 
 ### Background Agents — Delegate Session
 
@@ -112,10 +113,11 @@ Async in isolated Git worktree. Use when:
 
 Spawn via: Delegate Session → Background → Select agent → Enter prompt with full self-contained context (they cannot ask follow-ups).
 
-**After spawning**, log immediately (with `"outcome":"pending"`):
+**After spawning**, log the delegation record before spawning another agent or doing any other work:
 ```bash
-echo '{"timestamp":"...","session_id":"<branch>","agent":"...","model":"...","tier":"...","mechanism":"background","outcome":"pending","retries":0,"phase":N,"file_partition":["..."]}' >> .github/customizations/logs/delegations.ndjson
+echo '{"timestamp":"<ISO-NOW>","session_id":"<branch>","agent":"<name>","model":"<model>","tier":"<tier>","mechanism":"background","linear_issue":"<issue-or-N/A>","outcome":"pending","retries":0,"phase":<N>,"file_partition":["<paths>"]}' >> .github/customizations/logs/delegations.ndjson
 ```
+Verify: `tail -1 .github/customizations/logs/delegations.ndjson`
 
 **Rule of thumb:** Sub-agents for the critical path. Background agents for parallel work off the critical path.
 
@@ -196,7 +198,7 @@ For complex tasks (score 5+), load the **decomposition** skill for the Delegatio
 For each task:
   1. Move issue → In Progress
   2. Delegate to specialist agent
-  3. Log delegation to delegations.ndjson (immediately)
+  3. Log delegation to delegations.ndjson (immediately — verify with `tail -1`)
   4. Monitor for drift (load orchestration-protocols skill)
   5. Verify output:
      - Changed files within partition
@@ -239,14 +241,18 @@ See [shared-delivery-phase.md](../agent-workflows/shared-delivery-phase.md) for
 
 ## Observability
 
-Delegation logging happens **inline with each delegation** (see § Delegation above). Additionally:
+> **⛔ HARD GATE — ALL observability logging is mandatory.** No record type is optional.
+> The Session Guard will flag missing records, but do not rely on it — log inline as you go.
 
-- Session records → `sessions.ndjson` (one per task, before yielding to user)
-- Fast reviews → `reviews.ndjson`
-- Panel reviews → `panels.ndjson`
-- Disputes → `disputes.ndjson`
+| Record | File | When to log | Timing |
+|--------|------|-------------|--------|
+| **Session** | `sessions.ndjson` | Every session — always | Before yielding to user |
+| **Delegation** | `delegations.ndjson` | After each `runSubagent` / background spawn | **Inline** — immediately after each delegation, before review |
+| **Fast review** | `reviews.ndjson` | After each fast review | After review completes |
+| **Panel** | `panels.ndjson` | After each panel majority vote | After panel completes |
+| **Dispute** | `disputes.ndjson` | After each dispute is created | When dispute is filed |
 
-The **Session Guard** verifies completeness as your last action. Pass it: task description, delegation list, whether reviews/panels ran, retries, discoveries, files changed, commit/branch status.
+**Self-check before calling Session Guard:** Count delegations, reviews, and panels performed → count records written → numbers must match for each type. If any count is off, fix it before calling the guard.
 
 ## Rules
 
@@ -260,7 +266,7 @@ The **Session Guard** verifies completeness as your last action. Pass it: task d
 8. Never proceed to dependent task until prerequisite is verified
 9. Sub-agents must not spawn other sub-agents (no recursive delegation)
 10. Never push to `main` — feature branch → PR → human merges
-11. Log every delegation inline — do not defer to session end
+11. Log every delegation inline — immediately after each `runSubagent` or background spawn, not at session end
 12. Steer early — don't wait until an agent finishes to redirect when you spot drift
 13. Never exceed session budget without checkpointing — context degrades after 8+ delegations
 14. Read `LESSONS-LEARNED.md` before delegating — include relevant lessons in prompts

package/src/orchestrator/instructions/general.instructions.md

@@ -181,35 +181,39 @@ Append one JSON line per task using `echo '...' >> <file>`. When the Team Lead w
 echo '{"timestamp":"2026-03-01T14:00:00Z","agent":"Developer","model":"claude-opus-4-6","task":"Fix login redirect bug","outcome":"success","duration_min":15,"files_changed":3,"retries":0,"lessons_added":[],"discoveries":[]}' >> .github/customizations/logs/sessions.ndjson
 ```
 
-**Delegation record** (Team Lead only, after each delegation):
+**Delegation record** (Team Lead only, **immediately after each delegation — not at session end**):
 ```bash
 echo '{"timestamp":"2026-03-01T14:00:00Z","session_id":"feat/prj-57","agent":"Developer","model":"gpt-5.3-codex","tier":"fast","mechanism":"sub-agent","linear_issue":"PRJ-57","outcome":"success","retries":0,"phase":2,"file_partition":["src/components/"]}' >> .github/customizations/logs/delegations.ndjson
 ```
+Verify: `tail -1 .github/customizations/logs/delegations.ndjson`
 
-**Fast review record** (Team Lead, after each fast review):
+**Fast review record** (Team Lead, **immediately after each fast review**):
 ```bash
 echo '{"timestamp":"2026-03-01T14:30:00Z","linear_issue":"PRJ-42","agent":"Developer","reviewer_model":"gpt-5-mini","verdict":"pass","attempt":1,"issues_critical":0,"issues_major":0,"issues_minor":2,"confidence":"high","escalated":false,"duration_sec":45}' >> .github/customizations/logs/reviews.ndjson
 ```
+Verify: `tail -1 .github/customizations/logs/reviews.ndjson`
 
-**Panel record** (after each panel majority vote):
+**Panel record** (Panel runner, **immediately after each panel majority vote**):
 ```bash
 echo '{"timestamp":"2026-03-01T15:00:00Z","panel_key":"auth-review","verdict":"pass","pass_count":2,"block_count":1,"must_fix":0,"should_fix":3,"reviewer_model":"claude-opus-4-6","weighted":false,"attempt":1,"linear_issue":"PRJ-42","artifacts_count":5}' >> .github/customizations/logs/panels.ndjson
 ```
+Verify: `tail -1 .github/customizations/logs/panels.ndjson`
 
-**Dispute record** (Team Lead, after each dispute):
+**Dispute record** (Team Lead, **immediately after each dispute**):
 ```bash
 echo '{"timestamp":"2026-03-01T16:00:00Z","dispute_id":"DSP-001","linear_issue":"PRJ-42","priority":"high","trigger":"panel-3x-block","implementing_agent":"Developer","reviewing_agents":["Reviewer","Panel (3x)"],"total_attempts":6,"est_tokens_spent":120000,"status":"pending","resolution_option_chosen":null,"resolved_at":null}' >> .github/customizations/logs/disputes.ndjson
 ```
+Verify: `tail -1 .github/customizations/logs/disputes.ndjson`
 
 ### Pre-Response Logging Checklist
 
 **STOP before responding to the user.** Verify each applicable item:
 
 - [ ] **Session logged** — `sessions.ndjson` has a new line for this session (ALWAYS required)
-- [ ] **Delegations logged** — `delegations.ndjson` has a line for each delegation (Team Lead only)
-- [ ] **Reviews logged** — `reviews.ndjson` has a line for each fast review performed (if any)
-- [ ] **Panels logged** — `panels.ndjson` has a line for each panel review performed (if any)
-- [ ] **Disputes logged** — `disputes.ndjson` has a line for each dispute created (if any)
+- [ ] **Delegations logged** — `delegations.ndjson` has a line for **each** delegation (Team Lead only). Count delegations → count records → must match
+- [ ] **Reviews logged** — `reviews.ndjson` has a line for **each** fast review performed. Count reviews → count records → must match
+- [ ] **Panels logged** — `panels.ndjson` has a line for **each** panel review performed. Count panels → count records → must match
+- [ ] **Disputes logged** — `disputes.ndjson` has a line for **each** dispute created. Count disputes → count records → must match
 
 If ANY required log is missing, append it NOW before responding.
 

package/src/orchestrator/plugins/figma/config.ts

@@ -13,9 +13,7 @@ export const config: PluginConfig = {
     type: 'stdio',
     command: 'npx',
     args: ['-y', '@anthropic/figma-mcp@latest'],
-    env: {
-      FIGMA_ACCESS_TOKEN: '${FIGMA_ACCESS_TOKEN}',
-    },
+    envFile: '${workspaceFolder}/.env'
   },
   authType: 'env-token',
   envVars: [

package/src/orchestrator/skills/agent-hooks/SKILL.md

@@ -111,11 +111,12 @@ Pre-Delegate:
 
 ### Actions
 
-0. **Log the delegation NOW** — Append a record to `.github/customizations/logs/delegations.ndjson` immediately. Do this BEFORE review or verification — logging must not depend on review passing.
+0. **Log the delegation** — Append a record to `.github/customizations/logs/delegations.ndjson` **before** proceeding to review or verification.
    ```bash
-   echo '{"timestamp":"...","session_id":"<branch>","agent":"...","model":"...","tier":"...","mechanism":"sub-agent","outcome":"...","retries":0,"phase":N,"file_partition":["..."]}' >> .github/customizations/logs/delegations.ndjson
+   echo '{"timestamp":"...","session_id":"<branch>","agent":"...","model":"...","tier":"...","mechanism":"sub-agent","linear_issue":"<issue-or-N/A>","outcome":"...","retries":0,"phase":N,"file_partition":["..."]}' >> .github/customizations/logs/delegations.ndjson
    ```
-1. **Fast review (mandatory)** — Run the `fast-review` skill against the agent's output. This is a **non-skippable gate**. See the fast-review skill for the full procedure (single reviewer sub-agent, automatic retry, escalation). Only after the fast review passes do you proceed to the remaining post-delegate actions below.
+   Verify: `tail -1 .github/customizations/logs/delegations.ndjson`
+1. **Fast review (mandatory)** — Run the `fast-review` skill against the agent's output. This is a **non-skippable gate**. See the fast-review skill for the full procedure (single reviewer sub-agent, automatic retry, escalation). Log the review to `reviews.ndjson` immediately after. Only after the fast review passes do you proceed to the remaining post-delegate actions below.
 2. **Verify output** — Read changed files. Check that changes stay within the agent's file partition.
 2. **Run verification** — Execute appropriate checks: lint, type-check, tests, or visual inspection.
 3. **Check acceptance criteria** — Compare output against the tracker issue's acceptance criteria. Each criterion must be independently verified.
@@ -127,11 +128,12 @@ Pre-Delegate:
 
 ```
 Post-Delegate:
-☐ Delegation logged to delegations.ndjson (FIRST — before anything else)
+☐ Delegation logged to delegations.ndjson (before review — verify with tail -1)
 ☐ Changed files reviewed
 ☐ Files within partition
 ☐ Lint/test/build passes
 ☐ Fast review PASS (mandatory — load fast-review skill)
+☐ Review logged to reviews.ndjson (verify with tail -1)
 ☐ Acceptance criteria met
 ☐ Discovered issues tracked (not ignored)
 ☐ Lessons captured (if retries occurred)