Pin imported GitHub skills and add update checks

packages/shared/src/index.ts

@@ -68,13 +68,18 @@ export type {
   CompanySkillSourceType,
   CompanySkillTrustLevel,
   CompanySkillCompatibility,
+  CompanySkillSourceBadge,
   CompanySkillFileInventoryEntry,
   CompanySkill,
   CompanySkillListItem,
   CompanySkillUsageAgent,
   CompanySkillDetail,
+  CompanySkillUpdateStatus,
   CompanySkillImportRequest,
   CompanySkillImportResult,
+  CompanySkillCreateRequest,
+  CompanySkillFileDetail,
+  CompanySkillFileUpdateRequest,
   AgentSkillSyncMode,
   AgentSkillState,
   AgentSkillEntry,
@@ -251,12 +256,17 @@ export {
   companySkillSourceTypeSchema,
   companySkillTrustLevelSchema,
   companySkillCompatibilitySchema,
+  companySkillSourceBadgeSchema,
   companySkillFileInventoryEntrySchema,
   companySkillSchema,
   companySkillListItemSchema,
   companySkillUsageAgentSchema,
   companySkillDetailSchema,
+  companySkillUpdateStatusSchema,
   companySkillImportSchema,
+  companySkillCreateSchema,
+  companySkillFileDetailSchema,
+  companySkillFileUpdateSchema,
   portabilityIncludeSchema,
   portabilityEnvInputSchema,
   portabilityCompanyManifestEntrySchema,

packages/shared/src/types/company-skill.ts

@@ -4,6 +4,8 @@ export type CompanySkillTrustLevel = "markdown_only" | "assets" | "scripts_execu
 
 export type CompanySkillCompatibility = "compatible" | "unknown" | "invalid";
 
+export type CompanySkillSourceBadge = "paperclip" | "github" | "local" | "url" | "catalog";
+
 export interface CompanySkillFileInventoryEntry {
   path: string;
   kind: "skill" | "markdown" | "reference" | "script" | "asset" | "other";
@@ -29,6 +31,10 @@ export interface CompanySkill {
 
 export interface CompanySkillListItem extends CompanySkill {
   attachedAgentCount: number;
+  editable: boolean;
+  editableReason: string | null;
+  sourceLabel: string | null;
+  sourceBadge: CompanySkillSourceBadge;
 }
 
 export interface CompanySkillUsageAgent {
@@ -43,6 +49,19 @@ export interface CompanySkillUsageAgent {
 export interface CompanySkillDetail extends CompanySkill {
   attachedAgentCount: number;
   usedByAgents: CompanySkillUsageAgent[];
+  editable: boolean;
+  editableReason: string | null;
+  sourceLabel: string | null;
+  sourceBadge: CompanySkillSourceBadge;
+}
+
+export interface CompanySkillUpdateStatus {
+  supported: boolean;
+  reason: string | null;
+  trackingRef: string | null;
+  currentRef: string | null;
+  latestRef: string | null;
+  hasUpdate: boolean;
 }
 
 export interface CompanySkillImportRequest {
@@ -53,3 +72,25 @@ export interface CompanySkillImportResult {
   imported: CompanySkill[];
   warnings: string[];
 }
+
+export interface CompanySkillCreateRequest {
+  name: string;
+  slug?: string | null;
+  description?: string | null;
+  markdown?: string | null;
+}
+
+export interface CompanySkillFileDetail {
+  skillId: string;
+  path: string;
+  kind: CompanySkillFileInventoryEntry["kind"];
+  content: string;
+  language: string | null;
+  markdown: boolean;
+  editable: boolean;
+}
+
+export interface CompanySkillFileUpdateRequest {
+  path: string;
+  content: string;
+}

packages/shared/src/types/index.ts

@@ -3,13 +3,18 @@ export type {
   CompanySkillSourceType,
   CompanySkillTrustLevel,
   CompanySkillCompatibility,
+  CompanySkillSourceBadge,
   CompanySkillFileInventoryEntry,
   CompanySkill,
   CompanySkillListItem,
   CompanySkillUsageAgent,
   CompanySkillDetail,
+  CompanySkillUpdateStatus,
   CompanySkillImportRequest,
   CompanySkillImportResult,
+  CompanySkillCreateRequest,
+  CompanySkillFileDetail,
+  CompanySkillFileUpdateRequest,
 } from "./company-skill.js";
 export type {
   AgentSkillSyncMode,

packages/shared/src/validators/company-skill.ts

@@ -3,6 +3,7 @@ import { z } from "zod";
 export const companySkillSourceTypeSchema = z.enum(["local_path", "github", "url", "catalog"]);
 export const companySkillTrustLevelSchema = z.enum(["markdown_only", "assets", "scripts_executables"]);
 export const companySkillCompatibilitySchema = z.enum(["compatible", "unknown", "invalid"]);
+export const companySkillSourceBadgeSchema = z.enum(["paperclip", "github", "local", "url", "catalog"]);
 
 export const companySkillFileInventoryEntrySchema = z.object({
   path: z.string().min(1),
@@ -29,6 +30,10 @@ export const companySkillSchema = z.object({
 
 export const companySkillListItemSchema = companySkillSchema.extend({
   attachedAgentCount: z.number().int().nonnegative(),
+  editable: z.boolean(),
+  editableReason: z.string().nullable(),
+  sourceLabel: z.string().nullable(),
+  sourceBadge: companySkillSourceBadgeSchema,
 });
 
 export const companySkillUsageAgentSchema = z.object({
@@ -43,10 +48,47 @@ export const companySkillUsageAgentSchema = z.object({
 export const companySkillDetailSchema = companySkillSchema.extend({
   attachedAgentCount: z.number().int().nonnegative(),
   usedByAgents: z.array(companySkillUsageAgentSchema).default([]),
+  editable: z.boolean(),
+  editableReason: z.string().nullable(),
+  sourceLabel: z.string().nullable(),
+  sourceBadge: companySkillSourceBadgeSchema,
+});
+
+export const companySkillUpdateStatusSchema = z.object({
+  supported: z.boolean(),
+  reason: z.string().nullable(),
+  trackingRef: z.string().nullable(),
+  currentRef: z.string().nullable(),
+  latestRef: z.string().nullable(),
+  hasUpdate: z.boolean(),
 });
 
 export const companySkillImportSchema = z.object({
   source: z.string().min(1),
 });
 
+export const companySkillCreateSchema = z.object({
+  name: z.string().min(1),
+  slug: z.string().min(1).nullable().optional(),
+  description: z.string().nullable().optional(),
+  markdown: z.string().nullable().optional(),
+});
+
+export const companySkillFileDetailSchema = z.object({
+  skillId: z.string().uuid(),
+  path: z.string().min(1),
+  kind: z.enum(["skill", "markdown", "reference", "script", "asset", "other"]),
+  content: z.string(),
+  language: z.string().nullable(),
+  markdown: z.boolean(),
+  editable: z.boolean(),
+});
+
+export const companySkillFileUpdateSchema = z.object({
+  path: z.string().min(1),
+  content: z.string(),
+});
+
 export type CompanySkillImport = z.infer<typeof companySkillImportSchema>;
+export type CompanySkillCreate = z.infer<typeof companySkillCreateSchema>;
+export type CompanySkillFileUpdate = z.infer<typeof companySkillFileUpdateSchema>;

packages/shared/src/validators/index.ts

@@ -8,13 +8,20 @@ export {
   companySkillSourceTypeSchema,
   companySkillTrustLevelSchema,
   companySkillCompatibilitySchema,
+  companySkillSourceBadgeSchema,
   companySkillFileInventoryEntrySchema,
   companySkillSchema,
   companySkillListItemSchema,
   companySkillUsageAgentSchema,
   companySkillDetailSchema,
+  companySkillUpdateStatusSchema,
   companySkillImportSchema,
+  companySkillCreateSchema,
+  companySkillFileDetailSchema,
+  companySkillFileUpdateSchema,
   type CompanySkillImport,
+  type CompanySkillCreate,
+  type CompanySkillFileUpdate,
 } from "./company-skill.js";
 export {
   agentSkillStateSchema,