muse-crew 0.1.0

package/seed/workflows/standard.md

@@ -0,0 +1,34 @@
+# Standard
+
+The default workflow for feature work and improvements. Like Bugfix but without reproduction — the problem is already understood.
+
+## Steps
+
+### Triage
+**Identity:** Sage
+Validate, prioritize, connect dependencies, assign this workflow.
+
+### Map
+**Identity:** Mara
+Research options, pick the path, write the spec.
+
+### Build
+**Identity:** Wren
+Execute the spec.
+
+### Review
+**Identity:** Cass
+**Constraint:** Independent context. Review cold.
+
+### Integrate
+**Identity:** Wren
+Merge changes into the target branch. Create the commit with a clear message.
+
+### Deploy
+**Identity:** Wren
+Deploy the changes.
+
+### QA
+**Identity:** Hazel
+**Personas:** Yes — Hazel wears a persona costume to test from that perspective.
+**Constraint:** No code context. Pass or fail. File follow-up tasks for related issues found during testing.

package/workflows/AGENTS.md

@@ -0,0 +1,12 @@
+# AGENTS.md
+
+Executable Muse workflow scripts (JavaScript). These are what the workflow runtime actually runs.
+
+- `crew-dispatch.js` — reads the board, claims eligible tasks, returns structured launch records
+- `crew-init.js` — sets up a new crew instance: orchestration folders, dashboard, cron, sample project
+- `standard.js` — default task workflow: Triage → Map → Build → Review → Integrate → Deploy → QA
+- `bugfix.js` — adds Reproduce after Triage
+- `chore.js` — drops QA (low-risk)
+- `docs.js` — Tate writes, Cass reviews
+
+The `.js` scripts here are distinct from the `.md` definitions in `seed/workflows/` and `.orchestration/workflows/`. The `.md` files describe phases and prompts; these `.js` files execute them.

package/workflows/bugfix.js

@@ -0,0 +1,341 @@
+export const meta = {
+  name: "crew-bugfix",
+  description: "Bugfix workflow: Triage → Reproduce → Map → Build → Review → Integrate → Deploy → QA",
+  phases: ["Triage", "Reproduce", "Map", "Build", "Review", "Integrate", "Deploy", "QA"],
+  steps: [
+    { name: "Triage", identity: "sage" },
+    { name: "Reproduce", identity: "hazel" },
+    { name: "Map", identity: "mara" },
+    { name: "Build", identity: "wren" },
+    { name: "Review", identity: "cass" },
+    { name: "Integrate", identity: "wren" },
+    { name: "Deploy", identity: "wren" },
+    { name: "QA", identity: "hazel" }
+  ],
+  reworkTarget: "Build"
+};
+
+const inputs = args ?? {};
+const taskId = inputs.task_id;
+const taskTitle = inputs.task_title || "";
+const taskDescription = inputs.task_description || "";
+const firstSessionId = inputs.session_id || null;
+const startStepIndex = inputs.start_step_index || 0;
+
+// Config from args — backward-compatible fallbacks for manual launches
+const DASHBOARD_SLUG = inputs.dashboardSlug || "orchestra-dashboard";
+const crewHome = inputs.crewHome || "~/workspace/.jarvis";
+const ORCH_PATH = crewHome + "/.orchestration";
+// Pin lifecycle scripts to this run
+const LIFECYCLE_SRC = crewHome + "/lib/worktree-lifecycle.sh";
+const MERGE_LOCK_SRC = crewHome + "/lib/merge-lock.sh";
+const RUN_LIB = "/tmp/crew-lib-" + taskId;
+const LIFECYCLE = RUN_LIB + "/worktree-lifecycle.sh";
+const MERGE_LOCK = RUN_LIB + "/merge-lock.sh";
+
+// Project config — passed by dispatcher, falls back to dashboard defaults
+const projectConfig = inputs.project_config || {};
+const REPO_PATH = projectConfig.repo_path || "~/workspace/ts-spaces/orchestra-dashboard";
+const DEPLOY_TYPE = projectConfig.deploy_type || "artifact";
+const DEPLOY_SLUG = projectConfig.deploy_slug || DASHBOARD_SLUG;
+const PROJECT_DESC = projectConfig.description || "React + TypeScript web dashboard (client/src/, server/src/, drizzle/)";
+const RELEASE_SCRIPT = crewHome + "/crew-release.sh";
+
+if (!taskId) {
+  throw new Error("task_id is required in args");
+}
+
+// Work-agent result schema. Runtime retries on non-JSON (structured outputs).
+// Workflow wraps in try/catch so exhausted retries block instead of crashing.
+const WORK_SCHEMA = {
+  type: "object",
+  properties: { passed: { type: "boolean" }, summary: { type: "string" } },
+  required: ["passed", "summary"]
+};
+
+// STEPS inline — export const meta is parsed as metadata, not a runtime binding
+const STEPS = [
+  { name: "Triage", identity: "sage" },
+  { name: "Reproduce", identity: "hazel" },
+  { name: "Map", identity: "mara" },
+  { name: "Build", identity: "wren" },
+  { name: "Review", identity: "cass" },
+  { name: "Integrate", identity: "wren" },
+  { name: "Deploy", identity: "wren" },
+  { name: "QA", identity: "hazel" }
+];
+const BUILD_INDEX = STEPS.findIndex(s => s.name === 'Build');
+if (BUILD_INDEX < 0) throw new Error("STEPS missing 'Build' step");
+const MAX_REWORK = 2;
+let reworkCount = 0;
+let rejectionNotes = inputs.rejection_notes || "";
+let mapperSpec = "";
+let i = startStepIndex;
+
+// Pin lifecycle scripts
+await agent(
+  "Snapshot lifecycle scripts for version pinning.\n" +
+  "Run: mkdir -p " + RUN_LIB + " && cp " + LIFECYCLE_SRC + " " + LIFECYCLE + " && cp " + MERGE_LOCK_SRC + " " + MERGE_LOCK + " && chmod +x " + LIFECYCLE + " " + MERGE_LOCK,
+  { key: "pin-lifecycle", label: "Pinning lifecycle scripts", schema: { type: "object" } }
+);
+
+while (i < STEPS.length) {
+  const step = STEPS[i];
+  const isFirstClaim = (i === startStepIndex && reworkCount === 0);
+
+  phase(step.name);
+  log(step.name + " step (" + step.identity + ") for task " + taskId);
+
+  // Claim session
+  let activeSessionId;
+  if (isFirstClaim && firstSessionId) {
+    activeSessionId = firstSessionId;
+  } else {
+    const claimResult = await agent(
+      "Claim a session for this task step.\n" +
+      "Call artifact_invoke_action on slug \"" + DASHBOARD_SLUG + "\", action \"claimtask\", args:\n" +
+      "{ \"task_id\": \"" + taskId + "\", \"identity\": \"" + step.identity + "\", \"step\": \"" + step.name + "\", \"notes\": \"" + step.name + " step started" + (reworkCount > 0 ? " (rework #" + reworkCount + ")" : "") + "\" }.\n" +
+      "Return the session_id from the response.",
+      {
+        key: "claim-" + step.name + (reworkCount > 0 ? "-r" + reworkCount : ""),
+        label: "Claiming " + step.name,
+        schema: {
+          type: "object",
+          properties: { session_id: { type: "string" } },
+          required: ["session_id"]
+        }
+      }
+    );
+    activeSessionId = claimResult.session_id;
+  }
+
+  var safeTitle = taskTitle.replace(/"/g, "'").replace(/\\/g, "\\\\").replace(/`/g, "'");
+  var instructions = "";
+
+  if (step.name === "Triage") {
+    instructions = "Validate the task, check clarity, note dependencies, confirm the bugfix workflow assignment.\nIf the task needs decomposition, note that in your assessment.\nYour final response MUST be valid JSON and nothing else: { \"summary\": \"your assessment\", \"passed\": true }. No prose, no markdown, just the JSON object.";
+
+  } else if (step.name === "Reproduce") {
+    instructions = "Reproduce the bug from a user's perspective. You are CODE-BLIND — do NOT read source code.\n" +
+      "To investigate, use artifact_invoke_action on slug \"" + DASHBOARD_SLUG + "\" with action \"getstate\" (args {}) to read current sessions, events, and tasks.\n" +
+      "Look at session notes in the returned data — check whether multiline content has newlines preserved or runs together.\n" +
+      "You can also check specific sessions with the getevents action for evidence.\n" +
+      "Do NOT use artifact_inspect — it is async and will not return results inline.\n" +
+      "Capture concrete evidence from the data you retrieve.\n" +
+      "If reproduction succeeds, your final response MUST be valid JSON and nothing else: { \"passed\": true, \"summary\": \"reproduction evidence and steps\" }.\n" +
+      "If reproduction fails, your final response MUST be valid JSON and nothing else: { \"passed\": false, \"summary\": \"what you tried and why reproduction failed\" }.\n" +
+      "No prose, no markdown, just the JSON object.";
+
+  } else if (step.name === "Map") {
+    instructions = "Update the task with a solution-oriented spec. Research options, pick the shortest path.\nThe builder will edit source files in a git worktree.\nProject: " + PROJECT_DESC + "\nWrite it clearly enough that the builder does not need to ask questions.\nYour final response MUST be valid JSON and nothing else: { \"summary\": \"what you specified\", \"passed\": true }. No prose, no markdown, just the JSON object.";
+
+  } else if (step.name === "Build") {
+    instructions = "STEP 1: Prepare your worktree.\n" +
+      "Run: CREW_REPO=" + REPO_PATH + " " + LIFECYCLE + " prepare " + taskId + "\n" +
+      "If the output says CREATED or REUSED, proceed. If it says ERROR, stop and set passed to false.\n\n" +
+      "STEP 2: Edit source files to implement the mapper's spec below.\n" +
+      (mapperSpec ? "MAPPER'S SPEC (implement exactly this):\n" + mapperSpec + "\n\n" : "") +
+      "Your working directory: " + REPO_PATH + "/.worktrees/" + taskId + "/\n" +
+      "This is the project source: " + PROJECT_DESC + "\n" +
+      "Edit the TypeScript source files directly. Do NOT use artifact_edit — that happens in the Deploy phase.\n" +
+      "Do not add unrequested features. Build exactly what the spec calls for.\n\n" +
+      "STEP 3: Commit your changes.\n" +
+      "cd " + REPO_PATH + "/.worktrees/" + taskId + "\n" +
+      "git add -A\n" +
+      "git commit -m \"fix: " + safeTitle + "\"\n\n" +
+      (rejectionNotes ? "This is REWORK after rejection. Address these specific issues:\n" + rejectionNotes + "\n\n" : "") +
+      "Your final response MUST be valid JSON and nothing else: { \"summary\": \"what you built\", \"passed\": true }. No prose, no markdown, just the JSON object.";
+
+  } else if (step.name === "Review") {
+    instructions = "Review independently and cold. You have NOT seen any reasoning from the builder.\nDo NOT access the task dashboard, event log, or any comments. Your review is based solely on the spec and the code.\n\n" +
+      (mapperSpec ? "MAPPER'S SPEC (the builder was asked to implement exactly this):\n" + mapperSpec + "\n\n" : "Read the spec (from the task description or spec files under " + crewHome + "/).\n\n") +
+      "Examine the code changes by running:\n" +
+      "CREW_REPO=" + REPO_PATH + " " + LIFECYCLE + " inspect " + taskId + "\n\n" +
+      "You can also read specific files in the worktree at:\n" +
+      REPO_PATH + "/.worktrees/" + taskId + "/\n\n" +
+      "Check quality, correctness, and spec compliance.\n" +
+      "If the work passes review, your final response MUST be valid JSON and nothing else: { \"passed\": true, \"summary\": \"approval notes\" }.\n" +
+      "If the work fails review, your final response MUST be valid JSON and nothing else: { \"passed\": false, \"summary\": \"rejection notes explaining what needs to change\" }.\n" +
+      "No prose, no markdown, just the JSON object.";
+
+  } else if (step.name === "Integrate") {
+    instructions = "Merge the approved task branch into main.\n\n" +
+      "Run: CREW_REPO=" + REPO_PATH + " " + LIFECYCLE + " integrate " + taskId + " \"merge: fix: " + safeTitle + "\"\n\n" +
+      "Read the output:\n" +
+      "- If it contains MERGED, integration succeeded. Report the merged commit hash.\n" +
+      "- If it contains LOCK_HELD, another task is deploying. Set passed to false.\n" +
+      "- If it contains CONFLICT, a merge conflict occurred. Set passed to false with details.\n" +
+      "- If it contains ERROR, something else failed. Set passed to false.\n\n" +
+      "Your final response MUST be valid JSON and nothing else: { \"summary\": \"result\", \"passed\": true/false }. No prose, no markdown, just the JSON object.";
+
+  } else if (step.name === "Deploy") {
+    if (DEPLOY_TYPE === "repo") {
+      // Repo projects: install immutable release and atomically activate
+      instructions = "Deploy repo changes via the immutable release system.\n\n" +
+        "STEP 0: Refresh the merge lock to prevent stale-lock breaking during deploy.\n" +
+        "Run: CREW_REPO=" + REPO_PATH + " " + LIFECYCLE + " refresh-lock " + taskId + "\n\n" +
+        "STEP 1: Install and activate the new release.\n" +
+        "Run: " + RELEASE_SCRIPT + " deploy " + REPO_PATH + "\n" +
+        "Verify the output contains INSTALLED and ACTIVATED (or EXISTS and ACTIVATED if unchanged).\n\n" +
+        "STEP 2: Finalize.\n" +
+        "Run: CREW_REPO=" + REPO_PATH + " " + LIFECYCLE + " post-deploy " + taskId + "\n" +
+        "If the output contains DEPLOYED, finalization is complete.\n\n" +
+        "Your final response MUST be valid JSON and nothing else: { \"summary\": \"release activated and finalized\", \"passed\": true }.\n" +
+        "No prose, no markdown, just the JSON object.";
+    } else {
+      instructions = "Deploy the merged code to the live artifact.\n\n" +
+        "STEP 0: Refresh the merge lock to prevent stale-lock breaking during deploy.\n" +
+        "Run: CREW_REPO=" + REPO_PATH + " " + LIFECYCLE + " refresh-lock " + taskId + "\n\n" +
+        "STEP 1: Deploy to the live artifact.\n" +
+        "Get the change summary: cd " + REPO_PATH + " && git log -1 --stat\n" +
+        "Then call artifact_edit with slug \"" + DEPLOY_SLUG + "\" and verbatim_request:\n" +
+        "'Rebuild the application from current source. Do not modify any source files — just rebuild and deploy what is on disk.'\n" +
+        "Wait for the build to complete by polling artifact_status until it is no longer running.\n\n" +
+        "STEP 2: Finalize.\n" +
+        "Run: CREW_REPO=" + REPO_PATH + " " + LIFECYCLE + " post-deploy " + taskId + "\n" +
+        "If the output contains DEPLOYED, deployment is complete.\n\n" +
+        "If artifact_edit failed, still run post-deploy to release the merge lock and clean up.\n" +
+        "Report the failure: { \"passed\": false, \"summary\": \"artifact deployment failed: [details]\" }.\n\n" +
+        "Your final response MUST be valid JSON and nothing else: { \"summary\": \"deployed changes\", \"passed\": true }.\n" +
+        "No prose, no markdown, just the JSON object.";
+    }
+
+  } else if (step.name === "QA") {
+    instructions = "Final QA testing. You are CODE-BLIND — do NOT read source code.\n" +
+      "To test, use artifact_invoke_action on slug \"" + DASHBOARD_SLUG + "\" with action \"getstate\" (args {}) to read current sessions, events, and tasks.\n" +
+      "Verify the fix by checking that session notes in the returned data now handle newlines correctly.\n" +
+      "You can also check specific data with the getevents action.\n" +
+      "Do NOT use artifact_inspect — it is async and will not return results inline.\n" +
+      "File follow-up tasks via artifact_invoke_action createtask on slug \"" + DASHBOARD_SLUG + "\" for related issues.\n" +
+      "If testing passes, your final response MUST be valid JSON and nothing else: { \"passed\": true, \"summary\": \"test results\" }.\n" +
+      "If testing fails, your final response MUST be valid JSON and nothing else: { \"passed\": false, \"summary\": \"failure details\" }.\n" +
+      "No prose, no markdown, just the JSON object.";
+  }
+
+  // Task event history — all phases except Review see the comment log
+  var eventPreamble = "";
+  if (step.name !== "Review") {
+    eventPreamble = "CONTEXT: First, fetch this task's event history for background.\n" +
+      "Call artifact_invoke_action on slug \"" + DASHBOARD_SLUG + "\", action \"getevents\", args: { \"limit\": 100 }.\n" +
+      "Look through returned events for entries matching task_id \"" + taskId + "\". They contain notes and decisions from prior phases.\n\n";
+  }
+
+  var stepResult;
+  try {
+    stepResult = await agent(
+    "Read the identity file at " + ORCH_PATH + "/identities/" + step.identity + ".md using the read tool, and embody that character fully.\n\n" +
+    "## Your Assignment\n\n" +
+    "Task: " + taskTitle + "\n" +
+    "Task ID: " + taskId + "\n" +
+    "Description: " + taskDescription + "\n" +
+    "Step: " + step.name + "\n" +
+    (step.name !== "Review" ? "Dashboard slug: " + DASHBOARD_SLUG + "\n" : "") +
+    "\n## Instructions\n\n" + eventPreamble + instructions + "\n\n" +
+    "CONSTRAINT: Do NOT call logevent or upsertagentsession — the workflow handles all phase tracking after your step completes.\n\n" +
+    "Stay in character. Do the work thoroughly.",
+    {
+      key: "work-" + step.name + (reworkCount > 0 ? "-r" + reworkCount : ""),
+      label: step.identity + ": " + step.name + " on \"" + taskTitle + "\"",
+      timeoutMs: 3600000,
+      schema: WORK_SCHEMA
+    }
+    );
+  } catch (e) {
+    log(step.name + " agent failed: " + (e.message || String(e)).slice(0, 500));
+    stepResult = null;
+  }
+
+  // If schema retries were exhausted, block gracefully
+  if (!stepResult || typeof stepResult.summary !== "string") {
+    log(step.name + " closeout unrecoverable — blocking");
+    await agent(
+      "Record closeout failure.\n" +
+      "Call artifact_invoke_action on slug \"" + DASHBOARD_SLUG + "\", action \"upsertagentsession\", args:\n" +
+      "{ \"id\": \"" + activeSessionId + "\", \"task_id\": \"" + taskId + "\", \"identity\": \"" + step.identity + "\", \"step\": \"" + step.name + "\", \"status\": \"blocked\", \"notes\": \"Agent failed to return structured result after retries\" }.\n" +
+      "Then call artifact_invoke_action on slug \"" + DASHBOARD_SLUG + "\", action \"logevent\", args:\n" +
+      "{ \"task_id\": \"" + taskId + "\", \"type\": \"blocked\", \"message\": \"" + step.name + " agent failed after retries — workflow blocked\" }.",
+      { key: "record-block-" + step.name, label: "Recording closeout failure", schema: { type: "object" } }
+    );
+    return {
+      __hatchWorkflowControl: "blocked",
+      result: {
+        blocked_reason: step.name + " agent failed after retries",
+        message: "The " + step.identity + " agent's work may be valid — structured output failed.",
+        task_id: taskId
+      }
+    };
+  }
+
+  const summary = (stepResult.summary || "Step completed").slice(0, 2000);
+  const passed = stepResult.passed !== false;
+  const status = passed ? "completed" : "rejected";
+
+  // Capture mapper's spec for Build and Review
+  if (step.name === "Map" && passed) {
+    mapperSpec = summary;
+  }
+
+  await agent(
+    "Update the session and log the event.\n" +
+    "Call artifact_invoke_action on slug \"" + DASHBOARD_SLUG + "\", action \"upsertagentsession\", args:\n" +
+    "{ \"id\": \"" + activeSessionId + "\", \"task_id\": \"" + taskId + "\", \"identity\": \"" + step.identity + "\", \"step\": \"" + step.name + "\", \"status\": \"" + status + "\", \"notes\": " + JSON.stringify(summary) + " }.\n" +
+    "Then call artifact_invoke_action on slug \"" + DASHBOARD_SLUG + "\", action \"logevent\", args:\n" +
+    "{ \"task_id\": \"" + taskId + "\", \"type\": \"" + status + "\", \"identity\": \"" + step.identity + "\", \"message\": \"" + step.name + " " + status + " by " + step.identity + "\" }.",
+    {
+      key: "record-" + step.name + (reworkCount > 0 ? "-r" + reworkCount : ""),
+      label: "Recording " + step.name + " result",
+      schema: { type: "object" }
+    }
+  );
+
+  // Reproduce failure blocks the task
+  if (!passed && step.name === "Reproduce") {
+    log("Reproduction failed for task " + taskId + " — blocking");
+    await agent(
+      "Mark this task as blocked because reproduction failed.\n" +
+      "Call artifact_invoke_action on slug \"" + DASHBOARD_SLUG + "\", action \"logevent\", args:\n" +
+      "{ \"task_id\": \"" + taskId + "\", \"type\": \"blocked\", \"message\": \"Reproduction failed — needs PM attention\" }.",
+      { key: "block-repro", label: "Blocking: reproduction failed", schema: { type: "object" } }
+    );
+    return { status: "blocked", task_id: taskId, reason: "Reproduction failed" };
+  }
+
+  // Review/QA rejection bounces to Build
+  if (!passed && (step.name === "Review" || step.name === "QA")) {
+    reworkCount++;
+    if (reworkCount > MAX_REWORK) {
+      log("Max rework attempts reached for task " + taskId + " — worktree preserved at .worktrees/" + taskId + " for manual inspection");
+      return { status: "blocked", task_id: taskId, reason: "Exceeded " + MAX_REWORK + " rework attempts after " + step.name + " rejection. Worktree preserved." };
+    }
+    rejectionNotes = summary;
+    i = BUILD_INDEX;
+    log(step.name + " rejected — bouncing to Build (rework #" + reworkCount + ")");
+    continue;
+  }
+
+  // Integrate failure blocks the task
+  if (!passed && step.name === "Integrate") {
+    log("Integration failed for task " + taskId + ": " + summary);
+    return { status: "blocked", task_id: taskId, reason: "Integration failed: " + summary };
+  }
+
+  // Deploy failure blocks the task
+  if (!passed && step.name === "Deploy") {
+    log("Deploy failed for task " + taskId + ": " + summary);
+    return { status: "blocked", task_id: taskId, reason: "Deploy failed: " + summary };
+  }
+
+  i++;
+}
+
+await agent(
+  "Mark this task as done.\n" +
+  "Call artifact_invoke_action on slug \"" + DASHBOARD_SLUG + "\", action \"updatetask\", args: { \"id\": \"" + taskId + "\", \"state\": \"done\" }.\n" +
+  "Then call artifact_invoke_action on slug \"" + DASHBOARD_SLUG + "\", action \"logevent\", args:\n" +
+  "{ \"task_id\": \"" + taskId + "\", \"type\": \"completed\", \"message\": \"All bugfix workflow steps complete.\" }.",
+  { key: "task-done", label: "Completing task: " + taskTitle, schema: { type: "object" } }
+);
+
+log("Bugfix workflow complete for task " + taskId);
+await agent("Clean up pinned lifecycle scripts: rm -rf " + RUN_LIB, { key: "cleanup-pins", label: "Cleaning pinned scripts", schema: { type: "object" } });
+return { status: "ok", task_id: taskId, message: "Bugfix workflow complete for " + taskTitle };