create-yss-spec 3.0.0 → 3.0.1

package/template/.hermes/skills/archify/migrations/workflow-v2.mjs

@@ -1,279 +0,0 @@
-import { compileWorkflow } from '../renderers/workflow/workflow-compiler.mjs';
-import {
-  createMappedWorkflowCandidate,
-  intrinsicWorkflow,
-  planningWorkflow,
-} from '../renderers/workflow/workflow-migration-geometry.mjs';
-import { validateSchema } from '../renderers/shared/validator.mjs';
-
-export { createHorizontalRankMapper } from '../renderers/workflow/workflow-migration-geometry.mjs';
-
-const TARGET_SCHEMA_VERSION = 2;
-
-function clone(value) {
-  return JSON.parse(JSON.stringify(value));
-}
-
-function diagnostic({ code, message, subject = {}, evidence = {}, supportedFixes = [] }) {
-  return {
-    code,
-    severity: 'error',
-    message,
-    subject,
-    evidence,
-    supportedFixes,
-  };
-}
-
-function schemaDiagnostics(workflow) {
-  try {
-    validateSchema('workflow', workflow);
-    return [];
-  } catch (error) {
-    if (Array.isArray(error?.archifyDiagnostics)) {
-      return error.archifyDiagnostics.map((entry) => ({ ...entry }));
-    }
-    throw error;
-  }
-}
-
-function legacyLayoutProbe(workflow, qualityProfile) {
-  // The probe discovers fixed-v1 rank centers, not authored canvas capacity.
-  // Omitting viewBox lets a capacity-only legacy failure reach the v2 compiler,
-  // which can measure and monotonically expand the real migrated document.
-  const probe = {
-    schema_version: 1,
-    diagram_type: 'workflow',
-    meta: {
-      title: workflow.meta.title,
-      ...(workflow.meta.locale ? { locale: workflow.meta.locale } : {}),
-      legend: { mode: 'hidden' },
-    },
-    lanes: clone(workflow.lanes),
-    nodes: [{
-      id: 'migration_probe',
-      lane: workflow.lanes[0].id,
-      col: 0,
-      type: 'backend',
-      label: 'Probe',
-    }],
-    edges: [],
-  };
-  return compileWorkflow({ workflow: probe, qualityProfile });
-}
-
-function legacyRequirementProbe(workflow, qualityProfile) {
-  // Measure the complete fixed-v1 document without treating an authored
-  // viewBox as its intrinsic requirement. The authored viewBox remains a
-  // migration capacity and is preserved separately on the migrated document.
-  const probe = clone(workflow);
-  delete probe.meta.viewBox;
-  return compileWorkflow({ workflow: probe, qualityProfile });
-}
-
-function requiredViewBoxFrom(result) {
-  if (Array.isArray(result?.receipt?.requiredViewBox)) {
-    return [...result.receipt.requiredViewBox];
-  }
-  const required = result?.diagnostics
-    ?.map((entry) => entry?.evidence?.requiredViewBox)
-    .find((candidate) => Array.isArray(candidate) && candidate.length === 2);
-  return required ? [...required] : null;
-}
-
-function expandableViewBox(result) {
-  if (result.ok || !result.diagnostics?.length) return null;
-  if (!result.diagnostics.every((entry) => entry.code === 'workflow/viewbox-capacity')) return null;
-  return requiredViewBoxFrom(result);
-}
-
-function result({
-  ok,
-  document,
-  fromSchemaVersion = 1,
-  preExistingDiagnostics = [],
-  migrationDiagnostics = [],
-  newSchemaDiagnostics = [],
-  changedCoordinates = [],
-  oldRequiredViewBox = null,
-  newRequiredViewBox = null,
-}) {
-  return {
-    ok,
-    ...(document ? { document } : {}),
-    fromSchemaVersion,
-    toSchemaVersion: TARGET_SCHEMA_VERSION,
-    preExistingDiagnostics,
-    migrationDiagnostics,
-    newSchemaDiagnostics,
-    changedCoordinates,
-    oldRequiredViewBox,
-    newRequiredViewBox,
-  };
-}
-
-export function migrateWorkflowDocument(inputWorkflow) {
-  if (!inputWorkflow || typeof inputWorkflow !== 'object' || Array.isArray(inputWorkflow)) {
-    return result({
-      ok: false,
-      migrationDiagnostics: [diagnostic({
-        code: 'migration/source-document',
-        message: 'Workflow migration requires one parsed JSON object.',
-        supportedFixes: ['provide one workflow schema v1 JSON document'],
-      })],
-    });
-  }
-  // Migration has no quality override: the authored policy (or effective
-  // standard default) must validate the document after it leaves this process.
-  const qualityProfile = inputWorkflow.meta?.quality_profile || 'standard';
-
-  const workflow = clone(inputWorkflow);
-  const preExistingDiagnostics = schemaDiagnostics(workflow);
-  if (preExistingDiagnostics.length) {
-    return result({
-      ok: false,
-      fromSchemaVersion: workflow.schema_version,
-      preExistingDiagnostics,
-    });
-  }
-  if (workflow.schema_version === TARGET_SCHEMA_VERSION) {
-    const compiled = compileWorkflow({ workflow: clone(workflow), qualityProfile });
-    const requiredViewBox = requiredViewBoxFrom(compiled);
-    if (!compiled.ok) {
-      return result({
-        ok: false,
-        fromSchemaVersion: TARGET_SCHEMA_VERSION,
-        preExistingDiagnostics: compiled.diagnostics,
-        oldRequiredViewBox: requiredViewBox,
-        newRequiredViewBox: requiredViewBox,
-      });
-    }
-    return result({
-      ok: true,
-      document: workflow,
-      fromSchemaVersion: TARGET_SCHEMA_VERSION,
-      oldRequiredViewBox: requiredViewBox,
-      newRequiredViewBox: requiredViewBox,
-    });
-  }
-  if (workflow.schema_version !== 1) {
-    return result({
-      ok: false,
-      fromSchemaVersion: workflow.schema_version,
-      migrationDiagnostics: [diagnostic({
-        code: 'migration/source-schema-version',
-        message: 'Workflow migration to schema v2 requires a schema v1 or v2 source.',
-        subject: { path: '/schema_version' },
-        evidence: { actual: workflow.schema_version, expected: [1, 2] },
-        supportedFixes: ['use an unchanged schema v1 workflow or an already migrated schema v2 workflow as the source'],
-      })],
-    });
-  }
-
-  const legacy = compileWorkflow({ workflow: clone(workflow), qualityProfile });
-  const legacyProbe = legacyLayoutProbe(workflow, qualityProfile);
-  if (!legacyProbe.ok) {
-    return result({
-      ok: false,
-      preExistingDiagnostics: legacy.ok ? [] : legacy.diagnostics,
-      migrationDiagnostics: legacyProbe.diagnostics,
-    });
-  }
-  const legacyRequirement = legacyRequirementProbe(workflow, qualityProfile);
-  const oldRequiredViewBox = requiredViewBoxFrom(legacyRequirement)
-    || requiredViewBoxFrom(legacyProbe)
-    || requiredViewBoxFrom(legacy);
-  const preExistingLayoutDiagnostics = legacy.ok ? [] : legacy.diagnostics;
-
-  let planned = compileWorkflow({ workflow: intrinsicWorkflow(workflow), qualityProfile });
-  if (!planned.ok) {
-    // Old absolute pins can be invalid at the new rank centers before their X
-    // coordinates are mapped. Obtain the same rank plan from an automatic-route
-    // projection, then validate every authored pin again after mapping.
-    planned = compileWorkflow({ workflow: planningWorkflow(workflow), qualityProfile });
-  }
-  if (!planned.ok) {
-    return result({
-      ok: false,
-      preExistingDiagnostics: preExistingLayoutDiagnostics,
-      newSchemaDiagnostics: planned.diagnostics,
-      oldRequiredViewBox,
-      newRequiredViewBox: requiredViewBoxFrom(planned),
-    });
-  }
-
-  let mappedCandidate;
-  try {
-    mappedCandidate = createMappedWorkflowCandidate(
-      workflow,
-      legacyProbe.receipt.columns,
-      planned.receipt.columns,
-    );
-  } catch (error) {
-    return result({
-      ok: false,
-      preExistingDiagnostics: preExistingLayoutDiagnostics,
-      migrationDiagnostics: [diagnostic({
-        code: 'migration/rank-mapping',
-        message: 'Could not construct a stable horizontal rank mapping.',
-        evidence: { reason: error.message },
-        supportedFixes: ['report the workflow and compiler receipts to the Archify maintainers'],
-      })],
-      oldRequiredViewBox,
-      newRequiredViewBox: requiredViewBoxFrom(planned),
-    });
-  }
-
-  const { document: migrated, changedCoordinates } = mappedCandidate;
-
-  let compiled = compileWorkflow({ workflow: migrated, qualityProfile });
-  const requiredExpansion = migrated.meta.viewBox ? expandableViewBox(compiled) : null;
-  if (requiredExpansion) {
-    const current = migrated.meta.viewBox;
-    const expanded = [
-      Math.max(current[0], requiredExpansion[0]),
-      Math.max(current[1], requiredExpansion[1]),
-    ];
-    if (expanded[0] > current[0] || expanded[1] > current[1]) {
-      migrated.meta.viewBox = expanded;
-      compiled = compileWorkflow({ workflow: migrated, qualityProfile });
-    }
-  }
-
-  const newRequiredViewBox = requiredViewBoxFrom(compiled) || requiredViewBoxFrom(planned);
-  if (!compiled.ok) {
-    return result({
-      ok: false,
-      preExistingDiagnostics: preExistingLayoutDiagnostics,
-      newSchemaDiagnostics: compiled.diagnostics,
-      changedCoordinates,
-      oldRequiredViewBox,
-      newRequiredViewBox,
-    });
-  }
-
-  const migratedSchemaDiagnostics = schemaDiagnostics(migrated);
-  if (migratedSchemaDiagnostics.length) {
-    return result({
-      ok: false,
-      preExistingDiagnostics: preExistingLayoutDiagnostics,
-      newSchemaDiagnostics: migratedSchemaDiagnostics,
-      changedCoordinates,
-      oldRequiredViewBox,
-      newRequiredViewBox,
-    });
-  }
-
-  return result({
-    ok: true,
-    document: migrated,
-    preExistingDiagnostics: preExistingLayoutDiagnostics,
-    changedCoordinates,
-    oldRequiredViewBox,
-    newRequiredViewBox,
-  });
-}
-
-export function serializeMigratedWorkflow(workflow) {
-  return `${JSON.stringify(workflow, null, 2)}\n`;
-}

package/template/.hermes/skills/archify/package-lock.json

@@ -1,149 +0,0 @@
-{
-  "name": "archify",
-  "version": "2.16.0",
-  "lockfileVersion": 3,
-  "requires": true,
-  "packages": {
-    "": {
-      "name": "archify",
-      "version": "2.16.0",
-      "license": "MIT",
-      "bin": {
-        "archify": "bin/archify.mjs"
-      },
-      "devDependencies": {
-        "ajv": "^8.17.1",
-        "parse5": "7.3.0",
-        "saxes": "6.0.0",
-        "simple-icons": "16.28.0"
-      },
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/ajv": {
-      "version": "8.20.0",
-      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
-      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "fast-deep-equal": "^3.1.3",
-        "fast-uri": "^3.0.1",
-        "json-schema-traverse": "^1.0.0",
-        "require-from-string": "^2.0.2"
-      },
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/epoberezkin"
-      }
-    },
-    "node_modules/ajv/node_modules/fast-uri": {
-      "version": "3.1.5",
-      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.5.tgz",
-      "integrity": "sha512-gHwA1O9LDIcKunMKhObS/HimwtehO1nPUECKAu5TpKgaO19fcWEl4bliWe1jWxVFvIXztJjjQ4L8XQ1EU9f7Jw==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/fastify"
-        },
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/fastify"
-        }
-      ],
-      "license": "BSD-3-Clause"
-    },
-    "node_modules/entities": {
-      "version": "6.0.1",
-      "resolved": "https://registry.npmjs.org/entities/-/entities-6.0.1.tgz",
-      "integrity": "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==",
-      "dev": true,
-      "license": "BSD-2-Clause",
-      "engines": {
-        "node": ">=0.12"
-      },
-      "funding": {
-        "url": "https://github.com/fb55/entities?sponsor=1"
-      }
-    },
-    "node_modules/fast-deep-equal": {
-      "version": "3.1.3",
-      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
-      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/json-schema-traverse": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
-      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/parse5": {
-      "version": "7.3.0",
-      "resolved": "https://registry.npmjs.org/parse5/-/parse5-7.3.0.tgz",
-      "integrity": "sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "entities": "^6.0.0"
-      },
-      "funding": {
-        "url": "https://github.com/inikulin/parse5?sponsor=1"
-      }
-    },
-    "node_modules/require-from-string": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
-      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/saxes": {
-      "version": "6.0.0",
-      "resolved": "https://registry.npmjs.org/saxes/-/saxes-6.0.0.tgz",
-      "integrity": "sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==",
-      "dev": true,
-      "license": "ISC",
-      "dependencies": {
-        "xmlchars": "^2.2.0"
-      },
-      "engines": {
-        "node": ">=v12.22.7"
-      }
-    },
-    "node_modules/simple-icons": {
-      "version": "16.28.0",
-      "resolved": "https://registry.npmjs.org/simple-icons/-/simple-icons-16.28.0.tgz",
-      "integrity": "sha512-sQPR5AtK/ijRjou7zw7mlLp08oB6FH7i0lOy5XJ2zp9mJs/yejgiOn7KvQoe2q4YJIx6VmgUSW5AOefebPt5kg==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/simple-icons"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/simple-icons"
-        }
-      ],
-      "license": "CC0-1.0",
-      "engines": {
-        "node": ">=0.12.18"
-      }
-    },
-    "node_modules/xmlchars": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/xmlchars/-/xmlchars-2.2.0.tgz",
-      "integrity": "sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==",
-      "dev": true,
-      "license": "MIT"
-    }
-  }
-}

package/template/.hermes/skills/archify/package.json

@@ -1,37 +0,0 @@
-{
-  "name": "archify",
-  "version": "2.16.0",
-  "private": true,
-  "type": "module",
-  "description": "JSON-IR diagram renderers (architecture / workflow / sequence / dataflow / lifecycle).",
-  "license": "MIT",
-  "bin": {
-    "archify": "./bin/archify.mjs"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "generate:brand-marks": "node scripts/generate-brand-marks.mjs",
-    "check:brand-marks": "node scripts/generate-brand-marks.mjs --check",
-    "generate:validators": "node scripts/generate-validators.mjs",
-    "check:validators": "node scripts/generate-validators.mjs --check",
-    "check:release-identity": "node ../scripts/check-release-identity.mjs",
-    "build:gallery": "node ../scripts/build-gallery.mjs ../docs",
-    "build:guide": "node ../scripts/build-guide.mjs ../docs/guide.html",
-    "build:start": "node ../scripts/build-start.mjs ../docs/start.html",
-    "build:readme-showcase": "node ../scripts/build-readme-showcase.mjs",
-    "test:webm": "node test/webm-artifact.smoke.mjs && node --test test/site-language-integration.mjs",
-    "test": "npm run check:brand-marks && npm run check:validators && npm run check:release-identity && node test/golden.mjs && node ../scripts/run-tests.mjs",
-    "render:examples": "node scripts/render-examples.mjs ../examples"
-  },
-  "devDependencies": {
-    "ajv": "^8.17.1",
-    "parse5": "7.3.0",
-    "saxes": "6.0.0",
-    "simple-icons": "16.28.0"
-  },
-  "overrides": {
-    "fast-uri": "3.1.5"
-  }
-}