Metadata-Version: 2.4
Name: project-oracle
Version: 2.5.1
Summary: Short install name for hermes-project-oracle: audit AGENTS.md / CLAUDE.md against the repository, and generate it when missing.
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: agents-md,claude-md,ai-agents,context-engineering,developer-tools
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: hermes-project-oracle>=2.5.1
Dynamic: license-file

# project-oracle

Short install name for **[hermes-project-oracle](https://pypi.org/project/hermes-project-oracle/)**.
This package ships no code: it depends on the real distribution, which provides
the five `oracle-*` commands.

```bash
pipx install project-oracle
```

Because the console scripts come from the dependency, every command is on your
`PATH` after install: `oracle-lint`, `oracle-check`, `oracle-scan`,
`oracle-generate`, `oracle-vault`.

## What you get

`oracle-lint` audits the context file your coding agent reads and tells you which
rules the repository backs, which it contradicts, and which are unfalsifiable
noise:

```
$ oracle-lint AGENTS.md

✗ L5    Run `npm run test` before opening a pull request.
         `npm run test` does not exist (scripts: build, lint, start)
✓ L6    Build with `npm run build`.
         `npm run build` exists in package.json
⚠ L7    Always write clean, maintainable code.
         no definition of 'clean' to verify against
```

`oracle-check` does the same job for CI: it fails the build when the context has
drifted from the repository.

See the [main repository](https://github.com/iruzen-dono/hermes-project-oracle)
for the full documentation.

MIT.
