@aexol/opencode-wizard 0.1.0 → 0.1.3

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`.
-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>`.
+1. Bump `version` in `plugin/opencode-wizard/package.json`.
+2. Run `npm run plugin:release:check` from the repo root.
+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/dist/server.d.ts

@@ -1,4 +1,4 @@
-import { type Plugin } from '@opencode-ai/plugin';
+export declare const PLUGIN_ID = "opencode-wizard";
 type ResolvedConfig = {
     backendOrigin: string;
     graphqlUrl: string;
@@ -9,7 +9,15 @@ type ResolvedConfig = {
     rootSkillSeedPath: string;
     authStatePath: string;
 };
-type PublishedSkillCatalogPayload = {
+type WorkspaceResolution = {
+    requestedDirectory: string;
+    repositoryRoot: string;
+    repositoryUrl: string | null;
+    fallbackWorkspaceSlug: string | null;
+    directoryPath: string;
+    cacheKey: string;
+};
+export type PublishedSkillCatalogPayload = {
     workspace: {
         id: string;
         slug: string;
@@ -21,7 +29,7 @@ type PublishedSkillCatalogPayload = {
     directoryPath: string;
     skills: PublishedSkillCatalogItem[];
 };
-type PublishedSkillCatalogItem = {
+export type PublishedSkillCatalogItem = {
     assignmentSource: string;
     assignmentType: string;
     scopePath: string;
@@ -31,7 +39,9 @@ type PublishedSkillCatalogItem = {
         slug: string;
         name: string;
         summary?: string | null;
+        whenToUse?: string | null;
         status: string;
+        installPolicy: PublishedSkillInstallPolicy;
         tags: PublishedSkillTag[];
     };
     skillVersion: {
@@ -73,17 +83,42 @@ type PublishedSkillTagSummary = {
     description: string | null;
     facet: PublishedSkillFacetSummary | null;
 };
-type PublishedSkillDetailItem = PublishedSkillCatalogItem & {
+type PublishedSkillInstallPolicy = 'GLOBAL_CONTEXT' | 'PROJECT_INSTALLABLE';
+export type PublishedSkillDetailItem = PublishedSkillCatalogItem & {
     publishedArtifact: PublishedSkillCatalogItem['publishedArtifact'] & {
         markdownBody: string;
         renderedContent: string;
     };
 };
+type AuthState = {
+    pluginId: string;
+    sessionToken: string;
+    expiresAt: string;
+    authenticatedAt: string;
+    userId: string;
+    email: string;
+};
+type FetchResult = {
+    ok: true;
+    status: 'ready';
+    authMode: 'session';
+    payload: PublishedSkillCatalogPayload;
+    fetchedAt: string;
+    source: 'network' | 'cache';
+} | {
+    ok: false;
+    status: 'missing_auth' | 'request_failed';
+    authMode: 'missing' | 'session';
+    message: string;
+    fetchedAt: string;
+    source: 'network' | 'cache';
+};
 type PublishedSkillSummary = {
     skillSlug: string;
     skillName: string;
     artifactName: string;
     artifactDescription: string;
+    whenToUse: string | null;
     version: string;
     assignmentSource: string;
     assignmentType: string;
@@ -93,6 +128,9 @@ type PublishedSkillSummary = {
     publishedAt: string;
     identifiers: string[];
     tags: PublishedSkillTagSummary[];
+    contextKind: 'global' | 'project';
+    installPolicy: PublishedSkillInstallPolicy;
+    policyLabel: string;
 };
 type PublishedSkillDetail = PublishedSkillSummary & {
     skillId: string;
@@ -102,17 +140,69 @@ type PublishedSkillDetail = PublishedSkillSummary & {
     markdownBody: string;
     renderedContent: string;
 };
+type OpencodePluginServerInput = {
+    worktree: string;
+    directory: string;
+};
+type OpencodePluginSystemTransformOutput = {
+    system: string[];
+};
+type OpencodePluginServer = (input: OpencodePluginServerInput) => Promise<{
+    tool: Record<string, unknown>;
+    'experimental.chat.system.transform': (hookInput: unknown, output: OpencodePluginSystemTransformOutput) => Promise<void>;
+}>;
 type PublishedSkillsSuccessState = {
     pluginId: string;
     runtimeMode: 'tool_fetch_only';
+    deliveryModel: 'backend_published_global_project_assignments';
     workspace: PublishedSkillCatalogPayload['workspace'];
     directoryPath: string;
     rootSkillSeedPath: string;
     availableTools: string[];
     publishedSkillCount: number;
+    assignmentCounts: {
+        global: number;
+        project: number;
+        other: number;
+    };
     facets: PublishedSkillFacetSummary[];
     skills: PublishedSkillSummary[];
 };
+export declare const AVAILABLE_PUBLISHED_SKILL_TOOLS: string[];
+export type NativeSkillsUrlCompatibility = {
+    configKey: 'skills.urls';
+    deliveryMode: 'public_static_registry';
+    wizardPrivateDelivery: 'authenticated_scoped_fetch_tool';
+    authSupport: 'none';
+    guidance: string;
+};
+export declare const NATIVE_SKILLS_URL_COMPATIBILITY: NativeSkillsUrlCompatibility;
+export type PluginAuthStateSummary = {
+    status: 'missing' | 'authenticated';
+    email: string | null;
+    userId: string | null;
+    authenticatedAt: string | null;
+    expiresAt: string | null;
+};
+export type PluginStatusSnapshot = {
+    pluginId: string;
+    runtimeMode: 'tool_fetch_only';
+    nativeSkillsUrlCompatibility: NativeSkillsUrlCompatibility;
+    backendOrigin: string;
+    graphqlUrl: string;
+    fallbackWorkspaceSlug: string;
+    workspaceResolution: ReturnType<typeof toWorkspaceResolutionOutput>;
+    rootSkillSeedPath: string;
+    authStatePath: string;
+    authState: PluginAuthStateSummary;
+    status: FetchResult['status'];
+    authMode: FetchResult['authMode'];
+    fetchedAt: string;
+    source: FetchResult['source'];
+    availableTools: typeof AVAILABLE_PUBLISHED_SKILL_TOOLS;
+    message: string | null;
+    catalog: PublishedSkillsSuccessState | null;
+};
 export declare const resolveConfig: (worktree: string) => Promise<ResolvedConfig>;
 export declare const buildSkillMarkdown: (item: PublishedSkillDetailItem) => string;
 export declare const toPublishedSkillDetail: (item: PublishedSkillDetailItem) => PublishedSkillDetail;
@@ -123,8 +213,21 @@ export declare const selectPublishedSkills: <TItem extends PublishedSkillCatalog
     selectedItems: TItem[];
     missingIdentifiers: string[];
 };
+declare const toWorkspaceResolutionOutput: (resolution: WorkspaceResolution) => {
+    requestedDirectory: string;
+    repositoryRoot: string;
+    repositoryUrl: string | null;
+    fallbackWorkspaceSlug: string | null;
+    directoryPath: string;
+};
+export declare const toPluginAuthStateSummary: (authState: AuthState | null) => PluginAuthStateSummary;
+export declare const resolvePluginStatusSnapshot: ({ worktree, directory, signal, }: {
+    worktree: string;
+    directory: string;
+    signal: AbortSignal;
+}) => Promise<PluginStatusSnapshot>;
 declare const _default: {
     id: string;
-    server: Plugin;
+    server: OpencodePluginServer;
 };
 export default _default;