Bump version to 1.4.2

claude · claude · commit 087cdc100ab6 · 2026-05-12T05:50:35.000Z
Promotes [Unreleased] checkpoint skills work to v1.4.2. Updates version references across spec, plugin manifests, templates, skills, and all stamped artifacts. Spec last_updated set to 2026-05-12. https://claude.ai/code/session_01QTwxzD9j8ds3W1kq6dQ2UX
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
@@ -12,7 +12,7 @@
         "repo": "MSiccDev/ai-context-kit"
       },
       "description": "Context-aware AI collaboration skills for creating and validating user context, project AGENTS.md files, and skill artifacts across LLM providers.",
-      "version": "1.4.1",
+      "version": "1.4.2",
       "license": "MIT",
       "homepage": "https://github.com/MSiccDev/ai-context-kit",
       "repository": "https://github.com/MSiccDev/ai-context-kit",
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "ai-context-kit",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "Context-aware AI collaboration skills for creating and validating user context, project AGENTS.md files, and skill artifacts across LLM providers.",
   "author": {
     "name": "MSiccDev Software Development",
diff --git a/AGENTS.md b/AGENTS.md
@@ -1,4 +1,4 @@
-<!-- spec_version: 1.4.1 -->
+<!-- spec_version: 1.4.2 -->
 
 # AI Context Kit Agent Guide
 
@@ -11,7 +11,7 @@ This repository distinguishes:
 
 ## Source Of Truth And Precedence
 Use this order when files differ:
-1. **Specification (authoritative, v1.4.1):** `specs/context_aware_ai_session_spec.md`
+1. **Specification (authoritative, v1.4.2):** `specs/context_aware_ai_session_spec.md`
 2. **Templates (canonical structures):** `templates/*.instructions.md` and `templates/skill_template/SKILL.md`
 3. **Skills (canonical operational workflows):** `skills/*/SKILL.md` and skill-local references
 4. **Prompts (compatibility wrappers):** `prompts/*.prompt.md` (must defer detailed logic to skills)
@@ -115,7 +115,7 @@ Alias policy:
 - Validation: skill-based validation workflows and reports
 
 ### Current Objectives
-- Keep templates and skills aligned with spec `v1.4.1`.
+- Keep templates and skills aligned with spec `v1.4.2`.
 - Maintain the AGENTS-first project-context model.
 - Preserve deterministic behavior and path stability.
 - Reduce duplication and migration noise.
@@ -196,7 +196,7 @@ When `specs/context_aware_ai_session_spec.md` changes, audit and update all impa
 - `AGENTS.md`
 
 ## Key References
-- Specification (v1.4.1): [`specs/context_aware_ai_session_spec.md`](specs/context_aware_ai_session_spec.md)
+- Specification (v1.4.2): [`specs/context_aware_ai_session_spec.md`](specs/context_aware_ai_session_spec.md)
 - Project operational defaults: this root `AGENTS.md` (Default State For This Repo)
 - User context template: [`templates/usercontext_template.instructions.md`](templates/usercontext_template.instructions.md)
 - Skill template: [`templates/skill_template/SKILL.md`](templates/skill_template/SKILL.md)
diff --git a/AGENTS.validation.md b/AGENTS.validation.md
@@ -14,7 +14,7 @@
 - **Score:** 20/20
 - **Status:** PASS
 - Target file exists and is structurally complete.
-- `<!-- spec_version: 1.4.1 -->` comment is present and current — no version warning.
+- `<!-- spec_version: 1.4.2 -->` comment is present and current — no version warning.
 - Purpose, precedence model, and repository map are explicitly defined.
 - Heading structure is scannable and consistent.
 
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -13,17 +13,24 @@ When a new version is released:
 
 ## [Unreleased]
 
+---
+
+## [1.4.2] - 2026-05-12
+
 ### Added
 - **`create-checkpoint` skill** — guided workflow to capture session state as a checkpoint artifact per spec section 4.4, with schema reference and `agents/openai.yaml` sidecar
 - **`restore-checkpoint` skill** — guided workflow to load, validate, and restore a checkpoint artifact at session start per spec section 4.4 restore rules, with conflict resolution reference and `agents/openai.yaml` sidecar
+- **`checkpoint: true` required field** — added to spec section 4.4.2 schema so checkpoint files are self-identifying; restore validation is now fully spec-backed
 - AGENTS.md now references sections 4.4 (Cross-Session Persistence) and 4.5 (Context Compression) with explicit behavioral instructions for both
 - Prompts and Codex symlinks added for both new skills
+- `SKILL.validation.md` added to `create-checkpoint/` and `restore-checkpoint/` skill folders
 
 ### Safe to update from template
 - `skills/create-checkpoint/` (new)
 - `skills/restore-checkpoint/` (new)
 - `.agents/skills/` (two new symlinks)
 - `prompts/` (two new prompt files)
+- `specs/context_aware_ai_session_spec.md`
 - `AGENTS.md`
 - `README.md`
 - `CHANGELOG.md`
diff --git a/README.md b/README.md
@@ -81,7 +81,7 @@ ai-context-kit/
 │   └── context_aware_ai_session_spec.md              # Specification for AI session management
 │
 ├── templates/
-│  ├── usercontext_template.instructions.md           # Canonical v1.4.1 user context template (authoritative)
+│  ├── usercontext_template.instructions.md           # Canonical v1.4.2 user context template (authoritative)
 │  ├── AGENTS_template.md                             # Canonical AGENTS template (authoritative)
 │  └── skill_template/SKILL.md                        # Canonical skill template
 │
@@ -114,7 +114,7 @@ ai-context-kit/
 
 ---
 
-## Canonical Authority (Spec v1.4.1)
+## Canonical Authority (Spec v1.4.2)
 
 When guidance differs across files, use this authority order:
 
@@ -244,13 +244,13 @@ The following paths are considered **canonical**:
 - `AGENTS.md`
   - Primary agent entrypoint (repo-specific operational contract)
 - `templates/`
-  - Canonical instruction templates (spec v1.4.1)
+  - Canonical instruction templates (spec v1.4.2)
 - `skills/`
   - Canonical workflow skills (`SKILL.md`-based folders)
 - `prompts/`
   - Composition wrappers for instruction/skill workflows
 - `specs/context_aware_ai_session_spec.md`
-  - Authoritative specification (v1.4.1+)
+  - Authoritative specification (v1.4.2+)
 - Root `README.md`
   - Human-facing entry point and workflow documentation
 
@@ -456,7 +456,7 @@ Each project `AGENTS.md` should define:
 - **Languages:** LLMs work best when instructions are in English, but you can include multilingual content in user context if needed (just be aware of potential comprehension issues)
 - **Versioning:** Update user context when skills/preferences evolve; update project `AGENTS.md` when phases/objectives change. Ideally, these should live in the same repository as your codebase once they are created.
 - **Discoverability:** Semantic file extensions help AI tools identify and load the appropriate instructions automatically
-- **Canonical structure:** The templates in `/templates` define the only supported artifact structures for spec v1.4.1
+- **Canonical structure:** The templates in `/templates` define the only supported artifact structures for spec v1.4.2
 
 ---
 
diff --git a/docs/spec-rationale.md b/docs/spec-rationale.md
@@ -1,13 +1,13 @@
 ---
 context_type: rationale
 document_type: companion_document
-spec_version: 1.4.1
+spec_version: 1.4.2
 created: 2025-10-20
 last_updated: 2026-05-09
 status: active
 ---
 
-# Spec Rationale & Extended Reference (v1.4.1)
+# Spec Rationale & Extended Reference (v1.4.2)
 
 This document is the companion to [`specs/context_aware_ai_session_spec.md`](../specs/context_aware_ai_session_spec.md). It contains the background reasoning, extended examples, project profile illustrations, end-to-end scenarios, and future enhancement notes that were removed from the normative spec to keep it readable.
 
diff --git a/skills/create-agents-md/SKILL.md b/skills/create-agents-md/SKILL.md
@@ -32,7 +32,7 @@ Load or attach this file's contents into your AI session to activate the workflo
 1. Run seven-phase discovery using `references/discovery-phases.md`.
 2. Apply required element contract from `references/required-elements.md`.
 3. Generate artifact using `references/output-format.md`.
-4. Stamp `<!-- spec_version: 1.4.1 -->` as an HTML comment at the top of the generated `AGENTS.md`.
+4. Stamp `<!-- spec_version: 1.4.2 -->` as an HTML comment at the top of the generated `AGENTS.md`.
 5. Validate result against `references/quality-checklist.md`.
 6. Ensure links/paths remain relative and repository-accurate.
 
diff --git a/skills/create-project-instructions/SKILL.md b/skills/create-project-instructions/SKILL.md
@@ -35,7 +35,7 @@ Load or attach this file's contents into your AI session to activate the workflo
    - `references/command-template.md`
    - `references/role-template.md`
 4. Apply artifact/summary contract from `references/output-format.md`.
-5. Stamp `<!-- spec_version: 1.4.1 -->` as an HTML comment at the top of the generated `AGENTS.md`.
+5. Stamp `<!-- spec_version: 1.4.2 -->` as an HTML comment at the top of the generated `AGENTS.md`.
 6. Validate completeness using `references/quality-checklist.md` before final output.
 
 ## Output Expectations
diff --git a/skills/create-usercontext-instructions/SKILL.md b/skills/create-usercontext-instructions/SKILL.md
@@ -32,7 +32,7 @@ Load or attach this file's contents into your AI session to activate the workflo
 1. Run phased discovery using `references/discovery-phases.md`.
 2. Normalize findings into required schema using `references/output-schema.md`.
 3. Apply format contract from `references/output-format.md`.
-4. Stamp `spec_version: "1.4.1"` in the YAML frontmatter of the generated artifact.
+4. Stamp `spec_version: "1.4.2"` in the YAML frontmatter of the generated artifact.
 5. Validate against `references/quality-checklist.md` before final output.
 6. If structured metadata is requested, apply `references/json-metadata-schema.md`.
 
diff --git a/skills/create-usercontext-instructions/references/quality-checklist.md b/skills/create-usercontext-instructions/references/quality-checklist.md
@@ -1,7 +1,7 @@
 # Quality Checklist: create-usercontext-instructions
 
 Before finalizing:
-- [ ] Frontmatter includes `description`, `applyTo`, and `spec_version: "1.4.1"`.
+- [ ] Frontmatter includes `description`, `applyTo`, and `spec_version: "1.4.2"`.
 - [ ] All 15 required sections exist in correct order.
 - [ ] No unresolved placeholders remain unless user requested placeholders.
 - [ ] Privacy-sensitive fields respect user constraints.
diff --git a/skills/validate-agents-md/SKILL.md b/skills/validate-agents-md/SKILL.md
@@ -29,7 +29,7 @@ Load or attach this file's contents into your AI session to activate the workflo
 
 ## Workflow
 1. Run validation phases from `references/phase-checks.md`.
-2. Check for `<!-- spec_version: ... -->` comment: flag as WARNING if absent (pre-existing files may predate this requirement); flag as WARNING if present but older than `1.4.1`.
+2. Check for `<!-- spec_version: ... -->` comment: flag as WARNING if absent (pre-existing files may predate this requirement); flag as WARNING if present but older than `1.4.2`.
 3. Generate report using `references/report-contract.md`.
 4. Apply deterministic scoring from `references/scoring.md`.
 5. Classify findings into critical/warning/enhancement buckets.
diff --git a/skills/validate-project-instructions/SKILL.md b/skills/validate-project-instructions/SKILL.md
@@ -29,7 +29,7 @@ Load or attach this file's contents into your AI session to activate the workflo
 
 ## Workflow
 1. Run validation phases from `references/phase-checks.md`.
-2. Check for `<!-- spec_version: ... -->` comment: flag as WARNING if absent (pre-existing files may predate this requirement); flag as WARNING if present but older than `1.4.1`.
+2. Check for `<!-- spec_version: ... -->` comment: flag as WARNING if absent (pre-existing files may predate this requirement); flag as WARNING if present but older than `1.4.2`.
 3. Generate report using `references/report-contract.md`.
 4. Apply deterministic scoring from `references/scoring.md`.
 5. Classify findings into critical/warning/enhancement buckets.
diff --git a/skills/validate-usercontext-instructions/SKILL.md b/skills/validate-usercontext-instructions/SKILL.md
@@ -29,7 +29,7 @@ Load or attach this file's contents into your AI session to activate the workflo
 
 ## Workflow
 1. Run validation phases from `references/phase-checks.md`.
-2. Check for `spec_version` field in YAML frontmatter: flag as WARNING if absent (pre-existing files may predate this requirement); flag as WARNING if present but older than `1.4.1`.
+2. Check for `spec_version` field in YAML frontmatter: flag as WARNING if absent (pre-existing files may predate this requirement); flag as WARNING if present but older than `1.4.2`.
 3. Generate report using `references/report-contract.md`.
 4. Apply deterministic scoring from `references/scoring.md`.
 5. Classify findings into critical/warning/enhancement buckets.
diff --git a/specs/context_aware_ai_session_spec.md b/specs/context_aware_ai_session_spec.md
@@ -1,17 +1,17 @@
 ---
-version: 1.4.1
+version: 1.4.2
 context_type: specification
 document_type: technical_specification
 created: 2025-10-20
-last_updated: 2026-05-11
+last_updated: 2026-05-12
 status: active
 intended_audience: AI-assisted developers, system designers, prompt engineers, LLM-based tooling architects
 license: Open for adaptation and refinement
 ---
 
-# Context-Aware AI Session Flow Specification (v1.4.1)
+# Context-Aware AI Session Flow Specification (v1.4.2)
 
-**Version:** 1.4.1 | **Updated:** 2026-05-11 | **Status:** Active
+**Version:** 1.4.2 | **Updated:** 2026-05-12 | **Status:** Active
 
 > This document contains the normative rules. For background reasoning, extended examples, end-to-end scenarios, and future enhancement notes, see [`docs/spec-rationale.md`](../docs/spec-rationale.md).
 
diff --git a/templates/AGENTS_template.md b/templates/AGENTS_template.md
@@ -1,4 +1,4 @@
-<!-- spec_version: 1.4.1 -->
+<!-- spec_version: 1.4.2 -->
 
 # AGENTS.md Template
 
diff --git a/templates/usercontext_template.instructions.md b/templates/usercontext_template.instructions.md
@@ -1,14 +1,14 @@
 ---
 description: Personal AI collaboration context for [Your Name] - [Primary Focus] ([Primary Ecosystem])
 applyTo: "**/*"
-spec_version: "1.4.1"
+spec_version: "1.4.2"
 ---
 
 # User Context – [Your Name] ([Your Role/Title])
 
 > **Purpose:** This file defines your persistent **User Context** for instruction-based AI collaboration across providers.  
 > Load this first, then layer project-specific instructions for focused work.  
-> Aligned with the **Context-Aware AI Session Flow Specification v1.4.1**.
+> Aligned with the **Context-Aware AI Session Flow Specification v1.4.2**.
 
 You are an AI assistant working with **[Your Name]**, a [location]-based [profession/role].
 
@@ -301,4 +301,4 @@ This file is designed for:
 
 ---
 
-© [Year] [Your Name] – Personal User Context Instructions (Spec v1.4.1)
+© [Year] [Your Name] – Personal User Context Instructions (Spec v1.4.2)
diff --git a/usercontexts/sample_usercontext.instructions.md b/usercontexts/sample_usercontext.instructions.md
@@ -1,7 +1,7 @@
 ---
 description: Personal AI collaboration context for Jordan Kim - iOS Engineering (Apple)
 applyTo: "**/*"
-spec_version: "1.4.1"
+spec_version: "1.4.2"
 ---
 
 > **Note:** This is an illustrative example — Jordan Kim is not a real person. This file demonstrates realistic specificity, opinionated constraints, and lived-in project status that make a user context file genuinely useful.
@@ -10,7 +10,7 @@ spec_version: "1.4.1"
 
 > **Purpose:** This file defines your persistent **User Context** for instruction-based AI collaboration across providers.  
 > Load this first, then layer project-specific instructions for focused work.  
-> Aligned with the **Context-Aware AI Session Flow Specification v1.4.1**.
+> Aligned with the **Context-Aware AI Session Flow Specification v1.4.2**.
 
 You are an AI assistant working with **Jordan Kim**, a Toronto-based senior iOS developer.
 
diff --git a/usercontexts/sample_usercontext.validation.md b/usercontexts/sample_usercontext.validation.md
@@ -4,7 +4,7 @@
 
 **File:** `usercontexts/sample_usercontext.instructions.md`
 **Validated:** 2026-05-08
-**Spec Version:** v1.4.1
+**Spec Version:** v1.4.2
 **Validator:** `skills/validate-usercontext-instructions`
 
 ---
@@ -21,7 +21,7 @@
 ### Findings
 - Valid YAML frontmatter detected.
 - Required attributes `description` and `applyTo` are present.
-- `spec_version: "1.4.1"` is present and current — no version warning.
+- `spec_version: "1.4.2"` is present and current — no version warning.
 - No unsupported frontmatter attributes detected.
 
 ### Recommendations
@@ -81,7 +81,7 @@
 - Instruction-based architecture is explicit (WHO/WHAT/HOW) — assistant is told who Jordan Kim is, what the working constraints are, and how to behave in sessions.
 - Provider-neutral and portable wording is preserved throughout.
 - Content is complete for context-aware collaboration use across hosted, local, and API-based runtimes.
-- `spec_version: "1.4.1"` is present in YAML frontmatter, meeting the stamping requirement introduced in spec v1.3.1.
+- `spec_version: "1.4.2"` is present in YAML frontmatter, meeting the stamping requirement introduced in spec v1.3.1.
 - Session state defaults (role, phase, output style, tone, interaction mode) are explicitly defined.
 
 ### Recommendations
@@ -118,4 +118,4 @@
 1. Re-run validation whenever the canonical usercontext template or spec version changes.
 
 ### Migration Path (when relevant)
-1. Not applicable; artifact is aligned with spec v1.4.1.
+1. Not applicable; artifact is aligned with spec v1.4.2.

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",`
`3`	`3`	`"name": "ai-context-kit",`
`4`		`- "version": "1.4.1",`
	`4`	`+ "version": "1.4.2",`
`5`	`5`	`"description": "Context-aware AI collaboration skills for creating and validating user context, project AGENTS.md files, and skill artifacts across LLM providers.",`
`6`	`6`	`"author": {`
`7`	`7`	`"name": "MSiccDev Software Development",`