From 56b2b7ff264e2061bf56003aef30dfd7eb056b8c Mon Sep 17 00:00:00 2001 From: NgCuong Date: Wed, 26 Nov 2025 09:53:02 +0700 Subject: [PATCH 01/21] Create devcontainer.json MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Điều chỉnh hết các vấn đề bản quyền trước khi cài đặt vào hệ thônvs --- .devcontainer/devcontainer.json | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 .devcontainer/devcontainer.json diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json new file mode 100644 index 00000000..39bbd268 --- /dev/null +++ b/.devcontainer/devcontainer.json @@ -0,0 +1,4 @@ +{ + "image": "mcr.microsoft.com/devcontainers/universal:2", + "features": {} +} From 7d1c98c01ed72d83260ee366d0db644eb75b1f18 Mon Sep 17 00:00:00 2001 From: NgCuong <196793856+NguyenCuong1989@users.noreply.github.com> Date: Mon, 8 Dec 2025 01:02:56 +0700 Subject: [PATCH 02/21] Add .circleci/config.yml --- .circleci/config.yml | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 .circleci/config.yml diff --git a/.circleci/config.yml b/.circleci/config.yml new file mode 100644 index 00000000..bb68b14a --- /dev/null +++ b/.circleci/config.yml @@ -0,0 +1,31 @@ +# Use the latest 2.1 version of CircleCI pipeline process engine. +# See: https://circleci.com/docs/reference/configuration-reference +version: 2.1 + +# Define a job to be invoked later in a workflow. +# See: https://circleci.com/docs/guides/orchestrate/jobs-steps/#jobs-overview & https://circleci.com/docs/reference/configuration-reference/#jobs +jobs: + say-hello: + # Specify the execution environment. You can specify an image from Docker Hub or use one of our convenience images from CircleCI's Developer Hub. + # See: https://circleci.com/docs/guides/execution-managed/executor-intro/ & https://circleci.com/docs/reference/configuration-reference/#executor-job + docker: + # Specify the version you desire here + # See: https://circleci.com/developer/images/image/cimg/base + - image: cimg/base:current + + # Add steps to the job + # See: https://circleci.com/docs/guides/orchestrate/jobs-steps/#steps-overview & https://circleci.com/docs/reference/configuration-reference/#steps + steps: + # Checkout the code as the first step. + - checkout + - run: + name: "Say hello" + command: "echo Hello, World!" + +# Orchestrate jobs using workflows +# See: https://circleci.com/docs/guides/orchestrate/workflows/ & https://circleci.com/docs/reference/configuration-reference/#workflows +workflows: + say-hello-workflow: # This is the name of the workflow, feel free to change it to better match your workflow. + # Inside the workflow, you define the jobs you want to run. + jobs: + - say-hello \ No newline at end of file From 75e57afaf9160480658b5f714bd8d7f9ba2e92e7 Mon Sep 17 00:00:00 2001 From: NgCuong <196793856+NguyenCuong1989@users.noreply.github.com> Date: Sat, 13 Dec 2025 12:58:11 +0700 Subject: [PATCH 03/21] Create devcontainer.json --- .devcontainer/devcontainer.json | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 .devcontainer/devcontainer.json diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json new file mode 100644 index 00000000..39bbd268 --- /dev/null +++ b/.devcontainer/devcontainer.json @@ -0,0 +1,4 @@ +{ + "image": "mcr.microsoft.com/devcontainers/universal:2", + "features": {} +} From 09659e909dfa506db6a27d3537c655d3e2e26e67 Mon Sep 17 00:00:00 2001 From: NguyenCuong1989 <196793856+NguyenCuong1989@users.noreply.github.com> Date: Sun, 14 Dec 2025 15:16:13 +0700 Subject: [PATCH 04/21] Create .DS_Store --- .DS_Store | Bin 0 -> 6148 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 .DS_Store diff --git a/.DS_Store b/.DS_Store new file mode 100644 index 0000000000000000000000000000000000000000..143da19db2e1a6e56d5430017597ff067afdb812 GIT binary patch literal 6148 zcmeHKJ5Iwu5S?`_VMLRXawYmmX{eXToFE(knTP}_mQxUDeFaWH#Xaa~ISM@uZ*~Ub z#e@k`9)K229aj? ztqkz9%V|POx}xjk`DOP7$-~+0(@E-IeCyw=dhf>Q1*x?6zAvq4 zOI5Nv9p4Qj`e%5)>CW(Jox1rr$?mA+JoL!tF);>=0b}65Fo2rPQXB}{Xbczw#z4ma ze;+)QF(|fz@za4JwgA8!<|vqRFTpupF(|fz@IaiT0wvXHi{T_4cCT?ku@#hba@u@2 z-Pvh};^OXD-^XxrLC{8Hz!*pw7|G?B>;LKQ{y$B!D`UVI_)`qHyquRa+>+MT!Od~4 s_0V%D3&*vBT?!_#6eE^P@gXz{?4BpUpx6q+0hNU20x`q(*OVf literal 0 HcmV?d00001 From 7a5d3457433aa77489a6fd1bc8da2097d3768445 Mon Sep 17 00:00:00 2001 From: NguyenCuong1989 <196793856+NguyenCuong1989@users.noreply.github.com> Date: Sun, 14 Dec 2025 15:16:27 +0700 Subject: [PATCH 05/21] Update .DS_Store --- .DS_Store | Bin 6148 -> 6148 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/.DS_Store b/.DS_Store index 143da19db2e1a6e56d5430017597ff067afdb812..9a1198363234b8225f4f8fd57c02c027a183d983 100644 GIT binary patch delta 106 zcmZoMXffEJ#uU4Roq>UYg+Y%YogtH Date: Sun, 14 Dec 2025 15:16:36 +0700 Subject: [PATCH 06/21] Update .DS_Store --- .DS_Store | Bin 6148 -> 6148 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/.DS_Store b/.DS_Store index 9a1198363234b8225f4f8fd57c02c027a183d983..3e2b6d106c82bd752c5c1dcf95717bd042fedc98 100644 GIT binary patch delta 106 zcmZoMXffEJ#uU3!h=GBDg+Y%YogtHUYg+Y%YogtH Date: Fri, 27 Feb 2026 10:22:13 +0700 Subject: [PATCH 07/21] Add connect-your-tools integration hero mockup --- connect-your-tools.html | 106 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 106 insertions(+) create mode 100644 connect-your-tools.html diff --git a/connect-your-tools.html b/connect-your-tools.html new file mode 100644 index 00000000..b689c33d --- /dev/null +++ b/connect-your-tools.html @@ -0,0 +1,106 @@ + + + + + + Connect your tools + + + +
+ + +
+ + From ba119ca2a81bfea6cf154b6764e47c6b39fbccb4 Mon Sep 17 00:00:00 2001 From: NgCuong <196793856+NguyenCuong1989@users.noreply.github.com> Date: Sat, 28 Feb 2026 00:36:09 +0700 Subject: [PATCH 08/21] Add connect-your-tools visual mock page --- README.md | 8 ++ examples/connect-your-tools.html | 156 +++++++++++++++++++++++++++++++ 2 files changed, 164 insertions(+) create mode 100644 examples/connect-your-tools.html diff --git a/README.md b/README.md index 1cff9f51..23e7f601 100644 --- a/README.md +++ b/README.md @@ -130,3 +130,11 @@ We're excited to have you join us early in the Copilot CLI journey. This is an early-stage preview, and we're building quickly. Expect frequent updates--please keep your client up to date for the latest features and fixes! Your insights are invaluable! Open issue in this repo, join Discussions, and run `/feedback` from the CLI to submit a confidential feedback survey! + +## 🎨 Design mock: "Connect your tools" + +A static recreation of the Linear-style integration visual from the `WWW-3` issue is available at: + +- `examples/connect-your-tools.html` + +Open it locally in a browser to preview the gradient background and icon lockup. diff --git a/examples/connect-your-tools.html b/examples/connect-your-tools.html new file mode 100644 index 00000000..7f8c5dcf --- /dev/null +++ b/examples/connect-your-tools.html @@ -0,0 +1,156 @@ + + + + + + Connect your tools + + + +
+ + +
+ + From 29851e9d69769eb59a4d4ae60ff93362aeb72636 Mon Sep 17 00:00:00 2001 From: NgCuong <196793856+NguyenCuong1989@users.noreply.github.com> Date: Sat, 28 Feb 2026 04:14:09 +0700 Subject: [PATCH 09/21] refine connect-your-tools visual mock --- README.md | 4 +++ connect-your-tools.html | 70 +++++++++++++++++------------------------ 2 files changed, 32 insertions(+), 42 deletions(-) diff --git a/README.md b/README.md index 1cff9f51..75d9acc8 100644 --- a/README.md +++ b/README.md @@ -123,6 +123,10 @@ Each time you submit a prompt to GitHub Copilot CLI, your monthly quota of premi For more information about how to use the GitHub Copilot CLI, see [our official documentation](https://docs.github.com/copilot/concepts/agents/about-copilot-cli). +## 🔌 Connect your tools mock + +For the Linear WWW-3 visual, open `connect-your-tools.html` in a browser to see the recreated "Connect your tools" gradient + icon composition. + ## 📢 Feedback and Participation We're excited to have you join us early in the Copilot CLI journey. diff --git a/connect-your-tools.html b/connect-your-tools.html index b689c33d..afc42b96 100644 --- a/connect-your-tools.html +++ b/connect-your-tools.html @@ -6,41 +6,42 @@ Connect your tools From e2db5f24b79a4951ee41cb9a302239e0aa222fbb Mon Sep 17 00:00:00 2001 From: NgCuong <196793856+NguyenCuong1989@users.noreply.github.com> Date: Sun, 1 Mar 2026 19:28:50 +0700 Subject: [PATCH 10/21] refine connect-your-tools hero styling --- connect-your-tools.html | 44 ++++++++++++++++++++++++----------------- 1 file changed, 26 insertions(+), 18 deletions(-) diff --git a/connect-your-tools.html b/connect-your-tools.html index afc42b96..ca4a7459 100644 --- a/connect-your-tools.html +++ b/connect-your-tools.html @@ -6,11 +6,11 @@ Connect your tools From 22bfa0a0e9f1827c4aa5503172204dde3c4f64e9 Mon Sep 17 00:00:00 2001 From: NgCuong <196793856+NguyenCuong1989@users.noreply.github.com> Date: Sun, 1 Mar 2026 19:29:00 +0700 Subject: [PATCH 11/21] docs: add LIN-1 completion note to changelog --- changelog.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/changelog.md b/changelog.md index 4caea57f..af10e0e5 100644 --- a/changelog.md +++ b/changelog.md @@ -1,3 +1,7 @@ +## Unreleased + +- Add LIN-1 test follow-up note to complete Linear smoke test workflow + ## 0.0.369 - 2025-12-11 - Add support for GPT-5.2 From 3c6537266f7f947c57ec68c84ce8db75e4f23bf1 Mon Sep 17 00:00:00 2001 From: NgCuong <196793856+NguyenCuong1989@users.noreply.github.com> Date: Sun, 1 Mar 2026 20:19:36 +0700 Subject: [PATCH 12/21] docs: add dependency graph audit and risk assessment --- docs/dependency-audit.md | 100 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 100 insertions(+) create mode 100644 docs/dependency-audit.md diff --git a/docs/dependency-audit.md b/docs/dependency-audit.md new file mode 100644 index 00000000..a9e882d4 --- /dev/null +++ b/docs/dependency-audit.md @@ -0,0 +1,100 @@ +# Dependency Graph Audit — copilot-cli + +## Scope & approach + +Audit này tập trung vào **dependency thể hiện trong source repo** (không bao gồm binary nội bộ của `copilot` do repo này không chứa mã nguồn implementation chính): + +- File manifest/dependency trong repo +- Lockfile hiện có +- Mức độ pin version +- Mức độ reproducible build + +## 1) Danh sách dependency hiện tại + +### 1.1 Runtime / install channel dependencies + +| Khu vực | Dependency | Vị trí | Kiểu pin | +|---|---|---|---| +| Cài đặt npm | `@github/copilot` | `README.md` | Không pin (latest hoặc tag prerelease) | +| Cài đặt Homebrew | `copilot-cli`, `copilot-cli@prerelease` | `README.md` | Theo formula/cask của brew, không pin theo commit trong repo này | +| Cài đặt WinGet | `GitHub.Copilot`, `GitHub.Copilot.Prerelease` | `README.md`, `install.sh` | Không pin phiên bản cụ thể mặc định | +| Cài đặt script trực tiếp | GitHub Release artifact `copilot-{platform}-{arch}.tar.gz` | `install.sh` | Mặc định lấy `releases/latest`; có hỗ trợ pin bằng `VERSION` | + +### 1.2 CI / automation dependencies + +| Khu vực | Dependency | Vị trí | Kiểu pin | +|---|---|---|---| +| GitHub Actions | `actions/github-script@v7` | `.github/workflows/close-single-word-issues.yml` | Pin theo major tag (movable) | +| GitHub Actions | `actions/stale@v9` | `.github/workflows/no-response.yml`, `.github/workflows/stale-issues.yml` | Pin theo major tag (movable) | +| GitHub Actions | `actions/create-github-app-token@v2` | `.github/workflows/winget.yml` | Pin theo major tag (movable) | +| CircleCI executor image | `cimg/base:current` | `.circleci/config.yml` | Floating tag | +| Dev container image | `mcr.microsoft.com/devcontainers/universal:2` | `.devcontainer/devcontainer.json` | Pin theo major tag (movable) | +| CLI tool trong workflow | `gh` CLI trên runner image | Nhiều workflow dùng `gh ...` | Phụ thuộc tool preinstalled của `ubuntu-latest` (floating) | +| CLI tool tải runtime | `wingetcreate` từ `https://aka.ms/wingetcreate/latest` | `.github/workflows/winget.yml` | Floating `latest` | + +## 2) Kiểm tra lockfile + +### Kết quả + +Không phát hiện lockfile cho các ecosystem phổ biến (`package-lock.json`, `pnpm-lock.yaml`, `yarn.lock`, `go.sum`, `Cargo.lock`, v.v.). + +### Nhận định + +- Với trạng thái repo hiện tại (chủ yếu docs + script + workflow), việc không có lockfile cho app code là dễ hiểu. +- Tuy nhiên, phần automation vẫn phụ thuộc nhiều thành phần **floating** nên tính tái lập vẫn thấp dù không có package manager manifest truyền thống. + +## 3) Đánh giá pin version + +### 3.1 Điểm tốt + +- `install.sh` cho phép pin release qua biến `VERSION`. + +### 3.2 Rủi ro chính + +- Mặc định `install.sh` dùng `releases/latest` → khó tái lập giữa các lần cài. +- GitHub Actions pin theo `@v*` thay vì commit SHA → có rủi ro supply-chain nếu tag dịch chuyển hoặc action bị compromise. +- CircleCI `cimg/base:current` và GitHub runner `ubuntu-latest` là floating base environment. +- `wingetcreate/latest` được tải trực tiếp, chưa checksum/khóa phiên bản. + +## 4) Phân loại risk + +| Risk | Mức độ | Vì sao | +|---|---|---| +| Third-party action không pin SHA | High | Chuỗi CI có thể thay đổi mà không đổi code repo | +| Download artifact từ `latest` không verify checksum | High | Rủi ro integrity và khó rollback chính xác | +| Base image / runner floating (`current`, `*-latest`) | Medium | Build/test behavior có thể drift theo thời gian | +| Không có SBOM/dependency inventory tự động | Medium | Khó theo dõi thay đổi dependency và lỗ hổng | +| Không có lockfile ứng dụng | Low (hiện tại) | Repo không chứa app source/package manifest rõ ràng | + +## 5) Reproducible build assessment + +**Kết luận:** mức reproducibility hiện tại là **thấp đến trung bình** (đặc biệt ở pipeline automation), do phụ thuộc vào nhiều nguồn “latest/current/movable tags”. + +## 6) Đề xuất cải thiện (ưu tiên) + +### Ưu tiên 1 — Giảm rủi ro supply chain + +1. Pin toàn bộ `uses:` trong workflow sang **full commit SHA**. +2. Với `wingetcreate`, pin bản phát hành cụ thể thay vì `latest` + verify checksum/signature. +3. Trong `install.sh`, thêm khuyến nghị rõ ràng: production nên set `VERSION` cố định và (nếu có thể) verify checksum release asset. + +### Ưu tiên 2 — Tăng reproducibility môi trường CI + +1. Tránh `cimg/base:current`, pin image digest/tag cố định. +2. Đánh giá thay `ubuntu-latest` bằng version cụ thể ở workflow cần tính ổn định cao. + +### Ưu tiên 3 — Quản trị dependency liên tục + +1. Bật Dependabot cho GitHub Actions updates. +2. Tạo định kỳ báo cáo dependency/SBOM cho automation assets. +3. Thêm checklist “dependency pinning” vào PR template hoặc repo policy. + +## 7) Mapping theo acceptance criteria + +- [x] Có danh sách dependency +- [x] Có phân loại risk +- [x] Có đề xuất cải thiện + +## Reference note + +Tham chiếu best practice từ GitHub Docs: pin action theo full-length commit SHA để giảm rủi ro mutable tags. From 37a4fad5e7bc24cdce17a6230435618cdd22efc0 Mon Sep 17 00:00:00 2001 From: NgCuong <196793856+NguyenCuong1989@users.noreply.github.com> Date: Sun, 29 Mar 2026 19:23:06 +0700 Subject: [PATCH 13/21] Add WWW-4 import-your-data visual mock --- README.md | 5 ++ import-your-data.html | 143 ++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 148 insertions(+) create mode 100644 import-your-data.html diff --git a/README.md b/README.md index e5b2276b..88861e75 100644 --- a/README.md +++ b/README.md @@ -127,6 +127,11 @@ For more information about how to use the GitHub Copilot CLI, see [our official For the Linear WWW-3 visual, open `connect-your-tools.html` in a browser to see the recreated "Connect your tools" gradient + icon composition. + +## 🌐 Import your data mock + +For the Linear `WWW-4` visual, open `import-your-data.html` in a browser to see the recreated gradient hero, integration logos, and migration preview section. + ## 📢 Feedback and Participation We're excited to have you join us early in the Copilot CLI journey. diff --git a/import-your-data.html b/import-your-data.html new file mode 100644 index 00000000..8726f3b9 --- /dev/null +++ b/import-your-data.html @@ -0,0 +1,143 @@ + + + + + + Import your data + + + +
+ +
+ +
+

Import your data

+

Sync data between Linear and your other tools.

+ +
+ Pitch Linear + Run a pilot + Migration guide +
+ +
+ Linear migration workflow +
+
+ + From ffa43b7ca9dd870e45cbccfc8737aff6b8de168b Mon Sep 17 00:00:00 2001 From: NgCuong <196793856+NguyenCuong1989@users.noreply.github.com> Date: Sun, 29 Mar 2026 19:23:46 +0700 Subject: [PATCH 14/21] refine connect-your-tools layout and icon geometry --- connect-your-tools.html | 53 ++++++---- examples/connect-your-tools.html | 169 ++++++++++++------------------- 2 files changed, 94 insertions(+), 128 deletions(-) diff --git a/connect-your-tools.html b/connect-your-tools.html index ca4a7459..1de3ddbf 100644 --- a/connect-your-tools.html +++ b/connect-your-tools.html @@ -26,19 +26,22 @@ margin: 0; display: grid; place-items: center; + overflow: hidden; background: linear-gradient(125deg, var(--bg-start) 2%, var(--bg-mid) 51%, var(--bg-end) 98%); font-family: Inter, ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, Helvetica, Arial, sans-serif; } .logos { + --logo-size: clamp(108px, 11vw, 168px); display: flex; align-items: center; - gap: clamp(38px, 5vw, 84px); - transform: translateY(5vh); + gap: clamp(24px, 5vw, 64px); + transform: translateY(clamp(10px, 5vh, 52px)); + contain: layout paint; } .logo { - width: clamp(108px, 11vw, 168px); + width: var(--logo-size); aspect-ratio: 1; border-radius: 50%; background: var(--icon-bg); @@ -51,19 +54,18 @@ position: absolute; inset: 0; border-radius: 50%; - background: - linear-gradient( - 45deg, - transparent 38%, - var(--icon-accent) 38% 43.4%, - transparent 43.4% 51.6%, - var(--icon-accent) 51.6% 57%, - transparent 57% 65.2%, - var(--icon-accent) 65.2% 70.6%, - transparent 70.6% 78.8%, - var(--icon-accent) 78.8% 84.2%, - transparent 84.2% - ); + background: linear-gradient( + 45deg, + transparent 38%, + var(--icon-accent) 38% 43.4%, + transparent 43.4% 51.6%, + var(--icon-accent) 51.6% 57%, + transparent 57% 65.2%, + var(--icon-accent) 65.2% 70.6%, + transparent 70.6% 78.8%, + var(--icon-accent) 78.8% 84.2%, + transparent 84.2% + ); } .logo.plus::before, @@ -72,21 +74,30 @@ position: absolute; top: 50%; left: 50%; - width: clamp(42px, 4vw, 70px); - height: clamp(11px, 0.95vw, 16px); + width: 46%; + height: 10%; border-radius: 999px; background: var(--icon-accent); transform: translate(-50%, -50%); } .logo.plus::after { - transform: translate(-50%, -50%) rotate(90deg); + width: 10%; + height: 46%; } @media (max-width: 700px) { .logos { - gap: clamp(16px, 6vw, 36px); - transform: translateY(3vh); + transform: translateY(clamp(4px, 3vh, 20px)); + } + } + + @media (prefers-reduced-motion: reduce) { + *, + *::before, + *::after { + animation: none !important; + transition: none !important; } } diff --git a/examples/connect-your-tools.html b/examples/connect-your-tools.html index 7f8c5dcf..1de3ddbf 100644 --- a/examples/connect-your-tools.html +++ b/examples/connect-your-tools.html @@ -6,151 +6,106 @@ Connect your tools -
- - +
+ +
From 92f3368b9c1fb2b66c79c8d1073a02b02949e9f5 Mon Sep 17 00:00:00 2001 From: NgCuong <196793856+NguyenCuong1989@users.noreply.github.com> Date: Sun, 29 Mar 2026 19:24:36 +0700 Subject: [PATCH 15/21] refine connect-your-tools visual to match reference --- connect-your-tools.html | 74 +++++++++-------- examples/connect-your-tools.html | 134 +++++++++---------------------- 2 files changed, 76 insertions(+), 132 deletions(-) diff --git a/connect-your-tools.html b/connect-your-tools.html index afc42b96..ecf08276 100644 --- a/connect-your-tools.html +++ b/connect-your-tools.html @@ -6,10 +6,10 @@ Connect your tools -
- - +
+ +
diff --git a/examples/connect-your-tools.html b/examples/connect-your-tools.html index 7f8c5dcf..ecf08276 100644 --- a/examples/connect-your-tools.html +++ b/examples/connect-your-tools.html @@ -6,150 +6,90 @@ Connect your tools -
- +
+
From acae1c676ec425af6932f8a08b194cff05f40a62 Mon Sep 17 00:00:00 2001 From: NgCuong <196793856+NguyenCuong1989@users.noreply.github.com> Date: Sun, 29 Mar 2026 19:24:49 +0700 Subject: [PATCH 16/21] docs: add connect your tools integration section --- README.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/README.md b/README.md index 1cff9f51..3f311ea2 100644 --- a/README.md +++ b/README.md @@ -123,6 +123,24 @@ Each time you submit a prompt to GitHub Copilot CLI, your monthly quota of premi For more information about how to use the GitHub Copilot CLI, see [our official documentation](https://docs.github.com/copilot/concepts/agents/about-copilot-cli). +## 🔌 Connect your tools + +Integrations turn GitHub Copilot CLI into a stronger source of truth around product development. Keep data in sync and reduce manual updates between tools. + +### Key integrations + +- [**Slack**](https://linear.app/settings/integrations/slack): Create issues from Slack messages and sync threads. +- [**GitHub**](https://linear.app/settings/integrations/github) / [**GitLab**](https://linear.app/settings/integrations/gitlab): Automate pull request and commit workflows while keeping issues synced both ways. +- [**Agents**](https://linear.app/integrations/agents): Deploy AI agents that work alongside your team. + +### Browse all integrations + +Discover 150+ available connections in the [Linear integration directory](https://linear.app/integrations), from support tooling (Intercom, Zendesk) to design platforms such as Figma. + +### Build with the Linear API + +If you need a custom workflow, you can build directly on the [Linear API](https://linear.app/developers), which is GraphQL-based and designed for automation. + ## 📢 Feedback and Participation We're excited to have you join us early in the Copilot CLI journey. From 45753d5d013bbfb52684b0c6e929f86d34a6390b Mon Sep 17 00:00:00 2001 From: NgCuong <196793856+NguyenCuong1989@users.noreply.github.com> Date: Sun, 29 Mar 2026 21:42:24 +0700 Subject: [PATCH 17/21] Add LIN-5 link development checklist and docs references --- README.md | 2 ++ changelog.md | 1 + docs/lin-5-link-development-checklist.md | 42 ++++++++++++++++++++++++ 3 files changed, 45 insertions(+) create mode 100644 docs/lin-5-link-development-checklist.md diff --git a/README.md b/README.md index e5b2276b..98e561b5 100644 --- a/README.md +++ b/README.md @@ -127,6 +127,8 @@ For more information about how to use the GitHub Copilot CLI, see [our official For the Linear WWW-3 visual, open `connect-your-tools.html` in a browser to see the recreated "Connect your tools" gradient + icon composition. +For LIN-5 handoff and future link-development maintenance, use: `docs/lin-5-link-development-checklist.md`. + ## 📢 Feedback and Participation We're excited to have you join us early in the Copilot CLI journey. diff --git a/changelog.md b/changelog.md index af10e0e5..749c12d6 100644 --- a/changelog.md +++ b/changelog.md @@ -1,5 +1,6 @@ ## Unreleased +- Complete LIN-5 with a link-development checklist and README handoff reference - Add LIN-1 test follow-up note to complete Linear smoke test workflow ## 0.0.369 - 2025-12-11 diff --git a/docs/lin-5-link-development-checklist.md b/docs/lin-5-link-development-checklist.md new file mode 100644 index 00000000..32776d6e --- /dev/null +++ b/docs/lin-5-link-development-checklist.md @@ -0,0 +1,42 @@ +# LIN-5 Link Development Checklist + +This guide closes **LIN-5** and gives a practical checklist for link-related development so future updates are consistent and easy to maintain. + +## 1) Source references + +- Jira dashboard for tracking: + `https://nguyencuong2509-1772060629335.atlassian.net/jira/dashboards/10000` +- Local mock reference in this repository: + - `examples/connect-your-tools.html` + - README section: **Connect your tools mock** + +## 2) Recommended local workflow + +1. Create a short branch name tied to the issue (for example: `lin-5-link-check`). +2. Update docs and mock files together so links and descriptions stay aligned. +3. Verify every added/updated URL is: + - reachable, + - using HTTPS, + - and written once in canonical format. +4. Validate markdown formatting and ensure changed files are non-empty. +5. Add a short changelog note under `Unreleased` when user-visible docs are updated. + +## 3) Done criteria for link-related tasks + +A LIN-5 style “link check & finish” task is done when all items below are true: + +- [ ] Link targets are correct and use final URLs. +- [ ] README points to the latest relevant local doc or mock. +- [ ] Supporting doc explains purpose, maintenance notes, and where to extend. +- [ ] Changelog contains one concise completion note. +- [ ] Basic repository checks pass (`git diff --check`, file presence/non-empty checks). + +## 4) Maintenance notes + +- Prefer repository-relative references for local files (`docs/...`, `examples/...`) over repeating long explanations. +- Keep one checklist doc per issue when the change is process/documentation oriented. +- If links change in future issues, update this checklist and README in the same PR. + +--- + +If this file is updated later, keep the structure above so contributors can quickly verify “what to check” and “what marks the task complete.” From 021402184903f63f0568907772dbf94a0e5565cc Mon Sep 17 00:00:00 2001 From: NgCuong <196793856+NguyenCuong1989@users.noreply.github.com> Date: Fri, 10 Apr 2026 22:33:50 +0700 Subject: [PATCH 18/21] merge: add Vietnamese capability analysis (PR #19) --- docs/repo-capability-analysis.vi.md | 108 ++++++++++++++++++++++++++++ 1 file changed, 108 insertions(+) create mode 100644 docs/repo-capability-analysis.vi.md diff --git a/docs/repo-capability-analysis.vi.md b/docs/repo-capability-analysis.vi.md new file mode 100644 index 00000000..4a90d04b --- /dev/null +++ b/docs/repo-capability-analysis.vi.md @@ -0,0 +1,108 @@ +# Phân tích năng lực repository `copilot-cli` + +## 1) Tổng quan nhanh + +Repository hiện tại **đóng vai trò public distribution repo** cho GitHub Copilot CLI hơn là nơi chứa toàn bộ source code ứng dụng. Dấu hiệu: + +- README tập trung vào giá trị sản phẩm, cách cài đặt và cách sử dụng cho người dùng cuối. +- Có script cài đặt đa nền tảng (`install.sh`) để tải binary từ GitHub Releases. +- Có changelog chi tiết theo phiên bản để truyền thông tính năng và bản vá. +- Chưa thấy cấu trúc mã nguồn ứng dụng (ví dụ `src/`, `package.json`, test suite). + +=> Vì vậy, năng lực chính của repo là: **phân phối (distribution), tài liệu hóa (documentation), và trải nghiệm cài đặt nhanh**. + +--- + +## 2) Năng lực hiện có + +### 2.1. Năng lực phân phối và cài đặt + +- Hỗ trợ cài đặt qua nhiều kênh: `winget`, `brew`, `npm`, và shell installer. +- Shell installer tự nhận diện hệ điều hành, kiến trúc CPU, tải artifact phù hợp. +- Cho phép cài bản cụ thể qua biến môi trường `VERSION`. +- Cho phép tùy biến thư mục cài bằng `PREFIX`, có xử lý root/non-root. + +**Đánh giá:** tốt cho onboarding người dùng mới, giảm ma sát triển khai trên đa môi trường. + +### 2.2. Năng lực tương thích nền tảng + +- README nêu rõ hỗ trợ Linux/macOS/Windows. +- `install.sh` bao phủ Darwin/Linux; nhánh còn lại fallback cài qua `winget` cho Windows. + +**Đánh giá:** bao phủ tốt nhóm OS phổ biến cho developer tooling. + +### 2.3. Năng lực truyền thông sản phẩm + +- README trình bày rõ proposition: terminal-native, GitHub integration, agentic workflow, MCP extensibility. +- Changelog dày và đều theo phiên bản, cho thấy nhịp phát hành nhanh và liên tục cải tiến. + +**Đánh giá:** rất tốt ở mức “go-to-market docs” và minh bạch tiến hóa sản phẩm. + +### 2.4. Năng lực CI trong repo + +- Có cấu hình CircleCI nhưng hiện chỉ là job “Say hello” (mức tối thiểu). + +**Đánh giá:** hiện tại **gần như chưa có CI kiểm chứng chất lượng** ở chính repository này. + +--- + +## 3) Hạn chế / khoảng trống + +1. **Thiếu code implementation trong repo** + - Không có đủ thành phần để đánh giá sâu về kiến trúc nội bộ, chất lượng code, test coverage, bảo mật runtime. + +2. **CI quality gates còn rất mỏng** + - Pipeline hiện chưa chạy lint/test/security scan cho script và docs. + +3. **Thiếu chuẩn đóng góp cụ thể cho repo public-facing** + - Chưa thấy `CONTRIBUTING.md`, issue template, PR template. + +4. **Script installer có thể tăng cường thêm hardening** + - Hiện đã có kiểm tra tarball hợp lệ; nhưng chưa thấy checksum/signature verification của artifact. + +--- + +## 4) Mức trưởng thành hiện tại (đề xuất) + +- **Distribution Maturity:** 4/5 +- **Documentation Maturity:** 4/5 +- **Engineering Transparency (source/test/quality):** 2/5 (do không phải repo source đầy đủ) +- **Repository Governance (contribution standards):** 2.5/5 + +Tổng quan: repo phù hợp mục tiêu phân phối public preview, nhưng chưa tối ưu cho vai trò “engineering repository” theo nghĩa truyền thống. + +--- + +## 5) Đề xuất hoàn chỉnh (ưu tiên theo tác động) + +## Ưu tiên cao (Quick wins) + +1. **Nâng cấp CI cho chính repo này** + - Thêm job kiểm tra shell script (`shellcheck`), markdown link check, và format/lint cơ bản. + - Mục tiêu: tránh regression ở tài liệu và installer. + +2. **Thêm tài liệu đóng góp tối thiểu** + - `CONTRIBUTING.md` (quy trình issue/PR, quy ước changelog, cách test installer local). + - PR template để chuẩn hóa mô tả thay đổi. + +3. **Tăng độ tin cậy installer** + - Thêm checksum verification (SHA256) cho artifact trước khi giải nén. + +## Ưu tiên trung bình + +4. **Tài liệu vận hành phát hành (release playbook)** + - Mô tả quy trình publish artifact + cập nhật changelog + smoke test đa nền tảng. + +5. **Bổ sung FAQ vận hành thực tế** + - Lỗi PATH, lỗi quyền ghi, lỗi proxy/network enterprise, lỗi token/quota. + +## Ưu tiên dài hạn + +6. **Nếu phù hợp chiến lược public:** thêm “kiến trúc mức cao” + - Một sơ đồ/section giải thích thành phần chính CLI (UI loop, tool harness, MCP bridge, auth flow) ở mức không lộ chi tiết nội bộ. + +--- + +## 6) Kết luận + +Repo hiện có năng lực mạnh về **phân phối công cụ CLI cho người dùng cuối**, truyền thông rõ và cập nhật đều. Để “hoàn chỉnh” hơn theo góc độ engineering repository, nên tập trung bổ sung **quality gates cho installer/docs**, **chuẩn đóng góp**, và **hardening quy trình phát hành**. From b3e16978223810b360a459fef414f2c7a7d7b1ab Mon Sep 17 00:00:00 2001 From: NgCuong <196793856+NguyenCuong1989@users.noreply.github.com> Date: Fri, 10 Apr 2026 22:34:09 +0700 Subject: [PATCH 19/21] merge: refine connect-your-tools hero geometry (PR #15) --- connect-your-tools.html | 62 +++++++----- examples/connect-your-tools.html | 168 ++++++++++++------------------- 2 files changed, 101 insertions(+), 129 deletions(-) diff --git a/connect-your-tools.html b/connect-your-tools.html index ca4a7459..2ee2e201 100644 --- a/connect-your-tools.html +++ b/connect-your-tools.html @@ -6,11 +6,14 @@ Connect your tools diff --git a/examples/connect-your-tools.html b/examples/connect-your-tools.html index 7f8c5dcf..2ee2e201 100644 --- a/examples/connect-your-tools.html +++ b/examples/connect-your-tools.html @@ -6,151 +6,109 @@ Connect your tools -
- - +
+ +
From 5f27c8612e7c2779c54dea92b0d5ce5e5fcd6d19 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 15 Apr 2026 23:50:48 +0000 Subject: [PATCH 20/21] Initial plan From 7b709f5ee0735c1d5e5bb4ddb0e30ae65c26bb3f Mon Sep 17 00:00:00 2001 From: NgCuong <196793856+NguyenCuong1989@users.noreply.github.com> Date: Sun, 17 May 2026 23:03:38 +0700 Subject: [PATCH 21/21] Update import-your-data.html Co-authored-by: sourcery-ai[bot] <58596630+sourcery-ai[bot]@users.noreply.github.com> --- import-your-data.html | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/import-your-data.html b/import-your-data.html index 8726f3b9..ed473cd7 100644 --- a/import-your-data.html +++ b/import-your-data.html @@ -136,7 +136,13 @@

Import your data

- Linear migration workflow + Linear migration workflow