| name | lsharp-usage |
| description | L# v0.1.0 / v0.1.0-native-rc1 のインストール、公開 CLI、Wasm 生成、metadata test/doc、LSP/MCP、native RC の扱いを案内する。Use when users want to install, try, run, or explain the current L# language distribution. |
L# 利用スキル
このスキルは、現在の L# (lsharp) を利用者向けに案内・実行するための手順をまとめる。自然言語の説明は日本語で行い、コマンドやコードはそのまま提示する。
現在の配布前提
- installable release:
v0.1.0-native-rc1
- installed binary version:
lsharp 0.1.0
- primary install location:
~/.local/bin
- stable user-facing distribution: Rust host launcher + embedded/selfhost guest component
- experimental native-only RC: self-regeneration evidence bundle; stable CLI replacement ではない
experimental-native-rc-* の program.native は通常の利用者向け lsharp CLI として案内しない。日常利用には lsharp-v0.1.0-native-rc1-aarch64-apple-darwin.tar.gz に含まれる packaged lsharp を使う。
インストール
macOS Apple Silicon の現在の RC は GitHub Release から curl で ~/.local/bin に入れる。
curl -fsSL https://github.com/biwakonbu/lsharp/releases/download/v0.1.0-native-rc1/install.sh \
| LSHARP_VERSION=v0.1.0-native-rc1 sh
export PATH="$HOME/.local/bin:$PATH"
lsharp --version
期待される出力:
lsharp 0.1.0
install されるファイル:
~/.local/bin/lsharp
~/.local/bin/lsharp-lsp
~/.local/bin/lsharp.component.wasm
別の場所へ入れる場合:
curl -fsSL https://github.com/biwakonbu/lsharp/releases/download/v0.1.0-native-rc1/install.sh \
| LSHARP_VERSION=v0.1.0-native-rc1 LSHARP_INSTALL_DIR="$HOME/bin" sh
Hello World / compile
公開 CLI の基本導線は compile。parse / check / fmt はユーザー向けの主導線として案内せず、LSP/MCP 内部 API 寄りとして扱う。
cat > hello.ls <<'EOF'
(defn main [] 42)
EOF
lsharp compile hello.ls -o hello.wasm
生成物が Wasm であることを確認する場合:
xxd -p -l 4 hello.wasm
期待値:
0061736d
metadata test
:example / :invariant を書くと lsharp test で検証できる。
cat > metadata.ls <<'EOF'
(defn abs
[x]
:doc "整数の絶対値を返す。"
:params [(x "対象の整数")]
:returns "x の絶対値"
:example [(= (abs 5) 5)]
:invariant (>= result 0)
(if (< x 0) (- 0 x) x))
EOF
lsharp test metadata.ls
docs
HTML docs:
lsharp doc metadata.ls -o metadata.html
JSON docs:
lsharp doc metadata.ls --json -o api.json
IDE / AI backend
IDE:
lsharp lsp
AI / tool backend:
lsharp mcp-server
外部 compiler / 配布物の接続確認
LSHARP_PATH は、埋め込み guest component の代わりに外部 compiler / 配布物への process-entry delegation を試すための入口。
LSHARP_PATH=/path/to/lsharp lsharp --version
よくある判断
- 利用者に「Rust toolchain が必要か」と聞かれたら、installable release を使うだけなら不要と答える。
~/.local/bin が PATH にない場合は、export PATH="$HOME/.local/bin:$PATH" を案内する。- native-only が正式置換済みか聞かれたら、現時点では experimental RC であり、official stable 置換には archive layout / release smoke / signing-notarization / rollback anchor / Tier1 target matrix が残ると説明する。
- smoke test は
lsharp compile hello.ls -o hello.wasm と Wasm magic 0061736d の確認を優先する。
