@telefonica/ai-sdlc-opencode-plugin-v1-dev 0.1.0-snapshot.35846538366 → 0.1.0-snapshot.35850785707

package/README.md

@@ -1,124 +1,25 @@
 # @telefonica/ai-sdlc-opencode-plugin-v1
 
-CDO.AI gateway plugin for **OpenCode 1.x**. Registers the gateway as a provider,
-discovers its models, and renders remaining budget in the sidebar.
+CDO.AI gateway plugin for OpenCode 1.x.
 
-For installation and the `/connect` walkthrough, see the
-[plugins README](../../README.md). This file covers the internals.
+## Install
 
-> Using OpenCode 2.x? Install [`@telefonica/ai-sdlc-opencode-plugin-v2`](../v2)
-> instead — the two major versions have incompatible plugin APIs.
+Add the package to both OpenCode configuration files:
 
-## What it provides
-
-Two flavors are published as separate packages, each built into
-`plugin-dist/<flavor>/` with its own generated manifest — the same layout the v2
-plugin uses.
-
-| Package | Provider id | Shown in `/connect` as |
-| --- | --- | --- |
-| `@telefonica/ai-sdlc-opencode-plugin-v1` | `cdo-ai` | CDO.AI |
-| `@telefonica/ai-sdlc-opencode-plugin-v1-dev` | `cdo-ai-dev` | CDO.AI (dev) |
-
-Each package exposes two entry points, which OpenCode resolves independently:
-
-| Export | Built file | Role |
-| --- | --- | --- |
-| `./server` | `dist/index.js` | Provider registration, `/connect` auth, model discovery |
-| `./tui` | `dist/tui.js` | Sidebar budget panel |
-
-Only `exports["./server"]` and `exports["./tui"]` are consulted. OpenCode never
-reads `exports["."]`, and a `main` field would be picked up as an additional
-server entry point, so neither is declared.
-
-The production panel also covers the hand-written `litellm*` providers from the
-older manual setup, so the budget display keeps working while users migrate. The
-dev panel matches only `cdo-ai-dev`, so installing both packages does not produce
-two panels for the same gateway.
-
-## Architecture notes
-
-These are load-bearing constraints of the OpenCode 1.x plugin API. They look
-arbitrary in isolation, so they are recorded here.
-
-**Models come from the `config` hook, not the `provider.models` hook.** OpenCode
-invokes `provider.models` before config-declared providers exist, so it never
-fires for a provider that is not in the models.dev catalog. Discovery therefore
-happens in the `config` hook, which is async and may perform network calls.
-
-**A provider with no models is discarded.** OpenCode deletes any provider whose
-model map is empty before `/connect` renders, so the config hook seeds a
-placeholder entry that is replaced once discovery succeeds.
-
-**`/connect` does not call `authorize()` for API-key methods.** Values collected
-by `prompts` are stored as credential metadata and the key itself is collected by
-a separate built-in step. The auth method therefore prompts only for the gateway
-URL, and `auth.loader` recombines the stored URL and key into provider options.
-
-**Credentials are read from disk.** Stored auth is not exposed in-process when
-the config hook runs, so it reads `auth.json` directly. Resolution order is
-config `options`, then environment variables, then `auth.json`. Resolved values
-are written back into `options` because a fully custom provider builds its
-completion client from them directly.
-
-**One environment per package.** `Hooks.auth` binds a single provider id, so each
-environment needs its own plugin instance. Rather than smuggling both into one
-module, each flavor is built and published separately, which keeps the plain
-default-export plugin module shape and matches the v2 plugin.
-
-## Layout
-
-```
-src/
-├── flavor.ts             # prod/dev ids and labels, mirroring the v2 plugin
-├── entry-prod.ts         # server entry, prod   -> dist/index.js
-├── entry-dev.ts          # server entry, dev    -> dist/index.js
-├── tui-prod.tsx          # TUI entry, prod      -> dist/tui.js
-├── tui-dev.tsx           # TUI entry, dev       -> dist/tui.js
-├── tui.tsx               # sidebar slot registration and budget polling
-├── components.tsx        # budget panel rendering
-├── usage-client.ts       # /v1/usage fetch for the budget panel
-└── server/
-    ├── plugin.ts         # assembles the hooks for a flavor
-    ├── config-hook.ts    # provider registration and model discovery
-    ├── auth-hook.ts      # /connect prompts and credential loading
-    ├── credentials.ts    # config / env / auth.json resolution
-    ├── models-client.ts  # /v1/models and /v1/model/info
-    ├── model-cache.ts    # 7-day on-disk model cache
-    └── constants.ts
-```
-
-`FLAVOR=dev|prod` is the only build flag. Every identity string lives in
-`src/flavor.ts`; there is no runtime environment lookup.
-
-## Develop
-
-```bash
-npm ci
-npm run build:prod   # writes plugin-dist/prod/dist/
-npm run build:dev    # writes plugin-dist/dev/dist/
-npm run build        # both
-```
-
-Point OpenCode at a built flavor to try it:
+- `~/.config/opencode/opencode.jsonc`
+- `~/.config/opencode/tui.jsonc`
 
 ```jsonc
-{ "plugin": ["/absolute/path/to/plugins/opencode/v1/plugin-dist/prod"] }
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@telefonica/ai-sdlc-opencode-plugin-v1"]
+}
 ```
 
-For OpenCode 1.x, put this entry in both `opencode.jsonc` and `tui.jsonc`.
-The server and TUI plugin loaders use separate config files.
-
-Build before launching — OpenCode installs plugins with scripts disabled and will
-not build the package for you. Quit OpenCode fully between attempts, since a
-plugin that fails to load stays cached for the lifetime of the process.
-
-## Release
+For the development gateway, use
+`@telefonica/ai-sdlc-opencode-plugin-v1-dev` in both files.
 
-Published by `.github/workflows/opencode-plugin-release.yml` via
-`semantic-release`, tagged `opencode-v1@<version>`.
+Restart OpenCode, run `/connect`, choose **CDO.AI**, and enter the gateway URL
+and API key. Restart OpenCode once more after connecting so the model list loads.
 
-`plugin-dist/` is a build output directory and is not committed. The release
-`prepareCmd` builds both flavors and then runs `scripts/write-manifests.js`,
-which generates each publish manifest; `publishCmd` publishes both. The root
-package is `private` and exists only to hold the sources and release config.
+Using OpenCode 2.x? Install `@telefonica/ai-sdlc-opencode-plugin-v2` instead.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telefonica/ai-sdlc-opencode-plugin-v1-dev",
-  "version": "0.1.0-snapshot.35846538366",
+  "version": "0.1.0-snapshot.35850785707",
   "description": "OpenCode 1.x plugin (dev environment): CDO.AI provider registration, model discovery, and budget panel",
   "type": "module",
   "exports": {