@upgraide/ui-notes-cli 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,141 @@
+# @upgraide/ui-notes-cli
+
+Command-line tool to manage UI Notes — pull feedback, resolve issues, and manage projects from your terminal.
+
+## Installation
+
+```bash
+npm install -g @upgraide/ui-notes-cli
+```
+
+**Requires:** Bun >= 1.0.0
+
+## Quick Start
+
+```bash
+# Authenticate with your API server
+uinotes login
+
+# Pull open notes for your project
+uinotes pull --project my-app
+
+# Resolve a note
+uinotes resolve 42 "Fixed in latest deploy"
+```
+
+## Commands
+
+### `uinotes login`
+
+Interactive authentication flow. Prompts for your API URL, email, and password, then generates and saves an API key locally.
+
+```bash
+uinotes login
+```
+
+The API key is saved to `~/.uinotes.json` (or `.uinotes.json` in the current directory if one exists).
+
+### `uinotes config`
+
+View or update configuration.
+
+```bash
+# Show current config
+uinotes config
+
+# Set a value
+uinotes config set apiUrl https://my-api.example.com
+uinotes config set defaultProject my-app
+```
+
+**Config keys:** `apiUrl`, `apiKey`, `defaultProject`
+
+### `uinotes projects`
+
+Manage projects.
+
+```bash
+# List all projects
+uinotes projects
+
+# Include archived projects
+uinotes projects --archived
+
+# Create a project with URL patterns
+uinotes projects create my-app "My Application" --url "https://myapp.com/*"
+
+# Get project details
+uinotes projects get my-app
+
+# Rename a project
+uinotes projects rename my-app "New Name"
+
+# Add/remove URL patterns
+uinotes projects add-url my-app "https://staging.myapp.com/*"
+uinotes projects remove-url my-app "https://old.myapp.com/*"
+
+# Archive a project
+uinotes projects delete my-app
+```
+
+### `uinotes pull`
+
+Fetch notes from the API.
+
+```bash
+uinotes pull
+uinotes pull --project my-app --status open --type bug --limit 50
+```
+
+| Option | Description |
+|--------|-------------|
+| `--project <name>` | Filter by project (overrides default) |
+| `--status <status>` | Filter by status (`open`, `resolved`, `wontfix`) |
+| `--type <type>` | Filter by type (`bug`, `ux`, `feature`, `question`) |
+| `--limit <n>` | Max number of results |
+
+### `uinotes resolve`
+
+Mark a note as resolved.
+
+```bash
+uinotes resolve <id> [message]
+uinotes resolve 42 "Fixed in v2.1" --project my-app
+```
+
+### `uinotes wontfix`
+
+Mark a note as won't fix.
+
+```bash
+uinotes wontfix <id> [message]
+uinotes wontfix 99 "Out of scope for this release"
+```
+
+## Configuration
+
+The CLI looks for config in two places (local takes priority):
+
+1. **Local:** `.uinotes.json` in the current directory
+2. **Global:** `~/.uinotes.json` in your home directory
+
+```json
+{
+  "apiUrl": "http://localhost:3000",
+  "apiKey": "your-api-key",
+  "defaultProject": "my-app"
+}
+```
+
+API keys are redacted when displayed with `uinotes config`.
+
+## Global Options
+
+| Option | Description |
+|--------|-------------|
+| `--project <name>` | Override default project for this command |
+| `--help`, `-h` | Show help |
+
+## License
+
+MIT

package/api.ts

@@ -20,7 +20,10 @@ export async function apiFetch(
     headers['Content-Type'] = 'application/json';
   }
 
-  const res = await fetch(`${config.apiUrl}${path}`, {
+  // Prefix /api if not already present
+  const apiPath = path.startsWith('/api') ? path : `/api${path}`;
+
+  const res = await fetch(`${config.apiUrl}${apiPath}`, {
     method,
     headers,
     body: body ? (typeof body === 'string' ? body : JSON.stringify(body)) : undefined,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upgraide/ui-notes-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CLI for UI Notes - pull and manage UI feedback notes",
   "license": "MIT",
   "keywords": ["cli", "ui", "notes", "feedback", "ui-notes"],