autark-cli 0.4.1 → 0.4.2

package/autark.mjs

@@ -990,9 +990,10 @@ async function mailSend(rest) {
   rejectUnsendableAddress(to)
   const subject = opts.subject || ''
   const body = mailBody(opts, { to, subject })
+  const anchor = readAnchorOpts(opts)
   const dryRun = opts['dry-run'] === true || opts.dry_run === true
   if (dryRun) {
-    printJson({ dry_run: true, would_send: { inbox: creds.inboxId, to, subject, body } })
+    printJson({ dry_run: true, would_send: { inbox: creds.inboxId, to, subject, body, anchor } })
     return
   }
   const result = await agentmailRequest('POST', `/inboxes/${encodeURIComponent(creds.inboxId)}/messages/send`, body)
@@ -1002,10 +1003,30 @@ async function mailSend(rest) {
     recipient: to.join(','),
     subject,
     response: result,
+    metadata: anchor ? { anchor_quote: anchor.quote, anchor_url: anchor.url } : {},
   })
   printJson({ ...result, autark_action_id: action?.id })
 }
 
+// Optional anchor-quote primitive. The cold-outreach skill recommends that
+// every send carry a verbatim quote from the recipient's public surface
+// (HN comment, GitHub issue, tweet) plus the URL it was lifted from. The
+// CLI doesn't (yet) enforce — when both are present they're validated and
+// logged into the action's metadata; when absent the send still goes
+// through. Flip to required once the prompt-side discipline catches up.
+function readAnchorOpts(opts) {
+  let quote = opts['anchor-quote'] || opts.anchor_quote
+  const url = opts['anchor-url'] || opts.anchor_url
+  if (quote && String(quote).startsWith('@')) {
+    quote = fs.readFileSync(String(quote).slice(1), 'utf8').trim()
+  }
+  if (!quote && !url) return null
+  if (!quote || !url) throw new Error('--anchor-quote and --anchor-url must both be provided (or both omitted)')
+  if (String(quote).length < 30) throw new Error(`--anchor-quote too short (${String(quote).length} chars); need >=30 chars of verbatim recipient text`)
+  if (!/^https?:\/\//.test(String(url))) throw new Error(`--anchor-url must be a full URL, got: ${url}`)
+  return { quote: String(quote).trim(), url: String(url).trim() }
+}
+
 async function mailReply(rest, mode) {
   const opts = parseArgs(rest)
   const creds = requireAgentmailCredentials()
@@ -1404,6 +1425,7 @@ function mailUsage() {
 
   setup       --prefix <name> [--force]
   send        --to <email[,email]> --subject <s> --text @body.txt [--run-id <id>] [--dry-run]
+              [--anchor-quote @./q.txt --anchor-url <url>]   record the recipient's verbatim public quote
   reply       --message-id <id> --text @reply.txt [--run-id <id>]
   reply-all   --message-id <id> --text @reply.txt [--run-id <id>]
   forward     --message-id <id> --to <email> [--text @body.txt] [--run-id <id>]

package/package.json

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