Prepare for Zenodo archival: add CITATION.cff, update README

Add machine-readable citation metadata with ORCID, ecosystem references,
and keywords. Update README with features, architecture, citation section,
and ecosystem links. Remove outdated project status checklist.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: semanticintent

CITATION.cff

@@ -0,0 +1,55 @@
+cff-version: 1.2.0
+title: "CAL Runtime: Cormorant Agentic Language Execution Engine"
+message: "If you use this software, please cite it using the metadata from this file."
+type: software
+authors:
+  - family-names: Shatny
+    given-names: Michael
+    orcid: "https://orcid.org/0009-0006-2011-3258"
+repository-code: "https://github.com/semanticintent/cal-runtime"
+url: "https://cal.cormorantforaging.dev"
+abstract: >-
+  CAL (Cormorant Agentic Language) Runtime is a deterministic execution engine
+  for cascade analysis using the Cormorant Foraging methodology. It provides a
+  complete TypeScript implementation including a Peggy-based parser, 6D cascade
+  analyzer, DRIFT gap measurement, Fetch action decisions, and pluggable adapters
+  for data sources and alert channels. CAL encodes the Cormorant Foraging Framework
+  directly into language syntax — keywords like FORAGE, DRIFT, FETCH, CHIRP, PERCH,
+  and WAKE map to framework layers, making methodology executable rather than
+  descriptive. 192 passing tests validate the complete pipeline.
+keywords:
+  - domain-specific-language
+  - cormorant-agentic-language
+  - cascade-analysis
+  - cormorant-foraging
+  - deterministic-execution
+  - drift-measurement
+  - fetch-decisions
+  - 6d-methodology
+  - intelligence-systems
+  - biomimetic-framework
+license: MIT
+version: 1.0.0
+date-released: "2026-03-07"
+references:
+  - type: software
+    title: "Cormorant Foraging Framework: A Multi-Layered Architecture for Intelligence Systems"
+    authors:
+      - family-names: Shatny
+        given-names: Michael
+    doi: "10.5281/zenodo.18904952"
+    url: "https://github.com/semanticintent/cormorant-foraging-framework"
+  - type: software
+    title: "6D Foraging Methodology: Strategic Dimensional Discovery"
+    authors:
+      - family-names: Shatny
+        given-names: Michael
+    doi: "10.5281/zenodo.18209946"
+    url: "https://github.com/semanticintent/6d-foraging-methodology"
+  - type: software
+    title: "Semantic Intent SSOT"
+    authors:
+      - family-names: Shatny
+        given-names: Michael
+    doi: "10.5281/zenodo.17114972"
+    url: "https://semanticintent.dev/papers/semantic-intent-ssot"

README.md

@@ -1,12 +1,14 @@
-# 🪶 CAL Runtime
+# CAL Runtime
 
-**Cormorant Agentic Language (CAL) - Runtime Execution Engine**
+**Cormorant Agentic Language (CAL) — Runtime Execution Engine**
 
-A deterministic execution engine for cascade analysis using the 6D Foraging Methodology.
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A deterministic execution engine for cascade analysis using the Cormorant Foraging methodology and 6D dimensional framework.
 
 ## What is CAL?
 
-CAL is a domain-specific language for finding hidden costs through cascade analysis. It turns methodology into executable code.
+CAL is a domain-specific language for finding hidden costs through cascade analysis. It turns methodology into executable code — keywords ARE the framework.
 
 ```cal
 -- Find high-urgency situations
@@ -27,11 +29,19 @@ THRESHOLD 1000
 ON EXECUTE CHIRP critical "Take action"
 ```
 
-## Installation
+## Features
 
-```bash
-npm install @stratiqx/cal-runtime
-```
+- Methodology-native keywords (FORAGE, DRIFT, FETCH, CHIRP, PERCH, WAKE)
+- 6D dimension analysis (Customer, Employee, Revenue, Regulatory, Quality, Operational)
+- 3D Lens scoring (Sound x Space x Time)
+- DRIFT gap measurement (Methodology - Performance)
+- Fetch action decisions with multiplicative gating
+- Cascade pathway mapping with depth control
+- Financial impact calculation with cascade multipliers
+- Pluggable data adapters (JSON, memory, composite)
+- Pluggable alert adapters (console, file, webhook)
+- CLI tool for script execution
+- 192 passing tests across 8 test suites
 
 ## Quick Start
 
@@ -55,32 +65,18 @@ const output = await execute(result.actionPlan, {
 console.log(output.results);
 ```
 
-## Project Status
-
-**Phase 1: Validation & Stabilization** (Current)
+## Architecture
 
-- [ ] Parser validation
-- [ ] Executor validation
-- [ ] End-to-end testing
-- [ ] Financial model documentation
-
-See [CAL-IMPLEMENTATION-ANALYSIS.md](../cal/docs/CAL-IMPLEMENTATION-ANALYSIS.md) for full roadmap.
-
-## Features
-
-- ✅ Methodology-native keywords (FORAGE, DRIFT, FETCH)
-- ✅ 6D dimension analysis
-- ✅ 3D Lens scoring (Sound × Space × Time)
-- ✅ DRIFT gap measurement
-- ✅ Fetch action decisions
-- ✅ Cascade pathway mapping
-- ✅ Financial impact calculation
+```
+CAL Script → Parser (Peggy) → ActionPlan → Executor → Results
+                                              ↓
+                                    Data Adapters + Alert Adapters
+```
 
 ## Documentation
 
-- [Language Reference](https://cal.cormorantforaging.dev)
+- [Language Specification](https://cal.cormorantforaging.dev)
 - [API Documentation](./docs/API.md)
-- [Testing Guide](./docs/TESTING.md)
 - [Architecture](./docs/ARCHITECTURE.md)
 
 ## Development
@@ -94,17 +90,37 @@ npm test
 
 # Build
 npm run build
+```
+
+## Ecosystem
+
+CAL Runtime is the execution engine for the Cormorant Foraging Framework:
+
+- [Cormorant Foraging Framework](https://cormorantforaging.dev) — Foundational methodology
+- [CAL Language Specification](https://cal.cormorantforaging.dev) — Language reference
+- [6D Foraging Methodology](https://6d.cormorantforaging.dev) — Dimensional analysis
+- [StratIQX](https://stratiqx.com) — Case studies and analysis platform
 
-# Watch mode
-npm run dev
+## Citation
+
+If you use CAL Runtime in your work, please cite:
+
+```bibtex
+@misc{shatny2026cal,
+  author = {Shatny, Michael},
+  title = {CAL Runtime: Cormorant Agentic Language Execution Engine},
+  year = {2026},
+  publisher = {Zenodo},
+  url = {https://github.com/semanticintent/cal-runtime},
+  note = {ORCID: 0009-0006-2011-3258}
+}
 ```
 
-## License
+## Author
 
-MIT © Michael Shatny
+**Michael Shatny**
+ORCID: [0009-0006-2011-3258](https://orcid.org/0009-0006-2011-3258)
 
-## Links
+## License
 
-- [6D Methodology](https://6d.cormorantforaging.dev)
-- [Cormorant Foraging](https://cormorantforaging.dev)
-- [StratIQX](https://stratiqx.com)
+MIT