autark-cli 0.1.5 → 0.1.7

package/autark.mjs

@@ -12,7 +12,8 @@ import process from 'node:process'
 
 const API = process.env.AUTARK_API_URL || 'https://autark-api.kushalsokke.workers.dev'
 const AGENTMAIL_API = process.env.AGENTMAIL_API_URL || 'https://api.agentmail.to/v0'
-const CREDS_PATH = path.join(os.homedir(), '.autark', 'credentials.json')
+const AUTARK_HOME = process.env.AUTARK_HOME || path.join(os.homedir(), '.autark')
+const CREDS_PATH = process.env.AUTARK_CREDENTIALS || path.join(AUTARK_HOME, 'credentials.json')
 
 const args = process.argv.slice(2)
 main().catch(err => {
@@ -35,17 +36,26 @@ async function main() {
   if (group === 'product') {
     if (command === 'upsert') return productUpsert(rest)
     if (command === 'list')   return productList()
+    if (!command || command === '--help' || command === '-h') return productUsage()
   }
   if (group === 'hypothesis') {
     if (command === 'create') return hypothesisCreate(rest)
     if (command === 'status') return hypothesisStatus(rest)
+    if (!command || command === '--help' || command === '-h') return hypothesisUsage()
   }
   if (group === 'run') {
     if (command === 'start')  return runStart(rest)
     if (command === 'finish') return runFinish(rest)
+    if (!command || command === '--help' || command === '-h') return runUsage()
+  }
+  if (group === 'log') {
+    if (command === 'action') return logAction(rest)
+    if (!command || command === '--help' || command === '-h') return logUsage()
+  }
+  if (group === 'context') {
+    if (!command || command === '--help' || command === '-h') return contextUsage()
+    return context([command, ...rest].filter(Boolean))
   }
-  if (group === 'log' && command === 'action') return logAction(rest)
-  if (group === 'context') return context([command, ...rest].filter(Boolean))
   if (group === 'mail') return mail(command, rest)
 
   usage()
@@ -619,31 +629,80 @@ Mail uses the inbox-scoped token in ~/.autark/credentials.json.`)
 function usage() {
   console.log(`autark — agent runbook CLI
 
-  autark login send <email>                                send a magic code
-  autark login verify <email> --code <code>                complete login
-  autark logout                                            clear local credentials
-  autark me                                                show signed-in user
+  login send|verify          sign in / complete magic code
+  logout                     clear local credentials
+  me                         show signed-in user
+
+  product upsert|list        create/edit/list products
+  hypothesis create|status   create or update hypotheses
+  run start|finish           start / finish a run
+  log action                 record one outreach touch
+  context [<slug>|...]       pull product or hypothesis context
+
+  mail setup|send|reply|...  send/read mail via your AgentMail inbox
+
+For details on any group:  autark <group> --help
+Examples:                   autark product --help
+                            autark mail --help`)
+}
+
+function productUsage() {
+  console.log(`autark product
+
+  upsert --slug <slug> --name <name> [--url <url>] [--tagline <text>]
+         [--brief @./brief.md] [--visibility private|public]
+
+  list                       prints slug, visibility, id, name
+
+The brief is the markdown the agent reads at the top of every run
+to understand what the product is and who it might serve.`)
+}
 
-  autark product upsert --slug <slug> --name <name> [--url <url>] [--tagline <text>] [--brief @./brief.md] [--visibility private|public]
-  autark product list                                      prints slug, visibility, id, name
+function hypothesisUsage() {
+  console.log(`autark hypothesis
 
-  autark hypothesis create --product-id <id> --md @./hyp.md [--code H01] [--title <t>]
-  autark hypothesis create --product <slug> --md @./hyp.md [--code H01] [--title <t>]   # alias
-  autark hypothesis status --hypothesis-id <id> --status active|inactive|dead
-  autark hypothesis status <slug>/<H01> --status active|inactive|dead                  # alias
+  create --product-id <id>   --md @./hyp.md [--code H01] [--title <t>] [--status active|inactive|dead]
+  create --product <slug>    --md @./hyp.md [--code H01] [--title <t>]    # slug alias
 
-  autark run start --hypothesis-id <id>
-  autark run start --hypothesis <slug>/<H01>                                           # alias
-  autark run finish --run-id <id> --narrative @./run.md
+  status --hypothesis-id <id>      --status active|inactive|dead
+  status <slug>/<H01>              --status active|inactive|dead          # slug/code alias
+
+Hypotheses are frozen on create. Only --status changes after.
+If --code is omitted, autark picks the next H## for the product.`)
+}
+
+function runUsage() {
+  console.log(`autark run
+
+  start  --hypothesis-id <id>
+  start  --hypothesis <slug>/<H01>                                # slug/code alias
+         → prints RUN_ID to stdout
+
+  finish --run-id <id> --narrative @./run.md
+         → seals the run with the narrative blob`)
+}
+
+function logUsage() {
+  console.log(`autark log
+
+  action --run-id <id> --channel <c> --title <t>
+         [--url <u>]                          # github / reddit / hn / blog / gist / linkedin
+         [--agentmail-thread-id <uuid>]       # email
+         [--agentmail-inbox-id <email>]       # email — defaults to your inbox
+         [--recipient <email>]                # email
+         [--metadata @./meta.json]            # any channel-specific extras
+
+One row per external touch. Body content stays in AgentMail/GitHub/etc;
+this just records the pointer + the title agents see on the dashboard.`)
+}
 
-  autark log action --run-id <id> --channel <c> --title <t> [--url <u>]
-                    [--agentmail-thread-id <uuid>] [--agentmail-inbox-id <inbox>] [--recipient <email>]
-                    [--metadata @./meta.json]
+function contextUsage() {
+  console.log(`autark context
 
-  autark mail setup/send/reply/thread/messages/...       AgentMail via autark credentials
+  <slug>                     product brief + every hypothesis (active/inactive/dead)
+  <slug>/<H01>               one hypothesis: text + every run + every action
+  --product-id <id>          product brief + every hypothesis
+  --hypothesis-id <id>       one hypothesis: text + every run + every action
 
-  autark context --product-id <id>
-  autark context --hypothesis-id <id>
-  autark context <slug>
-  autark context <slug>/<H01>`)
+Use product-level first to pick which H## to drill into.`)
 }

package/package.json

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