shiva-code 0.7.3 → 0.7.5

package/README.md

@@ -0,0 +1,211 @@
+# SHIVA Code CLI
+
+> Makes Claude Code Persistent - Cross-Project Memory for AI Coding
+
+[![npm version](https://badge.fury.io/js/shiva-code.svg)](https://www.npmjs.com/package/shiva-code)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- **Persistent Memory** - Memories survive across sessions and projects
+- **Cloud Sync** - Sync your data between devices
+- **Project Packages** - Launch multiple projects at once
+- **Secure Secrets** - Encrypted secret storage with vault
+- **Docker Support** - Isolated development environments
+- **GitHub Integration** - Issues, PRs, and context at your fingertips
+- **Session Management** - Resume, restore, and organize sessions
+
+## Installation
+
+### Native Binary (Recommended)
+
+```bash
+curl -fsSL https://shiva.li/install | bash
+```
+
+### npm
+
+```bash
+npm install -g shiva-code
+```
+
+### From Source
+
+```bash
+git clone https://github.com/Aimtaim/shiva-code.git
+cd shiva-code
+npm install
+npm run build
+npm link
+```
+
+## Quick Start
+
+```bash
+# Initialize project
+cd your-project
+shiva init
+
+# Save a memory
+shiva remember "User prefers TypeScript" --category preference
+
+# Search memories
+shiva search "typescript"
+
+# Start Claude with context
+claude
+```
+
+## Commands
+
+### Session Management
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `shiva sessions` | `ss` | List all Claude sessions |
+| `shiva resume` | `res` | Resume a session |
+| `shiva restore` | `rst` | Restore a crashed session |
+| `shiva start` | `st` | Start multiple projects |
+
+### Memory & Context
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `shiva remember` | `rem`, `r` | Save a memory |
+| `shiva search` | `s`, `find` | Search memories |
+| `shiva forget` | `fg` | Delete a memory |
+| `shiva context` | - | Show current context |
+| `shiva tags` | - | Manage session tags |
+| `shiva export` | - | Export sessions |
+| `shiva import` | - | Import sessions |
+
+### Project Management
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `shiva init` | `i` | Initialize a project |
+| `shiva sync` | `sy` | Sync with cloud |
+| `shiva status` | `stat` | Show project status |
+| `shiva projects` | `proj`, `p` | List all projects |
+| `shiva config` | `cfg` | Manage settings |
+
+### GitHub Integration
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `shiva github` | `gh` | GitHub status/login |
+| `shiva issues` | `iss` | Show GitHub issues |
+| `shiva prs` | `pr` | Show pull requests |
+
+### Security
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `shiva secrets` | `sec` | Manage secrets |
+| `shiva scan` | `sc` | Security scan |
+
+### Advanced
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `shiva package` | `pkg` | Manage project packages |
+| `shiva docker` | `dk` | Docker mode |
+| `shiva sandbox` | `sb` | Sandbox mode |
+| `shiva workflow` | `wf` | Manage workflows |
+| `shiva hook` | `hk` | Manage hooks |
+
+### System
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `shiva doctor` | `doc` | System check |
+| `shiva upgrade` | `up` | Update SHIVA |
+| `shiva stats` | - | Show analytics |
+| `shiva validate` | - | Validate configuration |
+
+## Debug Mode
+
+Enable debug mode for troubleshooting:
+
+```bash
+# Via flag
+shiva --debug status
+
+# Via environment variable
+SHIVA_DEBUG=1 shiva status
+```
+
+## Configuration
+
+SHIVA stores configuration in `~/.config/shiva-code/`:
+
+- `config.json` - Main configuration
+- `packages.json` - Package definitions
+- `secrets.json` - Encrypted secrets (local)
+
+Project-specific settings are stored in `.shiva/`:
+
+- `config.json` - Project configuration
+- `CLAUDE.md` - Claude context file
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `SHIVA_DEBUG` | Enable debug mode (`1` to enable) |
+| `SHIVA_API_URL` | Override API endpoint |
+| `SHIVA_TOKEN` | Authentication token |
+
+## CLAUDE.md Integration
+
+SHIVA automatically manages your `CLAUDE.md` file, which Claude Code uses for context. The file includes:
+
+- Project information
+- Saved memories
+- Tech stack details
+- Custom instructions
+
+## Documentation
+
+- [Getting Started](https://shiva.li/docs)
+- [Commands Reference](https://shiva.li/docs/commands)
+- [API Documentation](https://shiva.li/docs/api)
+- [FAQ](https://shiva.li/docs/faq)
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+
+# Type check
+npm run typecheck
+
+# Development mode (watch)
+npm run dev
+```
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details.
+
+## License
+
+MIT - see [LICENSE](LICENSE) for details.
+
+## Links
+
+- [Website](https://shiva.li)
+- [Documentation](https://shiva.li/docs)
+- [GitHub](https://github.com/Aimtaim/shiva-code)
+- [npm](https://www.npmjs.com/package/shiva-code)
+- [Report Issues](https://github.com/Aimtaim/shiva-code/issues)

package/dist/{chunk-QQZRCJZK.js → chunk-J5IS642F.js}

@@ -3,6 +3,29 @@ import {
   getToken
 } from "./chunk-OP4HYQZZ.js";
 
+// src/utils/debug.ts
+var debugEnabled = false;
+function isDebugEnabled() {
+  return debugEnabled || process.env.SHIVA_DEBUG === "1";
+}
+function enableDebug() {
+  debugEnabled = true;
+}
+function debug(message, data) {
+  if (!isDebugEnabled()) return;
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  console.error(`[DEBUG ${timestamp}] ${message}`);
+  if (data !== void 0) {
+    console.error(JSON.stringify(data, null, 2));
+  }
+}
+function debugApi(method, url, status, duration) {
+  if (!isDebugEnabled()) return;
+  const statusStr = status ? ` -> ${status}` : "";
+  const durationStr = duration ? ` (${duration}ms)` : "";
+  debug(`API: ${method} ${url}${statusStr}${durationStr}`);
+}
+
 // src/services/api/client.ts
 var ApiClient = class {
   getHeaders() {
@@ -18,6 +41,8 @@ var ApiClient = class {
   async request(endpoint, options = {}) {
     const baseUrl = getApiEndpoint();
     const url = `${baseUrl}${endpoint}`;
+    const method = options.method || "GET";
+    const startTime = Date.now();
     const response = await fetch(url, {
       ...options,
       headers: {
@@ -25,6 +50,8 @@ var ApiClient = class {
         ...options.headers
       }
     });
+    const duration = Date.now() - startTime;
+    debugApi(method, endpoint, response.status, duration);
     if (!response.ok) {
       const error = await response.json().catch(() => ({ error: "Unknown error" }));
       throw new Error(error.error || error.message || `HTTP ${response.status}`);
@@ -799,5 +826,6 @@ var ApiClient = class {
 var api = new ApiClient();
 
 export {
+  enableDebug,
   api
 };

package/dist/{chunk-LBTCSQAX.js → chunk-KUA6TMQJ.js}

@@ -1,7 +1,7 @@
 import {
   findProject,
   getProjectName
-} from "./chunk-H5OFO4VS.js";
+} from "./chunk-W3DKHCXB.js";
 
 // src/services/data/package-manager.ts
 import Conf from "conf";

package/dist/{chunk-UZKDLLPA.js → chunk-KW3LP3K3.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-Z6NXFC4Q.js";
 import {
   api
-} from "./chunk-QQZRCJZK.js";
+} from "./chunk-J5IS642F.js";
 import {
   clearAuth,
   getConfig,

package/dist/{chunk-UAP4ZKEJ.js → chunk-RQ75X32M.js}

@@ -1589,7 +1589,7 @@ hookCommand.command("branch-switch").description("Branch-Wechsel behandeln (f\xF
   }
   const { getCurrentBranch } = await import("./api-OEHQTBH7.js");
   const { getSessionForBranch, hasShivaDir: hasShivaDir2 } = await import("./config-D6M6LI6U.js");
-  const { findProject, findSessionByBranch, formatRelativeTime } = await import("./manager-ZPQWG7E6.js");
+  const { findProject, findSessionByBranch, formatRelativeTime } = await import("./manager-CCRAV6A5.js");
   const projectPath = process.cwd();
   const newBranch = getCurrentBranch(projectPath);
   let sessionInfo = null;
@@ -1659,7 +1659,7 @@ hookCommand.command("scan-command").description("Scanne Bash-Befehle auf Package
   }
 });
 hookCommand.command("push").description("Hooks in Cloud sichern").action(async () => {
-  const { api } = await import("./client-GIGZFXT5.js");
+  const { api } = await import("./client-RPSJP4Z5.js");
   const { isAuthenticated } = await import("./config-FGMZONWV.js");
   if (!isAuthenticated()) {
     log.error("Nicht angemeldet");
@@ -1679,7 +1679,7 @@ hookCommand.command("push").description("Hooks in Cloud sichern").action(async (
   }
 });
 hookCommand.command("pull").description("Hooks aus Cloud laden").option("-f, --force", "Lokale Hooks \xFCberschreiben").action(async (options) => {
-  const { api } = await import("./client-GIGZFXT5.js");
+  const { api } = await import("./client-RPSJP4Z5.js");
   const { isAuthenticated } = await import("./config-FGMZONWV.js");
   if (!isAuthenticated()) {
     log.error("Nicht angemeldet");
@@ -1711,7 +1711,7 @@ hookCommand.command("pull").description("Hooks aus Cloud laden").option("-f, --f
   }
 });
 hookCommand.command("sync").description("Hooks mit Cloud synchronisieren").action(async () => {
-  const { api } = await import("./client-GIGZFXT5.js");
+  const { api } = await import("./client-RPSJP4Z5.js");
   const { isAuthenticated } = await import("./config-FGMZONWV.js");
   if (!isAuthenticated()) {
     log.error("Nicht angemeldet");
@@ -1738,7 +1738,7 @@ hookCommand.command("sync").description("Hooks mit Cloud synchronisieren").actio
   }
 });
 hookCommand.command("cloud-list").description("Cloud-Hooks auflisten").option("--event <type>", "Nach Event-Typ filtern").option("--json", "JSON Output").action(async (options) => {
-  const { api } = await import("./client-GIGZFXT5.js");
+  const { api } = await import("./client-RPSJP4Z5.js");
   const { isAuthenticated } = await import("./config-FGMZONWV.js");
   const { colors } = await import("./logger-E7SC5KUO.js");
   if (!isAuthenticated()) {
@@ -1787,7 +1787,7 @@ hookCommand.command("cloud-list").description("Cloud-Hooks auflisten").option("-
   }
 });
 hookCommand.command("cloud-create").description("Neuen Cloud-Hook erstellen").requiredOption("--event <event>", "Event-Typ (PreToolUse, PostToolUse, etc.)").requiredOption("--command <cmd>", "Auszuf\xFChrender Befehl").option("--matcher <pattern>", "Tool-Matcher Pattern").option("--type <type>", "Hook-Typ (command, script)", "command").option("--timeout <ms>", "Timeout in Millisekunden").action(async (options) => {
-  const { api } = await import("./client-GIGZFXT5.js");
+  const { api } = await import("./client-RPSJP4Z5.js");
   const { isAuthenticated } = await import("./config-FGMZONWV.js");
   if (!isAuthenticated()) {
     log.error("Nicht angemeldet");
@@ -1815,7 +1815,7 @@ hookCommand.command("cloud-create").description("Neuen Cloud-Hook erstellen").re
   }
 });
 hookCommand.command("cloud-test").description("Cloud-Hook testen").argument("<hook-id>", "Hook ID").action(async (hookId) => {
-  const { api } = await import("./client-GIGZFXT5.js");
+  const { api } = await import("./client-RPSJP4Z5.js");
   const { isAuthenticated } = await import("./config-FGMZONWV.js");
   const { colors } = await import("./logger-E7SC5KUO.js");
   if (!isAuthenticated()) {
@@ -1850,7 +1850,7 @@ hookCommand.command("cloud-test").description("Cloud-Hook testen").argument("<ho
   }
 });
 hookCommand.command("cloud-delete").description("Cloud-Hook l\xF6schen").argument("<hook-id>", "Hook ID").option("-y, --yes", "Ohne Best\xE4tigung").action(async (hookId, options) => {
-  const { api } = await import("./client-GIGZFXT5.js");
+  const { api } = await import("./client-RPSJP4Z5.js");
   const { isAuthenticated } = await import("./config-FGMZONWV.js");
   if (!isAuthenticated()) {
     log.error("Nicht angemeldet");
@@ -1885,7 +1885,7 @@ hookCommand.command("cloud-delete").description("Cloud-Hook l\xF6schen").argumen
   }
 });
 hookCommand.command("cloud-toggle").description("Cloud-Hook aktivieren/deaktivieren").argument("<hook-id>", "Hook ID").option("--enable", "Hook aktivieren").option("--disable", "Hook deaktivieren").action(async (hookId, options) => {
-  const { api } = await import("./client-GIGZFXT5.js");
+  const { api } = await import("./client-RPSJP4Z5.js");
   const { isAuthenticated } = await import("./config-FGMZONWV.js");
   if (!isAuthenticated()) {
     log.error("Nicht angemeldet");

package/dist/{chunk-H5OFO4VS.js → chunk-W3DKHCXB.js}

@@ -43,6 +43,10 @@ function isPathWithinAllowedBoundaries(inputPath) {
   ];
   return allowedPrefixes.some((prefix) => resolved.startsWith(prefix));
 }
+var SHELL_DANGEROUS_CHARS = /[;&|`$(){}[\]<>\\!#*?"'\n\r\t]/;
+function containsShellMetacharacters(input) {
+  return SHELL_DANGEROUS_CHARS.test(input);
+}
 function isValidSessionId(sessionId) {
   if (!sessionId || typeof sessionId !== "string") {
     return false;
@@ -402,6 +406,7 @@ function formatDate(date) {
 }
 
 export {
+  containsShellMetacharacters,
   isValidSessionId,
   isValidProjectPath,
   maskSecret,

package/dist/{client-GIGZFXT5.js → client-RPSJP4Z5.js}

@@ -1,6 +1,6 @@
 import {
   api
-} from "./chunk-QQZRCJZK.js";
+} from "./chunk-J5IS642F.js";
 import "./chunk-OP4HYQZZ.js";
 import "./chunk-3RG5ZIWI.js";
 export {

package/dist/{hook-SZAVQGEA.js → hook-GIK5RFRC.js}

@@ -1,6 +1,6 @@
 import {
   hookCommand
-} from "./chunk-UAP4ZKEJ.js";
+} from "./chunk-RQ75X32M.js";
 import "./chunk-Z6NXFC4Q.js";
 import "./chunk-IVFCZLBX.js";
 import "./chunk-PMA6MGQW.js";