@oneport-dev/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Logging Studio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,99 @@
+# @oneport-dev/cli
+
+Oneport from the terminal — feedback, roadmap & changelog for teams (and agents)
+that ship. Built to be equally good for humans (interactive, guided) and AI
+agents (scriptable, non-interactive, JSON-first).
+
+## Install
+
+```sh
+npm install -g @oneport-dev/cli
+# or run without installing
+npx @oneport-dev/cli login
+```
+
+## Quick start
+
+```sh
+oneport login                 # paste your API key, then pick a workspace
+oneport posts list            # any command prompts you to log in if you aren't
+oneport use <workspace>       # switch the active workspace anytime
+```
+
+Get an API key from the dashboard (**Settings → API keys**, the *Agents* page).
+Any command that needs auth will prompt you to log in first when run
+interactively, or exit with a clear error when run in a script.
+
+## Auth & workspaces
+
+| Command | What it does |
+| --- | --- |
+| `oneport login [--api-key <k>]` | Store an API key; pick a workspace |
+| `oneport logout` | Clear stored credentials |
+| `oneport whoami` | Show the current identity, workspace, and API URL |
+| `oneport workspace list` | List the workspaces your key can access |
+| `oneport use <slug>` | Switch the active workspace (alias of `workspace select`) |
+
+## Commands
+
+```
+posts      list | get | create | update | search | merge | unmerge
+           | comment | comments | vote | unvote
+boards     list | create
+roadmap
+changelog  list | create | update
+ship <postId> --title --content     # mark shipped + publish a changelog
+webhooks   list | create | delete
+domain     get | set | remove
+settings   get | set | logo set|remove
+context                              # brand voice + style exemplars (for agents)
+api <METHOD> <path>                  # raw authenticated request — 100% coverage
+```
+
+Run `oneport <command> --help` for flags. Example raw call (the `{slug}` is
+filled from your active workspace):
+
+```sh
+oneport api GET '/v1/workspaces/{slug}/posts' --query 'sort=top'
+oneport api POST '/v1/workspaces/{slug}/posts' \
+  --data '{"boardSlug":"features","title":"Hi","content":"from the API"}'
+```
+
+## For AI agents
+
+The CLI is designed to be driven non-interactively:
+
+- **Auth from the environment** — set `ONEPORT_API_KEY` (and optionally
+  `ONEPORT_WORKSPACE`); no `login` step required.
+- **`--json`** prints raw API JSON to **stdout**. All status/progress/prompts go
+  to **stderr**, so `oneport posts list --json | jq` is always clean.
+- **Never blocks** — when not a TTY (or with `--no-input`, or `CI=true`) the CLI
+  fails fast with an actionable message instead of prompting.
+- **Stable exit codes**: `0` ok · `1` runtime error · `2` usage · `3` auth
+  required · `4` not found.
+
+```sh
+export ONEPORT_API_KEY=sk_...
+export ONEPORT_WORKSPACE=acme
+oneport posts list --json | jq '.[].title'
+oneport context --json            # fetch brand voice before drafting a changelog
+```
+
+## Configuration
+
+Resolution order: **flag → environment → config file → prompt** (prompt only
+when interactive).
+
+| Setting | Flag | Env | Config key |
+| --- | --- | --- | --- |
+| API key | `oneport login --api-key` | `ONEPORT_API_KEY` | `apiKey` |
+| Workspace | `--workspace`, `-w` | `ONEPORT_WORKSPACE` | `workspace` |
+| API URL | `--api-url` | `ONEPORT_URL` (`ONEPORT_API_URL` also works) | `apiUrl` |
+
+Credentials are stored at `~/.config/oneport/config.json` (mode `0600`; honors
+`$XDG_CONFIG_HOME`, override with `ONEPORT_CONFIG_DIR`). Color honors
+`NO_COLOR` and is disabled when output isn't a TTY.
+
+## License
+
+MIT

package/dist/chunk-BH5VTHCM.mjs

@@ -0,0 +1,102 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/format.ts
+function formatPosts(items) {
+  if (!items.length) return "No posts.";
+  return items.map((p) => {
+    const status = p.status ? `[${p.status.slug}]` : "[\u2014]";
+    const flags = p.verified === false ? " (unverified)" : "";
+    return `\u25B2 ${String(p.voteCount).padStart(3)}  ${status.padEnd(14)} ${p.title}${flags}  ${p.id}`;
+  }).join("\n");
+}
+function formatPost(p) {
+  const status = p.status ? p.status.slug : "\u2014";
+  const lines = [
+    p.title,
+    `${p.id}   status: ${status}   votes: ${p.voteCount}   comments: ${p.commentCount ?? 0}`
+  ];
+  if (p.mergedInto) {
+    lines.push(`merged into: ${p.mergedInto.title} (${p.mergedInto.id})`);
+  }
+  lines.push("", p.content);
+  return lines.join("\n");
+}
+function formatRoadmap(columns) {
+  if (!columns.length) return "Roadmap is empty.";
+  return columns.map((col) => {
+    const items = col.items.length ? col.items.map((i) => `  \u25B2 ${i.voteCount}  ${i.title}`).join("\n") : "  \u2014 empty \u2014";
+    return `[${col.status.slug}]
+${items}`;
+  }).join("\n\n");
+}
+function formatChangelogs(items) {
+  if (!items.length) return "No changelog entries.";
+  return items.map((e) => {
+    const state = e.publishedAt ? e.publishedAt.slice(0, 10) : "draft";
+    return `${state.padEnd(12)} ${e.title}  ${e.id}`;
+  }).join("\n");
+}
+function formatBoards(items) {
+  if (!items.length) return "No boards.";
+  return items.map(
+    (b) => `${b.slug.padEnd(20)} ${b.name}${b.isPrivate ? " (private)" : ""}`
+  ).join("\n");
+}
+function formatWorkspaces(items, current) {
+  if (!items.length) return "No workspaces.";
+  return items.map((w) => {
+    const marker = w.slug === current ? "*" : " ";
+    return `${marker} ${w.slug.padEnd(20)} ${w.name}  (${w.role})`;
+  }).join("\n");
+}
+function formatComments(items) {
+  if (!items.length) return "No comments.";
+  return items.map((cm) => {
+    const who = cm.isTeamMember ? "team" : "user";
+    const when = cm.createdAt ? cm.createdAt.slice(0, 10) : "";
+    return `[${who}] ${when}  ${cm.content}  ${cm.id}`;
+  }).join("\n");
+}
+function formatWebhooks(items) {
+  if (!items.length) return "No webhooks.";
+  return items.map(
+    (w) => `${w.disabled ? "\u2717" : "\u2713"} ${w.url}  [${w.events.join(", ")}]  ${w.id}`
+  ).join("\n");
+}
+function formatValue(v) {
+  if (v === null || v === void 0) return "\u2014";
+  if (typeof v === "object") return JSON.stringify(v);
+  return String(v);
+}
+function formatRecord(obj) {
+  const entries = Object.entries(obj);
+  if (!entries.length) return "(empty)";
+  const width = Math.max(...entries.map(([k]) => k.length));
+  return entries.map(([k, v]) => `${k.padEnd(width)}  ${formatValue(v)}`).join("\n");
+}
+function formatWhoami(info) {
+  return formatRecord({
+    user: info.user?.email ?? info.user?.name ?? "(unknown)",
+    workspace: info.workspace ?? "(none selected)",
+    role: info.role ?? "\u2014",
+    "api url": info.apiUrl
+  });
+}
+
+export {
+  __export,
+  formatPosts,
+  formatPost,
+  formatRoadmap,
+  formatChangelogs,
+  formatBoards,
+  formatWorkspaces,
+  formatComments,
+  formatWebhooks,
+  formatRecord,
+  formatWhoami
+};

package/dist/format.mjs

@@ -0,0 +1,24 @@
+import {
+  formatBoards,
+  formatChangelogs,
+  formatComments,
+  formatPost,
+  formatPosts,
+  formatRecord,
+  formatRoadmap,
+  formatWebhooks,
+  formatWhoami,
+  formatWorkspaces
+} from "./chunk-BH5VTHCM.mjs";
+export {
+  formatBoards,
+  formatChangelogs,
+  formatComments,
+  formatPost,
+  formatPosts,
+  formatRecord,
+  formatRoadmap,
+  formatWebhooks,
+  formatWhoami,
+  formatWorkspaces
+};