psycgod-sage 2.0.1__tar.gz

psycgod_sage-2.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 PsYcGoD (SAGE Project)
+
+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.

psycgod_sage-2.0.1/PKG-INFO

@@ -0,0 +1,221 @@
+Metadata-Version: 2.4
+Name: psycgod-sage
+Version: 2.0.1
+Summary: Local-first command wrapper for AI coding agents with compressed terminal output and privacy-safe proof metrics.
+Author: PsYcGoD
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/PsYcGoD/sage
+Project-URL: Repository, https://github.com/PsYcGoD/sage
+Project-URL: Issues, https://github.com/PsYcGoD/sage/issues
+Project-URL: Dashboard, https://psyc-god-sage-api.valan-dj.workers.dev/dashboard
+Keywords: ai,cli,terminal,debugging,local assistant,terminal agent
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: joblib>=1.3
+Requires-Dist: keyring>=25
+Requires-Dist: pandas>=2.0
+Requires-Dist: PyYAML>=6
+Requires-Dist: scikit-learn>=1.3
+Requires-Dist: tiktoken>=0.7
+Provides-Extra: ai
+Requires-Dist: anthropic>=0.40; extra == "ai"
+Requires-Dist: boto3>=1.34; extra == "ai"
+Requires-Dist: google-generativeai>=0.8; extra == "ai"
+Requires-Dist: openai>=1.50; extra == "ai"
+Requires-Dist: requests>=2.31; extra == "ai"
+Provides-Extra: all
+Requires-Dist: anthropic>=0.40; extra == "all"
+Requires-Dist: boto3>=1.34; extra == "all"
+Requires-Dist: google-generativeai>=0.8; extra == "all"
+Requires-Dist: openai>=1.50; extra == "all"
+Requires-Dist: requests>=2.31; extra == "all"
+Dynamic: license-file
+
+# SAGE
+
+[![CI](https://github.com/PsYcGoD/sage/actions/workflows/ci.yml/badge.svg)](https://github.com/PsYcGoD/sage/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](pyproject.toml)
+[![License](https://img.shields.io/github/license/PsYcGoD/sage.svg)](LICENSE)
+[![Release](https://img.shields.io/github/v/release/PsYcGoD/sage?include_prereleases)](https://github.com/PsYcGoD/sage/releases)
+
+SAGE is a local-first command wrapper for AI coding agents that compresses terminal output, preserves raw logs locally, and proves token savings with privacy-safe metrics.
+
+The public package is CLI-first. The desktop GUI is not included in this public repository yet.
+
+## Live Public Proof Dashboard
+
+Live dashboard: https://psyc-god-sage-api.valan-dj.workers.dev/dashboard
+
+![SAGE Live Public Proof Dashboard](docs/assets/sage-live-dashboard.png)
+
+Current public proof includes:
+
+- Total commands processed through SAGE
+- Tokens processed, compressed, and saved
+- Estimated savings by AI agent/provider
+- Compression rate and command success rate
+- ML prediction scoring from local command history
+
+Latest verified snapshot:
+
+| Metric | Value |
+|--------|------:|
+| Commands processed | 4,726 |
+| Tokens processed | 16,870,812 |
+| Tokens compressed | 1,225,605 |
+| Tokens saved | 15,645,207 |
+| Estimated savings | $46.94 |
+| Compression rate | 92.74% |
+| Success rate | 98.03% |
+
+These stats reflect the public CLI proof snapshot after the hosted dashboard went live.
+Raw commands, outputs, file paths, and logs stay local by default. Public proof uses aggregate counters only.
+
+## Install From GitHub Until PyPI Is Live
+
+PyPI publishing is prepared but still blocked by the Trusted Publisher project-name mismatch. Until the PyPI project is live, install the public CLI directly from GitHub:
+
+```bash
+pip install git+https://github.com/PsYcGoD/sage.git
+sage --version
+```
+
+After PyPI is live, the install command will be:
+
+```bash
+pip install psycgod-sage
+sage --version
+```
+
+For local development:
+
+```bash
+git clone https://github.com/PsYcGoD/sage.git
+cd sage
+pip install -e .
+sage --version
+```
+
+The prepared PyPI distribution is `psycgod-sage`; the installed CLI command is still `sage`.
+
+## Connect Your Account
+
+Most public API-backed commands require GitHub OAuth:
+
+```bash
+sage connect
+sage whoami
+sage api status
+```
+
+SAGE stores the API key in the operating system keyring when available. Local command history and raw outputs remain on your machine.
+
+## Bind Agent Instructions
+
+Create local SAGE instructions for terminal agents:
+
+```bash
+sage init
+```
+
+This writes `SAGE.md` in the current project. Give that file to your local AI coding agent, or bind the same rule into your `AGENTS.md` / agent instruction file:
+
+```text
+Route every shell command through:
+
+sage run -- <command>
+```
+
+## Run Commands Through SAGE
+
+```bash
+sage run -- python -m pytest
+sage run -- npm test
+sage run -- git status
+```
+
+SAGE stores full raw command output locally, summarizes noisy output for AI context, tracks compression, and sends only allowed aggregate proof metrics to the dashboard.
+
+## Useful CLI Commands
+
+```bash
+sage context stats
+sage context report
+sage history --limit 10
+sage explain
+sage suggest
+sage fix
+sage fix --apply --confidence 0.9
+sage savings --agent claude-sonnet
+sage firewall status
+sage firewall rules list
+sage github-bot comment --kind summary
+sage mcp install
+sage dashboard start --port 8765
+```
+
+## Team View Preview
+
+Team Dashboard is not published yet. It will open by invite after SAGE reaches 100 users.
+
+![SAGE Team View Preview](docs/assets/team-dashboard-preview.png)
+
+The planned Team View will show aggregate workspace proof only: tokens saved, success rate, safety events, and protected secrets. It will not publish raw commands, source code, file paths, `.env` data, or raw logs.
+
+## Screenshots
+
+| Command | Preview |
+|---|---|
+| `sage run --` | ![sage run terminal capture](docs/assets/sage-run.svg) |
+| `sage context report` | ![sage context report terminal capture](docs/assets/sage-context-report.svg) |
+| `sage mcp install` | ![sage mcp install terminal capture](docs/assets/sage-mcp-install.svg) |
+| Dashboard proof | ![SAGE Live Public Proof Dashboard](docs/assets/sage-live-dashboard.png) |
+
+Starter demo GIFs:
+
+- [`demo-sage-run.gif`](docs/assets/demo-sage-run.gif)
+- [`demo-sage-savings.gif`](docs/assets/demo-sage-savings.gif)
+- [`demo-github-bot.gif`](docs/assets/demo-github-bot.gif)
+
+## GUI Status
+
+The desktop GUI is not available in this public repo right now.
+
+```bash
+sage gui
+```
+
+This command prints the roadmap status instead of launching a desktop app. The GUI will be released later with AI agents and ML workflows after it is stable enough for public use.
+
+## Known Limitations
+
+- The GUI is not public yet and is intentionally absent from the CLI package.
+- GitHub OAuth / a SAGE API key is required for most API-backed commands and public proof sync.
+- Telemetry level `0` is local-only; higher levels are opt-in and constrained by account/key policy.
+- The public dashboard is aggregate-only and does not expose raw commands, raw outputs, file paths, or local logs.
+- Local ML and agent features depend on local history volume and optional provider credentials.
+
+## Privacy
+
+- Raw commands and full outputs stay local by default.
+- Public dashboard data is aggregate proof only.
+- API connection is handled through GitHub OAuth.
+- Higher telemetry is opt-in.
+- API keys are stored in the OS keyring when available.
+
+See [PRIVACY.md](PRIVACY.md) and [SECURITY.md](SECURITY.md) for the detailed data and security model.
+
+## Development
+
+```bash
+python -m pytest -q
+```
+
+The public package is CLI-first. GUI source, GUI tests, and GUI-only dependencies are intentionally not shipped in this repo at this time.

psycgod_sage-2.0.1/README.md

@@ -0,0 +1,181 @@
+# SAGE
+
+[![CI](https://github.com/PsYcGoD/sage/actions/workflows/ci.yml/badge.svg)](https://github.com/PsYcGoD/sage/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](pyproject.toml)
+[![License](https://img.shields.io/github/license/PsYcGoD/sage.svg)](LICENSE)
+[![Release](https://img.shields.io/github/v/release/PsYcGoD/sage?include_prereleases)](https://github.com/PsYcGoD/sage/releases)
+
+SAGE is a local-first command wrapper for AI coding agents that compresses terminal output, preserves raw logs locally, and proves token savings with privacy-safe metrics.
+
+The public package is CLI-first. The desktop GUI is not included in this public repository yet.
+
+## Live Public Proof Dashboard
+
+Live dashboard: https://psyc-god-sage-api.valan-dj.workers.dev/dashboard
+
+![SAGE Live Public Proof Dashboard](docs/assets/sage-live-dashboard.png)
+
+Current public proof includes:
+
+- Total commands processed through SAGE
+- Tokens processed, compressed, and saved
+- Estimated savings by AI agent/provider
+- Compression rate and command success rate
+- ML prediction scoring from local command history
+
+Latest verified snapshot:
+
+| Metric | Value |
+|--------|------:|
+| Commands processed | 4,726 |
+| Tokens processed | 16,870,812 |
+| Tokens compressed | 1,225,605 |
+| Tokens saved | 15,645,207 |
+| Estimated savings | $46.94 |
+| Compression rate | 92.74% |
+| Success rate | 98.03% |
+
+These stats reflect the public CLI proof snapshot after the hosted dashboard went live.
+Raw commands, outputs, file paths, and logs stay local by default. Public proof uses aggregate counters only.
+
+## Install From GitHub Until PyPI Is Live
+
+PyPI publishing is prepared but still blocked by the Trusted Publisher project-name mismatch. Until the PyPI project is live, install the public CLI directly from GitHub:
+
+```bash
+pip install git+https://github.com/PsYcGoD/sage.git
+sage --version
+```
+
+After PyPI is live, the install command will be:
+
+```bash
+pip install psycgod-sage
+sage --version
+```
+
+For local development:
+
+```bash
+git clone https://github.com/PsYcGoD/sage.git
+cd sage
+pip install -e .
+sage --version
+```
+
+The prepared PyPI distribution is `psycgod-sage`; the installed CLI command is still `sage`.
+
+## Connect Your Account
+
+Most public API-backed commands require GitHub OAuth:
+
+```bash
+sage connect
+sage whoami
+sage api status
+```
+
+SAGE stores the API key in the operating system keyring when available. Local command history and raw outputs remain on your machine.
+
+## Bind Agent Instructions
+
+Create local SAGE instructions for terminal agents:
+
+```bash
+sage init
+```
+
+This writes `SAGE.md` in the current project. Give that file to your local AI coding agent, or bind the same rule into your `AGENTS.md` / agent instruction file:
+
+```text
+Route every shell command through:
+
+sage run -- <command>
+```
+
+## Run Commands Through SAGE
+
+```bash
+sage run -- python -m pytest
+sage run -- npm test
+sage run -- git status
+```
+
+SAGE stores full raw command output locally, summarizes noisy output for AI context, tracks compression, and sends only allowed aggregate proof metrics to the dashboard.
+
+## Useful CLI Commands
+
+```bash
+sage context stats
+sage context report
+sage history --limit 10
+sage explain
+sage suggest
+sage fix
+sage fix --apply --confidence 0.9
+sage savings --agent claude-sonnet
+sage firewall status
+sage firewall rules list
+sage github-bot comment --kind summary
+sage mcp install
+sage dashboard start --port 8765
+```
+
+## Team View Preview
+
+Team Dashboard is not published yet. It will open by invite after SAGE reaches 100 users.
+
+![SAGE Team View Preview](docs/assets/team-dashboard-preview.png)
+
+The planned Team View will show aggregate workspace proof only: tokens saved, success rate, safety events, and protected secrets. It will not publish raw commands, source code, file paths, `.env` data, or raw logs.
+
+## Screenshots
+
+| Command | Preview |
+|---|---|
+| `sage run --` | ![sage run terminal capture](docs/assets/sage-run.svg) |
+| `sage context report` | ![sage context report terminal capture](docs/assets/sage-context-report.svg) |
+| `sage mcp install` | ![sage mcp install terminal capture](docs/assets/sage-mcp-install.svg) |
+| Dashboard proof | ![SAGE Live Public Proof Dashboard](docs/assets/sage-live-dashboard.png) |
+
+Starter demo GIFs:
+
+- [`demo-sage-run.gif`](docs/assets/demo-sage-run.gif)
+- [`demo-sage-savings.gif`](docs/assets/demo-sage-savings.gif)
+- [`demo-github-bot.gif`](docs/assets/demo-github-bot.gif)
+
+## GUI Status
+
+The desktop GUI is not available in this public repo right now.
+
+```bash
+sage gui
+```
+
+This command prints the roadmap status instead of launching a desktop app. The GUI will be released later with AI agents and ML workflows after it is stable enough for public use.
+
+## Known Limitations
+
+- The GUI is not public yet and is intentionally absent from the CLI package.
+- GitHub OAuth / a SAGE API key is required for most API-backed commands and public proof sync.
+- Telemetry level `0` is local-only; higher levels are opt-in and constrained by account/key policy.
+- The public dashboard is aggregate-only and does not expose raw commands, raw outputs, file paths, or local logs.
+- Local ML and agent features depend on local history volume and optional provider credentials.
+
+## Privacy
+
+- Raw commands and full outputs stay local by default.
+- Public dashboard data is aggregate proof only.
+- API connection is handled through GitHub OAuth.
+- Higher telemetry is opt-in.
+- API keys are stored in the OS keyring when available.
+
+See [PRIVACY.md](PRIVACY.md) and [SECURITY.md](SECURITY.md) for the detailed data and security model.
+
+## Development
+
+```bash
+python -m pytest -q
+```
+
+The public package is CLI-first. GUI source, GUI tests, and GUI-only dependencies are intentionally not shipped in this repo at this time.

psycgod_sage-2.0.1/pyproject.toml

@@ -0,0 +1,71 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "psycgod-sage"
+version = "2.0.1"
+description = "Local-first command wrapper for AI coding agents with compressed terminal output and privacy-safe proof metrics."
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+  "joblib>=1.3",
+  "keyring>=25",
+  "pandas>=2.0",
+  "PyYAML>=6",
+  "scikit-learn>=1.3",
+  "tiktoken>=0.7",
+]
+
+license = "MIT"
+license-files = ["LICENSE*"]
+authors = [
+  { name = "PsYcGoD" }
+]
+keywords = ["ai", "cli", "terminal", "debugging", "local assistant", "terminal agent"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Topic :: Software Development",
+  "Topic :: Utilities"
+]
+
+[project.optional-dependencies]
+ai = [
+  "anthropic>=0.40",
+  "boto3>=1.34",
+  "google-generativeai>=0.8",
+  "openai>=1.50",
+  "requests>=2.31",
+]
+all = [
+  "anthropic>=0.40",
+  "boto3>=1.34",
+  "google-generativeai>=0.8",
+  "openai>=1.50",
+  "requests>=2.31",
+]
+
+[project.scripts]
+sage = "sage.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/PsYcGoD/sage"
+Repository = "https://github.com/PsYcGoD/sage"
+Issues = "https://github.com/PsYcGoD/sage/issues"
+Dashboard = "https://psyc-god-sage-api.valan-dj.workers.dev/dashboard"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"sage.dashboard" = ["static/*.html"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-m 'not live' --ignore=tests/live --ignore=tests/tests"
+markers = [
+  "live: spawns real CLIs or long-running processes; excluded by default and in CI",
+]

psycgod_sage-2.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+