@ahpd/server 0.1.0 → 0.2.0

package/dist/cron.d.ts

@@ -1,43 +0,0 @@
-/** Five-field AHP cron: what an expression means, and when it next comes round. */
-/**
- * A parsed expression, as the sets each field allows.
- *
- * Sets rather than the source text, because the question asked of this a
- * thousand times a day is "does this minute match" and not "what did somebody
- * type" - and because parsing once is what makes a bad expression a refusal at
- * the moment it is written rather than a schedule that silently never fires.
- */
-export interface Cron {
-    minutes: ReadonlySet<number>;
-    hours: ReadonlySet<number>;
-    doms: ReadonlySet<number>;
-    months: ReadonlySet<number>;
-    dows: ReadonlySet<number>;
-    /**
-     * Whether the day fields were narrowed, which decides how they combine.
-     *
-     * Unix cron's one genuine oddity: when both day-of-month and day-of-week are
-     * restricted, an occurrence matches when *either* does - `0 0 1 * 1` is the
-     * first of the month **and** every Monday. When one is `*` the other simply
-     * applies. Getting this backwards turns a weekly job into a yearly one.
-     */
-    domRestricted: boolean;
-    dowRestricted: boolean;
-}
-/**
- * Read an expression, or say what is wrong with it.
- *
- * Throws rather than returning undefined: an unparseable schedule is a thing
- * somebody typed and must be told about, and the one place it is read is the
- * moment they write it.
- */
-export declare function parseCron(expression: string): Cron;
-/**
- * The first occurrence strictly after that instant, or undefined.
- *
- * Walked a day at a time rather than a minute at a time: a minute-by-minute
- * search over the horizon is half a million time-zone conversions to answer a
- * question about February.
- */
-export declare function nextOccurrence(cron: Cron, after: Date, timeZone: string): Date | undefined;
-//# sourceMappingURL=cron.d.ts.map

package/dist/cron.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../src/cron.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF;;;;;;;GAOG;AACH,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B;;;;;;;OAOG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;CACxB;AAwED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAkBlD;AA8FD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CA0B1F"}

package/dist/cron.js

@@ -1,211 +0,0 @@
-/** Five-field AHP cron: what an expression means, and when it next comes round. */
-const MONTHS = ['jan', 'feb', 'mar', 'apr', 'may', 'jun', 'jul', 'aug', 'sep', 'oct', 'nov', 'dec'];
-const DAYS = ['sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat'];
-const FIELDS = [
-    { name: 'minute', min: 0, max: 59 },
-    { name: 'hour', min: 0, max: 23 },
-    { name: 'day of month', min: 1, max: 31 },
-    { name: 'month', min: 1, max: 12, names: MONTHS },
-    // 7 as well as 0, both meaning Sunday, which is what every crontab accepts.
-    { name: 'day of week', min: 0, max: 7, names: DAYS },
-];
-/** A single value, by number or by name. */
-function valueOf(text, field) {
-    const named = field.names?.indexOf(text.toLowerCase());
-    if (named !== undefined && named >= 0)
-        return named + (field.names === MONTHS ? 1 : 0);
-    if (!/^\d+$/.test(text))
-        throw new Error(`${text} is not a ${field.name}`);
-    const value = Number(text);
-    if (value < field.min || value > field.max) {
-        throw new Error(`${value} is out of range for ${field.name} (${field.min}-${field.max})`);
-    }
-    return value;
-}
-/** One field: a comma-separated list of values, ranges and steps. */
-function parseField(text, field) {
-    const out = new Set();
-    for (const term of text.split(',')) {
-        if (term === '')
-            throw new Error(`Empty ${field.name}`);
-        const [range, step] = term.split('/');
-        if (term.split('/').length > 2)
-            throw new Error(`${term} has more than one step`);
-        let by = 1;
-        if (step !== undefined) {
-            if (!/^\d+$/.test(step) || Number(step) === 0) {
-                throw new Error(`${step} is not a step for ${field.name}; a step must be a positive integer`);
-            }
-            by = Number(step);
-        }
-        let from;
-        let to;
-        if (range === '*') {
-            from = field.min;
-            to = field.max;
-        }
-        else if (range.includes('-')) {
-            const [a, b] = range.split('-');
-            if (range.split('-').length > 2)
-                throw new Error(`${range} is not a range`);
-            from = valueOf(a, field);
-            to = valueOf(b, field);
-            if (to < from)
-                throw new Error(`${range} runs backwards`);
-        }
-        else {
-            from = valueOf(range, field);
-            // A step on a single value means from there to the end of the field,
-            // which is what crontab does with `5/10`.
-            to = step === undefined ? from : field.max;
-        }
-        for (let at = from; at <= to; at += by)
-            out.add(at);
-    }
-    return out;
-}
-/**
- * Read an expression, or say what is wrong with it.
- *
- * Throws rather than returning undefined: an unparseable schedule is a thing
- * somebody typed and must be told about, and the one place it is read is the
- * moment they write it.
- */
-export function parseCron(expression) {
-    const fields = expression.trim().split(/\s+/);
-    if (fields.length !== 5) {
-        throw new Error(`A schedule has five fields; ${expression.trim() === '' ? 'this one has none' : `this one has ${fields.length}`}`);
-    }
-    const [minute, hour, dom, month, dow] = fields;
-    const dows = parseField(dow, FIELDS[4]);
-    // Both spellings of Sunday collapse to one, so a weekday test is a lookup.
-    if (dows.has(7)) {
-        dows.delete(7);
-        dows.add(0);
-    }
-    return {
-        minutes: parseField(minute, FIELDS[0]),
-        hours: parseField(hour, FIELDS[1]),
-        doms: parseField(dom, FIELDS[2]),
-        months: parseField(month, FIELDS[3]),
-        dows,
-        domRestricted: dom !== '*',
-        dowRestricted: dow !== '*',
-    };
-}
-const readers = new Map();
-/** Cached, because this is called once per candidate day and building one is not free. */
-function readerFor(timeZone) {
-    let held = readers.get(timeZone);
-    if (!held) {
-        held = new Intl.DateTimeFormat('en-US', {
-            timeZone,
-            hourCycle: 'h23',
-            year: 'numeric',
-            month: '2-digit',
-            day: '2-digit',
-            hour: '2-digit',
-            minute: '2-digit',
-        });
-        readers.set(timeZone, held);
-    }
-    return held;
-}
-/** What the clock in that zone said at that instant. */
-function wallAt(instant, timeZone) {
-    const parts = readerFor(timeZone).formatToParts(new Date(instant));
-    const found = {};
-    for (const part of parts) {
-        if (part.type !== 'literal')
-            found[part.type] = Number(part.value);
-    }
-    return {
-        year: found.year,
-        month: found.month,
-        day: found.day,
-        hour: found.hour,
-        minute: found.minute,
-    };
-}
-/** That zone's offset from UTC, in minutes, at that instant. */
-function offsetAt(instant, timeZone) {
-    const wall = wallAt(instant, timeZone);
-    const asUtc = Date.UTC(wall.year, wall.month - 1, wall.day, wall.hour, wall.minute);
-    // To the minute: the reading has no seconds, so the instant must not either.
-    return (asUtc - Math.floor(instant / 60000) * 60000) / 60000;
-}
-/**
- * The instant at which that zone's clock reads that.
- *
- * Two passes, because the offset depends on the answer: the first guess uses
- * the offset in force at roughly the right time and the second uses the one in
- * force at the instant the first produced, which is what gets the hour after a
- * DST change right. Returns undefined for a wall time that does not exist -
- * the hour a spring-forward skips - because a schedule pointing into the gap
- * has no occurrence that day rather than an occurrence at some other time.
- */
-function instantOf(wall, timeZone) {
-    const guess = Date.UTC(wall.year, wall.month - 1, wall.day, wall.hour, wall.minute);
-    let instant = guess - offsetAt(guess, timeZone) * 60000;
-    const again = guess - offsetAt(instant, timeZone) * 60000;
-    if (again !== instant)
-        instant = again;
-    const back = wallAt(instant, timeZone);
-    if (back.hour !== wall.hour || back.minute !== wall.minute || back.day !== wall.day)
-        return undefined;
-    return instant;
-}
-// ------------------------------------------------------------- the next time
-/** How far ahead to look before calling an expression unreachable. `0 0 30 2 *` is. */
-const HORIZON_DAYS = 1500;
-/** Whether that calendar day is one this expression fires on. */
-function dayMatches(cron, year, month, day) {
-    if (!cron.months.has(month))
-        return false;
-    const dow = new Date(Date.UTC(year, month - 1, day)).getUTCDay();
-    const byDom = cron.doms.has(day);
-    const byDow = cron.dows.has(dow);
-    if (cron.domRestricted && cron.dowRestricted)
-        return byDom || byDow;
-    if (cron.domRestricted)
-        return byDom;
-    if (cron.dowRestricted)
-        return byDow;
-    return true;
-}
-/**
- * The first occurrence strictly after that instant, or undefined.
- *
- * Walked a day at a time rather than a minute at a time: a minute-by-minute
- * search over the horizon is half a million time-zone conversions to answer a
- * question about February.
- */
-export function nextOccurrence(cron, after, timeZone) {
-    const from = after.getTime();
-    const start = wallAt(from, timeZone);
-    const minutes = [...cron.minutes].sort((a, b) => a - b);
-    const hours = [...cron.hours].sort((a, b) => a - b);
-    for (let ahead = 0; ahead <= HORIZON_DAYS; ahead++) {
-        // Calendar arithmetic in UTC on the *wall* date, which is date arithmetic
-        // and not instant arithmetic - adding 24 hours to an instant lands on the
-        // same date twice a year.
-        const at = new Date(Date.UTC(start.year, start.month - 1, start.day + ahead));
-        const year = at.getUTCFullYear();
-        const month = at.getUTCMonth() + 1;
-        const day = at.getUTCDate();
-        if (!dayMatches(cron, year, month, day))
-            continue;
-        for (const hour of hours) {
-            for (const minute of minutes) {
-                const instant = instantOf({ year, month, day, hour, minute }, timeZone);
-                // Undefined is the spring-forward gap; earlier than `after` is the
-                // hour a fall-back repeats, where the first pass is already behind us.
-                if (instant === undefined || instant <= from)
-                    continue;
-                return new Date(instant);
-            }
-        }
-    }
-    return undefined;
-}
-//# sourceMappingURL=cron.js.map

package/dist/cron.js.map

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

package/dist/git.d.ts

@@ -1,16 +0,0 @@
-/** What git can say about a directory the host serves. */
-import type { DirectoryFacts } from './types/host.js';
-/**
- * The branch each served directory is on, as a host's `DirectoryFacts`.
- *
- * Deliberately not part of `createHost`: it spawns `git`, which is a binary
- * rather than a runtime API and may not be installed at all. The daemon wires
- * it in, a library caller opts in, and a host without it still names its
- * projects - so nothing here is load-bearing for the protocol.
- *
- * ```ts
- * createHost({ path, agents: [claude({ paths })], directories: gitBranches() });
- * ```
- */
-export declare function gitBranches(): DirectoryFacts;
-//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAG1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,IAAI,cAAc,CAkH5C"}

package/dist/git.js

@@ -1,126 +0,0 @@
-/** What git can say about a directory the host serves. */
-import { execFile } from 'node:child_process';
-/**
- * The branch each served directory is on, as a host's `DirectoryFacts`.
- *
- * Deliberately not part of `createHost`: it spawns `git`, which is a binary
- * rather than a runtime API and may not be installed at all. The daemon wires
- * it in, a library caller opts in, and a host without it still names its
- * projects - so nothing here is load-bearing for the protocol.
- *
- * ```ts
- * createHost({ path, agents: [claude({ paths })], directories: gitBranches() });
- * ```
- */
-export function gitBranches() {
-    /*
-     * The branch, per *directory* rather than per session.
-     *
-     * A host serving one repository with ninety-eight sessions in it would
-     * otherwise ask git ninety-eight times for one answer.
-     */
-    const facts = new Map();
-    /** Run git in a directory and answer what it said, or nothing at all. */
-    const git = (dir, args) => new Promise((answer) => {
-        execFile('git', ['-C', dir, ...args], { timeout: 2000 }, (error, out) => {
-            answer(error ? undefined : out.toString().trim());
-        });
-    });
-    /**
-     * The owner and repository of a GitHub remote, if the remote is one.
-     *
-     * Both URL forms git writes: `git@github.com:owner/repo.git` and
-     * `https://github.com/owner/repo`. Anything else is a remote this says
-     * nothing about rather than one it guesses at.
-     */
-    const github = (url) => {
-        const found = /github\.com[:/]([^/]+)\/(.+?)(?:\.git)?$/.exec(url ?? '');
-        return found ? { owner: found[1], repo: found[2] } : undefined;
-    };
-    /**
-     * Ask git, and answer whether what it said differs from what was held.
-     *
-     * A directory that is not a repository, or one whose HEAD is detached, has
-     * no branch and is remembered as having none: `rev-parse --abbrev-ref` says
-     * `HEAD` for a detached head, and reporting that would draw a branch called
-     * HEAD.
-     */
-    const refresh = async (dir) => {
-        const said = await git(dir, ['rev-parse', '--abbrev-ref', 'HEAD']);
-        const branchName = said === undefined || said === '' || said === 'HEAD' ? undefined : said;
-        if (branchName === undefined) {
-            const had = facts.has(dir);
-            facts.delete(dir);
-            return had;
-        }
-        /*
-         * The rest in two more calls, both cheap and both answering a question a
-         * client draws something from.
-         *
-         * `status -sb --porcelain` names the upstream and the ahead/behind counts
-         * on its first line and one file per line after it, so the count of
-         * uncommitted changes comes out of the same call. `remote get-url` is the
-         * only way to know whether this is a GitHub repository, which is what
-         * turns a client's pull-request affordances on.
-         */
-        const [status, origin] = await Promise.all([
-            git(dir, ['status', '-sb', '--porcelain']),
-            git(dir, ['remote', 'get-url', 'origin']),
-        ]);
-        const lines = (status ?? '').split('\n');
-        const head = lines[0] ?? '';
-        const upstream = /^## [^.]*\.\.\.(\S+)/.exec(head)?.[1];
-        const ahead = Number(/\[.*?ahead (\d+)/.exec(head)?.[1] ?? 0);
-        const behind = Number(/\[.*?behind (\d+)/.exec(head)?.[1] ?? 0);
-        const owner = github(origin);
-        const now = {
-            branchName,
-            /*
-             * The drift, and only where there is something to drift from.
-             *
-             * A branch with no upstream is not zero ahead and zero behind, it is
-             * neither - and a client draws these as arrows beside the branch, so a
-             * pair of zeroes is two arrows saying nothing. The reference host omits
-             * them the same way.
-             */
-            ...(upstream === undefined ? {} : {
-                upstreamBranchName: upstream,
-                incomingChanges: behind,
-                outgoingChanges: ahead,
-            }),
-            uncommittedChanges: lines.slice(1).filter((one) => one.trim() !== '').length,
-            hasGitHubRemote: owner !== undefined,
-            ...(owner ? { githubOwner: owner.owner, githubRepo: owner.repo } : {}),
-        };
-        const before = facts.get(dir);
-        if (before !== undefined && JSON.stringify(before) === JSON.stringify(now))
-            return false;
-        facts.set(dir, now);
-        return true;
-    };
-    return {
-        /*
-         * `git` is the well-known key, and the field names are the reference host's.
-       *
-       * Not the protocol's: it declares no `_meta` keys at all. The names come
-       * from a capture of the other implementation - `branchName`,
-       * `upstreamBranchName`, `incomingChanges`, `outgoingChanges`,
-       * `uncommittedChanges`, `hasGitHubRemote`, `githubOwner`, `githubRepo` -
-       * because a client reads one spelling, and this host used to write `branch`
-       * where that client looks for `branchName` and so said nothing at all.
-       *
-       * Written whole, and correct only because this is the only producer of
-       * `_meta` here.
-         *
-         * Correct only because this is the only producer of `_meta` here:
-         * `session/metaChanged` replaces the map entirely, so a host with two of
-         * them would have to merge before dispatching rather than after.
-         */
-        meta: (dir) => {
-            const held = facts.get(dir);
-            return held === undefined ? undefined : { git: { ...held } };
-        },
-        refresh,
-    };
-}
-//# sourceMappingURL=git.js.map

package/dist/git.js.map

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

package/dist/host.d.ts

@@ -1,24 +0,0 @@
-/**
- * The protocol server: channels, subscriptions, requests and state actions.
- *
- * One host serves many connections. It owns the session catalogue, the live
- * sessions and the sequence number that orders everything it emits.
- *
- * Rules that govern anything answering AHP:
- *
- * - `serverSeq` advances when state changes, not per message. A snapshot is
- *   taken at a sequence number and every action after it carries a greater
- *   one, which is how a client knows it missed nothing.
- * - Notifications carry no id and get no reply. `unsubscribe` and
- *   `dispatchAction` are notifications.
- * - Subscriptions are per connection. Dropping one client's subscription must
- *   not affect another's.
- * - Only client-dispatchable actions are accepted from clients; the rest are
- *   the host reporting what it did.
- */
-import type { Host, HostOptions } from './types/host.js';
-import type { Summary } from './types/catalog.js';
-declare const ROOT = "ahp-root://";
-export declare function createHost(options: HostOptions): Host;
-export { ROOT, type Summary };
-//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAeH,OAAO,KAAK,EAAuB,IAAI,EAAE,WAAW,EAAY,MAAM,iBAAiB,CAAC;AACxF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAwBlD,QAAA,MAAM,IAAI,gBAAgB,CAAC;AAgI3B,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAgoLrD;AACD,OAAO,EAAE,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC"}