autark-cli 0.5.7 → 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) {
@@ -1214,6 +1298,9 @@ 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)
@@ -1229,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)
@@ -1237,6 +1326,16 @@ 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`)
@@ -1261,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}`)
     }
   }
 }
@@ -1274,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
@@ -1297,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)
@@ -1326,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`)
@@ -1338,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) {
@@ -1423,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`)
@@ -1509,6 +1653,7 @@ 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autark-cli",
-  "version": "0.5.7",
+  "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",