chore: add tooling and tests, drop dead CI config (Phase 3)

- add ameba 1.6 as a development dependency and satisfy its lints
- fix broken spec_helper (required a non-existent file) and replace the
  placeholder spec with model unit tests (Subject#color/#update?/#comment_url,
  Notification#mention?, JSON parsing, Slack serialization)
- add GitHub Actions CI running format check / ameba / spec
- remove obsolete .travis.yml; gitignore built bin/

refs #84

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: limit7412

.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: ci
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+jobs:
+  check:
+    name: format / lint / spec
+    runs-on: ubuntu-24.04-arm
+    steps:
+      - name: checkout
+        uses: actions/checkout@v4
+
+      - name: install crystal
+        uses: crystal-lang/install-crystal@v1
+        with:
+          crystal: latest
+
+      - name: install shards
+        run: shards install
+
+      - name: check format
+        run: crystal tool format --check
+
+      - name: lint with ameba
+        run: ./bin/ameba
+
+      - name: run specs
+        run: crystal spec

.gitignore

@@ -6,7 +6,8 @@ jspm_packages
 .serverless
 
 bootstrap
+bin
 lib
 env.yml
-
-.idea/
+
+.idea/

.travis.yml

@@ -1,6 +1,6 @@
-version: 1.0
+version: 2.0
 shards:
-  clim:
-    github: at-grandpa/clim
-    version: 0.4.1
+  ameba:
+    git: https://github.com/crystal-ameba/ameba.git
+    version: 1.6.4
 

shard.lock

@@ -10,4 +10,9 @@ targets:
 
 crystal: ">= 1.20.0"
 
+development_dependencies:
+  ameba:
+    github: crystal-ameba/ameba
+    version: ~> 1.6
+
 license: MIT

shard.yml

@@ -0,0 +1,113 @@
+require "../spec_helper"
+
+private def subject_from(type : String, url = "", latest_comment_url = "")
+  Github::Subject.from_json({
+    type:               type,
+    title:              "title",
+    url:                url,
+    latest_comment_url: latest_comment_url,
+  }.to_json)
+end
+
+describe Github::Subject do
+  describe "#update?" do
+    it "is true for tracked subject types" do
+      [
+        Github::Subject::Type::PULL_REQUEST,
+        Github::Subject::Type::ISSUE,
+        Github::Subject::Type::COMMIT,
+        Github::Subject::Type::DISCUSSION,
+      ].each do |type|
+        subject_from(type).update?.should be_true
+      end
+    end
+
+    it "is false for unknown subject types" do
+      subject_from("Release").update?.should be_false
+    end
+  end
+
+  describe "#color" do
+    it "returns a distinct color per known type" do
+      subject_from(Github::Subject::Type::PULL_REQUEST).color.should eq "#F6CEE3"
+      subject_from(Github::Subject::Type::ISSUE).color.should eq "#A9D0F5"
+      subject_from(Github::Subject::Type::COMMIT).color.should eq "#f5d7a9"
+      subject_from(Github::Subject::Type::DISCUSSION).color.should eq "#7fffd4"
+    end
+
+    it "falls back to a default color for unknown types" do
+      subject_from("Release").color.should eq "#D8D8D8"
+    end
+  end
+
+  describe "#comment_url" do
+    it "prefers latest_comment_url when present" do
+      subject = subject_from("Issue", url: "u", latest_comment_url: "c")
+      subject.comment_url.should eq "c"
+    end
+
+    it "falls back to url when latest_comment_url is blank" do
+      subject = subject_from("Issue", url: "u", latest_comment_url: "")
+      subject.comment_url.should eq "u"
+    end
+  end
+end
+
+describe Github::Notification do
+  describe "#mention?" do
+    it "is true for reasons that mention the user" do
+      Github::Notification::MENTION_REASONS.each do |reason|
+        notification_from(reason).mention?.should be_true
+      end
+    end
+
+    it "is false for non-mention reasons" do
+      notification_from("subscribed").mention?.should be_false
+      notification_from("ci_activity").mention?.should be_false
+    end
+  end
+
+  it "parses a GitHub notifications API payload" do
+    notifications = Array(Github::Notification).from_json(NOTIFICATIONS_FIXTURE)
+    notifications.size.should eq 1
+
+    notification = notifications.first
+    notification.reason.should eq "mention"
+    notification.subject.type.should eq "Issue"
+    notification.subject.title.should eq "Spurious failure"
+    notification.repository.full_name.should eq "octocat/Hello-World"
+    notification.mention?.should be_true
+  end
+end
+
+private def notification_from(reason : String)
+  Github::Notification.from_json({
+    reason:     reason,
+    subject:    {type: "Issue", title: "title"},
+    repository: {owner: {login: "octocat"}},
+  }.to_json)
+end
+
+NOTIFICATIONS_FIXTURE = <<-JSON
+[
+  {
+    "reason": "mention",
+    "subject": {
+      "title": "Spurious failure",
+      "url": "https://api.github.com/repos/octocat/Hello-World/issues/1",
+      "latest_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments/1",
+      "type": "Issue"
+    },
+    "repository": {
+      "full_name": "octocat/Hello-World",
+      "html_url": "https://github.com/octocat/Hello-World",
+      "owner": {
+        "login": "octocat",
+        "avatar_url": "https://github.com/images/error/octocat.gif",
+        "html_url": "https://github.com/octocat"
+      }
+    },
+    "subscription_url": "https://api.github.com/notifications/threads/1/subscription"
+  }
+]
+JSON

spec/github/models_spec.cr

@@ -0,0 +1,22 @@
+require "../spec_helper"
+
+describe Slack::Attachment do
+  it "omits unset fields when serialized" do
+    json = Slack::Attachment.new(text: "hello", color: "#000000").to_json
+    parsed = JSON.parse(json)
+
+    parsed["text"].should eq "hello"
+    parsed["color"].should eq "#000000"
+    parsed.as_h.has_key?("title").should be_false
+  end
+end
+
+describe Slack::Post do
+  it "wraps attachments under an attachments key" do
+    post = Slack::Post.new([Slack::Attachment.new(text: "a")])
+    parsed = JSON.parse(post.to_json)
+
+    parsed["attachments"].as_a.size.should eq 1
+    parsed["attachments"][0]["text"].should eq "a"
+  end
+end

spec/github_notifications_slack_spec.cr

@@ -1,2 +1,3 @@
 require "spec"
-require "../src/github_notifications_slack"
+require "../src/github/models"
+require "../src/slack/models"

spec/slack/models_spec.cr

@@ -19,9 +19,9 @@ Serverless::Lambda.handler "github_notifications_slack" do |_|
     slack_repo = Slack::PostRepository.new WEBHOOK_URL
 
     Notify::Usecase.new(github_repo, github_uc, slack_repo).check_notifications
-  rescue err
+  rescue error
     alert_repo = Slack::PostRepository.new ALERT_WEBHOOK_URL
-    Error::Usecase.new(alert_repo, SLACK_ID, APP_ENV).alert err
-    raise err
+    Error::Usecase.new(alert_repo, SLACK_ID, APP_ENV).alert error
+    raise error
   end
 end