@fiftth/fiftth-cli 1.0.1 → 1.1.1

package/.fiftthnexus/.github/workflows/copilot-orchestrator.yml

@@ -0,0 +1,78 @@
+name: Copilot Parallel Orchestrator
+
+on:
+  # Run manually
+  workflow_dispatch:
+    inputs:
+      max_parallel:
+        description: "Max issues in parallel"
+        default: "3"
+        type: string
+      max_iterations:
+        description: "Max orchestrator iterations"
+        default: "10"
+        type: string
+      label:
+        description: "Label to filter issues"
+        default: "ai-running-orchestrator"
+        type: string
+
+  # Run when an issue gets the ai-running-orchestrator label
+  issues:
+    types: [labeled]
+
+  # Poll every 30 minutes for newly unblocked issues
+  schedule:
+    - cron: "*/30 * * * *"
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+# Only one orchestrator at a time
+concurrency:
+  group: copilot-orchestrator
+  cancel-in-progress: false
+
+jobs:
+  orchestrate:
+    # Skip if triggered by label event and label is not ai-running-orchestrator
+    if: >
+      github.event_name != 'issues' || github.event.label.name == 'ai-running-orchestrator'
+    runs-on: ubuntu-latest
+    timeout-minutes: 120
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+
+      - name: Install tsx
+        run: npm install -g tsx
+
+      - name: Run Orchestrator
+        env:
+          GH_TOKEN: "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"
+          GITHUB_REPOSITORY: ${{ github.repository }}
+          MAX_PARALLEL: ${{ inputs.max_parallel || '3' }}
+          MAX_ITERATIONS: ${{ inputs.max_iterations || '10' }}
+          ORCHESTRATOR_LABEL: ${{ inputs.label || 'ai-running-orchestrator' }}
+          POLL_INTERVAL_MS: "60000"
+          MAX_WAIT_MS: "3600000"
+        run: npx tsx custom-agents/actions/orchestrator.ts
+
+      - name: Write Summary
+        if: always()
+        run: |
+          echo "## Copilot Orchestrator Run" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "- **Trigger:** ${{ github.event_name }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Max parallel:** ${{ inputs.max_parallel || '3' }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Label:** ${{ inputs.label || 'ai-running-orchestrator' }}" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "Check the job logs for detailed output." >> $GITHUB_STEP_SUMMARY

package/.fiftthnexus/actions/Dockerfile

@@ -0,0 +1,34 @@
+FROM node:22-slim
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    curl \
+    ca-certificates \
+    jq \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install GitHub CLI
+RUN curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg \
+     -o /usr/share/keyrings/githubcli-archive-keyring.gpg \
+    && echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" \
+       > /etc/apt/sources.list.d/github-cli.list \
+    && apt-get update \
+    && apt-get install -y gh \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Copilot CLI (required by @github/copilot-sdk)
+RUN npm install -g @github/copilot@latest
+
+RUN git config --global user.name "copilot-orchestrator" \
+    && git config --global user.email "copilot-orchestrator@local" \
+    && git config --global init.defaultBranch main
+
+# Install SDK dependencies
+COPY package.json /opt/package.json
+RUN cd /opt && npm install --omit=dev
+
+COPY copilot-agent.mjs /opt/copilot-agent.mjs
+
+WORKDIR /workspace
+
+ENTRYPOINT ["node", "/opt/copilot-agent.mjs"]

package/.fiftthnexus/actions/copilot-agent.mjs

@@ -0,0 +1,269 @@
+import { readFileSync } from "fs";
+import { approveAll, CopilotClient } from "@github/copilot-sdk";
+
+const STAGE_MARKER = "__FIFTTH_AGENT_STAGE__";
+
+// ---------------------------------------------------------------------------
+// CLI Args
+// ---------------------------------------------------------------------------
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const defaultModel = process.env.FIFTTH_DEFAULT_MODEL ?? "gpt-5.4";
+  const opts = {
+    promptFile: "",
+    planPromptFile: "",
+    implementPromptFile: "",
+    reviewPromptFile: "",
+    stage: "plan",
+    model: defaultModel,
+    verbose: false,
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    switch (args[i]) {
+      case "--prompt":
+        opts.promptFile = args[++i] ?? "";
+        break;
+      case "--plan-prompt":
+        opts.planPromptFile = args[++i] ?? "";
+        break;
+      case "--implement-prompt":
+        opts.implementPromptFile = args[++i] ?? "";
+        break;
+      case "--review-prompt":
+        opts.reviewPromptFile = args[++i] ?? "";
+        break;
+      case "--stage":
+        opts.stage = args[++i] ?? "plan";
+        break;
+      case "--model":
+        opts.model = args[++i] ?? defaultModel;
+        break;
+      case "--verbose":
+        opts.verbose = true;
+        break;
+    }
+  }
+
+  const isSingleStage = Boolean(opts.promptFile);
+  const isPipeline = Boolean(opts.planPromptFile && opts.implementPromptFile && opts.reviewPromptFile);
+
+  if (!isSingleStage && !isPipeline) {
+    console.error("ERROR: provide --prompt <file> or the full pipeline prompt set (--plan-prompt, --implement-prompt, --review-prompt)");
+    process.exit(1);
+  }
+  return opts;
+}
+
+// ---------------------------------------------------------------------------
+// Logging
+// ---------------------------------------------------------------------------
+function log(msg) {
+  process.stderr.write(`[agent] ${msg}\n`);
+}
+
+function emitStageEvent(stage, event) {
+  log(`${STAGE_MARKER} ${stage}:${event}`);
+}
+
+function applyPromptContext(template, replacements) {
+  let result = template;
+  for (const [key, value] of Object.entries(replacements)) {
+    result = result.replace(new RegExp(`\\{\\{${key}\\}\\}`, "g"), value);
+  }
+  return result;
+}
+
+async function finishPipeline(client, pipelineResult, exitCode = 0) {
+  process.stdout.write(JSON.stringify(pipelineResult));
+  await client.stop();
+  if (exitCode !== 0) {
+    process.exit(exitCode);
+  }
+}
+
+
+const SYSTEM_PROMPTS = {
+  plan:
+    `You are a senior software architect. You have tools to explore the codebase.
+Use them to understand the project structure before producing your plan.
+After exploring, output your plan as a JSON object wrapped in <plan> tags.`,
+
+  implement:
+    `You are a senior full-stack developer implementing features in an existing codebase.
+You have tools to explore, read, search, and write files, plus run shell commands.
+
+WORKFLOW:
+1. EXPLORE: Use tools to understand the existing codebase, tech stack, patterns, and conventions.
+2. IMPLEMENT: Create/update files. Match the existing stack and style EXACTLY.
+3. COMMIT: git add and git commit your changes.
+
+RULES:
+- ALWAYS explore relevant existing files before writing new ones
+- Match existing patterns, imports, and conventions exactly
+- Do NOT introduce frameworks or libraries not already in package.json
+- Write complete file contents (not diffs or partial content)
+- Run validation after writing code`,
+
+  review:
+    `You are a senior code reviewer performing a lightweight final pass on an already-implemented change.
+You have tools to inspect the diff, read nearby code, run focused validation, and make small follow-up fixes.
+
+WORKFLOW:
+1. Inspect only the current diff and directly affected code paths.
+2. Run only targeted validation for the changed paths.
+3. If you find one concrete correctness or test gap, fix it and commit once.
+4. If there is no concrete blocker, stop immediately and output COMPLETE.
+
+Avoid broad refactors, exhaustive analysis, or reopening implementation work that already passed.`,
+
+  merge: `You are a senior developer responsible for merging branches.
+You have tools to run git commands and resolve conflicts.
+Follow the merge instructions carefully.`,
+};
+
+async function runStage(client, stage, prompt, model, verbose) {
+  emitStageEvent(stage, "start");
+  const systemPrompt = SYSTEM_PROMPTS[stage] ?? SYSTEM_PROMPTS.plan;
+  const session = await client.createSession({
+    model,
+    systemMessage: {
+      mode: "replace",
+      content: systemPrompt,
+    },
+    onPermissionRequest: approveAll,
+    infiniteSessions: { enabled: true },
+  });
+
+  let toolCalls = 0;
+  let writeCount = 0;
+
+  session.on("tool.execution_start", (event) => {
+    toolCalls++;
+    if (verbose) {
+      log(`  tool(${stage}): ${event.data?.toolName ?? "unknown"}`);
+    }
+  });
+
+  session.on("tool.execution_complete", (event) => {
+    if (
+      event.data?.toolName === "write_file" ||
+      event.data?.toolName === "edit_file"
+    ) {
+      writeCount++;
+    }
+  });
+
+  session.on("assistant.message_delta", (event) => {
+    if (verbose && event.data?.deltaContent) {
+      process.stderr.write(event.data.deltaContent);
+    }
+  });
+
+  try {
+    log(`Sending ${stage} prompt...`);
+    const response = await session.sendAndWait(
+      { prompt },
+      10 * 60 * 1000,
+    );
+
+    const output = response?.data?.content ?? "";
+    log(`${stage} done (${toolCalls} tool calls, ${writeCount} writes, ${output.length} chars)`);
+    emitStageEvent(stage, "done");
+    await session.disconnect();
+    return {
+      success: true,
+      output,
+      toolCalls,
+      writes: writeCount,
+      errorText: "",
+    };
+  } catch (err) {
+    const errorText = err instanceof Error ? err.message : String(err);
+    emitStageEvent(stage, "failed");
+    await session.disconnect().catch(() => {});
+    return {
+      success: false,
+      output: "",
+      toolCalls,
+      writes: writeCount,
+      errorText,
+    };
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+  const opts = parseArgs();
+
+  log(`stage=${opts.stage} model=${opts.model} verbose=${opts.verbose}`);
+
+  log("Starting Copilot SDK client...");
+  const client = new CopilotClient({
+    githubToken: process.env.GITHUB_TOKEN,
+  });
+  await client.start();
+
+  try {
+    if (opts.promptFile) {
+      const prompt = readFileSync(opts.promptFile, "utf-8");
+      log(`Prompt ready (${prompt.length} chars)`);
+      const result = await runStage(client, opts.stage, prompt, opts.model, opts.verbose);
+      process.stdout.write(result.output);
+      await client.stop();
+      if (!result.success) {
+        process.exit(1);
+      }
+      return;
+    }
+
+    const planPrompt = readFileSync(opts.planPromptFile, "utf-8");
+    const implementPromptTemplate = readFileSync(opts.implementPromptFile, "utf-8");
+    const reviewPromptTemplate = readFileSync(opts.reviewPromptFile, "utf-8");
+    log(`Pipeline prompts ready (${planPrompt.length}/${implementPromptTemplate.length}/${reviewPromptTemplate.length} chars)`);
+
+    const pipelineResult = {
+      plan: await runStage(client, "plan", planPrompt, opts.model, opts.verbose),
+    };
+
+    if (!pipelineResult.plan.success) {
+      await finishPipeline(client, pipelineResult, 1);
+    }
+
+    pipelineResult.implement = await runStage(
+      client,
+      "implement",
+      applyPromptContext(implementPromptTemplate, {
+        PLAN_OUTPUT: pipelineResult.plan.output,
+      }),
+      opts.model,
+      opts.verbose,
+    );
+
+    if (!pipelineResult.implement.success) {
+      await finishPipeline(client, pipelineResult, 1);
+    }
+
+    pipelineResult.review = await runStage(
+      client,
+      "review",
+      applyPromptContext(reviewPromptTemplate, {
+        IMPLEMENTATION_OUTPUT: pipelineResult.implement.output,
+      }),
+      opts.model,
+      opts.verbose,
+    );
+
+    await finishPipeline(client, pipelineResult, pipelineResult.review.success ? 0 : 1);
+  } catch (err) {
+    await client.forceStop().catch(() => {});
+    throw err;
+  }
+}
+
+main().catch((err) => {
+  console.error(`[agent] FATAL: ${err.message}`);
+  process.exit(1);
+});

package/.fiftthnexus/actions/package.json

@@ -0,0 +1,8 @@
+{
+	"name": "copilot-agent",
+	"private": true,
+	"type": "module",
+	"dependencies": {
+		"@github/copilot-sdk": "^0.2.0"
+	}
+}