@agentsfleet/orly 0.5.0

package/fixtures/registry-invalid.json

@@ -0,0 +1 @@
+{"schema_version": 0}

package/fixtures/registry-valid.json

@@ -0,0 +1,18 @@
+{
+  "schema_version": 1,
+  "core_documents": ["core/operating-model.md"],
+  "packs": {
+    "fixture": {
+      "extensions": [],
+      "managed_files": []
+    }
+  },
+  "rules": [
+    {
+      "key": "fixture.judgment",
+      "state": "active",
+      "decision": "judgment",
+      "pack": "fixture"
+    }
+  ]
+}

package/fixtures/unclosed-pack-block.md

@@ -0,0 +1,8 @@
+# Fixture: unclosed pack block
+
+This document opens a pack block and never closes it. the render must
+throw ("unclosed orly pack block") — the fail fixture for
+governance.render.stable.
+
+<!-- oracle-packs:start language.zig -->
+Zig-only prose that never ends.

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@agentsfleet/orly",
+  "version": "0.5.0",
+  "description": "Repository-scoped engineering harness: renders agent rules, materialises the gates that enforce them, and proves the PR boundary — for any coding agent.",
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "test": "bun test src",
+    "typecheck": "tsc --noEmit"
+  },
+  "bin": {
+    "orly": "bin/orly"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentsfleet/orly.git"
+  },
+  "homepage": "https://github.com/agentsfleet/orly#readme",
+  "bugs": {
+    "url": "https://github.com/agentsfleet/orly/issues"
+  },
+  "keywords": [
+    "agents",
+    "coding-agent",
+    "governance",
+    "git-hooks",
+    "lint",
+    "claude",
+    "codex",
+    "opencode",
+    "amp"
+  ],
+  "engines": {
+    "bun": ">=1.4.0"
+  },
+  "files": [
+    "bin/orly",
+    ".githooks/",
+    "dispatch/",
+    "audits/",
+    "docs/*.md",
+    "docs/greptile-learnings/",
+    "skills/orly-write-unit-test/",
+    "skills/orly-write-integration-test/",
+    "skills/orly-spec-new/",
+    "skills/orly-babysit-prs/",
+    "core/",
+    "packs/",
+    "schemas/",
+    "fixtures/",
+    "src/",
+    "registry.json",
+    "AGENTS.md",
+    "SOUL.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/bun": "1.4.0",
+    "typescript": "7.0.2"
+  }
+}

package/packs/language/go/rules.md

@@ -0,0 +1,24 @@
+# Go authoring
+
+Return errors, do not panic across a package boundary. Wrap with `%w` so the
+caller can still match the cause, and add context the caller does not already
+have — never re-wrap the same fact twice.
+
+Every goroutine needs a stated exit: a `context.Context` it honours, a channel
+close, or a `WaitGroup` the caller waits on. A goroutine with no exit path is a
+leak whatever the test says. Take a `context.Context` as the first parameter on
+anything that blocks, and pass it down rather than storing it in a struct.
+
+Defer the release beside the acquire — `defer file.Close()`, `defer mu.Unlock()`
+— so the pairing survives an early return. Check the error from a deferred
+`Close` on a writer; a dropped flush is a silent truncation.
+
+Accept interfaces, return structs, and define the interface where it is
+consumed. Keep zero values usable so a caller need not call a constructor to get
+a working value.
+
+Table-driven tests are the default shape. Concurrency work needs a `-race` run,
+and a deterministic contention test rather than a sleep.
+
+The repository owns formatting, vet, lint, build, and test commands — it
+declares them in `.oracle/orly.json`.

package/packs/language/mdx/rules.md

@@ -0,0 +1,7 @@
+# Markdown JSX authoring
+
+Treat Markdown JSX (MDX) as a language, not generic prose. Validate front matter,
+component nesting, links, code fences, and accessible image descriptions.
+
+Mintlify behavior belongs to the Mintlify domain pack. An MDX repository that
+does not use Mintlify must not receive Mintlify-specific rules.

package/packs/language/python/rules.md

@@ -0,0 +1,8 @@
+# Python authoring
+
+Use standard-library parsers for structured input. Keep resource ownership in
+context managers. Validate data at parse boundaries and preserve specific
+exception classes until the caller can decide how to respond.
+
+The repository owns formatting, linting, type checking, and tests — it declares
+them in `.oracle/orly.json`.

package/packs/language/rust/rules.md

@@ -0,0 +1,38 @@
+# Rust authoring
+
+Use ownership and borrowing to make resource lifetime visible. Keep `unsafe`
+blocks small and state the invariant they rely on. Preserve error variants until
+the caller has enough information to decide whether to retry or stop.
+
+Test the feature combinations the repository actually builds. Concurrency work
+needs a deterministic contention test, not only a happy-path asynchronous test.
+
+The repository owns formatting, Clippy, build, test, security, and benchmark
+commands — it declares them in `.oracle/orly.json`.
+
+## Reference guideline (mandatory in review)
+
+Microsoft's Pragmatic Rust Guidelines are this pack's depth — thorough,
+agent-facing, and continuously maintained upstream. The local copy lives at
+`~/Projects/oss/rust-guidelines/all.txt`; fetch it when absent:
+
+```bash
+mkdir -p ~/Projects/oss/rust-guidelines && \
+  curl -fsSL https://microsoft.github.io/rust-guidelines/agents/all.txt \
+  -o ~/Projects/oss/rust-guidelines/all.txt
+```
+
+Every Rust REVIEW — and any adversarial pass over `*.rs` — reads it
+**sectioned, never whole-file** (186 sections):
+`grep -nE "^#+ " ~/Projects/oss/rust-guidelines/all.txt`, read the sections
+the diff touches, and cite the guideline IDs (`M-…` mnemonics, e.g.
+`M-UNSOUND`, `M-SIMPLE-ABSTRACTIONS`) applied or consciously diverged from.
+Local convention wins on conflict, but the divergence is named in the review
+output. Refresh the copy when the user asks or a cited rule looks stale
+(re-run the fetch; upstream updates continuously).
+
+## Evolution
+
+This pack is young next to the Zig façade and grows the same way: a Rust
+incident worth keeping becomes a rule or **Example:** line via the
+rule-extension protocol — never a memory file, never a milestone cite.

package/packs/language/shell/rules.md

@@ -0,0 +1,8 @@
+# Shell authoring
+
+Quote expansions, use arrays for argument lists, and clean temporary files on
+every exit path. Avoid `eval` for external input. Match the repository's required
+shell and macOS Bash compatibility level.
+
+The repository owns ShellCheck and executable tests — it declares them in
+`.oracle/orly.json`.

package/registry.json

@@ -0,0 +1,405 @@
+{
+  "schema_version": 1,
+  "core_documents": [
+    "core/operating-model.md",
+    "SOUL.md"
+  ],
+  "packs": {
+    "persona.indy": {
+      "extensions": [],
+      "managed_files": []
+    },
+    "universal.authoring": {
+      "extensions": [],
+      "managed_files": [
+        {
+          "source": "dispatch/write_any.md",
+          "target": "dispatch/write_any.md"
+        },
+        {
+          "source": "dispatch/write_any.sh",
+          "target": "dispatch/write_any.sh"
+        },
+        {
+          "source": "dispatch/lib.sh",
+          "target": "dispatch/lib.sh"
+        },
+        {
+          "source": "dispatch/lifecycle.md",
+          "target": "dispatch/lifecycle.md"
+        },
+        {
+          "source": "dispatch/name_architecture.md",
+          "target": "dispatch/name_architecture.md"
+        },
+        {
+          "source": "audits/ufs.sh",
+          "target": "audits/ufs.sh"
+        },
+        {
+          "source": "audits/logging.sh",
+          "target": "audits/logging.sh"
+        },
+        {
+          "source": "audits/msid-ui.sh",
+          "target": "audits/msid-ui.sh"
+        },
+        {
+          "source": "docs/greptile-learnings/RULES.md",
+          "target": "docs/greptile-learnings/RULES.md"
+        }
+      ]
+    },
+    "language.zig": {
+      "extensions": [
+        ".zig"
+      ],
+      "managed_files": [
+        {
+          "source": "dispatch/write_zig.md",
+          "target": "dispatch/write_zig.md"
+        },
+        {
+          "source": "dispatch/write_zig.sh",
+          "target": "dispatch/write_zig.sh"
+        },
+        {
+          "source": "audits/deinit-pairs.sh",
+          "target": "audits/deinit-pairs.sh"
+        },
+        {
+          "source": "audits/sql-mod.sh",
+          "target": "audits/sql-mod.sh"
+        },
+        {
+          "source": "docs/LIFECYCLE_PATTERNS.md",
+          "target": "docs/LIFECYCLE_PATTERNS.md"
+        }
+      ]
+    },
+    "language.typescript": {
+      "extensions": [
+        ".ts",
+        ".tsx"
+      ],
+      "managed_files": [
+        {
+          "source": "dispatch/write_ts_adhere_bun.md",
+          "target": "dispatch/write_ts_adhere_bun.md"
+        },
+        {
+          "source": "dispatch/write_ts_adhere_bun.sh",
+          "target": "dispatch/write_ts_adhere_bun.sh"
+        }
+      ]
+    },
+    "language.javascript": {
+      "extensions": [
+        ".js",
+        ".jsx"
+      ],
+      "managed_files": [
+        {
+          "source": "dispatch/write_ts_adhere_bun.md",
+          "target": "dispatch/write_ts_adhere_bun.md"
+        },
+        {
+          "source": "dispatch/write_ts_adhere_bun.sh",
+          "target": "dispatch/write_ts_adhere_bun.sh"
+        }
+      ]
+    },
+    "language.rust": {
+      "extensions": [
+        ".rs"
+      ],
+      "managed_files": [
+        {
+          "source": "packs/language/rust/rules.md",
+          "target": "dispatch/write_rust.md"
+        }
+      ]
+    },
+    "language.go": {
+      "extensions": [
+        ".go"
+      ],
+      "managed_files": [
+        {
+          "source": "packs/language/go/rules.md",
+          "target": "dispatch/write_go.md"
+        }
+      ]
+    },
+    "language.python": {
+      "extensions": [
+        ".py"
+      ],
+      "managed_files": [
+        {
+          "source": "packs/language/python/rules.md",
+          "target": "dispatch/write_python.md"
+        }
+      ]
+    },
+    "language.shell": {
+      "extensions": [
+        ".sh"
+      ],
+      "managed_files": [
+        {
+          "source": "packs/language/shell/rules.md",
+          "target": "dispatch/write_shell.md"
+        }
+      ]
+    },
+    "language.mdx": {
+      "extensions": [
+        ".mdx"
+      ],
+      "managed_files": [
+        {
+          "source": "packs/language/mdx/rules.md",
+          "target": "dispatch/write_mdx.md"
+        }
+      ]
+    },
+    "domain.sql": {
+      "extensions": [
+        ".sql"
+      ],
+      "managed_files": [
+        {
+          "source": "dispatch/write_sql.md",
+          "target": "dispatch/write_sql.md"
+        },
+        {
+          "source": "dispatch/write_sql.sh",
+          "target": "dispatch/write_sql.sh"
+        },
+        {
+          "source": "docs/SCHEMA_CONVENTIONS.md",
+          "target": "docs/SCHEMA_CONVENTIONS.md"
+        }
+      ]
+    },
+    "domain.http": {
+      "extensions": [],
+      "managed_files": [
+        {
+          "source": "dispatch/write_http.md",
+          "target": "dispatch/write_http.md"
+        },
+        {
+          "source": "docs/REST_API_DESIGN_GUIDELINES.md",
+          "target": "docs/REST_API_DESIGN_GUIDELINES.md"
+        }
+      ]
+    },
+    "domain.auth": {
+      "extensions": [],
+      "managed_files": [
+        {
+          "source": "dispatch/write_auth.md",
+          "target": "dispatch/write_auth.md"
+        }
+      ]
+    },
+    "domain.documentation": {
+      "extensions": [],
+      "managed_files": [
+        {
+          "source": "dispatch/write_documentation.md",
+          "target": "dispatch/write_documentation.md"
+        },
+        {
+          "source": "docs/DOCUMENTATION_RULES.md",
+          "target": "docs/DOCUMENTATION_RULES.md"
+        }
+      ]
+    },
+    "domain.changelog": {
+      "extensions": [],
+      "managed_files": [
+        {
+          "source": "dispatch/write_changelog.md",
+          "target": "dispatch/write_changelog.md"
+        },
+        {
+          "source": "docs/CHANGELOG_VOICE.md",
+          "target": "docs/CHANGELOG_VOICE.md"
+        }
+      ]
+    },
+    "workflow.specifications": {
+      "extensions": [],
+      "managed_files": [
+        {
+          "source": "dispatch/write_spec.md",
+          "target": "dispatch/write_spec.md"
+        },
+        {
+          "source": "docs/TEMPLATE.md",
+          "target": "docs/TEMPLATE.md"
+        },
+        {
+          "source": "audits/spec-template.sh",
+          "target": "audits/spec-template.sh"
+        }
+      ]
+    },
+    "workflow.governance": {
+      "extensions": [],
+      "managed_files": [
+        {
+          "source": "dispatch/edit_rules.md",
+          "target": "dispatch/edit_rules.md"
+        },
+        {
+          "source": "audits/agents-md.md",
+          "target": "audits/agents-md.md"
+        },
+        {
+          "source": "docs/ORLY_ARCHITECTURE.md",
+          "target": "docs/ORLY_ARCHITECTURE.md"
+        }
+      ]
+    },
+    "product.agentsfleet": {
+      "extensions": [],
+      "managed_files": [
+        {
+          "source": "audits/cross-tier-rates.sh",
+          "target": "audits/cross-tier-rates.sh"
+        },
+        {
+          "source": "audits/design-tokens.sh",
+          "target": "audits/design-tokens.sh"
+        },
+        {
+          "source": "audits/error-codes.sh",
+          "target": "audits/error-codes.sh"
+        },
+        {
+          "source": "docs/EXECUTE_DOC_READS.md",
+          "target": "docs/EXECUTE_DOC_READS.md"
+        },
+        {
+          "source": "docs/HARNESS_VERIFY_OUTPUT.md",
+          "target": "docs/HARNESS_VERIFY_OUTPUT.md"
+        },
+        {
+          "source": "docs/LOGGING_STANDARD.md",
+          "target": "docs/LOGGING_STANDARD.md"
+        },
+        {
+          "source": "dispatch/verify.md",
+          "target": "dispatch/verify.md"
+        },
+        {
+          "source": "docs/VERIFY_TIERS.md",
+          "target": "docs/VERIFY_TIERS.md"
+        }
+      ]
+    },
+    "workflow.skills": {
+      "extensions": [],
+      "managed_files": [
+        {
+          "source": "skills/orly-spec-new/SKILL.md",
+          "target": ".claude/skills/orly-spec-new/SKILL.md"
+        },
+        {
+          "source": "skills/orly-spec-new/SKILL.md",
+          "target": ".agents/skills/orly-spec-new/SKILL.md"
+        },
+        {
+          "source": "skills/orly-spec-new/SKILL.md",
+          "target": ".opencode/skills/orly-spec-new/SKILL.md"
+        },
+        {
+          "source": "skills/orly-write-unit-test/SKILL.md",
+          "target": ".claude/skills/orly-write-unit-test/SKILL.md"
+        },
+        {
+          "source": "skills/orly-write-unit-test/SKILL.md",
+          "target": ".agents/skills/orly-write-unit-test/SKILL.md"
+        },
+        {
+          "source": "skills/orly-write-unit-test/SKILL.md",
+          "target": ".opencode/skills/orly-write-unit-test/SKILL.md"
+        },
+        {
+          "source": "skills/orly-write-integration-test/SKILL.md",
+          "target": ".claude/skills/orly-write-integration-test/SKILL.md"
+        },
+        {
+          "source": "skills/orly-write-integration-test/SKILL.md",
+          "target": ".agents/skills/orly-write-integration-test/SKILL.md"
+        },
+        {
+          "source": "skills/orly-write-integration-test/SKILL.md",
+          "target": ".opencode/skills/orly-write-integration-test/SKILL.md"
+        },
+        {
+          "source": "skills/orly-babysit-prs/SKILL.md",
+          "target": ".claude/skills/orly-babysit-prs/SKILL.md"
+        },
+        {
+          "source": "skills/orly-babysit-prs/SKILL.md",
+          "target": ".agents/skills/orly-babysit-prs/SKILL.md"
+        },
+        {
+          "source": "skills/orly-babysit-prs/SKILL.md",
+          "target": ".opencode/skills/orly-babysit-prs/SKILL.md"
+        }
+      ]
+    }
+  },
+  "rules": [
+    {
+      "key": "governance.registry.valid",
+      "state": "active",
+      "decision": "mechanical",
+      "pack": "workflow.governance",
+      "checker": [
+        "bin/orly",
+        "validate"
+      ],
+      "fixtures": {
+        "pass": [
+          "fixtures/registry-valid.json"
+        ],
+        "fail": [
+          "fixtures/registry-invalid.json"
+        ]
+      }
+    },
+    {
+      "key": "governance.render.stable",
+      "state": "active",
+      "decision": "mechanical",
+      "pack": "workflow.governance",
+      "checker": [
+        "bin/orly",
+        "verify",
+        "--all"
+      ],
+      "fixtures": {
+        "pass": [
+          "src/render.test.ts"
+        ],
+        "fail": [
+          "fixtures/unclosed-pack-block.md"
+        ]
+      }
+    },
+    {
+      "key": "repository.conform",
+      "state": "active",
+      "decision": "repository",
+      "pack": "universal.authoring",
+      "command": "conform"
+    }
+  ]
+}

package/schemas/evidence.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "profile",
+    "source_commit",
+    "result",
+    "checks",
+    "llm_result",
+    "created_at"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "profile": {
+      "type": "string"
+    },
+    "source_commit": {
+      "type": "string"
+    },
+    "result": {
+      "enum": [
+        "pass",
+        "fail"
+      ]
+    },
+    "checks": {
+      "type": "array"
+    },
+    "llm_result": {
+      "enum": [
+        "pass",
+        "not-required"
+      ]
+    },
+    "created_at": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/profile.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "required": ["schema_version", "name", "packs", "commands"],
+  "properties": {
+    "schema_version": {"const": 1},
+    "name": {"type": "string"},
+    "packs": {"type": "array", "items": {"type": "string"}},
+    "commands": {"type": "object"}
+  },
+  "additionalProperties": false
+}

package/schemas/registry.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "required": ["schema_version", "core_documents", "packs", "rules"],
+  "properties": {
+    "schema_version": {"const": 1},
+    "core_documents": {"type": "array", "items": {"type": "string"}},
+    "packs": {"type": "object"},
+    "rules": {"type": "array"}
+  },
+  "additionalProperties": false
+}