Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions .github/copilot-instructions.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<!-- SPDX-License-Identifier: CC-BY-SA-4.0 -->
<!-- Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk> -->
<!-- Authoritative source: docs/AI-CONVENTIONS.md -->
<!-- Authoritative source: docs/practice/AI-CONVENTIONS.adoc -->

# Copilot Instructions

Expand Down Expand Up @@ -33,10 +33,10 @@

## Banned Languages

- No TypeScript (use ReScript)
- No Node.js / npm / bun (use Deno)
- No TypeScript or ReScript (use AffineScript)
- No Node.js or yarn (use Bun; runtime order Bun > Deno > pnpm > npm, npm only as the last resort)
- No Go (use Rust)
- No Python (use Julia or Rust)
- No Python (use AffineScript, Rust or Julia; no exceptions)
Comment on lines +36 to +39

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Synchronize the authoritative language policy

When an agent follows the newly corrected pointer on line 3, docs/practice/AI-CONVENTIONS.adoc lines 50–55 still directs TypeScript users to ReScript, bans Bun in favor of Deno, and offers only Julia/Rust for Python, contradicting these new rules. Because that document labels itself authoritative and says the per-tool configurations reference it, agents can receive mutually exclusive instructions or select a now-banned toolchain; update the authoritative table in the same change.

Useful? React with 👍 / 👎.


## Containers

Expand Down
8 changes: 4 additions & 4 deletions .machine_readable/ai/.clinerules
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# SPDX-License-Identifier: MPL-2.0
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
# Authoritative source: docs/AI-CONVENTIONS.md
# Authoritative source: docs/practice/AI-CONVENTIONS.adoc

# STARTUP: Read 0-AI-MANIFEST.deed first, then chora-registry_chora.deed.

Expand All @@ -24,10 +24,10 @@
# Rust: transmute (unless FFI with // SAFETY: comment)

# BANNED LANGUAGES
# TypeScript -> ReScript
# Node.js / npm / bun -> Deno
# TypeScript, ReScript -> AffineScript
# Node.js / yarn -> Bun (runtime order Bun > Deno > pnpm > npm; npm last resort)
# Go -> Rust
# Python -> Julia or Rust
# Python -> AffineScript, Rust or Julia (no exceptions)

# CONTAINERS
# Runtime: Podman (never Docker).
Expand Down
8 changes: 4 additions & 4 deletions .machine_readable/ai/.cursorrules
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# SPDX-License-Identifier: MPL-2.0
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
# Authoritative source: docs/AI-CONVENTIONS.md
# Authoritative source: docs/practice/AI-CONVENTIONS.adoc

# Read 0-AI-MANIFEST.deed in the repo root FIRST; it points at the repo deed.

Expand All @@ -23,10 +23,10 @@
# Rust: transmute (unless FFI with // SAFETY: comment)

# BANNED LANGUAGES
# TypeScript -> use ReScript
# Node.js / npm / bun -> use Deno
# TypeScript, ReScript -> use AffineScript
# Node.js / yarn -> use Bun (runtime order Bun > Deno > pnpm > npm; npm last resort)
# Go -> use Rust
# Python -> use Julia or Rust
# Python -> use AffineScript, Rust or Julia (no exceptions)

# CONTAINERS
# Runtime: Podman (never Docker)
Expand Down
8 changes: 4 additions & 4 deletions .machine_readable/ai/.windsurfrules
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# SPDX-License-Identifier: MPL-2.0
# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
# Authoritative source: docs/AI-CONVENTIONS.md
# Authoritative source: docs/practice/AI-CONVENTIONS.adoc

# STARTUP: Read 0-AI-MANIFEST.deed first, then chora-registry_chora.deed.

Expand All @@ -24,10 +24,10 @@
# Rust: transmute (unless FFI with // SAFETY: comment)

# BANNED LANGUAGES
# TypeScript -> ReScript
# Node.js / npm / bun -> Deno
# TypeScript, ReScript -> AffineScript
# Node.js / yarn -> Bun (runtime order Bun > Deno > pnpm > npm; npm last resort)
# Go -> Rust
# Python -> Julia or Rust
# Python -> AffineScript, Rust or Julia (no exceptions)

# CONTAINERS
# Runtime: Podman (never Docker).
Expand Down
2 changes: 1 addition & 1 deletion .machine_readable/ai/PLACEHOLDERS.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ sed -i "s/{{CURRENT_DATE}}/$(date +%Y-%m-%d)/g" $(grep -rl '{{CURRENT_DATE}}' .)

| Placeholder | Description | Example | Files |
|---|---|---|---|
| `{{AUTHOR}}` | Full legal name | `Jane Doe` | SPDX headers (all files), MAINTAINERS.md, .mailmap, .reuse/dep5, docs/AI-CONVENTIONS.md |
| `{{AUTHOR}}` | Full legal name | `Jane Doe` | SPDX headers (all files), MAINTAINERS.md, .mailmap, .reuse/dep5, docs/practice/AI-CONVENTIONS.adoc |
| `{{AUTHOR_EMAIL}}` | Primary contact email | `jane@example.org` | SPDX headers (all files), .mailmap, .reuse/dep5, .well-known/humans.txt |
| `{{AUTHOR_EMAIL_ALT}}` | Previous/secondary email (for .mailmap) | `old@example.com` | .mailmap |
| `{{AUTHOR_ORG}}` | Author's organization/affiliation | `Acme University` | project-metadata.k9.ncl |
Expand Down
8 changes: 3 additions & 5 deletions 0-AI-MANIFEST.deed
Original file line number Diff line number Diff line change
@@ -1,17 +1,15 @@
;; SPDX-License-Identifier: MPL-2.0
;; SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
;;
;; The machine front door of gv-clade-index (the chora-registry): pointer-only
;; (A7 ruling Q15). It names where to read and carries no facts of its own.
;; The machine front door of the chora-registry (formerly gv-clade-index):
;; pointer-only (A7 ruling Q15). It names where to read and carries no facts
;; of its own.
;; Repository facts are in chora-registry_chora.deed and
;; .machine_readable/descriptiles/STATE.deed; the registry itself is
;; verisim/seed/chora-registry_praxis.deed. It replaces 0-AI-MANIFEST.a2ml,
;; retired 2026-11-14 (docs/history/A2ML-REMOVED.adoc).
(repo-deed
:schema-version "1.0.0"
:canonical-name "gv-clade-index"
:repo-uuid #uuid"a65b74d8-351a-89d9-a38d-aea470863b03"
:beholding-chora #uuid"0889b37b-defb-831f-973c-e119500db00e"
(front-doors
:machine "chora-registry_chora.deed"
:human "README.adoc"))
Loading
Loading