@fnmoa/cli 0.2.5 → 0.4.0

package/dist/ui.js

@@ -1,56 +0,0 @@
-// Terminal formatting helpers (color-aware, respects NO_COLOR / non-TTY).
-const noColor = !!process.env.NO_COLOR || !process.stdout.isTTY;
-const wrap = (code) => (s) => (noColor ? `${s}` : `\x1b[${code}m${s}\x1b[0m`);
-export const c = {
-    dim: wrap('2'),
-    bold: wrap('1'),
-    green: wrap('32'),
-    red: wrap('31'),
-    yellow: wrap('33'),
-    cyan: wrap('36'),
-    amber: wrap('33'),
-};
-/** 256-color foreground (no-op when color is disabled). */
-const fg = (n) => (s) => (noColor ? s : `\x1b[38;5;${n}m${s}\x1b[0m`);
-// fnmoa wordmark in block letters, colored top→bottom as a cyan→blue gradient.
-const LOGO = [
-    '█████ █   █ █   █  ███   ███ ',
-    '█     ██  █ ██ ██ █   █ █   █',
-    '████  █ █ █ █ █ █ █   █ █████',
-    '█     █  ██ █   █ █   █ █   █',
-    '█     █   █ █   █  ███  █   █',
-];
-const LOGO_FG = [51, 45, 39, 33, 27];
-/** The fnmoa banner — wordmark + tagline, gradient-colored. */
-export function banner() {
-    const art = LOGO.map((line, i) => '  ' + fg(LOGO_FG[i])(line)).join('\n');
-    return `\n${art}\n  ${c.dim('autonomous GitHub coding workflows')}\n`;
-}
-export const statusColor = (s) => s === 'succeeded'
-    ? c.green(s)
-    : s === 'failed'
-        ? c.red(s)
-        : s === 'running' || s === 'queued'
-            ? c.yellow(s)
-            : c.dim(s);
-/** Relative time for list columns: "5s ago", "3m ago", "2h ago", "4d ago". */
-export function relTime(when) {
-    if (!when)
-        return '';
-    const t = new Date(when).getTime();
-    if (!Number.isFinite(t))
-        return '';
-    const s = Math.max(0, Math.floor((Date.now() - t) / 1000));
-    if (s < 60)
-        return `${s}s ago`;
-    if (s < 3600)
-        return `${Math.floor(s / 60)}m ago`;
-    if (s < 86400)
-        return `${Math.floor(s / 3600)}h ago`;
-    return `${Math.floor(s / 86400)}d ago`;
-}
-export function die(msg) {
-    console.error(c.red(`✗ ${msg}`));
-    process.exit(1);
-}
-//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"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"}

package/src/skills/moa-oracle/SKILL.md

@@ -1,35 +0,0 @@
----
-name: moa-oracle
-description: >-
-  Consult Moa's domain knowledge-base oracles — `moa oracle list` to see domains,
-  `moa oracle consult <domain> "<question>"` to ask, `moa oracle history` to review past
-  answers. Use to get a read-only answer sourced strictly from a specific knowledge base.
----
-
-# Consult Moa oracles
-
-An **oracle** is a read-only knowledge base. A `<domain>-oracle` subagent answers
-questions **only from that KB** — useful for grounded, source-bounded answers. Requires
-a connected CLI (see **moa-setup**).
-
-## Use
-
-```sh
-moa oracle list                                   # available domains
-moa oracle consult <domain> "<question>" --watch  # ask; --watch streams to the answer
-moa oracle history                                # past consultations (--limit N, --json)
-```
-
-Example:
-
-```sh
-moa oracle list
-moa oracle consult architecture "how do workflow runs isolate git worktrees?" --watch
-```
-
-## Notes
-
-- Answers are bounded to the KB — if the KB doesn't cover it, the oracle says so rather
-  than guessing.
-- `--watch` exits non-zero if the consultation fails.
-- `moa status` lists the oracle domains the server currently exposes.

package/src/skills/moa-profiles/SKILL.md

@@ -1,49 +0,0 @@
----
-name: moa-profiles
-description: >-
-  Act as multiple operators or orgs with Moa CLI profiles — `moa config add/use`, a
-  per-command `--profile` override, `$MOA_PROFILE`, and `moa whoami`. Use for
-  multi-operator review flows (solver ≠ reviewer) or driving several workspaces/orgs.
----
-
-# Multi-operator / multi-org profiles
-
-`~/.moa/cli.json` holds **named profiles** — each is one operator: a workspace URL + an
-API key. Profiles are how you run flows that need more than one identity (e.g. one
-operator solves, another reviews) or target multiple workspaces/orgs. Requires a
-connected CLI (see **moa-setup**).
-
-## Manage profiles
-
-```sh
-moa config add owner  --url <url> --key <ownerKey>  --label "owner"
-moa config add member --url <url> --key <memberKey> --label "member"
-moa config use member            # switch the active profile
-moa config                       # show active + list (● = active)
-moa config remove <name>
-```
-
-## Pick an identity per command
-
-```sh
-moa <cmd> --profile owner        # one-off override (no switch)
-MOA_PROFILE=owner moa <cmd>      # same, via env var
-moa whoami                       # who am I right now (+ GitHub login)
-```
-
-Precedence: `--profile <name>` → `$MOA_PROFILE` → active (`config use`) → `default`.
-
-## Why it matters
-
-- **Author ≠ reviewer:** GitHub blocks approving your own PR, so the realistic review
-  loop needs two operators:
-  ```sh
-  moa config use owner
-  moa wf solve <repo> <issue#> --watch
-  MOA_PROFILE=member moa wf review <repo> <pr#> --watch
-  moa wf merge <repo> <pr#> --watch
-  ```
-- **Multiple orgs/workspaces:** give each its own profile (distinct URL + key) and switch
-  with `moa config use`.
-
-Field precedence within a profile: `env ($MOA_API_URL / $MOA_API_KEY) → profile → default`.

package/src/skills/moa-review-pr/SKILL.md

@@ -1,47 +0,0 @@
----
-name: moa-review-pr
-description: >-
-  Review and unblock pull requests with Moa — `moa wf review` for a structured verdict,
-  `moa wf address` to apply review feedback, `moa wf fix-ci` to get red CI green, and
-  `moa wf review-fix` to converge to approval. Use to review a PR, address comments, or
-  fix failing checks.
----
-
-# Review & unblock PRs with Moa
-
-Requires a connected CLI (see **moa-setup**). Repos are `owner/repo`; add `--watch` to
-stream the timeline (exits non-zero on failure).
-
-## Review a PR
-
-```sh
-moa wf pending                          # your review inbox
-moa wf review <repo> <pr#> --watch       # → APPROVE / REQUEST_CHANGES + inline comments
-```
-
-The pipeline reconciles review state live from GitHub, so a review by **any** operator
-(or done directly on GitHub) advances the track — solver and reviewer needn't match.
-
-## Unblock a PR
-
-| Situation | Command | What it does |
-|---|---|---|
-| Reviewer asked for changes | `moa wf address <repo> <pr#>` | applies the feedback, pushes to the PR branch |
-| CI is red | `moa wf fix-ci <repo> <pr#>` | reads checks/logs, pushes a fix |
-| Want it to reach APPROVE | `moa wf review-fix <repo> <pr#>` | loops review → fix → re-review until approved |
-
-```sh
-moa wf fix-ci <repo> <pr#> --watch       # diagnose failing checks → push a fix
-moa wf address <repo> <pr#> --watch      # turn review comments into a commit
-moa wf review-fix <repo> <pr#> --watch   # converge to APPROVE + a fix commit
-```
-
-Then merge once approved + green (see **moa-ship-issue**): `moa wf merge <repo> <pr#> --watch`.
-
-## Notes
-
-- **Self-review:** GitHub won't let a PR's author approve/request-changes their own PR
-  (only comment). Review as a different operator — see **moa-profiles**.
-- **`address` vs `review-fix`:** `address` applies existing feedback once; `review-fix`
-  owns the whole review↔fix loop until it converges.
-- Inspect progress with `moa wf get <id> --watch`; failed checks and cost are shown there.

package/src/skills/moa-run-task/SKILL.md

@@ -1,44 +0,0 @@
----
-name: moa-run-task
-description: >-
-  Run an ad-hoc Moa agent task outside the GitHub workflow — `moa run "<prompt>" --dir
-  <path> --watch`, inspect with `moa task`, cancel a run, and track cost. Use for one-off
-  coding or analysis tasks not tied to an issue or PR.
----
-
-# Ad-hoc agent tasks with Moa
-
-For work that isn't an issue/PR workflow, run the agent directly. Tasks are async:
-`moa run` returns immediately as `queued`, then the run goes
-`queued → running → succeeded | failed | canceled`. Requires a connected CLI (see
-**moa-setup**).
-
-## Run
-
-```sh
-moa run "add a hello() to src/index.ts" --watch
-moa run "<prompt>" --dir /path/to/repo --watch     # run against a specific directory
-moa run "<prompt>" --autonomous --watch            # less interactive, more autonomy
-```
-
-`--watch` streams the live activity feed until the task finishes (and exits non-zero
-if it fails).
-
-## Inspect & manage
-
-```sh
-moa tasks                  # recent tasks (--limit N, default 30; --json for raw)
-moa task <id>              # one task: result, sessionId, numTurns, costUsd
-moa task <id> --json       # raw API response
-moa cancel <taskId>        # kill a running task (cancels its claude child)
-```
-
-`moa task <id>` accepts a unique id prefix.
-
-## Notes
-
-- Each task is one `claude` child process; **cancel** kills it.
-- Cost: every finished task reports `costUsd`; `moa status --spend` shows the cumulative
-  total for the operator.
-- For GitHub-driven work (issue→PR, review, fix-CI, merge), use the workflow skills:
-  **moa-ship-issue** and **moa-review-pr**.

package/src/skills/moa-setup/SKILL.md

@@ -1,60 +0,0 @@
----
-name: moa-setup
-description: >-
-  Install and connect the `moa` CLI (@fnmoa/cli) to a Moa workspace — npm install,
-  `moa login`, verify the Claude/GitHub connectors, and run a first status check.
-  Use when setting up Moa for the first time, moving to a new machine, or
-  troubleshooting auth errors like "auto-bootstrap is unavailable".
----
-
-# Setting up the `moa` CLI
-
-`moa` is a terminal client for a Moa **workspace** (an HTTP API). It authenticates
-with an `x-api-key` and defaults to `https://api.fnmoa.com`.
-
-## 1. Install
-
-```sh
-npm i -g @fnmoa/cli
-moa --help
-```
-
-## 2. Connect
-
-```sh
-moa login          # interactive: server URL (default api.fnmoa.com) + API key
-```
-
-`moa login` also starts automatically the first time you run bare `moa` with no
-config. It saves to `~/.moa/cli.json` and verifies the key against the server. Grab
-your API key from the Moa dashboard.
-
-Non-interactive equivalent (CI, scripts):
-
-```sh
-moa config set url https://api.fnmoa.com
-moa config set key <api-key>
-# or per-shell: export MOA_API_URL=… MOA_API_KEY=…
-```
-
-## 3. Verify
-
-```sh
-moa whoami         # which operator am I (+ GitHub login)
-moa setup          # connector status: claude (connected?) · github (@login?)
-moa status         # server snapshot: oracles, task/session counts, queue
-```
-
-## Troubleshooting
-
-- **`auto-bootstrap is unavailable … (enrolled to a control-plane)`** — the workspace
-  requires a pre-issued key. Run `moa login` (or `moa config set key <key>`); the key
-  comes from the dashboard, not auto-bootstrap.
-- **`cannot reach <url>`** — wrong URL or server down. Re-check with `moa config`, fix
-  with `moa config set url <url>`.
-- **`key rejected`** — the key is wrong/expired; re-run `moa login` with a fresh key.
-- **Connectors not connected** (`moa setup` shows red) — connect Claude/GitHub from the
-  dashboard; the workflows need them.
-
-Config precedence per field: `env ($MOA_API_URL / $MOA_API_KEY) → active profile → default`.
-For multiple operators or orgs, see the **moa-profiles** skill.

package/src/skills/moa-ship-issue/SKILL.md

@@ -1,54 +0,0 @@
----
-name: moa-ship-issue
-description: >-
-  Turn a GitHub issue into a merged PR with Moa — `moa wf solve` to implement and open
-  a PR, review it, then `moa wf merge`. Watch each run's live timeline. Use when you
-  want Moa to implement a known issue end-to-end and ship it.
----
-
-# Ship an issue with Moa (issue → PR → merge)
-
-Moa reads the issue, writes the code behind a verify gate (the repo's tests), and
-opens a PR — the git/gh is deterministic; the agent only reasons. It never commits or
-merges on its own; the workflow does. Requires a connected CLI (see **moa-setup**).
-
-Repos are `owner/repo`. Add `--watch` to stream the step timeline until the run ends
-(a watch exits non-zero if the run fails/cancels).
-
-## The happy path
-
-```sh
-moa wf solve <repo> <issue#> --watch     # agent codes → verify gate → opens PR
-moa wf review <repo> <pr#>   --watch     # structured verdict + inline comments
-moa wf merge  <repo> <pr#>   --watch     # guarded: needs approved + green
-```
-
-Check state any time:
-
-```sh
-moa track <repo>            # the issue's pipeline stage (… → branched → pr → merged)
-moa wf list                # recent runs
-moa wf get <id> --watch     # one run + its step timeline (and cost)
-moa wf pending             # your review inbox (issues/PRs awaiting you)
-```
-
-## Variations
-
-| Goal | Command |
-|---|---|
-| Issue → branch only (no PR), re-runnable | `moa wf branch <repo> <issue#>` |
-| Open a PR from an existing branch | `moa wf open-pr <repo> <issue#>` |
-| Apply review feedback to the PR | `moa wf address <repo> <pr#>` |
-| Get failing CI green | `moa wf fix-ci <repo> <pr#>` |
-| Review → fix → re-review until APPROVE | `moa wf review-fix <repo> <pr#>` |
-
-For reviewing/unblocking PRs in depth, see **moa-review-pr**.
-
-## Notes
-
-- **Author ≠ reviewer:** GitHub blocks approving your own PR. Use a second operator
-  (see **moa-profiles**) or let the `review` workflow post the verdict.
-- **Verify gate:** `solve` runs the repo's tests before pushing — a repo with no test
-  script weakens the signal.
-- **Cost:** each run reports `costUsd`; `moa wf get <id>` shows per-run cost. Add
-  `moa status --spend` for the cumulative total.

package/src/skills/moa-triage-audit/SKILL.md

@@ -1,47 +0,0 @@
----
-name: moa-triage-audit
-description: >-
-  Discover and categorize work with Moa — `moa wf triage` to categorize/label an issue,
-  and `moa wf report-issue` to audit a repo and file new GitHub issues. Use to triage an
-  incoming issue or have Moa audit a codebase and file what it finds.
----
-
-# Triage & audit with Moa
-
-Requires a connected CLI (see **moa-setup**). Repos are `owner/repo`; add `--watch` to
-stream the timeline.
-
-## Triage an existing issue
-
-```sh
-moa wf triage <repo> <issue#> --watch    # read-only: categorize / suggest labels
-```
-
-Use it to sort an incoming issue before deciding whether to `solve` it
-(see **moa-ship-issue**).
-
-## Audit a repo and file issues
-
-`report-issue` is **repo-level** (no issue/PR number): the agent reads the repo, recalls
-past hotspots from memory, audits it — optionally focused by `--instruction` — and files
-its findings as GitHub issue(s).
-
-```sh
-moa wf report-issue <repo> --watch
-moa wf report-issue <repo> --instruction "audit src/ for missing input validation and unhandled edge cases" --watch
-```
-
-Omit `--instruction` for a general audit; the agent decides what's worth filing. This is
-how you point Moa at a codebase to *discover* work rather than act on a known item. It
-files issues on the **target repo** — it is not a channel for reporting bugs about Moa
-itself.
-
-## See what's open
-
-```sh
-moa gh issues              # open issues Moa can see
-moa gh pulls               # open PRs
-moa track <repo>           # per-issue pipeline stages
-```
-
-Next: turn a filed/triaged issue into a PR with **moa-ship-issue**.