adispatchd 0.0.0-stage → 0.1.0

package/dist/cli/init-templates.js

@@ -0,0 +1,275 @@
+/**
+ * Files created by `init` (Spec §4): a commented, valid example configuration
+ * that starts without any GitHub credentials. Only the manual `hello`
+ * workflow is enabled; the GitHub coder workflow and the nightly schedule are
+ * disabled examples to copy from. Kept as code (not as package files) so the
+ * installed package needs no asset lookup.
+ */
+const CONFIG_YAML = (port) => `# config.yaml – global settings (Spec §5.1). All keys are optional; shown values are the defaults
+# unless noted. Validate after every change:  adispatch config validate --config-dir <dir>
+# Apply changes to a running instance:          adispatch config reload --config-dir <dir>
+
+server:
+  # The HTTP API/UI has NO authentication (V1). Keep it on loopback. To expose it, put an
+  # AUTHENTICATING reverse proxy / VPN / Tailscale in front (see docs/operations.md).
+  host: 127.0.0.1
+  port: ${port}
+  # Extra host names accepted in the Host/Origin header (DNS-rebinding protection), e.g. the
+  # public name of the authenticating reverse proxy: [orchestrator.example.com]
+  # ("name" = any port, "name:port" = only that port). Loopback names are always accepted.
+  allowed_hosts: []
+
+scheduler:
+  polling_interval: 30s   # how often sources are polled
+  max_concurrent: 5       # global limit for automatic starts (manual starts count, but are not limited)
+
+workspace:
+  # One workspace per run under base_dir/<workflow>/<run> (default: <data-dir>/workspaces).
+  # Relative paths are relative to this config dir.
+  # base_dir: /var/lib/adispatchd/workspaces
+  cleanup: on_success     # always | on_success | never
+
+lifecycle:
+  action_retry:           # default retry of lifecycle actions (source.update/comment, shell)
+    max_attempts: 3
+    delay: 30s
+
+retention:
+  completed_runs: 30d     # successful runs
+  failed_runs: 90d        # failed, crashed, cancelled ... runs
+  blocked_runs: never     # runs that led to a retry block
+  max_log_size_per_run: 100MB
+  cleanup_interval: 24h
+
+notifications:
+  # Central orchestrator notifications (Spec §18). Secrets come from environment variables:
+  # channels:
+  #   - type: webhook
+  #     url_env: SLACK_WEBHOOK_URL
+  #     headers_env: { Authorization: WEBHOOK_AUTH_HEADER }
+  on: [retry_block_created, lifecycle_action_failed, recovery_failed]
+`;
+const SOURCES_YAML = `# sources.yaml – external task sources (Spec §5.2). V1: GitHub issues/PRs.
+# Each source uses an identity from identities.yaml for read access.
+# The source ID is part of every run's item key (<source>:<number>) – renaming it detaches the run history.
+sources:
+  project_a:
+    type: github
+    owner: example          # GitHub owner/organisation
+    repository: project-a
+    identity: maintainer
+`;
+const IDENTITIES_YAML = `# identities.yaml – GitHub App identities, one per role (Spec §5.3).
+# The private key is NEVER stored here: private_key_env names an environment variable that holds
+# the PEM (real line breaks or "\\n" escapes). Under systemd put it into the EnvironmentFile
+# (default /etc/default/adispatchd, mode 0640).
+# Minimal app permissions: Issues read/write, Pull requests write (labels/comments on PRs), Metadata read.
+identities:
+  maintainer:
+    type: github_app
+    app_id: 100001
+    installation_id: 200001
+    private_key_env: GITHUB_MAINTAINER_PRIVATE_KEY
+  coder:
+    type: github_app
+    app_id: 100002
+    installation_id: 200002
+    private_key_env: GITHUB_CODER_PRIVATE_KEY
+`;
+const HELLO_YAML = `# workflows/hello.yaml – a manual workflow that runs without any external source.
+# Start it in the web UI (Workflows → hello → Start) or via the API:
+#   curl -X POST -H 'X-Adispatch-Request: 1' -H 'Content-Type: application/json' \\
+#        -d '{"parameters":{"name":"Ada"}}' http://127.0.0.1:8787/api/v1/workflows/hello/start
+id: hello
+name: Hello World
+trigger: { type: manual }
+parameters:
+  name:
+    type: string
+    default: world
+    description: Whom to greet
+execute:
+  type: shell
+  # Relative paths are resolved against the config dir. Arguments are passed as a list (no shell).
+  command: scripts/hello.sh
+  args: ['{parameters.name}']
+  timeout:
+    max_duration: 10m       # total runtime (default: unlimited)
+    idle_timeout: 5m        # time without output (default: unlimited)
+on_success:
+  - type: shell             # lifecycle shell action; gets run + result context (ADISPATCH_CONTEXT_FILE)
+    command: scripts/notify.sh
+    args: ['{workflow.id}', '{run.id}', '{result.message}']
+    timeout: 30s
+`;
+const CODER_YAML = `# workflows/coder.yaml – GitHub-driven agent workflow (Spec §5.4). DISABLED example:
+# configure sources.yaml/identities.yaml, provide the private keys, then set enabled: true.
+id: coder
+name: Coder – Project A
+enabled: false
+priority: 50                # workflow priority (higher first) before item priority
+max_concurrent: 2
+identity: coder             # default identity for writes (labels, comments)
+
+trigger:
+  type: source
+  source: project_a
+
+filter:                     # declarative filter (all/any/not; equals, contains, in, greater_than, ...)
+  all:
+    - { field: labels, operator: contains, value: ready-for-coding }
+    - { field: dependencies.blocked_by_open, operator: equals, value: 0 }
+
+item_priority:
+  rules:
+    - when: { field: labels, operator: contains, value: 'priority:high' }
+      value: 50
+  default: 0
+
+conditions:
+  workflow:                 # exit 0 = ok, 1 = not now, >=2 = check error (unknown → no start)
+    - type: shell
+      command: scripts/check-credits.sh
+      timeout: 15s
+      cache: 60s
+
+execute:
+  type: shell
+  command: scripts/coder.sh
+  working_directory: '{workspace.base_dir}/{workflow.id}/{run.id}'
+  env:
+    NODE_ENV: production
+  secrets:
+    GH_TOKEN: { identity: coder }   # short-lived installation token, only for this worker
+  timeout:
+    max_duration: 6h
+    idle_timeout: 45m
+  cancel_grace: 30s         # SIGTERM → SIGKILL of the worker's process group
+
+retry:
+  max_technical_failures: 3 # consecutive crashes/timeouts/start errors → retry block (remove in UI)
+
+on_start:
+  - type: source.update
+    labels: { add: [coding], remove: [ready-for-coding] }
+on_success:
+  - type: source.update
+    labels: { add: [ready-for-review], remove: [coding] }
+  - type: source.comment
+    message: 'Completed: {result.message}'
+    continue_on_error: true
+on_failure:                 # business failure: valid result file with "result": "failure"
+  - type: source.update
+    labels: { add: [needs-maintainer], remove: [coding] }
+  - type: source.comment
+    message: 'Needs maintainer: {result.message}'
+on_crash:
+  - type: source.update
+    labels: { add: [ready-for-coding], remove: [coding] }
+on_start_error:
+  - type: source.update
+    labels: { add: [ready-for-coding], remove: [coding] }
+on_timeout:
+  - type: source.update
+    labels: { add: [ready-for-coding], remove: [coding] }
+on_cancel:
+  - type: source.update
+    labels: { add: [ready-for-coding], remove: [coding] }
+`;
+const NIGHTLY_YAML = `# workflows/nightly-maintenance.yaml – time-triggered workflow (Spec §5.5). DISABLED example.
+# Missed slots (downtime, limits, failing conditions) are skipped, never caught up (docs/cron-semantics.md).
+id: nightly-maintenance
+name: Nightly Maintenance
+enabled: false
+priority: 20
+trigger:
+  type: schedule
+  cron: '0 3 * * *'
+  timezone: Europe/Berlin   # default UTC
+execute:
+  type: shell
+  command: scripts/maintenance.sh
+`;
+const VIEW_YAML = `# views/needs-maintainer.yaml – read-only table over one or more sources (Spec §17).
+# Needs working source credentials; otherwise the view shows a per-source error.
+id: needs-maintainer
+title: Needs Maintainer
+sources: [project_a]
+filter:
+  all:
+    - { field: labels, operator: contains, value: needs-maintainer }
+fields:
+  - { field: repository, label: Repository }
+  - { field: number, label: Issue }
+  - { field: title, label: Title, link: url }
+  - { field: run.last_workflow, label: Last agent }
+  - { field: run.last_result.message, label: Result }
+  - { field: updated_at, label: Updated }
+sort: { field: updated_at, direction: desc }
+`;
+const HELLO_SH = `#!/bin/sh
+# Example worker (worker protocol: docs/worker-protocol.md).
+# Input:  ADISPATCH_* environment variables + JSON context file ADISPATCH_CONTEXT_FILE.
+# Output: stdout/stderr (logged), optional "@@ADISPATCH_EVENT {json}" lines, optional result file ADISPATCH_RESULT_FILE.
+# Exit code: 0 = technically OK (business result from the result file, default success); != 0 = crashed.
+set -eu
+
+name="\${1:-world}"
+echo '@@ADISPATCH_EVENT {"type":"status","message":"Saying hello"}'
+echo "Hello, \${name}!"
+echo "run \${ADISPATCH_RUN_ID} of workflow \${ADISPATCH_WORKFLOW_ID} in \${ADISPATCH_WORKSPACE}"
+echo '@@ADISPATCH_EVENT {"type":"progress","value":100}'
+
+# Write the result atomically (temp file + rename). "failure" would trigger on_failure instead.
+tmp="\${ADISPATCH_RESULT_FILE}.tmp"
+printf '%s\\n' '{"schema_version":1,"result":"success","message":"Said hello"}' > "\${tmp}"
+mv "\${tmp}" "\${ADISPATCH_RESULT_FILE}"
+`;
+const NOTIFY_SH = `#!/bin/sh
+# Example lifecycle shell action: receives the rendered args and the run/result context
+# (ADISPATCH_CONTEXT_FILE). Replace with e.g. a Slack webhook call. Exit != 0 = action failed (retried).
+set -eu
+echo "workflow $1, run $2 finished: $3"
+`;
+const CODER_SH = `#!/bin/sh
+# Example coder wrapper – replace the body with your agent invocation.
+# GH_TOKEN (declared under execute.secrets) authenticates the GitHub CLI as the coder app.
+set -eu
+echo "Working on \${ADISPATCH_SOURCE_URL:-?} (item \${ADISPATCH_SOURCE_ITEM_ID:-?}) in \${ADISPATCH_WORKSPACE}"
+# git clone ... && your-agent --context "\${ADISPATCH_CONTEXT_FILE}"
+
+# Business failure ("needs maintainer"): write a valid result file and exit 0:
+#   printf '%s\\n' '{"schema_version":1,"result":"failure","message":"Requirements unclear"}' > "\${ADISPATCH_RESULT_FILE}.tmp"
+#   mv "\${ADISPATCH_RESULT_FILE}.tmp" "\${ADISPATCH_RESULT_FILE}"
+# Any exit code != 0 counts as a technical failure (crashed) and towards the retry block.
+exit 0
+`;
+const CHECK_CREDITS_SH = `#!/bin/sh
+# Example workflow condition: exit 0 = start allowed, 1 = not now, >= 2 = check error (unknown).
+exit 0
+`;
+const MAINTENANCE_SH = `#!/bin/sh
+set -eu
+echo "nightly maintenance at $(date -u +%Y-%m-%dT%H:%M:%SZ)"
+`;
+/** All files created by `init`, relative to config-dir. */
+export function initTemplates(options = {}) {
+    const port = options.port ?? 8787;
+    return [
+        { path: 'config.yaml', content: CONFIG_YAML(port), mode: 0o640 },
+        { path: 'sources.yaml', content: SOURCES_YAML, mode: 0o640 },
+        { path: 'identities.yaml', content: IDENTITIES_YAML, mode: 0o640 },
+        { path: 'workflows/hello.yaml', content: HELLO_YAML, mode: 0o640 },
+        { path: 'workflows/coder.yaml', content: CODER_YAML, mode: 0o640 },
+        { path: 'workflows/nightly-maintenance.yaml', content: NIGHTLY_YAML, mode: 0o640 },
+        { path: 'views/needs-maintainer.yaml', content: VIEW_YAML, mode: 0o640 },
+        { path: 'scripts/hello.sh', content: HELLO_SH, mode: 0o750 },
+        { path: 'scripts/notify.sh', content: NOTIFY_SH, mode: 0o750 },
+        { path: 'scripts/coder.sh', content: CODER_SH, mode: 0o750 },
+        { path: 'scripts/check-credits.sh', content: CHECK_CREDITS_SH, mode: 0o750 },
+        { path: 'scripts/maintenance.sh', content: MAINTENANCE_SH, mode: 0o750 },
+    ];
+}
+/** Directories created in data-dir (Spec §4); the app creates missing ones itself as well. */
+export const DATA_DIR_LAYOUT = ['logs', 'runs', 'workspaces', 'backups'];
+//# sourceMappingURL=init-templates.js.map

package/dist/cli/init-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-templates.js","sourceRoot":"","sources":["../../src/cli/init-templates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,WAAW,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC;;;;;;;;UAQpC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCb,CAAC;AAEF,MAAM,YAAY,GAAG;;;;;;;;;CASpB,CAAC;AAEF,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;CAgBvB,CAAC;AAEF,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyBlB,CAAC;AAEF,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyElB,CAAC;AAEF,MAAM,YAAY,GAAG;;;;;;;;;;;;;CAapB,CAAC;AAEF,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;CAgBjB,CAAC;AAEF,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;CAiBhB,CAAC;AAEF,MAAM,SAAS,GAAG;;;;;CAKjB,CAAC;AAEF,MAAM,QAAQ,GAAG;;;;;;;;;;;;CAYhB,CAAC;AAEF,MAAM,gBAAgB,GAAG;;;CAGxB,CAAC;AAEF,MAAM,cAAc,GAAG;;;CAGtB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAAC,OAAO,GAAsB,EAAE;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;IAClC,OAAO;QACL,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE;QAChE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE;QAC5D,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,EAAE;QAClE,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;QAClE,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;QAClE,EAAE,IAAI,EAAE,oCAAoC,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE;QAClF,EAAE,IAAI,EAAE,6BAA6B,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE;QACxE,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE;QAC5D,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE;QAC9D,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE;QAC5D,EAAE,IAAI,EAAE,0BAA0B,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE;QAC5E,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE;KACzE,CAAC;AACJ,CAAC;AAED,8FAA8F;AAC9F,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,CAAU,CAAC"}

package/dist/cli/init.d.ts

@@ -0,0 +1,16 @@
+import type { CliIo, InitCliOptions } from './program.js';
+/** Result of {@link initDirectories}. */
+export interface InitResult {
+    configDir: string;
+    dataDir: string;
+    created: string[];
+    kept: string[];
+}
+/** Create config-dir and data-dir (idempotent, never overwrites). */
+export declare function initDirectories(options: {
+    configDir: string;
+    dataDir: string;
+    port?: number;
+}): Promise<InitResult>;
+/** Create the `init` handler. */
+export declare function createInitHandler(io: Pick<CliIo, 'stdout' | 'stderr'>): (opts: InitCliOptions) => Promise<number>;

package/dist/cli/init.js

@@ -0,0 +1,107 @@
+/**
+ * `init --config-dir <dir> [--data-dir <dir>] [--port <port>]` (Spec §4):
+ * creates the config-dir with a commented example configuration and example
+ * scripts, and the data-dir layout. Never overwrites or modifies existing
+ * files (each file is created with `O_EXCL`); existing files are reported as
+ * kept. Afterwards the resulting configuration is validated.
+ *
+ * Exit codes: 0 = done (configuration valid), 1 = resulting configuration
+ * invalid (e.g. because of pre-existing files) or I/O error, 2 = usage error.
+ */
+import { constants } from 'node:fs';
+import { chmod, mkdir, open } from 'node:fs/promises';
+import path from 'node:path';
+import { errorMessage } from '../core/index.js';
+import { formatConfigIssue, loadConfig } from '../config/index.js';
+import { DATA_DIR_LAYOUT, initTemplates } from './init-templates.js';
+/** Create a file only if it does not exist yet. Returns false if it existed. */
+async function createExclusive(file, content, mode) {
+    let handle;
+    try {
+        handle = await open(file, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL, mode);
+    }
+    catch (err) {
+        if (err.code === 'EEXIST')
+            return false;
+        throw err;
+    }
+    try {
+        await handle.writeFile(content, 'utf8');
+    }
+    finally {
+        await handle.close();
+    }
+    await chmod(file, mode); // independent of the umask
+    return true;
+}
+/** Create config-dir and data-dir (idempotent, never overwrites). */
+export async function initDirectories(options) {
+    const configDir = path.resolve(options.configDir);
+    const dataDir = path.resolve(options.dataDir);
+    const created = [];
+    const kept = [];
+    for (const sub of ['', 'workflows', 'views', 'scripts']) {
+        await mkdir(path.join(configDir, sub), { recursive: true, mode: 0o750 });
+    }
+    for (const file of initTemplates({ ...(options.port !== undefined ? { port: options.port } : {}) })) {
+        const target = path.join(configDir, file.path);
+        if (await createExclusive(target, file.content, file.mode))
+            created.push(target);
+        else
+            kept.push(target);
+    }
+    await mkdir(dataDir, { recursive: true, mode: 0o750 });
+    for (const sub of DATA_DIR_LAYOUT) {
+        await mkdir(path.join(dataDir, sub), { recursive: true, mode: 0o750 });
+    }
+    return { configDir, dataDir, created, kept };
+}
+/** Create the `init` handler. */
+export function createInitHandler(io) {
+    return async (opts) => {
+        if (!opts.configDir) {
+            io.stderr('init: --config-dir is required (e.g. init --config-dir ./config --data-dir ./data)\n');
+            return 2;
+        }
+        let port;
+        if (opts.port !== undefined) {
+            port = Number(opts.port);
+            if (!Number.isInteger(port) || port < 1 || port > 65535) {
+                io.stderr(`init: invalid --port "${opts.port}"\n`);
+                return 2;
+            }
+        }
+        let result;
+        try {
+            result = await initDirectories({ configDir: opts.configDir, dataDir: opts.dataDir ?? 'data', ...(port !== undefined ? { port } : {}) });
+        }
+        catch (err) {
+            io.stderr(`init: ${errorMessage(err)}\n`);
+            return 1;
+        }
+        for (const f of result.created)
+            io.stdout(`created  ${f}\n`);
+        for (const f of result.kept)
+            io.stdout(`kept     ${f} (exists, not modified)\n`);
+        io.stdout(`data dir ${result.dataDir}\n`);
+        const loaded = await loadConfig(result.configDir, { dataDir: result.dataDir });
+        for (const w of loaded.warnings)
+            io.stderr(`warning: ${formatConfigIssue(w)}\n`);
+        if (!loaded.ok) {
+            io.stderr(`init: the configuration in ${result.configDir} is invalid (existing files were kept):\n` +
+                loaded.errors.map((e) => `  ${formatConfigIssue(e)}\n`).join(''));
+            return 1;
+        }
+        const q = (p) => (/^[A-Za-z0-9_@%+=:,./-]+$/.test(p) ? p : `'${p.replace(/'/g, `'\\''`)}'`);
+        io.stdout([
+            '',
+            'Next steps:',
+            `  adispatch start --config-dir ${q(result.configDir)} --data-dir ${q(result.dataDir)}`,
+            `  open http://127.0.0.1:${loaded.config.global.server.port}/ and start the "hello" workflow`,
+            '  configure sources.yaml / identities.yaml and enable workflows/coder.yaml for GitHub (see README.md)',
+            '',
+        ].join('\n'));
+        return 0;
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

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

package/dist/cli/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/main.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/** Executable entry point of the `adispatch` binary. */
+import { createConfigValidateHandler } from './config-validate.js';
+import { createConfigReloadHandler, createSchedulerHandler, createShutdownHandler, createStatusHandler } from './control.js';
+import { createInitHandler } from './init.js';
+import { createProgram, processIo } from './program.js';
+import { createServiceInstallHandler, createServiceStatusHandler, createServiceUninstallHandler } from './service.js';
+import { createStartHandler } from './start.js';
+import { createWorkflowDryRunHandler } from './workflow-dry-run.js';
+await createProgram({
+    init: createInitHandler(processIo),
+    start: createStartHandler(processIo),
+    configValidate: createConfigValidateHandler(processIo),
+    configReload: createConfigReloadHandler(processIo),
+    workflowDryRun: createWorkflowDryRunHandler(processIo),
+    status: createStatusHandler(processIo),
+    pause: createSchedulerHandler('pause', processIo),
+    resume: createSchedulerHandler('resume', processIo),
+    drain: createShutdownHandler('drain', processIo),
+    cancelAll: createShutdownHandler('cancel-all', processIo),
+    serviceInstall: createServiceInstallHandler(processIo),
+    serviceStatus: createServiceStatusHandler(processIo),
+    serviceUninstall: createServiceUninstallHandler(processIo),
+}, processIo).parseAsync(process.argv);
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AACA,wDAAwD;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC7H,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AACtH,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEpE,MAAM,aAAa,CACjB;IACE,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC;IAClC,KAAK,EAAE,kBAAkB,CAAC,SAAS,CAAC;IACpC,cAAc,EAAE,2BAA2B,CAAC,SAAS,CAAC;IACtD,YAAY,EAAE,yBAAyB,CAAC,SAAS,CAAC;IAClD,cAAc,EAAE,2BAA2B,CAAC,SAAS,CAAC;IACtD,MAAM,EAAE,mBAAmB,CAAC,SAAS,CAAC;IACtC,KAAK,EAAE,sBAAsB,CAAC,OAAO,EAAE,SAAS,CAAC;IACjD,MAAM,EAAE,sBAAsB,CAAC,QAAQ,EAAE,SAAS,CAAC;IACnD,KAAK,EAAE,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC;IAChD,SAAS,EAAE,qBAAqB,CAAC,YAAY,EAAE,SAAS,CAAC;IACzD,cAAc,EAAE,2BAA2B,CAAC,SAAS,CAAC;IACtD,aAAa,EAAE,0BAA0B,CAAC,SAAS,CAAC;IACpD,gBAAgB,EAAE,6BAA6B,CAAC,SAAS,CAAC;CAC3D,EACD,SAAS,CACV,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/cli/program.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Command-line interface definition (Spec §4, §14, §19). The command tree is
+ * declared here; the behaviour lives in injectable handlers (see `main.ts`).
+ */
+import { Command } from 'commander';
+/** Options available on every command. */
+export interface GlobalOptions {
+    configDir?: string;
+    dataDir?: string;
+}
+/** Options of commands talking to a running instance over HTTP. */
+export interface ControlCliOptions extends GlobalOptions {
+    /** Base URL of the running instance (default: `server.host`/`server.port` of the config, else `http://127.0.0.1:8787`). */
+    url?: string;
+    /** Print the raw JSON response. */
+    json?: boolean;
+}
+/** Options of `workflow dry-run`. */
+export interface DryRunCliOptions extends ControlCliOptions {
+    /** Evaluate locally even if an instance is running. */
+    local?: boolean;
+}
+/** Options of `drain` / `cancel-all`. */
+export interface ShutdownCliOptions extends ControlCliOptions {
+    /** Wait until the instance has stopped. */
+    wait?: boolean;
+    /** Maximum wait time with `--wait` (duration, default unlimited). */
+    timeout?: string;
+    /** Reason recorded for cancelled runs (`cancel-all`). */
+    reason?: string;
+}
+/** Options of `start`. */
+export interface StartCliOptions extends GlobalOptions {
+    /** SIGTERM drain timeout before cancel-all (duration, default 10m). */
+    drainTimeout?: string;
+    /** Time for cancelled runs incl. `on_cancel` before hooks are interrupted (duration, default 2m). */
+    cancelTimeout?: string;
+    /** Override `server.host`. */
+    host?: string;
+    /** Override `server.port`. */
+    port?: string;
+}
+/** Options of `init`. */
+export interface InitCliOptions extends GlobalOptions {
+    /** `server.port` written into a newly created config.yaml. */
+    port?: string;
+}
+/** Options of the `service` commands. */
+export interface ServiceCliOptions extends GlobalOptions {
+    /** Print what would be done (unit file + steps) without changing anything. */
+    dryRun?: boolean;
+    /** Unit name without `.service` (default `adispatchd`). */
+    name?: string;
+    /** Dedicated service user (default `adispatchd`). */
+    user?: string;
+    /** Group (default = user). */
+    group?: string;
+    /** Create the user if missing. */
+    createUser?: boolean;
+    /** Absolute node executable (default: the running node). */
+    node?: string;
+    /** Absolute package entry point (default: this installation's `dist/cli/main.js`). */
+    entry?: string;
+    /** Environment file for secrets (default `/etc/default/<name>`; `none` disables it). */
+    envFile?: string;
+    /** Directory for unit files (default `/etc/systemd/system`). */
+    unitDir?: string;
+    drainTimeout?: string;
+    cancelTimeout?: string;
+    /** `systemctl enable --now`. */
+    now?: boolean;
+}
+/** Exit code used by commands that are not implemented yet. */
+export declare const EXIT_NOT_IMPLEMENTED = 70;
+type Handler<O> = (opts: O) => Promise<number>;
+/** Handlers plugged into the command tree; unimplemented commands print a notice. */
+export interface CliHandlers {
+    init?: Handler<InitCliOptions>;
+    start?: Handler<StartCliOptions>;
+    configValidate?: Handler<GlobalOptions>;
+    configReload?: Handler<ControlCliOptions>;
+    workflowDryRun?: (workflowId: string, opts: DryRunCliOptions) => Promise<number>;
+    status?: Handler<ControlCliOptions>;
+    pause?: Handler<ControlCliOptions>;
+    resume?: Handler<ControlCliOptions>;
+    drain?: Handler<ShutdownCliOptions>;
+    cancelAll?: Handler<ShutdownCliOptions>;
+    serviceInstall?: Handler<ServiceCliOptions>;
+    serviceStatus?: Handler<ServiceCliOptions>;
+    serviceUninstall?: Handler<ServiceCliOptions>;
+}
+/** Streams/side effects used by the CLI (injectable for tests). */
+export interface CliIo {
+    stdout: (text: string) => void;
+    stderr: (text: string) => void;
+    setExitCode: (code: number) => void;
+}
+/** CLI I/O bound to the real process streams. */
+export declare const processIo: CliIo;
+/** Build the `adispatch` command tree. */
+export declare function createProgram(handlers?: CliHandlers, io?: CliIo): Command;
+export {};