Chore/pmpl normalize (#74)

Co-authored-by: Jonathan D.A. Jewell <jonathan.jewell@open.ac.uk>
Co-authored-by: Your Name <you@example.com>
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: 4 people

.machine_readable/AGENTIC.scm

@@ -1,26 +1,21 @@
-;; AGENTIC.scm — Agentic Reasoning Specification
-;; Defines how autonomous agents interpret, modify, and interact with artefacts.
+;; SPDX-License-Identifier: PMPL-1.0-or-later
+;; AGENTIC.scm - AI agent interaction patterns
 
-(agentic
-  (version "1.0")
-
-  (interpretation
-    (license "Treat PMPL as binding legal text with ethical extensions")
-    (exhibits "Interpret as normative supplements")
-    (metadata "Use SPDX metadata as canonical mapping"))
-
-  (agency
-    (allowed
-      (read "All artefacts")
-      (propose "Changes via issues or PRs")
-      (verify "Provenance and compliance"))
-    (forbidden
-      (modify "License text without Council approval")
-      (strip "Provenance metadata")
-      (misrepresent "Lineage or authorship")))
-
-  (autonomy
-    (agents-may
-      "Generate analyses, propose improvements, audit provenance")
-    (agents-must
-      "Preserve emotional lineage, maintain narrative context")))
+(define agentic-config
+  `((version . "1.0.0")
+    (claude-code
+      ((model . "claude-opus-4-5-20251101")
+       (tools . ("read" "edit" "bash" "grep" "glob"))
+       (permissions . "read-all")))
+    (patterns
+      ((code-review . "thorough")
+       (refactoring . "conservative")
+       (testing . "comprehensive")
+       (documentation . "bilingual-aware")))
+    (constraints
+      ((languages . ("ocaml" "scheme" "asciidoc" "nickel"))
+       (banned . ("typescript" "go" "python" "makefile"))))
+    (special-instructions
+      ((bilingual . "Maintain Dutch/English parity")
+       (legal . "Do not modify license text without review")
+       (governance . "Follow GOVERNANCE.md for major changes")))))

.machine_readable/ECOSYSTEM.scm

@@ -1,33 +1,25 @@
-;; ECOSYSTEM.scm — Palimpsest License Ecosystem Specification
-;; Canonical ontology for agents, artefacts, and governance flows.
+;; SPDX-License-Identifier: PMPL-1.0-or-later
+;; ECOSYSTEM.scm - Project ecosystem positioning
 
 (ecosystem
-  (name "palimpsest-license")
-  (version "1.0")
-  (governance "Palimpsest Stewardship Council")
-  (jurisdiction "NL")
-
-  (actors
-    (council "Palimpsest Stewardship Council")
-    (contributors "Individuals submitting improvements")
-    (maintainers "Repository maintainers")
-    (agents "Automated systems interacting with the license"))
-
-  (artefacts
-    (license "legal/PALIMPSEST-MPL-1.0.txt")
-    (exhibit-a "legal/exhibits/EXHIBIT-A-ETHICAL-USE.txt")
-    (exhibit-b "legal/exhibits/EXHIBIT-B-QUANTUM-SAFE.txt")
-    (metadata "LICENSES/PMPL-1.0.json")
-    (governance "GOVERNANCE.adoc")
-    (versioning "VERSIONING.adoc"))
-
-  (flows
-    (proposal "Contributor submits proposal → Council review → Public comment → Ratification")
-    (versioning "Council publishes new version → Metadata updated → Historical archive extended")
-    (provenance "pmpl-sign → pmpl-verify → pmpl-audit"))
-
-  (principles
-    (ethical-use "Preserve emotional lineage and cultural meaning")
-    (provenance "Maintain cryptographic lineage")
-    (reversibility "All artefacts must be reversible and auditable")
-    (narratability "Every artefact must tell its own story")))
+  ((version . "1.0.0")
+   (name . "palimpsest-license")
+   (type . "specification")
+   (purpose . "Ethical open source licensing framework for the AI age")
+   (position-in-ecosystem . "foundation")
+   (related-projects
+     ((rhodium-standard-repositories . "sibling-standard")
+      (gitvisor . "tooling-consumer")
+      (bunsenite . "consumer")
+      (zig-nickel-ffi . "consumer")
+      (formatrix-docs . "consumer")))
+   (what-this-is
+     ("An ethical licensing framework"
+      "A philosophical approach to open source"
+      "Protection for creators in AI age"
+      "Layered on MPL-2.0 for legal backing"
+      "Defines 6SCM machine-readable metadata standard"))
+   (what-this-is-not
+     ("A replacement for existing licenses - it extends MPL-2.0"
+      "Anti-AI or anti-technology - AI training explicitly permitted"
+      "A standalone legal invention - built on proven MPL-2.0 foundation"))))

.machine_readable/META.scm

@@ -1,40 +1,29 @@
-;; META.scm — Repository Identity Manifest
-;; Defines the canonical identity, purpose, and interpretive frame.
+;; SPDX-License-Identifier: PMPL-1.0-or-later
+;; META.scm - Project metadata and architectural decisions
 
-(meta
-  (id "palimpsest-license")
-  (version "1.0")
-  (spdx "PMPL-1.0-or-later")
-  (governed-by "Dutch law")
-  (steward "Palimpsest Stewardship Council")
-
-  (purpose
-    "To maintain the canonical text, governance, provenance, and tooling for the Palimpsest-MPL License.")
-
-  (scope
-    (legal "License text, exhibits, jurisdictional frameworks")
-    (governance "Council processes, versioning, interpretive guidance")
-    (tooling "Provenance tools, audit tools, signing tools")
-    (documentation "User guides, integration guides, compatibility notes"))
-
-  (constraints
-    (must-preserve "Emotional lineage, provenance metadata, narrative context")
-    (must-not "Strip provenance, misrepresent lineage, obscure authorship"))
-
-  (lineage
-    (root "MPL-2.0")
-    (extension "Ethical use, emotional lineage, quantum-safe provenance")))
-
-(tools
-  (description "Provenance and audit utilities for the Palimpsest‑MPL ecosystem.")
-  (directories
-    (pmpl-sign     "Create cryptographic signatures and embed provenance metadata.")
-    (pmpl-verify   "Verify signatures and validate provenance chains.")
-    (pmpl-audit    "Perform repository‑level audits for SPDX, manifests, and provenance.")
-    (integrations  "Templates and onboarding resources for CI/CD and developer workflows."))
-  (principles
-    (provenance integrity)
-    (reversibility)
-    (auditability)
-    (narrative-clarity)
-    (emotional-lineage)))
+(define project-meta
+  `((version . "1.0.0")
+    (architecture-decisions
+      ((adr-001
+        (status . "accepted")
+        (date . "2024-06-01")
+        (context . "Need license compatible with AI age concerns")
+        (decision . "Layer Palimpsest ethical framework on top of MPL-2.0")
+        (consequences . "MPL-2.0 provides legal backing, Palimpsest adds ethical layer"))
+       (adr-002
+        (status . "accepted")
+        (date . "2024-09-01")
+        (context . "Need machine-readable project metadata")
+        (decision . "Use 6SCM files standard (STATE, META, ECOSYSTEM, PLAYBOOK, AGENTIC, NEUROSYM)")
+        (consequences . "Consistent metadata across all repos, AI-parseable"))))
+    (development-practices
+      ((code-style . "ocamlformat")
+       (security . "openssf-scorecard")
+       (testing . "comprehensive")
+       (versioning . "semver")
+       (documentation . "asciidoc")
+       (branching . "trunk-based")))
+    (design-rationale
+      ((bilingual . "Dutch legally binding, English for accessibility")
+       (layered . "MPL-2.0 legal + Palimpsest ethical")
+       (6scm . "Machine-readable metadata for tooling and AI agents")))))

.machine_readable/NEUROSYM.scm

@@ -1,26 +1,18 @@
-;; NEUROSYM.scm — Neurosymbolic Interface Specification
-;; Defines how symbolic governance artefacts interact with machine reasoning systems.
+;; SPDX-License-Identifier: PMPL-1.0-or-later
+;; NEUROSYM.scm - Neurosymbolic integration config
 
-(neurosym
-  (version "1.0")
-
-  (symbolic
-    (anchors
-      (license "Primary normative artefact")
-      (exhibits "Ethical and provenance supplements")
-      (metadata "Machine-readable identity layer")))
-
-  (neural
-    (behaviours
-      (may "Analyse, summarise, classify, propose")
-      (must "Preserve meaning, avoid hallucination, respect lineage")))
-
-  (interfaces
-    (mapping
-      (spdx→text "Use LICENSES/PMPL-1.0.json to resolve canonical text")
-      (text→ethics "Use Exhibit A for ethical interpretation")
-      (text→provenance "Use Exhibit B for cryptographic interpretation")))
-
-  (constraints
-    (must-preserve "Narrative context, provenance metadata, emotional lineage")
-    (must-not "Generate interpretations that contradict the license text")))
+(define neurosym-config
+  `((version . "1.0.0")
+    (symbolic-layer
+      ((type . "scheme")
+       (reasoning . "deductive")
+       (verification . "formal")
+       (ontology . "license-compliance")))
+    (neural-layer
+      ((embeddings . false)
+       (fine-tuning . false)
+       (consent-required . true)))
+    (integration
+      ((license-parsing . "Extract clauses from license text")
+       (compliance-checking . "Verify project meets Palimpsest requirements")
+       (metadata-validation . "Validate 6SCM file structure")))))

.machine_readable/PLAYBOOK.scm

@@ -1,24 +1,19 @@
-;; PLAYBOOK.scm — Agent Playbook for Palimpsest License
-;; Defines canonical behaviours, rituals, and operational flows.
+;; SPDX-License-Identifier: PMPL-1.0-or-later
+;; PLAYBOOK.scm - Operational runbook
 
-(playbook
-  (version "1.0")
-
-  (rituals
-    (submit-proposal
-      "Open issue → Provide rationale → Link to exhibits → Await Council triage")
-    (update-license
-      "Draft revision → Public comment → Council vote → Publish → Archive previous version")
-    (provenance
-      "pmpl-sign → commit → pmpl-verify → CI audit"))
-
-  (behaviours
-    (agents
-      (must "Respect emotional lineage, preserve provenance metadata")
-      (should "Annotate changes with narrative context")
-      (must-not "Strip signatures, obscure authorship, or remove lineage chains")))
-
-  (interfaces
-    (cli "pmpl-sign, pmpl-verify, pmpl-audit")
-    (docs "README.adoc, GOVERNANCE.adoc, VERSIONING.adoc")
-    (legal "legal/PALIMPSEST-MPL-1.0.txt")))
+(define playbook
+  `((version . "1.0.0")
+    (procedures
+      ((build . (("docs" . "just docs")
+                 ("validate" . "just validate")))
+       (test . (("lint" . "npm run lint")
+                ("format" . "npm run format")))
+       (release . (("version-bump" . "Update CHANGELOG.md")
+                   ("tag" . "git tag -a vX.Y.Z")
+                   ("publish" . "just release")))
+       (translation . (("sync" . "Check bilingual-map.md")
+                       ("review" . "Dutch legal review")))))
+    (alerts . ())
+    (contacts
+      ((steward . "Jonathan D.A. Jewell")
+       (repo . "github.com/hyperpolymath/palimpsest-license")))))