feat: scan project workspaces for skills

Co-Authored-By: Paperclip <noreply@paperclip.ing>

packages/shared/src/index.ts

@@ -132,6 +132,10 @@ export type {
   CompanySkillUpdateStatus,
   CompanySkillImportRequest,
   CompanySkillImportResult,
+  CompanySkillProjectScanRequest,
+  CompanySkillProjectScanSkipped,
+  CompanySkillProjectScanConflict,
+  CompanySkillProjectScanResult,
   CompanySkillCreateRequest,
   CompanySkillFileDetail,
   CompanySkillFileUpdateRequest,
@@ -374,6 +378,10 @@ export {
   companySkillDetailSchema,
   companySkillUpdateStatusSchema,
   companySkillImportSchema,
+  companySkillProjectScanRequestSchema,
+  companySkillProjectScanSkippedSchema,
+  companySkillProjectScanConflictSchema,
+  companySkillProjectScanResultSchema,
   companySkillCreateSchema,
   companySkillFileDetailSchema,
   companySkillFileUpdateSchema,

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

@@ -88,6 +88,45 @@ export interface CompanySkillImportResult {
   warnings: string[];
 }
 
+export interface CompanySkillProjectScanRequest {
+  projectIds?: string[];
+  workspaceIds?: string[];
+}
+
+export interface CompanySkillProjectScanSkipped {
+  projectId: string;
+  projectName: string;
+  workspaceId: string | null;
+  workspaceName: string | null;
+  path: string | null;
+  reason: string;
+}
+
+export interface CompanySkillProjectScanConflict {
+  slug: string;
+  key: string;
+  projectId: string;
+  projectName: string;
+  workspaceId: string;
+  workspaceName: string;
+  path: string;
+  existingSkillId: string;
+  existingSkillKey: string;
+  existingSourceLocator: string | null;
+  reason: string;
+}
+
+export interface CompanySkillProjectScanResult {
+  scannedProjects: number;
+  scannedWorkspaces: number;
+  discovered: number;
+  imported: CompanySkill[];
+  updated: CompanySkill[];
+  skipped: CompanySkillProjectScanSkipped[];
+  conflicts: CompanySkillProjectScanConflict[];
+  warnings: string[];
+}
+
 export interface CompanySkillCreateRequest {
   name: string;
   slug?: string | null;

packages/shared/src/types/index.ts

@@ -12,6 +12,10 @@ export type {
   CompanySkillUpdateStatus,
   CompanySkillImportRequest,
   CompanySkillImportResult,
+  CompanySkillProjectScanRequest,
+  CompanySkillProjectScanSkipped,
+  CompanySkillProjectScanConflict,
+  CompanySkillProjectScanResult,
   CompanySkillCreateRequest,
   CompanySkillFileDetail,
   CompanySkillFileUpdateRequest,

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

@@ -68,6 +68,45 @@ export const companySkillImportSchema = z.object({
   source: z.string().min(1),
 });
 
+export const companySkillProjectScanRequestSchema = z.object({
+  projectIds: z.array(z.string().uuid()).optional(),
+  workspaceIds: z.array(z.string().uuid()).optional(),
+});
+
+export const companySkillProjectScanSkippedSchema = z.object({
+  projectId: z.string().uuid(),
+  projectName: z.string().min(1),
+  workspaceId: z.string().uuid().nullable(),
+  workspaceName: z.string().nullable(),
+  path: z.string().nullable(),
+  reason: z.string().min(1),
+});
+
+export const companySkillProjectScanConflictSchema = z.object({
+  slug: z.string().min(1),
+  key: z.string().min(1),
+  projectId: z.string().uuid(),
+  projectName: z.string().min(1),
+  workspaceId: z.string().uuid(),
+  workspaceName: z.string().min(1),
+  path: z.string().min(1),
+  existingSkillId: z.string().uuid(),
+  existingSkillKey: z.string().min(1),
+  existingSourceLocator: z.string().nullable(),
+  reason: z.string().min(1),
+});
+
+export const companySkillProjectScanResultSchema = z.object({
+  scannedProjects: z.number().int().nonnegative(),
+  scannedWorkspaces: z.number().int().nonnegative(),
+  discovered: z.number().int().nonnegative(),
+  imported: z.array(companySkillSchema),
+  updated: z.array(companySkillSchema),
+  skipped: z.array(companySkillProjectScanSkippedSchema),
+  conflicts: z.array(companySkillProjectScanConflictSchema),
+  warnings: z.array(z.string()),
+});
+
 export const companySkillCreateSchema = z.object({
   name: z.string().min(1),
   slug: z.string().min(1).nullable().optional(),
@@ -91,5 +130,6 @@ export const companySkillFileUpdateSchema = z.object({
 });
 
 export type CompanySkillImport = z.infer<typeof companySkillImportSchema>;
+export type CompanySkillProjectScan = z.infer<typeof companySkillProjectScanRequestSchema>;
 export type CompanySkillCreate = z.infer<typeof companySkillCreateSchema>;
 export type CompanySkillFileUpdate = z.infer<typeof companySkillFileUpdateSchema>;

packages/shared/src/validators/index.ts

@@ -23,10 +23,15 @@ export {
   companySkillDetailSchema,
   companySkillUpdateStatusSchema,
   companySkillImportSchema,
+  companySkillProjectScanRequestSchema,
+  companySkillProjectScanSkippedSchema,
+  companySkillProjectScanConflictSchema,
+  companySkillProjectScanResultSchema,
   companySkillCreateSchema,
   companySkillFileDetailSchema,
   companySkillFileUpdateSchema,
   type CompanySkillImport,
+  type CompanySkillProjectScan,
   type CompanySkillCreate,
   type CompanySkillFileUpdate,
 } from "./company-skill.js";