Init project

Author: hxgdzyuyi

.github/workflows/ci.yml

@@ -0,0 +1,24 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  go:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+          cache: true
+
+      - name: Test
+        run: go test ./...
+
+      - name: Vet
+        run: go vet ./...

.github/workflows/release.yml

@@ -0,0 +1,43 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  build-macos:
+    runs-on: macos-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+          cache: true
+
+      - name: Test
+        run: go test ./...
+
+      - name: Build macOS ARM64 binary
+        run: |
+          mkdir -p dist
+          GOOS=darwin GOARCH=arm64 CGO_ENABLED=0 go build -trimpath -o dist/narrc ./cmd/narrc
+
+      - name: Package binary
+        run: |
+          tar -czf dist/narrc-darwin-arm64.tar.gz -C dist narrc
+
+      - name: Create release and upload asset
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG_NAME: ${{ github.ref_name }}
+        run: |
+          gh release view "$TAG_NAME" >/dev/null 2>&1 || \
+            gh release create "$TAG_NAME" --title "$TAG_NAME" --generate-notes
+          gh release upload "$TAG_NAME" dist/narrc-darwin-arm64.tar.gz --clobber

.gitignore

@@ -0,0 +1 @@
+.DS_Store

AGENTS.md

@@ -0,0 +1,29 @@
+# Repository Guidelines
+
+## Scope
+
+This repository is implementing `narrc`, a Go CLI for the Narr language.
+The language grammar source of truth is `docs/syntax.md`; milestone planning
+is tracked in `docs/plans/narrc-go-implementation-plan.md`.
+
+## Build And Test
+
+- Format Go changes with `gofmt`.
+- Run `go test ./...` before handing off Go changes.
+- Use `go run ./cmd/narrc --version` for the smallest CLI smoke test.
+- Use `go run ./cmd/narrc lint --project examples/红楼梦` to verify the M1
+  project-loading path.
+
+## Project Layout
+
+- CLI entry point: `cmd/narrc/main.go`.
+- CLI parsing and command dispatch: `internal/cli`.
+- Project discovery, config loading, and file collection: `internal/project`.
+- Diagnostics and source positions: `internal/source`.
+- User-facing output formatting: `internal/format`.
+
+## Implementation Notes
+
+- Keep parser/checker/evaluator work aligned with `docs/syntax.md`.
+- Do not add syntax that is not documented in `docs/syntax.md`.
+- Keep generated build output out of source control.

Makefile

@@ -0,0 +1,19 @@
+.PHONY: build install test smoke clean
+
+BINARY := narrc
+CMD := ./cmd/narrc
+
+build:
+	go build -o bin/$(BINARY) $(CMD)
+
+install:
+	go install $(CMD)
+
+test:
+	go test ./...
+
+smoke:
+	go run $(CMD) --version
+
+clean:
+	rm -rf bin