@doguyilmaz/konvoy 0.1.2 → 0.2.0

package/README.md

@@ -41,6 +41,7 @@ to download; the npm package is a few kilobytes of source and runs on the Bun yo
 
 ```bash
 konvoy new "refactor the auth layer"
+konvoy new                     # no goal: named after the directory, like sinkaf-8f3a
 konvoy send codex "start with the token refresh path"
 konvoy ls
 konvoy resume                  # make a session current again and show its roster
@@ -52,6 +53,7 @@ konvoy attach kiro --id cli_8a1…   # adopt a session you started in kiro's own
 konvoy doctor
 konvoy update --all    # every agent CLI; konvoy itself follows its install channel (see Install)
 konvoy rm stale-slug --yes
+konvoy rename stale-slug token-refresh   # the session's .konvoy folder follows
 konvoy version
 konvoy dashboard --port 4000  # local page with the same numbers as `usage --chart`
 ```
@@ -164,6 +166,9 @@ Global `~/.config/konvoy/config.jsonc`, per project `.konvoy/config.jsonc`. The
 file wins. `konvoy config get` shows each agent's resolved settings and whether a value came
 from that agent, from `defaults`, or from konvoy's own built-in.
 
+`konvoy new` also writes `.konvoy/.gitignore` (`*`, then `!config.jsonc`), so a session's `CONTEXT.md`
+and `LEDGER.md` never reach git while the project config can be committed.
+
 ```jsonc
 {
   "defaults": { "effort": "high", "permission": "edit" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doguyilmaz/konvoy",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "One session across Claude Code, Codex, Kiro CLI and opencode: bind, hand off, fail over.",
   "license": "MIT",
   "type": "module",

package/src/cli.ts

@@ -18,6 +18,7 @@ import { cmdUpdate } from './commands/update'
 import { cmdConfig } from './commands/config'
 import { cmdResume } from './commands/resume'
 import { cmdRm } from './commands/rm'
+import { cmdRename } from './commands/rename'
 import { cmdUsage } from './commands/usage'
 import { cmdDashboard } from './commands/dashboard'
 import { formatCommandList, resolveCommandName, type CommandName } from './commands/table'
@@ -78,6 +79,14 @@ const handlers: Record<CommandName, Handler> = {
     const [action, key, value] = rest
     return cmdConfig(ctx.cfg, ctx.cwd, action ?? 'get', key, value, { global: ctx.args.flags.global === true })
   },
+  rename: (ctx, rest) => {
+    const [from, to] = rest
+    if (!from || !to) {
+      console.error('usage: konvoy rename <session> <new-name>')
+      return 2
+    }
+    return cmdRename(ctx.db, from, to)
+  },
   rm: (ctx, rest) => {
     const [target] = rest
     if (!target) {

package/src/commands/new.ts

@@ -1,20 +1,23 @@
 import type { Database } from 'bun:sqlite'
 import type { Config } from '../config/schema'
-import { newSession } from '../core/session'
-import { sessionDir } from '../paths'
+import { newSession, slugify } from '../core/session'
+import { basename, join, sessionDir } from '../paths'
 
 export async function cmdNew(db: Database, cfg: Config, cwd: string, goal: string): Promise<number> {
   const lead = cfg.roles.lead ?? 'claude'
-  const session = newSession(db, { cwd, goal: goal || 'untitled', lead })
+  const suffix = Bun.randomUUIDv7().slice(-4)
+  const slug = goal ? undefined : `${slugify(basename(cwd)).slice(0, 30)}-${suffix}`
+  const session = newSession(db, { cwd, goal, lead, slug })
   const dir = sessionDir(cwd, session.slug)
+  const ignore = Bun.file(join(cwd, '.konvoy', '.gitignore'))
+  if (!(await ignore.exists())) await Bun.write(ignore, '*\n!config.jsonc\n')
   // `konvoy rm` frees the slug but leaves these files - they are the user's. A new session under
   // an old slug adds its goal to the context and appends to the ledger; it truncates neither.
   const context = Bun.file(`${dir}/CONTEXT.md`)
+  const goalSection = session.goal ? `\n## Goal\n\n${session.goal}\n` : ''
   await Bun.write(
     context,
-    (await context.exists())
-      ? `${await context.text()}\n## Goal\n\n${session.goal}\n`
-      : `# ${session.slug}\n\n## Goal\n\n${session.goal}\n`,
+    (await context.exists()) ? `${await context.text()}${goalSection}` : `# ${session.slug}\n${goalSection}`,
   )
   const ledger = Bun.file(`${dir}/LEDGER.md`)
   if (!(await ledger.exists())) await Bun.write(ledger, `# Ledger - ${session.slug}\n`)

package/src/commands/rename.ts

@@ -0,0 +1,49 @@
+import type { Database } from 'bun:sqlite'
+import { slugify } from '../core/session'
+import { sessionDir } from '../paths'
+import { getSessionBySlug, lockOwner, renameSession } from '../store/queries'
+
+const isDir = async (path: string): Promise<boolean> => (await Bun.$`test -d ${path}`.quiet().nothrow()).exitCode === 0
+
+async function retitle(path: string, from: string, to: string): Promise<void> {
+  const file = Bun.file(path)
+  if (!(await file.exists())) return
+  const text = await file.text()
+  if (text.startsWith(from)) await Bun.write(file, to + text.slice(from.length))
+}
+
+export async function cmdRename(db: Database, from: string, to: string): Promise<number> {
+  const session = getSessionBySlug(db, from)
+  if (!session) {
+    console.error(`no konvoy session named "${from}"`)
+    return 2
+  }
+  const busy = lockOwner(db, session.id)
+  if (busy) {
+    console.error(`"${from}" has a turn running (${busy}) - wait for it to finish, then retry`)
+    return 2
+  }
+  const slug = slugify(to)
+  if (getSessionBySlug(db, slug)) {
+    console.error(`a session named "${slug}" already exists`)
+    return 2
+  }
+  const oldDir = sessionDir(session.cwd, from)
+  const newDir = sessionDir(session.cwd, slug)
+  if (await isDir(oldDir)) {
+    if (await isDir(newDir)) {
+      console.error(`${newDir} already exists - move it away first`)
+      return 2
+    }
+    const moved = await Bun.$`mv ${oldDir} ${newDir}`.quiet().nothrow()
+    if (moved.exitCode !== 0) {
+      console.error(`could not move ${oldDir} to ${newDir}: ${moved.stderr.toString().trim()}`)
+      return 1
+    }
+    await retitle(`${newDir}/CONTEXT.md`, `# ${from}\n`, `# ${slug}\n`)
+    await retitle(`${newDir}/LEDGER.md`, `# Ledger - ${from}\n`, `# Ledger - ${slug}\n`)
+  }
+  renameSession(db, session.id, slug)
+  console.log(`renamed ${from} -> ${slug}`)
+  return 0
+}

package/src/commands/table.ts

@@ -21,6 +21,7 @@ export const commandTable = [
     usage: 'rm <session> --yes',
     summary: 'delete a konvoy session (foreign sessions survive)',
   },
+  { name: 'rename', aliases: [], usage: 'rename <session> <new-name>', summary: 'rename a session; its .konvoy folder follows' },
   { name: 'roster', aliases: [], usage: 'roster', summary: 'who is in the convoy' },
   { name: 'usage', aliases: [], usage: 'usage [--all] [--chart]', summary: 'what this session spent, per agent' },
   { name: 'status', aliases: [], usage: 'status', summary: 'versions, auth and roster' },

package/src/core/prelude.ts

@@ -117,5 +117,5 @@ export function buildPrelude(db: Database, session: Session, facts: string, opts
 
   if (dropped > 0) turnBlocks.push(`(${dropped} earlier turn${dropped === 1 ? '' : 's'} not shown)`)
 
-  return [`goal: ${session.goal}`, facts, turnBlocks.join('\n\n')].filter(Boolean).join('\n\n')
+  return [session.goal ? `goal: ${session.goal}` : '', facts, turnBlocks.join('\n\n')].filter(Boolean).join('\n\n')
 }

package/src/paths.ts

@@ -14,6 +14,8 @@ export function join(...parts: string[]): string {
   return (absolute ? '/' : '') + segments.join('/')
 }
 
+export const basename = (p: string): string => p.split('/').filter(Boolean).at(-1) ?? ''
+
 export function dirname(p: string): string {
   const cut = p.lastIndexOf('/')
   if (cut < 0) return '.'

package/src/store/queries.ts

@@ -76,6 +76,10 @@ export function touchSession(db: Database, id: string): void {
   ).run({ id, now: now() })
 }
 
+export function renameSession(db: Database, id: string, slug: string): void {
+  db.query('UPDATE session SET slug = $slug WHERE id = $id').run({ slug, id })
+}
+
 export function deleteSession(db: Database, id: string): void {
   db.transaction(() => {
     db.query('DELETE FROM event WHERE turn_id IN (SELECT id FROM turn WHERE session_id = $id)').run({ id })