@aetherwing/fcp-terraform 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Kind of Terraform block.
+ */
+export type BlockKind = "resource" | "data" | "provider" | "variable" | "output" | "locals" | "module";
+/**
+ * A single attribute on a block.
+ */
+export interface Attribute {
+    key: string;
+    value: string;
+    valueType: "string" | "number" | "bool" | "list" | "map" | "reference" | "expression";
+}
+/**
+ * A nested block within a resource (e.g., ingress {}, root_block_device {}).
+ */
+export interface NestedBlock {
+    id: string;
+    type: string;
+    attributes: Map<string, Attribute>;
+}
+/**
+ * A top-level Terraform block (resource, provider, variable, output, data, module).
+ */
+export interface TfBlock {
+    id: string;
+    kind: BlockKind;
+    label: string;
+    fullType: string;
+    provider: string;
+    attributes: Map<string, Attribute>;
+    nestedBlocks: NestedBlock[];
+    tags: Map<string, string>;
+    meta: {
+        count?: string;
+        forEach?: string;
+        dependsOn: string[];
+    };
+}
+/**
+ * A dependency connection between two blocks.
+ */
+export interface Connection {
+    id: string;
+    sourceId: string;
+    targetId: string;
+    sourceLabel: string;
+    targetLabel: string;
+    label?: string;
+}
+/**
+ * The full in-memory Terraform configuration.
+ */
+export interface TerraformConfig {
+    id: string;
+    title: string;
+    filePath: string | null;
+    blocks: Map<string, TfBlock>;
+    connections: Map<string, Connection>;
+    blockOrder: string[];
+}
+/**
+ * Events for undo/redo.
+ */
+export type TerraformEvent = {
+    type: "block_added";
+    block: TfBlock;
+} | {
+    type: "block_removed";
+    block: TfBlock;
+} | {
+    type: "attribute_set";
+    blockId: string;
+    key: string;
+    before: Attribute | null;
+    after: Attribute;
+} | {
+    type: "attribute_removed";
+    blockId: string;
+    key: string;
+    before: Attribute;
+} | {
+    type: "nested_block_added";
+    blockId: string;
+    nestedBlock: NestedBlock;
+} | {
+    type: "nested_block_removed";
+    blockId: string;
+    nestedBlock: NestedBlock;
+} | {
+    type: "connection_added";
+    connection: Connection;
+} | {
+    type: "connection_removed";
+    connection: Connection;
+} | {
+    type: "tag_set";
+    blockId: string;
+    key: string;
+    before: string | null;
+    after: string;
+} | {
+    type: "tag_removed";
+    blockId: string;
+    key: string;
+    before: string;
+} | {
+    type: "block_renamed";
+    blockId: string;
+    before: string;
+    after: string;
+} | {
+    type: "title_changed";
+    before: string;
+    after: string;
+};

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/verbs.d.ts

@@ -0,0 +1,3 @@
+import type { VerbSpec } from "@aetherwing/fcp-core";
+export declare const VERB_SPECS: VerbSpec[];
+export declare const REFERENCE_CARD_SECTIONS: Record<string, string>;

package/dist/verbs.js

@@ -0,0 +1,40 @@
+export const VERB_SPECS = [
+    // Resources & Providers
+    { verb: "add", syntax: 'add resource TYPE LABEL [key:value...]', category: "Resources", description: "Add a resource, provider, variable, output, data source, or module" },
+    { verb: "add", syntax: 'add provider PROVIDER [region:R] [key:value...]', category: "Resources" },
+    { verb: "add", syntax: 'add variable NAME [type:T] [default:V] [description:D]', category: "Resources" },
+    { verb: "add", syntax: 'add output NAME value:EXPR [description:D]', category: "Resources" },
+    { verb: "add", syntax: 'add data TYPE LABEL [key:value...]', category: "Resources" },
+    { verb: "add", syntax: 'add module LABEL source:PATH [key:value...]', category: "Resources" },
+    // Connections
+    { verb: "connect", syntax: 'connect SRC -> TGT [label:TEXT]', category: "Connections", description: "Create a dependency between two blocks" },
+    { verb: "disconnect", syntax: 'disconnect SRC -> TGT', category: "Connections", description: "Remove a dependency" },
+    // Editing
+    { verb: "set", syntax: 'set LABEL key:value [key:value...]', category: "Editing", description: "Set attributes on an existing block" },
+    { verb: "unset", syntax: 'unset LABEL KEY [KEY...]', category: "Editing", description: "Remove attributes from a block" },
+    { verb: "remove", syntax: 'remove LABEL | remove @SELECTOR', category: "Editing", description: "Remove a block by label or selector" },
+    { verb: "label", syntax: 'label OLD_LABEL "new_label"', category: "Editing", description: "Rename a block" },
+    { verb: "style", syntax: 'style LABEL tags:"Key=Val,Key2=Val2"', category: "Editing", description: "Set tags on a resource" },
+    { verb: "nest", syntax: 'nest LABEL BLOCK_TYPE [key:value...]', category: "Editing", description: "Add a nested block (e.g., ingress, root_block_device)" },
+];
+export const REFERENCE_CARD_SECTIONS = {
+    "Selectors": [
+        "  @type:aws_instance      All resources of a given type",
+        "  @provider:aws            All blocks from a given provider",
+        "  @kind:resource            All blocks of kind (resource, variable, output, data)",
+        "  @tag:KEY or @tag:KEY=VAL  Blocks matching a tag",
+        "  @all                      All blocks",
+    ].join("\n"),
+    "Response Prefixes": [
+        "  +  block created        ~  connection created/modified",
+        "  *  block modified       -  block/connection removed",
+        "  !  meta operation       @  bulk operation",
+    ].join("\n"),
+    "Conventions": [
+        "  - Labels are unique short names — no full type paths needed",
+        "  - Provider auto-detected from resource type prefix (aws_, google_, azurerm_)",
+        "  - Use `plan` query to preview generated HCL without saving",
+        "  - Use `graph` query to visualize dependency graph",
+        "  - Call terraform_help for full reference",
+    ].join("\n"),
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@aetherwing/fcp-terraform",
+  "version": "0.1.0",
+  "description": "MCP server for Terraform HCL generation through intent-level commands",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@aetherwing/fcp-core": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1.27.1"
+  },
+  "devDependencies": {
+    "@cdktf/hcl2json": "^0.21.0",
+    "@types/node": "^22.15.2",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.1"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aetherwing-io/fcp-terraform"
+  },
+  "keywords": [
+    "terraform",
+    "hcl",
+    "infrastructure",
+    "mcp",
+    "fcp"
+  ]
+}