@bloxystudios/bloxycode 1.0.2 → 1.0.4

package/src/cli/ui.ts

@@ -1,86 +0,0 @@
-import z from "zod"
-import { EOL } from "os"
-import { NamedError } from "@/util/error"
-
-export namespace UI {
-  const LOGO = [
-    [`██████╗ ██╗      ██████╗ ██╗  ██╗██╗   ██╗`, ` ██████╗ ██████╗ ██████╗ ███████╗`],
-    [`██╔══██╗██║     ██╔═══██╗╚██╗██╔╝╚██╗ ██╔╝`, `██╔════╝██╔═══██╗██╔══██╗██╔════╝`],
-    [`██████╔╝██║     ██║   ██║ ╚███╔╝  ╚████╔╝ `, `██║     ██║   ██║██║  ██║█████╗  `],
-    [`██╔══██╗██║     ██║   ██║ ██╔██╗   ╚██╔╝  `, `██║     ██║   ██║██║  ██║██╔══╝  `],
-    [`██████╔╝███████╗╚██████╔╝██╔╝ ██╗   ██║   `, `╚██████╗╚██████╔╝██████╔╝███████╗`],
-    [`╚═════╝ ╚══════╝ ╚═════╝ ╚═╝  ╚═╝   ╚═╝   `, ` ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝`],
-  ]
-
-  export const CancelledError = NamedError.create("UICancelledError", z.void())
-
-  export const Style = {
-    TEXT_HIGHLIGHT: "\x1b[96m",
-    TEXT_HIGHLIGHT_BOLD: "\x1b[96m\x1b[1m",
-    TEXT_DIM: "\x1b[90m",
-    TEXT_DIM_BOLD: "\x1b[90m\x1b[1m",
-    TEXT_NORMAL: "\x1b[0m",
-    TEXT_NORMAL_BOLD: "\x1b[1m",
-    TEXT_WARNING: "\x1b[93m",
-    TEXT_WARNING_BOLD: "\x1b[93m\x1b[1m",
-    TEXT_DANGER: "\x1b[91m",
-    TEXT_DANGER_BOLD: "\x1b[91m\x1b[1m",
-    TEXT_SUCCESS: "\x1b[92m",
-    TEXT_SUCCESS_BOLD: "\x1b[92m\x1b[1m",
-    TEXT_INFO: "\x1b[94m",
-    TEXT_INFO_BOLD: "\x1b[94m\x1b[1m",
-  }
-
-  export function println(...message: string[]) {
-    print(...message)
-    Bun.stderr.write(EOL)
-  }
-
-  export function print(...message: string[]) {
-    blank = false
-    Bun.stderr.write(message.join(" "))
-  }
-
-  let blank = false
-  export function empty() {
-    if (blank) return
-    println("" + Style.TEXT_NORMAL)
-    blank = true
-  }
-
-  export function logo(pad?: string) {
-    const result = []
-    for (const row of LOGO) {
-      if (pad) result.push(pad)
-      result.push(Bun.color("gray", "ansi"))
-      result.push(row[0])
-      result.push("\x1b[0m")
-      result.push(row[1])
-      result.push(EOL)
-    }
-    return result.join("").trimEnd()
-  }
-
-  export async function input(prompt: string): Promise<string> {
-    const readline = require("readline")
-    const rl = readline.createInterface({
-      input: process.stdin,
-      output: process.stdout,
-    })
-
-    return new Promise((resolve) => {
-      rl.question(prompt, (answer: string) => {
-        rl.close()
-        resolve(answer.trim())
-      })
-    })
-  }
-
-  export function error(message: string) {
-    println(Style.TEXT_DANGER_BOLD + "Error: " + Style.TEXT_NORMAL + message)
-  }
-
-  export function markdown(text: string): string {
-    return text
-  }
-}

package/src/cli/upgrade.ts

@@ -1,25 +0,0 @@
-import { Bus } from "@/bus"
-import { Config } from "@/config/config"
-import { Flag } from "@/flag/flag"
-import { Installation } from "@/installation"
-
-export async function upgrade() {
-  const config = await Config.global()
-  const method = await Installation.method()
-  const latest = await Installation.latest(method).catch(() => {})
-  if (!latest) return
-  if (Installation.VERSION === latest) return
-
-  if (config.autoupdate === false || Flag.BLOXYCODE_DISABLE_AUTOUPDATE) {
-    return
-  }
-  if (config.autoupdate === "notify") {
-    await Bus.publish(Installation.Event.UpdateAvailable, { version: latest })
-    return
-  }
-
-  if (method === "unknown") return
-  await Installation.upgrade(method, latest)
-    .then(() => Bus.publish(Installation.Event.Updated, { version: latest }))
-    .catch(() => {})
-}

package/src/command/index.ts

@@ -1,173 +0,0 @@
-import { BusEvent } from "@/bus/bus-event"
-import z from "zod"
-import { Config } from "../config/config"
-import { Instance } from "../project/instance"
-import { Identifier } from "../id/id"
-import PROMPT_INITIALIZE from "./template/initialize.txt"
-import PROMPT_REVIEW from "./template/review.txt"
-import PROMPT_BLOXY from "./template/bloxy.txt"
-import PROMPT_BLOXY_STATUS from "./template/bloxy-status.txt"
-import PROMPT_BLOXY_RESUME from "./template/bloxy-resume.txt"
-import PROMPT_BLOXY_VALIDATE from "./template/bloxy-validate.txt"
-import { MCP } from "../mcp"
-
-export namespace Command {
-  export const Event = {
-    Executed: BusEvent.define(
-      "command.executed",
-      z.object({
-        name: z.string(),
-        sessionID: Identifier.schema("session"),
-        arguments: z.string(),
-        messageID: Identifier.schema("message"),
-      }),
-    ),
-  }
-
-  export const Info = z
-    .object({
-      name: z.string(),
-      description: z.string().optional(),
-      agent: z.string().optional(),
-      model: z.string().optional(),
-      mcp: z.boolean().optional(),
-      // workaround for zod not supporting async functions natively so we use getters
-      // https://zod.dev/v4/changelog?id=zfunction
-      template: z.promise(z.string()).or(z.string()),
-      subtask: z.boolean().optional(),
-      hints: z.array(z.string()),
-    })
-    .meta({
-      ref: "Command",
-    })
-
-  // for some reason zod is inferring `string` for z.promise(z.string()).or(z.string()) so we have to manually override it
-  export type Info = Omit<z.infer<typeof Info>, "template"> & { template: Promise<string> | string }
-
-  export function hints(template: string): string[] {
-    const result: string[] = []
-    const numbered = template.match(/\$\d+/g)
-    if (numbered) {
-      for (const match of [...new Set(numbered)].sort()) result.push(match)
-    }
-    if (template.includes("$ARGUMENTS")) result.push("$ARGUMENTS")
-    return result
-  }
-
-  export const Default = {
-    INIT: "init",
-    REVIEW: "review",
-    BLOXY: "bloxy",
-    BLOXY_STATUS: "bloxy-status",
-    BLOXY_RESUME: "bloxy-resume",
-    BLOXY_VALIDATE: "bloxy-validate",
-  } as const
-
-  const state = Instance.state(async () => {
-    const cfg = await Config.get()
-
-    const result: Record<string, Info> = {
-      [Default.INIT]: {
-        name: Default.INIT,
-        description: "create/update AGENTS.md",
-        get template() {
-          return PROMPT_INITIALIZE.replace("${path}", Instance.worktree)
-        },
-        hints: hints(PROMPT_INITIALIZE),
-      },
-      [Default.REVIEW]: {
-        name: Default.REVIEW,
-        description: "review changes [commit|branch|pr], defaults to uncommitted",
-        get template() {
-          return PROMPT_REVIEW.replace("${path}", Instance.worktree)
-        },
-        subtask: true,
-        hints: hints(PROMPT_REVIEW),
-      },
-      [Default.BLOXY]: {
-        name: Default.BLOXY,
-        description: "start autonomous task execution from PRD file [path], defaults to PRD.md",
-        agent: "bloxy",
-        get template() {
-          return PROMPT_BLOXY
-        },
-        hints: hints(PROMPT_BLOXY),
-      },
-      [Default.BLOXY_STATUS]: {
-        name: Default.BLOXY_STATUS,
-        description: "show current Bloxy task execution status",
-        get template() {
-          return PROMPT_BLOXY_STATUS
-        },
-        hints: [],
-      },
-      [Default.BLOXY_RESUME]: {
-        name: Default.BLOXY_RESUME,
-        description: "resume Bloxy from last failure [--skip-failed]",
-        agent: "bloxy",
-        get template() {
-          return PROMPT_BLOXY_RESUME
-        },
-        hints: hints(PROMPT_BLOXY_RESUME),
-      },
-      [Default.BLOXY_VALIDATE]: {
-        name: Default.BLOXY_VALIDATE,
-        description: "validate PRD file syntax without executing [path]",
-        get template() {
-          return PROMPT_BLOXY_VALIDATE
-        },
-        hints: hints(PROMPT_BLOXY_VALIDATE),
-      },
-    }
-
-    for (const [name, command] of Object.entries(cfg.command ?? {})) {
-      result[name] = {
-        name,
-        agent: command.agent,
-        model: command.model,
-        description: command.description,
-        get template() {
-          return command.template
-        },
-        subtask: command.subtask,
-        hints: hints(command.template),
-      }
-    }
-    for (const [name, prompt] of Object.entries(await MCP.prompts())) {
-      result[name] = {
-        name,
-        mcp: true,
-        description: prompt.description,
-        get template() {
-          // since a getter can't be async we need to manually return a promise here
-          return new Promise<string>(async (resolve, reject) => {
-            const template = await MCP.getPrompt(
-              prompt.client,
-              prompt.name,
-              prompt.arguments
-                ? // substitute each argument with $1, $2, etc.
-                  Object.fromEntries(prompt.arguments?.map((argument, i) => [argument.name, `$${i + 1}`]))
-                : {},
-            ).catch(reject)
-            resolve(
-              template?.messages
-                .map((message) => (message.content.type === "text" ? message.content.text : ""))
-                .join("\n") || "",
-            )
-          })
-        },
-        hints: prompt.arguments?.map((_, i) => `$${i + 1}`) ?? [],
-      }
-    }
-
-    return result
-  })
-
-  export async function get(name: string) {
-    return state().then((x) => x[name])
-  }
-
-  export async function list() {
-    return state().then((x) => Object.values(x))
-  }
-}

package/src/command/template/bloxy-resume.txt

@@ -1,15 +0,0 @@
-Resume the Bloxy session from the last pending or failed task.
-
-If $1 is "--skip-failed", skip any failed tasks and continue with the next pending task.
-
-Steps:
-1. Load the session state from .bloxycode/bloxy-state.json
-2. If no session exists, inform the user
-3. Find the first actionable task:
-   - With --skip-failed: Find first "pending" task
-   - Without flag: Find first "pending" or "failed" task (for retry)
-4. Set the session status to "running"
-5. Begin executing from that task
-6. Display which task is being resumed
-
-If all tasks are already completed, inform the user that there's nothing to resume.

package/src/command/template/bloxy-status.txt

@@ -1,25 +0,0 @@
-Show the current Bloxy session status.
-
-Read the state from .bloxycode/bloxy-state.json and display:
-
-1. **Session Overview**
-   - PRD file being executed
-   - Overall status (running/paused/completed/failed)
-   - Progress: X/Y tasks (Z%)
-
-2. **Completed Tasks** (if any)
-   - Task title and completion summary
-   - Time taken (if available)
-
-3. **Current Task** (if running)
-   - Task title and description
-   - Attempt number
-
-4. **Pending Tasks** (if any)
-   - List of remaining task titles
-
-5. **Failed Tasks** (if any)
-   - Task title and error message
-   - Number of attempts made
-
-If no active Bloxy session exists, inform the user and suggest starting one with /bloxy PRD.md

package/src/command/template/bloxy-validate.txt

@@ -1,22 +0,0 @@
-Validate the PRD file at $1 without executing tasks.
-
-If no path is provided, default to PRD.md.
-
-Perform the following validation checks:
-
-1. **File Exists**: Verify the PRD file exists and is readable
-2. **Syntax Check**: Validate markdown checkbox format
-   - `- [ ]` for pending tasks
-   - `- [x]` for completed tasks
-   - `- [~]` for deferred tasks
-3. **Task Count**: Ensure at least one task is defined
-4. **Task Titles**: Each task must have a title
-5. **No Duplicates**: Check for duplicate task IDs
-6. **Config Validation**: If YAML frontmatter or config section exists, validate it
-
-Report:
-- Total tasks found (pending, completed, deferred)
-- Any validation errors or warnings
-- Whether the PRD is ready for execution
-
-Do NOT start executing tasks. This is a dry-run validation only.

package/src/command/template/bloxy.txt

@@ -1,14 +0,0 @@
-Start autonomous task execution from PRD file: $1
-
-First, parse the PRD file and load all tasks. Display a summary of what tasks will be executed.
-
-Then, begin executing tasks sequentially. For each task:
-1. Read and understand the task requirements
-2. Implement the task completely
-3. Run tests if configured
-4. Commit changes if auto-commit is enabled
-5. Signal completion using the bloxy_control tool
-
-Continue until all tasks are complete or an unrecoverable error occurs.
-
-If no PRD path is specified, default to PRD.md in the current directory.

package/src/command/template/initialize.txt

@@ -1,10 +0,0 @@
-Please analyze this codebase and create an AGENTS.md file containing:
-1. Build/lint/test commands - especially for running a single test
-2. Code style guidelines including imports, formatting, types, naming conventions, error handling, etc.
-
-The file you create will be given to agentic coding agents (such as yourself) that operate in this repository. Make it about 150 lines long.
-If there are Cursor rules (in .cursor/rules/ or .cursorrules) or Copilot rules (in .github/copilot-instructions.md), make sure to include them.
-
-If there's already an AGENTS.md, improve it if it's located in ${path}
-
-$ARGUMENTS

package/src/command/template/review.txt

@@ -1,99 +0,0 @@
-You are a code reviewer. Your job is to review code changes and provide actionable feedback.
-
----
-
-Input: $ARGUMENTS
-
----
-
-## Determining What to Review
-
-Based on the input provided, determine which type of review to perform:
-
-1. **No arguments (default)**: Review all uncommitted changes
-   - Run: `git diff` for unstaged changes
-   - Run: `git diff --cached` for staged changes
-   - Run: `git status --short` to identify untracked (net new) files
-
-2. **Commit hash** (40-char SHA or short hash): Review that specific commit
-   - Run: `git show $ARGUMENTS`
-
-3. **Branch name**: Compare current branch to the specified branch
-   - Run: `git diff $ARGUMENTS...HEAD`
-
-4. **PR URL or number** (contains "github.com" or "pull" or looks like a PR number): Review the pull request
-   - Run: `gh pr view $ARGUMENTS` to get PR context
-   - Run: `gh pr diff $ARGUMENTS` to get the diff
-
-Use best judgement when processing input.
-
----
-
-## Gathering Context
-
-**Diffs alone are not enough.** After getting the diff, read the entire file(s) being modified to understand the full context. Code that looks wrong in isolation may be correct given surrounding logic—and vice versa.
-
-- Use the diff to identify which files changed
-- Use `git status --short` to identify untracked files, then read their full contents
-- Read the full file to understand existing patterns, control flow, and error handling
-- Check for existing style guide or conventions files (CONVENTIONS.md, AGENTS.md, .editorconfig, etc.)
-
----
-
-## What to Look For
-
-**Bugs** - Your primary focus.
-- Logic errors, off-by-one mistakes, incorrect conditionals
-- If-else guards: missing guards, incorrect branching, unreachable code paths
-- Edge cases: null/empty/undefined inputs, error conditions, race conditions
-- Security issues: injection, auth bypass, data exposure
-- Broken error handling that swallows failures, throws unexpectedly or returns error types that are not caught.
-
-**Structure** - Does the code fit the codebase?
-- Does it follow existing patterns and conventions?
-- Are there established abstractions it should use but doesn't?
-- Excessive nesting that could be flattened with early returns or extraction
-
-**Performance** - Only flag if obviously problematic.
-- O(n²) on unbounded data, N+1 queries, blocking I/O on hot paths
-
----
-
-## Before You Flag Something
-
-**Be certain.** If you're going to call something a bug, you need to be confident it actually is one.
-
-- Only review the changes - do not review pre-existing code that wasn't modified
-- Don't flag something as a bug if you're unsure - investigate first
-- Don't invent hypothetical problems - if an edge case matters, explain the realistic scenario where it breaks
-- If you need more context to be sure, use the tools below to get it
-
-**Don't be a zealot about style.** When checking code against conventions:
-
-- Verify the code is *actually* in violation. Don't complain about else statements if early returns are already being used correctly.
-- Some "violations" are acceptable when they're the simplest option. A `let` statement is fine if the alternative is convoluted.
-- Excessive nesting is a legitimate concern regardless of other style choices.
-- Don't flag style preferences as issues unless they clearly violate established project conventions.
-
----
-
-## Tools
-
-Use these to inform your review:
-
-- **Explore agent** - Find how existing code handles similar problems. Check patterns, conventions, and prior art before claiming something doesn't fit.
-- **Exa Code Context** - Verify correct usage of libraries/APIs before flagging something as wrong.
-- **Exa Web Search** - Research best practices if you're unsure about a pattern.
-
-If you're uncertain about something and can't verify it with these tools, say "I'm not sure about X" rather than flagging it as a definite issue.
-
----
-
-## Output
-
-1. If there is a bug, be direct and clear about why it is a bug.
-2. Clearly communicate severity of issues. Do not overstate severity.
-3. Critiques should clearly and explicitly communicate the scenarios, environments, or inputs that are necessary for the bug to arise. The comment should immediately indicate that the issue's severity depends on these factors.
-4. Your tone should be matter-of-fact and not accusatory or overly positive. It should read as a helpful AI assistant suggestion without sounding too much like a human reviewer.
-5. Write so the reader can quickly understand the issue without reading too closely.
-6. AVOID flattery, do not give any comments that are not helpful to the reader. Avoid phrasing like "Great job ...", "Thanks for ...".