@synth-deploy/server 0.1.0

package/dist/api/telemetry.js

@@ -0,0 +1,24 @@
+import { TelemetryQuerySchema } from "./schemas.js";
+import { requirePermission } from "../middleware/permissions.js";
+export function registerTelemetryRoutes(app, telemetryStore) {
+    app.get("/api/telemetry", { preHandler: [requirePermission("settings.manage")] }, async (request) => {
+        const parsed = TelemetryQuerySchema.safeParse(request.query);
+        const filters = parsed.success ? parsed.data : {};
+        const events = telemetryStore.query({
+            actor: filters.actor,
+            action: filters.action,
+            from: filters.from ? new Date(filters.from) : undefined,
+            to: filters.to ? new Date(filters.to) : undefined,
+            limit: filters.limit ?? 50,
+            offset: filters.offset ?? 0,
+        });
+        const total = telemetryStore.count({
+            actor: filters.actor,
+            action: filters.action,
+            from: filters.from ? new Date(filters.from) : undefined,
+            to: filters.to ? new Date(filters.to) : undefined,
+        });
+        return { events, total };
+    });
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/api/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/api/telemetry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,UAAU,uBAAuB,CACrC,GAAoB,EACpB,cAA+B;IAE/B,GAAG,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,UAAU,EAAE,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAClG,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAElD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC;YAClC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAqC;YACrD,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;YACvD,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;YACjD,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC;SAC5B,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC;YACjC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAqC;YACrD,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;YACvD,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;SAClD,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/api/users.d.ts

@@ -0,0 +1,4 @@
+import type { FastifyInstance } from "fastify";
+import type { IUserStore, IRoleStore, IUserRoleStore } from "@synth-deploy/core";
+export declare function registerUserRoutes(app: FastifyInstance, userStore: IUserStore, roleStore: IRoleStore, userRoleStore: IUserRoleStore): void;
+//# sourceMappingURL=users.d.ts.map

package/dist/api/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/api/users.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAA0C,MAAM,oBAAoB,CAAC;AAqBzH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,eAAe,EACpB,SAAS,EAAE,UAAU,EACrB,SAAS,EAAE,UAAU,EACrB,aAAa,EAAE,cAAc,GAC5B,IAAI,CAoLN"}

package/dist/api/users.js

@@ -0,0 +1,173 @@
+import crypto from "node:crypto";
+import bcrypt from "bcryptjs";
+import { requirePermission } from "../middleware/permissions.js";
+import { CreateUserSchema, UpdateUserSchema, AssignRolesSchema, CreateRoleSchema, UpdateRoleSchema, } from "./schemas.js";
+function toPublicUser(user) {
+    return {
+        id: user.id,
+        email: user.email,
+        name: user.name,
+        authSource: user.authSource ?? "local",
+        createdAt: user.createdAt,
+        updatedAt: user.updatedAt,
+    };
+}
+export function registerUserRoutes(app, userStore, roleStore, userRoleStore) {
+    // --- GET /api/users ---
+    app.get("/api/users", { preHandler: [requirePermission("users.manage")] }, async () => {
+        const users = userStore.list();
+        return { users: users.map(toPublicUser) };
+    });
+    // --- POST /api/users ---
+    app.post("/api/users", { preHandler: [requirePermission("users.manage")] }, async (request, reply) => {
+        const parsed = CreateUserSchema.safeParse(request.body);
+        if (!parsed.success) {
+            return reply.status(400).send({ error: "Validation failed", details: parsed.error.flatten() });
+        }
+        const { email, name, password } = parsed.data;
+        const existing = userStore.getByEmail(email);
+        if (existing) {
+            return reply.status(409).send({ error: "Email already in use" });
+        }
+        const passwordHash = await bcrypt.hash(password, 10);
+        const userId = crypto.randomUUID();
+        const now = new Date();
+        const user = userStore.create({
+            id: userId,
+            email,
+            name,
+            passwordHash,
+            createdAt: now,
+            updatedAt: now,
+        });
+        return reply.status(201).send({ user: toPublicUser(user) });
+    });
+    // --- PUT /api/users/:id ---
+    app.put("/api/users/:id", { preHandler: [requirePermission("users.manage")] }, async (request, reply) => {
+        const parsed = UpdateUserSchema.safeParse(request.body);
+        if (!parsed.success) {
+            return reply.status(400).send({ error: "Validation failed", details: parsed.error.flatten() });
+        }
+        const userId = request.params.id;
+        const existing = userStore.getById(userId);
+        if (!existing) {
+            return reply.status(404).send({ error: "User not found" });
+        }
+        const updates = { updatedAt: new Date() };
+        if (parsed.data.email !== undefined)
+            updates.email = parsed.data.email;
+        if (parsed.data.name !== undefined)
+            updates.name = parsed.data.name;
+        if (parsed.data.password !== undefined) {
+            updates.passwordHash = await bcrypt.hash(parsed.data.password, 10);
+        }
+        const user = userStore.update(userId, updates);
+        return { user: toPublicUser(user) };
+    });
+    // --- DELETE /api/users/:id ---
+    app.delete("/api/users/:id", { preHandler: [requirePermission("users.manage")] }, async (request, reply) => {
+        const userId = request.params.id;
+        const existing = userStore.getById(userId);
+        if (!existing) {
+            return reply.status(404).send({ error: "User not found" });
+        }
+        userStore.delete(userId);
+        return reply.status(204).send();
+    });
+    // --- GET /api/users/:id/roles ---
+    app.get("/api/users/:id/roles", { preHandler: [requirePermission("users.manage")] }, async (request, reply) => {
+        const userId = request.params.id;
+        const existing = userStore.getById(userId);
+        if (!existing) {
+            return reply.status(404).send({ error: "User not found" });
+        }
+        const roles = userRoleStore.getUserRoles(userId);
+        return { roles };
+    });
+    // --- PUT /api/users/:id/roles ---
+    app.put("/api/users/:id/roles", { preHandler: [requirePermission("roles.manage")] }, async (request, reply) => {
+        const parsed = AssignRolesSchema.safeParse(request.body);
+        if (!parsed.success) {
+            return reply.status(400).send({ error: "Validation failed", details: parsed.error.flatten() });
+        }
+        const userId = request.params.id;
+        const existing = userStore.getById(userId);
+        if (!existing) {
+            return reply.status(404).send({ error: "User not found" });
+        }
+        const assignedBy = request.user.id;
+        const roleIds = parsed.data.roleIds;
+        // Validate all role IDs exist
+        for (const roleId of roleIds) {
+            const role = roleStore.getById(roleId);
+            if (!role) {
+                return reply.status(400).send({ error: `Role not found: ${roleId}` });
+            }
+        }
+        userRoleStore.setRoles(userId, roleIds, assignedBy);
+        const roles = userRoleStore.getUserRoles(userId);
+        return { roles };
+    });
+    // --- GET /api/roles ---
+    app.get("/api/roles", { preHandler: [requirePermission("users.manage")] }, async () => {
+        const roles = roleStore.list();
+        return { roles };
+    });
+    // --- POST /api/roles ---
+    app.post("/api/roles", { preHandler: [requirePermission("roles.manage")] }, async (request, reply) => {
+        const parsed = CreateRoleSchema.safeParse(request.body);
+        if (!parsed.success) {
+            return reply.status(400).send({ error: "Validation failed", details: parsed.error.flatten() });
+        }
+        const { name, permissions } = parsed.data;
+        const existing = roleStore.getByName(name);
+        if (existing) {
+            return reply.status(409).send({ error: "Role name already in use" });
+        }
+        const roleId = crypto.randomUUID();
+        const role = roleStore.create({
+            id: roleId,
+            name,
+            permissions: permissions,
+            isBuiltIn: false,
+            createdAt: new Date(),
+        });
+        return reply.status(201).send({ role });
+    });
+    // --- PUT /api/roles/:id ---
+    app.put("/api/roles/:id", { preHandler: [requirePermission("roles.manage")] }, async (request, reply) => {
+        const parsed = UpdateRoleSchema.safeParse(request.body);
+        if (!parsed.success) {
+            return reply.status(400).send({ error: "Validation failed", details: parsed.error.flatten() });
+        }
+        const roleId = request.params.id;
+        const existing = roleStore.getById(roleId);
+        if (!existing) {
+            return reply.status(404).send({ error: "Role not found" });
+        }
+        if (existing.isBuiltIn) {
+            return reply.status(403).send({ error: "Cannot modify built-in roles" });
+        }
+        const updates = {};
+        if (parsed.data.name !== undefined)
+            updates.name = parsed.data.name;
+        if (parsed.data.permissions !== undefined)
+            updates.permissions = parsed.data.permissions;
+        const role = roleStore.update(roleId, updates);
+        return { role };
+    });
+    // --- DELETE /api/roles/:id ---
+    app.delete("/api/roles/:id", { preHandler: [requirePermission("roles.manage")] }, async (request, reply) => {
+        const roleId = request.params.id;
+        const existing = roleStore.getById(roleId);
+        if (!existing) {
+            return reply.status(404).send({ error: "Role not found" });
+        }
+        if (existing.isBuiltIn) {
+            return reply.status(403).send({ error: "Cannot delete built-in roles" });
+        }
+        roleStore.delete(roleId);
+        return reply.status(204).send();
+    });
+}
+//# sourceMappingURL=users.js.map

package/dist/api/users.js.map

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

package/dist/archive-unpacker.d.ts

@@ -0,0 +1,24 @@
+export interface ExtractedFile {
+    path: string;
+    content: string;
+}
+export interface UnpackResult {
+    files: ExtractedFile[];
+    skipped: number;
+}
+export type ArchiveFormat = "zip" | "tar" | "tar-gz";
+/**
+ * Map artifact type string to archive format, if applicable.
+ * Returns null for non-archive types.
+ */
+export declare function archiveFormat(artifactType: string, artifactName: string): ArchiveFormat | null;
+/**
+ * Unpack an archive buffer and extract readable text files.
+ * Returns an empty result for unrecognized or corrupt archives.
+ */
+export declare function unpackArchive(buffer: Buffer, format: ArchiveFormat): Promise<UnpackResult>;
+/**
+ * Format extracted files as a text block suitable for inclusion in an LLM prompt.
+ */
+export declare function formatExtractedFiles(result: UnpackResult): string;
+//# sourceMappingURL=archive-unpacker.d.ts.map

package/dist/archive-unpacker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-unpacker.d.ts","sourceRoot":"","sources":["../src/archive-unpacker.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAmMD,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAErD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAe9F;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,YAAY,CAAC,CASvB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAcjE"}

package/dist/archive-unpacker.js

@@ -0,0 +1,239 @@
+import AdmZip from "adm-zip";
+import tarStream from "tar-stream";
+import zlib from "node:zlib";
+import { Readable } from "node:stream";
+// ---------------------------------------------------------------------------
+// Text file detection
+// ---------------------------------------------------------------------------
+const TEXT_EXTENSIONS = new Set([
+    // Docs / context
+    ".md", ".txt", ".rst", ".adoc",
+    // Config / manifests
+    ".yaml", ".yml", ".json", ".toml", ".ini", ".conf", ".config",
+    ".properties", ".env", ".envrc",
+    // Infrastructure / IaC
+    ".tf", ".tfvars", ".hcl", ".bicep",
+    // Build / packaging
+    ".xml", ".gradle", ".gradle.kts", ".nuspec", ".pom",
+    ".csproj", ".fsproj", ".vbproj", ".sln",
+    ".gemspec", ".podspec", ".lock",
+    // Scripts
+    ".sh", ".bash", ".zsh", ".fish",
+    ".ps1", ".psm1", ".psd1", ".cmd", ".bat",
+    // Source (for deploy scripts, Lambdas, etc.)
+    ".py", ".rb", ".js", ".ts", ".go", ".rs", ".java", ".cs",
+    // Web / templates
+    ".html", ".htm", ".jinja", ".j2", ".tpl",
+]);
+const TEXT_FILENAMES = new Set([
+    "dockerfile", "makefile", "procfile", "brewfile", "gemfile",
+    "rakefile", "vagrantfile", "jenkinsfile", "capfile", "guardfile",
+    "podfile", "appfile", "fastfile",
+    "readme", "license", "changelog", "authors", "contributors", "notice",
+]);
+const SKIP_PATH_SEGMENTS = new Set([
+    "node_modules", ".git", "__pycache__", ".idea", ".vscode",
+    "vendor", "dist", "build", "target", "bin", "obj",
+]);
+const SKIP_EXTENSIONS = new Set([
+    ".pyc", ".class", ".o", ".a", ".so", ".dll", ".exe",
+    ".png", ".jpg", ".jpeg", ".gif", ".ico", ".svg", ".webp",
+    ".woff", ".woff2", ".ttf", ".eot",
+    ".zip", ".tar", ".gz", ".bz2", ".xz", ".7z", ".rar",
+    ".jar", ".war", ".ear", ".whl", ".nupkg",
+    ".pdf", ".doc", ".docx", ".xls", ".xlsx",
+]);
+const MAX_FILE_BYTES = 50 * 1024; // 50KB per file
+const MAX_TOTAL_BYTES = 300 * 1024; // 300KB total
+const MAX_FILES = 50;
+function shouldExtract(filePath) {
+    const lower = filePath.toLowerCase();
+    const segments = lower.split("/");
+    const filename = segments[segments.length - 1];
+    // Skip directories and hidden files at root
+    if (!filename || filename.startsWith("."))
+        return false;
+    // Skip paths with unwanted segments
+    for (const seg of segments.slice(0, -1)) {
+        if (SKIP_PATH_SEGMENTS.has(seg))
+            return false;
+    }
+    const dotIdx = filename.lastIndexOf(".");
+    const ext = dotIdx !== -1 ? filename.slice(dotIdx) : "";
+    if (SKIP_EXTENSIONS.has(ext))
+        return false;
+    if (TEXT_EXTENSIONS.has(ext))
+        return true;
+    if (TEXT_FILENAMES.has(filename))
+        return true;
+    return false;
+}
+// ---------------------------------------------------------------------------
+// ZIP unpacker (zip, nupkg, jar, war, ear, whl, vsix, apk)
+// ---------------------------------------------------------------------------
+function unpackZip(buffer) {
+    const files = [];
+    let skipped = 0;
+    let totalBytes = 0;
+    let zip;
+    try {
+        zip = new AdmZip(buffer);
+    }
+    catch {
+        return { files: [], skipped: 0 };
+    }
+    for (const entry of zip.getEntries()) {
+        if (entry.isDirectory)
+            continue;
+        if (files.length >= MAX_FILES) {
+            skipped++;
+            continue;
+        }
+        if (!shouldExtract(entry.entryName)) {
+            skipped++;
+            continue;
+        }
+        if (entry.header.size > MAX_FILE_BYTES) {
+            skipped++;
+            continue;
+        }
+        if (totalBytes + entry.header.size > MAX_TOTAL_BYTES) {
+            skipped++;
+            continue;
+        }
+        try {
+            const content = entry.getData().toString("utf-8");
+            // Reject if it looks binary (high proportion of null bytes / non-printable)
+            if (looksLikeBinary(content)) {
+                skipped++;
+                continue;
+            }
+            files.push({ path: entry.entryName, content });
+            totalBytes += entry.header.size;
+        }
+        catch {
+            skipped++;
+        }
+    }
+    return { files, skipped };
+}
+// ---------------------------------------------------------------------------
+// TAR unpacker (tar, tar.gz / tgz)
+// ---------------------------------------------------------------------------
+function unpackTar(buffer, gunzip) {
+    return new Promise((resolve) => {
+        const files = [];
+        let skipped = 0;
+        let totalBytes = 0;
+        const extract = tarStream.extract();
+        extract.on("entry", (header, stream, next) => {
+            if (header.type !== "file" ||
+                files.length >= MAX_FILES ||
+                !shouldExtract(header.name) ||
+                (header.size ?? 0) > MAX_FILE_BYTES ||
+                totalBytes + (header.size ?? 0) > MAX_TOTAL_BYTES) {
+                if (header.type === "file")
+                    skipped++;
+                stream.resume();
+                next();
+                return;
+            }
+            const chunks = [];
+            let bytes = 0;
+            stream.on("data", (chunk) => {
+                bytes += chunk.length;
+                if (bytes <= MAX_FILE_BYTES)
+                    chunks.push(chunk);
+            });
+            stream.on("end", () => {
+                try {
+                    const content = Buffer.concat(chunks).toString("utf-8");
+                    if (!looksLikeBinary(content)) {
+                        files.push({ path: header.name, content });
+                        totalBytes += bytes;
+                    }
+                    else {
+                        skipped++;
+                    }
+                }
+                catch {
+                    skipped++;
+                }
+                next();
+            });
+            stream.on("error", () => { skipped++; next(); });
+        });
+        extract.on("finish", () => resolve({ files, skipped }));
+        extract.on("error", () => resolve({ files, skipped }));
+        const readable = Readable.from(buffer);
+        if (gunzip) {
+            readable.pipe(zlib.createGunzip()).pipe(extract);
+        }
+        else {
+            readable.pipe(extract);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Binary detection heuristic
+// ---------------------------------------------------------------------------
+function looksLikeBinary(text) {
+    // Sample the first 1KB — if >10% non-printable chars, treat as binary
+    const sample = text.slice(0, 1024);
+    let nonPrintable = 0;
+    for (let i = 0; i < sample.length; i++) {
+        const code = sample.charCodeAt(i);
+        if (code < 9 || (code > 13 && code < 32) || code === 127)
+            nonPrintable++;
+    }
+    return nonPrintable / sample.length > 0.1;
+}
+/**
+ * Map artifact type string to archive format, if applicable.
+ * Returns null for non-archive types.
+ */
+export function archiveFormat(artifactType, artifactName) {
+    switch (artifactType) {
+        case "zip":
+        case "nupkg":
+        case "java-archive":
+        case "python-package":
+            return "zip";
+        case "tarball": {
+            const name = artifactName.toLowerCase();
+            if (name.endsWith(".tar.gz") || name.endsWith(".tgz"))
+                return "tar-gz";
+            return "tar";
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * Unpack an archive buffer and extract readable text files.
+ * Returns an empty result for unrecognized or corrupt archives.
+ */
+export async function unpackArchive(buffer, format) {
+    switch (format) {
+        case "zip":
+            return unpackZip(buffer);
+        case "tar":
+            return unpackTar(buffer, false);
+        case "tar-gz":
+            return unpackTar(buffer, true);
+    }
+}
+/**
+ * Format extracted files as a text block suitable for inclusion in an LLM prompt.
+ */
+export function formatExtractedFiles(result) {
+    if (result.files.length === 0) {
+        return "(no readable text files found in archive)";
+    }
+    const sections = result.files.map((f) => `=== ${f.path} ===\n${f.content.trimEnd()}`);
+    const footer = result.skipped > 0
+        ? `\n(${result.skipped} binary or oversized file${result.skipped === 1 ? "" : "s"} skipped)`
+        : "";
+    return sections.join("\n\n") + footer;
+}
+//# sourceMappingURL=archive-unpacker.js.map

package/dist/archive-unpacker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-unpacker.js","sourceRoot":"","sources":["../src/archive-unpacker.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,SAAS,CAAC;AAC7B,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAgBvC,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,iBAAiB;IACjB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;IAC9B,qBAAqB;IACrB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS;IAC7D,aAAa,EAAE,MAAM,EAAE,QAAQ;IAC/B,uBAAuB;IACvB,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ;IAClC,oBAAoB;IACpB,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM;IACnD,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM;IACvC,UAAU,EAAE,UAAU,EAAE,OAAO;IAC/B,UAAU;IACV,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;IAC/B,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;IACxC,6CAA6C;IAC7C,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK;IACxD,kBAAkB;IAClB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM;CACzC,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS;IAC3D,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW;IAChE,SAAS,EAAE,SAAS,EAAE,UAAU;IAChC,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ;CACtE,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACjC,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS;IACzD,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK;CAClD,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;IACnD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;IACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM;IACjC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM;IACnD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ;IACxC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;CACzC,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,CAAC,CAAG,gBAAgB;AACpD,MAAM,eAAe,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,cAAc;AAClD,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB,SAAS,aAAa,CAAC,QAAgB;IACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE/C,4CAA4C;IAC5C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAExD,oCAAoC;IACpC,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,IAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAChD,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAExD,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,2DAA2D;AAC3D,8EAA8E;AAE9E,SAAS,SAAS,CAAC,MAAc;IAC/B,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACnC,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,WAAW;YAAE,SAAS;QAChC,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;YAAC,OAAO,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QACvD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAAC,OAAO,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QAC7D,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,cAAc,EAAE,CAAC;YAAC,OAAO,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QAChE,IAAI,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,eAAe,EAAE,CAAC;YAAC,OAAO,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QAE9E,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClD,4EAA4E;YAC5E,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;gBAAC,OAAO,EAAE,CAAC;gBAAC,SAAS;YAAC,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/C,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC;AAED,8EAA8E;AAC9E,mCAAmC;AACnC,8EAA8E;AAE9E,SAAS,SAAS,CAAC,MAAc,EAAE,MAAe;IAChD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAoB,EAAE,CAAC;QAClC,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QAEpC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC3C,IACE,MAAM,CAAC,IAAI,KAAK,MAAM;gBACtB,KAAK,CAAC,MAAM,IAAI,SAAS;gBACzB,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC;gBAC3B,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,cAAc;gBACnC,UAAU,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,eAAe,EACjD,CAAC;gBACD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;oBAAE,OAAO,EAAE,CAAC;gBACtC,MAAM,CAAC,MAAM,EAAE,CAAC;gBAChB,IAAI,EAAE,CAAC;gBACP,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;YAEd,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBAClC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC;gBACtB,IAAI,KAAK,IAAI,cAAc;oBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClD,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACpB,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;oBACxD,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;wBAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;wBAC3C,UAAU,IAAI,KAAK,CAAC;oBACtB,CAAC;yBAAM,CAAC;wBACN,OAAO,EAAE,CAAC;oBACZ,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,EAAE,CAAC;gBACZ,CAAC;gBACD,IAAI,EAAE,CAAC;YACT,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAEvD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,MAAM,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E,SAAS,eAAe,CAAC,IAAY;IACnC,sEAAsE;IACtE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACnC,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,IAAI,IAAI,GAAG,EAAE,CAAC,IAAI,IAAI,KAAK,GAAG;YAAE,YAAY,EAAE,CAAC;IAC3E,CAAC;IACD,OAAO,YAAY,GAAG,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC;AAC5C,CAAC;AAQD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,YAAoB,EAAE,YAAoB;IACtE,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,KAAK,CAAC;QACX,KAAK,OAAO,CAAC;QACb,KAAK,cAAc,CAAC;QACpB,KAAK,gBAAgB;YACnB,OAAO,KAAK,CAAC;QACf,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,OAAO,QAAQ,CAAC;YACvE,OAAO,KAAK,CAAC;QACf,CAAC;QACD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,MAAqB;IAErB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK;YACR,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3B,KAAK,KAAK;YACR,OAAO,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAClC,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,2CAA2C,CAAC;IACrD,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAC/B,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CACnD,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,GAAG,CAAC;QAC/B,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,4BAA4B,MAAM,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW;QAC5F,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;AACxC,CAAC"}

package/dist/artifact-analyzer.d.ts

@@ -0,0 +1,59 @@
+import type { ArtifactAnalysis, Artifact } from "@synth-deploy/core";
+import type { LlmClient } from "@synth-deploy/core";
+import type { DebriefWriter } from "@synth-deploy/core";
+import type { PatternStore, PatternMatch } from "./pattern-store.js";
+export interface ArtifactInput {
+    name: string;
+    type?: string;
+    source: string;
+    content?: Buffer;
+    metadata?: Record<string, string>;
+}
+export interface AnalysisResult {
+    analysis: ArtifactAnalysis;
+    /** How the analysis was produced */
+    method: "llm" | "pattern-auto" | "pattern-suggest" | "unavailable";
+    /** Patterns that were matched, if any */
+    matchedPatterns?: PatternMatch[];
+}
+/**
+ * Detect artifact type from name and metadata.
+ * Used as a hint for the LLM and for intake routing — not for analysis.
+ */
+export declare function detectArtifactType(artifact: ArtifactInput): string;
+export interface ArtifactAnalyzerDeps {
+    llm: LlmClient;
+    debrief: DebriefWriter;
+    patternStore?: PatternStore;
+}
+/**
+ * Artifact analysis engine.
+ *
+ * Analysis pipeline:
+ *   1. Check pattern store for matching corrections (if available)
+ *      - Auto-apply if >= 2 corrections and confidence >= 0.7 (no LLM call)
+ *      - Suggest if 1 correction or confidence < 0.7 (apply as overlay after LLM)
+ *   2. If LLM is unavailable, return an "unavailable" result — no silent fallback
+ *   3. Run LLM analysis on the raw artifact content
+ *   4. Apply pattern-suggest overlay if applicable
+ *   5. Record debrief entry with decision trail
+ */
+export declare class ArtifactAnalyzer {
+    private readonly _llm;
+    private readonly _debrief;
+    private readonly _patternStore?;
+    constructor(deps: ArtifactAnalyzerDeps);
+    /**
+     * Analyze a deployment artifact. Returns structured analysis with
+     * confidence score and method used.
+     */
+    analyze(artifact: ArtifactInput): Promise<AnalysisResult>;
+    /**
+     * Re-analyze an artifact using its stored annotations as correction context.
+     * Returns null if LLM is unavailable.
+     */
+    reanalyzeWithAnnotations(artifact: Artifact): Promise<ArtifactAnalysis | null>;
+    private _recordDebrief;
+}
+export declare function createArtifactAnalyzer(deps: ArtifactAnalyzerDeps): ArtifactAnalyzer;
+//# sourceMappingURL=artifact-analyzer.d.ts.map

package/dist/artifact-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-analyzer.d.ts","sourceRoot":"","sources":["../src/artifact-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAmB,MAAM,oBAAoB,CAAC;AAOtF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,oCAAoC;IACpC,MAAM,EAAE,KAAK,GAAG,cAAc,GAAG,iBAAiB,GAAG,aAAa,CAAC;IACnE,yCAAyC;IACzC,eAAe,CAAC,EAAE,YAAY,EAAE,CAAC;CAClC;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CA0BlE;AAoGD,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,SAAS,CAAC;IACf,OAAO,EAAE,aAAa,CAAC;IACvB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAe;gBAElC,IAAI,EAAE,oBAAoB;IAMtC;;;OAGG;IACG,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAmH/D;;;OAGG;IACG,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IA+EpF,OAAO,CAAC,cAAc;CAqCvB;AAMD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CAEnF"}