V2.2/V2.3/V2.3.1 — Indoors phase + deterministic findPath + town/castle classification

.devcontainer/devcontainer.json

@@ -0,0 +1,12 @@
+{
+  "name": "Java",
+  "image": "mcr.microsoft.com/devcontainers/java:1-21",
+  "features": {
+    "ghcr.io/devcontainers/features/java:1": {
+      "version": "none",
+      "installMaven": "true",
+      "mavenVersion": "3.8.6",
+      "installGradle": "true"
+    }
+  }
+}

.github/workflows/build.yml

@@ -0,0 +1,30 @@
+name: Java CI
+
+on:
+  push:
+    branches: [ "**" ]
+  pull_request:
+    branches: [ "**" ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up JDK 17
+      uses: actions/setup-java@v4
+      with:
+        java-version: '17'
+        distribution: 'temurin'
+        cache: gradle
+
+    - name: Validate Gradle wrapper
+      uses: gradle/actions/wrapper-validation@v4
+
+    - name: Build with Gradle
+      run: ./gradlew build
+
+    - name: Run tests
+      run: ./gradlew test

.github/workflows/junie.yml

@@ -0,0 +1,22 @@
+name: Junie
+run-name: Junie run ${{ inputs.run_id }}
+
+permissions:
+  contents: write
+  pull-requests: write
+
+on:
+  workflow_dispatch:
+    inputs:
+      run_id:
+        description: "id of workflow process"
+        required: true
+      workflow_params:
+        description: "stringified params"
+        required: true
+
+jobs:
+  call-workflow-passing-data:
+    uses: jetbrains-junie/junie-workflows/.github/workflows/ej-issue.yml@main
+    with:
+      workflow_params: ${{ inputs.workflow_params }}

.github/workflows/test.yml

@@ -0,0 +1,19 @@
+name: Test
+
+on:
+  push:
+    branches: ['**']
+  pull_request:
+    branches: [master]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '17'
+      - uses: gradle/actions/setup-gradle@v4
+      - run: ./gradlew test

.gitignore

@@ -0,0 +1,52 @@
+# Gradle
+.gradle/
+.history/
+build/
+
+# Java
+*.class
+*.jar
+*.war
+*.ear
+!gradle/wrapper/gradle-wrapper.jar
+
+# IntelliJ IDEA
+.idea/
+*.iml
+*.ipr
+*.iws
+out/
+
+# Kotlin
+.kotlin/
+
+# Eclipse
+.project
+.classpath
+.settings/
+bin/
+
+# NetBeans
+nbproject/private/
+build/
+nbbuild/
+dist/
+nbdist/
+.nb-gradle/
+
+# VS Code
+.vscode/
+
+# macOS
+.DS_Store
+
+# Logs
+*.log
+
+# Temporary files
+*.tmp
+*.swp
+*.nes
+!**/src/test/resources/*.nes
+knes-agent/runs/
+roms

.junie/guidelines.md

@@ -0,0 +1,98 @@
+# kNES Project Guidelines
+
+## Project Overview
+
+kNES is a Nintendo Entertainment System (NES) emulator implemented in Java. It allows users to play NES games on modern computers by emulating the hardware of the original Nintendo Entertainment System. The emulator is implemented as a Java applet, which can be run either in a compatible browser or as a standalone application using the provided AppletLauncher.
+
+### Key Features
+
+- NES hardware emulation
+- Support for loading and playing NES ROM files
+- Java-based implementation for cross-platform compatibility
+- Multiple ways to run the emulator (standalone, applet, etc.)
+
+## Technical Architecture
+
+The project is structured as follows:
+
+- `src/main/java/` - Java source files containing the emulator implementation
+- `src/main/resources/` - Resource files (palettes)
+- `roms/` - Directory for storing NES ROM files (not included in the repository)
+- `build.gradle` - Gradle build configuration
+- `settings.gradle` - Gradle settings
+- `all.policy` - Java security policy file for running the applet
+
+## Development Guidelines
+
+### Environment Setup
+
+- **Java Version**: Java 8 (JDK 1.8) is required as it's the last Java version with full applet support
+- **Build System**: Gradle (wrapper included in the repository)
+- **IDE**: Any Java IDE with Gradle support (IntelliJ IDEA, Eclipse, etc.)
+
+### Building the Project
+
+To build the project:
+
+```
+./gradlew build
+```
+
+This will compile the Java sources and create a JAR file in `build/libs/kNES.jar`.
+
+### Running the Application
+
+There are multiple ways to run the application:
+
+1. **Using Gradle run task (recommended)**:
+   ```
+   ./gradlew run
+   ```
+
+2. **Running the JAR file directly**:
+   ```
+   java -jar build/libs/kNES.jar
+   ```
+
+3. **Using Gradle runApplet task** (requires Java 8 with appletviewer):
+   ```
+   ./gradlew runApplet
+   ```
+
+4. **Using a Java 8 compatible browser** (requires Java 8):
+   After running the build task, an HTML file is generated at `build/applet.html`. You can open this file in a browser that supports Java applets (with the Java plugin enabled).
+
+### Using ROM Files
+
+To use the emulator, you need to provide NES ROM files:
+
+1. Create a `roms` directory in the project root (if not already created)
+2. Place your NES ROM files (`.nes` files) in the `roms` directory
+3. When running the application, you can load a ROM by:
+   - Placing a ROM file named `knes.nes` in the project root directory, or
+   - Using the file chooser in the application to select a ROM file
+
+### Continuous Integration
+
+This project uses GitHub Actions for continuous integration. The workflow:
+
+- Runs on every push and pull request
+- Builds the project with Gradle
+- Runs tests to verify functionality
+- Uses Java 8 (JDK 1.8) for compatibility
+
+## Contributing
+
+When contributing to this project, please follow these guidelines:
+
+1. Create a feature branch for your changes
+2. Follow Java coding conventions
+3. Write tests for new functionality
+4. Update documentation as needed
+5. Submit a pull request for review
+
+## Notes and Limitations
+
+- Java applets are deprecated technology and may not work in modern browsers
+- This project is configured to use Java 8, which is the last version with full applet support
+- NES ROM files are not included with this project. You must obtain them legally elsewhere.

.mcp.json

@@ -0,0 +1,7 @@
+{
+  "mcpServers": {
+    "knes": {
+      "command": "/Users/askowronski/Priv/kNES/knes-mcp/build/install/knes-mcp/bin/knes-mcp"
+    }
+  }
+}

.sdkmanrc

@@ -0,0 +1 @@
+java=25-tem