@ade-syofyan/feature-map-pro 0.0.0-stage → 0.21.0-pro.2

package/LICENSE

@@ -0,0 +1,3 @@
+Copyright 2026 Ade Syofyan. All rights reserved.
+The installer may be downloaded and used to install licensed Feature Map Pro.
+This notice does not modify the MIT license of the separate Free core.

package/README.md

@@ -1,3 +1,24 @@
-# Temporary Holding Version
+# Feature Map Pro Installer
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Installer gratis untuk Feature Map Pro. Fitur premium memerlukan lisensi per email.
+Source mesin Pro tidak termasuk dalam paket npm; binary diunduh dari rilis resmi.
+
+```bash
+npx @ade-syofyan/feature-map-pro@preview install
+```
+
+Masukkan email pembelian dan kode lisensi dari Ade Syofyan. Anda juga bisa memakai
+`--license-file /path/to/buyer.license`. Jangan memasukkan kode ke argumen command.
+Setelah aktif, buka sesi agent baru. Status: `npx @ade-syofyan/feature-map-pro@preview license status`.
+
+Platform yang tersedia tercantum di release.json: macOS Apple Silicon, Windows x64,
+dan Linux x64 (glibc, Ubuntu 22.04 atau lebih baru). Windows ARM, Linux ARM dan
+Alpine/musl belum didukung. Windows memakai tar bawaan Windows 10/11. Node 20+, tar, Git, serta Python 3
+untuk hook/core Free diperlukan. Installer memasang skill Codex; `--activate-only`
+mengaktifkan tanpa memasang skill. Plugin Claude Code dapat dipasang manual dari
+folder paket melalui pengelola plugin, dengan satu sumber feature-map aktif.
+
+Lisensi diverifikasi offline sebelum instalasi skill dan setiap command premium.
+Instalasi lama disalin ke folder backup di luar folder skills. Core Free tetap MIT.
+Kompilasi mempersulit pembacaan source; bukan jaminan anti-reverse-engineering
+atau pencegahan penyalinan binary. Pembelian/harga: ade.syofyan@gmail.com.

package/bin/feature-map-pro.mjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import {fileURLToPath} from 'node:url';
+import {activateAndInstall,ensurePayload,installSkills,runEngine} from '../lib/installer.mjs';
+
+const manifest=JSON.parse(fs.readFileSync(fileURLToPath(new URL('../release.json',import.meta.url)),'utf8'));
+const args=process.argv.slice(2);
+if(!args.length||args[0]==='--help'||args[0]==='help') {
+ console.log(`Feature Map Pro ${manifest.version}\n\nPemakaian:\n  feature-map-pro install [--email email] [--license-file file] [--activate-only]\n  feature-map-pro license status\n  feature-map-pro <perintah-pro> [opsi]\n\nInstaller gratis; fitur Pro memerlukan lisensi pembelian.\nDukungan platform mengikuti paket yang tersedia pada rilis.`);
+} else {
+ try {
+  const root=await ensurePayload(manifest);
+  if(args[0]==='install') {
+   const activation=[];let activateOnly=false;
+   for(let i=1;i<args.length;i++) {
+    if(args[i]==='--activate-only') {activateOnly=true;continue;}
+    if(!['--email','--license-file'].includes(args[i])||!args[i+1]) throw new Error('Opsi instalasi tidak dikenal. Gunakan --help.');
+    activation.push(args[i]==='--license-file'?'--file':args[i],args[++i]);
+   }
+   activateAndInstall(()=>runEngine(root,['license','activate',...activation]),()=>{
+    const backup=activateOnly?null:installSkills(root);
+    console.log('Pro aktif. Buka sesi baru untuk memuat instruksi Pro.');
+    if(backup) console.log('Salinan skill sebelumnya: '+backup);
+   });
+  } else {
+   process.exitCode=runEngine(root,args).status??2;
+  }
+ } catch(error) {console.error('Gagal: '+error.message);process.exitCode=2;}
+}

package/lib/installer.mjs

@@ -0,0 +1,147 @@
+import {createHash,randomUUID} from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import {spawnSync} from 'node:child_process';
+
+const MAX_DOWNLOAD=384*1024*1024;
+const HEX=/^[a-f0-9]{64}$/;
+const VERSION=/^\d+\.\d+\.\d+(?:-[a-z0-9.]+)?$/;
+const DOWNLOAD_HOSTS=new Set(['github.com','release-assets.githubusercontent.com','objects.githubusercontent.com']);
+
+function trustedURL(value) {
+ const url=new URL(value);
+ if(url.protocol!=='https:'||url.username||url.password||!DOWNLOAD_HOSTS.has(url.hostname))
+  throw new Error('URL unduhan tidak tepercaya.');
+ return url;
+}
+export function selectArtifact(manifest,platform=process.platform,arch=process.arch) {
+ if(manifest?.schema_version!==1||!VERSION.test(manifest.version)||!manifest.artifacts)
+  throw new Error('Manifest rilis tidak valid.');
+ const entry=manifest.artifacts[`${platform}-${arch}`];
+ if(!entry) throw new Error(`Paket belum tersedia untuk platform ${platform}-${arch}.`);
+ if(!HEX.test(entry.sha256)||!HEX.test(entry.engine_sha256)||!Number.isSafeInteger(entry.size)||entry.size<1||entry.size>MAX_DOWNLOAD)
+  throw new Error('Metadata unduhan tidak valid.');
+ const url=trustedURL(entry.url);
+ if(url.hostname!=='github.com'||!url.pathname.startsWith('/ade-syofyan/feature-map-installer/releases/download/'))
+  throw new Error('Lokasi rilis tidak tepercaya.');
+ return entry;
+}
+export function verifyChecksum(data,expected) {
+ if(!HEX.test(expected)||createHash('sha256').update(data).digest('hex')!==expected)
+  throw new Error('Checksum paket berbeda. Unduhan dibatalkan.');
+ return true;
+}
+export function validateArchiveNames(listing) {
+ const names=listing.split(/\r?\n/).filter(Boolean);
+ if(!names.length) throw new Error('Arsip kosong.');
+ for(const name of names) {
+  if(!/^feature-map-pro\/(?:[A-Za-z0-9._+@/-]*)$/.test(name)||name.split('/').some(p=>p==='..'||p==='.'))
+   throw new Error('Path arsip tidak aman.');
+ }
+ return true;
+}
+export function activateAndInstall(activate,install) {
+ const result=activate();
+ if(result.status!==0) throw new Error('Aktivasi lisensi gagal. Instalasi skill dihentikan.');
+ return install();
+}
+export async function download(entry) {
+ let url=trustedURL(entry.url);
+ for(let redirects=0;redirects<=5;redirects++) {
+  const response=await fetch(url,{redirect:'manual',signal:AbortSignal.timeout(180000)});
+  if([301,302,303,307,308].includes(response.status)) {
+   const location=response.headers.get('location');
+   if(!location) throw new Error('Redirect unduhan tidak valid.');
+   url=trustedURL(new URL(location,url).href);continue;
+  }
+  if(!response.ok||!response.body) throw new Error(`Unduhan gagal (${response.status}).`);
+  const chunks=[];let size=0;
+  for await(const part of response.body) {
+   size+=part.byteLength;
+   if(size>entry.size||size>MAX_DOWNLOAD) throw new Error('Ukuran unduhan melebihi metadata rilis.');
+   chunks.push(Buffer.from(part));
+  }
+  if(size!==entry.size) throw new Error('Unduhan belum lengkap.');
+  const data=Buffer.concat(chunks);verifyChecksum(data,entry.sha256);return data;
+ }
+ throw new Error('Terlalu banyak redirect unduhan.');
+}
+export function enginePath(root,platform=process.platform) { return path.join(root,'runtime','engine',platform==='win32'?'feature-map-engine.exe':'feature-map-engine'); }
+function engineValid(root,entry,platform) {
+ try {
+  const file=enginePath(root,platform);
+  if(fs.lstatSync(file).isSymbolicLink()||!fs.statSync(file).isFile()) return false;
+  verifyChecksum(fs.readFileSync(file),entry.engine_sha256);return true;
+ } catch {return false;}
+}
+function tar(args) {
+ const result=spawnSync('tar',args,{encoding:'utf8',maxBuffer:8*1024*1024});
+ if(result.error||result.status!==0) throw new Error('Paket tidak bisa dibaca. Pastikan tar tersedia.');
+ return result.stdout;
+}
+export async function ensurePayload(manifest,{home=process.env.FEATURE_MAP_PRO_HOME||path.join(os.homedir(),'.local','share','feature-map-pro'),fetchArtifact=download,platform=process.platform,arch=process.arch}={}) {
+ const entry=selectArtifact(manifest,platform,arch);
+ const base=path.resolve(home,'releases',manifest.version,`${platform}-${arch}`);
+ const root=path.join(base,'feature-map-pro');
+ const marker=path.join(base,'artifact.sha256');
+ if(fs.existsSync(base)&&fs.lstatSync(base).isSymbolicLink()) throw new Error('Folder instalasi tidak boleh berupa symlink.');
+ if(fs.existsSync(marker)&&fs.readFileSync(marker,'utf8')===entry.sha256&&engineValid(root,entry,platform)) return root;
+ const parent=path.dirname(base);fs.mkdirSync(parent,{recursive:true});
+ const staging=fs.mkdtempSync(path.join(parent,'.download-'));
+ try {
+  console.log('Mengunduh mesin Feature Map Pro…');
+  const data=await fetchArtifact(entry);verifyChecksum(data,entry.sha256);
+  const archive=path.join(staging,'download.tar.gz');fs.writeFileSync(archive,data,{mode:0o600});
+  validateArchiveNames(tar(['-tzf',archive]));
+  const types=tar(['-tvzf',archive]).split(/\r?\n/).filter(Boolean);
+  if(types.some(line=>!['-','d'].includes(line[0]))) throw new Error('Arsip mengandung link atau file khusus.');
+  const extracted=path.join(staging,'extracted');fs.mkdirSync(extracted);
+  tar(['-xzf',archive,'-C',extracted,'--no-same-owner']);
+  const extractedRoot=path.join(extracted,'feature-map-pro');
+  if(!engineValid(extractedRoot,entry,platform)) throw new Error('Mesin Pro tidak cocok dengan rilis.');
+  const previous=base+'.previous-'+randomUUID();
+  const hadPrevious=fs.existsSync(base);
+  if(hadPrevious) fs.renameSync(base,previous);
+  try {fs.renameSync(extracted,base);} catch(error) {if(hadPrevious) fs.renameSync(previous,base);throw error;}
+  fs.writeFileSync(marker,entry.sha256,{mode:0o600});
+  if(hadPrevious) fs.rmSync(previous,{recursive:true,force:true});
+  return root;
+ } finally {fs.rmSync(staging,{recursive:true,force:true});}
+}
+export function installSkills(root,codexHome=process.env.CODEX_HOME||path.join(os.homedir(),'.codex')) {
+ const names=['feature-map','feature-map-pro'];
+ const id=randomUUID();const staging=path.join(codexHome,'feature-map-stage',id);
+ const backups=path.join(codexHome,'feature-map-backups',id);
+ const targets=names.map(name=>path.join(codexHome,'skills',name));
+ for(const target of targets) if(fs.existsSync(target)&&fs.lstatSync(target).isSymbolicLink())
+  throw new Error('Folder skill berupa symlink. Salin konfigurasi Anda sebelum mengganti instalasi.');
+ fs.mkdirSync(staging,{recursive:true});
+ const moved=[];const installed=[];
+ try {
+  for(const name of names) {
+   const source=path.join(root,'codex-skill',name);
+   if(!fs.existsSync(path.join(source,'SKILL.md'))) throw new Error('Skill tidak lengkap pada paket Pro.');
+   fs.cpSync(source,path.join(staging,name),{recursive:true});
+   fs.writeFileSync(path.join(staging,name,'plugin-root.txt'),root+'\n');
+  }
+  fs.mkdirSync(path.join(codexHome,'skills'),{recursive:true});
+  for(let i=0;i<names.length;i++) {
+   if(fs.existsSync(targets[i])) {
+    fs.mkdirSync(backups,{recursive:true});const backup=path.join(backups,names[i]);
+    fs.renameSync(targets[i],backup);moved.push([backup,targets[i]]);
+   }
+   fs.renameSync(path.join(staging,names[i]),targets[i]);installed.push(targets[i]);
+  }
+ } catch(error) {
+  for(const target of installed.reverse()) fs.rmSync(target,{recursive:true,force:true});
+  for(const [backup,target] of moved.reverse()) fs.renameSync(backup,target);
+  throw error;
+ } finally {fs.rmSync(staging,{recursive:true,force:true});}
+ return moved.length?backups:null;
+}
+export function runEngine(root,args,{stdio='inherit',...options}={}) {
+ const result=spawnSync(enginePath(root),args,{stdio,...options});
+ if(result.error) throw new Error('Mesin Pro tidak bisa dijalankan: '+result.error.message);
+ return result;
+}

package/package.json

@@ -1,6 +1,33 @@
 {
   "name": "@ade-syofyan/feature-map-pro",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.21.0-pro.2",
+  "description": "Installer and launcher for licensed Feature Map Pro",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "feature-map-pro": "bin/feature-map-pro.mjs"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "release.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "test": "node --test test/installer.test.mjs"
+  },
+  "author": "Ade Syofyan <ade.syofyan@gmail.com>",
+  "license": "SEE LICENSE IN LICENSE",
+  "publishConfig": {
+    "access": "public",
+    "tag": "preview"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ade-syofyan/feature-map-installer.git"
+  }
+}

package/release.json

@@ -0,0 +1,24 @@
+{
+  "schema_version": 1,
+  "version": "0.21.0-pro.2",
+  "artifacts": {
+    "darwin-arm64": {
+      "sha256": "fa90315978ee367eb169fb885d360d8e9830769752105e050eb7f95ac49b5a7d",
+      "engine_sha256": "189d9b537742f508de6bc2a296245a19d9422e91ce56edf7c55a9fee033266df",
+      "size": 14320567,
+      "url": "https://github.com/ade-syofyan/feature-map-installer/releases/download/v0.21.0-pro.2/feature-map-pro-0.21.0-pro.2-darwin-arm64.tar.gz"
+    },
+    "linux-x64": {
+      "sha256": "39bf4a0c239c0de291c27c7d7e684fef795f2de5e855072bc46868f2832c7ba4",
+      "engine_sha256": "5da00bbd833bc15c3ad0d98017e0a7127df861ac446455768b23b2950f7fee1a",
+      "size": 18223616,
+      "url": "https://github.com/ade-syofyan/feature-map-installer/releases/download/v0.21.0-pro.2/feature-map-pro-0.21.0-pro.2-linux-x64.tar.gz"
+    },
+    "win32-x64": {
+      "sha256": "948db51f8583753b68dd64d92db4f333601f4c51f9585e8924e2ab71f75c1ca0",
+      "engine_sha256": "9a4c4cb6cbe767eb02b9afa9a5e2425194ac6de6f2f593bd716ad53f87424ece",
+      "size": 11664438,
+      "url": "https://github.com/ade-syofyan/feature-map-installer/releases/download/v0.21.0-pro.2/feature-map-pro-0.21.0-pro.2-win32-x64.tar.gz"
+    }
+  }
+}