acdev 1.0.15 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acdev",
-  "version": "1.0.15",
+  "version": "1.1.0",
   "description": "Local CLI + web UI for running AI agents on GitHub issues via git worktrees",
   "type": "module",
   "bin": {

package/public/app.js

@@ -240,6 +240,7 @@ const els = {
   overviewTicketSource: document.getElementById('overview-ticket-source'),
   enqueueFeedback: document.getElementById('enqueue-feedback'),
   preferredBranch: document.getElementById('preferred-branch'),
+  enqueueUserPrompt: document.getElementById('enqueue-user-prompt'),
   addBtn: document.getElementById('add-btn'),
   statsGrid: document.getElementById('stats-grid'),
   overviewRunning: document.getElementById('overview-running'),
@@ -301,6 +302,8 @@ const els = {
   settingsModelValue: document.getElementById('settings-model-value'),
   settingsModelPanel: document.getElementById('settings-model-panel'),
   settingsModelList: document.getElementById('settings-model-list'),
+  settingsModelSearch: document.getElementById('settings-model-search'),
+  settingsModelHint: document.getElementById('settings-model-hint'),
   reviewPrLink: document.getElementById('review-pr-link'),
   reviewPrStatusLine: document.getElementById('review-pr-status-line'),
   reviewPrStatusNotes: document.getElementById('review-pr-status-notes'),
@@ -308,6 +311,10 @@ const els = {
   reviewTerminalMessage: document.getElementById('review-terminal-message'),
   reviewRetryBtn: document.getElementById('review-retry-btn'),
   settingsTools: document.getElementById('settings-tools'),
+  settingsMaxTurns: document.getElementById('settings-max-turns'),
+  settingsTimeout: document.getElementById('settings-timeout'),
+  settingsTimeoutMs: document.getElementById('settings-timeout-ms'),
+  settingsTestCommand: document.getElementById('settings-test-command'),
   settingsFeedback: document.getElementById('settings-feedback'),
   settingsSaveBtn: document.getElementById('settings-save-btn'),
   settingsTicketSource: document.getElementById('settings-ticket-source'),
@@ -1051,6 +1058,148 @@ function sortedJobs() {
   );
 }
 
+/**
+ * @param {string} raw
+ * @returns {string}
+ */
+function escapeHtml(raw) {
+  return String(raw)
+    .replaceAll('&', '&')
+    .replaceAll('<', '&lt;')
+    .replaceAll('>', '&gt;')
+    .replaceAll('"', '&quot;')
+    .replaceAll("'", '&#39;');
+}
+
+/**
+ * @param {string} raw
+ * @returns {string | null}
+ */
+function safeMarkdownHref(raw) {
+  const href = String(raw || '').trim();
+  if (!href) return null;
+  if (href.startsWith('#') || href.startsWith('/')) return href;
+  try {
+    const url = new URL(href, window.location.href);
+    return ['http:', 'https:', 'mailto:'].includes(url.protocol) ? url.href : null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * @param {string} raw
+ * @returns {string}
+ */
+function renderInlineMarkdown(raw) {
+  const stash = [];
+  const hold = (html) => `\u0000${stash.push(html) - 1}\u0000`;
+  let out = escapeHtml(raw);
+  out = out.replace(/`([^`]+)`/g, (_, code) => hold(`<code>${code}</code>`));
+  out = out.replace(/\*\*([^*]+)\*\*/g, (_, body) => hold(`<strong>${body}</strong>`));
+  out = out.replace(/__([^_]+)__/g, (_, body) => hold(`<strong>${body}</strong>`));
+  out = out.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_, label, href) => {
+    const safe = safeMarkdownHref(href);
+    if (!safe) return label;
+    return hold(
+      `<a href="${escapeHtml(safe)}" target="_blank" rel="noopener noreferrer">${label}</a>`
+    );
+  });
+  return out.replace(/\u0000(\d+)\u0000/g, (_, idx) => stash[Number(idx)] || '');
+}
+
+/**
+ * @param {HTMLElement | null} container
+ * @param {string} raw
+ */
+function renderMarkdownBlock(container, raw) {
+  if (!container) return;
+  container.innerHTML = '';
+  const text = String(raw || '').replace(/\r\n/g, '\n').trim();
+  if (!text) return;
+
+  const lines = text.split('\n');
+  let paragraph = [];
+  let listEl = null;
+  let listType = '';
+
+  const flushParagraph = () => {
+    if (!paragraph.length) return;
+    const p = document.createElement('p');
+    p.innerHTML = renderInlineMarkdown(paragraph.join(' '));
+    container.appendChild(p);
+    paragraph = [];
+  };
+
+  const flushList = () => {
+    if (!listEl) return;
+    container.appendChild(listEl);
+    listEl = null;
+    listType = '';
+  };
+
+  for (let i = 0; i < lines.length; i += 1) {
+    const line = lines[i];
+    if (!line.trim()) {
+      flushParagraph();
+      flushList();
+      continue;
+    }
+
+    const fence = line.match(/^```([\w-]+)?\s*$/);
+    if (fence) {
+      flushParagraph();
+      flushList();
+      const codeLines = [];
+      for (i += 1; i < lines.length; i += 1) {
+        if (/^```\s*$/.test(lines[i])) break;
+        codeLines.push(lines[i]);
+      }
+      const pre = document.createElement('pre');
+      pre.className = 'markdown-code';
+      const code = document.createElement('code');
+      if (fence[1]) code.dataset.language = fence[1];
+      code.textContent = codeLines.join('\n');
+      pre.appendChild(code);
+      container.appendChild(pre);
+      continue;
+    }
+
+    const heading = line.match(/^(#{1,6})\s+(.*)$/);
+    if (heading) {
+      flushParagraph();
+      flushList();
+      const tag = `h${heading[1].length}`;
+      const el = document.createElement(tag);
+      el.className = `markdown-heading markdown-heading-${heading[1].length}`;
+      el.innerHTML = renderInlineMarkdown(heading[2]);
+      container.appendChild(el);
+      continue;
+    }
+
+    const bullet = line.match(/^\s*([-*+])\s+(.*)$/);
+    const ordered = line.match(/^\s*\d+\.\s+(.*)$/);
+    if (bullet || ordered) {
+      flushParagraph();
+      const type = bullet ? 'ul' : 'ol';
+      if (!listEl || listType !== type) {
+        flushList();
+        listEl = document.createElement(type);
+        listType = type;
+      }
+      const li = document.createElement('li');
+      li.innerHTML = renderInlineMarkdown((bullet || ordered)[2] || (bullet || ordered)[1] || '');
+      listEl.appendChild(li);
+      continue;
+    }
+
+    paragraph.push(line.trim());
+  }
+
+  flushParagraph();
+  flushList();
+}
+
 /**
  * @param {HTMLElement | null} container
  * @param {object | null | undefined} pr
@@ -1089,8 +1238,8 @@ function renderPrStatusNotes(container, pr) {
 
       if (review.body) {
         const body = document.createElement('div');
-        body.className = 'pr-status-note-body';
-        body.textContent = review.body;
+        body.className = 'pr-status-note-body markdown-view';
+        renderMarkdownBlock(body, review.body);
         item.appendChild(body);
       }
 
@@ -1107,6 +1256,10 @@ function renderPrStatusNotes(container, pr) {
     container.appendChild(requested);
   }
 }
+if (typeof window !== 'undefined') {
+  window.__acdevMarkdownRender = renderMarkdownBlock;
+  window.__acdevMarkdownInline = renderInlineMarkdown;
+}
 function formatTime(ts) {
   try {
     return new Date(ts).toLocaleTimeString([], {
@@ -1771,8 +1924,8 @@ function renderDiff(diff, opts = {}) {
       const chip = document.createElement('div');
       chip.className = 'diff-pending-chip';
       const body = document.createElement('div');
-      body.className = 'diff-pending-chip-body';
-      body.textContent = c.body;
+      body.className = 'diff-pending-chip-body markdown-view';
+      renderMarkdownBlock(body, c.body);
       const actions = document.createElement('div');
       actions.className = 'diff-pending-chip-actions';
       const edit = document.createElement('button');
@@ -1922,8 +2075,7 @@ function renderDiff(diff, opts = {}) {
       }
       continue;
     }
-
-    if (line.startsWith('@@')) {
+    if (line.startsWith('@@ ')) {
       const m = line.match(/@@ -(\d+)(?:,\d+)? \+(\d+)(?:,\d+)? @@/);
       if (m) {
         leftNo = Number(m[1]);
@@ -2065,8 +2217,8 @@ function renderPendingCommentList(jobId) {
     }
 
     const body = document.createElement('div');
-    body.className = 'review-pending-item-body';
-    body.textContent = c.body;
+    body.className = 'review-pending-item-body markdown-view';
+    renderMarkdownBlock(body, c.body);
     main.appendChild(body);
     const actions = document.createElement('div');
     actions.className = 'review-pending-item-actions';
@@ -4998,6 +5150,7 @@ els.addBtn.addEventListener('click', async () => {
 
   const urls = splitIssueUrls(text);
   const branchName = els.preferredBranch?.value?.trim() || '';
+  const userPrompt = els.enqueueUserPrompt?.value?.trim() || '';
 
   try {
     const res = await fetch('/api/issues', {
@@ -5007,6 +5160,7 @@ els.addBtn.addEventListener('click', async () => {
         urls,
         ticketSource,
         ...(branchName ? { branchName } : {}),
+        ...(userPrompt ? { userPrompt } : {}),
       }),
     });
     const data = await res.json();
@@ -5019,6 +5173,7 @@ els.addBtn.addEventListener('click', async () => {
     }
     els.issueUrls.value = '';
     if (els.preferredBranch) els.preferredBranch.value = '';
+    if (els.enqueueUserPrompt) els.enqueueUserPrompt.value = '';
     const parts = [];
     if (data.jobs?.length) parts.push(`Added ${data.jobs.length}`);
     if (data.skipped?.length) {

package/public/index.html

@@ -156,6 +156,22 @@
                   </p>
                 </div>
 
+                <div class="enqueue-branch-field">
+                  <div class="enqueue-branch-label-row">
+                    <label class="field-label" for="enqueue-user-prompt">Additional instructions</label>
+                    <span class="enqueue-branch-optional">Optional</span>
+                  </div>
+                  <textarea
+                    id="enqueue-user-prompt"
+                    class="input textarea enqueue-textarea"
+                    rows="3"
+                    placeholder="Anything specific you want the agent to know or do…"
+                  ></textarea>
+                  <p class="enqueue-input-hint">
+                    Appended to the agent's instructions for these tickets. Leave empty to use the issue content only.
+                  </p>
+                </div>
+
                 <div class="enqueue-info-banner" id="enqueue-info-banner" role="note">
                   <svg class="enqueue-info-icon" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
                     <circle cx="12" cy="12" r="10"/>

package/public/styles.css

@@ -1620,15 +1620,67 @@ a { color: var(--primary); text-underline-offset: 3px; }
   background: var(--surface-2);
 }
 
-.pr-status-note-meta {
+.markdown-view {
+  line-height: 1.45;
+  word-break: break-word;
+}
+
+.markdown-view > :first-child {
+  margin-top: 0;
+}
+
+.markdown-view > :last-child {
+  margin-bottom: 0;
+}
+
+.markdown-view p,
+.markdown-view ul,
+.markdown-view ol,
+.markdown-view pre,
+.markdown-view blockquote,
+.markdown-view h1,
+.markdown-view h2,
+.markdown-view h3,
+.markdown-view h4,
+.markdown-view h5,
+.markdown-view h6 {
+  margin: 0 0 8px;
+}
+
+.markdown-view ul,
+.markdown-view ol {
+  padding-left: 20px;
+}
+
+.markdown-view code {
+  font-family: "JetBrains Mono", ui-monospace, monospace;
   font-size: 12px;
-  color: var(--text-muted);
-  margin-bottom: 4px;
+  padding: 1px 4px;
+  background: var(--bg);
+  border-radius: 4px;
+}
+
+.markdown-view pre {
+  margin: 0 0 8px;
+  padding: 8px 10px;
+  background: var(--bg);
+  border: 1px solid var(--border-soft);
+  border-radius: 8px;
+  overflow-x: auto;
+}
+
+.markdown-view pre code {
+  padding: 0;
+  background: transparent;
+}
+
+.markdown-view a {
+  color: var(--primary);
+  text-decoration: underline;
 }
 
 .pr-status-note-body {
-  white-space: pre-wrap;
-  line-height: 1.45;
+  font-size: 13px;
 }
 
 /* —— Review file selection —— */
@@ -1943,7 +1995,7 @@ body.diff-fs-open {
 
 .diff-pending-chip-body {
   color: var(--text);
-  white-space: pre-wrap;
+  font-size: 12px;
 }
 
 .diff-pending-chip-actions {
@@ -1953,6 +2005,10 @@ body.diff-fs-open {
   flex-wrap: wrap;
 }
 
+.review-pending-item-body {
+  font-size: 13px;
+}
+
 .review-pending-list {
   display: flex;
   flex-direction: column;

package/src/agent.js

@@ -89,6 +89,7 @@ export function stripAiAttribution(text) {
  *     comments?: Array<{ author: string, body: string }>,
  *   },
  *   jiraPrLinkPhrase?: string,
+ *   userPrompt?: string,
  * }} [context]
  */
 export function buildPrompt(issueUrl, config, context = {}) {
@@ -163,6 +164,14 @@ export function buildPrompt(issueUrl, config, context = {}) {
     );
   }
 
+  if (context.userPrompt && context.userPrompt.trim()) {
+    parts.push(
+      '',
+      'Additional instructions from the user (optional — follow them unless they conflict with the rules above):',
+      context.userPrompt.trim()
+    );
+  }
+
   // Drop empty strings from optional browse URL line
   const cleaned = parts.filter((p) => p !== '');
 
@@ -579,6 +588,7 @@ function stubAgentResult(onEvent, title, body) {
  *   ticketSource?: 'github' | 'jira',
  *   jiraKey?: string,
  *   jiraIssue?: object,
+ *   userPrompt?: string,
  *   queryFn?: typeof query,
  *   callModelFn?: (args: object) => object,
  * }} params
@@ -594,6 +604,7 @@ export async function runAgentOnIssue({
   ticketSource,
   jiraKey,
   jiraIssue,
+  userPrompt,
   queryFn = query,
   callModelFn,
 }) {
@@ -613,6 +624,7 @@ export async function runAgentOnIssue({
     jiraKey,
     jiraIssue,
     jiraPrLinkPhrase: config.jiraPrLinkPhrase,
+    userPrompt,
   });
 
   const { resultText, meta, usage } = await runConfiguredQuery({

package/src/server.js

@@ -68,6 +68,9 @@ const CLEARABLE_STATUSES = new Set([
   'failed',
 ]);
 
+/** Max length for optional user-supplied prompt appended to the agent instructions. */
+const USER_PROMPT_MAX_LEN = 4000;
+
 /**
  * Worktree directory id: Jira key or GitHub issue number.
  * @param {{ jiraKey?: string, issueNumber?: number }} job
@@ -471,6 +474,7 @@ export function createServer({ repoRoot, config, store, useStubAgent = false, de
         ticketSource: isJira ? 'jira' : 'github',
         jiraKey: job.jiraKey,
         jiraIssue,
+        userPrompt: job.userPrompt,
       });
 
       if (!store.getJob(jobId)) return;
@@ -833,6 +837,17 @@ export function createServer({ repoRoot, config, store, useStubAgent = false, de
       }
       const preferredBranchName = preferredParsed.value;
 
+      const rawUserPrompt = req.body?.userPrompt;
+      if (rawUserPrompt != null && typeof rawUserPrompt !== 'string') {
+        return res.status(400).json({ error: 'userPrompt must be a string' });
+      }
+      const userPrompt = typeof rawUserPrompt === 'string' ? rawUserPrompt.trim() : '';
+      if (userPrompt.length > USER_PROMPT_MAX_LEN) {
+        return res.status(400).json({
+          error: `userPrompt must be ${USER_PROMPT_MAX_LEN} characters or fewer.`,
+        });
+      }
+
       const ticketSource =
         req.body?.ticketSource === 'jira' || req.body?.ticketSource === 'github'
           ? req.body.ticketSource
@@ -929,6 +944,7 @@ export function createServer({ repoRoot, config, store, useStubAgent = false, de
           ticketSource: item.ticketSource,
           jiraKey: item.jiraKey,
           ...(preferredBranchName ? { preferredBranchName } : {}),
+          ...(userPrompt ? { userPrompt } : {}),
           llmProvider: llm.llmProvider,
           model: llm.model,
         });

package/src/store.js

@@ -53,19 +53,21 @@ export class Store {
    * @param {{
    *   issueUrl: string,
    *   issueNumber?: number,
- *   ticketSource?: 'github' | 'jira',
- *   jiraKey?: string,
- *   preferredBranchName?: string,
- *   llmProvider?: 'claude' | 'openrouter',
- *   model?: string,
- * }} data
- * @returns {Job}
- */
+   *   ticketSource?: 'github' | 'jira',
+   *   jiraKey?: string,
+   *   preferredBranchName?: string,
+   *   llmProvider?: 'claude' | 'openrouter',
+   *   model?: string,
+   *   userPrompt?: string,
+   * }} data
+   * @returns {Job}
+   */
   addJob(data) {
     const now = new Date().toISOString();
     const ticketSource = data.ticketSource === 'jira' ? 'jira' : 'github';
     const llmProvider = data.llmProvider === 'openrouter' ? 'openrouter' : 'claude';
     const model = typeof data.model === 'string' ? data.model.trim() : '';
+    const userPrompt = typeof data.userPrompt === 'string' ? data.userPrompt.trim() : '';
     /** @type {Job} */
     const job = {
       id: randomUUID(),
@@ -76,6 +78,7 @@ export class Store {
       ...(model ? { model } : {}),
       ...(data.jiraKey ? { jiraKey: data.jiraKey } : {}),
       ...(data.preferredBranchName ? { preferredBranchName: data.preferredBranchName } : {}),
+      ...(userPrompt ? { userPrompt } : {}),
       status: 'queued',
       createdAt: now,
       updatedAt: now,