@aexol/opencode-wizard 0.1.16 → 0.2.0

package/dist/server.d.ts

@@ -65,8 +65,18 @@ export type PublishedSkillCatalogItem = {
         frontmatterDescription: string;
         checksum: string;
         publishedAt: string;
+        fileCount: number;
     };
 };
+type PublishedSkillArtifactFilePayload = {
+    id: string;
+    relativePath: string;
+    contentType: string;
+    content: string;
+    checksum: string;
+    size: number;
+    sortOrder: number;
+};
 type PublishedSkillFacet = {
     id: string;
     slug: string;
@@ -96,6 +106,7 @@ export type PublishedSkillDetailItem = PublishedSkillCatalogItem & {
     publishedArtifact: PublishedSkillCatalogItem['publishedArtifact'] & {
         markdownBody: string;
         renderedContent: string;
+        files: PublishedSkillArtifactFilePayload[];
     };
 };
 type AuthState = {
@@ -134,10 +145,12 @@ type PublishedSkillSummary = {
     includeChildren: boolean | null;
     checksum: string;
     publishedAt: string;
+    fileCount: number;
     identifiers: string[];
     tags: PublishedSkillTagSummary[];
     contextKind: 'global' | 'project' | 'installable';
     installPolicy: PublishedSkillInstallPolicy;
+    assignmentLabel: string;
     policyLabel: string;
 };
 type PublishedSkillDetail = PublishedSkillSummary & {
@@ -147,6 +160,8 @@ type PublishedSkillDetail = PublishedSkillSummary & {
     markdownDocument: string;
     markdownBody: string;
     renderedContent: string;
+    files: PublishedSkillArtifactFilePayload[];
+    resources: PublishedSkillArtifactFilePayload[];
 };
 type OpencodePluginServerInput = {
     worktree: string;
@@ -171,6 +186,7 @@ type PublishedSkillsSuccessState = {
     assignmentCounts: {
         global: number;
         project: number;
+        user: number;
         other: number;
     };
     facets: PublishedSkillFacetSummary[];

package/dist/server.js

@@ -114,6 +114,7 @@ const PUBLISHED_SKILLS_CATALOG_QUERY = `
           frontmatterDescription
           checksum
           publishedAt
+          fileCount
         }
       }
       catalogSkills {
@@ -151,6 +152,7 @@ const PUBLISHED_SKILLS_CATALOG_QUERY = `
           frontmatterDescription
           checksum
           publishedAt
+          fileCount
         }
       }
       userPreferences {
@@ -195,6 +197,7 @@ const PUBLISHED_SKILLS_CATALOG_QUERY = `
             frontmatterDescription
             checksum
             publishedAt
+            fileCount
           }
         }
       }
@@ -245,6 +248,7 @@ const SET_PUBLISHED_SKILL_PREFERENCE_MUTATION = `
           frontmatterDescription
           checksum
           publishedAt
+          fileCount
         }
       }
     }
@@ -260,6 +264,16 @@ const PUBLISHED_SKILL_DETAIL_QUERY = `
       renderedContent
       checksum
       publishedAt
+      fileCount
+      files {
+        id
+        relativePath
+        contentType
+        content
+        checksum
+        size
+        sortOrder
+      }
     }
   }
 `;
@@ -601,7 +615,22 @@ const getPublishedSkillFacets = items => {
   }
   return [...facetsBySlug.values()].sort((left, right) => left.slug.localeCompare(right.slug));
 };
+const isUserPublishedSkillAssignment = assignmentSource => assignmentSource === 'USER' || assignmentSource === 'USER_GLOBAL' || assignmentSource === 'USER_WORKSPACE';
+const getPublishedSkillAssignmentLabel = assignmentSource => {
+  if (assignmentSource === 'GLOBAL') return 'GLOBAL SCOPE assignment';
+  if (assignmentSource === 'WORKSPACE') return 'PROJECT SCOPE assignment';
+  if (assignmentSource === 'USER_GLOBAL') return 'USER SCOPE preference (global target)';
+  if (assignmentSource === 'USER_WORKSPACE') return 'USER SCOPE preference (project target)';
+  if (assignmentSource === 'USER') return 'USER SCOPE assignment';
+  return `${assignmentSource.toUpperCase().replace(/_/gu, ' ')} assignment`;
+};
 const getPublishedSkillAssignmentCounts = items => items.reduce((counts, item) => {
+  if (isUserPublishedSkillAssignment(item.assignmentSource)) {
+    return {
+      ...counts,
+      user: counts.user + 1
+    };
+  }
   if (item.assignmentSource === 'GLOBAL') {
     return {
       ...counts,
@@ -621,17 +650,22 @@ const getPublishedSkillAssignmentCounts = items => items.reduce((counts, item) =
 }, {
   global: 0,
   project: 0,
+  user: 0,
   other: 0
 });
 const getSkillContextKind = item => {
   if (item.assignmentSource === 'GLOBAL' || item.assignmentSource === 'USER_GLOBAL') return 'global';
   return 'project';
 };
-const getSkillPolicyLabel = (policy, contextKind) => {
+const getSkillPolicyLabel = (policy, contextKind, assignmentSource) => {
+  if (isUserPublishedSkillAssignment(assignmentSource) && policy === 'GLOBAL_CONTEXT') {
+    return 'GLOBAL_CONTEXT · active USER SCOPE context';
+  }
+  if (isUserPublishedSkillAssignment(assignmentSource)) return 'PROJECT_INSTALLABLE · active USER SCOPE preference';
   if (policy === 'GLOBAL_CONTEXT') return 'GLOBAL_CONTEXT · active context only, not project-installable';
   if (contextKind === 'installable') return 'PROJECT_INSTALLABLE · available to install';
-  if (contextKind === 'global') return 'PROJECT_INSTALLABLE · active global assignment';
-  return 'PROJECT_INSTALLABLE · active project/workspace assignment';
+  if (contextKind === 'global') return 'PROJECT_INSTALLABLE · active GLOBAL SCOPE assignment';
+  return 'PROJECT_INSTALLABLE · active PROJECT SCOPE assignment';
 };
 const toPublishedSkillSummary = item => {
   const contextKind = getSkillContextKind(item);
@@ -648,11 +682,13 @@ const toPublishedSkillSummary = item => {
     includeChildren: item.includeChildren ?? null,
     checksum: item.publishedArtifact.checksum,
     publishedAt: item.publishedArtifact.publishedAt,
+    fileCount: item.publishedArtifact.fileCount,
     identifiers: getSkillIdentifiers(item),
     tags: item.skill.tags.map(toPublishedSkillTagSummary),
     contextKind,
     installPolicy: item.skill.installPolicy,
-    policyLabel: getSkillPolicyLabel(item.skill.installPolicy, contextKind)
+    assignmentLabel: getPublishedSkillAssignmentLabel(item.assignmentSource),
+    policyLabel: getSkillPolicyLabel(item.skill.installPolicy, contextKind, item.assignmentSource)
   };
 };
 export const toPublishedSkillDetail = item => ({
@@ -662,7 +698,9 @@ export const toPublishedSkillDetail = item => ({
   artifactId: item.publishedArtifact.id,
   markdownDocument: buildSkillMarkdown(item),
   markdownBody: item.publishedArtifact.markdownBody,
-  renderedContent: item.publishedArtifact.renderedContent
+  renderedContent: item.publishedArtifact.renderedContent,
+  files: item.publishedArtifact.files,
+  resources: item.publishedArtifact.files.filter(file => file.relativePath !== 'SKILL.md')
 });
 const toInstallableSkillSummary = item => ({
   skillSlug: item.skill.slug,
@@ -677,6 +715,7 @@ const toInstallableSkillSummary = item => ({
   includeChildren: true,
   checksum: item.publishedArtifact.checksum,
   publishedAt: item.publishedArtifact.publishedAt,
+  fileCount: item.publishedArtifact.fileCount,
   identifiers: getSkillIdentifiers({
     ...item,
     assignmentSource: 'CATALOG',
@@ -687,7 +726,8 @@ const toInstallableSkillSummary = item => ({
   tags: item.skill.tags.map(toPublishedSkillTagSummary),
   contextKind: 'installable',
   installPolicy: item.skill.installPolicy,
-  policyLabel: getSkillPolicyLabel(item.skill.installPolicy, 'installable')
+  assignmentLabel: 'catalog skill',
+  policyLabel: getSkillPolicyLabel(item.skill.installPolicy, 'installable', 'CATALOG')
 });
 export const toPublishedSkillCatalog = payload => ({
   pluginId: PLUGIN_ID,
@@ -800,7 +840,9 @@ const truncateText = (value, maxLength) => {
 };
 const buildSkillCatalogLine = skill => {
   const description = truncateText(skill.whenToUse || skill.artifactDescription || skill.skillName || skill.skillSlug, SYSTEM_NOTE_SKILL_DESCRIPTION_LIMIT);
-  return `- ${skill.artifactName || skill.skillName} (${skill.skillSlug}, ${skill.contextKind.toUpperCase()}): ${description}`;
+  const scopeLabel = isUserPublishedSkillAssignment(skill.assignmentSource) ? 'USER SCOPE' : skill.contextKind === 'global' ? 'GLOBAL SCOPE' : 'PROJECT SCOPE';
+  const assignmentLabel = skill.assignmentSource.toLowerCase().replace(/_/gu, ' ');
+  return `- ${skill.artifactName || skill.skillName} (${skill.skillSlug}, ${assignmentLabel} assignment) [${scopeLabel}]: ${description}`;
 };
 const buildSkillDetailSnippetLine = detail => {
   const body = detail.markdownBody || detail.renderedContent || detail.markdownDocument;
@@ -813,11 +855,12 @@ export const buildSystemNote = (result, config, details) => {
   const renderedSkillNames = skillNames.length > 0 ? skillNames.slice(0, SYSTEM_NOTE_SKILL_NAME_LIMIT).join(', ') : 'none';
   const remainingCount = Math.max(skillNames.length - SYSTEM_NOTE_SKILL_NAME_LIMIT, 0);
   const renderedCountSuffix = remainingCount > 0 ? ` (+${remainingCount} more)` : '';
-  const globalSkills = catalog.skills.filter(skill => skill.contextKind === 'global').slice(0, 8).map(buildSkillCatalogLine);
-  const projectSkills = catalog.skills.filter(skill => skill.contextKind === 'project').slice(0, 5).map(buildSkillCatalogLine);
+  const globalSkills = catalog.skills.filter(skill => skill.contextKind === 'global' && !isUserPublishedSkillAssignment(skill.assignmentSource)).slice(0, 8).map(buildSkillCatalogLine);
+  const projectSkills = catalog.skills.filter(skill => skill.contextKind === 'project' && !isUserPublishedSkillAssignment(skill.assignmentSource)).slice(0, 5).map(buildSkillCatalogLine);
+  const userSkills = catalog.skills.filter(skill => isUserPublishedSkillAssignment(skill.assignmentSource)).slice(0, 5).map(buildSkillCatalogLine);
   const detailLines = details.slice(0, SYSTEM_NOTE_DETAIL_LIMIT).map(buildSkillDetailSnippetLine);
   const detailBlock = detailLines.length > 0 ? ` Loaded body snippets (capped):\n${truncateText(detailLines.join('\n'), SYSTEM_NOTE_DETAIL_CHAR_LIMIT)}` : '';
-  return [result.fetchResult.payload.workspace ? `Prefer opencode-wizard backend-published fetched skill bodies for scoped/private wizard skills in workspace ${result.fetchResult.payload.workspace.slug}.` : 'Prefer opencode-wizard backend-published global fetched skill bodies; workspace-specific skills are unavailable because the workspace was not found.', `Current directory: ${result.directoryPath}.`, `Published skills for this scope: ${renderedSkillNames}${renderedCountSuffix}; counts: ${catalog.assignmentCounts.global} global, ${catalog.assignmentCounts.project} project, ${catalog.assignmentCounts.other} other.`, 'Use catalog whenToUse guidance to decide applicability; when it matches the task, fetch full bodies with opencode_wizard_published_skills_fetch and prefer those fetched bodies for current scoped/private wizard guidance.', 'GLOBAL_CONTEXT skills are active context skills and are not project-installable; PROJECT_INSTALLABLE skills can be assigned globally or to project/workspace scopes; assignment rows decide which skills are active here.', globalSkills.length > 0 ? `Global context skills:\n${globalSkills.join('\n')}` : 'Global context skills: none.', projectSkills.length > 0 ? `Project-scoped active skills:\n${projectSkills.join('\n')}` : 'Project-scoped active skills: none.', detailBlock, 'Local/native sources can still complement wizard skills: .opencode/skills is source seed content, skills.urls is a public/static complement, and backend-published fetched bodies are preferred for private/scoped wizard guidance.', `Root source seed path remains seed/source content: ${config.rootSkillSeedPath}/**.`].filter(line => line.length > 0).join(' ');
+  return [result.fetchResult.payload.workspace ? `Prefer opencode-wizard backend-published fetched skill bodies for scoped/private wizard skills in workspace ${result.fetchResult.payload.workspace.slug}.` : 'Prefer opencode-wizard backend-published global fetched skill bodies; workspace-specific skills are unavailable because the workspace was not found.', `Current directory: ${result.directoryPath}.`, `Published skills for this scope: ${renderedSkillNames}${renderedCountSuffix}; counts: ${catalog.assignmentCounts.global} global, ${catalog.assignmentCounts.project} workspace, ${catalog.assignmentCounts.user} user, ${catalog.assignmentCounts.other} other (GLOBAL SCOPE: ${catalog.assignmentCounts.global}, PROJECT SCOPE: ${catalog.assignmentCounts.project}, USER SCOPE: ${catalog.assignmentCounts.user}).`, 'Use catalog whenToUse guidance to decide applicability; when it matches the task, fetch full bodies with opencode_wizard_published_skills_fetch and prefer those fetched bodies for current scoped/private wizard guidance.', 'GLOBAL_CONTEXT skills are active context skills and are not project-installable; PROJECT_INSTALLABLE skills can be assigned to GLOBAL SCOPE, PROJECT SCOPE, or USER SCOPE; assignment rows decide which scope is active here.', globalSkills.length > 0 ? `GLOBAL SCOPE / Global context skills:\n${globalSkills.join('\n')}` : 'GLOBAL SCOPE / Global context skills: none.', projectSkills.length > 0 ? `PROJECT SCOPE / Project-scoped active skills:\n${projectSkills.join('\n')}` : 'PROJECT SCOPE / Project-scoped active skills: none.', userSkills.length > 0 ? `USER SCOPE / User-scoped active skills:\n${userSkills.join('\n')}` : 'USER SCOPE / User-scoped active skills: none.', detailBlock, 'Local/native sources can still complement wizard skills: .opencode/skills is source seed content, skills.urls is a public/static complement, and backend-published fetched bodies are preferred for private/scoped wizard guidance.', `Root source seed path remains seed/source content: ${config.rootSkillSeedPath}/**.`].filter(line => line.length > 0).join(' ');
 };
 const toWorkspaceResolutionOutput = resolution => ({
   requestedDirectory: resolution.requestedDirectory,
@@ -2263,6 +2306,7 @@ const OpencodeWizardSkillsPlugin = async input => {
           publishedSkillCount: catalog.publishedSkillCount.toString(),
           globalAssignmentCount: catalog.assignmentCounts.global.toString(),
           projectAssignmentCount: catalog.assignmentCounts.project.toString(),
+          userAssignmentCount: catalog.assignmentCounts.user.toString(),
           ignoredSkillCount: filteredPublishedSkillsResult.ignoreState.ignoredSkillSlugs.length.toString()
         }
       });
@@ -2285,6 +2329,9 @@ const OpencodeWizardSkillsPlugin = async input => {
           status: 'ready',
           ...toWorkspaceResolutionMetadata(filteredPublishedSkillsResult.workspaceResolution),
           publishedSkillCount: catalog.publishedSkillCount.toString(),
+          globalAssignmentCount: catalog.assignmentCounts.global.toString(),
+          projectAssignmentCount: catalog.assignmentCounts.project.toString(),
+          userAssignmentCount: catalog.assignmentCounts.user.toString(),
           ignoredSkillCount: filteredPublishedSkillsResult.ignoreState.ignoredSkillSlugs.length.toString()
         }
       };