@emaxe/oa 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to the `@emaxe/oa` package will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+**[English](CHANGELOG.md)** | **[Русский](CHANGELOG.ru.md)**
+
+---
+
+## [0.3.0] - 2026-09-11
+
+### Added
+- **Personal API Keys**: `oa login` now issues a personal key by default — valid across every team you belong to (with your real role in each), instead of one agent key per team. Use `oa login --agent` for the old behavior: a key locked to one team, for CI and narrowly-scoped use cases.
+- **`oa orgs`**: Lists the teams your key can act in, marking the one currently selected for this project.
+- **`oa use <team>`**: Sets the default team for the current project, saved to a `.oa.json` file next to it (no secrets — safe to commit). Pass `--global` to set it for the whole machine instead.
+- **`--org <team>` flag**: Added to `oa list` and `oa push` to override the resolved default team for a single invocation.
+- **Project-scoped config resolution**: `.oa.json` is found by walking up from the current directory, the same way `.git`/`.eslintrc` are — so the right team is picked up automatically no matter which subdirectory a command runs from.
+
+### Changed
+- Structured handling of the new `org_required` error: when a personal key belongs to more than one team and none is selected, the CLI prints the candidate list and points at `oa use`/`--org` instead of a raw error.
+- Credentials file permissions (`600`) are now re-applied on every login, not just when the file is first created.
+
+---
+
+## [0.2.0] - 2026-09-11
+
+### Added
+- **OAuth Device Flow**: Added `oa login` command enabling interactive device authentication with code verification and browser activation.
+- **Verification Command**: Added `oa whoami` command to check current credentials, active server, organization, and token expiration.
+- **Enhanced Share Options**: Added `--password` and `--expires` flags to `oa push` and `oa share` for secure, time-limited artifact sharing.
+- **Automatic Format Detection**: Automatic inference of artifact kind (`html`, `markdown`, `mermaid`, `svg`) based on file extension.
+- **Artifact Management**: Added `oa rm` and `oa unshare` commands.
+- **Bilingual Documentation**: Added English and Russian READMEs and Changelogs.
+
+### Changed
+- **Package Name**: Renamed npm package to [`@emaxe/oa`](https://www.npmjs.com/package/@emaxe/oa).
+- **Global Flag**: Ensured all commands support `--json` for scripting and agent pipeline compatibility.
+
+---
+
+## [0.1.0] - 2026-09-10
+
+### Added
+- Initial CLI release supporting artifact push, list, and get operations.

package/CHANGELOG.ru.md

@@ -0,0 +1,46 @@
+# История изменений (Changelog)
+
+Все заметные изменения пакета `@emaxe/oa` документируются в этом файле.
+
+Формат основан на [Keep a Changelog](https://keepachangelog.com/ru/1.0.0/),
+и проект придерживается [Семантического версионирования](https://semver.org/lang/ru/).
+
+**[English](CHANGELOG.md)** | **[Русский](CHANGELOG.ru.md)**
+
+---
+
+## [0.3.0] - 2026-09-11
+
+### Добавлено
+- **Личные API-ключи**: `oa login` теперь по умолчанию выпускает личный ключ — действующий во всех ваших командах (с вашей реальной ролью в каждой) вместо отдельного ключа агента на команду. Прежнее поведение (ключ, запертый в одной команде — для CI и узких прав) доступно через `oa login --agent`.
+- **`oa orgs`**: Список команд, доступных ключу, с отметкой текущей выбранной для этого проекта.
+- **`oa use <team>`**: Устанавливает команду по умолчанию для текущего проекта — сохраняется в файл `.oa.json` рядом с ним (без секретов, можно коммитить). Флаг `--global` задаёт значение для всего компьютера.
+- **Флаг `--org <team>`**: Добавлен в `oa list` и `oa push` для разового переопределения выбранной команды.
+- **Разрешение конфигурации по проекту**: `.oa.json` ищется подъёмом вверх по дереву каталогов от текущей директории — так же, как `.git`/`.eslintrc` — поэтому нужная команда подхватывается автоматически из любой вложенной папки.
+
+### Изменено
+- Структурированная обработка новой ошибки `org_required`: если у личного ключа несколько команд и ни одна не выбрана, CLI печатает список кандидатов и подсказывает `oa use`/`--org` вместо сырой ошибки.
+- Права на файл с учётными данными (`600`) теперь применяются при каждом логине, а не только при первом создании файла.
+
+---
+
+## [0.2.0] - 2026-09-11
+
+### Добавлено
+- **OAuth Device Flow**: Добавлена команда `oa login` для интерактивной авторизации устройства через браузер с короткими кодами активации.
+- **Команда проверки статуса**: Добавлена команда `oa whoami` для проверки действующих ключей, адреса сервера, организации и срока действия токена.
+- **Расширенные опции шеринга**: Поддержка параметров `--password` и `--expires` в командах `oa push` и `oa share` для создания защищенных паролем и временных ссылок.
+- **Автоопределение типа файла**: Автоматическое определение формата артефакта (`html`, `markdown`, `mermaid`, `svg`) по расширению файла.
+- **Управление артефактами**: Добавлены команды удаления артефакта `oa rm` и отзыва ссылки `oa unshare`.
+- **Двуязычная документация**: Добавлены русская и английская версии README и истории изменений.
+
+### Изменено
+- **Имя пакета**: Пакет переименован в [`@emaxe/oa`](https://www.npmjs.com/package/@emaxe/oa) в реестре npm.
+- **Флаг JSON**: Все команды поддерживают флаг `--json` для интеграции в скрипты и пайплайны агентов.
+
+---
+
+## [0.1.0] - 2026-09-10
+
+### Добавлено
+- Начальный релиз CLI с поддержкой команд `push`, `list` и `get`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 emaxe
+
+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

@@ -1,34 +1,193 @@
-# open-artifacts
+# @emaxe/oa
 
-CLI for [Open Artifacts](https://github.com/emaxe/open-artifacts) — a self-hosted, open
-alternative to Claude Artifacts. Publish HTML, Markdown, Mermaid, or SVG content to your own
-instance and get back a shareable link, from any AI agent or script.
+<p align="left">
+  <a href="https://www.npmjs.com/package/@emaxe/oa"><img src="https://img.shields.io/npm/v/@emaxe/oa.svg?color=blue&logo=npm" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@emaxe/oa"><img src="https://img.shields.io/npm/dm/@emaxe/oa.svg?color=blue&logo=npm" alt="npm downloads"></a>
+  <a href="https://github.com/emaxe/open-artifacts"><img src="https://img.shields.io/badge/GitHub-emaxe%2Fopen--artifacts-blue?logo=github" alt="GitHub Repository"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+  <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg?logo=node.js" alt="Node.js"></a>
+  <a href="https://skills.sh/emaxe/open-artifacts"><img src="https://skills.sh/b/emaxe/open-artifacts" alt="skills.sh"></a>
+</p>
+
+**[English](README.md)** | **[Русский](README.ru.md)** | **[Changelog](CHANGELOG.md)** | **[История изменений](CHANGELOG.ru.md)**
+
+Official CLI for [Open Artifacts](https://github.com/emaxe/open-artifacts) — a self-hosted, open-source alternative to Claude Artifacts. Publish HTML applications, Markdown documents, Mermaid diagrams, or vector SVG files from your terminal, scripts, or AI agent sessions and get back an interactive, shareable preview URL.
+
+---
+
+### Topics & Tags
+`ai-agents` • `artifacts` • `claude-artifacts` • `claude` • `mcp` • `model-context-protocol` • `self-hosted` • `cli` • `open-artifacts` • `developer-tools`
+
+---
+
+## Installation
 
 ```bash
+# Global installation (recommended):
 npm install -g @emaxe/oa
+
+# Or run directly without installing:
+npx @emaxe/oa --help
+```
+
+---
+
+## Quick Start
+
+### 1. Authenticate
+
+Connect to your Open Artifacts server using the interactive OAuth Device Flow:
+
+```bash
+oa login --server https://artifacts.your-company.com
+```
+
+The CLI outputs a short code (e.g. `ABCD-1234`) and an activation link. Open the link in your browser and approve access. This issues a **personal key** by default — it's valid across every team you belong to, not locked to one. Credentials are saved locally to `~/.config/open-artifacts/credentials.json` (`600` permissions).
+
+Verify your session at any time:
+
+```bash
+oa whoami
+```
+
+### 2. Pick a team
+
+If you belong to more than one team, tell the CLI which one to use for this project:
+
+```bash
+oa orgs           # list your teams, with a * next to the current default
+oa use <team>     # set the default for this project (writes a secret-free .oa.json you can commit)
+```
+
+With exactly one team, this step is optional — it's used automatically. Override it for a single command with `--org <team>` on `oa list` / `oa push`, without changing the saved default.
+
+### 3. Publish Content
+
+```bash
+# Publish an HTML file and get a public shareable URL:
+oa push report.html --title "Quarterly Financials" --share
+
+# Publish a Markdown summary:
+oa push summary.md --title "Meeting Minutes" --share
+
+# Render a Mermaid flowchart:
+oa push architecture.mmd --title "Service Architecture" --share
+
+# Upload an SVG vector graphic:
+oa push diagram.svg --title "Database Schema" --share
+```
+
+---
+
+## Command Reference
+
+### `oa login`
+Authorizes the CLI with an Open Artifacts server using the OAuth device flow.
+
+```bash
+oa login [options]
+  --server <url>      Open Artifacts server URL (default: "http://localhost:3000")
+  --name <name>        Name to register this device/agent as
+  --scopes <scopes>    Comma-separated list of scopes (default: "artifacts:read,artifacts:write,shares:write")
+  --agent               Issue an agent key locked to one team, instead of a personal key spanning all your teams
+```
+
+### `oa whoami`
+Displays current credentials, server endpoint, key type, effective team, and token expiration.
+
+### `oa orgs`
+Lists the teams your key can act in, marking the one currently selected for this project.
+
+```bash
+oa orgs [--json]
+```
+
+### `oa use <team>`
+Sets the default team (by id or slug) for the current project, or for the whole machine.
+
+```bash
+oa use <team> [--global]
+```
+
+### `oa push <file>`
+Creates a new artifact or updates an existing one from a local file.
+
+```bash
+oa push <file> [options]
+  --title <title>       Artifact title (defaults to filename)
+  --kind <kind>         Content type: html | markdown | mermaid | svg (auto-detected if omitted)
+  --id <id>             Update an existing artifact instead of creating a new one
+  --share               Automatically generate a public share link
+  --password <pass>     Protect the share link with a password (implies --share)
+  --expires <ttl>       Share expiration: 1h, 1d, 7d, 30d (implies --share)
+  --message <msg>       Version commit message
+  --org <team>          Team id or slug to publish into (overrides the project/machine default)
+  --json                Output result as JSON
+```
+
+### `oa list`
+Lists all artifacts in your active team.
+
+```bash
+oa list [--org <team>] [--json]
+```
+
+### `oa get <artifact-id>`
+Retrieves artifact metadata or downloads raw content to a file.
+
+```bash
+oa get <artifact-id> [-o output-file] [--json]
 ```
 
-## Usage
+### `oa rm <artifact-id>`
+Soft-deletes an artifact.
 
 ```bash
-oa login --server https://artifacts.your-company.com   # one-time device-flow authorization
-oa push report.html --title "Q3 Report" --share        # publish + print a share URL
-oa list                                                 # see what you've published
-oa get <artifact-id> -o report.html                     # fetch content back
-oa share <artifact-id> --password "..." --expires 7d    # a password-protected, expiring link
+oa rm <artifact-id> [--json]
 ```
 
-Every command supports `--json` for machine-readable output. Run `oa --help` or `oa <command>
---help` for the full option list.
+### `oa share <artifact-id>`
+Generates a new shareable link for an existing artifact.
 
-Credentials are saved to `~/.config/open-artifacts/credentials.json` (mode `600`) after `oa
-login`. Alternatively, set `OA_TOKEN` (and `OA_SERVER`) as environment variables to skip the
-device flow entirely — useful for CI or non-interactive agents that already have a key.
+```bash
+oa share <artifact-id> [options]
+  --password <pass>     Password protect the link
+  --expires <ttl>       Link expiration duration (e.g. 1h, 1d, 7d, 30d)
+  --json                Output share metadata as JSON
+```
+
+### `oa unshare <share-id>`
+Revokes an active share link immediately.
+
+```bash
+oa unshare <share-id> [--json]
+```
+
+---
+
+## Non-Interactive & CI Environments
+
+For CI/CD pipelines, headless scripts, or background agent environments, you can bypass the device flow by setting environment variables:
+
+```bash
+export OA_SERVER="https://artifacts.your-company.com"
+export OA_TOKEN="oa_live_xxxxxxxxxxxxxxxxxxxxxxxx"
+```
+
+For CI, an agent key (`oa login --agent`, or generated in the web dashboard under **Team > Agents**) is usually the right choice — it's locked to one team, which keeps the blast radius of a leaked CI secret small. A personal key issued from **Settings > Личные API-ключи** also works via `OA_TOKEN`, but it spans every team you belong to.
+
+---
+
+## AI Agent Integration
+
+This CLI is designed to be invoked by LLM coding agents (Claude Code, Cursor, Windsurf, Codex, Antigravity, OpenCode). You can install the pre-configured skill via [skills.sh](https://skills.sh/emaxe/open-artifacts):
+
+```bash
+npx skills add emaxe/open-artifacts
+```
 
-This CLI requires an Open Artifacts server to talk to — see the
-[main repository](https://github.com/emaxe/open-artifacts) for how to self-host one via Docker
-Compose.
+---
 
 ## License
 
-MIT
+MIT © [emaxe](https://github.com/emaxe)

package/README.ru.md

@@ -0,0 +1,193 @@
+# @emaxe/oa
+
+<p align="left">
+  <a href="https://www.npmjs.com/package/@emaxe/oa"><img src="https://img.shields.io/npm/v/@emaxe/oa.svg?color=blue&logo=npm" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@emaxe/oa"><img src="https://img.shields.io/npm/dm/@emaxe/oa.svg?color=blue&logo=npm" alt="npm downloads"></a>
+  <a href="https://github.com/emaxe/open-artifacts"><img src="https://img.shields.io/badge/GitHub-emaxe%2Fopen--artifacts-blue?logo=github" alt="GitHub Repository"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+  <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg?logo=node.js" alt="Node.js"></a>
+  <a href="https://skills.sh/emaxe/open-artifacts"><img src="https://skills.sh/b/emaxe/open-artifacts" alt="skills.sh"></a>
+</p>
+
+**[English](README.md)** | **[Русский](README.ru.md)** | **[Changelog](CHANGELOG.md)** | **[История изменений](CHANGELOG.ru.md)**
+
+Официальная консольная утилита (CLI) для [Open Artifacts](https://github.com/emaxe/open-artifacts) — открытой альтернативы Claude Artifacts. Позволяет публиковать веб-приложения на HTML, документы Markdown, диаграммы Mermaid или векторную графику SVG из терминала, скриптов или диалогов с AI-агентами, получая в ответ интерактивную публичную ссылку.
+
+---
+
+### Топики и теги
+`ai-agents` • `artifacts` • `claude-artifacts` • `claude` • `mcp` • `model-context-protocol` • `self-hosted` • `cli` • `open-artifacts` • `developer-tools`
+
+---
+
+## Установка
+
+```bash
+# Глобальная установка (рекомендуется):
+npm install -g @emaxe/oa
+
+# Или запуск без установки:
+npx @emaxe/oa --help
+```
+
+---
+
+## Быстрый старт
+
+### 1. Авторизация
+
+Подключитесь к вашему серверу Open Artifacts через удобный интерактивный OAuth Device Flow:
+
+```bash
+oa login --server https://artifacts.your-company.com
+```
+
+Утилита сгенерирует короткий код подтверждения (например, `ABCD-1234`) и ссылку на страницу активации. Перейдите по ссылке и разрешите доступ. По умолчанию выпускается **личный ключ** — он действует во всех ваших командах, а не запертый в одной. Токен сохранится локально в `~/.config/open-artifacts/credentials.json` с правами `600`.
+
+Проверить статус сессии в любой момент:
+
+```bash
+oa whoami
+```
+
+### 2. Выбор команды
+
+Если вы состоите в нескольких командах, укажите CLI, какую использовать для этого проекта:
+
+```bash
+oa orgs           # список ваших команд с отметкой * у текущей по умолчанию
+oa use <team>     # задать команду по умолчанию для проекта (пишет .oa.json без секретов, можно коммитить)
+```
+
+Если команда одна — этот шаг не нужен, она подставится автоматически. Переопределить для одного вызова можно флагом `--org <team>` у `oa list`/`oa push`, не меняя сохранённое значение по умолчанию.
+
+### 3. Публикация файлов
+
+```bash
+# Опубликовать HTML-страницу и получить публичную ссылку:
+oa push report.html --title "Финансовый отчет" --share
+
+# Опубликовать документ Markdown:
+oa push summary.md --title "Протокол встречи" --share
+
+# Отрендерить диаграмму Mermaid:
+oa push architecture.mmd --title "Архитектура сервиса" --share
+
+# Загрузить векторный файл SVG:
+oa push diagram.svg --title "Схема базы данных" --share
+```
+
+---
+
+## Справочник команд
+
+### `oa login`
+Авторизация CLI на сервере Open Artifacts по протоколу OAuth Device Flow.
+
+```bash
+oa login [options]
+  --server <url>      URL сервера Open Artifacts (по умолчанию: "http://localhost:3000")
+  --name <name>        Имя регистрируемого устройства/агента
+  --scopes <scopes>    Список запрашиваемых прав через запятую (по умолчанию: "artifacts:read,artifacts:write,shares:write")
+  --agent               Выпустить ключ агента, запертый в одной команде, вместо личного ключа на все ваши команды
+```
+
+### `oa whoami`
+Показывает текущие учётные данные, адрес сервера, тип ключа, выбранную команду и статус токена.
+
+### `oa orgs`
+Список команд, доступных ключу, с отметкой текущей выбранной для этого проекта.
+
+```bash
+oa orgs [--json]
+```
+
+### `oa use <team>`
+Задаёт команду по умолчанию (по id или slug) для текущего проекта или для всего компьютера.
+
+```bash
+oa use <team> [--global]
+```
+
+### `oa push <file>`
+Создает новый артефакт или обновляет существующий из локального файла.
+
+```bash
+oa push <file> [options]
+  --title <title>       Название артефакта (по умолчанию: имя файла)
+  --kind <kind>         Тип контента: html | markdown | mermaid | svg (определяется автоматически)
+  --id <id>             ID существующего артефакта для создания новой версии
+  --share               Сразу сгенерировать публичную ссылку
+  --password <pass>     Защитить ссылку паролем (включает --share)
+  --expires <ttl>       Срок действия ссылки: 1h, 1d, 7d, 30d (включает --share)
+  --message <msg>       Сообщение версии
+  --org <team>          Команда для публикации (переопределяет значение по умолчанию проекта/машины)
+  --json                Вывод результата в формате JSON
+```
+
+### `oa list`
+Выводит список всех артефактов в текущей команде.
+
+```bash
+oa list [--org <team>] [--json]
+```
+
+### `oa get <artifact-id>`
+Показывает информацию об артефакте или скачивает его содержимое в файл.
+
+```bash
+oa get <artifact-id> [-o output-file] [--json]
+```
+
+### `oa rm <artifact-id>`
+Удаляет артефакт в архив.
+
+```bash
+oa rm <artifact-id> [--json]
+```
+
+### `oa share <artifact-id>`
+Создает ссылку для совместного доступа к артефакту.
+
+```bash
+oa share <artifact-id> [options]
+  --password <pass>     Защитить ссылку паролем
+  --expires <ttl>       Срок действия ссылки (например: 1h, 1d, 7d, 30d)
+  --json                Вывод информации о ссылке в формате JSON
+```
+
+### `oa unshare <share-id>`
+Мгновенно отзывает выданную ссылку.
+
+```bash
+oa unshare <share-id> [--json]
+```
+
+---
+
+## Использование в CI/CD и неинтерактивных средах
+
+Для автоматических пайплайнов или фоновых скриптов можно передать параметры через переменные окружения, минуя Device Flow:
+
+```bash
+export OA_SERVER="https://artifacts.your-company.com"
+export OA_TOKEN="oa_live_xxxxxxxxxxxxxxxxxxxxxxxx"
+```
+
+Для CI обычно правильный выбор — ключ агента (`oa login --agent`, либо выпущенный в панели управления в разделе **Команда > Агенты**): он заперт в одной команде, что ограничивает ущерб от утечки CI-секрета. Личный ключ из **Настройки > Личные API-ключи** тоже подходит для `OA_TOKEN`, но действует во всех ваших командах.
+
+---
+
+## Интеграция с AI-агентами
+
+Утилита оптимизирована для взаимодействия с современными AI-агентами (Claude Code, Cursor, Windsurf, Codex, Antigravity, OpenCode). Установите готовый скилл через [skills.sh](https://skills.sh/emaxe/open-artifacts):
+
+```bash
+npx skills add emaxe/open-artifacts
+```
+
+---
+
+## Лицензия
+
+MIT © [emaxe](https://github.com/emaxe)

package/dist/__tests__/inferKind.test.js

@@ -0,0 +1,27 @@
+import { describe, expect, it } from "vitest";
+import { inferKind } from "../commands/artifacts.js";
+describe("inferKind", () => {
+    it("recognizes markdown extensions", () => {
+        expect(inferKind("report.md")).toBe("markdown");
+        expect(inferKind("report.markdown")).toBe("markdown");
+    });
+    it("recognizes svg", () => {
+        expect(inferKind("logo.svg")).toBe("svg");
+    });
+    it("recognizes mermaid extensions", () => {
+        expect(inferKind("diagram.mmd")).toBe("mermaid");
+        expect(inferKind("diagram.mermaid")).toBe("mermaid");
+    });
+    it("defaults to html for .html and unrecognized extensions", () => {
+        expect(inferKind("page.html")).toBe("html");
+        expect(inferKind("notes.txt")).toBe("html");
+        expect(inferKind("no-extension")).toBe("html");
+    });
+    it("is case-insensitive", () => {
+        expect(inferKind("REPORT.MD")).toBe("markdown");
+    });
+    it("only looks at the extension, ignoring directories in the path", () => {
+        expect(inferKind("/tmp/my.markdown.folder/report.svg")).toBe("svg");
+    });
+});
+//# sourceMappingURL=inferKind.test.js.map

package/dist/__tests__/inferKind.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inferKind.test.js","sourceRoot":"","sources":["../../src/__tests__/inferKind.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;QACxB,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,CAAC,SAAS,CAAC,oCAAoC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/org-resolution.test.js

@@ -0,0 +1,60 @@
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { resolveOrg } from "../org.js";
+let dir;
+afterEach(() => {
+    if (dir)
+        rmSync(dir, { recursive: true, force: true });
+    dir = undefined;
+});
+function makeTmpDir() {
+    dir = mkdtempSync(join(tmpdir(), "oa-org-resolution-"));
+    return dir;
+}
+const userCreds = { server: "https://oa.example.com", token: "oa_live_x", expiresAt: null, kind: "user", userId: "u1" };
+const legacyAgentCreds = { server: "https://oa.example.com", token: "oa_live_x", expiresAt: null, agentId: "a1", orgId: "org-legacy" };
+describe("resolveOrg priority", () => {
+    it("--org flag wins over everything else", () => {
+        const root = makeTmpDir();
+        writeFileSync(join(root, ".oa.json"), JSON.stringify({ orgId: "org-project" }));
+        const res = resolveOrg({ flag: "org-flag", cwd: root, env: { OA_ORG: "org-env" }, creds: userCreds });
+        expect(res).toEqual({ orgId: "org-flag", source: "flag" });
+    });
+    it("OA_ORG env wins over the project config", () => {
+        const root = makeTmpDir();
+        writeFileSync(join(root, ".oa.json"), JSON.stringify({ orgId: "org-project" }));
+        const res = resolveOrg({ cwd: root, env: { OA_ORG: "org-env" }, creds: userCreds });
+        expect(res).toEqual({ orgId: "org-env", source: "env" });
+    });
+    it("falls back to the project's .oa.json when no flag or env is given", () => {
+        const root = makeTmpDir();
+        writeFileSync(join(root, ".oa.json"), JSON.stringify({ orgId: "org-project", server: "https://oa.example.com" }));
+        const res = resolveOrg({ cwd: root, env: {}, creds: userCreds });
+        expect(res).toEqual({ orgId: "org-project", source: "project", configPath: join(root, ".oa.json") });
+    });
+    it("ignores a project config written for a different server", () => {
+        const root = makeTmpDir();
+        writeFileSync(join(root, ".oa.json"), JSON.stringify({ orgId: "org-project", server: "https://other.example.com" }));
+        const res = resolveOrg({ cwd: root, env: {}, creds: userCreds });
+        expect(res).toEqual({ source: "none" });
+    });
+    it("falls back to a legacy agent credentials file's locked org when nothing else resolves", () => {
+        const root = makeTmpDir();
+        const res = resolveOrg({ cwd: root, env: {}, creds: legacyAgentCreds });
+        expect(res).toEqual({ orgId: "org-legacy", source: "credentials" });
+    });
+    it("never falls back to credentials.orgId for a personal (kind: user) key", () => {
+        const root = makeTmpDir();
+        const personalWithOrg = { ...userCreds, orgId: "should-not-be-used" };
+        const res = resolveOrg({ cwd: root, env: {}, creds: personalWithOrg });
+        expect(res).toEqual({ source: "none" });
+    });
+    it("resolves to 'none' with no flag, env, project config, or usable credentials fallback", () => {
+        const root = makeTmpDir();
+        const res = resolveOrg({ cwd: root, env: {}, creds: userCreds });
+        expect(res).toEqual({ source: "none" });
+    });
+});
+//# sourceMappingURL=org-resolution.test.js.map

package/dist/__tests__/org-resolution.test.js.map

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