opencode-teammate 0.1.0-next.1

package/.bunli/commands.gen.ts

@@ -0,0 +1,87 @@
+// This file was automatically generated by Bunli.
+// You should NOT make any changes in this file as it will be overwritten.
+
+import type { Command, CLI, GeneratedOptionMeta, RegisteredCommands, CommandOptions, GeneratedCommandMeta } from '@bunli/core'
+import { createGeneratedHelpers, registerGeneratedStore } from '@bunli/core'
+
+import SpecSync from '../src/cli/commands/spec/sync.js'
+import Work from '../src/cli/commands/work.js'
+
+// Narrow list of command names to avoid typeof-cycles in types
+const names = ['spec/sync', 'work'] as const
+type GeneratedNames = typeof names[number]
+
+const modules: Record<GeneratedNames, Command<any>> = {
+  'spec/sync': SpecSync,
+  'work': Work
+} as const
+
+const metadata: Record<GeneratedNames, GeneratedCommandMeta> = {
+  'spec/sync': {
+      name: 'spec/sync',
+      description: 'Syncs the specifications with beads epics',
+      options: {
+        'target': { type: 'z.string.transform.optional', required: false, hasDefault: false, description: 'Specification file or directory to sync', short: 't', isTransform: true, fileType: 'directory', schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' },
+        'watch': { type: 'z.boolean.default', required: true, hasDefault: true, default: false, description: 'Watch target for changes', short: 'w', schema: {"type":"zod","method":"default","args":[{"type":"unknown","raw":{"type":"BooleanLiteral","start":586,"end":591,"loc":{"start":{"line":22,"column":38,"index":586},"end":{"line":22,"column":43,"index":591}},"value":false}}]}, validator: '(val) => true' }
+      },
+      path: '../src/cli/commands/spec/sync'
+    },
+  'work': {
+      name: 'work',
+      description: 'Starts RALPH loop on opened tasks',
+      alias: ["ralph"],
+      options: {
+        'concurrency': { type: 'z.coerce.number.min.default', required: true, hasDefault: true, default: 1, description: 'How many workers can be spawned at the same time', short: 'c', min: 1, minLength: 1, schema: {"type":"zod","method":"default","args":[{"type":"unknown","raw":{"type":"NumericLiteral","start":862,"end":863,"loc":{"start":{"line":22,"column":57,"index":862},"end":{"line":22,"column":58,"index":863}},"extra":{"rawValue":1,"raw":"1"},"value":1}}]}, validator: '(val) => true' },
+        'task': { type: 'z.string.optional', required: false, hasDefault: false, description: 'Task (including subtasks) to work on. When not provided, workers can be spawned for any ready tasks.', short: 't', schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' },
+        'project': { type: 'z.string.optional', required: false, hasDefault: false, description: 'Project to work on. When not provided, workers can be spawned for any ready tasks.', short: 'p', schema: {"type":"zod","method":"optional","args":[]}, validator: '(val) => true' }
+      },
+      path: '../src/cli/commands/work'
+    }
+} as const
+
+export const generated = registerGeneratedStore(createGeneratedHelpers(modules, metadata))
+
+export const commands = generated.commands
+export const commandMeta = generated.metadata
+
+export interface GeneratedCLI {
+  register(cli?: CLI<any>): GeneratedCLI
+  list(): Array<{
+    name: GeneratedNames
+    command: (typeof modules)[GeneratedNames]
+    metadata: (typeof metadata)[GeneratedNames]
+  }>
+  get<Name extends GeneratedNames>(name: Name): (typeof modules)[Name]
+  getMetadata<Name extends GeneratedNames>(name: Name): (typeof metadata)[Name]
+  getFlags<Name extends keyof RegisteredCommands & string>(name: Name): CommandOptions<Name>
+  getFlagsMeta<Name extends GeneratedNames>(name: Name): Record<string, GeneratedOptionMeta>
+  withCLI(cli: CLI<any>): { execute(name: string, options: unknown): Promise<void> }
+}
+
+export const cli: GeneratedCLI = {
+  register: (cliInstance?: CLI<any>) => { generated.register(cliInstance); return cli },
+  list: () => generated.list(),
+  get: <Name extends GeneratedNames>(name: Name) => generated.get(name),
+  getMetadata: <Name extends GeneratedNames>(name: Name) => generated.getMetadata(name),
+  getFlags: <Name extends keyof RegisteredCommands & string>(name: Name) => generated.getFlags(name) as CommandOptions<Name>,
+  getFlagsMeta: <Name extends GeneratedNames>(name: Name) => generated.getFlagsMeta(name),
+  withCLI: (cliInstance) => generated.withCLI(cliInstance)
+}
+
+// Enhanced helper functions
+export const listCommands = () => generated.list().map(c => c.name)
+export const getCommandApi = <Name extends GeneratedNames>(name: Name) => generated.getMetadata(name)
+export const getTypedFlags = <Name extends GeneratedNames>(name: Name) => generated.getFlags(name) as CommandOptions<Name>
+export const validateCommand = <Name extends GeneratedNames>(name: Name, flags: Record<string, unknown>) => generated.validateCommand(name, flags)
+export const findCommandByName = <Name extends GeneratedNames>(name: Name) => generated.findByName(name)
+export const findCommandsByDescription = (searchTerm: string) => generated.findByDescription(searchTerm)
+export const getCommandNames = () => generated.getCommandNames()
+
+// Auto-register on import for zero-config usage
+export default cli
+
+// Ensure module augmentation happens on import
+declare module '@bunli/core' {
+  // Precise key mapping without typeof cycles
+  interface RegisteredCommands extends Record<GeneratedNames, Command<any>> {}
+}

package/.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  checks:
+    name: Formatting & Lint
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Generate
+        run: bun run generate
+
+      - name: Check formatting
+        run: bun run fmt --check
+
+      - name: Run lint (includes type checks)
+        run: bun run lint

package/.github/workflows/release.yml

@@ -0,0 +1,140 @@
+name: Release (next)
+
+on:
+  workflow_run:
+    workflows: ["CI"]
+    types: [completed]
+
+concurrency:
+  group: release-next-main
+  cancel-in-progress: false
+
+jobs:
+  release-next:
+    if: >
+      github.event.workflow_run.conclusion == 'success' &&
+      github.event.workflow_run.head_branch == 'main'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+
+    env:
+      SOURCE_SHA: ${{ github.event.workflow_run.head_sha }}
+      RELEASE_BRANCH: release
+
+    steps:
+      - name: Checkout triggering main commit
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{ env.SOURCE_SHA }}
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Prepare local release branch
+        shell: bash
+        run: |
+          git fetch origin --tags
+          if git ls-remote --heads origin "${RELEASE_BRANCH}" | grep -q "${RELEASE_BRANCH}$"; then
+            git fetch origin "${RELEASE_BRANCH}:${RELEASE_BRANCH}"
+            git checkout "${RELEASE_BRANCH}"
+          else
+            git checkout --orphan "${RELEASE_BRANCH}"
+            git rm -rf .
+            git checkout "${SOURCE_SHA}" -- .
+            git config user.name "github-actions[bot]"
+            git config user.email "github-actions[bot]@users.noreply.github.com"
+            git commit -m "chore(next): initialize ${RELEASE_BRANCH} from ${SOURCE_SHA:0:7}"
+          fi
+
+      - name: Sync source tree from triggering main commit
+        shell: bash
+        run: |
+          git rm -rf .
+          git checkout "${SOURCE_SHA}" -- .
+
+      - name: Read package name
+        id: pkg
+        shell: bash
+        run: |
+          PKG_NAME="$(node -p "require('./package.json').name")"
+          echo "name=${PKG_NAME}" >> "$GITHUB_OUTPUT"
+          echo "Package: ${PKG_NAME}"
+
+      - name: Resolve semver base from npm latest
+        id: base
+        shell: bash
+        run: |
+          PKG="${{ steps.pkg.outputs.name }}"
+          LATEST="$(npm view "${PKG}" version 2>/dev/null || true)"
+
+          if [ -z "${LATEST}" ]; then
+            # First ever publish for this package
+            MAJOR=0
+            MINOR=1
+            PATCH=0
+          else
+            # Expect X.Y.Z on latest channel
+            IFS='.' read -r MAJOR MINOR PATCH <<< "${LATEST}"
+            PATCH=$((PATCH + 1))
+          fi
+
+          BASE="${MAJOR}.${MINOR}.${PATCH}"
+          echo "base=${BASE}" >> "$GITHUB_OUTPUT"
+          echo "Base next line: ${BASE}"
+
+      - name: Compute next prerelease version
+        id: ver
+        shell: bash
+        run: |
+          BASE="${{ steps.base.outputs.base }}"
+
+          # tags look like: 1.2.1-next.1, 1.2.1-next.2, ...
+          LAST_TAG="$(git tag --list "${BASE}-next.*" --sort=-v:refname | head -n1 || true)"
+
+          if [ -z "${LAST_TAG}" ]; then
+            X=1
+          else
+            LAST_NUM="${LAST_TAG##*.}"
+            if [ -z "${LAST_NUM}" ] || [ "${LAST_NUM}" = "${LAST_TAG}" ]; then
+              X=1
+            else
+              X=$((LAST_NUM + 1))
+            fi
+          fi
+
+          VERSION="${BASE}-next.${X}+sha.${SOURCE_SHA:0:7}"
+
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+          echo "Computed next version: ${VERSION}"
+
+      - name: Bump package version
+        run: bun pm version "${{ steps.ver.outputs.version }}" --no-git-tag-version
+
+      - name: Build
+        run: bun run build
+
+      - name: Commit release on release branch
+        shell: bash
+        run: |
+          VERSION="${{ steps.ver.outputs.version }}"
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          git add -A
+          git commit -m "release(next): v${VERSION}"
+
+      # - name: Publish to npm (next dist-tag)
+      #   env:
+      #     NPM_CONFIG_TOKEN: ${{ secrets.NPM_TOKEN }}
+      #   run: bun publish --access public --tag next
+
+      - name: Push release history
+        shell: bash
+        run: |
+          git push origin "${RELEASE_BRANCH}"

package/.oxfmtrc.json

@@ -0,0 +1,3 @@
+{
+  "ignorePatterns": [".bunli/**"]
+}

package/.oxlintrc.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "ignorePatterns": [".bunli/**"]
+}

package/.zed/settings.json

@@ -0,0 +1,76 @@
+// Folder-specific settings
+//
+// For a full list of overridable settings, and general information on folder-specific settings,
+// see the documentation: https://zed.dev/docs/configuring-zed#settings-files
+{
+  "format_on_save": "on",
+  "autosave": "on_focus_change",
+  "code_actions_on_format": {
+    "source.fixAll.oxlint": true,
+    "source.organizeImports.oxlint": true,
+    "source.removeUnusedImports": true
+  },
+  "languages": {
+    "JavaScript": {
+      "formatter": {
+        "language_server": {
+          "name": "oxfmt"
+        }
+      }
+    },
+    "TypeScript": {
+      "formatter": {
+        "language_server": {
+          "name": "oxfmt"
+        }
+      }
+    },
+    "JSON": {
+      "formatter": {
+        "language_server": {
+          "name": "oxfmt"
+        }
+      }
+    },
+    "JSONC": {
+      "formatter": {
+        "language_server": {
+          "name": "oxfmt"
+        }
+      }
+    },
+    "YAML": {
+      "formatter": {
+        "language_server": {
+          "name": "oxfmt"
+        }
+      }
+    },
+    "Markdown": {
+      "formatter": {
+        "language_server": {
+          "name": "oxfmt"
+        }
+      }
+    }
+  },
+  "lsp": {
+    "oxlint": {
+      "initialization_options": {
+        "typeAware": true,
+        "run": "onType",
+        "fixKind": "safe_fix"
+      }
+    },
+    "oxfmt": {
+      "initialization_options": {
+        "fmt.experimental": true,
+        "settings": {
+          "run": "onSave",
+          "fmt.experimental": true
+        }
+      }
+    }
+  },
+  "file_scan_exclusions": ["**/.git", "**/.DS_Store", "**/Thumbs.db"]
+}

package/README.md

@@ -0,0 +1,15 @@
+# opencode-teammate
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run index.ts
+```
+
+This project was created using `bun init` in bun v1.3.3. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

package/bunli.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from "@bunli/core";
+
+import { version } from "./package.json";
+
+export default defineConfig({
+  name: "mate",
+  version,
+  commands: {
+    directory: "./src/cli/commands",
+  },
+});

package/bunup.config.ts

@@ -0,0 +1,31 @@
+import { defineConfig } from "bunup";
+
+export default defineConfig([
+  {
+    name: "plugin",
+    entry: "src/plugin.ts",
+    format: "esm",
+    target: "bun",
+    outDir: "dist",
+    noExternal: ["radashi"],
+    drop: ["console"],
+    dts: {
+      tsgo: true,
+    },
+  },
+  {
+    name: "cli",
+    entry: "src/cli/index.ts",
+    format: "esm",
+    target: "bun",
+    noExternal: ["radashi"],
+    outDir: "dist/bin",
+    minify: true,
+    splitting: false,
+    clean: false,
+    onSuccess: `
+      mv dist/bin/index.js dist/bin/mate
+      chmod +x dist/bin/mate
+    `,
+  },
+]);

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "opencode-teammate",
+  "version": "0.1.0-next.1",
+  "private": false,
+  "bin": {
+    "mate": "./src/cli/index.ts"
+  },
+  "type": "module",
+  "module": "src/plugin.ts",
+  "imports": {
+    "#utils/*": "./src/utils/*"
+  },
+  "scripts": {
+    "generate": "bunli generate",
+    "cli:dev": "bunli dev",
+    "build": "bunup",
+    "lint": "oxlint --type-aware --type-check",
+    "fmt": "oxfmt"
+  },
+  "dependencies": {
+    "@bunli/core": "^0.5.4",
+    "bunli": "^0.5.3",
+    "radashi": "~12.7.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.1.59",
+    "@tsconfig/bun": "^1.0.10",
+    "@types/bun": "~1.3.9",
+    "@typescript/native-preview": "^7.0.0-dev.20260212.1",
+    "bunup": "^0.16.26",
+    "oxfmt": "^0.32.0",
+    "oxlint": "^1.47.0",
+    "oxlint-tsgolint": "^0.12.2"
+  }
+}

package/src/adapters/assets/index.ts

@@ -0,0 +1 @@
+export * as specifications from "./specifications";

package/src/adapters/assets/specifications.ts

@@ -0,0 +1,70 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { withResolvers } from "radashi";
+import { z } from "zod";
+
+export const MARKDOWN = new Bun.Glob("**/*.md");
+
+export type Specification = ReturnType<typeof createItem>;
+
+export type Frontmatter = z.infer<typeof Frontmatter>;
+export const Frontmatter = z.object({
+  issue: z.string().optional(),
+});
+
+export function use(options: { target: string; ignore?: Bun.Glob; watch: boolean }) {
+  if (options.watch) return watch(options);
+  else return scan(options);
+}
+
+export async function* watch(options: { target: string; ignore?: Bun.Glob }) {
+  const touched = new Map<string, number | bigint>();
+  const queue: Array<Specification> = [];
+  let resolver: PromiseWithResolvers<string> | undefined;
+
+  const watcher = fs.watch(options.target, async (event, filename) => {
+    if (event === "change" && filename) {
+      if (!MARKDOWN.match(filename)) return;
+      if (options.ignore?.match(filename)) return;
+
+      const item = createItem(options.target, filename);
+      const hash = Bun.hash(await item.file.text());
+      if (touched.get(filename) === hash) return;
+
+      touched.set(filename, hash);
+      queue.push(createItem(options.target, filename));
+
+      if (resolver) {
+        resolver.resolve(filename);
+        resolver = undefined;
+      }
+    }
+  });
+
+  try {
+    while (true) {
+      const item = queue.shift();
+
+      if (item) yield item;
+      else {
+        resolver = withResolvers();
+        await resolver.promise;
+      }
+    }
+  } finally {
+    watcher.close();
+  }
+}
+
+export async function* scan(options: { target: string; ignore?: Bun.Glob }) {
+  for await (const filename of MARKDOWN.scan({ cwd: options.target })) {
+    if (options.ignore?.match(filename)) continue;
+
+    yield createItem(options.target, filename);
+  }
+}
+
+function createItem(target: string, filename: string) {
+  const filepath = path.join(target, filename);
+  return { filename, filepath: path.parse(filepath), file: Bun.file(filepath) };
+}

package/src/adapters/beads/agents.ts

@@ -0,0 +1,105 @@
+import { isEmpty, listify, sift } from "radashi";
+
+// import * as shell from "#utils/shell/index.js";
+import * as shell from "../../utils/shell/index.js";
+
+import * as issues from "./issues";
+
+export type AgentState = "idle" | "spawning" | "running" | "working" | "stuck" | "done" | "stopped";
+
+export interface Agent {
+  id: string;
+  title: string;
+  rig: string | null;
+  role_bead: string | null;
+  role_type: string | null;
+  agent_state: AgentState;
+}
+
+export interface UpdatedAgentState {
+  agent: string;
+  agent_state: AgentState;
+}
+
+export interface StuckOptions {
+  context?: AgentContext;
+  reason: string;
+}
+
+export async function stuck(client: shell.client.ClientInput, slug: string, options: StuckOptions) {
+  const agent = await state(client, slug, "stuck");
+
+  await issues.update(
+    client,
+    { id: agent.agent },
+    {
+      "add-label": createContextLabels(options.context),
+      description: options.reason,
+    },
+  );
+
+  return agent;
+}
+
+export interface DoneOptions {
+  context?: AgentContext;
+}
+
+export async function done(
+  client: shell.client.ClientInput,
+  slug: string,
+  options: DoneOptions = {},
+) {
+  const agent = await state(client, slug, "done");
+
+  await issues.update(
+    client,
+    { id: agent.agent },
+    {
+      "add-label": createContextLabels(options.context),
+      description: "",
+    },
+  );
+
+  return agent;
+}
+
+export async function state(client: shell.client.ClientInput, slug: string, state: AgentState) {
+  const $ = shell.client.use(client);
+
+  const agent = await $<UpdatedAgentState>`bd agent state gram-${slug} ${state} --json`.json();
+
+  return agent;
+}
+
+export async function use(
+  client: shell.client.ClientInput,
+  input: { slug: string } | { id: string },
+) {
+  const $ = shell.client.use(client);
+
+  const id = "slug" in input ? `gram-${input.slug}` : input.id;
+
+  const agent = await $<Agent>`bd agent show ${id} --json`.json();
+
+  return agent;
+}
+
+interface AgentContext {
+  agent?: string;
+  model?: string;
+  provider?: string;
+}
+
+function createContextLabels(context?: AgentContext) {
+  if (!context) return undefined;
+
+  const labels = sift(
+    listify(
+      context as Record<string, string | undefined>,
+      (key, value) => value && `${key}:${value}`,
+    ),
+  );
+
+  return isEmpty(labels) ? undefined : labels;
+}

package/src/adapters/beads/config.ts

@@ -0,0 +1,17 @@
+// import * as shell from "#utils/shell/index.js";
+import * as shell from "../../utils/shell/index.js";
+
+export interface Config {
+  key: string;
+  value: string;
+}
+
+export async function issuePrefix(client: shell.client.ClientInput) {
+  return get(client, { key: "issue_prefix" });
+}
+
+export async function get(client: shell.client.ClientInput, input: { key: string }) {
+  const $ = shell.client.use(client);
+
+  return await $<Config>`bd config get ${input.key} --json`.json();
+}

package/src/adapters/beads/index.ts

@@ -0,0 +1,4 @@
+export * as agents from "./agents";
+export * as specifications from "./specifications";
+export * as issues from "./issues";
+export * as config from "./config";