patchwork-os 0.2.0-alpha.26 → 0.2.0-alpha.27

package/dist/commands/recipeInstall.js

@@ -0,0 +1,339 @@
+/**
+ * patchwork recipe install — download and install a recipe package.
+ * patchwork recipe list   — list installed recipe packages.
+ *
+ * Supports:
+ *   github:owner/repo
+ *   github:owner/repo/subdir
+ *   https://github.com/owner/repo
+ *   ./local/path
+ */
+import { cpSync, existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync, } from "node:fs";
+import https from "node:https";
+import os from "node:os";
+import path from "node:path";
+import { getManifestRecipeFiles, loadManifestFromDir, parseManifest, } from "../recipes/manifest.js";
+export const INSTALL_RECIPES_DIR = path.join(os.homedir(), ".patchwork", "recipes");
+/**
+ * Parse a user-supplied source string into a typed InstallSource.
+ *
+ * Supported forms:
+ *   github:owner/repo
+ *   github:owner/repo/subdir
+ *   https://github.com/owner/repo
+ *   https://github.com/owner/repo/tree/branch/subdir
+ *   ./relative/path
+ *   /absolute/path
+ */
+export function parseInstallSource(source) {
+    // Local path: starts with . or /
+    if (source.startsWith("./") ||
+        source.startsWith("/") ||
+        source.startsWith("../")) {
+        return { type: "local", path: source };
+    }
+    // github: prefix
+    if (source.startsWith("github:")) {
+        return parseGithubShorthand(source.slice("github:".length));
+    }
+    // Full GitHub URL
+    const githubUrlMatch = source.match(/^https?:\/\/github\.com\/([^/]+)\/([^/]+)(?:\/tree\/[^/]+\/(.+))?(?:\.git)?$/);
+    if (githubUrlMatch) {
+        const [, owner, repo, subdir] = githubUrlMatch;
+        if (!owner || !repo) {
+            throw new Error(`Invalid GitHub URL: ${source}`);
+        }
+        return {
+            type: "github",
+            owner,
+            repo: repo.replace(/\.git$/, ""),
+            ...(subdir ? { subdir } : {}),
+        };
+    }
+    throw new Error(`Unrecognized install source: "${source}"\n` +
+        `Supported: github:owner/repo, github:owner/repo/subdir, https://github.com/owner/repo, ./local/path`);
+}
+function parseGithubShorthand(shorthand) {
+    // owner/repo or owner/repo/subdir (may have multiple path segments)
+    const parts = shorthand.split("/");
+    if (parts.length < 2) {
+        throw new Error(`Invalid github shorthand "${shorthand}": expected "owner/repo" or "owner/repo/subdir"`);
+    }
+    const [owner, repo, ...subdirParts] = parts;
+    if (!owner || !repo) {
+        throw new Error(`Invalid github shorthand: "${shorthand}"`);
+    }
+    return {
+        type: "github",
+        owner,
+        repo,
+        ...(subdirParts.length > 0 ? { subdir: subdirParts.join("/") } : {}),
+    };
+}
+// ============================================================================
+// Install name determination
+// ============================================================================
+/**
+ * Determine the install directory name from the manifest or source.
+ * - Manifest present: strip leading @ and replace / with -- for filesystem safety.
+ * - GitHub source (no manifest): "owner/repo" or "owner/repo/subdir".
+ * - Local source (no manifest): basename of the directory.
+ */
+export function determineInstallName(manifest, source) {
+    if (manifest) {
+        // Strip leading @ and replace "/" with "--" so it's a valid directory name
+        return manifest.name.replace(/^@/, "").replace(/\//g, "--");
+    }
+    if (source.type === "github") {
+        const base = `${source.owner}/${source.repo}`;
+        return source.subdir ? `${base}/${source.subdir}` : base;
+    }
+    return path.basename(path.resolve(source.path));
+}
+// ============================================================================
+// GitHub file fetching via API
+// ============================================================================
+async function httpsGet(url) {
+    return new Promise((resolve, reject) => {
+        const req = https.get(url, {
+            headers: {
+                "User-Agent": "patchwork-recipe-installer/1.0",
+                Accept: "application/vnd.github.v3+json",
+            },
+        }, (res) => {
+            // Follow redirects
+            if (res.statusCode &&
+                res.statusCode >= 300 &&
+                res.statusCode < 400 &&
+                res.headers.location) {
+                httpsGet(res.headers.location).then(resolve).catch(reject);
+                return;
+            }
+            if (res.statusCode && res.statusCode >= 400) {
+                reject(new Error(`HTTP ${res.statusCode} fetching ${url}`));
+                return;
+            }
+            const chunks = [];
+            res.on("data", (chunk) => chunks.push(chunk));
+            res.on("end", () => resolve(Buffer.concat(chunks)));
+            res.on("error", reject);
+        });
+        req.on("error", reject);
+        req.end();
+    });
+}
+async function listGitHubContents(owner, repo, dirPath, ref) {
+    const url = `https://api.github.com/repos/${owner}/${repo}/contents/${dirPath}?ref=${ref}`;
+    const body = await httpsGet(url);
+    const parsed = JSON.parse(body.toString("utf-8"));
+    if (!Array.isArray(parsed)) {
+        throw new Error(`Expected array from GitHub contents API, got: ${typeof parsed}`);
+    }
+    return parsed;
+}
+async function fetchGitHubFile(downloadUrl) {
+    return httpsGet(downloadUrl);
+}
+/**
+ * Download all .yaml/.yml files (and recipe.json if present) from a GitHub
+ * directory into `destDir`. Returns list of filenames written.
+ */
+async function downloadGitHubDir(owner, repo, dirPath, ref, destDir) {
+    const items = await listGitHubContents(owner, repo, dirPath, ref);
+    const written = [];
+    for (const item of items) {
+        if (item.type !== "file")
+            continue;
+        if (item.name !== "recipe.json" && !/\.ya?ml$/i.test(item.name)) {
+            continue;
+        }
+        if (!item.download_url)
+            continue;
+        const content = await fetchGitHubFile(item.download_url);
+        const destPath = path.join(destDir, item.name);
+        writeFileSync(destPath, content);
+        written.push(item.name);
+    }
+    return written;
+}
+/**
+ * Install a recipe package from a source into INSTALL_RECIPES_DIR.
+ * Returns metadata about what was installed.
+ */
+export async function runRecipeInstall(rawSource, options = {}) {
+    const source = parseInstallSource(rawSource);
+    const recipesDir = options.recipesDir ?? INSTALL_RECIPES_DIR;
+    // Stage into temp dir first
+    const tmpDir = mkdtempSync(path.join(os.tmpdir(), "patchwork-recipe-"));
+    try {
+        if (source.type === "local") {
+            await stageLocalSource(source, tmpDir);
+        }
+        else {
+            await stageGitHubSource(source, tmpDir);
+        }
+        // Read manifest if present
+        let manifest = null;
+        const manifestPath = path.join(tmpDir, "recipe.json");
+        if (existsSync(manifestPath)) {
+            manifest = parseManifest(readFileSync(manifestPath, "utf-8"));
+        }
+        // Determine which files to copy
+        let filesToCopy;
+        if (manifest) {
+            const declared = getManifestRecipeFiles(manifest);
+            // Include recipe.json + declared recipe files (that exist in tmpDir)
+            filesToCopy = ["recipe.json", ...declared].filter((f) => existsSync(path.join(tmpDir, f)));
+        }
+        else {
+            // No manifest: take all .yaml/.yml files
+            filesToCopy = readdirSync(tmpDir).filter((f) => /\.ya?ml$/i.test(f));
+        }
+        if (filesToCopy.length === 0) {
+            throw new Error(`No recipe files found in source "${rawSource}". ` +
+                `Expected .yaml/.yml files or a recipe.json manifest.`);
+        }
+        const installName = determineInstallName(manifest, source);
+        const installDir = path.join(recipesDir, installName);
+        if (!existsSync(installDir)) {
+            mkdirSync(installDir, { recursive: true });
+        }
+        // Copy files
+        for (const file of filesToCopy) {
+            const src = path.join(tmpDir, file);
+            const dest = path.join(installDir, file);
+            // Ensure subdirs exist (recipe.json could declare children in subdirs)
+            const destParent = path.dirname(dest);
+            if (!existsSync(destParent)) {
+                mkdirSync(destParent, { recursive: true });
+            }
+            cpSync(src, dest);
+        }
+        return {
+            name: installName,
+            version: manifest?.version,
+            installDir,
+            filesInstalled: filesToCopy,
+            manifest,
+        };
+    }
+    finally {
+        try {
+            rmSync(tmpDir, { recursive: true, force: true });
+        }
+        catch {
+            // best-effort cleanup
+        }
+    }
+}
+async function stageLocalSource(source, tmpDir) {
+    const resolvedPath = path.resolve(source.path);
+    if (!existsSync(resolvedPath)) {
+        throw new Error(`Local path does not exist: ${resolvedPath}`);
+    }
+    if (!statSync(resolvedPath).isDirectory()) {
+        throw new Error(`Local path is not a directory: ${resolvedPath}`);
+    }
+    cpSync(resolvedPath, tmpDir, { recursive: true });
+}
+async function stageGitHubSource(source, tmpDir) {
+    const ref = source.ref ?? "main";
+    const dirPath = source.subdir ?? "";
+    try {
+        await downloadGitHubDir(source.owner, source.repo, dirPath, ref, tmpDir);
+    }
+    catch (err) {
+        // If main branch fails, try master
+        if (ref === "main") {
+            try {
+                await downloadGitHubDir(source.owner, source.repo, dirPath, "master", tmpDir);
+                return;
+            }
+            catch {
+                // fall through to original error
+            }
+        }
+        throw err;
+    }
+}
+export function listInstalledRecipes(options = {}) {
+    const recipesDir = options.recipesDir ?? INSTALL_RECIPES_DIR;
+    if (!existsSync(recipesDir)) {
+        return [];
+    }
+    const entries = [];
+    function scanDir(dir, namePrefix) {
+        const items = readdirSync(dir);
+        for (const item of items) {
+            const itemPath = path.join(dir, item);
+            if (!statSync(itemPath).isDirectory())
+                continue;
+            const entryName = namePrefix ? `${namePrefix}/${item}` : item;
+            const manifest = loadManifestFromDir(itemPath);
+            if (manifest) {
+                entries.push({
+                    name: entryName,
+                    version: manifest.version,
+                    description: manifest.description,
+                    connectors: manifest.connectors,
+                    mainRecipe: manifest.recipes.main,
+                    hasManifest: true,
+                });
+            }
+            else {
+                const yamlFiles = readdirSync(itemPath).filter((f) => /\.ya?ml$/i.test(f));
+                if (yamlFiles.length > 0) {
+                    entries.push({
+                        name: entryName,
+                        yamlFiles,
+                        hasManifest: false,
+                    });
+                }
+                else {
+                    // Recurse one level for namespaced dirs like "owner/repo"
+                    if (!namePrefix) {
+                        scanDir(itemPath, item);
+                    }
+                }
+            }
+        }
+    }
+    scanDir(recipesDir, "");
+    return entries.sort((a, b) => a.name.localeCompare(b.name));
+}
+// ============================================================================
+// CLI output helpers
+// ============================================================================
+export function printInstallResult(result) {
+    const versionStr = result.version ? `@${result.version}` : "";
+    console.log(`✓ Installed ${result.name}${versionStr} to ${result.installDir}`);
+    if (result.manifest?.connectors && result.manifest.connectors.length > 0) {
+        console.log(`  Requires connectors: ${result.manifest.connectors.join(", ")}`);
+    }
+    const mainRecipe = result.manifest?.recipes.main ?? result.filesInstalled[0];
+    if (mainRecipe) {
+        console.log(`  Run with: patchwork recipe run ${path.join(result.installDir, mainRecipe)}`);
+    }
+}
+export function printInstalledList(entries) {
+    if (entries.length === 0) {
+        console.log("No recipes installed. Use `patchwork recipe install <source>` to install.");
+        return;
+    }
+    const maxName = Math.max(...entries.map((e) => e.name.length), 4);
+    const maxVersion = Math.max(...entries.map((e) => (e.version ?? "—").length), 7);
+    const header = `${"Name".padEnd(maxName)}  ${"Version".padEnd(maxVersion)}  Description / Files`;
+    console.log(header);
+    console.log("-".repeat(Math.min(header.length, 100)));
+    for (const entry of entries) {
+        const version = (entry.version ?? "—").padEnd(maxVersion);
+        const detail = entry.hasManifest
+            ? (entry.description ?? "")
+            : `[${(entry.yamlFiles ?? []).join(", ")}]`;
+        console.log(`${entry.name.padEnd(maxName)}  ${version}  ${detail}`);
+        if (entry.connectors && entry.connectors.length > 0) {
+            console.log(`${"".padEnd(maxName)}  ${"".padEnd(maxVersion)}  connectors: ${entry.connectors.join(", ")}`);
+        }
+    }
+}
+//# sourceMappingURL=recipeInstall.js.map

package/dist/commands/recipeInstall.js.map

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

package/dist/connectors/datadog.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Datadog connector — query metrics, monitors, alerts, and incidents.
+ *
+ * Auth: API key + Application key.
+ *   - Env vars: DATADOG_API_KEY, DATADOG_APP_KEY, DATADOG_SITE (optional)
+ *   - Stored: getSecretJsonSync("datadog") → DatadogTokens
+ *   - Headers: DD-API-KEY + DD-APPLICATION-KEY
+ *
+ * Tools: queryMetrics, listMonitors, getMonitor, listActiveAlerts, muteMonitor, listIncidents
+ *
+ * Extends BaseConnector for unified auth, retry, rate-limit, error handling.
+ */
+import { type AuthContext, BaseConnector, type ConnectorError, type ConnectorStatus } from "./baseConnector.js";
+export interface DatadogTokens {
+    apiKey: string;
+    appKey: string;
+    site?: string;
+    orgName?: string;
+    connected_at: string;
+}
+export interface DatadogSeries {
+    metric: string;
+    display_name: string;
+    unit: Array<{
+        family: string;
+        name: string;
+        short_name: string;
+    }> | null;
+    pointlist: Array<[number, number | null]>;
+    start: number;
+    end: number;
+    interval: number;
+    length: number;
+    aggr: string | null;
+    scope: string;
+}
+export interface DatadogMonitor {
+    id: number;
+    name: string;
+    type: string;
+    query: string;
+    message: string;
+    status: string;
+    state: string;
+    tags: string[];
+    created: string;
+    modified: string;
+    overall_state: string;
+}
+export interface DatadogIncident {
+    id: string;
+    type: string;
+    attributes: {
+        title: string;
+        status: string;
+        severity: string;
+        created: string;
+        modified: string;
+        customer_impact_scope?: string;
+        customer_impacted: boolean;
+    };
+}
+export declare class DatadogConnector extends BaseConnector {
+    readonly providerName = "datadog";
+    private tokens;
+    protected getOAuthConfig(): null;
+    authenticate(): Promise<AuthContext>;
+    healthCheck(): Promise<{
+        ok: boolean;
+        error?: ConnectorError;
+    }>;
+    normalizeError(error: unknown): ConnectorError;
+    getStatus(): ConnectorStatus;
+    queryMetrics(query: string, from: number, to: number): Promise<{
+        series: DatadogSeries[];
+    }>;
+    listMonitors(params?: {
+        groupStates?: string[];
+        tags?: string[];
+        perPage?: number;
+    }): Promise<DatadogMonitor[]>;
+    getMonitor(monitorId: number): Promise<DatadogMonitor>;
+    listActiveAlerts(params?: {
+        priority?: number;
+    }): Promise<DatadogMonitor[]>;
+    muteMonitor(monitorId: number, end?: number): Promise<DatadogMonitor>;
+    listIncidents(params?: {
+        perPage?: number;
+    }): Promise<{
+        data: DatadogIncident[];
+    }>;
+    private baseUrl;
+    private buildHeaders;
+}
+export declare function loadTokens(): DatadogTokens | null;
+export declare function saveTokens(tokens: DatadogTokens): void;
+export declare function clearTokens(): void;
+export declare function getDatadogConnector(): DatadogConnector;
+export { getDatadogConnector as datadog };
+export interface ConnectorHandlerResult {
+    status: number;
+    body: string;
+    contentType?: string;
+}
+/**
+ * POST /connections/datadog/connect  { apiKey, appKey, site? }
+ */
+export declare function handleDatadogConnect(body: string): Promise<ConnectorHandlerResult>;
+/**
+ * POST /connections/datadog/test
+ */
+export declare function handleDatadogTest(): Promise<ConnectorHandlerResult>;
+/**
+ * DELETE /connections/datadog
+ */
+export declare function handleDatadogDisconnect(): ConnectorHandlerResult;