Add schedule name derivation and include installer/docs/tests

Author: waydelyle

README.md

@@ -3,18 +3,14 @@
 [![CI](https://github.com/swarmclawai/swarmclaw/actions/workflows/ci.yml/badge.svg)](https://github.com/swarmclawai/swarmclaw/actions/workflows/ci.yml)
 [![Release](https://img.shields.io/github/v/release/swarmclawai/swarmclaw?sort=semver)](https://github.com/swarmclawai/swarmclaw/releases)
 
-<p align="center">
-  <img src="public/branding/swarmclaw-org-avatar.png" alt="SwarmClaw lobster logo" width="120" />
-</p>
-
 Self-hosted AI agent orchestration dashboard. Manage multiple AI providers, orchestrate agent swarms, schedule tasks, and bridge agents to chat platforms — all from a single mobile-friendly interface.
 
-SwarmClaw can connect to one or many [OpenClaw](https://github.com/openclaw/openclaw) instances and orchestrate them from a single control plane.
-
 Inspired by [OpenClaw](https://github.com/openclaw).
 
 **[Documentation](https://swarmclaw.ai/docs)** | **[Website](https://swarmclaw.ai)**
 
+Org avatar files: `public/branding/swarmclaw-org-avatar.png` (upload-ready), `public/branding/swarmclaw-org-avatar.svg` (source)
+
 ![Dashboard](public/screenshots/dashboard.png)
 ![Agent Builder](public/screenshots/agents.png)
 ![Task Board](public/screenshots/tasks.png)

install.sh

@@ -0,0 +1,111 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO="${SWARMCLAW_REPO:-swarmclawai/swarmclaw}"
+INSTALL_DIR="${SWARMCLAW_DIR:-$HOME/swarmclaw}"
+REQUESTED_VERSION="${SWARMCLAW_VERSION:-latest}"
+
+log() {
+  printf '[install] %s\n' "$1"
+}
+
+fail() {
+  printf '[install] ERROR: %s\n' "$1" >&2
+  exit 1
+}
+
+need_cmd() {
+  if ! command -v "$1" >/dev/null 2>&1; then
+    fail "Required command not found: $1"
+  fi
+}
+
+resolve_latest_release_tag() {
+  local api_url="https://api.github.com/repos/${REPO}/releases/latest"
+  local tag
+
+  if command -v curl >/dev/null 2>&1; then
+    tag="$(curl -fsSL "$api_url" | sed -n 's/.*"tag_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -n1 || true)"
+  else
+    tag=""
+  fi
+
+  if [[ -z "$tag" ]]; then
+    tag="$(git ls-remote --tags --sort='-v:refname' "https://github.com/${REPO}.git" 'v*' 2>/dev/null | awk -F'/' 'NR==1 { print $3 }')"
+  fi
+
+  printf '%s' "$tag"
+}
+
+checkout_target() {
+  local target="$1"
+
+  if [[ "$target" == "main" ]]; then
+    git checkout main >/dev/null 2>&1 || git checkout -B main origin/main
+    git pull --ff-only origin main
+    return
+  fi
+
+  if ! [[ "$target" =~ ^v[0-9]+\.[0-9]+\.[0-9]+([-.+][0-9A-Za-z.-]+)?$ ]]; then
+    fail "Resolved version is not a valid release tag: $target"
+  fi
+
+  git fetch --tags origin --quiet
+  if ! git rev-parse "refs/tags/${target}" >/dev/null 2>&1; then
+    fail "Release tag not found: ${target}"
+  fi
+  git checkout -B stable "refs/tags/${target}"
+}
+
+main() {
+  need_cmd git
+  need_cmd node
+  need_cmd npm
+  need_cmd sed
+  need_cmd awk
+
+  local target="$REQUESTED_VERSION"
+  if [[ "$target" == "latest" ]]; then
+    target="$(resolve_latest_release_tag)"
+    if [[ -z "$target" ]]; then
+      log "No stable release tag found yet. Falling back to main branch."
+      target="main"
+    fi
+  fi
+
+  log "Installing ${REPO} (${target}) into ${INSTALL_DIR}"
+
+  if [[ -d "$INSTALL_DIR/.git" ]]; then
+    log "Existing install detected; updating repository metadata."
+    git -C "$INSTALL_DIR" remote set-url origin "https://github.com/${REPO}.git"
+    git -C "$INSTALL_DIR" fetch --all --tags --prune --quiet
+  else
+    rm -rf "$INSTALL_DIR"
+    git clone "https://github.com/${REPO}.git" "$INSTALL_DIR"
+  fi
+
+  cd "$INSTALL_DIR"
+  checkout_target "$target"
+
+  log "Installing dependencies"
+  npm install
+
+  log "Bootstrapping local environment"
+  npm run setup:easy -- --skip-install
+
+  cat <<EOF
+
+SwarmClaw installed successfully.
+
+Next steps:
+1. cd "$INSTALL_DIR"
+2. npm run dev
+3. Open http://localhost:3456
+
+For updates later:
+- npm run update:easy
+EOF
+}
+
+main "$@"
+

scripts/easy-update.mjs

@@ -5,7 +5,9 @@ import { spawnSync } from 'node:child_process'
 const args = new Set(process.argv.slice(2))
 const skipBuild = args.has('--skip-build')
 const allowDirty = args.has('--allow-dirty')
+const forceMain = args.has('--main')
 const cwd = process.cwd()
+const RELEASE_TAG_RE = /^v\d+\.\d+\.\d+([-.+][0-9A-Za-z.-]+)?$/
 
 function log(message) {
   process.stdout.write(`[update] ${message}\n`)
@@ -45,6 +47,13 @@ function runOrThrow(command, commandArgs, options = {}) {
   }
 }
 
+function getLatestStableTag() {
+  const tagList = run('git', ['tag', '--list', 'v*', '--sort=-v:refname'])
+  if (!tagList.ok) return null
+  const tags = tagList.out.split('\n').map((line) => line.trim()).filter(Boolean)
+  return tags.find((tag) => RELEASE_TAG_RE.test(tag)) || null
+}
+
 function main() {
   const gitCheck = run('git', ['rev-parse', '--is-inside-work-tree'])
   if (!gitCheck.ok) {
@@ -68,17 +77,40 @@ function main() {
     fail('Could not resolve current git SHA.')
   }
 
-  runOrThrow('git', ['fetch', 'origin', 'main', '--quiet'])
-  const behind = run('git', ['rev-list', 'HEAD..origin/main', '--count'])
-  const behindBy = Number.parseInt(behind.out || '0', 10) || 0
+  runOrThrow('git', ['fetch', '--tags', 'origin', '--quiet'])
 
-  if (behindBy <= 0) {
-    log('Already up to date. Nothing to install.')
-    return
-  }
+  let updateSource = 'main'
+  let pullOutput = ''
+  const latestTag = forceMain ? null : getLatestStableTag()
+
+  if (latestTag) {
+    const behind = run('git', ['rev-list', `HEAD..${latestTag}^{commit}`, '--count'])
+    const behindBy = Number.parseInt(behind.out || '0', 10) || 0
+
+    if (behindBy <= 0) {
+      log(`Already on latest stable release (${latestTag}) or newer.`)
+      return
+    }
 
-  log(`Found ${behindBy} new commit(s). Updating now...`)
-  runOrThrow('git', ['pull', '--ff-only', 'origin', 'main'])
+    updateSource = `stable release ${latestTag}`
+    log(`Found ${behindBy} commit(s) behind ${latestTag}. Updating now...`)
+    runOrThrow('git', ['checkout', '-B', 'stable', `${latestTag}^{commit}`])
+    pullOutput = `Updated to ${latestTag}`
+  } else {
+    runOrThrow('git', ['fetch', 'origin', 'main', '--quiet'])
+    const behind = run('git', ['rev-list', 'HEAD..origin/main', '--count'])
+    const behindBy = Number.parseInt(behind.out || '0', 10) || 0
+
+    if (behindBy <= 0) {
+      log('Already up to date. Nothing to install.')
+      return
+    }
+
+    updateSource = 'main branch'
+    log(`Found ${behindBy} new commit(s) on origin/main. Updating now...`)
+    runOrThrow('git', ['pull', '--ff-only', 'origin', 'main'])
+    pullOutput = `Pulled origin/main (+${behindBy})`
+  }
 
   const changed = run('git', ['diff', '--name-only', `${beforeSha.out}..HEAD`])
   const changedFiles = new Set((changed.out || '').split('\n').map((s) => s.trim()).filter(Boolean))
@@ -97,6 +129,7 @@ function main() {
   }
 
   log('Update complete.')
+  log(`Source: ${updateSource}. ${pullOutput}`.trim())
   log('Restart SwarmClaw to apply the new version.')
 }
 

src/app/api/schedules/[id]/route.ts

@@ -1,5 +1,6 @@
 import { NextResponse } from 'next/server'
 import { loadSchedules, saveSchedules } from '@/lib/server/storage'
+import { resolveScheduleName } from '@/lib/schedule-name'
 
 export async function PUT(req: Request, { params }: { params: Promise<{ id: string }> }) {
   const { id } = await params
@@ -10,6 +11,10 @@ export async function PUT(req: Request, { params }: { params: Promise<{ id: stri
   const origId = id
   Object.assign(schedules[id], body)
   schedules[id].id = origId
+  schedules[id].name = resolveScheduleName({
+    name: schedules[id].name,
+    taskPrompt: schedules[id].taskPrompt,
+  })
   saveSchedules(schedules)
   return NextResponse.json(schedules[id])
 }

src/app/api/schedules/route.ts

@@ -1,6 +1,7 @@
 import { NextResponse } from 'next/server'
 import crypto from 'crypto'
 import { loadSchedules, saveSchedules } from '@/lib/server/storage'
+import { resolveScheduleName } from '@/lib/schedule-name'
 
 export async function GET() {
   return NextResponse.json(loadSchedules())
@@ -24,7 +25,7 @@ export async function POST(req: Request) {
 
   schedules[id] = {
     id,
-    name: body.name || 'Unnamed Schedule',
+    name: resolveScheduleName({ name: body.name, taskPrompt: body.taskPrompt }),
     agentId: body.agentId,
     taskPrompt: body.taskPrompt || '',
     scheduleType: body.scheduleType || 'cron',

src/components/schedules/schedule-sheet.tsx

@@ -138,7 +138,7 @@ export function ScheduleSheet() {
 
   const handleSave = async () => {
     const data = {
-      name: name.trim() || 'Unnamed Schedule',
+      name: name.trim(),
       agentId,
       taskPrompt,
       scheduleType,

src/lib/schedule-name.ts

@@ -0,0 +1,62 @@
+const MAX_SCHEDULE_NAME_LENGTH = 80
+
+function normalizeWhitespace(value: string): string {
+  return value.replace(/\s+/g, ' ').trim()
+}
+
+function truncate(value: string, maxLength = MAX_SCHEDULE_NAME_LENGTH): string {
+  if (value.length <= maxLength) return value
+  return `${value.slice(0, Math.max(0, maxLength - 1)).trimEnd()}...`
+}
+
+function isGenericName(name: string): boolean {
+  const normalized = normalizeWhitespace(name).toLowerCase()
+  return normalized === '' || normalized === 'schedule' || normalized === 'new schedule' || normalized === 'unnamed schedule'
+}
+
+function deriveFromPrompt(taskPrompt: string): string {
+  const prompt = normalizeWhitespace(taskPrompt)
+  if (!prompt) return 'Scheduled Task'
+
+  const lower = prompt.toLowerCase()
+  if (lower.includes('wikipedia') && (lower.includes('screenshot') || lower.includes('screen shot'))) {
+    return 'Wikipedia Screenshot'
+  }
+  if (lower.includes('screenshot')) {
+    return 'Screenshot Task'
+  }
+  if (lower.includes('backup')) {
+    return 'Backup Task'
+  }
+  if (lower.includes('health check') || lower.includes('heartbeat')) {
+    return 'Health Check'
+  }
+  if (lower.includes('report')) {
+    return 'Report Task'
+  }
+
+  const firstLine = prompt.split('\n')[0] || prompt
+  const firstClause = firstLine.split(/[.,;:!?]/)[0] || firstLine
+  const cleaned = normalizeWhitespace(
+    firstClause
+      .replace(/^(please\s+)?(can you|could you|would you)\s+/i, '')
+      .replace(/^(create|make|set up|setup|schedule|run|execute|trigger|perform|generate|send|take|capture|navigate|go|open|check|monitor|fetch|pull|build|test)\b\s*/i, '')
+      .replace(/^to\s+/i, ''),
+  )
+  if (!cleaned) return 'Scheduled Task'
+  return `${cleaned.charAt(0).toUpperCase()}${cleaned.slice(1)}`
+}
+
+export function resolveScheduleName(input: {
+  name?: unknown
+  taskPrompt?: unknown
+}): string {
+  const providedName = typeof input.name === 'string' ? normalizeWhitespace(input.name) : ''
+  if (providedName && !isGenericName(providedName)) {
+    return truncate(providedName)
+  }
+
+  const taskPrompt = typeof input.taskPrompt === 'string' ? input.taskPrompt : ''
+  return truncate(deriveFromPrompt(taskPrompt))
+}
+

src/lib/server/session-tools.ts

@@ -36,6 +36,7 @@ import {
 import { log } from './logger'
 import { queryLogs, countLogs, clearLogs, type LogCategory } from './execution-log'
 import { resolveSessionToolPolicy } from './tool-capability-policy'
+import { resolveScheduleName } from '@/lib/schedule-name'
 
 const MAX_OUTPUT = 50 * 1024 // 50KB
 const MAX_FILE = 100 * 1024 // 100KB
@@ -1859,7 +1860,7 @@ export function buildSessionTools(cwd: string, enabledTools: string[], ctx?: Too
     manage_schedules: (p) => {
       const now = Date.now()
       const base = {
-        name: p.name || 'Unnamed Schedule',
+        name: resolveScheduleName({ name: p.name, taskPrompt: p.taskPrompt }),
         agentId: p.agentId || null,
         taskPrompt: p.taskPrompt || '',
         scheduleType: p.scheduleType || 'interval',