@oddessentials/repo-standards 3.1.0 → 4.0.1
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.
- package/README.md +2 -1
- package/dist/config/standards.csharp-dotnet.azure-devops.json +1 -1
- package/dist/config/standards.csharp-dotnet.github-actions.json +1 -1
- package/dist/config/standards.csharp-dotnet.json +1 -1
- package/dist/config/standards.go.azure-devops.json +1 -1
- package/dist/config/standards.go.github-actions.json +1 -1
- package/dist/config/standards.go.json +1 -1
- package/dist/config/standards.json +1 -1
- package/dist/config/standards.python.azure-devops.json +1 -1
- package/dist/config/standards.python.github-actions.json +1 -1
- package/dist/config/standards.python.json +1 -1
- package/dist/config/standards.rust.azure-devops.json +1 -1
- package/dist/config/standards.rust.github-actions.json +1 -1
- package/dist/config/standards.rust.json +1 -1
- package/dist/config/standards.typescript-js.azure-devops.json +1 -1
- package/dist/config/standards.typescript-js.github-actions.json +1 -1
- package/dist/config/standards.typescript-js.json +1 -1
- package/dist/index.d.ts +14 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +19 -0
- package/dist/version.d.ts +11 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +10 -0
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -68,7 +68,7 @@ The master spec includes a `meta` block that defines system-wide expectations:
|
|
|
68
68
|
|
|
69
69
|
## Structure of `config/standards.json`
|
|
70
70
|
|
|
71
|
-
- `version` — schema version (currently `
|
|
71
|
+
- `version` — schema version (currently `4`)
|
|
72
72
|
- `meta` — global rules and migration policy
|
|
73
73
|
- `ciSystems` — supported CI platforms
|
|
74
74
|
_(currently `github-actions`, `azure-devops`)_
|
|
@@ -103,6 +103,7 @@ The `version` field indicates schema compatibility:
|
|
|
103
103
|
- `1` — Original schema
|
|
104
104
|
- `2` — Adds `bazelHints`, `meta.executorHints.bazel` for Bazel support, `anyOfFiles`, `pinningNotes`, enforcement/severity levels, ratio-based coverage thresholds, Rust/Go stacks. Enforces strict validation with `additionalProperties: false`.
|
|
105
105
|
- `3` — Expands release, build determinism, and provenance/CI automation requirements; adds unified release workflow and template automation guidance.
|
|
106
|
+
- `4` — Stable API contract with `getStandards()`, `getSchema()`, `STANDARDS_VERSION` exports; Node 22 LTS alignment.
|
|
106
107
|
|
|
107
108
|
Consumers should ignore unknown fields for forward compatibility.
|
|
108
109
|
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import type { MasterJson, StackChecklistJson, StackId, CiSystem } from "./types.js";
|
|
2
|
+
import { STANDARDS_VERSION, STANDARDS_SCHEMA_VERSION } from "./version.js";
|
|
2
3
|
export type { MasterJson, StackChecklistJson, StackId, CiSystem };
|
|
4
|
+
export { STANDARDS_VERSION, STANDARDS_SCHEMA_VERSION };
|
|
3
5
|
/** Load the master spec JSON from the packaged dist directory */
|
|
4
6
|
export declare function loadMasterSpec(): MasterJson;
|
|
5
7
|
/** Load a stack-specific checklist (optionally filtered by CI system) */
|
|
@@ -8,4 +10,16 @@ export declare function loadBaseline(stack: StackId, ci?: CiSystem): StackCheckl
|
|
|
8
10
|
export declare function listSupportedStacks(): readonly StackId[];
|
|
9
11
|
/** List all supported CI systems (derived from the master spec) */
|
|
10
12
|
export declare function listSupportedCiSystems(): readonly CiSystem[];
|
|
13
|
+
/**
|
|
14
|
+
* PUBLIC API CONTRACT (semver-governed)
|
|
15
|
+
* Alias for loadBaseline - loads stack-specific standards checklist.
|
|
16
|
+
* Breaking changes to this function signature require a major version bump.
|
|
17
|
+
*/
|
|
18
|
+
export declare function getStandards(stack: StackId, ci?: CiSystem): StackChecklistJson;
|
|
19
|
+
/**
|
|
20
|
+
* PUBLIC API CONTRACT (semver-governed)
|
|
21
|
+
* Alias for loadMasterSpec - loads the master standards schema.
|
|
22
|
+
* Breaking changes to this function signature require a major version bump.
|
|
23
|
+
*/
|
|
24
|
+
export declare function getSchema(): MasterJson;
|
|
11
25
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,OAAO,EACP,QAAQ,EACT,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,OAAO,EACP,QAAQ,EACT,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAG3E,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAGlE,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,CAAC;AAcvD,iEAAiE;AACjE,wBAAgB,cAAc,IAAI,UAAU,CAG3C;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,EACd,EAAE,CAAC,EAAE,QAAQ,GACZ,kBAAkB,CAKpB;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,IAAI,SAAS,OAAO,EAAE,CAGxD;AAED,mEAAmE;AACnE,wBAAgB,sBAAsB,IAAI,SAAS,QAAQ,EAAE,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,EACd,EAAE,CAAC,EAAE,QAAQ,GACZ,kBAAkB,CAEpB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,UAAU,CAEtC"}
|
package/dist/index.js
CHANGED
|
@@ -1,6 +1,9 @@
|
|
|
1
1
|
import { fileURLToPath } from "node:url";
|
|
2
2
|
import { readFileSync } from "node:fs";
|
|
3
3
|
import { join, dirname } from "node:path";
|
|
4
|
+
import { STANDARDS_VERSION, STANDARDS_SCHEMA_VERSION } from "./version.js";
|
|
5
|
+
// Re-export version info (stable API contract)
|
|
6
|
+
export { STANDARDS_VERSION, STANDARDS_SCHEMA_VERSION };
|
|
4
7
|
// ESM equivalent of __dirname
|
|
5
8
|
const __filename = fileURLToPath(import.meta.url);
|
|
6
9
|
const __dirname = dirname(__filename);
|
|
@@ -33,6 +36,22 @@ export function listSupportedCiSystems() {
|
|
|
33
36
|
const spec = loadMasterSpec();
|
|
34
37
|
return spec.ciSystems;
|
|
35
38
|
}
|
|
39
|
+
/**
|
|
40
|
+
* PUBLIC API CONTRACT (semver-governed)
|
|
41
|
+
* Alias for loadBaseline - loads stack-specific standards checklist.
|
|
42
|
+
* Breaking changes to this function signature require a major version bump.
|
|
43
|
+
*/
|
|
44
|
+
export function getStandards(stack, ci) {
|
|
45
|
+
return loadBaseline(stack, ci);
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* PUBLIC API CONTRACT (semver-governed)
|
|
49
|
+
* Alias for loadMasterSpec - loads the master standards schema.
|
|
50
|
+
* Breaking changes to this function signature require a major version bump.
|
|
51
|
+
*/
|
|
52
|
+
export function getSchema() {
|
|
53
|
+
return loadMasterSpec();
|
|
54
|
+
}
|
|
36
55
|
/** Optional CLI entry point for debugging */
|
|
37
56
|
if (import.meta.url.startsWith("file:") && process.argv[1] === __filename) {
|
|
38
57
|
console.log({
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AUTO-GENERATED at build time by scripts/build.ts
|
|
3
|
+
* DO NOT EDIT MANUALLY
|
|
4
|
+
*
|
|
5
|
+
* This module provides version information for the repo-standards package.
|
|
6
|
+
* Consumers should import from here instead of package.json to avoid
|
|
7
|
+
* ESM/CJS interop issues.
|
|
8
|
+
*/
|
|
9
|
+
export declare const STANDARDS_VERSION = "4.0.0";
|
|
10
|
+
export declare const STANDARDS_SCHEMA_VERSION = 4;
|
|
11
|
+
//# sourceMappingURL=version.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,wBAAwB,IAAI,CAAC"}
|
package/dist/version.js
ADDED
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AUTO-GENERATED at build time by scripts/build.ts
|
|
3
|
+
* DO NOT EDIT MANUALLY
|
|
4
|
+
*
|
|
5
|
+
* This module provides version information for the repo-standards package.
|
|
6
|
+
* Consumers should import from here instead of package.json to avoid
|
|
7
|
+
* ESM/CJS interop issues.
|
|
8
|
+
*/
|
|
9
|
+
export const STANDARDS_VERSION = "4.0.0";
|
|
10
|
+
export const STANDARDS_SCHEMA_VERSION = 4;
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@oddessentials/repo-standards",
|
|
3
3
|
"private": false,
|
|
4
|
-
"version": "
|
|
4
|
+
"version": "4.0.1",
|
|
5
5
|
"description": "Standards and CI filtering utilities for multi-stack repository governance.",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"scripts": {
|
|
@@ -46,7 +46,7 @@
|
|
|
46
46
|
"vitest": "^4.0.15"
|
|
47
47
|
},
|
|
48
48
|
"engines": {
|
|
49
|
-
"node": ">=
|
|
49
|
+
"node": ">=22 <23"
|
|
50
50
|
},
|
|
51
51
|
"lint-staged": {
|
|
52
52
|
"*.{js,ts,mjs,json,md}": [
|