muse-crew 0.1.0

package/workflows/crew-init.js

@@ -0,0 +1,254 @@
+export const meta = {
+  name: "crew-init",
+  description: "Initialize Muse Crew: bootstrap release, scaffold orchestration, register dashboard project, set up polling cron. Idempotent — safe to re-run.",
+  phases: [
+    { name: "release", title: "Bootstrap release system" },
+    { name: "scaffold", title: "Scaffold orchestration directory" },
+    { name: "project", title: "Register dashboard project" },
+    { name: "cron", title: "Create polling cron" },
+    { name: "sweep-cron", title: "Create sweep cron" }
+  ]
+};
+
+// ── Arguments ──────────────────────────────────────────────────────────
+const inputs = args ?? {};
+const crewRepoPath = inputs.crewRepoPath;
+const crewHome = inputs.crewHome;
+const dashboardSlug = inputs.dashboardSlug;
+const dashboardName = inputs.dashboardName || "Muse Crew";
+const cronId = inputs.cronId || "crew-poll";
+const sweepCronId = inputs.sweepCronId || "crew-sweep";
+
+if (!crewRepoPath) throw new Error("crewRepoPath is required — path to muse-crew (git checkout or npm install)");
+if (!crewHome) throw new Error("crewHome is required — e.g. ~/.crew");
+if (!dashboardSlug) throw new Error("dashboardSlug is required — create the dashboard artifact first, then pass its slug here");
+
+const orchDir = crewHome + "/.orchestration";
+
+// ── Phase 1: Release ──────────────────────────────────────────────────
+phase("release");
+var releaseResult;
+try {
+  releaseResult = await agent(
+    "Bootstrap the Muse Crew release system.\n\n" +
+    "Crew repo: " + crewRepoPath + "\n" +
+    "Release home: " + crewHome + "\n" +
+    "Release script (in repo): " + crewRepoPath + "/lib/crew-release.sh\n\n" +
+    "Steps:\n" +
+    "1. Run: test -f " + crewHome + "/crew-release.sh && echo EXISTS || echo MISSING\n" +
+    "2. If EXISTS, run: " + crewHome + "/crew-release.sh current\n" +
+    "   Return { existed: true, hash: <current hash> }\n" +
+    "3. If MISSING, bootstrap:\n" +
+    "   a. Run: bash " + crewRepoPath + "/lib/crew-release.sh init " + crewHome + " " + crewRepoPath + "\n" +
+    "   b. Verify: " + crewHome + "/crew-release.sh current\n" +
+    "   c. Return { existed: false, hash: <hash from current> }\n\n" +
+    "Return JSON with existed (boolean) and hash (string).",
+    {
+      key: "release-1",
+      label: "Bootstrap release system",
+      schema: {
+        type: "object",
+        properties: {
+          existed: { type: "boolean" },
+          hash: { type: "string" }
+        },
+        required: ["existed", "hash"]
+      }
+    }
+  );
+} catch (e) {
+  return { __hatchWorkflowControl: "blocked", result: { blocked_reason: "Release bootstrap failed", message: String(e.message || e) } };
+}
+log("Release: " + (releaseResult.existed ? "existing" : "bootstrapped") + " at " + releaseResult.hash);
+
+// ── Phase 2: Scaffold ─────────────────────────────────────────────────
+// Copies identities (with portraits), personas, workflow docs, and
+// feedback convention from the crew repo into .orchestration/ under crewHome.
+// Uses cp --no-clobber so existing files are never overwritten.
+phase("scaffold");
+var scaffoldResult;
+try {
+  scaffoldResult = await agent(
+    "Scaffold the .orchestration directory from the crew repo.\n\n" +
+    "Source repo: " + crewRepoPath + "\n" +
+    "Destination: " + orchDir + "\n\n" +
+    "Steps:\n" +
+    "1. Create directories:\n" +
+    "   mkdir -p " + orchDir + "/identities " + orchDir + "/personas " + orchDir + "/workflows " + orchDir + "/feedback\n" +
+    "2. Copy identities (.md AND .png — portraits are in the repo):\n" +
+    "   cp -n " + crewRepoPath + "/identities/*.md " + crewRepoPath + "/identities/*.png " + orchDir + "/identities/\n" +
+    "   Also copy personality-notes.md if it exists.\n" +
+    "3. Copy personas:\n" +
+    "   cp -n " + crewRepoPath + "/personas/*.md " + orchDir + "/personas/\n" +
+    "4. Copy workflow documentation (markdown descriptions, not JS scripts):\n" +
+    "   cp -n " + crewRepoPath + "/seed/workflows/*.md " + orchDir + "/workflows/\n" +
+    "5. Copy feedback convention:\n" +
+    "   cp -n " + crewRepoPath + "/seed/feedback/README.md " + orchDir + "/feedback/README.md\n" +
+    "6. List what ended up in " + orchDir + " to confirm.\n\n" +
+    "Return JSON with created (array of relative paths that were newly copied) and skipped (array that already existed).",
+    {
+      key: "scaffold-1",
+      label: "Scaffold .orchestration directory",
+      schema: {
+        type: "object",
+        properties: {
+          created: { type: "array", items: { type: "string" } },
+          skipped: { type: "array", items: { type: "string" } }
+        },
+        required: ["created", "skipped"]
+      }
+    }
+  );
+} catch (e) {
+  return { __hatchWorkflowControl: "blocked", result: { blocked_reason: "Scaffold failed", message: String(e.message || e) } };
+}
+var scaffoldCreated = scaffoldResult.created ? scaffoldResult.created.length : 0;
+var scaffoldSkipped = scaffoldResult.skipped ? scaffoldResult.skipped.length : 0;
+log("Scaffold: " + scaffoldCreated + " created, " + scaffoldSkipped + " skipped");
+
+// ── Phase 3: Register dashboard as project ────────────────────────────
+// The dashboard IS the project. Register it so the crew knows what to work on.
+phase("project");
+var projectResult;
+try {
+  projectResult = await agent(
+    "Register the dashboard as a project in its own database.\n\n" +
+    "Dashboard slug: " + dashboardSlug + "\n\n" +
+    "Steps:\n" +
+    "1. Call artifact_invoke_action with:\n" +
+    "   slug: '" + dashboardSlug + "'\n" +
+    "   action_name: 'createproject'\n" +
+    "   args: {\n" +
+    "     id: '" + dashboardSlug + "',\n" +
+    "     display_name: '" + dashboardName + "',\n" +
+    "     repo_path: '" + crewRepoPath + "',\n" +
+    "     deploy_type: 'artifact',\n" +
+    "     deploy_slug: '" + dashboardSlug + "',\n" +
+    "     description: 'The Muse Crew dashboard — task board, activity feed, and crew controls'\n" +
+    "   }\n" +
+    "2. Return { registered: true } on success.\n\n" +
+    "Return JSON with registered (boolean).",
+    {
+      key: "project-1",
+      label: "Register dashboard project",
+      schema: {
+        type: "object",
+        properties: {
+          registered: { type: "boolean" }
+        },
+        required: ["registered"]
+      }
+    }
+  );
+} catch (e) {
+  return { __hatchWorkflowControl: "blocked", result: { blocked_reason: "Project registration failed", message: String(e.message || e) } };
+}
+log("Project: " + (projectResult.registered ? "registered" : "failed"));
+
+// ── Phase 4: Polling cron ─────────────────────────────────────────────
+// The cron body template lives in the repo at seed/cron-body-template.md.
+// Placeholders: {crewHome}, {dashboardSlug} are replaced with actual values.
+// Owner is the dashboard artifact so deleting the dashboard kills the cron.
+phase("cron");
+var cronResult;
+try {
+  cronResult = await agent(
+    "Check if the polling cron exists and create it if not.\n\n" +
+    "Cron id: " + cronId + "\n" +
+    "Template: " + crewRepoPath + "/seed/cron-body-template.md\n" +
+    "crewHome: " + crewHome + "\n" +
+    "Dashboard slug: " + dashboardSlug + "\n\n" +
+    "Steps:\n" +
+    "1. Call cron_list and look for a job with id '" + cronId + "'\n" +
+    "2. If it exists, return { existed: true }\n" +
+    "3. If not found:\n" +
+    "   a. Read the template at " + crewRepoPath + "/seed/cron-body-template.md\n" +
+    "   b. Replace all occurrences of {crewHome} with: " + crewHome + "\n" +
+    "      Replace all occurrences of {dashboardSlug} with: " + dashboardSlug + "\n" +
+    "   c. Call cron_add with:\n" +
+    "      - id: '" + cronId + "'\n" +
+    "      - title: 'Muse Crew polling loop'\n" +
+    "      - enabled: true\n" +
+    "      - mode: 'task'\n" +
+    "      - schedule: { kind: 'interval', every: '3m' }\n" +
+    "      - owner: 'space:" + dashboardSlug + "'\n" +
+    "      - timeout_secs: 180\n" +
+    "      - body: the processed template text\n" +
+    "   d. Return { existed: false }\n\n" +
+    "Return JSON with existed (boolean).",
+    {
+      key: "cron-1",
+      label: "Create polling cron",
+      schema: {
+        type: "object",
+        properties: {
+          existed: { type: "boolean" }
+        },
+        required: ["existed"]
+      }
+    }
+  );
+} catch (e) {
+  return { __hatchWorkflowControl: "blocked", result: { blocked_reason: "Cron creation failed", message: String(e.message || e) } };
+}
+log("Cron: " + (cronResult.existed ? "already existed" : "created as " + cronId));
+
+// ── Phase 5: Sweep cron ──────────────────────────────────────────────
+phase("sweep-cron");
+var sweepResult;
+try {
+  sweepResult = await agent(
+    "Check if the sweep cron exists and create it if not.\n\n" +
+    "Cron id: " + sweepCronId + "\n" +
+    "crewHome: " + crewHome + "\n" +
+    "Dashboard slug: " + dashboardSlug + "\n\n" +
+    "Steps:\n" +
+    "1. Call cron_list and look for a job with id '" + sweepCronId + "'\n" +
+    "2. If it exists, return { existed: true }\n" +
+    "3. If not found, call cron_add with:\n" +
+    "   - id: '" + sweepCronId + "'\n" +
+    "   - title: 'Muse Crew orphan sweep'\n" +
+    "   - enabled: true\n" +
+    "   - mode: 'task'\n" +
+    "   - schedule: { kind: 'interval', every: '30m' }\n" +
+    "   - owner: 'space:" + dashboardSlug + "'\n" +
+    "   - timeout_secs: 120\n" +
+    "   - body: the body text below\n" +
+    "   Return { existed: false }\n\n" +
+    "Body text for the cron:\n" +
+    "---\n" +
+    "## Muse Crew Orphan Sweep\n\n" +
+    "Run the orphan sweep to clean merged worktrees and break stale merge locks.\n\n" +
+    "Run this command:\n" +
+    crewHome + "/lib/orphan-sweep.sh clean\n\n" +
+    "Report the output. If it says CLEAN, no action was needed.\n" +
+    "---\n\n" +
+    "Return JSON with existed (boolean).",
+    {
+      key: "sweep-cron-1",
+      label: "Create sweep cron",
+      schema: {
+        type: "object",
+        properties: { existed: { type: "boolean" } },
+        required: ["existed"]
+      }
+    }
+  );
+} catch (e) {
+  return { __hatchWorkflowControl: "blocked", result: { blocked_reason: "Sweep cron creation failed", message: String(e.message || e) } };
+}
+log("Sweep cron: " + (sweepResult.existed ? "already existed" : "created as " + sweepCronId));
+
+// ── Summary ───────────────────────────────────────────────────────────
+return {
+  message: "Muse Crew initialized.",
+  crewHome: crewHome,
+  dashboardSlug: dashboardSlug,
+  dashboardName: dashboardName,
+  cronId: cronId,
+  releaseHash: releaseResult.hash,
+  scaffold: { created: scaffoldCreated, skipped: scaffoldSkipped },
+  project: projectResult.registered ? "registered" : "failed",
+  cron: cronResult.existed ? "existed" : "created",
+  sweepCron: sweepResult.existed ? "existed" : "created"
+};

package/workflows/docs.js

@@ -0,0 +1,141 @@
+export const meta = {
+  name: "crew-docs",
+  description: "Docs workflow: Triage → Write → Review",
+  phases: ["Triage", "Write", "Review"],
+  steps: [
+    { name: "Triage", identity: "sage" },
+    { name: "Write", identity: "tate" },
+    { name: "Review", identity: "cass" }
+  ],
+  reworkTarget: "Write"
+};
+
+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";
+
+if (!taskId) {
+  throw new Error("task_id is required in args");
+}
+
+// STEPS inline — export const meta is parsed as metadata, not a runtime binding
+const STEPS = [
+  { name: "Triage", identity: "sage" },
+  { name: "Write", identity: "tate" },
+  { name: "Review", identity: "cass" }
+];
+const WRITE_INDEX = STEPS.findIndex(s => s.name === 'Write');
+if (WRITE_INDEX < 0) throw new Error("STEPS missing 'Write' step");
+const MAX_REWORK = 2;
+let reworkCount = 0;
+let rejectionNotes = inputs.rejection_notes || "";
+let i = startStepIndex;
+
+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);
+
+  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 instructions = "";
+  if (step.name === "Triage") {
+    instructions = "Validate the task, check clarity, confirm the docs workflow assignment.\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 === "Write") {
+    instructions = "Write or revise the documentation the task asks for.\nFollow Tate's voice — clear, conversational, no jargon unless it earns its place.\nAll doc files go under " + crewHome + "/." +
+      (rejectionNotes ? "\n\nREWORK after review rejection. Address:\n" + rejectionNotes : "") +
+      "\nYour final response MUST be valid JSON and nothing else: { \"summary\": \"what you wrote and where\", \"passed\": true }. No prose, no markdown, just the JSON object.";
+  } else if (step.name === "Review") {
+    instructions = "Review the docs independently and cold — clarity, accuracy, completeness.\nNo prior context from the writer.\nIf it passes, your final response MUST be valid JSON and nothing else: { \"passed\": true, \"summary\": \"approval notes\" }.\nIf it fails, your final response MUST be valid JSON and nothing else: { \"passed\": false, \"summary\": \"rejection notes\" }.\nNo prose, no markdown, just the JSON object.";
+  }
+
+  const 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 + "\nTask ID: " + taskId + "\nDescription: " + taskDescription + "\nStep: " + step.name + "\nDashboard slug: " + DASHBOARD_SLUG + "\n\n" +
+    "## Instructions\n\n" + instructions + "\n\nCONSTRAINT: Do NOT call logevent or upsertagentsession — the workflow handles all phase tracking after your step completes.\n\nStay in character. All file work under " + crewHome + "/.",
+    {
+      key: "work-" + step.name + (reworkCount > 0 ? "-r" + reworkCount : ""),
+      label: step.identity + ": " + step.name + " on \"" + taskTitle + "\"",
+      timeoutMs: 3600000,
+      schema: {
+        type: "object",
+        properties: { passed: { type: "boolean" }, summary: { type: "string" } },
+        required: ["summary"]
+      }
+    }
+  );
+
+  const summary = (stepResult.summary || "Step completed").slice(0, 2000);
+  const passed = stepResult.passed !== false;
+  const status = passed ? "completed" : "rejected";
+
+  await agent(
+    "Update session and log 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" }
+    }
+  );
+
+  // Review rejection bounces to Write (not Build)
+  if (!passed && step.name === "Review") {
+    reworkCount++;
+    if (reworkCount > MAX_REWORK) {
+      log("Max rework attempts reached for task " + taskId);
+      return { status: "blocked", task_id: taskId, reason: "Exceeded " + MAX_REWORK + " rework attempts after Review rejection" };
+    }
+    rejectionNotes = summary;
+    i = WRITE_INDEX;
+    log("Review rejected — bouncing to Write (rework #" + reworkCount + ")");
+    continue;
+  }
+
+  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 docs workflow steps complete.\" }.",
+  { key: "task-done", label: "Completing task: " + taskTitle, schema: { type: "object" } }
+);
+
+log("Docs workflow complete for task " + taskId);
+return { status: "ok", task_id: taskId, message: "Docs workflow complete for " + taskTitle };