@codetreker/daynight 0.0.0-stage → 0.2.1

package/dist/cli.d.ts

@@ -0,0 +1,17 @@
+export { formatError } from "./diagnostics.js";
+import type { Configuration } from "./config.js";
+import type { RuntimePaths } from "./paths.js";
+import type { AddRepositoryInput, AddRepositoryOptions, AddRepositoryResult } from "./repositories.js";
+export type CliDependencies = {
+    version: string;
+    homeDirectory: () => string;
+    workingDirectory: () => string;
+    addRepository: (input: AddRepositoryInput, paths: RuntimePaths, options: AddRepositoryOptions) => Promise<AddRepositoryResult>;
+    listReviews: (paths: RuntimePaths) => Promise<string>;
+    loadConfiguration: (paths: RuntimePaths) => Promise<Configuration>;
+    runReview: (configuration: Configuration, paths: RuntimePaths) => Promise<void>;
+    stdout: (text: string) => void;
+    stderr: (text: string) => void;
+};
+export declare const runCli: (args: readonly string[], dependencies: CliDependencies) => Promise<number>;
+export declare const defaultCliDependencies: (version: string) => CliDependencies;

package/dist/cli.js

@@ -0,0 +1,164 @@
+import { homedir } from "node:os";
+import { formatError } from "./diagnostics.js";
+export { formatError } from "./diagnostics.js";
+import { loadConfiguration } from "./config.js";
+import { resolveRuntimePaths } from "./paths.js";
+import { addRepository } from "./repositories.js";
+import { listReviews } from "./review-list.js";
+import { formatCoordinatorEvent, runForegroundReview } from "./runtime.js";
+const help = `Usage: daynight --daemon-review
+       daynight add-repo <remote> [--path <path>]
+       daynight review list|ls
+
+Commands:
+  add-repo        Add a repository to configuration for the next review startup
+  review list|ls  List tracked ongoing PRs and recorded review status
+
+Options:
+  --daemon-review  Run foreground PR review until interrupted
+  -h, --help       Show this help
+  -v, --version    Show the installed version
+
+Configuration: ~/.daynight/config.yml (current user's home directory)
+Runtime state: ~/.daynight/
+`;
+const addRepositoryHelp = `Usage: daynight add-repo <remote> [--path <path>]
+
+Arguments:
+  <remote>        HTTPS or SSH GitHub repository address
+
+Options:
+  --path <path>   Dedicated review clone path (relative to the current directory)
+  -h, --help      Show this help
+
+Without --path, repositoryRoot (default: ~/daynights) determines the clone path.
+The resolved absolute path is saved in ~/.daynight/config.yml.
+Changes take effect the next time daynight --daemon-review starts.
+`;
+const reviewHelp = `Usage: daynight review list
+       daynight review ls
+
+Print a local persisted snapshot of configured repositories and tracked open PRs.
+Includes Draft PRs, saved review status, attempts, retry deadlines and errors.
+Last observed identifies the latest successful repository observation.
+Running is a recorded review state and does not establish process liveness.
+
+Options:
+  -h, --help      Show this help
+`;
+const parseCommand = (args) => {
+    if (args.length === 0)
+        throw new Error("Choose a command.");
+    if (args[0] === "review") {
+        const remaining = args.slice(1);
+        const isHelp = (value) => value === "--help" || value === "-h";
+        if (remaining.length === 1 && isHelp(remaining[0]))
+            return { kind: "help", text: reviewHelp };
+        if (remaining[0] === "list" || remaining[0] === "ls") {
+            if (remaining.length === 1)
+                return { kind: "review-list" };
+            if (remaining.length === 2 && isHelp(remaining[1]))
+                return { kind: "help", text: reviewHelp };
+        }
+        throw new Error("Expected daynight review list or daynight review ls.");
+    }
+    if (args[0] === "add-repo") {
+        const remaining = args.slice(1);
+        if (remaining.length === 1 && (remaining[0] === "--help" || remaining[0] === "-h")) {
+            return { kind: "help", text: addRepositoryHelp };
+        }
+        let remote;
+        let repositoryPath;
+        for (let index = 0; index < remaining.length; index++) {
+            const argument = remaining[index];
+            if (argument === "--path") {
+                if (repositoryPath !== undefined)
+                    throw new Error("Specify --path only once.");
+                const value = remaining[++index];
+                if (value === undefined || value === "" || value.startsWith("-")) {
+                    throw new Error("--path requires a path value.");
+                }
+                repositoryPath = value;
+            }
+            else if (argument.startsWith("-")) {
+                throw new Error(`Unknown add-repo option ${JSON.stringify(argument)}.`);
+            }
+            else {
+                if (remote !== undefined)
+                    throw new Error("add-repo accepts exactly one remote address.");
+                if (argument.trim() === "")
+                    throw new Error("add-repo requires a remote address.");
+                remote = argument;
+            }
+        }
+        if (remote === undefined)
+            throw new Error("add-repo requires a remote address.");
+        return { kind: "add-repo", input: repositoryPath === undefined ? { remote } : { remote, path: repositoryPath } };
+    }
+    if (args.length !== 1)
+        throw new Error("Expected a single command. Run daynight --help for supported commands.");
+    switch (args[0]) {
+        case "--help":
+        case "-h": return { kind: "help", text: help };
+        case "--version":
+        case "-v": return { kind: "version" };
+        case "--daemon-review": return { kind: "review" };
+        default: throw new Error(`Unknown argument ${JSON.stringify(args[0])}; review mode uses --daemon-review.`);
+    }
+};
+export const runCli = async (args, dependencies) => {
+    const { stdout, stderr } = dependencies;
+    let command;
+    try {
+        command = parseCommand(args);
+    }
+    catch (error) {
+        stderr(`${formatError(error)} Run daynight --help for usage.\n`);
+        return 2;
+    }
+    if (command.kind === "help") {
+        stdout(command.text);
+        return 0;
+    }
+    if (command.kind === "version") {
+        stdout(`${dependencies.version}\n`);
+        return 0;
+    }
+    try {
+        const homeDirectory = dependencies.homeDirectory();
+        const runtimePaths = resolveRuntimePaths(homeDirectory);
+        if (command.kind === "review-list") {
+            stdout(await dependencies.listReviews(runtimePaths));
+            return 0;
+        }
+        if (command.kind === "add-repo") {
+            const result = await dependencies.addRepository(command.input, runtimePaths, {
+                homeDirectory,
+                workingDirectory: dependencies.workingDirectory(),
+            });
+            stdout(`Repository ${result.repository.coordinate} ${result.added ? "added" : "is already configured"}.\nPath: ${result.repository.path}\nConfiguration: ${runtimePaths.configFile}\nConfiguration takes effect the next time daynight --daemon-review starts.\n`);
+            return 0;
+        }
+        const configuration = await dependencies.loadConfiguration(runtimePaths);
+        await dependencies.runReview(configuration, runtimePaths);
+        return 0;
+    }
+    catch (error) {
+        stderr(`${formatError(error)}\n`);
+        return 1;
+    }
+};
+export const defaultCliDependencies = (version) => ({
+    version,
+    homeDirectory: homedir,
+    workingDirectory: process.cwd,
+    addRepository,
+    listReviews,
+    loadConfiguration,
+    runReview: (configuration, paths) => runForegroundReview(configuration, paths, {
+        log: (event) => { process.stderr.write(`${formatCoordinatorEvent(event)}\n`); },
+    }),
+    stdout: (text) => { process.stdout.write(text); },
+    stderr: (text) => { process.stderr.write(text); },
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,32 @@
+import { parseDocument } from "yaml";
+import type { PathApi, RuntimePaths } from "./paths.js";
+export type RepositoryConfiguration = {
+    coordinate: string;
+    host: string;
+    owner: string;
+    name: string;
+    remote: string;
+    path: string;
+};
+export type Configuration = {
+    pollIntervalMs: number;
+    maxConcurrentWorker: number;
+    agentTimeoutMs: number;
+    maxAttempts: number;
+    retryDelayMs: number;
+    repositories: RepositoryConfiguration[];
+};
+export declare const defaultRepositoryRoot = "~/daynights";
+export declare const configurationDefaults: {
+    readonly pollIntervalMs: 60000;
+    readonly maxConcurrentWorker: 1;
+    readonly agentTimeoutMs: 1800000;
+    readonly maxAttempts: 3;
+    readonly retryDelayMs: 30000;
+};
+export declare const remoteIdentity: (remote: string, field: string) => Pick<RepositoryConfiguration, "coordinate" | "host" | "owner" | "name">;
+export declare const parseConfigurationDocument: (source: string, runtimePaths: RuntimePaths) => ReturnType<typeof parseDocument>;
+export declare const resolveRepositoryRoot: (configuredRoot: unknown, runtimePaths: RuntimePaths, homeDirectory: string, pathApi?: PathApi) => string;
+export declare const parseConfiguration: (source: string, runtimePaths: RuntimePaths, pathApi?: PathApi) => Configuration;
+export declare const loadConfiguration: (runtimePaths: RuntimePaths) => Promise<Configuration>;
+export declare const validateConfigurationSource: (source: string, runtimePaths: RuntimePaths) => Promise<Configuration>;

package/dist/config.js

@@ -0,0 +1,263 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { parseDocument } from "yaml";
+import { ancestorIdentities, missingPathsReferToSameDirectory, pathsEqual, pathsOverlap, resolvePhysicalDirectory } from "./paths.js";
+export const defaultRepositoryRoot = "~/daynights";
+export const configurationDefaults = {
+    pollIntervalMs: 60_000,
+    maxConcurrentWorker: 1,
+    agentTimeoutMs: 1_800_000,
+    maxAttempts: 3,
+    retryDelayMs: 30_000,
+};
+const asMapping = (value, field) => {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new Error(`${field} must be a mapping.`);
+    }
+    return value;
+};
+const validateKeys = (value, accepted, field) => {
+    for (const key of Object.keys(value)) {
+        if (!accepted.includes(key)) {
+            throw new Error(`${field} contains unsupported field ${JSON.stringify(key)}.`);
+        }
+    }
+};
+const nonEmptyString = (value, field) => {
+    if (typeof value !== "string" || value.trim() === "" || value.includes("\0")) {
+        throw new Error(`${field} must be a nonempty string without NUL characters.`);
+    }
+    return value;
+};
+const positiveInteger = (mapping, field) => {
+    if (!Object.hasOwn(mapping, field)) {
+        return configurationDefaults[field];
+    }
+    const value = mapping[field];
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0) {
+        throw new Error(`${field} must be a positive safe integer.`);
+    }
+    if (field.endsWith("Ms") && value > 2_147_483_647) {
+        throw new Error(`${field} must not exceed the supported timer limit of 2147483647 milliseconds.`);
+    }
+    return value;
+};
+export const remoteIdentity = (remote, field) => {
+    const invalidRemote = () => new Error(`${field} must be an HTTPS or SSH GitHub repository address with an owner and repository name; HTTPS credentials, query strings, and fragments are not allowed.`);
+    let host;
+    let coordinate;
+    const scp = /^git@([^\s/:]+):([^\s]+)$/.exec(remote);
+    if (scp !== null) {
+        host = scp[1];
+        coordinate = scp[2];
+        try {
+            const parsedHost = new URL(`ssh://git@${host}`);
+            if (parsedHost.hostname.toLowerCase() !== host.toLowerCase() || parsedHost.port !== "") {
+                throw invalidRemote();
+            }
+        }
+        catch (cause) {
+            throw new Error(`${field} has an invalid SSH host.`, { cause });
+        }
+    }
+    else {
+        if (!/^(?:https|ssh):\/\//i.test(remote)) {
+            throw invalidRemote();
+        }
+        let url;
+        try {
+            url = new URL(remote);
+        }
+        catch (cause) {
+            throw new Error(`${field} is not a supported GitHub repository address.`, { cause });
+        }
+        if (!["https:", "ssh:"].includes(url.protocol) ||
+            url.search !== "" ||
+            url.hash !== "" ||
+            url.password !== "" ||
+            (url.protocol === "https:" && url.username !== "") ||
+            (url.protocol === "ssh:" && url.username !== "git") ||
+            /\s/.test(remote)) {
+            throw invalidRemote();
+        }
+        host = url.protocol === "https:" ? url.host : url.hostname;
+        coordinate = url.pathname.slice(1);
+        if (!remote.endsWith(url.pathname)) {
+            throw invalidRemote();
+        }
+    }
+    try {
+        const normalizedHost = new URL(`https://${host}`);
+        if (normalizedHost.hostname === "" || normalizedHost.pathname !== "/" || normalizedHost.search !== "" || normalizedHost.hash !== "" || normalizedHost.username !== "" || normalizedHost.password !== "") {
+            throw invalidRemote();
+        }
+        host = normalizedHost.hostname.replace(/\.$/, "") +
+            (normalizedHost.port === "" ? "" : `:${normalizedHost.port}`);
+    }
+    catch (cause) {
+        throw new Error(`${field} has an invalid repository host.`, { cause });
+    }
+    coordinate = coordinate.replace(/\/$/, "").replace(/\.git$/, "");
+    const match = /^([a-z\d](?:[a-z\d-]{0,37}[a-z\d])?)\/([a-z\d_.-]+)$/i.exec(coordinate);
+    if (match === null || host === "" || match[2] === "." || match[2] === "..") {
+        throw invalidRemote();
+    }
+    const owner = match[1].toLowerCase();
+    const name = match[2].toLowerCase();
+    host = host.toLowerCase();
+    return { coordinate: `${host}/${owner}/${name}`, host, owner, name };
+};
+const validateRepositoryPaths = (repositories, repositoryPaths, stateDirectory, pathApi) => {
+    for (const [index, repositoryPath] of repositoryPaths.entries()) {
+        if (pathsOverlap(repositoryPath, stateDirectory, pathApi)) {
+            throw new Error(`repositories[${index}].path must not overlap the state directory ${stateDirectory}.`);
+        }
+        const duplicate = repositoryPaths
+            .slice(0, index)
+            .findIndex((previous) => pathsEqual(previous, repositoryPath, pathApi));
+        if (duplicate !== -1) {
+            throw new Error(`repositories[${index}].path resolves to the same location as repositories[${duplicate}].path (${repositories[duplicate].coordinate}).`);
+        }
+    }
+};
+export const parseConfigurationDocument = (source, runtimePaths) => {
+    const document = parseDocument(source, {
+        strict: true,
+        uniqueKeys: true,
+        stringKeys: true,
+        prettyErrors: false,
+    });
+    const problems = [...document.errors, ...document.warnings];
+    if (problems.length !== 0) {
+        throw new Error(`Invalid YAML in ${runtimePaths.configFile}.`, {
+            cause: new AggregateError(problems, "YAML configuration was rejected."),
+        });
+    }
+    return document;
+};
+export const resolveRepositoryRoot = (configuredRoot, runtimePaths, homeDirectory, pathApi = path) => {
+    const root = validateRepositoryRoot(configuredRoot, pathApi);
+    if (!pathApi.isAbsolute(homeDirectory)) {
+        throw new Error("The current user's home directory must be an absolute path.");
+    }
+    return root === "~" || root.startsWith("~/") || (pathApi.sep === "\\" && root.startsWith("~\\"))
+        ? pathApi.resolve(pathApi.join(homeDirectory, root.slice(2)))
+        : pathApi.resolve(pathApi.dirname(runtimePaths.configFile), root);
+};
+const validateRepositoryRoot = (value, pathApi) => {
+    const root = nonEmptyString(value, "repositoryRoot");
+    if (root.startsWith("~") && root !== "~" && !root.startsWith("~/") && !(pathApi.sep === "\\" && root.startsWith("~\\"))) {
+        throw new Error("repositoryRoot supports only the current user's home directory (~ or ~/), absolute paths, or config-directory-relative paths.");
+    }
+    if (pathApi.sep === "\\" && /^[a-z]:(?![\\/])/i.test(root)) {
+        throw new Error("repositoryRoot must not use a drive-relative Windows path.");
+    }
+    return root;
+};
+export const parseConfiguration = (source, runtimePaths, pathApi = path) => {
+    const document = parseConfigurationDocument(source, runtimePaths);
+    let parsed;
+    try {
+        parsed = document.toJS();
+    }
+    catch (cause) {
+        throw new Error(`Cannot decode YAML in ${runtimePaths.configFile}.`, { cause });
+    }
+    const mapping = asMapping(parsed, "Configuration");
+    validateKeys(mapping, [...Object.keys(configurationDefaults), "repositoryRoot", "repositories"], "Configuration");
+    if (Object.hasOwn(mapping, "repositoryRoot")) {
+        validateRepositoryRoot(mapping.repositoryRoot, pathApi);
+    }
+    if (!Array.isArray(mapping.repositories) || mapping.repositories.length === 0) {
+        throw new Error("repositories must be a nonempty sequence.");
+    }
+    const identities = new Set();
+    const repositories = mapping.repositories.map((value, index) => {
+        const field = `repositories[${index}]`;
+        const repository = asMapping(value, field);
+        validateKeys(repository, ["remote", "path"], field);
+        const remote = nonEmptyString(repository.remote, `${field}.remote`);
+        const identity = remoteIdentity(remote, `${field}.remote`);
+        if (identities.has(identity.coordinate)) {
+            throw new Error(`${field}.remote duplicates repository ${identity.coordinate}.`);
+        }
+        identities.add(identity.coordinate);
+        const configuredPath = nonEmptyString(repository.path, `${field}.path`);
+        if (configuredPath.startsWith("~")) {
+            throw new Error(`${field}.path must use an absolute path or a config-directory-relative path; tilde expansion is not supported.`);
+        }
+        if (pathApi.sep === "\\" && /^[a-z]:(?![\\/])/i.test(configuredPath)) {
+            throw new Error(`${field}.path must not use a drive-relative Windows path.`);
+        }
+        return {
+            ...identity,
+            remote,
+            path: pathApi.resolve(pathApi.dirname(runtimePaths.configFile), configuredPath),
+        };
+    });
+    validateRepositoryPaths(repositories, repositories.map((repository) => repository.path), runtimePaths.stateDirectory, pathApi);
+    return {
+        pollIntervalMs: positiveInteger(mapping, "pollIntervalMs"),
+        maxConcurrentWorker: positiveInteger(mapping, "maxConcurrentWorker"),
+        agentTimeoutMs: positiveInteger(mapping, "agentTimeoutMs"),
+        maxAttempts: positiveInteger(mapping, "maxAttempts"),
+        retryDelayMs: positiveInteger(mapping, "retryDelayMs"),
+        repositories,
+    };
+};
+const validatePhysicalRepositoryPaths = async (configuration, stateDirectory, repositoryDirectories, statePath) => {
+    const ancestors = new Map();
+    const ancestryOf = (directory) => {
+        const cached = ancestors.get(directory.ancestorIdentity);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const result = ancestorIdentities(directory.ancestorPath);
+        ancestors.set(directory.ancestorIdentity, result);
+        return result;
+    };
+    const stateAncestors = await ancestryOf(stateDirectory);
+    for (const [index, directory] of repositoryDirectories.entries()) {
+        const repositoryAncestors = await ancestryOf(directory);
+        if (repositoryAncestors.has(stateDirectory.ancestorIdentity) ||
+            (directory.missingComponents.length === 0 && stateAncestors.has(directory.ancestorIdentity))) {
+            throw new Error(`repositories[${index}].path must not overlap the state directory ${statePath}.`);
+        }
+        for (const [previousIndex, previous] of repositoryDirectories.slice(0, index).entries()) {
+            if (directory.ancestorIdentity !== previous.ancestorIdentity) {
+                continue;
+            }
+            const sameComponents = directory.missingComponents.length === previous.missingComponents.length;
+            const exact = sameComponents && directory.missingComponents.every((component, componentIndex) => component === previous.missingComponents[componentIndex]);
+            const observedSameDirectory = !exact && sameComponents && await missingPathsReferToSameDirectory(directory.ancestorPath, previous.missingComponents, directory.missingComponents);
+            if (exact || observedSameDirectory) {
+                throw new Error(`repositories[${index}].path resolves to the same location as repositories[${previousIndex}].path (${configuration.repositories[previousIndex].coordinate}).`);
+            }
+        }
+    }
+};
+export const loadConfiguration = async (runtimePaths) => {
+    let source;
+    try {
+        source = await readFile(runtimePaths.configFile, "utf8");
+    }
+    catch (cause) {
+        throw new Error(`Cannot read configuration file ${runtimePaths.configFile}.`, { cause });
+    }
+    return validateConfigurationSource(source, runtimePaths);
+};
+export const validateConfigurationSource = async (source, runtimePaths) => {
+    try {
+        const configuration = parseConfiguration(source, runtimePaths);
+        const [stateDirectory, ...repositoryDirectories] = await Promise.all([
+            resolvePhysicalDirectory(runtimePaths.stateDirectory),
+            ...configuration.repositories.map((repository) => resolvePhysicalDirectory(repository.path)),
+        ]);
+        await validatePhysicalRepositoryPaths(configuration, stateDirectory, repositoryDirectories, runtimePaths.stateDirectory);
+        return configuration;
+    }
+    catch (cause) {
+        throw new Error(`Invalid configuration file ${runtimePaths.configFile}: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+    }
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/coordinator.d.ts

@@ -0,0 +1,39 @@
+import type { ChildProcess } from "node:child_process";
+import type { Configuration } from "./config.js";
+import type { CopilotAttemptOutcome, createCopilotRunner } from "./copilot.js";
+import type { createGitManager } from "./git.js";
+import type { GitHubClient } from "./github.js";
+import type { AttemptIdentity, OperationsStopped, ProcessesExcluded, ReviewState, Store } from "./store.js";
+export type CoordinatorEvent = {
+    level: "info" | "error";
+    phase: string;
+    message: string;
+    repository?: string;
+    number?: number;
+    reviewId?: string;
+    revision?: number;
+    attempt?: number;
+    retryAt?: number;
+    error?: unknown;
+};
+export type CoordinatorProcesses = {
+    onProcess: (child: ChildProcess, attempt: AttemptIdentity) => void;
+    stop: (child: ChildProcess, attempt: AttemptIdentity) => Promise<void>;
+    exclude: (review: ReviewState, outcome?: CopilotAttemptOutcome) => Promise<ProcessesExcluded>;
+    recover: (review?: ReviewState) => Promise<ProcessesExcluded & OperationsStopped>;
+};
+export type CoordinatorOptions = {
+    configuration: Configuration;
+    store: Store;
+    client: GitHubClient;
+    git: ReturnType<typeof createGitManager>;
+    runner: Pick<ReturnType<typeof createCopilotRunner>, "run">;
+    processes: CoordinatorProcesses;
+    signal: AbortSignal;
+    log: (event: CoordinatorEvent) => void;
+    now?: () => number;
+};
+/** Owns one foreground scheduling lifetime; dependencies retain command and process ownership. */
+export declare const runCoordinator: (options: CoordinatorOptions) => Promise<{
+    safeToReleaseLock: boolean;
+}>;