@aihu/language-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fellwork
+
+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,123 @@
+# @aihu/language-server
+
+> **Aihu** — agentic discovery and interaction, for human purpose.
+
+Cross-editor Language Server (aihu-language-server) for .aihu Single File Components — diagnostics, hover, completion, and quick-fix code actions.
+
+Held-private workspace package. Not yet published to npm.
+
+> **Status:** Held private — not yet published to npm. See [v1.1 roadmap](../../docs/roadmap/SUMMARY.md) for ratification gating (e.g. RFC #56 live-binding for `@aihu/plugin` enforcement).
+
+<!-- BEGIN_HANDWRITTEN: prose -->
+Cross-editor [Language Server Protocol](https://microsoft.github.io/language-server-protocol/)
+implementation for `.aihu` Single File Components. Ships the runnable
+`aihu-language-server` binary that any LSP-aware editor (VS Code, Neovim, Helix,
+Zed, …) can launch over stdio.
+
+## Features
+
+- **Diagnostics** — shells out to the `aihu-compile` Rust binary with
+  `--machine-errors` (debounced 300 ms) and maps the structured errors onto LSP
+  diagnostics.
+- **Hover** — Markdown documentation for the 13 aihu macro keywords, aware of
+  `@state` vs `@template` block context.
+- **Completion** — 9 `$`-triggered macro-kind snippets (context-filtered) and 5
+  `@`-triggered top-level block names.
+- **Code actions** — QuickFix for the `C440`–`C444` old-spec macro diagnostics,
+  backed by the macro-simplification codemod.
+
+## Layout
+
+The package is laid out with a clean editor-agnostic seam (`src/core/`) so a
+future `@volar/language-core` virtual-code layer can consume the same
+diagnostics/hover/completion/code-action logic without touching the connection
+wiring (arch-4 §2.7). Volar is **not** adopted yet — that is a separate
+Phase-2 decision.
+
+- `src/core/*` — pure logic + the compiler bridge (no LSP connection objects).
+- `src/server.ts` — wires the core onto a `vscode-languageserver` connection.
+- `src/bin.ts` — the runnable `aihu-language-server` stdio entry.
+<!-- END_HANDWRITTEN: prose -->
+
+## Install
+
+<!-- BEGIN_AUTOGEN: install -->
+<!-- regenerate: bun scripts/sync-readme.ts (also runs in pre-commit + CI) -->
+
+```bash
+npm install @aihu/language-server
+# or
+bun add @aihu/language-server
+```
+
+<sub><i>Auto-generated against `@aihu/language-server@0.1.0`.</i></sub>
+
+<!-- END_AUTOGEN: install -->
+
+## Package facts
+
+<!-- BEGIN_AUTOGEN: stats -->
+<!-- regenerate: bun scripts/sync-readme.ts (also runs in pre-commit + CI) -->
+
+| | |
+|---|---|
+| **Version** | `0.1.0` |
+| **Tier** | E — Held private (unmapped tier) |
+| **Published files** | 3 entries |
+| **License** | MIT |
+
+<sub><i>Auto-generated against `@aihu/language-server@0.1.0`.</i></sub>
+
+<!-- END_AUTOGEN: stats -->
+
+## Exports
+
+<!-- BEGIN_AUTOGEN: exports -->
+<!-- regenerate: bun scripts/sync-readme.ts (also runs in pre-commit + CI) -->
+
+| Subpath | ESM | CJS |
+|---|---|---|
+| `.` | `./dist/server.js` | `—` |
+| `./core` | `./dist/core/index.js` | `—` |
+
+<sub><i>Auto-generated against `@aihu/language-server@0.1.0`.</i></sub>
+
+<!-- END_AUTOGEN: exports -->
+
+## Dependencies
+
+<!-- BEGIN_AUTOGEN: deps -->
+<!-- regenerate: bun scripts/sync-readme.ts (also runs in pre-commit + CI) -->
+
+**Dependencies:**
+
+- `@aihu/compiler` — `workspace:*`
+- `vscode-languageserver` — `^9.0.1`
+- `vscode-languageserver-textdocument` — `^1.0.11`
+
+<sub><i>Auto-generated against `@aihu/language-server@0.1.0`.</i></sub>
+
+<!-- END_AUTOGEN: deps -->
+
+## See also
+
+<!-- BEGIN_AUTOGEN: see-also -->
+<!-- regenerate: bun scripts/sync-readme.ts (also runs in pre-commit + CI) -->
+
+- [Aihu framework root](../../README.md)
+- [v1.1 roadmap](../../docs/roadmap/SUMMARY.md)
+
+<sub><i>Auto-generated against `@aihu/language-server@0.1.0`.</i></sub>
+
+<!-- END_AUTOGEN: see-also -->
+
+## License
+
+<!-- BEGIN_AUTOGEN: license -->
+<!-- regenerate: bun scripts/sync-readme.ts (also runs in pre-commit + CI) -->
+
+MIT — see [LICENSE](../../LICENSE).
+
+<sub><i>Auto-generated against `@aihu/language-server@0.1.0`.</i></sub>
+
+<!-- END_AUTOGEN: license -->