git-daemon 0.1.11 → 0.1.12

package/README.md

@@ -199,6 +199,14 @@ curl -H "Origin: https://app.example.com" \
   http://127.0.0.1:8790/v1/healthchecks/jobs/<JOB_ID>/result
 ```
 
+List healthchecks (flat):
+
+```bash
+curl -H "Origin: https://app.example.com" \
+  -H "Authorization: Bearer <TOKEN>" \
+  "http://127.0.0.1:8790/v1/healthchecks?flat=true"
+```
+
 ## Configuration
 
 Config is stored in OS-specific directories:

package/design.md

@@ -430,7 +430,7 @@ Recommendations:
 
 ### Healthcheck endpoints
 
-* `GET /v1/healthchecks` → list installed suites and checks.
+* `GET /v1/healthchecks` → list installed suites and checks (use `?flat=true` for a flattened list).
 * `POST /v1/healthchecks/run` → job
 
   * body: `{ repoPath, repoInfo?, suiteId?, checks?: [{ suiteId?, checkId, config?, cacheMode? }] }`

package/healthchecks/example-suite/about-description/run.js

@@ -155,10 +155,16 @@ const description =
 
 if (!description) {
   emit({
-    status: "na",
+    status: "failed",
     summary: "Missing repo description",
-    explanation:
-      "REPO_INFO.description is missing, so there is nothing to compare.",
+    explanation: "REPO_INFO.description is required for this healthcheck.",
+    details: [
+      {
+        code: "ABOUT_MISSING",
+        severity: "high",
+        message: "Provide a GitHub repo description to match the README.",
+      },
+    ],
   });
   process.exit(0);
 }
@@ -166,9 +172,16 @@ if (!description) {
 const readmePath = findReadme(repoPath);
 if (!readmePath) {
   emit({
-    status: "na",
+    status: "failed",
     summary: "README not found",
-    explanation: "No README file was found in the repo root.",
+    explanation: "A README is required to compare against the description.",
+    details: [
+      {
+        code: "README_MISSING",
+        severity: "high",
+        message: "Add a README with a clear first sentence.",
+      },
+    ],
   });
   process.exit(0);
 }
@@ -195,10 +208,18 @@ try {
 const firstSentence = extractFirstSentence(readmeText);
 if (!firstSentence) {
   emit({
-    status: "na",
-    summary: "README has no readable paragraph",
+    status: "failed",
+    summary: "README missing a first sentence",
     explanation:
       "Could not locate non-title text to compare against the description.",
+    details: [
+      {
+        code: "README_SENTENCE_MISSING",
+        severity: "high",
+        message:
+          "Add a first paragraph with a clear first sentence after the title.",
+      },
+    ],
   });
   process.exit(0);
 }

package/openapi.yaml

@@ -321,13 +321,16 @@ paths:
       summary: List available healthchecks
       parameters:
         - $ref: '#/components/parameters/OriginHeader'
+        - $ref: '#/components/parameters/HealthcheckFlat'
       responses:
         '200':
           description: Healthcheck catalog
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/HealthcheckCatalogResponse'
+                oneOf:
+                  - $ref: '#/components/schemas/HealthcheckCatalogResponse'
+                  - $ref: '#/components/schemas/HealthcheckFlatResponse'
         '401':
           $ref: '#/components/responses/Unauthorized'
         '403':
@@ -438,6 +441,14 @@ components:
       schema:
         type: boolean
         default: true
+    HealthcheckFlat:
+      name: flat
+      in: query
+      required: false
+      schema:
+        type: boolean
+        default: false
+      description: Return a flattened list of checks instead of suites.
   schemas:
     MetaResponse:
       type: object
@@ -790,6 +801,15 @@ components:
           type: array
           items:
             $ref: '#/components/schemas/HealthcheckSuite'
+    HealthcheckFlatResponse:
+      type: object
+      required:
+        - checks
+      properties:
+        checks:
+          type: array
+          items:
+            $ref: '#/components/schemas/HealthcheckFlatCheck'
     HealthcheckSuite:
       type: object
       required:
@@ -843,6 +863,43 @@ components:
           additionalProperties: true
         outputSchemaVersion:
           type: integer
+    HealthcheckFlatCheck:
+      type: object
+      required:
+        - suiteId
+        - checkId
+        - name
+        - version
+        - description
+        - timeoutSeconds
+        - cacheable
+      properties:
+        suiteId:
+          type: string
+        checkId:
+          type: string
+        name:
+          type: string
+        version:
+          type: string
+        description:
+          type: string
+        timeoutSeconds:
+          type: integer
+          minimum: 1
+        cacheable:
+          type: boolean
+        cacheMaxAgeSeconds:
+          type: integer
+          minimum: 1
+        permissions:
+          $ref: '#/components/schemas/HealthcheckPermissions'
+        configSchema:
+          type: object
+          description: JSON schema for check config.
+          additionalProperties: true
+        outputSchemaVersion:
+          type: integer
     HealthcheckPermissions:
       type: object
       properties:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "git-daemon",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "private": false,
   "type": "commonjs",
   "main": "dist/daemon.js",

package/src/app.ts

@@ -54,6 +54,7 @@ import { installDeps } from "./deps";
 import { openTarget } from "./os";
 import {
   HealthcheckResultStore,
+  flattenHealthchecks,
   listHealthcheckSuites,
   loadHealthcheckSuites,
   resolveSelections,
@@ -530,6 +531,11 @@ export const createApp = (ctx: DaemonContext) => {
           ctx.configDir,
           ctx.config.healthchecks?.suites ?? [],
         );
+        const flat = _req.query.flat === "true";
+        if (flat) {
+          res.json({ checks: flattenHealthchecks(suites) });
+          return;
+        }
         res.json({ suites: listHealthcheckSuites(suites) });
       } catch (err) {
         next(err);

package/src/healthchecks.ts

@@ -279,6 +279,23 @@ export const listHealthcheckSuites = (suites: HealthcheckSuite[]) =>
     })),
   }));
 
+export const flattenHealthchecks = (suites: HealthcheckSuite[]) =>
+  suites.flatMap((suite) =>
+    suite.checks.map((check) => ({
+      suiteId: suite.id,
+      checkId: check.id,
+      name: check.name,
+      version: check.version,
+      description: check.description,
+      timeoutSeconds: check.timeoutSeconds,
+      cacheable: check.cacheable,
+      cacheMaxAgeSeconds: check.cacheMaxAgeSeconds,
+      permissions: check.permissions,
+      configSchema: check.configSchema,
+      outputSchemaVersion: check.outputSchemaVersion,
+    })),
+  );
+
 export const resolveSelections = (
   suites: HealthcheckSuite[],
   request: HealthcheckRunRequest,