@snarkipus/opencode-beads 0.9.4 → 1.0.0

package/src/vendor-provenance.ts

@@ -1,252 +0,0 @@
-import { createHash } from "node:crypto";
-import * as fs from "node:fs/promises";
-import * as path from "node:path";
-
-export const VENDOR_MANIFEST = "manifest.json";
-export const VENDOR_SOURCES = Object.freeze([
-  {
-    source: "plugins/beads/agents/task-agent.md",
-    target: "agents/task-agent.md",
-  },
-  {
-    source: "plugins/beads/skills/beads/commands",
-    target: "commands",
-  },
-]);
-
-interface Semver {
-  major: bigint;
-  minor: bigint;
-  patch: bigint;
-}
-
-export interface VendorFileRecord {
-  path: string;
-  bytes: number;
-  sha256: string;
-}
-
-export interface VendorManifest {
-  schemaVersion: 1;
-  repository: string;
-  tag: string;
-  commit: string;
-  sources: typeof VENDOR_SOURCES;
-  files: VendorFileRecord[];
-}
-
-export interface ExpectedVendorProvenance {
-  repository: string;
-  tag: string;
-  commit: string;
-}
-
-export interface VendorRelease {
-  tag: string;
-  commit: string;
-}
-
-function parseStableTag(tag: string): Semver | undefined {
-  const match = tag.match(/^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/);
-  if (!match) return undefined;
-
-  const [, major, minor, patch] = match;
-  if (major === undefined || minor === undefined || patch === undefined) return undefined;
-  return { major: BigInt(major), minor: BigInt(minor), patch: BigInt(patch) };
-}
-
-function compareSemver(left: Semver, right: Semver): number {
-  for (const key of ["major", "minor", "patch"] as const) {
-    if (left[key] < right[key]) return -1;
-    if (left[key] > right[key]) return 1;
-  }
-  return 0;
-}
-
-/** Select the newest stable semver release from git ls-remote output. */
-export function selectStableRelease(lsRemoteOutput: string): VendorRelease {
-  const releases = new Map<
-    string,
-    { tagCommit?: string; peeledCommit?: string; version: Semver }
-  >();
-
-  for (const line of lsRemoteOutput.split(/\r?\n/)) {
-    if (!line.trim()) continue;
-    const match = line.match(/^([0-9a-fA-F]{40})\s+refs\/tags\/([^\s^]+)(\^\{\})?$/);
-    const commit = match?.[1]?.toLowerCase();
-    const tag = match?.[2];
-    const version = tag ? parseStableTag(tag) : undefined;
-    if (!commit || !tag || !version) continue;
-
-    const release = releases.get(tag) ?? { version };
-    const existingCommit = match[3] ? release.peeledCommit : release.tagCommit;
-    if (releases.has(tag) && existingCommit && existingCommit !== commit) {
-      throw new Error(`Conflicting commits for vendor tag: ${tag}`);
-    }
-    if (match[3]) release.peeledCommit = commit;
-    else release.tagCommit = commit;
-    releases.set(tag, release);
-  }
-
-  const candidates = [...releases].flatMap(([tag, release]) => {
-    const commit = release.peeledCommit ?? release.tagCommit;
-    return commit ? [{ tag, commit, version: release.version }] : [];
-  });
-  candidates.sort(
-    (left, right) =>
-      compareSemver(right.version, left.version) ||
-      (left.tag < right.tag ? -1 : left.tag > right.tag ? 1 : 0)
-  );
-  const selected = candidates[0];
-  if (!selected) throw new Error("No stable semver Beads tags found");
-  return { tag: selected.tag, commit: selected.commit };
-}
-
-/** Select the newest stable semver tag from git ls-remote output. */
-export function selectStableTag(lsRemoteOutput: string): string {
-  return selectStableRelease(lsRemoteOutput).tag;
-}
-
-async function listVendorFiles(vendorDir: string): Promise<string[]> {
-  const files: string[] = [];
-
-  async function visit(relativeDir: string): Promise<void> {
-    const entries = await fs.readdir(path.join(vendorDir, relativeDir), { withFileTypes: true });
-    for (const entry of entries) {
-      const relativePath = path.posix.join(relativeDir, entry.name);
-      if (entry.isDirectory()) await visit(relativePath);
-      else if (entry.isFile()) files.push(relativePath);
-      else throw new Error(`Unsupported vendor entry: ${relativePath}`);
-    }
-  }
-
-  await visit("agents");
-  await visit("commands");
-  return files.sort();
-}
-
-async function fileRecord(vendorDir: string, relativePath: string): Promise<VendorFileRecord> {
-  const content = await fs.readFile(path.join(vendorDir, relativePath));
-  return {
-    path: relativePath,
-    bytes: content.byteLength,
-    sha256: createHash("sha256").update(content).digest("hex"),
-  };
-}
-
-/** Build deterministic provenance for a validated vendor candidate. */
-export async function createVendorManifest(
-  vendorDir: string,
-  repository: string,
-  tag: string,
-  commit: string
-): Promise<VendorManifest> {
-  if (!repository) throw new Error("Vendor repository is required");
-  if (!parseStableTag(tag)) throw new Error(`Vendor tag is not stable semver: ${tag}`);
-  if (!/^[0-9a-f]{40}$/.test(commit)) throw new Error(`Invalid vendor commit SHA: ${commit}`);
-
-  const files = await listVendorFiles(vendorDir);
-  if (files.length === 0) throw new Error("Vendor inventory is empty");
-
-  return {
-    schemaVersion: 1,
-    repository,
-    tag,
-    commit,
-    sources: VENDOR_SOURCES,
-    files: await Promise.all(files.map((relativePath) => fileRecord(vendorDir, relativePath))),
-  };
-}
-
-export function serializeVendorManifest(manifest: VendorManifest): string {
-  return `${JSON.stringify(manifest, null, 2)}\n`;
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-function hasExactKeys(value: Record<string, unknown>, expectedKeys: string[]): boolean {
-  const actualKeys = Object.keys(value);
-  return (
-    actualKeys.length === expectedKeys.length &&
-    expectedKeys.every((key) => Object.hasOwn(value, key))
-  );
-}
-
-function parseManifest(content: string): VendorManifest {
-  const parsed: unknown = JSON.parse(content);
-  if (!isRecord(parsed)) {
-    throw new Error("Vendor manifest must be an object");
-  }
-  const values = parsed;
-  if (!hasExactKeys(values, ["schemaVersion", "repository", "tag", "commit", "sources", "files"])) {
-    throw new Error("Vendor manifest has unexpected or missing fields");
-  }
-  if (values.schemaVersion !== 1) throw new Error("Unsupported vendor manifest schema");
-  if (typeof values.repository !== "string" || !values.repository) throw new Error("Missing vendor repository");
-  if (typeof values.tag !== "string" || !parseStableTag(values.tag)) throw new Error("Invalid vendor tag");
-  if (typeof values.commit !== "string" || !/^[0-9a-f]{40}$/.test(values.commit)) throw new Error("Invalid vendor commit");
-  if (JSON.stringify(values.sources) !== JSON.stringify(VENDOR_SOURCES)) throw new Error("Vendor source paths differ from the expected inventory");
-  if (!Array.isArray(values.files) || values.files.length === 0) {
-    throw new Error("Missing vendor file inventory");
-  }
-
-  const files = values.files.map((value): VendorFileRecord => {
-    if (!isRecord(value)) {
-      throw new Error("Invalid vendor file record");
-    }
-    const record = value;
-    if (!hasExactKeys(record, ["path", "bytes", "sha256"])) {
-      throw new Error("Vendor file record has unexpected or missing fields");
-    }
-    if (typeof record.path !== "string" || !record.path) throw new Error("Invalid vendor file path");
-    if (typeof record.bytes !== "number" || !Number.isSafeInteger(record.bytes) || record.bytes < 0) throw new Error("Invalid vendor file size");
-    if (typeof record.sha256 !== "string" || !/^[0-9a-f]{64}$/.test(record.sha256)) throw new Error("Invalid vendor file checksum");
-    return { path: record.path, bytes: record.bytes, sha256: record.sha256 };
-  });
-
-  return {
-    schemaVersion: 1,
-    repository: values.repository,
-    tag: values.tag,
-    commit: values.commit,
-    sources: VENDOR_SOURCES,
-    files,
-  };
-}
-
-/** Validate manifest inventory and checksums against files on disk. */
-export async function validateVendorManifest(
-  vendorDir: string,
-  expected?: ExpectedVendorProvenance
-): Promise<VendorManifest> {
-  const manifest = parseManifest(
-    await fs.readFile(path.join(vendorDir, VENDOR_MANIFEST), "utf-8")
-  );
-  if (
-    expected &&
-    (manifest.repository !== expected.repository ||
-      manifest.tag !== expected.tag ||
-      manifest.commit !== expected.commit)
-  ) {
-    throw new Error("Vendor release provenance differs from the resolved upstream release");
-  }
-  const actualPaths = await listVendorFiles(vendorDir);
-  const manifestPaths = manifest.files.map((file) => file.path);
-  if (JSON.stringify(manifestPaths) !== JSON.stringify([...manifestPaths].sort())) {
-    throw new Error("Vendor manifest inventory is not sorted");
-  }
-  if (JSON.stringify(manifestPaths) !== JSON.stringify(actualPaths)) {
-    throw new Error("Vendor file inventory differs from the manifest");
-  }
-
-  for (const expected of manifest.files) {
-    const actual = await fileRecord(vendorDir, expected.path);
-    if (actual.bytes !== expected.bytes || actual.sha256 !== expected.sha256) {
-      throw new Error(`Vendor checksum mismatch: ${expected.path}`);
-    }
-  }
-
-  return manifest;
-}

package/src/vendor.ts

@@ -1,277 +0,0 @@
-/**
- * Vendor file loaders for beads plugin.
- *
- * The vendor directory contains beads command definitions and agent prompts
- * synced from the upstream beads repository via scripts/sync-beads.sh.
- */
-
-import * as fs from "node:fs/promises";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
-import type { AgentConfig, Config } from "@opencode-ai/sdk";
-import { adaptVendorPrompt } from "./vendor-adaptations";
-
-function getVendorDir(): string {
-  const __dirname = path.dirname(fileURLToPath(import.meta.url));
-  return path.join(__dirname, "..", "vendor");
-}
-
-interface ParsedMarkdown {
-  frontmatter: Record<string, string>;
-  body: string;
-}
-
-const DOCUMENT_ONLY_COMMANDS = new Set(["commands/prime.md", "commands/template.md"]);
-const COMMAND_FRONTMATTER_FIELDS = new Set([
-  "agent",
-  "argument-hint",
-  "description",
-  "model",
-  "subtask",
-]);
-const AGENT_FRONTMATTER_FIELDS = new Set([
-  "color",
-  "description",
-  "disable",
-  "maxSteps",
-  "mode",
-  "model",
-  "temperature",
-  "top_p",
-]);
-
-function vendorError(relativePath: string, reason: string): Error {
-  return new Error(`Invalid vendor artifact ${relativePath}: ${reason}`);
-}
-
-function parseMarkdownWithFrontmatter(content: string, relativePath: string): ParsedMarkdown {
-  const frontmatterRegex = /^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/;
-  const match = content.match(frontmatterRegex);
-
-  if (!match) throw vendorError(relativePath, "missing or malformed frontmatter delimiters");
-
-  const frontmatterStr = match[1];
-  const body = match[2];
-
-  if (frontmatterStr === undefined || body === undefined) {
-    throw vendorError(relativePath, "missing frontmatter or body");
-  }
-
-  const frontmatter: Record<string, string> = {};
-
-  for (const line of frontmatterStr.split("\n")) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith("#")) continue;
-
-    const colonIndex = trimmed.indexOf(":");
-    if (colonIndex <= 0) throw vendorError(relativePath, `malformed frontmatter line: ${trimmed}`);
-
-    const key = trimmed.slice(0, colonIndex).trim();
-    let value = trimmed.slice(colonIndex + 1).trim();
-    if (Object.hasOwn(frontmatter, key)) {
-      throw vendorError(relativePath, `duplicate frontmatter field: ${key}`);
-    }
-
-    // Handle quoted strings
-    if (
-      (value.startsWith('"') && value.endsWith('"')) ||
-      (value.startsWith("'") && value.endsWith("'"))
-    ) {
-      value = value.slice(1, -1);
-    } else if (value.startsWith('"') || value.startsWith("'")) {
-      throw vendorError(relativePath, `unterminated quoted value for ${key}`);
-    }
-
-    // Handle empty array syntax like []
-    if (value === "[]") {
-      value = "";
-    }
-
-    frontmatter[key] = value;
-  }
-
-  const trimmedBody = body.trim();
-  if (!trimmedBody) throw vendorError(relativePath, "body must not be empty");
-  return { frontmatter, body: trimmedBody };
-}
-
-async function readVendorFile(vendorDirectory: string, relativePath: string): Promise<string> {
-  try {
-    const fullPath = path.join(vendorDirectory, relativePath);
-    return await fs.readFile(fullPath, "utf-8");
-  } catch (error) {
-    const reason = error instanceof Error ? error.message : String(error);
-    throw vendorError(relativePath, `cannot read file: ${reason}`);
-  }
-}
-
-async function manifestPaths(vendorDirectory: string): Promise<string[]> {
-  const content = await readVendorFile(vendorDirectory, "manifest.json");
-  let manifest: unknown;
-  try {
-    manifest = JSON.parse(content);
-  } catch (error) {
-    const reason = error instanceof Error ? error.message : String(error);
-    throw vendorError("manifest.json", `invalid JSON: ${reason}`);
-  }
-
-  if (
-    typeof manifest !== "object" ||
-    manifest === null ||
-    !("files" in manifest) ||
-    !Array.isArray(manifest.files)
-  ) {
-    throw vendorError("manifest.json", "files must be an array");
-  }
-  const paths = manifest.files.map((file, index) => {
-    if (
-      typeof file !== "object" ||
-      file === null ||
-      !("path" in file) ||
-      typeof file.path !== "string"
-    ) {
-      throw vendorError("manifest.json", `files[${index}].path must be a string`);
-    }
-    return file.path;
-  });
-  if (new Set(paths).size !== paths.length) {
-    throw vendorError("manifest.json", "file paths must be unique");
-  }
-  return paths.sort();
-}
-
-function requiredString(
-  frontmatter: Record<string, string>,
-  field: string,
-  relativePath: string
-): string {
-  const value = frontmatter[field];
-  if (!value?.trim()) throw vendorError(relativePath, `${field} must be a non-empty string`);
-  return value;
-}
-
-function parseBoolean(value: string, field: string, relativePath: string): boolean {
-  if (value === "true") return true;
-  if (value === "false") return false;
-  throw vendorError(relativePath, `${field} must be true or false`);
-}
-
-function parseNumber(value: string, field: string, relativePath: string): number {
-  const parsed = Number(value);
-  if (!Number.isFinite(parsed)) throw vendorError(relativePath, `${field} must be a number`);
-  return parsed;
-}
-
-function rejectUnsupportedFields(
-  frontmatter: Record<string, string>,
-  supported: ReadonlySet<string>,
-  relativePath: string
-): void {
-  const unsupported = Object.keys(frontmatter).find((field) => !supported.has(field));
-  if (unsupported) throw vendorError(relativePath, `unsupported frontmatter field: ${unsupported}`);
-}
-
-const BEADS_HOST_GUIDANCE = `## CLI Safety
-
-There is no native \`bd\` or Beads MCP tool in OpenCode. Run \`bd\` through \`bash\`.
-Treat the injected \`bd prime\` output as the canonical workflow reference. Use \`bd --help\` to discover commands, \`bd <command> --help\` for current syntax, and \`--json\` when structured output improves reliability. Distinguish command failures from output parsing failures.
-
-Run relevant validation before closing an issue. Do not commit, push, or run Dolt synchronization automatically; do so only when current instructions or repository policy explicitly require it.`;
-
-const BEADS_DELEGATION_GUIDANCE = `## Delegation
-
-Delegate multi-command Beads work and issue-graph analysis to the \`beads-task-agent\`; perform only single atomic operations directly.`;
-
-const BEADS_SUBAGENT_CONTEXT = `## Beads Task Agent
-
-Full \`bd prime\` workflow context is injected at start and after compaction. Use \`bd\` via \`bash\`; rerun prime if context is missing or stale.
-
-For status or graph analysis, never claim, update, close, or modify a bead. Return the analysis and stop.
-
-For completion, process exactly one bead. Use a caller-supplied ID; otherwise choose one highest-priority ready bead. First run \`bd show <id> --json\`; confirm it is open, actionable, and appropriate; then claim with \`bd update <id> --claim --json\`. If an assigned bead is closed, blocked, unsuitable, missing, or otherwise not actionable, report and return without mutation or substitution.
-
-Implement and validate it. Create discoveries with \`discovered-from:<current-id>\` and a parent only when structurally obvious. Never claim or implement work created this invocation; it may be eligible later. Close or block the current bead, report discoveries, and return without seeking more work. Return concise results, not raw JSON.`;
-
-/** Build the single shared guidance layer for one injected audience. */
-export function beadsGuidance(
-  audience: "primary" | "task-agent"
-): string {
-  const sections = [BEADS_HOST_GUIDANCE];
-  if (audience === "primary") sections.push(BEADS_DELEGATION_GUIDANCE);
-  return `<beads-guidance>\n${sections.join("\n\n")}\n</beads-guidance>`;
-}
-
-export async function loadAgent(vendorDirectory = getVendorDir()): Promise<Config["agent"]> {
-  const relativePath = "agents/task-agent.md";
-  const paths = await manifestPaths(vendorDirectory);
-  if (!paths.includes(relativePath)) {
-    throw vendorError("manifest.json", `missing required file record: ${relativePath}`);
-  }
-  const content = await readVendorFile(vendorDirectory, relativePath);
-  const parsed = parseMarkdownWithFrontmatter(content, relativePath);
-  const { frontmatter } = parsed;
-  rejectUnsupportedFields(frontmatter, AGENT_FRONTMATTER_FIELDS, relativePath);
-  if (frontmatter.mode !== undefined && frontmatter.mode !== "subagent") {
-    throw vendorError(relativePath, "mode must be subagent when provided");
-  }
-
-  const agent: AgentConfig = {
-    description: requiredString(frontmatter, "description", relativePath),
-    prompt: BEADS_SUBAGENT_CONTEXT,
-    mode: "subagent",
-  };
-  // Keep upstream adaptation validation as a publish-time compatibility gate.
-  adaptVendorPrompt(relativePath, parsed.body);
-  if (frontmatter.model) agent.model = frontmatter.model;
-  if (frontmatter.temperature) {
-    agent.temperature = parseNumber(frontmatter.temperature, "temperature", relativePath);
-  }
-  if (frontmatter.top_p) agent.top_p = parseNumber(frontmatter.top_p, "top_p", relativePath);
-  if (frontmatter.disable) {
-    agent.disable = parseBoolean(frontmatter.disable, "disable", relativePath);
-  }
-  if (frontmatter.color) agent.color = frontmatter.color;
-  if (frontmatter.maxSteps) {
-    agent.maxSteps = parseNumber(frontmatter.maxSteps, "maxSteps", relativePath);
-  }
-
-  return { "beads-task-agent": agent };
-}
-
-export async function loadCommands(vendorDirectory = getVendorDir()): Promise<Config["command"]> {
-  const paths = await manifestPaths(vendorDirectory);
-  const commandPaths = paths.filter((file) => file.startsWith("commands/") && file.endsWith(".md"));
-  if (commandPaths.length === 0) {
-    throw vendorError("manifest.json", "no command Markdown files are recorded");
-  }
-  const commands: Config["command"] = {};
-
-  for (const relativePath of commandPaths) {
-    const content = await readVendorFile(vendorDirectory, relativePath);
-    if (DOCUMENT_ONLY_COMMANDS.has(relativePath)) continue;
-    const parsed = parseMarkdownWithFrontmatter(content, relativePath);
-    const { frontmatter } = parsed;
-    rejectUnsupportedFields(frontmatter, COMMAND_FRONTMATTER_FIELDS, relativePath);
-    const file = path.basename(relativePath);
-    const name = `beads:${file.replace(".md", "")}`;
-
-    const argHint = frontmatter["argument-hint"];
-    const baseDescription = requiredString(frontmatter, "description", relativePath);
-    const description = argHint
-      ? `${baseDescription} (${argHint})`
-      : baseDescription;
-
-    const command: NonNullable<Config["command"]>[string] = {
-      description,
-      template: adaptVendorPrompt(relativePath, parsed.body),
-    };
-    if (frontmatter.agent) command.agent = frontmatter.agent;
-    if (frontmatter.model) command.model = frontmatter.model;
-    if (frontmatter.subtask) {
-      command.subtask = parseBoolean(frontmatter.subtask, "subtask", relativePath);
-    }
-    commands[name] = command;
-  }
-
-  return commands;
-}

package/vendor/agents/task-agent.md

@@ -1,61 +0,0 @@
----
-description: Autonomous agent that finds and completes ready tasks
----
-
-You are a task-completion agent for beads. Your goal is to find ready work and complete it autonomously.
-
-# Agent Workflow
-
-1. **Find Ready Work**
-   - Use the `ready` MCP tool to get unblocked tasks
-   - Prefer higher priority tasks (P0 > P1 > P2 > P3 > P4)
-   - If no ready tasks, report completion
-
-2. **Claim the Task**
-   - Use the `show` tool to get full task details
-   - Use the `claim` tool for atomic start-work semantics
-   - Report what you're working on
-
-3. **Execute the Task**
-   - Read the task description carefully
-   - Use available tools to complete the work
-   - Follow best practices from project documentation
-   - Run tests if applicable
-
-4. **Track Discoveries**
-   - If you find bugs, TODOs, or related work:
-     - Use `create` tool to file new issues
-     - Use `dep` tool with `discovered-from` to link them
-   - This maintains context for future work
-
-5. **Complete the Task**
-   - Verify the work is done correctly
-   - Use `close` tool with a clear completion message
-   - Report what was accomplished
-
-6. **Continue**
-   - Check for newly unblocked work with `ready`
-   - Repeat the cycle
-
-# Important Guidelines
-
-- Always claim before working (MCP: `claim`; CLI: `--claim`) and close when done
-- Link discovered work with `discovered-from` dependencies
-- Don't close issues unless work is actually complete
-- If blocked, use `update` to set status to `blocked` and explain why
-- Communicate clearly about progress and blockers
-
-# Available Tools
-
-Via beads MCP server:
-- `ready` - Find unblocked tasks
-- `show` - Get task details
-- `claim` - Atomically claim task for work
-- `update` - Update task status/fields
-- `create` - Create new issues
-- `dep` - Manage dependencies
-- `close` - Complete tasks
-- `blocked` - Check blocked issues
-- `stats` - View project stats
-
-You are autonomous but should communicate your progress clearly. Start by finding ready work!

package/vendor/commands/audit.md

@@ -1,28 +0,0 @@
----
-description: Log and label agent interactions (append-only JSONL)
-argument-hint: record|label
----
-
-Append-only audit logging for agent interactions (prompts, responses, tool calls) in `.beads/interactions.jsonl`.
-
-Each line is one event. Labeling is done by appending a new `"label"` event referencing a previous entry.
-
-## Usage
-
-- **Record an interaction**:
-  - `bd audit record --kind llm_call --model "claude-3-5-haiku" --prompt "..." --response "..."`
-  - `bd audit record --kind tool_call --tool-name "go test" --exit-code 1 --error "..." --issue-id bd-42`
-
-- **Pipe JSON via stdin**:
-  - `cat event.json | bd audit record`
-
-- **Label an entry**:
-  - `bd audit label int-a1b2 --label good --reason "Worked perfectly"`
-  - `bd audit label int-a1b2 --label bad --reason "Hallucinated a file path"`
-
-## Notes
-
-- Audit entries are **append-only** (no in-place edits).
-- `bd dolt push` includes `.beads/interactions.jsonl` in the commit allowlist.
-
-

package/vendor/commands/blocked.md

@@ -1,15 +0,0 @@
----
-description: Show blocked issues
-argument-hint: []
----
-
-Show all issues that are blocked by dependencies.
-
-Use `bd blocked` to see which issues have blockers preventing them from being worked on. This is the inverse of `bd ready` - it shows what's NOT ready.
-
-Blocked issues have one or more dependencies with type "blocks" that are still open. Once all blocking dependencies are closed, the issue becomes ready and will appear in `bd ready`.
-
-Useful for:
-- Understanding why work is stuck
-- Identifying critical path items
-- Planning dependency resolution

package/vendor/commands/close.md

@@ -1,18 +0,0 @@
----
-description: Close a completed issue
-argument-hint: [issue-id] [reason]
----
-
-Close a beads issue that's been completed.
-
-If arguments are provided:
-- $1: Issue ID
-- $2+: Completion reason (optional)
-
-If the issue ID is missing, ask for it. Optionally ask for a reason describing what was done.
-
-Use the beads MCP `close` tool to close the issue. Show confirmation with the issue details.
-
-After closing, suggest checking for:
-- Dependent issues that might now be unblocked (use `ready` tool)
-- New work discovered during this task (use `create` tool with `discovered-from` link)

package/vendor/commands/comments.md

@@ -1,30 +0,0 @@
----
-description: View or manage comments on an issue
-argument-hint: [issue-id]
----
-
-View or add comments to a beads issue.
-
-Comments are separate from issue properties (title, description, etc.) because they serve a different purpose: they're a **discussion thread** rather than **singular editable fields**. Use `bd comments` for threaded conversations and `bd edit` for core issue metadata.
-
-## View Comments
-
-To view all comments on an issue:
-- $1: Issue ID (e.g., bd-123)
-
-Use the beads CLI `bd comments <issue-id>` to list all comments. Show them to the user with timestamps and authors.
-
-## Add Comment
-
-To add a comment:
-- $1: "add"
-- $2: Issue ID
-- $3: Comment text (or use -f flag for file input)
-
-Use `bd comments add <issue-id> "comment text"` to add a comment. Confirm the comment was added successfully.
-
-Comments are useful for:
-- Progress updates during work
-- Design notes or technical decisions
-- Links to related resources
-- Questions or blockers