pilothub 0.0.1 → 0.0.2

package/convex/auth.ts

@@ -1,19 +0,0 @@
-import GitHub from '@auth/core/providers/github'
-import { convexAuth } from '@convex-dev/auth/server'
-
-export const { auth, signIn, signOut, store, isAuthenticated } = convexAuth({
-  providers: [
-    GitHub({
-      clientId: process.env.AUTH_GITHUB_ID ?? '',
-      clientSecret: process.env.AUTH_GITHUB_SECRET ?? '',
-      profile(profile) {
-        return {
-          id: String(profile.id),
-          name: profile.login,
-          email: profile.email ?? undefined,
-          image: profile.avatar_url,
-        }
-      },
-    }),
-  ],
-})

package/convex/comments.ts

@@ -1,88 +0,0 @@
-import { v } from 'convex/values'
-import type { Doc } from './_generated/dataModel'
-import { mutation, query } from './_generated/server'
-import { assertModerator, requireUser } from './lib/access'
-import { type PublicUser, toPublicUser } from './lib/public'
-
-export const listBySkill = query({
-  args: { skillId: v.id('skills'), limit: v.optional(v.number()) },
-  handler: async (ctx, args) => {
-    const limit = args.limit ?? 50
-    const comments = await ctx.db
-      .query('comments')
-      .withIndex('by_skill', (q) => q.eq('skillId', args.skillId))
-      .order('desc')
-      .take(limit)
-
-    const results: Array<{ comment: Doc<'comments'>; user: PublicUser | null }> = []
-    for (const comment of comments) {
-      if (comment.softDeletedAt) continue
-      const user = toPublicUser(await ctx.db.get(comment.userId))
-      results.push({ comment, user })
-    }
-    return results
-  },
-})
-
-export const add = mutation({
-  args: { skillId: v.id('skills'), body: v.string() },
-  handler: async (ctx, args) => {
-    const { userId } = await requireUser(ctx)
-    const body = args.body.trim()
-    if (!body) throw new Error('Comment body required')
-
-    const skill = await ctx.db.get(args.skillId)
-    if (!skill) throw new Error('Skill not found')
-
-    await ctx.db.insert('comments', {
-      skillId: args.skillId,
-      userId,
-      body,
-      createdAt: Date.now(),
-      softDeletedAt: undefined,
-      deletedBy: undefined,
-    })
-
-    await ctx.db.patch(skill._id, {
-      stats: { ...skill.stats, comments: skill.stats.comments + 1 },
-      updatedAt: Date.now(),
-    })
-  },
-})
-
-export const remove = mutation({
-  args: { commentId: v.id('comments') },
-  handler: async (ctx, args) => {
-    const { user } = await requireUser(ctx)
-    const comment = await ctx.db.get(args.commentId)
-    if (!comment) throw new Error('Comment not found')
-    if (comment.softDeletedAt) return
-
-    const isOwner = comment.userId === user._id
-    if (!isOwner) {
-      assertModerator(user)
-    }
-
-    await ctx.db.patch(comment._id, {
-      softDeletedAt: Date.now(),
-      deletedBy: user._id,
-    })
-
-    const skill = await ctx.db.get(comment.skillId)
-    if (skill) {
-      await ctx.db.patch(skill._id, {
-        stats: { ...skill.stats, comments: Math.max(0, skill.stats.comments - 1) },
-        updatedAt: Date.now(),
-      })
-    }
-
-    await ctx.db.insert('auditLogs', {
-      actorUserId: user._id,
-      action: 'comment.delete',
-      targetType: 'comment',
-      targetId: comment._id,
-      metadata: { skillId: comment.skillId },
-      createdAt: Date.now(),
-    })
-  },
-})

package/convex/crons.ts

@@ -1,34 +0,0 @@
-import { cronJobs } from 'convex/server'
-import { internal } from './_generated/api'
-
-const crons = cronJobs()
-
-crons.interval(
-  'github-backup-sync',
-  { minutes: 30 },
-  internal.githubBackupsNode.syncGitHubBackupsInternal,
-  { batchSize: 50, maxBatches: 5 },
-)
-
-crons.interval(
-  'trending-leaderboard',
-  { minutes: 60 },
-  internal.leaderboards.rebuildTrendingLeaderboardInternal,
-  { limit: 200 },
-)
-
-crons.interval(
-  'skill-stats-backfill',
-  { minutes: 10 },
-  internal.statsMaintenance.runSkillStatBackfillInternal,
-  { batchSize: 200, maxBatches: 5 },
-)
-
-crons.interval(
-  'skill-stat-events',
-  { minutes: 15 },
-  internal.skillStatEvents.processSkillStatEventsAction,
-  {},
-)
-
-export default crons

package/convex/devSeed.ts

@@ -1,459 +0,0 @@
-import { v } from 'convex/values'
-import { internal } from './_generated/api'
-import type { ActionCtx } from './_generated/server'
-import { internalAction, internalMutation } from './_generated/server'
-import { EMBEDDING_DIMENSIONS } from './lib/embeddings'
-import { parseFrontmatter, parsePilotbotMetadata } from './lib/skills'
-
-type SeedSkillSpec = {
-  slug: string
-  displayName: string
-  summary: string
-  version: string
-  metadata: Record<string, unknown>
-  rawSkillMd: string
-}
-
-type SeedActionArgs = {
-  reset?: boolean
-}
-
-type SeedActionResult = {
-  ok: true
-  results: Array<Record<string, unknown> & { slug: string }>
-}
-
-type SeedMutationResult = Record<string, unknown>
-
-const SEED_SKILLS: SeedSkillSpec[] = [
-  {
-    slug: 'padel',
-    displayName: 'Padel',
-    summary: 'Check padel court availability and manage bookings via Playtomic.',
-    version: '0.1.0',
-    metadata: {
-      pilotbot: {
-        nix: {
-          plugin: 'github:joshp123/padel-cli',
-          systems: ['aarch64-darwin', 'x86_64-linux'],
-        },
-        config: {
-          requiredEnv: ['PADEL_AUTH_FILE'],
-          stateDirs: ['.config/padel'],
-          example:
-            'config = { env = { PADEL_AUTH_FILE = "/run/agenix/padel-auth"; }; stateDirs = [ ".config/padel" ]; };',
-        },
-        cliHelp: `Padel CLI for availability
-
-Usage:
-  padel [command]
-
-Available Commands:
-  auth         Manage authentication
-  availability Show availability for a club on a date
-  book         Book a court
-  bookings     Manage bookings history
-  search       Search for available courts
-  venues       Manage saved venues
-
-Flags:
-  -h, --help   help for padel
-  --json       Output JSON
-
-Use "padel [command] --help" for more information about a command.
-`,
-      },
-    },
-    rawSkillMd: `---
-name: padel
-description: Check padel court availability and manage bookings via the padel CLI.
----
-
-# Padel Booking Skill
-
-## CLI
-
-\`\`\`bash
-padel  # On PATH (pilotbot plugin bundle)
-\`\`\`
-
-## Venues
-
-Use the configured venue list in order of preference. If no venues are configured, ask for a venue name or location.
-
-## Commands
-
-### Check next booking
-\`\`\`bash
-padel bookings list 2>&1 | head -3
-\`\`\`
-
-### Search availability
-\`\`\`bash
-padel search --venues VENUE1,VENUE2 --date YYYY-MM-DD --time 09:00-12:00
-\`\`\`
-
-## Response guidelines
-
-- Keep responses concise.
-- Use 🎾 emoji.
-- End with a call to action.
-
-## Authorization
-
-Only the authorized booker can confirm bookings. If the requester is not authorized, ask the authorized user to confirm.
-`,
-  },
-  {
-    slug: 'gohome',
-    displayName: 'GoHome',
-    summary: 'Operate GoHome via gRPC discovery, metrics, and Grafana dashboards.',
-    version: '0.1.0',
-    metadata: {
-      pilotbot: {
-        nix: {
-          plugin: 'github:joshp123/gohome',
-          systems: ['x86_64-linux', 'aarch64-linux'],
-        },
-        config: {
-          requiredEnv: ['GOHOME_GRPC_ADDR', 'GOHOME_HTTP_BASE'],
-          example:
-            'config = { env = { GOHOME_GRPC_ADDR = "gohome:9000"; GOHOME_HTTP_BASE = "http://gohome:8080"; }; };',
-        },
-        cliHelp: `GoHome CLI
-
-Usage:
-  gohome-cli [command]
-
-Available Commands:
-  services   List registered services
-  plugins    Inspect loaded plugins
-  methods    List RPC methods
-  call       Call an RPC method
-  roborock   Manage roborock devices
-  tado       Manage tado zones
-
-Flags:
-  --grpc-addr string   gRPC endpoint (host:port)
-  -h, --help           help for gohome-cli
-`,
-      },
-    },
-    rawSkillMd: `---
-name: gohome
-description: Use when Pilotbot needs to test or operate GoHome via gRPC discovery, metrics, and Grafana.
----
-
-# GoHome Skill
-
-## Quick start
-
-\`\`\`bash
-export GOHOME_HTTP_BASE="http://gohome:8080"
-export GOHOME_GRPC_ADDR="gohome:9000"
-\`\`\`
-
-## CLI
-
-\`\`\`bash
-gohome-cli services
-\`\`\`
-
-## Discovery flow (read-only)
-
-1) List plugins.
-2) Describe a plugin.
-3) List RPC methods.
-4) Call a read-only RPC.
-
-## Metrics validation
-
-\`\`\`bash
-curl -s "\${GOHOME_HTTP_BASE}/gohome/metrics" | rg -n "gohome_"
-\`\`\`
-
-## Stateful actions
-
-Only call write RPCs after explicit user approval.
-`,
-  },
-  {
-    slug: 'xuezh',
-    displayName: 'Xuezh',
-    summary: 'Teach Mandarin with the xuezh engine for review, speaking, and audits.',
-    version: '0.1.0',
-    metadata: {
-      pilotbot: {
-        nix: {
-          plugin: 'github:joshp123/xuezh',
-          systems: ['aarch64-darwin', 'x86_64-linux'],
-        },
-        config: {
-          requiredEnv: ['XUEZH_AZURE_SPEECH_KEY_FILE', 'XUEZH_AZURE_SPEECH_REGION'],
-          stateDirs: ['.config/xuezh'],
-          example:
-            'config = { env = { XUEZH_AZURE_SPEECH_KEY_FILE = "/run/agenix/xuezh-azure-speech-key"; XUEZH_AZURE_SPEECH_REGION = "westeurope"; }; stateDirs = [ ".config/xuezh" ]; };',
-        },
-        cliHelp: `xuezh - Chinese learning engine
-
-Usage:
-  xuezh [command]
-
-Available Commands:
-  snapshot  Fetch learner state snapshot
-  review    Review due items
-  audio     Process speech audio
-  items     Manage learning items
-  events    Log learning events
-
-Flags:
-  -h, --help   help for xuezh
-  --json       Output JSON
-`,
-      },
-    },
-    rawSkillMd: `---
-name: xuezh
-description: Teach Mandarin using the xuezh engine for review, speaking, and audits.
----
-
-# Xuezh Skill
-
-## Contract
-
-Use the xuezh CLI exactly as specified. If a command is missing, ask for implementation instead of guessing.
-
-## Default loop
-
-1) Call \`xuezh snapshot\`.
-2) Pick a tiny plan (1-2 bullets).
-3) Run a short activity.
-4) Log outcomes.
-
-## CLI examples
-
-\`\`\`bash
-xuezh snapshot --profile default
-xuezh review next --limit 10
-xuezh audio process-voice --file ./utterance.wav
-\`\`\`
-`,
-  },
-]
-
-function injectMetadata(rawSkillMd: string, metadata: Record<string, unknown>) {
-  const frontmatterEnd = rawSkillMd.indexOf('\n---', 3)
-  if (frontmatterEnd === -1) return rawSkillMd
-  return `${rawSkillMd.slice(0, frontmatterEnd)}\nmetadata: ${JSON.stringify(
-    metadata,
-  )}${rawSkillMd.slice(frontmatterEnd)}`
-}
-
-async function seedNixSkillsHandler(
-  ctx: ActionCtx,
-  args: SeedActionArgs,
-): Promise<SeedActionResult> {
-  const results: Array<Record<string, unknown> & { slug: string }> = []
-
-  for (const spec of SEED_SKILLS) {
-    const skillMd = injectMetadata(spec.rawSkillMd, spec.metadata)
-    const frontmatter = parseFrontmatter(skillMd)
-    const pilotbot = parsePilotbotMetadata(frontmatter)
-    const storageId = await ctx.storage.store(new Blob([skillMd], { type: 'text/markdown' }))
-
-    const result: SeedMutationResult = await ctx.runMutation(internal.devSeed.seedSkillMutation, {
-      reset: args.reset,
-      storageId,
-      metadata: spec.metadata,
-      frontmatter,
-      pilotbot,
-      skillMd,
-      slug: spec.slug,
-      displayName: spec.displayName,
-      summary: spec.summary,
-      version: spec.version,
-    })
-
-    results.push({ slug: spec.slug, ...result })
-  }
-
-  return { ok: true, results }
-}
-
-export const seedNixSkills: ReturnType<typeof internalAction> = internalAction({
-  args: {
-    reset: v.optional(v.boolean()),
-  },
-  handler: seedNixSkillsHandler,
-})
-
-async function seedPadelSkillHandler(
-  ctx: ActionCtx,
-  args: SeedActionArgs,
-): Promise<SeedMutationResult> {
-  const spec = SEED_SKILLS.find((entry) => entry.slug === 'padel')
-  if (!spec) throw new Error('padel seed spec missing')
-
-  const skillMd = injectMetadata(spec.rawSkillMd, spec.metadata)
-  const frontmatter = parseFrontmatter(skillMd)
-  const pilotbot = parsePilotbotMetadata(frontmatter)
-  const storageId = await ctx.storage.store(new Blob([skillMd], { type: 'text/markdown' }))
-
-  return (await ctx.runMutation(internal.devSeed.seedSkillMutation, {
-    reset: args.reset,
-    storageId,
-    metadata: spec.metadata,
-    frontmatter,
-    pilotbot,
-    skillMd,
-    slug: spec.slug,
-    displayName: spec.displayName,
-    summary: spec.summary,
-    version: spec.version,
-  })) as SeedMutationResult
-}
-
-export const seedPadelSkill: ReturnType<typeof internalAction> = internalAction({
-  args: {
-    reset: v.optional(v.boolean()),
-  },
-  handler: seedPadelSkillHandler,
-})
-
-export const seedSkillMutation = internalMutation({
-  args: {
-    reset: v.optional(v.boolean()),
-    storageId: v.id('_storage'),
-    metadata: v.any(),
-    frontmatter: v.any(),
-    pilotbot: v.any(),
-    skillMd: v.string(),
-    slug: v.string(),
-    displayName: v.string(),
-    summary: v.optional(v.string()),
-    version: v.string(),
-  },
-  handler: async (ctx, args) => {
-    const existing = await ctx.db
-      .query('skills')
-      .withIndex('by_slug', (q) => q.eq('slug', args.slug))
-      .unique()
-
-    if (existing && !args.reset) {
-      return { ok: true, skipped: true, skillId: existing._id }
-    }
-
-    if (existing && args.reset) {
-      const versions = await ctx.db
-        .query('skillVersions')
-        .withIndex('by_skill', (q) => q.eq('skillId', existing._id))
-        .collect()
-      for (const version of versions) {
-        await ctx.db.delete(version._id)
-      }
-      const embeddings = await ctx.db
-        .query('skillEmbeddings')
-        .withIndex('by_skill', (q) => q.eq('skillId', existing._id))
-        .collect()
-      for (const embedding of embeddings) {
-        await ctx.db.delete(embedding._id)
-      }
-      await ctx.db.delete(existing._id)
-    }
-
-    const now = Date.now()
-    const existingUsers = await ctx.db
-      .query('users')
-      .withIndex('handle', (q) => q.eq('handle', 'local'))
-      .collect()
-
-    const userId =
-      existingUsers[0]?._id ??
-      (await ctx.db.insert('users', {
-        handle: 'local',
-        displayName: 'Local Dev',
-        role: 'admin',
-        createdAt: now,
-        updatedAt: now,
-      }))
-
-    const skillId = await ctx.db.insert('skills', {
-      slug: args.slug,
-      displayName: args.displayName,
-      summary: args.summary,
-      ownerUserId: userId,
-      latestVersionId: undefined,
-      tags: {},
-      softDeletedAt: undefined,
-      badges: { redactionApproved: undefined },
-      statsDownloads: 0,
-      statsStars: 0,
-      statsInstallsCurrent: 0,
-      statsInstallsAllTime: 0,
-      stats: {
-        downloads: 0,
-        installsCurrent: 0,
-        installsAllTime: 0,
-        stars: 0,
-        versions: 0,
-        comments: 0,
-      },
-      createdAt: now,
-      updatedAt: now,
-    })
-
-    const versionId = await ctx.db.insert('skillVersions', {
-      skillId,
-      version: args.version,
-      changelog: 'Seeded local version for screenshots.',
-      files: [
-        {
-          path: 'SKILL.md',
-          size: args.skillMd.length,
-          storageId: args.storageId,
-          sha256: 'seeded',
-          contentType: 'text/markdown',
-        },
-      ],
-      parsed: {
-        frontmatter: args.frontmatter,
-        metadata: args.metadata,
-        pilotbot: args.pilotbot,
-      },
-      createdBy: userId,
-      createdAt: now,
-      softDeletedAt: undefined,
-    })
-
-    const embeddingId = await ctx.db.insert('skillEmbeddings', {
-      skillId,
-      versionId,
-      ownerId: userId,
-      embedding: Array.from({ length: EMBEDDING_DIMENSIONS }, () => 0),
-      isLatest: true,
-      isApproved: true,
-      visibility: 'latest-approved',
-      updatedAt: now,
-    })
-
-    await ctx.db.patch(skillId, {
-      latestVersionId: versionId,
-      tags: { latest: versionId },
-      statsDownloads: 0,
-      statsStars: 0,
-      statsInstallsCurrent: 0,
-      statsInstallsAllTime: 0,
-      stats: {
-        downloads: 0,
-        installsCurrent: 0,
-        installsAllTime: 0,
-        stars: 0,
-        versions: 1,
-        comments: 0,
-      },
-      updatedAt: now,
-    })
-
-    return { ok: true, skillId, versionId, embeddingId }
-  },
-})