visigraph 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Textology Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# visigraph
+
+Command line for [VisiGraph](https://github.com/textologylabs/visigraph):
+architecture models you can play through.
+
+Early, pre-1.0. Today it validates a model; the journey player follows.
+
+```sh
+npx visigraph validate model.yaml
+```
+
+Resolves every identifier in the model and exits 1 on any dangling
+reference, with a path to each one:
+
+```
+error: model.yaml:journeys[0].steps[2].endpoint: container 'auth-service' has no endpoint 'token'
+```

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/main.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+import { parseArgs } from "node:util";
+import { loadModel, resolve } from "@visigraph/core";
+const USAGE = `usage: visigraph validate <model.yaml>
+
+Resolves every identifier in the model. Exits 1 on any dangling reference.`;
+async function main(argv) {
+    const { positionals } = parseArgs({ args: argv, allowPositionals: true, strict: true });
+    const [command, file] = positionals;
+    if (command !== "validate" || !file) {
+        console.error(USAGE);
+        return 2;
+    }
+    const parsed = await loadModel(file);
+    let diagnostics = parsed.diagnostics;
+    if (parsed.model) {
+        diagnostics = diagnostics.concat(resolve(parsed.model).diagnostics);
+    }
+    for (const d of diagnostics) {
+        const where = d.path ? `${file}:${d.path}` : file;
+        console.error(`${d.severity}: ${where}: ${d.message}`);
+    }
+    if (diagnostics.length > 0) {
+        console.error(`${diagnostics.length} error${diagnostics.length === 1 ? "" : "s"}`);
+        return 1;
+    }
+    console.log(`${file}: ok`);
+    return 0;
+}
+main(process.argv.slice(2)).then((code) => process.exit(code), (e) => {
+    console.error(`error: ${e instanceof Error ? e.message : String(e)}`);
+    process.exit(2);
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAmB,MAAM,iBAAiB,CAAC;AAEtE,MAAM,KAAK,GAAG;;2EAE6D,CAAC;AAE5E,KAAK,UAAU,IAAI,CAAC,IAAc;IAChC,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACxF,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,WAAW,CAAC;IAEpC,IAAI,OAAO,KAAK,UAAU,IAAI,CAAC,IAAI,EAAE,CAAC;QACpC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,WAAW,GAAiB,MAAM,CAAC,WAAW,CAAC;IACnD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAClD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,MAAM,SAAS,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QACnF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC;IAC3B,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAC9B,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAC5B,CAAC,CAAU,EAAE,EAAE;IACb,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CACF,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "visigraph",
+  "version": "0.0.1",
+  "description": "VisiGraph CLI \u2014 validate architecture models and play journeys through them",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "visigraph": "./dist/main.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/textologylabs/visigraph.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/textologylabs/visigraph",
+  "dependencies": {
+    "@visigraph/core": "0.0.1"
+  },
+  "bugs": {
+    "url": "https://github.com/textologylabs/visigraph/issues"
+  },
+  "keywords": [
+    "architecture",
+    "c4",
+    "journeys",
+    "diagram",
+    "model",
+    "visigraph"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}