@on-par/factory-cli 0.9.11-next.3 → 0.9.11-next.30

package/dist/cli/usage-json.d.ts

@@ -1,19 +1,10 @@
 import type { SubscriptionUsage } from '@on-par/factory-core';
+import type { UsageJson } from './json-contract.js';
+/** `factory usage --json` payload (#2270); absent readings are null, never 0 (ADR-0099). */
+export type { UsageJson } from './json-contract.js';
 /** Hours in the trailing usage window `factory usage` reports on. */
 export declare const USAGE_WINDOW_HOURS: number;
-export type UsageJsonSource = 'subscription' | 'heuristic' | 'unavailable';
-/** `factory usage --json` payload (#2270). Absent readings are null, never 0 (ADR-0099).
- *  Additive changes only; bump schemaVersion on a breaking change. */
-export interface UsageJson {
-    schemaVersion: 1;
-    source: UsageJsonSource;
-    /** Percent of the window used, 0-100 scale. */
-    utilizationPct: number | null;
-    resetsAt: string | null;
-    windowHours: number;
-    /** Trailing-window list-price estimate in USD. */
-    estimateUsd: number | null;
-}
+export type UsageJsonSource = UsageJson['source'];
 /** Builds the `factory usage --json` payload: the real subscription reading when present, else the
  *  list-price heuristic against `cap`, else an explicit `unavailable` record. Numbers are not rounded. */
 export declare function buildUsageJson(subscription: SubscriptionUsage | null, estimateUsd: number | null, cap: number): UsageJson;

package/dist/cli/usage-json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage-json.d.ts","sourceRoot":"","sources":["../../src/cli/usage-json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,QAAiC,CAAC;AAEjE,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,WAAW,GAAG,aAAa,CAAC;AAE3E;sEACsE;AACtE,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,CAAC,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,+CAA+C;IAC/C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;0GAC0G;AAC1G,wBAAgB,cAAc,CAC5B,YAAY,EAAE,iBAAiB,GAAG,IAAI,EACtC,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,GAAG,EAAE,MAAM,GACV,SAAS,CA6BX"}
+{"version":3,"file":"usage-json.d.ts","sourceRoot":"","sources":["../../src/cli/usage-json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,4FAA4F;AAC5F,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,QAAiC,CAAC;AAEjE,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAElD;0GAC0G;AAC1G,wBAAgB,cAAc,CAC5B,YAAY,EAAE,iBAAiB,GAAG,IAAI,EACtC,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,GAAG,EAAE,MAAM,GACV,SAAS,CA6BX"}

package/dist/cli/usage-json.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage-json.js","sourceRoot":"","sources":["../../src/cli/usage-json.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,qEAAqE;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,GAAG,SAAS,CAAC;AAiBjE;0GAC0G;AAC1G,MAAM,UAAU,cAAc,CAC5B,YAAsC,EACtC,WAA0B,EAC1B,GAAW;IAEX,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO;YACL,aAAa,EAAE,CAAC;YAChB,MAAM,EAAE,cAAc;YACtB,cAAc,EAAE,YAAY,CAAC,mBAAmB;YAChD,QAAQ,EAAE,YAAY,CAAC,gBAAgB;YACvC,WAAW,EAAE,kBAAkB;YAC/B,WAAW;SACZ,CAAC;IACJ,CAAC;IACD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO;YACL,aAAa,EAAE,CAAC;YAChB,MAAM,EAAE,WAAW;YACnB,cAAc,EAAE,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,GAAG;YACzC,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,kBAAkB;YAC/B,WAAW;SACZ,CAAC;IACJ,CAAC;IACD,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,MAAM,EAAE,aAAa;QACrB,cAAc,EAAE,IAAI;QACpB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EAAE,IAAI;KAClB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"usage-json.js","sourceRoot":"","sources":["../../src/cli/usage-json.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAMnE,qEAAqE;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,GAAG,SAAS,CAAC;AAIjE;0GAC0G;AAC1G,MAAM,UAAU,cAAc,CAC5B,YAAsC,EACtC,WAA0B,EAC1B,GAAW;IAEX,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO;YACL,aAAa,EAAE,CAAC;YAChB,MAAM,EAAE,cAAc;YACtB,cAAc,EAAE,YAAY,CAAC,mBAAmB;YAChD,QAAQ,EAAE,YAAY,CAAC,gBAAgB;YACvC,WAAW,EAAE,kBAAkB;YAC/B,WAAW;SACZ,CAAC;IACJ,CAAC;IACD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO;YACL,aAAa,EAAE,CAAC;YAChB,MAAM,EAAE,WAAW;YACnB,cAAc,EAAE,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,GAAG;YACzC,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,kBAAkB;YAC/B,WAAW;SACZ,CAAC;IACJ,CAAC;IACD,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,MAAM,EAAE,aAAa;QACrB,cAAc,EAAE,IAAI;QACpB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EAAE,IAAI;KAClB,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@on-par/factory-cli",
-  "version": "0.9.11-next.3",
+  "version": "0.9.11-next.30",
   "description": "On PAR Dev's Software Factory CLI: takes a GitHub issue through plan, build and check with AI agents, then opens a ready-for-review PR.",
   "keywords": [
     "ai-agents",
@@ -17,6 +17,7 @@
   },
   "files": [
     "dist",
+    "schemas",
     "!dist/.tsbuildinfo"
   ],
   "publishConfig": {
@@ -47,12 +48,14 @@
     "@octokit/plugin-retry": "^8.1.1",
     "@octokit/plugin-throttling": "^11.0.5",
     "@octokit/rest": "^22.0.0",
-    "@on-par/factory-core": "0.9.11-next.3",
-    "@on-par/factory-tui": "0.9.11-next.3",
-    "commander": "^15.0.0"
+    "@on-par/factory-core": "0.9.11-next.30",
+    "@on-par/factory-tui": "0.9.11-next.30",
+    "commander": "^15.0.0",
+    "zod": "^4.6.5"
   },
   "license": "MIT",
   "devDependencies": {
-    "@types/node": "^26.6.5"
+    "@types/node": "^26.6.5",
+    "ajv": "^8.20.0"
   }
 }

package/schemas/cost.schema.json

@@ -0,0 +1,100 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "rows": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "ts": {
+            "type": "string"
+          },
+          "issue": {
+            "type": "string"
+          },
+          "task": {
+            "type": "string"
+          },
+          "model": {
+            "type": "string"
+          },
+          "inputTokens": {
+            "type": "number"
+          },
+          "outputTokens": {
+            "type": "number"
+          },
+          "cacheReadTokens": {
+            "type": ["number", "null"]
+          },
+          "cacheCreationTokens": {
+            "type": ["number", "null"]
+          },
+          "cost": {
+            "type": ["number", "null"]
+          }
+        },
+        "required": [
+          "ts",
+          "issue",
+          "task",
+          "model",
+          "inputTokens",
+          "outputTokens",
+          "cacheReadTokens",
+          "cacheCreationTokens",
+          "cost"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "perModel": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "model": {
+            "type": "string"
+          },
+          "tasks": {
+            "type": "number"
+          },
+          "inputTokens": {
+            "type": "number"
+          },
+          "outputTokens": {
+            "type": "number"
+          },
+          "cost": {
+            "type": ["number", "null"]
+          },
+          "unpricedCount": {
+            "type": "number"
+          }
+        },
+        "required": ["model", "tasks", "inputTokens", "outputTokens", "cost", "unpricedCount"],
+        "additionalProperties": false
+      }
+    },
+    "total": {
+      "type": "object",
+      "properties": {
+        "cost": {
+          "type": ["number", "null"]
+        },
+        "unpricedCount": {
+          "type": "number"
+        }
+      },
+      "required": ["cost", "unpricedCount"],
+      "additionalProperties": false
+    }
+  },
+  "required": ["schemaVersion", "rows", "perModel", "total"],
+  "additionalProperties": false
+}

package/schemas/daemon-status.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "running": {
+      "type": "boolean"
+    },
+    "pid": {
+      "type": ["number", "null"]
+    },
+    "uptimeSec": {
+      "type": ["number", "null"]
+    },
+    "plistInstalled": {
+      "type": "boolean"
+    },
+    "repos": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "slug": {
+            "type": "string"
+          },
+          "checkoutPath": {
+            "type": "string"
+          },
+          "state": {
+            "type": "string",
+            "enum": ["active", "paused", "draining", "detached"]
+          }
+        },
+        "required": ["slug", "checkoutPath", "state"],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": ["schemaVersion", "running", "pid", "uptimeSec", "plistInstalled", "repos"],
+  "additionalProperties": false
+}

package/schemas/logs-line.schema.json

@@ -0,0 +1,114 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "ts": {
+      "type": "string"
+    },
+    "type": {
+      "type": "string"
+    },
+    "issue": {
+      "type": "string"
+    },
+    "msg": {
+      "type": "string"
+    },
+    "level": {
+      "type": "string",
+      "enum": ["debug", "info", "warn", "error"]
+    },
+    "lane": {
+      "type": "string"
+    },
+    "repo": {
+      "type": "string"
+    },
+    "phase": {
+      "type": "string"
+    },
+    "actor": {
+      "type": "string"
+    },
+    "failoverReason": {
+      "type": "string"
+    },
+    "fingerprint": {
+      "type": "string"
+    },
+    "evidence": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": {}
+    },
+    "rework": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": {}
+    },
+    "readiness": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": {}
+    },
+    "queueReprioritization": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": {}
+    },
+    "prClassification": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": {}
+    },
+    "lanePaused": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": {}
+    },
+    "stewardTriggered": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": {}
+    },
+    "flakyTests": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": {}
+    },
+    "checkFailure": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": {}
+    },
+    "ciFailure": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": {}
+    },
+    "model": {
+      "type": "string"
+    },
+    "tokens": {
+      "type": "object",
+      "properties": {
+        "input": {
+          "type": "number"
+        },
+        "output": {
+          "type": "number"
+        }
+      },
+      "required": ["input", "output"],
+      "additionalProperties": false
+    },
+    "durationMs": {
+      "type": "number"
+    },
+    "cursor": {
+      "type": "string"
+    }
+  },
+  "required": ["ts", "type", "issue", "msg"],
+  "additionalProperties": false
+}

package/schemas/queue-list.schema.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "lanes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "lane": {
+            "type": "string"
+          },
+          "items": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "issue": {
+                  "type": "number"
+                },
+                "title": {
+                  "type": "string"
+                },
+                "status": {
+                  "type": "string",
+                  "enum": ["queued", "in-progress", "parked"]
+                },
+                "order": {
+                  "type": "number"
+                },
+                "claimedBy": {
+                  "type": ["string", "null"]
+                }
+              },
+              "required": ["issue", "status", "order", "claimedBy"],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": ["lane", "items"],
+        "additionalProperties": false
+      }
+    },
+    "orderConflicts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "lane": {
+            "type": "string"
+          },
+          "order": {
+            "type": ["number", "null"]
+          },
+          "issues": {
+            "type": "array",
+            "items": {
+              "type": "number"
+            }
+          },
+          "reason": {
+            "type": "string",
+            "enum": ["missing-order-label", "multiple-order-labels", "malformed-order-label"]
+          }
+        },
+        "required": ["lane", "order", "issues"],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": ["schemaVersion", "lanes", "orderConflicts"],
+  "additionalProperties": false
+}

package/schemas/runs-diffstat.schema.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "issue": {
+      "type": "number"
+    },
+    "branch": {
+      "type": ["string", "null"]
+    },
+    "base": {
+      "type": "string"
+    },
+    "files": {
+      "anyOf": [
+        {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string"
+              },
+              "added": {
+                "type": ["number", "null"]
+              },
+              "deleted": {
+                "type": ["number", "null"]
+              }
+            },
+            "required": ["path", "added", "deleted"],
+            "additionalProperties": false
+          }
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "totals": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "files": {
+              "type": "number"
+            },
+            "added": {
+              "type": "number"
+            },
+            "deleted": {
+              "type": "number"
+            }
+          },
+          "required": ["files", "added", "deleted"],
+          "additionalProperties": false
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "reason": {
+      "anyOf": [
+        {
+          "type": "string",
+          "enum": ["branch-missing", "base-missing", "no-branch"]
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "required": ["schemaVersion", "issue", "branch", "base", "files", "totals", "reason"],
+  "additionalProperties": false
+}

package/schemas/runs.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "runs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "issue": {
+            "type": "number"
+          },
+          "lane": {
+            "type": ["string", "null"]
+          },
+          "repo": {
+            "type": ["string", "null"]
+          },
+          "status": {
+            "type": ["string", "null"]
+          },
+          "phase": {
+            "anyOf": [
+              {
+                "type": "string",
+                "enum": ["plan", "build", "check", "ship"]
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "branch": {
+            "type": ["string", "null"]
+          },
+          "prNumber": {
+            "type": ["number", "null"]
+          },
+          "model": {
+            "type": ["string", "null"]
+          },
+          "attempts": {
+            "type": ["number", "null"]
+          },
+          "startedAt": {
+            "type": ["string", "null"]
+          },
+          "updatedAt": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "issue",
+          "lane",
+          "repo",
+          "status",
+          "phase",
+          "branch",
+          "prNumber",
+          "model",
+          "attempts",
+          "startedAt",
+          "updatedAt"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": ["schemaVersion", "runs"],
+  "additionalProperties": false
+}