hermes-project-oracle 2.1.0__tar.gz

hermes_project_oracle-2.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jules Zhou
+
+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.

hermes_project_oracle-2.1.0/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: hermes-project-oracle
+Version: 2.1.0
+Summary: Deep project scanner that generates agent-ready context files — AGENTS.md, CLAUDE.md, Obsidian notes.
+Author-email: Jules Zhou <juleszhou01@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/iruzen-dono/hermes-project-oracle
+Project-URL: Repository, https://github.com/iruzen-dono/hermes-project-oracle
+Project-URL: Issues, https://github.com/iruzen-dono/hermes-project-oracle/issues
+Project-URL: Changelog, https://github.com/iruzen-dono/hermes-project-oracle/blob/main/CHANGELOG.md
+Keywords: ai-agents,agents-md,claude-code,cursor,codex,context-engineering,developer-tools,code-scanner,obsidian
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-cov>=5; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: mypy>=1.11; extra == "dev"
+Requires-Dist: pyyaml>=6; extra == "dev"
+Dynamic: license-file
+
+# Project Oracle 🧠
+
+[![CI](https://github.com/iruzen-dono/hermes-project-oracle/actions/workflows/ci.yml/badge.svg)](https://github.com/iruzen-dono/hermes-project-oracle/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/hermes-project-oracle.svg)](https://pypi.org/project/hermes-project-oracle/)
+[![Python](https://img.shields.io/pypi/pyversions/hermes-project-oracle.svg)](https://pypi.org/project/hermes-project-oracle/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+**Deep project scanner that generates agent-ready context files.**
+
+Scan any codebase and produce `AGENTS.md`, `CLAUDE.md`, or an Obsidian project
+note so a coding agent — Claude Code, Cursor, Codex CLI, OpenClaw, Gemini, or
+Hermes — understands the stack, the real commands, the conventions, and the
+landmines instantly. **Zero dependencies**: pure Python 3.11+ standard library,
+cross-platform (Windows, Linux, macOS).
+
+Unlike a plain generator, Project Oracle also captures **human knowledge a scan
+cannot see**. It interviews you for the project's intent and known pitfalls, then
+embeds both in the generated file — so the agent reads the landmines before it
+touches code.
+
+## Features
+
+- **Every framework, not just the first** — a Next.js + Express + Socket.IO + React project lists all four
+- **Real, runnable commands** — npm scripts captured with their actual shell command, not just the name
+- **Environment variable names** — read from `.env.example`; values are never copied and the real `.env` is never opened
+- **Secret-safe git context** — remote URLs are credential-masked (`https://***@host/...`) and de-duplicated
+- **28 languages detected** — Python, Java, Kotlin, TypeScript, Go, Rust, PHP, C#, Ruby, and more
+- **Build system + test detection** — Maven, Gradle, npm/yarn/pnpm/bun, uv/pip, Cargo, Go modules, Composer; Jest, Vitest, pytest, JUnit, and test-file counts
+- **Monorepo aware** — nested manifests discovered up to 2 levels deep
+- **Intent + pitfalls interview** — embeds project purpose and known landmines
+- **Safe regeneration** — an existing file is never clobbered silently: content
+  between `<!-- oracle:start/end -->` markers is refreshed in place (your edits
+  outside survive), anything else requires `--force` and keeps a `.bak` backup
+- **Multi-template output** — AGENTS.md, CLAUDE.md, Obsidian note, or all in one pass
+- **Cross-platform** — `pathlib` everywhere, no platform-specific code
+
+## Install
+
+**As a CLI** — one command, nothing to clone:
+
+```bash
+pipx install hermes-project-oracle
+# or
+uv tool install hermes-project-oracle
+```
+
+Three commands land on your `PATH`: **`oracle-scan`**, **`oracle-generate`**,
+**`oracle-vault`**.
+
+**As a skill** — for Claude Code, Cursor, Codex, Hermes. The zip carries only
+what the skill needs (`SKILL.md`, `scripts/`, `references/`), no `.git/`, tests
+or build artifacts:
+
+```bash
+git clone https://github.com/iruzen-dono/hermes-project-oracle.git
+cd hermes-project-oracle
+python package_skill.py          # builds hermes-project-oracle.zip + validates it
+
+# Claude Code / generic SKILL.md agents
+unzip hermes-project-oracle.zip -d ~/.claude/skills/
+
+# Hermes Agent
+unzip hermes-project-oracle.zip -d ~/.hermes/skills/
+```
+
+On Windows (PowerShell): `Expand-Archive hermes-project-oracle.zip -DestinationPath $HOME\.claude\skills\`
+
+## Quick start
+
+```bash
+# 1. Scan a project (writes <project>/.oracle/scan-report.json,
+#    and adds .oracle/ to the project's .gitignore when missing)
+oracle-scan --path /path/to/project --output /path/to/project/.oracle/
+
+# 2. Generate AGENTS.md, embedding the interview answers
+oracle-generate \
+  --scan .oracle/scan-report.json \
+  --template agents-md \
+  --output /path/to/project/AGENTS.md \
+  --intent-file .oracle/intent.json
+
+# 3. (Optional) push a note into your Obsidian vault
+oracle-vault --scan .oracle/scan-report.json --vault ~/Documents/"Obsidian Vault"
+```
+
+Running from a skill install instead? Prefix with `python $SKILL/scripts/`
+(`SKILL=~/.claude/skills/hermes-project-oracle`) — the flags are identical.
+
+`--output` accepts a directory (`.oracle/` or `.oracle`) or an explicit JSON
+file path. Run any script with `--help` for all flags.
+
+## Scripts
+
+| Script | Purpose |
+|--------|---------|
+| `scripts/oracle_scan.py` | Deep project scan → JSON report (28 languages, credential-safe) |
+| `scripts/oracle_generate.py` | Report → context files (4 templates + optional intent file) |
+| `scripts/oracle_vault.py` | Push a structured note into an Obsidian vault |
+
+## Docs
+
+- Full skill instructions: [`SKILL.md`](SKILL.md)
+- Interview script (intent + pitfalls): [`references/interview-script.md`](references/interview-script.md)
+- Example intent file: [`references/intent-example.json`](references/intent-example.json)
+- Example generated output: [`references/agents-md-example.md`](references/agents-md-example.md)
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+ruff check .                    # lint (deterministic via ruff.toml)
+mypy scripts/ --ignore-missing-imports
+pytest tests/ -v                # unit + end-to-end (scan → generate → vault)
+pytest tests/ --cov=scripts     # coverage (currently 77%)
+```
+
+The end-to-end test builds a fixture Node project, runs the full pipeline, and
+asserts the output is safe (no leaked tokens, no env values, no absolute paths)
+and complete (commands, frameworks, env names, pitfalls).
+
+## Contributing
+
+PRs welcome! Keep it cross-platform, add tests, preserve the zero-dependency
+promise, and never introduce network calls or credential collection.
+
+## License
+
+MIT

hermes_project_oracle-2.1.0/README.md

@@ -0,0 +1,128 @@
+# Project Oracle 🧠
+
+[![CI](https://github.com/iruzen-dono/hermes-project-oracle/actions/workflows/ci.yml/badge.svg)](https://github.com/iruzen-dono/hermes-project-oracle/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/hermes-project-oracle.svg)](https://pypi.org/project/hermes-project-oracle/)
+[![Python](https://img.shields.io/pypi/pyversions/hermes-project-oracle.svg)](https://pypi.org/project/hermes-project-oracle/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+**Deep project scanner that generates agent-ready context files.**
+
+Scan any codebase and produce `AGENTS.md`, `CLAUDE.md`, or an Obsidian project
+note so a coding agent — Claude Code, Cursor, Codex CLI, OpenClaw, Gemini, or
+Hermes — understands the stack, the real commands, the conventions, and the
+landmines instantly. **Zero dependencies**: pure Python 3.11+ standard library,
+cross-platform (Windows, Linux, macOS).
+
+Unlike a plain generator, Project Oracle also captures **human knowledge a scan
+cannot see**. It interviews you for the project's intent and known pitfalls, then
+embeds both in the generated file — so the agent reads the landmines before it
+touches code.
+
+## Features
+
+- **Every framework, not just the first** — a Next.js + Express + Socket.IO + React project lists all four
+- **Real, runnable commands** — npm scripts captured with their actual shell command, not just the name
+- **Environment variable names** — read from `.env.example`; values are never copied and the real `.env` is never opened
+- **Secret-safe git context** — remote URLs are credential-masked (`https://***@host/...`) and de-duplicated
+- **28 languages detected** — Python, Java, Kotlin, TypeScript, Go, Rust, PHP, C#, Ruby, and more
+- **Build system + test detection** — Maven, Gradle, npm/yarn/pnpm/bun, uv/pip, Cargo, Go modules, Composer; Jest, Vitest, pytest, JUnit, and test-file counts
+- **Monorepo aware** — nested manifests discovered up to 2 levels deep
+- **Intent + pitfalls interview** — embeds project purpose and known landmines
+- **Safe regeneration** — an existing file is never clobbered silently: content
+  between `<!-- oracle:start/end -->` markers is refreshed in place (your edits
+  outside survive), anything else requires `--force` and keeps a `.bak` backup
+- **Multi-template output** — AGENTS.md, CLAUDE.md, Obsidian note, or all in one pass
+- **Cross-platform** — `pathlib` everywhere, no platform-specific code
+
+## Install
+
+**As a CLI** — one command, nothing to clone:
+
+```bash
+pipx install hermes-project-oracle
+# or
+uv tool install hermes-project-oracle
+```
+
+Three commands land on your `PATH`: **`oracle-scan`**, **`oracle-generate`**,
+**`oracle-vault`**.
+
+**As a skill** — for Claude Code, Cursor, Codex, Hermes. The zip carries only
+what the skill needs (`SKILL.md`, `scripts/`, `references/`), no `.git/`, tests
+or build artifacts:
+
+```bash
+git clone https://github.com/iruzen-dono/hermes-project-oracle.git
+cd hermes-project-oracle
+python package_skill.py          # builds hermes-project-oracle.zip + validates it
+
+# Claude Code / generic SKILL.md agents
+unzip hermes-project-oracle.zip -d ~/.claude/skills/
+
+# Hermes Agent
+unzip hermes-project-oracle.zip -d ~/.hermes/skills/
+```
+
+On Windows (PowerShell): `Expand-Archive hermes-project-oracle.zip -DestinationPath $HOME\.claude\skills\`
+
+## Quick start
+
+```bash
+# 1. Scan a project (writes <project>/.oracle/scan-report.json,
+#    and adds .oracle/ to the project's .gitignore when missing)
+oracle-scan --path /path/to/project --output /path/to/project/.oracle/
+
+# 2. Generate AGENTS.md, embedding the interview answers
+oracle-generate \
+  --scan .oracle/scan-report.json \
+  --template agents-md \
+  --output /path/to/project/AGENTS.md \
+  --intent-file .oracle/intent.json
+
+# 3. (Optional) push a note into your Obsidian vault
+oracle-vault --scan .oracle/scan-report.json --vault ~/Documents/"Obsidian Vault"
+```
+
+Running from a skill install instead? Prefix with `python $SKILL/scripts/`
+(`SKILL=~/.claude/skills/hermes-project-oracle`) — the flags are identical.
+
+`--output` accepts a directory (`.oracle/` or `.oracle`) or an explicit JSON
+file path. Run any script with `--help` for all flags.
+
+## Scripts
+
+| Script | Purpose |
+|--------|---------|
+| `scripts/oracle_scan.py` | Deep project scan → JSON report (28 languages, credential-safe) |
+| `scripts/oracle_generate.py` | Report → context files (4 templates + optional intent file) |
+| `scripts/oracle_vault.py` | Push a structured note into an Obsidian vault |
+
+## Docs
+
+- Full skill instructions: [`SKILL.md`](SKILL.md)
+- Interview script (intent + pitfalls): [`references/interview-script.md`](references/interview-script.md)
+- Example intent file: [`references/intent-example.json`](references/intent-example.json)
+- Example generated output: [`references/agents-md-example.md`](references/agents-md-example.md)
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+ruff check .                    # lint (deterministic via ruff.toml)
+mypy scripts/ --ignore-missing-imports
+pytest tests/ -v                # unit + end-to-end (scan → generate → vault)
+pytest tests/ --cov=scripts     # coverage (currently 77%)
+```
+
+The end-to-end test builds a fixture Node project, runs the full pipeline, and
+asserts the output is safe (no leaked tokens, no env values, no absolute paths)
+and complete (commands, frameworks, env names, pitfalls).
+
+## Contributing
+
+PRs welcome! Keep it cross-platform, add tests, preserve the zero-dependency
+promise, and never introduce network calls or credential collection.
+
+## License
+
+MIT

hermes_project_oracle-2.1.0/pyproject.toml

@@ -0,0 +1,73 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "hermes-project-oracle"
+dynamic = ["version"]
+description = "Deep project scanner that generates agent-ready context files — AGENTS.md, CLAUDE.md, Obsidian notes."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Jules Zhou", email = "juleszhou01@gmail.com" }]
+keywords = [
+    "ai-agents",
+    "agents-md",
+    "claude-code",
+    "cursor",
+    "codex",
+    "context-engineering",
+    "developer-tools",
+    "code-scanner",
+    "obsidian",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Documentation",
+    "Topic :: Software Development :: Quality Assurance",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8",
+    "pytest-cov>=5",
+    "ruff>=0.6",
+    "mypy>=1.11",
+    "pyyaml>=6",
+]
+
+[project.urls]
+Homepage = "https://github.com/iruzen-dono/hermes-project-oracle"
+Repository = "https://github.com/iruzen-dono/hermes-project-oracle"
+Issues = "https://github.com/iruzen-dono/hermes-project-oracle/issues"
+Changelog = "https://github.com/iruzen-dono/hermes-project-oracle/blob/main/CHANGELOG.md"
+
+[project.scripts]
+oracle-scan = "oracle_scan:main"
+oracle-generate = "oracle_generate:main"
+oracle-vault = "oracle_vault:main"
+
+[tool.setuptools]
+package-dir = { "" = "scripts" }
+py-modules = ["oracle_scan", "oracle_generate", "oracle_vault", "safe_io", "version"]
+packages = ["oracle_scan_lib"]
+
+[tool.setuptools.dynamic]
+version = { attr = "version.__version__" }
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.mypy]
+python_version = "3.11"
+ignore_missing_imports = true

hermes_project_oracle-2.1.0/scripts/hermes_project_oracle.egg-info/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: hermes-project-oracle
+Version: 2.1.0
+Summary: Deep project scanner that generates agent-ready context files — AGENTS.md, CLAUDE.md, Obsidian notes.
+Author-email: Jules Zhou <juleszhou01@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/iruzen-dono/hermes-project-oracle
+Project-URL: Repository, https://github.com/iruzen-dono/hermes-project-oracle
+Project-URL: Issues, https://github.com/iruzen-dono/hermes-project-oracle/issues
+Project-URL: Changelog, https://github.com/iruzen-dono/hermes-project-oracle/blob/main/CHANGELOG.md
+Keywords: ai-agents,agents-md,claude-code,cursor,codex,context-engineering,developer-tools,code-scanner,obsidian
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-cov>=5; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: mypy>=1.11; extra == "dev"
+Requires-Dist: pyyaml>=6; extra == "dev"
+Dynamic: license-file
+
+# Project Oracle 🧠
+
+[![CI](https://github.com/iruzen-dono/hermes-project-oracle/actions/workflows/ci.yml/badge.svg)](https://github.com/iruzen-dono/hermes-project-oracle/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/hermes-project-oracle.svg)](https://pypi.org/project/hermes-project-oracle/)
+[![Python](https://img.shields.io/pypi/pyversions/hermes-project-oracle.svg)](https://pypi.org/project/hermes-project-oracle/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+**Deep project scanner that generates agent-ready context files.**
+
+Scan any codebase and produce `AGENTS.md`, `CLAUDE.md`, or an Obsidian project
+note so a coding agent — Claude Code, Cursor, Codex CLI, OpenClaw, Gemini, or
+Hermes — understands the stack, the real commands, the conventions, and the
+landmines instantly. **Zero dependencies**: pure Python 3.11+ standard library,
+cross-platform (Windows, Linux, macOS).
+
+Unlike a plain generator, Project Oracle also captures **human knowledge a scan
+cannot see**. It interviews you for the project's intent and known pitfalls, then
+embeds both in the generated file — so the agent reads the landmines before it
+touches code.
+
+## Features
+
+- **Every framework, not just the first** — a Next.js + Express + Socket.IO + React project lists all four
+- **Real, runnable commands** — npm scripts captured with their actual shell command, not just the name
+- **Environment variable names** — read from `.env.example`; values are never copied and the real `.env` is never opened
+- **Secret-safe git context** — remote URLs are credential-masked (`https://***@host/...`) and de-duplicated
+- **28 languages detected** — Python, Java, Kotlin, TypeScript, Go, Rust, PHP, C#, Ruby, and more
+- **Build system + test detection** — Maven, Gradle, npm/yarn/pnpm/bun, uv/pip, Cargo, Go modules, Composer; Jest, Vitest, pytest, JUnit, and test-file counts
+- **Monorepo aware** — nested manifests discovered up to 2 levels deep
+- **Intent + pitfalls interview** — embeds project purpose and known landmines
+- **Safe regeneration** — an existing file is never clobbered silently: content
+  between `<!-- oracle:start/end -->` markers is refreshed in place (your edits
+  outside survive), anything else requires `--force` and keeps a `.bak` backup
+- **Multi-template output** — AGENTS.md, CLAUDE.md, Obsidian note, or all in one pass
+- **Cross-platform** — `pathlib` everywhere, no platform-specific code
+
+## Install
+
+**As a CLI** — one command, nothing to clone:
+
+```bash
+pipx install hermes-project-oracle
+# or
+uv tool install hermes-project-oracle
+```
+
+Three commands land on your `PATH`: **`oracle-scan`**, **`oracle-generate`**,
+**`oracle-vault`**.
+
+**As a skill** — for Claude Code, Cursor, Codex, Hermes. The zip carries only
+what the skill needs (`SKILL.md`, `scripts/`, `references/`), no `.git/`, tests
+or build artifacts:
+
+```bash
+git clone https://github.com/iruzen-dono/hermes-project-oracle.git
+cd hermes-project-oracle
+python package_skill.py          # builds hermes-project-oracle.zip + validates it
+
+# Claude Code / generic SKILL.md agents
+unzip hermes-project-oracle.zip -d ~/.claude/skills/
+
+# Hermes Agent
+unzip hermes-project-oracle.zip -d ~/.hermes/skills/
+```
+
+On Windows (PowerShell): `Expand-Archive hermes-project-oracle.zip -DestinationPath $HOME\.claude\skills\`
+
+## Quick start
+
+```bash
+# 1. Scan a project (writes <project>/.oracle/scan-report.json,
+#    and adds .oracle/ to the project's .gitignore when missing)
+oracle-scan --path /path/to/project --output /path/to/project/.oracle/
+
+# 2. Generate AGENTS.md, embedding the interview answers
+oracle-generate \
+  --scan .oracle/scan-report.json \
+  --template agents-md \
+  --output /path/to/project/AGENTS.md \
+  --intent-file .oracle/intent.json
+
+# 3. (Optional) push a note into your Obsidian vault
+oracle-vault --scan .oracle/scan-report.json --vault ~/Documents/"Obsidian Vault"
+```
+
+Running from a skill install instead? Prefix with `python $SKILL/scripts/`
+(`SKILL=~/.claude/skills/hermes-project-oracle`) — the flags are identical.
+
+`--output` accepts a directory (`.oracle/` or `.oracle`) or an explicit JSON
+file path. Run any script with `--help` for all flags.
+
+## Scripts
+
+| Script | Purpose |
+|--------|---------|
+| `scripts/oracle_scan.py` | Deep project scan → JSON report (28 languages, credential-safe) |
+| `scripts/oracle_generate.py` | Report → context files (4 templates + optional intent file) |
+| `scripts/oracle_vault.py` | Push a structured note into an Obsidian vault |
+
+## Docs
+
+- Full skill instructions: [`SKILL.md`](SKILL.md)
+- Interview script (intent + pitfalls): [`references/interview-script.md`](references/interview-script.md)
+- Example intent file: [`references/intent-example.json`](references/intent-example.json)
+- Example generated output: [`references/agents-md-example.md`](references/agents-md-example.md)
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+ruff check .                    # lint (deterministic via ruff.toml)
+mypy scripts/ --ignore-missing-imports
+pytest tests/ -v                # unit + end-to-end (scan → generate → vault)
+pytest tests/ --cov=scripts     # coverage (currently 77%)
+```
+
+The end-to-end test builds a fixture Node project, runs the full pipeline, and
+asserts the output is safe (no leaked tokens, no env values, no absolute paths)
+and complete (commands, frameworks, env names, pitfalls).
+
+## Contributing
+
+PRs welcome! Keep it cross-platform, add tests, preserve the zero-dependency
+promise, and never introduce network calls or credential collection.
+
+## License
+
+MIT

hermes_project_oracle-2.1.0/scripts/hermes_project_oracle.egg-info/SOURCES.txt

@@ -0,0 +1,25 @@
+LICENSE
+README.md
+pyproject.toml
+scripts/oracle_generate.py
+scripts/oracle_scan.py
+scripts/oracle_vault.py
+scripts/safe_io.py
+scripts/version.py
+scripts/hermes_project_oracle.egg-info/PKG-INFO
+scripts/hermes_project_oracle.egg-info/SOURCES.txt
+scripts/hermes_project_oracle.egg-info/dependency_links.txt
+scripts/hermes_project_oracle.egg-info/entry_points.txt
+scripts/hermes_project_oracle.egg-info/requires.txt
+scripts/hermes_project_oracle.egg-info/top_level.txt
+scripts/oracle_scan_lib/__init__.py
+scripts/oracle_scan_lib/constants.py
+scripts/oracle_scan_lib/conventions.py
+scripts/oracle_scan_lib/detectors.py
+scripts/oracle_scan_lib/io.py
+scripts/oracle_scan_lib/misc.py
+scripts/oracle_scan_lib/structure.py
+scripts/oracle_scan_lib/vcs.py
+tests/test_oracle.py
+tests/test_oracle_hardening.py
+tests/test_oracle_lib.py

hermes_project_oracle-2.1.0/scripts/hermes_project_oracle.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

hermes_project_oracle-2.1.0/scripts/hermes_project_oracle.egg-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+oracle-generate = oracle_generate:main
+oracle-scan = oracle_scan:main
+oracle-vault = oracle_vault:main

hermes_project_oracle-2.1.0/scripts/hermes_project_oracle.egg-info/requires.txt

@@ -0,0 +1,7 @@
+
+[dev]
+pytest>=8
+pytest-cov>=5
+ruff>=0.6
+mypy>=1.11
+pyyaml>=6

hermes_project_oracle-2.1.0/scripts/hermes_project_oracle.egg-info/top_level.txt

@@ -0,0 +1,6 @@
+oracle_generate
+oracle_scan
+oracle_scan_lib
+oracle_vault
+safe_io
+version