@lovinka/deployik-mcp 0.1.1 → 0.1.5

package/dist/tools/help.js

@@ -30,5 +30,125 @@ export function registerHelpTools(server, ctx) {
             return { text: recipe.body, data: { topic: recipe.topic, title: recipe.title } };
         },
     });
+    registerTool(server, ctx, {
+        name: "find_help",
+        description: "Answer 'where do I set this?' / 'how do I X?' style questions by ranking the bundled Deployik recipes against your question. Returns the best matching recipe in full plus a short list of runners-up. Use this when you don't know which exact topic to ask for — just describe the goal in plain English.",
+        inputSchema: {
+            question: z.string().describe("Plain-English question or goal, e.g. 'where do I set Stripe API keys for the live site?'"),
+            max_results: z.number().int().positive().max(8).default(3),
+        },
+        annotations: { readOnlyHint: true },
+        handler: async (args) => {
+            const ranked = rankRecipes(args.question);
+            if (ranked.length === 0) {
+                return {
+                    text: `No matching recipe found for '${args.question}'. Call list_recipes to see the full catalog.`,
+                    data: { matches: [] },
+                };
+            }
+            const top = ranked[0];
+            const runnersUp = ranked.slice(1, args.max_results);
+            const summary = [
+                `Best match: ${top.recipe.title} (topic: ${top.recipe.topic}, score: ${top.score})`,
+                `Why: ${top.matchedTerms.length > 0 ? "matched terms — " + top.matchedTerms.join(", ") : "general overlap"}`,
+                ``,
+                `── Recipe body ──`,
+                top.recipe.body,
+            ];
+            if (runnersUp.length > 0) {
+                summary.push(``, `── Other relevant topics ──`);
+                for (const r of runnersUp) {
+                    summary.push(`  • ${r.recipe.topic.padEnd(22)} ${r.recipe.title}  (score: ${r.score})`);
+                }
+                summary.push(``, `Call get_recipe({ topic: "<name>" }) to fetch any of those in full.`);
+            }
+            return {
+                text: summary.join("\n"),
+                data: {
+                    best: { topic: top.recipe.topic, title: top.recipe.title, score: top.score, matched: top.matchedTerms },
+                    runners_up: runnersUp.map((r) => ({ topic: r.recipe.topic, title: r.recipe.title, score: r.score })),
+                },
+            };
+        },
+    });
+}
+const STOPWORDS = new Set([
+    "the", "a", "an", "is", "are", "do", "does", "did", "i", "me", "my", "we", "our", "you", "your",
+    "to", "of", "in", "on", "at", "for", "with", "this", "that", "these", "those", "how", "where",
+    "what", "when", "why", "which", "can", "could", "should", "would", "please", "just", "like",
+    "set", "setting", "add", "change", "update", "make", "need", "want", "get", "go", "be", "new",
+    "deployik", "app", "site", "project", "value", "using", "via", "up", "down",
+]);
+const SYNONYMS = {
+    // env vars
+    env: "envvars", envs: "envvars", environment: "envvars", variable: "envvars", variables: "envvars",
+    config: "envvars", configuration: "envvars", "next-public": "envvars",
+    // secrets
+    secret: "envvars", secrets: "envvars", key: "envvars", apikey: "envvars",
+    stripe: "envvars", token: "envvars", password: "envvars",
+    // domain
+    domain: "domain", domains: "domain", url: "domain", ssl: "domain", dns: "domain",
+    custom: "domain", subdomain: "domain", https: "domain", cert: "domain", certificate: "domain",
+    // auto-deploy
+    autodeploy: "autodeploy", webhook: "autodeploy", auto: "autodeploy", push: "autodeploy",
+    github: "autodeploy", branch: "autodeploy", trigger: "autodeploy",
+    // password protection
+    protect: "protection", protection: "protection", protected: "protection", lock: "protection",
+    preview: "preview", private: "protection",
+    // email / contact form
+    email: "email", contact: "email", smtp: "email", recaptcha: "email", form: "email",
+    webglobe: "email", mail: "email", "form-email": "email",
+    // rollback
+    rollback: "rollback", revert: "rollback", undo: "rollback", restore: "rollback", previous: "rollback",
+    // create / connect project
+    connect: "create", create: "create", new: "create", setup: "create", import: "create",
+    repo: "create", repository: "create", deploy: "create", first: "create",
+};
+function rankRecipes(question) {
+    const tokens = tokenize(question);
+    if (tokens.length === 0)
+        return [];
+    // Expand tokens through the synonym map (a token contributes both itself and any
+    // canonical bucket it belongs to).
+    const expanded = new Set();
+    for (const t of tokens) {
+        expanded.add(t);
+        if (SYNONYMS[t])
+            expanded.add(SYNONYMS[t]);
+    }
+    const ranked = [];
+    for (const recipe of listRecipes()) {
+        const haystack = (recipe.topic + " " + recipe.title + " " + recipe.summary + " " + recipe.body).toLowerCase();
+        let score = 0;
+        const matched = [];
+        for (const term of expanded) {
+            if (!haystack.includes(term))
+                continue;
+            // Weight: matches in topic/title are worth more than body matches.
+            const inTopic = recipe.topic.toLowerCase().includes(term);
+            const inTitle = recipe.title.toLowerCase().includes(term);
+            const inSummary = recipe.summary.toLowerCase().includes(term);
+            const weight = inTopic ? 5 : inTitle ? 3 : inSummary ? 2 : 1;
+            score += weight;
+            matched.push(term);
+        }
+        if (score > 0)
+            ranked.push({ recipe, score, matchedTerms: matched });
+    }
+    ranked.sort((a, b) => b.score - a.score);
+    return ranked;
+}
+function tokenize(input) {
+    const out = [];
+    for (const raw of input.toLowerCase().split(/[^a-z0-9]+/)) {
+        if (!raw)
+            continue;
+        if (raw.length < 2)
+            continue;
+        if (STOPWORDS.has(raw))
+            continue;
+        out.push(raw);
+    }
+    return out;
 }
 //# sourceMappingURL=help.js.map

package/dist/tools/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/tools/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAoB,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAoB,MAAM,uBAAuB,CAAC;AAEhG,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,GAAgB;IACnE,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE;QACxB,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,2IAA2I;QAC7I,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;QACnC,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxG,OAAO;gBACL,IAAI;gBACJ,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;aACnF,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE;QACxB,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,gGAAgG;QAC7G,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,aAAgD,CAAC;SAChE;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;QACnC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,EAAE,IAAI,EAAE,kBAAkB,IAAI,CAAC,KAAK,sCAAsC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACrG,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;QACnF,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/tools/help.ts"],"names":[],"mappings":"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"}

package/dist/tools/secrets.js

@@ -3,7 +3,8 @@ import { registerTool } from "./_helpers.js";
 import { resolveProject } from "../resolve/project.js";
 import { checkSafety } from "../lib/safety.js";
 import { renderDryRun } from "../lib/format.js";
-const SCOPE = z.enum(["shared", "preview", "production"]);
+import { requireScope } from "../lib/normalize.js";
+const SCOPE = z.string().describe("'shared' (both envs), 'preview' (test/staging/dev), or 'production' (live/prod). Aliases accepted.");
 export function registerSecretTools(server, ctx) {
     registerTool(server, ctx, {
         name: "list_secrets",
@@ -15,9 +16,10 @@ export function registerSecretTools(server, ctx) {
         },
         annotations: { readOnlyHint: true },
         handler: async (args) => {
+            const environment = requireScope(args.environment);
             const { project } = await resolveProject(ctx, args);
             const vars = await ctx.client.request(`/projects/${project.id}/secrets`, {
-                query: { environment: args.environment },
+                query: { environment },
             });
             const text = vars.length === 0
                 ? "(no secrets in this scope)"
@@ -36,12 +38,13 @@ export function registerSecretTools(server, ctx) {
             value: z.string(),
         },
         handler: async (args) => {
+            const environment = requireScope(args.environment);
             const { project } = await resolveProject(ctx, args);
             await ctx.client.request(`/projects/${project.id}/secrets`, {
                 method: "POST",
-                body: { environment: args.environment, key: args.key, value: args.value },
+                body: { environment, key: args.key, value: args.value },
             });
-            return { text: `Set secret ${args.key} in ${args.environment} scope of ${project.name}.` };
+            return { text: `Set secret ${args.key} in ${environment} scope of ${project.name}.` };
         },
     });
     registerTool(server, ctx, {
@@ -58,15 +61,16 @@ export function registerSecretTools(server, ctx) {
         annotations: { destructiveHint: true },
         audit: true,
         handler: async (args) => {
+            const environment = requireScope(args.environment);
             const { project } = await resolveProject(ctx, args);
-            const tier = args.environment === "production" ? "destructive_production" : "destructive";
+            const tier = environment === "production" ? "destructive_production" : "destructive";
             const safety = checkSafety({
                 toolName: "bulk_set_secrets",
                 tier,
                 expectedName: project.name,
                 impact: {
                     project: project.name,
-                    scope: args.environment,
+                    scope: environment,
                     replacing_with: args.variables.length,
                     note: "Existing secrets not in this set will be DELETED.",
                 },
@@ -75,9 +79,9 @@ export function registerSecretTools(server, ctx) {
                 return { text: renderDryRun(safety.dryRun) };
             const res = await ctx.client.request(`/projects/${project.id}/secrets`, {
                 method: "PUT",
-                body: { environment: args.environment, variables: args.variables },
+                body: { environment, variables: args.variables },
             });
-            return { text: `Replaced ${args.environment} secrets on ${project.name} — now ${res.count} keys.` };
+            return { text: `Replaced ${environment} secrets on ${project.name} — now ${res.count} keys.` };
         },
     });
     registerTool(server, ctx, {
@@ -94,21 +98,22 @@ export function registerSecretTools(server, ctx) {
         annotations: { destructiveHint: true },
         audit: true,
         handler: async (args) => {
+            const environment = requireScope(args.environment);
             const { project } = await resolveProject(ctx, args);
-            const tier = args.environment === "production" ? "destructive_production" : "destructive";
+            const tier = environment === "production" ? "destructive_production" : "destructive";
             const safety = checkSafety({
                 toolName: "delete_secret",
                 tier,
                 expectedName: project.name,
-                impact: { project: project.name, scope: args.environment, key: args.key },
+                impact: { project: project.name, scope: environment, key: args.key },
             }, { confirm: args.confirm, confirm_name: args.confirm_name });
             if (!safety.proceed)
                 return { text: renderDryRun(safety.dryRun) };
             await ctx.client.request(`/projects/${project.id}/secrets/${encodeURIComponent(args.key)}`, {
                 method: "DELETE",
-                query: { environment: args.environment },
+                query: { environment },
             });
-            return { text: `Deleted secret ${args.key} from ${args.environment} scope of ${project.name}.` };
+            return { text: `Deleted secret ${args.key} from ${environment} scope of ${project.name}.` };
         },
     });
 }

package/dist/tools/secrets.js.map

@@ -1 +1 @@
-{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../../src/tools/secrets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAoB,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;AAE1D,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,GAAgB;IACrE,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE;QACxB,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,wDAAwD;QACrE,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,WAAW,EAAE,KAAK;SACnB;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;QACnC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAmB,aAAa,OAAO,CAAC,EAAE,UAAU,EAAE;gBACzF,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;aACzC,CAAC,CAAC;YACH,MAAM,IAAI,GACR,IAAI,CAAC,MAAM,KAAK,CAAC;gBACf,CAAC,CAAC,4BAA4B;gBAC9B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC9B,CAAC;KACF,CAAC,CAAC;IAEH,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE;QACxB,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,iJAAiJ;QAC9J,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,WAAW,EAAE,KAAK;YAClB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;YACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SAClB;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACpD,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,OAAO,CAAC,EAAE,UAAU,EAAE;gBAC1D,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;aAC1E,CAAC,CAAC;YACH,OAAO,EAAE,IAAI,EAAE,cAAc,IAAI,CAAC,GAAG,OAAO,IAAI,CAAC,WAAW,aAAa,OAAO,CAAC,IAAI,GAAG,EAAE,CAAC;QAC7F,CAAC;KACF,CAAC,CAAC;IAEH,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE;QACxB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,6GAA6G;QAC1H,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,WAAW,EAAE,KAAK;YAClB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3E,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC/B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACpC;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;QACtC,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,aAAa,CAAC;YAC1F,MAAM,MAAM,GAAG,WAAW,CACxB;gBACE,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI;gBACJ,YAAY,EAAE,OAAO,CAAC,IAAI;gBAC1B,MAAM,EAAE;oBACN,OAAO,EAAE,OAAO,CAAC,IAAI;oBACrB,KAAK,EAAE,IAAI,CAAC,WAAW;oBACvB,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM;oBACrC,IAAI,EAAE,mDAAmD;iBAC1D;aACF,EACD,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAC3D,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAClE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAoB,aAAa,OAAO,CAAC,EAAE,UAAU,EAAE;gBACzF,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE;aACnE,CAAC,CAAC;YACH,OAAO,EAAE,IAAI,EAAE,YAAY,IAAI,CAAC,WAAW,eAAe,OAAO,CAAC,IAAI,UAAU,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;QACtG,CAAC;KACF,CAAC,CAAC;IAEH,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE;QACxB,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,gFAAgF;QAC7F,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,WAAW,EAAE,KAAK;YAClB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;YACf,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC/B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACpC;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;QACtC,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,aAAa,CAAC;YAC1F,MAAM,MAAM,GAAG,WAAW,CACxB;gBACE,QAAQ,EAAE,eAAe;gBACzB,IAAI;gBACJ,YAAY,EAAE,OAAO,CAAC,IAAI;gBAC1B,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;aAC1E,EACD,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAC3D,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAClE,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,OAAO,CAAC,EAAE,YAAY,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE;gBAC1F,MAAM,EAAE,QAAQ;gBAChB,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;aACzC,CAAC,CAAC;YACH,OAAO,EAAE,IAAI,EAAE,kBAAkB,IAAI,CAAC,GAAG,SAAS,IAAI,CAAC,WAAW,aAAa,OAAO,CAAC,IAAI,GAAG,EAAE,CAAC;QACnG,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../../src/tools/secrets.ts"],"names":[],"mappings":"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"}

package/dist/tools/workflows.js

@@ -6,8 +6,10 @@ import { pollUntil, sleep } from "../lib/poll.js";
 import { renderDryRun, renderProjectSummary, renderDeploymentSummary, renderDomainsList, renderVolumesList, renderProtection } from "../lib/format.js";
 import { formatLogs } from "../lib/logs.js";
 import { writeBinding, ensureGitignore, readBinding } from "../config/binding.js";
-const ENV = z.enum(["preview", "production"]);
-const VAR_SCOPE = z.enum(["shared", "preview", "production"]);
+import { requireEnvironment, requireScope } from "../lib/normalize.js";
+// Accept any string so we can normalize 'prod'/'live'/'staging' charitably.
+const ENV = z.string().describe("'preview' (test) or 'production' (live). Also accepts: prod, live, staging, dev, test.");
+const VAR_SCOPE = z.string().describe("'shared' (both envs), 'preview' (test only), or 'production' (live only). Also accepts: both, all, prod, live, staging.");
 const TERMINAL_STATUSES = new Set(["live", "failed", "replaced", "rolled_back"]);
 export function registerWorkflowTools(server, ctx) {
     registerTool(server, ctx, {
@@ -17,24 +19,26 @@ export function registerWorkflowTools(server, ctx) {
             project: z.string().optional(),
             project_id: z.string().optional(),
             workspace: z.string().optional(),
-            default_environment: ENV.optional(),
+            default_environment: z.string().optional().describe("Optional default environment: 'preview' or 'production' (also accepts prod/live/staging)."),
         },
         handler: async (args) => {
             const user = await ctx.client.request(`/auth/me`);
             const { project, source } = await resolveProject(ctx, args);
+            const defaultEnvironment = args.default_environment ? requireEnvironment(args.default_environment) : undefined;
             const binding = {
                 project: project.name,
                 workspace: project.organization_name ?? project.organization_id,
-                defaultEnvironment: args.default_environment,
+                defaultEnvironment,
             };
-            writeBinding(ctx.stateDir, binding);
+            writeBinding(ctx.stateDir, ctx.cwd, binding);
             const gitignoreUpdated = ensureGitignore(ctx.cwd);
             const lines = [
                 `Bound this repo to Deployik project '${project.name}' (workspace: ${binding.workspace}).`,
                 `Authenticated as ${user.username} (${user.role}).`,
                 `Resolution source: ${source}.`,
+                `Wrote .deployik.json (commit this — it tells teammates which project deploys here).`,
                 gitignoreUpdated ? "Added `.deployik/` to .gitignore." : "`.deployik/` already in .gitignore (or no .gitignore at repo root).",
-                `State dir: ${ctx.stateDir}`,
+                `Private state dir: ${ctx.stateDir} (cache, token, audit — never commit).`,
             ];
             return { text: lines.join("\n"), data: { project, binding, gitignoreUpdated } };
         },
@@ -96,7 +100,7 @@ export function registerWorkflowTools(server, ctx) {
     });
     registerTool(server, ctx, {
         name: "deploy_project",
-        description: "Trigger a deployment for a project + environment. With `wait:true`, polls until terminal status and returns the final state. Production requires `confirm: true` + `confirm_name`.",
+        description: "Start a new deployment. Use environment 'preview' for a test build (auto-deployed to a *.preview.lovinka.com URL) or 'production' for the public live version. With `wait:true`, this tool waits until the build finishes (success or failure) before returning. Production deploys require `confirm:true` + `confirm_name` matching the project slug, so the AI can't accidentally push to live.",
         inputSchema: {
             project_id: z.string().optional(),
             project: z.string().optional(),
@@ -111,8 +115,9 @@ export function registerWorkflowTools(server, ctx) {
         },
         audit: true,
         handler: async (args) => {
+            const environment = requireEnvironment(args.environment);
             const { project } = await resolveProject(ctx, args);
-            if (args.environment === "production") {
+            if (environment === "production") {
                 const safety = checkSafety({
                     toolName: "deploy_project",
                     tier: "destructive_production",
@@ -122,7 +127,7 @@ export function registerWorkflowTools(server, ctx) {
                 if (!safety.proceed)
                     return { text: renderDryRun(safety.dryRun) };
             }
-            const body = { environment: args.environment };
+            const body = { environment };
             if (args.branch)
                 body.branch = args.branch;
             if (args.create_tag)
@@ -131,7 +136,7 @@ export function registerWorkflowTools(server, ctx) {
                 body.tag_name = args.tag_name;
             const deployment = await ctx.client.request(`/projects/${project.id}/deployments`, { method: "POST", body });
             if (!args.wait) {
-                return { text: `Triggered ${args.environment} deploy.\n${renderDeploymentSummary(deployment)}`, data: deployment };
+                return { text: `Triggered ${environment} deploy.\n${renderDeploymentSummary(deployment)}`, data: deployment };
             }
             const final = await pollUntil(() => ctx.client.request(`/projects/${project.id}/deployments/${deployment.id}`), (d) => TERMINAL_STATUSES.has(d.status), { intervalMs: 2000, timeoutMs: args.timeout_ms, initialDelayMs: 1500 });
             const status = final.value;
@@ -144,46 +149,48 @@ export function registerWorkflowTools(server, ctx) {
     });
     registerTool(server, ctx, {
         name: "set_secret",
-        description: "Set a secret on a project+scope. Auto-resolves project from the .deployik binding if omitted. NEXT_PUBLIC_* keys are rejected by the backend (use set_env_var instead).",
+        description: "Add or change a secret value — API key, database password, Stripe key, anything sensitive. Stored encrypted; only available to the running container at runtime. NEXT_PUBLIC_* keys are NOT allowed here (they need to be baked into the build — use set_env_var). If you don't pass `project`, the tool uses the binding from `.deployik/` in the current folder.",
         inputSchema: {
             project_id: z.string().optional(),
-            project: z.string().optional(),
+            project: z.string().optional().describe("Project slug like 'my-app'. Omit to use the .deployik binding."),
             environment: VAR_SCOPE.default("production"),
-            key: z.string(),
-            value: z.string(),
+            key: z.string().describe("The variable name, e.g. STRIPE_SECRET_KEY."),
+            value: z.string().describe("The actual secret value."),
         },
         handler: async (args) => {
             if (args.key.startsWith("NEXT_PUBLIC_")) {
                 return {
-                    text: `Refusing to set NEXT_PUBLIC_* keys as secrets — they need to be embedded at build time. Use set_env_var instead.`,
+                    text: `NEXT_PUBLIC_* keys can't be secrets — they need to be embedded into the build so the browser can read them. Use set_env_var instead.`,
                     isError: true,
                 };
             }
+            const environment = requireScope(args.environment);
             const { project } = await resolveProject(ctx, args);
             await ctx.client.request(`/projects/${project.id}/secrets`, {
                 method: "POST",
-                body: { environment: args.environment, key: args.key, value: args.value },
+                body: { environment, key: args.key, value: args.value },
             });
-            return { text: `Set secret ${args.key} in ${args.environment} scope of ${project.name}.` };
+            return { text: `Saved secret '${args.key}' to ${environment} of ${project.name}.` };
         },
     });
     registerTool(server, ctx, {
         name: "set_env_var",
-        description: "Set an environment variable on a project+scope. Auto-resolves project from the .deployik binding if omitted.",
+        description: "Add or change an environment variable — a non-sensitive config value or a NEXT_PUBLIC_* value that the browser can see. If you don't pass `project`, the tool uses the binding from `.deployik/` in the current folder. Use 'shared' scope to set the same value for both preview and production.",
         inputSchema: {
             project_id: z.string().optional(),
             project: z.string().optional(),
             environment: VAR_SCOPE.default("production"),
-            key: z.string(),
+            key: z.string().describe("Variable name. Letters, digits, underscores only. Cannot start with a number."),
             value: z.string(),
         },
         handler: async (args) => {
+            const environment = requireScope(args.environment);
             const { project } = await resolveProject(ctx, args);
             await ctx.client.request(`/projects/${project.id}/env`, {
                 method: "POST",
-                body: { environment: args.environment, key: args.key, value: args.value },
+                body: { environment, key: args.key, value: args.value },
             });
-            return { text: `Set ${args.key} in ${args.environment} scope of ${project.name}.` };
+            return { text: `Saved '${args.key}' to ${environment} of ${project.name}.` };
         },
     });
     registerTool(server, ctx, {
@@ -208,7 +215,7 @@ export function registerWorkflowTools(server, ctx) {
     });
     registerTool(server, ctx, {
         name: "tail_latest_logs",
-        description: "The 'show me what just broke' tool: finds the latest deployment for a project+environment and returns formatted log tail. With `follow:true`, polls until the deploy terminates.",
+        description: "Show me the most recent build logs for a project. Finds the latest deployment, returns the tail with error lines highlighted. Use `follow:true` if a build is still running and you want to wait for it to finish before getting the logs.",
         inputSchema: {
             project_id: z.string().optional(),
             project: z.string().optional(),
@@ -219,11 +226,12 @@ export function registerWorkflowTools(server, ctx) {
         },
         annotations: { readOnlyHint: true },
         handler: async (args) => {
+            const environment = requireEnvironment(args.environment);
             const { project } = await resolveProject(ctx, args);
-            const deployments = await ctx.client.request(`/projects/${project.id}/deployments`, { query: { environment: args.environment, limit: 1 } });
+            const deployments = await ctx.client.request(`/projects/${project.id}/deployments`, { query: { environment, limit: 1 } });
             const latest = (deployments.deployments ?? [])[0];
             if (!latest) {
-                return { text: `(no ${args.environment} deployments yet for ${project.name})` };
+                return { text: `(no ${environment} deployments yet for ${project.name})` };
             }
             let current = latest;
             let logs = await ctx.client.request(`/deployments/${current.id}/logs`).catch(() => []);
@@ -346,5 +354,149 @@ export function registerWorkflowTools(server, ctx) {
             return { text: lines.join("\n"), data: { binding, project } };
         },
     });
+    // -----------------------------------------------------------------
+    // High-intent shortcuts for non-technical users.
+    //
+    // These tools accept loose English ("show me my site", "what's broken",
+    // "redeploy") and resolve to the same backend operations as the lower-level
+    // tools, with friendlier defaults and output. The AI is free to use the
+    // primitive tools instead — these are pure ergonomics.
+    // -----------------------------------------------------------------
+    registerTool(server, ctx, {
+        name: "whats_my_url",
+        description: "Show the live URL(s) of a project. Returns the primary preview and production URLs (with SSL status) so you can share or open them.",
+        inputSchema: {
+            project_id: z.string().optional(),
+            project: z.string().optional(),
+        },
+        annotations: { readOnlyHint: true },
+        handler: async (args) => {
+            const { project } = await resolveProject(ctx, args);
+            const domains = await ctx.client.request(`/projects/${project.id}/domains`);
+            const groupByEnv = { preview: [], production: [] };
+            for (const d of domains)
+                groupByEnv[d.environment].push(d);
+            const pickPrimary = (list) => list.find((d) => d.is_primary && d.dns_verified && d.ssl_status === "active") ??
+                list.find((d) => d.is_primary) ??
+                list[0];
+            const linesOut = [`URLs for '${project.name}':`];
+            for (const env of ["preview", "production"]) {
+                const list = groupByEnv[env];
+                const primary = pickPrimary(list);
+                if (!primary) {
+                    linesOut.push(`  ${env.padEnd(11)} (no ${env} domains yet)`);
+                    continue;
+                }
+                const proto = primary.ssl_status === "active" ? "https://" : "http://";
+                const flag = primary.ssl_status === "active" ? "live" : `${primary.ssl_status} SSL · DNS ${primary.dns_verified ? "ok" : "pending"}`;
+                linesOut.push(`  ${env.padEnd(11)} ${proto}${primary.domain}   (${flag})`);
+                const others = list.filter((d) => d !== primary);
+                for (const d of others) {
+                    linesOut.push(`              also: ${d.ssl_status === "active" ? "https://" : "http://"}${d.domain}`);
+                }
+            }
+            return { text: linesOut.join("\n"), data: { domains, primary: { preview: pickPrimary(groupByEnv.preview), production: pickPrimary(groupByEnv.production) } } };
+        },
+    });
+    registerTool(server, ctx, {
+        name: "whats_broken",
+        description: "Find the most recent failed deployment — either for a specific project, or (if none specified) the freshest failure across every project this token can see. Returns the deployment summary + a log tail with error lines highlighted, so the AI can suggest a fix in one shot.",
+        inputSchema: {
+            project_id: z.string().optional(),
+            project: z.string().optional(),
+            environment: ENV.optional(),
+        },
+        annotations: { readOnlyHint: true },
+        handler: async (args) => {
+            const envFilter = args.environment ? requireEnvironment(args.environment) : undefined;
+            let candidateProjects;
+            if (args.project_id || args.project) {
+                const { project } = await resolveProject(ctx, args);
+                candidateProjects = [project];
+            }
+            else {
+                candidateProjects = await fetchProjects(ctx);
+            }
+            const failures = [];
+            for (const project of candidateProjects) {
+                const list = await ctx.client
+                    .request(`/projects/${project.id}/deployments`, {
+                    query: { status: "failed", environment: envFilter, limit: 1 },
+                })
+                    .catch(() => ({ deployments: [], total: 0 }));
+                const dep = (list.deployments ?? [])[0];
+                if (dep)
+                    failures.push({ project, dep });
+            }
+            if (failures.length === 0) {
+                return { text: `No failed deployments found${args.project || args.project_id ? " for this project" : ""}.` };
+            }
+            failures.sort((a, b) => (b.dep.created_at > a.dep.created_at ? 1 : -1));
+            const winner = failures[0];
+            const logs = await ctx.client.request(`/deployments/${winner.dep.id}/logs`).catch(() => []);
+            const formatted = formatLogs(logs, { maxLines: 60, tail: true });
+            const header = `Project '${winner.project.name}' has a failed ${winner.dep.environment} deployment.\n${renderDeploymentSummary(winner.dep)}`;
+            const anchors = formatted.errorAnchors.length > 0 ? `\nError anchors: lines ${formatted.errorAnchors.join(", ")}` : "";
+            return {
+                text: `${header}\n\nLog tail (${formatted.returnedLines}/${formatted.totalLines}):\n${formatted.text}${anchors}`,
+                data: { project: winner.project, deployment: winner.dep, logsMeta: formatted, otherFailures: failures.length - 1 },
+            };
+        },
+    });
+    registerTool(server, ctx, {
+        name: "redeploy",
+        description: "Re-run the last build for a project. Convenience alias around deploy_project — defaults to the preview environment and waits for the build to finish. Use this when someone says 'redeploy', 'try again', or 'kick another build'.",
+        inputSchema: {
+            project_id: z.string().optional(),
+            project: z.string().optional(),
+            environment: ENV.default("preview"),
+            wait: z.boolean().default(true),
+            timeout_ms: z.number().int().positive().max(600_000).default(240_000),
+            confirm: z.boolean().optional(),
+            confirm_name: z.string().optional(),
+        },
+        audit: true,
+        handler: async (args) => {
+            const environment = requireEnvironment(args.environment);
+            const { project } = await resolveProject(ctx, args);
+            if (environment === "production") {
+                const safety = checkSafety({
+                    toolName: "redeploy",
+                    tier: "destructive_production",
+                    expectedName: project.name,
+                    impact: { project: project.name, environment, branch: project.branch },
+                }, { confirm: args.confirm, confirm_name: args.confirm_name });
+                if (!safety.proceed)
+                    return { text: renderDryRun(safety.dryRun) };
+            }
+            const dep = await ctx.client.request(`/projects/${project.id}/deployments`, {
+                method: "POST",
+                body: { environment },
+            });
+            if (!args.wait)
+                return { text: `Redeploy queued for ${project.name} (${environment}).\n${renderDeploymentSummary(dep)}`, data: dep };
+            const final = await pollUntil(() => ctx.client.request(`/projects/${project.id}/deployments/${dep.id}`), (d) => TERMINAL_STATUSES.has(d.status), { intervalMs: 2000, timeoutMs: args.timeout_ms, initialDelayMs: 1500 });
+            const status = final.value;
+            if (status.status === "live") {
+                const domains = await ctx.client.request(`/projects/${project.id}/domains`).catch(() => []);
+                const primary = domains.find((d) => d.environment === environment && d.is_primary) ?? domains.find((d) => d.environment === environment);
+                const url = primary ? (primary.ssl_status === "active" ? "https://" : "http://") + primary.domain : null;
+                return {
+                    text: [
+                        `✅ ${project.name} (${environment}) is live again.`,
+                        url ? `URL: ${url}` : "",
+                        renderDeploymentSummary(status),
+                    ].filter(Boolean).join("\n"),
+                    data: status,
+                };
+            }
+            const logs = await ctx.client.request(`/deployments/${status.id}/logs`).catch(() => []);
+            const formatted = formatLogs(logs, { maxLines: 80, tail: true });
+            return {
+                text: `❌ Redeploy of ${project.name} (${environment}) ended as '${status.status}'.\n${renderDeploymentSummary(status)}\n\nLog tail:\n${formatted.text}`,
+                data: status,
+            };
+        },
+    });
 }
 //# sourceMappingURL=workflows.js.map