@ozzylabs/feedradar 0.1.9 → 0.2.1

package/dist/cli/routine/fire.js

@@ -0,0 +1,196 @@
+/**
+ * `radar routine fire <trig_id>` — trigger a Claude Routine from the outside
+ * via the `/fire` API (ADR-0020 §「外部からの起動」; epic #277 / #282).
+ *
+ * The `/fire` endpoint creates a routine session and returns immediately — it
+ * does NOT wait for the session to finish. The optional `--text` body is a
+ * free-form string passed to the session as launch context; the API does not
+ * parse it. Each routine has its own per-routine bearer token, issued ONCE in
+ * the Web UI (shown a single time; Regenerate / Revoke from there). The token
+ * is read from the environment and is NEVER printed to logs.
+ */
+/**
+ * Base URL of the Anthropic API. Exposed as a constant (not hardcoded inline)
+ * so the fire URL stays in one place and tests can assert against it.
+ */
+export const ANTHROPIC_API_BASE = "https://api.anthropic.com";
+/** Beta header gating the experimental Claude Code routines surface. */
+export const ROUTINE_FIRE_BETA = "experimental-cc-routine-2026-04-01";
+/** Anthropic API version pin (stable date-versioned API). */
+export const ANTHROPIC_VERSION = "2023-06-01";
+/** Default env var holding the per-routine `/fire` bearer token. */
+export const DEFAULT_FIRE_TOKEN_ENV = "FEEDRADAR_ROUTINE_FIRE_TOKEN";
+/**
+ * Routine ids issued by the Web UI carry a `trig_` prefix. We validate the
+ * shape before composing the URL so a typo'd id fails fast with a clear
+ * message instead of a 404 from the server.
+ */
+export function isValidRoutineId(id) {
+    return /^trig_[A-Za-z0-9._-]+$/.test(id);
+}
+/**
+ * POST to `/v1/claude_code/routines/{trig_id}/fire`.
+ *
+ * The endpoint returns as soon as the session is created (it does not wait for
+ * completion). On a non-2xx status this throws with the status text; the token
+ * is never included in any error or log.
+ */
+export async function fireRoutine(options) {
+    const { routineId, token, text } = options;
+    const apiBase = options.apiBase ?? ANTHROPIC_API_BASE;
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    if (!isValidRoutineId(routineId)) {
+        throw new Error(`invalid routine id '${routineId}' (expected a Web UI id starting with 'trig_')`);
+    }
+    if (token.trim().length === 0) {
+        throw new Error("missing per-routine fire token");
+    }
+    const url = `${apiBase}/v1/claude_code/routines/${routineId}/fire`;
+    const headers = {
+        authorization: `Bearer ${token}`,
+        "anthropic-version": ANTHROPIC_VERSION,
+        "anthropic-beta": ROUTINE_FIRE_BETA,
+        "content-type": "application/json",
+    };
+    // The `text` body is free-form launch context; the API does not parse it.
+    // Always send a JSON object so the content-type matches even when empty.
+    const body = JSON.stringify(text === undefined ? {} : { text });
+    const response = await fetchImpl(url, { method: "POST", headers, body });
+    // Read the body once regardless of status so error and success paths share
+    // the same parse and we can surface server detail without leaking the token.
+    let parsed;
+    try {
+        parsed = await response.json();
+    }
+    catch {
+        parsed = await response.text().catch(() => "");
+    }
+    if (!response.ok) {
+        const detail = typeof parsed === "string" && parsed.length > 0
+            ? `: ${parsed}`
+            : parsed && typeof parsed === "object"
+                ? `: ${JSON.stringify(parsed)}`
+                : "";
+        throw new Error(`fire failed (HTTP ${response.status} ${response.statusText})${detail}`);
+    }
+    return { status: response.status, body: parsed };
+}
+/**
+ * Parse `routine fire <trig_id> [--text <msg>] [--token-env <NAME>]`.
+ *
+ * The routine id is a positional argument (the first non-flag token). A
+ * `--token-env` override lets a user point at a differently-named env var when
+ * juggling multiple routines, but the value is ALWAYS read from the
+ * environment — never accepted as a CLI flag (which would leak into process
+ * listings / shell history).
+ */
+export function parseFireRoutineArgs(args) {
+    let routineId;
+    let text;
+    let tokenEnv = DEFAULT_FIRE_TOKEN_ENV;
+    let help = false;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "-h" || a === "--help") {
+            help = true;
+            continue;
+        }
+        if (a === "--text") {
+            const value = args[++i];
+            if (value === undefined)
+                throw new Error(`option ${a} requires a value`);
+            text = value;
+            continue;
+        }
+        if (a === "--token-env") {
+            const value = args[++i];
+            if (value === undefined)
+                throw new Error(`option ${a} requires a value`);
+            tokenEnv = value;
+            continue;
+        }
+        if (a === "--token") {
+            // Refuse a token on the command line: it would leak into `ps` output and
+            // shell history. Direct the user to the env-var path instead.
+            throw new Error("refusing --token on the command line (it leaks via process listing / shell history); " +
+                `set the token in the ${DEFAULT_FIRE_TOKEN_ENV} env var (or use --token-env <NAME>)`);
+        }
+        if (a?.startsWith("-")) {
+            throw new Error(`unknown option: ${a}`);
+        }
+        if (routineId !== undefined) {
+            throw new Error(`unexpected positional argument: ${a}`);
+        }
+        routineId = a;
+    }
+    return { routineId, text, tokenEnv, help };
+}
+export function printFireRoutineHelp(log) {
+    log("Usage: radar routine fire <trig_id> [options]");
+    log("");
+    log("Triggers a registered Claude Code Routine from the outside via the");
+    log("/fire API (ADR-0020). The call returns as soon as the routine session");
+    log("is created — it does NOT wait for the session to finish.");
+    log("");
+    log("Arguments:");
+    log("  <trig_id>             Routine id from the Web UI (starts with 'trig_')");
+    log("");
+    log("Options:");
+    log("  --text <msg>          Free-form launch context (request body `text`).");
+    log("                        The API does not parse it; it is passed as-is.");
+    log(`  --token-env <NAME>    Env var holding the per-routine bearer token`);
+    log(`                        (default: ${DEFAULT_FIRE_TOKEN_ENV}).`);
+    log("");
+    log("The per-routine token is issued ONCE in the Web UI (Regenerate / Revoke");
+    log("there) and is read from the environment — it is never accepted as a flag");
+    log("and never printed.");
+}
+/**
+ * Entry point invoked by `runRoutine` when the user types
+ * `radar routine fire`. Reads the token from the environment (never a flag,
+ * never logged) and POSTs to `/fire`.
+ */
+export async function runFireRoutine(args, io = {}, env = process.env, fetchImpl) {
+    const log = io.log ?? ((m) => console.log(m));
+    const error = io.error ?? ((m) => console.error(m));
+    let parsed;
+    try {
+        parsed = parseFireRoutineArgs(args);
+    }
+    catch (e) {
+        error(`routine fire: ${e instanceof Error ? e.message : String(e)}`);
+        return 2;
+    }
+    if (parsed.help) {
+        printFireRoutineHelp(log);
+        return 0;
+    }
+    if (!parsed.routineId) {
+        error("routine fire: missing <trig_id> argument (the routine id from the Web UI)");
+        printFireRoutineHelp(error);
+        return 2;
+    }
+    const token = env[parsed.tokenEnv];
+    if (!token || token.trim().length === 0) {
+        error(`routine fire: no token in ${parsed.tokenEnv}. ` +
+            `Issue a per-routine token in the Web UI and export it, e.g. ` +
+            `export ${parsed.tokenEnv}='...'`);
+        return 2;
+    }
+    try {
+        const result = await fireRoutine({
+            routineId: parsed.routineId,
+            token,
+            text: parsed.text,
+            fetch: fetchImpl,
+        });
+        log(`routine fire: triggered ${parsed.routineId} (HTTP ${result.status}).`);
+        log("The session was created — this call does not wait for it to finish.");
+        return 0;
+    }
+    catch (e) {
+        error(`routine fire: ${e instanceof Error ? e.message : String(e)}`);
+        return 1;
+    }
+}
+//# sourceMappingURL=fire.js.map

package/dist/cli/routine/fire.js.map

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

package/dist/cli/routine/generate-pipeline.d.ts

@@ -0,0 +1,162 @@
+import { type RoutineIO, type SupportedModel } from "./generate-watch.js";
+/**
+ * `radar routine generate pipeline` (ADR-0020 D5 `pipeline`).
+ *
+ * Emits a Claude Routine YAML whose single session runs the FULL FeedRadar
+ * pipeline in sequence — `radar watch run` -> triage -> research -> review —
+ * processing items ONE AT A TIME via the self-session `--emit-payload` /
+ * `--commit` entrypoints (NOT `--batch`; ADR-0020 D2). The blast radius is
+ * bounded by CLI flags (`--max-items` / `--limit`), not the prompt's
+ * discretion (D3e), so a `--max-items` flag is the only structural addition
+ * over the `watch` generator.
+ *
+ * The cron / output-path / repository validators and the model roster are
+ * shared with `generate-watch.ts` rather than re-declared: routines enforce
+ * the identical 1-hour-minimum cron and `.claude/routines/*.yaml` output
+ * gate regardless of `<type>`, so a single source keeps the two in lockstep.
+ */
+/**
+ * Default for `--max-items`: how many items one run may triage / research /
+ * review. Kept small so the routine's per-run blast radius stays bounded by a
+ * deterministic CLI cap (ADR-0020 D3e) rather than the prompt's discretion.
+ * Mirrors the conservative default of the GHA `combined-with-triage` cap.
+ */
+export declare const PIPELINE_DEFAULT_MAX_ITEMS = 10;
+/**
+ * Landing / output modes for the pipeline routine's step-6 commit (#301).
+ *
+ * Symmetric with the GHA `combined-with-triage --output-mode pr|direct-commit`
+ * (#258), but the names differ because the mechanics differ:
+ *
+ * - `pr` (default): open a `claude/pipeline/...` branch + PR and STOP. A human
+ *   reviews and merges. This is the ADR-0020 D3a safe default — no unreviewed
+ *   routine output reaches the default branch.
+ * - `auto-merge`: open the same `claude/pipeline/...` PR, then immediately
+ *   `gh pr merge --squash` it so the output lands on `main`. Distinct from the
+ *   GHA `direct-commit` (which pushes to main with NO PR at all); here a PR is
+ *   always created first. Opt-in because the step-5 self-review makes the PR
+ *   review-complete (ADR-0020 D3a opt-in auto-merge).
+ *
+ * NB: `--auto` (vs immediate `--squash`) is intentionally NOT used — on a repo
+ * with no required checks `gh pr merge --auto` never merges, so the routine
+ * uses an immediate squash merge instead (#301).
+ */
+export declare const OUTPUT_MODES: readonly ["pr", "auto-merge"];
+export type OutputMode = (typeof OUTPUT_MODES)[number];
+/**
+ * Build the instructions step-6 commit/landing block for the given output mode.
+ *
+ * - `pr`: open a `claude/pipeline/...` branch + PR and stop (the current,
+ *   pre-#301 behavior).
+ * - `auto-merge`: the same branch + PR, then `git switch main` and
+ *   `gh pr merge "${BRANCH}" --squash --delete-branch` so the output lands on
+ *   `main`. Switching to `main` before `--delete-branch` keeps the merge
+ *   robust; the merge is fail-soft (`|| true`) so a transient failure leaves
+ *   the PR open rather than aborting the routine.
+ *
+ * Emitted with the same 5-space body indentation as the surrounding numbered
+ * step (the placeholder sits where the step body starts). Exported for unit
+ * testing (mirrors the GHA generator's `buildFinalStep`).
+ */
+export declare function buildPipelineLandingStep(mode: OutputMode): string;
+/**
+ * Build the hard-constraints output-gate bullet for the given output mode.
+ *
+ * - `pr`: the current "do NOT push to main; claude/* branch + PR only"
+ *   constraint (ADR-0020 D3a, no auto-merge).
+ * - `auto-merge`: flips the constraint to say auto-merge is intentional — the
+ *   routine opens a `claude/pipeline/...` PR then squash-merges it, and the
+ *   step-5 review is what makes the PR review-complete (ADR-0020 D3a opt-in
+ *   auto-merge).
+ *
+ * Exported for unit testing (mirrors the GHA generator's exported builders).
+ */
+export declare function buildOutputGateConstraint(mode: OutputMode): string;
+/**
+ * Build the `notes:` output-gate sentence for the given output mode. Mirrors
+ * `buildOutputGateConstraint` but phrased for the ops `notes` block.
+ */
+export declare function buildOutputGateNote(mode: OutputMode): string;
+/**
+ * Render the bundled `pipeline.yaml.tmpl` by substituting the `{{name}}` /
+ * `{{repository}}` / `{{cron}}` / `{{timezone}}` / `{{model}}` / `{{maxItems}}`
+ * placeholders.
+ *
+ * Literal `replace` (not a templating engine): the placeholders are simple
+ * tokens and we must not expand any other `{{...}}`-looking text in the body.
+ * Exported for unit testing in isolation.
+ */
+export declare function renderPipelineRoutineTemplate(template: string, values: {
+    name: string;
+    repository: string;
+    cron: string;
+    timezone: string;
+    model: string;
+    maxItems: number;
+    networkAccessBlock: string;
+    landingStep: string;
+    outputGateConstraint: string;
+    outputGateNote: string;
+    allowUnrestrictedGitPush: boolean;
+}): string;
+export interface GeneratePipelineRoutineOptions {
+    cwd: string;
+    name: string;
+    repository: string;
+    cron: string;
+    timezone: string;
+    model: SupportedModel;
+    maxItems: number;
+    /** Landing mode for the step-6 commit (#301). Defaults to `pr`. */
+    outputMode: OutputMode;
+    output: string;
+    force: boolean;
+    /** Test seam: override the templates root location. */
+    templatesRoot?: string;
+    io?: RoutineIO;
+}
+export interface GeneratePipelineRoutineResult {
+    /** Relative path (from `cwd`) of the file that was written. */
+    outputPath: string;
+}
+/**
+ * Core implementation of `radar routine generate pipeline` (ADR-0020 D5
+ * `pipeline`).
+ *
+ * Validates the cron (5-field + 1-hour-minimum), output path, repository, and
+ * `--max-items` (>= 1), renders the bundled `pipeline.yaml.tmpl`, and writes it
+ * under `.claude/routines/`. The completion stdout tells the user how to paste
+ * the multi-line fields into the Web UI (yq extraction) and how to apply the
+ * schedule via `/schedule`, since Routines has no declarative apply API
+ * (ADR-0020 D1).
+ */
+export declare function generatePipelineRoutine(options: GeneratePipelineRoutineOptions): Promise<GeneratePipelineRoutineResult>;
+interface ParsedFlags {
+    name: string;
+    repository: string;
+    cron: string;
+    timezone: string;
+    model: SupportedModel;
+    maxItems: number;
+    outputMode: OutputMode;
+    output: string;
+    force: boolean;
+    help: boolean;
+}
+/**
+ * Parse `routine generate pipeline` flags.
+ *
+ * `--output` defaults to `.claude/routines/<name>.yaml`, so it is resolved
+ * AFTER the loop once `--name` is known (a `--output` flag, if given, wins).
+ */
+export declare function parseGeneratePipelineRoutineArgs(args: string[]): ParsedFlags;
+export declare function printGeneratePipelineRoutineHelp(log: (m: string) => void): void;
+/**
+ * Entry point invoked by `runRoutine` (in `src/cli/routine.ts`) when the user
+ * types `radar routine generate pipeline`. Translates parsed flags into
+ * `generatePipelineRoutine` arguments and surfaces validation errors with the
+ * `routine generate pipeline:` prefix to match the rest of the CLI.
+ */
+export declare function runGeneratePipelineRoutine(args: string[], io?: RoutineIO, cwd?: string): Promise<number>;
+export {};
+//# sourceMappingURL=generate-pipeline.d.ts.map

package/dist/cli/routine/generate-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-pipeline.d.ts","sourceRoot":"","sources":["../../../src/cli/routine/generate-pipeline.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,SAAS,EAGd,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;GAeG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,YAAY,+BAAgC,CAAC;AAC1D,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA6CjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAYlE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAc5D;AAyBD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB,EAAE,OAAO,CAAC;CACnC,GACA,MAAM,CAaR;AAED,MAAM,WAAW,8BAA8B;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,EAAE,CAAC,EAAE,SAAS,CAAC;CAChB;AAED,MAAM,WAAW,6BAA6B;IAC5C,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,6BAA6B,CAAC,CAuHxC;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CAsG5E;AAED,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CA4B/E;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,GAAE,SAAc,EAClB,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAmCjB"}