@intentius/chant-lexicon-fly 0.37.2 → 0.39.0

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "de4e2ecb20f4ab172c08473322d96e3c51f35ac76d90c5e5f54d27216f14329e",
+    "manifest.json": "70ff6f13c27e82785b87f22342a1cfd59fbb9e02dce1e59c70cd9696d8e0d364",
     "meta.json": "e46e65ba7544fafc6dbb3fd48b841904b5ae6f7cb4d517a940ed68b01626c097",
     "types/index.d.ts": "07f5d04d0d3831cae053b1f0f5dd661c58e9708f45067a0fc85dd94079ac144b",
     "rules/guest-sizing.ts": "bc749d218df8f3cc3d8fbe388205ae96e6b204ae0d6d77e8bf82cb936cc53ff6",
@@ -15,5 +15,5 @@
     "skills/chant-fly-ops.md": "b8eef6504e203133e6a35c83aabb08404eec95060705395515a0046d42269cf1",
     "skills/chant-fly-sprites.md": "89ba52db63a71a17eab483d99233a4ae67f5d34920445010e750f81c95200b4e"
   },
-  "composite": "d39afaec5eb09bc53115953328ddc1b0c572ce6e265a10b31193a8fe32cba9e6"
+  "composite": "0452703745228834870dff925469a260ce4eadf276f59bc0d4618e78459f9b25"
 }

package/dist/lint/audit-catalog.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The fly lexicon's chant audit catalog — metadata for the FLY post-synth
+ * checks, contributed via `flyPlugin.auditCatalog()` (#687).
+ *
+ * Both entries carry `yamlBased: false`: each check reads the chant model
+ * (`ctx.entities`) rather than the emitted manifest, because what they need —
+ * whether a mount's volume is declared in the same stack — lives in the typed
+ * graph and is gone by the time `fly.toml` exists. So they fire on
+ * `chant build` and cannot fire on an audit of standalone Fly config.
+ * `auditRule()` hardcodes `yamlBased: true`, so these are constructed directly
+ * (the same reasoning as fountain's catalog).
+ *
+ * Without this the two checks reached `chant audit` with no title, tier, fix
+ * kind, or category at all — `resolveAuditCatalog` contributes nothing for a
+ * lexicon that omits the method, silently (#1346).
+ */
+import type { RuleMeta } from "@intentius/chant/audit/catalog";
+export declare const flyAuditCatalog: Record<string, RuleMeta>;
+//# sourceMappingURL=audit-catalog.d.ts.map

package/dist/lint/audit-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-catalog.d.ts","sourceRoot":"","sources":["../../src/lint/audit-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAa/D,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAepD,CAAC"}

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "fly",
-  "version": "0.37.2",
+  "version": "0.39.0",
   "chantVersion": ">=0.1.0",
   "namespace": "Fly"
 }

package/dist/op/activities/flaps.d.ts

@@ -1,3 +1,4 @@
+import { type EmulatorCapability, type EmulatorSpec } from "@intentius/chant/op";
 export interface FlapsUpArgs {
     /** Container name. Default: `chant-mudflaps`. */
     name?: string;
@@ -14,6 +15,15 @@ export interface FlapsDownArgs {
     /** Container name to remove. Default: `chant-mudflaps`. */
     name?: string;
 }
+export declare const MUDFLAPS_SPEC: EmulatorSpec;
+/**
+ * The Machines half of fly's emulator capability (#1345).
+ *
+ * fly ships two emulators, and `LexiconPlugin.emulator` held exactly one until
+ * #1345 widened it — so neither was declared and `chant emulator` reported fly
+ * as having none, while the tutorials booted mudflaps through `chant run`.
+ */
+export declare const MUDFLAPS_EMULATOR: EmulatorCapability;
 export declare const flapsExistsCommand: (name: string) => string;
 export declare const flapsRmCommand: (name: string) => string;
 export declare const flapsHealthUrl: (port: number) => string;

package/dist/op/activities/flaps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flaps.d.ts","sourceRoot":"","sources":["../../../src/op/activities/flaps.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,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,aAAa;IAC5B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAYD,eAAO,MAAM,kBAAkB,0BAAsB,CAAC;AACtD,eAAO,MAAM,cAAc,0BAAkB,CAAC;AAC9C,eAAO,MAAM,cAAc,0BAAkB,CAAC;AAC9C,4FAA4F;AAC5F,eAAO,MAAM,aAAa,0BAAiB,CAAC;AAC5C,eAAO,MAAM,eAAe,GAAI,OAAM,WAAgB,KAAG,MAAgC,CAAC;AAE1F,2FAA2F;AAC3F,eAAO,MAAM,OAAO,GAAI,OAAM,WAAgB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAC3E,CAAC;AAEzB,4EAA4E;AAC5E,eAAO,MAAM,SAAS,GAAI,OAAM,aAAkB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC,IAAI,CAC7D,CAAC"}
+{"version":3,"file":"flaps.d.ts","sourceRoot":"","sources":["../../../src/op/activities/flaps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGpG,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,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,aAAa;IAC5B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAKD,eAAO,MAAM,aAAa,EAAE,YAM3B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,kBAG/B,CAAC;AAIF,eAAO,MAAM,kBAAkB,0BAAsB,CAAC;AACtD,eAAO,MAAM,cAAc,0BAAkB,CAAC;AAC9C,eAAO,MAAM,cAAc,0BAAkB,CAAC;AAC9C,4FAA4F;AAC5F,eAAO,MAAM,aAAa,0BAAiB,CAAC;AAC5C,eAAO,MAAM,eAAe,GAAI,OAAM,WAAgB,KAAG,MAAgC,CAAC;AAE1F,2FAA2F;AAC3F,eAAO,MAAM,OAAO,GAAI,OAAM,WAAgB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAC3E,CAAC;AAEzB,4EAA4E;AAC5E,eAAO,MAAM,SAAS,GAAI,OAAM,aAAkB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC,IAAI,CAC7D,CAAC"}

package/dist/op/activities/sprites-emulator.d.ts

@@ -1,3 +1,4 @@
+import { type EmulatorCapability, type EmulatorSpec } from "@intentius/chant/op";
 export interface SpritesUpArgs {
     /** Container name. Default: `chant-spritzer`. */
     name?: string;
@@ -14,6 +15,9 @@ export interface SpritesDownArgs {
     /** Container name to remove. Default: `chant-spritzer`. */
     name?: string;
 }
+export declare const SPRITZER_SPEC: EmulatorSpec;
+/** The Sprites half of fly's emulator capability (#1345). */
+export declare const SPRITZER_EMULATOR: EmulatorCapability;
 export declare const spritesExistsCommand: (name: string) => string;
 export declare const spritesRmCommand: (name: string) => string;
 export declare const spritesHealthUrl: (port: number) => string;

package/dist/op/activities/sprites-emulator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sprites-emulator.d.ts","sourceRoot":"","sources":["../../../src/op/activities/sprites-emulator.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,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;AAaD,eAAO,MAAM,oBAAoB,0BAAyB,CAAC;AAC3D,eAAO,MAAM,gBAAgB,0BAAqB,CAAC;AACnD,eAAO,MAAM,gBAAgB,0BAAqB,CAAC;AACnD,sGAAsG;AACtG,eAAO,MAAM,eAAe,0BAAoB,CAAC;AACjD,eAAO,MAAM,iBAAiB,GAAI,OAAM,aAAkB,KAAG,MAAmC,CAAC;AAEjG,0FAA0F;AAC1F,eAAO,MAAM,SAAS,GAAI,OAAM,aAAkB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAC5E,CAAC;AAE5B,4EAA4E;AAC5E,eAAO,MAAM,WAAW,GAAI,OAAM,eAAoB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC,IAAI,CAC9D,CAAC"}
+{"version":3,"file":"sprites-emulator.d.ts","sourceRoot":"","sources":["../../../src/op/activities/sprites-emulator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGpG,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,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,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,EAAE,kBAG/B,CAAC;AAIF,eAAO,MAAM,oBAAoB,0BAAyB,CAAC;AAC3D,eAAO,MAAM,gBAAgB,0BAAqB,CAAC;AACnD,eAAO,MAAM,gBAAgB,0BAAqB,CAAC;AACnD,sGAAsG;AACtG,eAAO,MAAM,eAAe,0BAAoB,CAAC;AACjD,eAAO,MAAM,iBAAiB,GAAI,OAAM,aAAkB,KAAG,MAAmC,CAAC;AAEjG,0FAA0F;AAC1F,eAAO,MAAM,SAAS,GAAI,OAAM,aAAkB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAC5E,CAAC;AAE5B,4EAA4E;AAC5E,eAAO,MAAM,WAAW,GAAI,OAAM,eAAoB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC,IAAI,CAC9D,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,EAAkD,MAAM,0BAA0B,CAAC;AAmB9G;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,aA2RvB,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAkD,MAAM,0BAA0B,CAAC;AAuB9G;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,aA+RvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-fly",
-  "version": "0.37.2",
+  "version": "0.39.0",
   "type": "module",
   "files": [
     "src/",
@@ -57,7 +57,7 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.37.2",
+    "@intentius/chant": "^0.39.0",
     "typescript": "^5.9.3"
   },
   "description": "Fly.io Machines lexicon for chant — declarative IaC in TypeScript",

package/src/describe-resources.test.ts

@@ -2,6 +2,7 @@ import { describe, test, expect } from "vitest";
 import { describeObservationConformance } from "@intentius/chant-test-utils";
 import { describeResources, flyPlan } from "./describe-resources";
 import type { FlyHttp } from "./op/activities/fly-apply";
+import { FLY_METADATA_OWNERSHIP_KEYS } from "./ownership";
 
 // Injected-HTTP unit tests, mirroring fly-apply.test.ts: a scripted flaps answers
 // list/get reads, and describeResources maps them to ResourceMetadata with the
@@ -219,6 +220,7 @@ describe("flyPlan: declared-vs-live change set (create/noop/delete/adopt)", () =
 // The shared conformance suite (#1089).
 describeObservationConformance({
   lexicon: "fly",
+  ownershipChannel: { keys: FLY_METADATA_OWNERSHIP_KEYS, reads: ["describeResources"] },
   scenarios: [
     {
       name: "a build output that is not a readable fly plan",

package/src/lint/audit-catalog.ts

@@ -0,0 +1,46 @@
+/**
+ * The fly lexicon's chant audit catalog — metadata for the FLY post-synth
+ * checks, contributed via `flyPlugin.auditCatalog()` (#687).
+ *
+ * Both entries carry `yamlBased: false`: each check reads the chant model
+ * (`ctx.entities`) rather than the emitted manifest, because what they need —
+ * whether a mount's volume is declared in the same stack — lives in the typed
+ * graph and is gone by the time `fly.toml` exists. So they fire on
+ * `chant build` and cannot fire on an audit of standalone Fly config.
+ * `auditRule()` hardcodes `yamlBased: true`, so these are constructed directly
+ * (the same reasoning as fountain's catalog).
+ *
+ * Without this the two checks reached `chant audit` with no title, tier, fix
+ * kind, or category at all — `resolveAuditCatalog` contributes nothing for a
+ * lexicon that omits the method, silently (#1346).
+ */
+
+import type { RuleMeta } from "@intentius/chant/audit/catalog";
+
+/** Entity-based rule: everything fly ships. */
+function rule(
+  id: string,
+  tier: RuleMeta["tier"],
+  category: RuleMeta["category"],
+  title: string,
+  remediation: string,
+): RuleMeta {
+  return { id, tier, fixKind: "guidance", category, title, remediation, yamlBased: false };
+}
+
+export const flyAuditCatalog: Record<string, RuleMeta> = {
+  FLY010: rule(
+    "FLY010",
+    "merge-worthy",
+    "correctness",
+    "Machine config has no image",
+    "Set `config.image` on the Machine — a Machine cannot boot without one.",
+  ),
+  FLY011: rule(
+    "FLY011",
+    "merge-worthy",
+    "correctness",
+    "Machine mount references an undeclared volume",
+    "Declare the Volume in the same stack, or point the mount at one that is.",
+  ),
+};

package/src/op/activities/flaps.ts

@@ -1,4 +1,4 @@
-import { emulatorLifecycle } from "@intentius/chant/op";
+import { emulatorLifecycle, type EmulatorCapability, type EmulatorSpec } from "@intentius/chant/op";
 import { MUDFLAPS_IMAGE } from "./emulator-images";
 
 export interface FlapsUpArgs {
@@ -22,12 +22,27 @@ export interface FlapsDownArgs {
 // mudflaps is a stateful fake of the Fly Machines API (flaps) — a plain 200 on
 // its health endpoint means ready. The local target for flyApply; point it there
 // with FLY_FLAPS_BASE_URL. Shared lifecycle: emulatorLifecycle (#746).
-const flaps = emulatorLifecycle({
+export const MUDFLAPS_SPEC: EmulatorSpec = {
   name: "chant-mudflaps",
   image: MUDFLAPS_IMAGE,
   containerPort: 4280,
   healthPath: "/_mudflaps/health",
-});
+  upstream: { repo: "intentius/mudflaps" },
+};
+
+/**
+ * The Machines half of fly's emulator capability (#1345).
+ *
+ * fly ships two emulators, and `LexiconPlugin.emulator` held exactly one until
+ * #1345 widened it — so neither was declared and `chant emulator` reported fly
+ * as having none, while the tutorials booted mudflaps through `chant run`.
+ */
+export const MUDFLAPS_EMULATOR: EmulatorCapability = {
+  spec: MUDFLAPS_SPEC,
+  env: (endpoint) => ({ FLY_FLAPS_BASE_URL: endpoint }),
+};
+
+const flaps = emulatorLifecycle(MUDFLAPS_SPEC);
 
 export const flapsExistsCommand = flaps.existsCommand;
 export const flapsRmCommand = flaps.rmCommand;

package/src/op/activities/sprites-emulator.ts

@@ -1,4 +1,4 @@
-import { emulatorLifecycle } from "@intentius/chant/op";
+import { emulatorLifecycle, type EmulatorCapability, type EmulatorSpec } from "@intentius/chant/op";
 import { SPRITZER_IMAGE } from "./emulator-images";
 
 export interface SpritesUpArgs {
@@ -23,12 +23,21 @@ export interface SpritesDownArgs {
 // endpoint means ready. The local target for the sprite activities; point them
 // there with SPRITES_BASE_URL. Shared lifecycle: emulatorLifecycle (the same
 // helper that boots mudflaps for fly).
-const spritzer = emulatorLifecycle({
+export const SPRITZER_SPEC: EmulatorSpec = {
   name: "chant-spritzer",
   image: SPRITZER_IMAGE,
   containerPort: 4290,
   healthPath: "/_spritzer/health",
-});
+  upstream: { repo: "intentius/spritzer" },
+};
+
+/** The Sprites half of fly's emulator capability (#1345). */
+export const SPRITZER_EMULATOR: EmulatorCapability = {
+  spec: SPRITZER_SPEC,
+  env: (endpoint) => ({ SPRITES_BASE_URL: endpoint }),
+};
+
+const spritzer = emulatorLifecycle(SPRITZER_SPEC);
 
 export const spritesExistsCommand = spritzer.existsCommand;
 export const spritesRmCommand = spritzer.rmCommand;

package/src/plugin.ts

@@ -4,6 +4,9 @@ import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
 import type { CompletionContext, CompletionItem, HoverContext, HoverInfo } from "@intentius/chant/lsp/types";
 import type { McpToolContribution, McpResourceContribution } from "@intentius/chant/mcp/types";
 import { createSkillsLoader } from "@intentius/chant/lexicon-plugin-helpers";
+import { MUDFLAPS_EMULATOR } from "./op/activities/flaps";
+import { SPRITZER_EMULATOR } from "./op/activities/sprites-emulator";
+import { flyAuditCatalog } from "./lint/audit-catalog";
 import type { TemplateParser } from "@intentius/chant/import/parser";
 import type { TypeScriptGenerator } from "@intentius/chant/import/generator";
 import { flySerializer } from "./serializer";
@@ -16,6 +19,7 @@ import { FlyParser } from "./import/parser";
 import { FlyGenerator } from "./import/generator";
 import { flyReferenceCatalog } from "./reference-catalog";
 import { flyContextTools } from "./mcp/context-tools";
+import { FLY_METADATA_OWNERSHIP_KEYS } from "./ownership";
 
 /**
  * fly lexicon plugin.
@@ -24,6 +28,10 @@ import { flyContextTools } from "./mcp/context-tools";
  */
 export const flyPlugin: LexiconPlugin = {
   name: "fly",
+  ownershipChannel: { keys: FLY_METADATA_OWNERSHIP_KEYS, reads: ["describeResources"] },
+  // Two: the Machines API and Sprites (#1345).
+  emulator: [MUDFLAPS_EMULATOR, SPRITZER_EMULATOR],
+  auditCatalog: () => flyAuditCatalog,
   serializer: flySerializer,
 
   // ── Required lifecycle methods ────────────────────────────────

package/dist/emulator-freshness-cli.d.ts

@@ -1,11 +0,0 @@
-/**
- * CLI for the emulator-freshness check (#808 T2). Fetches the latest mudflaps /
- * spritzer releases, compares to the pinned tags, prints a report, and — when
- * run in CI — writes `behind` + a Markdown `body` to `$GITHUB_OUTPUT` so the
- * weekly workflow can open/refresh a single "N releases behind" notice issue.
- *
- * Advisory only: exits 0 whether or not a pin is behind (the bump is a human
- * decision per the #808 policy). A hard failure (network/API) exits 1.
- */
-export {};
-//# sourceMappingURL=emulator-freshness-cli.d.ts.map

package/dist/emulator-freshness-cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"emulator-freshness-cli.d.ts","sourceRoot":"","sources":["../src/emulator-freshness-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/emulator-freshness.d.ts

@@ -1,38 +0,0 @@
-/**
- * Emulator-freshness check (#808 T2, second half).
- *
- * mudflaps (Machines) and spritzer (Sprites) are pinned to a single source
- * (./op/activities/emulator-images.ts). Their upstream repos cut GitHub releases,
- * so this compares each pinned tag against the latest release and reports how far
- * behind it is. A weekly workflow surfaces a "N releases behind" notice — never
- * an auto-bump. Per the bump policy (#808), the tag moves only when a consuming
- * test needs the newer emulator, so this is advisory, not gating on the pin.
- */
-export interface EmulatorPin {
-    /** Short name, e.g. "mudflaps". */
-    name: string;
-    /** GitHub repo "owner/name" whose releases publish the emulator. */
-    repo: string;
-    /** Pinned version, no leading "v" (e.g. "0.3.1"). */
-    pinned: string;
-}
-export interface FreshnessResult {
-    name: string;
-    pinned: string;
-    latest: string;
-    /** True when the latest release is newer than the pinned version. */
-    behind: boolean;
-}
-/** Parse the version tag from a ghcr image ref (".../mudflaps:0.3.1" → "0.3.1"). */
-export declare function parseVersion(image: string): string;
-/** Compare pinned vs latest as dotted numeric versions; `behind` when latest > pinned. */
-export declare function compare(name: string, pinned: string, latest: string): FreshnessResult;
-/** The emulator pins to check, read from the single-source image constants. */
-export declare const EMULATOR_PINS: readonly EmulatorPin[];
-/** Fetch the latest release tag for a repo via the GitHub REST API. */
-export declare function latestRelease(repo: string, fetchImpl?: typeof fetch): Promise<string>;
-/** Check every emulator pin against its latest release. */
-export declare function checkFreshness(fetchImpl?: typeof fetch): Promise<FreshnessResult[]>;
-/** One-line human summary of a result. */
-export declare function formatResult(r: FreshnessResult): string;
-//# sourceMappingURL=emulator-freshness.d.ts.map

package/dist/emulator-freshness.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"emulator-freshness.d.ts","sourceRoot":"","sources":["../src/emulator-freshness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGlD;AAMD,0FAA0F;AAC1F,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAcrF;AAED,+EAA+E;AAC/E,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAGtC,CAAC;AAEX,uEAAuE;AACvE,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,OAAO,KAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlG;AAED,2DAA2D;AAC3D,wBAAsB,cAAc,CAAC,SAAS,GAAE,OAAO,KAAa,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAIhG;AAED,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAIvD"}

package/src/emulator-freshness-cli.ts

@@ -1,49 +0,0 @@
-/**
- * CLI for the emulator-freshness check (#808 T2). Fetches the latest mudflaps /
- * spritzer releases, compares to the pinned tags, prints a report, and — when
- * run in CI — writes `behind` + a Markdown `body` to `$GITHUB_OUTPUT` so the
- * weekly workflow can open/refresh a single "N releases behind" notice issue.
- *
- * Advisory only: exits 0 whether or not a pin is behind (the bump is a human
- * decision per the #808 policy). A hard failure (network/API) exits 1.
- */
-
-import { appendFileSync } from "node:fs";
-import { checkFreshness, formatResult, type FreshnessResult } from "./emulator-freshness";
-
-function issueBody(behind: FreshnessResult[]): string {
-  const rows = behind.map((r) => `- **${r.name}** — pinned \`${r.pinned}\`, latest \`${r.latest}\``).join("\n");
-  return [
-    "The pinned Fly emulator image(s) are behind their latest upstream release:",
-    "",
-    rows,
-    "",
-    "The tag lives in `lexicons/fly/src/op/activities/emulator-images.ts` (single source).",
-    "",
-    "Per the #808 bump policy this is **advisory** — move the pin only when a consuming",
-    "test needs the newer emulator (a fidelity fix the fly activities exercise), not on",
-    "every release. Close this issue once reviewed or bumped.",
-  ].join("\n");
-}
-
-async function main(): Promise<void> {
-  const results = await checkFreshness();
-  for (const r of results) console.error(formatResult(r));
-
-  const behind = results.filter((r) => r.behind);
-  console.log(JSON.stringify({ behind: behind.length > 0, results }, null, 2));
-
-  const out = process.env.GITHUB_OUTPUT;
-  if (out) {
-    appendFileSync(out, `behind=${behind.length > 0}\n`);
-    if (behind.length > 0) {
-      // Multiline output via the GITHUB_OUTPUT heredoc form.
-      appendFileSync(out, `body<<FRESHNESS_EOF\n${issueBody(behind)}\nFRESHNESS_EOF\n`);
-    }
-  }
-}
-
-main().catch((err: unknown) => {
-  console.error(err instanceof Error ? err.message : String(err));
-  process.exit(1);
-});

package/src/emulator-freshness.test.ts

@@ -1,86 +0,0 @@
-import { describe, test, expect } from "vitest";
-import {
-  parseVersion,
-  compare,
-  latestRelease,
-  checkFreshness,
-  formatResult,
-  EMULATOR_PINS,
-} from "./emulator-freshness";
-
-describe("parseVersion", () => {
-  test("extracts the version from a ghcr image ref, stripping a leading v", () => {
-    expect(parseVersion("ghcr.io/intentius/mudflaps:0.3.1")).toBe("0.3.1");
-    expect(parseVersion("ghcr.io/intentius/spritzer:v1.2.0")).toBe("1.2.0");
-  });
-});
-
-describe("compare", () => {
-  test("not behind when pinned equals latest", () => {
-    expect(compare("mudflaps", "0.3.1", "v0.3.1").behind).toBe(false);
-  });
-  test("behind when latest is a newer patch/minor/major", () => {
-    expect(compare("m", "0.3.1", "v0.3.2").behind).toBe(true);
-    expect(compare("m", "0.3.1", "v0.4.0").behind).toBe(true);
-    expect(compare("m", "0.3.1", "v1.0.0").behind).toBe(true);
-  });
-  test("not behind when pinned is ahead of latest", () => {
-    expect(compare("m", "0.4.0", "v0.3.9").behind).toBe(false);
-  });
-  test("normalizes the leading v out of the reported versions", () => {
-    const r = compare("m", "0.3.1", "v0.3.2");
-    expect(r.pinned).toBe("0.3.1");
-    expect(r.latest).toBe("0.3.2");
-  });
-});
-
-describe("EMULATOR_PINS", () => {
-  test("tracks mudflaps and spritzer from the single-source image constants", () => {
-    expect(EMULATOR_PINS.map((p) => p.name).sort()).toEqual(["mudflaps", "spritzer"]);
-    for (const p of EMULATOR_PINS) {
-      expect(p.repo).toMatch(/^intentius\//);
-      expect(p.pinned).toMatch(/^\d+\.\d+\.\d+$/);
-    }
-  });
-});
-
-describe("latestRelease + checkFreshness (mocked fetch)", () => {
-  const mkFetch = (tags: Record<string, string>): typeof fetch =>
-    (async (url: string | URL | Request) => {
-      const u = String(url);
-      const repo = u.match(/repos\/([^/]+\/[^/]+)\/releases/)?.[1] ?? "";
-      return { ok: true, status: 200, json: async () => ({ tag_name: tags[repo] }) } as Response;
-    }) as unknown as typeof fetch;
-
-  test("latestRelease returns the tag_name", async () => {
-    const f = mkFetch({ "intentius/mudflaps": "v0.9.0" });
-    expect(await latestRelease("intentius/mudflaps", f)).toBe("v0.9.0");
-  });
-
-  test("checkFreshness flags a pin behind its latest release", async () => {
-    // Force both upstreams to a high version so the check reports behind
-    // regardless of the currently-pinned tag.
-    const f = mkFetch({ "intentius/mudflaps": "v99.0.0", "intentius/spritzer": "v99.0.0" });
-    const results = await checkFreshness(f);
-    expect(results).toHaveLength(2);
-    expect(results.every((r) => r.behind)).toBe(true);
-  });
-
-  test("checkFreshness reports current when latest matches the pin", async () => {
-    const pins = Object.fromEntries(EMULATOR_PINS.map((p) => [p.repo, `v${p.pinned}`]));
-    const results = await checkFreshness(mkFetch(pins));
-    expect(results.every((r) => !r.behind)).toBe(true);
-  });
-
-  test("latestRelease throws on a non-ok response", async () => {
-    const f = (async () => ({ ok: false, status: 404 }) as Response) as unknown as typeof fetch;
-    await expect(latestRelease("intentius/nope", f)).rejects.toThrow(/HTTP 404/);
-  });
-});
-
-describe("formatResult", () => {
-  test("marks behind vs current distinctly", () => {
-    expect(formatResult({ name: "m", pinned: "0.3.1", latest: "0.4.0", behind: true })).toMatch(/behind/);
-    expect(formatResult({ name: "m", pinned: "0.3.1", latest: "0.3.1", behind: false })).toMatch(/current/);
-  });
-});

package/src/emulator-freshness.ts

@@ -1,87 +0,0 @@
-/**
- * Emulator-freshness check (#808 T2, second half).
- *
- * mudflaps (Machines) and spritzer (Sprites) are pinned to a single source
- * (./op/activities/emulator-images.ts). Their upstream repos cut GitHub releases,
- * so this compares each pinned tag against the latest release and reports how far
- * behind it is. A weekly workflow surfaces a "N releases behind" notice — never
- * an auto-bump. Per the bump policy (#808), the tag moves only when a consuming
- * test needs the newer emulator, so this is advisory, not gating on the pin.
- */
-
-import { MUDFLAPS_IMAGE, SPRITZER_IMAGE } from "./op/activities/emulator-images";
-
-export interface EmulatorPin {
-  /** Short name, e.g. "mudflaps". */
-  name: string;
-  /** GitHub repo "owner/name" whose releases publish the emulator. */
-  repo: string;
-  /** Pinned version, no leading "v" (e.g. "0.3.1"). */
-  pinned: string;
-}
-
-export interface FreshnessResult {
-  name: string;
-  pinned: string;
-  latest: string;
-  /** True when the latest release is newer than the pinned version. */
-  behind: boolean;
-}
-
-/** Parse the version tag from a ghcr image ref (".../mudflaps:0.3.1" → "0.3.1"). */
-export function parseVersion(image: string): string {
-  const tag = image.slice(image.lastIndexOf(":") + 1);
-  return tag.replace(/^v/, "");
-}
-
-function toParts(v: string): number[] {
-  return v.replace(/^v/, "").split(".").map((n) => parseInt(n, 10) || 0);
-}
-
-/** Compare pinned vs latest as dotted numeric versions; `behind` when latest > pinned. */
-export function compare(name: string, pinned: string, latest: string): FreshnessResult {
-  const p = toParts(pinned);
-  const l = toParts(latest);
-  let behind = false;
-  for (let i = 0; i < Math.max(p.length, l.length); i++) {
-    const a = p[i] ?? 0;
-    const b = l[i] ?? 0;
-    if (b > a) {
-      behind = true;
-      break;
-    }
-    if (b < a) break;
-  }
-  return { name, pinned: pinned.replace(/^v/, ""), latest: latest.replace(/^v/, ""), behind };
-}
-
-/** The emulator pins to check, read from the single-source image constants. */
-export const EMULATOR_PINS: readonly EmulatorPin[] = [
-  { name: "mudflaps", repo: "intentius/mudflaps", pinned: parseVersion(MUDFLAPS_IMAGE) },
-  { name: "spritzer", repo: "intentius/spritzer", pinned: parseVersion(SPRITZER_IMAGE) },
-] as const;
-
-/** Fetch the latest release tag for a repo via the GitHub REST API. */
-export async function latestRelease(repo: string, fetchImpl: typeof fetch = fetch): Promise<string> {
-  const headers: Record<string, string> = { Accept: "application/vnd.github+json" };
-  if (process.env.GITHUB_TOKEN) headers.Authorization = `Bearer ${process.env.GITHUB_TOKEN}`;
-  const res = await fetchImpl(`https://api.github.com/repos/${repo}/releases/latest`, { headers });
-  if (!res.ok) throw new Error(`releases/latest ${repo}: HTTP ${res.status}`);
-  const body = (await res.json()) as { tag_name?: string };
-  if (!body.tag_name) throw new Error(`releases/latest ${repo}: no tag_name`);
-  return body.tag_name;
-}
-
-/** Check every emulator pin against its latest release. */
-export async function checkFreshness(fetchImpl: typeof fetch = fetch): Promise<FreshnessResult[]> {
-  return Promise.all(
-    EMULATOR_PINS.map(async (p) => compare(p.name, p.pinned, await latestRelease(p.repo, fetchImpl))),
-  );
-}
-
-/** One-line human summary of a result. */
-export function formatResult(r: FreshnessResult): string {
-  return r.behind
-    ? `⚠ ${r.name}: pinned ${r.pinned}, latest ${r.latest} — behind`
-    : `✓ ${r.name}: pinned ${r.pinned} is current (latest ${r.latest})`;
-}