okstra 0.20.1 → 0.21.1

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 (41) hide show
  1. package/README.kr.md +2 -2
  2. package/README.md +2 -2
  3. package/docs/kr/architecture.md +1 -0
  4. package/docs/kr/cli.md +1 -1
  5. package/docs/kr/performance-improvement-plan-v2.md +330 -0
  6. package/docs/kr/performance-improvement-plan.md +125 -0
  7. package/docs/project-structure-overview.md +388 -0
  8. package/docs/superpowers/plans/2026-05-14-convergence-queue-pruning.md +1568 -0
  9. package/package.json +1 -1
  10. package/runtime/BUILD.json +2 -2
  11. package/runtime/agents/SKILL.md +7 -1
  12. package/runtime/agents/workers/claude-worker.md +3 -1
  13. package/runtime/agents/workers/report-writer-worker.md +4 -0
  14. package/runtime/bin/okstra-codex-exec.sh +42 -0
  15. package/runtime/bin/okstra-gemini-exec.sh +7 -0
  16. package/runtime/bin/okstra-trace-cleanup.sh +42 -0
  17. package/runtime/prompts/profiles/final-verification.md +8 -2
  18. package/runtime/prompts/profiles/implementation-planning.md +1 -1
  19. package/runtime/prompts/profiles/release-handoff.md +26 -28
  20. package/runtime/prompts/profiles/requirements-discovery.md +1 -1
  21. package/runtime/python/okstra_ctl/render.py +78 -4
  22. package/runtime/python/okstra_ctl/run_context.py +5 -0
  23. package/runtime/python/okstra_ctl/workflow.py +8 -7
  24. package/runtime/python/okstra_ctl/worktree.py +155 -12
  25. package/runtime/skills/okstra-brief/SKILL.md +523 -0
  26. package/runtime/skills/okstra-convergence/SKILL.md +149 -37
  27. package/runtime/skills/okstra-report-writer/SKILL.md +8 -6
  28. package/runtime/templates/prd/brief.template.md +12 -0
  29. package/runtime/templates/project-docs/task-index.template.md +12 -0
  30. package/runtime/templates/reports/error-analysis-input.template.md +12 -0
  31. package/runtime/templates/reports/final-report.template.md +39 -12
  32. package/runtime/templates/reports/final-verification-input.template.md +22 -0
  33. package/runtime/templates/reports/implementation-input.template.md +12 -0
  34. package/runtime/templates/reports/implementation-planning-input.template.md +12 -0
  35. package/runtime/templates/reports/quick-input.template.md +12 -0
  36. package/runtime/templates/reports/release-handoff-input.template.md +23 -10
  37. package/runtime/templates/reports/schedule.template.md +12 -0
  38. package/runtime/templates/reports/settings.template.json +92 -30
  39. package/runtime/templates/reports/task-brief.template.md +12 -0
  40. package/src/install.mjs +1 -0
  41. package/src/uninstall.mjs +1 -0
package/runtime/templates/reports/schedule.template.md CHANGED
@@ -1,3 +1,15 @@
1
+ ---
2
+ title: OKSTRA Schedule - {{TASK_KEY}}
3
+ id: {{FM_ID}}
4
+ tags: {{FM_TAGS}}
5
+ status: new
6
+ aliases: {{FM_ALIASES}}
7
+ date: {{TASK_DATE}}
8
+ task-id: "{{TASK_ID}}"
9
+ task-group: "{{TASK_GROUP}}"
10
+ project-id: "{{PROJECT_ID}}"
11
+ ---
12
+
1
13
  # <Title> — Work Schedule
2
14
 
3
15
  > Generated: <YYYY-MM-DD HH:MM> | Project: <project-id> | Task Group: <task-group>
package/runtime/templates/reports/settings.template.json CHANGED
@@ -14,81 +14,143 @@
14
14
  "WebFetch",
15
15
  "WebSearch",
16
16
  "TodoWrite",
17
- "Bash(git:*)",
18
- "Bash(gh:*)",
17
+
18
+ "Bash(pwd)",
19
+ "Bash(cd)",
20
+ "Bash(cd:*)",
21
+
22
+ "Bash(ls)",
19
23
  "Bash(ls:*)",
20
24
  "Bash(cat:*)",
21
25
  "Bash(head:*)",
22
26
  "Bash(tail:*)",
23
27
  "Bash(wc:*)",
24
- "Bash(jq:*)",
25
- "Bash(yq:*)",
28
+
29
+ "Bash(git)",
30
+ "Bash(git:*)",
31
+ "Bash(gh)",
32
+ "Bash(gh:*)",
33
+
26
34
  "Bash(rg:*)",
27
35
  "Bash(grep:*)",
28
36
  "Bash(find:*)",
29
- "Bash(mkdir:*)",
30
- "Bash(cp:*)",
31
- "Bash(mv:*)",
32
- "Bash(rm:*)",
33
37
  "Bash(diff:*)",
38
+
39
+ "Bash(jq:*)",
40
+ "Bash(yq:*)",
34
41
  "Bash(awk:*)",
35
42
  "Bash(sed:*)",
36
43
  "Bash(tr:*)",
37
44
  "Bash(sort:*)",
38
45
  "Bash(uniq:*)",
39
46
  "Bash(xargs:*)",
40
- "Bash(python3:*)",
41
- "Bash(python:*)",
42
- "Bash(pip3:*)",
43
- "Bash(pip:*)",
44
- "Bash(uv:*)",
45
- "Bash(poetry:*)",
46
- "Bash(pytest:*)",
47
- "Bash(bash:*)",
48
- "Bash(sh:*)",
49
- "Bash(eval:*)",
50
- "Bash(cd:*)",
47
+
48
+ "Bash(mkdir:*)",
49
+ "Bash(cp:*)",
50
+ "Bash(mv:*)",
51
+ "Bash(rm:*)",
52
+ "Bash(chmod:*)",
53
+
51
54
  "Bash(printf:*)",
55
+ "Bash(echo)",
52
56
  "Bash(echo:*)",
53
57
  "Bash(export:*)",
58
+ "Bash(env)",
54
59
  "Bash(env:*)",
55
60
  "Bash(test:*)",
56
- "Bash(true:*)",
57
- "Bash(false:*)",
58
61
  "Bash(true)",
62
+ "Bash(true:*)",
59
63
  "Bash(false)",
60
- "Bash(codex:*)",
61
- "Bash(codex exec:*)",
62
- "Bash(okstra:*)",
63
- "Bash($HOME/.okstra/bin/okstra-codex-exec.sh:*)",
64
- "Bash(gemini:*)",
65
- "Bash($HOME/.okstra/bin/okstra-gemini-exec.sh:*)",
66
- "Bash(claude:*)",
67
- "Bash(chmod:*)",
64
+ "Bash(false:*)",
65
+
66
+ "Bash(bash:*)",
67
+ "Bash(sh:*)",
68
+ "Bash(eval:*)",
69
+
70
+ "Bash(python)",
71
+ "Bash(python:*)",
72
+ "Bash(python3)",
73
+ "Bash(python3:*)",
74
+ "Bash(pip)",
75
+ "Bash(pip:*)",
76
+ "Bash(pip3)",
77
+ "Bash(pip3:*)",
78
+ "Bash(uv:*)",
79
+ "Bash(poetry:*)",
80
+ "Bash(pytest:*)",
81
+
82
+ "Bash(node)",
68
83
  "Bash(node:*)",
84
+ "Bash(npm)",
69
85
  "Bash(npm:*)",
86
+ "Bash(npx)",
70
87
  "Bash(npx:*)",
88
+ "Bash(pnpm)",
71
89
  "Bash(pnpm:*)",
90
+ "Bash(yarn)",
72
91
  "Bash(yarn:*)",
92
+ "Bash(tsc)",
73
93
  "Bash(tsc:*)",
74
- "Bash(go:*)",
94
+
95
+ "Bash(cargo)",
75
96
  "Bash(cargo:*)",
97
+ "Bash(rustc)",
76
98
  "Bash(rustc:*)",
99
+
100
+ "Bash(go)",
101
+ "Bash(go:*)",
102
+ "Bash(java)",
77
103
  "Bash(java:*)",
104
+ "Bash(javac)",
78
105
  "Bash(javac:*)",
106
+ "Bash(mvn)",
79
107
  "Bash(mvn:*)",
108
+ "Bash(gradle)",
80
109
  "Bash(gradle:*)",
110
+ "Bash(./gradlew)",
81
111
  "Bash(./gradlew:*)",
112
+ "Bash(make)",
82
113
  "Bash(make:*)",
114
+
115
+ "Bash(docker)",
83
116
  "Bash(docker:*)",
117
+ "Bash(docker compose)",
84
118
  "Bash(docker compose:*)",
119
+ "Bash(docker-compose)",
85
120
  "Bash(docker-compose:*)",
121
+ "Bash(kubectl)",
86
122
  "Bash(kubectl:*)",
123
+ "Bash(helm)",
87
124
  "Bash(helm:*)",
125
+
88
126
  "Bash(curl:*)",
89
127
  "Bash(wget:*)",
128
+
129
+ "Bash(codex)",
130
+ "Bash(codex:*)",
131
+ "Bash(codex exec:*)",
132
+ "Bash(okstra)",
133
+ "Bash(okstra:*)",
134
+ "Bash($HOME/.okstra/bin/okstra-codex-exec.sh:*)",
135
+
136
+ "Bash(gemini)",
137
+ "Bash(gemini:*)",
138
+ "Bash($HOME/.okstra/bin/okstra-gemini-exec.sh:*)",
139
+
140
+ "Bash(claude)",
141
+ "Bash(claude:*)",
142
+
90
143
  "mcp__test-context7__resolve-library-id",
91
144
  "mcp__test-context7__query-docs"
92
145
  ]
146
+ },
147
+ "hooks": {
148
+ "SessionEnd": [
149
+ {
150
+ "hooks": [
151
+ { "type": "command", "command": "$HOME/.okstra/bin/okstra-trace-cleanup.sh" }
152
+ ]
153
+ }
154
+ ]
93
155
  }
94
156
  }
package/runtime/templates/reports/task-brief.template.md CHANGED
@@ -1,3 +1,15 @@
1
+ ---
2
+ title: OKSTRA Task Brief - {{TASK_KEY}}
3
+ id: {{FM_ID}}
4
+ tags: {{FM_TAGS}}
5
+ status: new
6
+ aliases: {{FM_ALIASES}}
7
+ date: {{TASK_DATE}}
8
+ task-id: "{{TASK_ID}}"
9
+ task-group: "{{TASK_GROUP}}"
10
+ project-id: "{{PROJECT_ID}}"
11
+ ---
12
+
1
13
  # OKSTRA Task Brief
2
14
 
3
15
  ## Identity
package/src/install.mjs CHANGED
@@ -20,6 +20,7 @@ const BIN_ENTRYPOINTS = [
20
20
  "okstra.sh",
21
21
  "okstra-codex-exec.sh",
22
22
  "okstra-gemini-exec.sh",
23
+ "okstra-trace-cleanup.sh",
23
24
  "okstra-central.sh",
24
25
  "okstra-token-usage.py",
25
26
  "okstra-error-log.py",
package/src/uninstall.mjs CHANGED
@@ -7,6 +7,7 @@ const BIN_ENTRYPOINTS = [
7
7
  "okstra.sh",
8
8
  "okstra-codex-exec.sh",
9
9
  "okstra-gemini-exec.sh",
10
+ "okstra-trace-cleanup.sh",
10
11
  "okstra-central.sh",
11
12
  "okstra-token-usage.py",
12
13
  "okstra-error-log.py",