pisper 0.5.39-linux-x64.0 → 0.5.39

package/lib/npm-platform.mjs

@@ -0,0 +1,41 @@
+import process from 'node:process'
+
+export const NPM_PLATFORM_TARGETS = Object.freeze([
+  Object.freeze({ platform: 'win32', arch: 'x64', release: 'windows_x86_64', slug: 'win32-x64' }),
+  Object.freeze({ platform: 'darwin', arch: 'x64', release: 'darwin_x86_64', slug: 'darwin-x64' }),
+  Object.freeze({
+    platform: 'darwin',
+    arch: 'arm64',
+    release: 'darwin_aarch64',
+    slug: 'darwin-arm64',
+  }),
+  Object.freeze({ platform: 'linux', arch: 'x64', release: 'linux_x86_64', slug: 'linux-x64' }),
+])
+
+export function npmPlatformTarget(platform = process.platform, arch = process.arch) {
+  const target = NPM_PLATFORM_TARGETS.find(
+    (candidate) => candidate.platform === platform && candidate.arch === arch,
+  )
+  if (!target) throw new Error(`Pisper does not publish an npm package for ${platform}-${arch}`)
+  return target
+}
+
+export function npmPlatformAlias(platform = process.platform, arch = process.arch) {
+  return `pisper-binary-${npmPlatformTarget(platform, arch).slug}`
+}
+
+export function npmPlatformVersion(version, platform = process.platform, arch = process.arch) {
+  if (!/^\d+\.\d+\.\d+$/.test(version || '')) {
+    throw new Error(`invalid Pisper npm version: ${version}`)
+  }
+  return `${version}-${npmPlatformTarget(platform, arch).slug}.0`
+}
+
+export function npmPlatformOptionalDependencies(version) {
+  return Object.fromEntries(
+    NPM_PLATFORM_TARGETS.map(({ platform, arch }) => [
+      npmPlatformAlias(platform, arch),
+      `npm:pisper@${npmPlatformVersion(version, platform, arch)}`,
+    ]),
+  )
+}

package/lib/npm-update.mjs

@@ -0,0 +1,165 @@
+import { execFile, spawn } from 'node:child_process'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+import process from 'node:process'
+import { promisify } from 'node:util'
+import { fileURLToPath } from 'node:url'
+
+const execFileAsync = promisify(execFile)
+const packageRoot = fileURLToPath(new URL('..', import.meta.url))
+const packageManifest = JSON.parse(await readFile(join(packageRoot, 'package.json'), 'utf8'))
+
+function compareVersions(left, right) {
+  const a = left.split('.').map(Number)
+  const b = right.split('.').map(Number)
+  for (let index = 0; index < 3; index += 1) {
+    if (a[index] !== b[index]) return a[index] - b[index]
+  }
+  return 0
+}
+
+function npmInvocation(arguments_) {
+  if (process.platform === 'win32') {
+    return {
+      command: process.env.ComSpec || 'cmd.exe',
+      arguments: ['/d', '/s', '/c', 'npm.cmd', ...arguments_],
+    }
+  }
+  return { command: 'npm', arguments: arguments_ }
+}
+
+const NPM_CLI_HELP = `Pisper CLI
+
+Start a coding session in your terminal.
+
+Usage:
+  pisper [OPTIONS]
+  pisper resume [OPTIONS]
+  pisper doctor [OPTIONS]
+  pisper web [OPTIONS]
+  pisper update [--check]
+  pisper help [COMMAND]
+
+Commands:
+  resume    Choose and resume a conversation from any workspace
+  doctor    Check the TUI, Runtime connection, and capability catalogs
+  web       Open the bundled Web UI and Provider settings in your browser
+  update    Update the complete Pisper distribution through npm
+  help      Print this help or help for a command
+
+Options:
+  --cwd <directory>  Use a specific workspace (default: current directory)
+  -h, --help         Print help
+  -V, --version      Print the installed TUI version
+
+Getting started:
+  1. Change to your project directory.
+  2. Run \`pisper\`. Use \`/provider\` to choose a Provider and save its API Key.
+  3. Type a request and press Enter. Type \`/\` to browse commands.
+  4. Run \`pisper web\` for the bundled visual settings and workspace UI.
+  5. Run \`pisper update\` to update through the configured npm registry.`
+
+export function parseNpmHelpRequest(arguments_) {
+  if (arguments_.length === 1 && ['help', '--help', '-h'].includes(arguments_[0])) return true
+  return false
+}
+
+export function parseNpmUpdateRequest(arguments_) {
+  if (arguments_[0] === 'help' && arguments_[1] === 'update' && arguments_.length === 2) {
+    return { checkOnly: false, help: true }
+  }
+  if (arguments_[0] !== 'update') return null
+  let checkOnly = false
+  let help = false
+  for (const argument of arguments_.slice(1)) {
+    if (argument === '--check') {
+      checkOnly = true
+    } else if (argument === '--help' || argument === '-h') {
+      help = true
+    } else {
+      throw new Error('npm updates do not accept component names; run `pisper update`')
+    }
+  }
+  return { checkOnly, help }
+}
+
+async function queryLatestVersion() {
+  const invocation = npmInvocation(['view', 'pisper@latest', 'version', '--json'])
+  const { stdout } = await execFileAsync(invocation.command, invocation.arguments, {
+    encoding: 'utf8',
+    windowsHide: true,
+  })
+  const version = JSON.parse(stdout)
+  if (!/^\d+\.\d+\.\d+$/.test(version || '')) {
+    throw new Error('npm registry returned an invalid pisper version')
+  }
+  return version
+}
+
+async function installLatestVersion() {
+  await new Promise((resolve, reject) => {
+    const invocation = npmInvocation([
+      'install',
+      '--global',
+      'pisper@latest',
+      '--progress=true',
+      '--foreground-scripts',
+    ])
+    const child = spawn(invocation.command, invocation.arguments, {
+      stdio: 'inherit',
+      windowsHide: false,
+    })
+    child.once('error', reject)
+    child.once('exit', (code, signal) => {
+      if (signal) {
+        reject(new Error(`npm update was terminated by ${signal}`))
+      } else if (code !== 0) {
+        reject(new Error(`npm update failed with exit code ${code ?? 1}`))
+      } else {
+        resolve()
+      }
+    })
+  })
+}
+
+export function handleNpmHelp(arguments_, { log = console.log } = {}) {
+  if (!parseNpmHelpRequest(arguments_)) return false
+  log(NPM_CLI_HELP)
+  return true
+}
+
+export async function handleNpmUpdate(
+  arguments_,
+  {
+    currentVersion = packageManifest.version,
+    queryLatest = queryLatestVersion,
+    installLatest = installLatestVersion,
+    log = console.log,
+  } = {},
+) {
+  const request = parseNpmUpdateRequest(arguments_)
+  if (!request) return false
+
+  if (request.help) {
+    log(`Pisper npm update
+
+Usage:
+  pisper update [--check]
+
+Options:
+  --check      Check the configured npm registry without installing
+  -h, --help   Print update help`)
+    return true
+  }
+
+  const latest = await queryLatest()
+  if (compareVersions(currentVersion, latest) >= 0) {
+    log(`pisper: npm package ${currentVersion} is current`)
+    return true
+  }
+  log(`pisper: npm package update ${currentVersion} -> ${latest}`)
+  if (request.checkOnly) return true
+  await installLatest()
+  log(`pisper: npm package ${latest} is ready`)
+  return true
+}

package/lib/platform.mjs

@@ -0,0 +1,43 @@
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import process from 'node:process'
+
+export function releasePlatform(platform = process.platform) {
+  if (platform === 'win32') return 'windows'
+  if (platform === 'darwin') return 'darwin'
+  if (platform === 'linux') return 'linux'
+  throw new Error(`unsupported operating system: ${platform}`)
+}
+
+export function releaseArchitecture(arch = process.arch) {
+  if (arch === 'x64') return 'x86_64'
+  if (arch === 'arm64') return 'aarch64'
+  throw new Error(`unsupported CPU architecture: ${arch}`)
+}
+
+export function supportedTarget(platform = process.platform, arch = process.arch) {
+  const target = `${releasePlatform(platform)}_${releaseArchitecture(arch)}`
+  const supported = new Set(['windows_x86_64', 'darwin_x86_64', 'darwin_aarch64', 'linux_x86_64'])
+  if (!supported.has(target)) {
+    throw new Error(`Pisper does not publish a TUI package for ${target}`)
+  }
+  return target
+}
+
+export function executableName(platform = process.platform) {
+  return platform === 'win32' ? 'pisper.exe' : 'pisper'
+}
+
+export function localDataDirectory(platform = process.platform, env = process.env) {
+  if (env.PISPER_NPM_INSTALL_DIR) return env.PISPER_NPM_INSTALL_DIR
+  if (platform === 'win32') {
+    if (!env.LOCALAPPDATA) throw new Error('LOCALAPPDATA is unavailable')
+    return env.LOCALAPPDATA
+  }
+  if (platform === 'darwin') return join(homedir(), 'Library', 'Application Support')
+  return env.XDG_DATA_HOME || join(homedir(), '.local', 'share')
+}
+
+export function componentsRoot(platform = process.platform, env = process.env) {
+  return join(localDataDirectory(platform, env), 'com.lingkongran.pisper', 'components')
+}

package/lib/postinstall.mjs

@@ -0,0 +1,3 @@
+import { ensurePisperInstallation } from './install.mjs'
+
+await ensurePisperInstallation()

package/package.json

@@ -1,35 +1,57 @@
 {
   "name": "pisper",
-  "version": "0.5.39-linux-x64.0",
-  "description": "Pisper signed TUI and Node Runtime bundle for linux-x64.",
+  "version": "0.5.39",
+  "description": "Pisper CLI.",
   "license": "MIT",
   "author": {
     "name": "ling-kong-ran",
     "email": "65328093+ling-kong-ran@users.noreply.github.com",
     "url": "https://github.com/ling-kong-ran"
   },
+  "type": "module",
+  "homepage": "https://github.com/ling-kong-ran/pisper#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ling-kong-ran/pisper.git"
   },
-  "os": [
-    "linux"
-  ],
-  "cpu": [
-    "x64"
-  ],
+  "bugs": {
+    "url": "https://github.com/ling-kong-ran/pisper/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "pisper": "bin/pisper.mjs"
+  },
+  "scripts": {
+    "postinstall": "node lib/postinstall.mjs"
+  },
   "files": [
-    "components/",
+    "bin/",
+    "lib/",
+    "web/",
+    "updater.pubkey",
     "README.md",
+    "README.en.md",
     "LICENSE"
   ],
-  "publishConfig": {
-    "access": "public",
-    "provenance": true
+  "dependencies": {
+    "@threema/wasm-minisign-verify": "0.1.3",
+    "tar": "7.5.22"
   },
-  "pisperBundle": {
-    "target": "linux_x86_64",
+  "pisper": {
+    "repository": "ling-kong-ran/pisper",
     "tuiVersion": "0.5.23",
     "runtimeVersion": "0.5.37"
+  },
+  "optionalDependencies": {
+    "pisper-binary-win32-x64": "npm:pisper@0.5.39-win32-x64.0",
+    "pisper-binary-darwin-x64": "npm:pisper@0.5.39-darwin-x64.0",
+    "pisper-binary-darwin-arm64": "npm:pisper@0.5.39-darwin-arm64.0",
+    "pisper-binary-linux-x64": "npm:pisper@0.5.39-linux-x64.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
   }
 }

package/updater.pubkey

@@ -0,0 +1 @@
+dW50cnVzdGVkIGNvbW1lbnQ6IG1pbmlzaWduIHB1YmxpYyBrZXk6IEYwRTUzMkExNjAyRUNGQTQKUldTa3p5NWdvVExsOEQ5TElOa3BVcUxZQ2I1RlNieHJHeFQ3YVdqeTRMK0VKS2dWSlZsMXRNazQK