autark-cli 0.1.3 → 0.1.4

package/README.md

@@ -20,26 +20,34 @@ autark login verify your@email.com --code 123456
 
 ## Use
 
+Autark is ID-first. Use `product list` / `context` to discover IDs, then pass IDs for writes. `slug/H01` remains a convenience alias.
+
 ```sh
 # products
-autark product upsert --slug chrome-relay --name "chrome-relay" --tagline "..."
-autark product list
+autark product upsert --slug chrome-relay --name "Chrome Relay" --tagline "..."
+autark product list   # prints slug, visibility, id, name
+autark context chrome-relay
+
+autark context --product-id <product_id>
 
 # hypotheses
-autark hypothesis create --product chrome-relay --code H01 --md @./H01.md --title "..."
-autark hypothesis status chrome-relay/H01 --status active   # active|inactive|dead
+autark hypothesis create --product-id <product_id> --md @./H01.md --code H01 --title "..."
+autark context --hypothesis-id <hypothesis_id>
+autark hypothesis status --hypothesis-id <hypothesis_id> --status active   # active|inactive|dead
+
+# aliases still work
+autark hypothesis create --product chrome-relay --md @./H01.md --code H01
+autark context chrome-relay/H01
+autark hypothesis status chrome-relay/H01 --status inactive
 
 # runs
-autark run start --hypothesis chrome-relay/H01
-autark run finish --run <run_id> --narrative @./narrative.md
+autark run start --hypothesis-id <hypothesis_id>
+autark run finish --run-id <run_id> --narrative @./narrative.md
 
 # actions (anything the agent did during a run)
-autark log action --run <run_id> --channel email --title "..." \
+autark log action --run-id <run_id> --channel email --title "..." \
   --recipient person@example.com --agentmail-thread-id <thread_id>
-autark log action --run <run_id> --channel github --title "..." --url https://github.com/...
-
-# context (full hypothesis state for an agent picking up work)
-autark context chrome-relay/H01
+autark log action --run-id <run_id> --channel github --title "..." --url https://github.com/...
 
 autark me
 autark logout
@@ -53,4 +61,4 @@ autark logout
 
 The CLI is a thin HTTP client over a Cloudflare Worker that holds the InstantDB admin token. Magic-link auth via InstantDB. Token saved to `~/.autark/credentials.json` after login.
 
-The web at autark.kushalsm.com is read-only. All writes (product, hypothesis, run, action) come through this CLI or future MCP server.
+The web at autark.kushalsm.com reads from InstantDB. Writes should go through the Worker/CLI path; dashboard direct writes are being phased out.

package/autark.mjs

@@ -4,10 +4,8 @@
 // Auth: magic-link flow saves a refresh_token to ~/.autark/credentials.json.
 // Every subsequent command sends it as `Authorization: Bearer <token>`.
 //
-// All business logic, schema knowledge, and InstantDB connectivity lives in
-// the Worker. The CLI is intentionally thin — it parses args, makes HTTP
-// calls, formats output. Replace this binary in any language tomorrow and
-// the system still works.
+// The CLI is ID-first: once a product/hypothesis/run exists, use its id.
+// slug/Hxx remains as a convenience alias for humans.
 
 import fs from 'node:fs'
 import os from 'node:os'
@@ -116,7 +114,7 @@ async function productList() {
     return
   }
   for (const p of result.products) {
-    console.log(`${(p.slug || '').padEnd(20)} ${(p.visibility || '').padEnd(8)} ${p.name || ''}`)
+    console.log(`${(p.slug || '').padEnd(20)} ${(p.visibility || '').padEnd(8)} ${(p.id || '').padEnd(36)} ${p.name || ''}`)
   }
 }
 
@@ -124,45 +122,65 @@ async function productList() {
 
 async function hypothesisCreate(rest) {
   const opts = parseArgs(rest)
-  const product = required(opts.product, '--product')
-  const code    = required(opts.code, '--code')
-  const md      = readValue(required(opts.md, '--md'))
-  const title   = opts.title
-  const result = await api('POST', '/v1/hypotheses', {
-    product, code, md,
-    title:  title || undefined,
+  const md = readValue(required(opts.md, '--md'))
+  const body = {
+    md,
+    code:   opts.code || undefined,
+    title:  opts.title || undefined,
     status: opts.status || undefined,
-  })
+  }
+
+  let result
+  if (opts['product-id'] || opts.product_id) {
+    const productId = opts['product-id'] || opts.product_id
+    result = await api('POST', `/v1/products/${encodeURIComponent(productId)}/hypotheses`, body)
+  } else {
+    body.product = required(opts.product, '--product or --product-id')
+    result = await api('POST', '/v1/hypotheses', body)
+  }
   console.log(result.id)
 }
 
 async function hypothesisStatus(rest) {
   const opts = parseArgs(rest)
-  const ref  = required(opts._[0] || opts.hypothesis, 'hypothesis (e.g. chrome-relay/H01)')
   const status = required(opts.status, '--status')
-  const [productSlug, code] = splitHypothesisRef(ref)
-  const ctx = await api('GET', `/v1/context/${encodeURIComponent(productSlug)}/${encodeURIComponent(code)}`)
-  const hypId = ctx.hypothesis?.id
-  if (!hypId) throw new Error(`hypothesis not found: ${ref}`)
-  const result = await api('PATCH', `/v1/hypotheses/${hypId}/status`, { status })
-  console.log(`${ref} → ${result.status}`)
+  let hypId = opts['hypothesis-id'] || opts.hypothesis_id || opts.id
+  let label = hypId
+
+  if (!hypId) {
+    const ref = required(opts._[0] || opts.hypothesis, 'hypothesis id or product/Hxx')
+    const [productSlug, code] = splitHypothesisRef(ref)
+    const ctx = await api('GET', `/v1/context/${encodeURIComponent(productSlug)}/${encodeURIComponent(code)}`)
+    hypId = ctx.hypothesis?.id
+    label = ref
+  }
+  if (!hypId) throw new Error('hypothesis not found')
+
+  const result = await api('PATCH', `/v1/hypotheses/${encodeURIComponent(hypId)}/status`, { status })
+  console.log(`${label} → ${result.status}`)
 }
 
 // =============================================================== runs
 
 async function runStart(rest) {
   const opts = parseArgs(rest)
-  const ref  = required(opts.hypothesis || opts._[0], '--hypothesis (e.g. chrome-relay/H01)')
-  const [productSlug, code] = splitHypothesisRef(ref)
-  const result = await api('POST', '/v1/runs', { product: productSlug, hypothesis: code })
+  let result
+  const hypId = opts['hypothesis-id'] || opts.hypothesis_id
+  if (hypId) {
+    result = await api('POST', `/v1/hypotheses/${encodeURIComponent(hypId)}/runs`, {})
+  } else {
+    const ref = required(opts.hypothesis || opts._[0], '--hypothesis-id <id> or --hypothesis <slug/Hxx>')
+    const [productSlug, code] = splitHypothesisRef(ref)
+    result = await api('POST', '/v1/runs', { product: productSlug, hypothesis: code })
+  }
   console.log(result.id)
 }
 
 async function runFinish(rest) {
   const opts = parseArgs(rest)
-  const id   = required(opts.run, '--run')
+  const id = required(opts['run-id'] || opts.run_id || opts.run, '--run-id')
   const narrative = readValue(required(opts.narrative, '--narrative'))
-  const result = await api('PATCH', `/v1/runs/${id}/finish`, { narrative_md: narrative })
+  const result = await api('PATCH', `/v1/runs/${encodeURIComponent(id)}/finish`, { narrative_md: narrative })
   console.log(`${result.id}  finished_at=${result.finished_at}`)
 }
 
@@ -170,11 +188,10 @@ async function runFinish(rest) {
 
 async function logAction(rest) {
   const opts = parseArgs(rest)
-  const run = required(opts.run, '--run')
+  const run = required(opts['run-id'] || opts.run_id || opts.run, '--run-id')
   const channel = required(opts.channel, '--channel')
   const title   = required(opts.title, '--title')
-  const result = await api('POST', '/v1/actions', {
-    run,
+  const result = await api('POST', `/v1/runs/${encodeURIComponent(run)}/actions`, {
     channel,
     title,
     url:                 opts.url || undefined,
@@ -190,32 +207,51 @@ async function logAction(rest) {
 
 async function context(rest) {
   const opts = parseArgs(rest)
-  const ref = required(opts._[0] || opts.hypothesis, 'product or hypothesis (e.g. chrome-relay or chrome-relay/H01)')
+
+  if (opts['product-id'] || opts.product_id) {
+    const productId = opts['product-id'] || opts.product_id
+    return printProductContext(await api('GET', `/v1/products/${encodeURIComponent(productId)}/context`))
+  }
+
+  if (opts['hypothesis-id'] || opts.hypothesis_id) {
+    const hypId = opts['hypothesis-id'] || opts.hypothesis_id
+    return printHypothesisContext(await api('GET', `/v1/hypotheses/${encodeURIComponent(hypId)}/context`))
+  }
+
+  const ref = required(opts._[0] || opts.hypothesis, 'product slug, product/Hxx, --product-id, or --hypothesis-id')
   const parts = ref.split('/')
   const productSlug = parts[0]
   const code = parts[1]
 
   if (!code) {
-    // product-level: brief + every hypothesis with status + counts
-    const r = await api('GET', `/v1/context/${encodeURIComponent(productSlug)}`)
-    console.log(`# ${r.product.slug} — ${r.product.name}`)
-    if (r.product.tagline) console.log(`> ${r.product.tagline}`)
-    if (r.product.url)     console.log(`> ${r.product.url}`)
-    console.log(`\n## Brief\n`)
-    console.log(r.product.brief?.trim() || '(no brief set — owner can add one at https://autark.kushalsm.com)')
-    console.log(`\n## Hypotheses (${r.hypotheses.length})\n`)
-    if (!r.hypotheses.length) {
-      console.log('(none yet — start with H01)')
-    } else {
-      for (const h of r.hypotheses) {
-        console.log(`- [${h.status}] ${h.code} — ${h.title}  (runs: ${h.run_count})`)
-      }
-    }
-    return
+    return printProductContext(await api('GET', `/v1/context/${encodeURIComponent(productSlug)}`))
   }
 
   const result = await api('GET', `/v1/context/${encodeURIComponent(productSlug)}/${encodeURIComponent(code)}`)
+  return printHypothesisContext(result)
+}
+
+function printProductContext(r) {
+  console.log(`# ${r.product.slug} — ${r.product.name}`)
+  console.log(`id: ${r.product.id}`)
+  if (r.product.tagline) console.log(`> ${r.product.tagline}`)
+  if (r.product.url)     console.log(`> ${r.product.url}`)
+  console.log(`\n## Brief\n`)
+  console.log(r.product.brief?.trim() || '(no brief set — owner can add one at https://autark.kushalsm.com)')
+  console.log(`\n## Hypotheses (${r.hypotheses.length})\n`)
+  if (!r.hypotheses.length) {
+    console.log('(none yet — create one with: autark hypothesis create --product-id <product_id> --md @hyp.md)')
+  } else {
+    for (const h of r.hypotheses) {
+      console.log(`- [${h.status}] ${h.code}  id=${h.id}  — ${h.title}  (runs: ${h.run_count})`)
+    }
+  }
+}
+
+function printHypothesisContext(result) {
   console.log(`# ${result.product.slug}/${result.hypothesis.code} — ${result.hypothesis.title}\n`)
+  console.log(`product_id: ${result.product.id}`)
+  console.log(`hypothesis_id: ${result.hypothesis.id}`)
   console.log(`Status: ${result.hypothesis.status}\n`)
   console.log(result.hypothesis.hypothesis_md)
   for (const run of result.runs) {
@@ -330,17 +366,23 @@ function usage() {
   autark me                                                show signed-in user
 
   autark product upsert --slug <slug> --name <name> [--url <url>] [--tagline <text>] [--brief @./brief.md] [--visibility private|public]
-  autark product list
+  autark product list                                      prints slug, visibility, id, name
 
-  autark hypothesis create --product <slug> --code H01 --md @./hypothesis.md [--title <t>]
-  autark hypothesis status <slug>/<H01> --status active|inactive|dead
+  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
 
-  autark run start --hypothesis <slug>/<H01>
-  autark run finish --run <id> --narrative @./run.md
+  autark run start --hypothesis-id <id>
+  autark run start --hypothesis <slug>/<H01>                                           # alias
+  autark run finish --run-id <id> --narrative @./run.md
 
-  autark log action --run <id> --channel <c> --title <t> [--url <u>]
+  autark log action --run-id <id> --channel <c> --title <t> [--url <u>]
                     [--agentmail-thread-id <uuid>] [--recipient <email>]
                     [--metadata @./meta.json]
 
+  autark context --product-id <id>
+  autark context --hypothesis-id <id>
+  autark context <slug>
   autark context <slug>/<H01>`)
 }

package/package.json

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