@kenkyou/supekku 0.1.0-alpha.1 → 0.1.0-alpha.3

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.
Files changed (48) hide show
  1. package/README.md +41 -1
  2. package/dist/agent-artifacts.md +1 -1
  3. package/dist/agent-onboarding.md +42 -2
  4. package/dist/{api-D-iVy-AK.mjs → api-DNK2unOM.mjs} +9 -0
  5. package/dist/{archive-zV-1FPIG.mjs → archive-C9H-mmH5.mjs} +1 -1
  6. package/dist/archive-CHD4Te38.mjs +1 -0
  7. package/dist/{artifact-DFA13JnU.mjs → artifact-DB-BbLHN.mjs} +9 -11
  8. package/dist/artifact-DcpnfU11.mjs +2 -0
  9. package/dist/{browser-xnEH9tG1.mjs → browser-ZZZ9iv0U.mjs} +1 -1
  10. package/dist/{check-CdparnIC.mjs → check-CUGUw_8s.mjs} +1 -1
  11. package/dist/cli-publication.md +18 -14
  12. package/dist/{connection-DaxqQEdP.mjs → connection-jD5RlW1b.mjs} +1 -1
  13. package/dist/doctor-BBRvUMOX.mjs +1 -0
  14. package/dist/{doctor-CPnbf1nt.mjs → doctor-CiotyxFb.mjs} +3 -3
  15. package/dist/{feedback-CS1HHQqT.mjs → feedback-BrXufWeh.mjs} +4 -5
  16. package/dist/{feedback-DA-v75O7.mjs → feedback-CQ9Ymv6J.mjs} +1 -1
  17. package/dist/{feedback-C2zx-BMA.mjs → feedback-Dh0v9BIr.mjs} +2 -2
  18. package/dist/index.mjs +198 -30
  19. package/dist/init-C5RDDwUf.mjs +95 -0
  20. package/dist/{project-CdWOw1Ab.mjs → project-BXsAoMV1.mjs} +6 -2
  21. package/dist/project-BejWazB8.mjs +1 -0
  22. package/dist/project-Cp0fxWoh.mjs +1 -0
  23. package/dist/{project-Djy7qwQy.mjs → project-Dq2SpWN5.mjs} +15 -7
  24. package/dist/project-connection-09JC8T7M.mjs +203 -0
  25. package/dist/{publications-DaNXLqrj.mjs → publications-CCKKV7y1.mjs} +1 -1
  26. package/dist/{publish-CPyVtYSl.mjs → publish-DX7lmTf4.mjs} +5 -5
  27. package/dist/{revisions-CZyZmV7P.mjs → revisions-BuCkMiDb.mjs} +1 -1
  28. package/dist/{serve-C7rls3m6.mjs → serve-37rjgOKv.mjs} +2 -2
  29. package/dist/skills/supekku-artifacts/SKILL.md +4 -1
  30. package/dist/skills/supekku-development/SKILL.md +4 -0
  31. package/dist/skills/supekku-development/references/agent-onboarding.md +42 -2
  32. package/dist/{skills-BmMLLF83.mjs → skills-DcxDoyH7.mjs} +3 -3
  33. package/dist/skills-YRZw153S.mjs +1 -0
  34. package/dist/status-BbwxwT2C.mjs +1 -0
  35. package/dist/{status-BvBBIdUu.mjs → status-BiOxakHh.mjs} +36 -21
  36. package/dist/status-BzYrPSRi.mjs +124 -0
  37. package/dist/viewer/assets/local-CzRu6SWP.css +2 -0
  38. package/dist/viewer/local.html +2 -2
  39. package/package.json +1 -1
  40. package/dist/artifact-BTrZyotV.mjs +0 -2
  41. package/dist/connect-Bfgp9Y_w.mjs +0 -38
  42. package/dist/connection-BXfXx-wo.mjs +0 -1
  43. package/dist/credentials-CxkhjmnO.mjs +0 -63
  44. package/dist/project-B-H-RbPP.mjs +0 -1
  45. package/dist/project-DAv2aODU.mjs +0 -1
  46. package/dist/skills-CtT50_yk.mjs +0 -1
  47. package/dist/viewer/assets/local-B4ON878x.css +0 -2
  48. /package/dist/viewer/assets/{local-DGmDYuBR.js → local-wPtOzNXl.js} +0 -0
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  以規格驅動 AI Agent 開發:討論、提案、規格/設計、Tasks、驗證、TDD/Review、正式規格合併與封存。Artifact 是可選的討論材料;純本機開發流程不需要 Web 帳號或 Google 登入。
4
4
 
5
- 此套件為 `0.1.0-alpha.1` 預覽版,建議明確使用 `@next`;預覽版不代表穩定版。
5
+ 此套件為 `0.1.0-alpha.2` 預覽版,建議明確使用 `@next`;預覽版不代表穩定版。
6
6
 
7
7
  ## 安裝
8
8
 
@@ -25,6 +25,26 @@ npm install @kenkyou/supekku@next
25
25
 
26
26
  未發布的候選可將套件名稱替換成取得的 `.tgz` 絕對路徑。以下命令中的 `supekku` 須使用你選擇的新版執行路徑。
27
27
 
28
+ ## 一次完成初始化(alpha.2)
29
+
30
+ 在專案根目錄執行 `supekku init`,終端會詢問 Agent,依序初始化、安裝兩套 skills 並執行 doctor。此入口自 0.1.0-alpha.2 提供。
31
+
32
+ ```sh
33
+ supekku init
34
+ supekku init --agent codex --json
35
+ supekku init --independent --agent codex --json
36
+ supekku init --project /path/to/project --agent claude --json
37
+ supekku init --target .agents/skills --json
38
+ ```
39
+
40
+ Agent 選項:`codex` → `.codex/skills`、`claude` → `.claude/skills`、`agents` → `.agents/skills`。自訂 `--target` 與 `--agent` 互斥;不猜測 Agent 或寫入全域目錄。安裝後自行重新載入 Agent。
41
+
42
+ `--json` 或非互動程序必須提供 agent/target,不會等待輸入。互動選單沒有預設選項,取消、EOF 或非法選擇均不寫入。init 的 `--independent` 可使用目前目錄,底層 local init 仍要求搭配明確 --project。
43
+
44
+ 先預檢目標及 skill 衝突再寫入;既有修改與中斷檔案保留。多步操作不是單一交易,失敗不自動回滾或重送。JSON 的 `ok:true` 表示已產生流程結果,只有 `data.completed:true` 才代表全部就緒;部分失敗退出2,回報 failedStage、error、completedStages。先處理原因,再以相同選項明確重跑。doctor.ready 不代表 DB 健康或 Agent 已載入。
45
+
46
+ 底層 `local init`、`skills install/status`、`doctor` 保留;不登入、不綁 Web、不啟動任務,也不改寫 AGENTS.md。
47
+
28
48
  ## 純本機使用
29
49
 
30
50
  在要管理的專案執行,不在 CLI 安裝目錄初始化:
@@ -57,3 +77,23 @@ supekku artifact template document review-notes --json
57
77
  由早期內部 `@supekku/cli` 改名為 `@kenkyou/supekku`。舊套件與既有專案不會自動搬移;舊 scope 的 skill 收據會被當成不同套件,請保留自訂內容、使用新的支援目錄安裝,不修改收據來繞過保護。
58
78
 
59
79
  隨套件的 `dist/agent-onboarding.md`、`dist/change-workflow.md`、`dist/task-execution.md`、`dist/change-archive.md` 與 `dist/cli-publication.md` 提供完整操作說明。資料修改前請先備份;測試或留言不是執行授權。
80
+
81
+ ## 快捷入口(alpha.2)
82
+
83
+ ```sh
84
+ supekku status
85
+ supekku status --agent codex --json
86
+ supekku status --remote --json
87
+ supekku check my-change --json
88
+ supekku feedback my-document --limit 20 --json
89
+ supekku feedback my-document --version <versionId> --after <nextCursor> --json
90
+ supekku skills update --agent codex --json
91
+ ```
92
+
93
+ 所有入口可加 --project。status 預設不連線、不載入憑證、不初始化;省略 agent/target 時明示 skills 未檢查。顯示目前提案、Task runtime 狀態與待恢復封存/發布;不代表授權實作或自動恢復。--remote 只確認綁定與帳號的專案存取,不查所有 Artifact 版本;版本比較仍用 artifact status <id> --remote。
94
+
95
+ status 每次最多20提案、每案50任務、100筆 pending 發布,明示 hasMore;個案不可讀、缺少 journal、截斷或遠端失敗保留其他結果,complete:false 並退出2。缺資料不代表已驗證沒有待恢復操作。SQLite 讀取可能產生 WAL 協調檔;無業務寫入或恢復。
96
+
97
+ check 保留 change validate 的 valid、findings 和退出碼;ok:true 不等於 valid:true。feedback 是遠端只讀 list 捷徑,保留版本、cursor、limit 與現有授權,不回覆或標記完成。skills update 使用隨目前 CLI 的 skills,不更新 npm、不初始化專案、不覆寫自行修改內容。需明確 agent 或 target;可安全更新狀態不等於 Agent 已重新載入。原始底層指令持續支援。
98
+
99
+ 完整的初始化、提案、驗證、實作與封存教學見 [完整使用教學](../../docs/getting-started.md)。
@@ -12,7 +12,7 @@ Agent 使用 artifact feedback list 與明確游標讀取回饋,reply/resolv
12
12
 
13
13
  ## 發布至已登入的 Web 專案
14
14
 
15
- 新對話先執行 `supekku project status --project <path> --json`,以最近的 Supekku 根目錄及 `.supekku/project.json` 判定目的地,不從聊天內容猜專案。無綁定時,引導使用者執行 `connect --server <Web origin> --project <path>`,在 Google 登入的 Web 選專案並批准裝置,CLI 自動綁定。已有綁定時可執行 `connect --project <path>` 沿用網站。有效授權直接沿用;不同目的地需使用者明確同意後加 `--replace`,不得自行登出換帳號。開瀏覽器失敗可依終端網址手動操作,非互動環境使用 `--no-open --json`。公開綁定只含 repositoryId、origin、projectId;憑證在系統儲存庫。
15
+ 新對話先執行 `supekku project status --project <path> --json`,以最近的 Supekku 根目錄及 `.supekku/project.json` 判定目的地,不從聊天內容猜專案。無綁定時,引導使用者執行 `connect --server <Web origin> --project <path>`,在 Google 登入的 Web 選專案並批准裝置,CLI 自動綁定。已有綁定時可執行 `connect --project <path>` 沿用網站。只沿用這個 checkout 的有效授權;不同目的地需使用者明確同意後加 `--replace`,不得自行登出換帳號。開瀏覽器失敗可依終端網址手動操作,非互動環境使用 `--no-open --json`。schemaVersion 2 公開綁定含 repositoryId、origin、projectId 與非機密 credentialId;憑證在系統儲存庫。不同 checkout 的 connect、refresh 與 logout 互不覆蓋;舊 schema 1 需重新授權一次,不複製共用 token。
16
16
 
17
17
  生成與發布為兩次不同範圍的授權;既有明確發布授權不必重複詢問。順序是 `status → list/init → check → serve → publish --dry-run → publish`。使用 check 回傳的 revisionId:
18
18
 
@@ -1,6 +1,28 @@
1
1
  # Agent 安裝與專案啟用
2
2
 
3
- 需要 Node 24.22.1 或以上的受測版本。請使用已建置/安裝的新版 `@kenkyou/supekku`;`--version` 取自執行套件的 package.json。本指南對應 0.1.0-alpha.1;發行驗證以各版 release 紀錄為準。專案裡若還有舊版同名 CLI,先確認你執行的檔案路徑;以下 `supekku` 都指新版安裝後的 bin。
3
+ 需要 Node 24.22.1 或以上的受測版本。請使用已建置/安裝的新版 `@kenkyou/supekku`;`--version` 取自執行套件的 package.json。本指南對應 0.1.0-alpha.2;發行驗證以各版 release 紀錄為準。專案裡若還有舊版同名 CLI,先確認你執行的檔案路徑;以下 `supekku` 都指新版安裝後的 bin。
4
+
5
+ 完整的提案、TDD、Review 與封存步驟見 [完整使用教學](getting-started.md)。
6
+
7
+ ## 一次完成初始化(alpha.2)
8
+
9
+ 在專案根目錄執行 `supekku init`,終端會詢問 Agent,依序初始化、安裝兩套 skills 並執行 doctor。此入口自 0.1.0-alpha.2 提供。
10
+
11
+ ```sh
12
+ supekku init
13
+ supekku init --agent codex --json
14
+ supekku init --independent --agent codex --json
15
+ supekku init --project /path/to/project --agent claude --json
16
+ supekku init --target .agents/skills --json
17
+ ```
18
+
19
+ Agent 選項:`codex` → `.codex/skills`、`claude` → `.claude/skills`、`agents` → `.agents/skills`。自訂 `--target` 與 `--agent` 互斥;不猜測 Agent 或寫入全域目錄。安裝後自行重新載入 Agent。
20
+
21
+ `--json` 或非互動程序必須提供 agent/target,不會等待輸入。互動選單沒有預設選項,取消、EOF 或非法選擇均不寫入。init 的 `--independent` 可使用目前目錄,底層 local init 仍要求搭配明確 --project。
22
+
23
+ 先預檢目標及 skill 衝突再寫入;既有修改與中斷檔案保留。多步操作不是單一交易,失敗不自動回滾或重送。JSON 的 `ok:true` 表示已產生流程結果,只有 `data.completed:true` 才代表全部就緒;部分失敗退出2,回報 failedStage、error、completedStages。先處理原因,再以相同選項明確重跑。doctor.ready 不代表 DB 健康或 Agent 已載入。
24
+
25
+ 底層 `local init`、`skills install/status`、`doctor` 保留;不登入、不綁 Web、不啟動任務,也不改寫 AGENTS.md。
4
26
 
5
27
  ## 第一次使用
6
28
 
@@ -22,7 +44,7 @@ supekku doctor --project /path/to/project --target .agents/skills --json
22
44
  supekku local init --project /path/to/hakulax --independent --json
23
45
  ```
24
46
 
25
- 此選項僅適用 local init,必須同時提供 --project。只初始化指定資料夾,不掃描或遷移上層管理資料。後續指令從新根目錄或其子目錄尋找最近的 `.supekku/`。不加此選項時仍保留原本拒絕巢狀初始化的行為。
47
+ 上述底層 local init 的 --independent 必須同時提供 --project;新版統一 init 也支援 --independent,且可使用目前目錄。只初始化指定資料夾,不掃描或遷移上層管理資料。後續指令從新根目錄或其子目錄尋找最近的 `.supekku/`。不加此選項時仍保留原本拒絕巢狀初始化的行為。
26
48
 
27
49
  目標本身若有舊 supekku/、新舊目錄衝突、symlink 或不安全 journal,仍拒絕;沒有 force 覆寫。此功能不會安裝 skills、綁定網站或授權實作。不要把獨立子專案目錄列入父專案 Task scope。此選項自 0.1.0-alpha.1 提供,alpha.0 不支援。
28
50
 
@@ -80,3 +102,21 @@ doctor 的 `readiness.inspection.available` 表示 Node 與原生目錄足以開
80
102
  沒有 journal 時,活動 Task 的 `status/snapshot` 以空事件計算目前狀態;Markdown 宣告 done 不會產生 runtime 完成證據。Git 中的 `.supekku/archive/` 文件與 receipt 是歷史依據,不能轉成本機 done、當作本次驗證或新授權。`change archive-list` 查的是本機 journal 的操作,不是 Git 歷史文件清單。
81
103
 
82
104
  禁止直接讀取、複製私有 SQLite;這不禁止已授權的原生 CLI 正常使用 journal。既有 journal 的 status/snapshot 可能需要本機鎖與檔案存取權限,不保證在唯讀檔案系統可執行。禁止讀取環境檔;本機接手不需要 Web 登入或環境密鑰。
105
+
106
+ ## 快捷入口(alpha.2)
107
+
108
+ ```sh
109
+ supekku status
110
+ supekku status --agent codex --json
111
+ supekku status --remote --json
112
+ supekku check my-change --json
113
+ supekku feedback my-document --limit 20 --json
114
+ supekku feedback my-document --version <versionId> --after <nextCursor> --json
115
+ supekku skills update --agent codex --json
116
+ ```
117
+
118
+ 所有入口可加 --project。status 預設不連線、不載入憑證、不初始化;省略 agent/target 時明示 skills 未檢查。顯示目前提案、Task runtime 狀態與待恢復封存/發布;不代表授權實作或自動恢復。--remote 只確認綁定與帳號的專案存取,不查所有 Artifact 版本;版本比較仍用 artifact status <id> --remote。
119
+
120
+ status 每次最多20提案、每案50任務、100筆 pending 發布,明示 hasMore;個案不可讀、缺少 journal、截斷或遠端失敗保留其他結果,complete:false 並退出2。缺資料不代表已驗證沒有待恢復操作。SQLite 讀取可能產生 WAL 協調檔;無業務寫入或恢復。
121
+
122
+ check 保留 change validate 的 valid、findings 和退出碼;ok:true 不等於 valid:true。feedback 是遠端只讀 list 捷徑,保留版本、cursor、limit 與現有授權,不回覆或標記完成。skills update 使用隨目前 CLI 的 skills,不更新 npm、不初始化專案、不覆寫自行修改內容。需明確 agent 或 target;可安全更新狀態不等於 Agent 已重新載入。原始底層指令持續支援。
@@ -16,6 +16,7 @@ Type.Union([Type.Object({ name: Type.String({
16
16
  }) }, { additionalProperties: false }), Type.Object({ archived: Type.Boolean() }, { additionalProperties: false })]);
17
17
  Type.Object({ snapshot: SnapshotSchema }, { additionalProperties: false });
18
18
  Type.Object({
19
+ summary: Type.Optional(Type.Literal("true")),
19
20
  after: Type.Optional(Uuid),
20
21
  status: Type.Optional(Type.Union([
21
22
  Type.Literal("active"),
@@ -25,6 +26,14 @@ Type.Object({
25
26
  limit: Type.Optional(Type.String({ pattern: "^(?:[1-9]|[1-9][0-9]|100)$" }))
26
27
  }, { additionalProperties: false });
27
28
  const ProjectView = Type.Object({
29
+ summary: Type.Optional(Type.Object({
30
+ role: Type.Union([
31
+ Type.Literal("reader"),
32
+ Type.Literal("collaborator"),
33
+ Type.Literal("manager")
34
+ ]),
35
+ artifactCount: Type.Integer({ minimum: 0 })
36
+ }, { additionalProperties: false })),
28
37
  id: Uuid,
29
38
  name: Type.String(),
30
39
  createdAt: Type.String(),
@@ -272,4 +272,4 @@ async function archiveCommand(action, args, project, hook = async () => {}) {
272
272
  }
273
273
  });
274
274
  }
275
- export { archiveCommand };
275
+ export { archiveCommand as t };
@@ -0,0 +1 @@
1
+ export { t as archiveCommand } from "./archive-C9H-mmH5.mjs";
@@ -136,21 +136,19 @@ async function artifactCommand(action, args, project) {
136
136
  if (action === "template") return artifactTemplate(args[0], args[1]);
137
137
  const root = await findProject(project);
138
138
  if (action === "status") {
139
- const { artifactStatus } = await import("./status-BvBBIdUu.mjs");
139
+ const { artifactStatus } = await import("./status-BbwxwT2C.mjs");
140
140
  if (!args.includes("--remote")) return artifactStatus(root, args[0]);
141
- const { createConnection } = await import("./connection-BXfXx-wo.mjs");
142
- const { credentials } = await import("./credentials-CxkhjmnO.mjs");
143
- return artifactStatus(root, args[0], createConnection({ store: credentials }));
141
+ const { boundConnection } = await import("./project-connection-09JC8T7M.mjs");
142
+ return artifactStatus(root, args[0], await boundConnection(root));
144
143
  }
145
144
  if ([
146
145
  "publish",
147
146
  "publish-status",
148
147
  "publish-resume"
149
148
  ].includes(action)) {
150
- const { publishArtifact, resumePublication } = await import("./publish-CPyVtYSl.mjs");
151
- const { createConnection } = await import("./connection-BXfXx-wo.mjs");
152
- const { credentials } = await import("./credentials-CxkhjmnO.mjs");
153
- const remote = createConnection({ store: credentials });
149
+ const { publishArtifact, resumePublication } = await import("./publish-DX7lmTf4.mjs");
150
+ const { boundConnection } = await import("./project-connection-09JC8T7M.mjs");
151
+ const remote = await boundConnection(root);
154
152
  return action === "publish" ? publishArtifact(root, args[0], args[2], args.includes("--dry-run"), remote, (operationId) => {
155
153
  process.stderr.write(JSON.stringify({
156
154
  event: "publication_prepared",
@@ -229,14 +227,14 @@ async function artifactCommand(action, args, project) {
229
227
  return { artifacts };
230
228
  }
231
229
  if (action === "feedback") {
232
- const { feedback } = await import("./feedback-CS1HHQqT.mjs");
230
+ const { feedback } = await import("./feedback-BrXufWeh.mjs");
233
231
  return feedback(root, args);
234
232
  }
235
233
  if (action === "serve") {
236
- const { serve } = await import("./serve-C7rls3m6.mjs");
234
+ const { serve } = await import("./serve-37rjgOKv.mjs");
237
235
  return serve(root);
238
236
  }
239
- const { check } = await import("./check-CdparnIC.mjs");
237
+ const { check } = await import("./check-CUGUw_8s.mjs");
240
238
  return check(root, args[0]);
241
239
  }
242
240
  export { readManifest as n, artifactCommand as t };
@@ -0,0 +1,2 @@
1
+ import "./project-directory-w_ITkI7O.mjs";
2
+ export { t as artifactCommand } from "./artifact-DB-BbLHN.mjs";
@@ -1,5 +1,5 @@
1
1
  import { t as CoreError } from "./src-CRhxwFAN.mjs";
2
- import { n as serverOrigin } from "./connection-DaxqQEdP.mjs";
2
+ import { n as serverOrigin } from "./connection-jD5RlW1b.mjs";
3
3
  import { spawn } from "node:child_process";
4
4
  // src/remote/browser.ts
5
5
  function browserCommand(platform, url) {
@@ -1,4 +1,4 @@
1
- import { t as checkArtifact } from "./revisions-CZyZmV7P.mjs";
1
+ import { t as checkArtifact } from "./revisions-BuCkMiDb.mjs";
2
2
  // src/commands/artifact/check.ts
3
3
  const check = checkArtifact;
4
4
  export { check };
@@ -12,28 +12,32 @@ supekku connect --server https://your-server.example --project /path/to/reposito
12
12
 
13
13
  指令會開啟瀏覽器,Google 登入後選擇專案並允許授權;CLI 自動取得你批准的專案並完成綁定,不需要輸入 UUID。終端也會顯示網址及驗證碼;若無法自動開啟,手動開啟即可。遠端終端或不想開瀏覽器時加 --no-open。只有 Web 閱讀/評論的同事不需要 CLI。
14
14
 
15
- 在本機開發環境使用 --server http://127.0.0.1:5173,與 Web 登入的 origin 一致。綁定存於 .supekku/project.json,只有 repositoryId 與網站/專案識別,沒有 token。憑證留在系統儲存庫。
16
-
17
- 後續在同一資料夾或子目錄執行 supekku connect,可沿用網站地址及有效授權;已正確綁定會回報 changed=false。從 Git 取得綁定的同事仍需個別授權。connect 只連接,不發布 Artifact;既有發布流程保持明確授權。
18
-
19
- - 同網站已有有效 CLI 授權:沿用該授權的專案,不會再次開瀏覽器。
20
- - 需要換帳號/授權專案:明確執行 auth logout --server <origin>,再 connect;在瀏覽器選新專案。這會影響此使用者在同網站的其他本機專案登入狀態。
21
- - 新目的地與既有綁定不同:核對後加 --replace;它不會忽略未完成發布或併發修改。
22
- - 授權完成但本機寫入失敗:綁定沒有被偷偷重設,已保存的授權可供重跑 connect 使用。
15
+ 在本機開發環境使用 --server http://127.0.0.1:5173,與 Web 登入的 origin 一致。綁定存於 .supekku/project.json,包含 repositoryId、網站/專案識別與非機密 credentialId(schemaVersion 2),沒有 token。憑證留在系統儲存庫。
16
+
17
+ 後續在同一資料夾或子目錄執行 supekku connect,可沿用網站地址及有效授權;已正確綁定會回報 changed=false。從 Git 取得綁定的同事仍需個別授權。project.json 是本機連接設定,不應將重新授權造成的 credentialId 變更當成團隊共用設定覆蓋;若專案追蹤此檔,需自行管理這類變更,拉取其他 credentialId 後可能需要重新授權。connect 只連接,不發布 Artifact;既有發布流程保持明確授權。
18
+
19
+ - 每個本機 checkout 的授權獨立保存。同網站的其他專案已登入,也不會被自動套用。
20
+ - 新專案首次 connect 會開啟瀏覽器選 Web 專案;已有綁定時,重新授權必須選回原專案。
21
+ - 要換 Web 專案或帳號:執行 `supekku connect --project <path> --replace`;換網站再加 `--server <origin>`。成功驗證後才替換,取消或失敗保留原連接。
22
+ - 改綁成功不會自動撤銷舊裝置 grant;不再使用的授權可在 Web「已授權裝置」明確撤銷。
23
+ - 改綁不搬移或刪除舊 Web Artifact;新目的地會重新查詢自己的映射。未完成的發布必須先處理,不能改送其他專案。
24
+ - 授權完成但綁定寫入失敗:會嘗試撤銷新候選授權;舊授權不受影響。程序中斷或清理結果未知時,可到 Web「已授權裝置」檢查未使用的裝置,再重跑 connect。若寫入結果未知,先讀取 project status,不假設失敗代表未寫入。
25
+ - 舊 schemaVersion 1 綁定仍可讀取,但需重新 connect 授權一次升級。舊共用 Keychain token 不會被複製、更新或撤銷,可自行在 Web 撤銷舊裝置。
26
+ - 授權包含本機實際目錄身分;移動或複製 checkout 後需重新 connect,不會因複製 project.json 取得原目錄的授權。舊版 CLI 不支援 schemaVersion 2。
23
27
  - --json:stdout 是單一結果 envelope,授權/瀏覽器事件寫到 stderr,不輸出 token。
24
28
 
25
- 進階命令仍可使用:
29
+ `auth login` 現在依目前專案執行連接;`project link` 僅能驗證既有專屬授權,改選目的地請使用 `connect --replace`。進階命令:
26
30
 
27
31
  ```sh
28
- supekku auth login --server https://your-server.example --device-name "My computer"
29
- supekku auth whoami --server https://your-server.example --json
32
+ supekku auth login --server https://your-server.example --project /path/to/repository --device-name "My computer"
33
+ supekku auth whoami --server https://your-server.example --project /path/to/repository --json
30
34
  supekku project link --server https://your-server.example --project-id <Web授權專案UUID> --project /path/to/repository
31
35
  supekku project status --project /path/to/repository --json
32
36
  ```
33
37
 
34
38
  依 [Agent 約定](agent-artifacts.md) 產生 Artifact,再以 check 的 revisionId 發布。回應含 Web 固定版本 URL、artifactId、versionId、sourceRevisionHash 與 operationId。若連線中斷,不要猜成功或失敗;執行 `artifact publish-status <operationId>` 或 `artifact publish-resume <operationId>`。本機 intent 先保存再開始上傳,並在 stderr 輸出 `publication_prepared` 事件及 operationId(stdout 仍只有最終結果);恢復重新驗證原綁定與原版本。
35
39
 
36
- Access token 有效期 15 分鐘,CLI 自動使用輪替 refresh token;grant 最長 30 天。refresh 回應遺失、憑證儲存失敗或授權遭撤銷時,需重新 `auth login`。Google session 到期與 CLI token 到期是不同事件。登出:`auth logout --server <origin>`;離線時會清除本機憑證並提示遠端撤銷未確認,可到 Web 帳號選單的「已授權裝置」撤銷。
40
+ Access token 有效期 15 分鐘,CLI 自動使用輪替 refresh token;grant 最長 30 天。refresh 回應遺失、憑證儲存失敗或授權遭撤銷時,需重新 `auth login`。Google session 到期與 CLI token 到期是不同事件。登出目前專案:`auth logout --server <origin> --project <path>`;離線時會清除本機憑證並提示遠端撤銷未確認,可到 Web 帳號選單的「已授權裝置」撤銷。
37
41
 
38
42
  服務端 migration 新增 OAuth、grant 與 publication 表,需由使用者依既有 1Password 流程明確執行。舊本機 Artifact 日誌執行 `artifact store upgrade --project <path>`,會先備份,不做自動降版。正式 Markdown 不由此流程改寫。
39
43
 
@@ -48,12 +52,12 @@ HTML 使用獨立來源的既有隔離預覽,且須啟用既有互動政策;
48
52
  先執行新版 API migration(0018),再啟動新版 API/Web。裝置新增 feedback:read 權限,授權頁會說明評論與原文上下文讀取。既有裝置不會因 migration 或 token refresh 取得新權限;需要使用者執行:
49
53
 
50
54
  ```sh
51
- supekku auth logout --server <Web-origin>
55
+ supekku auth logout --server <Web-origin> --project <path>
52
56
  supekku connect --project <path>
53
57
  supekku artifact feedback list <id> --remote --project <path> --json
54
58
  ```
55
59
 
56
- logout 保留 project.json 與本機 Artifact,但會撤銷目前同 origin 裝置授權。若既有 token 已到期而 connect 要求重新授權,也會顯示新增讀取能力。此權限只新增評論讀取,沒有回覆/刪除/標記已處理。
60
+ logout 保留 project.json 與本機 Artifact,只撤銷所選本機專案的裝置授權,不影響其他 checkout。若既有 token 已到期而 connect 要求重新授權,也會顯示新增讀取能力。此權限只新增評論讀取,沒有回覆/刪除/標記已處理。
57
61
 
58
62
  list 以評論為單位分頁,每筆包含 thread 與 comment;僅讀取所選獨立 Document 版本。show <id> <threadId> --remote --version <versionId> 回傳該串分頁與原始 snapshot。預設版本是最新發布;--after 必須搭配 --version。新一輪讀取從第一頁開始,以取得現有評論的編輯/刪除狀態。詳見 Agent 約定的讀取步驟。Artboard/HTML/Image 回 UNSUPPORTED_ARTIFACT,不會讀取畫布內文件副本原本的評論。
59
63
 
@@ -1,5 +1,5 @@
1
1
  import { t as CoreError } from "./src-CRhxwFAN.mjs";
2
- import { n as isCliIdentity } from "./api-D-iVy-AK.mjs";
2
+ import { n as isCliIdentity } from "./api-DNK2unOM.mjs";
3
3
  import { setTimeout } from "node:timers/promises";
4
4
  // ../../packages/contracts/src/limits.ts
5
5
  /** Retry-After is untrusted metadata, never a reason to automatically repeat a request. */
@@ -0,0 +1 @@
1
+ export { t as doctor } from "./doctor-CiotyxFb.mjs";
@@ -1,7 +1,7 @@
1
1
  import { t as CoreError } from "./src-CRhxwFAN.mjs";
2
- import { n as directoryPresence, o as projectObservation } from "./project-CdWOw1Ab.mjs";
2
+ import { n as directoryPresence, s as projectObservation } from "./project-BXsAoMV1.mjs";
3
3
  import { t as nodeSupported } from "./package-Ci4aNmkW.mjs";
4
- import { i as targetPath, r as skillStatus } from "./skills-BmMLLF83.mjs";
4
+ import { a as targetPath, i as skillStatus } from "./skills-DcxDoyH7.mjs";
5
5
  import { join } from "node:path";
6
6
  import { lstat } from "node:fs/promises";
7
7
  // src/onboarding/doctor.ts
@@ -67,4 +67,4 @@ async function doctor(start, target, identity, nodeVersion = process.versions.no
67
67
  next
68
68
  };
69
69
  }
70
- export { doctor };
70
+ export { doctor as t };
@@ -1,12 +1,11 @@
1
1
  import { t as CoreError } from "./src-CRhxwFAN.mjs";
2
- import { i as resolveFeedback, n as listFeedback, r as replyFeedback } from "./feedback-DA-v75O7.mjs";
2
+ import { i as resolveFeedback, n as listFeedback, r as replyFeedback } from "./feedback-CQ9Ymv6J.mjs";
3
3
  // src/commands/artifact/feedback.ts
4
4
  async function feedback(root, args) {
5
5
  if (args.includes("--remote")) {
6
- const { readRemoteFeedback } = await import("./feedback-C2zx-BMA.mjs");
7
- const { createConnection } = await import("./connection-BXfXx-wo.mjs");
8
- const { credentials } = await import("./credentials-CxkhjmnO.mjs");
9
- return readRemoteFeedback(root, args, createConnection({ store: credentials }));
6
+ const { readRemoteFeedback } = await import("./feedback-Dh0v9BIr.mjs");
7
+ const { boundConnection } = await import("./project-connection-09JC8T7M.mjs");
8
+ return readRemoteFeedback(root, args, await boundConnection(root));
10
9
  }
11
10
  const [action, id, ...rest] = args;
12
11
  const positional = [];
@@ -1,6 +1,6 @@
1
1
  import { t as CoreError } from "./src-CRhxwFAN.mjs";
2
2
  import { a as artifactId, l as manifestBoards } from "./artifact-local-Bfy69a9H.mjs";
3
- import { n as getRevision } from "./revisions-CZyZmV7P.mjs";
3
+ import { n as getRevision } from "./revisions-BuCkMiDb.mjs";
4
4
  import { a as withStore } from "./store-jFj2Dhgl.mjs";
5
5
  import { randomUUID } from "node:crypto";
6
6
  // src/local/artifacts/feedback.ts
@@ -1,7 +1,7 @@
1
1
  import { l as Check, n as Hash, r as SnapshotSchema, t as CoreError, u as Type } from "./src-CRhxwFAN.mjs";
2
2
  import { a as artifactId, r as LocalId } from "./artifact-local-Bfy69a9H.mjs";
3
- import { t as Uuid } from "./api-D-iVy-AK.mjs";
4
- import { r as readBinding } from "./project-Djy7qwQy.mjs";
3
+ import { t as Uuid } from "./api-DNK2unOM.mjs";
4
+ import { i as readBinding } from "./project-Dq2SpWN5.mjs";
5
5
  // ../../packages/contracts/src/collaboration.ts
6
6
  const object = (properties) => Type.Object(properties, { additionalProperties: false });
7
7
  const text = (maxLength) => Type.String({