@horizon36596/zenith-seasons 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Horizon (FTC 36596)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,18 @@
+Zenith
+Copyright (c) 2026 Horizon (FTC 36596)
+
+Zenith is licensed under the MIT License; see LICENSE.
+
+Third-party assets
+
+- BIOBUZZ field images (apps/web/public/fields/biobuzz/*.webp) by Team Juice 16236, from the r/FTC
+  post "BIOBUZZ custom field images (MeepMeep compatible)". Used with the credit the author asks for.
+
+Bundled fonts
+
+The following fonts are bundled in apps/web/public/fonts/. Each is licensed under the SIL Open Font
+License, Version 1.1. The full licence text ships next to each font file.
+
+- Jost, licensed under the SIL Open Font License 1.1 (jost-OFL.txt).
+- IBM Plex Sans, licensed under the SIL Open Font License 1.1 (ibm-plex-sans-OFL.txt).
+- JetBrains Mono, licensed under the SIL Open Font License 1.1 (jetbrains-mono-OFL.txt).

package/README.md

@@ -0,0 +1,20 @@
+# @horizon36596/zenith-seasons
+
+The season registry of [Zenith](https://libraries.horizon36596.org/zenith/), the FTC autonomous
+planner by Horizon (FTC 36596). It turns a field file into the season rules the feasibility checks
+run against, so the editor, the CLI and the MCP server always agree on which season a project is.
+
+```
+npm install @horizon36596/zenith-seasons
+```
+
+```ts
+import { resolveSeason } from "@horizon36596/zenith-seasons";
+
+const { rules, warnings } = resolveSeason(field);
+```
+
+A field that names no known season gets no season rules and a warning, never an error. Seasons
+bundled today: BIOBUZZ ([`@horizon36596/zenith-season-biobuzz`](https://www.npmjs.com/package/@horizon36596/zenith-season-biobuzz)).
+
+Documentation: https://libraries.horizon36596.org/zenith/. Licence: MIT.

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @horizon36596/zenith-seasons: the one place that turns a `field.json` into the `SeasonRules` the core runs
+ * against, so the editor, the CLI and the MCP server never disagree about which season a project is.
+ *
+ * A season package implements `SeasonRules` and knows nothing about this registry; this package
+ * knows the registry and nothing about a season's rules. Adding a season is one entry below plus a
+ * dependency, and every consumer picks it up.
+ */
+import { type SeasonRules } from "@horizon36596/zenith-core";
+import type { Field } from "@horizon36596/zenith-schema";
+/** One season the registry knows, as the open dialog and `zenith init` list them. */
+export interface SeasonInfo {
+    /** The `rules.plugin` value in `field.json` that selects it. */
+    readonly plugin: string;
+    /** The `season` value in `field.json`, which selects it too when `rules.plugin` is absent. */
+    readonly season: string;
+    /** What a human calls it. */
+    readonly label: string;
+}
+/**
+ * What `field.json` resolved to. `known` is false when the file names a plugin this build does not
+ * carry: the rules are then `noSeasonRules`, the routine still plans and estimates, and every
+ * season-dependent check and ledger row is simply absent. `warnings` says so in full sentences; it
+ * is returned rather than logged, because core's callers include a pure CLI and an MCP server whose
+ * stdout is a protocol.
+ */
+export interface SeasonResolution {
+    readonly rules: SeasonRules;
+    readonly known: boolean;
+    /** The plugin name the field file asked for, or null when it names none. */
+    readonly plugin: string | null;
+    readonly warnings: readonly string[];
+}
+/** Every season this build carries, for a picker or a `--help` listing. */
+export declare const listSeasons: () => SeasonInfo[];
+/** The rules for a field file, with everything the caller needs to explain a miss. */
+export declare function resolveSeason(field: Field): SeasonResolution;
+/** The rules for a field file. The common case, when the caller has nothing to say about a miss. */
+export declare const seasonFor: (field: Field) => SeasonRules;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE5E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEzD,qFAAqF;AACrF,MAAM,WAAW,UAAU;IACzB,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAeD,2EAA2E;AAC3E,eAAO,MAAM,WAAW,QAAO,UAAU,EACiC,CAAC;AAW3E,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,gBAAgB,CAoB5D;AAED,oGAAoG;AACpG,eAAO,MAAM,SAAS,GAAI,OAAO,KAAK,KAAG,WAAyC,CAAC"}

package/dist/index.js

@@ -0,0 +1,50 @@
+/**
+ * @horizon36596/zenith-seasons: the one place that turns a `field.json` into the `SeasonRules` the core runs
+ * against, so the editor, the CLI and the MCP server never disagree about which season a project is.
+ *
+ * A season package implements `SeasonRules` and knows nothing about this registry; this package
+ * knows the registry and nothing about a season's rules. Adding a season is one entry below plus a
+ * dependency, and every consumer picks it up.
+ */
+import { noSeasonRules } from "@horizon36596/zenith-core";
+import { loadSeason as loadBiobuzz, seasonId as biobuzzSeasonId } from "@horizon36596/zenith-season-biobuzz";
+const REGISTRY = [
+    {
+        plugin: "season-biobuzz",
+        season: biobuzzSeasonId,
+        label: "BIOBUZZ presented by RTX (FTC 2026-27)",
+        load: loadBiobuzz,
+    },
+];
+/** Every season this build carries, for a picker or a `--help` listing. */
+export const listSeasons = () => REGISTRY.map(({ plugin, season, label }) => ({ plugin, season, label }));
+/** The registration a field file selects, by `rules.plugin` first and by `season` second. */
+function find(field) {
+    const plugin = field.rules?.plugin;
+    if (typeof plugin === "string" && plugin !== "") {
+        return REGISTRY.find((entry) => entry.plugin === plugin) ?? null;
+    }
+    return REGISTRY.find((entry) => entry.season === field.season) ?? null;
+}
+/** The rules for a field file, with everything the caller needs to explain a miss. */
+export function resolveSeason(field) {
+    const plugin = field.rules?.plugin ?? null;
+    const found = find(field);
+    if (found !== null) {
+        return { rules: found.load(field), known: true, plugin: found.plugin, warnings: [] };
+    }
+    const named = plugin === null
+        ? `The field file "${field.name}" names no season plugin`
+        : `The field file "${field.name}" names the season plugin "${plugin}", which this build does not carry`;
+    return {
+        rules: noSeasonRules,
+        known: false,
+        plugin,
+        warnings: [
+            `${named}, so the season checks and the ledger are inert. Known plugins: ${REGISTRY.map((entry) => entry.plugin).join(", ")}.`,
+        ],
+    };
+}
+/** The rules for a field file. The common case, when the caller has nothing to say about a miss. */
+export const seasonFor = (field) => resolveSeason(field).rules;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,aAAa,EAAoB,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAgC7G,MAAM,QAAQ,GAA4B;IACxC;QACE,MAAM,EAAE,gBAAgB;QACxB,MAAM,EAAE,eAAe;QACvB,KAAK,EAAE,wCAAwC;QAC/C,IAAI,EAAE,WAAW;KAClB;CACF,CAAC;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,WAAW,GAAG,GAAiB,EAAE,CAC5C,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAE3E,6FAA6F;AAC7F,SAAS,IAAI,CAAC,KAAY;IACxB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC;IACnC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QAChD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC;IACnE,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;AACzE,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,KAAY;IACxC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,MAAM,IAAI,IAAI,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACvF,CAAC;IACD,MAAM,KAAK,GACT,MAAM,KAAK,IAAI;QACb,CAAC,CAAC,mBAAmB,KAAK,CAAC,IAAI,0BAA0B;QACzD,CAAC,CAAC,mBAAmB,KAAK,CAAC,IAAI,8BAA8B,MAAM,oCAAoC,CAAC;IAC5G,OAAO;QACL,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,KAAK;QACZ,MAAM;QACN,QAAQ,EAAE;YACR,GAAG,KAAK,mEAAmE,QAAQ,CAAC,GAAG,CACrF,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CACxB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;SAChB;KACF,CAAC;AACJ,CAAC;AAED,oGAAoG;AACpG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAY,EAAe,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@horizon36596/zenith-seasons",
+  "version": "0.1.1",
+  "description": "The Zenith season registry: turns a field file into the season rules the checks run against.",
+  "keywords": [
+    "ftc",
+    "first-tech-challenge",
+    "robotics",
+    "autonomous",
+    "zenith",
+    "season"
+  ],
+  "homepage": "https://libraries.horizon36596.org/zenith/",
+  "bugs": {
+    "url": "https://github.com/Horizon-36596/zenith/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Horizon-36596/zenith.git",
+    "directory": "packages/seasons"
+  },
+  "license": "MIT",
+  "author": "Horizon (FTC 36596)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/**/*.qa.test.*",
+    "!dist/**/testSupport.*",
+    "!dist/**/*.tsbuildinfo",
+    "!dist/testing",
+    "!dist/**/testing.*",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@horizon36596/zenith-schema": "0.1.1",
+    "@horizon36596/zenith-season-biobuzz": "0.1.1",
+    "@horizon36596/zenith-core": "0.1.1"
+  },
+  "scripts": {}
+}