Export bran-dev 3feeba3 public snapshot

.bran-export.json

@@ -1,22 +1,40 @@
 {
   "schema_version": 1,
   "source_repository": "alphazede/bran-dev",
-  "source_commit": "0a1de91258669123a3488af9b20d47a4d16b53c2",
+  "source_commit": "3feeba3ab30f0504a601ffbb732f98801e25c5e8",
   "version": "0.1.0",
   "public_repository": "alphazede/bran",
   "files": [
     {
       "path": ".bran/policy.yaml",
       "mode": "100644",
-      "bytes": 975,
-      "sha256": "41e89d763cdd6beac49d0372e1758cc86c1e7cf6e15a494ded429fbbf7b6c7ac"
+      "bytes": 1470,
+      "sha256": "1310773d9ab2c879d66823174faa2ee81fdc67596c7189ab6237e6819d75b278"
     },
     {
       "path": ".branignore",
       "mode": "100644",
       "bytes": 86,
       "sha256": "fc3aedc03fe42a12f036c337a579efa7b47775a6f415d99e020f212cc38d4643"
     },
+    {
+      "path": ".github/ISSUE_TEMPLATE/bug_report.yml",
+      "mode": "100644",
+      "bytes": 1753,
+      "sha256": "199b767e0392a2a9c9a1fb452aa6b7410460636b239da46e80ca905aa4e6dc5f"
+    },
+    {
+      "path": ".github/ISSUE_TEMPLATE/config.yml",
+      "mode": "100644",
+      "bytes": 236,
+      "sha256": "639faef63a4c4deb8b3cb2ac86fdb888f12b51b06c767425c84db56bd8233558"
+    },
+    {
+      "path": ".github/ISSUE_TEMPLATE/feature_request.yml",
+      "mode": "100644",
+      "bytes": 1386,
+      "sha256": "6fe630e14a84502ba6c59a961fb84894388369615de101aa70cf2ea3ebd3c6a0"
+    },
     {
       "path": ".github/workflows/bran-fast.yml",
       "mode": "100644",
@@ -35,6 +53,18 @@
       "bytes": 100,
       "sha256": "e045528ae5373d1e7bbcd287702e6e7c0ccb096d2076acf9a7e6c9c708aefeab"
     },
+    {
+      "path": "CODE_OF_CONDUCT.md",
+      "mode": "100644",
+      "bytes": 1346,
+      "sha256": "ea1c3b2cc119c76a7ce48d0ae84410eb6de22c6fbbe8a24b3aee08e86cf46ae4"
+    },
+    {
+      "path": "CONTRIBUTING.md",
+      "mode": "100644",
+      "bytes": 2796,
+      "sha256": "3b268fa87dcfe4341f725bdb89c9d55e94139687d6e74e20f84ec71f201a7b4b"
+    },
     {
       "path": "Cargo.lock",
       "mode": "100644",
@@ -68,8 +98,8 @@
     {
       "path": "README.md",
       "mode": "100644",
-      "bytes": 9773,
-      "sha256": "e1e78f08b7f5bfe79f6a922d86df0d14de8a10d6e0771b2e602afda6ce502c3d"
+      "bytes": 10037,
+      "sha256": "2e0abb9ad0a78c411b75c72d798688c24110b0c57d426af199b8e376b9e37865"
     },
     {
       "path": "assets/brand/bran-repository-raven.png",
@@ -134,8 +164,8 @@
     {
       "path": "crates/bran-cli/src/main.rs",
       "mode": "100644",
-      "bytes": 322237,
-      "sha256": "ae35ec304b1c49cc01e3831e43f00b656af7d76fb2f4849f79a92034fa9eb924"
+      "bytes": 417784,
+      "sha256": "36b2ca5ae6b243b4d6ab0527e3e8b44100c532f14a33d7adc60a37edf7567f15"
     },
     {
       "path": "crates/bran-core/Cargo.toml",
@@ -386,8 +416,8 @@
     {
       "path": "docs/integrations/agent-setup.md",
       "mode": "100644",
-      "bytes": 6176,
-      "sha256": "f9ecccc289fd31330021a143c2e04ffe7b40ad273d3d75a8b63052789d5b1d88"
+      "bytes": 6388,
+      "sha256": "c26af274819ea9585fd3067abbdcd8ae6c79028b223d399bb3b5cfa01ae9e47c"
     },
     {
       "path": "examples/headless/README.md",
@@ -674,8 +704,8 @@
     {
       "path": "skill/use-bran/SKILL.md",
       "mode": "100644",
-      "bytes": 1214,
-      "sha256": "22c330b917abdf57e33b97ec44088b8278b61a7d1e0388672f358ae01b9258aa"
+      "bytes": 2244,
+      "sha256": "86006e16e96e8f5cf06b16c9bf362fa9272a228c6429a774d340918c615d6255"
     },
     {
       "path": "tools/ci/build-release.sh",
@@ -689,6 +719,12 @@
       "bytes": 4872,
       "sha256": "3dbbcf9e9feeac7e84f9344620fff59810d4cd37f3de7d61456537bbdaf37163"
     },
+    {
+      "path": "tools/ci/public-policy.yaml",
+      "mode": "100644",
+      "bytes": 1470,
+      "sha256": "1310773d9ab2c879d66823174faa2ee81fdc67596c7189ab6237e6819d75b278"
+    },
     {
       "path": "tools/ci/public_boundary_check.py",
       "mode": "100644",
@@ -698,8 +734,8 @@
     {
       "path": "tools/ci/public_export.py",
       "mode": "100644",
-      "bytes": 20580,
-      "sha256": "a0fa15276e2e12a98dd3545578296ac2896602c7cc9d96bda1f77b3361f94b4a"
+      "bytes": 33588,
+      "sha256": "c262d1860bc0ff312561b13035704f97eb326acc1587739e9715b2e7104bb8fe"
     },
     {
       "path": "tools/ci/release-check.sh",

.bran/policy.yaml

@@ -10,6 +10,19 @@ frontmatter:
     - freshness
     - resource
     - public_boundary
+    - description
+    - status
+    - stale_after
+    - sources
+    - usage_window
+    - generated
+    - verified
+    - timestamp
+    - runtime
+    - parameters
+    - computation
+    - executor
+    - attester
   allowed:
     - type
     - title
@@ -18,7 +31,23 @@ frontmatter:
     - freshness
     - resource
     - public_boundary
-  canonical_docs_frontmatter_state: legacy_baseline
+    - description
+    - status
+    - stale_after
+    - sources
+    - usage_window
+    - generated
+    - verified
+    - timestamp
+    - runtime
+    - parameters
+    - computation
+    - executor
+    - attester
+  preserved_canonical_keys:
+    - proposal_id
+    - kind
+    - submission_status
 
 coverage:
   - canonical
@@ -41,6 +70,8 @@ tags:
   allowed:
     - developer
     - public
+    - internal
+    - bran
 
 status:
   allowed:
@@ -51,6 +82,7 @@ status:
 public_boundary:
   values:
     - public
+    - public-compatible
     - private
     - internal
   path_allowlist:

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,60 @@
+name: Bug report
+description: Something behaves differently than it should
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please don't paste anything private. Repository paths, source excerpts,
+        and query text often carry more than you'd expect.
+  - type: textarea
+    id: command
+    attributes:
+      label: What you ran
+      description: The exact command, verbatim.
+      render: shell
+      placeholder: bran query . "where is authentication handled"
+    validations:
+      required: true
+  - type: textarea
+    id: output
+    attributes:
+      label: What came back
+      description: >
+        The JSON BRAN printed. Include `warnings` and `failures`, since those
+        usually explain it. Trim it if it's long, but don't summarise it.
+      render: json
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: What you expected instead
+      description: >
+        For a ranking problem, name the file you expected and where it actually
+        landed. "Expected src/auth.rs, got it at rank 14 behind four test
+        files" is something I can chase.
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: Output of `bran --version`.
+      placeholder: bran 0.1.0
+    validations:
+      required: true
+  - type: input
+    id: platform
+    attributes:
+      label: Platform
+      placeholder: macOS 15 arm64, Ubuntu 24.04 x86_64, Windows 11
+    validations:
+      required: true
+  - type: checkboxes
+    id: offline
+    attributes:
+      label: Mode
+      options:
+        - label: This happened with no model connected (offline)
+        - label: This happened with a model connected

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Security issue
+    url: https://github.com/alphazede/bran/blob/main/CONTRIBUTING.md#security
+    about: Don't file security problems publicly. See CONTRIBUTING for how to report them.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,38 @@
+name: Idea or feature request
+description: Something BRAN should be able to do
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: What are you trying to do
+      description: >
+        Describe the problem rather than the solution. What were you doing when
+        you hit the wall?
+    validations:
+      required: true
+  - type: textarea
+    id: idea
+    attributes:
+      label: What you have in mind
+      description: If you already have a shape in mind, describe it. Optional.
+  - type: markdown
+    attributes:
+      value: |
+        Two things worth knowing before you write, because they'll shape the
+        answer:
+
+        **Determinism is the point.** The same repository and question have to
+        return the same ranking every time. Anything that makes results depend
+        on timing, machine state, or hidden history changes what BRAN is. That
+        doesn't mean no, but it does mean we should talk about it.
+
+        **Offline is the default.** Scanning, ranking, packets, and validation
+        work with no account and no network calls.
+  - type: checkboxes
+    id: constraints
+    attributes:
+      label: Does this fit
+      options:
+        - label: This works without breaking determinism, or I've explained why it's worth the trade
+        - label: This works offline, or only affects the optional connected mode

CODE_OF_CONDUCT.md

@@ -0,0 +1,42 @@
+# Code of Conduct
+
+## The short version
+
+Be decent to people. Assume they're acting in good faith. Criticise the code,
+not the person who wrote it.
+
+## What's expected
+
+- Give feedback that someone can act on. "This ranking is wrong because X"
+  helps. "This is broken" doesn't.
+- Accept that other people have different context, hardware, and constraints
+  than you do.
+- Own your mistakes. Everyone ships bugs. This project has shipped a few
+  already.
+- Keep discussion on the technical question at hand.
+
+## What isn't
+
+- Harassment, insults, or personal attacks.
+- Sexualised language or unwanted attention of any kind.
+- Publishing someone's private information without their permission.
+- Sustained disruption of a discussion.
+
+## Where this applies
+
+Anywhere the project is represented: issues, discussions, pull requests, and
+any public space where you're speaking for BRAN.
+
+## Reporting
+
+Email 1wgrumph@gmail.com. Reports stay private, and I'll respond as quickly as
+I reasonably can.
+
+I'll decide what action to take, up to and including blocking someone from the
+project. If your behaviour makes the project worse for other people, you'll be
+asked to stop, and if it continues you'll be removed.
+
+## Credit
+
+This is adapted from the [Contributor Covenant](https://www.contributor-covenant.org),
+version 2.1, rewritten to be shorter.