@snaptrude/plugin-core 0.9.17 → 0.9.18-networks-20261016.1

package/scripts/generate-manifest.test.mjs

@@ -1,303 +1,303 @@
-// Unit tests for the discovery-manifest generator (pure codegen logic).
-// Run: `node --test scripts/generate-manifest.test.mjs` (from packages/plugin-core)
-import { test } from "node:test"
-import assert from "node:assert/strict"
-import { buildManifest } from "./generate-manifest.mjs"
-
-const manifest = buildManifest()
-const byPath = new Map(manifest.map((m) => [m.path, m]))
-
-test("every entry has a dotted path and a namespace", () => {
-  for (const m of manifest) {
-    assert.match(m.path, /^[a-z][a-zA-Z0-9.]*$/, `bad path: ${m.path}`)
-    assert.equal(typeof m.namespace, "string")
-    assert.ok(
-      Array.isArray(m.examplePrompts),
-      `${m.path} examplePrompts not array`,
-    )
-  }
-})
-
-test("output is sorted and unique by path", () => {
-  const paths = manifest.map((m) => m.path)
-  assert.deepEqual(
-    paths,
-    [...paths].sort((a, b) => a.localeCompare(b)),
-    "not sorted",
-  )
-  assert.equal(new Set(paths).size, paths.length, "duplicate paths")
-})
-
-test("all 4 Phase-1 slice methods are present with intent + prompts", () => {
-  const slice = [
-    "program.departments.list",
-    "program.departments.get",
-    "program.metrics.get",
-    "presentation.views.list",
-  ]
-  for (const p of slice) {
-    const m = byPath.get(p)
-    assert.ok(m, `missing slice method: ${p}`)
-    assert.ok(m.summary.length > 0, `${p} has no intent summary`)
-    assert.ok(m.examplePrompts.length >= 3, `${p} has < 3 example prompts`)
-    assert.ok(
-      m.resultType && m.resultType !== "void",
-      `${p} has no result type`,
-    )
-  }
-})
-
-test("departments.get carries its args type; list takes no args", () => {
-  assert.equal(byPath.get("program.departments.get").argsType, "string")
-  assert.equal(byPath.get("program.departments.list").argsType, null)
-})
-
-test("return-type wrapper PluginApiReturn<...> is unwrapped", () => {
-  for (const m of manifest) {
-    assert.ok(
-      !/^PluginApiReturn</.test(m.resultType ?? ""),
-      `${m.path} not unwrapped`,
-    )
-  }
-})
-
-test("author-ahead (optional) members are kept OUT of the manifest", () => {
-  // Optional sub-namespaces (`aiInspiration?`) and optional leaf methods
-  // (`departments.delete?`, `cores.create?`) are authored ahead of the host and
-  // must not appear in the discovery manifest until promoted to required
-  // `abstract` members. (See the discipline note in generate-manifest.mjs.)
-  const authoredAhead = [
-    "presentation.aiInspiration.listModels",
-    "program.departments.delete",
-    "program.cores.create",
-  ]
-  for (const p of authoredAhead) {
-    assert.ok(
-      !byPath.has(p),
-      `optional author-ahead member leaked into manifest: ${p}`,
-    )
-  }
-})
-
-test("promoted methods are present in the manifest", () => {
-  // Methods whose react host bodies have landed and been verified, flipped from
-  // optional author-ahead to required `abstract`.
-  const promoted = [
-    "program.departments.create",
-    "program.departments.setTargetArea",
-    "program.site.get",
-    "program.site.getContext",
-    "presentation.import.image",
-    "presentation.import.pdf",
-    "presentation.sheets.list",
-    "presentation.sheets.place",
-    "presentation.diagrams.place",
-    // 2026-07-02 promotions — react hosts landed and verified:
-    "program.spreadsheet.render",
-    "program.adjacency.getMatrix",
-    "program.adjacency.compute",
-    "program.spreadsheet.getTakeoff",
-    "program.spreadsheet.runScript",
-    "presentation.views.get",
-    "presentation.views.getActive",
-    "presentation.views.capture",
-    "presentation.views.setActive",
-    "presentation.views.create",
-    "core.storeys.layers.setActive",
-    "core.storeys.layers.update",
-    "program.areas.update",
-    // 2026-07-06 promotions — analysis namespace + program.site geo reads,
-    // react hosts landed:
-    "analysis.sunpath.enable",
-    "analysis.sunpath.disable",
-    "analysis.sunpath.isActive",
-    "analysis.shadows.enable",
-    "analysis.shadows.disable",
-    "analysis.shadows.isEnabled",
-    "analysis.shadows.setDateTime",
-    "analysis.shadows.getDateTime",
-    "analysis.sunlightHours.compute",
-    "analysis.sunlightHours.get",
-    "analysis.sunlightHours.cancel",
-    "analysis.sunlightHours.reset",
-    "analysis.illuminance.compute",
-    "analysis.illuminance.get",
-    "analysis.illuminance.cancel",
-    "analysis.illuminance.reset",
-    "program.site.getLocation",
-    "program.site.getNorthAngle",
-    // 2026-07-07 promotion — analysis.heatmaps, react host landed:
-    "analysis.heatmaps.renderSpaces",
-    "analysis.heatmaps.renderGrid",
-    "analysis.heatmaps.reset",
-    "analysis.heatmaps.isActive",
-    // 2026-07-09 promotion — program.layout became an async-job family (was
-    // author-ahead optional `arrange`/`pack`; now required + getState/cancel):
-    "program.layout.arrange",
-    "program.layout.pack",
-    "program.layout.getState",
-    "program.layout.cancel",
-  ]
-  for (const p of promoted) {
-    assert.ok(
-      byPath.has(p),
-      `expected promoted method missing from manifest: ${p}`,
-    )
-  }
-})
-
-test("v2 family reads (all 5 families) are present with intent + prompts", () => {
-  // All 22 reads of the five landed families. Every sub-api mount is now required
-  // `abstract` (the react hosts have landed), so each read is in the discovery
-  // manifest with a summary, >= 3 example prompts, and a result type.
-  const reads = [
-    "core.groups.list",
-    "core.groups.get",
-    "core.groups.getForComponent",
-    "core.groups.listMembers",
-    "core.groups.isLocked",
-    "core.groups.getBounds",
-    "core.buildings.list",
-    "core.buildings.get",
-    "core.buildings.listStoreys",
-    "core.buildings.getActive",
-    "core.storeys.layers.list",
-    "core.storeys.layers.get",
-    "core.storeys.layers.getActive",
-    // core.layers — the Layers panel (0.9.14)
-    "core.layers.list",
-    "core.layers.get",
-    "core.layers.getActive",
-    "core.tags.listCategories",
-    "core.tags.getCategory",
-    "core.tags.list",
-    "core.tags.get",
-    "core.tags.getTagsForComponent",
-    "core.tags.listComponents",
-    "program.areas.get",
-    "program.areas.list",
-    "program.areas.listMembers",
-  ]
-  for (const p of reads) {
-    const m = byPath.get(p)
-    assert.ok(m, `missing v2 family read: ${p}`)
-    assert.ok(m.summary.length > 0, `${p} has no intent summary`)
-    assert.ok(m.examplePrompts.length >= 3, `${p} has < 3 example prompts`)
-    assert.ok(
-      m.resultType && m.resultType !== "void",
-      `${p} has no result type`,
-    )
-  }
-})
-
-test("v2 family writes are IN the discovery manifest (hosts landed, promoted)", () => {
-  // 2026-07-02: every v2 family write's react host body has landed, so the
-  // contract members were promoted from optional `foo?: (args) => ...`
-  // fn-properties to required `abstract` methods — they now appear in the
-  // discovery build.
-  const promotedWrites = [
-    "core.groups.create",
-    "core.groups.update",
-    "core.groups.delete",
-    "core.buildings.setActive",
-    "core.buildings.create",
-    "core.buildings.update",
-    "core.buildings.copy",
-    "core.buildings.delete",
-    "core.storeys.layers.setActive",
-    "core.storeys.layers.update",
-    // core.layers — the Layers panel (0.9.14)
-    "core.layers.create",
-    "core.layers.rename",
-    "core.layers.update",
-    "core.layers.setActive",
-    "core.layers.delete",
-    "core.layers.assign",
-    "core.tags.createCategory",
-    "core.tags.updateCategory",
-    "core.tags.deleteCategory",
-    "core.tags.create",
-    "core.tags.update",
-    "core.tags.delete",
-    "core.tags.assign",
-    "core.tags.unassign",
-    "program.areas.update",
-  ]
-  for (const p of promotedWrites) {
-    assert.ok(
-      byPath.has(p),
-      `promoted v2 family write missing from manifest: ${p}`,
-    )
-  }
-})
-
-test("0.7.0 batch — new families & methods present with intent + prompts", () => {
-  // The 0.7.0 wave: core.proposals, the program.layout async-job family,
-  // door/window catalogs + placement, furniture categories, smart layout,
-  // align, per-face materials, staircase read/write, footprint-area lock,
-  // storey duplicate, SVG import, and view display settings. Every entry is a
-  // required `abstract` member (react hosts landed), so each must be in the
-  // discovery manifest with a summary, >= 3 example prompts, and a result type.
-  const batch = [
-    // core.proposals — design-option infrastructure
-    "core.proposals.list",
-    "core.proposals.get",
-    "core.proposals.getActive",
-    "core.proposals.listForComponent",
-    "core.proposals.isActive",
-    "core.proposals.create",
-    "core.proposals.rename",
-    "core.proposals.setActive",
-    "core.proposals.delete",
-    // program.layout — async space-solver job family
-    "program.layout.arrange",
-    "program.layout.pack",
-    "program.layout.getState",
-    "program.layout.cancel",
-    // door / window catalogs (shared DTOs) + placement creators
-    "design.doors.listCatalogGroups",
-    "design.doors.listCatalog",
-    "design.doors.getCatalogItem",
-    "design.doors.exists",
-    "design.windows.listCatalogGroups",
-    "design.windows.listCatalog",
-    "design.windows.getCatalogItem",
-    "design.windows.exists",
-    "design.create.door",
-    "design.create.window",
-    // furniture categories + smart layout
-    "design.furniture.listCategories",
-    "design.create.smartLayout",
-    // align
-    "design.transform.align",
-    // per-face materials
-    "design.materials.applyToFaces",
-    "design.materials.resetFaces",
-    "design.materials.getByFace",
-    "design.materials.listByFace",
-    // staircase read/write
-    "design.query.getStaircaseParams",
-    "design.update.staircase",
-    // footprint-area lock
-    "design.lockArea",
-    "design.unlockArea",
-    "design.isAreaLocked",
-    "design.listAreaLocked",
-    // storey duplicate
-    "entity.story.duplicate",
-    // present-canvas SVG import + view display settings
-    "presentation.import.svg",
-    "presentation.views.getSettings",
-    "presentation.views.updateSettings",
-  ]
-  for (const p of batch) {
-    const m = byPath.get(p)
-    assert.ok(m, `missing 0.7.0 batch method: ${p}`)
-    assert.ok(m.summary.length > 0, `${p} has no intent summary`)
-    assert.ok(m.examplePrompts.length >= 3, `${p} has < 3 example prompts`)
-    assert.ok(
-      m.resultType && m.resultType !== "void",
-      `${p} has no result type`,
-    )
-  }
-})
+// Unit tests for the discovery-manifest generator (pure codegen logic).
+// Run: `node --test scripts/generate-manifest.test.mjs` (from packages/plugin-core)
+import { test } from "node:test"
+import assert from "node:assert/strict"
+import { buildManifest } from "./generate-manifest.mjs"
+
+const manifest = buildManifest()
+const byPath = new Map(manifest.map((m) => [m.path, m]))
+
+test("every entry has a dotted path and a namespace", () => {
+  for (const m of manifest) {
+    assert.match(m.path, /^[a-z][a-zA-Z0-9.]*$/, `bad path: ${m.path}`)
+    assert.equal(typeof m.namespace, "string")
+    assert.ok(
+      Array.isArray(m.examplePrompts),
+      `${m.path} examplePrompts not array`,
+    )
+  }
+})
+
+test("output is sorted and unique by path", () => {
+  const paths = manifest.map((m) => m.path)
+  assert.deepEqual(
+    paths,
+    [...paths].sort((a, b) => a.localeCompare(b)),
+    "not sorted",
+  )
+  assert.equal(new Set(paths).size, paths.length, "duplicate paths")
+})
+
+test("all 4 Phase-1 slice methods are present with intent + prompts", () => {
+  const slice = [
+    "program.departments.list",
+    "program.departments.get",
+    "program.metrics.get",
+    "presentation.views.list",
+  ]
+  for (const p of slice) {
+    const m = byPath.get(p)
+    assert.ok(m, `missing slice method: ${p}`)
+    assert.ok(m.summary.length > 0, `${p} has no intent summary`)
+    assert.ok(m.examplePrompts.length >= 3, `${p} has < 3 example prompts`)
+    assert.ok(
+      m.resultType && m.resultType !== "void",
+      `${p} has no result type`,
+    )
+  }
+})
+
+test("departments.get carries its args type; list takes no args", () => {
+  assert.equal(byPath.get("program.departments.get").argsType, "string")
+  assert.equal(byPath.get("program.departments.list").argsType, null)
+})
+
+test("return-type wrapper PluginApiReturn<...> is unwrapped", () => {
+  for (const m of manifest) {
+    assert.ok(
+      !/^PluginApiReturn</.test(m.resultType ?? ""),
+      `${m.path} not unwrapped`,
+    )
+  }
+})
+
+test("author-ahead (optional) members are kept OUT of the manifest", () => {
+  // Optional sub-namespaces (`aiInspiration?`) and optional leaf methods
+  // (`departments.delete?`, `cores.create?`) are authored ahead of the host and
+  // must not appear in the discovery manifest until promoted to required
+  // `abstract` members. (See the discipline note in generate-manifest.mjs.)
+  const authoredAhead = [
+    "presentation.aiInspiration.listModels",
+    "program.departments.delete",
+    "program.cores.create",
+  ]
+  for (const p of authoredAhead) {
+    assert.ok(
+      !byPath.has(p),
+      `optional author-ahead member leaked into manifest: ${p}`,
+    )
+  }
+})
+
+test("promoted methods are present in the manifest", () => {
+  // Methods whose react host bodies have landed and been verified, flipped from
+  // optional author-ahead to required `abstract`.
+  const promoted = [
+    "program.departments.create",
+    "program.departments.setTargetArea",
+    "program.site.get",
+    "program.site.getContext",
+    "presentation.import.image",
+    "presentation.import.pdf",
+    "presentation.sheets.list",
+    "presentation.sheets.place",
+    "presentation.diagrams.place",
+    // 2026-07-02 promotions — react hosts landed and verified:
+    "program.spreadsheet.render",
+    "program.adjacency.getMatrix",
+    "program.adjacency.compute",
+    "program.spreadsheet.getTakeoff",
+    "program.spreadsheet.runScript",
+    "presentation.views.get",
+    "presentation.views.getActive",
+    "presentation.views.capture",
+    "presentation.views.setActive",
+    "presentation.views.create",
+    "core.storeys.layers.setActive",
+    "core.storeys.layers.update",
+    "program.areas.update",
+    // 2026-07-06 promotions — analysis namespace + program.site geo reads,
+    // react hosts landed:
+    "analysis.sunpath.enable",
+    "analysis.sunpath.disable",
+    "analysis.sunpath.isActive",
+    "analysis.shadows.enable",
+    "analysis.shadows.disable",
+    "analysis.shadows.isEnabled",
+    "analysis.shadows.setDateTime",
+    "analysis.shadows.getDateTime",
+    "analysis.sunlightHours.compute",
+    "analysis.sunlightHours.get",
+    "analysis.sunlightHours.cancel",
+    "analysis.sunlightHours.reset",
+    "analysis.illuminance.compute",
+    "analysis.illuminance.get",
+    "analysis.illuminance.cancel",
+    "analysis.illuminance.reset",
+    "program.site.getLocation",
+    "program.site.getNorthAngle",
+    // 2026-07-07 promotion — analysis.heatmaps, react host landed:
+    "analysis.heatmaps.renderSpaces",
+    "analysis.heatmaps.renderGrid",
+    "analysis.heatmaps.reset",
+    "analysis.heatmaps.isActive",
+    // 2026-07-09 promotion — program.layout became an async-job family (was
+    // author-ahead optional `arrange`/`pack`; now required + getState/cancel):
+    "program.layout.arrange",
+    "program.layout.pack",
+    "program.layout.getState",
+    "program.layout.cancel",
+  ]
+  for (const p of promoted) {
+    assert.ok(
+      byPath.has(p),
+      `expected promoted method missing from manifest: ${p}`,
+    )
+  }
+})
+
+test("v2 family reads (all 5 families) are present with intent + prompts", () => {
+  // All 22 reads of the five landed families. Every sub-api mount is now required
+  // `abstract` (the react hosts have landed), so each read is in the discovery
+  // manifest with a summary, >= 3 example prompts, and a result type.
+  const reads = [
+    "core.groups.list",
+    "core.groups.get",
+    "core.groups.getForComponent",
+    "core.groups.listMembers",
+    "core.groups.isLocked",
+    "core.groups.getBounds",
+    "core.buildings.list",
+    "core.buildings.get",
+    "core.buildings.listStoreys",
+    "core.buildings.getActive",
+    "core.storeys.layers.list",
+    "core.storeys.layers.get",
+    "core.storeys.layers.getActive",
+    // core.layers — the Layers panel (0.9.14)
+    "core.layers.list",
+    "core.layers.get",
+    "core.layers.getActive",
+    "core.tags.listCategories",
+    "core.tags.getCategory",
+    "core.tags.list",
+    "core.tags.get",
+    "core.tags.getTagsForComponent",
+    "core.tags.listComponents",
+    "program.areas.get",
+    "program.areas.list",
+    "program.areas.listMembers",
+  ]
+  for (const p of reads) {
+    const m = byPath.get(p)
+    assert.ok(m, `missing v2 family read: ${p}`)
+    assert.ok(m.summary.length > 0, `${p} has no intent summary`)
+    assert.ok(m.examplePrompts.length >= 3, `${p} has < 3 example prompts`)
+    assert.ok(
+      m.resultType && m.resultType !== "void",
+      `${p} has no result type`,
+    )
+  }
+})
+
+test("v2 family writes are IN the discovery manifest (hosts landed, promoted)", () => {
+  // 2026-07-02: every v2 family write's react host body has landed, so the
+  // contract members were promoted from optional `foo?: (args) => ...`
+  // fn-properties to required `abstract` methods — they now appear in the
+  // discovery build.
+  const promotedWrites = [
+    "core.groups.create",
+    "core.groups.update",
+    "core.groups.delete",
+    "core.buildings.setActive",
+    "core.buildings.create",
+    "core.buildings.update",
+    "core.buildings.copy",
+    "core.buildings.delete",
+    "core.storeys.layers.setActive",
+    "core.storeys.layers.update",
+    // core.layers — the Layers panel (0.9.14)
+    "core.layers.create",
+    "core.layers.rename",
+    "core.layers.update",
+    "core.layers.setActive",
+    "core.layers.delete",
+    "core.layers.assign",
+    "core.tags.createCategory",
+    "core.tags.updateCategory",
+    "core.tags.deleteCategory",
+    "core.tags.create",
+    "core.tags.update",
+    "core.tags.delete",
+    "core.tags.assign",
+    "core.tags.unassign",
+    "program.areas.update",
+  ]
+  for (const p of promotedWrites) {
+    assert.ok(
+      byPath.has(p),
+      `promoted v2 family write missing from manifest: ${p}`,
+    )
+  }
+})
+
+test("0.7.0 batch — new families & methods present with intent + prompts", () => {
+  // The 0.7.0 wave: core.proposals, the program.layout async-job family,
+  // door/window catalogs + placement, furniture categories, smart layout,
+  // align, per-face materials, staircase read/write, footprint-area lock,
+  // storey duplicate, SVG import, and view display settings. Every entry is a
+  // required `abstract` member (react hosts landed), so each must be in the
+  // discovery manifest with a summary, >= 3 example prompts, and a result type.
+  const batch = [
+    // core.proposals — design-option infrastructure
+    "core.proposals.list",
+    "core.proposals.get",
+    "core.proposals.getActive",
+    "core.proposals.listForComponent",
+    "core.proposals.isActive",
+    "core.proposals.create",
+    "core.proposals.rename",
+    "core.proposals.setActive",
+    "core.proposals.delete",
+    // program.layout — async space-solver job family
+    "program.layout.arrange",
+    "program.layout.pack",
+    "program.layout.getState",
+    "program.layout.cancel",
+    // door / window catalogs (shared DTOs) + placement creators
+    "design.doors.listCatalogGroups",
+    "design.doors.listCatalog",
+    "design.doors.getCatalogItem",
+    "design.doors.exists",
+    "design.windows.listCatalogGroups",
+    "design.windows.listCatalog",
+    "design.windows.getCatalogItem",
+    "design.windows.exists",
+    "design.create.door",
+    "design.create.window",
+    // furniture categories + smart layout
+    "design.furniture.listCategories",
+    "design.create.smartLayout",
+    // align
+    "design.transform.align",
+    // per-face materials
+    "design.materials.applyToFaces",
+    "design.materials.resetFaces",
+    "design.materials.getByFace",
+    "design.materials.listByFace",
+    // staircase read/write
+    "design.query.getStaircaseParams",
+    "design.update.staircase",
+    // footprint-area lock
+    "design.lockArea",
+    "design.unlockArea",
+    "design.isAreaLocked",
+    "design.listAreaLocked",
+    // storey duplicate
+    "entity.story.duplicate",
+    // present-canvas SVG import + view display settings
+    "presentation.import.svg",
+    "presentation.views.getSettings",
+    "presentation.views.updateSettings",
+  ]
+  for (const p of batch) {
+    const m = byPath.get(p)
+    assert.ok(m, `missing 0.7.0 batch method: ${p}`)
+    assert.ok(m.summary.length > 0, `${p} has no intent summary`)
+    assert.ok(m.examplePrompts.length >= 3, `${p} has < 3 example prompts`)
+    assert.ok(
+      m.resultType && m.resultType !== "void",
+      `${p} has no result type`,
+    )
+  }
+})