Function buildWorkspaceBrief

packages/core/src/agent.ts:840–898

(
  input: GenerateInput,
  fs: TextEditorFsCallbacks | undefined,
)

}

function buildWorkspaceBrief(
  input: GenerateInput,
  fs: TextEditorFsCallbacks | undefined,
): string | null {
  if (!fs) return null;
  const files = workspaceFiles(fs);
  const sources = sourceCandidates(files, fs);
  const hasDesignMd = fs.view('DESIGN.md') !== null;
  const hasAgentsMd = fs.view('AGENTS.md') !== null;
  const hasSettingsJson = fs.view('.codesign/settings.json') !== null;
  const attachmentCount = input.attachments?.length ?? 0;
  const imageCount = (input.attachments ?? []).filter((file) =>
    file.mediaType?.startsWith('image/'),
  ).length;
  const currentDesignName = input.currentDesignName?.trim();
  const needsTitle = isAutoDesignName(currentDesignName);
  const hasReferenceUrl = input.referenceUrl !== null && input.referenceUrl !== undefined;
  const hasReferenceMaterials =
    attachmentCount > 0 ||
    hasReferenceUrl ||
    (input.designSystem !== null && input.designSystem !== undefined);
  const lines = [
    'Workspace context:',
    currentDesignName
      ? `- Current design title: ${currentDesignName}${needsTitle ? ' (auto-generated; call set_title before other tools).' : '.'}`
      : '- Current design title: unknown.',
    sources.length > 0
      ? `- Existing source candidates: ${sources.join(', ')}`
      : `- No existing design source was found. Create ${DEFAULT_SOURCE_ENTRY} for visual/web work, or create the requested document/handoff file for document-first work.`,
    `- DESIGN.md: ${hasDesignMd ? 'present; treat it as the design baton for this workspace.' : 'absent.'}`,
    `- AGENTS.md: ${hasAgentsMd ? 'present' : 'absent'}`,
    `- .codesign/settings.json: ${hasSettingsJson ? 'present' : 'absent'}`,
    `- Reference materials: attached file(s): ${attachmentCount}; image file(s): ${imageCount}; reference URL: ${hasReferenceUrl ? 'yes' : 'no'}; linked design-system scan: ${input.designSystem ? 'yes' : 'no'}.`,
  ];
  lines.push(
    needsTitle
      ? sources.length > 0
        ? 'This workspace has source files, but the visible design title is still an auto-generated placeholder. First call `set_title` once, then inspect/view/edit. Preserve and extend existing source unless the user explicitly asks for a rebuild.'
        : `This is an empty auto-named workspace. First call \`set_title\` once, then create ${DEFAULT_SOURCE_ENTRY} for visual/web work or the requested document file for document-first work. Use set_todos for multi-step work.`
      : sources.length > 0
        ? 'Before editing existing source files, inspect the workspace when available, then view the current source file. Use set_todos when the edit has multiple steps. Existing-source sequence: optional `set_todos` -> `inspect_workspace` when available -> `view` the source -> `str_replace`/`insert`. For continuation or existing-source turns, do not call `set_title`; preserve and extend the current design unless the user explicitly asks for a rebuild.'
        : `This is an empty workspace. For visual/web work, create ${DEFAULT_SOURCE_ENTRY} when the first pass is ready; for document-first work, create the requested document file. Use set_todos for multi-step work.`,
  );
  if (hasDesignMd) {
    lines.push(
      'DESIGN.md is present; read and preserve it as the design baton before changing visual tokens.',
    );
  } else if (sources.length > 0) {
    lines.push(
      'If stable visual decisions emerge across screens, reference-driven work, componentization, or prototype work, create or update a minimal DESIGN.md.',
    );
  }
  if (hasReferenceMaterials) {
    lines.push(
      'Reference materials are available; extract design cues before writing or editing source.',
    );
  }
  return lines.join('\n');