@aexol/opencode-wizard 0.3.11 → 0.4.0

package/README.md

@@ -24,6 +24,7 @@ npm run typecheck
 npm run test
 npm run build
 npm run release:check
+npm pack --dry-run
 ```
 
 ## Published package usage
@@ -81,4 +82,6 @@ Editors can import external artifacts without writing project files via `opencod
 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` 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`, runs `npm run release:check` including `npm pack --dry-run`, deletes the inherited `@aexol` GitLab registry override, packs the exact release tarball with `npm pack`, and publishes that tarball with `npm publish --provenance --access public --registry https://registry.npmjs.org/ ./*.tgz`.
+
+GitLab provides a `SIGSTORE_ID_TOKEN` (`aud: sigstore`) for npm provenance, and the packed `*.tgz` is retained as a 30-day job artifact. The current flow still requires the existing `NPM_AUTH_TOKEN`; npm trusted publishing for GitLab would be the stronger future option once configured because it can remove the long-lived npm token. After release, `npm audit signatures` from a throwaway install is an optional registry verification check.

package/dist/graphql-operations.d.ts

@@ -1,9 +1,9 @@
-export declare const PUBLISHED_SKILLS_CATALOG_QUERY = "\n  query PluginPublishedSkills($input: PublishedSkillsDeliveryInput!) {\n    pluginPublishedSkills(input: $input) {\n      workspace {\n        id\n        slug\n        name\n        repositoryUrl\n        defaultBranch\n        status\n      }\n      directoryPath\n      skills {\n        \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  \n  skill {\n    id\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n    tags {\n      id\n      slug\n      label\n      description\n      facet {\n        id\n        slug\n        label\n        description\n      }\n    }\n  }\n  skillVersion {\n    id\n    version\n    title\n    summary\n    status\n  }\n  publishedArtifact {\n    id\n    frontmatterName\n    frontmatterDescription\n    checksum\n    publishedAt\n    fileCount\n  }\n\n\n      }\n      catalogSkills {\n        \n  skill {\n    id\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n    tags {\n      id\n      slug\n      label\n      description\n      facet {\n        id\n        slug\n        label\n        description\n      }\n    }\n  }\n  skillVersion {\n    id\n    version\n    title\n    summary\n    status\n  }\n  publishedArtifact {\n    id\n    frontmatterName\n    frontmatterDescription\n    checksum\n    publishedAt\n    fileCount\n  }\n\n      }\n      userPreferences {\n        scopeKey\n        userKey\n        ignoredSkills {\n          \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  \n  skill {\n    id\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n    tags {\n      id\n      slug\n      label\n      description\n      facet {\n        id\n        slug\n        label\n        description\n      }\n    }\n  }\n  skillVersion {\n    id\n    version\n    title\n    summary\n    status\n  }\n  publishedArtifact {\n    id\n    frontmatterName\n    frontmatterDescription\n    checksum\n    publishedAt\n    fileCount\n  }\n\n\n        }\n      }\n    }\n  }\n";
-export declare const SET_PUBLISHED_SKILL_PREFERENCE_MUTATION = "\n  mutation SetPublishedSkillPreference($input: SetPublishedSkillPreferenceInput!) {\n    setPublishedSkillPreference(input: $input) {\n      scopeKey\n      userKey\n      ignoredSkills {\n        \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  \n  skill {\n    id\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n    tags {\n      id\n      slug\n      label\n      description\n      facet {\n        id\n        slug\n        label\n        description\n      }\n    }\n  }\n  skillVersion {\n    id\n    version\n    title\n    summary\n    status\n  }\n  publishedArtifact {\n    id\n    frontmatterName\n    frontmatterDescription\n    checksum\n    publishedAt\n    fileCount\n  }\n\n\n      }\n    }\n  }\n";
+export declare const PUBLISHED_SKILLS_CATALOG_QUERY = "\n  query PluginPublishedSkills($input: PublishedSkillsDeliveryInput!) {\n    pluginPublishedSkills(input: $input) {\n      workspace {\n        id\n        slug\n        name\n        repositoryUrl\n        defaultBranch\n        status\n      }\n      directoryPath\n      skills {\n        \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  relevance\n  recommendationReason\n  \n  skill {\n    id\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n    tags {\n      id\n      slug\n      label\n      description\n      facet {\n        id\n        slug\n        label\n        description\n      }\n    }\n  }\n  skillVersion {\n    id\n    version\n    title\n    summary\n    status\n  }\n  publishedArtifact {\n    id\n    frontmatterName\n    frontmatterDescription\n    checksum\n    publishedAt\n    fileCount\n  }\n\n\n      }\n      catalogSkills {\n        \n  relevance\n  recommendationReason\n  \n  skill {\n    id\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n    tags {\n      id\n      slug\n      label\n      description\n      facet {\n        id\n        slug\n        label\n        description\n      }\n    }\n  }\n  skillVersion {\n    id\n    version\n    title\n    summary\n    status\n  }\n  publishedArtifact {\n    id\n    frontmatterName\n    frontmatterDescription\n    checksum\n    publishedAt\n    fileCount\n  }\n\n\n      }\n      userPreferences {\n        scopeKey\n        userKey\n        ignoredSkills {\n          \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  relevance\n  recommendationReason\n  \n  skill {\n    id\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n    tags {\n      id\n      slug\n      label\n      description\n      facet {\n        id\n        slug\n        label\n        description\n      }\n    }\n  }\n  skillVersion {\n    id\n    version\n    title\n    summary\n    status\n  }\n  publishedArtifact {\n    id\n    frontmatterName\n    frontmatterDescription\n    checksum\n    publishedAt\n    fileCount\n  }\n\n\n        }\n      }\n    }\n  }\n";
+export declare const SET_PUBLISHED_SKILL_PREFERENCE_MUTATION = "\n  mutation SetPublishedSkillPreference($input: SetPublishedSkillPreferenceInput!) {\n    setPublishedSkillPreference(input: $input) {\n      scopeKey\n      userKey\n      ignoredSkills {\n        \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  relevance\n  recommendationReason\n  \n  skill {\n    id\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n    tags {\n      id\n      slug\n      label\n      description\n      facet {\n        id\n        slug\n        label\n        description\n      }\n    }\n  }\n  skillVersion {\n    id\n    version\n    title\n    summary\n    status\n  }\n  publishedArtifact {\n    id\n    frontmatterName\n    frontmatterDescription\n    checksum\n    publishedAt\n    fileCount\n  }\n\n\n      }\n    }\n  }\n";
 export declare const PUBLISHED_SKILL_DETAIL_QUERY = "\n  query PluginPublishedSkillVersionArtifact($input: PublishedSkillArtifactDetailInput!) {\n    pluginPublishedSkillVersionArtifact(input: $input) {\n      id\n      frontmatterName\n      frontmatterDescription\n      markdownBody\n      renderedContent\n      checksum\n      publishedAt\n      fileCount\n      files {\n        id\n        relativePath\n        contentType\n        content\n        checksum\n        size\n        sortOrder\n      }\n    }\n  }\n";
-export declare const WIZARD_ARTIFACTS_CATALOG_QUERY = "\n  query PluginWizardArtifacts($input: WizardArtifactsDeliveryInput!) {\n    pluginWizardArtifacts(input: $input) {\n      artifactKind\n      workspace {\n        id\n        slug\n        name\n        repositoryUrl\n        defaultBranch\n        status\n      }\n      directoryPath\n      artifacts {\n        \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  \n  artifact {\n    id\n    kind\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n  }\n  artifactVersion {\n    id\n    version\n    title\n    summary\n    status\n    frontmatterName\n    frontmatterDescription\n    checksum\n    revision\n    updatedAtCursor\n    canonicalFilePath\n    publishedAt\n    fileCount\n  }\n\n\n      }\n      catalogArtifacts {\n        \n  artifact {\n    id\n    kind\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n  }\n  artifactVersion {\n    id\n    version\n    title\n    summary\n    status\n    frontmatterName\n    frontmatterDescription\n    checksum\n    revision\n    updatedAtCursor\n    canonicalFilePath\n    publishedAt\n    fileCount\n  }\n\n      }\n      artifactPreferences {\n        scopeKey\n        userKey\n        ignoredArtifacts {\n          \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  \n  artifact {\n    id\n    kind\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n  }\n  artifactVersion {\n    id\n    version\n    title\n    summary\n    status\n    frontmatterName\n    frontmatterDescription\n    checksum\n    revision\n    updatedAtCursor\n    canonicalFilePath\n    publishedAt\n    fileCount\n  }\n\n\n        }\n      }\n      unsupportedReason\n      message\n    }\n  }\n";
+export declare const WIZARD_ARTIFACTS_CATALOG_QUERY = "\n  query PluginWizardArtifacts($input: WizardArtifactsDeliveryInput!) {\n    pluginWizardArtifacts(input: $input) {\n      artifactKind\n      workspace {\n        id\n        slug\n        name\n        repositoryUrl\n        defaultBranch\n        status\n      }\n      directoryPath\n      artifacts {\n        \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  relevance\n  recommendationReason\n  \n  artifact {\n    id\n    kind\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n  }\n  artifactVersion {\n    id\n    version\n    title\n    summary\n    status\n    frontmatterName\n    frontmatterDescription\n    checksum\n    revision\n    updatedAtCursor\n    canonicalFilePath\n    publishedAt\n    fileCount\n  }\n\n\n      }\n      catalogArtifacts {\n        \n  relevance\n  recommendationReason\n  \n  artifact {\n    id\n    kind\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n  }\n  artifactVersion {\n    id\n    version\n    title\n    summary\n    status\n    frontmatterName\n    frontmatterDescription\n    checksum\n    revision\n    updatedAtCursor\n    canonicalFilePath\n    publishedAt\n    fileCount\n  }\n\n\n      }\n      artifactPreferences {\n        scopeKey\n        userKey\n        ignoredArtifacts {\n          \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  relevance\n  recommendationReason\n  \n  artifact {\n    id\n    kind\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n  }\n  artifactVersion {\n    id\n    version\n    title\n    summary\n    status\n    frontmatterName\n    frontmatterDescription\n    checksum\n    revision\n    updatedAtCursor\n    canonicalFilePath\n    publishedAt\n    fileCount\n  }\n\n\n        }\n      }\n      unsupportedReason\n      message\n    }\n  }\n";
 export declare const WIZARD_ARTIFACT_DETAIL_QUERY = "\n  query PluginWizardArtifactVersion($input: WizardArtifactDetailInput!) {\n    pluginWizardArtifactVersion(input: $input) {\n      id\n      artifact {\n        id\n        kind\n        slug\n        name\n        summary\n        whenToUse\n        status\n        installPolicy\n      }\n      version\n      title\n      summary\n      status\n      frontmatterName\n      frontmatterDescription\n      markdownBody\n      renderedContent\n      checksum\n      revision\n      updatedAtCursor\n      canonicalFilePath\n      publishedAt\n      fileCount\n      files {\n        id\n        relativePath\n        contentType\n        content\n        checksum\n        size\n        sortOrder\n      }\n    }\n  }\n";
 export declare const CURRENT_USER_ROLE_QUERY = "\n  query PluginCurrentUserRole {\n    user {\n      me {\n        _id\n        email\n        role\n      }\n    }\n  }\n";
-export declare const SET_WIZARD_ARTIFACT_PREFERENCE_MUTATION = "\n  mutation SetWizardArtifactPreference($input: SetWizardArtifactPreferenceInput!) {\n    setWizardArtifactPreference(input: $input) {\n      scopeKey\n      userKey\n      ignoredArtifacts {\n        \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  \n  artifact {\n    id\n    kind\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n  }\n  artifactVersion {\n    id\n    version\n    title\n    summary\n    status\n    frontmatterName\n    frontmatterDescription\n    checksum\n    revision\n    updatedAtCursor\n    canonicalFilePath\n    publishedAt\n    fileCount\n  }\n\n\n      }\n    }\n  }\n";
+export declare const SET_WIZARD_ARTIFACT_PREFERENCE_MUTATION = "\n  mutation SetWizardArtifactPreference($input: SetWizardArtifactPreferenceInput!) {\n    setWizardArtifactPreference(input: $input) {\n      scopeKey\n      userKey\n      ignoredArtifacts {\n        \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  relevance\n  recommendationReason\n  \n  artifact {\n    id\n    kind\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n  }\n  artifactVersion {\n    id\n    version\n    title\n    summary\n    status\n    frontmatterName\n    frontmatterDescription\n    checksum\n    revision\n    updatedAtCursor\n    canonicalFilePath\n    publishedAt\n    fileCount\n  }\n\n\n      }\n    }\n  }\n";
 export declare const CREATE_OR_UPDATE_SKILL_FROM_MARKDOWN_MUTATION = "\n  mutation CreateOrUpdateSkillFromMarkdown($markdownContent: String!) {\n    admin {\n      createOrUpdateSkillFromMarkdown(markdownContent: $markdownContent) {\n        success\n        skillSlug\n        skillVersionId\n        artifactSlug\n        artifactVersionId\n        errors\n      }\n    }\n  }\n";
 export declare const IMPORT_WIZARD_ARTIFACT_SNAPSHOT_MUTATION = "\n  mutation ImportWizardArtifactSnapshot($input: ImportWizardArtifactSnapshotInput!) {\n    importWizardArtifactSnapshot(input: $input) {\n      success\n      skillSlug\n      skillVersionId\n      artifactSlug\n      artifactVersionId\n      errors\n    }\n  }\n";

package/dist/graphql-operations.js

@@ -41,6 +41,13 @@ const PUBLISHED_SKILL_ASSIGNMENT_FIELDS = `
   assignmentType
   scopePath
   includeChildren
+  relevance
+  recommendationReason
+  ${PUBLISHED_SKILL_CORE_FIELDS}
+`;
+const PUBLISHED_SKILL_INSTALLABLE_FIELDS = `
+  relevance
+  recommendationReason
   ${PUBLISHED_SKILL_CORE_FIELDS}
 `;
 export const PUBLISHED_SKILLS_CATALOG_QUERY = `
@@ -59,7 +66,7 @@ export const PUBLISHED_SKILLS_CATALOG_QUERY = `
         ${PUBLISHED_SKILL_ASSIGNMENT_FIELDS}
       }
       catalogSkills {
-        ${PUBLISHED_SKILL_CORE_FIELDS}
+        ${PUBLISHED_SKILL_INSTALLABLE_FIELDS}
       }
       userPreferences {
         scopeKey
@@ -137,6 +144,13 @@ const WIZARD_ARTIFACT_ASSIGNMENT_FIELDS = `
   assignmentType
   scopePath
   includeChildren
+  relevance
+  recommendationReason
+  ${WIZARD_ARTIFACT_CORE_FIELDS}
+`;
+const WIZARD_ARTIFACT_INSTALLABLE_FIELDS = `
+  relevance
+  recommendationReason
   ${WIZARD_ARTIFACT_CORE_FIELDS}
 `;
 export const WIZARD_ARTIFACTS_CATALOG_QUERY = `
@@ -156,7 +170,7 @@ export const WIZARD_ARTIFACTS_CATALOG_QUERY = `
         ${WIZARD_ARTIFACT_ASSIGNMENT_FIELDS}
       }
       catalogArtifacts {
-        ${WIZARD_ARTIFACT_CORE_FIELDS}
+        ${WIZARD_ARTIFACT_INSTALLABLE_FIELDS}
       }
       artifactPreferences {
         scopeKey

package/dist/graphql-operations.js.map

@@ -1 +1 @@
-{"version":3,"names":["PUBLISHED_SKILL_CORE_FIELDS","PUBLISHED_SKILL_ASSIGNMENT_FIELDS","PUBLISHED_SKILLS_CATALOG_QUERY","SET_PUBLISHED_SKILL_PREFERENCE_MUTATION","PUBLISHED_SKILL_DETAIL_QUERY","WIZARD_ARTIFACT_CORE_FIELDS","WIZARD_ARTIFACT_ASSIGNMENT_FIELDS","WIZARD_ARTIFACTS_CATALOG_QUERY","WIZARD_ARTIFACT_DETAIL_QUERY","CURRENT_USER_ROLE_QUERY","SET_WIZARD_ARTIFACT_PREFERENCE_MUTATION","CREATE_OR_UPDATE_SKILL_FROM_MARKDOWN_MUTATION","IMPORT_WIZARD_ARTIFACT_SNAPSHOT_MUTATION"],"sources":["../src/graphql-operations.ts"],"sourcesContent":["const PUBLISHED_SKILL_CORE_FIELDS = `\n  skill {\n    id\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n    tags {\n      id\n      slug\n      label\n      description\n      facet {\n        id\n        slug\n        label\n        description\n      }\n    }\n  }\n  skillVersion {\n    id\n    version\n    title\n    summary\n    status\n  }\n  publishedArtifact {\n    id\n    frontmatterName\n    frontmatterDescription\n    checksum\n    publishedAt\n    fileCount\n  }\n`;\n\nconst PUBLISHED_SKILL_ASSIGNMENT_FIELDS = `\n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  ${PUBLISHED_SKILL_CORE_FIELDS}\n`;\n\nexport const PUBLISHED_SKILLS_CATALOG_QUERY = `\n  query PluginPublishedSkills($input: PublishedSkillsDeliveryInput!) {\n    pluginPublishedSkills(input: $input) {\n      workspace {\n        id\n        slug\n        name\n        repositoryUrl\n        defaultBranch\n        status\n      }\n      directoryPath\n      skills {\n        ${PUBLISHED_SKILL_ASSIGNMENT_FIELDS}\n      }\n      catalogSkills {\n        ${PUBLISHED_SKILL_CORE_FIELDS}\n      }\n      userPreferences {\n        scopeKey\n        userKey\n        ignoredSkills {\n          ${PUBLISHED_SKILL_ASSIGNMENT_FIELDS}\n        }\n      }\n    }\n  }\n`;\n\nexport const SET_PUBLISHED_SKILL_PREFERENCE_MUTATION = `\n  mutation SetPublishedSkillPreference($input: SetPublishedSkillPreferenceInput!) {\n    setPublishedSkillPreference(input: $input) {\n      scopeKey\n      userKey\n      ignoredSkills {\n        ${PUBLISHED_SKILL_ASSIGNMENT_FIELDS}\n      }\n    }\n  }\n`;\n\nexport const PUBLISHED_SKILL_DETAIL_QUERY = `\n  query PluginPublishedSkillVersionArtifact($input: PublishedSkillArtifactDetailInput!) {\n    pluginPublishedSkillVersionArtifact(input: $input) {\n      id\n      frontmatterName\n      frontmatterDescription\n      markdownBody\n      renderedContent\n      checksum\n      publishedAt\n      fileCount\n      files {\n        id\n        relativePath\n        contentType\n        content\n        checksum\n        size\n        sortOrder\n      }\n    }\n  }\n`;\n\nconst WIZARD_ARTIFACT_CORE_FIELDS = `\n  artifact {\n    id\n    kind\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n  }\n  artifactVersion {\n    id\n    version\n    title\n    summary\n    status\n    frontmatterName\n    frontmatterDescription\n    checksum\n    revision\n    updatedAtCursor\n    canonicalFilePath\n    publishedAt\n    fileCount\n  }\n`;\n\nconst WIZARD_ARTIFACT_ASSIGNMENT_FIELDS = `\n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  ${WIZARD_ARTIFACT_CORE_FIELDS}\n`;\n\nexport const WIZARD_ARTIFACTS_CATALOG_QUERY = `\n  query PluginWizardArtifacts($input: WizardArtifactsDeliveryInput!) {\n    pluginWizardArtifacts(input: $input) {\n      artifactKind\n      workspace {\n        id\n        slug\n        name\n        repositoryUrl\n        defaultBranch\n        status\n      }\n      directoryPath\n      artifacts {\n        ${WIZARD_ARTIFACT_ASSIGNMENT_FIELDS}\n      }\n      catalogArtifacts {\n        ${WIZARD_ARTIFACT_CORE_FIELDS}\n      }\n      artifactPreferences {\n        scopeKey\n        userKey\n        ignoredArtifacts {\n          ${WIZARD_ARTIFACT_ASSIGNMENT_FIELDS}\n        }\n      }\n      unsupportedReason\n      message\n    }\n  }\n`;\n\nexport const WIZARD_ARTIFACT_DETAIL_QUERY = `\n  query PluginWizardArtifactVersion($input: WizardArtifactDetailInput!) {\n    pluginWizardArtifactVersion(input: $input) {\n      id\n      artifact {\n        id\n        kind\n        slug\n        name\n        summary\n        whenToUse\n        status\n        installPolicy\n      }\n      version\n      title\n      summary\n      status\n      frontmatterName\n      frontmatterDescription\n      markdownBody\n      renderedContent\n      checksum\n      revision\n      updatedAtCursor\n      canonicalFilePath\n      publishedAt\n      fileCount\n      files {\n        id\n        relativePath\n        contentType\n        content\n        checksum\n        size\n        sortOrder\n      }\n    }\n  }\n`;\n\nexport const CURRENT_USER_ROLE_QUERY = `\n  query PluginCurrentUserRole {\n    user {\n      me {\n        _id\n        email\n        role\n      }\n    }\n  }\n`;\n\nexport const SET_WIZARD_ARTIFACT_PREFERENCE_MUTATION = `\n  mutation SetWizardArtifactPreference($input: SetWizardArtifactPreferenceInput!) {\n    setWizardArtifactPreference(input: $input) {\n      scopeKey\n      userKey\n      ignoredArtifacts {\n        ${WIZARD_ARTIFACT_ASSIGNMENT_FIELDS}\n      }\n    }\n  }\n`;\n\nexport const CREATE_OR_UPDATE_SKILL_FROM_MARKDOWN_MUTATION = `\n  mutation CreateOrUpdateSkillFromMarkdown($markdownContent: String!) {\n    admin {\n      createOrUpdateSkillFromMarkdown(markdownContent: $markdownContent) {\n        success\n        skillSlug\n        skillVersionId\n        artifactSlug\n        artifactVersionId\n        errors\n      }\n    }\n  }\n`;\n\nexport const IMPORT_WIZARD_ARTIFACT_SNAPSHOT_MUTATION = `\n  mutation ImportWizardArtifactSnapshot($input: ImportWizardArtifactSnapshotInput!) {\n    importWizardArtifactSnapshot(input: $input) {\n      success\n      skillSlug\n      skillVersionId\n      artifactSlug\n      artifactVersionId\n      errors\n    }\n  }\n`;\n"],"mappings":"AAAA,MAAMA,2BAA2B,GAAG;AACpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,MAAMC,iCAAiC,GAAG;AAC1C;AACA;AACA;AACA;AACA,IAAID,2BAA2B;AAC/B,CAAC;AAED,OAAO,MAAME,8BAA8B,GAAG;AAC9C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,UAAUD,iCAAiC;AAC3C;AACA;AACA,UAAUD,2BAA2B;AACrC;AACA;AACA;AACA;AACA;AACA,YAAYC,iCAAiC;AAC7C;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAME,uCAAuC,GAAG;AACvD;AACA;AACA;AACA;AACA;AACA,UAAUF,iCAAiC;AAC3C;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMG,4BAA4B,GAAG;AAC5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,MAAMC,2BAA2B,GAAG;AACpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,MAAMC,iCAAiC,GAAG;AAC1C;AACA;AACA;AACA;AACA,IAAID,2BAA2B;AAC/B,CAAC;AAED,OAAO,MAAME,8BAA8B,GAAG;AAC9C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,UAAUD,iCAAiC;AAC3C;AACA;AACA,UAAUD,2BAA2B;AACrC;AACA;AACA;AACA;AACA;AACA,YAAYC,iCAAiC;AAC7C;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAME,4BAA4B,GAAG;AAC5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMC,uBAAuB,GAAG;AACvC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMC,uCAAuC,GAAG;AACvD;AACA;AACA;AACA;AACA;AACA,UAAUJ,iCAAiC;AAC3C;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMK,6CAA6C,GAAG;AAC7D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMC,wCAAwC,GAAG;AACxD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC","ignoreList":[]}
+{"version":3,"names":["PUBLISHED_SKILL_CORE_FIELDS","PUBLISHED_SKILL_ASSIGNMENT_FIELDS","PUBLISHED_SKILL_INSTALLABLE_FIELDS","PUBLISHED_SKILLS_CATALOG_QUERY","SET_PUBLISHED_SKILL_PREFERENCE_MUTATION","PUBLISHED_SKILL_DETAIL_QUERY","WIZARD_ARTIFACT_CORE_FIELDS","WIZARD_ARTIFACT_ASSIGNMENT_FIELDS","WIZARD_ARTIFACT_INSTALLABLE_FIELDS","WIZARD_ARTIFACTS_CATALOG_QUERY","WIZARD_ARTIFACT_DETAIL_QUERY","CURRENT_USER_ROLE_QUERY","SET_WIZARD_ARTIFACT_PREFERENCE_MUTATION","CREATE_OR_UPDATE_SKILL_FROM_MARKDOWN_MUTATION","IMPORT_WIZARD_ARTIFACT_SNAPSHOT_MUTATION"],"sources":["../src/graphql-operations.ts"],"sourcesContent":["const PUBLISHED_SKILL_CORE_FIELDS = `\n  skill {\n    id\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n    tags {\n      id\n      slug\n      label\n      description\n      facet {\n        id\n        slug\n        label\n        description\n      }\n    }\n  }\n  skillVersion {\n    id\n    version\n    title\n    summary\n    status\n  }\n  publishedArtifact {\n    id\n    frontmatterName\n    frontmatterDescription\n    checksum\n    publishedAt\n    fileCount\n  }\n`;\n\nconst PUBLISHED_SKILL_ASSIGNMENT_FIELDS = `\n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  relevance\n  recommendationReason\n  ${PUBLISHED_SKILL_CORE_FIELDS}\n`;\n\nconst PUBLISHED_SKILL_INSTALLABLE_FIELDS = `\n  relevance\n  recommendationReason\n  ${PUBLISHED_SKILL_CORE_FIELDS}\n`;\n\nexport const PUBLISHED_SKILLS_CATALOG_QUERY = `\n  query PluginPublishedSkills($input: PublishedSkillsDeliveryInput!) {\n    pluginPublishedSkills(input: $input) {\n      workspace {\n        id\n        slug\n        name\n        repositoryUrl\n        defaultBranch\n        status\n      }\n      directoryPath\n      skills {\n        ${PUBLISHED_SKILL_ASSIGNMENT_FIELDS}\n      }\n      catalogSkills {\n        ${PUBLISHED_SKILL_INSTALLABLE_FIELDS}\n      }\n      userPreferences {\n        scopeKey\n        userKey\n        ignoredSkills {\n          ${PUBLISHED_SKILL_ASSIGNMENT_FIELDS}\n        }\n      }\n    }\n  }\n`;\n\nexport const SET_PUBLISHED_SKILL_PREFERENCE_MUTATION = `\n  mutation SetPublishedSkillPreference($input: SetPublishedSkillPreferenceInput!) {\n    setPublishedSkillPreference(input: $input) {\n      scopeKey\n      userKey\n      ignoredSkills {\n        ${PUBLISHED_SKILL_ASSIGNMENT_FIELDS}\n      }\n    }\n  }\n`;\n\nexport const PUBLISHED_SKILL_DETAIL_QUERY = `\n  query PluginPublishedSkillVersionArtifact($input: PublishedSkillArtifactDetailInput!) {\n    pluginPublishedSkillVersionArtifact(input: $input) {\n      id\n      frontmatterName\n      frontmatterDescription\n      markdownBody\n      renderedContent\n      checksum\n      publishedAt\n      fileCount\n      files {\n        id\n        relativePath\n        contentType\n        content\n        checksum\n        size\n        sortOrder\n      }\n    }\n  }\n`;\n\nconst WIZARD_ARTIFACT_CORE_FIELDS = `\n  artifact {\n    id\n    kind\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n  }\n  artifactVersion {\n    id\n    version\n    title\n    summary\n    status\n    frontmatterName\n    frontmatterDescription\n    checksum\n    revision\n    updatedAtCursor\n    canonicalFilePath\n    publishedAt\n    fileCount\n  }\n`;\n\nconst WIZARD_ARTIFACT_ASSIGNMENT_FIELDS = `\n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  relevance\n  recommendationReason\n  ${WIZARD_ARTIFACT_CORE_FIELDS}\n`;\n\nconst WIZARD_ARTIFACT_INSTALLABLE_FIELDS = `\n  relevance\n  recommendationReason\n  ${WIZARD_ARTIFACT_CORE_FIELDS}\n`;\n\nexport const WIZARD_ARTIFACTS_CATALOG_QUERY = `\n  query PluginWizardArtifacts($input: WizardArtifactsDeliveryInput!) {\n    pluginWizardArtifacts(input: $input) {\n      artifactKind\n      workspace {\n        id\n        slug\n        name\n        repositoryUrl\n        defaultBranch\n        status\n      }\n      directoryPath\n      artifacts {\n        ${WIZARD_ARTIFACT_ASSIGNMENT_FIELDS}\n      }\n      catalogArtifacts {\n        ${WIZARD_ARTIFACT_INSTALLABLE_FIELDS}\n      }\n      artifactPreferences {\n        scopeKey\n        userKey\n        ignoredArtifacts {\n          ${WIZARD_ARTIFACT_ASSIGNMENT_FIELDS}\n        }\n      }\n      unsupportedReason\n      message\n    }\n  }\n`;\n\nexport const WIZARD_ARTIFACT_DETAIL_QUERY = `\n  query PluginWizardArtifactVersion($input: WizardArtifactDetailInput!) {\n    pluginWizardArtifactVersion(input: $input) {\n      id\n      artifact {\n        id\n        kind\n        slug\n        name\n        summary\n        whenToUse\n        status\n        installPolicy\n      }\n      version\n      title\n      summary\n      status\n      frontmatterName\n      frontmatterDescription\n      markdownBody\n      renderedContent\n      checksum\n      revision\n      updatedAtCursor\n      canonicalFilePath\n      publishedAt\n      fileCount\n      files {\n        id\n        relativePath\n        contentType\n        content\n        checksum\n        size\n        sortOrder\n      }\n    }\n  }\n`;\n\nexport const CURRENT_USER_ROLE_QUERY = `\n  query PluginCurrentUserRole {\n    user {\n      me {\n        _id\n        email\n        role\n      }\n    }\n  }\n`;\n\nexport const SET_WIZARD_ARTIFACT_PREFERENCE_MUTATION = `\n  mutation SetWizardArtifactPreference($input: SetWizardArtifactPreferenceInput!) {\n    setWizardArtifactPreference(input: $input) {\n      scopeKey\n      userKey\n      ignoredArtifacts {\n        ${WIZARD_ARTIFACT_ASSIGNMENT_FIELDS}\n      }\n    }\n  }\n`;\n\nexport const CREATE_OR_UPDATE_SKILL_FROM_MARKDOWN_MUTATION = `\n  mutation CreateOrUpdateSkillFromMarkdown($markdownContent: String!) {\n    admin {\n      createOrUpdateSkillFromMarkdown(markdownContent: $markdownContent) {\n        success\n        skillSlug\n        skillVersionId\n        artifactSlug\n        artifactVersionId\n        errors\n      }\n    }\n  }\n`;\n\nexport const IMPORT_WIZARD_ARTIFACT_SNAPSHOT_MUTATION = `\n  mutation ImportWizardArtifactSnapshot($input: ImportWizardArtifactSnapshotInput!) {\n    importWizardArtifactSnapshot(input: $input) {\n      success\n      skillSlug\n      skillVersionId\n      artifactSlug\n      artifactVersionId\n      errors\n    }\n  }\n`;\n"],"mappings":"AAAA,MAAMA,2BAA2B,GAAG;AACpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,MAAMC,iCAAiC,GAAG;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA,IAAID,2BAA2B;AAC/B,CAAC;AAED,MAAME,kCAAkC,GAAG;AAC3C;AACA;AACA,IAAIF,2BAA2B;AAC/B,CAAC;AAED,OAAO,MAAMG,8BAA8B,GAAG;AAC9C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,UAAUF,iCAAiC;AAC3C;AACA;AACA,UAAUC,kCAAkC;AAC5C;AACA;AACA;AACA;AACA;AACA,YAAYD,iCAAiC;AAC7C;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMG,uCAAuC,GAAG;AACvD;AACA;AACA;AACA;AACA;AACA,UAAUH,iCAAiC;AAC3C;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMI,4BAA4B,GAAG;AAC5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,MAAMC,2BAA2B,GAAG;AACpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,MAAMC,iCAAiC,GAAG;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA,IAAID,2BAA2B;AAC/B,CAAC;AAED,MAAME,kCAAkC,GAAG;AAC3C;AACA;AACA,IAAIF,2BAA2B;AAC/B,CAAC;AAED,OAAO,MAAMG,8BAA8B,GAAG;AAC9C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,UAAUF,iCAAiC;AAC3C;AACA;AACA,UAAUC,kCAAkC;AAC5C;AACA;AACA;AACA;AACA;AACA,YAAYD,iCAAiC;AAC7C;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMG,4BAA4B,GAAG;AAC5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMC,uBAAuB,GAAG;AACvC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMC,uCAAuC,GAAG;AACvD;AACA;AACA;AACA;AACA;AACA,UAAUL,iCAAiC;AAC3C;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMM,6CAA6C,GAAG;AAC7D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMC,wCAAwC,GAAG;AACxD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC","ignoreList":[]}

package/dist/plugin-tools.d.ts

@@ -3,12 +3,14 @@ export type PublishedSkillFetchArgs = {
     skills?: string;
     directory?: string;
     refresh?: boolean;
+    recommendationContext?: string;
 };
 export type WizardArtifactKind = 'SKILL' | 'DESIGN_DOC';
 export type WizardArtifactCatalogFetchArgs = {
     artifactKind?: string;
     directory?: string;
     refresh?: boolean;
+    recommendationContext?: string;
 };
 export type WizardArtifactFetchArgs = {
     artifactKind?: string;
@@ -16,6 +18,7 @@ export type WizardArtifactFetchArgs = {
     artifacts?: string;
     directory?: string;
     refresh?: boolean;
+    recommendationContext?: string;
 };
 export type PluginStatusArgs = {
     directory?: string;

package/dist/plugin-tools.js

@@ -11,7 +11,8 @@ export const createPublishedSkillToolDefinitions = (tool, handlers) => ({
       args: {
         artifactKind: tool.schema.string().optional().describe('Wizard artifact kind to catalog: SKILL or DESIGN_DOC; defaults to SKILL'),
         directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),
-        refresh: tool.schema.boolean().optional().describe('Bypass the local plugin cache for this request')
+        refresh: tool.schema.boolean().optional().describe('Bypass the local plugin cache for this request'),
+        recommendationContext: tool.schema.string().optional().describe('Optional metadata-only relevance/ranking context for catalog recommendations; fetched artifact bodies/files remain the authority.')
       },
       async execute(args, context) {
         return handlers.fetchWizardArtifactCatalog(args, context);
@@ -24,19 +25,20 @@ export const createPublishedSkillToolDefinitions = (tool, handlers) => ({
         artifact: tool.schema.string().optional().describe('Single artifact identifier; for SKILL this is a skill slug, artifact name, or skill name'),
         artifacts: tool.schema.string().optional().describe('One or more comma-separated or newline-separated artifact identifiers'),
         directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),
-        refresh: tool.schema.boolean().optional().describe('Bypass the local plugin cache for this request')
+        refresh: tool.schema.boolean().optional().describe('Bypass the local plugin cache for this request'),
+        recommendationContext: tool.schema.string().optional().describe('Optional metadata-only relevance/ranking context for artifact discovery and suggestions; fetched bodies/files remain the authority.')
       },
       async execute(args, context) {
         return handlers.fetchWizardArtifacts(args, context);
       }
     }),
     opencode_wizard_artifact_preference_set: tool({
-      description: 'Always-available canonical wizard artifact preference tool. Supports SKILL and DESIGN_DOC install/uninstall/ignore/unignore through server-backed artifact preference APIs.',
+      description: 'Always-available canonical wizard artifact preference tool. Supports SKILL and DESIGN_DOC install/uninstall/ignore/unignore through server-backed artifact preference APIs. To disable a per-user global starter/global skill, call artifactKind=SKILL action=ignore preferenceScope=global; use action=unignore preferenceScope=global to enable it again.',
       args: {
         artifactKind: tool.schema.string().optional().describe('Wizard artifact kind to update: SKILL or DESIGN_DOC; defaults to SKILL'),
         artifact: tool.schema.string().describe('Artifact identifier; for SKILL this is the published skill slug'),
         action: tool.schema.string().describe('Preference action: install, uninstall, ignore, or unignore'),
-        preferenceScope: tool.schema.string().optional().describe('Preference scope for the action: project or global; defaults to project'),
+        preferenceScope: tool.schema.string().optional().describe('Preference scope for the action: project/workspace or global; defaults to project. Use global with ignore/unignore to disable or enable starter/global skills for the current user.'),
         directory: tool.schema.string().optional().describe('Optional absolute or relative directory override')
       },
       async execute(args, context) {
@@ -49,18 +51,19 @@ export const createPublishedSkillToolDefinitions = (tool, handlers) => ({
         skill: tool.schema.string().optional().describe('Single skill slug, artifact name, or skill name; backward-compatible with comma/newline-delimited lists'),
         skills: tool.schema.string().optional().describe('One or more comma-separated or newline-separated skill slugs, artifact names, or skill names'),
         directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),
-        refresh: tool.schema.boolean().optional().describe('Bypass the local plugin cache for this request')
+        refresh: tool.schema.boolean().optional().describe('Bypass the local plugin cache for this request'),
+        recommendationContext: tool.schema.string().optional().describe('Optional metadata-only relevance/ranking context for skill recommendations; fetched SKILL.md bodies remain the authority.')
       },
       async execute(args, context) {
         return handlers.fetchPublishedSkills(args, context);
       }
     }),
     opencode_wizard_published_skill_preference_set: tool({
-      description: 'Always-available tool to install, uninstall, ignore, or unignore a backend-published wizard skill for non-TUI workflows using the same shared server-backed preference API as the TUI overlay; auth/catalog failures are returned in tool output',
+      description: 'Always-available tool to install, uninstall, ignore, or unignore a backend-published wizard skill for non-TUI workflows using the shared server-backed preference API; auth/catalog failures are returned in tool output. Disable a per-user global starter/global skill with skill=<slug> action=ignore preferenceScope=global; enable it again with action=unignore preferenceScope=global.',
       args: {
         skill: tool.schema.string().describe('Published skill slug, artifact name, or skill name to update'),
         action: tool.schema.string().describe('Preference action: install, uninstall, ignore, or unignore'),
-        preferenceScope: tool.schema.string().optional().describe('Preference scope for the action: project or global; defaults to project'),
+        preferenceScope: tool.schema.string().optional().describe('Preference scope for the action: project/workspace or global; defaults to project. Use global with ignore/unignore to turn starter/global skills off or on for the current user.'),
         directory: tool.schema.string().optional().describe('Optional absolute or relative directory override')
       },
       async execute(args, context) {

package/dist/plugin-tools.js.map

@@ -1 +1 @@
-{"version":3,"names":["AVAILABLE_PUBLISHED_SKILL_TOOLS","SHARED_PUBLISHED_SKILL_TOOLS","slice","resolveAvailableTools","role","createPublishedSkillToolDefinitions","tool","handlers","sharedTools","opencode_wizard_catalog_fetch","description","args","artifactKind","schema","string","optional","describe","directory","refresh","boolean","execute","context","fetchWizardArtifactCatalog","opencode_wizard_artifact_fetch","artifact","artifacts","fetchWizardArtifacts","opencode_wizard_artifact_preference_set","action","preferenceScope","updateWizardArtifactPreference","opencode_wizard_published_skills_fetch","skill","skills","fetchPublishedSkills","opencode_wizard_published_skill_preference_set","updatePublishedSkillPreference","opencode_wizard_status","getStatus","editorOnlyTools","opencode_wizard_editor_create_or_update_skill","markdownContent","createOrUpdateEditorSkill","opencode_wizard_editor_publish_skill","skillSlug","publishEditorSkill","opencode_wizard_artifact_import","source","slug","name","summary","importWizardArtifact"],"sources":["../src/plugin-tools.ts"],"sourcesContent":["export type PublishedSkillFetchArgs = {\n  skill?: string;\n  skills?: string;\n  directory?: string;\n  refresh?: boolean;\n};\n\nexport type WizardArtifactKind = 'SKILL' | 'DESIGN_DOC';\n\nexport type WizardArtifactCatalogFetchArgs = {\n  artifactKind?: string;\n  directory?: string;\n  refresh?: boolean;\n};\n\nexport type WizardArtifactFetchArgs = {\n  artifactKind?: string;\n  artifact?: string;\n  artifacts?: string;\n  directory?: string;\n  refresh?: boolean;\n};\n\nexport type PluginStatusArgs = {\n  directory?: string;\n};\n\nexport type PublishedSkillPreferenceArgs = {\n  skill: string;\n  action: string;\n  preferenceScope?: string;\n  directory?: string;\n};\n\nexport type WizardArtifactPreferenceArgs = {\n  artifactKind?: string;\n  artifact: string;\n  action: string;\n  preferenceScope?: string;\n  directory?: string;\n};\n\nexport type EditorPublishSkillArgs = {\n  skillSlug: string;\n  directory?: string;\n};\n\nexport type EditorCreateOrUpdateSkillArgs = {\n  markdownContent: string;\n  directory?: string;\n};\n\nexport type WizardArtifactImportArgs = {\n  artifactKind?: string;\n  source: string;\n  slug?: string;\n  skill?: string;\n  name?: string;\n  summary?: string;\n  directory?: string;\n};\n\ntype ToolSchemaValue<TSelf> = {\n  optional: () => TSelf;\n  describe: (description: string) => TSelf;\n};\n\ntype ToolSchema = {\n  string: () => ToolSchemaValue<ToolSchemaValue<unknown>>;\n  boolean: () => ToolSchemaValue<ToolSchemaValue<unknown>>;\n};\n\nexport type ToolExecuteContext = {\n  directory: string;\n  abort: AbortSignal;\n  metadata: (payload: { title: string; metadata: Record<string, string> }) => void;\n};\n\ntype ToolDefinition<TArgs extends object> = {\n  description: string;\n  args: { [K in keyof TArgs]-?: unknown };\n  execute: (args: TArgs, context: ToolExecuteContext) => Promise<unknown>;\n};\n\nexport type ToolFactory = (<TArgs extends object>(definition: ToolDefinition<TArgs>) => unknown) & {\n  schema: ToolSchema;\n};\n\ntype PublishedSkillToolHandlers = {\n  fetchPublishedSkills: (args: PublishedSkillFetchArgs, context: ToolExecuteContext) => Promise<unknown>;\n  fetchWizardArtifactCatalog: (args: WizardArtifactCatalogFetchArgs, context: ToolExecuteContext) => Promise<unknown>;\n  fetchWizardArtifacts: (args: WizardArtifactFetchArgs, context: ToolExecuteContext) => Promise<unknown>;\n  updatePublishedSkillPreference: (args: PublishedSkillPreferenceArgs, context: ToolExecuteContext) => Promise<unknown>;\n  updateWizardArtifactPreference: (args: WizardArtifactPreferenceArgs, context: ToolExecuteContext) => Promise<unknown>;\n  getStatus: (args: PluginStatusArgs, context: ToolExecuteContext) => Promise<unknown>;\n  createOrUpdateEditorSkill: (args: EditorCreateOrUpdateSkillArgs, context: ToolExecuteContext) => Promise<unknown>;\n  publishEditorSkill: (args: EditorPublishSkillArgs, context: ToolExecuteContext) => Promise<unknown>;\n  importWizardArtifact: (args: WizardArtifactImportArgs, context: ToolExecuteContext) => Promise<unknown>;\n};\n\nexport const AVAILABLE_PUBLISHED_SKILL_TOOLS = [\n  'opencode_wizard_catalog_fetch',\n  'opencode_wizard_artifact_fetch',\n  'opencode_wizard_artifact_preference_set',\n  'opencode_wizard_published_skills_fetch',\n  'opencode_wizard_published_skill_preference_set',\n  'opencode_wizard_status',\n  'opencode_wizard_editor_create_or_update_skill',\n  'opencode_wizard_editor_publish_skill',\n  'opencode_wizard_artifact_import',\n];\n\nconst SHARED_PUBLISHED_SKILL_TOOLS = AVAILABLE_PUBLISHED_SKILL_TOOLS.slice(0, 6);\n\nexport const resolveAvailableTools = (role: string | null | undefined): string[] => {\n  if (role === 'EDITOR') return [...AVAILABLE_PUBLISHED_SKILL_TOOLS];\n  return [...SHARED_PUBLISHED_SKILL_TOOLS];\n};\n\nexport const createPublishedSkillToolDefinitions = (\n  tool: ToolFactory,\n  handlers: PublishedSkillToolHandlers,\n) => ({\n  sharedTools: {\n    opencode_wizard_catalog_fetch: tool<WizardArtifactCatalogFetchArgs>({\n      description:\n        'Always-available canonical wizard artifact catalog tool. Supports artifactKind SKILL and DESIGN_DOC; catalog metadata is candidate discovery only, and bodies/files should be fetched before using a matching wizard artifact as guidance.',\n      args: {\n        artifactKind: tool.schema\n          .string()\n          .optional()\n          .describe('Wizard artifact kind to catalog: SKILL or DESIGN_DOC; defaults to SKILL'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n        refresh: tool.schema.boolean().optional().describe('Bypass the local plugin cache for this request'),\n      },\n      async execute(args, context) {\n        return handlers.fetchWizardArtifactCatalog(args, context);\n      },\n    }),\n    opencode_wizard_artifact_fetch: tool<WizardArtifactFetchArgs>({\n      description:\n        'Always-available canonical wizard artifact detail tool. Supports artifactKind SKILL and DESIGN_DOC; fetched backend-authorized bodies/files are the reference content when a matching effective artifact is used.',\n      args: {\n        artifactKind: tool.schema\n          .string()\n          .optional()\n          .describe('Wizard artifact kind to fetch: SKILL or DESIGN_DOC; defaults to SKILL'),\n        artifact: tool.schema\n          .string()\n          .optional()\n          .describe('Single artifact identifier; for SKILL this is a skill slug, artifact name, or skill name'),\n        artifacts: tool.schema\n          .string()\n          .optional()\n          .describe('One or more comma-separated or newline-separated artifact identifiers'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n        refresh: tool.schema.boolean().optional().describe('Bypass the local plugin cache for this request'),\n      },\n      async execute(args, context) {\n        return handlers.fetchWizardArtifacts(args, context);\n      },\n    }),\n    opencode_wizard_artifact_preference_set: tool<WizardArtifactPreferenceArgs>({\n      description:\n        'Always-available canonical wizard artifact preference tool. Supports SKILL and DESIGN_DOC install/uninstall/ignore/unignore through server-backed artifact preference APIs.',\n      args: {\n        artifactKind: tool.schema\n          .string()\n          .optional()\n          .describe('Wizard artifact kind to update: SKILL or DESIGN_DOC; defaults to SKILL'),\n        artifact: tool.schema.string().describe('Artifact identifier; for SKILL this is the published skill slug'),\n        action: tool.schema\n          .string()\n          .describe('Preference action: install, uninstall, ignore, or unignore'),\n        preferenceScope: tool.schema\n          .string()\n          .optional()\n          .describe('Preference scope for the action: project or global; defaults to project'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n      },\n      async execute(args, context) {\n        return handlers.updateWizardArtifactPreference(args, context);\n      },\n    }),\n    opencode_wizard_published_skills_fetch: tool<PublishedSkillFetchArgs>({\n      description:\n        'Always-available tool to fetch one or multiple wizard-published SKILL.md bodies/details for the current scope. When a backend-published wizard-listed skill matches the task, use the fetched body as reference guidance; catalog/status metadata only identifies candidates. Use this for wizard-listed/private/scoped/backend-published skill slugs instead of the native OpenCode skill tool; auth/catalog failures are returned in tool output. Prefer `skills` for multiple identifiers, call with no args to discover/bootstrap auth, and pass `refresh: true` before clearing plugin/OpenCode caches',\n      args: {\n        skill: tool.schema\n          .string()\n          .optional()\n          .describe(\n            'Single skill slug, artifact name, or skill name; backward-compatible with comma/newline-delimited lists',\n          ),\n        skills: tool.schema\n          .string()\n          .optional()\n          .describe('One or more comma-separated or newline-separated skill slugs, artifact names, or skill names'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n        refresh: tool.schema.boolean().optional().describe('Bypass the local plugin cache for this request'),\n      },\n      async execute(args, context) {\n        return handlers.fetchPublishedSkills(args, context);\n      },\n    }),\n    opencode_wizard_published_skill_preference_set: tool<PublishedSkillPreferenceArgs>({\n      description:\n        'Always-available tool to install, uninstall, ignore, or unignore a backend-published wizard skill for non-TUI workflows using the same shared server-backed preference API as the TUI overlay; auth/catalog failures are returned in tool output',\n      args: {\n        skill: tool.schema.string().describe('Published skill slug, artifact name, or skill name to update'),\n        action: tool.schema\n          .string()\n          .describe('Preference action: install, uninstall, ignore, or unignore'),\n        preferenceScope: tool.schema\n          .string()\n          .optional()\n          .describe('Preference scope for the action: project or global; defaults to project'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n      },\n      async execute(args, context) {\n        return handlers.updatePublishedSkillPreference(args, context);\n      },\n    }),\n    opencode_wizard_status: tool<PluginStatusArgs>({\n      description:\n        'Always-available tool to report opencode-wizard plugin status, bootstrap auth when missing, and return safe auth/catalog/source/cache/workspace metadata without exposing tokens; fetch matching wizard skill bodies before using them as guidance',\n      args: {\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n      },\n      async execute(args, context) {\n        return handlers.getStatus(args, context);\n      },\n    }),\n  },\n  editorOnlyTools: {\n    opencode_wizard_editor_create_or_update_skill: tool<EditorCreateOrUpdateSkillArgs>({\n      description:\n        'Canonical EDITOR-only skill creation/update tool. Sends direct SKILL.md markdown content to the backend createOrUpdateSkillFromMarkdown mutation without requiring a local .opencode/skills seed file first.',\n      args: {\n        markdownContent: tool.schema\n          .string()\n          .describe('Complete SKILL.md markdown content, including frontmatter when the backend skill contract requires it'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n      },\n      async execute(args, context) {\n        return handlers.createOrUpdateEditorSkill(args, context);\n      },\n    }),\n    opencode_wizard_editor_publish_skill: tool<EditorPublishSkillArgs>({\n      description:\n        'Read skill markdown files from .opencode/skills/ and publish them to the backend via the createOrUpdateSkillFromMarkdown mutation. Requires EDITOR role.',\n      args: {\n        skillSlug: tool.schema\n          .string()\n          .describe('Skill slug matching a directory under .opencode/skills/'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n      },\n      async execute(args, context) {\n        return handlers.publishEditorSkill(args, context);\n      },\n    }),\n    opencode_wizard_artifact_import: tool<WizardArtifactImportArgs>({\n      description:\n        'Editor-only import tool for external wizard artifacts. Supports SKILL from GitHub/raw SKILL.md sources and DESIGN_DOC from direct URLs or command-like inputs such as `npx getdesign@latest add bmw-m`. Imported backend artifacts become the plugin runtime authority; no project files are written.',\n      args: {\n        artifactKind: tool.schema\n          .string()\n          .optional()\n          .describe('Wizard artifact kind to import: SKILL or DESIGN_DOC; inferred from source when omitted'),\n        source: tool.schema\n          .string()\n          .describe('Direct URL or command-like input, e.g. `https://github.com/vercel-labs/skills --skill find-skills` or `npx getdesign@latest add bmw-m`'),\n        slug: tool.schema.string().optional().describe('Artifact slug; required for DESIGN_DOC unless inferable'),\n        skill: tool.schema.string().optional().describe('Skill directory/name for SKILL repo imports'),\n        name: tool.schema.string().optional().describe('Optional display name override'),\n        summary: tool.schema.string().optional().describe('Optional summary/description override'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n      },\n      async execute(args, context) {\n        return handlers.importWizardArtifact(args, context);\n      },\n    }),\n  },\n});\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["AVAILABLE_PUBLISHED_SKILL_TOOLS","SHARED_PUBLISHED_SKILL_TOOLS","slice","resolveAvailableTools","role","createPublishedSkillToolDefinitions","tool","handlers","sharedTools","opencode_wizard_catalog_fetch","description","args","artifactKind","schema","string","optional","describe","directory","refresh","boolean","recommendationContext","execute","context","fetchWizardArtifactCatalog","opencode_wizard_artifact_fetch","artifact","artifacts","fetchWizardArtifacts","opencode_wizard_artifact_preference_set","action","preferenceScope","updateWizardArtifactPreference","opencode_wizard_published_skills_fetch","skill","skills","fetchPublishedSkills","opencode_wizard_published_skill_preference_set","updatePublishedSkillPreference","opencode_wizard_status","getStatus","editorOnlyTools","opencode_wizard_editor_create_or_update_skill","markdownContent","createOrUpdateEditorSkill","opencode_wizard_editor_publish_skill","skillSlug","publishEditorSkill","opencode_wizard_artifact_import","source","slug","name","summary","importWizardArtifact"],"sources":["../src/plugin-tools.ts"],"sourcesContent":["export type PublishedSkillFetchArgs = {\n  skill?: string;\n  skills?: string;\n  directory?: string;\n  refresh?: boolean;\n  recommendationContext?: string;\n};\n\nexport type WizardArtifactKind = 'SKILL' | 'DESIGN_DOC';\n\nexport type WizardArtifactCatalogFetchArgs = {\n  artifactKind?: string;\n  directory?: string;\n  refresh?: boolean;\n  recommendationContext?: string;\n};\n\nexport type WizardArtifactFetchArgs = {\n  artifactKind?: string;\n  artifact?: string;\n  artifacts?: string;\n  directory?: string;\n  refresh?: boolean;\n  recommendationContext?: string;\n};\n\nexport type PluginStatusArgs = {\n  directory?: string;\n};\n\nexport type PublishedSkillPreferenceArgs = {\n  skill: string;\n  action: string;\n  preferenceScope?: string;\n  directory?: string;\n};\n\nexport type WizardArtifactPreferenceArgs = {\n  artifactKind?: string;\n  artifact: string;\n  action: string;\n  preferenceScope?: string;\n  directory?: string;\n};\n\nexport type EditorPublishSkillArgs = {\n  skillSlug: string;\n  directory?: string;\n};\n\nexport type EditorCreateOrUpdateSkillArgs = {\n  markdownContent: string;\n  directory?: string;\n};\n\nexport type WizardArtifactImportArgs = {\n  artifactKind?: string;\n  source: string;\n  slug?: string;\n  skill?: string;\n  name?: string;\n  summary?: string;\n  directory?: string;\n};\n\ntype ToolSchemaValue<TSelf> = {\n  optional: () => TSelf;\n  describe: (description: string) => TSelf;\n};\n\ntype ToolSchema = {\n  string: () => ToolSchemaValue<ToolSchemaValue<unknown>>;\n  boolean: () => ToolSchemaValue<ToolSchemaValue<unknown>>;\n};\n\nexport type ToolExecuteContext = {\n  directory: string;\n  abort: AbortSignal;\n  metadata: (payload: { title: string; metadata: Record<string, string> }) => void;\n};\n\ntype ToolDefinition<TArgs extends object> = {\n  description: string;\n  args: { [K in keyof TArgs]-?: unknown };\n  execute: (args: TArgs, context: ToolExecuteContext) => Promise<unknown>;\n};\n\nexport type ToolFactory = (<TArgs extends object>(definition: ToolDefinition<TArgs>) => unknown) & {\n  schema: ToolSchema;\n};\n\ntype PublishedSkillToolHandlers = {\n  fetchPublishedSkills: (args: PublishedSkillFetchArgs, context: ToolExecuteContext) => Promise<unknown>;\n  fetchWizardArtifactCatalog: (args: WizardArtifactCatalogFetchArgs, context: ToolExecuteContext) => Promise<unknown>;\n  fetchWizardArtifacts: (args: WizardArtifactFetchArgs, context: ToolExecuteContext) => Promise<unknown>;\n  updatePublishedSkillPreference: (args: PublishedSkillPreferenceArgs, context: ToolExecuteContext) => Promise<unknown>;\n  updateWizardArtifactPreference: (args: WizardArtifactPreferenceArgs, context: ToolExecuteContext) => Promise<unknown>;\n  getStatus: (args: PluginStatusArgs, context: ToolExecuteContext) => Promise<unknown>;\n  createOrUpdateEditorSkill: (args: EditorCreateOrUpdateSkillArgs, context: ToolExecuteContext) => Promise<unknown>;\n  publishEditorSkill: (args: EditorPublishSkillArgs, context: ToolExecuteContext) => Promise<unknown>;\n  importWizardArtifact: (args: WizardArtifactImportArgs, context: ToolExecuteContext) => Promise<unknown>;\n};\n\nexport const AVAILABLE_PUBLISHED_SKILL_TOOLS = [\n  'opencode_wizard_catalog_fetch',\n  'opencode_wizard_artifact_fetch',\n  'opencode_wizard_artifact_preference_set',\n  'opencode_wizard_published_skills_fetch',\n  'opencode_wizard_published_skill_preference_set',\n  'opencode_wizard_status',\n  'opencode_wizard_editor_create_or_update_skill',\n  'opencode_wizard_editor_publish_skill',\n  'opencode_wizard_artifact_import',\n];\n\nconst SHARED_PUBLISHED_SKILL_TOOLS = AVAILABLE_PUBLISHED_SKILL_TOOLS.slice(0, 6);\n\nexport const resolveAvailableTools = (role: string | null | undefined): string[] => {\n  if (role === 'EDITOR') return [...AVAILABLE_PUBLISHED_SKILL_TOOLS];\n  return [...SHARED_PUBLISHED_SKILL_TOOLS];\n};\n\nexport const createPublishedSkillToolDefinitions = (\n  tool: ToolFactory,\n  handlers: PublishedSkillToolHandlers,\n) => ({\n  sharedTools: {\n    opencode_wizard_catalog_fetch: tool<WizardArtifactCatalogFetchArgs>({\n      description:\n        'Always-available canonical wizard artifact catalog tool. Supports artifactKind SKILL and DESIGN_DOC; catalog metadata is candidate discovery only, and bodies/files should be fetched before using a matching wizard artifact as guidance.',\n      args: {\n        artifactKind: tool.schema\n          .string()\n          .optional()\n          .describe('Wizard artifact kind to catalog: SKILL or DESIGN_DOC; defaults to SKILL'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n        refresh: tool.schema.boolean().optional().describe('Bypass the local plugin cache for this request'),\n        recommendationContext: tool.schema\n          .string()\n          .optional()\n          .describe(\n            'Optional metadata-only relevance/ranking context for catalog recommendations; fetched artifact bodies/files remain the authority.',\n          ),\n      },\n      async execute(args, context) {\n        return handlers.fetchWizardArtifactCatalog(args, context);\n      },\n    }),\n    opencode_wizard_artifact_fetch: tool<WizardArtifactFetchArgs>({\n      description:\n        'Always-available canonical wizard artifact detail tool. Supports artifactKind SKILL and DESIGN_DOC; fetched backend-authorized bodies/files are the reference content when a matching effective artifact is used.',\n      args: {\n        artifactKind: tool.schema\n          .string()\n          .optional()\n          .describe('Wizard artifact kind to fetch: SKILL or DESIGN_DOC; defaults to SKILL'),\n        artifact: tool.schema\n          .string()\n          .optional()\n          .describe('Single artifact identifier; for SKILL this is a skill slug, artifact name, or skill name'),\n        artifacts: tool.schema\n          .string()\n          .optional()\n          .describe('One or more comma-separated or newline-separated artifact identifiers'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n        refresh: tool.schema.boolean().optional().describe('Bypass the local plugin cache for this request'),\n        recommendationContext: tool.schema\n          .string()\n          .optional()\n          .describe(\n            'Optional metadata-only relevance/ranking context for artifact discovery and suggestions; fetched bodies/files remain the authority.',\n          ),\n      },\n      async execute(args, context) {\n        return handlers.fetchWizardArtifacts(args, context);\n      },\n    }),\n    opencode_wizard_artifact_preference_set: tool<WizardArtifactPreferenceArgs>({\n      description:\n        'Always-available canonical wizard artifact preference tool. Supports SKILL and DESIGN_DOC install/uninstall/ignore/unignore through server-backed artifact preference APIs. To disable a per-user global starter/global skill, call artifactKind=SKILL action=ignore preferenceScope=global; use action=unignore preferenceScope=global to enable it again.',\n      args: {\n        artifactKind: tool.schema\n          .string()\n          .optional()\n          .describe('Wizard artifact kind to update: SKILL or DESIGN_DOC; defaults to SKILL'),\n        artifact: tool.schema.string().describe('Artifact identifier; for SKILL this is the published skill slug'),\n        action: tool.schema\n          .string()\n          .describe('Preference action: install, uninstall, ignore, or unignore'),\n        preferenceScope: tool.schema\n          .string()\n          .optional()\n          .describe('Preference scope for the action: project/workspace or global; defaults to project. Use global with ignore/unignore to disable or enable starter/global skills for the current user.'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n      },\n      async execute(args, context) {\n        return handlers.updateWizardArtifactPreference(args, context);\n      },\n    }),\n    opencode_wizard_published_skills_fetch: tool<PublishedSkillFetchArgs>({\n      description:\n        'Always-available tool to fetch one or multiple wizard-published SKILL.md bodies/details for the current scope. When a backend-published wizard-listed skill matches the task, use the fetched body as reference guidance; catalog/status metadata only identifies candidates. Use this for wizard-listed/private/scoped/backend-published skill slugs instead of the native OpenCode skill tool; auth/catalog failures are returned in tool output. Prefer `skills` for multiple identifiers, call with no args to discover/bootstrap auth, and pass `refresh: true` before clearing plugin/OpenCode caches',\n      args: {\n        skill: tool.schema\n          .string()\n          .optional()\n          .describe(\n            'Single skill slug, artifact name, or skill name; backward-compatible with comma/newline-delimited lists',\n          ),\n        skills: tool.schema\n          .string()\n          .optional()\n          .describe('One or more comma-separated or newline-separated skill slugs, artifact names, or skill names'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n        refresh: tool.schema.boolean().optional().describe('Bypass the local plugin cache for this request'),\n        recommendationContext: tool.schema\n          .string()\n          .optional()\n          .describe(\n            'Optional metadata-only relevance/ranking context for skill recommendations; fetched SKILL.md bodies remain the authority.',\n          ),\n      },\n      async execute(args, context) {\n        return handlers.fetchPublishedSkills(args, context);\n      },\n    }),\n    opencode_wizard_published_skill_preference_set: tool<PublishedSkillPreferenceArgs>({\n      description:\n        'Always-available tool to install, uninstall, ignore, or unignore a backend-published wizard skill for non-TUI workflows using the shared server-backed preference API; auth/catalog failures are returned in tool output. Disable a per-user global starter/global skill with skill=<slug> action=ignore preferenceScope=global; enable it again with action=unignore preferenceScope=global.',\n      args: {\n        skill: tool.schema.string().describe('Published skill slug, artifact name, or skill name to update'),\n        action: tool.schema\n          .string()\n          .describe('Preference action: install, uninstall, ignore, or unignore'),\n        preferenceScope: tool.schema\n          .string()\n          .optional()\n          .describe('Preference scope for the action: project/workspace or global; defaults to project. Use global with ignore/unignore to turn starter/global skills off or on for the current user.'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n      },\n      async execute(args, context) {\n        return handlers.updatePublishedSkillPreference(args, context);\n      },\n    }),\n    opencode_wizard_status: tool<PluginStatusArgs>({\n      description:\n        'Always-available tool to report opencode-wizard plugin status, bootstrap auth when missing, and return safe auth/catalog/source/cache/workspace metadata without exposing tokens; fetch matching wizard skill bodies before using them as guidance',\n      args: {\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n      },\n      async execute(args, context) {\n        return handlers.getStatus(args, context);\n      },\n    }),\n  },\n  editorOnlyTools: {\n    opencode_wizard_editor_create_or_update_skill: tool<EditorCreateOrUpdateSkillArgs>({\n      description:\n        'Canonical EDITOR-only skill creation/update tool. Sends direct SKILL.md markdown content to the backend createOrUpdateSkillFromMarkdown mutation without requiring a local .opencode/skills seed file first.',\n      args: {\n        markdownContent: tool.schema\n          .string()\n          .describe('Complete SKILL.md markdown content, including frontmatter when the backend skill contract requires it'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n      },\n      async execute(args, context) {\n        return handlers.createOrUpdateEditorSkill(args, context);\n      },\n    }),\n    opencode_wizard_editor_publish_skill: tool<EditorPublishSkillArgs>({\n      description:\n        'Read skill markdown files from .opencode/skills/ and publish them to the backend via the createOrUpdateSkillFromMarkdown mutation. Requires EDITOR role.',\n      args: {\n        skillSlug: tool.schema\n          .string()\n          .describe('Skill slug matching a directory under .opencode/skills/'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n      },\n      async execute(args, context) {\n        return handlers.publishEditorSkill(args, context);\n      },\n    }),\n    opencode_wizard_artifact_import: tool<WizardArtifactImportArgs>({\n      description:\n        'Editor-only import tool for external wizard artifacts. Supports SKILL from GitHub/raw SKILL.md sources and DESIGN_DOC from direct URLs or command-like inputs such as `npx getdesign@latest add bmw-m`. Imported backend artifacts become the plugin runtime authority; no project files are written.',\n      args: {\n        artifactKind: tool.schema\n          .string()\n          .optional()\n          .describe('Wizard artifact kind to import: SKILL or DESIGN_DOC; inferred from source when omitted'),\n        source: tool.schema\n          .string()\n          .describe('Direct URL or command-like input, e.g. `https://github.com/vercel-labs/skills --skill find-skills` or `npx getdesign@latest add bmw-m`'),\n        slug: tool.schema.string().optional().describe('Artifact slug; required for DESIGN_DOC unless inferable'),\n        skill: tool.schema.string().optional().describe('Skill directory/name for SKILL repo imports'),\n        name: tool.schema.string().optional().describe('Optional display name override'),\n        summary: tool.schema.string().optional().describe('Optional summary/description override'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n      },\n      async execute(args, context) {\n        return handlers.importWizardArtifact(args, context);\n      },\n    }),\n  },\n});\n"],"mappings":"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","ignoreList":[]}

package/dist/published-skills-transform.d.ts

@@ -11,7 +11,11 @@ type PublishedSkillTagLike = {
     facet?: PublishedSkillFacetLike | null;
 };
 type PublishedSkillInstallPolicy = 'GLOBAL_CONTEXT' | 'PROJECT_INSTALLABLE';
-type PublishedSkillCatalogItemLike = {
+type RecommendationMetadataLike = {
+    relevance?: number | null;
+    recommendationReason?: string | null;
+};
+type PublishedSkillCatalogItemLike = RecommendationMetadataLike & {
     assignmentSource: string;
     assignmentType: string;
     scopePath: string;
@@ -53,6 +57,14 @@ type PublishedSkillArtifactFileLike = {
     size: number;
     sortOrder: number;
 };
+export type PublishedSkillSupportingFileMetadata = {
+    count: number;
+    paths: Array<{
+        relativePath: string;
+        contentType: string;
+        size: number;
+    }>;
+};
 type PublishedSkillDetailItemLike = PublishedSkillCatalogItemLike & {
     publishedArtifact: PublishedSkillCatalogItemLike['publishedArtifact'] & {
         markdownBody: string;
@@ -60,7 +72,7 @@ type PublishedSkillDetailItemLike = PublishedSkillCatalogItemLike & {
         files: PublishedSkillArtifactFileLike[];
     };
 };
-type PublishedSkillInstallableCatalogItemLike = Pick<PublishedSkillCatalogItemLike, 'skill' | 'skillVersion' | 'publishedArtifact'>;
+type PublishedSkillInstallableCatalogItemLike = Pick<PublishedSkillCatalogItemLike, 'skill' | 'skillVersion' | 'publishedArtifact'> & RecommendationMetadataLike;
 type PublishedSkillCatalogPayloadLike<TItem extends PublishedSkillCatalogItemLike = PublishedSkillCatalogItemLike> = {
     workspace: {
         id: string;
@@ -112,6 +124,8 @@ export type PublishedSkillSummary = {
     installPolicy: PublishedSkillInstallPolicy;
     assignmentLabel: string;
     policyLabel: string;
+    relevance: number | null;
+    recommendationReason: string | null;
 };
 export type PublishedSkillDetail = PublishedSkillSummary & {
     skillId: string;
@@ -122,9 +136,10 @@ export type PublishedSkillDetail = PublishedSkillSummary & {
     renderedContent: string;
     files: PublishedSkillArtifactFileLike[];
     resources: PublishedSkillArtifactFileLike[];
+    supportingFiles: PublishedSkillSupportingFileMetadata;
 };
 type WizardArtifactKind = 'SKILL' | 'DESIGN_DOC';
-type WizardArtifactCatalogItemLike = {
+type WizardArtifactCatalogItemLike = RecommendationMetadataLike & {
     assignmentSource: string;
     assignmentType: string;
     scopePath: string;
@@ -167,7 +182,7 @@ type WizardArtifactCatalogPayloadLike = {
     workspace: PublishedSkillCatalogPayloadLike['workspace'];
     directoryPath: string;
     artifacts: WizardArtifactCatalogItemLike[];
-    catalogArtifacts: Pick<WizardArtifactCatalogItemLike, 'artifact' | 'artifactVersion'>[];
+    catalogArtifacts: (Pick<WizardArtifactCatalogItemLike, 'artifact' | 'artifactVersion'> & RecommendationMetadataLike)[];
     artifactPreferences: {
         scopeKey: string;
         userKey: string;
@@ -196,6 +211,8 @@ export type WizardArtifactSummary = {
     installPolicy: PublishedSkillInstallPolicy;
     assignmentLabel: string;
     policyLabel: string;
+    relevance: number | null;
+    recommendationReason: string | null;
 };
 export type WizardArtifactDetail = WizardArtifactSummary & {
     artifactId: string;
@@ -205,6 +222,7 @@ export type WizardArtifactDetail = WizardArtifactSummary & {
     renderedContent: string;
     files: PublishedSkillArtifactFileLike[];
     resources: PublishedSkillArtifactFileLike[];
+    supportingFiles: PublishedSkillSupportingFileMetadata;
 };
 export type WizardArtifactCatalogState = {
     pluginId: string;

package/dist/published-skills-transform.js

@@ -21,6 +21,14 @@ export const buildSkillMarkdown = item => {
   }
   return `${frontmatter}\n\n${body.endsWith('\n') ? body : `${body}\n`}`;
 };
+const toSupportingFileMetadata = files => ({
+  count: files.length,
+  paths: files.map(file => ({
+    relativePath: file.relativePath,
+    contentType: file.contentType,
+    size: file.size
+  }))
+});
 const getSkillIdentifiers = item => {
   const candidates = [item.skill.slug, item.publishedArtifact.frontmatterName, item.skill.name];
   const seen = new Set();
@@ -119,7 +127,9 @@ export const toPublishedSkillSummary = item => {
       assignmentSource: item.assignmentSource,
       contextKind,
       policy: item.skill.installPolicy
-    })
+    }),
+    relevance: item.relevance ?? null,
+    recommendationReason: item.recommendationReason ?? null
   };
 };
 export const toPublishedSkillDetail = item => ({
@@ -131,7 +141,8 @@ export const toPublishedSkillDetail = item => ({
   markdownBody: item.publishedArtifact.markdownBody,
   renderedContent: item.publishedArtifact.renderedContent,
   files: item.publishedArtifact.files,
-  resources: item.publishedArtifact.files.filter(file => file.relativePath !== 'SKILL.md')
+  resources: item.publishedArtifact.files.filter(file => file.relativePath !== 'SKILL.md'),
+  supportingFiles: toSupportingFileMetadata(item.publishedArtifact.files.filter(file => file.relativePath !== 'SKILL.md'))
 });
 const getWizardArtifactContextKind = item => {
   if (item.assignmentSource === 'GLOBAL') return 'global';
@@ -178,7 +189,9 @@ export const toWizardArtifactSummary = item => {
       assignmentSource: item.assignmentSource,
       contextKind,
       policy: item.artifact.installPolicy
-    })
+    }),
+    relevance: item.relevance ?? null,
+    recommendationReason: item.recommendationReason ?? null
   };
 };
 export const buildWizardArtifactMarkdown = item => {
@@ -194,7 +207,8 @@ export const toWizardArtifactDetail = item => ({
   markdownBody: item.artifactVersion.markdownBody,
   renderedContent: item.artifactVersion.renderedContent,
   files: item.artifactVersion.files,
-  resources: item.artifactVersion.files.filter(file => file.relativePath !== item.artifactVersion.canonicalFilePath)
+  resources: item.artifactVersion.files.filter(file => file.relativePath !== item.artifactVersion.canonicalFilePath),
+  supportingFiles: toSupportingFileMetadata(item.artifactVersion.files.filter(file => file.relativePath !== item.artifactVersion.canonicalFilePath))
 });
 export const toWizardArtifactCatalog = (payload, options) => ({
   pluginId: options.pluginId,
@@ -245,7 +259,9 @@ export const toInstallableSkillSummary = item => ({
     assignmentSource: 'CATALOG',
     contextKind: 'installable',
     policy: item.skill.installPolicy
-  })
+  }),
+  relevance: item.relevance ?? null,
+  recommendationReason: item.recommendationReason ?? null
 });
 export const toPublishedSkillCatalog = (payload, options) => ({
   pluginId: options.pluginId,