Bootstrap Agent Routine

const isNewWorkspace = !existsSync(workspacePath);

if (isNewWorkspace) {
  // Create scaffold without AGENTS.md - that will be generated by opencode
  await createWorkspaceScaffold(workspacePath, libraryName, packages, { skipAgentsMd: true });
  await syncWorkspace(prefix, workspacePath);

  try {
    const result = await runBootstrapPrompt(
      async (userIntent, ui, client, serverUrl, model) => {
        await bootstrapWithOpencode(prefix, workspacePath, userIntent, xdgEnv, ui, client, serverUrl, model);
      },
      {
        prefix,
        workspacePath,
        xdgEnv,
      }
    );
    // ...
  }
}

type ViewState =
  | { type: "loading" }
  | { type: "provider-select"; selectedIndex: number }
  | { type: "auth-method-select"; providerId: string; methods: Array<{ type: string; label: string }>; selectedIndex: number }
  | { type: "oauth-auto"; providerId: string; methodIndex: number; url: string; instructions: string }
  | { type: "oauth-code"; providerId: string; methodIndex: number; url: string; instructions: string; error?: boolean }
  | { type: "api-key"; providerId: string; error?: boolean }
  | { type: "model-select"; models: ModelOption[] }
  | { type: "intent-prompt" }
  | { type: "bootstrap-output" }
  | { type: "question"; /* ... */ };

function buildBootstrapPrompt(userIntent: string): string {
  return `
You are bootstrapping a new workspace for the user. Their stated purpose is:
"${userIntent}"

## Important: Interview the User

If asked to read from a BOOT.md file, you must read it first. There will be information useful for you to help the user.

If there is a mention of Skills in either Markdown or JSON in the BOOT.md, you MUST use those to create skill files in your current working directory in the path .opencode/skills/<name>/SKILL.md.

Before taking any action outside of reading the BOOT.md, interview the user extensively to understand their needs:
- What specific problems are they trying to solve?
- What data sources will they work with?
- What are their preferred tools or libraries?
- What is their experience level with Python?
- Any specific requirements or constraints?

Use the AskUserQuestion tool to gather this information. Ask 2-4 focused questions before proceeding.

## After gathering information:

1. **TODO project tracker**: You need to set up a TODO for this bootstrapping task so you don't forget any steps. Validate by reading back the TODOs and the environment.
1. **Install packages**: Run \`uv add <packages>\` to install Python libraries appropriate for this use case
2. **Create library structure**: Add modules to src/agent_lib/ that will help with the stated purpose
3. **Generate SKILLS.md for each skill needed**: Create a SKILL.md at .opencode/skills/<name>/SKILL.md file with the SKILL.
3. **Generate AGENTS.md**: Create an AGENTS.md file following these best practices:

## SKILLS.md Guidelines:

You should always look up best practices for creating SKILLs.md files online before generating one. An extensive web search is recommended.

## AGENTS.md Guidelines:

You should always look up best practices for creating AGENTS.md files online before generating one. An extensive web search is recommended.

### Required Sections:
- **Project Overview**: One-sentence description tailored to "${userIntent}"
- **Commands**: Exact commands for build, test, run (use bun, uv, pytest)
- **Tech Stack**: Python 3.13, Bun, uv, and installed packages
- **Project Structure**: Key file paths and their purposes
- **Code Style**: Formatting rules, design patterns (use ruff, black)
- **Do's and Don'ts**: Specific, actionable guidelines for this use case
- **Safety Boundaries**:
  - Always do: Read files, run tests, format code
  - Ask first: Install new packages, modify pyproject.toml
  - Never do: Delete data, run destructive commands
`.trim();
}

const events = await client.event.subscribe({}, { signal: abort.signal });

for await (const event of events.stream) {
  // Auto-approve all permission requests during bootstrap
  if (event.type === "permission.asked") {
    const request = event.properties;
    if (request.sessionID === sessionId) {
      await autoApprovePermission(client, ui, request);
    }
  }

  // Stream text output
  if (event.type === "message.part.updated") {
    const { part, delta } = event.properties;
    if (part.sessionID !== sessionId) continue;

    if (part.type === "text" && delta) {
      ui.appendText(delta);
    }

    if (part.type === "tool") {
      // Show tool execution status (running, completed, error)
    }
  }

  // Handle question events
  if (event.type === "question.asked") {
    const request = event.properties;
    if (request.sessionID === sessionId) {
      const answers = await ui.showQuestion(request);
      await client.question.reply({ requestID: request.id, answers });
    }
  }

  // Check if session is idle (completed)
  if (event.type === "session.idle" && event.properties.sessionID === sessionId) {
    resolve();
  }
}

export interface BootstrapUI {
  appendText: (text: string) => void;
  appendToolStatus: (status: "running" | "completed" | "error", text: string) => void;
  setStatus: (status: string) => void;
  showDiff: (diffs: FileDiff[]) => void;
  showBashOutput: (command: string, output: string, description?: string) => void;
  showWriteOutput: (filePath: string, content: string) => void;
  showEditOutput: (filePath: string, diff: string) => void;
  setSpinnerActive: (active: boolean) => void;
  showQuestion: (request: QuestionRequest) => Promise<QuestionAnswer[]>;
}

function handleToolCompletion(
  ui: BootstrapUI,
  part: ToolCompletionPart,
): void {
  const { state, tool } = part;
  const output = state.output;
  const input = state.input;

  if (tool === "bash" && output?.trim()) {
    const command = (input?.command as string) || title;
    ui.showBashOutput(command, output, description);
  } else if (tool === "write" && input?.filePath) {
    ui.showWriteOutput(input.filePath as string, (input.content as string) || "");
  } else if (tool === "edit" && metadata?.diff && input?.filePath) {
    ui.showEditOutput(input.filePath as string, metadata.diff as string);
  } else if (tool === "apply_patch" && metadata?.diff) {
    ui.showEditOutput(filePath, metadata.diff as string);
  } else {
    ui.appendToolStatus("completed", title);
  }
}

if (!result) {
  // User skipped (Ctrl+C)
  console.log("\nSkipped bootstrap. Using default AGENTS.md.");
  await Bun.write(join(workspacePath, "AGENTS.md"), generateAgentsMd(libraryName));
}