@intentius/chant-lexicon-azure 0.37.0 → 0.38.0

package/dist/codegen/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/codegen/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAyFH;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9E"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/codegen/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAwFH;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9E"}

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "bc503f53d6bf2deade950968028c37335319c8868a0f7512e260d20f10dbfeed",
+    "manifest.json": "89559fdc63632e7cbaeb195d455ac1db336eb82f6a23a5572ddc6c08a026c65b",
     "meta.json": "051fb4ee43f7de48a36f1abc59c8ff5207c3b75aa28f13db6440b9f5b0337605",
     "types/index.d.ts": "617a6de433bd92a126170a7f5ae903d6d7aa83fbb0b57169d3450b5a13e72e0d",
     "rules/hardcoded-location.ts": "a9b1d1cec93f2ca9c5206641f53fc9621cefcfd2c00b3ab89c194b30a75fa949",
@@ -33,5 +33,5 @@
     "skills/chant-azure-patterns.md": "1a3bacfac612826b77332d2692a59195638db9f1b5e8ea2eda7579621d25f603",
     "skills/chant-azure-aks.md": "2d4e0098c1a22b54ffadd410564d9df0f3a04cb4eb7c6261f20ae33106e7aca8"
   },
-  "composite": "dff5b3422ce14b471818bb6b2799870cb3ce0d55d6caae6e0fc2164dce02830b"
+  "composite": "eb179778297979d924b6757f7b4b582220a69e508dcdb6092c1da311e53da90e"
 }

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "azure",
-  "version": "0.37.0",
+  "version": "0.38.0",
   "chantVersion": ">=0.1.0",
   "namespace": "Azure",
   "intrinsics": [

package/dist/op/activities/floci-az.d.ts

@@ -1,9 +1,10 @@
+import { type EmulatorCapability, type EmulatorSpec } from "@intentius/chant/op";
 export interface FlociAzUpArgs {
     /** Container name. Default: `chant-floci-az`. */
     name?: string;
     /** Host port mapped to the emulator's `:4577`. Default: `4577`. */
     port?: number;
-    /** Image. Default: `floci/floci-az:latest`. */
+    /** Image. Default: the pinned `floci/floci-az` tag. */
     image?: string;
     /** Readiness timeout in ms. Default: `60000`. */
     timeoutMs?: number;
@@ -14,6 +15,18 @@ export interface FlociAzDownArgs {
     /** Container name to remove. Default: `chant-floci-az`. */
     name?: string;
 }
+export declare const FLOCI_AZ_SPEC: EmulatorSpec;
+/**
+ * The azure plugin's emulator capability (#1345).
+ *
+ * The spec below has existed since #746; what was missing was declaring it, so
+ * `chant emulator up --all` booted Floci and nothing else even though floci-az
+ * was one line away. `AZURE_ENDPOINT_URL` is the var azure's own
+ * `describe-resources.ts` and `deep-observe.ts` already read on every live
+ * call, which is also what makes `--live --env <local>` reach the emulator
+ * instead of real Azure.
+ */
+export declare const FLOCI_AZ_EMULATOR: EmulatorCapability;
 export declare const flociAzExistsCommand: (name: string) => string;
 export declare const flociAzRmCommand: (name: string) => string;
 export declare const flociAzHealthUrl: (port: number) => string;

package/dist/op/activities/floci-az.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"floci-az.d.ts","sourceRoot":"","sources":["../../../src/op/activities/floci-az.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAWD,eAAO,MAAM,oBAAoB,0BAAmB,CAAC;AACrD,eAAO,MAAM,gBAAgB,0BAAe,CAAC;AAC7C,eAAO,MAAM,gBAAgB,0BAAe,CAAC;AAC7C,0EAA0E;AAC1E,eAAO,MAAM,eAAe,0BAAc,CAAC;AAC3C,eAAO,MAAM,iBAAiB,GAAI,OAAM,aAAkB,KAAG,MAA6B,CAAC;AAE3F,oFAAoF;AACpF,eAAO,MAAM,SAAS,GAAI,OAAM,aAAkB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAClF,CAAC;AAEtB,4EAA4E;AAC5E,eAAO,MAAM,WAAW,GAAI,OAAM,eAAoB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC,IAAI,CACpE,CAAC"}
+{"version":3,"file":"floci-az.d.ts","sourceRoot":"","sources":["../../../src/op/activities/floci-az.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEpG,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,eAAO,MAAM,aAAa,EAAE,YAM3B,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,EAAE,kBAG/B,CAAC;AAIF,eAAO,MAAM,oBAAoB,0BAAmB,CAAC;AACrD,eAAO,MAAM,gBAAgB,0BAAe,CAAC;AAC7C,eAAO,MAAM,gBAAgB,0BAAe,CAAC;AAC7C,0EAA0E;AAC1E,eAAO,MAAM,eAAe,0BAAc,CAAC;AAC3C,eAAO,MAAM,iBAAiB,GAAI,OAAM,aAAkB,KAAG,MAA6B,CAAC;AAE3F,oFAAoF;AACpF,eAAO,MAAM,SAAS,GAAI,OAAM,aAAkB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAClF,CAAC;AAEtB,4EAA4E;AAC5E,eAAO,MAAM,WAAW,GAAI,OAAM,eAAoB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC,IAAI,CACpE,CAAC"}

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,0BAA0B,CAAC;AAuB5E;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,aAqczB,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,0BAA0B,CAAC;AAyB5E;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,aAgdzB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-azure",
-  "version": "0.37.0",
+  "version": "0.38.0",
   "description": "Azure lexicon for chant — declarative IaC in TypeScript",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -74,7 +74,7 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.37.0",
+    "@intentius/chant": "^0.38.0",
     "typescript": "^5.9.3"
   }
 }

package/src/codegen/docs.ts

@@ -75,7 +75,6 @@ const docsConfig: DocsConfig = {
   // `lint-rules` below is the rules documentation; the generated `rules` table
   // would duplicate it and land in no sidebar (#1312). aws, k8s, gitlab and
   // github already suppress it for the same reason.
-  suppressPages: ["rules"],
   // These pages are hand-written files under docs/src/content/docs/. The
   // pipeline preserves pages it did not emit, but Starlight has no
   // auto-discovery, so without an entry here they are reachable only by URL —

package/src/lifecycle-integration.test.ts

@@ -125,6 +125,7 @@ describe("azure lifecycle integration (#163)", () => {
 // The shared conformance suite (#1089).
 describeObservationConformance({
   lexicon: "azure",
+  ownershipChannel: azurePlugin.ownershipChannel,
   scenarios: [
     {
       name: "a nested ARM type the reader cannot address",

package/src/op/activities/floci-az.test.ts

@@ -10,7 +10,7 @@ import {
 describe("floci-az lifecycle commands (typed emulator, not shell)", () => {
   test("run command uses defaults and maps the port", () => {
     expect(flociAzRunCommand({})).toBe(
-      "docker run -d --rm --name chant-floci-az -p 4577:4577 floci/floci-az:latest",
+      "docker run -d --rm --name chant-floci-az -p 4577:4577 floci/floci-az:0.10.0",
     );
   });
 

package/src/op/activities/floci-az.ts

@@ -1,11 +1,11 @@
-import { emulatorLifecycle } from "@intentius/chant/op";
+import { emulatorLifecycle, type EmulatorCapability, type EmulatorSpec } from "@intentius/chant/op";
 
 export interface FlociAzUpArgs {
   /** Container name. Default: `chant-floci-az`. */
   name?: string;
   /** Host port mapped to the emulator's `:4577`. Default: `4577`. */
   port?: number;
-  /** Image. Default: `floci/floci-az:latest`. */
+  /** Image. Default: the pinned `floci/floci-az` tag. */
   image?: string;
   /** Readiness timeout in ms. Default: `60000`. */
   timeoutMs?: number;
@@ -20,12 +20,32 @@ export interface FlociAzDownArgs {
 
 // floci-az is a bespoke ARM fake (not LocalStack) — a plain 200 on its health
 // endpoint means ready. Shared lifecycle: emulatorLifecycle (#746).
-const az = emulatorLifecycle({
+// Pinned rather than `:latest` (#1345): an image that moves underneath a
+// passing local suite is exactly the drift a pin exists to stop.
+export const FLOCI_AZ_SPEC: EmulatorSpec = {
   name: "chant-floci-az",
-  image: "floci/floci-az:latest",
+  image: "floci/floci-az:0.10.0",
   containerPort: 4577,
   healthPath: "/_floci/health",
-});
+  upstream: { repo: "floci-io/floci-az" },
+};
+
+/**
+ * The azure plugin's emulator capability (#1345).
+ *
+ * The spec below has existed since #746; what was missing was declaring it, so
+ * `chant emulator up --all` booted Floci and nothing else even though floci-az
+ * was one line away. `AZURE_ENDPOINT_URL` is the var azure's own
+ * `describe-resources.ts` and `deep-observe.ts` already read on every live
+ * call, which is also what makes `--live --env <local>` reach the emulator
+ * instead of real Azure.
+ */
+export const FLOCI_AZ_EMULATOR: EmulatorCapability = {
+  spec: FLOCI_AZ_SPEC,
+  env: (endpoint) => ({ AZURE_ENDPOINT_URL: endpoint }),
+};
+
+const az = emulatorLifecycle(FLOCI_AZ_SPEC);
 
 export const flociAzExistsCommand = az.existsCommand;
 export const flociAzRmCommand = az.rmCommand;

package/src/plugin.test.ts

@@ -185,7 +185,7 @@ describe("azurePlugin", () => {
 
     test("lookup-resource tool has correct structure", () => {
       const tools = azurePlugin.mcpTools!();
-      const lookupTool = tools.find((t) => t.name === "lookup-resource");
+      const lookupTool = tools.find((t) => t.name === "azure:lookup-resource");
       expect(lookupTool).toBeDefined();
       expect(lookupTool!.description.length).toBeGreaterThan(0);
       expect(lookupTool!.inputSchema.type).toBe("object");
@@ -195,7 +195,7 @@ describe("azurePlugin", () => {
 
     test("lookup-resource tool schema has query as required", () => {
       const tools = azurePlugin.mcpTools!();
-      const lookupTool = tools.find((t) => t.name === "lookup-resource")!;
+      const lookupTool = tools.find((t) => t.name === "azure:lookup-resource")!;
       expect(lookupTool.inputSchema.required).toContain("query");
     });
   });
@@ -212,7 +212,7 @@ describe("azurePlugin", () => {
 
     test("catalog has correct structure", () => {
       const resources = azurePlugin.mcpResources!();
-      const catalog = resources.find((r) => r.uri === "chant://lexicon/azure/catalog");
+      const catalog = resources.find((r) => r.uri === "resource-catalog");
       expect(catalog).toBeDefined();
       expect(catalog!.name.length).toBeGreaterThan(0);
       expect(catalog!.description.length).toBeGreaterThan(0);

package/src/plugin.ts

@@ -7,6 +7,7 @@ import type { CompletionContext, CompletionItem, HoverContext, HoverInfo } from
 import type { McpToolContribution, McpResourceContribution } from "@intentius/chant/mcp/types";
 import { postSynthChecks as postSynthCheckList } from "./lint/post-synth";
 import { azureAuditCatalog } from "./lint/audit-catalog";
+import { FLOCI_AZ_EMULATOR } from "./op/activities/floci-az";
 import { createSkillsLoader } from "@intentius/chant/lexicon-plugin-helpers";
 import { readFileSync, readdirSync, existsSync } from "fs";
 import { join, dirname } from "path";
@@ -20,6 +21,7 @@ import { ArmGenerator } from "./import/generator";
 import { azureCompletions } from "./lsp/completions";
 import { azureHover } from "./lsp/hover";
 import { azureDeepNormalizationHooks, observeResourcesDeepAzure } from "./deep-observe";
+import { AZURE_TAG_OWNERSHIP_KEYS } from "./ownership";
 
 /**
  * Azure Resource Manager lexicon plugin.
@@ -29,6 +31,8 @@ import { azureDeepNormalizationHooks, observeResourcesDeepAzure } from "./deep-o
  */
 export const azurePlugin: LexiconPlugin = {
   name: "azure",
+  ownershipChannel: { keys: AZURE_TAG_OWNERSHIP_KEYS, reads: ["exportResources"] },
+  emulator: FLOCI_AZ_EMULATOR,
   auditCatalog: () => azureAuditCatalog,
   serializer: azureSerializer,
 
@@ -354,7 +358,7 @@ export const tags = defaultTags([
 
   mcpTools(): McpToolContribution[] {
     return [{
-      name: "lookup-resource",
+      name: "azure:lookup-resource",
       description: "Look up an Azure resource type by name",
       inputSchema: {
         type: "object",
@@ -384,7 +388,7 @@ export const tags = defaultTags([
   mcpResources(): McpResourceContribution[] {
     return [
       {
-        uri: "chant://lexicon/azure/catalog",
+        uri: "resource-catalog",
         name: "Azure Resource Catalog",
         description: "All available Azure resource types",
         mimeType: "application/json",
@@ -398,7 +402,7 @@ export const tags = defaultTags([
         },
       },
       {
-        uri: "chant://lexicon/azure/examples",
+        uri: "examples",
         name: "Azure Example Projects",
         description: "Example project summaries with code snippets for Azure ARM templates",
         mimeType: "application/json",
@@ -480,4 +484,13 @@ export const tags = defaultTags([
     const { exportResources } = await import("./export-resources");
     return exportResources(options);
   },
+
+  /**
+   * The generator has always existed in src/codegen/docs.ts; only the package
+   * script reached it, so `plugin.docs()` was a no-op for azure alone (#1342).
+   */
+  async docs(options?: { verbose?: boolean }): Promise<void> {
+    const { generateDocs } = await import("./codegen/docs");
+    await generateDocs(options);
+  },
 };