Finish renaming to Ampere, add basic CLI

Author: wow-miley

.aiassistant/rules/file_structure.md

@@ -4,11 +4,11 @@ instructions: When a new file need to be created.
 ---
 
 You must decide the file's location and name based on the area of the codebase that it represents. Examples:
-- If creating `*UseCase.kt` for new shared functionality, then it should go in `/shared/src/commonMain/kotlin/link/socket/kore/domain/usecase`
+- If creating `*UseCase.kt` for new shared functionality, then it should go in `/shared/src/commonMain/kotlin/link/socket/ampere/domain/usecase`
 - If you are providing the `actual` definition for a new `commonMain` value/function, then it should stay within that module's folder, and the file must end in `*.$platform.kt`. Example:
-  - There is `expect fun foo()` defined in `/shared/src/commonMain/kotlin/link/socket/kore/io/Foo.kt`
-  - The Android `actual fun foo()` should be generated in `/shared/src/androidMain/kotlin/link/socket/kore/io/Foo.android.kt`
-  - The Desktop `actual fun foo()` should be generated in `/shared/src/jvmMain/kotlin/link/socket/kore/io/Foo.jvm.kt`
+  - There is `expect fun foo()` defined in `/shared/src/commonMain/kotlin/link/socket/ampere/io/Foo.kt`
+  - The Android `actual fun foo()` should be generated in `/shared/src/androidMain/kotlin/link/socket/ampere/io/Foo.android.kt`
+  - The Desktop `actual fun foo()` should be generated in `/shared/src/jvmMain/kotlin/link/socket/ampere/io/Foo.jvm.kt`
 - If you are defining new functionality that is specific to _only_ one platform then it must go in the folder for that platform. Examples:
   - The Android app is defined in `MainActivity.kt` and `AndroidMainfest.xml`, which are both in `/androidApp/src/androidMain/*`
-  - The Desktop app is defined in `Main.kt`, which is in `/desktopApp/src/jvmMain/kotlin/link/socket/kore/Main.kt`
+  - The Desktop app is defined in `Main.kt`, which is in `/desktopApp/src/jvmMain/kotlin/link/socket/ampere/Main.kt`

.junie/guidelines.md

@@ -2,12 +2,12 @@
 
 ## Project overview
 
-Kore AI is a Kotlin Multiplatform (KMP) project that provides a shared core for building conversational AI agents and
+Ampere is a Kotlin Multiplatform (KMP) project that provides a shared core for building conversational AI agents and
 multiple platform apps that consume this core.
 
 - shared: Multiplatform library containing the domain and model layers for agents, chat, conversations, capabilities,
   and tools.
-    - Common code: `shared/src/commonMain/kotlin/link/socket/kore/...`
+    - Common code: `shared/src/commonMain/kotlin/link/socket/ampere/...`
     - Platform code: `shared/src/{androidMain,iosMain,jvmMain}`
     - Tests: `shared/src/jvmTest`
 - androidApp: Android application that uses the shared module.
@@ -39,7 +39,7 @@ multiple platform apps that consume this core.
 
 ## Notes for this repository
 
-- The main package namespace is `link.socket.kore.*`.
+- The main package namespace is `link.socket.ampere.*`.
 - Key domains in `shared/src/commonMain/kotlin` include:
     - `domain/chat` and `domain/conversation`: Conversation, Chat, and system instructions (tone, seriousness).
     - `domain/capability`: Capability abstractions.

CLAUDE.md

@@ -160,7 +160,7 @@ Repository pattern with SQLDelight persistence:
 ## Directory Structure
 
 ```
-shared/src/commonMain/kotlin/link/socket/kore/
+shared/src/commonMain/kotlin/link/socket/ampere/
 ├── domain/
 │   ├── ai/
 │   │   ├── provider/          # AI providers (OpenAI, Anthropic, Google)

CONTRIBUTING.md

@@ -12,13 +12,13 @@ This project adheres to a Contributor Code of Conduct. By participating, you are
 
 ### Reporting Bugs
 
-- Ensure the bug was not already reported by searching on GitHub under [Issues](https://github.com/socket-link/kore-ai/issues).
-- If you have a bug to report, [open a new issue](https://github.com/socket-link/kore-ai/issues/new) and follow the issue template.
+- Ensure the bug was not already reported by searching on GitHub under [Issues](https://github.com/socket-link/ampere/issues).
+- If you have a bug to report, [open a new issue](https://github.com/socket-link/ampere/issues/new) and follow the issue template.
 
 ### Suggesting Enhancements
 
-- Check if the enhancement was already suggested by searching on GitHub under [Issues](https://github.com/socket-link/kore-ai/issues).
-- If you have an enhancement to suggest, [open a new issue](https://github.com/socket-link/kore-ai/issues/new) and follow the issue template.
+- Check if the enhancement was already suggested by searching on GitHub under [Issues](https://github.com/socket-link/ampere/issues).
+- If you have an enhancement to suggest, [open a new issue](https://github.com/socket-link/ampere/issues/new) and follow the issue template.
 
 ### Pull Requests
 
@@ -34,4 +34,3 @@ This project adheres to a Contributor Code of Conduct. By participating, you are
 - Use the present tense ("Add feature" not "Added feature").
 - Use the imperative mood ("Move cursor to..." not "Moves cursor to...").
 - Limit the first line to 72 characters or less.
-

README.md

@@ -1,4 +1,4 @@
-[![Maven Central](https://img.shields.io/maven-central/v/link.socket.kore-ai/kore-ai-client?color=blue&label=Download)](https://central.sonatype.com/namespace/link.socket.kore-ai)
+[![Maven Central](https://img.shields.io/maven-central/v/link.socket.ampere/ampere-client?color=blue&label=Download)](https://central.sonatype.com/namespace/link.socket.ampere)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
 # Ampere: A KMP Library for AI Agents & Assistants
@@ -8,7 +8,7 @@
 > **Note**  
 > This library, its APIs, and the sample client applications are in Alpha.
 > It may change incompatibly and require manual migration in the future.
-> If you have any issues, please report them on [GitHub](https://github.com/socket-link/kore-ai/issues).
+> If you have any issues, please report them on [GitHub](https://github.com/socket-link/ampere/issues).
 
 ## 📔 Overview
 
@@ -32,7 +32,7 @@ An **Agent** is a specialized AI Chatbot with domain-specific knowledge for well
 - **System Prompt**: Defines the Agent's mindset and approach
 - **User Prompt**: Initial prompt with optional `HumanAssisted` API for dynamic input
 
-### [Bundled Agents](https://github.com/socket-link/kore-ai/tree/main/shared/src/commonMain/kotlin/link/socket/kore/model/agent/bundled)
+### [Bundled Agents](https://github.com/socket-link/ampere/tree/main/shared/src/commonMain/kotlin/link/socket/ampere/model/agent/bundled)
 
 - Save File Agent
 - Modify File Agent  

README_AGENT_SYSTEM.md

@@ -1,6 +1,6 @@
 # Agent System Overview
 
-This document describes the minimal autonomous agent system added to Kore AI, including core interfaces, tools, and an example workflow using the CodeWriterAgent.
+This document describes the minimal autonomous agent system added to Ampere, including core interfaces, tools, and an example workflow using the CodeWriterAgent.
 
 ## Interfaces
 
@@ -11,7 +11,7 @@ This document describes the minimal autonomous agent system added to Kore AI, in
   - act(): Outcome — execute one step from the plan
   - signal(): Message? — communicate uncertainties or ask for approval
 
-All return types are immutable data classes in link.socket.kore.agents.core.AgentTypes.
+All return types are immutable data classes in link.socket.ampere.agents.core.AgentTypes.
 
 ## Autonomy Levels
 

ampere

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+# Run the ampere CLI.
+# Any arguments are forwarded to the CLI.
+
+if [ $# -eq 0 ]; then
+    ./gradlew --quiet ":ampere-cli:runJvm"
+else
+    ./gradlew --quiet ":ampere-cli:runJvm" --args="$*"
+fi

ampere-cli/build.gradle.kts

@@ -0,0 +1,48 @@
+@file:OptIn(ExperimentalKotlinGradlePluginApi::class)
+
+import org.jetbrains.kotlin.gradle.ExperimentalKotlinGradlePluginApi
+import org.jetbrains.kotlin.gradle.dsl.JvmTarget
+
+plugins {
+    kotlin("multiplatform")
+    kotlin("plugin.serialization")
+}
+
+kotlin {
+    jvmToolchain(21)
+
+    jvm {
+        compilerOptions {
+            jvmTarget.set(JvmTarget.JVM_21)
+        }
+
+        binaries {
+            executable {
+                mainClass.set("link.socket.ampere.MainKt")
+            }
+        }
+    }
+
+    sourceSets {
+        val jvmMain by getting {
+            dependencies {
+                implementation(project(":shared"))
+
+                // CLI argument parsing
+                implementation("com.github.ajalt.clikt:clikt:4.4.0")
+
+                // Terminal rendering with colors and styles
+                implementation("com.github.ajalt.mordant:mordant:2.7.2")
+
+                // Coroutines
+                implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.10.2")
+
+                // SQLDelight driver for JVM
+                implementation("app.cash.sqldelight:sqlite-driver:2.2.1")
+
+                // Serialization
+                implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.9.0")
+            }
+        }
+    }
+}

ampere-cli/src/jvmMain/kotlin/link/socket/ampere/Main.kt

@@ -0,0 +1,21 @@
+package link.socket.ampere
+
+import com.github.ajalt.clikt.core.CliktCommand
+import com.github.ajalt.clikt.core.subcommands
+
+fun main(args: Array<String>) = AmpereCommand()
+    .subcommands(WatchCommand())
+    .main(args)
+
+class AmpereCommand : CliktCommand(
+    name = "ampere",
+    help = """
+        Animated Multi-Agent (Prompting Technique) -> AniMA
+        AniMA Model Protocol -> AMP
+        AMP Environment Runtime Example -> AMPERE
+        
+        AMPERE is a tool for running AniMA simulations in a real-time, observable environment.
+    """.trimIndent()
+) {
+    override fun run() = Unit
+}

ampere-cli/src/jvmMain/kotlin/link/socket/ampere/WatchCommand.kt

@@ -0,0 +1,70 @@
+package link.socket.ampere
+
+import com.github.ajalt.clikt.core.CliktCommand
+import com.github.ajalt.clikt.parameters.options.default
+import com.github.ajalt.clikt.parameters.options.option
+import com.github.ajalt.clikt.parameters.types.int
+import com.github.ajalt.mordant.rendering.TextColors.*
+import com.github.ajalt.mordant.rendering.TextStyles.*
+import com.github.ajalt.mordant.terminal.Terminal
+
+class WatchCommand : CliktCommand(
+    name = "watch",
+    help = """
+        Watch events streaming from the AniMA substrate in real-time.
+
+        Connects to the EventBus and renders events to terminal with color-coding
+        and formatting for human readability.
+
+        Examples:
+          ampere watch                    # Watch all events
+          ampere watch --type TaskCreated # Filter by event type
+          ampere watch --since 1h         # Events from last hour
+    """.trimIndent()
+) {
+    private val eventType by option(
+        "--type", "-t",
+        help = "Filter events by type (TaskCreated, QuestionRaised, CodeSubmitted)"
+    )
+
+    private val agent by option(
+        "--agent", "-a",
+        help = "Filter events by agent ID"
+    )
+
+    private val since by option(
+        "--since", "-s",
+        help = "Show events since timestamp (e.g., '1h', '30m', '2024-01-01')"
+    )
+
+    private val limit by option(
+        "--limit", "-n",
+        help = "Limit number of events to display"
+    ).int().default(100)
+
+    private val replay by option(
+        "--replay", "-r",
+        help = "Replay historical events from database before watching"
+    )
+
+    private val terminal = Terminal()
+
+    override fun run() {
+        terminal.println(
+            bold(cyan("AMPERE")) + " - AniMA Perception & Relay Environment"
+        )
+        terminal.println(dim("Connecting to event stream..."))
+        terminal.println()
+
+        // Placeholder for actual implementation
+        terminal.println(yellow("Watch command invoked with:"))
+        eventType?.let { terminal.println("  Event type: $it") }
+        agent?.let { terminal.println("  Agent: $it") }
+        since?.let { terminal.println("  Since: $it") }
+        terminal.println("  Limit: $limit")
+        replay?.let { terminal.println("  Replay: $it") }
+
+        terminal.println()
+        terminal.println(dim("Event streaming will be implemented in subsequent tasks."))
+    }
+}