@pithosai/pithosai 1.0.3 → 1.0.5

package/README.md

@@ -1,6 +1,17 @@
 # Pithosai (`@pithosai/pithosai`)
 
-**Multi-role AI CLI** for coding and product work: natural-language requests, pluggable models (Cursor, DeepSeek, OpenRouter), and role-based prompts stored in SQLite. See [CHANGELOG.md](CHANGELOG.md) for release history.
+**Multi-role AI CLI** for coding and product work: natural-language requests, pluggable models (Cursor, DeepSeek, OpenRouter), and role-based prompts stored in SQLite.
+
+---
+
+## What's New in v1.0.5 (Customer Security View)
+
+- **Encrypted storage upgrade for existing users:** Legacy plaintext `pithosai.db` data is upgraded to encrypted storage on first open when encryption support is available.
+- **Device-tied protection:** Database protection is tied to your machine, reducing the risk of copied files being opened elsewhere.
+- **Safer release logging defaults:** Packaged releases now default to `INFO` logging to reduce unnecessary verbose output in normal usage.
+- **Controlled Markdown terminal output:** `render-markdown` now supports pager-based scrolling by default, with explicit `--show-all` when full direct terminal output is desired.
+
+See the database notes below for migration behavior and security details.
 
 ---
 
@@ -20,11 +31,11 @@ On a **global** install, the package runs a one-time step: if `~/.pithosai/pitho
 
 | You run | Purpose |
 |--------|---------|
-| `pithosai` | Main CLI: `init`, interactive agent, `task`, `heartbeat`, `skills`, `memorize`, and more. |
+| `pithosai` | Main CLI: `init`, `migrate-db`, interactive agent, `task`, `heartbeat`, `skills`, `memorize`, and more. |
 | `rdsai`, `pmsai`, `qasai`, `cosai`, `mktai`, `wrsai` | Same CLI with a **default role** (e.g. RD, PM, QA). |
 | `email-monitor` | Heartbeat / email-driven task loop (`heartbeat` bundle). |
 | `render-markdown` | Render Markdown files in the terminal. |
-| `pithosai-init-db` | Manually initialize `~/.pithosai/pithosai.db` if needed (usually automatic after global install). |
+| `init` | Manually initialize `~/.pithosai/pithosai.db` if needed (usually automatic after global install). |
 
 ---
 
@@ -32,7 +43,11 @@ On a **global** install, the package runs a one-time step: if `~/.pithosai/pitho
 
 Configure **at least one** of:
 
-1. **Cursor CLI** (recommended — subscription auth, no separate API key)  
+1. **DeepSeek** — `export DEEPSEEK_API_KEY=sk-...`
+
+2. **OpenRouter** — `export OPENROUTER_API_KEY=sk-or-...`
+
+3. **Cursor CLI** (last resort)  
    ```bash
    curl https://cursor.com/install -fsS | bash
    cursor-agent login
@@ -40,11 +55,7 @@ Configure **at least one** of:
    ```
    Use **`pithosai "your request" --cursor`** or set `CURSOR_MODEL`.
 
-2. **DeepSeek** — `export DEEPSEEK_API_KEY=sk-...`
-
-3. **OpenRouter** — `export OPENROUTER_API_KEY=sk-or-...`
-
-**Precedence:** `CURSOR_MODEL` / `--cursor` → DeepSeek → OpenRouter.
+**Precedence:** DeepSeek → OpenRouter → `CURSOR_MODEL` / `--cursor`.
 
 ---
 
@@ -59,8 +70,45 @@ pithosai "Describe what you want done"
 - **`pithosai -i`** — interactive session with no initial prompt.  
 - **`pithosai --no-interactive "…"`** — one shot, then exit.  
 - **`pithosai -C ./other-dir "…"`** — use another project directory.
+- Every CLI invocation prints a cyan ASCII `pithosai` slogan banner first.
+
+Prompts load from a local database (default `~/.pithosai/pithosai.db`). Optional role overrides live under `.pithosai/<role>/` in your project.
+
+### Language selection
 
-Prompts load from the **local SQLite database** (default `~/.pithosai/pithosai.db`). Optional overrides live under `.pithosai/<role>/` in your project.
+- Default language is **English (`en`)**.
+- Set language per command with `--lang`.
+- Or export `LANG` in your shell to set terminal locale preference.
+
+Examples:
+
+```bash
+pithosai --lang zh "请解释这个错误"
+```
+
+```bash
+export LANG=ja_JP.UTF-8
+pithosai "今日のタスクを要約してください"
+```
+
+Supported language codes:
+- `en` (English)
+- `ar` (Arabic)
+- `de` (German)
+- `es` (Spanish)
+- `fr` (French)
+- `it` (Italian)
+- `ja` (Japanese)
+- `ko` (Korean)
+- `nl` (Dutch)
+- `pt` (Portuguese)
+- `zh` (Simplified Chinese)
+- `zh-hant` (Traditional Chinese)
+
+### Upgrading from v1.0.4 (plaintext `pithosai.db`)
+
+- **Automatic:** After upgrading to **1.0.5+**, plaintext databases are migrated in place to encrypted storage on first open when encryption support is available.
+- **Manual (optional):** You can run `pithosai migrate-db` if you want to trigger migration directly.
 
 ---
 
@@ -77,7 +125,7 @@ pithosai --mode dialog "Explain this error"
 pithosai --mode plan "Outline the next sprint"
 ```
 
-Result previews (terminal or optional Chrome via Playwright) can be tuned with `PITHOSAI_SKIP_RESULT_BROWSER`, `PITHOSAI_RESULT_BROWSER`, and `PITHOSAI_PLAYWRIGHT_CHANNEL`. For a full write-up, see **`docs/Configuration.md`** in the project source tree (not shipped on npm).
+Result previews (terminal or optional Chrome via Playwright) can be tuned with `PITHOSAI_SKIP_RESULT_BROWSER`, `PITHOSAI_RESULT_BROWSER`, and `PITHOSAI_PLAYWRIGHT_CHANNEL`.
 
 ---
 
@@ -86,12 +134,12 @@ Result previews (terminal or optional Chrome via Playwright) can be tuned with `
 | Command | What it does |
 |---------|----------------|
 | `pithosai init [dir]` | Scaffold project, `.pithosai/sessions/`, settings. |
+| `pithosai migrate-db` | Convert a legacy plaintext global DB to SQLCipher (optional; usually automatic on first open). |
 | `pithosai add-role <role>` | Add a role to the project. |
 | `pithosai task --file <md>` | Watch a task file and run tasks sequentially. |
 | `pithosai memorize --start … --end … -r <role>` | Build `.pithosai/<role>/memory.md` from stored tasks. |
 | `pithosai heartbeat` / `heartbeat --once` | Email-driven task pipeline (needs IMAP/SMTP in settings). |
-| `pithosai skills …` | Install / list / remove skills (see repo docs). |
-| `pithosai show-prompt` | Print or preview the system prompt for debugging. |
+| `pithosai skills …` | Install / list / remove skills. |
 | `pithosai shell "cmd"` | Run a shell command via the CLI. |
 
 Use **`pithosai --help`** and **`pithosai <command> --help`** for flags (`--timeout`, `--lang`, `--role`, `--log-path`, etc.).
@@ -104,7 +152,7 @@ In a normal terminal, the default UI uses a **full-screen TUI** (bottom input, s
 
 ---
 
-## Environment variables (essentials)
+## Environment variables
 
 | Variable | Role |
 |----------|------|
@@ -116,21 +164,11 @@ In a normal terminal, the default UI uses a **full-screen TUI** (bottom input, s
 | `PITHOSAI_TIMEOUT_MS` / `--timeout` | Run time limits |
 | `SCRAPERAPI_API_KEY` | Used by skills / some tools |
 
-A longer list (history limits, security hooks, debug) is documented in **`docs/Configuration.md`** in the project source tree.
-
 ---
 
-## Documentation and source
-
-The **npm package** contains the built CLI and runtime assets (not the full `docs/` tree). [CHANGELOG.md](CHANGELOG.md) ships with the package.
-
-Extended Markdown guides live under **`docs/`** in a **full checkout** of the project (clone or archive), for example:
+## Help and support
 
-- `docs/ARCHITECTURE.md`
-- `docs/Configuration.md`
-- `docs/TROUBLESHOOTING.md`
-- `docs/SKILLS-CLI.md`
-- `docs/SHELL-CLI.md`
+Use `pithosai --help` for top-level options, and `pithosai <command> --help` for command-specific details.
 
 ---
 

package/dist/336.mjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export const __rspack_esm_id="336";export const __rspack_esm_ids=["336"];export const __webpack_modules__={5627(_){_.exports=import("@journeyapps/sqlcipher").then(function(_){return _})}};

package/dist/935.mjs

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-export const __rspack_esm_id="935";export const __rspack_esm_ids=["935"];export const __webpack_modules__={8498(t,e,i){i.a(t,async function(t,s){try{i.d(e,{showMarkdownInPiTui:()=>a});var l=i(8691),r=i(8285),n=i(4127),h=t([l,r,n]);[l,r,n]=h.then?(await h)():h;let o=!1;class c{constructor(t){let{terminal:e,tui:i,markdown:s,hintText:l,documentTitle:r,onClose:n}=t;this.terminal=e,this.tui=i,this._markdown=s,this.hintText=l,this.documentTitle=r?.trim()||"",this.onClose=n,this.scrollTop=0,this._fullLines=null,this._cachedWidth=null,this._ggAwaitingSecondG=!1,this._ggTimer=null}clearGgPrefixState(){null!=this._ggTimer&&(clearTimeout(this._ggTimer),this._ggTimer=null),this._ggAwaitingSecondG=!1}invalidate(){this._markdown.invalidate(),this._fullLines=null,this._cachedWidth=null}handleInput(t){let e=this.terminal.columns,i=this.terminal.rows,s=+!!this.documentTitle,l=Math.max(1,i-s-1),r=this._getFullLines(e).length,h=Math.max(0,r-l);if((0,n.matchesKey)(t,"escape")||(0,n.matchesKey)(t,"esc")||(0,n.matchesKey)(t,"q")||(0,n.matchesKey)(t,"shift+q")||(0,n.matchesKey)(t,"ctrl+c")){this.clearGgPrefixState(),this.onClose();return}if((0,n.matchesKey)(t,"shift+g")){this.clearGgPrefixState(),this.scrollTop=h;return}if((0,n.matchesKey)(t,"g")){if(this._ggAwaitingSecondG){this.clearGgPrefixState(),this.scrollTop=0;return}this._ggAwaitingSecondG=!0,null!=this._ggTimer&&clearTimeout(this._ggTimer),this._ggTimer=setTimeout(()=>{this._ggTimer=null,this._ggAwaitingSecondG=!1},500);return}if(this.clearGgPrefixState(),(0,n.matchesKey)(t,"up")||(0,n.matchesKey)(t,"k")){this.scrollTop=Math.max(0,this.scrollTop-1);return}if((0,n.matchesKey)(t,"down")||(0,n.matchesKey)(t,"j")){this.scrollTop=Math.min(h,this.scrollTop+1);return}if((0,n.matchesKey)(t,"pageUp")||(0,n.matchesKey)(t,"ctrl+u")){this.scrollTop=Math.max(0,this.scrollTop-l);return}if((0,n.matchesKey)(t,"pageDown")||(0,n.matchesKey)(t,"ctrl+d")){this.scrollTop=Math.min(h,this.scrollTop+l);return}if((0,n.matchesKey)(t,"home")){this.scrollTop=0;return}if((0,n.matchesKey)(t,"end")){this.scrollTop=h;return}}_getFullLines(t){return this._fullLines&&this._cachedWidth===t||(this._cachedWidth=t,this._fullLines=this._markdown.render(t)),this._fullLines}render(t){let e=this.terminal.rows,i=this.documentTitle?[l.m.bold.cyan((0,n.truncateToWidth)(this.documentTitle,t))]:[],s=i.length,r=Math.max(1,e-s-1);null!=this._cachedWidth&&this._cachedWidth!==t&&this.invalidate();let h=this._getFullLines(t),a=Math.max(0,h.length-r);this.scrollTop=Math.min(this.scrollTop,a);let o=h.slice(this.scrollTop,this.scrollTop+r);for(;o.length<r;)o.push("");let c=l.m.dim((0,n.truncateToWidth)(this.hintText,t));return[...i,...o,c]}}async function a(t){let{markdown:e,t:i,documentTitle:s,tuiSession:l=null}=t;if(!e||"string"!=typeof e||!e.trim())return;if(!(process.stdout.isTTY&&process.stdin.isTTY))return void process.stdout.write(`${e}
-`);let h=l&&"function"==typeof l.suspendForReadline&&"function"==typeof l.resumeFromReadline;h&&l.suspendForReadline();try{o||((0,r.CK)("dark"),o=!0);let t=(0,r.pd)(),l=new n.Markdown(e,1,1,t),h=i("cli.resultPreviewTerminalHint"),a=new n.ProcessTerminal,m=new n.TUI(a);m.setClearOnShrink(!0),await new Promise(t=>{let e,i=new c({terminal:a,tui:m,markdown:l,hintText:h,documentTitle:s,onClose:()=>{e?.clearGgPrefixState(),m.stop(),t()}});e=i;let r=new n.Container;r.addChild(i),m.addChild(r),m.setFocus(i),m.start(),m.requestRender(!0)})}finally{h&&l.resumeFromReadline()}}s()}catch(t){s(t)}})}};
+export const __rspack_esm_id="935";export const __rspack_esm_ids=["935"];export const __webpack_modules__={8498(t,e,i){i.a(t,async function(t,s){try{i.d(e,{showMarkdownInPiTui:()=>a});var l=i(8691),r=i(2421),n=i(4127),h=t([l,r,n]);[l,r,n]=h.then?(await h)():h;let o=!1;class c{constructor(t){let{terminal:e,tui:i,markdown:s,hintText:l,documentTitle:r,onClose:n}=t;this.terminal=e,this.tui=i,this._markdown=s,this.hintText=l,this.documentTitle=r?.trim()||"",this.onClose=n,this.scrollTop=0,this._fullLines=null,this._cachedWidth=null,this._ggAwaitingSecondG=!1,this._ggTimer=null}clearGgPrefixState(){null!=this._ggTimer&&(clearTimeout(this._ggTimer),this._ggTimer=null),this._ggAwaitingSecondG=!1}invalidate(){this._markdown.invalidate(),this._fullLines=null,this._cachedWidth=null}handleInput(t){let e=this.terminal.columns,i=this.terminal.rows,s=+!!this.documentTitle,l=Math.max(1,i-s-1),r=this._getFullLines(e).length,h=Math.max(0,r-l);if((0,n.matchesKey)(t,"escape")||(0,n.matchesKey)(t,"esc")||(0,n.matchesKey)(t,"q")||(0,n.matchesKey)(t,"shift+q")||(0,n.matchesKey)(t,"ctrl+c")){this.clearGgPrefixState(),this.onClose();return}if((0,n.matchesKey)(t,"shift+g")){this.clearGgPrefixState(),this.scrollTop=h;return}if((0,n.matchesKey)(t,"g")){if(this._ggAwaitingSecondG){this.clearGgPrefixState(),this.scrollTop=0;return}this._ggAwaitingSecondG=!0,null!=this._ggTimer&&clearTimeout(this._ggTimer),this._ggTimer=setTimeout(()=>{this._ggTimer=null,this._ggAwaitingSecondG=!1},500);return}if(this.clearGgPrefixState(),(0,n.matchesKey)(t,"up")||(0,n.matchesKey)(t,"k")){this.scrollTop=Math.max(0,this.scrollTop-1);return}if((0,n.matchesKey)(t,"down")||(0,n.matchesKey)(t,"j")){this.scrollTop=Math.min(h,this.scrollTop+1);return}if((0,n.matchesKey)(t,"pageUp")||(0,n.matchesKey)(t,"ctrl+u")){this.scrollTop=Math.max(0,this.scrollTop-l);return}if((0,n.matchesKey)(t,"pageDown")||(0,n.matchesKey)(t,"ctrl+d")){this.scrollTop=Math.min(h,this.scrollTop+l);return}if((0,n.matchesKey)(t,"home")){this.scrollTop=0;return}if((0,n.matchesKey)(t,"end")){this.scrollTop=h;return}}_getFullLines(t){return this._fullLines&&this._cachedWidth===t||(this._cachedWidth=t,this._fullLines=this._markdown.render(t)),this._fullLines}render(t){let e=this.terminal.rows,i=this.documentTitle?[l.m.bold.cyan((0,n.truncateToWidth)(this.documentTitle,t))]:[],s=i.length,r=Math.max(1,e-s-1);null!=this._cachedWidth&&this._cachedWidth!==t&&this.invalidate();let h=this._getFullLines(t),a=Math.max(0,h.length-r);this.scrollTop=Math.min(this.scrollTop,a);let o=h.slice(this.scrollTop,this.scrollTop+r);for(;o.length<r;)o.push("");let c=l.m.dim((0,n.truncateToWidth)(this.hintText,t));return[...i,...o,c]}}async function a(t){let{markdown:e,t:i,documentTitle:s,tuiSession:l=null}=t;if(!e||"string"!=typeof e||!e.trim())return;if(!(process.stdout.isTTY&&process.stdin.isTTY))return void process.stdout.write(`${e}
+`);let h=l&&"function"==typeof l.suspendForReadline&&"function"==typeof l.resumeFromReadline;h&&l.suspendForReadline();try{o||((0,r.initTheme)("dark"),o=!0);let t=(0,r.getMarkdownTheme)(),l=new n.Markdown(e,1,1,t),h=i("cli.resultPreviewTerminalHint"),a=new n.ProcessTerminal,m=new n.TUI(a);m.setClearOnShrink(!0),await new Promise(t=>{let e,i=new c({terminal:a,tui:m,markdown:l,hintText:h,documentTitle:s,onClose:()=>{e?.clearGgPrefixState(),m.stop(),t()}});e=i;let r=new n.Container;r.addChild(i),m.addChild(r),m.setFocus(i),m.start(),m.requestRender(!0)})}finally{h&&l.resumeFromReadline()}}s()}catch(t){s(t)}})}};