@infracraft/pulumi 1.10.0 → 1.11.0

package/dist/agents/hint.cjs

@@ -26,15 +26,17 @@ const INFRACRAFT_DEFAULTS = [
 * @returns Nothing; emits to the chosen channel as a side effect.
 * @example
 * ```typescript
-* agentHint({
+* 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",
+*     "Production is protected — `unprotect <urn>` first for a deliberate change",
+*     "Feature env = imports:[staging], zero config; pulumi destroy is safe",
 *   ],
 * });
 * ```
 */
-function agentHint(options = {}) {
+function hint(options = {}) {
 	if (!(options.enabled ?? (!!process.env.CLAUDECODE || !!process.env.AI_AGENT))) return;
 	const block = [
 		"<infracraft-hint>",
@@ -47,5 +49,5 @@ function agentHint(options = {}) {
 }
 
 //#endregion
-exports.agentHint = agentHint;
+exports.hint = hint;
 //# sourceMappingURL=hint.cjs.map

package/dist/agents/hint.cjs.map

@@ -1 +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 * agentHint({\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 agentHint(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;;;;;;;;;;;;;;;;;;;;;;AA2CA,SAAgB,UAAU,UAA4B,CAAC,GAAS;CAI/D,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"}
+{"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

@@ -31,15 +31,17 @@ interface AgentHintOptions {
  * @returns Nothing; emits to the chosen channel as a side effect.
  * @example
  * ```typescript
- * agentHint({
+ * 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",
+ *     "Production is protected — `unprotect <urn>` first for a deliberate change",
+ *     "Feature env = imports:[staging], zero config; pulumi destroy is safe",
  *   ],
  * });
  * ```
  */
-declare function agentHint(options?: AgentHintOptions): void;
+declare function hint(options?: AgentHintOptions): void;
 //#endregion
-export { AgentHintOptions, agentHint };
+export { AgentHintOptions, hint };
 //# sourceMappingURL=hint.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hint.d.cts","names":[],"sources":["../../src/agents/hint.ts"],"mappings":";;;;UAaiB,gBAAA;;EAEhB,OAAA;EAFgC;;;;EAQhC,OAAA;EAQA;;AAAO;AAwBR;;;EAxBC,OAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;iBAwBe,SAAA,CAAU,OAA8B,GAArB,gBAAqB"}
+{"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

@@ -31,15 +31,17 @@ interface AgentHintOptions {
  * @returns Nothing; emits to the chosen channel as a side effect.
  * @example
  * ```typescript
- * agentHint({
+ * 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",
+ *     "Production is protected — `unprotect <urn>` first for a deliberate change",
+ *     "Feature env = imports:[staging], zero config; pulumi destroy is safe",
  *   ],
  * });
  * ```
  */
-declare function agentHint(options?: AgentHintOptions): void;
+declare function hint(options?: AgentHintOptions): void;
 //#endregion
-export { AgentHintOptions, agentHint };
+export { AgentHintOptions, hint };
 //# sourceMappingURL=hint.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hint.d.mts","names":[],"sources":["../../src/agents/hint.ts"],"mappings":";;;;UAaiB,gBAAA;;EAEhB,OAAA;EAFgC;;;;EAQhC,OAAA;EAQA;;AAAO;AAwBR;;;EAxBC,OAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;iBAwBe,SAAA,CAAU,OAA8B,GAArB,gBAAqB"}
+{"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

@@ -24,15 +24,17 @@ const INFRACRAFT_DEFAULTS = [
 * @returns Nothing; emits to the chosen channel as a side effect.
 * @example
 * ```typescript
-* agentHint({
+* 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",
+*     "Production is protected — `unprotect <urn>` first for a deliberate change",
+*     "Feature env = imports:[staging], zero config; pulumi destroy is safe",
 *   ],
 * });
 * ```
 */
-function agentHint(options = {}) {
+function hint(options = {}) {
 	if (!(options.enabled ?? (!!process.env.CLAUDECODE || !!process.env.AI_AGENT))) return;
 	const block = [
 		"<infracraft-hint>",
@@ -45,5 +47,5 @@ function agentHint(options = {}) {
 }
 
 //#endregion
-export { agentHint };
+export { hint };
 //# sourceMappingURL=hint.mjs.map

package/dist/agents/hint.mjs.map

@@ -1 +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 * agentHint({\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 agentHint(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;;;;;;;;;;;;;;;;;;;;;;AA2CA,SAAgB,UAAU,UAA4B,CAAC,GAAS;CAI/D,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"}
+{"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.10.0",
+	"version": "1.11.0",
 	"type": "module",
 	"license": "MIT",
 	"repository": {
@@ -25,9 +25,9 @@
 			"types": "./dist/fly/index.d.mts",
 			"default": "./dist/fly/index.mjs"
 		},
-		"./agents/hint": {
-			"types": "./dist/agents/hint.d.mts",
-			"default": "./dist/agents/hint.mjs"
+		"./agents": {
+			"types": "./dist/agents/index.d.mts",
+			"default": "./dist/agents/index.mjs"
 		},
 		"./hash": {
 			"types": "./dist/hash.d.mts",