@on-par/factory-cli 0.0.0-stage → 0.9.1

package/dist/cli/update-state.d.ts

@@ -0,0 +1,44 @@
+import { type FactorydConfig, type InstallKind, type UpdateChannel, type UpdateMode } from './daemon.js';
+export declare const UPDATE_OUTCOMES: readonly ['updated', 'rolled-back', 'failed', 'skipped'];
+export type UpdateOutcome = (typeof UPDATE_OUTCOMES)[number];
+export interface UpdateLastResult {
+    at: string;
+    version: string;
+    outcome: UpdateOutcome;
+    error?: string;
+}
+export interface UpdateDraining {
+    since: string;
+    target: string;
+}
+/** On-disk shape of <daemon state dir>/update-state.json (#2129). */
+export interface UpdateState {
+    schemaVersion: 1;
+    mode: UpdateMode;
+    channel: UpdateChannel | null;
+    installKind: InstallKind;
+    current: string;
+    available: string | null;
+    lastCheckAt: string | null;
+    lastResult: UpdateLastResult | null;
+    draining: UpdateDraining | null;
+}
+/** `update` in `factory status --json` — UpdateState without schemaVersion. */
+export type StatusUpdateJson = Omit<UpdateState, 'schemaVersion'>;
+export declare function updateStatePath(stateDir: string): string;
+/** Tolerant reader: a missing or invalid file is `null`; never throws. */
+export declare function readUpdateState(file: string): UpdateState | null;
+/** Atomic write (tmp + rename) so a concurrent `factory status` never reads a torn file. */
+export declare function writeUpdateState(file: string, state: UpdateState): void;
+export declare function initialUpdateState(config: Pick<FactorydConfig, 'autoUpdate' | 'install'>, previous: UpdateState | null): UpdateState;
+export declare function buildStatusUpdateJson(state: UpdateState | null): StatusUpdateJson | null;
+/** The one human line `factory status` prints for the update state. */
+export declare function formatUpdateStatusLine(update: StatusUpdateJson | null): string;
+export declare function formatUpdateStartupLine(state: UpdateState): string;
+export declare function formatUpdateCheckLine(state: UpdateState): string;
+/** Records one check result and logs it once. Seam for the later update checker; no production caller yet. */
+export declare function recordUpdateCheck(file: string, check: {
+    at: string;
+    available: string | null;
+}, log: (line: string) => void): UpdateState | null;
+//# sourceMappingURL=update-state.d.ts.map

package/dist/cli/update-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-state.d.ts","sourceRoot":"","sources":["../../src/cli/update-state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvH,eAAO,MAAM,eAAe,YAAI,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AACxF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,CAAC,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACpC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;CACjC;AAED,+EAA+E;AAC/E,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;AAIlE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AA0BD,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAuBhE;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAKvE;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,SAAS,CAAC,EACtD,QAAQ,EAAE,WAAW,GAAG,IAAI,GAC3B,WAAW,CAeb;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,gBAAgB,GAAG,IAAI,CAIxF;AA0BD,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,MAAM,CAa9E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAElE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAGhE;AAED,8GAA8G;AAC9G,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAC/C,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC1B,WAAW,GAAG,IAAI,CAOpB"}

package/dist/cli/update-state.js

@@ -0,0 +1,154 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { UPDATE_MODES } from './daemon.js';
+export const UPDATE_OUTCOMES = ['updated', 'rolled-back', 'failed', 'skipped'];
+const INSTALL_KINDS = ['npm-global', 'source', 'unknown'];
+export function updateStatePath(stateDir) {
+    return join(stateDir, 'update-state.json');
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function stringOrNull(value) {
+    return typeof value === 'string' ? value : null;
+}
+function parseLastResult(value) {
+    if (!isRecord(value))
+        return null;
+    const { at, version, outcome, error } = value;
+    if (typeof at !== 'string' || typeof version !== 'string')
+        return null;
+    if (!UPDATE_OUTCOMES.includes(outcome))
+        return null;
+    const result = { at, version, outcome: outcome };
+    if (typeof error === 'string')
+        result.error = error;
+    return result;
+}
+function parseDraining(value) {
+    if (!isRecord(value))
+        return null;
+    if (typeof value.since !== 'string' || typeof value.target !== 'string')
+        return null;
+    return { since: value.since, target: value.target };
+}
+/** Tolerant reader: a missing or invalid file is `null`; never throws. */
+export function readUpdateState(file) {
+    try {
+        if (!existsSync(file))
+            return null;
+        const raw = JSON.parse(readFileSync(file, 'utf-8'));
+        if (!isRecord(raw))
+            return null;
+        if (!UPDATE_MODES.includes(raw.mode))
+            return null;
+        if (typeof raw.current !== 'string' || raw.current === '')
+            return null;
+        return {
+            schemaVersion: 1,
+            mode: raw.mode,
+            channel: raw.channel === 'latest' || raw.channel === 'next' ? raw.channel : null,
+            installKind: INSTALL_KINDS.includes(raw.installKind)
+                ? raw.installKind
+                : 'unknown',
+            current: raw.current,
+            available: stringOrNull(raw.available),
+            lastCheckAt: stringOrNull(raw.lastCheckAt),
+            lastResult: parseLastResult(raw.lastResult),
+            draining: parseDraining(raw.draining),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Atomic write (tmp + rename) so a concurrent `factory status` never reads a torn file. */
+export function writeUpdateState(file, state) {
+    mkdirSync(dirname(file), { recursive: true });
+    const tmp = `${file}.tmp`;
+    writeFileSync(tmp, `${JSON.stringify(state, null, 2)}\n`);
+    renameSync(tmp, file);
+}
+export function initialUpdateState(config, previous) {
+    const { mode, channel } = config.autoUpdate;
+    const current = config.install.version;
+    const carried = previous?.available ?? null;
+    return {
+        schemaVersion: 1,
+        mode,
+        channel,
+        installKind: config.install.kind,
+        current,
+        available: mode === 'manual' || carried === current ? null : carried,
+        lastCheckAt: previous?.lastCheckAt ?? null,
+        lastResult: previous?.lastResult ?? null,
+        draining: null,
+    };
+}
+export function buildStatusUpdateJson(state) {
+    if (!state)
+        return null;
+    const { schemaVersion: _schemaVersion, ...update } = state;
+    return { ...update, available: state.mode === 'manual' ? null : state.available };
+}
+function installLabel(kind) {
+    switch (kind) {
+        case 'npm-global':
+            return 'npm';
+        case 'source':
+            return 'source';
+        case 'unknown':
+            return 'unknown install';
+    }
+}
+function outcomeLabel(outcome) {
+    switch (outcome) {
+        case 'updated':
+            return 'updated';
+        case 'rolled-back':
+            return 'rolled back';
+        case 'failed':
+            return 'failed';
+        case 'skipped':
+            return 'skipped';
+    }
+}
+/** The one human line `factory status` prints for the update state. */
+export function formatUpdateStatusLine(update) {
+    if (!update)
+        return 'factory update: no factoryd update state (daemon not started?)';
+    let line = `factory ${update.current} (${update.mode}, ${installLabel(update.installKind)})`;
+    if (update.mode === 'manual')
+        line += ' — automatic updates off';
+    else if (update.available !== null && update.available !== update.current)
+        line += ` — ${update.available} available`;
+    else
+        line += ' — up to date';
+    if (update.lastResult) {
+        const { version, outcome, error } = update.lastResult;
+        line += `; last update to ${version} ${outcomeLabel(outcome)}`;
+        if (error)
+            line += ` (${error})`;
+    }
+    if (update.draining)
+        line += `; draining for ${update.draining.target} since ${update.draining.since}`;
+    return line;
+}
+export function formatUpdateStartupLine(state) {
+    return `update: factory ${state.current}, mode ${state.mode} (channel ${state.channel ?? 'none'}, install ${state.installKind})`;
+}
+export function formatUpdateCheckLine(state) {
+    const found = state.available && state.available !== state.current ? `${state.available} available` : 'up to date';
+    return `update check: ${found} on ${state.channel ?? 'none'} (current ${state.current})`;
+}
+/** Records one check result and logs it once. Seam for the later update checker; no production caller yet. */
+export function recordUpdateCheck(file, check, log) {
+    const state = readUpdateState(file);
+    if (!state)
+        return null;
+    const next = { ...state, lastCheckAt: check.at, available: check.available };
+    writeUpdateState(file, next);
+    log(formatUpdateCheckLine(next));
+    return next;
+}
+//# sourceMappingURL=update-state.js.map

package/dist/cli/update-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-state.js","sourceRoot":"","sources":["../../src/cli/update-state.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,20 @@
+import type { SubscriptionUsage } from '@on-par/factory-core';
+/** 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;
+}
+/** 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;
+//# sourceMappingURL=usage-json.d.ts.map

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

@@ -0,0 +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"}

package/dist/cli/usage-json.js

@@ -0,0 +1,36 @@
+import { TRAILING_WINDOW_MS } from '@on-par/factory-core/internal';
+/** Hours in the trailing usage window `factory usage` reports on. */
+export const USAGE_WINDOW_HOURS = TRAILING_WINDOW_MS / 3_600_000;
+/** 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 function buildUsageJson(subscription, estimateUsd, cap) {
+    if (subscription !== null) {
+        return {
+            schemaVersion: 1,
+            source: 'subscription',
+            utilizationPct: subscription.fiveHourUtilization,
+            resetsAt: subscription.fiveHourResetsAt,
+            windowHours: USAGE_WINDOW_HOURS,
+            estimateUsd,
+        };
+    }
+    if (estimateUsd !== null) {
+        return {
+            schemaVersion: 1,
+            source: 'heuristic',
+            utilizationPct: (estimateUsd / cap) * 100,
+            resetsAt: null,
+            windowHours: USAGE_WINDOW_HOURS,
+            estimateUsd,
+        };
+    }
+    return {
+        schemaVersion: 1,
+        source: 'unavailable',
+        utilizationPct: null,
+        resetsAt: null,
+        windowHours: USAGE_WINDOW_HOURS,
+        estimateUsd: null,
+    };
+}
+//# sourceMappingURL=usage-json.js.map

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

@@ -0,0 +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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+// packages/cli/src/cli.ts — CLI entry point
+import { main } from './cli/index.js';
+import { runEntry } from './entry.js';
+void runEntry(main);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,4CAA4C;AAE5C,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC"}

package/dist/entry.d.ts

@@ -0,0 +1,6 @@
+export interface EntryIo {
+    error(msg: string): void;
+    exit(code: number): void;
+}
+export declare function runEntry(main: () => Promise<void>, io?: EntryIo): Promise<void>;
+//# sourceMappingURL=entry.d.ts.map

package/dist/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAKD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,GAAE,OAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhG"}

package/dist/entry.js

@@ -0,0 +1,13 @@
+// packages/cli/src/entry.ts — bin-entry runner: awaits main and exits 1 on rejection (#2031).
+// References, not wrappers: Node's console methods are bound and process.exit ignores `this`.
+const defaultIo = { error: console.error, exit: process.exit };
+export async function runEntry(main, io = defaultIo) {
+    try {
+        await main();
+    }
+    catch (err) {
+        io.error(err.message);
+        io.exit(1);
+    }
+}
+//# sourceMappingURL=entry.js.map

package/dist/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAO9F,8FAA8F;AAC9F,MAAM,SAAS,GAAY,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;AAExE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAyB,EAAE,EAAE,GAAY,SAAS;IAC/E,IAAI,CAAC;QACH,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;QACjC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACb,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@on-par/factory-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.9.1",
+  "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",
+    "github",
+    "cli",
+    "claude-code",
+    "pull-requests",
+    "automation"
+  ],
+  "type": "module",
+  "main": "dist/cli.js",
+  "bin": {
+    "factory": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "!dist/.tsbuildinfo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/on-par/software-factory.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/on-par/software-factory#readme",
+  "bugs": {
+    "url": "https://github.com/on-par/software-factory/issues"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build",
+    "prepack": "node ../../scripts/pack-hygiene-cli.ts prepack"
+  },
+  "dependencies": {
+    "@octokit/plugin-retry": "^8.1.1",
+    "@octokit/plugin-throttling": "^11.0.5",
+    "@octokit/rest": "^22.0.0",
+    "@on-par/factory-core": "0.9.1",
+    "@on-par/factory-tui": "0.9.1",
+    "commander": "^15.0.0"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^26.6.4"
+  }
+}