storageops 0.4.14__tar.gz

storageops-0.4.14/MANIFEST.in

@@ -0,0 +1,5 @@
+recursive-include storageops_cli/extensions *
+recursive-include storageops_cli/skills *
+global-exclude *.py[cod]
+global-exclude __pycache__
+prune **/__pycache__

storageops-0.4.14/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: storageops
+Version: 0.4.14
+Summary: StorageOps — S3-compatible object storage diagnostic toolkit. A Pi Coding Agent extension + skill pack.
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Internet :: Log Analysis
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+
+# StorageOps
+
+StorageOps is a Pi Coding Agent extension and skill pack for diagnosing S3-compatible object storage problems.
+
+It is designed for cases like `AccessDenied`, `SlowDown`, `SignatureDoesNotMatch`, checksum mismatches, stale reads, broken lifecycle rules, failed notifications, and migration surprises. You provide logs, errors, configs, or a short description; Pi loads the StorageOps skills and tools to produce an evidence-based diagnosis.
+
+## What You Get
+
+- 16 diagnostic skills covering security, protocol compatibility, CLI/SDK behavior, performance, network access, lifecycle cost, replication, mount/workspace usage, migration, data consistency, access logs, big-data pipelines, notifications, reporting, and triage, plus 1 eval skill pack.
+- 3 Pi extension tools:
+  - `scan_secrets` redacts credentials and tokens.
+  - `detect_domain` ranks likely diagnostic domains from evidence text.
+  - `search_memory` searches prior Pi sessions for related diagnoses.
+- Deterministic helper scripts for access logs, policy analysis, throttling, ETags, small-object cost, migration estimates, SigV4 parsing, endpoint reachability, and golden-case eval.
+- A regression suite with 33 compact golden cases and size gates to keep the repository lean.
+
+## Quick Start
+
+**Prerequisites:** Node.js 18+, Python 3.11+, and a model provider key.
+
+```bash
+# 1. Install Pi Coding Agent (the runtime engine)
+#    storageops install does this automatically, but you can also install manually:
+npm install -g @earendil-works/pi-coding-agent
+
+# 2. Install StorageOps
+pip install storageops
+storageops install
+
+# 3. Configure a model key (pick one)
+export ANTHROPIC_API_KEY=sk-...
+export DEEPSEEK_API_KEY=sk-...
+export OPENAI_API_KEY=sk-...
+
+# 4. Run a diagnosis
+storageops --print 's5cmd sync reports 429 SlowDown; diagnose likely cause'
+```
+
+> **Ubuntu / Debian:** If `pip install storageops` fails with
+> "externally-managed-environment", use
+> `pip install storageops --break-system-packages` or create a virtualenv first.
+
+`storageops install` automatically installs Pi Coding Agent via npm if it is not
+already present. It warns (but does not auto-upgrade) when an older Pi version is
+detected, to avoid disrupting existing Pi configurations.
+
+## Configure a Model Key
+
+Use any one of these patterns:
+
+```bash
+export DEEPSEEK_API_KEY=sk-...
+export ANTHROPIC_API_KEY=sk-...
+export OPENAI_API_KEY=sk-...
+```
+
+Or store a local key for the selected StorageOps/Pi agent directory:
+
+```bash
+echo sk-... > ~/.storageops/agent/api-key
+chmod 600 ~/.storageops/agent/api-key
+```
+
+You can also pass Pi-native options through `storageops`, for example `--provider`, `--model`, `--api-key`, `--print`, `--resume`, or `@file` inputs.
+
+## Install Modes
+
+Independent mode is the default:
+
+```bash
+storageops install
+```
+
+It writes:
+
+```text
+~/.storageops/
+├── agent/
+│   ├── settings.json
+│   ├── api-key
+│   ├── extensions/storageops.ts
+│   └── sessions/
+└── skills/
+```
+
+Merge mode installs into an existing Pi setup:
+
+```bash
+storageops install --merge
+```
+
+It writes the extension to `~/.pi/agent/extensions/`, skills to `~/.pi/skills/`, and backs up `settings.json` before merging StorageOps settings.
+
+## Typical Workflows
+
+Single-shot diagnosis:
+
+```bash
+storageops --print @rclone-debug.log 'Explain the checksum mismatch and safe next steps'
+```
+
+Interactive diagnosis:
+
+```bash
+storageops
+```
+
+Refresh an install after upgrade:
+
+```bash
+pip install --upgrade storageops
+storageops install --force
+```
+
+Run quality gates from a checkout:
+
+```bash
+python3 scripts/skill_integrity_check.py
+python3 skills/storageops-eval-golden-cases/scripts/golden_case_validator.py \
+  skills/storageops-eval-golden-cases/cases
+make validate
+```
+
+## Documentation Map
+
+- [Getting Started](docs/getting-started.md)
+- [CLI Reference](docs/cli-reference.md)
+- [Architecture](docs/ARCHITECTURE.md)
+- [Quick Reference](docs/quick-reference.md)
+- [Tutorial](docs/tutorial.md)
+- [Skill Quality Guide](docs/skill-quality-guide.md)
+- [Skill Taxonomy](docs/skill-taxonomy.md)
+- [Routing Flowchart](docs/skill-routing-flowchart.md)
+- [Dependency Map](docs/skill-dependency-map.md)
+- [API Coverage Matrix](docs/api-coverage-matrix.md)
+- [Examples](docs/examples/)
+- [Changelog](CHANGELOG.md)
+- [Security](SECURITY.md)
+- [Contributing](CONTRIBUTING.md)
+
+## Repository Note
+
+The source tree keeps canonical skills at repository root and exposes them through `storageops_cli/skills -> ../skills` for packaging. The installer expects packaged skills to be available next to `storageops_cli`; review distribution changes carefully.
+
+## License
+
+MIT

storageops-0.4.14/README.md

@@ -0,0 +1,147 @@
+# StorageOps
+
+StorageOps is a Pi Coding Agent extension and skill pack for diagnosing S3-compatible object storage problems.
+
+It is designed for cases like `AccessDenied`, `SlowDown`, `SignatureDoesNotMatch`, checksum mismatches, stale reads, broken lifecycle rules, failed notifications, and migration surprises. You provide logs, errors, configs, or a short description; Pi loads the StorageOps skills and tools to produce an evidence-based diagnosis.
+
+## What You Get
+
+- 16 diagnostic skills covering security, protocol compatibility, CLI/SDK behavior, performance, network access, lifecycle cost, replication, mount/workspace usage, migration, data consistency, access logs, big-data pipelines, notifications, reporting, and triage, plus 1 eval skill pack.
+- 3 Pi extension tools:
+  - `scan_secrets` redacts credentials and tokens.
+  - `detect_domain` ranks likely diagnostic domains from evidence text.
+  - `search_memory` searches prior Pi sessions for related diagnoses.
+- Deterministic helper scripts for access logs, policy analysis, throttling, ETags, small-object cost, migration estimates, SigV4 parsing, endpoint reachability, and golden-case eval.
+- A regression suite with 33 compact golden cases and size gates to keep the repository lean.
+
+## Quick Start
+
+**Prerequisites:** Node.js 18+, Python 3.11+, and a model provider key.
+
+```bash
+# 1. Install Pi Coding Agent (the runtime engine)
+#    storageops install does this automatically, but you can also install manually:
+npm install -g @earendil-works/pi-coding-agent
+
+# 2. Install StorageOps
+pip install storageops
+storageops install
+
+# 3. Configure a model key (pick one)
+export ANTHROPIC_API_KEY=sk-...
+export DEEPSEEK_API_KEY=sk-...
+export OPENAI_API_KEY=sk-...
+
+# 4. Run a diagnosis
+storageops --print 's5cmd sync reports 429 SlowDown; diagnose likely cause'
+```
+
+> **Ubuntu / Debian:** If `pip install storageops` fails with
+> "externally-managed-environment", use
+> `pip install storageops --break-system-packages` or create a virtualenv first.
+
+`storageops install` automatically installs Pi Coding Agent via npm if it is not
+already present. It warns (but does not auto-upgrade) when an older Pi version is
+detected, to avoid disrupting existing Pi configurations.
+
+## Configure a Model Key
+
+Use any one of these patterns:
+
+```bash
+export DEEPSEEK_API_KEY=sk-...
+export ANTHROPIC_API_KEY=sk-...
+export OPENAI_API_KEY=sk-...
+```
+
+Or store a local key for the selected StorageOps/Pi agent directory:
+
+```bash
+echo sk-... > ~/.storageops/agent/api-key
+chmod 600 ~/.storageops/agent/api-key
+```
+
+You can also pass Pi-native options through `storageops`, for example `--provider`, `--model`, `--api-key`, `--print`, `--resume`, or `@file` inputs.
+
+## Install Modes
+
+Independent mode is the default:
+
+```bash
+storageops install
+```
+
+It writes:
+
+```text
+~/.storageops/
+├── agent/
+│   ├── settings.json
+│   ├── api-key
+│   ├── extensions/storageops.ts
+│   └── sessions/
+└── skills/
+```
+
+Merge mode installs into an existing Pi setup:
+
+```bash
+storageops install --merge
+```
+
+It writes the extension to `~/.pi/agent/extensions/`, skills to `~/.pi/skills/`, and backs up `settings.json` before merging StorageOps settings.
+
+## Typical Workflows
+
+Single-shot diagnosis:
+
+```bash
+storageops --print @rclone-debug.log 'Explain the checksum mismatch and safe next steps'
+```
+
+Interactive diagnosis:
+
+```bash
+storageops
+```
+
+Refresh an install after upgrade:
+
+```bash
+pip install --upgrade storageops
+storageops install --force
+```
+
+Run quality gates from a checkout:
+
+```bash
+python3 scripts/skill_integrity_check.py
+python3 skills/storageops-eval-golden-cases/scripts/golden_case_validator.py \
+  skills/storageops-eval-golden-cases/cases
+make validate
+```
+
+## Documentation Map
+
+- [Getting Started](docs/getting-started.md)
+- [CLI Reference](docs/cli-reference.md)
+- [Architecture](docs/ARCHITECTURE.md)
+- [Quick Reference](docs/quick-reference.md)
+- [Tutorial](docs/tutorial.md)
+- [Skill Quality Guide](docs/skill-quality-guide.md)
+- [Skill Taxonomy](docs/skill-taxonomy.md)
+- [Routing Flowchart](docs/skill-routing-flowchart.md)
+- [Dependency Map](docs/skill-dependency-map.md)
+- [API Coverage Matrix](docs/api-coverage-matrix.md)
+- [Examples](docs/examples/)
+- [Changelog](CHANGELOG.md)
+- [Security](SECURITY.md)
+- [Contributing](CONTRIBUTING.md)
+
+## Repository Note
+
+The source tree keeps canonical skills at repository root and exposes them through `storageops_cli/skills -> ../skills` for packaging. The installer expects packaged skills to be available next to `storageops_cli`; review distribution changes carefully.
+
+## License
+
+MIT

storageops-0.4.14/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "storageops"
+version = "0.4.14"
+description = "StorageOps — S3-compatible object storage diagnostic toolkit. A Pi Coding Agent extension + skill pack."
+requires-python = ">=3.11"
+readme = "README.md"
+license = {text = "MIT"}
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: System :: Systems Administration",
+    "Topic :: Internet :: Log Analysis",
+]
+
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "build>=1.0",
+]
+
+[project.scripts]
+storageops = "storageops_cli:main"
+
+[tool.setuptools.packages.find]
+include = ["storageops_cli", "storageops_cli.*"]
+
+[tool.setuptools.package-data]
+storageops_cli = ["extensions/*", "skills/**"]
+
+[tool.setuptools.exclude-package-data]
+storageops_cli = ["**/__pycache__/*", "**/*.pyc", "**/*.pyo"]
+
+[tool.ruff]
+line-length = 100

storageops-0.4.14/setup.cfg

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

storageops-0.4.14/storageops.egg-info/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: storageops
+Version: 0.4.14
+Summary: StorageOps — S3-compatible object storage diagnostic toolkit. A Pi Coding Agent extension + skill pack.
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Internet :: Log Analysis
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+
+# StorageOps
+
+StorageOps is a Pi Coding Agent extension and skill pack for diagnosing S3-compatible object storage problems.
+
+It is designed for cases like `AccessDenied`, `SlowDown`, `SignatureDoesNotMatch`, checksum mismatches, stale reads, broken lifecycle rules, failed notifications, and migration surprises. You provide logs, errors, configs, or a short description; Pi loads the StorageOps skills and tools to produce an evidence-based diagnosis.
+
+## What You Get
+
+- 16 diagnostic skills covering security, protocol compatibility, CLI/SDK behavior, performance, network access, lifecycle cost, replication, mount/workspace usage, migration, data consistency, access logs, big-data pipelines, notifications, reporting, and triage, plus 1 eval skill pack.
+- 3 Pi extension tools:
+  - `scan_secrets` redacts credentials and tokens.
+  - `detect_domain` ranks likely diagnostic domains from evidence text.
+  - `search_memory` searches prior Pi sessions for related diagnoses.
+- Deterministic helper scripts for access logs, policy analysis, throttling, ETags, small-object cost, migration estimates, SigV4 parsing, endpoint reachability, and golden-case eval.
+- A regression suite with 33 compact golden cases and size gates to keep the repository lean.
+
+## Quick Start
+
+**Prerequisites:** Node.js 18+, Python 3.11+, and a model provider key.
+
+```bash
+# 1. Install Pi Coding Agent (the runtime engine)
+#    storageops install does this automatically, but you can also install manually:
+npm install -g @earendil-works/pi-coding-agent
+
+# 2. Install StorageOps
+pip install storageops
+storageops install
+
+# 3. Configure a model key (pick one)
+export ANTHROPIC_API_KEY=sk-...
+export DEEPSEEK_API_KEY=sk-...
+export OPENAI_API_KEY=sk-...
+
+# 4. Run a diagnosis
+storageops --print 's5cmd sync reports 429 SlowDown; diagnose likely cause'
+```
+
+> **Ubuntu / Debian:** If `pip install storageops` fails with
+> "externally-managed-environment", use
+> `pip install storageops --break-system-packages` or create a virtualenv first.
+
+`storageops install` automatically installs Pi Coding Agent via npm if it is not
+already present. It warns (but does not auto-upgrade) when an older Pi version is
+detected, to avoid disrupting existing Pi configurations.
+
+## Configure a Model Key
+
+Use any one of these patterns:
+
+```bash
+export DEEPSEEK_API_KEY=sk-...
+export ANTHROPIC_API_KEY=sk-...
+export OPENAI_API_KEY=sk-...
+```
+
+Or store a local key for the selected StorageOps/Pi agent directory:
+
+```bash
+echo sk-... > ~/.storageops/agent/api-key
+chmod 600 ~/.storageops/agent/api-key
+```
+
+You can also pass Pi-native options through `storageops`, for example `--provider`, `--model`, `--api-key`, `--print`, `--resume`, or `@file` inputs.
+
+## Install Modes
+
+Independent mode is the default:
+
+```bash
+storageops install
+```
+
+It writes:
+
+```text
+~/.storageops/
+├── agent/
+│   ├── settings.json
+│   ├── api-key
+│   ├── extensions/storageops.ts
+│   └── sessions/
+└── skills/
+```
+
+Merge mode installs into an existing Pi setup:
+
+```bash
+storageops install --merge
+```
+
+It writes the extension to `~/.pi/agent/extensions/`, skills to `~/.pi/skills/`, and backs up `settings.json` before merging StorageOps settings.
+
+## Typical Workflows
+
+Single-shot diagnosis:
+
+```bash
+storageops --print @rclone-debug.log 'Explain the checksum mismatch and safe next steps'
+```
+
+Interactive diagnosis:
+
+```bash
+storageops
+```
+
+Refresh an install after upgrade:
+
+```bash
+pip install --upgrade storageops
+storageops install --force
+```
+
+Run quality gates from a checkout:
+
+```bash
+python3 scripts/skill_integrity_check.py
+python3 skills/storageops-eval-golden-cases/scripts/golden_case_validator.py \
+  skills/storageops-eval-golden-cases/cases
+make validate
+```
+
+## Documentation Map
+
+- [Getting Started](docs/getting-started.md)
+- [CLI Reference](docs/cli-reference.md)
+- [Architecture](docs/ARCHITECTURE.md)
+- [Quick Reference](docs/quick-reference.md)
+- [Tutorial](docs/tutorial.md)
+- [Skill Quality Guide](docs/skill-quality-guide.md)
+- [Skill Taxonomy](docs/skill-taxonomy.md)
+- [Routing Flowchart](docs/skill-routing-flowchart.md)
+- [Dependency Map](docs/skill-dependency-map.md)
+- [API Coverage Matrix](docs/api-coverage-matrix.md)
+- [Examples](docs/examples/)
+- [Changelog](CHANGELOG.md)
+- [Security](SECURITY.md)
+- [Contributing](CONTRIBUTING.md)
+
+## Repository Note
+
+The source tree keeps canonical skills at repository root and exposes them through `storageops_cli/skills -> ../skills` for packaging. The installer expects packaged skills to be available next to `storageops_cli`; review distribution changes carefully.
+
+## License
+
+MIT