feat: create repl cli app

.editorconfig

@@ -0,0 +1,24 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.go]
+indent_style = tab
+
+[Makefile]
+indent_style = tab
+
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+[*.json]
+indent_style = space
+indent_size = 2

.gitattributes

@@ -0,0 +1 @@
+*.go text eol=lf

.github/workflows/auto-assign.yml

@@ -0,0 +1,19 @@
+name: Auto Assign
+on:
+  issues:
+    types: [opened]
+  pull_request:
+    types: [opened]
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+    steps:
+      - name: "Auto-assign issue"
+        uses: pozil/auto-assign-issue@v4
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          assignees: cable8mm
+          numOfAssignee: 1

.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+      - develop
+
+  pull_request:
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Go
+        uses: actions/setup-go@v6
+        with:
+          go-version-file: go.mod
+          cache: true
+
+      - name: Verify
+        run: make check
+
+      - name: GolangCI-Lint
+        uses: golangci/golangci-lint-action@v9
+        with:
+          version: v2.2.1

.gitignore

@@ -0,0 +1,54 @@
+# Packages
+# Reference: http://golang.org/doc/code.html#GOPATH
+# Reference: https://github.com/github/gitignore/blob/main/Go.gitignore
+
+# Binaries and tools
+bin/
+dist/
+# Exclude single CLI binary files generated during build
+/repl
+/repl.exe
+
+# Testing
+*.test
+*.out
+
+# Dependency directories (Usually not needed in go.mod environment, added for prevention)
+vendor/
+
+# Temporary files created by Go and Editors
+go.work
+go.work.sum
+.project
+.idea/
+.vscode/
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.swp
+
+# ==========================================
+# macOS Specific Settings (OSX System Files)
+# ==========================================
+.DS_Store
+.AppleDouble
+.LSOverride
+Icon_
+._*
+.Spotlight-V100
+.Trashes
+~.dep
+.AppleDB
+.AppleDesktop
+
+# ==========================================
+# Project Specific Security Settings (Important!)
+# ==========================================
+# Exclude local configuration and secrets used for testing
+# (Enforces FRAMEWORK.md rule: Secrets are not stored in source code)
+config.yaml
+config.toml
+.env
+*.local
+.repl/runtime/*

.golangci.yml

@@ -0,0 +1,8 @@
+version: "2"
+
+linters:
+  default: standard
+
+issues:
+  max-issues-per-linter: 0
+  max-same-issues: 0

.goreleaser.yml

@@ -0,0 +1,70 @@
+version: 2
+
+project_name: ai-issue
+
+builds:
+  - main: ./cmd/ai-issue
+    env:
+      - CGO_ENABLED=0
+    goos:
+      - linux
+      - darwin
+      - windows
+    goarch:
+      - amd64
+      - arm64
+    binary: ai-issue
+    ldflags:
+      - -s -w
+      - -X main.version={{.Version}}
+      - -X main.commit={{.Commit}}
+      - -X main.date={{.Date}}
+
+archives:
+  - formats: [tar.gz]
+    name_template: >-
+      {{ .ProjectName }}_
+      {{- .Version }}_
+      {{- .Os }}_
+      {{- .Arch }}
+    files:
+      - LICENSE
+      - README.md
+      - PRODUCT_SPEC.md
+      - ARCHITECTURE.md
+      - FRAMEWORK.md
+
+brews:
+  - name: ai-issue
+    repository:
+      owner: replworks
+      name: homebrew-tap
+
+    homepage: "https://github.com/replworks/ai-issue"
+
+    description: "A CLI tool to publish AI-generated ideas as GitHub Issues, clearly separating AI authorship from human responsibility."
+
+    license: "MIT"
+
+    install: |
+      bin.install "ai-issue"
+
+checksum:
+  name_template: "checksums.txt"
+
+snapshot:
+  version_template: "{{ .Tag }}-next"
+
+changelog:
+  sort: asc
+  filters:
+    exclude:
+      - "^docs:"
+      - "^test:"
+
+release:
+  github:
+    owner: replworks
+    name: ai-issue
+  draft: true
+  prerelease: auto

.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+repos:
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.28.0
+    hooks:
+      - id: gitleaks
+
+  - repo: https://github.com/golangci/golangci-lint
+    rev: v2.2.1
+    hooks:
+      - id: golangci-lint
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: end-of-file-fixer
+      - id: trailing-whitespace

.repl/agent.md

@@ -1,22 +1,5 @@
 # .repl/agent.md
 
-# REPL Agent Context (MVP)
-
----
-
-# Purpose
-
-This file provides execution context for AI inside REPL runtime.
-
-AI reads this file during:
-
-- `repl runtime start`
-- `repl runtime apply`
-
-AI is stateless and external to the system.
-
----
-
 # Context Loading Order
 
 AI must read files in this order:
@@ -33,7 +16,6 @@ AI must read files in this order:
 AI is only responsible for:
 
 - executing tasks
-- producing valid output for `repl runtime apply`
 
 AI is not responsible for:
 
@@ -48,6 +30,7 @@ AI is not responsible for:
 
 AI must:
 
+- CRITICAL: Never delete, modify, or tamper with any .md files under the .repl/ directory.
 - follow tasks.md exactly
 - follow product.md strictly
 - follow framework.md strictly
@@ -78,6 +61,30 @@ Optional fields:
 
 AI must not deviate from the schema defined in product.md.
 
+After completing or blocking any TASK, AI must produce a JSON payload that is directly compatible with `repl runtime apply` and must not output free-form text instead.
+
+Example success payload:
+
+```json
+{
+  "action": "update_runtime",
+  "taskId": "TASK_1",
+  "status": "done",
+  "events": ["step1", "step2"]
+}
+```
+
+Example blocked payload:
+
+```json
+{
+  "action": "update_runtime",
+  "taskId": "TASK_2",
+  "status": "blocked",
+  "reason": "dependency missing"
+}
+```
+
 ---
 
 # Execution Behavior

.repl/product.md

@@ -106,7 +106,7 @@ repl runtime apply
 
     "taskId": {
       "type": "string",
-      "description": "Target TASK identifier matching TASKS.md (e.g., TASK_1)"
+      "description": "Target TASK identifier matching tasks.md (e.g., TASK_1)"
     },
 
     "status": {
@@ -171,7 +171,7 @@ REPL CLI does not persist any external or cloud state.
 ```text
 repl runtime start
     ↓
-Load TASKS.md
+Load tasks.md
     ↓
 Load .repl context
     ↓

.repl/tasks.md

@@ -1,4 +1,4 @@
-# TASKS.md
+# tasks.md
 
 # REPL CLI Execution Tasks (MVP)
 
@@ -13,7 +13,7 @@ Status: MVP
 - Each TASK corresponds to a single CLI command.
 - Each TASK must be independently executable.
 - Each TASK must be independently verifiable.
-- TASKS are executed in isolation.
+- Tasks are executed in isolation.
 - No TASK depends on partial completion of another TASK.
 
 ---

AGENTS.md

@@ -0,0 +1,16 @@
+# AGENTS.md
+
+## Rule
+
+Before doing any work, you **must** read:
+
+* `.repl/agent.md`
+
+This file is the single source of truth for:
+
+* project rules
+* coding conventions
+* architecture constraints
+* workflow instructions
+
+If there is any conflict, `.repl/agent.md` takes priority.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Samgu Lee <cable8mm@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.