portercode 0.1.0

package/LICENSE

@@ -0,0 +1,123 @@
+PROPRIETARY SOFTWARE LICENSE
+============================
+
+Copyright (c) 2025 Porter Metrics Inc.
+All Rights Reserved.
+
+Author: Carlos Alexis Gomez Ruiz <alexis@portermetrics.com>
+
+--------------------------------------------------------------------------------
+1. OWNERSHIP AND INTELLECTUAL PROPERTY
+--------------------------------------------------------------------------------
+
+This software and associated documentation files (the "Software") are the
+exclusive property of Porter Metrics Inc. The Software is protected by
+copyright laws and international treaty provisions. All intellectual property
+rights in and to the Software, including but not limited to patents, copyrights,
+trade secrets, and trademarks, are and shall remain the exclusive property of
+Porter Metrics Inc.
+
+--------------------------------------------------------------------------------
+2. LICENSE RESTRICTIONS
+--------------------------------------------------------------------------------
+
+Unless expressly authorized in writing by Porter Metrics Inc., you may NOT:
+
+  a) Copy, reproduce, or duplicate the Software or any portion thereof
+  b) Modify, adapt, translate, or create derivative works based on the Software
+  c) Distribute, sublicense, lease, rent, loan, or transfer the Software
+  d) Reverse engineer, disassemble, decompile, or attempt to derive source code
+  e) Remove, alter, or obscure any proprietary notices on the Software
+  f) Use the Software for any unlawful purpose or in violation of any regulations
+  g) Share access credentials or allow unauthorized third parties to access
+  h) Use the Software to develop competing products or services
+
+--------------------------------------------------------------------------------
+3. CONFIDENTIALITY AGREEMENT (NDA)
+--------------------------------------------------------------------------------
+
+By accessing this Software, you acknowledge and agree that:
+
+  a) The Software, including its source code, architecture, algorithms, and
+     documentation, constitutes Confidential Information of Porter Metrics Inc.
+
+  b) You shall maintain strict confidentiality and shall not disclose any
+     Confidential Information to any third party without prior written consent.
+
+  c) You shall use the Confidential Information solely for authorized purposes
+     and shall take all reasonable measures to protect its confidentiality.
+
+  d) Upon termination of your authorized access or upon request, you shall
+     promptly return or destroy all copies of Confidential Information.
+
+  e) This confidentiality obligation shall survive termination and remain in
+     effect indefinitely for trade secrets and for five (5) years for other
+     Confidential Information.
+
+  f) Unauthorized disclosure may result in irreparable harm, and Porter Metrics
+     Inc. shall be entitled to seek injunctive relief in addition to other
+     remedies.
+
+--------------------------------------------------------------------------------
+4. TERMS OF USE FOR AUTHORIZED USERS
+--------------------------------------------------------------------------------
+
+Authorized users of the Software agree to:
+
+  a) Use the Software only for its intended purpose within the scope of their
+     authorization from Porter Metrics Inc.
+
+  b) Maintain the security of any access credentials and immediately report
+     any suspected unauthorized access or security breaches.
+
+  c) Comply with all applicable laws, regulations, and Porter Metrics Inc.
+     policies when using the Software.
+
+  d) Not attempt to circumvent any security measures or access controls.
+
+  e) Not use the Software in any manner that could damage, disable, or impair
+     Porter Metrics Inc. systems or interfere with other authorized users.
+
+  f) Acknowledge that Porter Metrics Inc. may monitor usage to ensure compliance
+     with these terms.
+
+--------------------------------------------------------------------------------
+5. 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. PORTER METRICS INC.
+DOES NOT WARRANT THAT THE SOFTWARE WILL BE ERROR-FREE OR UNINTERRUPTED.
+
+--------------------------------------------------------------------------------
+6. LIMITATION OF LIABILITY
+--------------------------------------------------------------------------------
+
+IN NO EVENT SHALL PORTER METRICS INC., ITS OFFICERS, DIRECTORS, EMPLOYEES,
+OR AGENTS BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL,
+OR PUNITIVE DAMAGES, INCLUDING BUT NOT LIMITED TO LOSS OF PROFITS, DATA,
+OR USE, ARISING OUT OF OR IN CONNECTION WITH THIS LICENSE OR THE SOFTWARE.
+
+--------------------------------------------------------------------------------
+7. 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, and each party
+consents to the personal jurisdiction of such courts.
+
+--------------------------------------------------------------------------------
+8. CONTACT INFORMATION
+--------------------------------------------------------------------------------
+
+For licensing inquiries, permissions, or to report violations:
+
+  Porter Metrics Inc.
+  Email: alexis@portermetrics.com
+
+================================================================================
+
+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,178 @@
+# 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
+```
+
+## 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) |
+| `-g, --gateway` | Enable Gateway server for VSCode |
+
+---
+
+## 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"
+```
+
+---
+
+## Development
+
+```bash
+# Run in dev mode
+bun run dev
+
+# Run tests
+bun test
+
+# Type check
+bun run typecheck
+```
+
+## License
+
+Proprietary - See [LICENSE](LICENSE) for details.
+
+Copyright (c) 2025 Porter Metrics Inc. All rights reserved.

package/dist/auth/index.d.ts

@@ -0,0 +1,103 @@
+import { z } from "zod";
+export declare namespace Auth {
+    const Oauth: z.ZodObject<{
+        type: z.ZodLiteral<"oauth">;
+        refresh: z.ZodString;
+        access: z.ZodString;
+        expires: z.ZodNumber;
+        enterpriseUrl: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "oauth";
+        refresh: string;
+        access: string;
+        expires: number;
+        enterpriseUrl?: string | undefined;
+    }, {
+        type: "oauth";
+        refresh: string;
+        access: string;
+        expires: number;
+        enterpriseUrl?: string | undefined;
+    }>;
+    const Api: z.ZodObject<{
+        type: z.ZodLiteral<"api">;
+        key: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "api";
+        key: string;
+    }, {
+        type: "api";
+        key: string;
+    }>;
+    const WellKnown: z.ZodObject<{
+        type: z.ZodLiteral<"wellknown">;
+        key: z.ZodString;
+        token: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "wellknown";
+        key: string;
+        token: string;
+    }, {
+        type: "wellknown";
+        key: string;
+        token: string;
+    }>;
+    const Info: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"oauth">;
+        refresh: z.ZodString;
+        access: z.ZodString;
+        expires: z.ZodNumber;
+        enterpriseUrl: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "oauth";
+        refresh: string;
+        access: string;
+        expires: number;
+        enterpriseUrl?: string | undefined;
+    }, {
+        type: "oauth";
+        refresh: string;
+        access: string;
+        expires: number;
+        enterpriseUrl?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"api">;
+        key: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "api";
+        key: string;
+    }, {
+        type: "api";
+        key: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"wellknown">;
+        key: z.ZodString;
+        token: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "wellknown";
+        key: string;
+        token: string;
+    }, {
+        type: "wellknown";
+        key: string;
+        token: string;
+    }>]>;
+    type Info = z.infer<typeof Info>;
+    function get(providerID: string): Promise<{
+        type: "oauth";
+        refresh: string;
+        access: string;
+        expires: number;
+        enterpriseUrl?: string | undefined;
+    } | {
+        type: "api";
+        key: string;
+    } | {
+        type: "wellknown";
+        key: string;
+        token: string;
+    }>;
+    function all(): Promise<Record<string, Info>>;
+    function set(key: string, info: Info): Promise<void>;
+    function remove(key: string): Promise<void>;
+}

package/dist/bus/bus-event.d.ts

@@ -0,0 +1,10 @@
+import z from "zod";
+import type { ZodType } from "zod";
+export declare namespace BusEvent {
+    type Definition = ReturnType<typeof define>;
+    function define<Type extends string, Properties extends ZodType>(type: Type, properties: Properties): {
+        type: Type;
+        properties: Properties;
+    };
+    function payloads(): z.ZodDiscriminatedUnion<"type", any>;
+}

package/dist/bus/global.d.ts

@@ -0,0 +1,7 @@
+import { EventEmitter } from "events";
+export declare const GlobalBus: EventEmitter<{
+    event: [{
+        directory?: string;
+        payload: any;
+    }];
+}>;

package/dist/bus/index.d.ts

@@ -0,0 +1,26 @@
+import z from "zod";
+import { BusEvent } from "./bus-event";
+export declare namespace Bus {
+    const InstanceDisposed: {
+        type: "server.instance.disposed";
+        properties: z.ZodObject<{
+            directory: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            directory: string;
+        }, {
+            directory: string;
+        }>;
+    };
+    function publish<Definition extends BusEvent.Definition>(def: Definition, properties: z.output<Definition["properties"]>): Promise<void[]>;
+    function subscribe<Definition extends BusEvent.Definition>(def: Definition, callback: (event: {
+        type: Definition["type"];
+        properties: z.infer<Definition["properties"]>;
+    }) => void): () => void;
+    function once<Definition extends BusEvent.Definition>(def: Definition, callback: (event: {
+        type: Definition["type"];
+        properties: z.infer<Definition["properties"]>;
+    }) => "done" | undefined): void;
+    function subscribeAll(callback: (event: any) => void): () => void;
+}
+export { BusEvent } from "./bus-event";
+export { GlobalBus } from "./global";

package/dist/cli/auth.d.ts

@@ -0,0 +1,11 @@
+export declare function authLogin(): Promise<void>;
+export declare function authList(): Promise<void>;
+export declare function authLogout(): Promise<void>;
+/**
+ * Check if any provider has credentials configured
+ */
+export declare function hasAnyCredentials(): Promise<boolean>;
+/**
+ * Run onboarding flow if no credentials configured
+ */
+export declare function runOnboarding(): Promise<boolean>;

package/dist/cli/index.d.ts

@@ -0,0 +1 @@
+export declare function cli(): Promise<void>;

package/dist/cli/ui.d.ts

@@ -0,0 +1,26 @@
+export declare namespace UI {
+    class CancelledError extends Error {
+        constructor();
+    }
+    const Style: {
+        TEXT_HIGHLIGHT: string;
+        TEXT_HIGHLIGHT_BOLD: string;
+        TEXT_DIM: string;
+        TEXT_DIM_BOLD: string;
+        TEXT_NORMAL: string;
+        TEXT_NORMAL_BOLD: string;
+        TEXT_WARNING: string;
+        TEXT_WARNING_BOLD: string;
+        TEXT_DANGER: string;
+        TEXT_DANGER_BOLD: string;
+        TEXT_SUCCESS: string;
+        TEXT_SUCCESS_BOLD: string;
+        TEXT_INFO: string;
+        TEXT_INFO_BOLD: string;
+    };
+    function println(...message: string[]): void;
+    function print(...message: string[]): void;
+    function empty(): void;
+    function logo(pad?: string): string;
+    function error(message: string): void;
+}

package/dist/command/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Command System
+ *
+ * Manages slash commands for the TUI.
+ * Commands can be triggered by typing / followed by the command name.
+ */
+export type DialogType = "model" | "help" | "diagnostics" | "config" | "sessions" | null;
+export interface Command {
+    name: string;
+    aliases?: string[];
+    description: string;
+    category: "session" | "display" | "system" | "help";
+    execute: (ctx: CommandContext) => void | Promise<void>;
+}
+export interface CommandContext {
+    sessionId?: string;
+    navigate: (route: any) => void;
+    exit: () => void;
+    showDialog: (type: DialogType) => void;
+    clearDialog: () => void;
+    showOutput: (text: string) => void;
+    optimize?: () => Promise<void>;
+    sessionTokens?: {
+        input: number;
+        output: number;
+    };
+    availableProviders?: string[];
+    currentModel?: string;
+}
+/**
+ * Register a command
+ */
+export declare function register(command: Command): void;
+/**
+ * Get all registered commands
+ */
+export declare function all(): Command[];
+/**
+ * Find a command by name or alias
+ */
+export declare function find(name: string): Command | undefined;
+/**
+ * Execute a command string (e.g., "/help" or "/session")
+ */
+export declare function execute(input: string, ctx: CommandContext): Promise<boolean>;
+export interface CommandSuggestion {
+    command: Command;
+    matchedName: string;
+}
+/**
+ * Get command suggestions for autocomplete
+ * Returns commands that start with the given prefix, along with which name/alias matched
+ */
+export declare function suggestions(prefix: string): CommandSuggestion[];