@koppajs/koppajs-core 3.0.3 → 3.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/README.md +18 -7
  3. package/package.json +7 -5
package/CHANGELOG.md CHANGED
@@ -22,6 +22,28 @@ Changes will only appear here when they:
22
22
 
23
23
  ---
24
24
 
25
+ ## [3.0.4] — Documentation Contract And Release Guardrails
26
+
27
+ **2026-03-27**
28
+
29
+ Patch release to formalize governed repository-document contracts, strengthen
30
+ local release validation, and tighten contributor workflow guidance. No
31
+ intentional runtime or public API changes.
32
+
33
+ ### Added
34
+
35
+ - Added an explicit repository documentation contract spec and a local validator
36
+ for governed root documents
37
+
38
+ ### Changed
39
+
40
+ - Added `check:docs` to the main quality gate and local pre-commit flow
41
+ - Tightened README and contributor governance docs around documentation shape
42
+ and release expectations
43
+ - Updated GitHub Actions workflow action runtimes for CI and release automation
44
+
45
+ ---
46
+
25
47
  ## [3.0.3] — Tooling Baseline And Ecosystem Cleanup
26
48
 
27
49
  **2026-03-26**
package/README.md CHANGED
@@ -50,8 +50,8 @@
50
50
  <li><a href="#getting-started">Getting Started</a></li>
51
51
  <li><a href="#runtime-model">Runtime Model</a></li>
52
52
  <li><a href="#roadmap">Roadmap</a></li>
53
- <li><a href="#architecture--governance">Architecture & Governance</a></li>
54
- <li><a href="#community--contribution">Community & Contribution</a></li>
53
+ <li><a href="#architecture-governance">Architecture & Governance</a></li>
54
+ <li><a href="#community-contribution">Community & Contribution</a></li>
55
55
  <li><a href="#license">License</a></li>
56
56
  </ol>
57
57
  </details>
@@ -178,8 +178,7 @@ core consumes at runtime.
178
178
 
179
179
  ## Architecture & Governance
180
180
 
181
- Project intent, runtime constraints, and contributor rules live in the repo
182
- meta layer:
181
+ Project intent, contributor rules, and documentation contracts live in the local repo meta layer:
183
182
 
184
183
  - [AI_CONSTITUTION.md](./AI_CONSTITUTION.md)
185
184
  - [ARCHITECTURE.md](./ARCHITECTURE.md)
@@ -188,10 +187,20 @@ meta layer:
188
187
  - [TESTING_STRATEGY.md](./TESTING_STRATEGY.md)
189
188
  - [RELEASE.md](./RELEASE.md)
190
189
  - [ROADMAP.md](./ROADMAP.md)
191
- - [docs/specs/component-runtime-contract.md](./docs/specs/component-runtime-contract.md)
192
- - [docs/architecture/runtime-flow.md](./docs/architecture/runtime-flow.md)
190
+ - [CHANGELOG.md](./CHANGELOG.md)
191
+ - [CONTRIBUTING.md](./CONTRIBUTING.md)
192
+ - [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md)
193
+ - [docs/specs/README.md](./docs/specs/README.md)
194
+ - [docs/specs/repository-documentation-contract.md](./docs/specs/repository-documentation-contract.md)
195
+ - [docs/meta/README.md](./docs/meta/README.md)
193
196
 
194
- Tagged releases are documented in `CHANGELOG.md`.
197
+ The file-shape contract for `README.md`, `CHANGELOG.md`, `CODE_OF_CONDUCT.md`, and `CONTRIBUTING.md` is defined in [docs/specs/repository-documentation-contract.md](./docs/specs/repository-documentation-contract.md).
198
+
199
+ Run the local document guard before committing:
200
+
201
+ ```bash
202
+ pnpm run check:docs
203
+ ```
195
204
 
196
205
  ---
197
206
 
@@ -203,6 +212,8 @@ https://github.com/koppajs/koppajs-core/issues
203
212
 
204
213
  Contributor workflow details live in [CONTRIBUTING.md](./CONTRIBUTING.md).
205
214
 
215
+ Community expectations live in [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md).
216
+
206
217
  ---
207
218
 
208
219
  ## License
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@koppajs/koppajs-core",
3
- "version": "3.0.3",
3
+ "version": "3.0.4",
4
4
  "type": "module",
5
5
  "types": "./dist/index.d.ts",
6
6
  "main": "./dist/index.cjs.js",
@@ -67,9 +67,10 @@
67
67
  "lint:fix": "eslint . --fix",
68
68
  "format": "prettier --write .",
69
69
  "format:check": "prettier --check .",
70
- "check": "pnpm run typecheck && pnpm run lint && pnpm run format:check && pnpm run test:ci",
71
- "validate": "pnpm run check && pnpm run build",
72
- "dump:ai": "node scripts/project-dump.mjs"
70
+ "check": "pnpm run check:docs && pnpm run typecheck && pnpm run lint && pnpm run format:check && pnpm run test:ci",
71
+ "validate": "pnpm run check:docs && pnpm run check && pnpm run build",
72
+ "dump:ai": "node scripts/project-dump.mjs",
73
+ "check:docs": "node scripts/check-doc-contract.mjs"
73
74
  },
74
75
  "packageManager": "pnpm@10.24.0",
75
76
  "engines": {
@@ -105,5 +106,6 @@
105
106
  "onlyBuiltDependencies": [
106
107
  "esbuild"
107
108
  ]
108
- }
109
+ },
110
+ "private": false
109
111
  }