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.2",
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
- - Make the smallest change that increases observability. Avoid speculative fixes.
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.