debugsk 0.0.2 → 0.0.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.
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "debugsk",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.3",
|
|
4
4
|
"description": "Debug investigation CLI: server + Codex skill management for hypothesis-driven workflows.",
|
|
5
5
|
"bin": {
|
|
6
6
|
"debugsk": "dist/cli.js"
|
|
@@ -11,6 +11,15 @@
|
|
|
11
11
|
"dist",
|
|
12
12
|
"skills"
|
|
13
13
|
],
|
|
14
|
+
"scripts": {
|
|
15
|
+
"build": "tsup",
|
|
16
|
+
"dev": "tsup --watch",
|
|
17
|
+
"typecheck": "tsc --noEmit",
|
|
18
|
+
"lint": "eslint .",
|
|
19
|
+
"format": "prettier --check .",
|
|
20
|
+
"format:write": "prettier --write .",
|
|
21
|
+
"test": "vitest run"
|
|
22
|
+
},
|
|
14
23
|
"engines": {
|
|
15
24
|
"node": ">=18"
|
|
16
25
|
},
|
|
@@ -33,14 +42,5 @@
|
|
|
33
42
|
"tsx": "^4.19.2",
|
|
34
43
|
"typescript": "^5.6.3",
|
|
35
44
|
"vitest": "^3.0.4"
|
|
36
|
-
},
|
|
37
|
-
"scripts": {
|
|
38
|
-
"build": "tsup",
|
|
39
|
-
"dev": "tsup --watch",
|
|
40
|
-
"typecheck": "tsc --noEmit",
|
|
41
|
-
"lint": "eslint .",
|
|
42
|
-
"format": "prettier --check .",
|
|
43
|
-
"format:write": "prettier --write .",
|
|
44
|
-
"test": "vitest run"
|
|
45
45
|
}
|
|
46
|
-
}
|
|
46
|
+
}
|
|
@@ -14,7 +14,9 @@ description: Standardized, hypothesis-driven debug investigation workflow for un
|
|
|
14
14
|
- required instrumentation (what to measure or log).
|
|
15
15
|
- Prefer decisive signals over narratives. Do not ask for reproduction without a plan to capture evidence.
|
|
16
16
|
- Narrow with comparisons (fail vs pass) and a binary-search style approach when possible.
|
|
17
|
-
-
|
|
17
|
+
- Add debug instrumentation generously to capture decisive signals in a single reproduction run.
|
|
18
|
+
- Assume each reproduction is costly; instrument enough to narrow root cause without requiring additional runs.
|
|
19
|
+
- Never fix code speculatively. Confirm root cause with evidence before any production code change.
|
|
18
20
|
|
|
19
21
|
## Tool selection (what to use)
|
|
20
22
|
- Primary tool for new instrumentation: local HTTP ingest logger.
|
|
@@ -66,6 +68,7 @@ description: Standardized, hypothesis-driven debug investigation workflow for un
|
|
|
66
68
|
## User interaction rules
|
|
67
69
|
- When reproduction is required, provide exact steps, expected signals, and required artifacts.
|
|
68
70
|
- If reproduction is not possible, pivot to existing logs, metrics, traces, config diffs, or safe probes.
|
|
71
|
+
- After embedding debug code, explicitly ask the user whether to use a tunneling setup (e.g., ngrok/Cloudflare Tunnel) for external or mobile access; do not assume.
|
|
69
72
|
|
|
70
73
|
## Cleanup policy
|
|
71
74
|
- When the user confirms the issue is resolved or the investigation is closed, stop the debug server and delete all investigation logs (e.g., `.logs/`).
|
|
@@ -73,7 +76,7 @@ description: Standardized, hypothesis-driven debug investigation workflow for un
|
|
|
73
76
|
- If deletion could affect unrelated files, confirm the exact paths before removal.
|
|
74
77
|
|
|
75
78
|
## Reporting format
|
|
76
|
-
Use the template in `assets/report-template.md`.
|
|
79
|
+
Use the template in `assets/report-template.md`. Headings are bilingual (English / Japanese); write content in the user's language.
|
|
77
80
|
|
|
78
81
|
## References
|
|
79
82
|
- Use `references/logging-schema.md` when adding or validating instrumentation.
|
|
@@ -1,19 +1,19 @@
|
|
|
1
|
-
# Investigation Summary
|
|
2
|
-
- Impact
|
|
3
|
-
- Confidence
|
|
1
|
+
# Investigation Summary / 調査概要
|
|
2
|
+
- Impact / 影響:
|
|
3
|
+
- Confidence / 確信度:
|
|
4
4
|
|
|
5
|
-
# Facts (observed)
|
|
5
|
+
# Facts (observed) / 事実(観測結果)
|
|
6
6
|
|
|
7
|
-
# Hypotheses
|
|
7
|
+
# Hypotheses / 仮説
|
|
8
8
|
|
|
9
|
-
# Instrumentation Plan
|
|
9
|
+
# Instrumentation Plan / 計装計画
|
|
10
10
|
|
|
11
|
-
# Reproduction Checklist
|
|
11
|
+
# Reproduction Checklist / 再現手順
|
|
12
12
|
|
|
13
|
-
# Findings (log-backed)
|
|
13
|
+
# Findings (log-backed) / 発見事項(ログ根拠あり)
|
|
14
14
|
|
|
15
|
-
# Root Cause (if confirmed)
|
|
15
|
+
# Root Cause (if confirmed) / 根本原因(確定時)
|
|
16
16
|
|
|
17
|
-
# Next Actions (if not confirmed)
|
|
17
|
+
# Next Actions (if not confirmed) / 次のアクション(未確定時)
|
|
18
18
|
|
|
19
|
-
# Fix Plan + Tests
|
|
19
|
+
# Fix Plan + Tests / 修正計画 + テスト
|
package/LICENSE
DELETED
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2025 OSS Contributors
|
|
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.
|