[WFYishere] iP

.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+max_line_length = 120

.gitignore

@@ -1,17 +1,12 @@
-# IDEA files
-/.idea/
-/out/
-/*.iml
-
-# Gradle build files
-/.gradle/
-/build/
-src/main/resources/docs/
-
-# MacOS custom attributes files created by Finder
-.DS_Store
+# Java/Gradle
+.gradle/
+build/
+out/
+target/
+**/*.class
+# IntelliJ
+.idea/
 *.iml
-bin/
-
-/text-ui-test/ACTUAL.TXT
-text-ui-test/EXPECTED-UNIX.TXT
+# OS
+.DS_Store
+Thumbs.db

AI.md

@@ -0,0 +1,17 @@
+# AI-Assisted Development Log
+
+This project uses AI tools to increase productivity while meeting iP requirements.
+
+## Tools Used
+- ChatGPT (OpenAI): prompt-driven code assistance and review suggestions.
+
+## Usage Records
+
+### 2025-09-20 — C-Sort (Category C Extension)
+- **What AI did:** Suggested a minimal insertion for a `sort` command inside the existing command switch in `src/main/java/quokka/Quokka.java`, keeping the codebase structure unchanged (no new classes).
+- **Why helpful:** Reduced implementation time and ensured zero behavior drift elsewhere.
+- **Developer review:** Verified that the change compiles and that the command behaves as intended (alphabetical, case-insensitive).
+
+## Notes
+- AI suggestions are treated as drafts; final decisions and verifications are done by the developer.
+- This file will be updated if/when more AI-assisted changes are adopted.

README.md

@@ -1,26 +1,34 @@
-# Duke project template
-
-This is a project template for a greenfield Java project. It's named after the Java mascot _Duke_. Given below are instructions on how to use it.
-
-## Setting up in Intellij
-
-Prerequisites: JDK 17, update Intellij to the most recent version.
-
-1. Open Intellij (if you are not in the welcome screen, click `File` > `Close Project` to close the existing project first)
-1. Open the project into Intellij as follows:
-   1. Click `Open`.
-   1. Select the project directory, and click `OK`.
-   1. If there are any further prompts, accept the defaults.
-1. Configure the project to use **JDK 17** (not other versions) as explained in [here](https://www.jetbrains.com/help/idea/sdk.html#set-up-jdk).<br>
-   In the same dialog, set the **Project language level** field to the `SDK default` option.
-1. After that, locate the `src/main/java/Duke.java` file, right-click it, and choose `Run Duke.main()` (if the code editor is showing compile errors, try restarting the IDE). If the setup is correct, you should see something like the below as the output:
-   ```
-   Hello from
-    ____        _        
-   |  _ \ _   _| | _____ 
-   | | | | | | | |/ / _ \
-   | |_| | |_| |   <  __/
-   |____/ \__,_|_|\_\___|
-   ```
-
-**Warning:** Keep the `src\main\java` folder as the root folder for Java files (i.e., don't rename those folders or move Java files to another folder outside of this folder path), as this is the default location some tools (e.g., Gradle) expect to find Java files.
+# Quokka iP
+
+> “Your mind is for having ideas, not holding them.” — David Allen  
+> _(via_ [Getting Things Done](https://gettingthingsdone.com) _)_
+
+Quokka is a text-based task manager that’s *simple*, **fast**, and ~~bug-prone~~ **robust** 😉.
+
+## Highlights
+- Text UI you can use from any terminal
+- Tasks: **Todo**, **Deadline**, **Event**
+- Dates parsed as `yyyy-MM-dd` and displayed as `MMM d yyyy`
+- Persistent storage in a human-editable file
+
+## Quick Start
+1. Download the latest JAR from the **Releases** page.
+2. Open a terminal in the folder containing the JAR.
+3. Run: `java -jar "Duke.jar"`.
+4. Add tasks, `list` them, then `bye`.
+
+## Sample Session
+```java
+// Commands you can try
+todo read book
+deadline return book /by 2019-10-15
+event project /from 2019-12-01 /to 2019-12-02
+list
+bye
+````
+
+More info:
+
+* Main class: `quokka.Quokka`
+* Releases: [Download Quokka.jar](https://github.com/WFYishere/ip/releases) 
+

build.gradle

@@ -0,0 +1,101 @@
+plugins {
+    id 'java'
+    id 'application'
+    id 'com.github.johnrengelman.shadow' version '7.1.2'
+    id 'checkstyle'
+}
+
+tasks.withType(JavaCompile).configureEach {
+    options.encoding = 'UTF-8'
+}
+
+repositories {
+    mavenCentral()
+}
+
+dependencies {
+    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.10.0'
+    testRuntimeOnly  'org.junit.jupiter:junit-jupiter-engine:5.10.0'
+
+    String javaFxVersion = '17.0.7'
+
+    implementation group: 'org.openjfx', name: 'javafx-base',     version: javaFxVersion, classifier: 'win'
+    implementation group: 'org.openjfx', name: 'javafx-base',     version: javaFxVersion, classifier: 'mac'
+    implementation group: 'org.openjfx', name: 'javafx-base',     version: javaFxVersion, classifier: 'linux'
+
+    implementation group: 'org.openjfx', name: 'javafx-controls', version: javaFxVersion, classifier: 'win'
+    implementation group: 'org.openjfx', name: 'javafx-controls', version: javaFxVersion, classifier: 'mac'
+    implementation group: 'org.openjfx', name: 'javafx-controls', version: javaFxVersion, classifier: 'linux'
+
+    implementation group: 'org.openjfx', name: 'javafx-fxml',     version: javaFxVersion, classifier: 'win'
+    implementation group: 'org.openjfx', name: 'javafx-fxml',     version: javaFxVersion, classifier: 'mac'
+    implementation group: 'org.openjfx', name: 'javafx-fxml',     version: javaFxVersion, classifier: 'linux'
+
+    implementation group: 'org.openjfx', name: 'javafx-graphics', version: javaFxVersion, classifier: 'win'
+    implementation group: 'org.openjfx', name: 'javafx-graphics', version: javaFxVersion, classifier: 'mac'
+    implementation group: 'org.openjfx', name: 'javafx-graphics', version: javaFxVersion, classifier: 'linux'
+}
+
+
+checkstyle {
+    toolVersion = '10.12.4'
+    maxWarnings = 0
+    config = resources.text.fromString(
+        '''<?xml version="1.0" encoding="UTF-8"?>
+           <!DOCTYPE module PUBLIC
+             "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
+             "https://checkstyle.org/dtds/configuration_1_3.dtd">
+           <module name="Checker">
+             <module name="TreeWalker">
+               <module name="NeedBraces"/>
+             </module>
+           </module>'''
+    )
+}
+
+
+tasks.withType(Checkstyle).configureEach {
+    reports {
+        xml.required.set(false)
+        html.required.set(true)
+    }
+}
+
+test {
+    useJUnitPlatform()
+    jvmArgs '-ea'
+
+    testLogging {
+        events "passed", "skipped", "failed"
+
+        showExceptions true
+        exceptionFormat "full"
+        showCauses true
+        showStackTraces true
+        showStandardStreams = false
+    }
+}
+
+application {
+    mainClass.set('quokka.Launcher')
+    applicationDefaultJvmArgs = ['-ea']
+}
+
+jar {
+    manifest {
+        attributes('Main-Class': application.mainClass.get())
+    }
+    duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+}
+
+shadowJar {
+    archiveFileName = 'Quokka.jar'
+    archiveClassifier = null
+    manifest { attributes('Main-Class': application.mainClass.get()) }
+    mergeServiceFiles()
+    exclude 'module-info.class'
+}
+
+run{
+    standardInput = System.in
+}

config/checkstyle/checkstyle.xml

@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module name="Checker">
+    <property name="charset" value="UTF-8"/>
+    <property name="severity" value="warning"/>
+
+    <module name="SuppressionFilter">
+        <property name="file" value="config/checkstyle/suppressions.xml"/>
+        <property name="optional" value="true"/>
+    </module>
+
+    <module name="NewlineAtEndOfFile"/>
+    <module name="FileTabCharacter"/>
+    <module name="OuterTypeFilename"/>
+    <module name="LineLength">
+        <property name="max" value="120"/>
+        <property name="ignorePattern" value="^package .*|^import .*"/>
+    </module>
+    <module name="RegexpSingleline">
+        <property name="format" value="\s+$"/>
+        <property name="message" value="Trailing spaces are not allowed."/>
+    </module>
+
+    <module name="TreeWalker">
+        <module name="NeedBraces"/>
+        <module name="WhitespaceAround"/>
+        <module name="WhitespaceAfter"/>
+        <module name="NoWhitespaceBefore"/>
+        <module name="NoWhitespaceAfter"/>
+        <module name="EmptyBlock"/>
+
+        <module name="MissingJavadocType">
+            <property name="scope" value="public"/>
+            <property name="violateExecutionOnNonTightHtml" value="false"/>
+        </module>
+        <module name="MissingJavadocMethod">
+            <property name="scope" value="public"/>
+            <property name="allowMissingPropertyJavadoc" value="true"/>
+            <property name="minLineCount" value="2"/>
+        </module>
+
+        <module name="Indentation">
+            <property name="basicOffset" value="4"/>
+            <property name="caseIndent" value="4"/>
+            <property name="lineWrappingIndentation" value="8"/>
+            <property name="throwsIndent" value="4"/>
+        </module>
+    </module>
+</module>

config/checkstyle/suppressions.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<suppressions>
+    <!-- Don’t require JavaDoc in tests -->
+    <suppress files="src[\\/]test[\\/]java[\\/].*" checks="MissingJavadoc.*"/>
+</suppressions>

data/tasks.txt

@@ -0,0 +1,4 @@
+T | 0 | book
+T | 0 | buy milk
+D | 0 | submit assignment | 2025-09-30
+E | 0 | hackathon | 2025-09-10 | 2025-09-12