@aexol/opencode-wizard 0.1.0

package/README.md

@@ -0,0 +1,44 @@
+# @aexol/opencode-wizard
+
+`@aexol/opencode-wizard` is a separately releasable OpenCode server plugin package for fetching published skills from the opencode-wizard backend runtime.
+
+## Package target
+
+- `oc-plugin: ["server"]`
+- `./server` → `dist/server.js`
+- no generated runtime skill directory is published; the plugin stays fetch-only at runtime
+
+## Local development
+
+This monorepo still path-loads the same package from `./plugin/opencode-wizard-skills` 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`.
+
+Useful commands:
+
+```bash
+npm run typecheck
+npm run build
+npm run release:check
+```
+
+## Published package usage
+
+OpenCode server/plugin host can install the published package by package name instead of a repo-local path:
+
+```jsonc
+{
+  "plugin": ["@aexol/opencode-wizard@latest"]
+}
+```
+
+For repo-local development, continue using the local path-based config already documented in this repository.
+
+## 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>`.
+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/`.

package/dist/server.d.ts

@@ -0,0 +1,130 @@
+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;