bioscode 0.1.5

package/LICENSE

@@ -0,0 +1,306 @@
+PROPRIETARY SOFTWARE LICENSE WITH RESTRICTED USE
+================================================
+
+Copyright (c) 2025 Carlos Alexis Gomez Ruiz
+All Rights Reserved.
+
+--------------------------------------------------------------------------------
+1. OWNERSHIP AND COPYRIGHT
+--------------------------------------------------------------------------------
+
+This software and associated documentation files (the "Software") are the
+original creation and exclusive intellectual property of Carlos Alexis Gomez
+Ruiz (hereinafter "the Author"). All copyrights, patents, trade secrets,
+trademarks, and other intellectual property rights in and to the Software
+are and shall remain the exclusive property of the Author.
+
+--------------------------------------------------------------------------------
+2. NON-EXCLUSIVE LICENSE GRANT TO PORTER METRICS INC.
+--------------------------------------------------------------------------------
+
+The Author hereby grants to Porter Metrics Inc. a NON-EXCLUSIVE, worldwide,
+perpetual license to:
+
+  a) Use, copy, reproduce, and duplicate the Software
+  b) Modify, adapt, translate, and create derivative works based on the Software
+  c) Distribute, sublicense, lease, rent, loan, and transfer the Software
+  d) Commercially exploit and monetize the Software
+  e) Integrate the Software into other products and services
+
+This license grant is NON-EXCLUSIVE, meaning:
+
+  - The Author retains ALL rights to the Software without any limitations
+  - The Author may use, modify, distribute, license, sell, or otherwise
+    exploit the Software in any manner, at any time, without restriction
+  - The Author may grant similar or different licenses to other parties
+  - Porter Metrics Inc. does not acquire any ownership rights over the Software
+
+--------------------------------------------------------------------------------
+3. AUTHOR'S RESERVED RIGHTS
+--------------------------------------------------------------------------------
+
+The Author expressly reserves the following unlimited rights:
+
+  a) To use, modify, and exploit the Software in any form, for any purpose,
+     commercial or non-commercial, without any obligation to Porter Metrics Inc.
+
+  b) To license the Software to any third party under any terms
+
+  c) To create, publish, and distribute any derivative works
+
+  d) To incorporate the Software into other projects without restriction
+
+  e) To revoke or modify third-party licenses (excluding the license granted
+     to Porter Metrics Inc.) at the Author's discretion
+
+--------------------------------------------------------------------------------
+4. DERIVATIVE WORKS AND MODIFICATIONS
+--------------------------------------------------------------------------------
+
+Any modifications, enhancements, derivative works, or contributions made to
+the Software by any person or entity authorized by the Author (including but
+not limited to Porter Metrics Inc., employees, contractors, or collaborators)
+shall be subject to the following terms:
+
+  a) All derivative works and modifications are and shall remain the property
+     of Carlos Alexis Gomez Ruiz by virtue of the original copyright.
+
+  b) Any authorized party making modifications to the Software MUST deliver
+     and transfer all such modifications, including source code, documentation,
+     and related materials, to the Author upon the Author's request.
+
+  c) The Author shall have unlimited rights to use, modify, license, or
+     otherwise exploit any and all derivative works and modifications.
+
+  d) Authorized parties retain no exclusive rights over their modifications;
+     any rights granted to them are subject to the Author's superior ownership.
+
+  e) This obligation to deliver modifications survives the termination of
+     any authorization or license agreement.
+
+--------------------------------------------------------------------------------
+5. PERSONAL AND NON-COMMERCIAL USE LICENSE
+--------------------------------------------------------------------------------
+
+The Author grants to any person obtaining a copy of this Software a LIMITED,
+NON-EXCLUSIVE, NON-TRANSFERABLE license for PERSONAL AND NON-COMMERCIAL USE
+ONLY, subject to the following restrictions:
+
+5.1 PERMITTED USES:
+  a) Personal learning and education
+  b) Academic research and study
+  c) Non-commercial personal projects
+  d) Code review and security research (responsible disclosure)
+  e) Contributing improvements via pull requests (subject to section 4)
+
+5.2 PROHIBITED USES - General:
+  a) Any COMMERCIAL use, including but not limited to:
+     - Offering the Software as a service (SaaS)
+     - Integrating into commercial products or services
+     - Using in business operations or professional services
+     - Generating revenue directly or indirectly from the Software
+
+  b) CREATING COMPETING PRODUCTS OR SERVICES, including but not limited to:
+     - AI-powered coding assistants or CLI tools
+     - Developer productivity tools using LLM integration
+     - Code generation or editing tools
+     - Any product or service that competes with PorterCode
+     - Any product or service that competes with offerings from:
+       * Porter Metrics Inc.
+       * Companies affiliated with Carlos Alexis Gomez Ruiz
+       * Companies where Carlos Alexis Gomez Ruiz has ownership interest
+
+  c) REBRANDING, RESELLING, OR REDISTRIBUTION:
+     - Removing or altering copyright notices or attributions
+     - Distributing modified versions under a different name
+     - Selling or licensing the Software or derivatives
+     - Incorporating into products intended for distribution
+     - White-labeling or rebranding for any purpose
+
+  d) Reverse engineering, decompiling, or attempting to extract proprietary
+     algorithms, methodologies, or trade secrets with intent to replicate
+
+  e) Using the Software to train AI models or create training datasets
+     for competitive purposes
+
+  f) Circumventing or removing security features, license checks, or
+     usage limitations
+
+  g) Using the Software in any manner that violates applicable laws or
+     regulations
+
+5.3 SPECIFIC PROHIBITED COMPETITIVE USES:
+  You may NOT use this Software to create, develop, or operate:
+  - LLM-based coding assistants or development tools
+  - CLI tools for code generation or manipulation
+  - AI agents for software development
+  - Developer productivity platforms using AI
+  - Code editors with AI capabilities
+  - Automated programming or refactoring tools
+  - Developer workflow automation tools using LLM
+  - Any tool marketed as an alternative to PorterCode or similar products
+
+5.4 REQUIRED ATTRIBUTION:
+  - All redistributions (if permitted) must retain copyright notices
+  - Modified versions must clearly indicate changes made
+  - No use of Author's or Porter Metrics Inc.'s names for endorsement
+
+--------------------------------------------------------------------------------
+6. RESTRICTIONS FOR UNAUTHORIZED COMMERCIAL ENTITIES
+--------------------------------------------------------------------------------
+
+Unless expressly authorized in writing by the Author, commercial entities,
+organizations, or businesses may NOT:
+
+  a) Use the Software for any commercial purpose
+  b) Copy, reproduce, or duplicate the Software or any portion thereof
+  c) Modify, adapt, translate, or create derivative works based on the Software
+  d) Distribute, sublicense, lease, rent, loan, or transfer the Software
+  e) Integrate the Software into commercial products or services
+  f) Perform competitive analysis or benchmarking for commercial purposes
+
+Commercial entities seeking to use the Software must obtain explicit written
+permission and a separate commercial license from the Author.
+
+--------------------------------------------------------------------------------
+7. CONFIDENTIALITY
+--------------------------------------------------------------------------------
+
+All parties with access to the Software acknowledge and agree that:
+
+  a) The Software, including its source code, architecture, algorithms, and
+     documentation, constitutes Confidential Information of the Author.
+
+  b) Confidential Information shall not be disclosed to any unauthorized
+     third party without prior written consent from the Author.
+
+  c) This confidentiality obligation shall survive termination and remain in
+     effect indefinitely for trade secrets and for five (5) years for other
+     Confidential Information.
+
+  d) Source code and internal documentation marked as confidential must not
+     be shared publicly or with unauthorized parties.
+
+--------------------------------------------------------------------------------
+8. TERMINATION
+--------------------------------------------------------------------------------
+
+8.1 AUTOMATIC TERMINATION:
+This license automatically terminates if you:
+  - Violate any term or restriction of this license
+  - Use the Software for any prohibited purpose
+  - Fail to comply with attribution requirements
+  - Attempt to create competing products or services
+  - Engage in any commercial use without authorization
+
+8.2 EFFECT OF TERMINATION:
+Upon termination:
+  - You must immediately cease all use of the Software
+  - Delete or destroy all copies in your possession
+  - Discontinue distribution of any derivatives
+  - Return or destroy all confidential materials
+
+8.3 SURVIVAL:
+Sections 1 (Ownership), 7 (Confidentiality), 9 (Disclaimer), 10 (Limitation
+of Liability), and 11 (Governing Law) survive termination.
+
+--------------------------------------------------------------------------------
+9. DISCLAIMER OF WARRANTIES
+--------------------------------------------------------------------------------
+
+THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. THE AUTHOR DOES NOT
+WARRANT THAT THE SOFTWARE WILL BE ERROR-FREE, UNINTERRUPTED, SECURE, OR
+FREE OF HARMFUL COMPONENTS.
+
+YOU ASSUME ALL RISK ASSOCIATED WITH THE USE OF THIS SOFTWARE. THE AUTHOR
+SHALL NOT BE LIABLE FOR ANY DAMAGE TO YOUR COMPUTER SYSTEM, LOSS OF DATA,
+OR ANY OTHER DAMAGE RESULTING FROM USE OF THE SOFTWARE.
+
+--------------------------------------------------------------------------------
+10. LIMITATION OF LIABILITY
+--------------------------------------------------------------------------------
+
+IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
+CONSEQUENTIAL, EXEMPLARY, OR PUNITIVE DAMAGES, INCLUDING BUT NOT LIMITED TO:
+  - Loss of profits, revenue, or business opportunities
+  - Loss of data or data corruption
+  - Business interruption or downtime
+  - Cost of substitute products or services
+  - Loss of goodwill or reputation damage
+
+THIS LIMITATION APPLIES EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY
+OF SUCH DAMAGES. THE AUTHOR'S TOTAL LIABILITY SHALL NOT EXCEED THE AMOUNT
+PAID BY YOU FOR THE SOFTWARE (IF ANY).
+
+SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF CERTAIN
+DAMAGES, SO THE ABOVE LIMITATIONS MAY NOT APPLY TO YOU.
+
+--------------------------------------------------------------------------------
+11. EXPORT COMPLIANCE
+--------------------------------------------------------------------------------
+
+You agree to comply with all applicable export and import laws and regulations.
+You shall not export, re-export, or transfer the Software to prohibited
+countries or individuals under applicable laws.
+
+--------------------------------------------------------------------------------
+12. GOVERNING LAW AND JURISDICTION
+--------------------------------------------------------------------------------
+
+This License shall be governed by and construed in accordance with the laws
+of the State of Delaware, United States of America, without regard to conflict
+of law principles. Any disputes arising under this License shall be resolved
+exclusively in the state or federal courts located in Delaware.
+
+Both parties consent to personal jurisdiction in Delaware and waive any
+objection to venue in such courts.
+
+--------------------------------------------------------------------------------
+13. SEVERABILITY
+--------------------------------------------------------------------------------
+
+If any provision of this License is held to be invalid or unenforceable, the
+remaining provisions shall continue in full force and effect, and the invalid
+provision shall be modified to the minimum extent necessary to make it valid
+and enforceable.
+
+--------------------------------------------------------------------------------
+14. ENTIRE AGREEMENT
+--------------------------------------------------------------------------------
+
+This License constitutes the entire agreement between you and the Author
+regarding the Software and supersedes all prior or contemporaneous
+communications, whether written or oral.
+
+This License may only be modified by a written amendment signed by the Author.
+No waiver of any provision shall constitute a waiver of any other provision
+or future waiver of the same provision.
+
+--------------------------------------------------------------------------------
+15. CONTACT INFORMATION
+--------------------------------------------------------------------------------
+
+For licensing inquiries, commercial use permissions, or to report violations:
+
+  Carlos Alexis Gomez Ruiz
+  Email: alexisg.0207@gmail.com
+
+  Porter Metrics Inc. (Authorized Licensee)
+  Email: alexis@portermetrics.com
+
+================================================================================
+
+IMPORTANT NOTICE:
+
+This is proprietary software. Unauthorized commercial use, redistribution,
+rebranding, or creation of competing products is strictly prohibited and may
+result in legal action.
+
+For commercial licensing options, please contact the Author at the email
+address provided above.
+
+================================================================================
+
+For third-party software notices and attributions, see the NOTICE file.

package/NOTICE

@@ -0,0 +1,45 @@
+NOTICES AND ATTRIBUTIONS
+========================
+
+Portercode - Copyright (c) 2025 Porter Metrics Inc.
+Author: Carlos Alexis Gomez Ruiz <alexis@portermetrics.com>
+
+================================================================================
+THIRD-PARTY SOFTWARE NOTICES
+================================================================================
+
+This software contains code derived from OpenCode, which is licensed under
+the MIT License. In compliance with the MIT License requirements, the original
+copyright notice and license text are reproduced below:
+
+--------------------------------------------------------------------------------
+OpenCode
+https://github.com/sst/opencode
+
+MIT License
+
+Copyright (c) 2024 SST
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+--------------------------------------------------------------------------------
+
+Note: The inclusion of this notice fulfills the attribution requirements of
+the MIT License for the original OpenCode project. The derivative work
+(Portercode) is separately licensed under a proprietary license as specified
+in the LICENSE file.

package/README.md

@@ -0,0 +1,277 @@
+# PorterCode
+
+AI-powered coding assistant CLI.
+
+## Installation
+
+```bash
+npm install -g portercode
+```
+
+**Requirements:** [Bun](https://bun.sh) runtime
+
+## Usage
+
+```bash
+# Interactive mode
+porter
+
+# With initial message
+porter "explain this codebase"
+
+# Continue last session
+porter -c
+
+# Use specific model
+porter -m anthropic/claude-sonnet-4-20250514
+
+# Start HTTP server for VS Code extension
+porter --port 50123
+```
+
+## Commands
+
+```
+porter              Start interactive TUI
+porter auth         Manage API credentials
+porter config       Show configuration
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-d, --debug` | Enable debug mode |
+| `-s, --session` | Continue specific session |
+| `-c, --continue` | Continue most recent session |
+| `-m, --model` | Model to use (provider/model) |
+| `--port <number>` | Start HTTP server on specified port (for VS Code extension) |
+
+---
+
+## VS Code Extension Communication
+
+When started with `--port`, PorterCode runs an HTTP server for communication with the VS Code extension.
+
+### Architecture: HTTP + SSE
+
+- **HTTP REST API**: For requests (prompts, sessions, auth, permissions)
+- **SSE (Server-Sent Events)**: For real-time streaming responses
+
+### API Endpoints
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/health` | GET | Health check |
+| `/events` | GET | SSE stream for real-time events |
+| `/api/sessions` | GET | List all sessions |
+| `/api/sessions` | POST | Create a new session |
+| `/api/sessions/:id/messages` | GET | Get messages for a session |
+| `/api/prompt` | POST | Send a prompt to the LLM |
+| `/api/cancel` | POST | Cancel active generation |
+| `/api/permission` | POST | Respond to permission requests |
+| `/api/auth/status` | GET | Check authentication status |
+| `/api/auth/providers` | GET | List available LLM providers |
+| `/api/auth/credentials` | POST | Save API key credential |
+
+### SSE Events
+
+The `/events` endpoint streams the following event types:
+
+| Event | Description |
+|-------|-------------|
+| `heartbeat` | Keep-alive ping |
+| `message.start` | LLM generation started |
+| `message.delta` | Text content chunk |
+| `reasoning.delta` | Reasoning/thinking content chunk |
+| `message.complete` | LLM generation finished |
+| `tool.start` | Tool execution started |
+| `tool.complete` | Tool execution finished |
+| `permission.request` | Permission required for tool |
+| `session.updated` | Session metadata changed |
+
+### Example: Connecting to SSE
+
+```javascript
+const eventSource = new EventSource('http://localhost:50123/events');
+
+eventSource.addEventListener('message.delta', (e) => {
+  const data = JSON.parse(e.data);
+  console.log('Content:', data.content);
+});
+
+eventSource.addEventListener('tool.start', (e) => {
+  const data = JSON.parse(e.data);
+  console.log('Tool:', data.toolName);
+});
+```
+
+---
+
+## Publishing to npm
+
+### Prerequisites
+
+1. npm account with publish access
+2. Logged in: `npm login`
+3. Bun installed
+
+### Steps to Publish a New Version
+
+#### 1. Update Version
+
+```bash
+# Patch (0.1.0 -> 0.1.1)
+npm version patch
+
+# Minor (0.1.0 -> 0.2.0)
+npm version minor
+
+# Major (0.1.0 -> 1.0.0)
+npm version major
+```
+
+#### 2. Build & Verify
+
+```bash
+# Build (compiles + obfuscates)
+bun run build
+
+# Verify CLI works
+bun ./dist/index.js --help
+```
+
+#### 3. Preview Package Contents (IMPORTANT)
+
+**Always verify before publishing:**
+
+```bash
+# List files that will be included
+npm pack --dry-run
+
+# Or create and inspect the tarball
+npm pack
+tar -tzf portercode-*.tgz
+```
+
+**Checklist - Verify these are NOT included:**
+- [ ] `src/` directory (source code)
+- [ ] `test/` directory
+- [ ] `*.ts` files (except `*.d.ts`)
+- [ ] `build.ts`
+- [ ] `tsconfig*.json`
+- [ ] `bun.lockb`
+- [ ] `.env` or credentials
+
+**Checklist - Verify these ARE included:**
+- [x] `dist/index.js` (obfuscated)
+- [x] `dist/**/*.d.ts` (type declarations)
+- [x] `LICENSE`
+- [x] `NOTICE`
+- [x] `package.json`
+
+#### 4. Verify Obfuscation
+
+```bash
+# Check that code is obfuscated (should show hexadecimal variables)
+head -c 500 dist/index.js
+```
+
+Expected output should look like:
+```javascript
+var _0x12a874=_0x45ea;(function(_0x68ac43,_0x53f9ec){...
+```
+
+**NOT** readable code like:
+```javascript
+import { something } from "./module"
+```
+
+#### 5. Publish
+
+```bash
+# Publish to npm
+npm publish --access public
+
+# Or dry-run first
+npm publish --access public --dry-run
+```
+
+#### 6. Verify Published Package
+
+```bash
+# Check on npm
+npm info portercode
+
+# Test installation
+npm install -g portercode
+porter --version
+```
+
+### Rollback (if needed)
+
+```bash
+# Unpublish within 72 hours
+npm unpublish portercode@0.1.1
+
+# Deprecate (after 72 hours)
+npm deprecate portercode@0.1.1 "Critical bug, use 0.1.2"
+```
+
+---
+
+## Features
+
+- 🤖 **Multi-LLM Support**: Works with Anthropic Claude, OpenAI GPT, Google Gemini, and Groq
+- 🔐 **Granular Permissions**: Fine-grained control over file operations and command execution
+- 💬 **Interactive Sessions**: Save and resume conversations
+- ⚙️ **Configurable**: Hierarchical configuration system with JSONC support
+- 🔧 **Extensible Tools**: Read, write, edit files, execute commands, search code
+- 🎨 **Terminal UI**: Beautiful interactive interface built with Ink
+- 📡 **VS Code Integration**: HTTP + SSE server for VS Code extension
+
+## Development
+
+```bash
+# Run in dev mode
+bun run dev
+
+# Run tests
+bun test
+
+# Type check
+bun run typecheck
+```
+
+---
+
+## Configuration
+
+Create a `porter.jsonc` file in your project root or `~/.config/portercode/porter.jsonc` globally:
+
+```jsonc
+{
+  "model": "claude-sonnet-4",
+  "permission": {
+    "edit": "ask",      // Always ask before editing files
+    "bash": "auto"      // Execute commands automatically
+  }
+}
+```
+
+### Configuration Options
+
+| Option | Description | Values |
+|--------|-------------|--------|
+| `model` | Default LLM model | `claude-sonnet-4`, `gpt-4`, `gemini-pro`, etc. |
+| `permission.edit` | Permission for editing files | `ask`, `auto`, `deny` |
+| `permission.write` | Permission for creating files | `ask`, `auto`, `deny` |
+| `permission.bash` | Permission for shell commands | `ask`, `auto`, `deny` |
+
+---
+
+## License
+
+Proprietary - See [LICENSE](LICENSE) for details.
+
+Copyright (c) 2025 Carlos Alexis Gomez Ruiz. All rights reserved.