chore(copyright): add sync-header-years script and tests

chore(copyright): wire sync script into lefthook and add package scripts

feat(eslint): add inline ping-copyright rule to eslint.config.mjs

Author: SteinGabriel

eslint.config.mjs

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2025 Ping Identity Corporation. All rights reserved.
+ * Copyright (c) 2025 - 2026 Ping Identity Corporation. All rights reserved.
  *
  * This software may be modified and distributed under the terms
  * of the MIT license. See the LICENSE file for details.
@@ -33,6 +33,48 @@ export default [
       '**/test-output',
     ],
   },
+  {
+    files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx', '**/*.mjs', '**/*.cjs'],
+    ignores: [
+      '**/*.test.*',
+      '**/*.spec.*',
+      '**/vite.config.*',
+      '**/vitest.config.*',
+      '**/vitest.setup.*',
+      '**/eslint.config.*',
+    ],
+    plugins: {
+      'local-rules': {
+        rules: {
+          'ping-copyright': {
+            meta: {
+              type: 'suggestion',
+              messages: { missing: 'Missing Ping Identity copyright header.' },
+            },
+            create(context) {
+              return {
+                Program(node) {
+                  const src = context.getSourceCode();
+                  const comments = src.getAllComments();
+                  const first = comments[0];
+                  if (
+                    !first ||
+                    first.range[0] > 0 ||
+                    !/Copyright[\s\S]*Ping Identity/i.test(first.value)
+                  ) {
+                    context.report({ node, messageId: 'missing' });
+                  }
+                },
+              };
+            },
+          },
+        },
+      },
+    },
+    rules: {
+      'local-rules/ping-copyright': 'warn',
+    },
+  },
   ...compat.extends('plugin:@typescript-eslint/recommended', 'plugin:prettier/recommended'),
   {
     plugins: {

lefthook.yml

@@ -2,6 +2,9 @@ pre-commit:
   commands:
     nx-sync:
       run: pnpm nx sync
+    copyright-sync:
+      run: node tools/copyright/sync-header-years.mjs --fix
+      stage_fixed: true
     nx-check:
       run: pnpm nx affected -t typecheck lint build api-report --tui=false
       stage_fixed: true

package.json

@@ -20,6 +20,8 @@
     "circular-dep-check": "madge --circular .",
     "clean": "shx rm -rf ./{coverage,dist,docs,node_modules,tmp}/ ./{packages,e2e}/*/{dist,node_modules}/ ./e2e/node_modules/ && git clean -fX -e \"!.env*,nx-cloud.env\" -e \"!**/GEMINI.md\"",
     "commit": "git cz",
+    "copyright:check": "node tools/copyright/sync-header-years.mjs --check",
+    "copyright:sync": "node tools/copyright/sync-header-years.mjs --fix",
     "commitlint": "commitlint --edit",
     "create-package": "nx g @nx/js:library",
     "format": "pnpm nx format:write",
@@ -45,7 +47,6 @@
       "path": "./node_modules/cz-conventional-changelog"
     }
   },
-  "dependencies": {},
   "devDependencies": {
     "@changesets/changelog-github": "^0.6.0",
     "@changesets/cli": "^2.27.9",
@@ -55,6 +56,7 @@
     "@effect/cli": "catalog:effect",
     "@eslint/eslintrc": "^3.0.0",
     "@eslint/js": "~9.39.0",
+    "@evilmartians/lefthook": "^2.1.4",
     "@nx/devkit": "22.6.5",
     "@nx/eslint": "22.6.5",
     "@nx/eslint-plugin": "22.6.5",
@@ -92,7 +94,6 @@
     "eslint-plugin-playwright": "^2.0.0",
     "eslint-plugin-prettier": "^5.2.3",
     "fast-check": "^4.0.0",
-    "@evilmartians/lefthook": "^2.1.4",
     "jiti": "2.6.1",
     "jsdom": "27.4.0",
     "jsonc-eslint-parser": "^2.1.0",
@@ -104,9 +105,9 @@
     "shx": "^0.4.0",
     "swc-loader": "0.2.7",
     "ts-node": "10.9.2",
-    "tsx": "^4.20.0",
     "ts-patch": "3.3.0",
     "tslib": "^2.5.0",
+    "tsx": "^4.20.0",
     "typedoc": "^0.27.4",
     "typedoc-github-theme": "0.2.1",
     "typedoc-plugin-rename-defaults": "^0.7.2",

packages/davinci-client/api-report/davinci-client.api.md

@@ -270,7 +270,7 @@ export function davinci<ActionType extends ActionTypes = ActionTypes>(input: {
     start: <QueryParams extends OutgoingQueryParams = OutgoingQueryParams>(options?: StartOptions<QueryParams> | undefined) => Promise<ContinueNode | StartNode | ErrorNode | FailureNode | SuccessNode>;
     update: <T extends SingleValueCollectors | MultiSelectCollector | ObjectValueCollectors | AutoCollectors>(collector: T) => Updater<T>;
     validate: (collector: SingleValueCollectors | ObjectValueCollectors | MultiValueCollectors | AutoCollectors) => Validator;
-    poll: (collector: PollingCollector) => Poller;
+    pollStatus: (collector: PollingCollector) => Poller;
     getClient: () => {
         status: "start";
     } | {

packages/davinci-client/api-report/davinci-client.types.api.md

@@ -270,7 +270,7 @@ export function davinci<ActionType extends ActionTypes = ActionTypes>(input: {
     start: <QueryParams extends OutgoingQueryParams = OutgoingQueryParams>(options?: StartOptions<QueryParams> | undefined) => Promise<ContinueNode | StartNode | ErrorNode | FailureNode | SuccessNode>;
     update: <T extends SingleValueCollectors | MultiSelectCollector | ObjectValueCollectors | AutoCollectors>(collector: T) => Updater<T>;
     validate: (collector: SingleValueCollectors | ObjectValueCollectors | MultiValueCollectors | AutoCollectors) => Validator;
-    poll: (collector: PollingCollector) => Poller;
+    pollStatus: (collector: PollingCollector) => Poller;
     getClient: () => {
         status: "start";
     } | {