{"_id":"@code-fixer-23/pi-session-manager","_rev":"8-f8cb0d1058d7bb068c7091b54e90ca2d","name":"@code-fixer-23/pi-session-manager","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@code-fixer-23/pi-session-manager","version":"1.0.0","keywords":["pi-package"],"license":"MIT","_id":"@code-fixer-23/pi-session-manager@1.0.0","maintainers":[{"name":"codebreaker10","email":"louisshelton0@gmail.com"}],"homepage":"https://github.com/louiss0/pi-packages","bugs":{"url":"https://github.com/louiss0/pi-packages/issues"},"pi":{"image":"https://raw.githubusercontent.com/louiss0/pi-packages/main/pi-session-manager/assets/Pi-Session-Manager-Small.png"},"dist":{"shasum":"83c6979abab68c03170e2117471c468f94e19205","tarball":"https://registry.npmjs.org/@code-fixer-23/pi-session-manager/-/pi-session-manager-1.0.0.tgz","fileCount":12,"integrity":"sha512-GiKZeBTdNS6FUxn7A2Mo1dVhOFO/2RY52Sdbseo3Lfixk+V94bSpzsOFCT0j+BBGez6p1+FZmgwp/2nM1YLWrA==","signatures":[{"sig":"MEUCIQCYJb8B/htfHyqBSN8J7Pkzl7XSK3VKhWh3sBwPCDcXkAIgPwoCE5ottxk4kEIKRGro8cFONmHnKLihyIgCSLYqzIU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3178447},"type":"module","private":false,"_npmUser":{"name":"codebreaker10","email":"louisshelton0@gmail.com"},"repository":{"url":"https://github.com/louiss0/pi-packages","type":"git","directory":"pi-session-manager"},"description":"Pi package scaffold for pi-session-manager","directories":{},"_nodeVersion":"24.15.0","dependencies":{"valibot":"^1.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"latest","typescript":"latest"},"peerDependencies":{"@earendil-works/pi-tui":"*","@earendil-works/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-session-manager_1.0.0_1783033669240_0.7929312866045715","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@code-fixer-23/pi-session-manager","version":"1.0.1","keywords":["pi-package"],"license":"MIT","_id":"@code-fixer-23/pi-session-manager@1.0.1","maintainers":[{"name":"codebreaker10","email":"louisshelton0@gmail.com"}],"homepage":"https://github.com/louiss0/pi-packages","bugs":{"url":"https://github.com/louiss0/pi-packages/issues"},"pi":{"image":"https://raw.githubusercontent.com/louiss0/pi-packages/main/pi-session-manager/assets/Pi-Session-Manager-Small.png","extensions":["extensions","extensions/!*.test.ts"]},"dist":{"shasum":"edb9d873ee5177c898ac1f944d0eb0e80a655639","tarball":"https://registry.npmjs.org/@code-fixer-23/pi-session-manager/-/pi-session-manager-1.0.1.tgz","fileCount":12,"integrity":"sha512-eD0Taq2O0/AkiSbNkggtniChbIzJpO3LIz70npBxqrQ2pAkbOtRjzndiWDbS6iW9ssEQHZR4b45M8prp6PXMkg==","signatures":[{"sig":"MEYCIQCWejS9RUlHN8qLj/uWdW7Cvml3TqXaGnmGtSXAZeSc+wIhAOf0Inv5S8DiefSjTkjD2VWNqR8hfWSNbJ/qmaNdpPPw","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3178723},"type":"module","private":false,"_npmUser":{"name":"codebreaker10","email":"louisshelton0@gmail.com"},"repository":{"url":"https://github.com/louiss0/pi-packages","type":"git","directory":"pi-session-manager"},"description":"Pi package scaffold for pi-session-manager","directories":{},"_nodeVersion":"22.19.0","dependencies":{"valibot":"^1.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"latest","typescript":"latest"},"peerDependencies":{"@earendil-works/pi-tui":"*","@earendil-works/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-session-manager_1.0.1_1783104907678_0.7239853055198833","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@code-fixer-23/pi-session-manager","version":"1.0.2","keywords":["pi-package"],"license":"MIT","_id":"@code-fixer-23/pi-session-manager@1.0.2","maintainers":[{"name":"codebreaker10","email":"louisshelton0@gmail.com"}],"homepage":"https://github.com/louiss0/pi-packages","bugs":{"url":"https://github.com/louiss0/pi-packages/issues"},"pi":{"image":"https://raw.githubusercontent.com/louiss0/pi-packages/main/pi-session-manager/assets/Pi-Session-Manager-Small.png","extensions":["extensions","extensions/!*.test.ts"]},"dist":{"shasum":"f280e301f2e1223e657809d57cd409b0d208a05c","tarball":"https://registry.npmjs.org/@code-fixer-23/pi-session-manager/-/pi-session-manager-1.0.2.tgz","fileCount":12,"integrity":"sha512-4v5JwM0OyeVQuvxT2bhLDReul9ktzJsnXrzU4kPrPDUUhWOsE1RYMgCTXp/YBhobEcJvYC/1POT1LQdvYZSM9g==","signatures":[{"sig":"MEYCIQC4E4zqA04iiiXrUCfdQ3M4zZOA2g+ax/7V9RjLaDHbzwIhAPgfqmrOavjzVsXf+t9FyTgk4OWB2W+JtbhvVN7qARFa","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3178936},"type":"module","private":false,"_npmUser":{"name":"codebreaker10","email":"louisshelton0@gmail.com"},"repository":{"url":"https://github.com/louiss0/pi-packages","type":"git","directory":"pi-session-manager"},"description":"Pi package scaffold for pi-session-manager","directories":{},"_nodeVersion":"22.19.0","dependencies":{"valibot":"^1.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"latest","typescript":"latest"},"peerDependencies":{"@earendil-works/pi-tui":"*","@earendil-works/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-session-manager_1.0.2_1783105167933_0.6508206918175174","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@code-fixer-23/pi-session-manager","version":"1.0.3","keywords":["pi-package"],"license":"MIT","_id":"@code-fixer-23/pi-session-manager@1.0.3","maintainers":[{"name":"codebreaker10","email":"louisshelton0@gmail.com"}],"homepage":"https://github.com/louiss0/pi-packages","bugs":{"url":"https://github.com/louiss0/pi-packages/issues"},"pi":{"image":"https://raw.githubusercontent.com/louiss0/pi-packages/main/pi-session-manager/assets/Pi-Session-Manager-Small.png","extensions":["extensions","extensions/!*.test.ts"]},"dist":{"shasum":"ecede2b2f0d10da202128d71dae8d0cd3dfe1292","tarball":"https://registry.npmjs.org/@code-fixer-23/pi-session-manager/-/pi-session-manager-1.0.3.tgz","fileCount":12,"integrity":"sha512-NeQBH03aYYwugY+vL/6Txi2QflDjIS07ZmHERs6Q+NrMBFS4TsOu8CjweC9m1zyc1eLJra8ATuDgY1nrV5SY4Q==","signatures":[{"sig":"MEYCIQDTsKNmh2m9WJF3T73wBd5ABVNxtJdP79YpW5uuPQoVYQIhAIPj1mXVJ36HSAjMVkNyj5Poxxh48KwR/+s4NRNAolfS","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3180653},"type":"module","private":false,"_npmUser":{"name":"codebreaker10","email":"louisshelton0@gmail.com"},"repository":{"url":"https://github.com/louiss0/pi-packages","type":"git","directory":"pi-session-manager"},"description":"Pi package scaffold for pi-session-manager","directories":{},"_nodeVersion":"24.15.0","dependencies":{"valibot":"^1.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"latest","typescript":"latest"},"peerDependencies":{"@earendil-works/pi-tui":"*","@earendil-works/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-session-manager_1.0.3_1783112651927_0.7084469543611986","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@code-fixer-23/pi-session-manager","version":"1.0.4","keywords":["pi-package"],"license":"MIT","_id":"@code-fixer-23/pi-session-manager@1.0.4","maintainers":[{"name":"codebreaker10","email":"louisshelton0@gmail.com"}],"homepage":"https://github.com/louiss0/pi-packages","bugs":{"url":"https://github.com/louiss0/pi-packages/issues"},"pi":{"image":"https://raw.githubusercontent.com/louiss0/pi-packages/main/pi-session-manager/assets/Pi-Session-Manager-Small.png","extensions":["extensions","extensions/!*.test.ts"]},"dist":{"shasum":"6c47acef88c0f833c3321da8a00ca857cd8e378a","tarball":"https://registry.npmjs.org/@code-fixer-23/pi-session-manager/-/pi-session-manager-1.0.4.tgz","fileCount":12,"integrity":"sha512-eXSZPSanpFu+HAcO/3Ks6HIyuWt0H7+A7fXBjwGjObXpLgG1sjnMrT0NLM8wQGUj00SaKgtQvOHjaiy2zSKNxg==","signatures":[{"sig":"MEYCIQCpBMlw/ymmE0ossQrcngHh3bzjMFqEeK5S52SRRA92BwIhAMUA3iJ+rFxgOI0yuC1JW2g+2Rbp51wB3d6O3e3/WYB3","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3179953},"type":"module","private":false,"_npmUser":{"name":"codebreaker10","email":"louisshelton0@gmail.com"},"repository":{"url":"https://github.com/louiss0/pi-packages","type":"git","directory":"pi-session-manager"},"description":"Pi package scaffold for pi-session-manager","directories":{},"_nodeVersion":"22.19.0","dependencies":{"valibot":"^1.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"latest","typescript":"latest"},"peerDependencies":{"@earendil-works/pi-tui":"*","@earendil-works/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-session-manager_1.0.4_1783193114096_0.3576677211854209","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@code-fixer-23/pi-session-manager","version":"1.0.5","keywords":["pi-package"],"license":"MIT","_id":"@code-fixer-23/pi-session-manager@1.0.5","maintainers":[{"name":"codebreaker10","email":"louisshelton0@gmail.com"}],"homepage":"https://github.com/louiss0/pi-packages","bugs":{"url":"https://github.com/louiss0/pi-packages/issues"},"pi":{"image":"https://raw.githubusercontent.com/louiss0/pi-packages/main/pi-session-manager/assets/Pi-Session-Manager-Small.png","extensions":["extensions","extensions/!*.test.ts"]},"dist":{"shasum":"02af30308862cde22c9c7593fbc5858a6021b5db","tarball":"https://registry.npmjs.org/@code-fixer-23/pi-session-manager/-/pi-session-manager-1.0.5.tgz","fileCount":12,"integrity":"sha512-tc5l8urd2Em6tnGwMdr+t4kKs0ujczwug1TnX8lhegODrZJ+xd2C4vKOvGcvVipcRfdEvg3mZjmav5W0ZCkMKg==","signatures":[{"sig":"MEUCIHEDd0SROtkNbPti+YsZ4Ok+wgg+ZMjGEK3ANB7QxQjFAiEA67GIT+GPeufGJD2nbjQ4+zUxrs1qxPQWI836p5/gc+E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3189381},"type":"module","private":false,"_npmUser":{"name":"codebreaker10","email":"louisshelton0@gmail.com"},"repository":{"url":"https://github.com/louiss0/pi-packages","type":"git","directory":"pi-session-manager"},"description":"Pi package scaffold for pi-session-manager","directories":{},"_nodeVersion":"24.15.0","dependencies":{"valibot":"^1.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"latest","typescript":"latest"},"peerDependencies":{"@earendil-works/pi-tui":"*","@earendil-works/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-session-manager_1.0.5_1783472332808_0.9094196770610945","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@code-fixer-23/pi-session-manager","version":"1.0.6","keywords":["pi-package"],"license":"MIT","_id":"@code-fixer-23/pi-session-manager@1.0.6","maintainers":[{"name":"codebreaker10","email":"louisshelton0@gmail.com"}],"homepage":"https://github.com/louiss0/pi-packages","bugs":{"url":"https://github.com/louiss0/pi-packages/issues"},"pi":{"image":"https://raw.githubusercontent.com/louiss0/pi-packages/main/pi-session-manager/assets/Pi-Session-Manager-Small.png","extensions":["extensions","extensions/!*.test.ts"]},"dist":{"shasum":"0852b05015577a1772433a0b4e717808519765dd","tarball":"https://registry.npmjs.org/@code-fixer-23/pi-session-manager/-/pi-session-manager-1.0.6.tgz","fileCount":12,"integrity":"sha512-Ur0iRC+2uC9VoNeKMHVaHkMBBBfjxz3niQNaTcad/8z9/TTlo16jHbK+ffEH8E1uJGkYkQlEgneemcmpYqE5sA==","signatures":[{"sig":"MEUCIGTggEDJlfuAYNCGIRnEWJ6nxVepFmstvz0VNcPsfpXiAiEA2pqDXQ6kizZU+keJZT/chowHJCO6X7kM1r14dLrNqhY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3190804},"type":"module","private":false,"_npmUser":{"name":"codebreaker10","email":"louisshelton0@gmail.com"},"repository":{"url":"https://github.com/louiss0/pi-packages","type":"git","directory":"pi-session-manager"},"description":"Pi package scaffold for pi-session-manager","directories":{},"_nodeVersion":"24.15.0","dependencies":{"valibot":"^1.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"latest","typescript":"latest"},"peerDependencies":{"@earendil-works/pi-tui":"*","@earendil-works/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-session-manager_1.0.6_1784250696873_0.7000215657713196","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@code-fixer-23/pi-session-manager","type":"module","version":"1.1.0","keywords":["pi-package"],"devDependencies":{"typescript":"~6.0.3","vitest":"latest"},"private":false,"publishConfig":{"access":"public"},"license":"MIT","description":"Pi package scaffold for pi-session-manager","repository":{"type":"git","url":"https://github.com/louiss0/pi-packages","directory":"pi-session-manager"},"homepage":"https://github.com/louiss0/pi-packages","bugs":{"url":"https://github.com/louiss0/pi-packages/issues"},"dependencies":{"@juanibiapina/pi-extension-settings":"^0.9.1","valibot":"^1.4"},"peerDependencies":{"@earendil-works/pi-coding-agent":"*","@earendil-works/pi-tui":"*"},"pi":{"extensions":["extensions","extensions/!*.test.ts"],"image":"https://raw.githubusercontent.com/louiss0/pi-packages/main/pi-session-manager/assets/Pi-Session-Manager-Small.png"},"_nodeVersion":"26.7.0","_id":"@code-fixer-23/pi-session-manager@1.1.0","dist":{"integrity":"sha512-laM/saxYgJAbC9sExbut3kNV53piMKRlzApuQr+pFtzsubSbjioQtu5JU08Tj1R+b/xU76bBjRqmIeHa0EOh/w==","shasum":"a4be32025e3bd2acaab3b9666d13c812a1c90742","tarball":"https://registry.npmjs.org/@code-fixer-23/pi-session-manager/-/pi-session-manager-1.1.0.tgz","fileCount":13,"unpackedSize":3202623,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDkOgPIsUqLfm0DAOKBSu1dwQnsMbMAHEORDCTOYBEe9wIgWIAyOtZ1pmlWwLAasvJuh3lqgZyNtZ3N2Xvo23VKNBM="}]},"_npmUser":{"name":"codebreaker10","email":"louisshelton0@gmail.com"},"directories":{},"maintainers":[{"name":"codebreaker10","email":"louisshelton0@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pi-session-manager_1.1.0_1787508049541_0.6598595361767181"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-02T23:07:49.070Z","modified":"2026-08-23T18:00:50.535Z","1.0.0":"2026-07-02T23:07:49.438Z","1.0.1":"2026-07-03T18:55:07.891Z","1.0.2":"2026-07-03T18:59:28.149Z","1.0.3":"2026-07-03T21:04:12.188Z","1.0.4":"2026-07-04T19:25:14.297Z","1.0.5":"2026-07-08T00:58:53.066Z","1.0.6":"2026-07-17T01:11:37.073Z","1.1.0":"2026-08-23T18:00:49.807Z"},"bugs":{"url":"https://github.com/louiss0/pi-packages/issues"},"license":"MIT","homepage":"https://github.com/louiss0/pi-packages","keywords":["pi-package"],"repository":{"type":"git","url":"https://github.com/louiss0/pi-packages","directory":"pi-session-manager"},"description":"Pi package scaffold for pi-session-manager","maintainers":[{"name":"codebreaker10","email":"louisshelton0@gmail.com"}],"readme":"# pi-session-manager\r\n\r\n![Session Manager](https://raw.githubusercontent.com/louiss0/pi-packages/main/pi-session-manager/assets/Pi-Session_Manager-Big.png)\r\n\r\n\r\n[![npm version](https://img.shields.io/npm/v/@code-fixer-23/pi-session-manager.svg)](https://www.npmjs.com/package/@code-fixer-23/pi-session-manager)\r\n[![downloads](https://img.shields.io/npm/dm/@code-fixer-23/pi-session-manager.svg)](https://www.npmjs.com/package/@code-fixer-23/pi-session-manager)\r\n[![license](https://img.shields.io/npm/l/@code-fixer-23/pi-session-manager.svg)](./LICENSE)\r\n[![CI](https://github.com/louiss0/pi-packages/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/louiss0/pi-packages/actions/workflows/ci.yml)\r\n\r\n\r\n`pi-session-manager` adds local session cleanup and series management workflows to PI. It helps keep session history organized by pruning stale sessions stored on your machine, naming related sessions consistently, and carrying series context forward between sessions. The package plugs into PI's extension lifecycle so it can react when a session starts, restore persisted series metadata, and expose commands that coordinate session creation, continuation, and cleanup.\r\n\r\n## pi-session-manager\r\n\r\nThis package ships a single PI extension in `extensions/index.ts`, supported by a small test suite and a helper script for scaffolding additional extension entry points.\r\n\r\n### Behavior overview\r\n\r\nThe extension centers on two workflows:\r\n\r\n1. **Session cleanup** — it can remove inactive local sessions automatically on startup or manually through commands.\r\n2. **Session series management** — it records related sessions under a shared series name, preserves that context across session restarts, and lets you continue or extend a series later.\r\n\r\nOn session start, the extension first restores any persisted series data from the temp directory so PI can resume the correct session name and custom entry. When the session starts normally or after a reload, it also loads the package config, checks the cleanup rules, and removes stale local sessions if they exceed the configured age limit.\r\n\r\nIf you want a session gone, delete it through the package commands instead of editing the config by hand. The config is an internal coordination file, not a user-edit surface.\r\n\r\n> Warning: do not edit the extension's stored settings directly. If you need to remove a series, use `session-manager:series delete` and let the package update its own state.\r\n\r\n### Commands\r\n\r\nAll commands live under the `session-manager` namespace. Every cleanup command that works on the current project has an `:all` twin that works on **every** session in the sessions area (`~/.pi/agent/sessions/`), no matter which project it belongs to. After any deletion, you are shown the list of deleted sessions grouped and sorted by project name.\r\n\r\n#### `session-manager:clean:inactive`\r\nDeletes local sessions that have been inactive longer than the configured day limit. This command reads the day limit from the shared extension settings, so the cleanup window matches the same rule used during startup cleanup. Use this when you want PI to resume with a clean local session set without manually touching files.\r\n\r\n#### `session-manager:clean:inactive:all`\r\nThe same inactivity rule as `session-manager:clean:inactive`, but applied to every session stored in the sessions area across all projects. This is the tool for pruning outdated sessions from projects you no longer work in.\r\n\r\n#### `session-manager:clean:older-than <duration>`\r\nDeletes local sessions older than a specific duration. The argument accepts either full units like `5days`, `2weeks`, `12hours` or shorthand forms like `5d`, `2w`, `12h`. This is useful when you want to remove sessions using an ad hoc retention threshold instead of the saved day limit.\r\n\r\n#### `session-manager:clean:older-than:all <duration>`\r\nThe same duration rule as `session-manager:clean:older-than`, but applied to all sessions in the sessions area across every project.\r\n\r\n#### `session-manager:delete-last <count>`\r\nDeletes the most recent N local sessions. The argument is an integer from 1 to 10, which makes it a quick recovery tool for removing only the newest session files when you want to clean up by hand.\r\n\r\n#### `session-manager:delete-last:all <count>`\r\nDeletes the most recent N sessions across every project in the sessions area. Like the local variant, the count is an integer from 1 to 10. A completion hint labels each option as \"last N in every project\" so it is easy to tell apart from the project-scoped command.\r\n\r\n#### `session-manager:series <action>`\r\nCoordinates the session-series lifecycle. The available actions are:\r\n\r\n- `create` — create a new series and a first session inside it, then persist the resulting session metadata so PI can restore the series context later.\r\n- `new` — add a new session to an existing series and keep the series record updated.\r\n- `continue` — inspect the currently active session entry, recover its series, and start the next session in that same chain.\r\n- `delete` — remove a series and all local session files whose names start with that series prefix. This is the safest way to remove a series; avoid editing the config file directly.\r\n\r\n### Deleted session report\r\nEvery manual cleanup command (local and `:all`) finishes by presenting what was removed. Sessions are sorted by project name — derived from the deepest folder segment of each session's working directory — then by modified time inside each project, and rendered as a grouped listing:\r\n\r\n```\r\nRemoved 3 session(s):\r\nproject-a\r\n  Refactor Auth--Create JWT Token\r\nproject-b\r\n  Fix Memory Leak--Patch Heap Snapshot\r\n  UI Migration--Move Button Component\r\n```\r\n\r\n### Features\r\n\r\n#### Startup lifecycle coordination\r\nThe extension listens to PI session startup and reload events to restore persisted session-series data before the rest of the session flow continues. That lets PI reopen the correct session name and custom entry even after a new process starts.\r\n\r\n#### Persistent session-series state\r\nWhen a series session is created, the extension writes a small temp file in the OS temp directory. On the next session start, it consumes that file, applies the stored session name and entry, and then removes the temp file so the state only applies once.\r\n\r\n#### Configured cleanup rules\r\nSettings are persisted through [@juanibiapina/pi-extension-settings](https://www.npmjs.com/package/@juanibiapina/pi-extension-settings). The `Session Deletion Day Limit` setting controls the automatic inactivity cleanup threshold and can be changed from PI with the `/extension-settings` command (default: 3 days). The series/title structure per working directory is remembered in the same store under the `pi-session-manager` extension name.\r\n\r\nTreat these stored values as internal state. Do not edit them manually unless you are debugging the package itself. If you need to remove a series, use `session-manager:series delete` instead of changing the stored settings.\r\n\r\nThe package is designed to work with local session files only, so it should never be treated as a remote or shared-session cleanup tool.\r\n\r\n### Developer notes\r\n\r\n- Package metadata lives in `package.json` and identifies this as a PI extension package.\r\n- The implementation is in `extensions/index.ts`.\r\n- Tests live alongside the extension in `extensions/index.test.ts`.\r\n- `scripts/create-extension.ts` is a small helper for scaffolding a new extension file under `extensions/`.\r\n\r\n### Assets in this repository\r\n\r\n- `extensions/` — extension implementation and tests\r\n- `scripts/` — helper script for creating new extension files\r\n- No `prompts/`, `skills/`, or `themes/` directories are present in this package\r\n","readmeFilename":""}