gitsawe 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BereketeAb
+
+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/README.md

@@ -0,0 +1,64 @@
+# gitsawe
+
+Open JSON data for Gitsawe readings, feasts, sub-feasts, months, mahlets, and packages.
+
+## Data files
+
+- `data/daily-gitsawe.json`
+- `data/seasonal-gitsawe.json`
+- `data/monthly-gitsawe.json`
+- `data/months.json`
+- `data/feasts.json`
+- `data/sub-feasts.json`
+- `data/mahlets.json`
+- `data/packages.json`
+
+## Package API
+
+```ts
+import { Gitsawe, gitsaweData, dailyGitsawe, seasonalGitsawe, monthlyGitsawe } from "gitsawe";
+```
+
+`gitsaweData` preserves the original seed order from GitsaweBot:
+daily, seasonal fast/feast data, then monthly data.
+
+### Find readings
+
+```ts
+const newYear = Gitsawe.find({
+  type: "daily",
+  date: new Date(2025, 8, 11),
+});
+
+const byKey = Gitsawe.find({
+  type: "daily",
+  date: "01-01",
+});
+```
+
+`Date` values are read as local Gregorian dates and converted to the
+Ethiopian `DD-MM` key used by the daily Gitsawe data. String dates are matched
+exactly as provided.
+
+## Validate
+
+```sh
+npm test
+```
+
+## CLI
+
+```sh
+npx gitsawe daily 01-01
+```
+
+The CLI prints JSON. Use `daily`, `seasonal`, `monthly`, or `all`; omit the
+date to print the full selected collection.
+
+## Source
+
+Generated from the GitsaweBot seed files with:
+
+```sh
+npm run export:data
+```

package/bin/gitsawe.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+
+const { readFileSync } = require("node:fs");
+const { join } = require("node:path");
+
+const collections = {
+  daily: "daily-gitsawe.json",
+  seasonal: "seasonal-gitsawe.json",
+  monthly: "monthly-gitsawe.json",
+  all: null,
+};
+
+function readJson(fileName) {
+  return JSON.parse(readFileSync(join(__dirname, "..", "data", fileName), "utf8"));
+}
+
+function readCollection(type) {
+  if (type === "all") {
+    return [
+      ...readJson(collections.daily),
+      ...readJson(collections.seasonal),
+      ...readJson(collections.monthly),
+    ];
+  }
+
+  return readJson(collections[type]);
+}
+
+function printUsage() {
+  console.log(`Usage: gitsawe [type] [date]
+
+Types:
+  daily      Daily Gitsawe readings
+  seasonal   Seasonal fast and feast readings
+  monthly    Monthly readings
+  all        All Gitsawe readings
+
+Examples:
+  gitsawe
+  gitsawe daily
+  gitsawe daily 01-01`);
+}
+
+const args = process.argv.slice(2);
+
+if (args.includes("--help") || args.includes("-h")) {
+  printUsage();
+  process.exit(0);
+}
+
+const type = args[0] || "all";
+const date = args[1];
+
+if (!Object.hasOwn(collections, type)) {
+  console.error(`Unknown Gitsawe type: ${type}`);
+  printUsage();
+  process.exit(1);
+}
+
+const entries = readCollection(type);
+const result = date === undefined ? entries : entries.filter((entry) => entry.date === date);
+
+console.log(JSON.stringify(result, null, 2));