@agimon-ai/foundation-process-registry 0.7.0 → 0.8.2

package/README.md

@@ -0,0 +1,41 @@
+# @agimon-ai/foundation-process-registry
+
+Long-running process registry and cleanup coordination across worktrees.
+
+## Tags
+
+Registrations can carry tags through the `tags` field on process registration requests.
+
+The registry also reads `PROCESS_REGISTRY_TAG` and adds that value automatically to every registration.
+
+- A single value is treated as one tag.
+- Comma-separated values are split into multiple tags.
+- Explicit `tags` and `PROCESS_REGISTRY_TAG` are merged and deduplicated.
+
+## Releasing by tag
+
+Use the CLI to kill and release registrations by tag:
+
+```bash
+process-registry release-process --repository-path /path/to/worktree --tag api
+```
+
+Repeat `--tag` to match multiple tags:
+
+```bash
+process-registry release-process --repository-path /path/to/worktree --tag api --tag worker
+```
+
+## Example
+
+```ts
+import { createProcessLease } from '@agimon-ai/foundation-process-registry';
+
+const lease = await createProcessLease({
+  repositoryPath: '/path/to/worktree',
+  serviceName: 'mcp-proxy-http',
+  tags: ['api', 'http'],
+});
+
+await lease.release({ kill: true, releasePort: true });
+```

package/dist/ProcessRegistryService.cjs

@@ -1,2 +1,2 @@
-var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`node:crypto`),l=require(`node:fs`);l=s(l);let u=require(`node:fs/promises`);u=s(u);let d=require(`node:path`);d=s(d);let f=require(`@agimon-ai/foundation-port-registry`),p=require(`zod`),m=require(`node:os`);m=s(m);const h=p.z.enum([`service`,`tool`]),g=p.z.record(p.z.string(),p.z.unknown()),_=p.z.object({repositoryPath:p.z.string().trim().min(1,`repositoryPath is required`),serviceName:p.z.string().trim().min(1,`serviceName is required`),serviceType:h,environment:p.z.string().trim().min(1).optional(),pid:p.z.number().int().min(1),port:p.z.number().int().min(1).max(65535).optional(),host:p.z.string().trim().min(1).optional(),command:p.z.string().trim().min(1).optional(),args:p.z.array(p.z.string()).optional(),metadata:g.optional(),createdAt:p.z.string().trim().min(1),updatedAt:p.z.string().trim().min(1)}),v=p.z.object({version:p.z.literal(1),updatedAt:p.z.string().trim().min(1),entries:p.z.array(_)}),y=p.z.object({repositoryPath:p.z.string().trim().min(1),serviceName:p.z.string().trim().min(1),serviceType:h.default(`service`),environment:p.z.string().trim().min(1).optional(),pid:p.z.number().int().min(1),port:p.z.number().int().min(1).max(65535).optional(),host:p.z.string().trim().min(1).optional(),command:p.z.string().trim().min(1).optional(),args:p.z.array(p.z.string()).optional(),metadata:g.optional(),force:p.z.boolean().optional()}),b=p.z.object({repositoryPath:p.z.string().trim().min(1),serviceName:p.z.string().trim().min(1),serviceType:h.optional(),pid:p.z.number().int().min(1).optional(),environment:p.z.string().trim().min(1).optional(),force:p.z.boolean().optional(),kill:p.z.boolean().optional().default(!0),releasePort:p.z.boolean().optional().default(!0)}),x=p.z.object({repositoryPath:p.z.string().trim().min(1).optional(),serviceType:h.optional(),serviceName:p.z.string().trim().min(1).optional(),environment:p.z.string().trim().min(1).optional()}),S=p.z.object({success:p.z.boolean(),pid:p.z.number().int().min(1).optional(),record:_.optional(),error:p.z.string().optional()});var C=class extends Error{code;constructor(e,t,n){super(e,n),this.name=`ProcessRegistryError`,this.code=t}};const w=d.default.join(m.default.homedir(),`.process-registry`,`processes.json`),T=`${w}.lock`,E=e=>d.default.resolve(e),D=e=>`${e}.${(0,c.randomBytes)(6).toString(`hex`)}.tmp`;function O(e,t){if(!e)return;let n=d.default.resolve(e);return d.default.extname(n)===`.json`?d.default.join(d.default.dirname(n),t):d.default.join(n,t)}var k=class e{registryPath;lockPath;activeLockToken;lockCleanupHandlers=new Map;constructor(t=w,n,r=new f.PortRegistryService(process.env.PORT_REGISTRY_PATH)){this.portRegistry=r,this.registryPath=e.resolveRegistryPath(t),this.lockPath=n??`${this.registryPath}.lock`}static resolveRegistryPath(e){if(!e)return w;let t=d.default.isAbsolute(e)?e:d.default.join(process.cwd(),e);return d.default.extname(t)===`.json`?t:d.default.join(t,`processes.json`)}async registerProcess(e){let t=y.parse(e);return this.withLock(async()=>{let e=await this.loadState(),n=E(t.repositoryPath),r=t.serviceType??`service`,i=t.environment??process.env.NODE_ENV??`development`,a=await this.pruneState(e),o=this.findEntry(a,{repositoryPath:n,serviceName:t.serviceName,serviceType:r,environment:i});if(o){if(o.pid===t.pid)return o.updatedAt=new Date().toISOString(),o.port=t.port??o.port,o.host=t.host??o.host,o.command=t.command??o.command,o.args=t.args??o.args,o.metadata=t.metadata??o.metadata,await this.saveState(a),this.createSuccessResponse(t.pid,o);let e=this.isProcessRunning(o.pid);if(e&&!(t.force??!0))return this.createFailureResponse(`Process already registered for ${t.serviceName} in requested scope`);e&&await this.terminateProcess(o.pid),await this.releaseAssociatedPort(o),this.removeMatchingEntries(a,{repositoryPath:n,serviceName:t.serviceName,serviceType:r,environment:i})}let s=new Date().toISOString(),c={repositoryPath:n,serviceName:t.serviceName,serviceType:r,environment:i,pid:t.pid,port:t.port,host:t.host,command:t.command,args:t.args,metadata:t.metadata,createdAt:s,updatedAt:s};return a.entries.push(c),await this.saveState(a),this.createSuccessResponse(t.pid,c)})}async releaseProcess(e){let t=b.parse(e);return this.withLock(async()=>{let e=await this.loadState(),n=await this.pruneMissingRepositories(e),r=E(t.repositoryPath),i=t.serviceType??`service`,a=t.environment??process.env.NODE_ENV??`development`,o=n.entries.filter(e=>!(e.repositoryPath!==r||e.serviceName!==t.serviceName||e.serviceType!==i||t.environment&&e.environment!==a||typeof t.pid==`number`&&e.pid!==t.pid));if(o.length===0)return this.createFailureResponse(`No matching process entry for ${t.serviceName}`);let s=[],c=new Set;for(let e of o){let n=this.entryKey(e);try{(t.kill??!0)&&this.isProcessRunning(e.pid)&&await this.terminateProcess(e.pid),(t.releasePort??!0)&&await this.releaseAssociatedPort(e),c.add(n)}catch(t){s.push(`${e.serviceName} (pid ${e.pid}): ${t instanceof Error?t.message:String(t)}`)}}return c.size>0&&(n.entries=n.entries.filter(e=>!c.has(this.entryKey(e))),await this.saveState(n)),s.length>0?this.createFailureResponse(s.join(`; `)):this.createSuccessResponse()})}async listProcesses(e={}){let t=x.parse(e);return this.withLock(async()=>{let e=await this.loadState();return[...(await this.pruneState(e)).entries].filter(e=>!(t.repositoryPath&&e.repositoryPath!==E(t.repositoryPath)||t.serviceType&&e.serviceType!==t.serviceType||t.serviceName&&e.serviceName!==t.serviceName||t.environment&&e.environment!==t.environment))})}async withLock(e){let t=`${process.pid}-${(0,c.randomBytes)(6).toString(`hex`)}`;await this.acquireLock(t);try{return await e()}finally{await this.releaseLock(t)}}async loadState(){await u.default.mkdir(d.default.dirname(this.registryPath),{recursive:!0});try{let e=await u.default.readFile(this.registryPath,`utf-8`),t=JSON.parse(e);return v.parse(t)}catch(e){let t=e;if(t.code===`ENOENT`)return{version:1,updatedAt:new Date().toISOString(),entries:[]};if(t instanceof SyntaxError){let e=`${this.registryPath}.corrupt.${Date.now()}`;await u.default.rename(this.registryPath,e).catch(()=>void 0)}throw new C(`Failed to read registry file: ${e instanceof Error?e.message:String(e)}`,`REGISTRY_READ_FAILED`,{cause:e})}}async saveState(e){await u.default.mkdir(d.default.dirname(this.registryPath),{recursive:!0});let t={...e,updatedAt:new Date().toISOString(),entries:[...e.entries]},n=D(this.registryPath);await u.default.writeFile(n,JSON.stringify(t,null,2),`utf-8`),await u.default.rename(n,this.registryPath)}async pruneState(e){let t=await this.pruneMissingRepositories(e);return this.pruneDeadProcesses(t)}async pruneMissingRepositories(e){let t=(await Promise.all(e.entries.map(async e=>({entry:e,exists:await this.pathExists(e.repositoryPath)})))).filter(e=>e.exists).map(e=>e.entry);return t.length!==e.entries.length&&(e.entries=t,await this.saveState(e)),e}async pruneDeadProcesses(e){let t=[],n=!1;for(let r of e.entries){if(this.isProcessRunning(r.pid)){t.push(r);continue}n=!0,await this.releaseAssociatedPort(r)}return n&&(e.entries=t,await this.saveState(e)),e}async acquireLock(e){await u.default.mkdir(d.default.dirname(this.lockPath),{recursive:!0});for(let t=0;t<80;t+=1)try{let t={pid:process.pid,token:e,createdAt:new Date().toISOString()};await u.default.writeFile(this.lockPath,JSON.stringify(t),{flag:`wx`}),this.registerLockCleanup(e);return}catch(e){if(e.code!==`EEXIST`)throw new C(`Failed to acquire registry lock: ${e instanceof Error?e.message:String(e)}`,`REGISTRY_LOCK_FAILED`,{cause:e});if(await this.isStaleLock()){await u.default.unlink(this.lockPath).catch(()=>void 0),--t;continue}await this.delay(75)}throw new C(`Unable to acquire registry lock (timeout)`,`REGISTRY_LOCK_FAILED`)}async releaseLock(e){try{let t=await u.default.readFile(this.lockPath,`utf-8`);JSON.parse(t).token===e&&await u.default.unlink(this.lockPath)}catch{}finally{this.unregisterLockCleanup(e)}}async isStaleLock(){try{let e=await u.default.readFile(this.lockPath,`utf-8`),t=JSON.parse(e);if(t.pid&&this.isProcessRunning(t.pid)){let e=Date.now()-new Date(t.createdAt).getTime();return!(Number.isFinite(e)&&e<5e3)}return!0}catch{return!0}}isProcessRunning(e){try{return process.kill(e,0),!0}catch{return!1}}registerLockCleanup(e){this.unregisterLockCleanup(this.activeLockToken),this.activeLockToken=e;let t=()=>{this.releaseLockSync(e)};for(let e of[`exit`,`SIGINT`,`SIGTERM`,`uncaughtException`,`unhandledRejection`])process.once(e,t),this.lockCleanupHandlers.set(e,t)}unregisterLockCleanup(e){if(!(!e||this.activeLockToken!==e)){for(let[e,t]of this.lockCleanupHandlers)process.off(e,t);this.lockCleanupHandlers.clear(),this.activeLockToken=void 0}}releaseLockSync(e){try{let t=l.default.readFileSync(this.lockPath,`utf-8`);JSON.parse(t).token===e&&l.default.unlinkSync(this.lockPath)}catch{}}async terminateProcess(e){try{process.kill(e,0)}catch{return}try{process.kill(e,`SIGTERM`)}catch(t){if(t.code===`ESRCH`)return;throw Error(`Failed to send SIGTERM to process ${e}: ${t instanceof Error?t.message:String(t)}`,{cause:t})}if(await this.delay(500),this.isProcessRunning(e)){try{process.kill(e,`SIGKILL`)}catch(t){if(t.code===`ESRCH`)return;throw Error(`Failed to send SIGKILL to process ${e}: ${t instanceof Error?t.message:String(t)}`,{cause:t})}if(await this.delay(250),this.isProcessRunning(e))throw Error(`Process ${e} did not exit after SIGKILL`)}}async releaseAssociatedPort(e){if(!(!this.portRegistry||!e.port))try{let t=await this.portRegistry.releasePort({repositoryPath:e.repositoryPath,serviceName:e.serviceName,serviceType:e.serviceType,environment:e.environment,pid:e.pid,force:!0});if(!t.success&&t.error&&!t.error.includes(`No matching registry entry`))throw Error(t.error)}catch{}}entryKey(e){return[e.repositoryPath,e.serviceName,e.serviceType,e.environment??``,String(e.pid)].join(`|`)}findEntry(e,t){return e.entries.find(e=>e.repositoryPath===t.repositoryPath&&e.serviceName===t.serviceName&&e.serviceType===t.serviceType&&(t.environment?e.environment===t.environment:!0))}removeMatchingEntries(e,t){e.entries=e.entries.filter(e=>!(e.repositoryPath===t.repositoryPath&&e.serviceName===t.serviceName&&e.serviceType===t.serviceType&&(!t.environment||e.environment===t.environment)))}createSuccessResponse(e,t){return S.parse({success:!0,...typeof e==`number`?{pid:e}:{},...t?{record:t}:{}})}createFailureResponse(e){return S.parse({success:!1,error:e})}async pathExists(e){try{return await u.default.access(e),!0}catch{return!1}}delay(e){return new Promise(t=>setTimeout(t,e))}};Object.defineProperty(exports,`_`,{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return 75}}),Object.defineProperty(exports,`b`,{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return E}}),Object.defineProperty(exports,`d`,{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,`f`,{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,`g`,{enumerable:!0,get:function(){return 1}}),Object.defineProperty(exports,`h`,{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return 80}}),Object.defineProperty(exports,`l`,{enumerable:!0,get:function(){return O}}),Object.defineProperty(exports,`m`,{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return T}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return 5e3}}),Object.defineProperty(exports,`p`,{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return D}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return k}}),Object.defineProperty(exports,`u`,{enumerable:!0,get:function(){return x}}),Object.defineProperty(exports,`v`,{enumerable:!0,get:function(){return b}}),Object.defineProperty(exports,`y`,{enumerable:!0,get:function(){return h}});
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`node:crypto`),l=require(`node:os`);l=s(l);let u=require(`node:path`);u=s(u);let d=require(`node:fs`);d=s(d);let f=require(`node:fs/promises`);f=s(f);let p=require(`@agimon-ai/foundation-port-registry`),m=require(`zod`);const h=u.default.join(l.default.homedir(),`.process-registry`,`processes.json`),g=`${h}.lock`,_=`PROCESS_REGISTRY_TAG`,v=e=>u.default.resolve(e),y=e=>`${e}.${(0,c.randomBytes)(6).toString(`hex`)}.tmp`;function b(e){let t=S(e),n=S(process.env[_]),r=[...t??[],...n??[]];if(r.length!==0)return Array.from(new Set(r))}function x(e,t){if(!e)return;let n=u.default.resolve(e);return u.default.extname(n)===`.json`?u.default.join(u.default.dirname(n),t):u.default.join(n,t)}function S(e){if(e===void 0)return;let t=(Array.isArray(e)?e:e.split(`,`).map(e=>e.trim()).filter(e=>e.length>0)).map(e=>e.trim()).filter(e=>e.length>0);return t.length>0?t:void 0}const C=m.z.enum([`service`,`tool`]),w=m.z.record(m.z.string(),m.z.unknown()),T=m.z.object({repositoryPath:m.z.string().trim().min(1,`repositoryPath is required`),serviceName:m.z.string().trim().min(1,`serviceName is required`),serviceType:C,environment:m.z.string().trim().min(1).optional(),pid:m.z.number().int().min(1),port:m.z.number().int().min(1).max(65535).optional(),host:m.z.string().trim().min(1).optional(),command:m.z.string().trim().min(1).optional(),args:m.z.array(m.z.string()).optional(),tags:m.z.array(m.z.string().trim().min(1)).optional(),metadata:w.optional(),createdAt:m.z.string().trim().min(1),updatedAt:m.z.string().trim().min(1)}),E=m.z.object({version:m.z.literal(1),updatedAt:m.z.string().trim().min(1),entries:m.z.array(T)}),D=m.z.object({repositoryPath:m.z.string().trim().min(1),serviceName:m.z.string().trim().min(1),serviceType:C.default(`service`),environment:m.z.string().trim().min(1).optional(),pid:m.z.number().int().min(1),port:m.z.number().int().min(1).max(65535).optional(),host:m.z.string().trim().min(1).optional(),command:m.z.string().trim().min(1).optional(),args:m.z.array(m.z.string()).optional(),tags:m.z.array(m.z.string().trim().min(1)).optional(),metadata:w.optional(),force:m.z.boolean().optional()}),O=m.z.object({repositoryPath:m.z.string().trim().min(1),serviceName:m.z.string().trim().min(1),serviceType:C.optional(),pid:m.z.number().int().min(1).optional(),environment:m.z.string().trim().min(1).optional(),tags:m.z.array(m.z.string().trim().min(1)).optional(),force:m.z.boolean().optional(),kill:m.z.boolean().optional().default(!0),releasePort:m.z.boolean().optional().default(!0)}),k=m.z.object({repositoryPath:m.z.string().trim().min(1).optional(),serviceType:C.optional(),serviceName:m.z.string().trim().min(1).optional(),environment:m.z.string().trim().min(1).optional(),tags:m.z.array(m.z.string().trim().min(1)).optional()}),A=m.z.object({success:m.z.boolean(),pid:m.z.number().int().min(1).optional(),record:T.optional(),error:m.z.string().optional()});var j=class extends Error{code;constructor(e,t,n){super(e,n),this.name=`ProcessRegistryError`,this.code=t}},M=class e{registryPath;lockPath;activeLockToken;lockCleanupHandlers=new Map;constructor(t=h,n,r=new p.PortRegistryService(process.env.PORT_REGISTRY_PATH)){this.portRegistry=r,this.registryPath=e.resolveRegistryPath(t),this.lockPath=n??`${this.registryPath}.lock`}static resolveRegistryPath(e){if(!e)return h;let t=u.default.isAbsolute(e)?e:u.default.join(process.cwd(),e);return u.default.extname(t)===`.json`?t:u.default.join(t,`processes.json`)}async registerProcess(e){let t=D.parse(e);return this.withLock(async()=>{let e=await this.loadState(),n=v(t.repositoryPath),r=t.serviceType??`service`,i=t.environment??process.env.NODE_ENV??`development`,a=b(t.tags),o=await this.pruneState(e),s=this.findEntry(o,{repositoryPath:n,serviceName:t.serviceName,serviceType:r,environment:i});if(s){if(s.pid===t.pid)return s.updatedAt=new Date().toISOString(),s.port=t.port??s.port,s.host=t.host??s.host,s.command=t.command??s.command,s.args=t.args??s.args,s.tags=a??s.tags,s.metadata=t.metadata??s.metadata,await this.saveState(o),this.createSuccessResponse(t.pid,s);let e=this.isProcessRunning(s.pid);if(e&&!(t.force??!0))return this.createFailureResponse(`Process already registered for ${t.serviceName} in requested scope`);e&&await this.terminateProcess(s.pid),await this.releaseAssociatedPort(s),this.removeMatchingEntries(o,{repositoryPath:n,serviceName:t.serviceName,serviceType:r,environment:i})}let c=new Date().toISOString(),l={repositoryPath:n,serviceName:t.serviceName,serviceType:r,environment:i,pid:t.pid,port:t.port,host:t.host,command:t.command,args:t.args,tags:a,metadata:t.metadata,createdAt:c,updatedAt:c};return o.entries.push(l),await this.saveState(o),this.createSuccessResponse(t.pid,l)})}async releaseProcess(e){let t=O.parse(e);return this.withLock(async()=>{let e=await this.loadState(),n=await this.pruneMissingRepositories(e),r=v(t.repositoryPath),i=t.serviceType??`service`,a=t.environment??process.env.NODE_ENV??`development`,o=N(t.tags),s=n.entries.filter(e=>!(e.repositoryPath!==r||e.serviceName!==t.serviceName||e.serviceType!==i||t.environment&&e.environment!==a||typeof t.pid==`number`&&e.pid!==t.pid||o&&o.length>0&&!this.matchesTags(e.tags,o)));if(s.length===0)return this.createFailureResponse(`No matching process entry for ${t.serviceName}`);let c=[],l=new Set;for(let e of s){let n=this.entryKey(e);try{(t.kill??!0)&&this.isProcessRunning(e.pid)&&await this.terminateProcess(e.pid),(t.releasePort??!0)&&await this.releaseAssociatedPort(e),l.add(n)}catch(t){c.push(`${e.serviceName} (pid ${e.pid}): ${t instanceof Error?t.message:String(t)}`)}}return l.size>0&&(n.entries=n.entries.filter(e=>!l.has(this.entryKey(e))),await this.saveState(n)),c.length>0?this.createFailureResponse(c.join(`; `)):this.createSuccessResponse()})}async listProcesses(e={}){let t=k.parse(e);return this.withLock(async()=>{let e=await this.loadState(),n=await this.pruneState(e),r=N(t.tags);return[...n.entries].filter(e=>!(t.repositoryPath&&e.repositoryPath!==v(t.repositoryPath)||t.serviceType&&e.serviceType!==t.serviceType||t.serviceName&&e.serviceName!==t.serviceName||t.environment&&e.environment!==t.environment||r&&r.length>0&&!this.matchesTags(e.tags,r)))})}async withLock(e){let t=`${process.pid}-${(0,c.randomBytes)(6).toString(`hex`)}`;await this.acquireLock(t);try{return await e()}finally{await this.releaseLock(t)}}async loadState(){await f.default.mkdir(u.default.dirname(this.registryPath),{recursive:!0});try{let e=await f.default.readFile(this.registryPath,`utf-8`),t=JSON.parse(e);return E.parse(t)}catch(e){let t=e;if(t.code===`ENOENT`)return{version:1,updatedAt:new Date().toISOString(),entries:[]};if(t instanceof SyntaxError){let e=`${this.registryPath}.corrupt.${Date.now()}`;await f.default.rename(this.registryPath,e).catch(()=>void 0)}throw new j(`Failed to read registry file: ${e instanceof Error?e.message:String(e)}`,`REGISTRY_READ_FAILED`,{cause:e})}}async saveState(e){await f.default.mkdir(u.default.dirname(this.registryPath),{recursive:!0});let t={...e,updatedAt:new Date().toISOString(),entries:[...e.entries]},n=y(this.registryPath);await f.default.writeFile(n,JSON.stringify(t,null,2),`utf-8`),await f.default.rename(n,this.registryPath)}async pruneState(e){let t=await this.pruneMissingRepositories(e);return this.pruneDeadProcesses(t)}async pruneMissingRepositories(e){let t=(await Promise.all(e.entries.map(async e=>({entry:e,exists:await this.pathExists(e.repositoryPath)})))).filter(e=>e.exists).map(e=>e.entry);return t.length!==e.entries.length&&(e.entries=t,await this.saveState(e)),e}async pruneDeadProcesses(e){let t=[],n=!1;for(let r of e.entries){if(this.isProcessRunning(r.pid)){t.push(r);continue}n=!0,await this.releaseAssociatedPort(r)}return n&&(e.entries=t,await this.saveState(e)),e}async acquireLock(e){await f.default.mkdir(u.default.dirname(this.lockPath),{recursive:!0});for(let t=0;t<80;t+=1)try{let t={pid:process.pid,token:e,createdAt:new Date().toISOString()};await f.default.writeFile(this.lockPath,JSON.stringify(t),{flag:`wx`}),this.registerLockCleanup(e);return}catch(e){if(e.code!==`EEXIST`)throw new j(`Failed to acquire registry lock: ${e instanceof Error?e.message:String(e)}`,`REGISTRY_LOCK_FAILED`,{cause:e});if(await this.isStaleLock()){await f.default.unlink(this.lockPath).catch(()=>void 0),--t;continue}await this.delay(75)}throw new j(`Unable to acquire registry lock (timeout)`,`REGISTRY_LOCK_FAILED`)}async releaseLock(e){try{let t=await f.default.readFile(this.lockPath,`utf-8`);JSON.parse(t).token===e&&await f.default.unlink(this.lockPath)}catch{}finally{this.unregisterLockCleanup(e)}}async isStaleLock(){try{let e=await f.default.readFile(this.lockPath,`utf-8`),t=JSON.parse(e);if(t.pid&&this.isProcessRunning(t.pid)){let e=Date.now()-new Date(t.createdAt).getTime();return!(Number.isFinite(e)&&e<5e3)}return!0}catch{return!0}}isProcessRunning(e){try{return process.kill(e,0),!0}catch{return!1}}registerLockCleanup(e){this.unregisterLockCleanup(this.activeLockToken),this.activeLockToken=e;let t=()=>{this.releaseLockSync(e)};for(let e of[`exit`,`SIGINT`,`SIGTERM`,`uncaughtException`,`unhandledRejection`])process.once(e,t),this.lockCleanupHandlers.set(e,t)}unregisterLockCleanup(e){if(!(!e||this.activeLockToken!==e)){for(let[e,t]of this.lockCleanupHandlers)process.off(e,t);this.lockCleanupHandlers.clear(),this.activeLockToken=void 0}}releaseLockSync(e){try{let t=d.default.readFileSync(this.lockPath,`utf-8`);JSON.parse(t).token===e&&d.default.unlinkSync(this.lockPath)}catch{}}async terminateProcess(e){try{process.kill(e,0)}catch{return}try{process.kill(e,`SIGTERM`)}catch(t){if(t.code===`ESRCH`)return;throw Error(`Failed to send SIGTERM to process ${e}: ${t instanceof Error?t.message:String(t)}`,{cause:t})}if(await this.delay(500),this.isProcessRunning(e)){try{process.kill(e,`SIGKILL`)}catch(t){if(t.code===`ESRCH`)return;throw Error(`Failed to send SIGKILL to process ${e}: ${t instanceof Error?t.message:String(t)}`,{cause:t})}if(await this.delay(250),this.isProcessRunning(e))throw Error(`Process ${e} did not exit after SIGKILL`)}}async releaseAssociatedPort(e){if(!(!this.portRegistry||!e.port))try{let t=await this.portRegistry.releasePort({repositoryPath:e.repositoryPath,serviceName:e.serviceName,serviceType:e.serviceType,environment:e.environment,pid:e.pid,force:!0});if(!t.success&&t.error&&!t.error.includes(`No matching registry entry`))throw Error(t.error)}catch{}}entryKey(e){return[e.repositoryPath,e.serviceName,e.serviceType,e.environment??``,String(e.pid)].join(`|`)}findEntry(e,t){return e.entries.find(e=>e.repositoryPath===t.repositoryPath&&e.serviceName===t.serviceName&&e.serviceType===t.serviceType&&(t.environment?e.environment===t.environment:!0))}removeMatchingEntries(e,t){e.entries=e.entries.filter(e=>!(e.repositoryPath===t.repositoryPath&&e.serviceName===t.serviceName&&e.serviceType===t.serviceType&&(!t.environment||e.environment===t.environment)))}createSuccessResponse(e,t){return A.parse({success:!0,...typeof e==`number`?{pid:e}:{},...t?{record:t}:{}})}createFailureResponse(e){return A.parse({success:!1,error:e})}matchesTags(e,t){return t.length===0?!0:!e||e.length===0?!1:t.some(t=>e.includes(t))}async pathExists(e){try{return await f.default.access(e),!0}catch{return!1}}delay(e){return new Promise(t=>setTimeout(t,e))}};function N(e){if(e!==void 0)return Array.from(new Set(e.map(e=>e.trim()).filter(e=>e.length>0)))}Object.defineProperty(exports,`S`,{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,`_`,{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return T}}),Object.defineProperty(exports,`b`,{enumerable:!0,get:function(){return b}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return 1}}),Object.defineProperty(exports,`d`,{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,`f`,{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,`g`,{enumerable:!0,get:function(){return 5e3}}),Object.defineProperty(exports,`h`,{enumerable:!0,get:function(){return 75}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return j}}),Object.defineProperty(exports,`l`,{enumerable:!0,get:function(){return D}}),Object.defineProperty(exports,`m`,{enumerable:!0,get:function(){return 80}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return k}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return A}}),Object.defineProperty(exports,`p`,{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return E}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return M}}),Object.defineProperty(exports,`u`,{enumerable:!0,get:function(){return O}}),Object.defineProperty(exports,`v`,{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,`x`,{enumerable:!0,get:function(){return x}}),Object.defineProperty(exports,`y`,{enumerable:!0,get:function(){return v}});
 //# sourceMappingURL=ProcessRegistryService.cjs.map

package/dist/ProcessRegistryService.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ProcessRegistryService.cjs","names":["z","path","os","PortRegistryService","path","fs","fsSync"],"sources":["../src/types/index.ts","../src/utils/index.ts","../src/services/ProcessRegistryService.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport const REGISTRY_VERSION = 1 as const;\n\nexport const ServiceCategorySchema = z.enum(['service', 'tool']);\n\nexport const ProcessMetadataSchema = z.record(z.string(), z.unknown());\n\nexport const ProcessRegistryRecordSchema = z.object({\n  repositoryPath: z.string().trim().min(1, 'repositoryPath is required'),\n  serviceName: z.string().trim().min(1, 'serviceName is required'),\n  serviceType: ServiceCategorySchema,\n  environment: z.string().trim().min(1).optional(),\n  pid: z.number().int().min(1),\n  port: z.number().int().min(1).max(65535).optional(),\n  host: z.string().trim().min(1).optional(),\n  command: z.string().trim().min(1).optional(),\n  args: z.array(z.string()).optional(),\n  metadata: ProcessMetadataSchema.optional(),\n  createdAt: z.string().trim().min(1),\n  updatedAt: z.string().trim().min(1),\n});\n\nexport const ProcessRegistryStateSchema = z.object({\n  version: z.literal(REGISTRY_VERSION),\n  updatedAt: z.string().trim().min(1),\n  entries: z.array(ProcessRegistryRecordSchema),\n});\n\nexport const RegisterProcessRequestSchema = z.object({\n  repositoryPath: z.string().trim().min(1),\n  serviceName: z.string().trim().min(1),\n  serviceType: ServiceCategorySchema.default('service'),\n  environment: z.string().trim().min(1).optional(),\n  pid: z.number().int().min(1),\n  port: z.number().int().min(1).max(65535).optional(),\n  host: z.string().trim().min(1).optional(),\n  command: z.string().trim().min(1).optional(),\n  args: z.array(z.string()).optional(),\n  metadata: ProcessMetadataSchema.optional(),\n  force: z.boolean().optional(),\n});\n\nexport const ReleaseProcessRequestSchema = z.object({\n  repositoryPath: z.string().trim().min(1),\n  serviceName: z.string().trim().min(1),\n  serviceType: ServiceCategorySchema.optional(),\n  pid: z.number().int().min(1).optional(),\n  environment: z.string().trim().min(1).optional(),\n  force: z.boolean().optional(),\n  kill: z.boolean().optional().default(true),\n  releasePort: z.boolean().optional().default(true),\n});\n\nexport const ListProcessFiltersSchema = z.object({\n  repositoryPath: z.string().trim().min(1).optional(),\n  serviceType: ServiceCategorySchema.optional(),\n  serviceName: z.string().trim().min(1).optional(),\n  environment: z.string().trim().min(1).optional(),\n});\n\nexport const ProcessRegistryResponseSchema = z.object({\n  success: z.boolean(),\n  pid: z.number().int().min(1).optional(),\n  record: ProcessRegistryRecordSchema.optional(),\n  error: z.string().optional(),\n});\n\nexport type ServiceCategory = z.infer<typeof ServiceCategorySchema>;\nexport type ProcessMetadata = z.infer<typeof ProcessMetadataSchema>;\nexport type ProcessRegistryRecord = z.infer<typeof ProcessRegistryRecordSchema>;\nexport type ProcessRegistryState = z.infer<typeof ProcessRegistryStateSchema>;\nexport type RegisterProcessRequest = z.infer<typeof RegisterProcessRequestSchema>;\nexport type ReleaseProcessRequest = z.infer<typeof ReleaseProcessRequestSchema>;\nexport type ListProcessFilters = z.infer<typeof ListProcessFiltersSchema>;\nexport type ProcessRegistryResponse = z.infer<typeof ProcessRegistryResponseSchema>;\n\nexport type ProcessRegistryErrorCode =\n  | 'INVALID_REQUEST'\n  | 'REGISTRY_READ_FAILED'\n  | 'REGISTRY_WRITE_FAILED'\n  | 'REGISTRY_LOCK_FAILED'\n  | 'NO_PROCESS_FOUND';\n\nexport class ProcessRegistryError extends Error {\n  readonly code: ProcessRegistryErrorCode;\n\n  constructor(message: string, code: ProcessRegistryErrorCode, options?: ErrorOptions) {\n    super(message, options);\n    this.name = 'ProcessRegistryError';\n    this.code = code;\n  }\n}\n","import { randomBytes } from 'node:crypto';\nimport os from 'node:os';\nimport path from 'node:path';\n\nexport const DEFAULT_REGISTRY_PATH = path.join(os.homedir(), '.process-registry', 'processes.json');\nexport const DEFAULT_REGISTRY_LOCK_PATH = `${DEFAULT_REGISTRY_PATH}.lock`;\nexport const LOCK_RETRY_DELAY_MS = 75;\nexport const LOCK_MAX_RETRIES = 80;\nexport const LOCK_STALE_AFTER_MS = 5_000;\n\nexport const normalizeRepositoryPath = (value: string): string => path.resolve(value);\n\nexport const makeTempPath = (filePath: string): string => {\n  const random = randomBytes(6).toString('hex');\n  return `${filePath}.${random}.tmp`;\n};\n\nexport function resolveSiblingRegistryPath(registryPath: string | undefined, fileName: string): string | undefined {\n  if (!registryPath) {\n    return undefined;\n  }\n\n  const resolved = path.resolve(registryPath);\n  if (path.extname(resolved) === '.json') {\n    return path.join(path.dirname(resolved), fileName);\n  }\n\n  return path.join(resolved, fileName);\n}\n","import { randomBytes } from 'node:crypto';\nimport fsSync from 'node:fs';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { PortRegistryService } from '@agimon-ai/foundation-port-registry';\nimport {\n  type ListProcessFilters,\n  ListProcessFiltersSchema,\n  ProcessRegistryError,\n  type ProcessRegistryRecord,\n  type ProcessRegistryResponse,\n  ProcessRegistryResponseSchema,\n  type ProcessRegistryState,\n  ProcessRegistryStateSchema,\n  REGISTRY_VERSION,\n  type RegisterProcessRequest,\n  RegisterProcessRequestSchema,\n  type ReleaseProcessRequest,\n  ReleaseProcessRequestSchema,\n} from '../types';\nimport {\n  DEFAULT_REGISTRY_PATH,\n  LOCK_MAX_RETRIES,\n  LOCK_RETRY_DELAY_MS,\n  LOCK_STALE_AFTER_MS,\n  makeTempPath,\n  normalizeRepositoryPath,\n} from '../utils';\n\ninterface LockState {\n  pid: number;\n  token: string;\n  createdAt: string;\n}\n\ninterface NormalizedFilters {\n  repositoryPath: string;\n  serviceName: string;\n  serviceType: 'service' | 'tool';\n  environment?: string;\n}\n\ntype LockCleanupEvent = 'exit' | 'SIGINT' | 'SIGTERM' | 'uncaughtException' | 'unhandledRejection';\n\ntype PortRegistryCleanup = Pick<PortRegistryService, 'releasePort'>;\n\nexport class ProcessRegistryService {\n  private readonly registryPath: string;\n  private readonly lockPath: string;\n  private activeLockToken?: string;\n  private readonly lockCleanupHandlers = new Map<LockCleanupEvent, (...args: unknown[]) => void>();\n\n  constructor(\n    registryPath: string = DEFAULT_REGISTRY_PATH,\n    lockPath?: string,\n    private readonly portRegistry: PortRegistryCleanup = new PortRegistryService(process.env.PORT_REGISTRY_PATH),\n  ) {\n    this.registryPath = ProcessRegistryService.resolveRegistryPath(registryPath);\n    this.lockPath = lockPath ?? `${this.registryPath}.lock`;\n  }\n\n  static resolveRegistryPath(inputPath?: string): string {\n    if (!inputPath) {\n      return DEFAULT_REGISTRY_PATH;\n    }\n\n    const resolvedPath = path.isAbsolute(inputPath) ? inputPath : path.join(process.cwd(), inputPath);\n    if (path.extname(resolvedPath) === '.json') {\n      return resolvedPath;\n    }\n\n    return path.join(resolvedPath, 'processes.json');\n  }\n\n  async registerProcess(rawRequest: RegisterProcessRequest): Promise<ProcessRegistryResponse> {\n    const request = RegisterProcessRequestSchema.parse(rawRequest);\n\n    return this.withLock(async () => {\n      const state = await this.loadState();\n      const normalizedRepo = normalizeRepositoryPath(request.repositoryPath);\n      const serviceType = request.serviceType ?? 'service';\n      const environment = request.environment ?? process.env.NODE_ENV ?? 'development';\n      const registry = await this.pruneState(state);\n      const existing = this.findEntry(registry, {\n        repositoryPath: normalizedRepo,\n        serviceName: request.serviceName,\n        serviceType,\n        environment,\n      });\n\n      if (existing) {\n        if (existing.pid === request.pid) {\n          existing.updatedAt = new Date().toISOString();\n          existing.port = request.port ?? existing.port;\n          existing.host = request.host ?? existing.host;\n          existing.command = request.command ?? existing.command;\n          existing.args = request.args ?? existing.args;\n          existing.metadata = request.metadata ?? existing.metadata;\n          await this.saveState(registry);\n          return this.createSuccessResponse(request.pid, existing);\n        }\n\n        const isAlive = this.isProcessRunning(existing.pid);\n        if (isAlive && !(request.force ?? true)) {\n          return this.createFailureResponse(`Process already registered for ${request.serviceName} in requested scope`);\n        }\n\n        if (isAlive) {\n          await this.terminateProcess(existing.pid);\n        }\n\n        await this.releaseAssociatedPort(existing);\n        this.removeMatchingEntries(registry, {\n          repositoryPath: normalizedRepo,\n          serviceName: request.serviceName,\n          serviceType,\n          environment,\n        });\n      }\n\n      const now = new Date().toISOString();\n      const record: ProcessRegistryRecord = {\n        repositoryPath: normalizedRepo,\n        serviceName: request.serviceName,\n        serviceType,\n        environment,\n        pid: request.pid,\n        port: request.port,\n        host: request.host,\n        command: request.command,\n        args: request.args,\n        metadata: request.metadata,\n        createdAt: now,\n        updatedAt: now,\n      };\n\n      registry.entries.push(record);\n      await this.saveState(registry);\n      return this.createSuccessResponse(request.pid, record);\n    });\n  }\n\n  async releaseProcess(rawRequest: ReleaseProcessRequest): Promise<ProcessRegistryResponse> {\n    const request = ReleaseProcessRequestSchema.parse(rawRequest);\n\n    return this.withLock(async () => {\n      const state = await this.loadState();\n      const registry = await this.pruneMissingRepositories(state);\n      const normalizedRepo = normalizeRepositoryPath(request.repositoryPath);\n      const serviceType = request.serviceType ?? 'service';\n      const environment = request.environment ?? process.env.NODE_ENV ?? 'development';\n      const matches = registry.entries.filter((entry) => {\n        if (entry.repositoryPath !== normalizedRepo) return false;\n        if (entry.serviceName !== request.serviceName) return false;\n        if (entry.serviceType !== serviceType) return false;\n        if (request.environment && entry.environment !== environment) return false;\n        if (typeof request.pid === 'number' && entry.pid !== request.pid) return false;\n        return true;\n      });\n\n      if (matches.length === 0) {\n        return this.createFailureResponse(`No matching process entry for ${request.serviceName}`);\n      }\n\n      const errors: string[] = [];\n      const removable = new Set<string>();\n\n      for (const entry of matches) {\n        const entryKey = this.entryKey(entry);\n\n        try {\n          if (request.kill ?? true) {\n            if (this.isProcessRunning(entry.pid)) {\n              await this.terminateProcess(entry.pid);\n            }\n          }\n\n          if (request.releasePort ?? true) {\n            await this.releaseAssociatedPort(entry);\n          }\n\n          removable.add(entryKey);\n        } catch (error) {\n          errors.push(\n            `${entry.serviceName} (pid ${entry.pid}): ${error instanceof Error ? error.message : String(error)}`,\n          );\n        }\n      }\n\n      if (removable.size > 0) {\n        registry.entries = registry.entries.filter((entry) => !removable.has(this.entryKey(entry)));\n        await this.saveState(registry);\n      }\n\n      if (errors.length > 0) {\n        return this.createFailureResponse(errors.join('; '));\n      }\n\n      return this.createSuccessResponse();\n    });\n  }\n\n  async listProcesses(filters: ListProcessFilters = {}): Promise<ProcessRegistryRecord[]> {\n    const request = ListProcessFiltersSchema.parse(filters);\n\n    return this.withLock(async () => {\n      const state = await this.loadState();\n      const registry = await this.pruneState(state);\n\n      return [...registry.entries].filter((entry) => {\n        if (request.repositoryPath && entry.repositoryPath !== normalizeRepositoryPath(request.repositoryPath)) {\n          return false;\n        }\n        if (request.serviceType && entry.serviceType !== request.serviceType) return false;\n        if (request.serviceName && entry.serviceName !== request.serviceName) return false;\n        if (request.environment && entry.environment !== request.environment) return false;\n        return true;\n      });\n    });\n  }\n\n  private async withLock<T>(callback: () => Promise<T>): Promise<T> {\n    const lockToken = `${process.pid}-${randomBytes(6).toString('hex')}`;\n    await this.acquireLock(lockToken);\n\n    try {\n      return await callback();\n    } finally {\n      await this.releaseLock(lockToken);\n    }\n  }\n\n  private async loadState(): Promise<ProcessRegistryState> {\n    await fs.mkdir(path.dirname(this.registryPath), { recursive: true });\n\n    try {\n      const content = await fs.readFile(this.registryPath, 'utf-8');\n      const parsed = JSON.parse(content);\n      return ProcessRegistryStateSchema.parse(parsed);\n    } catch (error) {\n      const sysError = error as NodeJS.ErrnoException;\n      if (sysError.code === 'ENOENT') {\n        return {\n          version: REGISTRY_VERSION,\n          updatedAt: new Date().toISOString(),\n          entries: [],\n        };\n      }\n\n      if (sysError instanceof SyntaxError) {\n        const backupPath = `${this.registryPath}.corrupt.${Date.now()}`;\n        await fs.rename(this.registryPath, backupPath).catch(() => undefined);\n      }\n\n      throw new ProcessRegistryError(\n        `Failed to read registry file: ${error instanceof Error ? error.message : String(error)}`,\n        'REGISTRY_READ_FAILED',\n        { cause: error },\n      );\n    }\n  }\n\n  private async saveState(state: ProcessRegistryState): Promise<void> {\n    await fs.mkdir(path.dirname(this.registryPath), { recursive: true });\n\n    const payload: ProcessRegistryState = {\n      ...state,\n      updatedAt: new Date().toISOString(),\n      entries: [...state.entries],\n    };\n\n    const tempPath = makeTempPath(this.registryPath);\n    await fs.writeFile(tempPath, JSON.stringify(payload, null, 2), 'utf-8');\n    await fs.rename(tempPath, this.registryPath);\n  }\n\n  private async pruneState(state: ProcessRegistryState): Promise<ProcessRegistryState> {\n    const repositoryPruned = await this.pruneMissingRepositories(state);\n    return this.pruneDeadProcesses(repositoryPruned);\n  }\n\n  private async pruneMissingRepositories(state: ProcessRegistryState): Promise<ProcessRegistryState> {\n    const entries = await Promise.all(\n      state.entries.map(async (entry) => ({\n        entry,\n        exists: await this.pathExists(entry.repositoryPath),\n      })),\n    );\n\n    const pruned = entries.filter((value) => value.exists).map((value) => value.entry);\n    if (pruned.length !== state.entries.length) {\n      state.entries = pruned;\n      await this.saveState(state);\n    }\n\n    return state;\n  }\n\n  private async pruneDeadProcesses(state: ProcessRegistryState): Promise<ProcessRegistryState> {\n    const aliveEntries: ProcessRegistryRecord[] = [];\n    let changed = false;\n\n    for (const entry of state.entries) {\n      if (this.isProcessRunning(entry.pid)) {\n        aliveEntries.push(entry);\n        continue;\n      }\n\n      changed = true;\n      await this.releaseAssociatedPort(entry);\n    }\n\n    if (changed) {\n      state.entries = aliveEntries;\n      await this.saveState(state);\n    }\n\n    return state;\n  }\n\n  private async acquireLock(token: string): Promise<void> {\n    await fs.mkdir(path.dirname(this.lockPath), { recursive: true });\n\n    for (let attempt = 0; attempt < LOCK_MAX_RETRIES; attempt += 1) {\n      try {\n        const lockState: LockState = {\n          pid: process.pid,\n          token,\n          createdAt: new Date().toISOString(),\n        };\n        await fs.writeFile(this.lockPath, JSON.stringify(lockState), { flag: 'wx' });\n        this.registerLockCleanup(token);\n        return;\n      } catch (error) {\n        if ((error as NodeJS.ErrnoException).code !== 'EEXIST') {\n          throw new ProcessRegistryError(\n            `Failed to acquire registry lock: ${error instanceof Error ? error.message : String(error)}`,\n            'REGISTRY_LOCK_FAILED',\n            { cause: error },\n          );\n        }\n\n        const stale = await this.isStaleLock();\n        if (stale) {\n          await fs.unlink(this.lockPath).catch(() => undefined);\n          attempt -= 1;\n          continue;\n        }\n\n        await this.delay(LOCK_RETRY_DELAY_MS);\n      }\n    }\n\n    throw new ProcessRegistryError('Unable to acquire registry lock (timeout)', 'REGISTRY_LOCK_FAILED');\n  }\n\n  private async releaseLock(token: string): Promise<void> {\n    try {\n      const existing = await fs.readFile(this.lockPath, 'utf-8');\n      const parsed = JSON.parse(existing) as { token: string };\n      if (parsed.token === token) {\n        await fs.unlink(this.lockPath);\n      }\n    } catch {\n      // ignore\n    } finally {\n      this.unregisterLockCleanup(token);\n    }\n  }\n\n  private async isStaleLock(): Promise<boolean> {\n    try {\n      const content = await fs.readFile(this.lockPath, 'utf-8');\n      const parsed = JSON.parse(content) as LockState;\n\n      if (parsed.pid) {\n        const pidAlive = this.isProcessRunning(parsed.pid);\n        if (pidAlive) {\n          const age = Date.now() - new Date(parsed.createdAt).getTime();\n          return !(Number.isFinite(age) && age < LOCK_STALE_AFTER_MS);\n        }\n      }\n\n      return true;\n    } catch {\n      return true;\n    }\n  }\n\n  private isProcessRunning(pid: number): boolean {\n    try {\n      process.kill(pid, 0);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private registerLockCleanup(token: string): void {\n    this.unregisterLockCleanup(this.activeLockToken);\n    this.activeLockToken = token;\n\n    const cleanup = (): void => {\n      this.releaseLockSync(token);\n    };\n\n    for (const event of [\n      'exit',\n      'SIGINT',\n      'SIGTERM',\n      'uncaughtException',\n      'unhandledRejection',\n    ] satisfies LockCleanupEvent[]) {\n      process.once(event, cleanup);\n      this.lockCleanupHandlers.set(event, cleanup);\n    }\n  }\n\n  private unregisterLockCleanup(token: string | undefined): void {\n    if (!token || this.activeLockToken !== token) {\n      return;\n    }\n\n    for (const [event, handler] of this.lockCleanupHandlers) {\n      process.off(event, handler);\n    }\n\n    this.lockCleanupHandlers.clear();\n    this.activeLockToken = undefined;\n  }\n\n  private releaseLockSync(token: string): void {\n    try {\n      const existing = fsSync.readFileSync(this.lockPath, 'utf-8');\n      const parsed = JSON.parse(existing) as { token?: string };\n      if (parsed.token === token) {\n        fsSync.unlinkSync(this.lockPath);\n      }\n    } catch {\n      // ignore best-effort cleanup\n    }\n  }\n\n  private async terminateProcess(pid: number): Promise<void> {\n    try {\n      process.kill(pid, 0);\n    } catch {\n      return;\n    }\n\n    try {\n      process.kill(pid, 'SIGTERM');\n    } catch (error) {\n      const sysError = error as NodeJS.ErrnoException;\n      if (sysError.code === 'ESRCH') {\n        return;\n      }\n\n      throw new Error(\n        `Failed to send SIGTERM to process ${pid}: ${error instanceof Error ? error.message : String(error)}`,\n        {\n          cause: error,\n        },\n      );\n    }\n\n    await this.delay(500);\n\n    if (!this.isProcessRunning(pid)) {\n      return;\n    }\n\n    try {\n      process.kill(pid, 'SIGKILL');\n    } catch (error) {\n      const sysError = error as NodeJS.ErrnoException;\n      if (sysError.code === 'ESRCH') {\n        return;\n      }\n\n      throw new Error(\n        `Failed to send SIGKILL to process ${pid}: ${error instanceof Error ? error.message : String(error)}`,\n        {\n          cause: error,\n        },\n      );\n    }\n\n    await this.delay(250);\n\n    if (this.isProcessRunning(pid)) {\n      throw new Error(`Process ${pid} did not exit after SIGKILL`);\n    }\n  }\n\n  private async releaseAssociatedPort(entry: ProcessRegistryRecord): Promise<void> {\n    if (!this.portRegistry || !entry.port) {\n      return;\n    }\n\n    try {\n      const result = await this.portRegistry.releasePort({\n        repositoryPath: entry.repositoryPath,\n        serviceName: entry.serviceName,\n        serviceType: entry.serviceType,\n        environment: entry.environment,\n        pid: entry.pid,\n        force: true,\n      });\n\n      if (!result.success && result.error && !result.error.includes('No matching registry entry')) {\n        throw new Error(result.error);\n      }\n    } catch {\n      // Best-effort cleanup: port release failures should not block process cleanup.\n    }\n  }\n\n  private entryKey(entry: ProcessRegistryRecord): string {\n    return [\n      entry.repositoryPath,\n      entry.serviceName,\n      entry.serviceType,\n      entry.environment ?? '',\n      String(entry.pid),\n    ].join('|');\n  }\n\n  private findEntry(state: ProcessRegistryState, filters: NormalizedFilters): ProcessRegistryRecord | undefined {\n    return state.entries.find(\n      (entry) =>\n        entry.repositoryPath === filters.repositoryPath &&\n        entry.serviceName === filters.serviceName &&\n        entry.serviceType === filters.serviceType &&\n        (filters.environment ? entry.environment === filters.environment : true),\n    );\n  }\n\n  private removeMatchingEntries(state: ProcessRegistryState, filters: NormalizedFilters): void {\n    state.entries = state.entries.filter(\n      (entry) =>\n        !(\n          entry.repositoryPath === filters.repositoryPath &&\n          entry.serviceName === filters.serviceName &&\n          entry.serviceType === filters.serviceType &&\n          (!filters.environment || entry.environment === filters.environment)\n        ),\n    );\n  }\n\n  private createSuccessResponse(pid?: number, record?: ProcessRegistryRecord): ProcessRegistryResponse {\n    return ProcessRegistryResponseSchema.parse({\n      success: true,\n      ...(typeof pid === 'number' ? { pid } : {}),\n      ...(record ? { record } : {}),\n    });\n  }\n\n  private createFailureResponse(error: string): ProcessRegistryResponse {\n    return ProcessRegistryResponseSchema.parse({\n      success: false,\n      error,\n    });\n  }\n\n  private async pathExists(candidate: string): Promise<boolean> {\n    try {\n      await fs.access(candidate);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"ProcessRegistryService.cjs","names":["path","os","normalizeTags","z","PortRegistryService","path","fs","fsSync"],"sources":["../src/utils/index.ts","../src/types/index.ts","../src/services/ProcessRegistryService.ts"],"sourcesContent":["import { randomBytes } from 'node:crypto';\nimport os from 'node:os';\nimport path from 'node:path';\n\nexport const DEFAULT_REGISTRY_PATH = path.join(os.homedir(), '.process-registry', 'processes.json');\nexport const DEFAULT_REGISTRY_LOCK_PATH = `${DEFAULT_REGISTRY_PATH}.lock`;\nexport const LOCK_RETRY_DELAY_MS = 75;\nexport const LOCK_MAX_RETRIES = 80;\nexport const LOCK_STALE_AFTER_MS = 5_000;\nexport const PROCESS_REGISTRY_TAG_ENV_VAR = 'PROCESS_REGISTRY_TAG';\n\nexport const normalizeRepositoryPath = (value: string): string => path.resolve(value);\n\nexport const makeTempPath = (filePath: string): string => {\n  const random = randomBytes(6).toString('hex');\n  return `${filePath}.${random}.tmp`;\n};\n\nexport function resolveProcessTags(tags?: string[]): string[] | undefined {\n  const resolved = normalizeTags(tags);\n  const envTags = normalizeTags(process.env[PROCESS_REGISTRY_TAG_ENV_VAR]);\n\n  const combined = [...(resolved ?? []), ...(envTags ?? [])];\n  if (combined.length === 0) {\n    return undefined;\n  }\n\n  return Array.from(new Set(combined));\n}\n\nexport function resolveSiblingRegistryPath(registryPath: string | undefined, fileName: string): string | undefined {\n  if (!registryPath) {\n    return undefined;\n  }\n\n  const resolved = path.resolve(registryPath);\n  if (path.extname(resolved) === '.json') {\n    return path.join(path.dirname(resolved), fileName);\n  }\n\n  return path.join(resolved, fileName);\n}\n\nfunction normalizeTags(tags: string[] | string | undefined): string[] | undefined {\n  if (tags === undefined) {\n    return undefined;\n  }\n\n  const values = Array.isArray(tags)\n    ? tags\n    : tags\n        .split(',')\n        .map((tag) => tag.trim())\n        .filter((tag) => tag.length > 0);\n\n  const normalized = values.map((tag) => tag.trim()).filter((tag) => tag.length > 0);\n  return normalized.length > 0 ? normalized : undefined;\n}\n","import { z } from 'zod';\n\nexport const REGISTRY_VERSION = 1 as const;\n\nexport const ServiceCategorySchema = z.enum(['service', 'tool']);\n\nexport const ProcessMetadataSchema = z.record(z.string(), z.unknown());\n\nexport const ProcessRegistryRecordSchema = z.object({\n  repositoryPath: z.string().trim().min(1, 'repositoryPath is required'),\n  serviceName: z.string().trim().min(1, 'serviceName is required'),\n  serviceType: ServiceCategorySchema,\n  environment: z.string().trim().min(1).optional(),\n  pid: z.number().int().min(1),\n  port: z.number().int().min(1).max(65535).optional(),\n  host: z.string().trim().min(1).optional(),\n  command: z.string().trim().min(1).optional(),\n  args: z.array(z.string()).optional(),\n  tags: z.array(z.string().trim().min(1)).optional(),\n  metadata: ProcessMetadataSchema.optional(),\n  createdAt: z.string().trim().min(1),\n  updatedAt: z.string().trim().min(1),\n});\n\nexport const ProcessRegistryStateSchema = z.object({\n  version: z.literal(REGISTRY_VERSION),\n  updatedAt: z.string().trim().min(1),\n  entries: z.array(ProcessRegistryRecordSchema),\n});\n\nexport const RegisterProcessRequestSchema = z.object({\n  repositoryPath: z.string().trim().min(1),\n  serviceName: z.string().trim().min(1),\n  serviceType: ServiceCategorySchema.default('service'),\n  environment: z.string().trim().min(1).optional(),\n  pid: z.number().int().min(1),\n  port: z.number().int().min(1).max(65535).optional(),\n  host: z.string().trim().min(1).optional(),\n  command: z.string().trim().min(1).optional(),\n  args: z.array(z.string()).optional(),\n  tags: z.array(z.string().trim().min(1)).optional(),\n  metadata: ProcessMetadataSchema.optional(),\n  force: z.boolean().optional(),\n});\n\nexport const ReleaseProcessRequestSchema = z.object({\n  repositoryPath: z.string().trim().min(1),\n  serviceName: z.string().trim().min(1),\n  serviceType: ServiceCategorySchema.optional(),\n  pid: z.number().int().min(1).optional(),\n  environment: z.string().trim().min(1).optional(),\n  tags: z.array(z.string().trim().min(1)).optional(),\n  force: z.boolean().optional(),\n  kill: z.boolean().optional().default(true),\n  releasePort: z.boolean().optional().default(true),\n});\n\nexport const ListProcessFiltersSchema = z.object({\n  repositoryPath: z.string().trim().min(1).optional(),\n  serviceType: ServiceCategorySchema.optional(),\n  serviceName: z.string().trim().min(1).optional(),\n  environment: z.string().trim().min(1).optional(),\n  tags: z.array(z.string().trim().min(1)).optional(),\n});\n\nexport const ProcessRegistryResponseSchema = z.object({\n  success: z.boolean(),\n  pid: z.number().int().min(1).optional(),\n  record: ProcessRegistryRecordSchema.optional(),\n  error: z.string().optional(),\n});\n\nexport type ServiceCategory = z.infer<typeof ServiceCategorySchema>;\nexport type ProcessMetadata = z.infer<typeof ProcessMetadataSchema>;\nexport type ProcessRegistryRecord = z.infer<typeof ProcessRegistryRecordSchema>;\nexport type ProcessRegistryState = z.infer<typeof ProcessRegistryStateSchema>;\nexport type RegisterProcessRequest = z.infer<typeof RegisterProcessRequestSchema>;\nexport type ReleaseProcessRequest = z.infer<typeof ReleaseProcessRequestSchema>;\nexport type ListProcessFilters = z.infer<typeof ListProcessFiltersSchema>;\nexport type ProcessRegistryResponse = z.infer<typeof ProcessRegistryResponseSchema>;\n\nexport type ProcessRegistryErrorCode =\n  | 'INVALID_REQUEST'\n  | 'REGISTRY_READ_FAILED'\n  | 'REGISTRY_WRITE_FAILED'\n  | 'REGISTRY_LOCK_FAILED'\n  | 'NO_PROCESS_FOUND';\n\nexport class ProcessRegistryError extends Error {\n  readonly code: ProcessRegistryErrorCode;\n\n  constructor(message: string, code: ProcessRegistryErrorCode, options?: ErrorOptions) {\n    super(message, options);\n    this.name = 'ProcessRegistryError';\n    this.code = code;\n  }\n}\n","import { randomBytes } from 'node:crypto';\nimport fsSync from 'node:fs';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { PortRegistryService } from '@agimon-ai/foundation-port-registry';\nimport {\n  type ListProcessFilters,\n  ListProcessFiltersSchema,\n  ProcessRegistryError,\n  type ProcessRegistryRecord,\n  type ProcessRegistryResponse,\n  ProcessRegistryResponseSchema,\n  type ProcessRegistryState,\n  ProcessRegistryStateSchema,\n  REGISTRY_VERSION,\n  type RegisterProcessRequest,\n  RegisterProcessRequestSchema,\n  type ReleaseProcessRequest,\n  ReleaseProcessRequestSchema,\n} from '../types';\nimport {\n  DEFAULT_REGISTRY_PATH,\n  LOCK_MAX_RETRIES,\n  LOCK_RETRY_DELAY_MS,\n  LOCK_STALE_AFTER_MS,\n  resolveProcessTags,\n  makeTempPath,\n  normalizeRepositoryPath,\n} from '../utils';\n\ninterface LockState {\n  pid: number;\n  token: string;\n  createdAt: string;\n}\n\ninterface NormalizedFilters {\n  repositoryPath: string;\n  serviceName: string;\n  serviceType: 'service' | 'tool';\n  environment?: string;\n  tags?: string[];\n}\n\ntype LockCleanupEvent = 'exit' | 'SIGINT' | 'SIGTERM' | 'uncaughtException' | 'unhandledRejection';\n\ntype PortRegistryCleanup = Pick<PortRegistryService, 'releasePort'>;\n\nexport class ProcessRegistryService {\n  private readonly registryPath: string;\n  private readonly lockPath: string;\n  private activeLockToken?: string;\n  private readonly lockCleanupHandlers = new Map<LockCleanupEvent, (...args: unknown[]) => void>();\n\n  constructor(\n    registryPath: string = DEFAULT_REGISTRY_PATH,\n    lockPath?: string,\n    private readonly portRegistry: PortRegistryCleanup = new PortRegistryService(process.env.PORT_REGISTRY_PATH),\n  ) {\n    this.registryPath = ProcessRegistryService.resolveRegistryPath(registryPath);\n    this.lockPath = lockPath ?? `${this.registryPath}.lock`;\n  }\n\n  static resolveRegistryPath(inputPath?: string): string {\n    if (!inputPath) {\n      return DEFAULT_REGISTRY_PATH;\n    }\n\n    const resolvedPath = path.isAbsolute(inputPath) ? inputPath : path.join(process.cwd(), inputPath);\n    if (path.extname(resolvedPath) === '.json') {\n      return resolvedPath;\n    }\n\n    return path.join(resolvedPath, 'processes.json');\n  }\n\n  async registerProcess(rawRequest: RegisterProcessRequest): Promise<ProcessRegistryResponse> {\n    const request = RegisterProcessRequestSchema.parse(rawRequest);\n\n    return this.withLock(async () => {\n      const state = await this.loadState();\n      const normalizedRepo = normalizeRepositoryPath(request.repositoryPath);\n      const serviceType = request.serviceType ?? 'service';\n      const environment = request.environment ?? process.env.NODE_ENV ?? 'development';\n      const tags = resolveProcessTags(request.tags);\n      const registry = await this.pruneState(state);\n      const existing = this.findEntry(registry, {\n        repositoryPath: normalizedRepo,\n        serviceName: request.serviceName,\n        serviceType,\n        environment,\n      });\n\n      if (existing) {\n        if (existing.pid === request.pid) {\n          existing.updatedAt = new Date().toISOString();\n          existing.port = request.port ?? existing.port;\n          existing.host = request.host ?? existing.host;\n          existing.command = request.command ?? existing.command;\n          existing.args = request.args ?? existing.args;\n          existing.tags = tags ?? existing.tags;\n          existing.metadata = request.metadata ?? existing.metadata;\n          await this.saveState(registry);\n          return this.createSuccessResponse(request.pid, existing);\n        }\n\n        const isAlive = this.isProcessRunning(existing.pid);\n        if (isAlive && !(request.force ?? true)) {\n          return this.createFailureResponse(`Process already registered for ${request.serviceName} in requested scope`);\n        }\n\n        if (isAlive) {\n          await this.terminateProcess(existing.pid);\n        }\n\n        await this.releaseAssociatedPort(existing);\n        this.removeMatchingEntries(registry, {\n          repositoryPath: normalizedRepo,\n          serviceName: request.serviceName,\n          serviceType,\n          environment,\n        });\n      }\n\n      const now = new Date().toISOString();\n      const record: ProcessRegistryRecord = {\n        repositoryPath: normalizedRepo,\n        serviceName: request.serviceName,\n        serviceType,\n        environment,\n        pid: request.pid,\n        port: request.port,\n        host: request.host,\n        command: request.command,\n        args: request.args,\n        tags,\n        metadata: request.metadata,\n        createdAt: now,\n        updatedAt: now,\n      };\n\n      registry.entries.push(record);\n      await this.saveState(registry);\n      return this.createSuccessResponse(request.pid, record);\n    });\n  }\n\n  async releaseProcess(rawRequest: ReleaseProcessRequest): Promise<ProcessRegistryResponse> {\n    const request = ReleaseProcessRequestSchema.parse(rawRequest);\n\n    return this.withLock(async () => {\n      const state = await this.loadState();\n      const registry = await this.pruneMissingRepositories(state);\n      const normalizedRepo = normalizeRepositoryPath(request.repositoryPath);\n      const serviceType = request.serviceType ?? 'service';\n      const environment = request.environment ?? process.env.NODE_ENV ?? 'development';\n      const requestedTags = normalizeTags(request.tags);\n      const matches = registry.entries.filter((entry) => {\n        if (entry.repositoryPath !== normalizedRepo) return false;\n        if (entry.serviceName !== request.serviceName) return false;\n        if (entry.serviceType !== serviceType) return false;\n        if (request.environment && entry.environment !== environment) return false;\n        if (typeof request.pid === 'number' && entry.pid !== request.pid) return false;\n        if (requestedTags && requestedTags.length > 0 && !this.matchesTags(entry.tags, requestedTags)) return false;\n        return true;\n      });\n\n      if (matches.length === 0) {\n        return this.createFailureResponse(`No matching process entry for ${request.serviceName}`);\n      }\n\n      const errors: string[] = [];\n      const removable = new Set<string>();\n\n      for (const entry of matches) {\n        const entryKey = this.entryKey(entry);\n\n        try {\n          if (request.kill ?? true) {\n            if (this.isProcessRunning(entry.pid)) {\n              await this.terminateProcess(entry.pid);\n            }\n          }\n\n          if (request.releasePort ?? true) {\n            await this.releaseAssociatedPort(entry);\n          }\n\n          removable.add(entryKey);\n        } catch (error) {\n          errors.push(\n            `${entry.serviceName} (pid ${entry.pid}): ${error instanceof Error ? error.message : String(error)}`,\n          );\n        }\n      }\n\n      if (removable.size > 0) {\n        registry.entries = registry.entries.filter((entry) => !removable.has(this.entryKey(entry)));\n        await this.saveState(registry);\n      }\n\n      if (errors.length > 0) {\n        return this.createFailureResponse(errors.join('; '));\n      }\n\n      return this.createSuccessResponse();\n    });\n  }\n\n  async listProcesses(filters: ListProcessFilters = {}): Promise<ProcessRegistryRecord[]> {\n    const request = ListProcessFiltersSchema.parse(filters);\n\n    return this.withLock(async () => {\n      const state = await this.loadState();\n      const registry = await this.pruneState(state);\n      const requestedTags = normalizeTags(request.tags);\n\n      return [...registry.entries].filter((entry) => {\n        if (request.repositoryPath && entry.repositoryPath !== normalizeRepositoryPath(request.repositoryPath)) {\n          return false;\n        }\n        if (request.serviceType && entry.serviceType !== request.serviceType) return false;\n        if (request.serviceName && entry.serviceName !== request.serviceName) return false;\n        if (request.environment && entry.environment !== request.environment) return false;\n        if (requestedTags && requestedTags.length > 0 && !this.matchesTags(entry.tags, requestedTags)) return false;\n        return true;\n      });\n    });\n  }\n\n  private async withLock<T>(callback: () => Promise<T>): Promise<T> {\n    const lockToken = `${process.pid}-${randomBytes(6).toString('hex')}`;\n    await this.acquireLock(lockToken);\n\n    try {\n      return await callback();\n    } finally {\n      await this.releaseLock(lockToken);\n    }\n  }\n\n  private async loadState(): Promise<ProcessRegistryState> {\n    await fs.mkdir(path.dirname(this.registryPath), { recursive: true });\n\n    try {\n      const content = await fs.readFile(this.registryPath, 'utf-8');\n      const parsed = JSON.parse(content);\n      return ProcessRegistryStateSchema.parse(parsed);\n    } catch (error) {\n      const sysError = error as NodeJS.ErrnoException;\n      if (sysError.code === 'ENOENT') {\n        return {\n          version: REGISTRY_VERSION,\n          updatedAt: new Date().toISOString(),\n          entries: [],\n        };\n      }\n\n      if (sysError instanceof SyntaxError) {\n        const backupPath = `${this.registryPath}.corrupt.${Date.now()}`;\n        await fs.rename(this.registryPath, backupPath).catch(() => undefined);\n      }\n\n      throw new ProcessRegistryError(\n        `Failed to read registry file: ${error instanceof Error ? error.message : String(error)}`,\n        'REGISTRY_READ_FAILED',\n        { cause: error },\n      );\n    }\n  }\n\n  private async saveState(state: ProcessRegistryState): Promise<void> {\n    await fs.mkdir(path.dirname(this.registryPath), { recursive: true });\n\n    const payload: ProcessRegistryState = {\n      ...state,\n      updatedAt: new Date().toISOString(),\n      entries: [...state.entries],\n    };\n\n    const tempPath = makeTempPath(this.registryPath);\n    await fs.writeFile(tempPath, JSON.stringify(payload, null, 2), 'utf-8');\n    await fs.rename(tempPath, this.registryPath);\n  }\n\n  private async pruneState(state: ProcessRegistryState): Promise<ProcessRegistryState> {\n    const repositoryPruned = await this.pruneMissingRepositories(state);\n    return this.pruneDeadProcesses(repositoryPruned);\n  }\n\n  private async pruneMissingRepositories(state: ProcessRegistryState): Promise<ProcessRegistryState> {\n    const entries = await Promise.all(\n      state.entries.map(async (entry) => ({\n        entry,\n        exists: await this.pathExists(entry.repositoryPath),\n      })),\n    );\n\n    const pruned = entries.filter((value) => value.exists).map((value) => value.entry);\n    if (pruned.length !== state.entries.length) {\n      state.entries = pruned;\n      await this.saveState(state);\n    }\n\n    return state;\n  }\n\n  private async pruneDeadProcesses(state: ProcessRegistryState): Promise<ProcessRegistryState> {\n    const aliveEntries: ProcessRegistryRecord[] = [];\n    let changed = false;\n\n    for (const entry of state.entries) {\n      if (this.isProcessRunning(entry.pid)) {\n        aliveEntries.push(entry);\n        continue;\n      }\n\n      changed = true;\n      await this.releaseAssociatedPort(entry);\n    }\n\n    if (changed) {\n      state.entries = aliveEntries;\n      await this.saveState(state);\n    }\n\n    return state;\n  }\n\n  private async acquireLock(token: string): Promise<void> {\n    await fs.mkdir(path.dirname(this.lockPath), { recursive: true });\n\n    for (let attempt = 0; attempt < LOCK_MAX_RETRIES; attempt += 1) {\n      try {\n        const lockState: LockState = {\n          pid: process.pid,\n          token,\n          createdAt: new Date().toISOString(),\n        };\n        await fs.writeFile(this.lockPath, JSON.stringify(lockState), { flag: 'wx' });\n        this.registerLockCleanup(token);\n        return;\n      } catch (error) {\n        if ((error as NodeJS.ErrnoException).code !== 'EEXIST') {\n          throw new ProcessRegistryError(\n            `Failed to acquire registry lock: ${error instanceof Error ? error.message : String(error)}`,\n            'REGISTRY_LOCK_FAILED',\n            { cause: error },\n          );\n        }\n\n        const stale = await this.isStaleLock();\n        if (stale) {\n          await fs.unlink(this.lockPath).catch(() => undefined);\n          attempt -= 1;\n          continue;\n        }\n\n        await this.delay(LOCK_RETRY_DELAY_MS);\n      }\n    }\n\n    throw new ProcessRegistryError('Unable to acquire registry lock (timeout)', 'REGISTRY_LOCK_FAILED');\n  }\n\n  private async releaseLock(token: string): Promise<void> {\n    try {\n      const existing = await fs.readFile(this.lockPath, 'utf-8');\n      const parsed = JSON.parse(existing) as { token: string };\n      if (parsed.token === token) {\n        await fs.unlink(this.lockPath);\n      }\n    } catch {\n      // ignore\n    } finally {\n      this.unregisterLockCleanup(token);\n    }\n  }\n\n  private async isStaleLock(): Promise<boolean> {\n    try {\n      const content = await fs.readFile(this.lockPath, 'utf-8');\n      const parsed = JSON.parse(content) as LockState;\n\n      if (parsed.pid) {\n        const pidAlive = this.isProcessRunning(parsed.pid);\n        if (pidAlive) {\n          const age = Date.now() - new Date(parsed.createdAt).getTime();\n          return !(Number.isFinite(age) && age < LOCK_STALE_AFTER_MS);\n        }\n      }\n\n      return true;\n    } catch {\n      return true;\n    }\n  }\n\n  private isProcessRunning(pid: number): boolean {\n    try {\n      process.kill(pid, 0);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private registerLockCleanup(token: string): void {\n    this.unregisterLockCleanup(this.activeLockToken);\n    this.activeLockToken = token;\n\n    const cleanup = (): void => {\n      this.releaseLockSync(token);\n    };\n\n    for (const event of [\n      'exit',\n      'SIGINT',\n      'SIGTERM',\n      'uncaughtException',\n      'unhandledRejection',\n    ] satisfies LockCleanupEvent[]) {\n      process.once(event, cleanup);\n      this.lockCleanupHandlers.set(event, cleanup);\n    }\n  }\n\n  private unregisterLockCleanup(token: string | undefined): void {\n    if (!token || this.activeLockToken !== token) {\n      return;\n    }\n\n    for (const [event, handler] of this.lockCleanupHandlers) {\n      process.off(event, handler);\n    }\n\n    this.lockCleanupHandlers.clear();\n    this.activeLockToken = undefined;\n  }\n\n  private releaseLockSync(token: string): void {\n    try {\n      const existing = fsSync.readFileSync(this.lockPath, 'utf-8');\n      const parsed = JSON.parse(existing) as { token?: string };\n      if (parsed.token === token) {\n        fsSync.unlinkSync(this.lockPath);\n      }\n    } catch {\n      // ignore best-effort cleanup\n    }\n  }\n\n  private async terminateProcess(pid: number): Promise<void> {\n    try {\n      process.kill(pid, 0);\n    } catch {\n      return;\n    }\n\n    try {\n      process.kill(pid, 'SIGTERM');\n    } catch (error) {\n      const sysError = error as NodeJS.ErrnoException;\n      if (sysError.code === 'ESRCH') {\n        return;\n      }\n\n      throw new Error(\n        `Failed to send SIGTERM to process ${pid}: ${error instanceof Error ? error.message : String(error)}`,\n        {\n          cause: error,\n        },\n      );\n    }\n\n    await this.delay(500);\n\n    if (!this.isProcessRunning(pid)) {\n      return;\n    }\n\n    try {\n      process.kill(pid, 'SIGKILL');\n    } catch (error) {\n      const sysError = error as NodeJS.ErrnoException;\n      if (sysError.code === 'ESRCH') {\n        return;\n      }\n\n      throw new Error(\n        `Failed to send SIGKILL to process ${pid}: ${error instanceof Error ? error.message : String(error)}`,\n        {\n          cause: error,\n        },\n      );\n    }\n\n    await this.delay(250);\n\n    if (this.isProcessRunning(pid)) {\n      throw new Error(`Process ${pid} did not exit after SIGKILL`);\n    }\n  }\n\n  private async releaseAssociatedPort(entry: ProcessRegistryRecord): Promise<void> {\n    if (!this.portRegistry || !entry.port) {\n      return;\n    }\n\n    try {\n      const result = await this.portRegistry.releasePort({\n        repositoryPath: entry.repositoryPath,\n        serviceName: entry.serviceName,\n        serviceType: entry.serviceType,\n        environment: entry.environment,\n        pid: entry.pid,\n        force: true,\n      });\n\n      if (!result.success && result.error && !result.error.includes('No matching registry entry')) {\n        throw new Error(result.error);\n      }\n    } catch {\n      // Best-effort cleanup: port release failures should not block process cleanup.\n    }\n  }\n\n  private entryKey(entry: ProcessRegistryRecord): string {\n    return [\n      entry.repositoryPath,\n      entry.serviceName,\n      entry.serviceType,\n      entry.environment ?? '',\n      String(entry.pid),\n    ].join('|');\n  }\n\n  private findEntry(state: ProcessRegistryState, filters: NormalizedFilters): ProcessRegistryRecord | undefined {\n    return state.entries.find(\n      (entry) =>\n        entry.repositoryPath === filters.repositoryPath &&\n        entry.serviceName === filters.serviceName &&\n        entry.serviceType === filters.serviceType &&\n        (filters.environment ? entry.environment === filters.environment : true),\n    );\n  }\n\n  private removeMatchingEntries(state: ProcessRegistryState, filters: NormalizedFilters): void {\n    state.entries = state.entries.filter(\n      (entry) =>\n        !(\n          entry.repositoryPath === filters.repositoryPath &&\n          entry.serviceName === filters.serviceName &&\n          entry.serviceType === filters.serviceType &&\n          (!filters.environment || entry.environment === filters.environment)\n        ),\n    );\n  }\n\n  private createSuccessResponse(pid?: number, record?: ProcessRegistryRecord): ProcessRegistryResponse {\n    return ProcessRegistryResponseSchema.parse({\n      success: true,\n      ...(typeof pid === 'number' ? { pid } : {}),\n      ...(record ? { record } : {}),\n    });\n  }\n\n  private createFailureResponse(error: string): ProcessRegistryResponse {\n    return ProcessRegistryResponseSchema.parse({\n      success: false,\n      error,\n    });\n  }\n\n  private matchesTags(entryTags: string[] | undefined, requestedTags: string[]): boolean {\n    if (requestedTags.length === 0) {\n      return true;\n    }\n\n    if (!entryTags || entryTags.length === 0) {\n      return false;\n    }\n\n    return requestedTags.some((tag) => entryTags.includes(tag));\n  }\n\n  private async pathExists(candidate: string): Promise<boolean> {\n    try {\n      await fs.access(candidate);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n\nfunction normalizeTags(tags: string[] | undefined): string[] | undefined {\n  if (tags === undefined) {\n    return undefined;\n  }\n\n  return Array.from(new Set(tags.map((tag) => tag.trim()).filter((tag) => tag.length > 0)));\n}\n"],"mappings":"wsBAIA,MAAa,EAAwBA,EAAAA,QAAK,KAAKC,EAAAA,QAAG,SAAS,CAAE,oBAAqB,iBAAiB,CACtF,EAA6B,GAAG,EAAsB,OAItD,EAA+B,uBAE/B,EAA2B,GAA0BD,EAAAA,QAAK,QAAQ,EAAM,CAExE,EAAgB,GAEpB,GAAG,EAAS,IAAA,EAAA,EAAA,aADQ,EAAE,CAAC,SAAS,MAAM,CAChB,MAG/B,SAAgB,EAAmB,EAAuC,CACxE,IAAM,EAAWE,EAAc,EAAK,CAC9B,EAAUA,EAAc,QAAQ,IAAI,GAA8B,CAElE,EAAW,CAAC,GAAI,GAAY,EAAE,CAAG,GAAI,GAAW,EAAE,CAAE,CACtD,KAAS,SAAW,EAIxB,OAAO,MAAM,KAAK,IAAI,IAAI,EAAS,CAAC,CAGtC,SAAgB,EAA2B,EAAkC,EAAsC,CACjH,GAAI,CAAC,EACH,OAGF,IAAM,EAAWF,EAAAA,QAAK,QAAQ,EAAa,CAK3C,OAJIA,EAAAA,QAAK,QAAQ,EAAS,GAAK,QACtBA,EAAAA,QAAK,KAAKA,EAAAA,QAAK,QAAQ,EAAS,CAAE,EAAS,CAG7CA,EAAAA,QAAK,KAAK,EAAU,EAAS,CAGtC,SAASE,EAAc,EAA2D,CAChF,GAAI,IAAS,IAAA,GACX,OAUF,IAAM,GAPS,MAAM,QAAQ,EAAK,CAC9B,EACA,EACG,MAAM,IAAI,CACV,IAAK,GAAQ,EAAI,MAAM,CAAC,CACxB,OAAQ,GAAQ,EAAI,OAAS,EAAE,EAEZ,IAAK,GAAQ,EAAI,MAAM,CAAC,CAAC,OAAQ,GAAQ,EAAI,OAAS,EAAE,CAClF,OAAO,EAAW,OAAS,EAAI,EAAa,IAAA,GCtD9C,MAEa,EAAwBC,EAAAA,EAAE,KAAK,CAAC,UAAW,OAAO,CAAC,CAEnD,EAAwBA,EAAAA,EAAE,OAAOA,EAAAA,EAAE,QAAQ,CAAEA,EAAAA,EAAE,SAAS,CAAC,CAEzD,EAA8BA,EAAAA,EAAE,OAAO,CAClD,eAAgBA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAG,6BAA6B,CACtE,YAAaA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAG,0BAA0B,CAChE,YAAa,EACb,YAAaA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CAChD,IAAKA,EAAAA,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAC5B,KAAMA,EAAAA,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,MAAM,CAAC,UAAU,CACnD,KAAMA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CACzC,QAASA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CAC5C,KAAMA,EAAAA,EAAE,MAAMA,EAAAA,EAAE,QAAQ,CAAC,CAAC,UAAU,CACpC,KAAMA,EAAAA,EAAE,MAAMA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CAClD,SAAU,EAAsB,UAAU,CAC1C,UAAWA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CACnC,UAAWA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CACpC,CAAC,CAEW,EAA6BA,EAAAA,EAAE,OAAO,CACjD,QAASA,EAAAA,EAAE,QAAA,EAAyB,CACpC,UAAWA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CACnC,QAASA,EAAAA,EAAE,MAAM,EAA4B,CAC9C,CAAC,CAEW,EAA+BA,EAAAA,EAAE,OAAO,CACnD,eAAgBA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CACxC,YAAaA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CACrC,YAAa,EAAsB,QAAQ,UAAU,CACrD,YAAaA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CAChD,IAAKA,EAAAA,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAC5B,KAAMA,EAAAA,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,MAAM,CAAC,UAAU,CACnD,KAAMA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CACzC,QAASA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CAC5C,KAAMA,EAAAA,EAAE,MAAMA,EAAAA,EAAE,QAAQ,CAAC,CAAC,UAAU,CACpC,KAAMA,EAAAA,EAAE,MAAMA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CAClD,SAAU,EAAsB,UAAU,CAC1C,MAAOA,EAAAA,EAAE,SAAS,CAAC,UAAU,CAC9B,CAAC,CAEW,EAA8BA,EAAAA,EAAE,OAAO,CAClD,eAAgBA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CACxC,YAAaA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CACrC,YAAa,EAAsB,UAAU,CAC7C,IAAKA,EAAAA,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,UAAU,CACvC,YAAaA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CAChD,KAAMA,EAAAA,EAAE,MAAMA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CAClD,MAAOA,EAAAA,EAAE,SAAS,CAAC,UAAU,CAC7B,KAAMA,EAAAA,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,GAAK,CAC1C,YAAaA,EAAAA,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,GAAK,CAClD,CAAC,CAEW,EAA2BA,EAAAA,EAAE,OAAO,CAC/C,eAAgBA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CACnD,YAAa,EAAsB,UAAU,CAC7C,YAAaA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CAChD,YAAaA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CAChD,KAAMA,EAAAA,EAAE,MAAMA,EAAAA,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CACnD,CAAC,CAEW,EAAgCA,EAAAA,EAAE,OAAO,CACpD,QAASA,EAAAA,EAAE,SAAS,CACpB,IAAKA,EAAAA,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,UAAU,CACvC,OAAQ,EAA4B,UAAU,CAC9C,MAAOA,EAAAA,EAAE,QAAQ,CAAC,UAAU,CAC7B,CAAC,CAkBF,IAAa,EAAb,cAA0C,KAAM,CAC9C,KAEA,YAAY,EAAiB,EAAgC,EAAwB,CACnF,MAAM,EAAS,EAAQ,CACvB,KAAK,KAAO,uBACZ,KAAK,KAAO,IC9CH,EAAb,MAAa,CAAuB,CAClC,aACA,SACA,gBACA,oBAAuC,IAAI,IAE3C,YACE,EAAuB,EACvB,EACA,EAAqD,IAAIC,EAAAA,oBAAoB,QAAQ,IAAI,mBAAmB,CAC5G,CADiB,KAAA,aAAA,EAEjB,KAAK,aAAe,EAAuB,oBAAoB,EAAa,CAC5E,KAAK,SAAW,GAAY,GAAG,KAAK,aAAa,OAGnD,OAAO,oBAAoB,EAA4B,CACrD,GAAI,CAAC,EACH,OAAO,EAGT,IAAM,EAAeC,EAAAA,QAAK,WAAW,EAAU,CAAG,EAAYA,EAAAA,QAAK,KAAK,QAAQ,KAAK,CAAE,EAAU,CAKjG,OAJIA,EAAAA,QAAK,QAAQ,EAAa,GAAK,QAC1B,EAGFA,EAAAA,QAAK,KAAK,EAAc,iBAAiB,CAGlD,MAAM,gBAAgB,EAAsE,CAC1F,IAAM,EAAU,EAA6B,MAAM,EAAW,CAE9D,OAAO,KAAK,SAAS,SAAY,CAC/B,IAAM,EAAQ,MAAM,KAAK,WAAW,CAC9B,EAAiB,EAAwB,EAAQ,eAAe,CAChE,EAAc,EAAQ,aAAe,UACrC,EAAc,EAAQ,aAAe,QAAQ,IAAI,UAAY,cAC7D,EAAO,EAAmB,EAAQ,KAAK,CACvC,EAAW,MAAM,KAAK,WAAW,EAAM,CACvC,EAAW,KAAK,UAAU,EAAU,CACxC,eAAgB,EAChB,YAAa,EAAQ,YACrB,cACA,cACD,CAAC,CAEF,GAAI,EAAU,CACZ,GAAI,EAAS,MAAQ,EAAQ,IAS3B,MARA,GAAS,UAAY,IAAI,MAAM,CAAC,aAAa,CAC7C,EAAS,KAAO,EAAQ,MAAQ,EAAS,KACzC,EAAS,KAAO,EAAQ,MAAQ,EAAS,KACzC,EAAS,QAAU,EAAQ,SAAW,EAAS,QAC/C,EAAS,KAAO,EAAQ,MAAQ,EAAS,KACzC,EAAS,KAAO,GAAQ,EAAS,KACjC,EAAS,SAAW,EAAQ,UAAY,EAAS,SACjD,MAAM,KAAK,UAAU,EAAS,CACvB,KAAK,sBAAsB,EAAQ,IAAK,EAAS,CAG1D,IAAM,EAAU,KAAK,iBAAiB,EAAS,IAAI,CACnD,GAAI,GAAW,EAAE,EAAQ,OAAS,IAChC,OAAO,KAAK,sBAAsB,kCAAkC,EAAQ,YAAY,qBAAqB,CAG3G,GACF,MAAM,KAAK,iBAAiB,EAAS,IAAI,CAG3C,MAAM,KAAK,sBAAsB,EAAS,CAC1C,KAAK,sBAAsB,EAAU,CACnC,eAAgB,EAChB,YAAa,EAAQ,YACrB,cACA,cACD,CAAC,CAGJ,IAAM,EAAM,IAAI,MAAM,CAAC,aAAa,CAC9B,EAAgC,CACpC,eAAgB,EAChB,YAAa,EAAQ,YACrB,cACA,cACA,IAAK,EAAQ,IACb,KAAM,EAAQ,KACd,KAAM,EAAQ,KACd,QAAS,EAAQ,QACjB,KAAM,EAAQ,KACd,OACA,SAAU,EAAQ,SAClB,UAAW,EACX,UAAW,EACZ,CAID,OAFA,EAAS,QAAQ,KAAK,EAAO,CAC7B,MAAM,KAAK,UAAU,EAAS,CACvB,KAAK,sBAAsB,EAAQ,IAAK,EAAO,EACtD,CAGJ,MAAM,eAAe,EAAqE,CACxF,IAAM,EAAU,EAA4B,MAAM,EAAW,CAE7D,OAAO,KAAK,SAAS,SAAY,CAC/B,IAAM,EAAQ,MAAM,KAAK,WAAW,CAC9B,EAAW,MAAM,KAAK,yBAAyB,EAAM,CACrD,EAAiB,EAAwB,EAAQ,eAAe,CAChE,EAAc,EAAQ,aAAe,UACrC,EAAc,EAAQ,aAAe,QAAQ,IAAI,UAAY,cAC7D,EAAgB,EAAc,EAAQ,KAAK,CAC3C,EAAU,EAAS,QAAQ,OAAQ,GAMvC,EALI,EAAM,iBAAmB,GACzB,EAAM,cAAgB,EAAQ,aAC9B,EAAM,cAAgB,GACtB,EAAQ,aAAe,EAAM,cAAgB,GAC7C,OAAO,EAAQ,KAAQ,UAAY,EAAM,MAAQ,EAAQ,KACzD,GAAiB,EAAc,OAAS,GAAK,CAAC,KAAK,YAAY,EAAM,KAAM,EAAc,EAE7F,CAEF,GAAI,EAAQ,SAAW,EACrB,OAAO,KAAK,sBAAsB,iCAAiC,EAAQ,cAAc,CAG3F,IAAM,EAAmB,EAAE,CACrB,EAAY,IAAI,IAEtB,IAAK,IAAM,KAAS,EAAS,CAC3B,IAAM,EAAW,KAAK,SAAS,EAAM,CAErC,GAAI,EACE,EAAQ,MAAQ,KACd,KAAK,iBAAiB,EAAM,IAAI,EAClC,MAAM,KAAK,iBAAiB,EAAM,IAAI,EAItC,EAAQ,aAAe,KACzB,MAAM,KAAK,sBAAsB,EAAM,CAGzC,EAAU,IAAI,EAAS,OAChB,EAAO,CACd,EAAO,KACL,GAAG,EAAM,YAAY,QAAQ,EAAM,IAAI,KAAK,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GACnG,EAaL,OATI,EAAU,KAAO,IACnB,EAAS,QAAU,EAAS,QAAQ,OAAQ,GAAU,CAAC,EAAU,IAAI,KAAK,SAAS,EAAM,CAAC,CAAC,CAC3F,MAAM,KAAK,UAAU,EAAS,EAG5B,EAAO,OAAS,EACX,KAAK,sBAAsB,EAAO,KAAK,KAAK,CAAC,CAG/C,KAAK,uBAAuB,EACnC,CAGJ,MAAM,cAAc,EAA8B,EAAE,CAAoC,CACtF,IAAM,EAAU,EAAyB,MAAM,EAAQ,CAEvD,OAAO,KAAK,SAAS,SAAY,CAC/B,IAAM,EAAQ,MAAM,KAAK,WAAW,CAC9B,EAAW,MAAM,KAAK,WAAW,EAAM,CACvC,EAAgB,EAAc,EAAQ,KAAK,CAEjD,MAAO,CAAC,GAAG,EAAS,QAAQ,CAAC,OAAQ,GAOnC,EANI,EAAQ,gBAAkB,EAAM,iBAAmB,EAAwB,EAAQ,eAAe,EAGlG,EAAQ,aAAe,EAAM,cAAgB,EAAQ,aACrD,EAAQ,aAAe,EAAM,cAAgB,EAAQ,aACrD,EAAQ,aAAe,EAAM,cAAgB,EAAQ,aACrD,GAAiB,EAAc,OAAS,GAAK,CAAC,KAAK,YAAY,EAAM,KAAM,EAAc,EAE7F,EACF,CAGJ,MAAc,SAAY,EAAwC,CAChE,IAAM,EAAY,GAAG,QAAQ,IAAI,IAAA,EAAA,EAAA,aAAe,EAAE,CAAC,SAAS,MAAM,GAClE,MAAM,KAAK,YAAY,EAAU,CAEjC,GAAI,CACF,OAAO,MAAM,GAAU,QACf,CACR,MAAM,KAAK,YAAY,EAAU,EAIrC,MAAc,WAA2C,CACvD,MAAMC,EAAAA,QAAG,MAAMD,EAAAA,QAAK,QAAQ,KAAK,aAAa,CAAE,CAAE,UAAW,GAAM,CAAC,CAEpE,GAAI,CACF,IAAM,EAAU,MAAMC,EAAAA,QAAG,SAAS,KAAK,aAAc,QAAQ,CACvD,EAAS,KAAK,MAAM,EAAQ,CAClC,OAAO,EAA2B,MAAM,EAAO,OACxC,EAAO,CACd,IAAM,EAAW,EACjB,GAAI,EAAS,OAAS,SACpB,MAAO,CACL,QAAA,EACA,UAAW,IAAI,MAAM,CAAC,aAAa,CACnC,QAAS,EAAE,CACZ,CAGH,GAAI,aAAoB,YAAa,CACnC,IAAM,EAAa,GAAG,KAAK,aAAa,WAAW,KAAK,KAAK,GAC7D,MAAMA,EAAAA,QAAG,OAAO,KAAK,aAAc,EAAW,CAAC,UAAY,IAAA,GAAU,CAGvE,MAAM,IAAI,EACR,iCAAiC,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GACvF,uBACA,CAAE,MAAO,EAAO,CACjB,EAIL,MAAc,UAAU,EAA4C,CAClE,MAAMA,EAAAA,QAAG,MAAMD,EAAAA,QAAK,QAAQ,KAAK,aAAa,CAAE,CAAE,UAAW,GAAM,CAAC,CAEpE,IAAM,EAAgC,CACpC,GAAG,EACH,UAAW,IAAI,MAAM,CAAC,aAAa,CACnC,QAAS,CAAC,GAAG,EAAM,QAAQ,CAC5B,CAEK,EAAW,EAAa,KAAK,aAAa,CAChD,MAAMC,EAAAA,QAAG,UAAU,EAAU,KAAK,UAAU,EAAS,KAAM,EAAE,CAAE,QAAQ,CACvE,MAAMA,EAAAA,QAAG,OAAO,EAAU,KAAK,aAAa,CAG9C,MAAc,WAAW,EAA4D,CACnF,IAAM,EAAmB,MAAM,KAAK,yBAAyB,EAAM,CACnE,OAAO,KAAK,mBAAmB,EAAiB,CAGlD,MAAc,yBAAyB,EAA4D,CAQjG,IAAM,GAPU,MAAM,QAAQ,IAC5B,EAAM,QAAQ,IAAI,KAAO,KAAW,CAClC,QACA,OAAQ,MAAM,KAAK,WAAW,EAAM,eAAe,CACpD,EAAE,CACJ,EAEsB,OAAQ,GAAU,EAAM,OAAO,CAAC,IAAK,GAAU,EAAM,MAAM,CAMlF,OALI,EAAO,SAAW,EAAM,QAAQ,SAClC,EAAM,QAAU,EAChB,MAAM,KAAK,UAAU,EAAM,EAGtB,EAGT,MAAc,mBAAmB,EAA4D,CAC3F,IAAM,EAAwC,EAAE,CAC5C,EAAU,GAEd,IAAK,IAAM,KAAS,EAAM,QAAS,CACjC,GAAI,KAAK,iBAAiB,EAAM,IAAI,CAAE,CACpC,EAAa,KAAK,EAAM,CACxB,SAGF,EAAU,GACV,MAAM,KAAK,sBAAsB,EAAM,CAQzC,OALI,IACF,EAAM,QAAU,EAChB,MAAM,KAAK,UAAU,EAAM,EAGtB,EAGT,MAAc,YAAY,EAA8B,CACtD,MAAMA,EAAAA,QAAG,MAAMD,EAAAA,QAAK,QAAQ,KAAK,SAAS,CAAE,CAAE,UAAW,GAAM,CAAC,CAEhE,IAAK,IAAI,EAAU,EAAG,EAAA,GAA4B,GAAW,EAC3D,GAAI,CACF,IAAM,EAAuB,CAC3B,IAAK,QAAQ,IACb,QACA,UAAW,IAAI,MAAM,CAAC,aAAa,CACpC,CACD,MAAMC,EAAAA,QAAG,UAAU,KAAK,SAAU,KAAK,UAAU,EAAU,CAAE,CAAE,KAAM,KAAM,CAAC,CAC5E,KAAK,oBAAoB,EAAM,CAC/B,aACO,EAAO,CACd,GAAK,EAAgC,OAAS,SAC5C,MAAM,IAAI,EACR,oCAAoC,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAC1F,uBACA,CAAE,MAAO,EAAO,CACjB,CAIH,GADc,MAAM,KAAK,aAAa,CAC3B,CACT,MAAMA,EAAAA,QAAG,OAAO,KAAK,SAAS,CAAC,UAAY,IAAA,GAAU,CACrD,IACA,SAGF,MAAM,KAAK,MAAA,GAA0B,CAIzC,MAAM,IAAI,EAAqB,4CAA6C,uBAAuB,CAGrG,MAAc,YAAY,EAA8B,CACtD,GAAI,CACF,IAAM,EAAW,MAAMA,EAAAA,QAAG,SAAS,KAAK,SAAU,QAAQ,CAC3C,KAAK,MAAM,EAAS,CACxB,QAAU,GACnB,MAAMA,EAAAA,QAAG,OAAO,KAAK,SAAS,MAE1B,SAEE,CACR,KAAK,sBAAsB,EAAM,EAIrC,MAAc,aAAgC,CAC5C,GAAI,CACF,IAAM,EAAU,MAAMA,EAAAA,QAAG,SAAS,KAAK,SAAU,QAAQ,CACnD,EAAS,KAAK,MAAM,EAAQ,CAElC,GAAI,EAAO,KACQ,KAAK,iBAAiB,EAAO,IAAI,CACpC,CACZ,IAAM,EAAM,KAAK,KAAK,CAAG,IAAI,KAAK,EAAO,UAAU,CAAC,SAAS,CAC7D,MAAO,EAAE,OAAO,SAAS,EAAI,EAAI,EAAA,KAIrC,MAAO,QACD,CACN,MAAO,IAIX,iBAAyB,EAAsB,CAC7C,GAAI,CAEF,OADA,QAAQ,KAAK,EAAK,EAAE,CACb,QACD,CACN,MAAO,IAIX,oBAA4B,EAAqB,CAC/C,KAAK,sBAAsB,KAAK,gBAAgB,CAChD,KAAK,gBAAkB,EAEvB,IAAM,MAAsB,CAC1B,KAAK,gBAAgB,EAAM,EAG7B,IAAK,IAAM,IAAS,CAClB,OACA,SACA,UACA,oBACA,qBACD,CACC,QAAQ,KAAK,EAAO,EAAQ,CAC5B,KAAK,oBAAoB,IAAI,EAAO,EAAQ,CAIhD,sBAA8B,EAAiC,CACzD,MAAC,GAAS,KAAK,kBAAoB,GAIvC,KAAK,GAAM,CAAC,EAAO,KAAY,KAAK,oBAClC,QAAQ,IAAI,EAAO,EAAQ,CAG7B,KAAK,oBAAoB,OAAO,CAChC,KAAK,gBAAkB,IAAA,IAGzB,gBAAwB,EAAqB,CAC3C,GAAI,CACF,IAAM,EAAWC,EAAAA,QAAO,aAAa,KAAK,SAAU,QAAQ,CAC7C,KAAK,MAAM,EAAS,CACxB,QAAU,GACnB,EAAA,QAAO,WAAW,KAAK,SAAS,MAE5B,GAKV,MAAc,iBAAiB,EAA4B,CACzD,GAAI,CACF,QAAQ,KAAK,EAAK,EAAE,MACd,CACN,OAGF,GAAI,CACF,QAAQ,KAAK,EAAK,UAAU,OACrB,EAAO,CAEd,GADiB,EACJ,OAAS,QACpB,OAGF,MAAU,MACR,qCAAqC,EAAI,IAAI,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GACnG,CACE,MAAO,EACR,CACF,CAGH,SAAM,KAAK,MAAM,IAAI,CAEhB,KAAK,iBAAiB,EAAI,CAI/B,IAAI,CACF,QAAQ,KAAK,EAAK,UAAU,OACrB,EAAO,CAEd,GADiB,EACJ,OAAS,QACpB,OAGF,MAAU,MACR,qCAAqC,EAAI,IAAI,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GACnG,CACE,MAAO,EACR,CACF,CAKH,GAFA,MAAM,KAAK,MAAM,IAAI,CAEjB,KAAK,iBAAiB,EAAI,CAC5B,MAAU,MAAM,WAAW,EAAI,6BAA6B,EAIhE,MAAc,sBAAsB,EAA6C,CAC3E,MAAC,KAAK,cAAgB,CAAC,EAAM,MAIjC,GAAI,CACF,IAAM,EAAS,MAAM,KAAK,aAAa,YAAY,CACjD,eAAgB,EAAM,eACtB,YAAa,EAAM,YACnB,YAAa,EAAM,YACnB,YAAa,EAAM,YACnB,IAAK,EAAM,IACX,MAAO,GACR,CAAC,CAEF,GAAI,CAAC,EAAO,SAAW,EAAO,OAAS,CAAC,EAAO,MAAM,SAAS,6BAA6B,CACzF,MAAU,MAAM,EAAO,MAAM,MAEzB,GAKV,SAAiB,EAAsC,CACrD,MAAO,CACL,EAAM,eACN,EAAM,YACN,EAAM,YACN,EAAM,aAAe,GACrB,OAAO,EAAM,IAAI,CAClB,CAAC,KAAK,IAAI,CAGb,UAAkB,EAA6B,EAA+D,CAC5G,OAAO,EAAM,QAAQ,KAClB,GACC,EAAM,iBAAmB,EAAQ,gBACjC,EAAM,cAAgB,EAAQ,aAC9B,EAAM,cAAgB,EAAQ,cAC7B,EAAQ,YAAc,EAAM,cAAgB,EAAQ,YAAc,IACtE,CAGH,sBAA8B,EAA6B,EAAkC,CAC3F,EAAM,QAAU,EAAM,QAAQ,OAC3B,GACC,EACE,EAAM,iBAAmB,EAAQ,gBACjC,EAAM,cAAgB,EAAQ,aAC9B,EAAM,cAAgB,EAAQ,cAC7B,CAAC,EAAQ,aAAe,EAAM,cAAgB,EAAQ,cAE5D,CAGH,sBAA8B,EAAc,EAAyD,CACnG,OAAO,EAA8B,MAAM,CACzC,QAAS,GACT,GAAI,OAAO,GAAQ,SAAW,CAAE,MAAK,CAAG,EAAE,CAC1C,GAAI,EAAS,CAAE,SAAQ,CAAG,EAAE,CAC7B,CAAC,CAGJ,sBAA8B,EAAwC,CACpE,OAAO,EAA8B,MAAM,CACzC,QAAS,GACT,QACD,CAAC,CAGJ,YAAoB,EAAiC,EAAkC,CASrF,OARI,EAAc,SAAW,EACpB,GAGL,CAAC,GAAa,EAAU,SAAW,EAC9B,GAGF,EAAc,KAAM,GAAQ,EAAU,SAAS,EAAI,CAAC,CAG7D,MAAc,WAAW,EAAqC,CAC5D,GAAI,CAEF,OADA,MAAMD,EAAAA,QAAG,OAAO,EAAU,CACnB,QACD,CACN,MAAO,IAIX,MAAc,EAA2B,CACvC,OAAO,IAAI,QAAS,GAAY,WAAW,EAAS,EAAG,CAAC,GAI5D,SAAS,EAAc,EAAkD,CACnE,OAAS,IAAA,GAIb,OAAO,MAAM,KAAK,IAAI,IAAI,EAAK,IAAK,GAAQ,EAAI,MAAM,CAAC,CAAC,OAAQ,GAAQ,EAAI,OAAS,EAAE,CAAC,CAAC"}

package/dist/ProcessRegistryService.mjs

@@ -1,2 +1,2 @@
-import{randomBytes as e}from"node:crypto";import t from"node:fs";import n from"node:fs/promises";import r from"node:path";import{PortRegistryService as i}from"@agimon-ai/foundation-port-registry";import{z as a}from"zod";import o from"node:os";const s=1,c=a.enum([`service`,`tool`]),l=a.record(a.string(),a.unknown()),u=a.object({repositoryPath:a.string().trim().min(1,`repositoryPath is required`),serviceName:a.string().trim().min(1,`serviceName is required`),serviceType:c,environment:a.string().trim().min(1).optional(),pid:a.number().int().min(1),port:a.number().int().min(1).max(65535).optional(),host:a.string().trim().min(1).optional(),command:a.string().trim().min(1).optional(),args:a.array(a.string()).optional(),metadata:l.optional(),createdAt:a.string().trim().min(1),updatedAt:a.string().trim().min(1)}),d=a.object({version:a.literal(1),updatedAt:a.string().trim().min(1),entries:a.array(u)}),f=a.object({repositoryPath:a.string().trim().min(1),serviceName:a.string().trim().min(1),serviceType:c.default(`service`),environment:a.string().trim().min(1).optional(),pid:a.number().int().min(1),port:a.number().int().min(1).max(65535).optional(),host:a.string().trim().min(1).optional(),command:a.string().trim().min(1).optional(),args:a.array(a.string()).optional(),metadata:l.optional(),force:a.boolean().optional()}),p=a.object({repositoryPath:a.string().trim().min(1),serviceName:a.string().trim().min(1),serviceType:c.optional(),pid:a.number().int().min(1).optional(),environment:a.string().trim().min(1).optional(),force:a.boolean().optional(),kill:a.boolean().optional().default(!0),releasePort:a.boolean().optional().default(!0)}),m=a.object({repositoryPath:a.string().trim().min(1).optional(),serviceType:c.optional(),serviceName:a.string().trim().min(1).optional(),environment:a.string().trim().min(1).optional()}),h=a.object({success:a.boolean(),pid:a.number().int().min(1).optional(),record:u.optional(),error:a.string().optional()});var g=class extends Error{code;constructor(e,t,n){super(e,n),this.name=`ProcessRegistryError`,this.code=t}};const _=r.join(o.homedir(),`.process-registry`,`processes.json`),v=`${_}.lock`,y=75,b=80,x=5e3,S=e=>r.resolve(e),C=t=>`${t}.${e(6).toString(`hex`)}.tmp`;function w(e,t){if(!e)return;let n=r.resolve(e);return r.extname(n)===`.json`?r.join(r.dirname(n),t):r.join(n,t)}var T=class a{registryPath;lockPath;activeLockToken;lockCleanupHandlers=new Map;constructor(e=_,t,n=new i(process.env.PORT_REGISTRY_PATH)){this.portRegistry=n,this.registryPath=a.resolveRegistryPath(e),this.lockPath=t??`${this.registryPath}.lock`}static resolveRegistryPath(e){if(!e)return _;let t=r.isAbsolute(e)?e:r.join(process.cwd(),e);return r.extname(t)===`.json`?t:r.join(t,`processes.json`)}async registerProcess(e){let t=f.parse(e);return this.withLock(async()=>{let e=await this.loadState(),n=S(t.repositoryPath),r=t.serviceType??`service`,i=t.environment??process.env.NODE_ENV??`development`,a=await this.pruneState(e),o=this.findEntry(a,{repositoryPath:n,serviceName:t.serviceName,serviceType:r,environment:i});if(o){if(o.pid===t.pid)return o.updatedAt=new Date().toISOString(),o.port=t.port??o.port,o.host=t.host??o.host,o.command=t.command??o.command,o.args=t.args??o.args,o.metadata=t.metadata??o.metadata,await this.saveState(a),this.createSuccessResponse(t.pid,o);let e=this.isProcessRunning(o.pid);if(e&&!(t.force??!0))return this.createFailureResponse(`Process already registered for ${t.serviceName} in requested scope`);e&&await this.terminateProcess(o.pid),await this.releaseAssociatedPort(o),this.removeMatchingEntries(a,{repositoryPath:n,serviceName:t.serviceName,serviceType:r,environment:i})}let s=new Date().toISOString(),c={repositoryPath:n,serviceName:t.serviceName,serviceType:r,environment:i,pid:t.pid,port:t.port,host:t.host,command:t.command,args:t.args,metadata:t.metadata,createdAt:s,updatedAt:s};return a.entries.push(c),await this.saveState(a),this.createSuccessResponse(t.pid,c)})}async releaseProcess(e){let t=p.parse(e);return this.withLock(async()=>{let e=await this.loadState(),n=await this.pruneMissingRepositories(e),r=S(t.repositoryPath),i=t.serviceType??`service`,a=t.environment??process.env.NODE_ENV??`development`,o=n.entries.filter(e=>!(e.repositoryPath!==r||e.serviceName!==t.serviceName||e.serviceType!==i||t.environment&&e.environment!==a||typeof t.pid==`number`&&e.pid!==t.pid));if(o.length===0)return this.createFailureResponse(`No matching process entry for ${t.serviceName}`);let s=[],c=new Set;for(let e of o){let n=this.entryKey(e);try{(t.kill??!0)&&this.isProcessRunning(e.pid)&&await this.terminateProcess(e.pid),(t.releasePort??!0)&&await this.releaseAssociatedPort(e),c.add(n)}catch(t){s.push(`${e.serviceName} (pid ${e.pid}): ${t instanceof Error?t.message:String(t)}`)}}return c.size>0&&(n.entries=n.entries.filter(e=>!c.has(this.entryKey(e))),await this.saveState(n)),s.length>0?this.createFailureResponse(s.join(`; `)):this.createSuccessResponse()})}async listProcesses(e={}){let t=m.parse(e);return this.withLock(async()=>{let e=await this.loadState();return[...(await this.pruneState(e)).entries].filter(e=>!(t.repositoryPath&&e.repositoryPath!==S(t.repositoryPath)||t.serviceType&&e.serviceType!==t.serviceType||t.serviceName&&e.serviceName!==t.serviceName||t.environment&&e.environment!==t.environment))})}async withLock(t){let n=`${process.pid}-${e(6).toString(`hex`)}`;await this.acquireLock(n);try{return await t()}finally{await this.releaseLock(n)}}async loadState(){await n.mkdir(r.dirname(this.registryPath),{recursive:!0});try{let e=await n.readFile(this.registryPath,`utf-8`),t=JSON.parse(e);return d.parse(t)}catch(e){let t=e;if(t.code===`ENOENT`)return{version:1,updatedAt:new Date().toISOString(),entries:[]};if(t instanceof SyntaxError){let e=`${this.registryPath}.corrupt.${Date.now()}`;await n.rename(this.registryPath,e).catch(()=>void 0)}throw new g(`Failed to read registry file: ${e instanceof Error?e.message:String(e)}`,`REGISTRY_READ_FAILED`,{cause:e})}}async saveState(e){await n.mkdir(r.dirname(this.registryPath),{recursive:!0});let t={...e,updatedAt:new Date().toISOString(),entries:[...e.entries]},i=C(this.registryPath);await n.writeFile(i,JSON.stringify(t,null,2),`utf-8`),await n.rename(i,this.registryPath)}async pruneState(e){let t=await this.pruneMissingRepositories(e);return this.pruneDeadProcesses(t)}async pruneMissingRepositories(e){let t=(await Promise.all(e.entries.map(async e=>({entry:e,exists:await this.pathExists(e.repositoryPath)})))).filter(e=>e.exists).map(e=>e.entry);return t.length!==e.entries.length&&(e.entries=t,await this.saveState(e)),e}async pruneDeadProcesses(e){let t=[],n=!1;for(let r of e.entries){if(this.isProcessRunning(r.pid)){t.push(r);continue}n=!0,await this.releaseAssociatedPort(r)}return n&&(e.entries=t,await this.saveState(e)),e}async acquireLock(e){await n.mkdir(r.dirname(this.lockPath),{recursive:!0});for(let t=0;t<80;t+=1)try{let t={pid:process.pid,token:e,createdAt:new Date().toISOString()};await n.writeFile(this.lockPath,JSON.stringify(t),{flag:`wx`}),this.registerLockCleanup(e);return}catch(e){if(e.code!==`EEXIST`)throw new g(`Failed to acquire registry lock: ${e instanceof Error?e.message:String(e)}`,`REGISTRY_LOCK_FAILED`,{cause:e});if(await this.isStaleLock()){await n.unlink(this.lockPath).catch(()=>void 0),--t;continue}await this.delay(75)}throw new g(`Unable to acquire registry lock (timeout)`,`REGISTRY_LOCK_FAILED`)}async releaseLock(e){try{let t=await n.readFile(this.lockPath,`utf-8`);JSON.parse(t).token===e&&await n.unlink(this.lockPath)}catch{}finally{this.unregisterLockCleanup(e)}}async isStaleLock(){try{let e=await n.readFile(this.lockPath,`utf-8`),t=JSON.parse(e);if(t.pid&&this.isProcessRunning(t.pid)){let e=Date.now()-new Date(t.createdAt).getTime();return!(Number.isFinite(e)&&e<5e3)}return!0}catch{return!0}}isProcessRunning(e){try{return process.kill(e,0),!0}catch{return!1}}registerLockCleanup(e){this.unregisterLockCleanup(this.activeLockToken),this.activeLockToken=e;let t=()=>{this.releaseLockSync(e)};for(let e of[`exit`,`SIGINT`,`SIGTERM`,`uncaughtException`,`unhandledRejection`])process.once(e,t),this.lockCleanupHandlers.set(e,t)}unregisterLockCleanup(e){if(!(!e||this.activeLockToken!==e)){for(let[e,t]of this.lockCleanupHandlers)process.off(e,t);this.lockCleanupHandlers.clear(),this.activeLockToken=void 0}}releaseLockSync(e){try{let n=t.readFileSync(this.lockPath,`utf-8`);JSON.parse(n).token===e&&t.unlinkSync(this.lockPath)}catch{}}async terminateProcess(e){try{process.kill(e,0)}catch{return}try{process.kill(e,`SIGTERM`)}catch(t){if(t.code===`ESRCH`)return;throw Error(`Failed to send SIGTERM to process ${e}: ${t instanceof Error?t.message:String(t)}`,{cause:t})}if(await this.delay(500),this.isProcessRunning(e)){try{process.kill(e,`SIGKILL`)}catch(t){if(t.code===`ESRCH`)return;throw Error(`Failed to send SIGKILL to process ${e}: ${t instanceof Error?t.message:String(t)}`,{cause:t})}if(await this.delay(250),this.isProcessRunning(e))throw Error(`Process ${e} did not exit after SIGKILL`)}}async releaseAssociatedPort(e){if(!(!this.portRegistry||!e.port))try{let t=await this.portRegistry.releasePort({repositoryPath:e.repositoryPath,serviceName:e.serviceName,serviceType:e.serviceType,environment:e.environment,pid:e.pid,force:!0});if(!t.success&&t.error&&!t.error.includes(`No matching registry entry`))throw Error(t.error)}catch{}}entryKey(e){return[e.repositoryPath,e.serviceName,e.serviceType,e.environment??``,String(e.pid)].join(`|`)}findEntry(e,t){return e.entries.find(e=>e.repositoryPath===t.repositoryPath&&e.serviceName===t.serviceName&&e.serviceType===t.serviceType&&(t.environment?e.environment===t.environment:!0))}removeMatchingEntries(e,t){e.entries=e.entries.filter(e=>!(e.repositoryPath===t.repositoryPath&&e.serviceName===t.serviceName&&e.serviceType===t.serviceType&&(!t.environment||e.environment===t.environment)))}createSuccessResponse(e,t){return h.parse({success:!0,...typeof e==`number`?{pid:e}:{},...t?{record:t}:{}})}createFailureResponse(e){return h.parse({success:!1,error:e})}async pathExists(e){try{return await n.access(e),!0}catch{return!1}}delay(e){return new Promise(t=>setTimeout(t,e))}};export{f as _,y as a,S as c,l as d,g as f,s as g,d as h,b as i,w as l,h as m,v as n,x as o,u as p,_ as r,C as s,T as t,m as u,p as v,c as y};
+import{randomBytes as e}from"node:crypto";import t from"node:os";import n from"node:path";import r from"node:fs";import i from"node:fs/promises";import{PortRegistryService as a}from"@agimon-ai/foundation-port-registry";import{z as o}from"zod";const s=n.join(t.homedir(),`.process-registry`,`processes.json`),c=`${s}.lock`,l=75,u=80,d=5e3,f=`PROCESS_REGISTRY_TAG`,p=e=>n.resolve(e),m=t=>`${t}.${e(6).toString(`hex`)}.tmp`;function h(e){let t=_(e),n=_(process.env[f]),r=[...t??[],...n??[]];if(r.length!==0)return Array.from(new Set(r))}function g(e,t){if(!e)return;let r=n.resolve(e);return n.extname(r)===`.json`?n.join(n.dirname(r),t):n.join(r,t)}function _(e){if(e===void 0)return;let t=(Array.isArray(e)?e:e.split(`,`).map(e=>e.trim()).filter(e=>e.length>0)).map(e=>e.trim()).filter(e=>e.length>0);return t.length>0?t:void 0}const v=1,y=o.enum([`service`,`tool`]),b=o.record(o.string(),o.unknown()),x=o.object({repositoryPath:o.string().trim().min(1,`repositoryPath is required`),serviceName:o.string().trim().min(1,`serviceName is required`),serviceType:y,environment:o.string().trim().min(1).optional(),pid:o.number().int().min(1),port:o.number().int().min(1).max(65535).optional(),host:o.string().trim().min(1).optional(),command:o.string().trim().min(1).optional(),args:o.array(o.string()).optional(),tags:o.array(o.string().trim().min(1)).optional(),metadata:b.optional(),createdAt:o.string().trim().min(1),updatedAt:o.string().trim().min(1)}),S=o.object({version:o.literal(1),updatedAt:o.string().trim().min(1),entries:o.array(x)}),C=o.object({repositoryPath:o.string().trim().min(1),serviceName:o.string().trim().min(1),serviceType:y.default(`service`),environment:o.string().trim().min(1).optional(),pid:o.number().int().min(1),port:o.number().int().min(1).max(65535).optional(),host:o.string().trim().min(1).optional(),command:o.string().trim().min(1).optional(),args:o.array(o.string()).optional(),tags:o.array(o.string().trim().min(1)).optional(),metadata:b.optional(),force:o.boolean().optional()}),w=o.object({repositoryPath:o.string().trim().min(1),serviceName:o.string().trim().min(1),serviceType:y.optional(),pid:o.number().int().min(1).optional(),environment:o.string().trim().min(1).optional(),tags:o.array(o.string().trim().min(1)).optional(),force:o.boolean().optional(),kill:o.boolean().optional().default(!0),releasePort:o.boolean().optional().default(!0)}),T=o.object({repositoryPath:o.string().trim().min(1).optional(),serviceType:y.optional(),serviceName:o.string().trim().min(1).optional(),environment:o.string().trim().min(1).optional(),tags:o.array(o.string().trim().min(1)).optional()}),E=o.object({success:o.boolean(),pid:o.number().int().min(1).optional(),record:x.optional(),error:o.string().optional()});var D=class extends Error{code;constructor(e,t,n){super(e,n),this.name=`ProcessRegistryError`,this.code=t}},O=class t{registryPath;lockPath;activeLockToken;lockCleanupHandlers=new Map;constructor(e=s,n,r=new a(process.env.PORT_REGISTRY_PATH)){this.portRegistry=r,this.registryPath=t.resolveRegistryPath(e),this.lockPath=n??`${this.registryPath}.lock`}static resolveRegistryPath(e){if(!e)return s;let t=n.isAbsolute(e)?e:n.join(process.cwd(),e);return n.extname(t)===`.json`?t:n.join(t,`processes.json`)}async registerProcess(e){let t=C.parse(e);return this.withLock(async()=>{let e=await this.loadState(),n=p(t.repositoryPath),r=t.serviceType??`service`,i=t.environment??process.env.NODE_ENV??`development`,a=h(t.tags),o=await this.pruneState(e),s=this.findEntry(o,{repositoryPath:n,serviceName:t.serviceName,serviceType:r,environment:i});if(s){if(s.pid===t.pid)return s.updatedAt=new Date().toISOString(),s.port=t.port??s.port,s.host=t.host??s.host,s.command=t.command??s.command,s.args=t.args??s.args,s.tags=a??s.tags,s.metadata=t.metadata??s.metadata,await this.saveState(o),this.createSuccessResponse(t.pid,s);let e=this.isProcessRunning(s.pid);if(e&&!(t.force??!0))return this.createFailureResponse(`Process already registered for ${t.serviceName} in requested scope`);e&&await this.terminateProcess(s.pid),await this.releaseAssociatedPort(s),this.removeMatchingEntries(o,{repositoryPath:n,serviceName:t.serviceName,serviceType:r,environment:i})}let c=new Date().toISOString(),l={repositoryPath:n,serviceName:t.serviceName,serviceType:r,environment:i,pid:t.pid,port:t.port,host:t.host,command:t.command,args:t.args,tags:a,metadata:t.metadata,createdAt:c,updatedAt:c};return o.entries.push(l),await this.saveState(o),this.createSuccessResponse(t.pid,l)})}async releaseProcess(e){let t=w.parse(e);return this.withLock(async()=>{let e=await this.loadState(),n=await this.pruneMissingRepositories(e),r=p(t.repositoryPath),i=t.serviceType??`service`,a=t.environment??process.env.NODE_ENV??`development`,o=k(t.tags),s=n.entries.filter(e=>!(e.repositoryPath!==r||e.serviceName!==t.serviceName||e.serviceType!==i||t.environment&&e.environment!==a||typeof t.pid==`number`&&e.pid!==t.pid||o&&o.length>0&&!this.matchesTags(e.tags,o)));if(s.length===0)return this.createFailureResponse(`No matching process entry for ${t.serviceName}`);let c=[],l=new Set;for(let e of s){let n=this.entryKey(e);try{(t.kill??!0)&&this.isProcessRunning(e.pid)&&await this.terminateProcess(e.pid),(t.releasePort??!0)&&await this.releaseAssociatedPort(e),l.add(n)}catch(t){c.push(`${e.serviceName} (pid ${e.pid}): ${t instanceof Error?t.message:String(t)}`)}}return l.size>0&&(n.entries=n.entries.filter(e=>!l.has(this.entryKey(e))),await this.saveState(n)),c.length>0?this.createFailureResponse(c.join(`; `)):this.createSuccessResponse()})}async listProcesses(e={}){let t=T.parse(e);return this.withLock(async()=>{let e=await this.loadState(),n=await this.pruneState(e),r=k(t.tags);return[...n.entries].filter(e=>!(t.repositoryPath&&e.repositoryPath!==p(t.repositoryPath)||t.serviceType&&e.serviceType!==t.serviceType||t.serviceName&&e.serviceName!==t.serviceName||t.environment&&e.environment!==t.environment||r&&r.length>0&&!this.matchesTags(e.tags,r)))})}async withLock(t){let n=`${process.pid}-${e(6).toString(`hex`)}`;await this.acquireLock(n);try{return await t()}finally{await this.releaseLock(n)}}async loadState(){await i.mkdir(n.dirname(this.registryPath),{recursive:!0});try{let e=await i.readFile(this.registryPath,`utf-8`),t=JSON.parse(e);return S.parse(t)}catch(e){let t=e;if(t.code===`ENOENT`)return{version:1,updatedAt:new Date().toISOString(),entries:[]};if(t instanceof SyntaxError){let e=`${this.registryPath}.corrupt.${Date.now()}`;await i.rename(this.registryPath,e).catch(()=>void 0)}throw new D(`Failed to read registry file: ${e instanceof Error?e.message:String(e)}`,`REGISTRY_READ_FAILED`,{cause:e})}}async saveState(e){await i.mkdir(n.dirname(this.registryPath),{recursive:!0});let t={...e,updatedAt:new Date().toISOString(),entries:[...e.entries]},r=m(this.registryPath);await i.writeFile(r,JSON.stringify(t,null,2),`utf-8`),await i.rename(r,this.registryPath)}async pruneState(e){let t=await this.pruneMissingRepositories(e);return this.pruneDeadProcesses(t)}async pruneMissingRepositories(e){let t=(await Promise.all(e.entries.map(async e=>({entry:e,exists:await this.pathExists(e.repositoryPath)})))).filter(e=>e.exists).map(e=>e.entry);return t.length!==e.entries.length&&(e.entries=t,await this.saveState(e)),e}async pruneDeadProcesses(e){let t=[],n=!1;for(let r of e.entries){if(this.isProcessRunning(r.pid)){t.push(r);continue}n=!0,await this.releaseAssociatedPort(r)}return n&&(e.entries=t,await this.saveState(e)),e}async acquireLock(e){await i.mkdir(n.dirname(this.lockPath),{recursive:!0});for(let t=0;t<80;t+=1)try{let t={pid:process.pid,token:e,createdAt:new Date().toISOString()};await i.writeFile(this.lockPath,JSON.stringify(t),{flag:`wx`}),this.registerLockCleanup(e);return}catch(e){if(e.code!==`EEXIST`)throw new D(`Failed to acquire registry lock: ${e instanceof Error?e.message:String(e)}`,`REGISTRY_LOCK_FAILED`,{cause:e});if(await this.isStaleLock()){await i.unlink(this.lockPath).catch(()=>void 0),--t;continue}await this.delay(75)}throw new D(`Unable to acquire registry lock (timeout)`,`REGISTRY_LOCK_FAILED`)}async releaseLock(e){try{let t=await i.readFile(this.lockPath,`utf-8`);JSON.parse(t).token===e&&await i.unlink(this.lockPath)}catch{}finally{this.unregisterLockCleanup(e)}}async isStaleLock(){try{let e=await i.readFile(this.lockPath,`utf-8`),t=JSON.parse(e);if(t.pid&&this.isProcessRunning(t.pid)){let e=Date.now()-new Date(t.createdAt).getTime();return!(Number.isFinite(e)&&e<5e3)}return!0}catch{return!0}}isProcessRunning(e){try{return process.kill(e,0),!0}catch{return!1}}registerLockCleanup(e){this.unregisterLockCleanup(this.activeLockToken),this.activeLockToken=e;let t=()=>{this.releaseLockSync(e)};for(let e of[`exit`,`SIGINT`,`SIGTERM`,`uncaughtException`,`unhandledRejection`])process.once(e,t),this.lockCleanupHandlers.set(e,t)}unregisterLockCleanup(e){if(!(!e||this.activeLockToken!==e)){for(let[e,t]of this.lockCleanupHandlers)process.off(e,t);this.lockCleanupHandlers.clear(),this.activeLockToken=void 0}}releaseLockSync(e){try{let t=r.readFileSync(this.lockPath,`utf-8`);JSON.parse(t).token===e&&r.unlinkSync(this.lockPath)}catch{}}async terminateProcess(e){try{process.kill(e,0)}catch{return}try{process.kill(e,`SIGTERM`)}catch(t){if(t.code===`ESRCH`)return;throw Error(`Failed to send SIGTERM to process ${e}: ${t instanceof Error?t.message:String(t)}`,{cause:t})}if(await this.delay(500),this.isProcessRunning(e)){try{process.kill(e,`SIGKILL`)}catch(t){if(t.code===`ESRCH`)return;throw Error(`Failed to send SIGKILL to process ${e}: ${t instanceof Error?t.message:String(t)}`,{cause:t})}if(await this.delay(250),this.isProcessRunning(e))throw Error(`Process ${e} did not exit after SIGKILL`)}}async releaseAssociatedPort(e){if(!(!this.portRegistry||!e.port))try{let t=await this.portRegistry.releasePort({repositoryPath:e.repositoryPath,serviceName:e.serviceName,serviceType:e.serviceType,environment:e.environment,pid:e.pid,force:!0});if(!t.success&&t.error&&!t.error.includes(`No matching registry entry`))throw Error(t.error)}catch{}}entryKey(e){return[e.repositoryPath,e.serviceName,e.serviceType,e.environment??``,String(e.pid)].join(`|`)}findEntry(e,t){return e.entries.find(e=>e.repositoryPath===t.repositoryPath&&e.serviceName===t.serviceName&&e.serviceType===t.serviceType&&(t.environment?e.environment===t.environment:!0))}removeMatchingEntries(e,t){e.entries=e.entries.filter(e=>!(e.repositoryPath===t.repositoryPath&&e.serviceName===t.serviceName&&e.serviceType===t.serviceType&&(!t.environment||e.environment===t.environment)))}createSuccessResponse(e,t){return E.parse({success:!0,...typeof e==`number`?{pid:e}:{},...t?{record:t}:{}})}createFailureResponse(e){return E.parse({success:!1,error:e})}matchesTags(e,t){return t.length===0?!0:!e||e.length===0?!1:t.some(t=>e.includes(t))}async pathExists(e){try{return await i.access(e),!0}catch{return!1}}delay(e){return new Promise(t=>setTimeout(t,e))}};function k(e){if(e!==void 0)return Array.from(new Set(e.map(e=>e.trim()).filter(e=>e.length>0)))}export{f as _,x as a,h as b,v as c,y as d,c as f,d as g,l as h,D as i,C as l,u as m,T as n,E as o,s as p,b as r,S as s,O as t,w as u,m as v,g as x,p as y};
 //# sourceMappingURL=ProcessRegistryService.mjs.map

package/dist/ProcessRegistryService.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ProcessRegistryService.mjs","names":[],"sources":["../src/types/index.ts","../src/utils/index.ts","../src/services/ProcessRegistryService.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport const REGISTRY_VERSION = 1 as const;\n\nexport const ServiceCategorySchema = z.enum(['service', 'tool']);\n\nexport const ProcessMetadataSchema = z.record(z.string(), z.unknown());\n\nexport const ProcessRegistryRecordSchema = z.object({\n  repositoryPath: z.string().trim().min(1, 'repositoryPath is required'),\n  serviceName: z.string().trim().min(1, 'serviceName is required'),\n  serviceType: ServiceCategorySchema,\n  environment: z.string().trim().min(1).optional(),\n  pid: z.number().int().min(1),\n  port: z.number().int().min(1).max(65535).optional(),\n  host: z.string().trim().min(1).optional(),\n  command: z.string().trim().min(1).optional(),\n  args: z.array(z.string()).optional(),\n  metadata: ProcessMetadataSchema.optional(),\n  createdAt: z.string().trim().min(1),\n  updatedAt: z.string().trim().min(1),\n});\n\nexport const ProcessRegistryStateSchema = z.object({\n  version: z.literal(REGISTRY_VERSION),\n  updatedAt: z.string().trim().min(1),\n  entries: z.array(ProcessRegistryRecordSchema),\n});\n\nexport const RegisterProcessRequestSchema = z.object({\n  repositoryPath: z.string().trim().min(1),\n  serviceName: z.string().trim().min(1),\n  serviceType: ServiceCategorySchema.default('service'),\n  environment: z.string().trim().min(1).optional(),\n  pid: z.number().int().min(1),\n  port: z.number().int().min(1).max(65535).optional(),\n  host: z.string().trim().min(1).optional(),\n  command: z.string().trim().min(1).optional(),\n  args: z.array(z.string()).optional(),\n  metadata: ProcessMetadataSchema.optional(),\n  force: z.boolean().optional(),\n});\n\nexport const ReleaseProcessRequestSchema = z.object({\n  repositoryPath: z.string().trim().min(1),\n  serviceName: z.string().trim().min(1),\n  serviceType: ServiceCategorySchema.optional(),\n  pid: z.number().int().min(1).optional(),\n  environment: z.string().trim().min(1).optional(),\n  force: z.boolean().optional(),\n  kill: z.boolean().optional().default(true),\n  releasePort: z.boolean().optional().default(true),\n});\n\nexport const ListProcessFiltersSchema = z.object({\n  repositoryPath: z.string().trim().min(1).optional(),\n  serviceType: ServiceCategorySchema.optional(),\n  serviceName: z.string().trim().min(1).optional(),\n  environment: z.string().trim().min(1).optional(),\n});\n\nexport const ProcessRegistryResponseSchema = z.object({\n  success: z.boolean(),\n  pid: z.number().int().min(1).optional(),\n  record: ProcessRegistryRecordSchema.optional(),\n  error: z.string().optional(),\n});\n\nexport type ServiceCategory = z.infer<typeof ServiceCategorySchema>;\nexport type ProcessMetadata = z.infer<typeof ProcessMetadataSchema>;\nexport type ProcessRegistryRecord = z.infer<typeof ProcessRegistryRecordSchema>;\nexport type ProcessRegistryState = z.infer<typeof ProcessRegistryStateSchema>;\nexport type RegisterProcessRequest = z.infer<typeof RegisterProcessRequestSchema>;\nexport type ReleaseProcessRequest = z.infer<typeof ReleaseProcessRequestSchema>;\nexport type ListProcessFilters = z.infer<typeof ListProcessFiltersSchema>;\nexport type ProcessRegistryResponse = z.infer<typeof ProcessRegistryResponseSchema>;\n\nexport type ProcessRegistryErrorCode =\n  | 'INVALID_REQUEST'\n  | 'REGISTRY_READ_FAILED'\n  | 'REGISTRY_WRITE_FAILED'\n  | 'REGISTRY_LOCK_FAILED'\n  | 'NO_PROCESS_FOUND';\n\nexport class ProcessRegistryError extends Error {\n  readonly code: ProcessRegistryErrorCode;\n\n  constructor(message: string, code: ProcessRegistryErrorCode, options?: ErrorOptions) {\n    super(message, options);\n    this.name = 'ProcessRegistryError';\n    this.code = code;\n  }\n}\n","import { randomBytes } from 'node:crypto';\nimport os from 'node:os';\nimport path from 'node:path';\n\nexport const DEFAULT_REGISTRY_PATH = path.join(os.homedir(), '.process-registry', 'processes.json');\nexport const DEFAULT_REGISTRY_LOCK_PATH = `${DEFAULT_REGISTRY_PATH}.lock`;\nexport const LOCK_RETRY_DELAY_MS = 75;\nexport const LOCK_MAX_RETRIES = 80;\nexport const LOCK_STALE_AFTER_MS = 5_000;\n\nexport const normalizeRepositoryPath = (value: string): string => path.resolve(value);\n\nexport const makeTempPath = (filePath: string): string => {\n  const random = randomBytes(6).toString('hex');\n  return `${filePath}.${random}.tmp`;\n};\n\nexport function resolveSiblingRegistryPath(registryPath: string | undefined, fileName: string): string | undefined {\n  if (!registryPath) {\n    return undefined;\n  }\n\n  const resolved = path.resolve(registryPath);\n  if (path.extname(resolved) === '.json') {\n    return path.join(path.dirname(resolved), fileName);\n  }\n\n  return path.join(resolved, fileName);\n}\n","import { randomBytes } from 'node:crypto';\nimport fsSync from 'node:fs';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { PortRegistryService } from '@agimon-ai/foundation-port-registry';\nimport {\n  type ListProcessFilters,\n  ListProcessFiltersSchema,\n  ProcessRegistryError,\n  type ProcessRegistryRecord,\n  type ProcessRegistryResponse,\n  ProcessRegistryResponseSchema,\n  type ProcessRegistryState,\n  ProcessRegistryStateSchema,\n  REGISTRY_VERSION,\n  type RegisterProcessRequest,\n  RegisterProcessRequestSchema,\n  type ReleaseProcessRequest,\n  ReleaseProcessRequestSchema,\n} from '../types';\nimport {\n  DEFAULT_REGISTRY_PATH,\n  LOCK_MAX_RETRIES,\n  LOCK_RETRY_DELAY_MS,\n  LOCK_STALE_AFTER_MS,\n  makeTempPath,\n  normalizeRepositoryPath,\n} from '../utils';\n\ninterface LockState {\n  pid: number;\n  token: string;\n  createdAt: string;\n}\n\ninterface NormalizedFilters {\n  repositoryPath: string;\n  serviceName: string;\n  serviceType: 'service' | 'tool';\n  environment?: string;\n}\n\ntype LockCleanupEvent = 'exit' | 'SIGINT' | 'SIGTERM' | 'uncaughtException' | 'unhandledRejection';\n\ntype PortRegistryCleanup = Pick<PortRegistryService, 'releasePort'>;\n\nexport class ProcessRegistryService {\n  private readonly registryPath: string;\n  private readonly lockPath: string;\n  private activeLockToken?: string;\n  private readonly lockCleanupHandlers = new Map<LockCleanupEvent, (...args: unknown[]) => void>();\n\n  constructor(\n    registryPath: string = DEFAULT_REGISTRY_PATH,\n    lockPath?: string,\n    private readonly portRegistry: PortRegistryCleanup = new PortRegistryService(process.env.PORT_REGISTRY_PATH),\n  ) {\n    this.registryPath = ProcessRegistryService.resolveRegistryPath(registryPath);\n    this.lockPath = lockPath ?? `${this.registryPath}.lock`;\n  }\n\n  static resolveRegistryPath(inputPath?: string): string {\n    if (!inputPath) {\n      return DEFAULT_REGISTRY_PATH;\n    }\n\n    const resolvedPath = path.isAbsolute(inputPath) ? inputPath : path.join(process.cwd(), inputPath);\n    if (path.extname(resolvedPath) === '.json') {\n      return resolvedPath;\n    }\n\n    return path.join(resolvedPath, 'processes.json');\n  }\n\n  async registerProcess(rawRequest: RegisterProcessRequest): Promise<ProcessRegistryResponse> {\n    const request = RegisterProcessRequestSchema.parse(rawRequest);\n\n    return this.withLock(async () => {\n      const state = await this.loadState();\n      const normalizedRepo = normalizeRepositoryPath(request.repositoryPath);\n      const serviceType = request.serviceType ?? 'service';\n      const environment = request.environment ?? process.env.NODE_ENV ?? 'development';\n      const registry = await this.pruneState(state);\n      const existing = this.findEntry(registry, {\n        repositoryPath: normalizedRepo,\n        serviceName: request.serviceName,\n        serviceType,\n        environment,\n      });\n\n      if (existing) {\n        if (existing.pid === request.pid) {\n          existing.updatedAt = new Date().toISOString();\n          existing.port = request.port ?? existing.port;\n          existing.host = request.host ?? existing.host;\n          existing.command = request.command ?? existing.command;\n          existing.args = request.args ?? existing.args;\n          existing.metadata = request.metadata ?? existing.metadata;\n          await this.saveState(registry);\n          return this.createSuccessResponse(request.pid, existing);\n        }\n\n        const isAlive = this.isProcessRunning(existing.pid);\n        if (isAlive && !(request.force ?? true)) {\n          return this.createFailureResponse(`Process already registered for ${request.serviceName} in requested scope`);\n        }\n\n        if (isAlive) {\n          await this.terminateProcess(existing.pid);\n        }\n\n        await this.releaseAssociatedPort(existing);\n        this.removeMatchingEntries(registry, {\n          repositoryPath: normalizedRepo,\n          serviceName: request.serviceName,\n          serviceType,\n          environment,\n        });\n      }\n\n      const now = new Date().toISOString();\n      const record: ProcessRegistryRecord = {\n        repositoryPath: normalizedRepo,\n        serviceName: request.serviceName,\n        serviceType,\n        environment,\n        pid: request.pid,\n        port: request.port,\n        host: request.host,\n        command: request.command,\n        args: request.args,\n        metadata: request.metadata,\n        createdAt: now,\n        updatedAt: now,\n      };\n\n      registry.entries.push(record);\n      await this.saveState(registry);\n      return this.createSuccessResponse(request.pid, record);\n    });\n  }\n\n  async releaseProcess(rawRequest: ReleaseProcessRequest): Promise<ProcessRegistryResponse> {\n    const request = ReleaseProcessRequestSchema.parse(rawRequest);\n\n    return this.withLock(async () => {\n      const state = await this.loadState();\n      const registry = await this.pruneMissingRepositories(state);\n      const normalizedRepo = normalizeRepositoryPath(request.repositoryPath);\n      const serviceType = request.serviceType ?? 'service';\n      const environment = request.environment ?? process.env.NODE_ENV ?? 'development';\n      const matches = registry.entries.filter((entry) => {\n        if (entry.repositoryPath !== normalizedRepo) return false;\n        if (entry.serviceName !== request.serviceName) return false;\n        if (entry.serviceType !== serviceType) return false;\n        if (request.environment && entry.environment !== environment) return false;\n        if (typeof request.pid === 'number' && entry.pid !== request.pid) return false;\n        return true;\n      });\n\n      if (matches.length === 0) {\n        return this.createFailureResponse(`No matching process entry for ${request.serviceName}`);\n      }\n\n      const errors: string[] = [];\n      const removable = new Set<string>();\n\n      for (const entry of matches) {\n        const entryKey = this.entryKey(entry);\n\n        try {\n          if (request.kill ?? true) {\n            if (this.isProcessRunning(entry.pid)) {\n              await this.terminateProcess(entry.pid);\n            }\n          }\n\n          if (request.releasePort ?? true) {\n            await this.releaseAssociatedPort(entry);\n          }\n\n          removable.add(entryKey);\n        } catch (error) {\n          errors.push(\n            `${entry.serviceName} (pid ${entry.pid}): ${error instanceof Error ? error.message : String(error)}`,\n          );\n        }\n      }\n\n      if (removable.size > 0) {\n        registry.entries = registry.entries.filter((entry) => !removable.has(this.entryKey(entry)));\n        await this.saveState(registry);\n      }\n\n      if (errors.length > 0) {\n        return this.createFailureResponse(errors.join('; '));\n      }\n\n      return this.createSuccessResponse();\n    });\n  }\n\n  async listProcesses(filters: ListProcessFilters = {}): Promise<ProcessRegistryRecord[]> {\n    const request = ListProcessFiltersSchema.parse(filters);\n\n    return this.withLock(async () => {\n      const state = await this.loadState();\n      const registry = await this.pruneState(state);\n\n      return [...registry.entries].filter((entry) => {\n        if (request.repositoryPath && entry.repositoryPath !== normalizeRepositoryPath(request.repositoryPath)) {\n          return false;\n        }\n        if (request.serviceType && entry.serviceType !== request.serviceType) return false;\n        if (request.serviceName && entry.serviceName !== request.serviceName) return false;\n        if (request.environment && entry.environment !== request.environment) return false;\n        return true;\n      });\n    });\n  }\n\n  private async withLock<T>(callback: () => Promise<T>): Promise<T> {\n    const lockToken = `${process.pid}-${randomBytes(6).toString('hex')}`;\n    await this.acquireLock(lockToken);\n\n    try {\n      return await callback();\n    } finally {\n      await this.releaseLock(lockToken);\n    }\n  }\n\n  private async loadState(): Promise<ProcessRegistryState> {\n    await fs.mkdir(path.dirname(this.registryPath), { recursive: true });\n\n    try {\n      const content = await fs.readFile(this.registryPath, 'utf-8');\n      const parsed = JSON.parse(content);\n      return ProcessRegistryStateSchema.parse(parsed);\n    } catch (error) {\n      const sysError = error as NodeJS.ErrnoException;\n      if (sysError.code === 'ENOENT') {\n        return {\n          version: REGISTRY_VERSION,\n          updatedAt: new Date().toISOString(),\n          entries: [],\n        };\n      }\n\n      if (sysError instanceof SyntaxError) {\n        const backupPath = `${this.registryPath}.corrupt.${Date.now()}`;\n        await fs.rename(this.registryPath, backupPath).catch(() => undefined);\n      }\n\n      throw new ProcessRegistryError(\n        `Failed to read registry file: ${error instanceof Error ? error.message : String(error)}`,\n        'REGISTRY_READ_FAILED',\n        { cause: error },\n      );\n    }\n  }\n\n  private async saveState(state: ProcessRegistryState): Promise<void> {\n    await fs.mkdir(path.dirname(this.registryPath), { recursive: true });\n\n    const payload: ProcessRegistryState = {\n      ...state,\n      updatedAt: new Date().toISOString(),\n      entries: [...state.entries],\n    };\n\n    const tempPath = makeTempPath(this.registryPath);\n    await fs.writeFile(tempPath, JSON.stringify(payload, null, 2), 'utf-8');\n    await fs.rename(tempPath, this.registryPath);\n  }\n\n  private async pruneState(state: ProcessRegistryState): Promise<ProcessRegistryState> {\n    const repositoryPruned = await this.pruneMissingRepositories(state);\n    return this.pruneDeadProcesses(repositoryPruned);\n  }\n\n  private async pruneMissingRepositories(state: ProcessRegistryState): Promise<ProcessRegistryState> {\n    const entries = await Promise.all(\n      state.entries.map(async (entry) => ({\n        entry,\n        exists: await this.pathExists(entry.repositoryPath),\n      })),\n    );\n\n    const pruned = entries.filter((value) => value.exists).map((value) => value.entry);\n    if (pruned.length !== state.entries.length) {\n      state.entries = pruned;\n      await this.saveState(state);\n    }\n\n    return state;\n  }\n\n  private async pruneDeadProcesses(state: ProcessRegistryState): Promise<ProcessRegistryState> {\n    const aliveEntries: ProcessRegistryRecord[] = [];\n    let changed = false;\n\n    for (const entry of state.entries) {\n      if (this.isProcessRunning(entry.pid)) {\n        aliveEntries.push(entry);\n        continue;\n      }\n\n      changed = true;\n      await this.releaseAssociatedPort(entry);\n    }\n\n    if (changed) {\n      state.entries = aliveEntries;\n      await this.saveState(state);\n    }\n\n    return state;\n  }\n\n  private async acquireLock(token: string): Promise<void> {\n    await fs.mkdir(path.dirname(this.lockPath), { recursive: true });\n\n    for (let attempt = 0; attempt < LOCK_MAX_RETRIES; attempt += 1) {\n      try {\n        const lockState: LockState = {\n          pid: process.pid,\n          token,\n          createdAt: new Date().toISOString(),\n        };\n        await fs.writeFile(this.lockPath, JSON.stringify(lockState), { flag: 'wx' });\n        this.registerLockCleanup(token);\n        return;\n      } catch (error) {\n        if ((error as NodeJS.ErrnoException).code !== 'EEXIST') {\n          throw new ProcessRegistryError(\n            `Failed to acquire registry lock: ${error instanceof Error ? error.message : String(error)}`,\n            'REGISTRY_LOCK_FAILED',\n            { cause: error },\n          );\n        }\n\n        const stale = await this.isStaleLock();\n        if (stale) {\n          await fs.unlink(this.lockPath).catch(() => undefined);\n          attempt -= 1;\n          continue;\n        }\n\n        await this.delay(LOCK_RETRY_DELAY_MS);\n      }\n    }\n\n    throw new ProcessRegistryError('Unable to acquire registry lock (timeout)', 'REGISTRY_LOCK_FAILED');\n  }\n\n  private async releaseLock(token: string): Promise<void> {\n    try {\n      const existing = await fs.readFile(this.lockPath, 'utf-8');\n      const parsed = JSON.parse(existing) as { token: string };\n      if (parsed.token === token) {\n        await fs.unlink(this.lockPath);\n      }\n    } catch {\n      // ignore\n    } finally {\n      this.unregisterLockCleanup(token);\n    }\n  }\n\n  private async isStaleLock(): Promise<boolean> {\n    try {\n      const content = await fs.readFile(this.lockPath, 'utf-8');\n      const parsed = JSON.parse(content) as LockState;\n\n      if (parsed.pid) {\n        const pidAlive = this.isProcessRunning(parsed.pid);\n        if (pidAlive) {\n          const age = Date.now() - new Date(parsed.createdAt).getTime();\n          return !(Number.isFinite(age) && age < LOCK_STALE_AFTER_MS);\n        }\n      }\n\n      return true;\n    } catch {\n      return true;\n    }\n  }\n\n  private isProcessRunning(pid: number): boolean {\n    try {\n      process.kill(pid, 0);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private registerLockCleanup(token: string): void {\n    this.unregisterLockCleanup(this.activeLockToken);\n    this.activeLockToken = token;\n\n    const cleanup = (): void => {\n      this.releaseLockSync(token);\n    };\n\n    for (const event of [\n      'exit',\n      'SIGINT',\n      'SIGTERM',\n      'uncaughtException',\n      'unhandledRejection',\n    ] satisfies LockCleanupEvent[]) {\n      process.once(event, cleanup);\n      this.lockCleanupHandlers.set(event, cleanup);\n    }\n  }\n\n  private unregisterLockCleanup(token: string | undefined): void {\n    if (!token || this.activeLockToken !== token) {\n      return;\n    }\n\n    for (const [event, handler] of this.lockCleanupHandlers) {\n      process.off(event, handler);\n    }\n\n    this.lockCleanupHandlers.clear();\n    this.activeLockToken = undefined;\n  }\n\n  private releaseLockSync(token: string): void {\n    try {\n      const existing = fsSync.readFileSync(this.lockPath, 'utf-8');\n      const parsed = JSON.parse(existing) as { token?: string };\n      if (parsed.token === token) {\n        fsSync.unlinkSync(this.lockPath);\n      }\n    } catch {\n      // ignore best-effort cleanup\n    }\n  }\n\n  private async terminateProcess(pid: number): Promise<void> {\n    try {\n      process.kill(pid, 0);\n    } catch {\n      return;\n    }\n\n    try {\n      process.kill(pid, 'SIGTERM');\n    } catch (error) {\n      const sysError = error as NodeJS.ErrnoException;\n      if (sysError.code === 'ESRCH') {\n        return;\n      }\n\n      throw new Error(\n        `Failed to send SIGTERM to process ${pid}: ${error instanceof Error ? error.message : String(error)}`,\n        {\n          cause: error,\n        },\n      );\n    }\n\n    await this.delay(500);\n\n    if (!this.isProcessRunning(pid)) {\n      return;\n    }\n\n    try {\n      process.kill(pid, 'SIGKILL');\n    } catch (error) {\n      const sysError = error as NodeJS.ErrnoException;\n      if (sysError.code === 'ESRCH') {\n        return;\n      }\n\n      throw new Error(\n        `Failed to send SIGKILL to process ${pid}: ${error instanceof Error ? error.message : String(error)}`,\n        {\n          cause: error,\n        },\n      );\n    }\n\n    await this.delay(250);\n\n    if (this.isProcessRunning(pid)) {\n      throw new Error(`Process ${pid} did not exit after SIGKILL`);\n    }\n  }\n\n  private async releaseAssociatedPort(entry: ProcessRegistryRecord): Promise<void> {\n    if (!this.portRegistry || !entry.port) {\n      return;\n    }\n\n    try {\n      const result = await this.portRegistry.releasePort({\n        repositoryPath: entry.repositoryPath,\n        serviceName: entry.serviceName,\n        serviceType: entry.serviceType,\n        environment: entry.environment,\n        pid: entry.pid,\n        force: true,\n      });\n\n      if (!result.success && result.error && !result.error.includes('No matching registry entry')) {\n        throw new Error(result.error);\n      }\n    } catch {\n      // Best-effort cleanup: port release failures should not block process cleanup.\n    }\n  }\n\n  private entryKey(entry: ProcessRegistryRecord): string {\n    return [\n      entry.repositoryPath,\n      entry.serviceName,\n      entry.serviceType,\n      entry.environment ?? '',\n      String(entry.pid),\n    ].join('|');\n  }\n\n  private findEntry(state: ProcessRegistryState, filters: NormalizedFilters): ProcessRegistryRecord | undefined {\n    return state.entries.find(\n      (entry) =>\n        entry.repositoryPath === filters.repositoryPath &&\n        entry.serviceName === filters.serviceName &&\n        entry.serviceType === filters.serviceType &&\n        (filters.environment ? entry.environment === filters.environment : true),\n    );\n  }\n\n  private removeMatchingEntries(state: ProcessRegistryState, filters: NormalizedFilters): void {\n    state.entries = state.entries.filter(\n      (entry) =>\n        !(\n          entry.repositoryPath === filters.repositoryPath &&\n          entry.serviceName === filters.serviceName &&\n          entry.serviceType === filters.serviceType &&\n          (!filters.environment || entry.environment === filters.environment)\n        ),\n    );\n  }\n\n  private createSuccessResponse(pid?: number, record?: ProcessRegistryRecord): ProcessRegistryResponse {\n    return ProcessRegistryResponseSchema.parse({\n      success: true,\n      ...(typeof pid === 'number' ? { pid } : {}),\n      ...(record ? { record } : {}),\n    });\n  }\n\n  private createFailureResponse(error: string): ProcessRegistryResponse {\n    return ProcessRegistryResponseSchema.parse({\n      success: false,\n      error,\n    });\n  }\n\n  private async pathExists(candidate: string): Promise<boolean> {\n    try {\n      await fs.access(candidate);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"ProcessRegistryService.mjs","names":["normalizeTags"],"sources":["../src/utils/index.ts","../src/types/index.ts","../src/services/ProcessRegistryService.ts"],"sourcesContent":["import { randomBytes } from 'node:crypto';\nimport os from 'node:os';\nimport path from 'node:path';\n\nexport const DEFAULT_REGISTRY_PATH = path.join(os.homedir(), '.process-registry', 'processes.json');\nexport const DEFAULT_REGISTRY_LOCK_PATH = `${DEFAULT_REGISTRY_PATH}.lock`;\nexport const LOCK_RETRY_DELAY_MS = 75;\nexport const LOCK_MAX_RETRIES = 80;\nexport const LOCK_STALE_AFTER_MS = 5_000;\nexport const PROCESS_REGISTRY_TAG_ENV_VAR = 'PROCESS_REGISTRY_TAG';\n\nexport const normalizeRepositoryPath = (value: string): string => path.resolve(value);\n\nexport const makeTempPath = (filePath: string): string => {\n  const random = randomBytes(6).toString('hex');\n  return `${filePath}.${random}.tmp`;\n};\n\nexport function resolveProcessTags(tags?: string[]): string[] | undefined {\n  const resolved = normalizeTags(tags);\n  const envTags = normalizeTags(process.env[PROCESS_REGISTRY_TAG_ENV_VAR]);\n\n  const combined = [...(resolved ?? []), ...(envTags ?? [])];\n  if (combined.length === 0) {\n    return undefined;\n  }\n\n  return Array.from(new Set(combined));\n}\n\nexport function resolveSiblingRegistryPath(registryPath: string | undefined, fileName: string): string | undefined {\n  if (!registryPath) {\n    return undefined;\n  }\n\n  const resolved = path.resolve(registryPath);\n  if (path.extname(resolved) === '.json') {\n    return path.join(path.dirname(resolved), fileName);\n  }\n\n  return path.join(resolved, fileName);\n}\n\nfunction normalizeTags(tags: string[] | string | undefined): string[] | undefined {\n  if (tags === undefined) {\n    return undefined;\n  }\n\n  const values = Array.isArray(tags)\n    ? tags\n    : tags\n        .split(',')\n        .map((tag) => tag.trim())\n        .filter((tag) => tag.length > 0);\n\n  const normalized = values.map((tag) => tag.trim()).filter((tag) => tag.length > 0);\n  return normalized.length > 0 ? normalized : undefined;\n}\n","import { z } from 'zod';\n\nexport const REGISTRY_VERSION = 1 as const;\n\nexport const ServiceCategorySchema = z.enum(['service', 'tool']);\n\nexport const ProcessMetadataSchema = z.record(z.string(), z.unknown());\n\nexport const ProcessRegistryRecordSchema = z.object({\n  repositoryPath: z.string().trim().min(1, 'repositoryPath is required'),\n  serviceName: z.string().trim().min(1, 'serviceName is required'),\n  serviceType: ServiceCategorySchema,\n  environment: z.string().trim().min(1).optional(),\n  pid: z.number().int().min(1),\n  port: z.number().int().min(1).max(65535).optional(),\n  host: z.string().trim().min(1).optional(),\n  command: z.string().trim().min(1).optional(),\n  args: z.array(z.string()).optional(),\n  tags: z.array(z.string().trim().min(1)).optional(),\n  metadata: ProcessMetadataSchema.optional(),\n  createdAt: z.string().trim().min(1),\n  updatedAt: z.string().trim().min(1),\n});\n\nexport const ProcessRegistryStateSchema = z.object({\n  version: z.literal(REGISTRY_VERSION),\n  updatedAt: z.string().trim().min(1),\n  entries: z.array(ProcessRegistryRecordSchema),\n});\n\nexport const RegisterProcessRequestSchema = z.object({\n  repositoryPath: z.string().trim().min(1),\n  serviceName: z.string().trim().min(1),\n  serviceType: ServiceCategorySchema.default('service'),\n  environment: z.string().trim().min(1).optional(),\n  pid: z.number().int().min(1),\n  port: z.number().int().min(1).max(65535).optional(),\n  host: z.string().trim().min(1).optional(),\n  command: z.string().trim().min(1).optional(),\n  args: z.array(z.string()).optional(),\n  tags: z.array(z.string().trim().min(1)).optional(),\n  metadata: ProcessMetadataSchema.optional(),\n  force: z.boolean().optional(),\n});\n\nexport const ReleaseProcessRequestSchema = z.object({\n  repositoryPath: z.string().trim().min(1),\n  serviceName: z.string().trim().min(1),\n  serviceType: ServiceCategorySchema.optional(),\n  pid: z.number().int().min(1).optional(),\n  environment: z.string().trim().min(1).optional(),\n  tags: z.array(z.string().trim().min(1)).optional(),\n  force: z.boolean().optional(),\n  kill: z.boolean().optional().default(true),\n  releasePort: z.boolean().optional().default(true),\n});\n\nexport const ListProcessFiltersSchema = z.object({\n  repositoryPath: z.string().trim().min(1).optional(),\n  serviceType: ServiceCategorySchema.optional(),\n  serviceName: z.string().trim().min(1).optional(),\n  environment: z.string().trim().min(1).optional(),\n  tags: z.array(z.string().trim().min(1)).optional(),\n});\n\nexport const ProcessRegistryResponseSchema = z.object({\n  success: z.boolean(),\n  pid: z.number().int().min(1).optional(),\n  record: ProcessRegistryRecordSchema.optional(),\n  error: z.string().optional(),\n});\n\nexport type ServiceCategory = z.infer<typeof ServiceCategorySchema>;\nexport type ProcessMetadata = z.infer<typeof ProcessMetadataSchema>;\nexport type ProcessRegistryRecord = z.infer<typeof ProcessRegistryRecordSchema>;\nexport type ProcessRegistryState = z.infer<typeof ProcessRegistryStateSchema>;\nexport type RegisterProcessRequest = z.infer<typeof RegisterProcessRequestSchema>;\nexport type ReleaseProcessRequest = z.infer<typeof ReleaseProcessRequestSchema>;\nexport type ListProcessFilters = z.infer<typeof ListProcessFiltersSchema>;\nexport type ProcessRegistryResponse = z.infer<typeof ProcessRegistryResponseSchema>;\n\nexport type ProcessRegistryErrorCode =\n  | 'INVALID_REQUEST'\n  | 'REGISTRY_READ_FAILED'\n  | 'REGISTRY_WRITE_FAILED'\n  | 'REGISTRY_LOCK_FAILED'\n  | 'NO_PROCESS_FOUND';\n\nexport class ProcessRegistryError extends Error {\n  readonly code: ProcessRegistryErrorCode;\n\n  constructor(message: string, code: ProcessRegistryErrorCode, options?: ErrorOptions) {\n    super(message, options);\n    this.name = 'ProcessRegistryError';\n    this.code = code;\n  }\n}\n","import { randomBytes } from 'node:crypto';\nimport fsSync from 'node:fs';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { PortRegistryService } from '@agimon-ai/foundation-port-registry';\nimport {\n  type ListProcessFilters,\n  ListProcessFiltersSchema,\n  ProcessRegistryError,\n  type ProcessRegistryRecord,\n  type ProcessRegistryResponse,\n  ProcessRegistryResponseSchema,\n  type ProcessRegistryState,\n  ProcessRegistryStateSchema,\n  REGISTRY_VERSION,\n  type RegisterProcessRequest,\n  RegisterProcessRequestSchema,\n  type ReleaseProcessRequest,\n  ReleaseProcessRequestSchema,\n} from '../types';\nimport {\n  DEFAULT_REGISTRY_PATH,\n  LOCK_MAX_RETRIES,\n  LOCK_RETRY_DELAY_MS,\n  LOCK_STALE_AFTER_MS,\n  resolveProcessTags,\n  makeTempPath,\n  normalizeRepositoryPath,\n} from '../utils';\n\ninterface LockState {\n  pid: number;\n  token: string;\n  createdAt: string;\n}\n\ninterface NormalizedFilters {\n  repositoryPath: string;\n  serviceName: string;\n  serviceType: 'service' | 'tool';\n  environment?: string;\n  tags?: string[];\n}\n\ntype LockCleanupEvent = 'exit' | 'SIGINT' | 'SIGTERM' | 'uncaughtException' | 'unhandledRejection';\n\ntype PortRegistryCleanup = Pick<PortRegistryService, 'releasePort'>;\n\nexport class ProcessRegistryService {\n  private readonly registryPath: string;\n  private readonly lockPath: string;\n  private activeLockToken?: string;\n  private readonly lockCleanupHandlers = new Map<LockCleanupEvent, (...args: unknown[]) => void>();\n\n  constructor(\n    registryPath: string = DEFAULT_REGISTRY_PATH,\n    lockPath?: string,\n    private readonly portRegistry: PortRegistryCleanup = new PortRegistryService(process.env.PORT_REGISTRY_PATH),\n  ) {\n    this.registryPath = ProcessRegistryService.resolveRegistryPath(registryPath);\n    this.lockPath = lockPath ?? `${this.registryPath}.lock`;\n  }\n\n  static resolveRegistryPath(inputPath?: string): string {\n    if (!inputPath) {\n      return DEFAULT_REGISTRY_PATH;\n    }\n\n    const resolvedPath = path.isAbsolute(inputPath) ? inputPath : path.join(process.cwd(), inputPath);\n    if (path.extname(resolvedPath) === '.json') {\n      return resolvedPath;\n    }\n\n    return path.join(resolvedPath, 'processes.json');\n  }\n\n  async registerProcess(rawRequest: RegisterProcessRequest): Promise<ProcessRegistryResponse> {\n    const request = RegisterProcessRequestSchema.parse(rawRequest);\n\n    return this.withLock(async () => {\n      const state = await this.loadState();\n      const normalizedRepo = normalizeRepositoryPath(request.repositoryPath);\n      const serviceType = request.serviceType ?? 'service';\n      const environment = request.environment ?? process.env.NODE_ENV ?? 'development';\n      const tags = resolveProcessTags(request.tags);\n      const registry = await this.pruneState(state);\n      const existing = this.findEntry(registry, {\n        repositoryPath: normalizedRepo,\n        serviceName: request.serviceName,\n        serviceType,\n        environment,\n      });\n\n      if (existing) {\n        if (existing.pid === request.pid) {\n          existing.updatedAt = new Date().toISOString();\n          existing.port = request.port ?? existing.port;\n          existing.host = request.host ?? existing.host;\n          existing.command = request.command ?? existing.command;\n          existing.args = request.args ?? existing.args;\n          existing.tags = tags ?? existing.tags;\n          existing.metadata = request.metadata ?? existing.metadata;\n          await this.saveState(registry);\n          return this.createSuccessResponse(request.pid, existing);\n        }\n\n        const isAlive = this.isProcessRunning(existing.pid);\n        if (isAlive && !(request.force ?? true)) {\n          return this.createFailureResponse(`Process already registered for ${request.serviceName} in requested scope`);\n        }\n\n        if (isAlive) {\n          await this.terminateProcess(existing.pid);\n        }\n\n        await this.releaseAssociatedPort(existing);\n        this.removeMatchingEntries(registry, {\n          repositoryPath: normalizedRepo,\n          serviceName: request.serviceName,\n          serviceType,\n          environment,\n        });\n      }\n\n      const now = new Date().toISOString();\n      const record: ProcessRegistryRecord = {\n        repositoryPath: normalizedRepo,\n        serviceName: request.serviceName,\n        serviceType,\n        environment,\n        pid: request.pid,\n        port: request.port,\n        host: request.host,\n        command: request.command,\n        args: request.args,\n        tags,\n        metadata: request.metadata,\n        createdAt: now,\n        updatedAt: now,\n      };\n\n      registry.entries.push(record);\n      await this.saveState(registry);\n      return this.createSuccessResponse(request.pid, record);\n    });\n  }\n\n  async releaseProcess(rawRequest: ReleaseProcessRequest): Promise<ProcessRegistryResponse> {\n    const request = ReleaseProcessRequestSchema.parse(rawRequest);\n\n    return this.withLock(async () => {\n      const state = await this.loadState();\n      const registry = await this.pruneMissingRepositories(state);\n      const normalizedRepo = normalizeRepositoryPath(request.repositoryPath);\n      const serviceType = request.serviceType ?? 'service';\n      const environment = request.environment ?? process.env.NODE_ENV ?? 'development';\n      const requestedTags = normalizeTags(request.tags);\n      const matches = registry.entries.filter((entry) => {\n        if (entry.repositoryPath !== normalizedRepo) return false;\n        if (entry.serviceName !== request.serviceName) return false;\n        if (entry.serviceType !== serviceType) return false;\n        if (request.environment && entry.environment !== environment) return false;\n        if (typeof request.pid === 'number' && entry.pid !== request.pid) return false;\n        if (requestedTags && requestedTags.length > 0 && !this.matchesTags(entry.tags, requestedTags)) return false;\n        return true;\n      });\n\n      if (matches.length === 0) {\n        return this.createFailureResponse(`No matching process entry for ${request.serviceName}`);\n      }\n\n      const errors: string[] = [];\n      const removable = new Set<string>();\n\n      for (const entry of matches) {\n        const entryKey = this.entryKey(entry);\n\n        try {\n          if (request.kill ?? true) {\n            if (this.isProcessRunning(entry.pid)) {\n              await this.terminateProcess(entry.pid);\n            }\n          }\n\n          if (request.releasePort ?? true) {\n            await this.releaseAssociatedPort(entry);\n          }\n\n          removable.add(entryKey);\n        } catch (error) {\n          errors.push(\n            `${entry.serviceName} (pid ${entry.pid}): ${error instanceof Error ? error.message : String(error)}`,\n          );\n        }\n      }\n\n      if (removable.size > 0) {\n        registry.entries = registry.entries.filter((entry) => !removable.has(this.entryKey(entry)));\n        await this.saveState(registry);\n      }\n\n      if (errors.length > 0) {\n        return this.createFailureResponse(errors.join('; '));\n      }\n\n      return this.createSuccessResponse();\n    });\n  }\n\n  async listProcesses(filters: ListProcessFilters = {}): Promise<ProcessRegistryRecord[]> {\n    const request = ListProcessFiltersSchema.parse(filters);\n\n    return this.withLock(async () => {\n      const state = await this.loadState();\n      const registry = await this.pruneState(state);\n      const requestedTags = normalizeTags(request.tags);\n\n      return [...registry.entries].filter((entry) => {\n        if (request.repositoryPath && entry.repositoryPath !== normalizeRepositoryPath(request.repositoryPath)) {\n          return false;\n        }\n        if (request.serviceType && entry.serviceType !== request.serviceType) return false;\n        if (request.serviceName && entry.serviceName !== request.serviceName) return false;\n        if (request.environment && entry.environment !== request.environment) return false;\n        if (requestedTags && requestedTags.length > 0 && !this.matchesTags(entry.tags, requestedTags)) return false;\n        return true;\n      });\n    });\n  }\n\n  private async withLock<T>(callback: () => Promise<T>): Promise<T> {\n    const lockToken = `${process.pid}-${randomBytes(6).toString('hex')}`;\n    await this.acquireLock(lockToken);\n\n    try {\n      return await callback();\n    } finally {\n      await this.releaseLock(lockToken);\n    }\n  }\n\n  private async loadState(): Promise<ProcessRegistryState> {\n    await fs.mkdir(path.dirname(this.registryPath), { recursive: true });\n\n    try {\n      const content = await fs.readFile(this.registryPath, 'utf-8');\n      const parsed = JSON.parse(content);\n      return ProcessRegistryStateSchema.parse(parsed);\n    } catch (error) {\n      const sysError = error as NodeJS.ErrnoException;\n      if (sysError.code === 'ENOENT') {\n        return {\n          version: REGISTRY_VERSION,\n          updatedAt: new Date().toISOString(),\n          entries: [],\n        };\n      }\n\n      if (sysError instanceof SyntaxError) {\n        const backupPath = `${this.registryPath}.corrupt.${Date.now()}`;\n        await fs.rename(this.registryPath, backupPath).catch(() => undefined);\n      }\n\n      throw new ProcessRegistryError(\n        `Failed to read registry file: ${error instanceof Error ? error.message : String(error)}`,\n        'REGISTRY_READ_FAILED',\n        { cause: error },\n      );\n    }\n  }\n\n  private async saveState(state: ProcessRegistryState): Promise<void> {\n    await fs.mkdir(path.dirname(this.registryPath), { recursive: true });\n\n    const payload: ProcessRegistryState = {\n      ...state,\n      updatedAt: new Date().toISOString(),\n      entries: [...state.entries],\n    };\n\n    const tempPath = makeTempPath(this.registryPath);\n    await fs.writeFile(tempPath, JSON.stringify(payload, null, 2), 'utf-8');\n    await fs.rename(tempPath, this.registryPath);\n  }\n\n  private async pruneState(state: ProcessRegistryState): Promise<ProcessRegistryState> {\n    const repositoryPruned = await this.pruneMissingRepositories(state);\n    return this.pruneDeadProcesses(repositoryPruned);\n  }\n\n  private async pruneMissingRepositories(state: ProcessRegistryState): Promise<ProcessRegistryState> {\n    const entries = await Promise.all(\n      state.entries.map(async (entry) => ({\n        entry,\n        exists: await this.pathExists(entry.repositoryPath),\n      })),\n    );\n\n    const pruned = entries.filter((value) => value.exists).map((value) => value.entry);\n    if (pruned.length !== state.entries.length) {\n      state.entries = pruned;\n      await this.saveState(state);\n    }\n\n    return state;\n  }\n\n  private async pruneDeadProcesses(state: ProcessRegistryState): Promise<ProcessRegistryState> {\n    const aliveEntries: ProcessRegistryRecord[] = [];\n    let changed = false;\n\n    for (const entry of state.entries) {\n      if (this.isProcessRunning(entry.pid)) {\n        aliveEntries.push(entry);\n        continue;\n      }\n\n      changed = true;\n      await this.releaseAssociatedPort(entry);\n    }\n\n    if (changed) {\n      state.entries = aliveEntries;\n      await this.saveState(state);\n    }\n\n    return state;\n  }\n\n  private async acquireLock(token: string): Promise<void> {\n    await fs.mkdir(path.dirname(this.lockPath), { recursive: true });\n\n    for (let attempt = 0; attempt < LOCK_MAX_RETRIES; attempt += 1) {\n      try {\n        const lockState: LockState = {\n          pid: process.pid,\n          token,\n          createdAt: new Date().toISOString(),\n        };\n        await fs.writeFile(this.lockPath, JSON.stringify(lockState), { flag: 'wx' });\n        this.registerLockCleanup(token);\n        return;\n      } catch (error) {\n        if ((error as NodeJS.ErrnoException).code !== 'EEXIST') {\n          throw new ProcessRegistryError(\n            `Failed to acquire registry lock: ${error instanceof Error ? error.message : String(error)}`,\n            'REGISTRY_LOCK_FAILED',\n            { cause: error },\n          );\n        }\n\n        const stale = await this.isStaleLock();\n        if (stale) {\n          await fs.unlink(this.lockPath).catch(() => undefined);\n          attempt -= 1;\n          continue;\n        }\n\n        await this.delay(LOCK_RETRY_DELAY_MS);\n      }\n    }\n\n    throw new ProcessRegistryError('Unable to acquire registry lock (timeout)', 'REGISTRY_LOCK_FAILED');\n  }\n\n  private async releaseLock(token: string): Promise<void> {\n    try {\n      const existing = await fs.readFile(this.lockPath, 'utf-8');\n      const parsed = JSON.parse(existing) as { token: string };\n      if (parsed.token === token) {\n        await fs.unlink(this.lockPath);\n      }\n    } catch {\n      // ignore\n    } finally {\n      this.unregisterLockCleanup(token);\n    }\n  }\n\n  private async isStaleLock(): Promise<boolean> {\n    try {\n      const content = await fs.readFile(this.lockPath, 'utf-8');\n      const parsed = JSON.parse(content) as LockState;\n\n      if (parsed.pid) {\n        const pidAlive = this.isProcessRunning(parsed.pid);\n        if (pidAlive) {\n          const age = Date.now() - new Date(parsed.createdAt).getTime();\n          return !(Number.isFinite(age) && age < LOCK_STALE_AFTER_MS);\n        }\n      }\n\n      return true;\n    } catch {\n      return true;\n    }\n  }\n\n  private isProcessRunning(pid: number): boolean {\n    try {\n      process.kill(pid, 0);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private registerLockCleanup(token: string): void {\n    this.unregisterLockCleanup(this.activeLockToken);\n    this.activeLockToken = token;\n\n    const cleanup = (): void => {\n      this.releaseLockSync(token);\n    };\n\n    for (const event of [\n      'exit',\n      'SIGINT',\n      'SIGTERM',\n      'uncaughtException',\n      'unhandledRejection',\n    ] satisfies LockCleanupEvent[]) {\n      process.once(event, cleanup);\n      this.lockCleanupHandlers.set(event, cleanup);\n    }\n  }\n\n  private unregisterLockCleanup(token: string | undefined): void {\n    if (!token || this.activeLockToken !== token) {\n      return;\n    }\n\n    for (const [event, handler] of this.lockCleanupHandlers) {\n      process.off(event, handler);\n    }\n\n    this.lockCleanupHandlers.clear();\n    this.activeLockToken = undefined;\n  }\n\n  private releaseLockSync(token: string): void {\n    try {\n      const existing = fsSync.readFileSync(this.lockPath, 'utf-8');\n      const parsed = JSON.parse(existing) as { token?: string };\n      if (parsed.token === token) {\n        fsSync.unlinkSync(this.lockPath);\n      }\n    } catch {\n      // ignore best-effort cleanup\n    }\n  }\n\n  private async terminateProcess(pid: number): Promise<void> {\n    try {\n      process.kill(pid, 0);\n    } catch {\n      return;\n    }\n\n    try {\n      process.kill(pid, 'SIGTERM');\n    } catch (error) {\n      const sysError = error as NodeJS.ErrnoException;\n      if (sysError.code === 'ESRCH') {\n        return;\n      }\n\n      throw new Error(\n        `Failed to send SIGTERM to process ${pid}: ${error instanceof Error ? error.message : String(error)}`,\n        {\n          cause: error,\n        },\n      );\n    }\n\n    await this.delay(500);\n\n    if (!this.isProcessRunning(pid)) {\n      return;\n    }\n\n    try {\n      process.kill(pid, 'SIGKILL');\n    } catch (error) {\n      const sysError = error as NodeJS.ErrnoException;\n      if (sysError.code === 'ESRCH') {\n        return;\n      }\n\n      throw new Error(\n        `Failed to send SIGKILL to process ${pid}: ${error instanceof Error ? error.message : String(error)}`,\n        {\n          cause: error,\n        },\n      );\n    }\n\n    await this.delay(250);\n\n    if (this.isProcessRunning(pid)) {\n      throw new Error(`Process ${pid} did not exit after SIGKILL`);\n    }\n  }\n\n  private async releaseAssociatedPort(entry: ProcessRegistryRecord): Promise<void> {\n    if (!this.portRegistry || !entry.port) {\n      return;\n    }\n\n    try {\n      const result = await this.portRegistry.releasePort({\n        repositoryPath: entry.repositoryPath,\n        serviceName: entry.serviceName,\n        serviceType: entry.serviceType,\n        environment: entry.environment,\n        pid: entry.pid,\n        force: true,\n      });\n\n      if (!result.success && result.error && !result.error.includes('No matching registry entry')) {\n        throw new Error(result.error);\n      }\n    } catch {\n      // Best-effort cleanup: port release failures should not block process cleanup.\n    }\n  }\n\n  private entryKey(entry: ProcessRegistryRecord): string {\n    return [\n      entry.repositoryPath,\n      entry.serviceName,\n      entry.serviceType,\n      entry.environment ?? '',\n      String(entry.pid),\n    ].join('|');\n  }\n\n  private findEntry(state: ProcessRegistryState, filters: NormalizedFilters): ProcessRegistryRecord | undefined {\n    return state.entries.find(\n      (entry) =>\n        entry.repositoryPath === filters.repositoryPath &&\n        entry.serviceName === filters.serviceName &&\n        entry.serviceType === filters.serviceType &&\n        (filters.environment ? entry.environment === filters.environment : true),\n    );\n  }\n\n  private removeMatchingEntries(state: ProcessRegistryState, filters: NormalizedFilters): void {\n    state.entries = state.entries.filter(\n      (entry) =>\n        !(\n          entry.repositoryPath === filters.repositoryPath &&\n          entry.serviceName === filters.serviceName &&\n          entry.serviceType === filters.serviceType &&\n          (!filters.environment || entry.environment === filters.environment)\n        ),\n    );\n  }\n\n  private createSuccessResponse(pid?: number, record?: ProcessRegistryRecord): ProcessRegistryResponse {\n    return ProcessRegistryResponseSchema.parse({\n      success: true,\n      ...(typeof pid === 'number' ? { pid } : {}),\n      ...(record ? { record } : {}),\n    });\n  }\n\n  private createFailureResponse(error: string): ProcessRegistryResponse {\n    return ProcessRegistryResponseSchema.parse({\n      success: false,\n      error,\n    });\n  }\n\n  private matchesTags(entryTags: string[] | undefined, requestedTags: string[]): boolean {\n    if (requestedTags.length === 0) {\n      return true;\n    }\n\n    if (!entryTags || entryTags.length === 0) {\n      return false;\n    }\n\n    return requestedTags.some((tag) => entryTags.includes(tag));\n  }\n\n  private async pathExists(candidate: string): Promise<boolean> {\n    try {\n      await fs.access(candidate);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n\nfunction normalizeTags(tags: string[] | undefined): string[] | undefined {\n  if (tags === undefined) {\n    return undefined;\n  }\n\n  return Array.from(new Set(tags.map((tag) => tag.trim()).filter((tag) => tag.length > 0)));\n}\n"],"mappings":"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"}

package/dist/cli.cjs

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./ProcessRegistryService.cjs`);let t=require(`node:path`);function n(e,t,n){if(e.includes(`=`)){let t=e.indexOf(`=`),r=t>=0?e.slice(t+1):``;if(r.length===0)throw Error(`Missing value for ${n}`);return[r,0]}if(!t||t.startsWith(`--`))throw Error(`Missing value for ${n}`);return[t,1]}function r(e){let t={};for(let r=0;r<e.length;r+=1){let i=e[r];if(i===`--repository-path`){let[a,o]=n(i,e[r+1],`--repository-path`);t.repositoryPath=a,r+=o;continue}if(i.startsWith(`--repository-path=`)){let[e]=n(i,void 0,`--repository-path`);t.repositoryPath=e;continue}if(i===`--service-name`){let[a,o]=n(i,e[r+1],`--service-name`);t.serviceName=a,r+=o;continue}if(i.startsWith(`--service-name=`)){let[e]=n(i,void 0,`--service-name`);t.serviceName=e;continue}throw i===`--help`||i===`-h`?Error(`help`):i.startsWith(`--`)?Error(`Unknown option: ${i}`):Error(`Unknown argument: ${i}`)}return t}function i(){let e=(0,t.basename)(process.argv[1]||`process-registry`);return[`Usage: ${e} release-process [options]`,``,`Options:`,`  --repository-path <path>  Worktree root to clean up (default: process.cwd())`,`  --service-name <name>     Service name to clean up (default: all services in worktree)`,``,`Examples:`,`  ${e} release-process --repository-path /path/to/worktree --service-name mcp-proxy-http`,`  ${e} release-process --service-name mcp-proxy-http`,`  ${e} release-process --repository-path /path/to/worktree`].join(`
-`)}function a(e){let t=new Map;for(let n of e){let e=[n.repositoryPath,n.serviceName,n.serviceType,n.environment??``,String(n.pid??``)].join(`|`);t.has(e)||t.set(e,n)}return[...t.values()]}async function o(t){let n=e.c(t.repositoryPath??process.cwd()),r=t.serviceName?.trim(),i=new e.t(process.env.PROCESS_REGISTRY_PATH),o=await i.listProcesses({repositoryPath:n,...r?{serviceName:r}:{}});if(o.length===0){let e=r?`service ${r} `:``;console.error(`No matching process registrations found for ${e}in worktree ${n}`),process.exit(1)}let s=a(o),c=[];for(let e of s){let t=await i.releaseProcess({repositoryPath:n,serviceName:e.serviceName,serviceType:e.serviceType,environment:e.environment,...e.pid?{pid:e.pid}:{},kill:!0,releasePort:!0});t.success||c.push(`Service ${e.serviceName}: ${t.error??`Unknown error`}`)}if(c.length>0){console.error(`Failed to release ${c.length} entr${c.length===1?`y`:`ies`}:`);for(let e of c)console.error(`- ${e}`);process.exit(1)}console.log(r?`Released ${s.length} process registration(s) for service ${r} in ${n}`:`Released ${s.length} process registration(s) for worktree ${n}`)}async function s(){let[e=``,...t]=process.argv.slice(2);if(e===`-h`||e===`--help`||e===`help`){console.log(i());return}e!==`release-process`&&(console.error(`Unknown command: ${e||`(none)`}`),console.error(i()),process.exit(1));try{await o(r(t))}catch(e){if(e instanceof Error&&e.message===`help`){console.log(i());return}console.error(e instanceof Error?e.message:`Failed to execute command`),process.exit(1)}}process.argv[1]&&/[\\/](cli\.(ts|mjs|cjs))$/.test(process.argv[1])&&s(),exports.parseReleaseProcessArgs=r,exports.runReleaseProcess=o;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./ProcessRegistryService.cjs`);let t=require(`node:path`);function n(e,t,n){if(e.includes(`=`)){let t=e.indexOf(`=`),r=t>=0?e.slice(t+1):``;if(r.length===0)throw Error(`Missing value for ${n}`);return[r,0]}if(!t||t.startsWith(`--`))throw Error(`Missing value for ${n}`);return[t,1]}function r(e){let t={};for(let r=0;r<e.length;r+=1){let i=e[r];if(i===`--repository-path`){let[a,o]=n(i,e[r+1],`--repository-path`);t.repositoryPath=a,r+=o;continue}if(i.startsWith(`--repository-path=`)){let[e]=n(i,void 0,`--repository-path`);t.repositoryPath=e;continue}if(i===`--service-name`){let[a,o]=n(i,e[r+1],`--service-name`);t.serviceName=a,r+=o;continue}if(i.startsWith(`--service-name=`)){let[e]=n(i,void 0,`--service-name`);t.serviceName=e;continue}if(i===`--tag`){let[a,o]=n(i,e[r+1],`--tag`);t.tags=[...t.tags??[],a],r+=o;continue}if(i.startsWith(`--tag=`)){let[e]=n(i,void 0,`--tag`);t.tags=[...t.tags??[],e];continue}throw i===`--help`||i===`-h`?Error(`help`):i.startsWith(`--`)?Error(`Unknown option: ${i}`):Error(`Unknown argument: ${i}`)}return t}function i(){let e=(0,t.basename)(process.argv[1]||`process-registry`);return[`Usage: ${e} release-process [options]`,``,`Options:`,`  --repository-path <path>  Worktree root to clean up (default: process.cwd())`,`  --service-name <name>     Service name to clean up (default: all services in worktree)`,`  --tag <tag>               Only clean up registrations carrying the given tag (repeatable)`,``,`Examples:`,`  ${e} release-process --repository-path /path/to/worktree --service-name mcp-proxy-http`,`  ${e} release-process --repository-path /path/to/worktree --tag api`,`  ${e} release-process --service-name mcp-proxy-http`,`  ${e} release-process --repository-path /path/to/worktree`].join(`
+`)}function a(e){let t=new Map;for(let n of e){let e=[n.repositoryPath,n.serviceName,n.serviceType,n.environment??``,String(n.pid??``)].join(`|`);t.has(e)||t.set(e,n)}return[...t.values()]}async function o(t){let n=e.y(t.repositoryPath??process.cwd()),r=t.serviceName?.trim(),i=Array.from(new Set((t.tags??[]).map(e=>e.trim()).filter(e=>e.length>0))),o=new e.t(process.env.PROCESS_REGISTRY_PATH),s={repositoryPath:n,...r?{serviceName:r}:{},...i.length>0?{tags:i}:{}},c=await o.listProcesses(s);if(c.length===0){let e=[r?`service ${r}`:``,i.length>0?`tag ${i.join(`, `)}`:``].filter(Boolean).join(` and `);console.error(`No matching process registrations found for ${e?`${e} `:``}in worktree ${n}`),process.exit(1)}let l=a(c),u=[];for(let e of l){let t=await o.releaseProcess({repositoryPath:n,serviceName:e.serviceName,serviceType:e.serviceType,environment:e.environment,...e.pid?{pid:e.pid}:{},kill:!0,releasePort:!0});t.success||u.push(`Service ${e.serviceName}: ${t.error??`Unknown error`}`)}if(u.length>0){console.error(`Failed to release ${u.length} entr${u.length===1?`y`:`ies`}:`);for(let e of u)console.error(`- ${e}`);process.exit(1)}let d=[r?`service ${r}`:``,i.length>0?`tag ${i.join(`, `)}`:``].filter(Boolean).join(` and `);if(d){console.log(`Released ${l.length} process registration(s) for ${d} in ${n}`);return}console.log(`Released ${l.length} process registration(s) for worktree ${n}`)}async function s(){let[e=``,...t]=process.argv.slice(2);if(e===`-h`||e===`--help`||e===`help`){console.log(i());return}e!==`release-process`&&(console.error(`Unknown command: ${e||`(none)`}`),console.error(i()),process.exit(1));try{await o(r(t))}catch(e){if(e instanceof Error&&e.message===`help`){console.log(i());return}console.error(e instanceof Error?e.message:`Failed to execute command`),process.exit(1)}}process.argv[1]&&/[\\/](cli\.(ts|mjs|cjs))$/.test(process.argv[1])&&s(),exports.parseReleaseProcessArgs=r,exports.runReleaseProcess=o;
 //# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.cjs","names":["normalizeRepositoryPath","ProcessRegistryService"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { basename } from 'node:path';\nimport { ProcessRegistryService } from './services';\nimport { normalizeRepositoryPath } from './utils';\nimport { type ProcessRegistryRecord } from './types';\n\ntype ReleaseProcessCommandOptions = {\n  repositoryPath?: string;\n  serviceName?: string;\n};\n\nfunction parseValueFromArg(arg: string, nextValue: string | undefined, optionName: string): [string, number] {\n  if (arg.includes('=')) {\n    const equalsIndex = arg.indexOf('=');\n    const value = equalsIndex >= 0 ? arg.slice(equalsIndex + 1) : '';\n    if (value.length === 0) {\n      throw new Error(`Missing value for ${optionName}`);\n    }\n\n    return [value, 0];\n  }\n\n  if (!nextValue || nextValue.startsWith('--')) {\n    throw new Error(`Missing value for ${optionName}`);\n  }\n\n  return [nextValue, 1];\n}\n\nfunction parseReleaseProcessArgs(argv: string[]): ReleaseProcessCommandOptions {\n  const parsed: ReleaseProcessCommandOptions = {};\n\n  for (let index = 0; index < argv.length; index += 1) {\n    const arg = argv[index];\n    if (arg === '--repository-path') {\n      const [value, consumed] = parseValueFromArg(arg, argv[index + 1], '--repository-path');\n      parsed.repositoryPath = value;\n      index += consumed;\n      continue;\n    }\n\n    if (arg.startsWith('--repository-path=')) {\n      const [value] = parseValueFromArg(arg, undefined, '--repository-path');\n      parsed.repositoryPath = value;\n      continue;\n    }\n\n    if (arg === '--service-name') {\n      const [value, consumed] = parseValueFromArg(arg, argv[index + 1], '--service-name');\n      parsed.serviceName = value;\n      index += consumed;\n      continue;\n    }\n\n    if (arg.startsWith('--service-name=')) {\n      const [value] = parseValueFromArg(arg, undefined, '--service-name');\n      parsed.serviceName = value;\n      continue;\n    }\n\n    if (arg === '--help' || arg === '-h') {\n      throw new Error('help');\n    }\n\n    if (arg.startsWith('--')) {\n      throw new Error(`Unknown option: ${arg}`);\n    }\n\n    throw new Error(`Unknown argument: ${arg}`);\n  }\n\n  return parsed;\n}\n\nfunction formatUsage() {\n  const command = basename(process.argv[1] || 'process-registry');\n\n  return [\n    `Usage: ${command} release-process [options]`,\n    '',\n    'Options:',\n    '  --repository-path <path>  Worktree root to clean up (default: process.cwd())',\n    '  --service-name <name>     Service name to clean up (default: all services in worktree)',\n    '',\n    'Examples:',\n    `  ${command} release-process --repository-path /path/to/worktree --service-name mcp-proxy-http`,\n    `  ${command} release-process --service-name mcp-proxy-http`,\n    `  ${command} release-process --repository-path /path/to/worktree`,\n  ].join('\\n');\n}\n\nfunction dedupeRecords(records: ProcessRegistryRecord[]): ProcessRegistryRecord[] {\n  const byKey = new Map<string, ProcessRegistryRecord>();\n\n  for (const record of records) {\n    const key = [\n      record.repositoryPath,\n      record.serviceName,\n      record.serviceType,\n      record.environment ?? '',\n      String(record.pid ?? ''),\n    ].join('|');\n    if (!byKey.has(key)) {\n      byKey.set(key, record);\n    }\n  }\n\n  return [...byKey.values()];\n}\n\nasync function runReleaseProcess(options: ReleaseProcessCommandOptions): Promise<void> {\n  const repositoryPath = normalizeRepositoryPath(options.repositoryPath ?? process.cwd());\n  const serviceName = options.serviceName?.trim();\n  const service = new ProcessRegistryService(process.env.PROCESS_REGISTRY_PATH);\n\n  const matches = await service.listProcesses({\n    repositoryPath,\n    ...(serviceName ? { serviceName } : {}),\n  });\n\n  if (matches.length === 0) {\n    const target = serviceName ? `service ${serviceName} ` : '';\n    console.error(`No matching process registrations found for ${target}in worktree ${repositoryPath}`);\n    process.exit(1);\n  }\n\n  const releases = dedupeRecords(matches);\n  const releaseErrors: string[] = [];\n\n  for (const entry of releases) {\n    const response = await service.releaseProcess({\n      repositoryPath,\n      serviceName: entry.serviceName,\n      serviceType: entry.serviceType,\n      environment: entry.environment,\n      ...(entry.pid ? { pid: entry.pid } : {}),\n      kill: true,\n      releasePort: true,\n    });\n\n    if (!response.success) {\n      releaseErrors.push(`Service ${entry.serviceName}: ${response.error ?? 'Unknown error'}`);\n    }\n  }\n\n  if (releaseErrors.length > 0) {\n    console.error(`Failed to release ${releaseErrors.length} entr${releaseErrors.length === 1 ? 'y' : 'ies'}:`);\n    for (const failure of releaseErrors) {\n      console.error(`- ${failure}`);\n    }\n    process.exit(1);\n  }\n\n  if (serviceName) {\n    console.log(`Released ${releases.length} process registration(s) for service ${serviceName} in ${repositoryPath}`);\n  } else {\n    console.log(`Released ${releases.length} process registration(s) for worktree ${repositoryPath}`);\n  }\n}\n\nasync function main() {\n  const [command = '', ...rawArgs] = process.argv.slice(2);\n\n  if (command === '-h' || command === '--help' || command === 'help') {\n    console.log(formatUsage());\n    return;\n  }\n\n  if (command !== 'release-process') {\n    console.error(`Unknown command: ${command || '(none)'}`);\n    console.error(formatUsage());\n    process.exit(1);\n  }\n\n  try {\n    const options = parseReleaseProcessArgs(rawArgs);\n    await runReleaseProcess(options);\n  } catch (error) {\n    if (error instanceof Error && error.message === 'help') {\n      console.log(formatUsage());\n      return;\n    }\n\n    console.error(error instanceof Error ? error.message : 'Failed to execute command');\n    process.exit(1);\n  }\n}\n\nif (process.argv[1] && /[\\\\/](cli\\.(ts|mjs|cjs))$/.test(process.argv[1])) {\n  void main();\n}\n\nexport { parseReleaseProcessArgs, runReleaseProcess };\n"],"mappings":"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"}
+{"version":3,"file":"cli.cjs","names":["normalizeRepositoryPath","ProcessRegistryService"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { basename } from 'node:path';\nimport { ProcessRegistryService } from './services';\nimport { normalizeRepositoryPath } from './utils';\nimport { type ProcessRegistryRecord } from './types';\n\ntype ReleaseProcessCommandOptions = {\n  repositoryPath?: string;\n  serviceName?: string;\n  tags?: string[];\n};\n\nfunction parseValueFromArg(arg: string, nextValue: string | undefined, optionName: string): [string, number] {\n  if (arg.includes('=')) {\n    const equalsIndex = arg.indexOf('=');\n    const value = equalsIndex >= 0 ? arg.slice(equalsIndex + 1) : '';\n    if (value.length === 0) {\n      throw new Error(`Missing value for ${optionName}`);\n    }\n\n    return [value, 0];\n  }\n\n  if (!nextValue || nextValue.startsWith('--')) {\n    throw new Error(`Missing value for ${optionName}`);\n  }\n\n  return [nextValue, 1];\n}\n\nfunction parseReleaseProcessArgs(argv: string[]): ReleaseProcessCommandOptions {\n  const parsed: ReleaseProcessCommandOptions = {};\n\n  for (let index = 0; index < argv.length; index += 1) {\n    const arg = argv[index];\n    if (arg === '--repository-path') {\n      const [value, consumed] = parseValueFromArg(arg, argv[index + 1], '--repository-path');\n      parsed.repositoryPath = value;\n      index += consumed;\n      continue;\n    }\n\n    if (arg.startsWith('--repository-path=')) {\n      const [value] = parseValueFromArg(arg, undefined, '--repository-path');\n      parsed.repositoryPath = value;\n      continue;\n    }\n\n    if (arg === '--service-name') {\n      const [value, consumed] = parseValueFromArg(arg, argv[index + 1], '--service-name');\n      parsed.serviceName = value;\n      index += consumed;\n      continue;\n    }\n\n    if (arg.startsWith('--service-name=')) {\n      const [value] = parseValueFromArg(arg, undefined, '--service-name');\n      parsed.serviceName = value;\n      continue;\n    }\n\n    if (arg === '--tag') {\n      const [value, consumed] = parseValueFromArg(arg, argv[index + 1], '--tag');\n      parsed.tags = [...(parsed.tags ?? []), value];\n      index += consumed;\n      continue;\n    }\n\n    if (arg.startsWith('--tag=')) {\n      const [value] = parseValueFromArg(arg, undefined, '--tag');\n      parsed.tags = [...(parsed.tags ?? []), value];\n      continue;\n    }\n\n    if (arg === '--help' || arg === '-h') {\n      throw new Error('help');\n    }\n\n    if (arg.startsWith('--')) {\n      throw new Error(`Unknown option: ${arg}`);\n    }\n\n    throw new Error(`Unknown argument: ${arg}`);\n  }\n\n  return parsed;\n}\n\nfunction formatUsage() {\n  const command = basename(process.argv[1] || 'process-registry');\n\n  return [\n    `Usage: ${command} release-process [options]`,\n    '',\n    'Options:',\n    '  --repository-path <path>  Worktree root to clean up (default: process.cwd())',\n    '  --service-name <name>     Service name to clean up (default: all services in worktree)',\n    '  --tag <tag>               Only clean up registrations carrying the given tag (repeatable)',\n    '',\n    'Examples:',\n    `  ${command} release-process --repository-path /path/to/worktree --service-name mcp-proxy-http`,\n    `  ${command} release-process --repository-path /path/to/worktree --tag api`,\n    `  ${command} release-process --service-name mcp-proxy-http`,\n    `  ${command} release-process --repository-path /path/to/worktree`,\n  ].join('\\n');\n}\n\nfunction dedupeRecords(records: ProcessRegistryRecord[]): ProcessRegistryRecord[] {\n  const byKey = new Map<string, ProcessRegistryRecord>();\n\n  for (const record of records) {\n    const key = [\n      record.repositoryPath,\n      record.serviceName,\n      record.serviceType,\n      record.environment ?? '',\n      String(record.pid ?? ''),\n    ].join('|');\n    if (!byKey.has(key)) {\n      byKey.set(key, record);\n    }\n  }\n\n  return [...byKey.values()];\n}\n\nasync function runReleaseProcess(options: ReleaseProcessCommandOptions): Promise<void> {\n  const repositoryPath = normalizeRepositoryPath(options.repositoryPath ?? process.cwd());\n  const serviceName = options.serviceName?.trim();\n  const tags = Array.from(new Set((options.tags ?? []).map((tag) => tag.trim()).filter((tag) => tag.length > 0)));\n  const service = new ProcessRegistryService(process.env.PROCESS_REGISTRY_PATH);\n  const releaseFilters = {\n    repositoryPath,\n    ...(serviceName ? { serviceName } : {}),\n    ...(tags.length > 0 ? { tags } : {}),\n  };\n\n  const matches = await service.listProcesses(releaseFilters);\n\n  if (matches.length === 0) {\n    const target = [serviceName ? `service ${serviceName}` : '', tags.length > 0 ? `tag ${tags.join(', ')}` : '']\n      .filter(Boolean)\n      .join(' and ');\n    console.error(\n      `No matching process registrations found for ${target ? `${target} ` : ''}in worktree ${repositoryPath}`,\n    );\n    process.exit(1);\n  }\n\n  const releases = dedupeRecords(matches);\n  const releaseErrors: string[] = [];\n\n  for (const entry of releases) {\n    const response = await service.releaseProcess({\n      repositoryPath,\n      serviceName: entry.serviceName,\n      serviceType: entry.serviceType,\n      environment: entry.environment,\n      ...(entry.pid ? { pid: entry.pid } : {}),\n      kill: true,\n      releasePort: true,\n    });\n\n    if (!response.success) {\n      releaseErrors.push(`Service ${entry.serviceName}: ${response.error ?? 'Unknown error'}`);\n    }\n  }\n\n  if (releaseErrors.length > 0) {\n    console.error(`Failed to release ${releaseErrors.length} entr${releaseErrors.length === 1 ? 'y' : 'ies'}:`);\n    for (const failure of releaseErrors) {\n      console.error(`- ${failure}`);\n    }\n    process.exit(1);\n  }\n\n  const target = [serviceName ? `service ${serviceName}` : '', tags.length > 0 ? `tag ${tags.join(', ')}` : '']\n    .filter(Boolean)\n    .join(' and ');\n\n  if (target) {\n    console.log(`Released ${releases.length} process registration(s) for ${target} in ${repositoryPath}`);\n    return;\n  }\n\n  console.log(`Released ${releases.length} process registration(s) for worktree ${repositoryPath}`);\n}\n\nasync function main() {\n  const [command = '', ...rawArgs] = process.argv.slice(2);\n\n  if (command === '-h' || command === '--help' || command === 'help') {\n    console.log(formatUsage());\n    return;\n  }\n\n  if (command !== 'release-process') {\n    console.error(`Unknown command: ${command || '(none)'}`);\n    console.error(formatUsage());\n    process.exit(1);\n  }\n\n  try {\n    const options = parseReleaseProcessArgs(rawArgs);\n    await runReleaseProcess(options);\n  } catch (error) {\n    if (error instanceof Error && error.message === 'help') {\n      console.log(formatUsage());\n      return;\n    }\n\n    console.error(error instanceof Error ? error.message : 'Failed to execute command');\n    process.exit(1);\n  }\n}\n\nif (process.argv[1] && /[\\\\/](cli\\.(ts|mjs|cjs))$/.test(process.argv[1])) {\n  void main();\n}\n\nexport { parseReleaseProcessArgs, runReleaseProcess };\n"],"mappings":"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"}

package/dist/cli.d.cts

@@ -2,6 +2,7 @@
 type ReleaseProcessCommandOptions = {
   repositoryPath?: string;
   serviceName?: string;
+  tags?: string[];
 };
 declare function parseReleaseProcessArgs(argv: string[]): ReleaseProcessCommandOptions;
 declare function runReleaseProcess(options: ReleaseProcessCommandOptions): Promise<void>;

package/dist/cli.d.mts

@@ -2,6 +2,7 @@
 type ReleaseProcessCommandOptions = {
   repositoryPath?: string;
   serviceName?: string;
+  tags?: string[];
 };
 declare function parseReleaseProcessArgs(argv: string[]): ReleaseProcessCommandOptions;
 declare function runReleaseProcess(options: ReleaseProcessCommandOptions): Promise<void>;

package/dist/cli.mjs

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import{c as e,t}from"./ProcessRegistryService.mjs";import{basename as n}from"node:path";function r(e,t,n){if(e.includes(`=`)){let t=e.indexOf(`=`),r=t>=0?e.slice(t+1):``;if(r.length===0)throw Error(`Missing value for ${n}`);return[r,0]}if(!t||t.startsWith(`--`))throw Error(`Missing value for ${n}`);return[t,1]}function i(e){let t={};for(let n=0;n<e.length;n+=1){let i=e[n];if(i===`--repository-path`){let[a,o]=r(i,e[n+1],`--repository-path`);t.repositoryPath=a,n+=o;continue}if(i.startsWith(`--repository-path=`)){let[e]=r(i,void 0,`--repository-path`);t.repositoryPath=e;continue}if(i===`--service-name`){let[a,o]=r(i,e[n+1],`--service-name`);t.serviceName=a,n+=o;continue}if(i.startsWith(`--service-name=`)){let[e]=r(i,void 0,`--service-name`);t.serviceName=e;continue}throw i===`--help`||i===`-h`?Error(`help`):i.startsWith(`--`)?Error(`Unknown option: ${i}`):Error(`Unknown argument: ${i}`)}return t}function a(){let e=n(process.argv[1]||`process-registry`);return[`Usage: ${e} release-process [options]`,``,`Options:`,`  --repository-path <path>  Worktree root to clean up (default: process.cwd())`,`  --service-name <name>     Service name to clean up (default: all services in worktree)`,``,`Examples:`,`  ${e} release-process --repository-path /path/to/worktree --service-name mcp-proxy-http`,`  ${e} release-process --service-name mcp-proxy-http`,`  ${e} release-process --repository-path /path/to/worktree`].join(`
-`)}function o(e){let t=new Map;for(let n of e){let e=[n.repositoryPath,n.serviceName,n.serviceType,n.environment??``,String(n.pid??``)].join(`|`);t.has(e)||t.set(e,n)}return[...t.values()]}async function s(n){let r=e(n.repositoryPath??process.cwd()),i=n.serviceName?.trim(),a=new t(process.env.PROCESS_REGISTRY_PATH),s=await a.listProcesses({repositoryPath:r,...i?{serviceName:i}:{}});if(s.length===0){let e=i?`service ${i} `:``;console.error(`No matching process registrations found for ${e}in worktree ${r}`),process.exit(1)}let c=o(s),l=[];for(let e of c){let t=await a.releaseProcess({repositoryPath:r,serviceName:e.serviceName,serviceType:e.serviceType,environment:e.environment,...e.pid?{pid:e.pid}:{},kill:!0,releasePort:!0});t.success||l.push(`Service ${e.serviceName}: ${t.error??`Unknown error`}`)}if(l.length>0){console.error(`Failed to release ${l.length} entr${l.length===1?`y`:`ies`}:`);for(let e of l)console.error(`- ${e}`);process.exit(1)}console.log(i?`Released ${c.length} process registration(s) for service ${i} in ${r}`:`Released ${c.length} process registration(s) for worktree ${r}`)}async function c(){let[e=``,...t]=process.argv.slice(2);if(e===`-h`||e===`--help`||e===`help`){console.log(a());return}e!==`release-process`&&(console.error(`Unknown command: ${e||`(none)`}`),console.error(a()),process.exit(1));try{await s(i(t))}catch(e){if(e instanceof Error&&e.message===`help`){console.log(a());return}console.error(e instanceof Error?e.message:`Failed to execute command`),process.exit(1)}}process.argv[1]&&/[\\/](cli\.(ts|mjs|cjs))$/.test(process.argv[1])&&c();export{i as parseReleaseProcessArgs,s as runReleaseProcess};
+import{t as e,y as t}from"./ProcessRegistryService.mjs";import{basename as n}from"node:path";function r(e,t,n){if(e.includes(`=`)){let t=e.indexOf(`=`),r=t>=0?e.slice(t+1):``;if(r.length===0)throw Error(`Missing value for ${n}`);return[r,0]}if(!t||t.startsWith(`--`))throw Error(`Missing value for ${n}`);return[t,1]}function i(e){let t={};for(let n=0;n<e.length;n+=1){let i=e[n];if(i===`--repository-path`){let[a,o]=r(i,e[n+1],`--repository-path`);t.repositoryPath=a,n+=o;continue}if(i.startsWith(`--repository-path=`)){let[e]=r(i,void 0,`--repository-path`);t.repositoryPath=e;continue}if(i===`--service-name`){let[a,o]=r(i,e[n+1],`--service-name`);t.serviceName=a,n+=o;continue}if(i.startsWith(`--service-name=`)){let[e]=r(i,void 0,`--service-name`);t.serviceName=e;continue}if(i===`--tag`){let[a,o]=r(i,e[n+1],`--tag`);t.tags=[...t.tags??[],a],n+=o;continue}if(i.startsWith(`--tag=`)){let[e]=r(i,void 0,`--tag`);t.tags=[...t.tags??[],e];continue}throw i===`--help`||i===`-h`?Error(`help`):i.startsWith(`--`)?Error(`Unknown option: ${i}`):Error(`Unknown argument: ${i}`)}return t}function a(){let e=n(process.argv[1]||`process-registry`);return[`Usage: ${e} release-process [options]`,``,`Options:`,`  --repository-path <path>  Worktree root to clean up (default: process.cwd())`,`  --service-name <name>     Service name to clean up (default: all services in worktree)`,`  --tag <tag>               Only clean up registrations carrying the given tag (repeatable)`,``,`Examples:`,`  ${e} release-process --repository-path /path/to/worktree --service-name mcp-proxy-http`,`  ${e} release-process --repository-path /path/to/worktree --tag api`,`  ${e} release-process --service-name mcp-proxy-http`,`  ${e} release-process --repository-path /path/to/worktree`].join(`
+`)}function o(e){let t=new Map;for(let n of e){let e=[n.repositoryPath,n.serviceName,n.serviceType,n.environment??``,String(n.pid??``)].join(`|`);t.has(e)||t.set(e,n)}return[...t.values()]}async function s(n){let r=t(n.repositoryPath??process.cwd()),i=n.serviceName?.trim(),a=Array.from(new Set((n.tags??[]).map(e=>e.trim()).filter(e=>e.length>0))),s=new e(process.env.PROCESS_REGISTRY_PATH),c={repositoryPath:r,...i?{serviceName:i}:{},...a.length>0?{tags:a}:{}},l=await s.listProcesses(c);if(l.length===0){let e=[i?`service ${i}`:``,a.length>0?`tag ${a.join(`, `)}`:``].filter(Boolean).join(` and `);console.error(`No matching process registrations found for ${e?`${e} `:``}in worktree ${r}`),process.exit(1)}let u=o(l),d=[];for(let e of u){let t=await s.releaseProcess({repositoryPath:r,serviceName:e.serviceName,serviceType:e.serviceType,environment:e.environment,...e.pid?{pid:e.pid}:{},kill:!0,releasePort:!0});t.success||d.push(`Service ${e.serviceName}: ${t.error??`Unknown error`}`)}if(d.length>0){console.error(`Failed to release ${d.length} entr${d.length===1?`y`:`ies`}:`);for(let e of d)console.error(`- ${e}`);process.exit(1)}let f=[i?`service ${i}`:``,a.length>0?`tag ${a.join(`, `)}`:``].filter(Boolean).join(` and `);if(f){console.log(`Released ${u.length} process registration(s) for ${f} in ${r}`);return}console.log(`Released ${u.length} process registration(s) for worktree ${r}`)}async function c(){let[e=``,...t]=process.argv.slice(2);if(e===`-h`||e===`--help`||e===`help`){console.log(a());return}e!==`release-process`&&(console.error(`Unknown command: ${e||`(none)`}`),console.error(a()),process.exit(1));try{await s(i(t))}catch(e){if(e instanceof Error&&e.message===`help`){console.log(a());return}console.error(e instanceof Error?e.message:`Failed to execute command`),process.exit(1)}}process.argv[1]&&/[\\/](cli\.(ts|mjs|cjs))$/.test(process.argv[1])&&c();export{i as parseReleaseProcessArgs,s as runReleaseProcess};
 //# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { basename } from 'node:path';\nimport { ProcessRegistryService } from './services';\nimport { normalizeRepositoryPath } from './utils';\nimport { type ProcessRegistryRecord } from './types';\n\ntype ReleaseProcessCommandOptions = {\n  repositoryPath?: string;\n  serviceName?: string;\n};\n\nfunction parseValueFromArg(arg: string, nextValue: string | undefined, optionName: string): [string, number] {\n  if (arg.includes('=')) {\n    const equalsIndex = arg.indexOf('=');\n    const value = equalsIndex >= 0 ? arg.slice(equalsIndex + 1) : '';\n    if (value.length === 0) {\n      throw new Error(`Missing value for ${optionName}`);\n    }\n\n    return [value, 0];\n  }\n\n  if (!nextValue || nextValue.startsWith('--')) {\n    throw new Error(`Missing value for ${optionName}`);\n  }\n\n  return [nextValue, 1];\n}\n\nfunction parseReleaseProcessArgs(argv: string[]): ReleaseProcessCommandOptions {\n  const parsed: ReleaseProcessCommandOptions = {};\n\n  for (let index = 0; index < argv.length; index += 1) {\n    const arg = argv[index];\n    if (arg === '--repository-path') {\n      const [value, consumed] = parseValueFromArg(arg, argv[index + 1], '--repository-path');\n      parsed.repositoryPath = value;\n      index += consumed;\n      continue;\n    }\n\n    if (arg.startsWith('--repository-path=')) {\n      const [value] = parseValueFromArg(arg, undefined, '--repository-path');\n      parsed.repositoryPath = value;\n      continue;\n    }\n\n    if (arg === '--service-name') {\n      const [value, consumed] = parseValueFromArg(arg, argv[index + 1], '--service-name');\n      parsed.serviceName = value;\n      index += consumed;\n      continue;\n    }\n\n    if (arg.startsWith('--service-name=')) {\n      const [value] = parseValueFromArg(arg, undefined, '--service-name');\n      parsed.serviceName = value;\n      continue;\n    }\n\n    if (arg === '--help' || arg === '-h') {\n      throw new Error('help');\n    }\n\n    if (arg.startsWith('--')) {\n      throw new Error(`Unknown option: ${arg}`);\n    }\n\n    throw new Error(`Unknown argument: ${arg}`);\n  }\n\n  return parsed;\n}\n\nfunction formatUsage() {\n  const command = basename(process.argv[1] || 'process-registry');\n\n  return [\n    `Usage: ${command} release-process [options]`,\n    '',\n    'Options:',\n    '  --repository-path <path>  Worktree root to clean up (default: process.cwd())',\n    '  --service-name <name>     Service name to clean up (default: all services in worktree)',\n    '',\n    'Examples:',\n    `  ${command} release-process --repository-path /path/to/worktree --service-name mcp-proxy-http`,\n    `  ${command} release-process --service-name mcp-proxy-http`,\n    `  ${command} release-process --repository-path /path/to/worktree`,\n  ].join('\\n');\n}\n\nfunction dedupeRecords(records: ProcessRegistryRecord[]): ProcessRegistryRecord[] {\n  const byKey = new Map<string, ProcessRegistryRecord>();\n\n  for (const record of records) {\n    const key = [\n      record.repositoryPath,\n      record.serviceName,\n      record.serviceType,\n      record.environment ?? '',\n      String(record.pid ?? ''),\n    ].join('|');\n    if (!byKey.has(key)) {\n      byKey.set(key, record);\n    }\n  }\n\n  return [...byKey.values()];\n}\n\nasync function runReleaseProcess(options: ReleaseProcessCommandOptions): Promise<void> {\n  const repositoryPath = normalizeRepositoryPath(options.repositoryPath ?? process.cwd());\n  const serviceName = options.serviceName?.trim();\n  const service = new ProcessRegistryService(process.env.PROCESS_REGISTRY_PATH);\n\n  const matches = await service.listProcesses({\n    repositoryPath,\n    ...(serviceName ? { serviceName } : {}),\n  });\n\n  if (matches.length === 0) {\n    const target = serviceName ? `service ${serviceName} ` : '';\n    console.error(`No matching process registrations found for ${target}in worktree ${repositoryPath}`);\n    process.exit(1);\n  }\n\n  const releases = dedupeRecords(matches);\n  const releaseErrors: string[] = [];\n\n  for (const entry of releases) {\n    const response = await service.releaseProcess({\n      repositoryPath,\n      serviceName: entry.serviceName,\n      serviceType: entry.serviceType,\n      environment: entry.environment,\n      ...(entry.pid ? { pid: entry.pid } : {}),\n      kill: true,\n      releasePort: true,\n    });\n\n    if (!response.success) {\n      releaseErrors.push(`Service ${entry.serviceName}: ${response.error ?? 'Unknown error'}`);\n    }\n  }\n\n  if (releaseErrors.length > 0) {\n    console.error(`Failed to release ${releaseErrors.length} entr${releaseErrors.length === 1 ? 'y' : 'ies'}:`);\n    for (const failure of releaseErrors) {\n      console.error(`- ${failure}`);\n    }\n    process.exit(1);\n  }\n\n  if (serviceName) {\n    console.log(`Released ${releases.length} process registration(s) for service ${serviceName} in ${repositoryPath}`);\n  } else {\n    console.log(`Released ${releases.length} process registration(s) for worktree ${repositoryPath}`);\n  }\n}\n\nasync function main() {\n  const [command = '', ...rawArgs] = process.argv.slice(2);\n\n  if (command === '-h' || command === '--help' || command === 'help') {\n    console.log(formatUsage());\n    return;\n  }\n\n  if (command !== 'release-process') {\n    console.error(`Unknown command: ${command || '(none)'}`);\n    console.error(formatUsage());\n    process.exit(1);\n  }\n\n  try {\n    const options = parseReleaseProcessArgs(rawArgs);\n    await runReleaseProcess(options);\n  } catch (error) {\n    if (error instanceof Error && error.message === 'help') {\n      console.log(formatUsage());\n      return;\n    }\n\n    console.error(error instanceof Error ? error.message : 'Failed to execute command');\n    process.exit(1);\n  }\n}\n\nif (process.argv[1] && /[\\\\/](cli\\.(ts|mjs|cjs))$/.test(process.argv[1])) {\n  void main();\n}\n\nexport { parseReleaseProcessArgs, runReleaseProcess };\n"],"mappings":"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"}
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { basename } from 'node:path';\nimport { ProcessRegistryService } from './services';\nimport { normalizeRepositoryPath } from './utils';\nimport { type ProcessRegistryRecord } from './types';\n\ntype ReleaseProcessCommandOptions = {\n  repositoryPath?: string;\n  serviceName?: string;\n  tags?: string[];\n};\n\nfunction parseValueFromArg(arg: string, nextValue: string | undefined, optionName: string): [string, number] {\n  if (arg.includes('=')) {\n    const equalsIndex = arg.indexOf('=');\n    const value = equalsIndex >= 0 ? arg.slice(equalsIndex + 1) : '';\n    if (value.length === 0) {\n      throw new Error(`Missing value for ${optionName}`);\n    }\n\n    return [value, 0];\n  }\n\n  if (!nextValue || nextValue.startsWith('--')) {\n    throw new Error(`Missing value for ${optionName}`);\n  }\n\n  return [nextValue, 1];\n}\n\nfunction parseReleaseProcessArgs(argv: string[]): ReleaseProcessCommandOptions {\n  const parsed: ReleaseProcessCommandOptions = {};\n\n  for (let index = 0; index < argv.length; index += 1) {\n    const arg = argv[index];\n    if (arg === '--repository-path') {\n      const [value, consumed] = parseValueFromArg(arg, argv[index + 1], '--repository-path');\n      parsed.repositoryPath = value;\n      index += consumed;\n      continue;\n    }\n\n    if (arg.startsWith('--repository-path=')) {\n      const [value] = parseValueFromArg(arg, undefined, '--repository-path');\n      parsed.repositoryPath = value;\n      continue;\n    }\n\n    if (arg === '--service-name') {\n      const [value, consumed] = parseValueFromArg(arg, argv[index + 1], '--service-name');\n      parsed.serviceName = value;\n      index += consumed;\n      continue;\n    }\n\n    if (arg.startsWith('--service-name=')) {\n      const [value] = parseValueFromArg(arg, undefined, '--service-name');\n      parsed.serviceName = value;\n      continue;\n    }\n\n    if (arg === '--tag') {\n      const [value, consumed] = parseValueFromArg(arg, argv[index + 1], '--tag');\n      parsed.tags = [...(parsed.tags ?? []), value];\n      index += consumed;\n      continue;\n    }\n\n    if (arg.startsWith('--tag=')) {\n      const [value] = parseValueFromArg(arg, undefined, '--tag');\n      parsed.tags = [...(parsed.tags ?? []), value];\n      continue;\n    }\n\n    if (arg === '--help' || arg === '-h') {\n      throw new Error('help');\n    }\n\n    if (arg.startsWith('--')) {\n      throw new Error(`Unknown option: ${arg}`);\n    }\n\n    throw new Error(`Unknown argument: ${arg}`);\n  }\n\n  return parsed;\n}\n\nfunction formatUsage() {\n  const command = basename(process.argv[1] || 'process-registry');\n\n  return [\n    `Usage: ${command} release-process [options]`,\n    '',\n    'Options:',\n    '  --repository-path <path>  Worktree root to clean up (default: process.cwd())',\n    '  --service-name <name>     Service name to clean up (default: all services in worktree)',\n    '  --tag <tag>               Only clean up registrations carrying the given tag (repeatable)',\n    '',\n    'Examples:',\n    `  ${command} release-process --repository-path /path/to/worktree --service-name mcp-proxy-http`,\n    `  ${command} release-process --repository-path /path/to/worktree --tag api`,\n    `  ${command} release-process --service-name mcp-proxy-http`,\n    `  ${command} release-process --repository-path /path/to/worktree`,\n  ].join('\\n');\n}\n\nfunction dedupeRecords(records: ProcessRegistryRecord[]): ProcessRegistryRecord[] {\n  const byKey = new Map<string, ProcessRegistryRecord>();\n\n  for (const record of records) {\n    const key = [\n      record.repositoryPath,\n      record.serviceName,\n      record.serviceType,\n      record.environment ?? '',\n      String(record.pid ?? ''),\n    ].join('|');\n    if (!byKey.has(key)) {\n      byKey.set(key, record);\n    }\n  }\n\n  return [...byKey.values()];\n}\n\nasync function runReleaseProcess(options: ReleaseProcessCommandOptions): Promise<void> {\n  const repositoryPath = normalizeRepositoryPath(options.repositoryPath ?? process.cwd());\n  const serviceName = options.serviceName?.trim();\n  const tags = Array.from(new Set((options.tags ?? []).map((tag) => tag.trim()).filter((tag) => tag.length > 0)));\n  const service = new ProcessRegistryService(process.env.PROCESS_REGISTRY_PATH);\n  const releaseFilters = {\n    repositoryPath,\n    ...(serviceName ? { serviceName } : {}),\n    ...(tags.length > 0 ? { tags } : {}),\n  };\n\n  const matches = await service.listProcesses(releaseFilters);\n\n  if (matches.length === 0) {\n    const target = [serviceName ? `service ${serviceName}` : '', tags.length > 0 ? `tag ${tags.join(', ')}` : '']\n      .filter(Boolean)\n      .join(' and ');\n    console.error(\n      `No matching process registrations found for ${target ? `${target} ` : ''}in worktree ${repositoryPath}`,\n    );\n    process.exit(1);\n  }\n\n  const releases = dedupeRecords(matches);\n  const releaseErrors: string[] = [];\n\n  for (const entry of releases) {\n    const response = await service.releaseProcess({\n      repositoryPath,\n      serviceName: entry.serviceName,\n      serviceType: entry.serviceType,\n      environment: entry.environment,\n      ...(entry.pid ? { pid: entry.pid } : {}),\n      kill: true,\n      releasePort: true,\n    });\n\n    if (!response.success) {\n      releaseErrors.push(`Service ${entry.serviceName}: ${response.error ?? 'Unknown error'}`);\n    }\n  }\n\n  if (releaseErrors.length > 0) {\n    console.error(`Failed to release ${releaseErrors.length} entr${releaseErrors.length === 1 ? 'y' : 'ies'}:`);\n    for (const failure of releaseErrors) {\n      console.error(`- ${failure}`);\n    }\n    process.exit(1);\n  }\n\n  const target = [serviceName ? `service ${serviceName}` : '', tags.length > 0 ? `tag ${tags.join(', ')}` : '']\n    .filter(Boolean)\n    .join(' and ');\n\n  if (target) {\n    console.log(`Released ${releases.length} process registration(s) for ${target} in ${repositoryPath}`);\n    return;\n  }\n\n  console.log(`Released ${releases.length} process registration(s) for worktree ${repositoryPath}`);\n}\n\nasync function main() {\n  const [command = '', ...rawArgs] = process.argv.slice(2);\n\n  if (command === '-h' || command === '--help' || command === 'help') {\n    console.log(formatUsage());\n    return;\n  }\n\n  if (command !== 'release-process') {\n    console.error(`Unknown command: ${command || '(none)'}`);\n    console.error(formatUsage());\n    process.exit(1);\n  }\n\n  try {\n    const options = parseReleaseProcessArgs(rawArgs);\n    await runReleaseProcess(options);\n  } catch (error) {\n    if (error instanceof Error && error.message === 'help') {\n      console.log(formatUsage());\n      return;\n    }\n\n    console.error(error instanceof Error ? error.message : 'Failed to execute command');\n    process.exit(1);\n  }\n}\n\nif (process.argv[1] && /[\\\\/](cli\\.(ts|mjs|cjs))$/.test(process.argv[1])) {\n  void main();\n}\n\nexport { parseReleaseProcessArgs, runReleaseProcess };\n"],"mappings":"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"}

package/dist/index.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./ProcessRegistryService.cjs`);function t(t){return new e.t(t??process.env.PROCESS_REGISTRY_PATH)}async function n(e,n){let r=n??t(),i=e.pid??process.pid,a=e.serviceType??`tool`,o=e.environment??process.env.NODE_ENV??`development`,s={repositoryPath:e.repositoryPath,serviceName:e.serviceName,serviceType:a,environment:o,pid:i,port:e.port,host:e.host,command:e.command,args:e.args,metadata:e.metadata,force:e.force??!0},c=await r.registerProcess(s);if(!c.success||!c.record)throw Error(c.error||`Failed to register process for ${e.serviceName}`);let l=!1;return{release:async t=>{if(l)return;l=!0;let n=await r.releaseProcess({repositoryPath:e.repositoryPath,serviceName:e.serviceName,serviceType:a,pid:i,environment:o,kill:t?.kill??!0,releasePort:t?.releasePort??!0});if(!n.success&&n.error&&!n.error.includes(`No matching process entry`))throw Error(n.error||`Failed to release process for ${e.serviceName}`)}}}exports.DEFAULT_REGISTRY_LOCK_PATH=e.n,exports.DEFAULT_REGISTRY_PATH=e.r,exports.LOCK_MAX_RETRIES=e.i,exports.LOCK_RETRY_DELAY_MS=e.a,exports.LOCK_STALE_AFTER_MS=e.o,exports.ListProcessFiltersSchema=e.u,exports.ProcessMetadataSchema=e.d,exports.ProcessRegistryError=e.f,exports.ProcessRegistryRecordSchema=e.p,exports.ProcessRegistryResponseSchema=e.m,exports.ProcessRegistryService=e.t,exports.ProcessRegistryStateSchema=e.h,exports.REGISTRY_VERSION=e.g,exports.RegisterProcessRequestSchema=e._,exports.ReleaseProcessRequestSchema=e.v,exports.ServiceCategorySchema=e.y,exports.createProcessLease=n,exports.createProcessRegistryService=t,exports.makeTempPath=e.s,exports.normalizeRepositoryPath=e.c,exports.resolveSiblingRegistryPath=e.l;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./ProcessRegistryService.cjs`);function t(t){return new e.t(t??process.env.PROCESS_REGISTRY_PATH)}async function n(n,r){let i=r??t(),a=n.pid??process.pid,o=n.serviceType??`tool`,s=n.environment??process.env.NODE_ENV??`development`,c={repositoryPath:n.repositoryPath,serviceName:n.serviceName,serviceType:o,environment:s,pid:a,port:n.port,host:n.host,command:n.command,args:n.args,tags:e.b(n.tags),metadata:n.metadata,force:n.force??!0},l=await i.registerProcess(c);if(!l.success||!l.record)throw Error(l.error||`Failed to register process for ${n.serviceName}`);let u=!1;return{release:async e=>{if(u)return;u=!0;let t=await i.releaseProcess({repositoryPath:n.repositoryPath,serviceName:n.serviceName,serviceType:o,pid:a,environment:s,kill:e?.kill??!0,releasePort:e?.releasePort??!0});if(!t.success&&t.error&&!t.error.includes(`No matching process entry`))throw Error(t.error||`Failed to release process for ${n.serviceName}`)}}}exports.DEFAULT_REGISTRY_LOCK_PATH=e.f,exports.DEFAULT_REGISTRY_PATH=e.p,exports.LOCK_MAX_RETRIES=e.m,exports.LOCK_RETRY_DELAY_MS=e.h,exports.LOCK_STALE_AFTER_MS=e.g,exports.ListProcessFiltersSchema=e.n,exports.PROCESS_REGISTRY_TAG_ENV_VAR=e._,exports.ProcessMetadataSchema=e.r,exports.ProcessRegistryError=e.i,exports.ProcessRegistryRecordSchema=e.a,exports.ProcessRegistryResponseSchema=e.o,exports.ProcessRegistryService=e.t,exports.ProcessRegistryStateSchema=e.s,exports.REGISTRY_VERSION=e.c,exports.RegisterProcessRequestSchema=e.l,exports.ReleaseProcessRequestSchema=e.u,exports.ServiceCategorySchema=e.d,exports.createProcessLease=n,exports.createProcessRegistryService=t,exports.makeTempPath=e.v,exports.normalizeRepositoryPath=e.y,exports.resolveProcessTags=e.b,exports.resolveSiblingRegistryPath=e.x;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["ProcessRegistryService"],"sources":["../src/services/ProcessLease.ts"],"sourcesContent":["import type { RegisterProcessRequest, ServiceCategory } from '../types';\nimport { ProcessRegistryService } from './ProcessRegistryService';\n\nexport interface ProcessLease {\n  release(options?: { kill?: boolean; releasePort?: boolean }): Promise<void>;\n}\n\nexport interface ProcessLeaseOptions {\n  repositoryPath: string;\n  serviceName: string;\n  serviceType?: ServiceCategory;\n  environment?: string;\n  pid?: number;\n  port?: number;\n  host?: string;\n  command?: string;\n  args?: string[];\n  metadata?: Record<string, unknown>;\n  force?: boolean;\n}\n\nexport function createProcessRegistryService(registryPath?: string): ProcessRegistryService {\n  return new ProcessRegistryService(registryPath ?? process.env.PROCESS_REGISTRY_PATH);\n}\n\nexport async function createProcessLease(\n  options: ProcessLeaseOptions,\n  service?: ProcessRegistryService,\n): Promise<ProcessLease> {\n  const registry = service ?? createProcessRegistryService();\n  const pid = options.pid ?? process.pid;\n  const serviceType = options.serviceType ?? 'tool';\n  const environment = options.environment ?? process.env.NODE_ENV ?? 'development';\n\n  const request: RegisterProcessRequest = {\n    repositoryPath: options.repositoryPath,\n    serviceName: options.serviceName,\n    serviceType,\n    environment,\n    pid,\n    port: options.port,\n    host: options.host,\n    command: options.command,\n    args: options.args,\n    metadata: options.metadata,\n    force: options.force ?? true,\n  };\n\n  const result = await registry.registerProcess(request);\n\n  if (!result.success || !result.record) {\n    throw new Error(result.error || `Failed to register process for ${options.serviceName}`);\n  }\n\n  let released = false;\n  return {\n    release: async (releaseOptions?: { kill?: boolean; releasePort?: boolean }): Promise<void> => {\n      if (released) {\n        return;\n      }\n\n      released = true;\n      const releaseResult = await registry.releaseProcess({\n        repositoryPath: options.repositoryPath,\n        serviceName: options.serviceName,\n        serviceType,\n        pid,\n        environment,\n        kill: releaseOptions?.kill ?? true,\n        releasePort: releaseOptions?.releasePort ?? true,\n      });\n\n      if (!releaseResult.success && releaseResult.error && !releaseResult.error.includes('No matching process entry')) {\n        throw new Error(releaseResult.error || `Failed to release process for ${options.serviceName}`);\n      }\n    },\n  };\n}\n"],"mappings":"mHAqBA,SAAgB,EAA6B,EAA+C,CAC1F,OAAO,IAAIA,EAAAA,EAAuB,GAAgB,QAAQ,IAAI,sBAAsB,CAGtF,eAAsB,EACpB,EACA,EACuB,CACvB,IAAM,EAAW,GAAW,GAA8B,CACpD,EAAM,EAAQ,KAAO,QAAQ,IAC7B,EAAc,EAAQ,aAAe,OACrC,EAAc,EAAQ,aAAe,QAAQ,IAAI,UAAY,cAE7D,EAAkC,CACtC,eAAgB,EAAQ,eACxB,YAAa,EAAQ,YACrB,cACA,cACA,MACA,KAAM,EAAQ,KACd,KAAM,EAAQ,KACd,QAAS,EAAQ,QACjB,KAAM,EAAQ,KACd,SAAU,EAAQ,SAClB,MAAO,EAAQ,OAAS,GACzB,CAEK,EAAS,MAAM,EAAS,gBAAgB,EAAQ,CAEtD,GAAI,CAAC,EAAO,SAAW,CAAC,EAAO,OAC7B,MAAU,MAAM,EAAO,OAAS,kCAAkC,EAAQ,cAAc,CAG1F,IAAI,EAAW,GACf,MAAO,CACL,QAAS,KAAO,IAA8E,CAC5F,GAAI,EACF,OAGF,EAAW,GACX,IAAM,EAAgB,MAAM,EAAS,eAAe,CAClD,eAAgB,EAAQ,eACxB,YAAa,EAAQ,YACrB,cACA,MACA,cACA,KAAM,GAAgB,MAAQ,GAC9B,YAAa,GAAgB,aAAe,GAC7C,CAAC,CAEF,GAAI,CAAC,EAAc,SAAW,EAAc,OAAS,CAAC,EAAc,MAAM,SAAS,4BAA4B,CAC7G,MAAU,MAAM,EAAc,OAAS,iCAAiC,EAAQ,cAAc,EAGnG"}
+{"version":3,"file":"index.cjs","names":["ProcessRegistryService","resolveProcessTags"],"sources":["../src/services/ProcessLease.ts"],"sourcesContent":["import type { RegisterProcessRequest, ServiceCategory } from '../types';\nimport { resolveProcessTags } from '../utils';\nimport { ProcessRegistryService } from './ProcessRegistryService';\n\nexport interface ProcessLease {\n  release(options?: { kill?: boolean; releasePort?: boolean }): Promise<void>;\n}\n\nexport interface ProcessLeaseOptions {\n  repositoryPath: string;\n  serviceName: string;\n  serviceType?: ServiceCategory;\n  environment?: string;\n  pid?: number;\n  port?: number;\n  host?: string;\n  command?: string;\n  args?: string[];\n  tags?: string[];\n  metadata?: Record<string, unknown>;\n  force?: boolean;\n}\n\nexport function createProcessRegistryService(registryPath?: string): ProcessRegistryService {\n  return new ProcessRegistryService(registryPath ?? process.env.PROCESS_REGISTRY_PATH);\n}\n\nexport async function createProcessLease(\n  options: ProcessLeaseOptions,\n  service?: ProcessRegistryService,\n): Promise<ProcessLease> {\n  const registry = service ?? createProcessRegistryService();\n  const pid = options.pid ?? process.pid;\n  const serviceType = options.serviceType ?? 'tool';\n  const environment = options.environment ?? process.env.NODE_ENV ?? 'development';\n\n  const request: RegisterProcessRequest = {\n    repositoryPath: options.repositoryPath,\n    serviceName: options.serviceName,\n    serviceType,\n    environment,\n    pid,\n    port: options.port,\n    host: options.host,\n    command: options.command,\n    args: options.args,\n    tags: resolveProcessTags(options.tags),\n    metadata: options.metadata,\n    force: options.force ?? true,\n  };\n\n  const result = await registry.registerProcess(request);\n\n  if (!result.success || !result.record) {\n    throw new Error(result.error || `Failed to register process for ${options.serviceName}`);\n  }\n\n  let released = false;\n  return {\n    release: async (releaseOptions?: { kill?: boolean; releasePort?: boolean }): Promise<void> => {\n      if (released) {\n        return;\n      }\n\n      released = true;\n      const releaseResult = await registry.releaseProcess({\n        repositoryPath: options.repositoryPath,\n        serviceName: options.serviceName,\n        serviceType,\n        pid,\n        environment,\n        kill: releaseOptions?.kill ?? true,\n        releasePort: releaseOptions?.releasePort ?? true,\n      });\n\n      if (!releaseResult.success && releaseResult.error && !releaseResult.error.includes('No matching process entry')) {\n        throw new Error(releaseResult.error || `Failed to release process for ${options.serviceName}`);\n      }\n    },\n  };\n}\n"],"mappings":"mHAuBA,SAAgB,EAA6B,EAA+C,CAC1F,OAAO,IAAIA,EAAAA,EAAuB,GAAgB,QAAQ,IAAI,sBAAsB,CAGtF,eAAsB,EACpB,EACA,EACuB,CACvB,IAAM,EAAW,GAAW,GAA8B,CACpD,EAAM,EAAQ,KAAO,QAAQ,IAC7B,EAAc,EAAQ,aAAe,OACrC,EAAc,EAAQ,aAAe,QAAQ,IAAI,UAAY,cAE7D,EAAkC,CACtC,eAAgB,EAAQ,eACxB,YAAa,EAAQ,YACrB,cACA,cACA,MACA,KAAM,EAAQ,KACd,KAAM,EAAQ,KACd,QAAS,EAAQ,QACjB,KAAM,EAAQ,KACd,KAAMC,EAAAA,EAAmB,EAAQ,KAAK,CACtC,SAAU,EAAQ,SAClB,MAAO,EAAQ,OAAS,GACzB,CAEK,EAAS,MAAM,EAAS,gBAAgB,EAAQ,CAEtD,GAAI,CAAC,EAAO,SAAW,CAAC,EAAO,OAC7B,MAAU,MAAM,EAAO,OAAS,kCAAkC,EAAQ,cAAc,CAG1F,IAAI,EAAW,GACf,MAAO,CACL,QAAS,KAAO,IAA8E,CAC5F,GAAI,EACF,OAGF,EAAW,GACX,IAAM,EAAgB,MAAM,EAAS,eAAe,CAClD,eAAgB,EAAQ,eACxB,YAAa,EAAQ,YACrB,cACA,MACA,cACA,KAAM,GAAgB,MAAQ,GAC9B,YAAa,GAAgB,aAAe,GAC7C,CAAC,CAEF,GAAI,CAAC,EAAc,SAAW,EAAc,OAAS,CAAC,EAAc,MAAM,SAAS,4BAA4B,CAC7G,MAAU,MAAM,EAAc,OAAS,iCAAiC,EAAQ,cAAc,EAGnG"}

package/dist/index.d.cts

@@ -21,6 +21,7 @@ declare const ProcessRegistryRecordSchema: z.ZodObject<{
   host: z.ZodOptional<z.ZodString>;
   command: z.ZodOptional<z.ZodString>;
   args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
   metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
@@ -41,6 +42,7 @@ declare const ProcessRegistryStateSchema: z.ZodObject<{
     host: z.ZodOptional<z.ZodString>;
     command: z.ZodOptional<z.ZodString>;
     args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
@@ -59,6 +61,7 @@ declare const RegisterProcessRequestSchema: z.ZodObject<{
   host: z.ZodOptional<z.ZodString>;
   command: z.ZodOptional<z.ZodString>;
   args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
   metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   force: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
@@ -71,6 +74,7 @@ declare const ReleaseProcessRequestSchema: z.ZodObject<{
   }>>;
   pid: z.ZodOptional<z.ZodNumber>;
   environment: z.ZodOptional<z.ZodString>;
+  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
   force: z.ZodOptional<z.ZodBoolean>;
   kill: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   releasePort: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -83,6 +87,7 @@ declare const ListProcessFiltersSchema: z.ZodObject<{
   }>>;
   serviceName: z.ZodOptional<z.ZodString>;
   environment: z.ZodOptional<z.ZodString>;
+  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 declare const ProcessRegistryResponseSchema: z.ZodObject<{
   success: z.ZodBoolean;
@@ -100,6 +105,7 @@ declare const ProcessRegistryResponseSchema: z.ZodObject<{
     host: z.ZodOptional<z.ZodString>;
     command: z.ZodOptional<z.ZodString>;
     args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
@@ -153,6 +159,7 @@ declare class ProcessRegistryService {
   private removeMatchingEntries;
   private createSuccessResponse;
   private createFailureResponse;
+  private matchesTags;
   private pathExists;
   private delay;
 }
@@ -174,6 +181,7 @@ interface ProcessLeaseOptions {
   host?: string;
   command?: string;
   args?: string[];
+  tags?: string[];
   metadata?: Record<string, unknown>;
   force?: boolean;
 }
@@ -186,9 +194,11 @@ declare const DEFAULT_REGISTRY_LOCK_PATH: string;
 declare const LOCK_RETRY_DELAY_MS = 75;
 declare const LOCK_MAX_RETRIES = 80;
 declare const LOCK_STALE_AFTER_MS = 5000;
+declare const PROCESS_REGISTRY_TAG_ENV_VAR = "PROCESS_REGISTRY_TAG";
 declare const normalizeRepositoryPath: (value: string) => string;
 declare const makeTempPath: (filePath: string) => string;
+declare function resolveProcessTags(tags?: string[]): string[] | undefined;
 declare function resolveSiblingRegistryPath(registryPath: string | undefined, fileName: string): string | undefined;
 //#endregion
-export { DEFAULT_REGISTRY_LOCK_PATH, DEFAULT_REGISTRY_PATH, LOCK_MAX_RETRIES, LOCK_RETRY_DELAY_MS, LOCK_STALE_AFTER_MS, ListProcessFilters, ListProcessFiltersSchema, ProcessLease, ProcessLeaseOptions, ProcessMetadata, ProcessMetadataSchema, ProcessRegistryError, ProcessRegistryErrorCode, ProcessRegistryRecord, ProcessRegistryRecordSchema, ProcessRegistryResponse, ProcessRegistryResponseSchema, ProcessRegistryService, ProcessRegistryState, ProcessRegistryStateSchema, REGISTRY_VERSION, RegisterProcessRequest, RegisterProcessRequestSchema, ReleaseProcessRequest, ReleaseProcessRequestSchema, ServiceCategory, ServiceCategorySchema, createProcessLease, createProcessRegistryService, makeTempPath, normalizeRepositoryPath, resolveSiblingRegistryPath };
+export { DEFAULT_REGISTRY_LOCK_PATH, DEFAULT_REGISTRY_PATH, LOCK_MAX_RETRIES, LOCK_RETRY_DELAY_MS, LOCK_STALE_AFTER_MS, ListProcessFilters, ListProcessFiltersSchema, PROCESS_REGISTRY_TAG_ENV_VAR, ProcessLease, ProcessLeaseOptions, ProcessMetadata, ProcessMetadataSchema, ProcessRegistryError, ProcessRegistryErrorCode, ProcessRegistryRecord, ProcessRegistryRecordSchema, ProcessRegistryResponse, ProcessRegistryResponseSchema, ProcessRegistryService, ProcessRegistryState, ProcessRegistryStateSchema, REGISTRY_VERSION, RegisterProcessRequest, RegisterProcessRequestSchema, ReleaseProcessRequest, ReleaseProcessRequestSchema, ServiceCategory, ServiceCategorySchema, createProcessLease, createProcessRegistryService, makeTempPath, normalizeRepositoryPath, resolveProcessTags, resolveSiblingRegistryPath };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -21,6 +21,7 @@ declare const ProcessRegistryRecordSchema: z.ZodObject<{
   host: z.ZodOptional<z.ZodString>;
   command: z.ZodOptional<z.ZodString>;
   args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
   metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
@@ -41,6 +42,7 @@ declare const ProcessRegistryStateSchema: z.ZodObject<{
     host: z.ZodOptional<z.ZodString>;
     command: z.ZodOptional<z.ZodString>;
     args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
@@ -59,6 +61,7 @@ declare const RegisterProcessRequestSchema: z.ZodObject<{
   host: z.ZodOptional<z.ZodString>;
   command: z.ZodOptional<z.ZodString>;
   args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
   metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   force: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
@@ -71,6 +74,7 @@ declare const ReleaseProcessRequestSchema: z.ZodObject<{
   }>>;
   pid: z.ZodOptional<z.ZodNumber>;
   environment: z.ZodOptional<z.ZodString>;
+  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
   force: z.ZodOptional<z.ZodBoolean>;
   kill: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   releasePort: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -83,6 +87,7 @@ declare const ListProcessFiltersSchema: z.ZodObject<{
   }>>;
   serviceName: z.ZodOptional<z.ZodString>;
   environment: z.ZodOptional<z.ZodString>;
+  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 declare const ProcessRegistryResponseSchema: z.ZodObject<{
   success: z.ZodBoolean;
@@ -100,6 +105,7 @@ declare const ProcessRegistryResponseSchema: z.ZodObject<{
     host: z.ZodOptional<z.ZodString>;
     command: z.ZodOptional<z.ZodString>;
     args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
@@ -153,6 +159,7 @@ declare class ProcessRegistryService {
   private removeMatchingEntries;
   private createSuccessResponse;
   private createFailureResponse;
+  private matchesTags;
   private pathExists;
   private delay;
 }
@@ -174,6 +181,7 @@ interface ProcessLeaseOptions {
   host?: string;
   command?: string;
   args?: string[];
+  tags?: string[];
   metadata?: Record<string, unknown>;
   force?: boolean;
 }
@@ -186,9 +194,11 @@ declare const DEFAULT_REGISTRY_LOCK_PATH: string;
 declare const LOCK_RETRY_DELAY_MS = 75;
 declare const LOCK_MAX_RETRIES = 80;
 declare const LOCK_STALE_AFTER_MS = 5000;
+declare const PROCESS_REGISTRY_TAG_ENV_VAR = "PROCESS_REGISTRY_TAG";
 declare const normalizeRepositoryPath: (value: string) => string;
 declare const makeTempPath: (filePath: string) => string;
+declare function resolveProcessTags(tags?: string[]): string[] | undefined;
 declare function resolveSiblingRegistryPath(registryPath: string | undefined, fileName: string): string | undefined;
 //#endregion
-export { DEFAULT_REGISTRY_LOCK_PATH, DEFAULT_REGISTRY_PATH, LOCK_MAX_RETRIES, LOCK_RETRY_DELAY_MS, LOCK_STALE_AFTER_MS, ListProcessFilters, ListProcessFiltersSchema, ProcessLease, ProcessLeaseOptions, ProcessMetadata, ProcessMetadataSchema, ProcessRegistryError, ProcessRegistryErrorCode, ProcessRegistryRecord, ProcessRegistryRecordSchema, ProcessRegistryResponse, ProcessRegistryResponseSchema, ProcessRegistryService, ProcessRegistryState, ProcessRegistryStateSchema, REGISTRY_VERSION, RegisterProcessRequest, RegisterProcessRequestSchema, ReleaseProcessRequest, ReleaseProcessRequestSchema, ServiceCategory, ServiceCategorySchema, createProcessLease, createProcessRegistryService, makeTempPath, normalizeRepositoryPath, resolveSiblingRegistryPath };
+export { DEFAULT_REGISTRY_LOCK_PATH, DEFAULT_REGISTRY_PATH, LOCK_MAX_RETRIES, LOCK_RETRY_DELAY_MS, LOCK_STALE_AFTER_MS, ListProcessFilters, ListProcessFiltersSchema, PROCESS_REGISTRY_TAG_ENV_VAR, ProcessLease, ProcessLeaseOptions, ProcessMetadata, ProcessMetadataSchema, ProcessRegistryError, ProcessRegistryErrorCode, ProcessRegistryRecord, ProcessRegistryRecordSchema, ProcessRegistryResponse, ProcessRegistryResponseSchema, ProcessRegistryService, ProcessRegistryState, ProcessRegistryStateSchema, REGISTRY_VERSION, RegisterProcessRequest, RegisterProcessRequestSchema, ReleaseProcessRequest, ReleaseProcessRequestSchema, ServiceCategory, ServiceCategorySchema, createProcessLease, createProcessRegistryService, makeTempPath, normalizeRepositoryPath, resolveProcessTags, resolveSiblingRegistryPath };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import{_ as e,a as t,c as n,d as r,f as i,g as a,h as o,i as s,l as c,m as l,n as u,o as d,p as f,r as p,s as m,t as h,u as g,v as _,y as v}from"./ProcessRegistryService.mjs";function y(e){return new h(e??process.env.PROCESS_REGISTRY_PATH)}async function b(e,t){let n=t??y(),r=e.pid??process.pid,i=e.serviceType??`tool`,a=e.environment??process.env.NODE_ENV??`development`,o={repositoryPath:e.repositoryPath,serviceName:e.serviceName,serviceType:i,environment:a,pid:r,port:e.port,host:e.host,command:e.command,args:e.args,metadata:e.metadata,force:e.force??!0},s=await n.registerProcess(o);if(!s.success||!s.record)throw Error(s.error||`Failed to register process for ${e.serviceName}`);let c=!1;return{release:async t=>{if(c)return;c=!0;let o=await n.releaseProcess({repositoryPath:e.repositoryPath,serviceName:e.serviceName,serviceType:i,pid:r,environment:a,kill:t?.kill??!0,releasePort:t?.releasePort??!0});if(!o.success&&o.error&&!o.error.includes(`No matching process entry`))throw Error(o.error||`Failed to release process for ${e.serviceName}`)}}}export{u as DEFAULT_REGISTRY_LOCK_PATH,p as DEFAULT_REGISTRY_PATH,s as LOCK_MAX_RETRIES,t as LOCK_RETRY_DELAY_MS,d as LOCK_STALE_AFTER_MS,g as ListProcessFiltersSchema,r as ProcessMetadataSchema,i as ProcessRegistryError,f as ProcessRegistryRecordSchema,l as ProcessRegistryResponseSchema,h as ProcessRegistryService,o as ProcessRegistryStateSchema,a as REGISTRY_VERSION,e as RegisterProcessRequestSchema,_ as ReleaseProcessRequestSchema,v as ServiceCategorySchema,b as createProcessLease,y as createProcessRegistryService,m as makeTempPath,n as normalizeRepositoryPath,c as resolveSiblingRegistryPath};
+import{_ as e,a as t,b as n,c as r,d as i,f as a,g as o,h as s,i as c,l,m as u,n as d,o as f,p,r as m,s as h,t as g,u as _,v,x as y,y as b}from"./ProcessRegistryService.mjs";function x(e){return new g(e??process.env.PROCESS_REGISTRY_PATH)}async function S(e,t){let r=t??x(),i=e.pid??process.pid,a=e.serviceType??`tool`,o=e.environment??process.env.NODE_ENV??`development`,s={repositoryPath:e.repositoryPath,serviceName:e.serviceName,serviceType:a,environment:o,pid:i,port:e.port,host:e.host,command:e.command,args:e.args,tags:n(e.tags),metadata:e.metadata,force:e.force??!0},c=await r.registerProcess(s);if(!c.success||!c.record)throw Error(c.error||`Failed to register process for ${e.serviceName}`);let l=!1;return{release:async t=>{if(l)return;l=!0;let n=await r.releaseProcess({repositoryPath:e.repositoryPath,serviceName:e.serviceName,serviceType:a,pid:i,environment:o,kill:t?.kill??!0,releasePort:t?.releasePort??!0});if(!n.success&&n.error&&!n.error.includes(`No matching process entry`))throw Error(n.error||`Failed to release process for ${e.serviceName}`)}}}export{a as DEFAULT_REGISTRY_LOCK_PATH,p as DEFAULT_REGISTRY_PATH,u as LOCK_MAX_RETRIES,s as LOCK_RETRY_DELAY_MS,o as LOCK_STALE_AFTER_MS,d as ListProcessFiltersSchema,e as PROCESS_REGISTRY_TAG_ENV_VAR,m as ProcessMetadataSchema,c as ProcessRegistryError,t as ProcessRegistryRecordSchema,f as ProcessRegistryResponseSchema,g as ProcessRegistryService,h as ProcessRegistryStateSchema,r as REGISTRY_VERSION,l as RegisterProcessRequestSchema,_ as ReleaseProcessRequestSchema,i as ServiceCategorySchema,S as createProcessLease,x as createProcessRegistryService,v as makeTempPath,b as normalizeRepositoryPath,n as resolveProcessTags,y as resolveSiblingRegistryPath};
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/services/ProcessLease.ts"],"sourcesContent":["import type { RegisterProcessRequest, ServiceCategory } from '../types';\nimport { ProcessRegistryService } from './ProcessRegistryService';\n\nexport interface ProcessLease {\n  release(options?: { kill?: boolean; releasePort?: boolean }): Promise<void>;\n}\n\nexport interface ProcessLeaseOptions {\n  repositoryPath: string;\n  serviceName: string;\n  serviceType?: ServiceCategory;\n  environment?: string;\n  pid?: number;\n  port?: number;\n  host?: string;\n  command?: string;\n  args?: string[];\n  metadata?: Record<string, unknown>;\n  force?: boolean;\n}\n\nexport function createProcessRegistryService(registryPath?: string): ProcessRegistryService {\n  return new ProcessRegistryService(registryPath ?? process.env.PROCESS_REGISTRY_PATH);\n}\n\nexport async function createProcessLease(\n  options: ProcessLeaseOptions,\n  service?: ProcessRegistryService,\n): Promise<ProcessLease> {\n  const registry = service ?? createProcessRegistryService();\n  const pid = options.pid ?? process.pid;\n  const serviceType = options.serviceType ?? 'tool';\n  const environment = options.environment ?? process.env.NODE_ENV ?? 'development';\n\n  const request: RegisterProcessRequest = {\n    repositoryPath: options.repositoryPath,\n    serviceName: options.serviceName,\n    serviceType,\n    environment,\n    pid,\n    port: options.port,\n    host: options.host,\n    command: options.command,\n    args: options.args,\n    metadata: options.metadata,\n    force: options.force ?? true,\n  };\n\n  const result = await registry.registerProcess(request);\n\n  if (!result.success || !result.record) {\n    throw new Error(result.error || `Failed to register process for ${options.serviceName}`);\n  }\n\n  let released = false;\n  return {\n    release: async (releaseOptions?: { kill?: boolean; releasePort?: boolean }): Promise<void> => {\n      if (released) {\n        return;\n      }\n\n      released = true;\n      const releaseResult = await registry.releaseProcess({\n        repositoryPath: options.repositoryPath,\n        serviceName: options.serviceName,\n        serviceType,\n        pid,\n        environment,\n        kill: releaseOptions?.kill ?? true,\n        releasePort: releaseOptions?.releasePort ?? true,\n      });\n\n      if (!releaseResult.success && releaseResult.error && !releaseResult.error.includes('No matching process entry')) {\n        throw new Error(releaseResult.error || `Failed to release process for ${options.serviceName}`);\n      }\n    },\n  };\n}\n"],"mappings":"+KAqBA,SAAgB,EAA6B,EAA+C,CAC1F,OAAO,IAAI,EAAuB,GAAgB,QAAQ,IAAI,sBAAsB,CAGtF,eAAsB,EACpB,EACA,EACuB,CACvB,IAAM,EAAW,GAAW,GAA8B,CACpD,EAAM,EAAQ,KAAO,QAAQ,IAC7B,EAAc,EAAQ,aAAe,OACrC,EAAc,EAAQ,aAAe,QAAQ,IAAI,UAAY,cAE7D,EAAkC,CACtC,eAAgB,EAAQ,eACxB,YAAa,EAAQ,YACrB,cACA,cACA,MACA,KAAM,EAAQ,KACd,KAAM,EAAQ,KACd,QAAS,EAAQ,QACjB,KAAM,EAAQ,KACd,SAAU,EAAQ,SAClB,MAAO,EAAQ,OAAS,GACzB,CAEK,EAAS,MAAM,EAAS,gBAAgB,EAAQ,CAEtD,GAAI,CAAC,EAAO,SAAW,CAAC,EAAO,OAC7B,MAAU,MAAM,EAAO,OAAS,kCAAkC,EAAQ,cAAc,CAG1F,IAAI,EAAW,GACf,MAAO,CACL,QAAS,KAAO,IAA8E,CAC5F,GAAI,EACF,OAGF,EAAW,GACX,IAAM,EAAgB,MAAM,EAAS,eAAe,CAClD,eAAgB,EAAQ,eACxB,YAAa,EAAQ,YACrB,cACA,MACA,cACA,KAAM,GAAgB,MAAQ,GAC9B,YAAa,GAAgB,aAAe,GAC7C,CAAC,CAEF,GAAI,CAAC,EAAc,SAAW,EAAc,OAAS,CAAC,EAAc,MAAM,SAAS,4BAA4B,CAC7G,MAAU,MAAM,EAAc,OAAS,iCAAiC,EAAQ,cAAc,EAGnG"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/services/ProcessLease.ts"],"sourcesContent":["import type { RegisterProcessRequest, ServiceCategory } from '../types';\nimport { resolveProcessTags } from '../utils';\nimport { ProcessRegistryService } from './ProcessRegistryService';\n\nexport interface ProcessLease {\n  release(options?: { kill?: boolean; releasePort?: boolean }): Promise<void>;\n}\n\nexport interface ProcessLeaseOptions {\n  repositoryPath: string;\n  serviceName: string;\n  serviceType?: ServiceCategory;\n  environment?: string;\n  pid?: number;\n  port?: number;\n  host?: string;\n  command?: string;\n  args?: string[];\n  tags?: string[];\n  metadata?: Record<string, unknown>;\n  force?: boolean;\n}\n\nexport function createProcessRegistryService(registryPath?: string): ProcessRegistryService {\n  return new ProcessRegistryService(registryPath ?? process.env.PROCESS_REGISTRY_PATH);\n}\n\nexport async function createProcessLease(\n  options: ProcessLeaseOptions,\n  service?: ProcessRegistryService,\n): Promise<ProcessLease> {\n  const registry = service ?? createProcessRegistryService();\n  const pid = options.pid ?? process.pid;\n  const serviceType = options.serviceType ?? 'tool';\n  const environment = options.environment ?? process.env.NODE_ENV ?? 'development';\n\n  const request: RegisterProcessRequest = {\n    repositoryPath: options.repositoryPath,\n    serviceName: options.serviceName,\n    serviceType,\n    environment,\n    pid,\n    port: options.port,\n    host: options.host,\n    command: options.command,\n    args: options.args,\n    tags: resolveProcessTags(options.tags),\n    metadata: options.metadata,\n    force: options.force ?? true,\n  };\n\n  const result = await registry.registerProcess(request);\n\n  if (!result.success || !result.record) {\n    throw new Error(result.error || `Failed to register process for ${options.serviceName}`);\n  }\n\n  let released = false;\n  return {\n    release: async (releaseOptions?: { kill?: boolean; releasePort?: boolean }): Promise<void> => {\n      if (released) {\n        return;\n      }\n\n      released = true;\n      const releaseResult = await registry.releaseProcess({\n        repositoryPath: options.repositoryPath,\n        serviceName: options.serviceName,\n        serviceType,\n        pid,\n        environment,\n        kill: releaseOptions?.kill ?? true,\n        releasePort: releaseOptions?.releasePort ?? true,\n      });\n\n      if (!releaseResult.success && releaseResult.error && !releaseResult.error.includes('No matching process entry')) {\n        throw new Error(releaseResult.error || `Failed to release process for ${options.serviceName}`);\n      }\n    },\n  };\n}\n"],"mappings":"8KAuBA,SAAgB,EAA6B,EAA+C,CAC1F,OAAO,IAAI,EAAuB,GAAgB,QAAQ,IAAI,sBAAsB,CAGtF,eAAsB,EACpB,EACA,EACuB,CACvB,IAAM,EAAW,GAAW,GAA8B,CACpD,EAAM,EAAQ,KAAO,QAAQ,IAC7B,EAAc,EAAQ,aAAe,OACrC,EAAc,EAAQ,aAAe,QAAQ,IAAI,UAAY,cAE7D,EAAkC,CACtC,eAAgB,EAAQ,eACxB,YAAa,EAAQ,YACrB,cACA,cACA,MACA,KAAM,EAAQ,KACd,KAAM,EAAQ,KACd,QAAS,EAAQ,QACjB,KAAM,EAAQ,KACd,KAAM,EAAmB,EAAQ,KAAK,CACtC,SAAU,EAAQ,SAClB,MAAO,EAAQ,OAAS,GACzB,CAEK,EAAS,MAAM,EAAS,gBAAgB,EAAQ,CAEtD,GAAI,CAAC,EAAO,SAAW,CAAC,EAAO,OAC7B,MAAU,MAAM,EAAO,OAAS,kCAAkC,EAAQ,cAAc,CAG1F,IAAI,EAAW,GACf,MAAO,CACL,QAAS,KAAO,IAA8E,CAC5F,GAAI,EACF,OAGF,EAAW,GACX,IAAM,EAAgB,MAAM,EAAS,eAAe,CAClD,eAAgB,EAAQ,eACxB,YAAa,EAAQ,YACrB,cACA,MACA,cACA,KAAM,GAAgB,MAAQ,GAC9B,YAAa,GAAgB,aAAe,GAC7C,CAAC,CAEF,GAAI,CAAC,EAAc,SAAW,EAAc,OAAS,CAAC,EAAc,MAAM,SAAS,4BAA4B,CAC7G,MAAU,MAAM,EAAc,OAAS,iCAAiC,EAAQ,cAAc,EAGnG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/foundation-process-registry",
-  "version": "0.7.0",
+  "version": "0.8.2",
   "description": "Long-running process registry and cleanup coordination across worktrees",
   "bin": {
     "process-registry": "./dist/cli.cjs"
@@ -14,7 +14,7 @@
   },
   "dependencies": {
     "zod": "4.3.6",
-    "@agimon-ai/foundation-port-registry": "0.7.0"
+    "@agimon-ai/foundation-port-registry": "0.8.2"
   },
   "devDependencies": {
     "@types/node": "25.6.0",