@bynlk/codeomnivis 0.0.0-bootstrap.0

package/LICENSE

@@ -0,0 +1,77 @@
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright in
+it for any purpose permitted below in **Noncommercial
+Purposes**.  When you do so, all copies must include this
+license and the copyright notice below.
+
+## Noncommercial Purposes
+
+**Noncommercial Purposes** means any purpose that is not
+primarily intended for or directed towards commercial
+advantage or monetary compensation.  Noncommercial Purposes
+include:
+
+- personal uses
+- hobbyist uses
+- research uses
+- uses by nonprofit organizations
+- uses by educational institutions
+- uses for testing or evaluation
+
+Commercial purposes include:
+
+- selling the software or services based on the software
+- using the software in a product or service that you sell
+- using the software to provide a service to paying clients
+- using the software in an advertising-supported product
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as a copy of the copyright
+notice above.
+
+## Excuse
+
+If anyone notifies you in writing that you have not
+complied with [Notices](#notices), you can keep your
+license by taking all practical steps to comply within 30
+days after the notice.  If you do not do so, your license
+ends immediately.
+
+## Patent License
+
+The licensor grants you a patent license for the software
+that covers patent claims the licensor can license, or
+becomes able to license, that you would infringe by using
+the software, for any purpose permitted below in
+**Noncommercial Purposes**.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any
+of your licenses to anyone else, or prevent anyone else from
+having their own licenses to the software.  These terms do
+not imply any other licenses.
+
+## No Liability
+
+**The software comes as is, with no warranties or
+conditions of any kind.  The licensor will not be liable
+to you for any damages arising out of these terms or the
+use or nature of the software, under any kind of legal
+claim.**

package/README.md

@@ -0,0 +1,62 @@
+# @bynlk/codeomnivis
+
+CodeOmniVis is a zero-config TypeScript full-stack architecture visualizer. One analyzer-owned `ProjectSnapshot` is projected through the CLI, the local Web/REST workbench, and MCP so humans and AI coding agents refer to the same node IDs, edge IDs, and `snapshotDigest`.
+
+## Quick start
+
+Run this at the root of a TypeScript or mixed TypeScript/Kotlin repository:
+
+```bash
+npx @bynlk/codeomnivis serve
+```
+
+Or point it at another local project:
+
+```bash
+npx @bynlk/codeomnivis serve --project /absolute/path/to/repository
+```
+
+## Public command contract
+
+The following fenced block is verified against the CLI command registry:
+
+```codeomnivis-cli-contract
+analyze
+check
+init
+mcp
+serve
+test-import
+test-run
+```
+
+| Command | Purpose |
+| --- | --- |
+| `serve --project <path> [--port <port>] [--host <host>] [--no-open]` | Analyze, open the local workbench, watch source files, and publish updates |
+| `analyze --project <path> [--output <file>] [--json]` | Write a graph or versioned snapshot envelope |
+| `check` | Print parser diagnostics and deterministic findings for the current directory |
+| `mcp --project <path>` | Start the protocol-only stdio MCP server |
+| `test-import --project <path> --junit <file-or-glob>` | Import bounded JUnit XML without executing tests |
+| `test-run --project <path> --runner <name> [--timeout <ms>]` | Explicitly execute an enumerated, shell-free test runner |
+| `init` | Generate a starter `.codeomnivis.json` file |
+
+Static analysis commands never execute target tests. Only `test-run` can do so, with validated paths, an argument array, `shell: false`, a 1-second to 30-minute timeout, and a 10 MiB output cap.
+
+## Local and remote access
+
+Loopback `serve` is zero-config. Binding to a non-loopback host requires `--token`; protected REST and WebSocket requests use a bearer token or a short-lived HttpOnly browser session. Keep the workbench local unless remote access is intentional.
+
+## Documentation
+
+- [GitHub repository](https://github.com/Bynlk/CodeOmniVis)
+- [English README](https://github.com/Bynlk/CodeOmniVis#readme)
+- [中文 README](https://github.com/Bynlk/CodeOmniVis/blob/master/README.zh-CN.md)
+- [Test intelligence](https://github.com/Bynlk/CodeOmniVis/blob/master/docs/guides/test-intelligence.md)
+- [MCP tools](https://github.com/Bynlk/CodeOmniVis/blob/master/docs/api/mcp-tools.md)
+- [REST API](https://github.com/Bynlk/CodeOmniVis/blob/master/docs/api/rest-api.md)
+
+CodeOmniVis analyzes source locally. Static analysis can miss runtime dependency injection, generated code, dynamic imports, reflective test registration, and metaprogramming; inspect confidence and source locations before making high-risk changes.
+
+## License
+
+PolyForm Noncommercial License 1.0.0. Commercial use requires separate permission.

package/bin/codeomnivis.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+/**
+ * CodeOmniVis CLI 入口
+ *
+ * 这个文件是 npm bin 的入口点。
+ * 它会加载编译后的 CLI 代码。
+ */
+
+import('../dist/index.js')
+  .then((module) => {
+    // Development tests may intentionally execute against an older dist build,
+    // whose import side effect already starts the CLI and has no runCli export.
+    if (typeof module.runCli === 'function') return module.runCli()
+  })
+  .catch((err) => {
+    console.error('Failed to load CodeOmniVis CLI:', err)
+    process.exit(1)
+  })