Merge pull request #2104 from finos/release-1.2-revised

CALM Schema Release 1.2 - Timelines & Decorators

Author: markscott-ms

calm-ai/README.md

@@ -25,14 +25,17 @@ calm-ai/
 │   ├── architecture-creation.md
 │   ├── calm-cli-instructions.md
 │   ├── control-creation.md
+│   ├── decorator-creation.md
 │   ├── documentation-creation.md
 │   ├── flow-creation.md
 │   ├── interface-creation.md
 │   ├── metadata-creation.md
+│   ├── moment-creation.md
 │   ├── node-creation.md
 │   ├── pattern-creation.md
 │   ├── relationship-creation.md
-│   └── standards-creation.md
+│   ├── standards-creation.md
+│   └── timeline-creation.md
 └── package.json           # Package metadata
 ```
 
@@ -45,14 +48,17 @@ Individual markdown files providing detailed guidance for specific CALM modeling
 | `architecture-creation.md` | Guide for creating complete CALM architecture documents with required schema structure |
 | `calm-cli-instructions.md` | Summary of CALM CLI commands, validation modes, and usage flags |
 | `control-creation.md` | Guide for defining control requirements and compliance configurations |
+| `decorator-creation.md` | Guide for creating decorators |
 | `documentation-creation.md` | Guide for generating documentation from CALM models |
 | `flow-creation.md` | Guide for modeling business process flows through architecture |
 | `interface-creation.md` | Critical guidance for interface definitions and oneOf constraints |
 | `metadata-creation.md` | Guide for adding metadata arrays with proper validation |
+| `moment-creation.md` | Guide for adding moments to timelines with proper validation |
 | `node-creation.md` | Guide for creating nodes (components) with proper validation |
 | `pattern-creation.md` | Guide for defining reusable architectural patterns |
 | `relationship-creation.md` | Guide for creating relationships between nodes |
 | `standards-creation.md` | Guide for creating JSON Schema Standards extending CALM with organizational requirements |
+| `timeline-creation.md` | Guide for creating architecture timelines |
 
 Each tool prompt follows a consistent structure:
 - Overview and purpose
@@ -133,7 +139,10 @@ Configuration files in `ai-assistants/` define how to integrate CALM prompts wit
         "calm-prompts/flow-creation.md",
         "calm-prompts/pattern-creation.md",
         "calm-prompts/documentation-creation.md",
-        "calm-prompts/standards-creation.md"
+        "calm-prompts/standards-creation.md",
+        "calm-prompts/moment-creation.md",
+        "calm-prompts/timeline-creation.md",
+        "calm-prompts/decorator-creation.md"
     ]
 }
 ```
@@ -165,7 +174,10 @@ Configuration files in `ai-assistants/` define how to integrate CALM prompts wit
         "calm-prompts/flow-creation.md",
         "calm-prompts/pattern-creation.md",
         "calm-prompts/documentation-creation.md",
-        "calm-prompts/standards-creation.md"
+        "calm-prompts/standards-creation.md",
+        "calm-prompts/moment-creation.md",
+        "calm-prompts/timeline-creation.md",
+        "calm-prompts/decorator-creation.md"
     ]
 }
 ```
@@ -210,7 +222,7 @@ The template includes:
 ### 2. Prompt Management
 - Provides modular, focused guidance for specific CALM tasks
 - Enforces validation requirements and best practices
-- References CALM schema v1.1 for accuracy
+- References CALM schema v1.2 for accuracy
 - Includes working examples and common pitfall warnings
 
 ### 3. Multi-provider Support
@@ -282,7 +294,7 @@ When editing `templates/CALM.chatmode_template.md`:
 ## Validation Requirements
 
 All tool prompts must:
-- Reference CALM schema v1.1
+- Reference CALM schema v1.2
 - Include mandatory validation steps
 - Provide `calm validate` commands
 - Emphasize `hasErrors: false` requirement
@@ -292,6 +304,6 @@ All tool prompts must:
 ## Related Documentation
 
 - **CALM CLI**: See `cli/AGENTS.md` for CLI command details
-- **CALM Schema**: https://calm.finos.org/release/1.1/meta/calm.json
+- **CALM Schema**: https://calm.finos.org/release/1.2/meta/calm.json
 - **User Docs**: https://calm.finos.org
 - **VSCode Extension**: See `calm-plugins/vscode/AGENTS.md`

calm-ai/ai-assistants/claude.json

@@ -16,6 +16,9 @@
         "calm-prompts/flow-creation.md",
         "calm-prompts/pattern-creation.md",
         "calm-prompts/documentation-creation.md",
-        "calm-prompts/standards-creation.md"
+        "calm-prompts/standards-creation.md",
+        "calm-prompts/moment-creation.md",
+        "calm-prompts/timeline-creation.md",
+        "calm-prompts/decorator-creation.md"
     ]
 }

calm-ai/ai-assistants/copilot.json

@@ -16,6 +16,9 @@
         "calm-prompts/flow-creation.md",
         "calm-prompts/pattern-creation.md",
         "calm-prompts/documentation-creation.md",
-        "calm-prompts/standards-creation.md"
+        "calm-prompts/standards-creation.md",
+        "calm-prompts/moment-creation.md",
+        "calm-prompts/timeline-creation.md",
+        "calm-prompts/decorator-creation.md"
     ]
 }

calm-ai/ai-assistants/kiro.json

@@ -16,6 +16,9 @@
         "calm-prompts/flow-creation.md",
         "calm-prompts/pattern-creation.md",
         "calm-prompts/documentation-creation.md",
-        "calm-prompts/standards-creation.md"
+        "calm-prompts/standards-creation.md",
+        "calm-prompts/moment-creation.md",
+        "calm-prompts/timeline-creation.md",
+        "calm-prompts/decorator-creation.md"
     ]
 }

calm-ai/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@finos/calm-ai",
-    "version": "1.0.0",
+    "version": "1.2.0",
     "description": "AI tools and prompts for FINOS CALM architecture modeling",
     "private": true,
     "main": "index.js",

calm-ai/templates/CALM.chatmode_template.md

@@ -16,12 +16,14 @@ CALM enables modeling of:
 - **Flows** – business-level processes traversing your architecture
 - **Controls** – compliance policies and enforcement mechanisms
 - **Metadata** – supplemental, non-structural annotations
+- **Timelines** – evolution of architectures over time
+- **Decorators** – supplementary cross-cutting data (deployment, security, business context) attached to architecture elements without modifying the core definition
 
 ## Your Role
 
 You specialize in helping users create, modify, and understand CALM architecture models. You have deep knowledge of:
 
-- CALM schema validation requirements (release/1.1)
+- CALM schema validation requirements (release/1.2)
 - Best practices for architecture modeling
 - JSON schema constraints and validation rules
 - VSCode integration and tooling
@@ -40,7 +42,7 @@ On your first prompt in each session, you MUST:
 
 ## Guidelines
 
-- Always validate CALM models against the 1.1 schema
+- Always validate CALM models against the 1.2 schema
 - Provide specific, actionable guidance for schema compliance
 - Reference the tool prompts for detailed creation instructions
 - Use examples that follow CALM best practices

calm-ai/tools/architecture-creation.md

@@ -2,15 +2,15 @@
 
 ## Overview
 
-This guide provides instructions for creating complete CALM architecture documents that comply with the FINOS CALM v1.1 schema.
+This guide provides instructions for creating complete CALM architecture documents that comply with the FINOS CALM v1.2 schema.
 
 ## Required Schema Structure
 
 Every CALM architecture MUST include:
 
 ```json
 {
-    "$schema": "https://calm.finos.org/release/1.1/meta/calm.json",
+    "$schema": "https://calm.finos.org/release/1.2/meta/calm.json",
     "unique-id": "string",
     "name": "string",
     "description": "string"
@@ -31,7 +31,7 @@ Every CALM architecture MUST include:
 
 ## Architecture Creation Checklist
 
-- [ ] Include required $schema reference to CALM v1.1
+- [ ] Include required $schema reference to CALM v1.2
 - [ ] Provide unique-id (kebab-case recommended)
 - [ ] Add descriptive name and description
 - [ ] Name file with `.architecture.json` suffix
@@ -61,7 +61,7 @@ Every CALM architecture MUST include:
 
 ```json
 {
-    "$schema": "https://calm.finos.org/release/1.1/meta/calm.json",
+    "$schema": "https://calm.finos.org/release/1.2/meta/calm.json",
     "unique-id": "example-trading-system",
     "name": "Example Trading System",
     "description": "A simple trading system architecture",

calm-ai/tools/control-creation.md

@@ -6,7 +6,7 @@
 
 ## Official JSON Schema Definition
 
-The complete control schema from the FINOS CALM v1.1 specification:
+The complete control schema from the FINOS CALM v1.2 specification:
 
 ```json
 {
@@ -118,7 +118,7 @@ Applied to the entire architecture document - affects all components:
 
 ```json
 {
-    "calm-version": "1.0.0",
+    "calm-version": "1.2.0",
     "architecture-version": "1.0.0",
     "controls": {
         "data-residency": {