@kenkyou/supekku 0.0.0-stage → 0.1.0-alpha.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +58 -2
- package/dist/THIRD_PARTY_NOTICES.md +4029 -0
- package/dist/agent-artifacts.md +91 -0
- package/dist/agent-onboarding.md +70 -0
- package/dist/agent-workflow-handoff.md +59 -0
- package/dist/api-D-iVy-AK.mjs +257 -0
- package/dist/archive-zV-1FPIG.mjs +275 -0
- package/dist/artifact-BTrZyotV.mjs +2 -0
- package/dist/artifact-DFA13JnU.mjs +242 -0
- package/dist/artifact-local-Bfy69a9H.mjs +161 -0
- package/dist/artifact-local.md +126 -0
- package/dist/artifact-migrations/0001_initial.sql +9 -0
- package/dist/artifact-migrations/0002_publications.sql +9 -0
- package/dist/artifact.schema.json +297 -0
- package/dist/browser-xnEH9tG1.mjs +61 -0
- package/dist/change-BGLzKkKO.mjs +177 -0
- package/dist/change-C4CjlVny.mjs +362 -0
- package/dist/change-CdFWVdtN.mjs +1 -0
- package/dist/change-archive.md +83 -0
- package/dist/change-workflow.md +183 -0
- package/dist/check-CdparnIC.mjs +4 -0
- package/dist/cli-publication.md +107 -0
- package/dist/connect-Bfgp9Y_w.mjs +38 -0
- package/dist/connection-BXfXx-wo.mjs +1 -0
- package/dist/connection-DaxqQEdP.mjs +276 -0
- package/dist/credentials-CxkhjmnO.mjs +63 -0
- package/dist/doctor-DYGXldO4.mjs +70 -0
- package/dist/feedback-C2zx-BMA.mjs +191 -0
- package/dist/feedback-CS1HHQqT.mjs +45 -0
- package/dist/feedback-DA-v75O7.mjs +92 -0
- package/dist/files-Ca24RKdp.mjs +59 -0
- package/dist/files-DphxaLNK.mjs +84 -0
- package/dist/index.mjs +631 -0
- package/dist/journal-BUovxXEV.mjs +806 -0
- package/dist/local-BDsv_lkD.mjs +69 -0
- package/dist/local-DrJ8z2qm.mjs +1 -0
- package/dist/locks-C4XYFwbg.mjs +88 -0
- package/dist/locks-ePa5rQ2P.mjs +1 -0
- package/dist/maintenance-Cab52jTm.mjs +488 -0
- package/dist/migrations/0001_initial.sql +8 -0
- package/dist/migrations/0002_identity.sql +11 -0
- package/dist/migrations/0003_task_events.sql +9 -0
- package/dist/migrations/0004_archive_operations.sql +8 -0
- package/dist/package-Ci4aNmkW.mjs +56 -0
- package/dist/package-Dg68Av6x.mjs +1 -0
- package/dist/project-B4BDXHwA.mjs +1 -0
- package/dist/project-DAv2aODU.mjs +1 -0
- package/dist/project-Djy7qwQy.mjs +152 -0
- package/dist/project-YL4kEL7c.mjs +95 -0
- package/dist/project-directory-8to0Nbna.mjs +1 -0
- package/dist/project-directory-w_ITkI7O.mjs +66 -0
- package/dist/publications-DaNXLqrj.mjs +146 -0
- package/dist/publish-CPyVtYSl.mjs +191 -0
- package/dist/revisions-CZyZmV7P.mjs +637 -0
- package/dist/serve-C7rls3m6.mjs +612 -0
- package/dist/skills/supekku-artifacts/SKILL.md +19 -0
- package/dist/skills/supekku-artifacts/references/handoff.md +59 -0
- package/dist/skills/supekku-artifacts/references/workflow.md +99 -0
- package/dist/skills/supekku-development/SKILL.md +28 -0
- package/dist/skills/supekku-development/references/agent-onboarding.md +70 -0
- package/dist/skills/supekku-development/references/change-archive.md +83 -0
- package/dist/skills/supekku-development/references/change-workflow.md +183 -0
- package/dist/skills/supekku-development/references/examples/document-comments.md +44 -0
- package/dist/skills/supekku-development/references/examples/new-member-journey.md +44 -0
- package/dist/skills/supekku-development/references/handoff.md +59 -0
- package/dist/skills/supekku-development/references/routing.md +18 -0
- package/dist/skills/supekku-development/references/stages.md +59 -0
- package/dist/skills/supekku-development/references/task-execution.md +85 -0
- package/dist/skills/supekku-development/references/verification-map.md +53 -0
- package/dist/skills-BmMLLF83.mjs +312 -0
- package/dist/skills-CtT50_yk.mjs +1 -0
- package/dist/src-CRhxwFAN.mjs +3323 -0
- package/dist/src-DeDtBfdV.mjs +26336 -0
- package/dist/status-BvBBIdUu.mjs +320 -0
- package/dist/store-DDJRNwP-.mjs +1 -0
- package/dist/store-jFj2Dhgl.mjs +288 -0
- package/dist/task-CV3faWLg.mjs +1 -0
- package/dist/task-F-xMfIdb.mjs +206 -0
- package/dist/task-execution.md +85 -0
- package/dist/templates/artifact.json +48 -0
- package/dist/templates/comparison/.supekku/artifacts/example-comparison/artifact.json +48 -0
- package/dist/templates/comparison/.supekku/artifacts/example-comparison/content/option-a/index.html +2 -0
- package/dist/templates/comparison/.supekku/artifacts/example-comparison/content/option-b/index.html +2 -0
- package/dist/templates/content/option-a/index.html +2 -0
- package/dist/templates/content/option-b/index.html +2 -0
- package/dist/templates/document/.supekku/artifacts/example-document/artifact.json +9 -0
- package/dist/templates/document/.supekku/example-document.md +16 -0
- package/dist/templates/html/.supekku/artifacts/example-html/artifact.json +9 -0
- package/dist/templates/html/.supekku/artifacts/example-html/content/main/index.html +1 -0
- package/dist/templates/image/.supekku/artifacts/example-image/artifact.json +9 -0
- package/dist/templates/image/.supekku/artifacts/example-image/content/image.png +0 -0
- package/dist/verification-BEG80Jm9.mjs +56 -0
- package/dist/verification-BSp-UJLw.mjs +99 -0
- package/dist/verification-D2vjvdCT.mjs +1 -0
- package/dist/verification-map.md +53 -0
- package/dist/viewer/assets/local-B4ON878x.css +2 -0
- package/dist/viewer/assets/local-DGmDYuBR.js +17 -0
- package/dist/viewer/brand/apple-touch-icon.png +0 -0
- package/dist/viewer/brand/favicon-16.png +0 -0
- package/dist/viewer/brand/favicon-32.png +0 -0
- package/dist/viewer/brand/favicon.ico +0 -0
- package/dist/viewer/brand/favicon.svg +1 -0
- package/dist/viewer/brand/og.png +0 -0
- package/dist/viewer/local.html +3 -0
- package/package.json +50 -3
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 kenkyou
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,59 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Supekku CLI
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
以規格驅動 AI Agent 開發:討論、提案、規格/設計、Tasks、驗證、TDD/Review、正式規格合併與封存。Artifact 是可選的討論材料;純本機開發流程不需要 Web 帳號或 Google 登入。
|
|
4
|
+
|
|
5
|
+
目前為 `0.1.0-alpha.0` 預覽候選。此版本尚在發布準備;以下 npm 指令在套件發布後才可使用。
|
|
6
|
+
|
|
7
|
+
## 安裝
|
|
8
|
+
|
|
9
|
+
需要 Node.js **24.22.1 或以上**。發布後安裝指定的預覽標籤:
|
|
10
|
+
|
|
11
|
+
```sh
|
|
12
|
+
npm install -g @kenkyou/supekku@next
|
|
13
|
+
supekku --version
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
若已安裝另一個同名 `supekku`,請使用獨立目錄安裝,避免全域 bin 衝突:
|
|
17
|
+
|
|
18
|
+
```sh
|
|
19
|
+
mkdir supekku-cli-install
|
|
20
|
+
cd supekku-cli-install
|
|
21
|
+
npm init -y
|
|
22
|
+
npm install @kenkyou/supekku@next
|
|
23
|
+
./node_modules/.bin/supekku --version
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
未發布的候選可將套件名稱替換成取得的 `.tgz` 絕對路徑。以下命令中的 `supekku` 須使用你選擇的新版執行路徑。
|
|
27
|
+
|
|
28
|
+
## 純本機使用
|
|
29
|
+
|
|
30
|
+
在要管理的專案執行,不在 CLI 安裝目錄初始化:
|
|
31
|
+
|
|
32
|
+
```sh
|
|
33
|
+
supekku local init --project /path/to/project --json
|
|
34
|
+
supekku skills install --project /path/to/project --target .agents/skills --json
|
|
35
|
+
supekku doctor --project /path/to/project --target .agents/skills --json
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
兩套隨附 skill 為 `supekku-development` 與 `supekku-artifacts`。請選擇 Agent 支援的目錄並重新載入;安裝不代表 Agent 已載入。使用 development skill 完成提案到封存;CLI 不會因評論或規格確認自動授權實作。
|
|
39
|
+
|
|
40
|
+
正式文件保存在 `.supekku/`,建議進 Git;`.supekku/.local/` 是私有日誌,不進 Git,也不是可隨意刪除的快取。已有上層 Supekku 專案時不能再建立巢狀根目錄。
|
|
41
|
+
|
|
42
|
+
## 選用 Web 協作
|
|
43
|
+
|
|
44
|
+
有平台與專案權限時才需連接:
|
|
45
|
+
|
|
46
|
+
```sh
|
|
47
|
+
supekku connect --server https://your-server.example --project /path/to/project
|
|
48
|
+
supekku artifact template document review-notes --json
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
瀏覽器核對驗證碼、選專案並授權。範本命令只輸出檔案描述,不會自行寫入;請由 Agent 在授權範圍建立內容,執行 `artifact check`,再以回傳 revisionId 明確 `artifact publish`。憑證留在系統儲存庫,不進專案。Linux 的遠端授權需 Secret Service,沒有純文字 fallback。
|
|
52
|
+
|
|
53
|
+
## 平台與更新
|
|
54
|
+
|
|
55
|
+
目前 macOS arm64 有本機驗證;macOS x64、Linux x64 glibc、Windows x64 的這個發布候選尚待獨立驗證,不把安裝成功或預覽標籤當成四平台認證。原生依賴需要對應預編譯產物。
|
|
56
|
+
|
|
57
|
+
由早期內部 `@supekku/cli` 改名為 `@kenkyou/supekku`。舊套件與既有專案不會自動搬移;舊 scope 的 skill 收據會被當成不同套件,請保留自訂內容、使用新的支援目錄安裝,不修改收據來繞過保護。
|
|
58
|
+
|
|
59
|
+
隨套件的 `dist/agent-onboarding.md`、`dist/change-workflow.md`、`dist/task-execution.md`、`dist/change-archive.md` 與 `dist/cli-publication.md` 提供完整操作說明。資料修改前請先備份;測試或留言不是執行授權。
|