@rheged-studio/changelog-core 1.1.1

package/dist/lib/stamp.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Stamp `version` onto an entry if it has none. Returns the rewritten markdown,
+ * or null when the entry already has a version (no write needed).
+ */
+export declare function stampVersion(raw: string, version: string): null | string;
+/**
+ * Read the `version` field from a package.json string.
+ */
+export declare function readPackageVersion(packageJsonRaw: string): string;
+//# sourceMappingURL=stamp.d.ts.map

package/dist/lib/stamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.d.ts","sourceRoot":"","sources":["../../src/lib/stamp.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CASxE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAajE"}

package/dist/lib/stamp.js

@@ -0,0 +1,35 @@
+// Pure helpers for release-time version stamping: set `version` on an entry
+// that doesn't have one, and read the version from package.json.
+//
+// Library module (no CLI): the release-time orchestrator finalise composes
+// these. Kept pure so they're trivially unit-testable. Zero-dep — uses the
+// package's frontmatter parser.
+import { blank } from "./blank.js";
+import { parseFrontmatter, stringifyFrontmatter } from "./frontmatter.js";
+/**
+ * Stamp `version` onto an entry if it has none. Returns the rewritten markdown,
+ * or null when the entry already has a version (no write needed).
+ */
+export function stampVersion(raw, version) {
+    const parsed = parseFrontmatter(raw);
+    const fm = { ...parsed.data };
+    if (!blank(fm.version)) {
+        return null;
+    }
+    fm.version = version;
+    return stringifyFrontmatter(parsed.content, fm);
+}
+/**
+ * Read the `version` field from a package.json string.
+ */
+export function readPackageVersion(packageJsonRaw) {
+    const pkg = JSON.parse(packageJsonRaw);
+    if (!pkg ||
+        typeof pkg !== "object" ||
+        Array.isArray(pkg) ||
+        typeof pkg.version !== "string" ||
+        pkg.version.length === 0) {
+        throw new Error("package.json is missing a string `version`");
+    }
+    return pkg.version;
+}

package/dist/lib/vendor/issue-keys.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Escape regex metacharacters so a configured key such as `C++` or `MY.KEY`
+ * can't throw at construction or silently widen the match.
+ */
+export declare function escapeRegex(source: string): string;
+/**
+ * Build the `\b(?:KEY|…)-\d+\b` matcher (global flag) from configured issue keys.
+ *
+ * Returns `null` when no keys are configured: an empty alternation would match
+ * the empty string before every `-<digits>` and inject bogus links (e.g. `-2`).
+ * A single key needs no `(?:…)` wrapper — only wrap when there's an alternation,
+ * because the naive join `\bA|B-\d+\b` parses as `\bA` *or* `B-\d+\b` (matching a
+ * bare `A` and missing `A-7`).
+ */
+export declare function buildIssueRe(keys: string[]): null | RegExp;
+//# sourceMappingURL=issue-keys.d.ts.map

package/dist/lib/vendor/issue-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-keys.d.ts","sourceRoot":"","sources":["../../../src/lib/vendor/issue-keys.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,MAAM,CAQ1D"}

package/dist/lib/vendor/issue-keys.js

@@ -0,0 +1,29 @@
+// Canonical issue-key helpers — the single source of truth for deriving a
+// Linear issue-key regex from a branch name or prose.
+//
+// Pure and zero-dependency by design: the host loads its own config and
+// passes the configured keys in.
+/**
+ * Escape regex metacharacters so a configured key such as `C++` or `MY.KEY`
+ * can't throw at construction or silently widen the match.
+ */
+export function escapeRegex(source) {
+    return source.replaceAll(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Build the `\b(?:KEY|…)-\d+\b` matcher (global flag) from configured issue keys.
+ *
+ * Returns `null` when no keys are configured: an empty alternation would match
+ * the empty string before every `-<digits>` and inject bogus links (e.g. `-2`).
+ * A single key needs no `(?:…)` wrapper — only wrap when there's an alternation,
+ * because the naive join `\bA|B-\d+\b` parses as `\bA` *or* `B-\d+\b` (matching a
+ * bare `A` and missing `A-7`).
+ */
+export function buildIssueRe(keys) {
+    if (!Array.isArray(keys) || keys.length === 0) {
+        return null;
+    }
+    const alternation = keys.map(escapeRegex).join("|");
+    const group = keys.length > 1 ? `(?:${alternation})` : alternation;
+    return new RegExp(`\\b${group}-\\d+\\b`, "g");
+}

package/package.json

@@ -0,0 +1,124 @@
+{
+  "name": "@rheged-studio/changelog-core",
+  "version": "1.1.1",
+  "description": "Shared changelog contract and dual-runtime CLI for Acme Skunkworks — validate, enrich, and finalise dated changelog entries.",
+  "keywords": [
+    "changelog",
+    "release-notes",
+    "validate",
+    "enrich",
+    "finalise"
+  ],
+  "homepage": "https://github.com/rheged-studio/changelog-core#readme",
+  "bugs": {
+    "url": "https://github.com/rheged-studio/changelog-core/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rheged-studio/changelog-core.git"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Rob Easthope",
+    "url": "https://github.com/RobEasthope"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./contract": "./changelog-contract.md"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "changelog-core": "dist/cli.js"
+  },
+  "files": [
+    "changelog-contract.md",
+    "config.json",
+    "dist"
+  ],
+  "scripts": {
+    "act:ci": "act pull_request -W .github/workflows/ci.yml --eventpath .github/act-events/pull_request.json",
+    "act:list": "act --list",
+    "act:release:dry": "act push -W .github/workflows/pkg-release.yml",
+    "build": "tsc",
+    "changelog:enrich": "tsx src/cli.ts --config config.json enrich",
+    "changelog:finalise": "tsx src/cli.ts --config config.json finalise",
+    "ci:list": "gh run list --limit 10",
+    "ci:view": "gh run view",
+    "ci:watch": "gh run watch $(gh run list -L 1 --json databaseId -q '.[0].databaseId // empty')",
+    "clean": "rimraf node_modules dist",
+    "format": "prettier --write .",
+    "lint": "eslint 'src/**/*.ts' 'tests/**/*.ts' --cache --cache-location ./.eslintcache",
+    "lint:fix": "eslint 'src/**/*.ts' 'tests/**/*.ts' --fix --cache --cache-location ./.eslintcache",
+    "lint:md": "markdownlint-cli2 '**/*.{md,mdx}' '!**/node_modules/**' '!**/dist/**' '!**/.turbo/**' '!**/.astro/**' '!**/.claude/skills/**' '!**/.agents/skills/**'",
+    "lint:md:fix": "markdownlint-cli2 --fix '**/*.{md,mdx}' '!**/node_modules/**' '!**/dist/**' '!**/.turbo/**' '!**/.astro/**' '!**/.claude/skills/**' '!**/.agents/skills/**'",
+    "lint:sh": "bash -c 'if command -v shellcheck >/dev/null 2>&1; then shellcheck infrastructure/scripts/*.sh .husky/pre-commit .husky/pre-push .husky/commit-msg; elif [ \"$(uname -s)\" = \"Darwin\" ]; then echo \"⚠️  shellcheck not installed — skipping. Install: brew install shellcheck\"; else echo \"⚠️  shellcheck not installed — skipping. Install: apt-get install shellcheck\"; fi'",
+    "lint:workflows": "actionlint",
+    "lint:yaml": "yamllint .",
+    "prepare": "husky",
+    "prepublishOnly": "pnpm run build",
+    "release:manual": "pnpm run build && npm publish --access public --provenance=false",
+    "release:manual:dry": "pnpm run build && npm publish --access public --provenance=false --dry-run",
+    "sort-pkg-json": "sort-package-json",
+    "test": "vitest run",
+    "test:sh": "bash -c 'if command -v bats >/dev/null 2>&1; then bats infrastructure/tests/*.bats; elif [ \"$(uname -s)\" = \"Darwin\" ]; then echo \"⚠️  bats not installed — skipping. Install: brew install bats-core\"; else echo \"⚠️  bats not installed — skipping. Install: apt-get install bats\"; fi'",
+    "test:watch": "vitest",
+    "tsc": "tsc --noEmit && tsc -p tsconfig.tools.json",
+    "validate:changelog": "tsx src/cli.ts --config config.json validate"
+  },
+  "lint-staged": {
+    "**/*": [
+      "prettier --write --ignore-unknown"
+    ],
+    "**/*.{ts,tsx,js,mjs,cjs}": [
+      "bash -c 'pnpm exec eslint --fix --cache --cache-location ./.eslintcache \"$@\" || true' --"
+    ],
+    "**/package.json": [
+      "bash -c 'sort-package-json \"$@\" || true' --",
+      "bash -c 'pnpm exec eslint --fix --cache --cache-location ./.eslintcache \"$@\" || true' --"
+    ],
+    "**/*.{md,mdx}": [
+      "bash -c 'markdownlint-cli2 --fix --config ./.markdownlint-cli2.jsonc \"$@\" || true' --"
+    ],
+    "**/*.{yml,yaml}": [
+      "bash -c 'if command -v yamllint >/dev/null 2>&1; then yamllint \"$@\"; elif [ \"$(uname -s)\" = \"Darwin\" ]; then echo \"⚠️  yamllint not installed — skipping. Install with: brew install yamllint\"; else echo \"⚠️  yamllint not installed — skipping. Install with: pip install --user yamllint==1.37.1\"; fi' --"
+    ],
+    ".github/workflows/*.{yml,yaml}": [
+      "bash -c 'if command -v actionlint >/dev/null 2>&1; then actionlint \"$@\"; elif [ \"$(uname -s)\" = \"Darwin\" ]; then echo \"⚠️  actionlint not installed — skipping. Install with: brew install actionlint\"; else echo \"⚠️  actionlint not installed — skipping. Install via: bash <(curl -fsSL https://raw.githubusercontent.com/rhysd/actionlint/v1.7.5/scripts/download-actionlint.bash)\"; fi' --"
+    ]
+  },
+  "devDependencies": {
+    "@acme-skunkworks/commitlint-config": "^1.0.1",
+    "@acme-skunkworks/eslint-config": "^1.1.3",
+    "@acme-skunkworks/markdownlint-config": "^3.0.0",
+    "@commitlint/cli": "^21.2.1",
+    "@types/node": "^25.6.0",
+    "bats": "1.13.0",
+    "eslint": "^9.0.0",
+    "husky": "^9.1.7",
+    "jiti": "^2.7.0",
+    "lint-staged": "^16.3.2",
+    "markdownlint-cli2": "^0.18.1",
+    "prettier": "^3.0.0",
+    "prettier-plugin-tailwindcss": "^0.8.0",
+    "rimraf": "^6.0.1",
+    "sort-package-json": "^3.6.1",
+    "tsx": "^4.21.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  },
+  "packageManager": "pnpm@10.33.0",
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}