pilothub 0.0.1 → 0.0.2

package/convex/leaderboards.ts

@@ -1,39 +0,0 @@
-import { v } from 'convex/values'
-import { internalMutation } from './_generated/server'
-import { buildTrendingLeaderboard } from './lib/leaderboards'
-
-const MAX_TRENDING_LIMIT = 200
-const KEEP_LEADERBOARD_ENTRIES = 3
-
-export const rebuildTrendingLeaderboardInternal = internalMutation({
-  args: { limit: v.optional(v.number()) },
-  handler: async (ctx, args) => {
-    const limit = clampInt(args.limit ?? MAX_TRENDING_LIMIT, 1, MAX_TRENDING_LIMIT)
-    const now = Date.now()
-    const { startDay, endDay, items } = await buildTrendingLeaderboard(ctx, { limit, now })
-
-    await ctx.db.insert('skillLeaderboards', {
-      kind: 'trending',
-      generatedAt: now,
-      rangeStartDay: startDay,
-      rangeEndDay: endDay,
-      items,
-    })
-
-    const recent = await ctx.db
-      .query('skillLeaderboards')
-      .withIndex('by_kind', (q) => q.eq('kind', 'trending'))
-      .order('desc')
-      .take(KEEP_LEADERBOARD_ENTRIES + 5)
-
-    for (const entry of recent.slice(KEEP_LEADERBOARD_ENTRIES)) {
-      await ctx.db.delete(entry._id)
-    }
-
-    return { ok: true as const, count: items.length }
-  },
-})
-
-function clampInt(value: number, min: number, max: number) {
-  return Math.min(Math.max(value, min), max)
-}

package/convex/lib/access.ts

@@ -1,36 +0,0 @@
-import { getAuthUserId } from '@convex-dev/auth/server'
-import { internal } from '../_generated/api'
-import type { Doc } from '../_generated/dataModel'
-import type { ActionCtx, MutationCtx, QueryCtx } from '../_generated/server'
-
-export type Role = 'admin' | 'moderator' | 'user'
-
-export async function requireUser(ctx: MutationCtx | QueryCtx) {
-  const userId = await getAuthUserId(ctx)
-  if (!userId) throw new Error('Unauthorized')
-  const user = await ctx.db.get(userId)
-  if (!user || user.deletedAt) throw new Error('User not found')
-  return { userId, user }
-}
-
-export async function requireUserFromAction(ctx: ActionCtx) {
-  const userId = await getAuthUserId(ctx)
-  if (!userId) throw new Error('Unauthorized')
-  const user = await ctx.runQuery(internal.users.getByIdInternal, { userId })
-  if (!user || user.deletedAt) throw new Error('User not found')
-  return { userId, user: user as Doc<'users'> }
-}
-
-export function assertRole(user: Doc<'users'>, allowed: Role[]) {
-  if (!user.role || !allowed.includes(user.role as Role)) {
-    throw new Error('Forbidden')
-  }
-}
-
-export function assertAdmin(user: Doc<'users'>) {
-  assertRole(user, ['admin'])
-}
-
-export function assertModerator(user: Doc<'users'>) {
-  assertRole(user, ['admin', 'moderator'])
-}

package/convex/lib/apiTokenAuth.ts

@@ -1,36 +0,0 @@
-import { ConvexError } from 'convex/values'
-import { internal } from '../_generated/api'
-import type { Doc } from '../_generated/dataModel'
-import type { ActionCtx } from '../_generated/server'
-import { hashToken } from './tokens'
-
-type TokenAuthResult = { user: Doc<'users'>; userId: Doc<'users'>['_id'] }
-
-export async function requireApiTokenUser(
-  ctx: ActionCtx,
-  request: Request,
-): Promise<TokenAuthResult> {
-  const header = request.headers.get('authorization') ?? request.headers.get('Authorization')
-  const token = parseBearerToken(header)
-  if (!token) throw new ConvexError('Unauthorized')
-
-  const tokenHash = await hashToken(token)
-  const apiToken = await ctx.runQuery(internal.tokens.getByHashInternal, { tokenHash })
-  if (!apiToken || apiToken.revokedAt) throw new ConvexError('Unauthorized')
-
-  const user = await ctx.runQuery(internal.tokens.getUserForTokenInternal, {
-    tokenId: apiToken._id,
-  })
-  if (!user || user.deletedAt) throw new ConvexError('Unauthorized')
-
-  await ctx.runMutation(internal.tokens.touchInternal, { tokenId: apiToken._id })
-  return { user, userId: user._id }
-}
-
-function parseBearerToken(header: string | null) {
-  if (!header) return null
-  const trimmed = header.trim()
-  if (!trimmed.toLowerCase().startsWith('bearer ')) return null
-  const token = trimmed.slice(7).trim()
-  return token || null
-}

package/convex/lib/badges.ts

@@ -1,50 +0,0 @@
-import type { Doc, Id } from '../_generated/dataModel'
-import type { QueryCtx } from '../_generated/server'
-
-type BadgeKind = Doc<'skillBadges'>['kind']
-
-export type SkillBadgeMap = Partial<Record<BadgeKind, { byUserId: Id<'users'>; at: number }>>
-
-export type SkillBadgeSource = { badges?: SkillBadgeMap | null }
-
-type BadgeCtx = Pick<QueryCtx, 'db'>
-
-export function isSkillHighlighted(skill: SkillBadgeSource) {
-  return Boolean(skill.badges?.highlighted)
-}
-
-export function isSkillOfficial(skill: SkillBadgeSource) {
-  return Boolean(skill.badges?.official)
-}
-
-export function isSkillDeprecated(skill: SkillBadgeSource) {
-  return Boolean(skill.badges?.deprecated)
-}
-
-export function buildBadgeMap(records: Doc<'skillBadges'>[]): SkillBadgeMap {
-  return records.reduce<SkillBadgeMap>((acc, record) => {
-    acc[record.kind] = { byUserId: record.byUserId, at: record.at }
-    return acc
-  }, {})
-}
-
-export async function getSkillBadgeMap(
-  ctx: BadgeCtx,
-  skillId: Id<'skills'>,
-): Promise<SkillBadgeMap> {
-  const records = await ctx.db
-    .query('skillBadges')
-    .withIndex('by_skill', (q) => q.eq('skillId', skillId))
-    .collect()
-  return buildBadgeMap(records)
-}
-
-export async function getSkillBadgeMaps(
-  ctx: BadgeCtx,
-  skillIds: Array<Id<'skills'>>,
-): Promise<Map<Id<'skills'>, SkillBadgeMap>> {
-  const entries = await Promise.all(
-    skillIds.map(async (skillId) => [skillId, await getSkillBadgeMap(ctx, skillId)] as const),
-  )
-  return new Map(entries)
-}

package/convex/lib/changelog.test.ts

@@ -1,34 +0,0 @@
-import { describe, expect, it } from 'vitest'
-import { __test } from './changelog'
-
-describe('changelog utils', () => {
-  it('summarizes file diffs', () => {
-    const diff = __test.summarizeFileDiff(
-      [
-        { path: 'a.txt', sha256: 'aaa' },
-        { path: 'b.txt', sha256: 'bbb' },
-      ],
-      [
-        { path: 'a.txt', sha256: 'aaa' },
-        { path: 'b.txt', sha256: 'ccc' },
-        { path: 'c.txt', sha256: 'ddd' },
-      ],
-    )
-
-    expect(diff.added).toEqual(['c.txt'])
-    expect(diff.removed).toEqual([])
-    expect(diff.changed).toEqual(['b.txt'])
-    expect(__test.formatDiffSummary(diff)).toBe('1 added, 1 changed')
-  })
-
-  it('generates a fallback initial release note', () => {
-    const text = __test.generateFallback({
-      slug: 'demo',
-      version: '1.0.0',
-      oldReadme: null,
-      nextReadme: 'hi',
-      fileDiff: null,
-    })
-    expect(text).toMatch(/Initial release/i)
-  })
-})

package/convex/lib/changelog.ts

@@ -1,278 +0,0 @@
-import { internal } from '../_generated/api'
-import type { Doc, Id } from '../_generated/dataModel'
-import type { ActionCtx } from '../_generated/server'
-
-const CHANGELOG_MODEL = process.env.OPENAI_CHANGELOG_MODEL ?? 'gpt-4.1'
-const MAX_README_CHARS = 8_000
-const MAX_PATHS_IN_PROMPT = 30
-
-type FileMeta = { path: string; sha256?: string }
-
-type FileDiffSummary = {
-  added: string[]
-  removed: string[]
-  changed: string[]
-}
-
-function clampText(value: string, maxChars: number) {
-  const trimmed = value.trim()
-  if (trimmed.length <= maxChars) return trimmed
-  return `${trimmed.slice(0, maxChars).trimEnd()}\n…`
-}
-
-function summarizeFileDiff(oldFiles: FileMeta[], nextFiles: FileMeta[]): FileDiffSummary {
-  const oldByPath = new Map(oldFiles.map((f) => [f.path, f] as const))
-  const nextByPath = new Map(nextFiles.map((f) => [f.path, f] as const))
-
-  const added: string[] = []
-  const removed: string[] = []
-  const changed: string[] = []
-
-  for (const [path, file] of nextByPath.entries()) {
-    const prev = oldByPath.get(path)
-    if (!prev) {
-      added.push(path)
-      continue
-    }
-    if (file.sha256 && prev.sha256 && file.sha256 !== prev.sha256) changed.push(path)
-  }
-  for (const path of oldByPath.keys()) {
-    if (!nextByPath.has(path)) removed.push(path)
-  }
-
-  added.sort()
-  removed.sort()
-  changed.sort()
-  return { added, removed, changed }
-}
-
-function formatDiffSummary(diff: FileDiffSummary) {
-  const parts: string[] = []
-  if (diff.added.length) parts.push(`${diff.added.length} added`)
-  if (diff.changed.length) parts.push(`${diff.changed.length} changed`)
-  if (diff.removed.length) parts.push(`${diff.removed.length} removed`)
-  return parts.join(', ') || 'no file changes detected'
-}
-
-function pickPaths(values: string[]) {
-  if (values.length <= MAX_PATHS_IN_PROMPT) return values
-  return values.slice(0, MAX_PATHS_IN_PROMPT)
-}
-
-function extractResponseText(payload: unknown) {
-  if (!payload || typeof payload !== 'object') return null
-  const output = (payload as { output?: unknown }).output
-  if (!Array.isArray(output)) return null
-  const chunks: string[] = []
-  for (const item of output) {
-    if (!item || typeof item !== 'object') continue
-    if ((item as { type?: unknown }).type !== 'message') continue
-    const content = (item as { content?: unknown }).content
-    if (!Array.isArray(content)) continue
-    for (const part of content) {
-      if (!part || typeof part !== 'object') continue
-      if ((part as { type?: unknown }).type !== 'output_text') continue
-      const text = (part as { text?: unknown }).text
-      if (typeof text === 'string' && text.trim()) chunks.push(text)
-    }
-  }
-  const joined = chunks.join('\n').trim()
-  return joined || null
-}
-
-async function generateWithOpenAI(args: {
-  slug: string
-  version: string
-  oldReadme: string | null
-  nextReadme: string
-  fileDiff: FileDiffSummary | null
-}) {
-  const apiKey = process.env.OPENAI_API_KEY
-  if (!apiKey) return null
-
-  const oldReadme = args.oldReadme ? clampText(args.oldReadme, MAX_README_CHARS) : ''
-  const nextReadme = clampText(args.nextReadme, MAX_README_CHARS)
-
-  const fileDiff = args.fileDiff
-  const diffSummary = fileDiff ? formatDiffSummary(fileDiff) : 'unknown'
-  const changedPaths = fileDiff ? pickPaths(fileDiff.changed) : []
-  const addedPaths = fileDiff ? pickPaths(fileDiff.added) : []
-  const removedPaths = fileDiff ? pickPaths(fileDiff.removed) : []
-
-  const input = [
-    `Skill: ${args.slug}`,
-    `Version: ${args.version}`,
-    `File changes: ${diffSummary}`,
-    changedPaths.length ? `Changed files (sample): ${changedPaths.join(', ')}` : null,
-    addedPaths.length ? `Added files (sample): ${addedPaths.join(', ')}` : null,
-    removedPaths.length ? `Removed files (sample): ${removedPaths.join(', ')}` : null,
-    oldReadme ? `Previous SKILL.md:\n${oldReadme}` : null,
-    `New SKILL.md:\n${nextReadme}`,
-  ]
-    .filter(Boolean)
-    .join('\n\n')
-
-  const response = await fetch('https://api.openai.com/v1/responses', {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${apiKey}`,
-    },
-    body: JSON.stringify({
-      model: CHANGELOG_MODEL,
-      instructions:
-        'Write a concise changelog for this skill version. Audience: everyone. Output plain text. Prefer 2–6 bullet points. If it is a big change, include a short 1-line summary first, then bullets. Don’t mention that you are AI. Don’t invent details; only use the inputs.',
-      input,
-      max_output_tokens: 220,
-    }),
-  })
-
-  if (!response.ok) return null
-  const payload = (await response.json()) as unknown
-  return extractResponseText(payload)
-}
-
-function generateFallback(args: {
-  slug: string
-  version: string
-  oldReadme: string | null
-  nextReadme: string
-  fileDiff: FileDiffSummary | null
-}) {
-  const lines: string[] = []
-  if (!args.oldReadme) {
-    lines.push(`- Initial release.`)
-    return lines.join('\n')
-  }
-
-  const diff = args.fileDiff
-  if (diff) {
-    const parts: string[] = []
-    if (diff.added.length) parts.push(`added ${diff.added.length}`)
-    if (diff.changed.length) parts.push(`updated ${diff.changed.length}`)
-    if (diff.removed.length) parts.push(`removed ${diff.removed.length}`)
-    if (parts.length) lines.push(`- ${parts.join(', ')} file(s).`)
-  }
-
-  lines.push(`- Updated SKILL.md and bundle contents.`)
-  return lines.join('\n')
-}
-
-export async function generateChangelogForPublish(
-  ctx: ActionCtx,
-  args: { slug: string; version: string; readmeText: string; files: FileMeta[] },
-): Promise<string> {
-  try {
-    const skill = (await ctx.runQuery(internal.skills.getSkillBySlugInternal, {
-      slug: args.slug,
-    })) as Doc<'skills'> | null
-    const previous: Doc<'skillVersions'> | null =
-      skill?.latestVersionId && !skill.softDeletedAt
-        ? ((await ctx.runQuery(internal.skills.getVersionByIdInternal, {
-            versionId: skill.latestVersionId,
-          })) as Doc<'skillVersions'> | null)
-        : null
-
-    const oldReadmeText: string | null = previous
-      ? await readReadmeFromVersion(ctx, previous)
-      : null
-    const oldFiles = previous
-      ? previous.files.map((file) => ({ path: file.path, sha256: file.sha256 }))
-      : []
-    const fileDiff = previous ? summarizeFileDiff(oldFiles, args.files) : null
-
-    const ai = await generateWithOpenAI({
-      slug: args.slug,
-      version: args.version,
-      oldReadme: oldReadmeText,
-      nextReadme: args.readmeText,
-      fileDiff,
-    }).catch(() => null)
-
-    return (
-      ai ??
-      generateFallback({
-        slug: args.slug,
-        version: args.version,
-        oldReadme: oldReadmeText,
-        nextReadme: args.readmeText,
-        fileDiff,
-      })
-    )
-  } catch {
-    return '- Updated skill.'
-  }
-}
-
-export async function generateChangelogPreview(
-  ctx: ActionCtx,
-  args: {
-    slug: string
-    version: string
-    readmeText: string
-    filePaths?: string[]
-  },
-): Promise<string> {
-  try {
-    const skill = (await ctx.runQuery(internal.skills.getSkillBySlugInternal, {
-      slug: args.slug,
-    })) as Doc<'skills'> | null
-    const previous: Doc<'skillVersions'> | null =
-      skill?.latestVersionId && !skill.softDeletedAt
-        ? ((await ctx.runQuery(internal.skills.getVersionByIdInternal, {
-            versionId: skill.latestVersionId,
-          })) as Doc<'skillVersions'> | null)
-        : null
-
-    const oldReadmeText: string | null = previous
-      ? await readReadmeFromVersion(ctx, previous)
-      : null
-    const fileDiff =
-      previous && args.filePaths
-        ? summarizeFileDiff(
-            previous.files.map((file) => ({ path: file.path, sha256: file.sha256 })),
-            args.filePaths.map((path) => ({ path })),
-          )
-        : null
-
-    const ai = await generateWithOpenAI({
-      slug: args.slug,
-      version: args.version,
-      oldReadme: oldReadmeText,
-      nextReadme: args.readmeText,
-      fileDiff,
-    }).catch(() => null)
-
-    return (
-      ai ??
-      generateFallback({
-        slug: args.slug,
-        version: args.version,
-        oldReadme: oldReadmeText,
-        nextReadme: args.readmeText,
-        fileDiff,
-      })
-    )
-  } catch {
-    return '- Updated skill.'
-  }
-}
-
-async function readReadmeFromVersion(ctx: ActionCtx, version: Doc<'skillVersions'>) {
-  const readmeFile = version.files.find((file) => {
-    const lower = file.path.toLowerCase()
-    return lower === 'skill.md' || lower === 'skills.md'
-  })
-  if (!readmeFile) return null
-  const blob = await ctx.storage.get(readmeFile.storageId as Id<'_storage'>)
-  if (!blob) return null
-  return blob.text()
-}
-
-export const __test = {
-  clampText,
-  extractResponseText,
-  formatDiffSummary,
-  summarizeFileDiff,
-  generateFallback,
-}

package/convex/lib/embeddings.ts

@@ -1,38 +0,0 @@
-export const EMBEDDING_MODEL = 'text-embedding-3-small'
-export const EMBEDDING_DIMENSIONS = 1536
-
-function emptyEmbedding() {
-  return Array.from({ length: EMBEDDING_DIMENSIONS }, () => 0)
-}
-
-export async function generateEmbedding(text: string) {
-  const apiKey = process.env.OPENAI_API_KEY
-  if (!apiKey) {
-    console.warn('OPENAI_API_KEY is not configured; using zero embeddings')
-    return emptyEmbedding()
-  }
-
-  const response = await fetch('https://api.openai.com/v1/embeddings', {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${apiKey}`,
-    },
-    body: JSON.stringify({
-      model: EMBEDDING_MODEL,
-      input: text,
-    }),
-  })
-
-  if (!response.ok) {
-    const message = await response.text()
-    throw new Error(`Embedding failed: ${message}`)
-  }
-
-  const payload = (await response.json()) as {
-    data?: Array<{ embedding: number[] }>
-  }
-  const embedding = payload.data?.[0]?.embedding
-  if (!embedding) throw new Error('Embedding missing from response')
-  return embedding
-}