javi-forge 0.1.0 → 1.0.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/.releaserc +2 -1
- package/README.md +143 -31
- package/ai-config/commands/workflows/diagnose.md +70 -0
- package/ai-config/commands/workflows/discover.md +86 -0
- package/dist/commands/doctor.js +24 -1
- package/dist/commands/init.js +48 -1
- package/dist/commands/llmstxt.d.ts +9 -0
- package/dist/commands/llmstxt.js +93 -0
- package/dist/commands/llmstxt.test.d.ts +2 -0
- package/dist/commands/plugin.d.ts +24 -0
- package/dist/commands/plugin.js +78 -0
- package/dist/commands/plugin.test.d.ts +2 -0
- package/dist/constants.d.ts +8 -0
- package/dist/constants.js +8 -0
- package/dist/index.js +33 -4
- package/dist/lib/plugin.d.ts +39 -0
- package/dist/lib/plugin.js +228 -0
- package/dist/lib/plugin.test.d.ts +2 -0
- package/dist/types/index.d.ts +42 -0
- package/dist/ui/App.d.ts +2 -1
- package/dist/ui/App.js +2 -1
- package/dist/ui/LlmsTxt.d.ts +8 -0
- package/dist/ui/LlmsTxt.js +48 -0
- package/dist/ui/Plugin.d.ts +9 -0
- package/dist/ui/Plugin.js +96 -0
- package/modules/obsidian-brain/README.md +32 -0
- package/modules/obsidian-brain/core/templates/braindump.md +15 -0
- package/modules/obsidian-brain/core/templates/consolidation.md +42 -0
- package/modules/obsidian-brain/core/templates/daily-note.md +18 -0
- package/modules/obsidian-brain/core/templates/resource-capture.md +14 -0
- package/modules/obsidian-brain/developer/templates/adr.md +40 -0
- package/modules/obsidian-brain/developer/templates/coding-session.md +24 -0
- package/modules/obsidian-brain/developer/templates/debug-journal.md +22 -0
- package/modules/obsidian-brain/developer/templates/sdd-feedback.md +27 -0
- package/modules/obsidian-brain/developer/templates/tech-debt.md +20 -0
- package/modules/obsidian-brain/pm-lead/templates/daily-brief.md +25 -0
- package/modules/obsidian-brain/pm-lead/templates/meeting-notes.md +24 -0
- package/modules/obsidian-brain/pm-lead/templates/risk-registry.md +12 -0
- package/modules/obsidian-brain/pm-lead/templates/sprint-review.md +27 -0
- package/modules/obsidian-brain/pm-lead/templates/stakeholder-update.md +24 -0
- package/modules/obsidian-brain/pm-lead/templates/team-intelligence.md +19 -0
- package/modules/obsidian-brain/pm-lead/templates/weekly-brief.md +29 -0
- package/package.json +1 -1
- package/schemas/plugin.schema.json +62 -0
- package/ai-config/skills/docs/api-documentation/SKILL.md +0 -293
- package/ai-config/skills/docs/docs-spring/SKILL.md +0 -377
- package/ai-config/skills/docs/mustache-templates/SKILL.md +0 -190
- package/ai-config/skills/docs/technical-docs/SKILL.md +0 -447
- package/dist/commands/analyze.d.ts.map +0 -1
- package/dist/commands/analyze.js.map +0 -1
- package/dist/commands/analyze.test.d.ts.map +0 -1
- package/dist/commands/analyze.test.js +0 -145
- package/dist/commands/analyze.test.js.map +0 -1
- package/dist/commands/doctor.d.ts.map +0 -1
- package/dist/commands/doctor.js.map +0 -1
- package/dist/commands/doctor.test.d.ts.map +0 -1
- package/dist/commands/doctor.test.js +0 -200
- package/dist/commands/doctor.test.js.map +0 -1
- package/dist/commands/init.d.ts.map +0 -1
- package/dist/commands/init.js.map +0 -1
- package/dist/commands/init.test.d.ts.map +0 -1
- package/dist/commands/init.test.js +0 -271
- package/dist/commands/init.test.js.map +0 -1
- package/dist/commands/sync.d.ts.map +0 -1
- package/dist/commands/sync.js.map +0 -1
- package/dist/constants.d.ts.map +0 -1
- package/dist/constants.js.map +0 -1
- package/dist/e2e/aggressive.e2e.test.d.ts.map +0 -1
- package/dist/e2e/aggressive.e2e.test.js +0 -350
- package/dist/e2e/aggressive.e2e.test.js.map +0 -1
- package/dist/e2e/commands.e2e.test.d.ts.map +0 -1
- package/dist/e2e/commands.e2e.test.js +0 -213
- package/dist/e2e/commands.e2e.test.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/lib/common.d.ts.map +0 -1
- package/dist/lib/common.js.map +0 -1
- package/dist/lib/common.test.d.ts.map +0 -1
- package/dist/lib/common.test.js +0 -316
- package/dist/lib/common.test.js.map +0 -1
- package/dist/lib/frontmatter.d.ts.map +0 -1
- package/dist/lib/frontmatter.js.map +0 -1
- package/dist/lib/frontmatter.test.d.ts.map +0 -1
- package/dist/lib/frontmatter.test.js +0 -257
- package/dist/lib/frontmatter.test.js.map +0 -1
- package/dist/lib/template.d.ts.map +0 -1
- package/dist/lib/template.js.map +0 -1
- package/dist/lib/template.test.d.ts.map +0 -1
- package/dist/lib/template.test.js +0 -201
- package/dist/lib/template.test.js.map +0 -1
- package/dist/types/index.d.ts.map +0 -1
- package/dist/types/index.js.map +0 -1
- package/dist/ui/AnalyzeUI.d.ts.map +0 -1
- package/dist/ui/AnalyzeUI.js.map +0 -1
- package/dist/ui/App.d.ts.map +0 -1
- package/dist/ui/App.js.map +0 -1
- package/dist/ui/CIContext.d.ts.map +0 -1
- package/dist/ui/CIContext.js.map +0 -1
- package/dist/ui/CISelector.d.ts.map +0 -1
- package/dist/ui/CISelector.js.map +0 -1
- package/dist/ui/Doctor.d.ts.map +0 -1
- package/dist/ui/Doctor.js.map +0 -1
- package/dist/ui/Header.d.ts.map +0 -1
- package/dist/ui/Header.js.map +0 -1
- package/dist/ui/MemorySelector.d.ts.map +0 -1
- package/dist/ui/MemorySelector.js.map +0 -1
- package/dist/ui/NameInput.d.ts.map +0 -1
- package/dist/ui/NameInput.js.map +0 -1
- package/dist/ui/OptionSelector.d.ts.map +0 -1
- package/dist/ui/OptionSelector.js.map +0 -1
- package/dist/ui/Progress.d.ts.map +0 -1
- package/dist/ui/Progress.js.map +0 -1
- package/dist/ui/StackSelector.d.ts.map +0 -1
- package/dist/ui/StackSelector.js.map +0 -1
- package/dist/ui/Summary.d.ts.map +0 -1
- package/dist/ui/Summary.js.map +0 -1
- package/dist/ui/SyncUI.d.ts.map +0 -1
- package/dist/ui/SyncUI.js.map +0 -1
- package/dist/ui/Welcome.d.ts.map +0 -1
- package/dist/ui/Welcome.js.map +0 -1
- package/dist/ui/theme.d.ts.map +0 -1
- package/dist/ui/theme.js.map +0 -1
- package/modules/obsidian-brain/.obsidian/plugins/dataview/data.json +0 -25
- package/modules/obsidian-brain/.obsidian/plugins/obsidian-kanban/data.json +0 -29
- package/modules/obsidian-brain/.obsidian/plugins/templater-obsidian/data.json +0 -18
- package/src/commands/analyze.test.ts +0 -145
- package/src/commands/analyze.ts +0 -69
- package/src/commands/doctor.test.ts +0 -208
- package/src/commands/doctor.ts +0 -163
- package/src/commands/init.test.ts +0 -298
- package/src/commands/init.ts +0 -285
- package/src/constants.ts +0 -69
- package/src/e2e/aggressive.e2e.test.ts +0 -557
- package/src/e2e/commands.e2e.test.ts +0 -298
- package/src/index.tsx +0 -106
- package/src/lib/common.test.ts +0 -318
- package/src/lib/common.ts +0 -127
- package/src/lib/frontmatter.test.ts +0 -291
- package/src/lib/frontmatter.ts +0 -77
- package/src/lib/template.test.ts +0 -226
- package/src/lib/template.ts +0 -99
- package/src/types/index.ts +0 -53
- package/src/ui/AnalyzeUI.tsx +0 -133
- package/src/ui/App.tsx +0 -175
- package/src/ui/CIContext.tsx +0 -25
- package/src/ui/CISelector.tsx +0 -72
- package/src/ui/Doctor.tsx +0 -122
- package/src/ui/Header.tsx +0 -48
- package/src/ui/MemorySelector.tsx +0 -73
- package/src/ui/NameInput.tsx +0 -82
- package/src/ui/OptionSelector.tsx +0 -100
- package/src/ui/Progress.tsx +0 -88
- package/src/ui/StackSelector.tsx +0 -101
- package/src/ui/Summary.tsx +0 -134
- package/src/ui/Welcome.tsx +0 -54
- package/src/ui/theme.ts +0 -10
- package/stryker.config.json +0 -19
- package/tsconfig.json +0 -19
- package/vitest.config.ts +0 -16
|
@@ -1,190 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: mustache-templates
|
|
3
|
-
description: >
|
|
4
|
-
Desarrollo de templates Mustache para generación de código. Sintaxis, contextos, partials.
|
|
5
|
-
Trigger: template mustache, .mustache, generación código, template context
|
|
6
|
-
tools:
|
|
7
|
-
- Read
|
|
8
|
-
- Write
|
|
9
|
-
- Edit
|
|
10
|
-
- Grep
|
|
11
|
-
- Glob
|
|
12
|
-
metadata:
|
|
13
|
-
author: apigen-team
|
|
14
|
-
version: "1.0"
|
|
15
|
-
tags: [mustache, templates, codegen]
|
|
16
|
-
scope: ["**/templates/**/*.mustache"]
|
|
17
|
-
---
|
|
18
|
-
|
|
19
|
-
# Mustache Templates
|
|
20
|
-
|
|
21
|
-
## Ubicación
|
|
22
|
-
|
|
23
|
-
```
|
|
24
|
-
apigen-codegen/src/main/resources/templates/
|
|
25
|
-
├── java/
|
|
26
|
-
├── kotlin/
|
|
27
|
-
├── csharp/
|
|
28
|
-
├── go-chi/
|
|
29
|
-
├── go-gin/
|
|
30
|
-
├── python-fastapi/
|
|
31
|
-
├── typescript-nestjs/
|
|
32
|
-
├── php-laravel/
|
|
33
|
-
└── rust-axum/
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
## Sintaxis Quick Reference
|
|
37
|
-
|
|
38
|
-
```mustache
|
|
39
|
-
{{! Comentario }}
|
|
40
|
-
{{variable}} {{! Variable }}
|
|
41
|
-
{{{rawHtml}}} {{! Sin escape }}
|
|
42
|
-
{{#section}}...{{/section}} {{! Si truthy }}
|
|
43
|
-
{{^section}}...{{/section}} {{! Si falsy }}
|
|
44
|
-
{{#list}}{{.}}{{/list}} {{! Iterar }}
|
|
45
|
-
{{> partial}} {{! Incluir }}
|
|
46
|
-
{{#-first}}...{{/-first}} {{! Primer item }}
|
|
47
|
-
{{#-last}}...{{/-last}} {{! Último item }}
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
## Patrones Comunes
|
|
51
|
-
|
|
52
|
-
### Imports Condicionales
|
|
53
|
-
|
|
54
|
-
```mustache
|
|
55
|
-
{{#hasValidation}}
|
|
56
|
-
import jakarta.validation.constraints.*;
|
|
57
|
-
{{/hasValidation}}
|
|
58
|
-
{{#hasJpa}}
|
|
59
|
-
import jakarta.persistence.*;
|
|
60
|
-
{{/hasJpa}}
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
### Lista con Separadores
|
|
64
|
-
|
|
65
|
-
```mustache
|
|
66
|
-
{{#columns}}
|
|
67
|
-
{{propertyName}}{{^-last}},{{/-last}}
|
|
68
|
-
{{/columns}}
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
### If-Else
|
|
72
|
-
|
|
73
|
-
```mustache
|
|
74
|
-
{{#nullable}}
|
|
75
|
-
Optional<{{type}}>
|
|
76
|
-
{{/nullable}}
|
|
77
|
-
{{^nullable}}
|
|
78
|
-
{{type}}
|
|
79
|
-
{{/nullable}}
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
### Default Value
|
|
83
|
-
|
|
84
|
-
```mustache
|
|
85
|
-
{{propertyName}}{{^propertyName}}defaultValue{{/propertyName}}
|
|
86
|
-
```
|
|
87
|
-
|
|
88
|
-
## Context Objects (Java)
|
|
89
|
-
|
|
90
|
-
```java
|
|
91
|
-
public class EntityTemplateContext {
|
|
92
|
-
String packageName;
|
|
93
|
-
String className;
|
|
94
|
-
String tableName;
|
|
95
|
-
List<ColumnContext> columns;
|
|
96
|
-
boolean hasAuditing;
|
|
97
|
-
boolean hasSoftDelete;
|
|
98
|
-
}
|
|
99
|
-
|
|
100
|
-
public class ColumnContext {
|
|
101
|
-
String columnName;
|
|
102
|
-
String propertyName;
|
|
103
|
-
String javaType;
|
|
104
|
-
boolean required;
|
|
105
|
-
boolean isId;
|
|
106
|
-
boolean isRelationship;
|
|
107
|
-
String relatedClassName;
|
|
108
|
-
}
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
## Template Ejemplo Completo
|
|
112
|
-
|
|
113
|
-
```mustache
|
|
114
|
-
package {{packageName}}.entity;
|
|
115
|
-
|
|
116
|
-
import jakarta.persistence.*;
|
|
117
|
-
{{#hasLombok}}
|
|
118
|
-
import lombok.*;
|
|
119
|
-
{{/hasLombok}}
|
|
120
|
-
{{#hasValidation}}
|
|
121
|
-
import jakarta.validation.constraints.*;
|
|
122
|
-
{{/hasValidation}}
|
|
123
|
-
{{#hasAuditing}}
|
|
124
|
-
import org.springframework.data.annotation.*;
|
|
125
|
-
{{/hasAuditing}}
|
|
126
|
-
|
|
127
|
-
@Entity
|
|
128
|
-
@Table(name = "{{tableName}}")
|
|
129
|
-
{{#hasLombok}}
|
|
130
|
-
@Data
|
|
131
|
-
@Builder
|
|
132
|
-
@NoArgsConstructor
|
|
133
|
-
@AllArgsConstructor
|
|
134
|
-
{{/hasLombok}}
|
|
135
|
-
public class {{className}} {
|
|
136
|
-
|
|
137
|
-
@Id
|
|
138
|
-
@GeneratedValue(strategy = GenerationType.{{idStrategy}})
|
|
139
|
-
private {{idType}} id;
|
|
140
|
-
|
|
141
|
-
{{#columns}}
|
|
142
|
-
{{^isId}}
|
|
143
|
-
{{#isRelationship}}
|
|
144
|
-
@ManyToOne(fetch = FetchType.LAZY)
|
|
145
|
-
@JoinColumn(name = "{{columnName}}")
|
|
146
|
-
private {{relatedClassName}} {{propertyName}};
|
|
147
|
-
{{/isRelationship}}
|
|
148
|
-
{{^isRelationship}}
|
|
149
|
-
@Column(name = "{{columnName}}"{{#required}}, nullable = false{{/required}})
|
|
150
|
-
private {{javaType}} {{propertyName}};
|
|
151
|
-
{{/isRelationship}}
|
|
152
|
-
|
|
153
|
-
{{/isId}}
|
|
154
|
-
{{/columns}}
|
|
155
|
-
{{#hasAuditing}}
|
|
156
|
-
@CreatedDate
|
|
157
|
-
private Instant createdAt;
|
|
158
|
-
|
|
159
|
-
@LastModifiedDate
|
|
160
|
-
private Instant updatedAt;
|
|
161
|
-
{{/hasAuditing}}
|
|
162
|
-
}
|
|
163
|
-
```
|
|
164
|
-
|
|
165
|
-
## Testing Templates
|
|
166
|
-
|
|
167
|
-
```java
|
|
168
|
-
@Test
|
|
169
|
-
void shouldRenderEntity() {
|
|
170
|
-
var context = new EntityTemplateContext();
|
|
171
|
-
context.setClassName("User");
|
|
172
|
-
context.setTableName("users");
|
|
173
|
-
context.setColumns(List.of(
|
|
174
|
-
column("name", "String", false)
|
|
175
|
-
));
|
|
176
|
-
|
|
177
|
-
String result = engine.render("java/entity.mustache", context);
|
|
178
|
-
|
|
179
|
-
assertThat(result)
|
|
180
|
-
.contains("public class User")
|
|
181
|
-
.contains("@Table(name = \"users\")")
|
|
182
|
-
.contains("private String name");
|
|
183
|
-
}
|
|
184
|
-
```
|
|
185
|
-
|
|
186
|
-
## Related Skills
|
|
187
|
-
|
|
188
|
-
- `codegen-patterns`: Patrones de generación
|
|
189
|
-
- `apigen-codegen-dev`: Desarrollo del módulo
|
|
190
|
-
|
|
@@ -1,447 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: technical-docs
|
|
3
|
-
description: >
|
|
4
|
-
Technical documentation writing including ADRs, API docs, runbooks, and README files with proper structure.
|
|
5
|
-
Trigger: documentation, ADR, architecture decision, API docs, runbook, README, technical writing
|
|
6
|
-
tools:
|
|
7
|
-
- Read
|
|
8
|
-
- Write
|
|
9
|
-
- Bash
|
|
10
|
-
- Grep
|
|
11
|
-
metadata:
|
|
12
|
-
author: plataforma-industrial
|
|
13
|
-
version: "2.0"
|
|
14
|
-
tags: [documentation, adr, api-docs, technical-writing]
|
|
15
|
-
updated: "2026-02"
|
|
16
|
-
---
|
|
17
|
-
|
|
18
|
-
# Technical Documentation
|
|
19
|
-
|
|
20
|
-
## Documentation Structure
|
|
21
|
-
|
|
22
|
-
```
|
|
23
|
-
docs/
|
|
24
|
-
├── architecture/
|
|
25
|
-
│ ├── ADR/ # Architecture Decision Records
|
|
26
|
-
│ │ ├── 001-monorepo.md
|
|
27
|
-
│ │ └── template.md
|
|
28
|
-
│ ├── C4/ # C4 Diagrams
|
|
29
|
-
│ └── overview.md
|
|
30
|
-
├── api/
|
|
31
|
-
│ ├── openapi/
|
|
32
|
-
│ └── endpoints.md
|
|
33
|
-
├── guides/
|
|
34
|
-
│ ├── getting-started.md
|
|
35
|
-
│ ├── development.md
|
|
36
|
-
│ └── deployment.md
|
|
37
|
-
├── runbooks/
|
|
38
|
-
│ ├── incident-response.md
|
|
39
|
-
│ └── database-backup.md
|
|
40
|
-
└── README.md
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
## Architecture Decision Records (ADR)
|
|
44
|
-
|
|
45
|
-
### Template
|
|
46
|
-
|
|
47
|
-
```markdown
|
|
48
|
-
# ADR-XXX: [Concise Title]
|
|
49
|
-
|
|
50
|
-
**Status**: Proposed | Accepted | Rejected | Deprecated | Supersedes ADR-XXX
|
|
51
|
-
**Date**: YYYY-MM-DD
|
|
52
|
-
**Authors**: @username
|
|
53
|
-
|
|
54
|
-
## Context
|
|
55
|
-
|
|
56
|
-
[Describe the problem or situation requiring a decision.
|
|
57
|
-
Include technical, business, or time constraints.]
|
|
58
|
-
|
|
59
|
-
## Decision
|
|
60
|
-
|
|
61
|
-
[Describe the decision clearly and directly.
|
|
62
|
-
Use active voice: "We will use X" not "X will be used".]
|
|
63
|
-
|
|
64
|
-
## Consequences
|
|
65
|
-
|
|
66
|
-
### Positive
|
|
67
|
-
- [Benefit 1]
|
|
68
|
-
- [Benefit 2]
|
|
69
|
-
|
|
70
|
-
### Negative
|
|
71
|
-
- [Trade-off 1]
|
|
72
|
-
- [Trade-off 2]
|
|
73
|
-
|
|
74
|
-
### Risks
|
|
75
|
-
- [Risk and mitigation]
|
|
76
|
-
|
|
77
|
-
## Alternatives Considered
|
|
78
|
-
|
|
79
|
-
### Alternative A: [Name]
|
|
80
|
-
- **Pros**: ...
|
|
81
|
-
- **Cons**: ...
|
|
82
|
-
- **Why not**: ...
|
|
83
|
-
|
|
84
|
-
## References
|
|
85
|
-
|
|
86
|
-
- [Relevant documentation link]
|
|
87
|
-
- [Related issue or discussion]
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
### Example ADR
|
|
91
|
-
|
|
92
|
-
```markdown
|
|
93
|
-
# ADR-002: Rust for Edge Components
|
|
94
|
-
|
|
95
|
-
**Status**: Accepted
|
|
96
|
-
**Date**: 2024-01-15
|
|
97
|
-
**Authors**: @developer
|
|
98
|
-
|
|
99
|
-
## Context
|
|
100
|
-
|
|
101
|
-
Edge components require:
|
|
102
|
-
- Predictable latency (<10ms)
|
|
103
|
-
- Minimal memory usage (<50MB)
|
|
104
|
-
- High reliability (24/7 operation)
|
|
105
|
-
|
|
106
|
-
## Decision
|
|
107
|
-
|
|
108
|
-
We will use **Rust** for edge-gateway and edge-anomaly components.
|
|
109
|
-
|
|
110
|
-
## Consequences
|
|
111
|
-
|
|
112
|
-
### Positive
|
|
113
|
-
- Predictable latency without GC pauses
|
|
114
|
-
- Memory safety without runtime overhead
|
|
115
|
-
- Small, standalone binaries
|
|
116
|
-
|
|
117
|
-
### Negative
|
|
118
|
-
- Steeper learning curve
|
|
119
|
-
- Slower compilation than Go
|
|
120
|
-
|
|
121
|
-
## Alternatives Considered
|
|
122
|
-
|
|
123
|
-
### Go for all Edge
|
|
124
|
-
- **Pros**: Single language, more developers
|
|
125
|
-
- **Cons**: Unpredictable GC pauses
|
|
126
|
-
- **Why not**: Doesn't meet latency requirements
|
|
127
|
-
```
|
|
128
|
-
|
|
129
|
-
## API Documentation
|
|
130
|
-
|
|
131
|
-
### OpenAPI Example
|
|
132
|
-
|
|
133
|
-
```yaml
|
|
134
|
-
openapi: 3.0.3
|
|
135
|
-
info:
|
|
136
|
-
title: API Name
|
|
137
|
-
description: |
|
|
138
|
-
API description.
|
|
139
|
-
|
|
140
|
-
## Authentication
|
|
141
|
-
Requires `Authorization: Bearer <token>` header.
|
|
142
|
-
|
|
143
|
-
## Rate Limiting
|
|
144
|
-
- 100 requests/minute per IP
|
|
145
|
-
version: 1.0.0
|
|
146
|
-
|
|
147
|
-
servers:
|
|
148
|
-
- url: https://api.example.com/v1
|
|
149
|
-
description: Production
|
|
150
|
-
|
|
151
|
-
paths:
|
|
152
|
-
/items:
|
|
153
|
-
get:
|
|
154
|
-
summary: List items
|
|
155
|
-
tags: [items]
|
|
156
|
-
security:
|
|
157
|
-
- bearerAuth: []
|
|
158
|
-
parameters:
|
|
159
|
-
- name: status
|
|
160
|
-
in: query
|
|
161
|
-
schema:
|
|
162
|
-
type: string
|
|
163
|
-
enum: [active, inactive]
|
|
164
|
-
- name: page
|
|
165
|
-
in: query
|
|
166
|
-
schema:
|
|
167
|
-
type: integer
|
|
168
|
-
default: 1
|
|
169
|
-
responses:
|
|
170
|
-
'200':
|
|
171
|
-
description: Item list
|
|
172
|
-
content:
|
|
173
|
-
application/json:
|
|
174
|
-
schema:
|
|
175
|
-
$ref: '#/components/schemas/ItemListResponse'
|
|
176
|
-
|
|
177
|
-
components:
|
|
178
|
-
securitySchemes:
|
|
179
|
-
bearerAuth:
|
|
180
|
-
type: http
|
|
181
|
-
scheme: bearer
|
|
182
|
-
bearerFormat: JWT
|
|
183
|
-
|
|
184
|
-
schemas:
|
|
185
|
-
Item:
|
|
186
|
-
type: object
|
|
187
|
-
required: [id, name]
|
|
188
|
-
properties:
|
|
189
|
-
id:
|
|
190
|
-
type: string
|
|
191
|
-
format: uuid
|
|
192
|
-
name:
|
|
193
|
-
type: string
|
|
194
|
-
```
|
|
195
|
-
|
|
196
|
-
### Markdown API Docs
|
|
197
|
-
|
|
198
|
-
```markdown
|
|
199
|
-
# API Endpoints
|
|
200
|
-
|
|
201
|
-
Base URL: `https://api.example.com/v1`
|
|
202
|
-
|
|
203
|
-
## Authentication
|
|
204
|
-
|
|
205
|
-
\`\`\`bash
|
|
206
|
-
curl -X POST /auth/login \
|
|
207
|
-
-H "Content-Type: application/json" \
|
|
208
|
-
-d '{"email": "user@example.com", "password": "secret"}'
|
|
209
|
-
\`\`\`
|
|
210
|
-
|
|
211
|
-
## GET /items
|
|
212
|
-
|
|
213
|
-
List all items.
|
|
214
|
-
|
|
215
|
-
**Query Parameters:**
|
|
216
|
-
|
|
217
|
-
| Param | Type | Required | Description |
|
|
218
|
-
|-------|------|----------|-------------|
|
|
219
|
-
| status | string | No | Filter by status |
|
|
220
|
-
| page | int | No | Page (default: 1) |
|
|
221
|
-
|
|
222
|
-
**Example:**
|
|
223
|
-
|
|
224
|
-
\`\`\`bash
|
|
225
|
-
curl -X GET "/items?status=active" \
|
|
226
|
-
-H "Authorization: Bearer $TOKEN"
|
|
227
|
-
\`\`\`
|
|
228
|
-
|
|
229
|
-
**Response 200:**
|
|
230
|
-
|
|
231
|
-
\`\`\`json
|
|
232
|
-
{
|
|
233
|
-
"data": [{ "id": "...", "name": "Item 1" }],
|
|
234
|
-
"meta": { "total": 42, "page": 1 }
|
|
235
|
-
}
|
|
236
|
-
\`\`\`
|
|
237
|
-
```
|
|
238
|
-
|
|
239
|
-
## Runbook Template
|
|
240
|
-
|
|
241
|
-
```markdown
|
|
242
|
-
# Runbook: [Procedure Name]
|
|
243
|
-
|
|
244
|
-
**Last Updated**: YYYY-MM-DD
|
|
245
|
-
**Author**: @username
|
|
246
|
-
**Estimated Time**: X minutes
|
|
247
|
-
|
|
248
|
-
## Description
|
|
249
|
-
|
|
250
|
-
[Brief description of procedure and when to use it]
|
|
251
|
-
|
|
252
|
-
## Prerequisites
|
|
253
|
-
|
|
254
|
-
- [ ] Access to [system/tool]
|
|
255
|
-
- [ ] [Required permissions]
|
|
256
|
-
|
|
257
|
-
## Procedure
|
|
258
|
-
|
|
259
|
-
### 1. [Step 1]
|
|
260
|
-
|
|
261
|
-
\`\`\`bash
|
|
262
|
-
command --flag value
|
|
263
|
-
\`\`\`
|
|
264
|
-
|
|
265
|
-
**Verification**: [How to verify step succeeded]
|
|
266
|
-
|
|
267
|
-
### 2. [Step 2]
|
|
268
|
-
|
|
269
|
-
...
|
|
270
|
-
|
|
271
|
-
## Rollback
|
|
272
|
-
|
|
273
|
-
If something goes wrong:
|
|
274
|
-
|
|
275
|
-
1. [Rollback step 1]
|
|
276
|
-
2. [Rollback step 2]
|
|
277
|
-
|
|
278
|
-
## Troubleshooting
|
|
279
|
-
|
|
280
|
-
### Problem: [Description]
|
|
281
|
-
**Symptom**: [What you observe]
|
|
282
|
-
**Cause**: [Why it happens]
|
|
283
|
-
**Solution**: [How to fix]
|
|
284
|
-
|
|
285
|
-
## Contacts
|
|
286
|
-
|
|
287
|
-
- **Primary**: @user (Slack: @user)
|
|
288
|
-
- **Escalation**: @manager
|
|
289
|
-
```
|
|
290
|
-
|
|
291
|
-
## README Template
|
|
292
|
-
|
|
293
|
-
```markdown
|
|
294
|
-
# Project Name
|
|
295
|
-
|
|
296
|
-
[](link)
|
|
297
|
-
[](link)
|
|
298
|
-
|
|
299
|
-
> Brief one-line description.
|
|
300
|
-
|
|
301
|
-
## Quick Start
|
|
302
|
-
|
|
303
|
-
\`\`\`bash
|
|
304
|
-
git clone https://github.com/org/project.git
|
|
305
|
-
cd project
|
|
306
|
-
cp .env.example .env
|
|
307
|
-
make dev
|
|
308
|
-
\`\`\`
|
|
309
|
-
|
|
310
|
-
## Architecture
|
|
311
|
-
|
|
312
|
-
\`\`\`
|
|
313
|
-
+---------+ +---------+
|
|
314
|
-
| Client |---->| API |
|
|
315
|
-
+---------+ +----+----+
|
|
316
|
-
|
|
|
317
|
-
+----+----+
|
|
318
|
-
| DB |
|
|
319
|
-
+---------+
|
|
320
|
-
\`\`\`
|
|
321
|
-
|
|
322
|
-
## Development
|
|
323
|
-
|
|
324
|
-
### Requirements
|
|
325
|
-
|
|
326
|
-
- Node 20+
|
|
327
|
-
- Docker 24+
|
|
328
|
-
|
|
329
|
-
### Commands
|
|
330
|
-
|
|
331
|
-
\`\`\`bash
|
|
332
|
-
make dev # Start development
|
|
333
|
-
make test # Run tests
|
|
334
|
-
make lint # Run linters
|
|
335
|
-
make build # Build for production
|
|
336
|
-
\`\`\`
|
|
337
|
-
|
|
338
|
-
## API
|
|
339
|
-
|
|
340
|
-
See [API documentation](docs/api/).
|
|
341
|
-
|
|
342
|
-
## Contributing
|
|
343
|
-
|
|
344
|
-
1. Fork the repository
|
|
345
|
-
2. Create branch: `git checkout -b feature/my-feature`
|
|
346
|
-
3. Commit: `git commit -m "feat: add feature"`
|
|
347
|
-
4. Push: `git push origin feature/my-feature`
|
|
348
|
-
5. Create Pull Request
|
|
349
|
-
|
|
350
|
-
## License
|
|
351
|
-
|
|
352
|
-
[MIT](LICENSE)
|
|
353
|
-
```
|
|
354
|
-
|
|
355
|
-
## Mermaid Diagrams
|
|
356
|
-
|
|
357
|
-
```markdown
|
|
358
|
-
## Data Flow
|
|
359
|
-
|
|
360
|
-
\`\`\`mermaid
|
|
361
|
-
flowchart LR
|
|
362
|
-
Client -->|HTTP| API
|
|
363
|
-
API -->|SQL| DB[(Database)]
|
|
364
|
-
API -->|Cache| Redis[(Redis)]
|
|
365
|
-
\`\`\`
|
|
366
|
-
|
|
367
|
-
## Sequence Diagram
|
|
368
|
-
|
|
369
|
-
\`\`\`mermaid
|
|
370
|
-
sequenceDiagram
|
|
371
|
-
User->>Frontend: Login
|
|
372
|
-
Frontend->>API: POST /auth/login
|
|
373
|
-
API->>DB: Verify credentials
|
|
374
|
-
DB-->>API: User valid
|
|
375
|
-
API-->>Frontend: JWT Token
|
|
376
|
-
Frontend-->>User: Redirect
|
|
377
|
-
\`\`\`
|
|
378
|
-
|
|
379
|
-
## Entity Relationship
|
|
380
|
-
|
|
381
|
-
\`\`\`mermaid
|
|
382
|
-
erDiagram
|
|
383
|
-
USER ||--o{ ORDER : places
|
|
384
|
-
ORDER ||--|{ ITEM : contains
|
|
385
|
-
|
|
386
|
-
USER {
|
|
387
|
-
uuid id PK
|
|
388
|
-
string email
|
|
389
|
-
}
|
|
390
|
-
\`\`\`
|
|
391
|
-
```
|
|
392
|
-
|
|
393
|
-
## Style Guide
|
|
394
|
-
|
|
395
|
-
### Markdown Conventions
|
|
396
|
-
|
|
397
|
-
- **Titles**: Imperative ("Configure", not "Configuration of")
|
|
398
|
-
- **Voice**: Active ("Run the command", not "The command should be run")
|
|
399
|
-
- **Length**: Lines <100 chars, paragraphs <5 sentences
|
|
400
|
-
- **Links**: Descriptive ("see deployment guide", not "click here")
|
|
401
|
-
|
|
402
|
-
### Formatting
|
|
403
|
-
|
|
404
|
-
```markdown
|
|
405
|
-
# H1 - One per document
|
|
406
|
-
|
|
407
|
-
## H2 - Main sections
|
|
408
|
-
|
|
409
|
-
### H3 - Subsections
|
|
410
|
-
|
|
411
|
-
**Bold** for important emphasis.
|
|
412
|
-
*Italic* for new technical terms.
|
|
413
|
-
`code` for commands, variables, files.
|
|
414
|
-
|
|
415
|
-
- Lists for items (max 7)
|
|
416
|
-
- Sub-items if needed
|
|
417
|
-
- Max 2 levels
|
|
418
|
-
|
|
419
|
-
1. Numbered lists for steps
|
|
420
|
-
2. When order matters
|
|
421
|
-
|
|
422
|
-
> Quotes for important notes or warnings.
|
|
423
|
-
|
|
424
|
-
| Header 1 | Header 2 |
|
|
425
|
-
|----------|----------|
|
|
426
|
-
| Cell 1 | Cell 2 |
|
|
427
|
-
```
|
|
428
|
-
|
|
429
|
-
## Documentation Checklist
|
|
430
|
-
|
|
431
|
-
### For each feature:
|
|
432
|
-
- [ ] README updated if API changes
|
|
433
|
-
- [ ] ADR if architectural decision
|
|
434
|
-
- [ ] Code comments for complex logic
|
|
435
|
-
- [ ] Changelog entry
|
|
436
|
-
|
|
437
|
-
### For releases:
|
|
438
|
-
- [ ] Complete changelog
|
|
439
|
-
- [ ] Migration guide if breaking changes
|
|
440
|
-
- [ ] API docs updated
|
|
441
|
-
- [ ] Runbooks reviewed
|
|
442
|
-
|
|
443
|
-
## Related Skills
|
|
444
|
-
|
|
445
|
-
- `git-workflow`: Commit documentation
|
|
446
|
-
- `git-github`: PR documentation
|
|
447
|
-
- `devops-infra`: CI/CD docs
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAIjD,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;AAgB5C;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAsCf"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAGhC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;AAIzC,SAAS,MAAM,CAAC,MAAoB,EAAE,EAAU,EAAE,KAAa,EAAE,MAA0B,EAAE,MAAe;IAC1G,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AACvC,CAAC;AAED,6CAA6C;AAC7C,KAAK,UAAU,KAAK,CAAC,GAAW;IAC9B,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;QACnC,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,UAAkB,EAClB,MAAe,EACf,MAAoB;IAEpB,MAAM,MAAM,GAAG,mBAAmB,CAAA;IAClC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,+BAA+B,EAAE,SAAS,CAAC,CAAA;IAElE,IAAI,CAAC;QACH,kCAAkC;QAClC,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,CAAA;QAE7C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,+BAA+B,EAAE,OAAO,EAC7D,0DAA0D,CAAC,CAAA;YAC7D,OAAM;QACR,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,CAAA;QACzC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACxB,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,IAAI,EAAE;YAChE,GAAG,EAAE,UAAU;YACf,OAAO,EAAE,OAAO,EAAE,mDAAmD;SACtE,CAAC,CAAA;QAEF,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,+BAA+B,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,IAAI,UAAU,CAAC,CAAA;QAChH,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,+BAA+B,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;QAC3G,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,MAAM,GAAG,kBAAkB,CAAA;YACjC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAA;QAC/F,CAAC;IACH,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QACtD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,+BAA+B,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;IACvE,CAAC;AACH,CAAC"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"analyze.test.d.ts","sourceRoot":"","sources":["../../src/commands/analyze.test.ts"],"names":[],"mappings":""}
|