@ghship/cli 1.0.1 → 1.0.4

package/README.md

@@ -1,7 +1,10 @@
 # GHShip npm distribution
 
-Go CLI and home AI skill plus per-project integration. Package includes native
-binaries for macOS/Linux/Windows × amd64/arm64, with no postinstall downloads.
+Go CLI and home AI skill plus per-project integration. npm installs the native
+binary package matching the Node.js operating system and architecture for
+macOS/Linux/Windows × x64/arm64, with no postinstall downloads. Optional
+dependencies must be enabled and the matching package must be available from the
+configured registry. An emulated Node.js runtime selects its own architecture.
 
 After publication: `npx @ghship/cli@latest install` installs the home skill, same-version
 persistent CLI, then enters project initialization. `--user-only` stops after user
@@ -10,12 +13,16 @@ installation. Project workflows need Git and a gh with native Issue relationship
 
 Update/uninstall via external `npx @ghship/cli@latest update|uninstall`. Project lifecycle:
 `ghship project install|status|update|uninstall`; custom `.ghship/skill.md` is preserved.
+Install and update also update a verified standalone installation in place, keeping its
+channel and paths. To uninstall a standalone installation, use a separate downloaded
+executable with `uninstall --standalone`.
 Users: `ghship user add|update|delete|list`; list validates tokens and reports actual
 expiry when GitHub returns it, otherwise unknown. Tokens never belong in projects.
 
 For a downloaded npm tarball, use:
 `npm exec --package /absolute/ghship.tgz -- ghship install --package-source /absolute/ghship.tgz`.
-Add `--user-only` to install shared tools without initializing a project.
+The configured registry must provide the same-version platform package. Add
+`--user-only` to install shared tools without initializing a project.
 Registry commands require the selected version to be published.
 
 Detailed Chinese tutorial and AI skill: https://github.com/ghship/cli

package/checksums.json

@@ -1,8 +1,8 @@
 {
-  "bin/darwin-amd64/ghship": "81c748330990be524622d58c8dc9e47efa81f554c7004a378ef9a958e29d6f53",
-  "bin/darwin-arm64/ghship": "93c2f21a01d0d276a1f8cacfd5e3361de048b32a66da62178e6728f700c5a9ac",
-  "bin/linux-amd64/ghship": "9e75a33039b6568c02ca5020c26c5ae7eca5248487643a8a37578e263391e1c7",
-  "bin/linux-arm64/ghship": "58c8390b8e8ece6164c2eb2de97947257062a413bf53daa7e329ef80970e6bfa",
-  "bin/windows-amd64/ghship.exe": "80468fe319d059c8256671cfcc33b598e9520b3f954d2ec5b28b75b926dbab40",
-  "bin/windows-arm64/ghship.exe": "ed332b76c8c943ba6cf5a54a2480fde4411417cc88e2a63e1cf1831a553c6825"
+  "darwin-arm64": "bdce86aa2ebb4bca9ee4e149cce2b29d51557dfeee7f732b2dcd6d1458f125a6",
+  "darwin-x64": "c0b71ad5b0d9e338cb9836b8572e9caacbad1a710965df0af88665d68dc100da",
+  "linux-arm64": "b3607bc943a8b01a5e8a164a21026766442cd1a7fae14b2703afcfdd1afa97f3",
+  "linux-x64": "2ba3458d178f81abc11478fa92128e76fcc61567b9abc4a8d1931fcaa6363f02",
+  "win32-arm64": "68a9bb61d9f1ee7147f2bc7eacc2c377fd25f2016b4d911b818db3d8666e2f4c",
+  "win32-x64": "dc1d6ebf166634222f919668f1b7803c2bf1c2c6d6df2d460c95b7bb48f2d85d"
 }

package/package.json

@@ -1,16 +1,23 @@
 {
   "name": "@ghship/cli",
-  "version": "1.0.1",
+  "version": "1.0.4",
   "description": "Go CLI and AI skill for native GitHub delivery pipelines",
   "bin": {
     "ghship": "run.cjs"
   },
   "files": [
     "run.cjs",
-    "bin",
     "README.md",
     "checksums.json"
   ],
+  "optionalDependencies": {
+    "@ghship/cli-darwin-x64": "1.0.4",
+    "@ghship/cli-darwin-arm64": "1.0.4",
+    "@ghship/cli-linux-x64": "1.0.4",
+    "@ghship/cli-linux-arm64": "1.0.4",
+    "@ghship/cli-win32-x64": "1.0.4",
+    "@ghship/cli-win32-arm64": "1.0.4"
+  },
   "engines": {
     "node": ">=18"
   },

package/run.cjs

@@ -4,11 +4,31 @@ const fs = require('node:fs');
 const os = require('node:os');
 const crypto = require('node:crypto');
 const { spawn, spawnSync } = require('node:child_process');
-function binaryPath(platform = process.platform, arch = process.arch) {
- const os = {darwin:'darwin', linux:'linux', win32:'windows'}[platform];
- const cpu = {x64:'amd64', arm64:'arm64'}[arch];
- if (!os || !cpu) throw new Error(`Unsupported platform: ${platform}/${arch}`);
- return path.join(__dirname, 'bin', `${os}-${cpu}`, os === 'windows' ? 'ghship.exe' : 'ghship');
+function singlePack(value,name) {
+ let record;
+ if(Array.isArray(value)) {if(value.length!==1)throw new Error('Unexpected npm pack result');record=value[0];}
+ else if(value&&typeof value==='object'&&Object.keys(value).length===1&&Object.hasOwn(value,name))record=value[name];
+ if(!record||typeof record!=='object'||record.name!==name||typeof record.version!=='string')throw new Error('Unexpected npm pack result');
+ return record;
+}
+function platformInfo(platform = process.platform, arch = process.arch) {
+ if (!['darwin','linux','win32'].includes(platform) || !['x64','arm64'].includes(arch)) throw new Error(`Unsupported platform: ${platform}/${arch}`);
+ return {target:`${platform}-${arch}`,name:`@ghship/cli-${platform}-${arch}`,binary:platform==='win32'?'ghship.exe':'ghship'};
+}
+function binaryPath(platform = process.platform, arch = process.arch, root = __dirname) {
+ const info=platformInfo(platform,arch);
+ const meta=JSON.parse(fs.readFileSync(path.join(root,'package.json'),'utf8'));
+ let manifest;try {manifest=require.resolve(`${info.name}/package.json`,{paths:[root]});}
+ catch (_) {throw new Error(`Platform package ${info.name}@${meta.version} is missing; enable optional dependencies and reinstall @ghship/cli@${meta.version}`);}
+ const allowed=[path.join(root,'node_modules',info.name),path.join(path.dirname(path.dirname(root)),info.name)];
+ if(!allowed.some(dir=>path.resolve(path.dirname(manifest))===path.resolve(dir)))throw new Error('Platform package is outside the installation; preserved');
+ noLinks(manifest);
+ const platformMeta=JSON.parse(fs.readFileSync(manifest,'utf8'));
+ if(platformMeta.name!==info.name||platformMeta.version!==meta.version||!platformMeta.os?.includes(platform)||!platformMeta.cpu?.includes(arch))throw new Error('Platform package does not match CLI version or platform; preserved');
+ const executable=path.join(path.dirname(manifest),'bin',info.binary);noLinks(executable);
+ const checks=JSON.parse(fs.readFileSync(path.join(root,'checksums.json'),'utf8'));
+ if(!checks[info.target]||hashFile(executable)!==checks[info.target])throw new Error('Platform binary missing or checksum mismatch; preserved');
+ return executable;
 }
 function npmCommand() {
  if (process.env.npm_execpath && fs.existsSync(process.env.npm_execpath)) return [process.execPath, [process.env.npm_execpath]];
@@ -53,8 +73,10 @@ function observePackage(root,meta,existing,replacingVerifiedReceipt=false) {
  const directory=path.join(root,meta.name); noLinks(directory);
  const metadata=JSON.parse(fs.readFileSync(path.join(directory,'package.json'),'utf8'));
  if(metadata.name!==meta.name||metadata.version!==existing.version||metadata.bin?.ghship!=='run.cjs')throw new Error('Unrecognized global package; preserved');
- const relative=path.relative(__dirname,binaryPath());
- const observed={root,name:meta.name,version:metadata.version,launcher:hashFile(path.join(directory,'run.cjs')),binary:hashFile(path.join(directory,relative))};
+ const info=platformInfo();const legacyOS={darwin:'darwin',linux:'linux',win32:'windows'}[process.platform];const legacyArch={x64:'amd64',arm64:'arm64'}[process.arch];
+ const legacy=path.join(directory,'bin',`${legacyOS}-${legacyArch}`,info.binary);
+ const installedBinary=fs.existsSync(legacy)?legacy:binaryPath(process.platform,process.arch,directory);noLinks(installedBinary);
+ const observed={root,name:meta.name,version:metadata.version,launcher:hashFile(path.join(directory,'run.cjs')),binary:hashFile(installedBinary)};
  const current=observed.version===meta.version&&observed.launcher===hashFile(path.join(__dirname,'run.cjs'))&&observed.binary===hashFile(binaryPath());
  const receipt=packageReceipt(root);noLinks(receipt);
  let recorded=null;try{recorded=JSON.parse(fs.readFileSync(receipt,'utf8'));}catch(error){if(error.code!=='ENOENT')throw new Error('Invalid installation receipt; preserved');}
@@ -73,7 +95,7 @@ function lifecycle(executable,args) {
  const action=args[0], meta=require('./package.json'); let source=`${meta.name}@${meta.version}`;
  const passed=args.slice(1); const sourceIndex=passed.indexOf('--package-source');
  if(sourceIndex>=0) {if(!passed[sourceIndex+1])throw new Error('--package-source requires a local tarball');source=path.resolve(passed[sourceIndex+1]);passed.splice(sourceIndex,2);
-  const packed=JSON.parse(npm(['pack',source,'--dry-run','--json'],true));if(packed.length!==1||packed[0].name!==meta.name||packed[0].version!==meta.version)throw new Error('Local package source must match this exact package and version');
+  const packed=singlePack(JSON.parse(npm(['pack',source,'--dry-run','--json'],true)),meta.name);if(packed.version!==meta.version)throw new Error('Local package source must match this exact package and version');
  }
  const lifecycleArgs=[];const initArgs=[];let userOnly=false;
  const initValues=new Set(['--project','--repo','--author','--reviewer','--admin','--acceptance-pr']);
@@ -87,8 +109,18 @@ function lifecycle(executable,args) {
   else throw new Error(`Unknown lifecycle option: ${arg}; use ghship help install`);
  }
  const preflight=go(executable,[action,'--skill-only','--check',...lifecycleArgs,'--json'],true);if(preflight.code!==0)return preflight.code;
+ const state=JSON.parse(preflight.stdout);
  const installed=JSON.parse(npm(['list','-g',meta.name,'--depth=0','--json'],true));
  const existing=installed.dependencies && installed.dependencies[meta.name];
+ if(state.standalone) {
+  if(action==='uninstall')throw new Error('Standalone installation exists; uninstall with a separate downloaded executable and --standalone');
+  if(existing)throw new Error('Standalone and npm installations both exist; inspect both before updating');
+  const args=[action,'--standalone',...lifecycleArgs,...(userOnly?['--user-only']:[]),...initArgs.filter(arg=>arg!=='--json'),'--json'];
+  const result=go(executable,args,true,action==='install'&&!userOnly);
+  if(action==='install'&&!userOnly) {if(result.stdout)process.stdout.write(result.stdout);return result.code;}
+  if(result.code!==0)return result.code;
+  console.log(JSON.stringify({userInstalled:true,version:meta.version,projectInitialized:false}));return 0;
+ }
  const root=path.resolve(npm(['root','-g'],true).trim());
  const receipt=packageReceipt(root);noLinks(receipt);
  if(!existing&&action!=='uninstall'&&fs.existsSync(receipt))throw new Error('Installation receipt exists without its package; preserved');
@@ -105,7 +137,7 @@ function lifecycle(executable,args) {
  const verified=JSON.parse(npm(['list','-g',meta.name,'--depth=0','--json'],true));
  if(!verified.dependencies||verified.dependencies[meta.name]?.version!==meta.version)throw new Error('Installed CLI version does not match skill; installation incomplete');
  const persisted=observePackage(root,meta,verified.dependencies[meta.name],!!observation);if(!persisted.current)throw new Error('Persistent CLI content does not match this package');
- const runtimeVersion=go(path.join(root,meta.name,path.relative(__dirname,executable)),['version'],true);
+ const runtimeVersion=go(binaryPath(process.platform,process.arch,path.join(root,meta.name)),['version'],true);
  if(runtimeVersion.code!==0||runtimeVersion.stdout.trim()!==meta.version)throw new Error('Persistent CLI cannot run the expected version');
  saveReceipt(root,persisted.observed);
  if(action==='update'||userOnly){console.log(JSON.stringify({userInstalled:true,version:meta.version,projectInitialized:false}));return 0;}
@@ -113,7 +145,7 @@ function lifecycle(executable,args) {
  let result;try{result=JSON.parse(init.stdout);}catch(_){result={ready:false,missing:['Initialization failed before producing a result'],next:['ghship init --json']};}
  result.userInstalled=true;result.version=meta.version;console.log(JSON.stringify(result));return init.code;
 }
-module.exports = {binaryPath};
+module.exports = {binaryPath,platformInfo,singlePack};
 if(require.main===module) {
  try {
   const executable=binaryPath();if(!fs.existsSync(executable))throw new Error('Package missing Go binary; reinstall the package');