seniority 0.0.1

package/README.md

@@ -0,0 +1,22 @@
+# seniority
+
+**Not yet released, and not yet on the roadmap.** This version reserves the name. The layer,
+its incumbents and the measurements behind it are documented in
+[`.sdlc/research/candidate-layers.md`](https://github.com/ofri-peretz/burgee/blob/main/.sdlc/research/candidate-layers.md).
+An intent and a working release follow if and when the roadmap takes it up.
+
+**Seniority** is ranking higher because of longer service or higher position — and therefore taking precedence when there is a conflict. Two people want the same shift; seniority decides.
+
+Config sources have rank. A `--flag` outranks an environment variable, which outranks a project config file, which outranks a home config file, which outranks a default. When they disagree, seniority settles it.
+
+## What it will be
+
+- **One declared order, not per-tool folklore.** Precedence is a truth table you can read and test, not a paragraph in a README.
+- **Provenance for every value.** If `out` is `lib`, the answer to *which source set it* is a file and a line — not a shrug. An agent repairing a misconfiguration needs the origin, not just the value.
+- **One package, not seven.** The incumbents split discovery and loading across `cosmiconfig`, `find-up`, `locate-path`, `p-locate`, `path-exists`, `import-fresh` and `parse-json`.
+- **Drop-in paths** for `cosmiconfig`, `lilconfig`, `dotenv` and `rc`, graded by their own suites.
+- **Zero external dependencies.**
+
+## Licence
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * seniority — name reserved, not yet on the roadmap. The layer and the measurements
+ * behind it are documented in .sdlc/research/candidate-layers.md in the burgee
+ * repository. Until an intent is opened this entry exports only its own name, so
+ * that importing it costs nothing and promises nothing.
+ */
+export declare const name: "seniority";

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * seniority — name reserved, not yet on the roadmap. The layer and the measurements
+ * behind it are documented in .sdlc/research/candidate-layers.md in the burgee
+ * repository. Until an intent is opened this entry exports only its own name, so
+ * that importing it costs nothing and promises nothing.
+ */
+export const name = 'seniority';
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "seniority",
+  "version": "0.0.1",
+  "description": "Which source outranks the others. One resolution for flags, environment, project and home config files and defaults \u2014 with provenance, so every value can say where it came from. Drop-in paths for cosmiconfig, dotenv and rc. Zero dependencies.",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "!dist/**/*.test.*"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "lint": "eslint src"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ofri-peretz/burgee.git",
+    "directory": "packages/seniority"
+  },
+  "homepage": "https://github.com/ofri-peretz/burgee/tree/main/packages/seniority#readme",
+  "bugs": {
+    "url": "https://github.com/ofri-peretz/burgee/issues"
+  },
+  "keywords": [
+    "cli",
+    "config",
+    "configuration",
+    "cosmiconfig",
+    "dotenv",
+    "rc",
+    "lilconfig",
+    "precedence",
+    "env",
+    "settings",
+    "provenance"
+  ],
+  "devDependencies": {
+    "vitest": "^4.0.0"
+  }
+}