git-daemon 0.1.10 → 0.1.11

package/README.md

@@ -19,7 +19,9 @@ Git Daemon is a local Node.js service that exposes a small, authenticated HTTP A
 Healthchecks are user-supplied executables/scripts stored in local suites (which can be
 private repos). The daemon runs them as jobs, streams logs over SSE, and returns a
 normalized status (`na`, `failed`, `pass-partial`, `pass-full`) plus details. Suites are
-configured via local paths, and each check has a `healthcheck.json` manifest.
+configured via local paths, and each check has a `healthcheck.json` manifest. For a
+quick demo, set `healthchecks.demo: true` in config to auto-enable the bundled example
+suite (when present).
 
 ## Security model (high level)
 
@@ -218,6 +220,7 @@ Key settings live in `config.json`:
 - `deps.defaultSafer`: defaults to `true` for `--ignore-scripts`
 - `jobs.maxConcurrent` and `jobs.timeoutSeconds`
 - `healthchecks.suites`: array of absolute or config-relative suite paths
+- `healthchecks.demo`: enable bundled example healthchecks if present
 
 Tokens are stored (hashed) in `tokens.json`. Logs are written under the configured `logging.directory` with rotation.
 

package/config.schema.json

@@ -140,6 +140,11 @@
         },
         "defaultSuiteId": {
           "type": "string"
+        },
+        "demo": {
+          "type": "boolean",
+          "default": false,
+          "description": "When true, auto-enables the bundled example healthchecks if present."
         }
       }
     },

package/dist/config.js

@@ -47,6 +47,7 @@ const defaultConfig = () => ({
     },
     healthchecks: {
         suites: [],
+        demo: false,
     },
     logging: {
         directory: "logs",
@@ -68,7 +69,7 @@ const loadConfig = async (configDir) => {
     try {
         const raw = await fs_1.promises.readFile(configPath, "utf8");
         const data = JSON.parse(raw);
-        return {
+        const merged = {
             ...(0, exports.defaultConfig)(),
             ...data,
             server: {
@@ -107,6 +108,22 @@ const loadConfig = async (configDir) => {
                 entries: data.approvals?.entries ?? [],
             },
         };
+        if (merged.healthchecks?.demo) {
+            const demoSuitePath = path_1.default.resolve(__dirname, "..", "healthchecks", "example-suite");
+            try {
+                await fs_1.promises.access(demoSuitePath);
+                if (!merged.healthchecks.suites.includes(demoSuitePath)) {
+                    merged.healthchecks.suites = [
+                        ...merged.healthchecks.suites,
+                        demoSuitePath,
+                    ];
+                }
+            }
+            catch {
+                // Ignore missing demo suite; config can still load.
+            }
+        }
+        return merged;
     }
     catch (err) {
         if (err.code !== "ENOENT") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "git-daemon",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "private": false,
   "type": "commonjs",
   "main": "dist/daemon.js",
@@ -8,6 +8,8 @@
     "build": "tsc",
     "daemon": "tsx src/daemon.ts",
     "daemon:setup": "tsx src/setup.ts",
+    "typecheck": "tsc --noEmit",
+    "verify": "npm run lint && npm run typecheck && npm test",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:clone": "bash scripts/test-clone.sh",

package/src/config.ts

@@ -46,6 +46,7 @@ export const defaultConfig = (): AppConfig => ({
   },
   healthchecks: {
     suites: [],
+    demo: false,
   },
   logging: {
     directory: "logs",
@@ -67,7 +68,7 @@ export const loadConfig = async (configDir: string): Promise<AppConfig> => {
   try {
     const raw = await fs.readFile(configPath, "utf8");
     const data = JSON.parse(raw) as AppConfig;
-    return {
+    const merged: AppConfig = {
       ...defaultConfig(),
       ...data,
       server: {
@@ -106,6 +107,28 @@ export const loadConfig = async (configDir: string): Promise<AppConfig> => {
         entries: data.approvals?.entries ?? [],
       },
     };
+
+    if (merged.healthchecks?.demo) {
+      const demoSuitePath = path.resolve(
+        __dirname,
+        "..",
+        "healthchecks",
+        "example-suite",
+      );
+      try {
+        await fs.access(demoSuitePath);
+        if (!merged.healthchecks.suites.includes(demoSuitePath)) {
+          merged.healthchecks.suites = [
+            ...merged.healthchecks.suites,
+            demoSuitePath,
+          ];
+        }
+      } catch {
+        // Ignore missing demo suite; config can still load.
+      }
+    }
+
+    return merged;
   } catch (err) {
     if ((err as NodeJS.ErrnoException).code !== "ENOENT") {
       throw err;

package/src/daemon.ts

@@ -15,6 +15,7 @@ const start = async () => {
     port: ctx.config.server.port,
     workspaceRoot: ctx.config.workspaceRoot ?? "not configured",
     originAllowlist: ctx.config.originAllowlist,
+    healthchecksDemo: ctx.config.healthchecks?.demo ?? false,
   };
   ctx.logger.info(startupSummary, "Git Daemon starting");
   if (process.env.GIT_DAEMON_LOG_STDOUT !== "1") {
@@ -26,6 +27,9 @@ const start = async () => {
     console.log(
       `  allowlist: ${startupSummary.originAllowlist.join(", ") || "none"}`,
     );
+    if (startupSummary.healthchecksDemo) {
+      console.log("  healthchecks: demo mode enabled");
+    }
     const httpsConfig = ctx.config.server.https;
     if (httpsConfig?.enabled) {
       console.log(

package/src/types.ts

@@ -34,6 +34,7 @@ export type AppConfig = {
   healthchecks?: {
     suites: string[];
     defaultSuiteId?: string;
+    demo?: boolean;
   };
   logging: {
     directory: string;