@infracraft/pulumi 1.9.0 → 1.11.0

package/dist/agents/hint.cjs

@@ -0,0 +1,53 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_chunk = require('../chunk-BVYJZCqc.cjs');
+let _pulumi_pulumi = require("@pulumi/pulumi");
+_pulumi_pulumi = require_chunk.__toESM(_pulumi_pulumi, 1);
+
+//#region src/agents/hint.ts
+/**
+* Generic infracraft reminders, prepended to every hint. These hold for any
+* infracraft stack regardless of the consuming project.
+*/
+const INFRACRAFT_DEFAULTS = [
+	"Adopt-or-create: re-running is safe — existing resources are adopted, missing ones created",
+	"Shared resources (Railway services/projects, Neon projects) have no-op deletes — destroy never removes them",
+	"Mark shared/production resources protect:true — pulumi destroy aborts on protected resources"
+];
+/**
+* Emits a delimited `<infracraft-hint>` block of reminders for AI coding agents
+* operating this Pulumi stack — modeled on Vercel's `AGENTS.md` guidance: a
+* delimited block, an agent-directed intro, then terse directive bullets.
+*
+* No-op for humans (no agent env var) unless `enabled` is forced. Call it once at
+* the top of your Pulumi program; the infracraft defaults are always included and
+* `project` lines are appended.
+*
+* @param options Project reminders, channel, and detection override.
+* @returns Nothing; emits to the chosen channel as a side effect.
+* @example
+* ```typescript
+* import * as agents from "@infracraft/pulumi/agents";
+*
+* agents.hint({
+*   project: [
+*     "Production is protected — `unprotect <urn>` first for a deliberate change",
+*     "Feature env = imports:[staging], zero config; pulumi destroy is safe",
+*   ],
+* });
+* ```
+*/
+function hint(options = {}) {
+	if (!(options.enabled ?? (!!process.env.CLAUDECODE || !!process.env.AI_AGENT))) return;
+	const block = [
+		"<infracraft-hint>",
+		"Reminders for AI agents operating this Pulumi stack:",
+		...[...INFRACRAFT_DEFAULTS, ...options.project ?? []].map((line) => `- ${line}`),
+		"</infracraft-hint>"
+	].join("\n");
+	if (options.channel === "pulumi-log") _pulumi_pulumi.log.info(block);
+	else process.stderr.write(`${block}\n`);
+}
+
+//#endregion
+exports.hint = hint;
+//# sourceMappingURL=hint.cjs.map

package/dist/agents/hint.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hint.cjs","names":[],"sources":["../../src/agents/hint.ts"],"sourcesContent":["import * as pulumi from \"@pulumi/pulumi\";\n\n/**\n * Generic infracraft reminders, prepended to every hint. These hold for any\n * infracraft stack regardless of the consuming project.\n */\nconst INFRACRAFT_DEFAULTS = [\n\t\"Adopt-or-create: re-running is safe — existing resources are adopted, missing ones created\",\n\t\"Shared resources (Railway services/projects, Neon projects) have no-op deletes — destroy never removes them\",\n\t\"Mark shared/production resources protect:true — pulumi destroy aborts on protected resources\",\n];\n\n/** Options for {@link agentHint}. */\nexport interface AgentHintOptions {\n\t/** Project-specific reminders appended after the infracraft defaults. */\n\tproject?: string[];\n\n\t/**\n\t * Force the hint on or off. Defaults to auto-detecting an AI coding agent via\n\t * the `CLAUDECODE` / `AI_AGENT` environment variables.\n\t */\n\tenabled?: boolean;\n\n\t/**\n\t * Where to write the hint. `\"stderr\"` (default) prints it prominently the\n\t * instant the program loads, before Pulumi's own output — modeled on how the\n\t * Vercel CLI surfaces agent guidance. `\"pulumi-log\"` routes it through\n\t * `pulumi.log.info` (lands in the Diagnostics section instead).\n\t */\n\tchannel?: \"stderr\" | \"pulumi-log\";\n}\n\n/**\n * Emits a delimited `<infracraft-hint>` block of reminders for AI coding agents\n * operating this Pulumi stack — modeled on Vercel's `AGENTS.md` guidance: a\n * delimited block, an agent-directed intro, then terse directive bullets.\n *\n * No-op for humans (no agent env var) unless `enabled` is forced. Call it once at\n * the top of your Pulumi program; the infracraft defaults are always included and\n * `project` lines are appended.\n *\n * @param options Project reminders, channel, and detection override.\n * @returns Nothing; emits to the chosen channel as a side effect.\n * @example\n * ```typescript\n * import * as agents from \"@infracraft/pulumi/agents\";\n *\n * agents.hint({\n *   project: [\n *     \"Production is protected — `unprotect <urn>` first for a deliberate change\",\n *     \"Feature env = imports:[staging], zero config; pulumi destroy is safe\",\n *   ],\n * });\n * ```\n */\nexport function hint(options: AgentHintOptions = {}): void {\n\tconst enabled =\n\t\toptions.enabled ?? (!!process.env.CLAUDECODE || !!process.env.AI_AGENT);\n\n\tif (!enabled) {\n\t\treturn;\n\t}\n\n\tconst lines = [...INFRACRAFT_DEFAULTS, ...(options.project ?? [])];\n\n\tconst block = [\n\t\t\"<infracraft-hint>\",\n\t\t\"Reminders for AI agents operating this Pulumi stack:\",\n\t\t...lines.map((line) => `- ${line}`),\n\t\t\"</infracraft-hint>\",\n\t].join(\"\\n\");\n\n\tif (options.channel === \"pulumi-log\") {\n\t\tpulumi.log.info(block);\n\t} else {\n\t\tprocess.stderr.write(`${block}\\n`);\n\t}\n}\n"],"mappings":";;;;;;;;;;AAMA,MAAM,sBAAsB;CAC3B;CACA;CACA;AACD;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,SAAgB,KAAK,UAA4B,CAAC,GAAS;CAI1D,IAAI,EAFH,QAAQ,YAAY,CAAC,CAAC,QAAQ,IAAI,cAAc,CAAC,CAAC,QAAQ,IAAI,YAG9D;CAKD,MAAM,QAAQ;EACb;EACA;EACA,GAAG,CALW,GAAG,qBAAqB,GAAI,QAAQ,WAAW,CAAC,CAKvD,EAAE,KAAK,SAAS,KAAK,MAAM;EAClC;CACD,EAAE,KAAK,IAAI;CAEX,IAAI,QAAQ,YAAY,cACvB,eAAO,IAAI,KAAK,KAAK;MAErB,QAAQ,OAAO,MAAM,GAAG,MAAM,GAAG;AAEnC"}

package/dist/agents/hint.d.cts

@@ -0,0 +1,47 @@
+import { t as __name } from "../chunk-OPjESj5l.cjs";
+
+//#region src/agents/hint.d.ts
+/** Options for {@link agentHint}. */
+interface AgentHintOptions {
+  /** Project-specific reminders appended after the infracraft defaults. */
+  project?: string[];
+  /**
+   * Force the hint on or off. Defaults to auto-detecting an AI coding agent via
+   * the `CLAUDECODE` / `AI_AGENT` environment variables.
+   */
+  enabled?: boolean;
+  /**
+   * Where to write the hint. `"stderr"` (default) prints it prominently the
+   * instant the program loads, before Pulumi's own output — modeled on how the
+   * Vercel CLI surfaces agent guidance. `"pulumi-log"` routes it through
+   * `pulumi.log.info` (lands in the Diagnostics section instead).
+   */
+  channel?: "stderr" | "pulumi-log";
+}
+/**
+ * Emits a delimited `<infracraft-hint>` block of reminders for AI coding agents
+ * operating this Pulumi stack — modeled on Vercel's `AGENTS.md` guidance: a
+ * delimited block, an agent-directed intro, then terse directive bullets.
+ *
+ * No-op for humans (no agent env var) unless `enabled` is forced. Call it once at
+ * the top of your Pulumi program; the infracraft defaults are always included and
+ * `project` lines are appended.
+ *
+ * @param options Project reminders, channel, and detection override.
+ * @returns Nothing; emits to the chosen channel as a side effect.
+ * @example
+ * ```typescript
+ * import * as agents from "@infracraft/pulumi/agents";
+ *
+ * agents.hint({
+ *   project: [
+ *     "Production is protected — `unprotect <urn>` first for a deliberate change",
+ *     "Feature env = imports:[staging], zero config; pulumi destroy is safe",
+ *   ],
+ * });
+ * ```
+ */
+declare function hint(options?: AgentHintOptions): void;
+//#endregion
+export { AgentHintOptions, hint };
+//# sourceMappingURL=hint.d.cts.map

package/dist/agents/hint.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hint.d.cts","names":[],"sources":["../../src/agents/hint.ts"],"mappings":";;;;UAaiB,gBAAA;;EAEhB,OAAA;EAFgC;;;;EAQhC,OAAA;EAQA;;AAAO;AA0BR;;;EA1BC,OAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;iBA0Be,IAAA,CAAK,OAA8B,GAArB,gBAAqB"}

package/dist/agents/hint.d.mts

@@ -0,0 +1,47 @@
+import { t as __name } from "../chunk-OPjESj5l.mjs";
+
+//#region src/agents/hint.d.ts
+/** Options for {@link agentHint}. */
+interface AgentHintOptions {
+  /** Project-specific reminders appended after the infracraft defaults. */
+  project?: string[];
+  /**
+   * Force the hint on or off. Defaults to auto-detecting an AI coding agent via
+   * the `CLAUDECODE` / `AI_AGENT` environment variables.
+   */
+  enabled?: boolean;
+  /**
+   * Where to write the hint. `"stderr"` (default) prints it prominently the
+   * instant the program loads, before Pulumi's own output — modeled on how the
+   * Vercel CLI surfaces agent guidance. `"pulumi-log"` routes it through
+   * `pulumi.log.info` (lands in the Diagnostics section instead).
+   */
+  channel?: "stderr" | "pulumi-log";
+}
+/**
+ * Emits a delimited `<infracraft-hint>` block of reminders for AI coding agents
+ * operating this Pulumi stack — modeled on Vercel's `AGENTS.md` guidance: a
+ * delimited block, an agent-directed intro, then terse directive bullets.
+ *
+ * No-op for humans (no agent env var) unless `enabled` is forced. Call it once at
+ * the top of your Pulumi program; the infracraft defaults are always included and
+ * `project` lines are appended.
+ *
+ * @param options Project reminders, channel, and detection override.
+ * @returns Nothing; emits to the chosen channel as a side effect.
+ * @example
+ * ```typescript
+ * import * as agents from "@infracraft/pulumi/agents";
+ *
+ * agents.hint({
+ *   project: [
+ *     "Production is protected — `unprotect <urn>` first for a deliberate change",
+ *     "Feature env = imports:[staging], zero config; pulumi destroy is safe",
+ *   ],
+ * });
+ * ```
+ */
+declare function hint(options?: AgentHintOptions): void;
+//#endregion
+export { AgentHintOptions, hint };
+//# sourceMappingURL=hint.d.mts.map

package/dist/agents/hint.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hint.d.mts","names":[],"sources":["../../src/agents/hint.ts"],"mappings":";;;;UAaiB,gBAAA;;EAEhB,OAAA;EAFgC;;;;EAQhC,OAAA;EAQA;;AAAO;AA0BR;;;EA1BC,OAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;iBA0Be,IAAA,CAAK,OAA8B,GAArB,gBAAqB"}

package/dist/agents/hint.mjs

@@ -0,0 +1,51 @@
+import { t as __name } from "../chunk-OPjESj5l.mjs";
+import * as pulumi from "@pulumi/pulumi";
+
+//#region src/agents/hint.ts
+/**
+* Generic infracraft reminders, prepended to every hint. These hold for any
+* infracraft stack regardless of the consuming project.
+*/
+const INFRACRAFT_DEFAULTS = [
+	"Adopt-or-create: re-running is safe — existing resources are adopted, missing ones created",
+	"Shared resources (Railway services/projects, Neon projects) have no-op deletes — destroy never removes them",
+	"Mark shared/production resources protect:true — pulumi destroy aborts on protected resources"
+];
+/**
+* Emits a delimited `<infracraft-hint>` block of reminders for AI coding agents
+* operating this Pulumi stack — modeled on Vercel's `AGENTS.md` guidance: a
+* delimited block, an agent-directed intro, then terse directive bullets.
+*
+* No-op for humans (no agent env var) unless `enabled` is forced. Call it once at
+* the top of your Pulumi program; the infracraft defaults are always included and
+* `project` lines are appended.
+*
+* @param options Project reminders, channel, and detection override.
+* @returns Nothing; emits to the chosen channel as a side effect.
+* @example
+* ```typescript
+* import * as agents from "@infracraft/pulumi/agents";
+*
+* agents.hint({
+*   project: [
+*     "Production is protected — `unprotect <urn>` first for a deliberate change",
+*     "Feature env = imports:[staging], zero config; pulumi destroy is safe",
+*   ],
+* });
+* ```
+*/
+function hint(options = {}) {
+	if (!(options.enabled ?? (!!process.env.CLAUDECODE || !!process.env.AI_AGENT))) return;
+	const block = [
+		"<infracraft-hint>",
+		"Reminders for AI agents operating this Pulumi stack:",
+		...[...INFRACRAFT_DEFAULTS, ...options.project ?? []].map((line) => `- ${line}`),
+		"</infracraft-hint>"
+	].join("\n");
+	if (options.channel === "pulumi-log") pulumi.log.info(block);
+	else process.stderr.write(`${block}\n`);
+}
+
+//#endregion
+export { hint };
+//# sourceMappingURL=hint.mjs.map

package/dist/agents/hint.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hint.mjs","names":[],"sources":["../../src/agents/hint.ts"],"sourcesContent":["import * as pulumi from \"@pulumi/pulumi\";\n\n/**\n * Generic infracraft reminders, prepended to every hint. These hold for any\n * infracraft stack regardless of the consuming project.\n */\nconst INFRACRAFT_DEFAULTS = [\n\t\"Adopt-or-create: re-running is safe — existing resources are adopted, missing ones created\",\n\t\"Shared resources (Railway services/projects, Neon projects) have no-op deletes — destroy never removes them\",\n\t\"Mark shared/production resources protect:true — pulumi destroy aborts on protected resources\",\n];\n\n/** Options for {@link agentHint}. */\nexport interface AgentHintOptions {\n\t/** Project-specific reminders appended after the infracraft defaults. */\n\tproject?: string[];\n\n\t/**\n\t * Force the hint on or off. Defaults to auto-detecting an AI coding agent via\n\t * the `CLAUDECODE` / `AI_AGENT` environment variables.\n\t */\n\tenabled?: boolean;\n\n\t/**\n\t * Where to write the hint. `\"stderr\"` (default) prints it prominently the\n\t * instant the program loads, before Pulumi's own output — modeled on how the\n\t * Vercel CLI surfaces agent guidance. `\"pulumi-log\"` routes it through\n\t * `pulumi.log.info` (lands in the Diagnostics section instead).\n\t */\n\tchannel?: \"stderr\" | \"pulumi-log\";\n}\n\n/**\n * Emits a delimited `<infracraft-hint>` block of reminders for AI coding agents\n * operating this Pulumi stack — modeled on Vercel's `AGENTS.md` guidance: a\n * delimited block, an agent-directed intro, then terse directive bullets.\n *\n * No-op for humans (no agent env var) unless `enabled` is forced. Call it once at\n * the top of your Pulumi program; the infracraft defaults are always included and\n * `project` lines are appended.\n *\n * @param options Project reminders, channel, and detection override.\n * @returns Nothing; emits to the chosen channel as a side effect.\n * @example\n * ```typescript\n * import * as agents from \"@infracraft/pulumi/agents\";\n *\n * agents.hint({\n *   project: [\n *     \"Production is protected — `unprotect <urn>` first for a deliberate change\",\n *     \"Feature env = imports:[staging], zero config; pulumi destroy is safe\",\n *   ],\n * });\n * ```\n */\nexport function hint(options: AgentHintOptions = {}): void {\n\tconst enabled =\n\t\toptions.enabled ?? (!!process.env.CLAUDECODE || !!process.env.AI_AGENT);\n\n\tif (!enabled) {\n\t\treturn;\n\t}\n\n\tconst lines = [...INFRACRAFT_DEFAULTS, ...(options.project ?? [])];\n\n\tconst block = [\n\t\t\"<infracraft-hint>\",\n\t\t\"Reminders for AI agents operating this Pulumi stack:\",\n\t\t...lines.map((line) => `- ${line}`),\n\t\t\"</infracraft-hint>\",\n\t].join(\"\\n\");\n\n\tif (options.channel === \"pulumi-log\") {\n\t\tpulumi.log.info(block);\n\t} else {\n\t\tprocess.stderr.write(`${block}\\n`);\n\t}\n}\n"],"mappings":";;;;;;;;AAMA,MAAM,sBAAsB;CAC3B;CACA;CACA;AACD;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,SAAgB,KAAK,UAA4B,CAAC,GAAS;CAI1D,IAAI,EAFH,QAAQ,YAAY,CAAC,CAAC,QAAQ,IAAI,cAAc,CAAC,CAAC,QAAQ,IAAI,YAG9D;CAKD,MAAM,QAAQ;EACb;EACA;EACA,GAAG,CALW,GAAG,qBAAqB,GAAI,QAAQ,WAAW,CAAC,CAKvD,EAAE,KAAK,SAAS,KAAK,MAAM;EAClC;CACD,EAAE,KAAK,IAAI;CAEX,IAAI,QAAQ,YAAY,cACvB,OAAO,IAAI,KAAK,KAAK;MAErB,QAAQ,OAAO,MAAM,GAAG,MAAM,GAAG;AAEnC"}

package/dist/agents/index.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_agents_hint = require('./hint.cjs');
+
+exports.hint = require_agents_hint.hint;

package/dist/agents/index.d.cts

@@ -0,0 +1,2 @@
+import { AgentHintOptions, hint } from "./hint.cjs";
+export { type AgentHintOptions, hint };

package/dist/agents/index.d.mts

@@ -0,0 +1,2 @@
+import { AgentHintOptions, hint } from "./hint.mjs";
+export { type AgentHintOptions, hint };

package/dist/agents/index.mjs

@@ -0,0 +1,3 @@
+import { hint } from "./hint.mjs";
+
+export { hint };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@infracraft/pulumi",
-	"version": "1.9.0",
+	"version": "1.11.0",
 	"type": "module",
 	"license": "MIT",
 	"repository": {
@@ -25,6 +25,10 @@
 			"types": "./dist/fly/index.d.mts",
 			"default": "./dist/fly/index.mjs"
 		},
+		"./agents": {
+			"types": "./dist/agents/index.d.mts",
+			"default": "./dist/agents/index.mjs"
+		},
 		"./hash": {
 			"types": "./dist/hash.d.mts",
 			"default": "./dist/hash.mjs"