@intentius/chant-lexicon-aws 0.0.6 → 0.0.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-aws",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "license": "Apache-2.0",
   "type": "module",
   "files": ["src/", "dist/"],

package/src/codegen/__snapshots__/snapshot.test.ts.snap

@@ -3,7 +3,7 @@
 exports[`snapshot tests Bucket lexicon entry 1`] = `
 {
   "attrs": {
-    "arn": "Arn",
+    "Arn": "Arn",
   },
   "createOnly": [
     "BucketName",
@@ -27,7 +27,7 @@ exports[`snapshot tests Bucket lexicon entry 1`] = `
 exports[`snapshot tests Function lexicon entry 1`] = `
 {
   "attrs": {
-    "arn": "Arn",
+    "Arn": "Arn",
   },
   "kind": "resource",
   "lexicon": "aws",
@@ -79,8 +79,8 @@ exports[`snapshot tests Function lexicon entry 1`] = `
 exports[`snapshot tests Role lexicon entry 1`] = `
 {
   "attrs": {
-    "arn": "Arn",
-    "roleId": "RoleId",
+    "Arn": "Arn",
+    "RoleId": "RoleId",
   },
   "kind": "resource",
   "lexicon": "aws",
@@ -160,17 +160,17 @@ exports[`snapshot tests Bucket .d.ts class declaration 1`] = `
 "export declare class Bucket {
   constructor(props: {
     /** A name for the bucket. */
-    bucketName: string;
+    BucketName: string;
     /** The Amazon Resource Name (ARN) of the bucket. */
-    arn?: string;
+    Arn?: string;
     /** Specifies default encryption for a bucket. */
-    bucketEncryption?: Bucket_BucketEncryption;
+    BucketEncryption?: Bucket_BucketEncryption;
     /** An arbitrary set of tags (key-value pairs) for this S3 bucket. */
-    tags?: Bucket_Tag[];
+    Tags?: Bucket_Tag[];
     /** Enables multiple versions of all objects in this bucket. */
-    versioningConfiguration?: Bucket_VersioningConfiguration;
+    VersioningConfiguration?: Bucket_VersioningConfiguration;
   });
-  readonly arn: string;
+  readonly Arn: string;
 }"
 `;
 
@@ -178,20 +178,20 @@ exports[`snapshot tests Function .d.ts class declaration 1`] = `
 "export declare class Function {
   constructor(props: {
     /** The code for the function. */
-    code: Function_Code;
+    Code: Function_Code;
     /** The ARN of the function's execution role. */
-    role: string;
+    Role: string;
     /** The ARN of the function. */
-    arn?: string;
+    Arn?: string;
     /** The name of the Lambda function. */
-    functionName?: string;
+    FunctionName?: string;
     /** The name of the method within your code that Lambda calls to run your function. */
-    handler?: string;
+    Handler?: string;
     /** The amount of memory available to the function at runtime. */
-    memorySize?: number;
+    MemorySize?: number;
     /** The identifier of the function's runtime. */
-    runtime?: "java17" | "java21" | "nodejs18.x" | "nodejs20.x" | "python3.11" | "python3.12";
+    Runtime?: "java17" | "java21" | "nodejs18.x" | "nodejs20.x" | "python3.11" | "python3.12";
   });
-  readonly arn: string;
+  readonly Arn: string;
 }"
 `;

package/src/codegen/docs.ts

@@ -152,7 +152,7 @@ Produces this CloudFormation resource:
 }
 \`\`\`
 
-Notice how \`dataBucket\` becomes \`DataBucket\` (PascalCase logical ID), and \`bucketName\` becomes \`BucketName\`. This mapping is automatic.
+Notice how \`dataBucket\` becomes \`DataBucket\` (PascalCase logical ID). Property names like \`BucketName\` use the CloudFormation spec-native PascalCase directly.
 
 ## Resource types and naming
 
@@ -517,7 +517,7 @@ Pass CloudFormation Parameters to child stacks with the \`parameters\` option:
 \`\`\`typescript
 import { nestedStack } from "@intentius/chant-lexicon-aws";
 
-const network = nestedStack("network", import.meta.dir + "/network", {
+const network = nestedStack("network", import.meta.dirname + "/network", {
   parameters: { Environment: "prod", CidrBlock: "10.0.0.0/16" },
 });
 \`\`\`
@@ -739,8 +739,8 @@ src/
 **Patterns demonstrated:**
 
 1. **Direct imports** — lexicon types come from \`@intentius/chant-lexicon-aws\`, sibling exports are imported from the file that defines them
-2. **Shared defaults** — \`defaults.ts\` exports reusable property objects (\`bucketEncryption\`, \`publicAccessBlock\`) that other files import directly
-3. **Cross-resource references** — \`dataBucket.arn\` in \`handler.ts\` serializes to \`Fn::GetAtt\` in the template
+2. **Shared defaults** — \`defaults.ts\` exports reusable property objects (\`BucketEncryption\`, \`PublicAccessBlockConfiguration\`) that other files import directly
+3. **Cross-resource references** — \`dataBucket.Arn\` in \`handler.ts\` serializes to \`Fn::GetAtt\` in the template
 4. **Intrinsics** — \`Sub\` tagged templates with pseudo-parameters for dynamic naming
 
 {{file:getting-started/src/handler.ts}}
@@ -798,6 +798,61 @@ src/
 
 See [Nested Stacks](./nested-stacks) for the full guide.`,
       },
+      {
+        slug: "skills",
+        title: "AI Skills",
+        description: "AI agent skills bundled with the AWS CloudFormation lexicon",
+        content: `The AWS lexicon ships an AI skill called **chant-aws** that teaches AI coding agents (like Claude Code) how to build, validate, and deploy CloudFormation templates from a chant project.
+
+## What are skills?
+
+Skills are structured markdown documents bundled with a lexicon. When an AI agent works in a chant project, it discovers and loads relevant skills automatically — giving it operational knowledge about the deployment workflow without requiring the user to explain each step.
+
+## Installation
+
+When you scaffold a new project with \`chant init --lexicon aws\`, the skill is installed to \`.claude/skills/chant-aws/SKILL.md\` for automatic discovery by Claude Code.
+
+For existing projects, create the file manually:
+
+\`\`\`
+.claude/
+  skills/
+    chant-aws/
+      SKILL.md    # skill content (see below)
+\`\`\`
+
+## Skill: chant-aws
+
+The \`chant-aws\` skill covers the full deployment lifecycle:
+
+- **Build** — \`chant build src/ --output stack.json\`
+- **Validate** — \`chant lint src/\` + \`aws cloudformation validate-template\`
+- **Deploy** — \`aws cloudformation deploy\` with capabilities
+- **Update** — change sets for preview, or direct deploy
+- **Delete** — \`aws cloudformation delete-stack\`
+- **Status** — \`describe-stacks\` and \`describe-stack-events\`
+- **Troubleshooting** — event inspection, rollback recovery, drift detection
+
+The skill is invocable as a slash command: \`/chant-aws\`
+
+## MCP integration
+
+The lexicon also provides MCP (Model Context Protocol) tools and resources that AI agents can use programmatically:
+
+| MCP tool | Description |
+|----------|-------------|
+| \`build\` | Build the chant project |
+| \`lint\` | Run lint rules |
+| \`explain\` | Summarize project resources |
+| \`scaffold\` | Generate starter files |
+| \`search\` | Search available resource types |
+| \`aws:diff\` | Compare current build output against previous |
+
+| MCP resource | Description |
+|--------------|-------------|
+| \`resource-catalog\` | JSON list of all supported CloudFormation resource types |
+| \`examples/basic-stack\` | Example stack with S3 bucket and IAM role |`,
+      },
     ],
   };
 

package/src/codegen/generate.ts

@@ -152,17 +152,6 @@ export function writeGeneratedFiles(result: GenerateResult, baseDir: string): vo
         "",
       ].join("\n"),
     },
-    snapshot: (generatedDir) => {
-      const { snapshotArtifacts, saveSnapshot } = require("./rollback");
-      const lexiconPath = join(generatedDir, "lexicon-aws.json");
-      if (existsSync(lexiconPath)) {
-        const snapshot = snapshotArtifacts(generatedDir);
-        if (Object.keys(snapshot.files).length > 0) {
-          const snapshotsDir = join(baseDir, ".snapshots");
-          saveSnapshot(snapshot, snapshotsDir);
-        }
-      }
-    },
   });
 }
 
@@ -184,8 +173,7 @@ function generateRuntimeIndex(
     // Build attrs map
     const attrs: Record<string, string> = {};
     for (const a of r.resource.attributes) {
-      const camelName = a.name.charAt(0).toLowerCase() + a.name.slice(1);
-      attrs[camelName] = a.name;
+      attrs[a.name] = a.name;
     }
 
     resourceEntries.push({ tsName, resourceType: cfnType, attrs });

package/src/codegen/package.ts

@@ -3,7 +3,9 @@
  * with AWS-specific manifest building and skill collection.
  */
 
+import { createRequire } from "module";
 import { readFileSync } from "fs";
+const require = createRequire(import.meta.url);
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 import type { IntrinsicDef } from "@intentius/chant/lexicon";

package/src/codegen/typecheck.test.ts

@@ -6,7 +6,7 @@ describe("typecheckDTS", () => {
     const content = `
       export declare class Bucket {
         readonly type: string;
-        readonly bucketName?: string;
+        readonly BucketName?: string;
       }
     `;
     const result = await typecheckDTS(content);