@o/cli 0.16.19 → 0.16.20-canary.1791839822276

package/dist/cmd.d.ts

@@ -14,18 +14,20 @@ type Args<S extends string> = import('./args.js').Args<S>;
 type RunFn<S extends string> = (fn: (ctx: Prettify<{
     args: Args<S>;
 } & CmdContext>) => Promise<void> | void) => Promise<void>;
+type Chainable<S extends string> = {
+    env(vars: Record<string, string>): Chainable<S>;
+    run: RunFn<S>;
+};
+type Command = {
+    env(vars: Record<string, string>): Command;
+    args<const S extends string>(spec: S): Chainable<S>;
+    run: RunFn<''>;
+};
 export declare function setInterceptCmd(fn: ((info: {
     description: string;
     args?: string;
 }) => void) | undefined): void;
-declare function createCmd(description: string): {
-    env(vars: Record<string, string>): /*elided*/ any;
-    args<const S extends string>(spec: S): {
-        env(vars: Record<string, string>): /*elided*/ any;
-        run: RunFn<S>;
-    };
-    run: RunFn<"">;
-};
+declare function createCmd(description: string): Command;
 export declare function cmd(description: string): ReturnType<typeof createCmd>;
 export declare function cmd(strings: TemplateStringsArray): ReturnType<typeof createCmd>;
 export {};

package/dist/cmd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cmd.d.ts","sourceRoot":"","sources":["../src/cmd.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAA;AAEhD,KAAK,UAAU,GAAG;IAChB,CAAC,EAAE,cAAc,KAAK,EAAE,CAAC,CAAA;IACzB,MAAM,EAAE,cAAc,YAAY,CAAC,CAAA;IACnC,MAAM,EAAE,cAAc,gBAAgB,CAAC,CAAA;IACvC,GAAG,EAAE,cAAc,UAAU,EAAE,GAAG,CAAA;IAClC,EAAE,EAAE,cAAc,SAAS,CAAC,CAAA;IAC5B,IAAI,EAAE,cAAc,WAAW,CAAC,CAAA;IAChC,EAAE,EAAE,cAAc,SAAS,CAAC,CAAA;CAC7B,CAAA;AAED,KAAK,IAAI,CAAC,CAAC,SAAS,MAAM,IAAI,OAAO,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;AAEzD,KAAK,KAAK,CAAC,CAAC,SAAS,MAAM,IAAI,CAC7B,EAAE,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;CAAE,GAAG,UAAU,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KACxE,OAAO,CAAC,IAAI,CAAC,CAAA;AAIlB,wBAAgB,eAAe,CAC7B,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAC,GAAG,SAAS,QAGzE;AAED,iBAAS,SAAS,CAAC,WAAW,EAAE,MAAM;cA6DxB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;eAIrB,CAAC,SAAS,MAAM,QAAQ,CAAC;kBAbxB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;EAmBrC;AAED,wBAAgB,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAA;AACtE,wBAAgB,GAAG,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAA"}
+{"version":3,"file":"cmd.d.ts","sourceRoot":"","sources":["../src/cmd.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAA;AAEhD,KAAK,UAAU,GAAG;IAChB,CAAC,EAAE,cAAc,KAAK,EAAE,CAAC,CAAA;IACzB,MAAM,EAAE,cAAc,YAAY,CAAC,CAAA;IACnC,MAAM,EAAE,cAAc,gBAAgB,CAAC,CAAA;IACvC,GAAG,EAAE,cAAc,UAAU,EAAE,GAAG,CAAA;IAClC,EAAE,EAAE,cAAc,SAAS,CAAC,CAAA;IAC5B,IAAI,EAAE,cAAc,WAAW,CAAC,CAAA;IAChC,EAAE,EAAE,cAAc,SAAS,CAAC,CAAA;CAC7B,CAAA;AAED,KAAK,IAAI,CAAC,CAAC,SAAS,MAAM,IAAI,OAAO,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;AAEzD,KAAK,KAAK,CAAC,CAAC,SAAS,MAAM,IAAI,CAC7B,EAAE,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;CAAE,GAAG,UAAU,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KACxE,OAAO,CAAC,IAAI,CAAC,CAAA;AAElB,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;IAC/C,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;CACd,CAAA;AAED,KAAK,OAAO,GAAG;IACb,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAA;IAC1C,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;IACnD,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;CACf,CAAA;AAID,wBAAgB,eAAe,CAC7B,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAC,GAAG,SAAS,QAGzE;AAED,iBAAS,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAuE/C;AAED,wBAAgB,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAA;AACtE,wBAAgB,GAAG,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAA"}

package/dist/cmd.js.map

@@ -1 +1 @@
-{"version":3,"file":"cmd.js","sourceRoot":"","sources":["../src/cmd.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cmd.js","sourceRoot":"","sources":["../src/cmd.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@o/cli",
-  "version": "0.16.19",
+  "version": "0.16.20-canary.1791839822276",
   "description": "Typed command and subprocess helpers for Orez consumers.",
   "license": "MIT",
   "repository": {
@@ -14,7 +14,9 @@
   "module": "dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "o": "./dist/cli.js"
+    "o": "./dist/cli.js",
+    "tko": "./src/tko/cli.ts",
+    "takeout": "./src/tko/cli.ts"
   },
   "exports": {
     "./package.json": "./package.json",
@@ -22,12 +24,23 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
-    }
+    },
+    "./utils/*": {
+      "types": "./src/tko/utils/*.ts",
+      "default": "./src/tko/utils/*.ts"
+    },
+    "./constants/*": {
+      "types": "./src/tko/constants/*.ts",
+      "default": "./src/tko/constants/*.ts"
+    },
+    "./withOpSqliteStatic": "./src/tko/withOpSqliteStatic.cjs",
+    "./withExpoModulesCoreSwift6Fix": "./src/tko/withExpoModulesCoreSwift6Fix.cjs"
   },
   "files": [
     "dist",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "src/tko"
   ],
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.build.json && cp src/run-pty.mjs dist/run-pty.mjs && chmod +x dist/cli.js dist/run-pty.mjs",
@@ -40,7 +53,10 @@
   "dependencies": {
     "@clack/prompts": "^0.8.2",
     "@lydell/node-pty": "^1.2.0-beta.3",
-    "picocolors": "^1.1.1"
+    "picocolors": "^1.1.1",
+    "@o/run": "0.16.20-canary.1791839822276",
+    "@o/scripts": "0.16.20-canary.1791839822276",
+    "citty": "^0.1.6"
   },
   "devDependencies": {
     "@types/bun": "1.3.14",
@@ -50,5 +66,14 @@
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "peerDependencies": {
+    "@expo/config-plugins": "*"
+  },
+  "peerDependenciesMeta": {
+    "@expo/config-plugins": {
+      "optional": true
+    }
+  },
+  "releaseSourceCommit": "e7c02e302d6227ce686b136dcb361e5823d58d33"
 }

package/src/tko/cli.ts

@@ -0,0 +1,173 @@
+#!/usr/bin/env bun
+
+/**
+ * Takeout CLI
+ * Interactive tools for Takeout starter kit setup and management
+ */
+
+import { spawnSync } from 'node:child_process'
+import { existsSync, statSync } from 'node:fs'
+import { join } from 'node:path'
+
+import { defineCommand, runMain } from 'citty'
+
+// check if a directory exists in scripts folder (lazy check)
+function isScriptCategory(name: string): boolean {
+  const scriptsDir = join(process.cwd(), 'scripts')
+  const categoryPath = join(scriptsDir, name)
+
+  try {
+    return existsSync(categoryPath) && statSync(categoryPath).isDirectory()
+  } catch {
+    return false
+  }
+}
+
+// find a local script in ./scripts/, returns path or null
+function findLocalScript(name: string): string | null {
+  const scriptsDir = join(process.cwd(), 'scripts')
+  const normalizedName = name.replace(/:/g, '/')
+
+  for (const ext of ['.ts', '.js', '']) {
+    const scriptPath = join(scriptsDir, `${normalizedName}${ext}`)
+    if (existsSync(scriptPath)) {
+      return scriptPath
+    }
+  }
+
+  return null
+}
+
+function isLocalScript(name: string): boolean {
+  return findLocalScript(name) !== null
+}
+
+// find a built-in script in @o/scripts, returns path or null
+function findBuiltInScript(name: string): string | null {
+  try {
+    const resolved = import.meta.resolve('@o/scripts/package.json')
+    const packageJsonPath = new URL(resolved).pathname
+    const packageRoot = join(packageJsonPath, '..')
+    const srcPath = join(packageRoot, 'src')
+
+    // normalize name: convert colons to slashes
+    const normalizedName = name.replace(/:/g, '/')
+
+    // check if the script file exists
+    for (const ext of ['.ts', '.js', '']) {
+      const scriptPath = join(srcPath, `${normalizedName}${ext}`)
+      if (existsSync(scriptPath)) {
+        return scriptPath
+      }
+    }
+  } catch {
+    // package not found or error resolving
+  }
+
+  return null
+}
+
+function isBuiltInScript(name: string): boolean {
+  return findBuiltInScript(name) !== null
+}
+
+// always enable shorthand mode — both tko and takeout resolve to this file
+const isShorthand = true
+
+if (isShorthand) {
+  // in shorthand mode, treat first arg as potential script command
+  const firstArg = process.argv[2]
+  const builtInCommands = [
+    'docs',
+    'onboard',
+    'run',
+    'run-all',
+    'script',
+    'skills',
+    'env:setup',
+    'sync',
+    'changed',
+    '--help',
+    '-h',
+    '--version',
+    '-v',
+  ]
+
+  if (firstArg && !builtInCommands.includes(firstArg)) {
+    // resolve the script name for category/script patterns
+    let resolvedScriptName: string | undefined
+
+    // check if it's a script category or has a slash (category/script format)
+    // Do a lazy check only on the specific arg, not scanning all directories
+    if (isScriptCategory(firstArg)) {
+      // find first non-flag arg as sub-script name
+      // e.g., "tko check types" or "tko check --default-all types"
+      const restArgs = process.argv.slice(3)
+      const subScriptIdx = restArgs.findIndex((a) => !a.startsWith('-'))
+      if (subScriptIdx !== -1) {
+        const subScript = restArgs[subScriptIdx]
+        resolvedScriptName = `${firstArg}/${subScript}`
+        // remove the sub-script from its position and replace category with combined path
+        process.argv.splice(3 + subScriptIdx, 1)
+        process.argv[2] = resolvedScriptName
+      }
+      // inject "run" into args to use the run command directly
+      process.argv.splice(2, 0, 'run')
+    } else if (firstArg?.includes('/')) {
+      resolvedScriptName = firstArg
+      // inject "run" into args to use the run command directly
+      process.argv.splice(2, 0, 'run')
+    } else if (isLocalScript(firstArg) || isBuiltInScript(firstArg)) {
+      resolvedScriptName = firstArg
+      // check if it's a local or built-in script (like update-deps, clean, etc.)
+      // use "run" to avoid citty parsing issues with hyphens
+      process.argv.splice(2, 0, 'run')
+    } else {
+      // assume it's a script command, inject "script" into args
+      process.argv.splice(2, 0, 'script')
+    }
+
+    // bypass citty for --help on scripts so the script handles it itself
+    const hasHelp = process.argv.includes('--help') || process.argv.includes('-h')
+    if (resolvedScriptName && hasHelp) {
+      const scriptPath =
+        findLocalScript(resolvedScriptName) || findBuiltInScript(resolvedScriptName)
+      if (scriptPath) {
+        const flagArgs = process.argv.slice(3).filter((a) => a !== resolvedScriptName)
+        const result = spawnSync('bun', [scriptPath, ...flagArgs], {
+          stdio: 'inherit',
+          shell: false,
+        })
+        process.exit(result.status || 0)
+      }
+    }
+  }
+}
+
+const main = defineCommand({
+  meta: {
+    name: isShorthand ? 'tko' : 'takeout',
+    version: '0.0.2',
+    description: 'CLI tools for Takeout starter kit',
+  },
+  subCommands: {
+    onboard: () => import('./commands/onboard').then((m) => m.onboardCommand),
+    docs: () => import('./commands/docs').then((m) => m.docsCommand),
+    'env:setup': () => import('./commands/env-setup').then((m) => m.envSetupCommand),
+    run: () => import('./commands/run').then((m) => m.runCommand),
+    'run-all': () => import('./commands/run-all').then((m) => m.runAllCommand),
+    script: () => import('./commands/script').then((m) => m.scriptCommand),
+    skills: () => import('./commands/skills').then((m) => m.skillsCommand),
+    sync: () => import('./commands/sync').then((m) => m.syncCommand),
+    changed: () => import('./commands/changed').then((m) => m.changedCommand),
+  },
+  async run() {
+    const hasArgs = process.argv.length > 2
+    if (!hasArgs) {
+      const { listAllScripts } = await import('./utils/script-listing')
+      await listAllScripts()
+    }
+  },
+})
+
+runMain(main)

package/src/tko/commands/changed.ts

@@ -0,0 +1,313 @@
+/**
+ * Changed command - show what's changed in upstream Takeout since last sync
+ */
+
+import { execSync } from 'node:child_process'
+import { existsSync, readFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+import { defineCommand } from 'citty'
+import pc from 'picocolors'
+
+const UPSTREAM_REPO = 'tamagui/takeout2'
+const UPSTREAM_REMOTE = 'takeout-upstream'
+const TAKEOUT_FILE = '.takeout'
+
+const COMMIT_TYPE_ORDER = [
+  'feat',
+  'fix',
+  'perf',
+  'refactor',
+  'docs',
+  'chore',
+  'test',
+  'ci',
+]
+
+interface CommitInfo {
+  hash: string
+  type: string
+  scope?: string
+  message: string
+  breaking: boolean
+  date: string
+}
+
+interface TakeoutConfig {
+  sha?: string
+  date?: string
+}
+
+function readTakeoutConfig(): TakeoutConfig | null {
+  const configPath = join(process.cwd(), TAKEOUT_FILE)
+
+  if (!existsSync(configPath)) {
+    return null
+  }
+
+  try {
+    const content = readFileSync(configPath, 'utf-8')
+    const config: TakeoutConfig = {}
+
+    for (const line of content.split('\n')) {
+      const trimmed = line.trim()
+      if (trimmed.startsWith('#') || !trimmed) continue
+
+      const [key, ...valueParts] = trimmed.split('=')
+      const value = valueParts.join('=').trim()
+
+      if (key === 'sha') config.sha = value
+      if (key === 'date') config.date = value
+    }
+
+    return config
+  } catch {
+    return null
+  }
+}
+
+function parseConventionalCommit(
+  message: string
+): { type: string; scope?: string; message: string; breaking: boolean } | null {
+  // match conventional commit format: type(scope)!: message or type!: message
+  const match = message.match(/^(\w+)(?:\(([^)]+)\))?(!)?: (.+)$/)
+  if (!match) return null
+
+  const [, type, scope, breaking, msg] = match
+
+  // include all commit types for takeout
+  const validTypes = [
+    'feat',
+    'fix',
+    'perf',
+    'refactor',
+    'docs',
+    'chore',
+    'test',
+    'ci',
+    'build',
+    'style',
+  ]
+  if (!type || !validTypes.includes(type)) return null
+
+  return {
+    type,
+    scope,
+    message: msg || message,
+    breaking: !!breaking || message.toLowerCase().includes('breaking'),
+  }
+}
+
+function ensureUpstreamRemote(): boolean {
+  try {
+    // check if remote exists
+    const remotes = execSync('git remote', { encoding: 'utf-8' })
+    if (!remotes.includes(UPSTREAM_REMOTE)) {
+      console.info(pc.dim(`  adding ${UPSTREAM_REMOTE} remote...`))
+      execSync(`git remote add ${UPSTREAM_REMOTE} git@github.com:${UPSTREAM_REPO}.git`, {
+        stdio: 'pipe',
+      })
+    }
+
+    // fetch latest
+    console.info(pc.dim(`  fetching from ${UPSTREAM_REMOTE}...`))
+    execSync(`git fetch ${UPSTREAM_REMOTE} --quiet`, { stdio: 'pipe' })
+    return true
+  } catch (err) {
+    console.error(pc.red(`failed to setup upstream remote: ${err}`))
+    return false
+  }
+}
+
+function getCommitsBetween(fromSha: string, toRef: string): CommitInfo[] {
+  const commits: CommitInfo[] = []
+
+  try {
+    // format: hash|date|message
+    const result = execSync(
+      `git log ${fromSha}..${toRef} --pretty=format:"%H|%ad|%s" --date=short 2>/dev/null`,
+      { encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024 }
+    )
+
+    const lines = result.trim().split('\n').filter(Boolean)
+
+    for (const line of lines) {
+      const [hash = '', date = '', ...messageParts] = line.split('|')
+      const message = messageParts.join('|')
+
+      const parsed = parseConventionalCommit(message)
+
+      // include non-conventional commits too, just categorize them as "other"
+      commits.push({
+        hash: hash.slice(0, 7),
+        type: parsed?.type || 'other',
+        scope: parsed?.scope,
+        message: parsed?.message || message,
+        breaking: parsed?.breaking || false,
+        date,
+      })
+    }
+  } catch {
+    // no commits or error
+  }
+
+  return commits
+}
+
+function formatChangelog(commits: CommitInfo[]): void {
+  if (commits.length === 0) {
+    console.info(pc.dim('  no changes found'))
+    return
+  }
+
+  // group by type
+  const grouped = new Map<string, CommitInfo[]>()
+  for (const commit of commits) {
+    const existing = grouped.get(commit.type) || []
+    existing.push(commit)
+    grouped.set(commit.type, existing)
+  }
+
+  // sort by type order
+  const sortedTypes = Array.from(grouped.keys()).sort((a, b) => {
+    const aIdx = COMMIT_TYPE_ORDER.indexOf(a)
+    const bIdx = COMMIT_TYPE_ORDER.indexOf(b)
+    return (aIdx === -1 ? 999 : aIdx) - (bIdx === -1 ? 999 : bIdx)
+  })
+
+  // show breaking changes first
+  const breakingChanges = commits.filter((c) => c.breaking)
+  if (breakingChanges.length > 0) {
+    console.info()
+    console.info(pc.red(pc.bold('  BREAKING CHANGES')))
+    for (const commit of breakingChanges) {
+      const scope = commit.scope ? pc.cyan(`(${commit.scope})`) : ''
+      console.info(
+        `    ${pc.red('!')} ${scope} ${commit.message} ${pc.dim(`(${commit.hash})`)}`
+      )
+    }
+  }
+
+  const typeLabels: Record<string, string> = {
+    feat: 'Features',
+    fix: 'Bug Fixes',
+    perf: 'Performance',
+    refactor: 'Refactoring',
+    docs: 'Documentation',
+    chore: 'Maintenance',
+    test: 'Tests',
+    ci: 'CI',
+    build: 'Build',
+    style: 'Style',
+    other: 'Other',
+  }
+
+  const typeColors: Record<string, (s: string) => string> = {
+    feat: pc.green,
+    fix: pc.yellow,
+    perf: pc.magenta,
+    refactor: pc.blue,
+    docs: pc.dim,
+    chore: pc.dim,
+    test: pc.dim,
+    ci: pc.dim,
+    build: pc.dim,
+    style: pc.dim,
+    other: pc.white,
+  }
+
+  for (const type of sortedTypes) {
+    const typeCommits = grouped.get(type)!.filter((c) => !c.breaking)
+    if (typeCommits.length === 0) continue
+
+    const label = typeLabels[type] || type
+    const color = typeColors[type] || pc.white
+
+    console.info()
+    console.info(color(pc.bold(`  ${label}`)))
+
+    for (const commit of typeCommits) {
+      const scope = commit.scope ? pc.cyan(`(${commit.scope}) `) : ''
+      console.info(
+        `    ${pc.dim('-')} ${scope}${commit.message} ${pc.dim(`(${commit.hash})`)}`
+      )
+    }
+  }
+}
+
+export const changedCommand = defineCommand({
+  meta: {
+    name: 'changed',
+    description: 'Show changes in upstream Takeout since last sync',
+  },
+  args: {
+    from: {
+      type: 'string',
+      description: 'Starting commit SHA (defaults to .takeout file)',
+    },
+    to: {
+      type: 'string',
+      description: 'Ending commit ref (defaults to upstream main)',
+    },
+  },
+  async run({ args }) {
+    console.info()
+    console.info(pc.bold(pc.cyan('Takeout Changes')))
+    console.info()
+
+    // determine from SHA
+    let fromSha = args.from
+    const config = readTakeoutConfig()
+
+    if (!fromSha) {
+      if (!config?.sha) {
+        console.info(pc.yellow('No .takeout file found with last sync SHA.'))
+        console.info()
+        console.info(pc.dim('Either:'))
+        console.info(pc.dim('  1. Create a .takeout file with: sha=<commit-sha>'))
+        console.info(pc.dim('  2. Run with --from <sha> to specify starting point'))
+        console.info(pc.dim('  3. Run `tko sync` to sync and create the file'))
+        console.info()
+        return
+      }
+      fromSha = config.sha
+    }
+
+    // setup upstream remote and fetch
+    if (!ensureUpstreamRemote()) {
+      return
+    }
+
+    const toRef = args.to || `${UPSTREAM_REMOTE}/main`
+
+    console.info(pc.dim(`  from: ${fromSha.slice(0, 7)}`))
+    console.info(pc.dim(`  to:   ${toRef}`))
+
+    if (config?.date) {
+      console.info(pc.dim(`  last sync: ${config.date}`))
+    }
+
+    // get commits
+    const commits = getCommitsBetween(fromSha, toRef)
+
+    if (commits.length === 0) {
+      console.info()
+      console.info(pc.green('✓ Already up to date with upstream!'))
+      console.info()
+      return
+    }
+
+    console.info()
+    console.info(
+      pc.bold(
+        `${commits.length} commit${commits.length === 1 ? '' : 's'} since last sync:`
+      )
+    )
+
+    formatChangelog(commits)
+
+    console.info()
+    console.info(pc.dim('Run `tko sync` to sync these changes into your fork.'))
+    console.info()
+  },
+})