autark-cli 0.5.6 → 0.5.8

package/autark.mjs

@@ -25,7 +25,23 @@ const RAW_RUNTIME_BASE = process.env.AUTARK_RUNTIME_RAW_BASE
   || 'https://autark.sh/runtime'
 const SKILL_NAMES = ['autark', 'plumcake', 'chrome-relay', 'email', 'outreach', 'email-finder']
 const ECOSYSTEM_CLIS = ['autark-cli', 'plumcake-cli', 'chrome-relay']
-const PROGRAM_FILES = ['start.md', 'double-down.md', 'check.md', 'followup.md']
+const PROGRAM_FILES = ['start.md', 'find_leads.md', 'double-down.md', 'check.md', 'followup.md']
+const LEAD_TEMPLATE = {
+  person: {
+    full_name: 'Itay Rosen',
+    primary_email: 'itay@example.com',
+    email_status: 'guessed',
+    handles: {
+      github: 'itayrosen',
+      twitter: 'itayrosen',
+    },
+    headline: 'Maintainer of parallel-browser-mcp',
+    source: 'github',
+  },
+  lead: {
+    angle: 'Maintains a browser automation MCP project, so he is likely to care about real-browser access for agents.',
+  },
+}
 
 // ============================================================ address reject
 // Two address shapes are bad enough to refuse at the CLI boundary, regardless
@@ -208,6 +224,11 @@ async function main() {
     if (command === 'unpause') return hypothesisPause(rest, 'active')
     if (!command || command === '--help' || command === '-h') return hypothesisUsage()
   }
+  if (group === 'lead') {
+    if (command === 'add')      return leadAdd(rest)
+    if (command === 'template') return leadTemplate()
+    if (!command || command === 'help' || command === '--help' || command === '-h') return leadUsage()
+  }
   if (group === 'run') {
     if (command === 'start')  return runStart(rest)
     if (command === 'finish') return runFinish(rest)
@@ -655,6 +676,69 @@ async function hypothesisStatus(rest) {
   console.log(`${label} → ${result.status}`)
 }
 
+// =============================================================== v2 leads
+
+async function leadAdd(rest) {
+  const opts = parseArgs(rest)
+  const payload = parseJsonValue(readValue(required(opts.input, '--input @lead.json')), '--input')
+  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) throw new Error('--input must be a JSON object')
+  if (!payload.lead || typeof payload.lead !== 'object' || !String(payload.lead.angle || '').trim()) {
+    throw new Error('lead.angle is required in --input JSON')
+  }
+
+  let hypId = opts['hypothesis-id'] || opts.hypothesis_id
+  if (!hypId) {
+    const ref = opts.hypothesis || opts._[0]
+    if (ref) {
+      const [productSlug, code] = splitHypothesisRef(ref)
+      const ctx = await api('GET', `/v1/context/${encodeURIComponent(productSlug)}/${encodeURIComponent(code)}`)
+      hypId = ctx.hypothesis?.id
+    }
+  }
+  if (!hypId) throw new Error('pass --hypothesis-id <id> or --hypothesis <slug/Hxx>')
+
+  const body = {
+    ...payload,
+    source_run_id: opts['run-id'] || opts.run_id || opts.run || payload.source_run_id || undefined,
+  }
+  const result = await api('POST', `/v1/hypotheses/${encodeURIComponent(hypId)}/leads`, body)
+  console.log(JSON.stringify(result))
+}
+
+function leadTemplate() {
+  printJson(LEAD_TEMPLATE)
+}
+
+function leadUsage() {
+  console.log(`autark lead
+
+  template
+      print a minimal JSON payload for lead add
+
+  add --hypothesis-id <id> --input @/tmp/lead.json [--run-id <id>]
+  add --hypothesis <slug>/<H01> --input @/tmp/lead.json [--run-id <id>]
+
+lead add records one sourced lead: person identity + the angle connecting that
+person to the hypothesis. It sends one ID-first request to the worker and
+prints exactly one compact JSON object to stdout:
+
+  {"person_id":"...","lead_id":"...","person_existed":false,"lead_existed":false}
+
+Minimum payload:
+
+${JSON.stringify(LEAD_TEMPLATE, null, 2)}
+
+Required:
+  - lead.angle
+  - enough person identity to dedupe: primary_email, a supported handle, or full_name
+
+Optional person fields:
+  email_status, headline, source, bio, signals
+
+find_leads should write /tmp/lead-N.json and call lead add with --input @file.
+No outreach is sent and no touch rows are written.`)
+}
+
 // =============================================================== runs
 
 async function runStart(rest) {
@@ -776,15 +860,31 @@ async function hypothesisPause(rest, status) {
 async function feedbackRecord(rest) {
   const opts = parseArgs(rest)
   const ref = opts.hypothesis || opts._[0]
+  const text = readValue(required(opts.text || opts.message || opts.body, '--text "<feedback>"'))
+
+  // --product-id (or a bare product slug with no /Hxx) → product-level feedback.
+  const productId = opts['product-id'] || opts.product_id
+  const isProductSlug = ref && !opts['hypothesis-id'] && !opts.hypothesis_id && !/\/H\d{2}$/.test(ref)
+  if (productId || isProductSlug) {
+    let pid = productId
+    if (!pid) {
+      const ctx = await api('GET', `/v1/context/${encodeURIComponent(ref)}`)
+      pid = ctx.product?.id
+    }
+    if (!pid) throw new Error('product not found')
+    const result = await api('POST', `/v1/products/${encodeURIComponent(pid)}/feedback`, { text })
+    console.log(result.id)
+    return
+  }
+
   let hypId = opts['hypothesis-id'] || opts.hypothesis_id
   if (!hypId) {
-    if (!ref) throw new Error('pass product/Hxx or --hypothesis-id')
+    if (!ref) throw new Error('pass product, product/Hxx, --product-id, or --hypothesis-id')
     const [productSlug, code] = splitHypothesisRef(ref)
     const ctx = await api('GET', `/v1/context/${encodeURIComponent(productSlug)}/${encodeURIComponent(code)}`)
     hypId = ctx.hypothesis?.id
   }
   if (!hypId) throw new Error('hypothesis not found')
-  const text = readValue(required(opts.text || opts.message || opts.body, '--text "<feedback>"'))
   const body = { text }
   if (opts['action-id'] || opts.action_id) body.action_id = opts['action-id'] || opts.action_id
   const result = await api('POST', `/v1/hypotheses/${encodeURIComponent(hypId)}/feedback`, body)
@@ -799,7 +899,8 @@ async function feedbackDelete(rest) {
 }
 
 function feedbackUsage() {
-  console.log(`autark feedback record <product/Hxx> --text "<nudge>" [--action-id <id>]
+  console.log(`autark feedback record <product/Hxx> --text "<nudge>" [--action-id <id>]   per-hypothesis nudge
+autark feedback record <product>     --text "<nudge>"                     product-level note (any hypothesis)
 autark feedback delete <feedback-id>`)
 }
 
@@ -886,7 +987,16 @@ async function mailLint(rest) {
   const compoundQ = /\b(are|is|do|does|did|will|would|can|could|should|have|has)\b[^?]{0,200}\bor\b[^?]{0,200}\?/i
   if (compoundQ.test(body)) violations.push({ rule: 'compound-question', detail: 'a/b question with "or"', why: WHY['compound-question'] })
   const sigSplit = body.split(/\n\s*\n(?:best|thanks|cheers|—|-)[\s,]*\n/i)[0] || body
-  const len = sigSplit.trim().length
+  // Measure VISIBLE prose length, not raw markup. An <a href>/[text](url) signature
+  // anchor or any HTML wrapper must not eat into the 400-char content budget — only
+  // what the recipient actually reads counts.
+  const visibleText = sigSplit
+    .replace(/<a\b[^>]*>(.*?)<\/a>/gis, '$1')           // <a ...>Kushal</a> -> Kushal
+    .replace(/\[([^\]]+)\]\(\s*https?:\/\/[^)]+\)/g, '$1') // [Kushal](url) -> Kushal
+    .replace(/<[^>]+>/g, '')                             // drop remaining html tags
+    .replace(/\s+/g, ' ')                               // collapse whitespace
+    .trim()
+  const len = visibleText.length
   if (len > 400) violations.push({ rule: 'too-long', detail: `${len} chars`, why: WHY['too-long'] })
   const hasMdAnchor = /\[[^\]]+\]\(https?:\/\/[^)]+\)/.test(body)
   const hasHtmlAnchor = /<a\b[^>]*href\s*=\s*["']https?:\/\/[^"']+["'][^>]*>[^<]+<\/a>/i.test(body)
@@ -1188,6 +1298,17 @@ function printProductContext(r) {
   kv('product.url', r.product.url)
   kv('product.visibility', r.product.visibility)
   kv('product.hypothesis_count', (r.hypotheses || []).length)
+  kv('product.person_count', r.product.person_count || (r.people || []).length || 0)
+  kv('product.lead_count', r.product.lead_count || (r.leads || []).length || 0)
+  kv('product.ready_lead_count', r.product.ready_lead_count || (r.leads || []).filter((l) => l.status === 'ready').length || 0)
+  // Product-level operator feedback (newest first). Append-only + timestamped,
+  // so each entry is a distinct nudge — re-read these every run.
+  kv('product.feedback_count', (r.feedback || []).length)
+  for (const f of (r.feedback || [])) {
+    const shortF = String(f.id || '').slice(0, 8)
+    kv(`product.feedback.${shortF}.created_at`, f.created_at)
+    kv(`product.feedback.${shortF}.text`, f.text)
+  }
   for (const h of (r.hypotheses || [])) {
     kv(`hypothesis.${h.code}.id`, h.id)
     kv(`hypothesis.${h.code}.title`, h.title)
@@ -1195,6 +1316,8 @@ function printProductContext(r) {
     kv(`hypothesis.${h.code}.run_count`, h.run_count)
     kv(`hypothesis.${h.code}.action_count`, h.action_count)
     kv(`hypothesis.${h.code}.reply_count`, h.reply_count)
+    kv(`hypothesis.${h.code}.lead_count`, h.lead_count || (h.leads || []).length || 0)
+    kv(`hypothesis.${h.code}.ready_lead_count`, h.ready_lead_count || (h.leads || []).filter((l) => l.status === 'ready').length || 0)
     if (h.needs_human_count) kv(`hypothesis.${h.code}.needs_human_count`, h.needs_human_count)
     const actions = (h.runs || []).flatMap((run) => run.actions || [])
     const by = channelBreakdown(actions)
@@ -1203,12 +1326,29 @@ function printProductContext(r) {
       kv(`hypothesis.${h.code}.channel.${ch}.replied`, by[ch].replied)
     }
   }
+  for (const lead of (r.leads || [])) {
+    const shortL = actionShortId(lead.id)
+    kv(`lead.${shortL}.id`, lead.id)
+    kv(`lead.${shortL}.status`, lead.status)
+    kv(`lead.${shortL}.hypothesis_code`, lead.hypothesis_code)
+    kv(`lead.${shortL}.person_name`, lead.person?.full_name)
+    kv(`lead.${shortL}.person_email`, lead.person?.primary_email)
+    kv(`lead.${shortL}.headline`, lead.person?.headline)
+    kv(`lead.${shortL}.angle`, lead.angle)
+  }
   console.log('---')
   // ---- narrative ----
   console.log(`# ${r.product.slug} — ${r.product.name}\n`)
   if (r.product.tagline) console.log(`> ${r.product.tagline}\n`)
   console.log(`## Brief\n`)
   console.log(r.product.brief?.trim() || '(no brief set — owner can add one at https://autark.sh)')
+  if ((r.feedback || []).length > 0) {
+    console.log(`\n## Operator feedback (${r.feedback.length}) — product-level, newest first\n`)
+    console.log(`These are general operator nudges, not tied to one hypothesis. Treat the most recent as the freshest signal and let them re-shape your next move.\n`)
+    for (const f of r.feedback) {
+      console.log(`- (${f.created_at}) ${f.text}`)
+    }
+  }
   if (!r.hypotheses?.length) {
     console.log(`\n## Hypotheses\n\n(none yet — create one with: autark hypothesis create --product-id <product_id> --md @hyp.md)`)
   } else {
@@ -1220,7 +1360,18 @@ function printProductContext(r) {
         .map((ch) => `${ch} ${by[ch].replied}/${by[ch].sent}`)
         .join('  ')
       const tail = channelSummary ? `  — replies/sends by channel: ${channelSummary}` : ''
-      console.log(`- [${h.status}] ${h.code} — ${h.title}  (runs: ${h.run_count}, actions: ${h.action_count || 0}, replies: ${h.reply_count || 0})${tail}`)
+      console.log(`- [${h.status}] ${h.code} — ${h.title}  (runs: ${h.run_count}, actions: ${h.action_count || 0}, replies: ${h.reply_count || 0}, leads: ${h.lead_count || 0})${tail}`)
+    }
+  }
+  if (r.leads?.length) {
+    console.log(`\n## Recent leads (${r.leads.length})\n`)
+    for (const lead of r.leads) {
+      const person = lead.person || {}
+      const label = person.full_name || person.primary_email || Object.entries(person.handles || {})[0]?.join(':') || lead.person_id || 'unknown person'
+      const hyp = lead.hypothesis_code ? `${lead.hypothesis_code} ` : ''
+      const headline = person.headline ? ` — ${person.headline}` : ''
+      console.log(`- [${lead.status}] ${hyp}${label}${headline}`)
+      if (lead.angle) console.log(`  angle: ${lead.angle}`)
     }
   }
 }
@@ -1233,6 +1384,8 @@ function printHypothesisContext(result) {
   kv('hypothesis.code', result.hypothesis.code)
   kv('hypothesis.title', result.hypothesis.title)
   kv('hypothesis.status', result.hypothesis.status)
+  kv('hypothesis.lead_count', result.hypothesis.lead_count || (result.leads || []).length || 0)
+  kv('hypothesis.ready_lead_count', result.hypothesis.ready_lead_count || (result.leads || []).filter((l) => l.status === 'ready').length || 0)
   // Feedback — operator nudges left on this hypothesis, oldest first. The
   // worker returns them; previously the CLI silently dropped them, so agents
   // never saw the operator's running corrections. Now surface them up top
@@ -1256,9 +1409,11 @@ function printHypothesisContext(result) {
   }
   for (const run of (result.runs || [])) {
     const shortRun = actionShortId(run.id)
+    const runLeads = (result.leads || []).filter((l) => l.source_run_id === run.id)
     kv(`run.${shortRun}.id`, run.id)
     kv(`run.${shortRun}.run_number`, run.run_number)
     kv(`run.${shortRun}.started_at`, run.started_at)
+    kv(`run.${shortRun}.lead_count`, runLeads.length)
     if (run.finished_at) kv(`run.${shortRun}.finished_at`, run.finished_at)
     for (const a of (run.actions || [])) {
       const shortA = actionShortId(a.id)
@@ -1285,6 +1440,16 @@ function printHypothesisContext(result) {
       }
     }
   }
+  for (const lead of (result.leads || [])) {
+    const shortL = actionShortId(lead.id)
+    kv(`lead.${shortL}.id`, lead.id)
+    kv(`lead.${shortL}.status`, lead.status)
+    kv(`lead.${shortL}.source_run_id`, lead.source_run_id)
+    kv(`lead.${shortL}.person_name`, lead.person?.full_name)
+    kv(`lead.${shortL}.person_email`, lead.person?.primary_email)
+    kv(`lead.${shortL}.headline`, lead.person?.headline)
+    kv(`lead.${shortL}.angle`, lead.angle)
+  }
   console.log('---')
   // ---- narrative ----
   console.log(`# ${result.product.slug}/${result.hypothesis.code} — ${result.hypothesis.title}\n`)
@@ -1297,9 +1462,21 @@ function printHypothesisContext(result) {
       console.log(`- [${when}]${tag} ${f.text}`)
     }
   }
+  if (result.leads?.length) {
+    console.log(`\n\n## Leads (${result.leads.length})\n`)
+    for (const lead of result.leads) {
+      const person = lead.person || {}
+      const label = person.full_name || person.primary_email || Object.entries(person.handles || {})[0]?.join(':') || lead.person_id || 'unknown person'
+      const headline = person.headline ? ` — ${person.headline}` : ''
+      const runTag = lead.source_run_id ? `  (run ${actionShortId(lead.source_run_id)})` : ''
+      console.log(`- [${lead.status}] ${label}${headline}${runTag}`)
+      if (lead.angle) console.log(`  angle: ${lead.angle}`)
+    }
+  }
   for (const run of (result.runs || [])) {
+    const runLeads = (result.leads || []).filter((l) => l.source_run_id === run.id)
     console.log(`\n\n## Run ${run.run_number}  (${run.id})`)
-    console.log(`started: ${run.started_at}${run.finished_at ? `   finished: ${run.finished_at}` : '   (in progress)'}`)
+    console.log(`started: ${run.started_at}${run.finished_at ? `   finished: ${run.finished_at}` : '   (in progress)'}${runLeads.length ? `   leads sourced: ${runLeads.length}` : ''}`)
     if (run.actions?.length) {
       console.log(`\nActions:`)
       for (const a of run.actions) {
@@ -1382,6 +1559,14 @@ function readValue(value) {
   return String(value)
 }
 
+function parseJsonValue(value, label = 'json') {
+  try {
+    return JSON.parse(value)
+  } catch (e) {
+    throw new Error(`${label} must be valid JSON: ${e.message}`)
+  }
+}
+
 function listOpt(value, label) {
   if (value === undefined || value === null || value === '') {
     if (label) throw new Error(`${label} is required`)
@@ -1468,10 +1653,11 @@ function usage() {
   product pause|unpause      stop / resume cron on a product
   hypothesis create|status   create or update hypotheses
   hypothesis pause|unpause   stop / resume work on a hypothesis
+  lead add|template          record sourced v2 leads
   run start|finish           start / finish a run
   log action                 record one outreach touch
   action escalate            flag an action for human attention
-  feedback record|delete     leave a free-text nudge on a hypothesis
+  feedback record|delete     leave a free-text nudge on a hypothesis or product
   context [<slug>|...]       pull product or hypothesis context
 
   mail setup|send|reply|...  send/read mail via your AgentMail inbox

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autark-cli",
-  "version": "0.5.6",
+  "version": "0.5.8",
   "description": "CLI for autark \u2014 hypothesis-driven product runbooks. Track products, hypotheses, runs, and actions from the terminal.",
   "type": "module",
   "license": "MIT",