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

package/dist/cli/feedback.js

@@ -0,0 +1,180 @@
+// packages/cli/src/cli/feedback.ts — `factory feedback <pr-url>`: file a human review's findings as one factory issue (#1851).
+// Each review body is sanitized on its own (stripHiddenContent) before it reaches the title or body (#1852).
+import { createHash } from 'node:crypto';
+import { hostname } from 'node:os';
+import { join } from 'node:path';
+import { readEvents } from '@on-par/factory-core';
+import { DEFAULT_BUG_LABELS, factoryBranchIssue, fileBug, stripHiddenContent } from '@on-par/factory-core/internal';
+export const FEEDBACK_TRIAGE_LABEL = 'factory:needs-triage';
+export const FEEDBACK_LABELS = [...DEFAULT_BUG_LABELS, FEEDBACK_TRIAGE_LABEL];
+const PR_URL_RE = /^https?:\/\/github\.com\/([^/\s]+)\/([^/\s]+)\/pull\/(\d+)(?:[/?#].*)?$/;
+export function parseFeedbackPrUrl(raw) {
+    const m = PR_URL_RE.exec(raw.trim());
+    if (!m)
+        throw new Error(`factory feedback: "${raw}" is not a GitHub pull request URL`);
+    const [, owner, repo, num] = m;
+    const number = Number(num);
+    return { owner, repo, number, url: `https://github.com/${owner}/${repo}/pull/${number}` };
+}
+export async function collectReviewFindings(client, pr) {
+    const [reviews, comments] = await Promise.all([client.listReviews(pr), client.listReviewComments(pr)]);
+    const findings = [];
+    for (const r of reviews) {
+        const body = stripHiddenContent(r.body ?? '').trim();
+        if (!body)
+            continue;
+        findings.push({
+            author: stripHiddenContent(r.user),
+            kind: 'review',
+            body,
+            at: r.submittedAt,
+            state: r.state,
+            url: r.url,
+        });
+    }
+    for (const c of comments) {
+        const body = stripHiddenContent(c.body ?? '').trim();
+        if (!body)
+            continue;
+        findings.push({
+            author: stripHiddenContent(c.user),
+            kind: 'comment',
+            body,
+            at: c.createdAt,
+            path: c.path === undefined ? undefined : stripHiddenContent(c.path),
+            line: c.line,
+            url: c.url,
+        });
+    }
+    return findings.sort((a, b) => (a.at < b.at ? -1 : a.at > b.at ? 1 : 0));
+}
+const TITLE_MAX = 80;
+export function buildFeedbackTitle(findings, note) {
+    const trimmedNote = note?.trim();
+    if (trimmedNote)
+        return `[feedback] ${trimmedNote}`;
+    const first = findings[0];
+    if (!first)
+        throw new Error('factory feedback: the PR has no review findings; pass --note to describe the problem');
+    const rawLine = first.body.split('\n').find((l) => l.trim()) ?? '';
+    const line = rawLine.replace(/\s+/g, ' ').trim();
+    const cut = line.length > TITLE_MAX ? `${line.slice(0, TITLE_MAX)}…` : line;
+    return `[feedback] ${cut}`;
+}
+function renderFindings(findings) {
+    return findings
+        .map((f) => {
+        const where = f.kind === 'review' ? (f.state ?? 'review') : `${f.path ?? 'unknown'}${f.line ? `:${f.line}` : ''}`;
+        return `### ${f.author} — ${where} (${f.at})\n${f.body}\n`;
+    })
+        .join('\n');
+}
+function runWindow(events, issue, slug) {
+    const mine = events.filter((e) => e.issue === String(issue) && (e.repo === undefined || e.repo === slug));
+    if (mine.length === 0)
+        return { count: 0 };
+    const stamps = mine.map((e) => e.ts).sort();
+    return { first: stamps[0], last: stamps[stamps.length - 1], count: mine.length };
+}
+export async function runFeedback(prUrl, opts, deps) {
+    const pr = parseFeedbackPrUrl(prUrl);
+    const pull = await deps.github.getPull(pr);
+    const findings = await collectReviewFindings(deps.github, pr);
+    const title = buildFeedbackTitle(findings, opts.note);
+    const issue = factoryBranchIssue(pull.headRef, deps.branchPrefix);
+    const window = issue === null ? undefined : runWindow(readEvents(deps.paths.events), issue, `${pr.owner}/${pr.repo}`);
+    const designPath = issue === null ? undefined : join(deps.paths.plans, `issue-${issue}.md`);
+    const logPath = issue === null ? deps.paths.logs : join(deps.paths.logs, String(issue));
+    const host = deps.host ?? hostname();
+    const lines = [
+        `Human review of ${pr.url} found factory defects the run did not catch.`,
+        '',
+        `- PR: ${pr.url} (${pull.title})`,
+        `- Factory issue: ${issue === null ? `not a factory branch (${pull.headRef})` : `#${issue}`}`,
+        `- Run events: ${window?.count
+            ? `${window.count} between ${window.first} and ${window.last}`
+            : `none found in ${deps.paths.events}`}`,
+        `- Design artifact: ${designPath ? `${host}:${designPath}` : 'unknown'}`,
+        `- Findings: ${findings.length}`,
+    ];
+    const note = opts.note?.trim();
+    if (note)
+        lines.push(`- Note: ${note}`);
+    const fingerprint = `fb_${createHash('sha256')
+        .update(`${pr.url}|${deps.now().toISOString()}`)
+        .digest('hex')
+        .slice(0, 16)}`;
+    const fingerprinted = {
+        fingerprint,
+        evidence: {
+            repo: `${pr.owner}/${pr.repo}`,
+            issue: issue === null ? pr.url : String(issue),
+            phase: 'check',
+            model: 'human-review',
+            reason: 'unknown',
+            component: 'human-review',
+            origin: 'factory-internal',
+            eventExcerpt: renderFindings(findings) || '(no review findings; see note)',
+            logPath,
+        },
+    };
+    return fileBug(deps.filing, {
+        fingerprinted,
+        now: deps.now,
+        labels: FEEDBACK_LABELS,
+        title,
+        problem: lines.join('\n'),
+        host: deps.host,
+        internalRepo: deps.internalRepo,
+    });
+}
+export function createOctokitFeedbackClient(octokit) {
+    return {
+        async getPull({ owner, repo, number }) {
+            const { data } = await octokit.rest.pulls.get({ owner, repo, pull_number: number });
+            return { headRef: data.head.ref, title: data.title, url: data.html_url };
+        },
+        async listReviews({ owner, repo, number }) {
+            const data = await octokit.paginate(octokit.rest.pulls.listReviews, {
+                owner,
+                repo,
+                pull_number: number,
+                per_page: 100,
+            });
+            return data.map((r) => ({
+                user: r.user?.login ?? 'unknown',
+                state: r.state,
+                body: r.body ?? '',
+                submittedAt: r.submitted_at ?? '',
+                url: r.html_url,
+            }));
+        },
+        async listReviewComments({ owner, repo, number }) {
+            const data = await octokit.paginate(octokit.rest.pulls.listReviewComments, {
+                owner,
+                repo,
+                pull_number: number,
+                per_page: 100,
+            });
+            return data.map((c) => ({
+                user: c.user?.login ?? 'unknown',
+                body: c.body ?? '',
+                path: c.path,
+                line: c.line ?? c.original_line ?? undefined,
+                createdAt: c.created_at,
+                url: c.html_url,
+            }));
+        },
+    };
+}
+/** Wire the real GitHub clients and run-state paths into FeedbackDeps. */
+export function buildFeedbackDeps(octokit, paths, branchPrefix, createFilingClient) {
+    return {
+        github: createOctokitFeedbackClient(octokit),
+        filing: createFilingClient(octokit),
+        paths: { events: paths.events, plans: paths.plans, logs: paths.logs },
+        branchPrefix,
+        now: () => new Date(),
+    };
+}
+//# sourceMappingURL=feedback.js.map

package/dist/cli/feedback.js.map

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

package/dist/cli/filing.d.ts

@@ -0,0 +1,22 @@
+export interface FilingPreviewDeps {
+    out: {
+        write(s: string): unknown;
+    };
+    err: {
+        write(s: string): unknown;
+    };
+    eventsFile: string;
+    runsDir: string;
+    factoryVersion: string;
+    factoryCommit: () => Promise<string | null>;
+    os: string;
+    nodeVersion: string;
+    usernames: string[];
+    hostnames: string[];
+    branchPrefix?: string;
+}
+/** Print the exact title and body an upstream report would carry. Returns false when no evidence matches. */
+export declare function runFilingPreview(runId: string, deps: FilingPreviewDeps): Promise<boolean>;
+/** Sha of the factory checkout `cwd` sits in; null when installed or not a factory checkout (never the target repo's). */
+export declare function resolveFactoryCheckoutCommit(cwd: string, run: (cmd: string, cwd: string) => Promise<string>): Promise<string | null>;
+//# sourceMappingURL=filing.d.ts.map

package/dist/cli/filing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filing.d.ts","sourceRoot":"","sources":["../../src/cli/filing.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE;QAAE,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACnC,GAAG,EAAE;QAAE,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAQD,6GAA6G;AAC7G,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAiC/F;AAED,0HAA0H;AAC1H,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACjD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASxB"}

package/dist/cli/filing.js

@@ -0,0 +1,53 @@
+// packages/cli/src/cli/filing.ts — `factory filing preview <run-id>`: print the redacted upstream report, send nothing (#1858).
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { readEvents } from '@on-par/factory-core';
+import { buildUpstreamReport, daemonRunFile, isValidRunId, readDaemonRun, upstreamInputFromEvidence, } from '@on-par/factory-core/internal';
+function hasEvidence(e) {
+    return typeof e.fingerprint === 'string' && e.evidence !== undefined;
+}
+/** Print the exact title and body an upstream report would carry. Returns false when no evidence matches. */
+export async function runFilingPreview(runId, deps) {
+    const events = readEvents(deps.eventsFile).filter(hasEvidence);
+    const record = isValidRunId(runId) ? await readDaemonRun(daemonRunFile(deps.runsDir, runId)) : null;
+    const matches = record
+        ? events.filter((e) => e.issue === String(record.issue) && (!e.repo || e.repo === record.repo))
+        : events.filter((e) => e.fingerprint === runId);
+    const match = matches[matches.length - 1];
+    if (!match) {
+        deps.err.write(`No failure evidence found for run ${runId}.\n`);
+        return false;
+    }
+    const repoSlugs = [record?.repo, match.repo].filter((s) => !!s);
+    const owners = repoSlugs.map((s) => s.split('/')[0]).filter((s) => !!s);
+    const input = upstreamInputFromEvidence({ fingerprint: match.fingerprint, evidence: match.evidence }, {
+        factoryVersion: deps.factoryVersion,
+        factoryCommit: await deps.factoryCommit(),
+        os: deps.os,
+        nodeVersion: deps.nodeVersion,
+        redaction: {
+            repoSlugs,
+            usernames: [...deps.usernames, ...owners],
+            hostnames: deps.hostnames,
+            branchPrefix: deps.branchPrefix,
+        },
+    });
+    const { title, body } = buildUpstreamReport(input);
+    deps.out.write(`${title}\n\n${body.replace(/\n+$/, '')}\n`);
+    deps.err.write('Preview only — nothing was sent.\n');
+    return true;
+}
+/** Sha of the factory checkout `cwd` sits in; null when installed or not a factory checkout (never the target repo's). */
+export async function resolveFactoryCheckoutCommit(cwd, run) {
+    try {
+        const top = (await run('git rev-parse --show-toplevel', cwd)).trim();
+        const pkg = JSON.parse(readFileSync(resolve(top, 'packages/cli/package.json'), 'utf8'));
+        if (pkg.name !== '@on-par/factory-cli')
+            return null;
+        return (await run('git rev-parse HEAD', cwd)).trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=filing.js.map

package/dist/cli/filing.js.map

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

package/dist/cli/first-run.d.ts

@@ -0,0 +1,9 @@
+export declare const DOCS_URL = "https://github.com/on-par/software-factory#readme";
+export declare const CLAUDE_CODE_URL = "https://docs.anthropic.com/en/docs/claude-code";
+export declare const GITHUB_TOKENS_URL = "https://github.com/settings/tokens";
+/** Printed by bare `factory` (no subcommand). */
+export declare function formatOverview(): string;
+export declare function missingClaudeCliMessage(): string;
+export declare function missingTokenMessage(): string;
+export declare function notInitializedMessage(): string;
+//# sourceMappingURL=first-run.d.ts.map

package/dist/cli/first-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-run.d.ts","sourceRoot":"","sources":["../../src/cli/first-run.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,sDAAsD,CAAC;AAC5E,eAAO,MAAM,eAAe,mDAAmD,CAAC;AAChF,eAAO,MAAM,iBAAiB,uCAAuC,CAAC;AAEtE,iDAAiD;AACjD,wBAAgB,cAAc,IAAI,MAAM,CAkBvC;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/cli/first-run.js

@@ -0,0 +1,34 @@
+// packages/cli/src/cli/first-run.ts — designed first-run copy: overview + structured error messages
+export const DOCS_URL = 'https://github.com/on-par/software-factory#readme';
+export const CLAUDE_CODE_URL = 'https://docs.anthropic.com/en/docs/claude-code';
+export const GITHUB_TOKENS_URL = 'https://github.com/settings/tokens';
+/** Printed by bare `factory` (no subcommand). */
+export function formatOverview() {
+    return `factory — ship verified GitHub issues autonomously
+
+The software factory takes issues from your backlog through a
+plan → build → check → ship pipeline using a boss-worker-checker
+pattern, and opens a pull request for each one.
+
+Common commands:
+  factory init                     Initialize .factory/ in this repo
+  factory ship <issue>             Plan → build → check one issue and open a PR
+  factory queue add <lane> <N...>  Queue issues into a lane (GitHub labels)
+  factory run                      Ship queued issues, lanes in parallel
+  factory status                   Show active runs and the queue
+
+Check your setup:       factory doctor
+All commands:           factory --help
+Docs:                   ${DOCS_URL}
+`;
+}
+export function missingClaudeCliMessage() {
+    return `claude CLI not found — install Claude Code first: ${CLAUDE_CODE_URL}`;
+}
+export function missingTokenMessage() {
+    return `GITHUB_TOKEN not set — create a token at ${GITHUB_TOKENS_URL} and export it (or run \`gh auth login\`)`;
+}
+export function notInitializedMessage() {
+    return 'factory not initialized — run `factory init` first';
+}
+//# sourceMappingURL=first-run.js.map

package/dist/cli/first-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-run.js","sourceRoot":"","sources":["../../src/cli/first-run.ts"],"names":[],"mappings":"AAAA,oGAAoG;AAEpG,MAAM,CAAC,MAAM,QAAQ,GAAG,mDAAmD,CAAC;AAC5E,MAAM,CAAC,MAAM,eAAe,GAAG,gDAAgD,CAAC;AAChF,MAAM,CAAC,MAAM,iBAAiB,GAAG,oCAAoC,CAAC;AAEtE,iDAAiD;AACjD,MAAM,UAAU,cAAc;IAC5B,OAAO;;;;;;;;;;;;;;;0BAeiB,QAAQ;CACjC,CAAC;AACF,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,qDAAqD,eAAe,EAAE,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,4CAA4C,iBAAiB,2CAA2C,CAAC;AAClH,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,oDAAoD,CAAC;AAC9D,CAAC"}

package/dist/cli/help-groups.d.ts

@@ -0,0 +1,17 @@
+import type { Command } from 'commander';
+export interface HelpGroup {
+    heading: string;
+    /** Top-level command names, in the order they should appear under the heading. */
+    commands: readonly string[];
+    /** Put Commander's implicit `help [command]` entry under this heading. */
+    includesHelp?: boolean;
+}
+/** Heading for any registered command missing from the table, so a new command still shows up. */
+export declare const OTHER_GROUP = "Other:";
+/** The shipped `factory --help` layout: everyday commands first, experimental ones last. */
+export declare const HELP_GROUPS: readonly HelpGroup[];
+/** Assign each top-level command its help heading and reorder `program.commands` to match
+ *  the table. Commander renders groups in order of first appearance, so the reorder is what
+ *  puts "Run work:" first. Only help layout changes — command parsing ignores the order. */
+export declare function applyHelpGroups(program: Command, groups?: readonly HelpGroup[]): void;
+//# sourceMappingURL=help-groups.d.ts.map

package/dist/cli/help-groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-groups.d.ts","sourceRoot":"","sources":["../../src/cli/help-groups.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,0EAA0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,kGAAkG;AAClG,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC,4FAA4F;AAC5F,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAgB3C,CAAC;AAEF;;4FAE4F;AAC5F,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,GAAE,SAAS,SAAS,EAAgB,GAAG,IAAI,CAwBlG"}

package/dist/cli/help-groups.js

@@ -0,0 +1,50 @@
+// packages/cli/src/cli/help-groups.ts — section headings and order for `factory --help`
+/** Heading for any registered command missing from the table, so a new command still shows up. */
+export const OTHER_GROUP = 'Other:';
+/** The shipped `factory --help` layout: everyday commands first, experimental ones last. */
+export const HELP_GROUPS = [
+    {
+        heading: 'Run work:',
+        commands: ['ship', 'run-issue', 'run-brief', 'run', 'supervise', 'land', 'resume-approved', 'stop', 'resume'],
+    },
+    {
+        heading: 'Setup:',
+        commands: ['init', 'doctor', 'constitution', 'models', 'migrate'],
+        includesHelp: true,
+    },
+    { heading: 'Queue:', commands: ['queue', 'unpark', 'triage', 'check', 'feedback', 'filing'] },
+    { heading: 'Observe:', commands: ['status', 'runs', 'logs', 'tui', 'cost', 'usage', 'kpis', 'classifier', 'garden'] },
+    {
+        heading: 'Advanced / experimental:',
+        commands: ['worktree', 'reset', 'daemon', 'proxy', 'hosted', 'local-small-dry-run', 'local-small-overnight'],
+    },
+];
+/** Assign each top-level command its help heading and reorder `program.commands` to match
+ *  the table. Commander renders groups in order of first appearance, so the reorder is what
+ *  puts "Run work:" first. Only help layout changes — command parsing ignores the order. */
+export function applyHelpGroups(program, groups = HELP_GROUPS) {
+    const byName = new Map(program.commands.map((cmd) => [cmd.name(), cmd]));
+    const ordered = [];
+    for (const group of groups) {
+        for (const name of group.commands) {
+            const cmd = byName.get(name);
+            if (!cmd)
+                continue;
+            cmd.helpGroup(group.heading);
+            ordered.push(cmd);
+            byName.delete(name);
+        }
+    }
+    for (const cmd of byName.values()) {
+        cmd.helpGroup(OTHER_GROUP);
+        ordered.push(cmd);
+    }
+    // Commander types `commands` as readonly but keeps a plain array; reorder it in place.
+    program.commands.splice(0, program.commands.length, ...ordered);
+    const helpGroup = groups.find((g) => g.includesHelp);
+    if (helpGroup) {
+        program.commandsGroup(helpGroup.heading);
+        program.helpCommand(true);
+    }
+}
+//# sourceMappingURL=help-groups.js.map

package/dist/cli/help-groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-groups.js","sourceRoot":"","sources":["../../src/cli/help-groups.ts"],"names":[],"mappings":"AAAA,wFAAwF;AAYxF,kGAAkG;AAClG,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;AAEpC,4FAA4F;AAC5F,MAAM,CAAC,MAAM,WAAW,GAAyB;IAC/C;QACE,OAAO,EAAE,WAAW;QACpB,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,CAAC;KAC9G;IACD;QACE,OAAO,EAAE,QAAQ;QACjB,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,CAAC;QACjE,YAAY,EAAE,IAAI;KACnB;IACD,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE;IAC7F,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE;IACrH;QACE,OAAO,EAAE,0BAA0B;QACnC,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,uBAAuB,CAAC;KAC7G;CACF,CAAC;AAEF;;4FAE4F;AAC5F,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,MAAM,GAAyB,WAAW;IAC1F,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,OAAO,GAAc,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IACD,uFAAuF;IACtF,OAAO,CAAC,QAAsB,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC;IAE/E,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACrD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACzC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/cli/hosted-queue.d.ts

@@ -0,0 +1,45 @@
+import type { HostedJobClient, QueueAndTailOutcome } from '@on-par/factory-core';
+export interface HostedQueueCliOptions {
+    /** default 'http://127.0.0.1:8799' */
+    url?: string;
+    /** default 'on-par/software-factory' */
+    repo?: string;
+    /** opaque task payload; default 'hosted-exec: queue and tail one job (#926)' */
+    task?: string;
+    /** comma-separated; default 'git,node' */
+    capabilities?: string;
+    /** default 'repo:read' */
+    authority?: string;
+    /** bounded wait window in ms; default 120000 */
+    timeout?: string;
+    /** delay between summary polls in ms; default 1000 */
+    pollInterval?: string;
+    /** explicit job id (default server-generated) */
+    jobId?: string;
+}
+export interface HostedQueueCliDeps {
+    out?: {
+        write(s: string): unknown;
+    };
+    env?: NodeJS.ProcessEnv;
+    /** default createHttpHostedJobClient({ baseUrl: opts.url }) */
+    client?: HostedJobClient;
+    /** default () => Date.now() */
+    now?: () => number;
+    /** default a real setTimeout-backed delay */
+    sleep?: (ms: number) => Promise<void>;
+}
+/** Renders only QueueAndTailOutcome fields sourced from HostedJobSummary — no
+ * secret material ever flows through this path (logsTail is redacted by the
+ * runner, and requiredAuthority/credential handles are never included). */
+export declare function formatQueueAndTailOutcome(outcome: QueueAndTailOutcome): string;
+/** Testable core of the command: gate on the flag, queue one job and tail it
+ * to a terminal status within the bounded wait window, print the event
+ * progression plus the final result. Exit code is 0 only when the terminal
+ * status is 'done' — failed, canceled, and a non-terminal timeout all exit 1. */
+export declare function runHostedQueueCli(opts: HostedQueueCliOptions, deps?: HostedQueueCliDeps): Promise<{
+    exitCode: number;
+}>;
+/** Command entry point wired up to commander. */
+export declare function cmdHostedQueue(opts: HostedQueueCliOptions): Promise<void>;
+//# sourceMappingURL=hosted-queue.d.ts.map

package/dist/cli/hosted-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-queue.d.ts","sourceRoot":"","sources":["../../src/cli/hosted-queue.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAKjF,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE;QAAE,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAQD;;2EAE2E;AAC3E,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAqB9E;AAED;;;iFAGiF;AACjF,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,qBAAqB,EAC3B,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA6B/B;AAED,iDAAiD;AACjD,wBAAsB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/E"}

package/dist/cli/hosted-queue.js

@@ -0,0 +1,74 @@
+// packages/cli/src/cli/hosted-queue.ts — `factory hosted queue` [--url <base>]
+// [--repo <slug>] [--task <text>] [--capabilities <csv>] [--authority <authority>]
+// [--timeout <ms>] [--poll-interval <ms>] [--job-id <id>]
+//
+// Queue/tail slice (#926): queues one job to the local hosted-exec control
+// plane, tails its events and summary until it reaches a terminal state, and
+// prints the event progression plus the final secret-redacted result. Exits
+// non-zero for failed/canceled jobs and for a non-terminal timeout. Gated by
+// FACTORY_HOSTED_EXEC=1, same as the rest of hosted-exec.
+import { createHttpHostedJobClient, hostedExecEnabled, queueAndTailJob } from '@on-par/factory-core';
+import { applyExitCode } from './hosted.js';
+function parsePositiveInt(value, fallback) {
+    if (!value)
+        return fallback;
+    const parsed = Number.parseInt(value, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+/** Renders only QueueAndTailOutcome fields sourced from HostedJobSummary — no
+ * secret material ever flows through this path (logsTail is redacted by the
+ * runner, and requiredAuthority/credential handles are never included). */
+export function formatQueueAndTailOutcome(outcome) {
+    const eventLines = outcome.events.map((e) => `event:    [${e.severity}] ${e.type} @ ${e.ts} — ${e.message}`);
+    const summary = outcome.summary;
+    const summaryLines = [
+        `job:      ${summary.jobId}`,
+        `repo:     ${summary.repoSlug}`,
+        `status:   ${summary.status}`,
+        `outcome:  ${summary.outcome ?? '(none)'}`,
+        `exit:     ${summary.exitCode ?? '(none)'}`,
+        `failure:  ${summary.failurePhase ?? '(none)'}`,
+        `logs:     ${summary.logsTail ?? '(none)'}`,
+        `artifacts: ${summary.artifactCount === 0
+            ? '(none)'
+            : summary.artifacts.map((a) => `${a.name} (${a.kind}): ${a.ref}`).join(', ')}`,
+        `cleanup:  ${summary.cleanupProof ?? '(none)'}`,
+    ];
+    return [...eventLines, ...summaryLines].join('\n') + '\n';
+}
+/** Testable core of the command: gate on the flag, queue one job and tail it
+ * to a terminal status within the bounded wait window, print the event
+ * progression plus the final result. Exit code is 0 only when the terminal
+ * status is 'done' — failed, canceled, and a non-terminal timeout all exit 1. */
+export async function runHostedQueueCli(opts, deps = {}) {
+    const env = deps.env ?? process.env;
+    const out = deps.out ?? process.stdout;
+    if (!hostedExecEnabled(env)) {
+        out.write('hosted-exec queue refused: set FACTORY_HOSTED_EXEC=1 to enable — the local factory path is unchanged\n');
+        return { exitCode: 0 };
+    }
+    const client = deps.client ?? createHttpHostedJobClient({ baseUrl: opts.url ?? 'http://127.0.0.1:8799' });
+    const requiredCapabilities = (opts.capabilities ?? 'git,node')
+        .split(',')
+        .map((c) => c.trim())
+        .filter((c) => c.length > 0);
+    const outcome = await queueAndTailJob(client, {
+        repoSlug: opts.repo ?? 'on-par/software-factory',
+        taskPayload: opts.task ?? 'hosted-exec: queue and tail one job (#926)',
+        requiredCapabilities,
+        requiredAuthority: opts.authority ?? 'repo:read',
+        jobId: opts.jobId,
+        timeoutMs: parsePositiveInt(opts.timeout, 120_000),
+        pollIntervalMs: parsePositiveInt(opts.pollInterval, 1_000),
+        now: deps.now,
+        sleep: deps.sleep,
+    });
+    out.write(formatQueueAndTailOutcome(outcome));
+    return { exitCode: outcome.status === 'done' ? 0 : 1 };
+}
+/** Command entry point wired up to commander. */
+export async function cmdHostedQueue(opts) {
+    const { exitCode } = await runHostedQueueCli(opts);
+    applyExitCode(exitCode);
+}
+//# sourceMappingURL=hosted-queue.js.map

package/dist/cli/hosted-queue.js.map

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

package/dist/cli/hosted-runner.d.ts

@@ -0,0 +1,44 @@
+import type { HostedControlPlaneClient, OneJobRunnerOutcome } from '@on-par/factory-core';
+export interface HostedRunnerCliOptions {
+    /** default 'http://127.0.0.1:8799' */
+    url?: string;
+    /** default `runner-<pid>` */
+    runnerId?: string;
+    /** comma-separated; default 'git,node' */
+    capabilities?: string;
+    /** bounded wait window in ms; default 30000 */
+    timeout?: string;
+    /** delay between poll attempts in ms; default 2000 */
+    pollInterval?: string;
+    /** lease TTL in ms; default 300000 */
+    leaseTtl?: string;
+    /** expected heartbeat interval in ms; default 30000 */
+    heartbeatInterval?: string;
+}
+export interface HostedRunnerCliDeps {
+    out?: {
+        write(s: string): unknown;
+    };
+    env?: NodeJS.ProcessEnv;
+    /** default createHttpHostedControlPlaneClient({ baseUrl: opts.url }) */
+    client?: HostedControlPlaneClient;
+    /** default () => Date.now() */
+    now?: () => number;
+    /** default a real setTimeout-backed delay */
+    sleep?: (ms: number) => Promise<void>;
+    /** default randomUUID() */
+    generateLeaseId?: () => string;
+}
+/** Renders only OneJobRunnerOutcome fields — no secret material ever flows
+ * through this path (registration/lease payloads carry no credentials). */
+export declare function formatHostedRunnerOutcome(outcome: OneJobRunnerOutcome): string;
+/** Testable core of the command: gate on the flag, register + poll for one
+ * compatible job within the bounded wait window, print the result. Exits 0
+ * both when a job is leased and when the window elapses with no compatible
+ * work — the latter is a clean, expected outcome, not a failure. */
+export declare function runHostedRunnerCli(opts: HostedRunnerCliOptions, deps?: HostedRunnerCliDeps): Promise<{
+    exitCode: number;
+}>;
+/** Command entry point wired up to commander. */
+export declare function cmdHostedRunner(opts: HostedRunnerCliOptions): Promise<void>;
+//# sourceMappingURL=hosted-runner.d.ts.map

package/dist/cli/hosted-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-runner.d.ts","sourceRoot":"","sources":["../../src/cli/hosted-runner.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAK1F,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE;QAAE,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,wEAAwE;IACxE,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,2BAA2B;IAC3B,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC;CAChC;AAQD;2EAC2E;AAC3E,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAY9E;AAED;;;oEAGoE;AACpE,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,sBAAsB,EAC5B,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA+B/B;AAED,iDAAiD;AACjD,wBAAsB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjF"}