@aexol/opencode-wizard 0.1.0 → 0.1.2

package/README.md

@@ -1,16 +1,19 @@
 # @aexol/opencode-wizard
 
-`@aexol/opencode-wizard` is a separately releasable OpenCode server plugin package for fetching published skills from the opencode-wizard backend runtime.
+`@aexol/opencode-wizard` is a separately releasable OpenCode plugin package for fetching published skills from the opencode-wizard backend runtime and surfacing plugin status in the TUI.
 
 ## Package target
 
-- `oc-plugin: ["server"]`
+- `oc-plugin: ["server", "tui"]`
 - `./server` → `dist/server.js`
+- `./tui` → `dist/tui.js`
 - no generated runtime skill directory is published; the plugin stays fetch-only at runtime
+- native OpenCode `skills.urls` is treated as a public/static registry complement, not as the private wizard delivery authority
+- the TUI shows loaded plugins, current paths, backend/auth status without tokens, available tools, `skills.urls` guidance, the backend-published GLOBAL/PROJECT delivery model, policy labels, and catalog counts/names when passive fetch succeeds
 
 ## Local development
 
-This monorepo still path-loads the same package from `./plugin/opencode-wizard-skills` during local OpenCode development.
+This monorepo still path-loads the same package from `./plugin/opencode-wizard` during local OpenCode development.
 
 Backend origin resolution keeps local-first behavior only when the plugin is executing from a local module path/check-out. In that case it still prefers repo `.env`/`PORT`, then `APP_URL`, then falls back to `http://localhost:8080`. For the packaged/published plugin, the same config values still win when present, but the fallback origin is `https://opencode-wizard.aexol.work`.
 
@@ -34,11 +37,27 @@ OpenCode server/plugin host can install the published package by package name in
 
 For repo-local development, continue using the local path-based config already documented in this repository.
 
+## Native `skills.urls` compatibility
+
+OpenCode's native `skills.urls` support downloads public/static skill registries from base URLs that expose an `index.json` and file paths under that base URL. Current support has no plugin session/header integration, so it must not be pointed at private opencode-wizard skill delivery.
+
+Use `skills.urls` only for public registries that are intentionally cacheable by OpenCode. Private workspace-scoped wizard skills remain authenticated and directory-scoped through `opencode_wizard_published_skills_fetch`.
+
+## Catalog discovery and auth bootstrap
+
+On chat/system-context startup, the plugin attempts to load the catalog automatically with the stored plugin session at `plugin/opencode-wizard/.generated/auth-state.json`. If no valid plugin session exists, startup stays passive and reports that interactive fetch will bootstrap browser login when needed; it does not open the browser from system context.
+
+Call `opencode_wizard_published_skills_fetch` without `skill` or `skills` to manually bootstrap plugin login if needed and return catalog-only discovery output for the current directory scope.
+
+No-arg discovery returns published skill summaries, assignment counts split into `global` and `project`, policy metadata, and no markdown bodies. Existing `skill` and `skills` calls still fetch one or more full skill body/detail payloads by slug, artifact name, or skill name.
+
+`GLOBAL_CONTEXT` skills are active context skills and are not meant to be installed per project. `PROJECT_INSTALLABLE` skills are gallery/installable skills that may be attached globally or to a workspace/path through assignment records; those assignments remain the source of truth for what is active in a catalog response.
+
 ## Release flow
 
-1. Bump `version` in `plugin/opencode-wizard-skills/package.json`.
+1. Bump `version` in `plugin/opencode-wizard/package.json`.
 2. Run `npm run plugin:skills:release:check` from the repo root.
-3. If you are following the repo release-tag convention, create Git tag `plugin-opencode-wizard-skills-v<version>`.
+3. If you are following the repo release-tag convention, create Git tag `plugin-opencode-wizard-v<version>`.
 4. Push the release commit/tag so GitLab can run the shared npm public publish job.
 
-The CI publish job comes from `ci/templates/node/npm-publish-public.yml`, stays manual on the repo `deploy` stage, runs from `plugin/opencode-wizard-skills` via `APP_ROOT`, builds the package with `npm run build --if-present`, deletes the inherited `@aexol` GitLab registry override, and then publishes `@aexol/opencode-wizard` with `npm publish --access public --registry https://registry.npmjs.org/`.
+The CI publish job comes from `ci/templates/node/npm-publish-public.yml`, stays manual on the repo `deploy` stage, runs from `plugin/opencode-wizard` via `APP_ROOT`, builds the package with `npm run build --if-present`, deletes the inherited `@aexol` GitLab registry override, and then publishes `@aexol/opencode-wizard` with `npm publish --access public --registry https://registry.npmjs.org/`.

package/package.json

@@ -1,15 +1,20 @@
 {
   "name": "@aexol/opencode-wizard",
-  "version": "0.1.0",
-  "description": "OpenCode server plugin for opencode-wizard published skills",
+  "version": "0.1.2",
+  "description": "OpenCode plugin for opencode-wizard published skills",
   "type": "module",
   "oc-plugin": [
-    "server"
+    "server",
+    "tui"
   ],
   "exports": {
     "./server": {
       "default": "./dist/server.js",
       "types": "./dist/server.d.ts"
+    },
+    "./tui": {
+      "default": "./dist/tui.js",
+      "types": "./dist/tui.d.ts"
     }
   },
   "files": [
@@ -17,7 +22,7 @@
   ],
   "scripts": {
     "release:check": "npm run typecheck && npm run build",
-    "build": "tsc -p tsconfig.json",
+    "build": "node ./build.mjs",
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "smoke:published-skills": "node ./dist/smoke-published-skills.js"
   },
@@ -27,7 +32,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://gitlab.com/aexol/open-source/opencode-wizard.git",
-    "directory": "plugin/opencode-wizard-skills"
+    "directory": "plugin/opencode-wizard"
   },
   "keywords": [
     "opencode",
@@ -40,10 +45,16 @@
     "opencode": ">=1.14.18 <2"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "^1.14.18"
+    "@opencode-ai/plugin": "^1.14.18",
+    "@opentui/core": "0.1.103",
+    "@opentui/solid": "0.1.103",
+    "solid-js": "1.9.11"
   },
   "devDependencies": {
+    "@babel/core": "^7.28.4",
+    "@babel/preset-typescript": "^7.27.1",
     "@types/node": "^22.12.0",
+    "babel-preset-solid": "1.9.10",
     "typescript": "^5.9.2"
   }
 }

package/dist/server.d.ts

@@ -1,130 +0,0 @@
-import { type Plugin } from '@opencode-ai/plugin';
-type ResolvedConfig = {
-    backendOrigin: string;
-    graphqlUrl: string;
-    authSessionUrl: string;
-    presenceUrl: string;
-    actionsUrl: string;
-    fallbackWorkspaceSlug: string;
-    rootSkillSeedPath: string;
-    authStatePath: string;
-};
-type PublishedSkillCatalogPayload = {
-    workspace: {
-        id: string;
-        slug: string;
-        name: string;
-        repositoryUrl?: string | null;
-        defaultBranch?: string | null;
-        status: string;
-    };
-    directoryPath: string;
-    skills: PublishedSkillCatalogItem[];
-};
-type PublishedSkillCatalogItem = {
-    assignmentSource: string;
-    assignmentType: string;
-    scopePath: string;
-    includeChildren?: boolean | null;
-    skill: {
-        id: string;
-        slug: string;
-        name: string;
-        summary?: string | null;
-        status: string;
-        tags: PublishedSkillTag[];
-    };
-    skillVersion: {
-        id: string;
-        version: string;
-        title?: string | null;
-        summary?: string | null;
-        status: string;
-    };
-    publishedArtifact: {
-        id: string;
-        frontmatterName: string;
-        frontmatterDescription: string;
-        checksum: string;
-        publishedAt: string;
-    };
-};
-type PublishedSkillFacet = {
-    id: string;
-    slug: string;
-    label: string;
-    description?: string | null;
-};
-type PublishedSkillTag = {
-    id: string;
-    slug: string;
-    label: string;
-    description?: string | null;
-    facet?: PublishedSkillFacet | null;
-};
-type PublishedSkillFacetSummary = {
-    slug: string;
-    label: string;
-    description: string | null;
-};
-type PublishedSkillTagSummary = {
-    slug: string;
-    label: string;
-    description: string | null;
-    facet: PublishedSkillFacetSummary | null;
-};
-type PublishedSkillDetailItem = PublishedSkillCatalogItem & {
-    publishedArtifact: PublishedSkillCatalogItem['publishedArtifact'] & {
-        markdownBody: string;
-        renderedContent: string;
-    };
-};
-type PublishedSkillSummary = {
-    skillSlug: string;
-    skillName: string;
-    artifactName: string;
-    artifactDescription: string;
-    version: string;
-    assignmentSource: string;
-    assignmentType: string;
-    scopePath: string;
-    includeChildren: boolean | null;
-    checksum: string;
-    publishedAt: string;
-    identifiers: string[];
-    tags: PublishedSkillTagSummary[];
-};
-type PublishedSkillDetail = PublishedSkillSummary & {
-    skillId: string;
-    skillVersionId: string;
-    artifactId: string;
-    markdownDocument: string;
-    markdownBody: string;
-    renderedContent: string;
-};
-type PublishedSkillsSuccessState = {
-    pluginId: string;
-    runtimeMode: 'tool_fetch_only';
-    workspace: PublishedSkillCatalogPayload['workspace'];
-    directoryPath: string;
-    rootSkillSeedPath: string;
-    availableTools: string[];
-    publishedSkillCount: number;
-    facets: PublishedSkillFacetSummary[];
-    skills: PublishedSkillSummary[];
-};
-export declare const resolveConfig: (worktree: string) => Promise<ResolvedConfig>;
-export declare const buildSkillMarkdown: (item: PublishedSkillDetailItem) => string;
-export declare const toPublishedSkillDetail: (item: PublishedSkillDetailItem) => PublishedSkillDetail;
-export declare const toPublishedSkillCatalog: (payload: PublishedSkillCatalogPayload) => PublishedSkillsSuccessState;
-export declare const selectPublishedSkills: <TItem extends PublishedSkillCatalogItem>(payload: Omit<PublishedSkillCatalogPayload, "skills"> & {
-    skills: TItem[];
-}, identifiers: string[]) => {
-    selectedItems: TItem[];
-    missingIdentifiers: string[];
-};
-declare const _default: {
-    id: string;
-    server: Plugin;
-};
-export default _default;