julia-ecosystem/packages/MacroPower.jl/0-AI-MANIFEST.a2ml at main · hyperpolymath/julia-ecosystem · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
;; SPDX-License-Identifier: MPL-2.0
;; 0-AI-MANIFEST.a2ml - AI Agent Entry Point for MacroPower.jl
;; Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
;;
;; This file is the FIRST file any AI agent must read when entering this repository.
;; It defines canonical locations, critical invariants, and lifecycle hooks.

(ai-manifest
  (version "1.0")
  (project "MacroPower.jl")
  (description "Automation workflow framework with macro-based trigger/action system")

  ;; =========================================================================
  ;; Canonical File Locations
  ;; =========================================================================
  (canonical-locations
    (scm-files ".machine_readable/"
      (state ".machine_readable/STATE.scm")
      (ecosystem ".machine_readable/ECOSYSTEM.scm")
      (meta ".machine_readable/META.scm"))

    (source-code "src/"
      (main-module "src/MacroPower.jl")))

  ;; =========================================================================
  ;; Critical Invariants
  ;; =========================================================================
  (invariants
    (scm-location "SCM files ONLY in .machine_readable/ — NEVER in repo root")
    (license "MPL-2.0")
    (language "Julia")
    (part-of "julia-ecosystem monorepo")
    (no-banned-patterns "No believe_me, assert_total, Admitted, sorry, unsafeCoerce, Obj.magic"))

  ;; =========================================================================
  ;; Lifecycle Hooks
  ;; =========================================================================
  (lifecycle
    (on-enter
      (read ".machine_readable/STATE.scm")
      (read ".machine_readable/ECOSYSTEM.scm")
      (read ".machine_readable/META.scm"))
    (on-exit
      (update ".machine_readable/STATE.scm"))))