From 2473272a35fe3ddd4eb8751bcc3df469273fb39d Mon Sep 17 00:00:00 2001
From: Daniel Roe <daniel@roe.dev>
Date: Sun, 18 Oct 2026 21:55:56 +0000
Subject: [PATCH] feat: add role to projects

---
 app/components/admin/ProjectForm.vue | 12 ++++++++++++
 lexicons.ts                          |  1 +
 modules/sync/providers/sifa.ts       |  1 +
 server/utils/cms/projects.ts         |  2 +-
 shared/cms/projects.ts               |  2 +-
 test/unit/sifa.spec.ts               |  2 ++
 6 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/app/components/admin/ProjectForm.vue b/app/components/admin/ProjectForm.vue
index a9e1cbd3..02cc2318 100644
--- a/app/components/admin/ProjectForm.vue
+++ b/app/components/admin/ProjectForm.vue
@@ -61,6 +61,7 @@ const initialImage = props.initial?.images?.find(i => i.purpose === defs.purpose
 const form = reactive({
   categoryUri: props.initial?.category?.uri ?? '',
   name: props.initial?.name ?? '',
+  role: props.initial?.role ?? '',
   description: props.initial?.description ?? '',
   links: (props.initial?.links ?? []).map(l => ({ uri: l.uri, label: l.label ?? '', role: l.role ?? '' })),
   status: props.initial?.status ?? '',
@@ -177,6 +178,7 @@ async function onSubmit () {
     const value: ProjectValue = {
       category: categoryRef,
       name: form.name,
+      ...(form.role ? { role: form.role } : {}),
       ...(form.description ? { description: form.description } : {}),
       ...(links.length ? { links } : {}),
       ...(form.image
@@ -248,6 +250,16 @@ async function onSubmit () {
       >
     </label>
 
+    <label class="flex flex-col gap-1 text-sm">
+      <span class="text-muted">My role</span>
+      <input
+        v-model="form.role"
+        type="text"
+        placeholder="Project lead"
+        class="bg-accent px-3 py-2"
+      >
+    </label>
+
     <label class="flex flex-col gap-1 text-sm">
       <span class="text-muted">Description</span>
       <textarea
diff --git a/lexicons.ts b/lexicons.ts
index 5c268d14..968e9045 100644
--- a/lexicons.ts
+++ b/lexicons.ts
@@ -42,6 +42,7 @@ export default defineLexicons('dev.roe', {
   project: record({
     category: field.ref('projectCategory').describe('Strong-ref to the parent dev.roe.projectCategory record.'),
     name: field.text({ max: 256 }),
+    role: field.text({ max: 256 }).describe('My role on the project, e.g. `Project lead` or `Core contributor`.').optional(),
     description: field.text({ max: 2500 }).optional(),
     links: field.list(link(), { max: 12 })
       .describe('Relevant destinations for the project. The site links the card at the first `linkRoleWebsite`, falling back to the first link of any role.')
diff --git a/modules/sync/providers/sifa.ts b/modules/sync/providers/sifa.ts
index 3417397d..fb3fd4d8 100644
--- a/modules/sync/providers/sifa.ts
+++ b/modules/sync/providers/sifa.ts
@@ -105,6 +105,7 @@ export function toProject ({ rkey, value }: Source<ProjectRecord>): Project {
   const url = (value.links?.find(link => link.role === 'community.lexicon.app.defs#linkRoleWebsite') ?? value.links?.[0])?.uri
   return {
     name: value.name,
+    ...(value.role ? { role: value.role } : {}),
     ...(value.description ? { description: value.description } : {}),
     ...(url ? { url: url as l.UriString } : {}),
     createdAt: (value.createdAt ?? dateFromTid(rkey)) as l.DatetimeString,
diff --git a/server/utils/cms/projects.ts b/server/utils/cms/projects.ts
index 7280d68a..92e1a825 100644
--- a/server/utils/cms/projects.ts
+++ b/server/utils/cms/projects.ts
@@ -36,7 +36,7 @@ export async function getProjects (): Promise<ProjectCategory[]> {
   return await Promise.all(categories.map(async cat => {
     const bucket = byCategoryUri.get(cat.uri) ?? []
     const items: Project[] = await Promise.all(bucket.map(async it => {
-      const { $type, category, links, images, status, createdAt, ...passthrough } = it.value
+      const { $type, category, links, images, status, role, createdAt, ...passthrough } = it.value
       const image = images?.find(i => i.purpose === PURPOSE_SCREENSHOT) ?? images?.[0]
       return {
         ...passthrough,
diff --git a/shared/cms/projects.ts b/shared/cms/projects.ts
index 82ba7b06..0b61ae27 100644
--- a/shared/cms/projects.ts
+++ b/shared/cms/projects.ts
@@ -7,7 +7,7 @@ import type { ResolvedViewImage } from './image.ts'
  * the page uses (site link, source link, screenshot) so the page doesn't have
  * to know about link roles and image purposes.
  */
-export type Project = Omit<ProjectRecord, '$type' | 'category' | 'links' | 'images' | 'status' | 'createdAt'> & {
+export type Project = Omit<ProjectRecord, '$type' | 'category' | 'links' | 'images' | 'status' | 'role' | 'createdAt'> & {
   url: string | null
   repo: string | null
   archived: boolean
diff --git a/test/unit/sifa.spec.ts b/test/unit/sifa.spec.ts
index 7cf0de95..2b756755 100644
--- a/test/unit/sifa.spec.ts
+++ b/test/unit/sifa.spec.ts
@@ -108,6 +108,7 @@ describe('toProject', () => {
       value: {
         $type: 'dev.roe.project',
         name: 'magic-regexp',
+        role: 'Creator',
         description: 'A compiled-away, type-safe, readable RegExp alternative',
         category: { uri: `at://${did}/dev.roe.projectCategory/3mtxxqyu2rz26`, cid: 'bafy' },
         links: [
@@ -120,6 +121,7 @@ describe('toProject', () => {
 
     expect(project).toEqual({
       name: 'magic-regexp',
+      role: 'Creator',
       description: 'A compiled-away, type-safe, readable RegExp alternative',
       url: 'https://regexp.dev',
       createdAt: '2026-08-26T08:58:54.746Z',
-- 
2.54.0