@take-out/scripts 0.0.93 → 0.0.95

package/src/update-changelog.ts

@@ -1,61 +1,56 @@
 #!/usr/bin/env bun
 
-/**
- * @description Update changelog.mdx with recent git commits using Claude Code
- *
- * outputs a prompt for claude code to investigate commits and update changelog
- * run: bun tko update-changelog
- */
+import { cmd } from './cmd'
 
-import { execSync } from 'node:child_process'
-import { existsSync, readFileSync } from 'node:fs'
-import { join } from 'node:path'
+await cmd`update changelog with recent git commits`.run(async ({ path }) => {
+  const { execSync } = await import('node:child_process')
+  const { existsSync, readFileSync } = await import('node:fs')
 
-const CHANGELOG_PATH = join(process.cwd(), 'src/features/site/docs/changelog.mdx')
+  const CHANGELOG_PATH = path.join(process.cwd(), 'src/features/site/docs/changelog.mdx')
 
-function getLastSha(): string | null {
-  if (!existsSync(CHANGELOG_PATH)) return null
+  function getLastSha(): string | null {
+    if (!existsSync(CHANGELOG_PATH)) return null
 
-  try {
-    const content = readFileSync(CHANGELOG_PATH, 'utf-8')
-    const match = content.match(/\{\/\* last updated: ([a-f0-9]+) \*\/\}/)
-    return match?.[1] || null
-  } catch {
-    return null
+    try {
+      const content = readFileSync(CHANGELOG_PATH, 'utf-8')
+      const match = content.match(/\{\/\* last updated: ([a-f0-9]+) \*\/\}/)
+      return match?.[1] || null
+    } catch {
+      return null
+    }
   }
-}
 
-function getLatestSha(): string {
-  return execSync('git rev-parse --short HEAD', { encoding: 'utf-8' }).trim()
-}
+  function getLatestSha(): string {
+    return execSync('git rev-parse --short HEAD', { encoding: 'utf-8' }).trim()
+  }
 
-function getCommitCount(fromSha: string, toSha: string): number {
-  try {
-    const result = execSync(`git rev-list --count ${fromSha}..${toSha} --no-merges`, {
-      encoding: 'utf-8',
-    })
-    return parseInt(result.trim(), 10)
-  } catch {
-    return 0
+  function getCommitCount(fromSha: string, toSha: string): number {
+    try {
+      const result = execSync(`git rev-list --count ${fromSha}..${toSha} --no-merges`, {
+        encoding: 'utf-8',
+      })
+      return parseInt(result.trim(), 10)
+    } catch {
+      return 0
+    }
   }
-}
 
-const lastSha = getLastSha()
-const latestSha = getLatestSha()
+  const lastSha = getLastSha()
+  const latestSha = getLatestSha()
 
-if (!lastSha) {
-  console.info(`no last sha found in changelog, defaulting to 4 weeks ago`)
-}
+  if (!lastSha) {
+    console.info(`no last sha found in changelog, defaulting to 4 weeks ago`)
+  }
 
-const fromRef = lastSha || '$(git log --since="4 weeks ago" --format="%H" | tail -1)'
-const commitCount = lastSha ? getCommitCount(lastSha, latestSha) : '~30'
+  const fromRef = lastSha || '$(git log --since="4 weeks ago" --format="%H" | tail -1)'
+  const commitCount = lastSha ? getCommitCount(lastSha, latestSha) : '~30'
 
-if (commitCount === 0) {
-  console.info('no new commits since last update')
-  process.exit(0)
-}
+  if (commitCount === 0) {
+    console.info('no new commits since last update')
+    process.exit(0)
+  }
 
-console.info(`
+  console.info(`
 Update the changelog at: ${CHANGELOG_PATH}
 
 Commit range: ${fromRef}..${latestSha} (${commitCount} commits)
@@ -77,3 +72,4 @@ Archiving old entries:
 - when over 10 weeks, move oldest entries to changelog-YYYY.mdx (by year, e.g. changelog-2025.mdx)
 - add a link at the bottom of changelog.mdx: "See [2025 changes](/docs/changelog-2025)" etc (use absolute path)
 `)
+})

package/src/update-local-env.ts

@@ -1,183 +1,164 @@
 #!/usr/bin/env bun
 
-/**
- * @description Bootstrap project dependencies and workspace packages
- *
- * This script runs automatically during `bun install` via the prepare lifecycle.
- * It manages the .env file configuration with the following responsibilities:
- *
- * 1. Creates .env from .env.template if it doesn't exist
- * 2. Maintains an auto-generated section in .env with package metadata
- * 3. Currently syncs ZERO_VERSION from package.json dependencies
- * 4. Preserves all user-defined environment variables
- * 5. Creates backups before modifications for safety
- *
- * The auto-generated section is clearly marked and should not be edited manually.
- * All operations are defensive and will not fail the install process.
- */
-
-import {
-  existsSync,
-  readFileSync,
-  writeFileSync,
-  copyFileSync,
-  renameSync,
-  unlinkSync,
-} from 'node:fs'
-import { join } from 'node:path'
-
-import { getZeroVersion } from '@take-out/scripts/helpers/zero-get-version'
-
-const ENV_PATH = join(process.cwd(), '.env')
-const ENV_TEMPLATE_PATH = join(process.cwd(), '.env.template')
-const ENV_BACKUP_PATH = join(process.cwd(), '.env.backup')
-const ENV_TEMP_PATH = join(process.cwd(), '.env.tmp')
-
-// auto-generated section markers
-const BEGIN_MARKER = '# ---- BEGIN AUTO-GENERATED (DO NOT EDIT) ----'
-const END_MARKER = '# ---- END AUTO-GENERATED ----'
-
-function createEnvFromTemplate(): boolean {
-  if (!existsSync(ENV_TEMPLATE_PATH)) {
-    console.info('No .env.template found, skipping .env creation')
-    return false
+import { cmd } from './cmd'
+
+await cmd`sync auto-generated env vars to local .env file`.run(async ({ path }) => {
+  const {
+    existsSync,
+    readFileSync,
+    writeFileSync,
+    copyFileSync,
+    renameSync,
+    unlinkSync,
+  } = await import('node:fs')
+  const { getZeroVersion } = await import('./helpers/zero-get-version')
+
+  // skip in CI environments
+  if (process.env.CI === 'true') {
+    console.info('Skipping bootstrap in CI environment')
+    process.exit(0)
   }
 
-  try {
-    copyFileSync(ENV_TEMPLATE_PATH, ENV_PATH)
-    console.info('Created .env from .env.template')
-    return true
-  } catch (error) {
-    console.error('Failed to create .env from .env.template:', error)
-    return false
-  }
-}
+  const ENV_PATH = path.join(process.cwd(), '.env')
+  const ENV_TEMPLATE_PATH = path.join(process.cwd(), '.env.template')
+  const ENV_BACKUP_PATH = path.join(process.cwd(), '.env.backup')
+  const ENV_TEMP_PATH = path.join(process.cwd(), '.env.tmp')
 
-function getAutoGeneratedContent(): string {
-  const zeroVersion = getZeroVersion()
-  if (!zeroVersion) {
-    console.warn('Could not determine Zero version')
-    return ''
-  }
+  // auto-generated section markers
+  const BEGIN_MARKER = '# ---- BEGIN AUTO-GENERATED (DO NOT EDIT) ----'
+  const END_MARKER = '# ---- END AUTO-GENERATED ----'
 
-  // build the auto-generated content
-  const lines = [
-    BEGIN_MARKER,
-    `# Generated at: ${new Date().toISOString()}`,
-    `ZERO_VERSION=${zeroVersion}`,
-    END_MARKER,
-  ]
-
-  return lines.join('\n')
-}
-
-function updateEnvFile(): void {
-  // ensure .env exists
-  if (!existsSync(ENV_PATH)) {
-    const created = createEnvFromTemplate()
-    if (!created && !existsSync(ENV_PATH)) {
-      // create empty .env if no template exists
-      writeFileSync(ENV_PATH, '')
-      console.info('Created empty .env file')
+  function createEnvFromTemplate(): boolean {
+    if (!existsSync(ENV_TEMPLATE_PATH)) {
+      console.info('No .env.template found, skipping .env creation')
+      return false
     }
-  }
 
-  try {
-    // create backup
-    if (existsSync(ENV_PATH)) {
-      copyFileSync(ENV_PATH, ENV_BACKUP_PATH)
+    try {
+      copyFileSync(ENV_TEMPLATE_PATH, ENV_PATH)
+      console.info('Created .env from .env.template')
+      return true
+    } catch (error) {
+      console.error('Failed to create .env from .env.template:', error)
+      return false
     }
+  }
 
-    // read current content
-    const currentContent = readFileSync(ENV_PATH, 'utf-8')
-
-    // find existing auto-generated section
-    const beginIndex = currentContent.indexOf(BEGIN_MARKER)
-    const endIndex = currentContent.indexOf(END_MARKER)
-
-    let newContent: string
-
-    if (beginIndex !== -1 && endIndex !== -1 && endIndex > beginIndex) {
-      // replace existing auto-generated section
-      const beforeSection = currentContent.substring(0, beginIndex).trimEnd()
-      const afterSection = currentContent
-        .substring(endIndex + END_MARKER.length)
-        .trimStart()
-
-      newContent = [beforeSection, getAutoGeneratedContent(), afterSection]
-        .filter(Boolean)
-        .join('\n\n')
-    } else if (beginIndex !== -1 || endIndex !== -1) {
-      // malformed markers - preserve content and append new section
-      console.warn('Found malformed auto-generated section, appending new section')
-      newContent = currentContent.trimEnd() + '\n\n' + getAutoGeneratedContent()
-    } else {
-      // no existing section - append to end
-      const trimmedContent = currentContent.trimEnd()
-      newContent = trimmedContent
-        ? trimmedContent + '\n\n' + getAutoGeneratedContent()
-        : getAutoGeneratedContent()
+  function getAutoGeneratedContent(): string {
+    const zeroVersion = getZeroVersion()
+    if (!zeroVersion) {
+      console.warn('Could not determine Zero version')
+      return ''
     }
 
-    // write to temp file first (atomic operation)
-    writeFileSync(ENV_TEMP_PATH, newContent)
+    const lines = [
+      BEGIN_MARKER,
+      `# Generated at: ${new Date().toISOString()}`,
+      `ZERO_VERSION=${zeroVersion}`,
+      END_MARKER,
+    ]
+
+    return lines.join('\n')
+  }
 
-    // validate temp file
-    const tempContent = readFileSync(ENV_TEMP_PATH, 'utf-8')
-    if (!tempContent.includes(BEGIN_MARKER) || !tempContent.includes(END_MARKER)) {
-      throw new Error('Generated content validation failed')
+  function updateEnvFile(): void {
+    // ensure .env exists
+    if (!existsSync(ENV_PATH)) {
+      const created = createEnvFromTemplate()
+      if (!created && !existsSync(ENV_PATH)) {
+        writeFileSync(ENV_PATH, '')
+        console.info('Created empty .env file')
+      }
     }
 
-    // atomic replace
-    renameSync(ENV_TEMP_PATH, ENV_PATH)
+    try {
+      // create backup
+      if (existsSync(ENV_PATH)) {
+        copyFileSync(ENV_PATH, ENV_BACKUP_PATH)
+      }
 
-    if (existsSync(ENV_BACKUP_PATH)) {
-      try {
-        unlinkSync(ENV_BACKUP_PATH)
-      } catch {
-        // ignore cleanup errors
+      const currentContent = readFileSync(ENV_PATH, 'utf-8')
+
+      const beginIndex = currentContent.indexOf(BEGIN_MARKER)
+      const endIndex = currentContent.indexOf(END_MARKER)
+
+      let newContent: string
+
+      if (beginIndex !== -1 && endIndex !== -1 && endIndex > beginIndex) {
+        // replace existing auto-generated section
+        const beforeSection = currentContent.substring(0, beginIndex).trimEnd()
+        const afterSection = currentContent
+          .substring(endIndex + END_MARKER.length)
+          .trimStart()
+
+        newContent = [beforeSection, getAutoGeneratedContent(), afterSection]
+          .filter(Boolean)
+          .join('\n\n')
+      } else if (beginIndex !== -1 || endIndex !== -1) {
+        // malformed markers - preserve content and append new section
+        console.warn('Found malformed auto-generated section, appending new section')
+        newContent = currentContent.trimEnd() + '\n\n' + getAutoGeneratedContent()
+      } else {
+        // no existing section - append to end
+        const trimmedContent = currentContent.trimEnd()
+        newContent = trimmedContent
+          ? trimmedContent + '\n\n' + getAutoGeneratedContent()
+          : getAutoGeneratedContent()
       }
-    }
 
-    console.info('Updated .env auto-generated section')
-  } catch (error) {
-    console.error('Failed to update .env file:', error)
-
-    // attempt to restore backup
-    if (existsSync(ENV_BACKUP_PATH)) {
-      try {
-        copyFileSync(ENV_BACKUP_PATH, ENV_PATH)
-        console.info('Restored .env from backup')
-      } catch (restoreError) {
-        console.error('Failed to restore backup:', restoreError)
+      // write to temp file first (atomic operation)
+      writeFileSync(ENV_TEMP_PATH, newContent)
+
+      // validate temp file
+      const tempContent = readFileSync(ENV_TEMP_PATH, 'utf-8')
+      if (!tempContent.includes(BEGIN_MARKER) || !tempContent.includes(END_MARKER)) {
+        throw new Error('Generated content validation failed')
+      }
+
+      // atomic replace
+      renameSync(ENV_TEMP_PATH, ENV_PATH)
+
+      if (existsSync(ENV_BACKUP_PATH)) {
+        try {
+          unlinkSync(ENV_BACKUP_PATH)
+        } catch {
+          // ignore cleanup errors
+        }
       }
-    }
 
-    // clean up temp file
-    if (existsSync(ENV_TEMP_PATH)) {
-      try {
-        unlinkSync(ENV_TEMP_PATH)
-      } catch {
-        // ignore cleanup errors
+      console.info('Updated .env auto-generated section')
+    } catch (error) {
+      console.error('Failed to update .env file:', error)
+
+      // attempt to restore backup
+      if (existsSync(ENV_BACKUP_PATH)) {
+        try {
+          copyFileSync(ENV_BACKUP_PATH, ENV_PATH)
+          console.info('Restored .env from backup')
+        } catch (restoreError) {
+          console.error('Failed to restore backup:', restoreError)
+        }
       }
+
+      // clean up temp file
+      if (existsSync(ENV_TEMP_PATH)) {
+        try {
+          unlinkSync(ENV_TEMP_PATH)
+        } catch {
+          // ignore cleanup errors
+        }
+      }
+
+      // don't fail the install process
+      process.exit(0)
     }
+  }
 
-    // don't fail the install process
+  try {
+    updateEnvFile()
+  } catch (error) {
+    // catch any unexpected errors and exit gracefully
+    console.error('Bootstrap script error:', error)
     process.exit(0)
   }
-}
-
-// main execution
-// skip bootstrap in CI environments
-if (process.env.CI === 'true') {
-  console.info('Skipping bootstrap in CI environment')
-  process.exit(0)
-}
-
-try {
-  updateEnvFile()
-} catch (error) {
-  // catch any unexpected errors and exit gracefully
-  console.error('Bootstrap script error:', error)
-  process.exit(0)
-}
+})

package/src/wait-for-dev.ts

@@ -1,24 +1,26 @@
 #!/usr/bin/env bun
 
-import { sleep } from '@take-out/helpers'
-
-const ONE_SERVER_URL = process.env.ONE_SERVER_URL || 'http://localhost:8081'
-const CHECK_INTERVAL = 2000
-
-async function checkServer(): Promise<boolean> {
-  try {
-    await fetch(ONE_SERVER_URL, {
-      signal: AbortSignal.timeout(5000),
-    }).then((res) => res.text())
-    // give it a couple seconds to build initial route
-    await sleep(2000)
-    return true
-  } catch (error) {
-    return false
+import { cmd } from './cmd'
+
+await cmd`wait for dev server to be available`.run(async () => {
+  const { sleep } = await import('@take-out/helpers')
+
+  const ONE_SERVER_URL = process.env.ONE_SERVER_URL || 'http://localhost:8081'
+  const CHECK_INTERVAL = 2000
+
+  async function checkServer(): Promise<boolean> {
+    try {
+      await fetch(ONE_SERVER_URL, {
+        signal: AbortSignal.timeout(5000),
+      }).then((res) => res.text())
+      // give it a couple seconds to build initial route
+      await sleep(2000)
+      return true
+    } catch (error) {
+      return false
+    }
   }
-}
 
-async function waitForServer(): Promise<void> {
   process.stdout.write(`Waiting for server at ${ONE_SERVER_URL}...\n`)
 
   while (true) {
@@ -34,7 +36,6 @@ async function waitForServer(): Promise<void> {
       `Waiting to start dev watch until after dev server (wait ${CHECK_INTERVAL / 1000}s)...\n`
     )
   }
-}
 
-await waitForServer()
-process.exit(0)
+  process.exit(0)
+})