Skip to content

audit(2026-05-31): add AGENTS.md operating contract#2

Merged
hizrianraz merged 1 commit into
mainfrom
audit/2026-05-31
May 31, 2026
Merged

audit(2026-05-31): add AGENTS.md operating contract#2
hizrianraz merged 1 commit into
mainfrom
audit/2026-05-31

Conversation

@hizrianraz
Copy link
Copy Markdown
Contributor

@hizrianraz hizrianraz commented May 31, 2026

Part of the org-wide audit — Linear AIN-328. Do not merge without founder review.

Change

  • + AGENTS.md — operating contract for agents-as-users (template = valinor-gateway/AGENTS.md): identity, naming law v1.3 (canonical ainfera-inference; mithril/auto = silent aliases), §0 premise probe, curl-proof definition-of-done, secret rules.

Verified

  • AGENTS.md present; README unchanged otherwise; LICENSE already Apache-2.0; gh description law-compliant.
  • No ainfera-os / valinor-mcp / "Internal OS" in this repo's live surfaces.

🤖 Aulë · audit branch audit/2026-05-31 · not merged.


Note

Low Risk
Documentation-only; no application code, APIs, or auth logic changed.

Overview
Adds AGENTS.md, an operating contract for agents working in this repo (org audit AIN-328, aligned with the valinor-gateway template).

It documents that this package is a public LangChain adapter (not Valinor or “Ainfera OS”), pins naming law v1.3 (canonical wire model ainfera-inference, legacy aliases accepted), and sets process rules: §0 premise checks before edits, curl/quickstart + audit verify as definition of done, and hard secret handling for AINFERA_API_KEY. No runtime or README changes in the diff.

Reviewed by Cursor Bugbot for commit a6ed2a1. Bugbot is set up for automated code reviews on this repo. Configure here.

Adds the agents-as-users operating contract (template = valinor-gateway):
identity, naming law v1.3, §0 premise probe, curl-proof done, secret rules.

Refs AIN-328.
Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

Bugbot Autofix is ON. A cloud agent has been kicked off to fix the reported issue.

Reviewed by Cursor Bugbot for commit a6ed2a1. Configure here.

Comment thread AGENTS.md
./curl-example.sh # no-deps path (where present)
# or the framework path in the README Quickstart
```
Done = a routed completion **and** an audit receipt the `verify` tool accepts. PR opened ≠ shipped.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Export skips audit verify step

Medium Severity

The Definition of done requires signup, routed inference, and audit verify, but the sample commands export AINFERA_API_KEY before ./curl-example.sh. With a key already set, that script reuses the key, skips signup, leaves AGENT_ID empty, and never runs the audit verify curl—so the documented sequence cannot satisfy the stated completion criteria.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit a6ed2a1. Configure here.

@hizrianraz hizrianraz merged commit 8a1a295 into main May 31, 2026
3 checks passed
@hizrianraz hizrianraz deleted the audit/2026-05-31 branch May 31, 2026 09:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant