publishport-opencli 1.0.19 → 1.0.21

package/dist/src/plugin.js

@@ -1,7 +1,7 @@
-import*as J from"node:fs";import*as p from"node:os";import*as B from"node:path";import{execSync as e,execFileSync as S}from"node:child_process";import{fileURLToPath as k}from"node:url";import{PLUGINS_DIR as T}from"./discovery.js";import{getErrorMessage as U,PluginError as x}from"./errors.js";import{log as w}from"./logger.js";import{isRecord as b}from"./utils.js";import{readPluginManifest as F,isMonorepo as y,getEnabledPlugins as qq,checkCompatibility as O,getCompatibilityRange as M}from"./plugin-manifest.js";const N=process.platform==="win32",d="local:";function a(){return process.env.HOME||process.env.USERPROFILE||p.homedir()}export function getLockFilePath(){return B.join(a(),".ppcli","plugins.lock.json")}export function getMonoreposDir(){return B.join(a(),".ppcli","monorepos")}function h(q){if(!q)return;if(q.startsWith(d))return{kind:"local",path:B.resolve(q.slice(d.length))};return{kind:"git",url:q}}function isLocalPluginSource(q){return h(q)?.kind==="local"}function toStoredPluginSource(q){if(q.kind==="local")return`${d}${B.resolve(q.path)}`;return q.url}function toLocalPluginSource(q){return toStoredPluginSource({kind:"local",path:q})}function Kq(q){if(!b(q))return;if(typeof q.name!=="string"||typeof q.subPath!=="string")return;return{name:q.name,subPath:q.subPath}}function Qq(q,K){if(typeof q==="string"){const Q=h(q);if(!Q)return;if(Q.kind==="git"&&K)return{kind:"monorepo",url:Q.url,repoName:K.name,subPath:K.subPath};return Q}if(!b(q)||typeof q.kind!=="string")return;switch(q.kind){case"git":return typeof q.url==="string"?{kind:"git",url:q.url}:void 0;case"local":return typeof q.path==="string"?{kind:"local",path:B.resolve(q.path)}:void 0;case"monorepo":return typeof q.url==="string"&&typeof q.repoName==="string"&&typeof q.subPath==="string"?{kind:"monorepo",url:q.url,repoName:q.repoName,subPath:q.subPath}:void 0;default:return}}function Vq(q){if(!b(q))return;const K=Kq(q.monorepo),Q=Qq(q.source,K);if(!Q)return;if(typeof q.commitHash!=="string"||typeof q.installedAt!=="string")return;const V={source:Q,commitHash:q.commitHash,installedAt:q.installedAt};if(typeof q.updatedAt==="string")V.updatedAt=q.updatedAt;return V}function resolvePluginSource(q,K){if(q)return q.source;return h(_q(K))}function resolveStoredPluginSource(q,K){const Q=resolvePluginSource(q,K);return Q?toStoredPluginSource(Q):void 0}function moveDir(q,K,Q=J){try{Q.renameSync(q,K)}catch(V){if(V.code==="EXDEV"){try{Q.cpSync(q,K,{recursive:!0})}catch(Y){try{Q.rmSync(K,{recursive:!0,force:!0})}catch{}throw Y}Q.rmSync(q,{recursive:!0,force:!0})}else throw V}}function L(q,K){const Q=`${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`;return B.join(B.dirname(q),`.${B.basename(q)}.${K}-${Q}`)}function Yq(q){const K=B.join(p.tmpdir(),`opencli-clone-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`);try{S("git",["clone","--depth","1",q,K],{encoding:"utf-8",stdio:["pipe","pipe","pipe"]})}catch(Q){throw new x(`Failed to clone plugin: ${U(Q)}`,"Check the repository URL and your network connection.")}return K}function m(q,K){const Q=Yq(q);try{return K(Q)}finally{try{J.rmSync(Q,{recursive:!0,force:!0})}catch{}}}function Zq(q,K){const Q=resolvePluginSource(q,K);if(!Q||Q.kind==="local")throw Error(`Unable to determine remote source for plugin at ${K}`);return Q.url}function D(q){try{J.lstatSync(q);return!0}catch{return!1}}function C(q,K){const Q=B.resolve(q,K);if(!Q.startsWith(q+B.sep)&&Q!==q)throw new x(`Plugin path "${K}" escapes repo root.`);return Q}function f(q){try{if(J.lstatSync(q).isSymbolicLink()){J.unlinkSync(q);return}J.rmSync(q,{recursive:!0,force:!0})}catch{}}class i{#K=[];#q=!1;track(q){this.#K.push(q);return q}commit(){if(this.#q)return;this.#q=!0;for(const q of this.#K)q.finalize()}rollback(){if(this.#q)return;this.#q=!0;for(const q of[...this.#K].reverse())q.rollback()}}function s(q){const K=new i;try{const Q=q(K);K.commit();return Q}catch(Q){K.rollback();throw Q}}function n(q,K,Q=J){const V=Q.existsSync(K);Q.mkdirSync(B.dirname(K),{recursive:!0});const Y=L(K,"tmp"),Z=V?L(K,"bak"):null;let X=!1;try{moveDir(q,Y,Q);if(Z)Q.renameSync(K,Z);Q.renameSync(Y,K)}catch($){try{Q.rmSync(Y,{recursive:!0,force:!0})}catch{}if(Z&&!Q.existsSync(K))try{Q.renameSync(Z,K)}catch{}throw $}return{finalize(){if(X)return;X=!0;if(Z)try{Q.rmSync(Z,{recursive:!0,force:!0})}catch{}},rollback(){if(X)return;X=!0;try{Q.rmSync(K,{recursive:!0,force:!0})}catch{}if(Z)try{Q.renameSync(Z,K)}catch{}try{Q.rmSync(Y,{recursive:!0,force:!0})}catch{}}}}function $q(q,K){const Q=D(K);if(Q&&!isSymlinkSync(K))throw Error(`Expected monorepo plugin link at ${K} to be a symlink`);J.mkdirSync(B.dirname(K),{recursive:!0});const V=L(K,"tmp"),Y=Q?L(K,"bak"):null,Z=N?"junction":"dir";let X=!1;try{J.symlinkSync(q,V,Z);if(Y)J.renameSync(K,Y);J.renameSync(V,K)}catch($){f(V);if(Y&&!D(K))try{J.renameSync(Y,K)}catch{}throw $}return{finalize(){if(X)return;X=!0;if(Y)f(Y)},rollback(){if(X)return;X=!0;f(K);if(Y&&!D(K))try{J.renameSync(Y,K)}catch{}f(V)}}}function readLockFileWithWriter(q=writeLockFile){try{const K=J.readFileSync(getLockFilePath(),"utf-8"),Q=JSON.parse(K);if(!b(Q))return{};const V={};let Y=!1;for(const[Z,X]of Object.entries(Q)){const $=Vq(X);if(!$){Y=!0;continue}V[Z]=$;if(JSON.stringify(X)!==JSON.stringify($))Y=!0}if(Y)try{q(V)}catch{}return V}catch{return{}}}export function readLockFile(){return readLockFileWithWriter(writeLockFile)}function writeLockFileWithFs(q,K=J){const Q=getLockFilePath();K.mkdirSync(B.dirname(Q),{recursive:!0});const V=L(Q,"tmp");try{K.writeFileSync(V,JSON.stringify(q,null,2)+`
-`);K.renameSync(V,Q)}catch(Y){try{K.rmSync(V,{force:!0})}catch{}throw Y}}export function writeLockFile(q){writeLockFileWithFs(q,J)}export function getCommitHash(q){try{return S("git",["rev-parse","HEAD"],{cwd:q,encoding:"utf-8",stdio:["pipe","pipe","pipe"]}).trim()}catch{return}}export function validatePluginStructure(q){const K=[];if(!J.existsSync(q))return{valid:!1,errors:["Plugin directory does not exist"]};const Q=J.readdirSync(q),V=Q.some((Z)=>Z.endsWith(".ts")&&!Z.endsWith(".d.ts")&&!Z.endsWith(".test.ts")),Y=Q.some((Z)=>Z.endsWith(".js")&&!Z.endsWith(".d.js"));if(!V&&!Y)K.push("No command files found in plugin directory. A plugin must contain at least one .ts or .js command file.");if(V){const Z=B.join(q,"package.json");if(!J.existsSync(Z))K.push('Plugin contains .ts files but no package.json. A package.json with "type": "module" and "@jackwener/opencli" peer dependency is required for TS plugins.');else try{if(JSON.parse(J.readFileSync(Z,"utf-8")).type!=="module")K.push('Plugin package.json must have "type": "module" for TypeScript plugins.')}catch{K.push("Plugin package.json is malformed or invalid JSON.")}}return{valid:K.length===0,errors:K}}function Xq(q){const K=B.join(q,"package.json");if(!J.existsSync(K))return!1;try{const Q=JSON.parse(J.readFileSync(K,"utf-8"));return Q.dependencies!=null&&Object.keys(Q.dependencies).length>0}catch{return!1}}function installDependencies(q){const K=B.join(q,"package.json");if(!J.existsSync(K))return;try{S("npm",["install","--omit=dev","--ignore-scripts"],{cwd:q,encoding:"utf-8",stdio:["pipe","pipe","pipe"],...N&&{shell:!0}})}catch(Q){throw new x(`npm install failed in ${q}: ${U(Q)}`,"Check your network connection and npm configuration.")}}function g(q){xq(q);Tq(q)}function o(q){installDependencies(q);g(q)}function postInstallMonorepoLifecycle(q,K){installDependencies(q);for(const Q of K){if(Q!==q&&Xq(Q))installDependencies(Q);g(Q)}}function l(q){const K=validatePluginStructure(q);if(!K.valid)throw new x(`Invalid plugin structure:
-- ${K.errors.join(`
-- `)}`);o(q)}function R(q,K,Q){q[K]={...Q,installedAt:Q.installedAt??new Date().toISOString()}}function r(q,K,Q){s((V)=>{V.track(n(q,K));Q(getCommitHash(K))})}function t(q,K,Q,V,Y){s((Z)=>{if(V){J.mkdirSync(V.parentDir,{recursive:!0});Z.track(n(V.stagingDir,q))}const X=getCommitHash(q);for(const $ of Q){const A=B.join(K,$.name),z=C(q,$.subPath);Z.track($q(z,A))}Y?.(X)})}export function installPlugin(q){const K=parseSource(q);if(!K)throw Error(`Invalid plugin source: "${q}"
+import*as a from"node:fs";import*as C from"node:os";import*as l from"node:path";import{execSync as nn,execFileSync as U}from"node:child_process";import{fileURLToPath as R}from"node:url";import{PLUGINS_DIR as y}from"./discovery.js";import{getErrorMessage as v,PluginError as h}from"./errors.js";import{log as S}from"./logger.js";import{isRecord as A}from"./utils.js";import{readPluginManifest as P,isMonorepo as D,getEnabledPlugins as tn,checkCompatibility as j,getCompatibilityRange as x}from"./plugin-manifest.js";const w=process.platform==="win32",T="local:";function B(){return process.env.HOME||process.env.USERPROFILE||C.homedir()}export function getLockFilePath(){return l.join(B(),".ppcli","plugins.lock.json")}export function getMonoreposDir(){return l.join(B(),".ppcli","monorepos")}function H(n){if(!n)return;if(n.startsWith(T))return{kind:"local",path:l.resolve(n.slice(T.length))};return{kind:"git",url:n}}function isLocalPluginSource(n){return H(n)?.kind==="local"}function toStoredPluginSource(n){if(n.kind==="local")return`${T}${l.resolve(n.path)}`;return n.url}function toLocalPluginSource(n){return toStoredPluginSource({kind:"local",path:n})}function en(n){if(!A(n))return;if(typeof n.name!=="string"||typeof n.subPath!=="string")return;return{name:n.name,subPath:n.subPath}}function rn(n,t){if(typeof n==="string"){const e=H(n);if(!e)return;if(e.kind==="git"&&t)return{kind:"monorepo",url:e.url,repoName:t.name,subPath:t.subPath};return e}if(!A(n)||typeof n.kind!=="string")return;switch(n.kind){case"git":return typeof n.url==="string"?{kind:"git",url:n.url}:void 0;case"local":return typeof n.path==="string"?{kind:"local",path:l.resolve(n.path)}:void 0;case"monorepo":return typeof n.url==="string"&&typeof n.repoName==="string"&&typeof n.subPath==="string"?{kind:"monorepo",url:n.url,repoName:n.repoName,subPath:n.subPath}:void 0;default:return}}function on(n){if(!A(n))return;const t=en(n.monorepo),e=rn(n.source,t);if(!e)return;if(typeof n.commitHash!=="string"||typeof n.installedAt!=="string")return;const i={source:e,commitHash:n.commitHash,installedAt:n.installedAt};if(typeof n.updatedAt==="string")i.updatedAt=n.updatedAt;return i}function resolvePluginSource(n,t){if(n)return n.source;return H(yn(t))}function resolveStoredPluginSource(n,t){const e=resolvePluginSource(n,t);return e?toStoredPluginSource(e):void 0}function moveDir(n,t,e=a){try{e.renameSync(n,t)}catch(i){if(i.code==="EXDEV"){try{e.cpSync(n,t,{recursive:!0})}catch(r){try{e.rmSync(t,{recursive:!0,force:!0})}catch{}throw r}e.rmSync(n,{recursive:!0,force:!0})}else throw i}}function F(n,t){const e=`${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`;return l.join(l.dirname(n),`.${l.basename(n)}.${t}-${e}`)}function sn(n){const t=l.join(C.tmpdir(),`opencli-clone-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`);try{U("git",["clone","--depth","1",n,t],{encoding:"utf-8",stdio:["pipe","pipe","pipe"]})}catch(e){throw new h(`Failed to clone plugin: ${v(e)}`,"Check the repository URL and your network connection.")}return t}function J(n,t){const e=sn(n);try{return t(e)}finally{try{a.rmSync(e,{recursive:!0,force:!0})}catch{}}}function cn(n,t){const e=resolvePluginSource(n,t);if(!e||e.kind==="local")throw Error(`Unable to determine remote source for plugin at ${t}`);return e.url}function W(n){try{a.lstatSync(n);return!0}catch{return!1}}function E(n,t){const e=l.resolve(n,t);if(!e.startsWith(n+l.sep)&&e!==n)throw new h(`Plugin path "${t}" escapes repo root.`);return e}function M(n){try{if(a.lstatSync(n).isSymbolicLink()){a.unlinkSync(n);return}a.rmSync(n,{recursive:!0,force:!0})}catch{}}class Z{#t=[];#n=!1;track(n){this.#t.push(n);return n}commit(){if(this.#n)return;this.#n=!0;for(const n of this.#t)n.finalize()}rollback(){if(this.#n)return;this.#n=!0;for(const n of[...this.#t].reverse())n.rollback()}}function G(n){const t=new Z;try{const e=n(t);t.commit();return e}catch(e){t.rollback();throw e}}function X(n,t,e=a){const i=e.existsSync(t);e.mkdirSync(l.dirname(t),{recursive:!0});const r=F(t,"tmp"),o=i?F(t,"bak"):null;let c=!1;try{moveDir(n,r,e);if(o)e.renameSync(t,o);e.renameSync(r,t)}catch(s){try{e.rmSync(r,{recursive:!0,force:!0})}catch{}if(o&&!e.existsSync(t))try{e.renameSync(o,t)}catch{}throw s}return{finalize(){if(c)return;c=!0;if(o)try{e.rmSync(o,{recursive:!0,force:!0})}catch{}},rollback(){if(c)return;c=!0;try{e.rmSync(t,{recursive:!0,force:!0})}catch{}if(o)try{e.renameSync(o,t)}catch{}try{e.rmSync(r,{recursive:!0,force:!0})}catch{}}}}function an(n,t){const e=W(t);if(e&&!isSymlinkSync(t))throw Error(`Expected monorepo plugin link at ${t} to be a symlink`);a.mkdirSync(l.dirname(t),{recursive:!0});const i=F(t,"tmp"),r=e?F(t,"bak"):null,o=w?"junction":"dir";let c=!1;try{a.symlinkSync(n,i,o);if(r)a.renameSync(t,r);a.renameSync(i,t)}catch(s){M(i);if(r&&!W(t))try{a.renameSync(r,t)}catch{}throw s}return{finalize(){if(c)return;c=!0;if(r)M(r)},rollback(){if(c)return;c=!0;M(t);if(r&&!W(t))try{a.renameSync(r,t)}catch{}M(i)}}}function readLockFileWithWriter(n=writeLockFile){try{const t=a.readFileSync(getLockFilePath(),"utf-8"),e=JSON.parse(t);if(!A(e))return{};const i={};let r=!1;for(const[o,c]of Object.entries(e)){const s=on(c);if(!s){r=!0;continue}i[o]=s;if(JSON.stringify(c)!==JSON.stringify(s))r=!0}if(r)try{n(i)}catch{}return i}catch{return{}}}export function readLockFile(){return readLockFileWithWriter(writeLockFile)}function writeLockFileWithFs(n,t=a){const e=getLockFilePath();t.mkdirSync(l.dirname(e),{recursive:!0});const i=F(e,"tmp");try{t.writeFileSync(i,JSON.stringify(n,null,2)+`
+`);t.renameSync(i,e)}catch(r){try{t.rmSync(i,{force:!0})}catch{}throw r}}export function writeLockFile(n){writeLockFileWithFs(n,a)}export function getCommitHash(n){try{return U("git",["rev-parse","HEAD"],{cwd:n,encoding:"utf-8",stdio:["pipe","pipe","pipe"]}).trim()}catch{return}}export function validatePluginStructure(n){const t=[];if(!a.existsSync(n))return{valid:!1,errors:["Plugin directory does not exist"]};const e=a.readdirSync(n),i=e.some((o)=>o.endsWith(".ts")&&!o.endsWith(".d.ts")&&!o.endsWith(".test.ts")),r=e.some((o)=>o.endsWith(".js")&&!o.endsWith(".d.js"));if(!i&&!r)t.push("No command files found in plugin directory. A plugin must contain at least one .ts or .js command file.");if(i){const o=l.join(n,"package.json");if(!a.existsSync(o))t.push('Plugin contains .ts files but no package.json. A package.json with "type": "module" and "@jackwener/opencli" peer dependency is required for TS plugins.');else try{if(JSON.parse(a.readFileSync(o,"utf-8")).type!=="module")t.push('Plugin package.json must have "type": "module" for TypeScript plugins.')}catch{t.push("Plugin package.json is malformed or invalid JSON.")}}return{valid:t.length===0,errors:t}}function ln(n){const t=l.join(n,"package.json");if(!a.existsSync(t))return!1;try{const e=JSON.parse(a.readFileSync(t,"utf-8"));return e.dependencies!=null&&Object.keys(e.dependencies).length>0}catch{return!1}}function installDependencies(n){const t=l.join(n,"package.json");if(!a.existsSync(t))return;try{U("npm",["install","--omit=dev","--ignore-scripts"],{cwd:n,encoding:"utf-8",stdio:["pipe","pipe","pipe"],...w&&{shell:!0}})}catch(e){throw new h(`npm install failed in ${n}: ${v(e)}`,"Check your network connection and npm configuration.")}}function O(n){Sn(n);kn(n)}function V(n){installDependencies(n);O(n)}function postInstallMonorepoLifecycle(n,t){installDependencies(n);for(const e of t){if(e!==n&&ln(e))installDependencies(e);O(e)}}function K(n){const t=validatePluginStructure(n);if(!t.valid)throw new h(`Invalid plugin structure:
+- ${t.errors.join(`
+- `)}`);V(n)}function L(n,t,e){n[t]={...e,installedAt:e.installedAt??new Date().toISOString()}}function Q(n,t,e){G((i)=>{i.track(X(n,t));e(getCommitHash(t))})}function Y(n,t,e,i,r){G((o)=>{if(i){a.mkdirSync(i.parentDir,{recursive:!0});o.track(X(i.stagingDir,n))}const c=getCommitHash(n);for(const s of e){const u=l.join(t,s.name),p=E(n,s.subPath);o.track(an(p,u))}r?.(c)})}export function installPlugin(n){const t=parseSource(n);if(!t)throw Error(`Invalid plugin source: "${n}"
 Supported formats:
   github:user/repo
   github:user/repo/subplugin
@@ -10,11 +10,11 @@ Supported formats:
   ssh://git@<host>/<path>/repo.git
   git@<host>:user/repo.git
   file:///absolute/path
-  /absolute/path`);const{name:Q,subPlugin:V}=K;if(K.type==="local")return installLocalPlugin(K.localPath,Q);return m(K.cloneUrl,(Y)=>{const Z=F(Y),X=M(Z);if(X&&!O(X))throw Error(`Plugin requires ppcli ${X}, but current version is incompatible.`);if(Z&&y(Z))return Aq(Y,K.cloneUrl,Q,Z,V);return Jq(Y,K.cloneUrl,Q,Z)})}function Jq(q,K,Q,V){const Y=V?.name??Q,Z=B.join(T,Y);if(J.existsSync(Z))throw new x(`Plugin "${Y}" is already installed at ${Z}`,'Use "ppcli plugin uninstall" first, or pick a different name.');l(q);r(q,Z,(X)=>{const $=readLockFile();if(X){R($,Y,{source:{kind:"git",url:K},commitHash:X});writeLockFile($)}});return Y}function installLocalPlugin(q,K){if(!J.existsSync(q))throw new x(`Local plugin path does not exist: ${q}`);if(!J.statSync(q).isDirectory())throw new x(`Local plugin path is not a directory: ${q}`);const V=F(q),Y=M(V);if(Y&&!O(Y))throw new x(`Plugin requires ppcli ${Y}, but current version is incompatible.`,"Upgrade ppcli to a compatible version.");const Z=V?.name??K,X=B.join(T,Z);if(J.existsSync(X))throw new x(`Plugin "${Z}" is already installed at ${X}`,'Use "ppcli plugin uninstall" first, or pick a different name.');const $=validatePluginStructure(q);if(!$.valid)throw new x(`Invalid plugin structure:
-- ${$.errors.join(`
-- `)}`);J.mkdirSync(T,{recursive:!0});const A=B.resolve(q),z=N?"junction":"dir";J.symlinkSync(A,X,z);installDependencies(q);g(q);const j=readLockFile(),G=getCommitHash(q);R(j,Z,{source:{kind:"local",path:A},commitHash:G??"local"});writeLockFile(j);return Z}function Bq(q,K,Q,V){const Y=J.realpathSync(K),Z=validatePluginStructure(Y);if(!Z.valid)w.warn(`Plugin "${q}" structure invalid:
-- ${Z.errors.join(`
-- `)}`);o(Y);R(Q,q,{source:V?.source??{kind:"local",path:Y},commitHash:getCommitHash(Y)??"local",installedAt:V?.installedAt??new Date().toISOString(),updatedAt:new Date().toISOString()});writeLockFile(Q)}function Aq(q,K,Q,V,Y){const Z=getMonoreposDir(),X=B.join(Z,Q),$=J.existsSync(X),A=$?X:q,z=$?F(X):V;if(!z||!y(z))throw new x(`Monorepo manifest missing or invalid at ${A}`);let j=qq(z);if(Y){j=j.filter((W)=>W.name===Y);if(j.length===0){if(z.plugins?.[Y])throw new x(`Sub-plugin "${Y}" is disabled in the manifest.`);throw new x(`Sub-plugin "${Y}" not found in monorepo. Available: ${Object.keys(z.plugins??{}).join(", ")}`)}}const G=[],I=readLockFile(),_=[];J.mkdirSync(T,{recursive:!0});for(const{name:W,entry:H}of j){const v=M(H);if(v&&!O(v)){w.warn(`Skipping "${W}": requires ppcli ${v}`);continue}let P;try{P=C(A,H.path)}catch{w.warn(`Skipping "${W}": path "${H.path}" escapes repo root.`);continue}if(!J.existsSync(P)){w.warn(`Skipping "${W}": path "${H.path}" not found in repo.`);continue}const u=validatePluginStructure(P);if(!u.valid){w.warn(`Skipping "${W}": invalid structure — ${u.errors.join(", ")}`);continue}const c=B.join(T,W);if(J.existsSync(c)){w.warn(`Skipping "${W}": already installed at ${c}`);continue}_.push({name:W,entry:H})}if(_.length===0)return G;const E=_.map(({name:W,entry:H})=>({name:W,subPath:H.path}));if($)postInstallMonorepoLifecycle(X,_.map((W)=>C(X,W.entry.path)));else postInstallMonorepoLifecycle(q,_.map((W)=>C(q,W.entry.path)));t(X,T,E,$?void 0:{stagingDir:q,parentDir:Z},(W)=>{for(const{name:H,entry:v}of _){if(W)R(I,H,{source:{kind:"monorepo",url:K,repoName:Q,subPath:v.path},commitHash:W});G.push(H)}writeLockFile(I)});return G}function zq(q,K,Q,V,Y){const Z=[];for(const[X,$]of Object.entries(K)){if($.source.kind!=="monorepo"||$.source.repoName!==q)continue;const A=Q.plugins?.[X];if(!A||A.disabled)throw Error(`Installed sub-plugin "${X}" no longer exists in ${V}`);const z=M(A);if(z&&!O(z))throw Error(`Sub-plugin "${X}" requires ppcli ${z}`);const j=C(Y,A.path),G=validatePluginStructure(j);if(!G.valid)throw Error(`Updated sub-plugin "${X}" is invalid:
-- ${G.errors.join(`
-- `)}`);Z.push({name:X,lockEntry:$,manifestEntry:A})}return Z}function jq(q,K,Q,V,Y){for(const Z of K){if(!Y)continue;R(q,Z.name,{...Z.lockEntry,source:{kind:"monorepo",url:Q,repoName:V,subPath:Z.manifestEntry.path},commitHash:Y,updatedAt:new Date().toISOString()})}}function Wq(q,K,Q,V,Y){if(!Y)return;R(q,K,{source:{kind:"git",url:Q},commitHash:Y,installedAt:V?.installedAt??new Date().toISOString(),updatedAt:new Date().toISOString()})}export function uninstallPlugin(q){const K=B.join(T,q);if(!D(K))throw Error(`Plugin "${q}" is not installed.`);const Q=readLockFile(),V=Q[q];if(isSymlinkSync(K))J.unlinkSync(K);else J.rmSync(K,{recursive:!0,force:!0});if(V?.source.kind==="monorepo"){delete Q[q];const Z=V.source.repoName;if(!Object.values(Q).some(($)=>$.source.kind==="monorepo"&&$.source.repoName===Z)){const $=B.join(getMonoreposDir(),Z);try{J.rmSync($,{recursive:!0,force:!0})}catch{}}}else if(Q[q])delete Q[q];writeLockFile(Q)}function isSymlinkSync(q){try{return J.lstatSync(q).isSymbolicLink()}catch{return!1}}export function updatePlugin(q){const K=B.join(T,q);if(!J.existsSync(K))throw Error(`Plugin "${q}" is not installed.`);const Q=readLockFile(),V=Q[q],Y=resolvePluginSource(V,K);if(Y?.kind==="local"){Bq(q,K,Q,V);return}if(Y?.kind==="monorepo"){const X=B.join(getMonoreposDir(),Y.repoName),$=Y.repoName,A=Y.url;m(A,(z)=>{const j=F(z);if(!j||!y(j))throw Error(`Updated source is no longer a monorepo: ${A}`);const G=M(j);if(G&&!O(G))throw Error(`Plugin requires ppcli ${G}, but current version is incompatible.`);const I=zq($,Q,j,A,z);if(I.length>0)postInstallMonorepoLifecycle(z,I.map((_)=>C(z,_.manifestEntry.path)));t(X,T,I.map((_)=>({name:_.name,subPath:_.manifestEntry.path})),{stagingDir:z,parentDir:B.dirname(X)},(_)=>{jq(Q,I,A,$,_);writeLockFile(Q)})});return}const Z=Zq(V,K);m(Z,(X)=>{const $=F(X);if($&&y($))throw Error(`Updated source is now a monorepo: ${Z}`);const A=M($);if(A&&!O(A))throw Error(`Plugin requires ppcli ${A}, but current version is incompatible.`);l(X);r(X,K,(z)=>{Wq(Q,q,Z,Q[q],z);if(z)writeLockFile(Q)})})}export function updateAllPlugins(){return listPlugins().map((q)=>{try{updatePlugin(q.name);return{name:q.name,success:!0}}catch(K){return{name:q.name,success:!1,error:U(K)}}})}export function listPlugins(){if(!J.existsSync(T))return[];const q=J.readdirSync(T,{withFileTypes:!0}),K=readLockFile(),Q=[];for(const V of q){const Y=B.join(T,V.name);if(!(V.isDirectory()||isSymlinkSync(Y)))continue;const X=Gq(Y),$=K[V.name],A=F(Y);let z=A?.description,j=A?.version;if($?.source.kind==="monorepo"&&!z){const I=B.join(getMonoreposDir(),$.source.repoName),E=F(I)?.plugins?.[V.name];if(E){z=z??E.description;j=j??E.version}}const G=resolveStoredPluginSource($,Y);Q.push({name:V.name,path:Y,commands:X,source:G,version:j??$?.commitHash?.slice(0,7),installedAt:$?.installedAt,monorepoName:$?.source.kind==="monorepo"?$.source.repoName:void 0,description:z})}return Q}function Gq(q){try{const K=J.readdirSync(q);return[...new Set(K.filter((V)=>V.endsWith(".ts")&&!V.endsWith(".d.ts")&&!V.endsWith(".test.ts")||V.endsWith(".js")&&!V.endsWith(".d.js")).map((V)=>B.basename(V,B.extname(V))))]}catch{return[]}}function _q(q){try{return S("git",["config","--get","remote.origin.url"],{cwd:q,encoding:"utf-8",stdio:["pipe","pipe","pipe"]}).trim()}catch{return}}function parseSource(q){if(q.startsWith("file://"))try{const $=B.resolve(k(q));return{type:"local",localPath:$,name:B.basename($).replace(/^opencli-plugin-/,"")}}catch{return null}if(B.isAbsolute(q)){const $=B.resolve(q);return{type:"local",localPath:$,name:B.basename($).replace(/^opencli-plugin-/,"")}}const K=q.match(/^github:([\w.-]+)\/([\w.-]+)\/([\w.-]+)$/);if(K){const[,$,A,z]=K,j=A.replace(/^opencli-plugin-/,"");return{type:"git",cloneUrl:`https://github.com/${$}/${A}.git`,name:j,subPlugin:z}}const Q=q.match(/^github:([\w.-]+)\/([\w.-]+)$/);if(Q){const[,$,A]=Q,z=A.replace(/^opencli-plugin-/,"");return{type:"git",cloneUrl:`https://github.com/${$}/${A}.git`,name:z}}const V=q.match(/^https?:\/\/github\.com\/([\w.-]+)\/([\w.-]+?)(?:\.git)?$/);if(V){const[,$,A]=V,z=A.replace(/^opencli-plugin-/,"");return{type:"git",cloneUrl:`https://github.com/${$}/${A}.git`,name:z}}const Y=q.match(/^ssh:\/\/[^/]+\/(.*?)(?:\.git)?$/);if(Y){const j=Y[1].split("/").pop().replace(/^opencli-plugin-/,"");return{type:"git",cloneUrl:q,name:j}}const Z=q.match(/^git@[^:]+:(.+?)(?:\.git)?$/);if(Z){const j=Z[1].split("/").pop().replace(/^opencli-plugin-/,"");return{type:"git",cloneUrl:q,name:j}}const X=q.match(/^https?:\/\/[^/]+\/(.+?)(?:\.git)?$/);if(X){const j=X[1].split("/").pop().replace(/^opencli-plugin-/,"");return{type:"git",cloneUrl:q.endsWith(".git")?q:`${q}.git`,name:j}}return null}function xq(q){try{const K=resolveHostOpencliRoot(),Q=B.join(q,"node_modules","@jackwener","opencli");if(J.existsSync(Q))J.rmSync(Q,{recursive:!0,force:!0});J.mkdirSync(B.dirname(Q),{recursive:!0});const V=N?"junction":"dir";J.symlinkSync(K,Q,V);w.debug(`Linked host ppcli into plugin: ${Q} → ${K}`)}catch(K){w.warn(`Failed to link host ppcli into plugin: ${U(K)}`)}}export function resolveEsbuildBin(){const q=resolveHostOpencliRoot();if(N){const Q=B.join(q,"node_modules",".bin","esbuild.cmd");if(J.existsSync(Q))return Q}if(!N)try{const Q=import.meta.resolve("esbuild/package.json");if(Q.startsWith("file://")){const V=k(Q),Y=J.readFileSync(V,"utf8"),Z=JSON.parse(Y);if(Z.bin&&typeof Z.bin==="object"&&Z.bin.esbuild){const X=B.resolve(B.dirname(V),Z.bin.esbuild);if(J.existsSync(X))return X}else if(typeof Z.bin==="string"){const X=B.resolve(B.dirname(V),Z.bin);if(J.existsSync(X))return X}}}catch{}const K=B.join(q,"node_modules",".bin","esbuild");if(J.existsSync(K))return K;try{const V=e(N?"where esbuild":"which esbuild",{encoding:"utf-8",stdio:"pipe"}).trim().split(`
-`)[0].trim();if(V&&J.existsSync(V))return V}catch{}return null}function resolveHostOpencliRoot(q=k(import.meta.url)){let K=B.dirname(q);while(!0){const Q=B.join(K,"package.json");if(J.existsSync(Q))try{if(JSON.parse(J.readFileSync(Q,"utf-8"))?.name==="@jackwener/opencli")return K}catch{}const V=B.dirname(K);if(V===K)break;K=V}return B.resolve(B.dirname(q),"..")}function Tq(q){try{const K=resolveEsbuildBin();if(!K){w.warn("esbuild not found. TS plugin files will not be transpiled and may fail to load. Install esbuild (`npm i -g esbuild`) or ensure it is available in the ppcli host node_modules.");return}const V=J.readdirSync(q).filter((Y)=>Y.endsWith(".ts")&&!Y.endsWith(".d.ts")&&!Y.endsWith(".test.ts"));for(const Y of V){const Z=Y.replace(/\.ts$/,".js"),X=B.join(q,Z);if(J.existsSync(X))continue;try{S(K,[Y,`--outfile=${Z}`,"--format=esm","--platform=node"],{cwd:q,encoding:"utf-8",stdio:["pipe","pipe","pipe"],...N&&{shell:!0}});w.debug(`Transpiled plugin file: ${Y} → ${Z}`)}catch($){w.warn(`Failed to transpile ${Y}: ${U($)}`)}}}catch(K){w.warn(`TS transpilation setup failed: ${U(K)}`)}}export{resolveHostOpencliRoot as _resolveHostOpencliRoot,resolveEsbuildBin as _resolveEsbuildBin,getCommitHash as _getCommitHash,installDependencies as _installDependencies,parseSource as _parseSource,postInstallMonorepoLifecycle as _postInstallMonorepoLifecycle,readLockFile as _readLockFile,readLockFileWithWriter as _readLockFileWithWriter,updateAllPlugins as _updateAllPlugins,validatePluginStructure as _validatePluginStructure,writeLockFile as _writeLockFile,writeLockFileWithFs as _writeLockFileWithFs,isSymlinkSync as _isSymlinkSync,getMonoreposDir as _getMonoreposDir,installLocalPlugin as _installLocalPlugin,isLocalPluginSource as _isLocalPluginSource,moveDir as _moveDir,resolvePluginSource as _resolvePluginSource,resolveStoredPluginSource as _resolveStoredPluginSource,toStoredPluginSource as _toStoredPluginSource,toLocalPluginSource as _toLocalPluginSource};
+  /absolute/path`);const{name:e,subPlugin:i}=t;if(t.type==="local")return installLocalPlugin(t.localPath,e);return J(t.cloneUrl,(r)=>{const o=P(r),c=x(o);if(c&&!j(c))throw Error(`Plugin requires ppcli ${c}, but current version is incompatible.`);if(o&&D(o))return dn(r,t.cloneUrl,e,o,i);return un(r,t.cloneUrl,e,o)})}function un(n,t,e,i){const r=i?.name??e,o=l.join(y,r);if(a.existsSync(o))throw new h(`Plugin "${r}" is already installed at ${o}`,'Use "ppcli plugin uninstall" first, or pick a different name.');K(n);Q(n,o,(c)=>{const s=readLockFile();if(c){L(s,r,{source:{kind:"git",url:t},commitHash:c});writeLockFile(s)}});return r}function installLocalPlugin(n,t){if(!a.existsSync(n))throw new h(`Local plugin path does not exist: ${n}`);if(!a.statSync(n).isDirectory())throw new h(`Local plugin path is not a directory: ${n}`);const i=P(n),r=x(i);if(r&&!j(r))throw new h(`Plugin requires ppcli ${r}, but current version is incompatible.`,"Upgrade ppcli to a compatible version.");const o=i?.name??t,c=l.join(y,o);if(a.existsSync(c))throw new h(`Plugin "${o}" is already installed at ${c}`,'Use "ppcli plugin uninstall" first, or pick a different name.');const s=validatePluginStructure(n);if(!s.valid)throw new h(`Invalid plugin structure:
+- ${s.errors.join(`
+- `)}`);a.mkdirSync(y,{recursive:!0});const u=l.resolve(n),p=w?"junction":"dir";a.symlinkSync(u,c,p);installDependencies(n);O(n);const d=readLockFile(),m=getCommitHash(n);L(d,o,{source:{kind:"local",path:u},commitHash:m??"local"});writeLockFile(d);return o}function pn(n,t,e,i){const r=a.realpathSync(t),o=validatePluginStructure(r);if(!o.valid)S.warn(`Plugin "${n}" structure invalid:
+- ${o.errors.join(`
+- `)}`);V(r);L(e,n,{source:i?.source??{kind:"local",path:r},commitHash:getCommitHash(r)??"local",installedAt:i?.installedAt??new Date().toISOString(),updatedAt:new Date().toISOString()});writeLockFile(e)}function dn(n,t,e,i,r){const o=getMonoreposDir(),c=l.join(o,e),s=a.existsSync(c),u=s?c:n,p=s?P(c):i;if(!p||!D(p))throw new h(`Monorepo manifest missing or invalid at ${u}`);let d=tn(p);if(r){d=d.filter((f)=>f.name===r);if(d.length===0){if(p.plugins?.[r])throw new h(`Sub-plugin "${r}" is disabled in the manifest.`);throw new h(`Sub-plugin "${r}" not found in monorepo. Available: ${Object.keys(p.plugins??{}).join(", ")}`)}}const m=[],b=readLockFile(),g=[];a.mkdirSync(y,{recursive:!0});for(const{name:f,entry:k}of d){const _=x(k);if(_&&!j(_)){S.warn(`Skipping "${f}": requires ppcli ${_}`);continue}let I;try{I=E(u,k.path)}catch{S.warn(`Skipping "${f}": path "${k.path}" escapes repo root.`);continue}if(!a.existsSync(I)){S.warn(`Skipping "${f}": path "${k.path}" not found in repo.`);continue}const z=validatePluginStructure(I);if(!z.valid){S.warn(`Skipping "${f}": invalid structure — ${z.errors.join(", ")}`);continue}const q=l.join(y,f);if(a.existsSync(q)){S.warn(`Skipping "${f}": already installed at ${q}`);continue}g.push({name:f,entry:k})}if(g.length===0)return m;const N=g.map(({name:f,entry:k})=>({name:f,subPath:k.path}));if(s)postInstallMonorepoLifecycle(c,g.map((f)=>E(c,f.entry.path)));else postInstallMonorepoLifecycle(n,g.map((f)=>E(n,f.entry.path)));Y(c,y,N,s?void 0:{stagingDir:n,parentDir:o},(f)=>{for(const{name:k,entry:_}of g){if(f)L(b,k,{source:{kind:"monorepo",url:t,repoName:e,subPath:_.path},commitHash:f});m.push(k)}writeLockFile(b)});return m}function fn(n,t,e,i,r){const o=[];for(const[c,s]of Object.entries(t)){if(s.source.kind!=="monorepo"||s.source.repoName!==n)continue;const u=e.plugins?.[c];if(!u||u.disabled)throw Error(`Installed sub-plugin "${c}" no longer exists in ${i}`);const p=x(u);if(p&&!j(p))throw Error(`Sub-plugin "${c}" requires ppcli ${p}`);const d=E(r,u.path),m=validatePluginStructure(d);if(!m.valid)throw Error(`Updated sub-plugin "${c}" is invalid:
+- ${m.errors.join(`
+- `)}`);o.push({name:c,lockEntry:s,manifestEntry:u})}return o}function mn(n,t,e,i,r){for(const o of t){if(!r)continue;L(n,o.name,{...o.lockEntry,source:{kind:"monorepo",url:e,repoName:i,subPath:o.manifestEntry.path},commitHash:r,updatedAt:new Date().toISOString()})}}function gn(n,t,e,i,r){if(!r)return;L(n,t,{source:{kind:"git",url:e},commitHash:r,installedAt:i?.installedAt??new Date().toISOString(),updatedAt:new Date().toISOString()})}export function uninstallPlugin(n){const t=l.join(y,n);if(!W(t))throw Error(`Plugin "${n}" is not installed.`);const e=readLockFile(),i=e[n];if(isSymlinkSync(t))a.unlinkSync(t);else a.rmSync(t,{recursive:!0,force:!0});if(i?.source.kind==="monorepo"){delete e[n];const o=i.source.repoName;if(!Object.values(e).some((s)=>s.source.kind==="monorepo"&&s.source.repoName===o)){const s=l.join(getMonoreposDir(),o);try{a.rmSync(s,{recursive:!0,force:!0})}catch{}}}else if(e[n])delete e[n];writeLockFile(e)}function isSymlinkSync(n){try{return a.lstatSync(n).isSymbolicLink()}catch{return!1}}export function updatePlugin(n){const t=l.join(y,n);if(!a.existsSync(t))throw Error(`Plugin "${n}" is not installed.`);const e=readLockFile(),i=e[n],r=resolvePluginSource(i,t);if(r?.kind==="local"){pn(n,t,e,i);return}if(r?.kind==="monorepo"){const c=l.join(getMonoreposDir(),r.repoName),s=r.repoName,u=r.url;J(u,(p)=>{const d=P(p);if(!d||!D(d))throw Error(`Updated source is no longer a monorepo: ${u}`);const m=x(d);if(m&&!j(m))throw Error(`Plugin requires ppcli ${m}, but current version is incompatible.`);const b=fn(s,e,d,u,p);if(b.length>0)postInstallMonorepoLifecycle(p,b.map((g)=>E(p,g.manifestEntry.path)));Y(c,y,b.map((g)=>({name:g.name,subPath:g.manifestEntry.path})),{stagingDir:p,parentDir:l.dirname(c)},(g)=>{mn(e,b,u,s,g);writeLockFile(e)})});return}const o=cn(i,t);J(o,(c)=>{const s=P(c);if(s&&D(s))throw Error(`Updated source is now a monorepo: ${o}`);const u=x(s);if(u&&!j(u))throw Error(`Plugin requires ppcli ${u}, but current version is incompatible.`);K(c);Q(c,t,(p)=>{gn(e,n,o,e[n],p);if(p)writeLockFile(e)})})}export function updateAllPlugins(){return listPlugins().map((n)=>{try{updatePlugin(n.name);return{name:n.name,success:!0}}catch(t){return{name:n.name,success:!1,error:v(t)}}})}export function listPlugins(){if(!a.existsSync(y))return[];const n=a.readdirSync(y,{withFileTypes:!0}),t=readLockFile(),e=[];for(const i of n){const r=l.join(y,i.name);if(!(i.isDirectory()||isSymlinkSync(r)))continue;const c=hn(r),s=t[i.name],u=P(r);let p=u?.description,d=u?.version;if(s?.source.kind==="monorepo"&&!p){const b=l.join(getMonoreposDir(),s.source.repoName),N=P(b)?.plugins?.[i.name];if(N){p=p??N.description;d=d??N.version}}const m=resolveStoredPluginSource(s,r);e.push({name:i.name,path:r,commands:c,source:m,version:d??s?.commitHash?.slice(0,7),installedAt:s?.installedAt,monorepoName:s?.source.kind==="monorepo"?s.source.repoName:void 0,description:p})}return e}function hn(n){try{const t=a.readdirSync(n);return[...new Set(t.filter((i)=>i.endsWith(".ts")&&!i.endsWith(".d.ts")&&!i.endsWith(".test.ts")||i.endsWith(".js")&&!i.endsWith(".d.js")).map((i)=>l.basename(i,l.extname(i))))]}catch{return[]}}function yn(n){try{return U("git",["config","--get","remote.origin.url"],{cwd:n,encoding:"utf-8",stdio:["pipe","pipe","pipe"]}).trim()}catch{return}}function parseSource(n){if(n.startsWith("file://"))try{const s=l.resolve(R(n));return{type:"local",localPath:s,name:l.basename(s).replace(/^opencli-plugin-/,"")}}catch{return null}if(l.isAbsolute(n)){const s=l.resolve(n);return{type:"local",localPath:s,name:l.basename(s).replace(/^opencli-plugin-/,"")}}const t=n.match(/^github:([\w.-]+)\/([\w.-]+)\/([\w.-]+)$/);if(t){const[,s,u,p]=t,d=u.replace(/^opencli-plugin-/,"");return{type:"git",cloneUrl:`https://github.com/${s}/${u}.git`,name:d,subPlugin:p}}const e=n.match(/^github:([\w.-]+)\/([\w.-]+)$/);if(e){const[,s,u]=e,p=u.replace(/^opencli-plugin-/,"");return{type:"git",cloneUrl:`https://github.com/${s}/${u}.git`,name:p}}const i=n.match(/^https?:\/\/github\.com\/([\w.-]+)\/([\w.-]+?)(?:\.git)?$/);if(i){const[,s,u]=i,p=u.replace(/^opencli-plugin-/,"");return{type:"git",cloneUrl:`https://github.com/${s}/${u}.git`,name:p}}const r=n.match(/^ssh:\/\/[^/]+\/(.*?)(?:\.git)?$/);if(r){const d=r[1].split("/").pop().replace(/^opencli-plugin-/,"");return{type:"git",cloneUrl:n,name:d}}const o=n.match(/^git@[^:]+:(.+?)(?:\.git)?$/);if(o){const d=o[1].split("/").pop().replace(/^opencli-plugin-/,"");return{type:"git",cloneUrl:n,name:d}}const c=n.match(/^https?:\/\/[^/]+\/(.+?)(?:\.git)?$/);if(c){const d=c[1].split("/").pop().replace(/^opencli-plugin-/,"");return{type:"git",cloneUrl:n.endsWith(".git")?n:`${n}.git`,name:d}}return null}function Sn(n){try{const t=resolveHostOpencliRoot(),e=l.join(n,"node_modules","@jackwener","opencli");if(a.existsSync(e))a.rmSync(e,{recursive:!0,force:!0});a.mkdirSync(l.dirname(e),{recursive:!0});const i=w?"junction":"dir";a.symlinkSync(t,e,i);S.debug(`Linked host ppcli into plugin: ${e} → ${t}`)}catch(t){S.warn(`Failed to link host ppcli into plugin: ${v(t)}`)}}export function resolveEsbuildBin(){const n=resolveHostOpencliRoot();if(w){const e=l.join(n,"node_modules",".bin","esbuild.cmd");if(a.existsSync(e))return e}if(!w)try{const e=import.meta.resolve("esbuild/package.json");if(e.startsWith("file://")){const i=R(e),r=a.readFileSync(i,"utf8"),o=JSON.parse(r);if(o.bin&&typeof o.bin==="object"&&o.bin.esbuild){const c=l.resolve(l.dirname(i),o.bin.esbuild);if(a.existsSync(c))return c}else if(typeof o.bin==="string"){const c=l.resolve(l.dirname(i),o.bin);if(a.existsSync(c))return c}}}catch{}const t=l.join(n,"node_modules",".bin","esbuild");if(a.existsSync(t))return t;try{const i=nn(w?"where esbuild":"which esbuild",{encoding:"utf-8",stdio:"pipe"}).trim().split(`
+`)[0].trim();if(i&&a.existsSync(i))return i}catch{}return null}function resolveHostOpencliRoot(n=R(import.meta.url)){let t=l.dirname(n);while(!0){const e=l.join(t,"package.json");if(a.existsSync(e))try{if(JSON.parse(a.readFileSync(e,"utf-8"))?.name==="@jackwener/opencli")return t}catch{}const i=l.dirname(t);if(i===t)break;t=i}return l.resolve(l.dirname(n),"..")}function kn(n){try{const t=resolveEsbuildBin();if(!t){S.warn("esbuild not found. TS plugin files will not be transpiled and may fail to load. Install esbuild (`npm i -g esbuild`) or ensure it is available in the ppcli host node_modules.");return}const i=a.readdirSync(n).filter((r)=>r.endsWith(".ts")&&!r.endsWith(".d.ts")&&!r.endsWith(".test.ts"));for(const r of i){const o=r.replace(/\.ts$/,".js"),c=l.join(n,o);if(a.existsSync(c))continue;try{U(t,[r,`--outfile=${o}`,"--format=esm","--platform=node"],{cwd:n,encoding:"utf-8",stdio:["pipe","pipe","pipe"],...w&&{shell:!0}});S.debug(`Transpiled plugin file: ${r} → ${o}`)}catch(s){S.warn(`Failed to transpile ${r}: ${v(s)}`)}}}catch(t){S.warn(`TS transpilation setup failed: ${v(t)}`)}}export{resolveHostOpencliRoot as _resolveHostOpencliRoot,resolveEsbuildBin as _resolveEsbuildBin,getCommitHash as _getCommitHash,installDependencies as _installDependencies,parseSource as _parseSource,postInstallMonorepoLifecycle as _postInstallMonorepoLifecycle,readLockFile as _readLockFile,readLockFileWithWriter as _readLockFileWithWriter,updateAllPlugins as _updateAllPlugins,validatePluginStructure as _validatePluginStructure,writeLockFile as _writeLockFile,writeLockFileWithFs as _writeLockFileWithFs,isSymlinkSync as _isSymlinkSync,getMonoreposDir as _getMonoreposDir,installLocalPlugin as _installLocalPlugin,isLocalPluginSource as _isLocalPluginSource,moveDir as _moveDir,resolvePluginSource as _resolvePluginSource,resolveStoredPluginSource as _resolveStoredPluginSource,toStoredPluginSource as _toStoredPluginSource,toLocalPluginSource as _toLocalPluginSource};

package/dist/src/rate-limit.js

@@ -1,2 +1,2 @@
-import*as m from"node:fs";import*as p from"node:os";import*as f from"node:path";import $ from"js-yaml";import{ConfigError as s,RateLimitError as v,getErrorMessage as S}from"./errors.js";import{isRecord as l}from"./utils.js";const g="rate-limits.yaml",x="rate-limit-state.json";export function getRateLimitConfigPath(t=p.homedir()){return f.join(t,".ppcli",g)}export function getRateLimitStatePath(t=p.homedir()){return f.join(t,".ppcli",x)}export function enforceRateLimit(t,e={}){const r=e.configPath??getRateLimitConfigPath(),n=findRateLimitRule(t,r);if(!n)return;const o=e.statePath??getRateLimitStatePath(),i=e.now??Date.now(),a=M(o),c=Array.isArray(a.commands[t])?a.commands[t]:[],h=i-n.windowMs,u=c.filter((d)=>Number.isFinite(d)&&d>h);if(u.length>=n.limit){const d=Math.min(...u),b=Math.max(0,d+n.windowMs-i);a.commands[t]=u;y(o,a);throw new v(t,b,r)}a.commands[t]=[...u,i];y(o,a)}export function findRateLimitRule(t,e=getRateLimitConfigPath()){return loadRateLimitRules(e).find((n)=>n.command===t)??null}export function loadRateLimitRules(t=getRateLimitConfigPath()){if(!m.existsSync(t))return[];let e;try{e=$.load(m.readFileSync(t,"utf-8"))??{}}catch(n){throw new s(`Failed to parse ${t}: ${S(n)}`,"Fix the YAML syntax or remove the file to disable command rate limits.")}if(!l(e))throw new s(`Invalid ${t}: root value must be an object with a rules array.`);const r=e.rules;if(r===void 0)return[];if(!Array.isArray(r))throw new s(`Invalid ${t}: rules must be an array.`);return r.map((n,o)=>F(n,o,t))}function F(t,e,r){const n=`${r} rules[${e}]`;if(!l(t))throw new s(`Invalid ${n}: rule must be an object.`);const o=typeof t.command==="string"?t.command.trim():"";if(!o)throw new s(`Invalid ${n}: command must be a non-empty string.`);const i=Number(t.limit);if(!Number.isInteger(i)||i<=0)throw new s(`Invalid ${n}: limit must be a positive integer.`);if(typeof t.window!=="string"&&typeof t.window!=="number")throw new s(`Invalid ${n}: window must be a duration like 10m, 1h, or 500ms.`);return{command:o,limit:i,windowMs:I(t.window,`${n}.window`)}}function I(t,e){const r=String(t).trim(),n=/^(\d+(?:\.\d+)?)(ms|s|m|h)?$/.exec(r);if(!n)throw new s(`Invalid ${e}: expected a duration like 10m, 1h, or 500ms.`);const o=Number.parseFloat(n[1]),i=n[2]??"ms",c=Math.round(o*(i==="h"?3600000:i==="m"?60000:i==="s"?1000:1));if(!Number.isFinite(c)||c<=0)throw new s(`Invalid ${e}: duration must be greater than zero.`);return c}function M(t){if(!m.existsSync(t))return w();try{const e=JSON.parse(m.readFileSync(t,"utf-8"));if(!l(e)||!l(e.commands))return w();const r={};for(const[n,o]of Object.entries(e.commands)){if(!Array.isArray(o))continue;r[n]=o.filter((i)=>typeof i==="number"&&Number.isFinite(i))}return{version:1,commands:r}}catch{return w()}}function y(t,e){m.mkdirSync(f.dirname(t),{recursive:!0});const r=`${t}.${process.pid}.${Date.now()}.tmp`;m.writeFileSync(r,JSON.stringify(e,null,2)+`
+import*as m from"node:fs";import*as p from"node:os";import*as f from"node:path";import v from"js-yaml";import{ConfigError as s,RateLimitError as S,getErrorMessage as g}from"./errors.js";import{isRecord as l}from"./utils.js";const x="rate-limits.yaml",F="rate-limit-state.json";export function getRateLimitConfigPath(t=p.homedir()){return f.join(t,".ppcli",x)}export function getRateLimitStatePath(t=p.homedir()){return f.join(t,".ppcli",F)}export function enforceRateLimit(t,e={}){const r=e.configPath??getRateLimitConfigPath(),n=findRateLimitRule(t,r);if(!n)return;const o=e.statePath??getRateLimitStatePath(),i=e.now??Date.now(),a=A(o),c=Array.isArray(a.commands[t])?a.commands[t]:[],h=i-n.windowMs,u=c.filter((d)=>Number.isFinite(d)&&d>h);if(u.length>=n.limit){const d=Math.min(...u),b=Math.max(0,d+n.windowMs-i);a.commands[t]=u;y(o,a);throw new S(t,b,r)}a.commands[t]=[...u,i];y(o,a)}export function findRateLimitRule(t,e=getRateLimitConfigPath()){return loadRateLimitRules(e).find((n)=>n.command===t)??null}export function loadRateLimitRules(t=getRateLimitConfigPath()){if(!m.existsSync(t))return[];let e;try{e=v.load(m.readFileSync(t,"utf-8"))??{}}catch(n){throw new s(`Failed to parse ${t}: ${g(n)}`,"Fix the YAML syntax or remove the file to disable command rate limits.")}if(!l(e))throw new s(`Invalid ${t}: root value must be an object with a rules array.`);const r=e.rules;if(r===void 0)return[];if(!Array.isArray(r))throw new s(`Invalid ${t}: rules must be an array.`);return r.map((n,o)=>I(n,o,t))}function I(t,e,r){const n=`${r} rules[${e}]`;if(!l(t))throw new s(`Invalid ${n}: rule must be an object.`);const o=typeof t.command==="string"?t.command.trim():"";if(!o)throw new s(`Invalid ${n}: command must be a non-empty string.`);const i=Number(t.limit);if(!Number.isInteger(i)||i<=0)throw new s(`Invalid ${n}: limit must be a positive integer.`);if(typeof t.window!=="string"&&typeof t.window!=="number")throw new s(`Invalid ${n}: window must be a duration like 10m, 1h, or 500ms.`);return{command:o,limit:i,windowMs:M(t.window,`${n}.window`)}}function M(t,e){const r=String(t).trim(),n=/^(\d+(?:\.\d+)?)(ms|s|m|h)?$/.exec(r);if(!n)throw new s(`Invalid ${e}: expected a duration like 10m, 1h, or 500ms.`);const o=Number.parseFloat(n[1]),i=n[2]??"ms",c=Math.round(o*(i==="h"?3600000:i==="m"?60000:i==="s"?1000:1));if(!Number.isFinite(c)||c<=0)throw new s(`Invalid ${e}: duration must be greater than zero.`);return c}function A(t){if(!m.existsSync(t))return w();try{const e=JSON.parse(m.readFileSync(t,"utf-8"));if(!l(e)||!l(e.commands))return w();const r={};for(const[n,o]of Object.entries(e.commands)){if(!Array.isArray(o))continue;r[n]=o.filter((i)=>typeof i==="number"&&Number.isFinite(i))}return{version:1,commands:r}}catch{return w()}}function y(t,e){m.mkdirSync(f.dirname(t),{recursive:!0});const r=`${t}.${process.pid}.${Date.now()}.tmp`;m.writeFileSync(r,JSON.stringify(e,null,2)+`
 `,"utf-8");m.renameSync(r,t)}function w(){return{version:1,commands:{}}}

package/dist/src/registry.js

@@ -1 +1 @@
-export var Strategy;(function(j){j.PUBLIC="public";j.LOCAL="local";j.COOKIE="cookie";j.INTERCEPT="intercept";j.UI="ui"})(Strategy||(Strategy={}));const J=globalThis.__opencli_registry__??=new Map;export function cli(j){const q={site:j.site,name:j.name,aliases:j.aliases,description:j.description??"",access:j.access,example:j.example,domain:j.domain,strategy:j.strategy,browser:j.browser,args:j.args??[],columns:j.columns,func:j.func,pipeline:j.pipeline,footerExtra:j.footerExtra,validateArgs:j.validateArgs,navigateBefore:j.navigateBefore,siteSession:j.siteSession,defaultWindowMode:j.defaultWindowMode,defaultFormat:j.defaultFormat,authStatus:j.authStatus};registerCommand(q);return J.get(fullName(q))}export function getRegistry(){return J}export function fullName(j){return`${j.site}/${j.name}`}export function strategyLabel(j){return j.strategy??Strategy.PUBLIC}function M(j){const q=j.args.filter((I)=>I.fromFile);if(q.length===0)return;const G=`${j.site}/${j.name}`;if(q.length>1)throw Error(`Command ${G}: 只能有一个 fromFile 参数，当前有 ${q.map((I)=>I.name).join(", ")}`);const D=q[0],H=typeof D.fromFile==="string"?D.fromFile:"file",E=j.args.find((I)=>I.name===H);if(E){if(E.generatedFileFor===D.name)return;throw Error(`Command ${G}: fromFile 想生成的 --${H} 与已有参数重名；`+`给 ${D.name} 的 fromFile 指定别的名字（如 '${D.name}-file'）`)}const L=D.positional?`<${D.name}>`:`--${D.name}`;j.args=j.args.map((I)=>I===D?{...I,required:!1,requiredUnlessFile:I.required===!0}:I);j.args.push({name:H,generatedFileFor:D.name,help:`从本机文件读取${D.name}（UTF-8），与 ${L} 二选一。`+"长正文建议走文件：命令行上只剩短参数，不受 shell 引号 / 换行 / 编码影响"})}function O(j){Q(j);R(j);M(j);const q=j.strategy??(j.browser===!1?Strategy.PUBLIC:Strategy.COOKIE),G=j.browser??(q!==Strategy.PUBLIC&&q!==Strategy.LOCAL);let D=j.navigateBefore;if(D===void 0){if(q===Strategy.COOKIE&&j.domain)D=`https://${j.domain}`;else if(q!==Strategy.PUBLIC&&q!==Strategy.LOCAL)D=!0}return G?{...j,strategy:q,browser:!0,navigateBefore:D}:{...j,strategy:q,browser:!1,navigateBefore:D}}function Q(j){if(j.access==="read"||j.access==="write")return;const q=`${j.site}/${j.name}`;throw Error(`Command ${q} must declare access: 'read' | 'write'`)}function R(j){if(j.siteSession===void 0)return;const q=`${j.site}/${j.name}`;if(j.siteSession!=="ephemeral"&&j.siteSession!=="persistent")throw Error(`Command ${q} siteSession must be one of: ephemeral, persistent`)}export function registerCommand(j){const q=O(j),G=fullName(q),D=J.get(G);if(D?.aliases)for(const E of D.aliases)J.delete(`${D.site}/${E}`);const H=T(q.aliases,q.name);q.aliases=H.length>0?H:void 0;J.set(G,q);for(const E of H)J.set(`${q.site}/${E}`,q)}function T(j,q){if(!Array.isArray(j)||j.length===0)return[];const G=new Set,D=[];for(const H of j){const E=typeof H==="string"?H.trim():"";if(!E||E===q||G.has(E))continue;G.add(E);D.push(E)}return D}
+export var Strategy;(function(e){e.PUBLIC="public";e.LOCAL="local";e.COOKIE="cookie";e.INTERCEPT="intercept";e.UI="ui"})(Strategy||(Strategy={}));const o=globalThis.__opencli_registry__??=new Map;export function cli(e){const n={site:e.site,name:e.name,aliases:e.aliases,description:e.description??"",access:e.access,example:e.example,domain:e.domain,strategy:e.strategy,browser:e.browser,args:e.args??[],columns:e.columns,func:e.func,pipeline:e.pipeline,footerExtra:e.footerExtra,validateArgs:e.validateArgs,navigateBefore:e.navigateBefore,siteSession:e.siteSession,defaultWindowMode:e.defaultWindowMode,defaultFormat:e.defaultFormat,authStatus:e.authStatus};registerCommand(n);return o.get(fullName(n))}export function getRegistry(){return o}export function fullName(e){return`${e.site}/${e.name}`}export function strategyLabel(e){return e.strategy??Strategy.PUBLIC}function f(e){const n=e.args.filter((a)=>a.fromFile);if(n.length===0)return;const t=`${e.site}/${e.name}`;if(n.length>1)throw Error(`Command ${t}: 只能有一个 fromFile 参数，当前有 ${n.map((a)=>a.name).join(", ")}`);const r=n[0],s=typeof r.fromFile==="string"?r.fromFile:"file",i=e.args.find((a)=>a.name===s);if(i){if(i.generatedFileFor===r.name)return;throw Error(`Command ${t}: fromFile 想生成的 --${s} 与已有参数重名；`+`给 ${r.name} 的 fromFile 指定别的名字（如 '${r.name}-file'）`)}const l=r.positional?`<${r.name}>`:`--${r.name}`;e.args=e.args.map((a)=>a===r?{...a,required:!1,requiredUnlessFile:a.required===!0}:a);e.args.push({name:s,generatedFileFor:r.name,help:`从本机文件读取${r.name}（UTF-8），与 ${l} 二选一。`+"长正文建议走文件：命令行上只剩短参数，不受 shell 引号 / 换行 / 编码影响"})}function u(e){c(e);m(e);f(e);const n=e.strategy??(e.browser===!1?Strategy.PUBLIC:Strategy.COOKIE),t=e.browser??(n!==Strategy.PUBLIC&&n!==Strategy.LOCAL);let r=e.navigateBefore;if(r===void 0){if(n===Strategy.COOKIE&&e.domain)r=`https://${e.domain}`;else if(n!==Strategy.PUBLIC&&n!==Strategy.LOCAL)r=!0}return t?{...e,strategy:n,browser:!0,navigateBefore:r}:{...e,strategy:n,browser:!1,navigateBefore:r}}function c(e){if(e.access==="read"||e.access==="write")return;const n=`${e.site}/${e.name}`;throw Error(`Command ${n} must declare access: 'read' | 'write'`)}function m(e){if(e.siteSession===void 0)return;const n=`${e.site}/${e.name}`;if(e.siteSession!=="ephemeral"&&e.siteSession!=="persistent")throw Error(`Command ${n} siteSession must be one of: ephemeral, persistent`)}export function registerCommand(e){const n=u(e),t=fullName(n),r=o.get(t);if(r?.aliases)for(const i of r.aliases)o.delete(`${r.site}/${i}`);const s=g(n.aliases,n.name);n.aliases=s.length>0?s:void 0;o.set(t,n);for(const i of s)o.set(`${n.site}/${i}`,n)}function g(e,n){if(!Array.isArray(e)||e.length===0)return[];const t=new Set,r=[];for(const s of e){const i=typeof s==="string"?s.trim():"";if(!i||i===n||t.has(i))continue;t.add(i);r.push(i)}return r}

package/dist/src/runtime-detect.js

@@ -1 +1 @@
-export const MIN_SUPPORTED_NODE_MAJOR=20;export function detectRuntime(){return globalThis.Bun!==void 0?"bun":"node"}export function getRuntimeVersion(){const k=globalThis.Bun;return k?k.version:process.version}export function getRuntimeLabel(){return`${detectRuntime()} ${getRuntimeVersion()}`}export function parseNodeMajor(k){const q=/^v?(\d+)\./.exec(String(k).trim());if(!q)return null;const w=Number(q[1]);return Number.isInteger(w)?w:null}export function isSupportedNodeVersion(k=process.version){const q=parseNodeMajor(k);return q!==null&&q>=MIN_SUPPORTED_NODE_MAJOR}
+export const MIN_SUPPORTED_NODE_MAJOR=20;export function detectRuntime(){return globalThis.Bun!==void 0?"bun":"node"}export function getRuntimeVersion(){const n=globalThis.Bun;return n?n.version:process.version}export function getRuntimeLabel(){return`${detectRuntime()} ${getRuntimeVersion()}`}export function parseNodeMajor(n){const e=/^v?(\d+)\./.exec(String(n).trim());if(!e)return null;const r=Number(e[1]);return Number.isInteger(r)?r:null}export function isSupportedNodeVersion(n=process.version){const e=parseNodeMajor(n);return e!==null&&e>=MIN_SUPPORTED_NODE_MAJOR}

package/dist/src/runtime.js

@@ -1 +1 @@
-import{BrowserBridge as X,CDPBridge as Y}from"./browser/index.js";import{TimeoutError as Z}from"./errors.js";import{isElectronApp as $}from"./electron-apps.js";import{DEFAULT_BROWSER_COMMAND_TIMEOUT,DEFAULT_BROWSER_CONNECT_TIMEOUT}from"./browser/config.js";export{DEFAULT_BROWSER_COMMAND_TIMEOUT,DEFAULT_BROWSER_CONNECT_TIMEOUT};export function getBrowserFactory(z){if(z&&$(z))return Y;return X}export async function runWithTimeout(z,G){const q=G.label??"Operation";return withTimeoutMs(z,G.timeout*1000,()=>new Z(q,G.timeout,G.hint))}export function withTimeoutMs(z,G,q="Operation timed out"){const H=typeof q==="string"?()=>Error(q):q;return new Promise((J,Q)=>{const V=setTimeout(()=>Q(H()),G);z.then((K)=>{clearTimeout(V);J(K)},(K)=>{clearTimeout(V);Q(K)})})}export async function browserSession(z,G,q={}){const H=new z;try{const J=await H.connect({timeout:DEFAULT_BROWSER_CONNECT_TIMEOUT,session:q.session,cdpEndpoint:q.cdpEndpoint,contextId:q.contextId,idleTimeout:q.idleTimeout,windowMode:q.windowMode,surface:q.surface,siteSession:q.siteSession,initScript:q.initScript,proxyAuth:q.proxyAuth});return await G(J)}finally{await H.close().catch(()=>{})}}
+import{BrowserBridge as s,CDPBridge as m}from"./browser/index.js";import{TimeoutError as a}from"./errors.js";import{isElectronApp as w}from"./electron-apps.js";import{DEFAULT_BROWSER_COMMAND_TIMEOUT,DEFAULT_BROWSER_CONNECT_TIMEOUT}from"./browser/config.js";export{DEFAULT_BROWSER_COMMAND_TIMEOUT,DEFAULT_BROWSER_CONNECT_TIMEOUT};export function getBrowserFactory(t){if(t&&w(t))return m;return s}export async function runWithTimeout(t,i){const e=i.label??"Operation";return withTimeoutMs(t,i.timeout*1000,()=>new a(e,i.timeout,i.hint))}export function withTimeoutMs(t,i,e="Operation timed out"){const o=typeof e==="string"?()=>Error(e):e;return new Promise((r,c)=>{const u=setTimeout(()=>c(o()),i);t.then((n)=>{clearTimeout(u);r(n)},(n)=>{clearTimeout(u);c(n)})})}export async function browserSession(t,i,e={}){const o=new t;try{const r=await o.connect({timeout:DEFAULT_BROWSER_CONNECT_TIMEOUT,session:e.session,cdpEndpoint:e.cdpEndpoint,contextId:e.contextId,idleTimeout:e.idleTimeout,windowMode:e.windowMode,surface:e.surface,siteSession:e.siteSession,initScript:e.initScript,proxyAuth:e.proxyAuth});return await i(r)}finally{await o.close().catch(()=>{})}}

package/dist/src/scripts/framework.js

@@ -1 +1 @@
-export function detectFramework(){const e={};try{const t=document.querySelector("#app"),r=window;e.vue3=!!(t&&t.__vue_app__);e.vue2=!!(t&&t.__vue__);e.react=!!r.__REACT_DEVTOOLS_GLOBAL_HOOK__||!!document.querySelector("[data-reactroot]");e.nextjs=!!r.__NEXT_DATA__;e.nuxt=!!r.__NUXT__;if(e.vue3&&t?.__vue_app__){const _=t.__vue_app__.config?.globalProperties;e.pinia=!!(_&&_.$pinia);e.vuex=!!(_&&_.$store)}}catch{}return e}
+export function detectFramework(){const _={};try{const e=document.querySelector("#app"),o=window;_.vue3=!!(e&&e.__vue_app__);_.vue2=!!(e&&e.__vue__);_.react=!!o.__REACT_DEVTOOLS_GLOBAL_HOOK__||!!document.querySelector("[data-reactroot]");_.nextjs=!!o.__NEXT_DATA__;_.nuxt=!!o.__NUXT__;if(_.vue3&&e?.__vue_app__){const t=e.__vue_app__.config?.globalProperties;_.pinia=!!(t&&t.$pinia);_.vuex=!!(t&&t.$store)}}catch{}return _}

package/dist/src/scripts/interact.js

@@ -1 +1 @@
-export async function interactFuzz(){const q=(f)=>new Promise((h)=>setTimeout(h,f)),u=Array.from(document.querySelectorAll('button, [role="button"], [role="tab"], .tab, .btn, a[href="javascript:void(0)"], a[href="#"]')).slice(0,15);let j=0;for(const f of u)try{const h=f.getBoundingClientRect();if(h.width>0&&h.height>0){f.dispatchEvent(new MouseEvent("click",{bubbles:!0,cancelable:!0,view:window}));j++;await q(300)}}catch{}return j}
+export async function interactFuzz(){const n=(e)=>new Promise((t)=>setTimeout(t,e)),o=Array.from(document.querySelectorAll('button, [role="button"], [role="tab"], .tab, .btn, a[href="javascript:void(0)"], a[href="#"]')).slice(0,15);let c=0;for(const e of o)try{const t=e.getBoundingClientRect();if(t.width>0&&t.height>0){e.dispatchEvent(new MouseEvent("click",{bubbles:!0,cancelable:!0,view:window}));c++;await n(300)}}catch{}return c}

package/dist/src/scripts/store.js

@@ -1 +1 @@
-export function discoverStores(){const s=[];try{const c=document.querySelector("#app");if(!c?.__vue_app__)return s;const r=c.__vue_app__.config?.globalProperties,a=r?.$pinia;if(a?._s)a._s.forEach((o,n)=>{const t=[],i=[];for(const e in o)try{if(e.startsWith("$")||e.startsWith("_"))continue;if(typeof o[e]==="function")t.push(e);else i.push(e)}catch{}s.push({type:"pinia",id:n,actions:t.slice(0,20),stateKeys:i.slice(0,15)})});const p=r?.$store;if(p?._modules?.root?._children){const o=p._modules.root._children;for(const[n,t]of Object.entries(o)){const i=Object.keys(t._rawModule?.actions??{}).slice(0,20),e=Object.keys(t.state??{}).slice(0,15);s.push({type:"vuex",id:n,actions:i,stateKeys:e})}}}catch{}return s}
+export function discoverStores(){const e=[];try{const i=document.querySelector("#app");if(!i?.__vue_app__)return e;const r=i.__vue_app__.config?.globalProperties,a=r?.$pinia;if(a?._s)a._s.forEach((o,n)=>{const s=[],c=[];for(const t in o)try{if(t.startsWith("$")||t.startsWith("_"))continue;if(typeof o[t]==="function")s.push(t);else c.push(t)}catch{}e.push({type:"pinia",id:n,actions:s.slice(0,20),stateKeys:c.slice(0,15)})});const p=r?.$store;if(p?._modules?.root?._children){const o=p._modules.root._children;for(const[n,s]of Object.entries(o)){const c=Object.keys(s._rawModule?.actions??{}).slice(0,20),t=Object.keys(s.state??{}).slice(0,15);e.push({type:"vuex",id:n,actions:c,stateKeys:t})}}}catch{}return e}

package/dist/src/serialization.js

@@ -1,4 +1,4 @@
-import{fullName as J,strategyLabel as K}from"./registry.js";export function serializeArg(k){return{name:k.name,type:k.type??"string",required:!!k.required,valueRequired:!!k.valueRequired,positional:!!k.positional,choices:k.choices??[],default:k.default??null,help:k.help??""}}export function serializeCommand(k){return{command:J(k),site:k.site,name:k.name,aliases:k.aliases??[],description:k.description,access:k.access,strategy:K(k),browser:!!k.browser,args:k.args.map(serializeArg),columns:k.columns??[],domain:k.domain??null,example:formatCommandExample(k),defaultFormat:k.defaultFormat??null,siteSession:k.siteSession??null}}export function formatArgSummary(k){return k.map((v)=>{if(v.positional)return v.required?`<${v.name}>`:`[${v.name}]`;return v.required?`--${v.name}`:`[--${v.name}]`}).join(" ")}function M(k){if(k.length<=4)return k.join(", ");return`${k.slice(0,4).join(", ")}, ... (+${k.length-4} more)`}function F(k){return`<${k}>`}export function formatCommandExample(k){if(k.example?.trim())return k.example.trim();const v=["ppcli",k.site,k.name],D=(q)=>q.required||q.requiredUnlessFile;for(const q of k.args)if(q.positional&&D(q))v.push(F(q.name));for(const q of k.args){if(q.positional||!D(q))continue;v.push(`--${q.name}`);if(q.type!=="bool"&&q.type!=="boolean")v.push(F(q.name))}v.push("-f","yaml");return v.join(" ")}export function formatRegistryHelpText(k){const v=[],D=k.args.filter((B)=>B.choices?.length);for(const B of D){const H=B.positional?`<${B.name}>`:`--${B.name}`,I=B.default!=null?`  (default: ${B.default})`:"";v.push(`  ${H}: ${M(B.choices)}${I}`)}const q=[];q.push(`Access: ${k.access}`);q.push(`Browser: ${k.browser?"yes":"no"}`);if(k.domain)q.push(`Domain: ${k.domain}`);if(k.defaultFormat)q.push(`Default format: ${k.defaultFormat}`);if(k.aliases?.length)q.push(`Aliases: ${k.aliases.join(", ")}`);v.push(q.join(" | "));v.push(`Example: ${formatCommandExample(k)}`);if(k.columns?.length)v.push(`Output columns: ${k.columns.join(", ")}`);return`
-`+v.join(`
+import{fullName as l,strategyLabel as u}from"./registry.js";export function serializeArg(e){return{name:e.name,type:e.type??"string",required:!!e.required,valueRequired:!!e.valueRequired,positional:!!e.positional,choices:e.choices??[],default:e.default??null,help:e.help??""}}export function serializeCommand(e){return{command:l(e),site:e.site,name:e.name,aliases:e.aliases??[],description:e.description,access:e.access,strategy:u(e),browser:!!e.browser,args:e.args.map(serializeArg),columns:e.columns??[],domain:e.domain??null,example:formatCommandExample(e),defaultFormat:e.defaultFormat??null,siteSession:e.siteSession??null}}export function formatArgSummary(e){return e.map((o)=>{if(o.positional)return o.required?`<${o.name}>`:`[${o.name}]`;return o.required?`--${o.name}`:`[--${o.name}]`}).join(" ")}function p(e){if(e.length<=4)return e.join(", ");return`${e.slice(0,4).join(", ")}, ... (+${e.length-4} more)`}function r(e){return`<${e}>`}export function formatCommandExample(e){if(e.example?.trim())return e.example.trim();const o=["ppcli",e.site,e.name],t=(n)=>n.required||n.requiredUnlessFile;for(const n of e.args)if(n.positional&&t(n))o.push(r(n.name));for(const n of e.args){if(n.positional||!t(n))continue;o.push(`--${n.name}`);if(n.type!=="bool"&&n.type!=="boolean")o.push(r(n.name))}o.push("-f","yaml");return o.join(" ")}export function formatRegistryHelpText(e){const o=[],t=e.args.filter((s)=>s.choices?.length);for(const s of t){const i=s.positional?`<${s.name}>`:`--${s.name}`,a=s.default!=null?`  (default: ${s.default})`:"";o.push(`  ${i}: ${p(s.choices)}${a}`)}const n=[];n.push(`Access: ${e.access}`);n.push(`Browser: ${e.browser?"yes":"no"}`);if(e.domain)n.push(`Domain: ${e.domain}`);if(e.defaultFormat)n.push(`Default format: ${e.defaultFormat}`);if(e.aliases?.length)n.push(`Aliases: ${e.aliases.join(", ")}`);o.push(n.join(" | "));o.push(`Example: ${formatCommandExample(e)}`);if(e.columns?.length)o.push(`Output columns: ${e.columns.join(", ")}`);return`
+`+o.join(`
 `)+`
 `}

package/dist/src/session-lease.js

@@ -1 +1 @@
-export const SESSION_LEASE_TTL_MS=45000,SESSION_BUSY_CODE="session_busy";export function getSessionLeaseKey(q,b,j){return`${q}␟${b}␟${encodeURIComponent(j)}`}export function parsePidFromRunId(q){const b=/^run_(\d+)_/.exec(q);if(!b)return null;const j=Number(b[1]);return Number.isInteger(j)&&j>0?j:null}export function isSessionLeaseCommand(q){return q.surface==="adapter"&&q.siteSession==="persistent"&&q.access==="write"&&typeof q.session==="string"&&q.session.length>0&&typeof q.runId==="string"&&q.runId.length>0}export class SessionLeaseRegistry{ttlMs;leases=new Map;constructor(q=SESSION_LEASE_TTL_MS){this.ttlMs=q}touch(q,b){const j=this.leases.get(q),z=j!==void 0&&(b.now-j.lastSeenAt<=this.ttlMs||b.hasPendingWork?.(j.runId)===!0);if(j!==void 0&&z&&j.runId!==b.runId)return{granted:!1,holder:j};const G=j!==void 0&&j.runId===b.runId?{...j,command:b.command,lastSeenAt:b.now}:{runId:b.runId,command:b.command,pid:parsePidFromRunId(b.runId),startedAt:b.now,lastSeenAt:b.now};this.leases.set(q,G);return{granted:!0,holder:G}}heartbeat(q,b,j){const z=this.leases.get(q);if(z!==void 0&&z.runId===b)z.lastSeenAt=j}releaseByRunId(q){for(const[b,j]of this.leases)if(j.runId===q)this.leases.delete(b)}get(q,b){const j=this.leases.get(q);if(j===void 0)return;if(b-j.lastSeenAt>this.ttlMs){this.leases.delete(q);return}return j}list(q,b){const j=[];for(const[z,G]of this.leases)if(q-G.lastSeenAt<=this.ttlMs||b?.(G.runId)===!0)j.push({key:z,...G});return j}}export function buildSessionBusyFailure(q,b,j){const z=Math.max(0,Math.round((j-b.startedAt)/1000)),G=b.pid!=null?`${b.command} (pid ${b.pid})`:b.command,H=b.pid!=null?`Wait for it to finish, or stop it with \`kill ${b.pid}\` if it is stuck.`:"Wait for it to finish, or stop that process if it is stuck.";return{message:`Session "${q}" is busy: ${G} has been driving it for ${z}s.`,errorCode:SESSION_BUSY_CODE,errorHint:`${H} Read-only commands are not blocked.`,status:409}}
+export const SESSION_LEASE_TTL_MS=45000,SESSION_BUSY_CODE="session_busy";export function getSessionLeaseKey(s,e,t){return`${s}␟${e}␟${encodeURIComponent(t)}`}export function parsePidFromRunId(s){const e=/^run_(\d+)_/.exec(s);if(!e)return null;const t=Number(e[1]);return Number.isInteger(t)&&t>0?t:null}export function isSessionLeaseCommand(s){return s.surface==="adapter"&&s.siteSession==="persistent"&&s.access==="write"&&typeof s.session==="string"&&s.session.length>0&&typeof s.runId==="string"&&s.runId.length>0}export class SessionLeaseRegistry{ttlMs;leases=new Map;constructor(s=SESSION_LEASE_TTL_MS){this.ttlMs=s}touch(s,e){const t=this.leases.get(s),n=t!==void 0&&(e.now-t.lastSeenAt<=this.ttlMs||e.hasPendingWork?.(t.runId)===!0);if(t!==void 0&&n&&t.runId!==e.runId)return{granted:!1,holder:t};const r=t!==void 0&&t.runId===e.runId?{...t,command:e.command,lastSeenAt:e.now}:{runId:e.runId,command:e.command,pid:parsePidFromRunId(e.runId),startedAt:e.now,lastSeenAt:e.now};this.leases.set(s,r);return{granted:!0,holder:r}}heartbeat(s,e,t){const n=this.leases.get(s);if(n!==void 0&&n.runId===e)n.lastSeenAt=t}releaseByRunId(s){for(const[e,t]of this.leases)if(t.runId===s)this.leases.delete(e)}get(s,e){const t=this.leases.get(s);if(t===void 0)return;if(e-t.lastSeenAt>this.ttlMs){this.leases.delete(s);return}return t}list(s,e){const t=[];for(const[n,r]of this.leases)if(s-r.lastSeenAt<=this.ttlMs||e?.(r.runId)===!0)t.push({key:n,...r});return t}}export function buildSessionBusyFailure(s,e,t){const n=Math.max(0,Math.round((t-e.startedAt)/1000)),r=e.pid!=null?`${e.command} (pid ${e.pid})`:e.command,o=e.pid!=null?`Wait for it to finish, or stop it with \`kill ${e.pid}\` if it is stuck.`:"Wait for it to finish, or stop that process if it is stuck.";return{message:`Session "${s}" is busy: ${r} has been driving it for ${n}s.`,errorCode:SESSION_BUSY_CODE,errorHint:`${o} Read-only commands are not blocked.`,status:409}}

package/dist/src/snapshotFormatter.js

@@ -1,3 +1,3 @@
-const D=200,S=new Set(["none","presentation","separator","paragraph","tooltip","status"]),m=new Set(["contentinfo"]),O=new Set(["button","link","textbox","checkbox","radio","combobox","tab","menuitem","option","switch","slider","spinbutton","searchbox"]),A=new Set(["main","navigation","banner","heading","search","region","list","listitem","article","complementary","group","toolbar","tablist"]),U=new Set(["list","listitem","group","toolbar","tablist","navigation","region","complementary","search","article","paragraph","figure"]),C=new Set(["•","·","|","—","-","/","\\"]),N=["googleadservices.com/pagead/","alb.reddit.com/cr?","doubleclick.net/","cm.bilibili.com/cm/api/fees/"],_=["回到顶部","back to top","scroll to top","go to top"];function R(W){let q=W;if(q.startsWith("'")&&q.endsWith("':"))q=q.slice(1,-2)+":";else if(q.startsWith("'")&&q.endsWith("'"))q=q.slice(1,-1);const $=q.match(/^([a-zA-Z]+)\b/),V=$?$[1].toLowerCase():"",H=q.match(/"([^"]*)"/),P=H?H[1]:"";let K=q;K=K.replace(/"[^"]*"/g,'""');K=K.replace(/\[[^\]]*\]/g,"");const b=K.lastIndexOf(":");let F="";if(b!==-1){if(K.slice(b+1).trim().length>0){const G=q.lastIndexOf(":");if(G!==-1)F=q.slice(G+1).trim()}}return{role:V,text:P,hasText:P.length>0||F.length>0,trailingText:F}}function g(W){let q=W;if(q.startsWith("'")&&(q.endsWith("':")||q.endsWith("'")))if(q.endsWith("':"))q=q.slice(1,-2)+":";else q=q.slice(1,-1);const $=q.split('"');for(let H=0;H<$.length;H+=2)$[H]=$[H].replace(/\s*\[[^\]]*\]/g,"");return $.join('"').replace(/\s{2,}/g," ").trim()}function j(W){return/^\/[a-zA-Z]+:/.test(W)}function I(W){return C.has(W.trim())}function L(W,q){const $=(W+" "+q).toLowerCase();if($.includes("sponsored")||$.includes("advertisement"))return!0;if($.includes("广告"))return!0;for(const V of N)if(W.includes(V)||q.includes(V))return!0;return!1}function E(W){const q=W.toLowerCase();return _.some(($)=>q.includes($))}function u(W,q,$,V){if(S.has(W))return!0;if(W==="generic"&&!q)return!0;if(W==="img"&&!q)return!0;if((W==="generic"||W==="text")&&q){if(I(V||$))return!0}return!1}export function formatSnapshot(W,q={}){if(!W||typeof W!=="string")return"";const $=q.maxTextLength??D,V=W.split(`
-`),H=[];let P=0,K=-1;for(let Y=0;Y<V.length;Y++){const z=V[Y];if(!z.trim())continue;const Q=z.length-z.trimStart().length,Z=Math.floor(Q/2);if(K>=0){if(Z>K)continue;K=-1}let J=z.trimStart();if(J.startsWith("- "))J=J.slice(2);if(j(J))continue;if(q.maxDepth!==void 0&&Z>q.maxDepth)continue;const{role:v,text:f,hasText:k,trailingText:B}=R(J);if(u(v,k,f,B))continue;if(m.has(v)){K=Z;continue}if(L(f,B)||E(f)){K=Z;continue}J=g(J);const w=O.has(v),M=A.has(v);if(q.interactive&&!w&&!M&&!k)continue;if(q.compact)J=J.replace(/\s*\[.*?\]\s*/g," ").replace(/\s+/g," ").trim();if($>0&&J.length>$)J=J.slice(0,$)+"…";if(w){P++;J=`[@${P}] ${J}`}H.push({depth:Z,content:J,role:v,text:f,trailingText:B,isInteractive:w,isLandmark:M})}const b=[];for(let Y=0;Y<H.length;Y++){const z=H[Y];if(z.role==="generic"||z.role==="text"){let Q;for(let Z=b.length-1;Z>=0;Z--){if(b[Z].depth<z.depth){Q=b[Z];break}if(b[Z].depth===z.depth)break}if(Q){const Z=z.trailingText||z.text;if(Z&&Q.text&&Z===Q.text)continue}}if(z.role==="heading"&&z.text){const Q=H[Y+1];if(Q&&Q.role==="link"&&Q.text===z.text&&Q.depth===z.depth+1){b.push(z);Y++;continue}}if(z.role==="link"&&z.text){const Q=H[Y+1];if(Q&&Q.role==="link"&&Q.text===z.text&&Q.depth===z.depth+1)continue}b.push(z)}let F=b,X=!0;while(X){X=!1;const Y=[];for(let z=0;z<F.length;z++){const Q=F[z];if(U.has(Q.role)&&!Q.text&&!Q.trailingText){let Z=!1;for(let J=z+1;J<F.length;J++){if(F[J].depth<=Q.depth)break;if(F[J].depth>Q.depth){Z=!0;break}}if(!Z){X=!0;continue}}Y.push(Q)}F=Y}const G=[];for(let Y=0;Y<F.length;Y++){const z=F[Y];if(U.has(z.role)&&!z.text&&!z.trailingText){let Q=0,Z=-1;for(let J=Y+1;J<F.length;J++){if(F[J].depth<=z.depth)break;if(F[J].depth===z.depth+1){Q++;if(Q===1)Z=J}}if(Q===1&&Z!==-1){const J=F[Z];let v=!1;for(let f=Z+1;f<F.length;f++){if(F[f].depth<=J.depth)break;if(F[f].depth>J.depth){v=!0;break}}if(!v){G.push({...z,content:z.content.replace(/:$/,"")+" > "+J.content,role:J.role,text:J.text,trailingText:J.trailingText,isInteractive:J.isInteractive});Y++;continue}}}G.push(z)}return G.map((Y)=>"  ".repeat(Y.depth)+Y.content).join(`
+const k=200,A=new Set(["none","presentation","separator","paragraph","tooltip","status"]),I=new Set(["contentinfo"]),R=new Set(["button","link","textbox","checkbox","radio","combobox","tab","menuitem","option","switch","slider","spinbutton","searchbox"]),O=new Set(["main","navigation","banner","heading","search","region","list","listitem","article","complementary","group","toolbar","tablist"]),S=new Set(["list","listitem","group","toolbar","tablist","navigation","region","complementary","search","article","paragraph","figure"]),_=new Set(["•","·","|","—","-","/","\\"]),C=["googleadservices.com/pagead/","alb.reddit.com/cr?","doubleclick.net/","cm.bilibili.com/cm/api/fees/"],N=["回到顶部","back to top","scroll to top","go to top"];function w(o){let t=o;if(t.startsWith("'")&&t.endsWith("':"))t=t.slice(1,-2)+":";else if(t.startsWith("'")&&t.endsWith("'"))t=t.slice(1,-1);const c=t.match(/^([a-zA-Z]+)\b/),f=c?c[1].toLowerCase():"",a=t.match(/"([^"]*)"/),x=a?a[1]:"";let h=t;h=h.replace(/"[^"]*"/g,'""');h=h.replace(/\[[^\]]*\]/g,"");const u=h.lastIndexOf(":");let l="";if(u!==-1){if(h.slice(u+1).trim().length>0){const g=t.lastIndexOf(":");if(g!==-1)l=t.slice(g+1).trim()}}return{role:f,text:x,hasText:x.length>0||l.length>0,trailingText:l}}function W(o){let t=o;if(t.startsWith("'")&&(t.endsWith("':")||t.endsWith("'")))if(t.endsWith("':"))t=t.slice(1,-2)+":";else t=t.slice(1,-1);const c=t.split('"');for(let a=0;a<c.length;a+=2)c[a]=c[a].replace(/\s*\[[^\]]*\]/g,"");return c.join('"').replace(/\s{2,}/g," ").trim()}function v(o){return/^\/[a-zA-Z]+:/.test(o)}function D(o){return _.has(o.trim())}function j(o,t){const c=(o+" "+t).toLowerCase();if(c.includes("sponsored")||c.includes("advertisement"))return!0;if(c.includes("广告"))return!0;for(const f of C)if(o.includes(f)||t.includes(f))return!0;return!1}function y(o){const t=o.toLowerCase();return N.some((c)=>t.includes(c))}function M(o,t,c,f){if(A.has(o))return!0;if(o==="generic"&&!t)return!0;if(o==="img"&&!t)return!0;if((o==="generic"||o==="text")&&t){if(D(f||c))return!0}return!1}export function formatSnapshot(o,t={}){if(!o||typeof o!=="string")return"";const c=t.maxTextLength??k,f=o.split(`
+`),a=[];let x=0,h=-1;for(let r=0;r<f.length;r++){const e=f[r];if(!e.trim())continue;const i=e.length-e.trimStart().length,s=Math.floor(i/2);if(h>=0){if(s>h)continue;h=-1}let n=e.trimStart();if(n.startsWith("- "))n=n.slice(2);if(v(n))continue;if(t.maxDepth!==void 0&&s>t.maxDepth)continue;const{role:d,text:p,hasText:E,trailingText:b}=w(n);if(M(d,E,p,b))continue;if(I.has(d)){h=s;continue}if(j(p,b)||y(p)){h=s;continue}n=W(n);const T=R.has(d),L=O.has(d);if(t.interactive&&!T&&!L&&!E)continue;if(t.compact)n=n.replace(/\s*\[.*?\]\s*/g," ").replace(/\s+/g," ").trim();if(c>0&&n.length>c)n=n.slice(0,c)+"…";if(T){x++;n=`[@${x}] ${n}`}a.push({depth:s,content:n,role:d,text:p,trailingText:b,isInteractive:T,isLandmark:L})}const u=[];for(let r=0;r<a.length;r++){const e=a[r];if(e.role==="generic"||e.role==="text"){let i;for(let s=u.length-1;s>=0;s--){if(u[s].depth<e.depth){i=u[s];break}if(u[s].depth===e.depth)break}if(i){const s=e.trailingText||e.text;if(s&&i.text&&s===i.text)continue}}if(e.role==="heading"&&e.text){const i=a[r+1];if(i&&i.role==="link"&&i.text===e.text&&i.depth===e.depth+1){u.push(e);r++;continue}}if(e.role==="link"&&e.text){const i=a[r+1];if(i&&i.role==="link"&&i.text===e.text&&i.depth===e.depth+1)continue}u.push(e)}let l=u,m=!0;while(m){m=!1;const r=[];for(let e=0;e<l.length;e++){const i=l[e];if(S.has(i.role)&&!i.text&&!i.trailingText){let s=!1;for(let n=e+1;n<l.length;n++){if(l[n].depth<=i.depth)break;if(l[n].depth>i.depth){s=!0;break}}if(!s){m=!0;continue}}r.push(i)}l=r}const g=[];for(let r=0;r<l.length;r++){const e=l[r];if(S.has(e.role)&&!e.text&&!e.trailingText){let i=0,s=-1;for(let n=r+1;n<l.length;n++){if(l[n].depth<=e.depth)break;if(l[n].depth===e.depth+1){i++;if(i===1)s=n}}if(i===1&&s!==-1){const n=l[s];let d=!1;for(let p=s+1;p<l.length;p++){if(l[p].depth<=n.depth)break;if(l[p].depth>n.depth){d=!0;break}}if(!d){g.push({...e,content:e.content.replace(/:$/,"")+" > "+n.content,role:n.role,text:n.text,trailingText:n.trailingText,isInteractive:n.isInteractive});r++;continue}}}g.push(e)}return g.map((r)=>"  ".repeat(r.depth)+r.content).join(`
 `)}

package/dist/src/tui.js

@@ -1,16 +1,16 @@
-import{EXIT_CODES as j}from"./errors.js";export async function checkboxPrompt(Q,P={}){if(Q.length===0)return[];const{stdin:B,stdout:J}=process;if(!B.isTTY)return Q.filter((z)=>z.checked).map((z)=>z.value);let G=0;const F=Q.map((z)=>({...z}));function U(){let z="";if(P.title)z+=`
-${P.title}
+import{EXIT_CODES as k}from"./errors.js";export async function checkboxPrompt(f,l={}){if(f.length===0)return[];const{stdin:n,stdout:s}=process;if(!n.isTTY)return f.filter((e)=>e.checked).map((e)=>e.value);let c=0;const r=f.map((e)=>({...e}));function d(){let e="";if(l.title)e+=`
+${l.title}
 
-`;for(let K=0;K<F.length;K++){const L=F[K],A=K===G?"❯":" ",V=L.checked?"◉":"○",W=L.status??"";z+=`  ${A} ${V} ${L.label}${W?`  ${W}`:""}
-`}z+=`
+`;for(let o=0;o<r.length;o++){const a=r[o],t=o===c?"❯":" ",h=a.checked?"◉":"○",w=a.status??"";e+=`  ${t} ${h} ${a.label}${w?`  ${w}`:""}
+`}e+=`
   ↑↓ navigate  ·  Space toggle  ·  a all  ·  Enter confirm  ·  q cancel
-`;return z}return new Promise((z)=>{const K=B.isRaw;B.setRawMode(!0);B.resume();J.write("\x1B[?25l");let L=!0;function A(){if(!L){const Z=U().split(`
-`).length;J.write(`\x1B[${Z}A\x1B[J`)}L=!1;J.write(U())}function V(){B.setRawMode(K??!1);B.pause();B.removeListener("data",W);const Z=U().split(`
-`).length;J.write(`\x1B[${Z}A\x1B[J`);J.write("\x1B[?25h")}function W(Z){const H=Z.toString();if(H==="\x1B[A"||H==="k"){G=(G-1+F.length)%F.length;A();return}if(H==="\x1B[B"||H==="j"){G=(G+1)%F.length;A();return}if(H===" "){F[G].checked=!F[G].checked;A();return}if(H==="\t"){F[G].checked=!F[G].checked;G=(G+1)%F.length;A();return}if(H==="a"){const $=F.every((M)=>M.checked);for(const M of F)M.checked=!$;A();return}if(H==="\r"||H===`
-`){V();const $=F.filter((M)=>M.checked).map((M)=>M.value);J.write(`  ✓ ${$.length} file(s) selected
+`;return e}return new Promise((e)=>{const o=n.isRaw;n.setRawMode(!0);n.resume();s.write("\x1B[?25l");let a=!0;function t(){if(!a){const p=d().split(`
+`).length;s.write(`\x1B[${p}A\x1B[J`)}a=!1;s.write(d())}function h(){n.setRawMode(o??!1);n.pause();n.removeListener("data",w);const p=d().split(`
+`).length;s.write(`\x1B[${p}A\x1B[J`);s.write("\x1B[?25h")}function w(p){const i=p.toString();if(i==="\x1B[A"||i==="k"){c=(c-1+r.length)%r.length;t();return}if(i==="\x1B[B"||i==="j"){c=(c+1)%r.length;t();return}if(i===" "){r[c].checked=!r[c].checked;t();return}if(i==="\t"){r[c].checked=!r[c].checked;c=(c+1)%r.length;t();return}if(i==="a"){const x=r.every((u)=>u.checked);for(const u of r)u.checked=!x;t();return}if(i==="\r"||i===`
+`){h();const x=r.filter((u)=>u.checked).map((u)=>u.value);s.write(`  ✓ ${x.length} file(s) selected
 
-`);z($);return}if(H==="q"||H==="\x1B"){V();J.write(`  ✗ Cancelled
+`);e(x);return}if(i==="q"||i==="\x1B"){h();s.write(`  ✗ Cancelled
 
-`);z([]);return}if(H==="\x03"){V();process.exit(j.INTERRUPTED)}}B.on("data",W);A()})}export async function confirmPrompt(Q,P=!0){const{stdin:B,stdout:J}=process;if(!B.isTTY)return P;const G=P?"[Y/n]":"[y/N]";J.write(`  ${Q} ${G} `);return new Promise((F)=>{const U=B.isRaw;B.setRawMode(!0);B.resume();function z(){B.setRawMode(U??!1);B.pause();B.removeListener("data",K);J.write(`
-`)}function K(L){const A=L.toString();if(A==="\x03"){z();process.exit(j.INTERRUPTED)}if(A==="\r"||A===`
-`){z();F(P);return}if(A==="y"||A==="Y"){z();F(!0);return}if(A==="n"||A==="N"||A==="q"||A==="\x1B"){z();F(!1);return}}B.on("data",K)})}
+`);e([]);return}if(i==="\x03"){h();process.exit(k.INTERRUPTED)}}n.on("data",w);t()})}export async function confirmPrompt(f,l=!0){const{stdin:n,stdout:s}=process;if(!n.isTTY)return l;const c=l?"[Y/n]":"[y/N]";s.write(`  ${f} ${c} `);return new Promise((r)=>{const d=n.isRaw;n.setRawMode(!0);n.resume();function e(){n.setRawMode(d??!1);n.pause();n.removeListener("data",o);s.write(`
+`)}function o(a){const t=a.toString();if(t==="\x03"){e();process.exit(k.INTERRUPTED)}if(t==="\r"||t===`
+`){e();r(l);return}if(t==="y"||t==="Y"){e();r(!0);return}if(t==="n"||t==="N"||t==="q"||t==="\x1B"){e();r(!1);return}}n.on("data",o)})}

package/dist/src/user-runtime.js

@@ -1 +1 @@
-import*as j from"node:fs";import*as H from"node:os";import*as v from"node:path";export const LEGACY_USER_DIR_NAME=".opencli",USER_DIR_NAME=".ppcli";function B(k){try{j.lstatSync(k);return!0}catch{return!1}}function F(k,b){const q=j.lstatSync(k);if(q.isDirectory()){let w=0;if(!B(b)){j.mkdirSync(b,{recursive:!0,mode:q.mode});w++}else if(!j.lstatSync(b).isDirectory())return 0;for(const z of j.readdirSync(k))try{w+=F(v.join(k,z),v.join(b,z))}catch{}return w}if(B(b))return 0;j.mkdirSync(v.dirname(b),{recursive:!0});if(q.isSymbolicLink())j.symlinkSync(j.readlinkSync(k),b,process.platform==="win32"?"junction":void 0);else if(q.isFile()){j.copyFileSync(k,b,j.constants.COPYFILE_EXCL);j.chmodSync(b,q.mode)}else return 0;return 1}export function migrateLegacyUserRuntime(k=H.homedir()){try{const b=v.join(k,LEGACY_USER_DIR_NAME);if(!j.existsSync(b))return 0;return F(b,v.join(k,USER_DIR_NAME))}catch{return 0}}
+import*as i from"node:fs";import*as f from"node:os";import*as e from"node:path";export const LEGACY_USER_DIR_NAME=".opencli",USER_DIR_NAME=".ppcli";function s(r){try{i.lstatSync(r);return!0}catch{return!1}}function y(r,n){const t=i.lstatSync(r);if(t.isDirectory()){let c=0;if(!s(n)){i.mkdirSync(n,{recursive:!0,mode:t.mode});c++}else if(!i.lstatSync(n).isDirectory())return 0;for(const o of i.readdirSync(r))try{c+=y(e.join(r,o),e.join(n,o))}catch{}return c}if(s(n))return 0;i.mkdirSync(e.dirname(n),{recursive:!0});if(t.isSymbolicLink())i.symlinkSync(i.readlinkSync(r),n,process.platform==="win32"?"junction":void 0);else if(t.isFile()){i.copyFileSync(r,n,i.constants.COPYFILE_EXCL);i.chmodSync(n,t.mode)}else return 0;return 1}export function migrateLegacyUserRuntime(r=f.homedir()){try{const n=e.join(r,LEGACY_USER_DIR_NAME);if(!i.existsSync(n))return 0;return y(n,e.join(r,USER_DIR_NAME))}catch{return 0}}

package/dist/src/utils.d.ts

@@ -55,3 +55,15 @@ export declare function parseJsonOrThrowLoginWall(response: Response, opts?: {
  *
  * The Node side then calls `throwIfLoginWall(res, { url })` on the result. */
 export declare const BROWSER_JSON_SNIFF_FN = "\nasync function fetchJsonOrLoginWall(input, init) {\n  const r = await fetch(input, init);\n  const contentType = r.headers.get('content-type') || '';\n  const text = await r.text();\n  const trimmed = text.replace(/^\\s+/, '');\n  const looksLikeHtml =\n    contentType.toLowerCase().includes('text/html')\n    || /^<(?:!doctype|html|head|body|title)(?:[\\s>/]|$)/i.test(trimmed);\n  if (looksLikeHtml) {\n    return {\n      __loginWall: true,\n      status: r.status,\n      url: r.url || (typeof input === 'string' ? input : ''),\n      contentType,\n      bodyPreview: trimmed.slice(0, 100),\n    };\n  }\n  if (!r.ok) {\n    return { error: r.status };\n  }\n  try {\n    return JSON.parse(text);\n  } catch (err) {\n    throw new Error(\n      'JSON parse failed (status=' + r.status + ', body[0..50]=' + JSON.stringify(trimmed.slice(0, 50)) + '): '\n      + (err && err.message ? err.message : String(err))\n    );\n  }\n}\n";
+/** [pp-only] 记下正文文件所在目录；传 null 清空。由 resolveFileBackedArg 调用。 */
+export declare function setContentBaseDir(dir: string | null): void;
+/** [pp-only] 取正文文件所在目录（没有走 --file 时为 null）。 */
+export declare function getContentBaseDir(): string | null;
+/**
+ * [pp-only] 解析正文里引用的本机相对路径。
+ *
+ * 顺序：① 正文文件所在目录（作者的心智模型）→ ② CLI cwd（老行为兜底）。
+ * ①存在才用①，否则回退②——这样「正文和图放一起」和「图放在 cwd」两种摆法都能发出去，
+ * 且绝不会因为新逻辑把原本能用的路径解析坏。绝对路径原样返回。
+ */
+export declare function resolveContentPath(p: string): string;

package/dist/src/utils.js

@@ -1,8 +1,8 @@
-import*as X from"node:fs";import*as Z from"node:path";import C from"turndown";import{LoginWallError as Y}from"./errors.js";export function isRecord(q){return typeof q==="object"&&q!==null&&!Array.isArray(q)}export async function mapConcurrent(q,z,D){const G=Array(q.length);let A=0;async function V(){while(A<q.length){const Q=A++;G[Q]=await D(q[Q],Q)}}const K=Array.from({length:Math.min(z,q.length)},()=>V());await Promise.all(K);return G}export function sleep(q){return new Promise((z)=>setTimeout(z,q))}export async function saveBase64ToFile(q,z){const D=Z.dirname(z);await X.promises.mkdir(D,{recursive:!0});await X.promises.writeFile(z,Buffer.from(q,"base64"))}export function createMarkdownConverter(q){const z=new C({headingStyle:"atx",codeBlockStyle:"fenced",bulletListMarker:"-"});z.addRule("linebreak",{filter:"br",replacement:()=>`
-`});if(q)q(z);return z}export function htmlToMarkdown(q,z){return createMarkdownConverter(z).turndown(q||"").replace(/\u00a0/g," ").replace(/\n{4,}/g,`
+import*as l from"node:fs";import*as s from"node:path";import m from"turndown";import{LoginWallError as f}from"./errors.js";export function isRecord(t){return typeof t==="object"&&t!==null&&!Array.isArray(t)}export async function mapConcurrent(t,e,r){const o=Array(t.length);let n=0;async function u(){while(n<t.length){const a=n++;o[a]=await r(t[a],a)}}const i=Array.from({length:Math.min(e,t.length)},()=>u());await Promise.all(i);return o}export function sleep(t){return new Promise((e)=>setTimeout(e,t))}export async function saveBase64ToFile(t,e){const r=s.dirname(e);await l.promises.mkdir(r,{recursive:!0});await l.promises.writeFile(e,Buffer.from(t,"base64"))}export function createMarkdownConverter(t){const e=new m({headingStyle:"atx",codeBlockStyle:"fenced",bulletListMarker:"-"});e.addRule("linebreak",{filter:"br",replacement:()=>`
+`});if(t)t(e);return e}export function htmlToMarkdown(t,e){return createMarkdownConverter(e).turndown(t||"").replace(/\u00a0/g," ").replace(/\n{4,}/g,`
 
 
-`).replace(/[ \t]+$/gm,"").trim()}function H(q){return typeof q==="object"&&q!==null&&q.__loginWall===!0&&typeof q.status==="number"}export function throwIfLoginWall(q,z={}){if(H(q))throw new Y(`Server returned HTML instead of JSON (status=${q.status}). Likely a login wall, rate limit, or WAF challenge.`,q.status,z.url||q.url||"",q.bodyPreview);return q}export async function parseJsonOrThrowLoginWall(q,z={}){const D=q.headers.get("content-type")||"",G=await q.text(),A=G.trimStart();if(D.toLowerCase().includes("text/html")||/^<(?:!doctype|html|head|body|title)(?:[\s>/]|$)/i.test(A))throw new Y(`Server returned HTML instead of JSON (status=${q.status}). Likely a login wall, rate limit, or WAF challenge.`,q.status,z.url||q.url||"",A.slice(0,100));try{return JSON.parse(G)}catch(K){throw Error(`JSON parse failed (status=${q.status}, body[0..50]=${JSON.stringify(A.slice(0,50))}): `+(K instanceof Error?K.message:String(K)))}}export const BROWSER_JSON_SNIFF_FN=`
+`).replace(/[ \t]+$/gm,"").trim()}function d(t){return typeof t==="object"&&t!==null&&t.__loginWall===!0&&typeof t.status==="number"}export function throwIfLoginWall(t,e={}){if(d(t))throw new f(`Server returned HTML instead of JSON (status=${t.status}). Likely a login wall, rate limit, or WAF challenge.`,t.status,e.url||t.url||"",t.bodyPreview);return t}export async function parseJsonOrThrowLoginWall(t,e={}){const r=t.headers.get("content-type")||"",o=await t.text(),n=o.trimStart();if(r.toLowerCase().includes("text/html")||/^<(?:!doctype|html|head|body|title)(?:[\s>/]|$)/i.test(n))throw new f(`Server returned HTML instead of JSON (status=${t.status}). Likely a login wall, rate limit, or WAF challenge.`,t.status,e.url||t.url||"",n.slice(0,100));try{return JSON.parse(o)}catch(i){throw Error(`JSON parse failed (status=${t.status}, body[0..50]=${JSON.stringify(n.slice(0,50))}): `+(i instanceof Error?i.message:String(i)))}}export const BROWSER_JSON_SNIFF_FN=`
 async function fetchJsonOrLoginWall(input, init) {
   const r = await fetch(input, init);
   const contentType = r.headers.get('content-type') || '';
@@ -32,4 +32,4 @@ async function fetchJsonOrLoginWall(input, init) {
     );
   }
 }
-`;
+`;const c="PP_CONTENT_BASE_DIR";export function setContentBaseDir(t){if(t)process.env[c]=t;else delete process.env[c]}export function getContentBaseDir(){return process.env[c]||null}export function resolveContentPath(t){if(s.isAbsolute(t))return t;const e=getContentBaseDir();if(e){const r=s.resolve(e,t);if(l.existsSync(r))return r}return s.resolve(t)}

package/dist/src/validate.js

@@ -1,3 +1,3 @@
-import{getRegistry as O,fullName as M}from"./registry.js";import{getRegisteredStepNames as Q}from"./pipeline/registry.js";function U(){return new Set(Q())}export function validateClisWithTarget(q,F){const x=O(),B=[];let I=0,H=0;if(x.size===0)return{ok:!0,results:[{label:"(registry)",errors:[],warnings:["Registry is empty — no commands discovered. Did discoverClis() run?"]}],errors:0,warnings:1,commands:0};let D=F;if(F?.includes("/")){const G=x.get(F);if(G)D=M(G)}const E=new Set;for(const[G,J]of x){if(E.has(J))continue;if(G!==M(J))continue;E.add(J);if(D){if(D.includes("/")){if(G!==D)continue}else if(J.site!==D)continue}const L=V(J);B.push(L);I+=L.errors.length;H+=L.warnings.length}return{ok:I===0,results:B,errors:I,warnings:H,commands:B.length}}function V(q){const F=M(q),x=[],B=[];if(!q.description)B.push("Missing description");if(q.browser&&!q.domain)B.push('Browser command without "domain" — authenticated browser context may not work');if(Array.isArray(q.pipeline)){const H=U();for(let D=0;D<q.pipeline.length;D++){const E=q.pipeline[D];if(E&&typeof E==="object"){for(const G of Object.keys(E))if(!H.has(G))B.push(`Pipeline step ${D}: unknown step name "${G}" (did you mean one of: ${[...H].join(", ")}?)`)}}}const I=q;if(!q.func&&!q.pipeline&&!I._lazy)x.push('Command has neither "func" nor "pipeline" — it cannot execute');if(q.args&&q.args.length>0){const H=new Set;let D=!1;for(const E of q.args){if(H.has(E.name))x.push(`Duplicate arg name "${E.name}"`);H.add(E.name);if(E.positional&&D)B.push(`Positional arg "${E.name}" appears after named args`);if(!E.positional)D=!0}}return{label:F,errors:x,warnings:B}}export function renderValidationReport(q){const F=[`ppcli validate: ${q.ok?"PASS":"FAIL"}`,`Checked ${q.commands} command(s)`,`Errors: ${q.errors}  Warnings: ${q.warnings}`];for(const x of q.results)if(x.errors.length>0||x.warnings.length>0){F.push(`
-${x.label}:`);for(const B of x.errors)F.push(`  ❌ ${B}`);for(const B of x.warnings)F.push(`  ⚠️  ${B}`)}return F.join(`
+import{getRegistry as p,fullName as u}from"./registry.js";import{getRegisteredStepNames as g}from"./pipeline/registry.js";function m(){return new Set(g())}export function validateClisWithTarget(e,r){const n=p(),s=[];let l=0,a=0;if(n.size===0)return{ok:!0,results:[{label:"(registry)",errors:[],warnings:["Registry is empty — no commands discovered. Did discoverClis() run?"]}],errors:0,warnings:1,commands:0};let i=r;if(r?.includes("/")){const t=n.get(r);if(t)i=u(t)}const o=new Set;for(const[t,f]of n){if(o.has(f))continue;if(t!==u(f))continue;o.add(f);if(i){if(i.includes("/")){if(t!==i)continue}else if(f.site!==i)continue}const c=h(f);s.push(c);l+=c.errors.length;a+=c.warnings.length}return{ok:l===0,results:s,errors:l,warnings:a,commands:s.length}}function h(e){const r=u(e),n=[],s=[];if(!e.description)s.push("Missing description");if(e.browser&&!e.domain)s.push('Browser command without "domain" — authenticated browser context may not work');if(Array.isArray(e.pipeline)){const a=m();for(let i=0;i<e.pipeline.length;i++){const o=e.pipeline[i];if(o&&typeof o==="object"){for(const t of Object.keys(o))if(!a.has(t))s.push(`Pipeline step ${i}: unknown step name "${t}" (did you mean one of: ${[...a].join(", ")}?)`)}}}const l=e;if(!e.func&&!e.pipeline&&!l._lazy)n.push('Command has neither "func" nor "pipeline" — it cannot execute');if(e.args&&e.args.length>0){const a=new Set;let i=!1;for(const o of e.args){if(a.has(o.name))n.push(`Duplicate arg name "${o.name}"`);a.add(o.name);if(o.positional&&i)s.push(`Positional arg "${o.name}" appears after named args`);if(!o.positional)i=!0}}return{label:r,errors:n,warnings:s}}export function renderValidationReport(e){const r=[`ppcli validate: ${e.ok?"PASS":"FAIL"}`,`Checked ${e.commands} command(s)`,`Errors: ${e.errors}  Warnings: ${e.warnings}`];for(const n of e.results)if(n.errors.length>0||n.warnings.length>0){r.push(`
+${n.label}:`);for(const s of n.errors)r.push(`  ❌ ${s}`);for(const s of n.warnings)r.push(`  ⚠️  ${s}`)}return r.join(`
 `)}

package/dist/src/verify.js

@@ -1,2 +1,2 @@
-import{validateClisWithTarget as I,renderValidationReport as J}from"./validate.js";import{spawn as K}from"node:child_process";import*as L from"node:fs";import*as H from"node:path";export async function verifyClis(q){const y=I([q.builtinClis,q.userClis],q.target);let z=null;if(q.smoke)z=await M(q.builtinClis);return{ok:y.ok&&(z?.ok??!0),validation:y,smoke:z}}export function renderVerifyReport(q){const y=J(q.validation);if(!q.smoke)return y;const z=q.smoke.ok?"PASS":"FAIL",B=q.smoke.executed?"executed":"skipped";return`${y}
-Smoke: ${z} (${B}) — ${q.smoke.summary}`}async function M(q){const y=H.resolve(q,".."),z=H.join(y,"tests","smoke");if(!L.existsSync(z))return{requested:!0,executed:!1,ok:!1,summary:"Smoke tests are unavailable in this package/environment."};const B=process.platform==="win32"?"npx.cmd":"npx";return new Promise((F)=>{const E=K(B,["vitest","run","tests/smoke/","--reporter=dot"],{cwd:y,env:{...process.env},stdio:["ignore","pipe","pipe"]});let G="";E.stderr.on("data",(A)=>{G+=A.toString()});E.on("error",(A)=>{F({requested:!0,executed:!1,ok:!1,summary:`Failed to start smoke tests: ${A.message}`})});E.on("close",(A)=>{F({requested:!0,executed:!0,ok:A===0,summary:A===0?"tests/smoke passed":G.trim()||`vitest exited with code ${A}`})})})}
+import{validateClisWithTarget as u,renderValidationReport as c}from"./validate.js";import{spawn as d}from"node:child_process";import*as l from"node:fs";import*as m from"node:path";export async function verifyClis(e){const t=u([e.builtinClis,e.userClis],e.target);let s=null;if(e.smoke)s=await k(e.builtinClis);return{ok:t.ok&&(s?.ok??!0),validation:t,smoke:s}}export function renderVerifyReport(e){const t=c(e.validation);if(!e.smoke)return t;const s=e.smoke.ok?"PASS":"FAIL",o=e.smoke.executed?"executed":"skipped";return`${t}
+Smoke: ${s} (${o}) — ${e.smoke.summary}`}async function k(e){const t=m.resolve(e,".."),s=m.join(t,"tests","smoke");if(!l.existsSync(s))return{requested:!0,executed:!1,ok:!1,summary:"Smoke tests are unavailable in this package/environment."};const o=process.platform==="win32"?"npx.cmd":"npx";return new Promise((n)=>{const i=d(o,["vitest","run","tests/smoke/","--reporter=dot"],{cwd:t,env:{...process.env},stdio:["ignore","pipe","pipe"]});let a="";i.stderr.on("data",(r)=>{a+=r.toString()});i.on("error",(r)=>{n({requested:!0,executed:!1,ok:!1,summary:`Failed to start smoke tests: ${r.message}`})});i.on("close",(r)=>{n({requested:!0,executed:!0,ok:r===0,summary:r===0?"tests/smoke passed":a.trim()||`vitest exited with code ${r}`})})})}

package/dist/src/version.js

@@ -1 +1 @@
-import*as q from"node:fs";import*as b from"node:path";import{fileURLToPath as x}from"node:url";const y=b.dirname(x(import.meta.url));let j=b.resolve(y,"..");if(!q.existsSync(b.join(j,"package.json")))j=b.resolve(j,"..");const z=b.join(j,"package.json");export const PKG_VERSION=(()=>{try{return JSON.parse(q.readFileSync(z,"utf-8")).version}catch{return"0.0.0"}})();
+import*as e from"node:fs";import*as r from"node:path";import{fileURLToPath as t}from"node:url";const a=r.dirname(t(import.meta.url));let o=r.resolve(a,"..");if(!e.existsSync(r.join(o,"package.json")))o=r.resolve(o,"..");const n=r.join(o,"package.json");export const PKG_VERSION=(()=>{try{return JSON.parse(e.readFileSync(n,"utf-8")).version}catch{return"0.0.0"}})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "publishport-opencli",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "publishConfig": {
     "access": "public",
     "provenance": false