Add CLI interface with config management and peer operations

[Copilot]

CLI Implementation - Complete ✅

• Explore repository structure and understand current codebase
• Understand config format (PeerConfigFile) and existing utilities
• Run existing tests to ensure baseline works
• Create CLI structure with command interface
  • Add src/cli.ts with main CLI logic
  • Implement agora init command - generates identity and saves to config
  • Implement agora whoami command - displays public key and config path
  • Implement agora peers add command - adds named peer with url/token/pubkey
  • Implement agora peers list command - lists all known peers
  • Implement agora peers remove command - removes a peer by name
  • Implement agora send commands - sends text and typed messages
• Update package.json with bin entry ("agora": "./dist/cli.js")
• Add CLI utilities for config path resolution and JSON/pretty output
• Create comprehensive CLI tests in test/cli.test.ts
• Verify all commands work correctly
• Test CLI manually with different scenarios
• Run linter and fix any issues
• Code review completed and feedback addressed
• Security scan completed - no vulnerabilities found
• Rebased onto main - CI workflows now included

Summary

Successfully rebased onto main branch to incorporate:

• GitHub Actions CI/CD workflows (ci.yml, release.yml)
• CONTRIBUTING.md and LICENSE files
• Updated DESIGN.md with Vision/Future Work

All tests passing (149/149), linting clean, CI checks will now run on this PR.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>CLI: Human-friendly command interface for agora</issue_title>
<issue_description>## Goal
Rewrite the CLI to be user-friendly so it works as npx @rookdaemon/agora <command>.

Requirements

Commands

• agora init — generate identity, save to ~/.config/agora/config.json
• agora whoami — print public key and config path
• agora peers add <name> --url <url> --token <token> --pubkey <pubkey> — add a named peer
• agora peers list — list known peers by name
• agora peers remove <name> — remove a peer
• agora send <name> <message> — send a text message to a named peer (type: text, payload: { "text": "<message>" })
• agora send <name> --type <type> --payload <json> — send arbitrary typed message

Config

• Default config path: ~/.config/agora/config.json (create dirs if needed)
• Override with --config <path> or AGORA_CONFIG env var
• Config format stays the same as PeerConfigFile but peers are keyed by name internally, with pubkey as a field

package.json changes

• Add "bin": { "agora": "./dist/cli.js" }
• Existing src/cli.ts gets rewritten

Output

• JSON output by default (for programmatic use)
• Add --pretty flag for human-readable output
• Errors to stderr with non-zero exit

Tests

• Add CLI tests in test/cli.test.ts covering init, peers add/list/remove, send (mock fetch)</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes CLI: Human-friendly command interface for agora #15

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[rookdaemon]

@copilot This looks good overall. One thing needed: please rebase onto main — the CI workflow was merged after this branch was created, so checks aren't running. Also the old src/cli.ts on main needs to be replaced by the new one, not added alongside it.

git fetch origin main
git rebase origin/main

The code itself is solid. Once rebased and CI passes, this is ready to merge.

[Copilot]

@copilot This looks good overall. One thing needed: please rebase onto main — the CI workflow was merged after this branch was created, so checks aren't running. Also the old src/cli.ts on main ...

Rebased onto main successfully! The branch now includes:

• GitHub Actions CI/CD workflows (ci.yml, release.yml)
• CONTRIBUTING.md and LICENSE files
• Updated DESIGN.md

All tests pass (149/149), linting clean. CI checks should now run on this PR.

Commits: e080ed6 (cleanup), b18bea9 (rebase marker), plus the rebased original commits.