MVP

.claude/README.md

@@ -0,0 +1,20 @@
+# Claude Code Configuration
+
+This directory contains configuration and customizations for Claude Code.
+
+## ⚠️ Project Requirements
+
+**IMPORTANT:** This project requires `GOEXPERIMENT=jsonv2,synctest` for all `go` commands.
+
+See [project-config.md](project-config.md) for complete details.
+
+## Directory Structure
+
+- `commands/` - Custom slash commands
+- `skills/` - Reusable skills that can be invoked during conversations
+- `prompts/` - Reusable prompts and sub-agent definitions
+- `project-config.md` - Project-specific configuration and requirements
+
+## Documentation
+
+For more information, see the [Claude Code documentation](https://docs.claude.com/claude-code).

.claude/commands/README.md

@@ -0,0 +1,13 @@
+# Custom Slash Commands
+
+Place custom slash command markdown files here. Each file defines a command that can be invoked with `/command-name`.
+
+## Example
+
+Create a file `example.md`:
+
+```markdown
+Print "Hello from custom command!"
+```
+
+Then invoke it with `/example` in Claude Code.

.claude/commands/lint.md

@@ -0,0 +1,52 @@
+---
+description: Run comprehensive Go linting and static analysis tools
+---
+
+# Go Linting Suite
+
+Run a comprehensive suite of Go linting and static analysis tools on the codebase.
+
+**IMPORTANT:** This project requires `GOEXPERIMENT=jsonv2,synctest` to be set for all `go` commands. See `.claude/project-config.md` for details.
+
+## Steps to Execute
+
+1. **Run go vet**
+   - Execute: `go vet ./...`
+   - Report any issues with file paths and line numbers
+
+2. **Run golangci-lint**
+   - Execute: `go tool golangci-lint run`
+   - Report any issues with file paths and line numbers
+   - Highlight critical vs warning vs style issues
+
+3. **Summarize results**
+   - Count total issues by severity
+   - Provide clickable file references using markdown format: `[filename.go:42](path/to/filename.go#L42)`
+   - If all checks pass, clearly state "All linting checks passed ✓"
+   - If there are issues, prioritize them by severity
+
+## Output Format
+
+Present results in this format:
+
+```
+## Linting Results
+
+### go vet
+[Status and issues]
+
+### staticcheck
+[Status and issues]
+
+### golangci-lint
+[Status and issues]
+
+### Summary
+[Total count and severity breakdown]
+```
+
+## Error Handling
+
+- If a linter fails due to version compatibility, note this and continue
+- Don't fail the entire check if one linter has issues
+- Suggest fixes when appropriate (e.g., adding `//lint:ignore` comments)

.claude/project-config.md

@@ -0,0 +1,46 @@
+# Project Configuration
+
+This file contains project-specific configuration and requirements for Claude Code.
+
+## Go Environment
+
+**IMPORTANT:** All `go` commands in this project MUST be run with the `GOEXPERIMENT=jsonv2,synctest` environment variable set.
+
+### Examples
+
+```bash
+# Running tests
+GOEXPERIMENT=jsonv2,synctest go test ./...
+
+# Running go vet
+GOEXPERIMENT=jsonv2,synctest go vet ./...
+
+# Building
+GOEXPERIMENT=jsonv2,synctest go build ./...
+
+# Running the application
+GOEXPERIMENT=jsonv2,synctest go run ./cmd/app
+
+# Installing tools
+GOEXPERIMENT=jsonv2,synctest go install example.com/tool@latest
+```
+
+### Why?
+
+This project uses the `jsonv2` experiment which provides an improved JSON API for Go.
+
+### Linting Tools
+
+When running linting tools that invoke `go`, ensure they also respect this environment variable:
+
+```bash
+# golangci-lint
+GOEXPERIMENT=jsonv2,synctest go tool golangci-lint run
+
+# staticcheck may also need this if it invokes go
+GOEXPERIMENT=jsonv2,synctest staticcheck ./...
+```
+
+## Makefile
+
+The project includes a Makefile that already sets `GOEXPERIMENT=jsonv2,synctest`. Prefer using `make` targets when available.

.claude/prompts/README.md

@@ -0,0 +1,3 @@
+# Prompts
+
+Place reusable prompts and sub-agent definitions here. These can be referenced in commands, skills, or invoked directly.

.claude/skills/README.md

@@ -0,0 +1,7 @@
+# Skills
+
+Place skill definitions here. Skills are specialized capabilities that can be invoked during conversations.
+
+## Structure
+
+Each skill should be in its own directory with a `skill.md` file that defines the skill's behavior.

.github/workflows/pr-check.yml

@@ -0,0 +1,64 @@
+name: PR Check
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  gen:
+    runs-on: ubuntu-latest
+    steps:
+      - &checkout
+        uses: actions/checkout@v4
+      - &setup-go
+        name: Set up Go
+        uses: actions/[email protected]
+        with:
+          go-version-file: "go.mod"
+      - name: Generate
+        run: make gen
+      - &check-no-mod
+        name: Ensure tracked files were up to date
+        run: ./scripts/git_tracked_are_unmodified
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - *checkout
+      - *setup-go
+      - name: Lint
+        run: make lint-ci
+      - name: Determine golangci-lint version
+        id: golangci-lint-version
+        run: echo "golangci-lint-version=$(go list -modfile=golangci-lint.mod -m github.com/golangci/golangci-lint/v2 | awk '{print $2}')" >> "$GITHUB_OUTPUT"
+      - name: golangci-lint
+        uses: golangci/[email protected]
+        with:
+          version: ${{ steps.golangci-lint-version.outputs.golangci-lint-version }}
+        env:
+          GOEXPERIMENT: "jsonv2,synctest" # align with `Makefile` (export GOEXPERIMENT)
+      - *check-no-mod
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy: &strategy
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - *checkout
+      - *setup-go
+      - name: Test
+        run: make test
+        env:
+          TEST_LOG: fail
+      - name: Ensure tracked files were up to date
+        run: ./scripts/git_tracked_are_unmodified
+  build:
+    runs-on: ${{ matrix.os }}
+    strategy: *strategy
+    steps:
+      - *checkout
+      - *setup-go
+      - name: Build
+        run: make build-only
+      - *check-no-mod

.gitignore

@@ -0,0 +1,29 @@
+# overmind
+.overmind.sock
+
+# macOS
+.DS_Store
+
+# Temporary files
+/tmp/*
+!/tmp/.keep
+
+# Misc
+/bin
+__debug_bin*
+
+# Programming languages
+/vendor
+/out
+/node_modules
+
+# Environment
+.env
+.env.*
+!.env.example
+
+# Claude Code
+.claude/settings.local.json
+
+# Misc IDEs
+/.idea

.vscode/launch.json

@@ -0,0 +1,70 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Run TUI",
+            "type": "go",
+            "request": "launch",
+            "mode": "debug",
+            "program": "${workspaceFolder}/cmd/lapiasse",
+            "cwd": "${workspaceFolder}",
+            "args": [
+                "tui",
+            ],
+            "env": {
+                "GOEXPERIMENT": "jsonv2,synctest",
+            }
+        },
+        {
+            "name": "Run Serve",
+            "type": "go",
+            "request": "launch",
+            "mode": "debug",
+            "program": "${workspaceFolder}/cmd/lapiasse",
+            "cwd": "${workspaceFolder}",
+            "args": [
+                "serve",
+            ],
+            "env": {
+                "GOEXPERIMENT": "jsonv2,synctest"
+            }
+        },
+        {
+            "name": "Run Serve, dry start",
+            "type": "go",
+            "request": "launch",
+            "mode": "debug",
+            "program": "${workspaceFolder}/cmd/lapiasse",
+            "cwd": "${workspaceFolder}",
+            "args": [
+                "serve",
+                "--dry-start"
+            ],
+            "env": {
+                "GOEXPERIMENT": "jsonv2,synctest"
+            }
+        },
+        {
+            "name": "Moneydance Importer",
+            "type": "go",
+            "request": "launch",
+            "mode": "debug",
+            "program": "${workspaceFolder}/cmd/import_md_to_lapiasse",
+            "cwd": "${workspaceFolder}",
+            "args": [
+                "--md-source",
+                "${workspaceFolder}/tmp/md.json",
+                "--api-token",
+                "dev-static-token",
+                "--book-name",
+                "Dev Imported",
+                "--skip-suffix-to-book-name",
+                "--delete-book-if-exists",
+                "true"
+            ],
+            "env": {
+                "GOEXPERIMENT": "jsonv2,synctest"
+            }
+        }
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,11 @@
+{
+  "go.toolsEnvVars": {
+    "GOEXPERIMENT": "jsonv2,synctest",
+    "PWD": "${workspaceFolder}",
+    "WORKSPACE_ROOT": "${workspaceFolder}",
+  },
+  "go.buildTags": "test",
+  "yaml.schemas": {
+    "openapi:v3": "file:///Users/adeynack/src/github.com/Adeynack/lapiasse/pkg/api/lapiasse.oas.yaml"
+  }
+}