tspl-cli 0.0.0-stage → 0.1.1

package/src/commands/project.command.js

@@ -0,0 +1,191 @@
+'use strict'
+
+const { input } = require('@inquirer/prompts')
+
+const { request } = require('../api-client')
+const { readCredentials, readLinks, writeLinks } = require('../config-store')
+
+const localLinks = project =>
+  readLinks()[`${readCredentials().organization}/${project.slug}`] || { repos: {} }
+
+const printProject = project => {
+  const links = localLinks(project)
+  console.log(`${project.name} (${project.slug})`)
+  if (project.description) {
+    console.log(`  ${project.description}`)
+  }
+  if (!project.repos.length) {
+    console.log('  No repos yet. Run tspl inside the project folder to add them.')
+  }
+  project.repos.forEach(repo => {
+    const local = links.repos[repo._id]
+    console.log(
+      `  ${repo.name.padEnd(24)} [${repo.defaultBaseBranch}]  ${local ? local.path : '(not on this machine)'}`,
+    )
+  })
+}
+
+const list = async () => {
+  const projects = await request('GET', '/api/v1/projects')
+  if (!projects.length) {
+    console.log('No projects yet. Run tspl inside a project folder to create one.')
+    return
+  }
+  projects.forEach(project => {
+    console.log(`${project.slug}  ${project.name}  (${project.repos.length} repos)`)
+  })
+}
+
+const show = async projectRef => {
+  const project = await request(
+    'GET',
+    `/api/v1/projects/${encodeURIComponent(projectRef)}`,
+  )
+  printProject(project)
+}
+
+const removeRepo = async (projectRef, repoName) => {
+  const project = await request(
+    'GET',
+    `/api/v1/projects/${encodeURIComponent(projectRef)}`,
+  )
+  const repo = project.repos.find(r => r.name === repoName)
+  if (!repo) {
+    throw new Error(`"${repoName}" is not a repo of ${project.name}`)
+  }
+
+  const updated = await request(
+    'DELETE',
+    `/api/v1/projects/${project._id}/repos/${repo._id}`,
+  )
+
+  const links = readLinks()
+  const key = `${readCredentials().organization}/${project.slug}`
+  if (links[key]) {
+    delete links[key].repos[repo._id]
+    links[key].ignored = [
+      ...new Set([...(links[key].ignored || []), repo.fingerprint || repo.remoteHash]),
+    ]
+    writeLinks(links)
+  }
+
+  printProject(updated)
+}
+
+const memberId = async email => {
+  const members = await request('GET', '/api/v1/members')
+  const member = members.find(item => item.email === email.toLowerCase())
+  if (!member) {
+    throw new Error(`${email} is not in your organization; add them first: tspl member add ${email} --name "…" --role developer`)
+  }
+  return member.userId
+}
+
+const addMember = async (projectRef, email) => {
+  const project = await request('POST', `/api/v1/projects/${encodeURIComponent(projectRef)}/members`, { email })
+  console.log(`${email} can now work on ${project.name} (${project.members.length} people).`)
+}
+
+const removeMember = async (projectRef, email) => {
+  const project = await request('DELETE', `/api/v1/projects/${encodeURIComponent(projectRef)}/members/${await memberId(email)}`)
+  console.log(`${email} is off ${project.name}.`)
+}
+
+const setApproval = async (projectRef, value) => {
+  const on = { on: true, yes: true, true: true, off: false, no: false, false: false }[String(value).toLowerCase()]
+  if (on === undefined) {
+    throw new Error('Use on or off, e.g. tspl project set-approval my-project on')
+  }
+  const project = await request('PUT', `/api/v1/projects/${encodeURIComponent(projectRef)}/settings`, { requirePmApproval: on })
+  console.log(on
+    ? `${project.name}: plans now need PM approval after the developer approves.`
+    : `${project.name}: the developer's approval is enough; no PM approval needed.`)
+}
+
+const setBranch = async (projectRef, repoName, branch) => {
+  const project = await request(
+    'GET',
+    `/api/v1/projects/${encodeURIComponent(projectRef)}`,
+  )
+  const repo = project.repos.find(r => r.name === repoName)
+  if (!repo) {
+    throw new Error(`"${repoName}" is not a repo of ${project.name}`)
+  }
+  const updated = await request(
+    'PATCH',
+    `/api/v1/projects/${project._id}/repos/${repo._id}`,
+    { defaultBaseBranch: branch },
+  )
+  printProject(updated)
+}
+
+const remove = async (projectRef, options) => {
+  const project = await request(
+    'GET',
+    `/api/v1/projects/${encodeURIComponent(projectRef)}`,
+  )
+
+  if (!options.yes) {
+    const typed = await input({
+      message: `This deletes project "${project.name}" for everyone. Type ${project.slug} to confirm:`,
+    })
+    const answer = typed.trim().toLowerCase()
+    if (answer !== project.slug && answer !== project.name.toLowerCase()) {
+      console.log('Not deleted: the name did not match.')
+      return
+    }
+  }
+
+  await request('DELETE', `/api/v1/projects/${project._id}`)
+
+  const links = readLinks()
+  delete links[`${readCredentials().organization}/${project.slug}`]
+  writeLinks(links)
+
+  console.log(`Deleted project "${project.name}". Your local repos are untouched.`)
+}
+
+module.exports = {
+  register(program) {
+    const project = program.command('project').description('View projects and their repos')
+
+    project.command('list').description('Projects you can see').action(list)
+
+    project
+      .command('show <project>')
+      .description('One project, its repos, and where they are on this machine')
+      .action(show)
+
+    project
+      .command('remove-repo <project> <repo>')
+      .description('Remove a repo from a project (it is archived, not deleted)')
+      .action(removeRepo)
+
+    project
+      .command('set-branch <project> <repo> <branch>')
+      .description('Change which branch is read and built on for a repo')
+      .action(setBranch)
+
+    project
+      .command('add-member <project> <email>')
+      .description('Give a person in your organization access to a project (owner, admin or PM)')
+      .action(addMember)
+
+    project
+      .command('remove-member <project> <email>')
+      .description('Take a person off a project (owner, admin or PM)')
+      .action(removeMember)
+
+    project
+      .command('set-approval <project> <on|off>')
+      .description('Whether plans need PM approval before building (owner, admin or PM)')
+      .action(setApproval)
+
+    project
+      .command('delete <project>')
+      .alias('rm')
+      .description('Delete a project for everyone (owner or admin)')
+      .option('-y, --yes', 'skip the confirmation')
+      .action(remove)
+  },
+}

package/src/commands/setup.command.js

@@ -0,0 +1,63 @@
+'use strict'
+
+const Prompts = require('@inquirer/prompts')
+const { execFileSync } = require('child_process')
+
+const { configureMachine } = require('../setup')
+const { request, originOf } = require('../api-client')
+const config = require('../config-store')
+const engines = require('../engines')
+const { login } = require('./auth.command')
+const { TOOLS, connectTool } = require('./connect.command')
+
+const ICON = { ok: '✓', failed: '✗', missing: '✗', manual: '!', skipped: '–' }
+
+const gitVersion = () => {
+  try {
+    return execFileSync('git', ['--version'], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim()
+  } catch (err) {
+    return null
+  }
+}
+
+const defaultDeps = () => ({
+  prompts: Prompts,
+  config: { read: config.readConfig, write: config.writeConfig },
+  credentials: { read: config.readCredentials, clear: config.clearCredentials },
+  engines: {
+    detectAll: engines.detectAll,
+    defaultAssignments: engines.defaultAssignments,
+    read: config.readEngines,
+    write: config.writeEngines,
+    run: engines.run,
+  },
+  request,
+  originOf,
+  login,
+  connect: connectTool,
+  tools: TOOLS,
+  gitVersion,
+})
+
+const setup = async options => {
+  const result = await configureMachine(options, defaultDeps())
+  console.log('')
+  result.steps.forEach(item => console.log(`${ICON[item.status] || '?'} ${item.label}: ${item.detail}`))
+  console.log(`\n${result.ready ? 'This machine is ready.' : 'This machine is not ready yet.'}`)
+  result.next.forEach(line => console.log(`  → ${line}`))
+  if (!result.ready) process.exitCode = 1
+}
+
+module.exports = {
+  register(program) {
+    program
+      .command('setup')
+      .description('Configure this machine step by step: API login, AI engines, AI tool integrations, optional engine test (no project needed)')
+      .option('-y, --yes', 'keep existing choices and ask nothing')
+      .option('--api <url>', 'TSPL API address')
+      .option('--email <email>', 'your email')
+      .option('--org <slug>', 'organization, if you belong to several')
+      .option('--connect <tools...>', 'AI tools to connect (claude, codex, antigravity, gemini, cursor, vscode)')
+      .action(setup)
+  },
+}

package/src/commands/sync.command.js

@@ -0,0 +1,59 @@
+'use strict'
+
+const Path = require('path')
+const { spawn } = require('child_process')
+
+const { findProject } = require('../workspace')
+const { refreshIndex } = require('../analysis/analyzer')
+const { fetchBranch } = require('../git-helper')
+const { lockSync, unlockSync, readSyncState, writeSyncState } = require('../config-store')
+
+const BIN = Path.join(__dirname, '..', '..', 'bin', 'tspl.js')
+const FETCH_EVERY = 30 * 60 * 1000
+
+const fetchDue = projectId => {
+  const fetchedAt = (readSyncState()[projectId] || {}).fetchedAt
+  return !fetchedAt || Date.now() - new Date(fetchedAt).getTime() > FETCH_EVERY
+}
+
+const fetchBases = (project, repos) => {
+  const state = readSyncState()
+  state[project._id] = { ...(state[project._id] || {}), fetchedAt: new Date().toISOString() }
+  writeSyncState(state)
+  repos.forEach(repo => fetchBranch(repo.path, repo.defaultBaseBranch))
+}
+
+const sync = async () => {
+  if (!lockSync()) {
+    return
+  }
+  try {
+    const { project, repos, offline } = await findProject(process.cwd())
+    if (offline) {
+      return
+    }
+    if (fetchDue(project._id)) {
+      fetchBases(project, repos)
+    }
+    await refreshIndex(project, repos)
+  } finally {
+    unlockSync()
+  }
+}
+
+const syncInBackground = cwd => {
+  const child = spawn(process.execPath, [BIN, 'sync'], { cwd, detached: true, stdio: 'ignore' })
+  child.on('error', () => {})
+  child.unref()
+}
+
+module.exports = {
+  fetchDue,
+  syncInBackground,
+  register(program) {
+    program
+      .command('sync', { hidden: true })
+      .description('Fetch the newest base branches and refresh the local code map (runs in the background)')
+      .action(sync)
+  },
+}