pi-cicd 1.0.2 → 1.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/docs/ARCHITECTURE.md +22 -0
- package/docs/FEATURE_INTAKE.md +20 -0
- package/docs/HARNESS.md +18 -0
- package/docs/HARNESS_BACKLOG.md +14 -0
- package/docs/TEST_MATRIX.md +18 -0
- package/docs/decisions/0001-cicd-architecture.md +18 -0
- package/docs/product/DEPLOYMENT.md +16 -0
- package/docs/templates/story.md +23 -0
- package/package.json +1 -1
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Architecture
|
|
2
|
+
|
|
3
|
+
## Structure
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
pi-cicd/
|
|
7
|
+
├── src/
|
|
8
|
+
│ ├── ci/ # CI integration
|
|
9
|
+
│ ├── deploy/ # Deployment strategies
|
|
10
|
+
│ ├── release/ # Release management
|
|
11
|
+
│ └── headless/ # Headless mode
|
|
12
|
+
├── skills/
|
|
13
|
+
└── test/unit/
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
## Core Components
|
|
17
|
+
|
|
18
|
+
| Component | Purpose |
|
|
19
|
+
| --- | --- |
|
|
20
|
+
| CI Pipeline | GitHub Actions, GitLab, Jenkins |
|
|
21
|
+
| Deploy | Canary, blue-green, rolling |
|
|
22
|
+
| Release | Changelog, versioning |
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Feature Intake
|
|
2
|
+
|
|
3
|
+
## Lanes
|
|
4
|
+
|
|
5
|
+
### Tiny
|
|
6
|
+
Docs or narrow edits.
|
|
7
|
+
|
|
8
|
+
### Normal
|
|
9
|
+
Story-sized behavior with bounded scope.
|
|
10
|
+
|
|
11
|
+
### High-Risk
|
|
12
|
+
Deployment or breaking changes.
|
|
13
|
+
|
|
14
|
+
## Risk Checklist
|
|
15
|
+
|
|
16
|
+
| Risk flag | Applies when |
|
|
17
|
+
| --- | --- |
|
|
18
|
+
| Deploy strategy | Changes deployment logic |
|
|
19
|
+
| Breaking change | Could break pipelines |
|
|
20
|
+
| New CI tool | Adding new CI integration |
|
package/docs/HARNESS.md
ADDED
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Harness
|
|
2
|
+
|
|
3
|
+
pi-cicd provides CI/CD pipeline and deployment integration.
|
|
4
|
+
|
|
5
|
+
## Input Types
|
|
6
|
+
|
|
7
|
+
| Type | Use when | Typical artifact |
|
|
8
|
+
| --- | --- | --- |
|
|
9
|
+
| New deploy | Adding deployment strategy | Story |
|
|
10
|
+
| CI integration | Pipeline tool changes | Story |
|
|
11
|
+
| Harness | Process improvements | Backlog |
|
|
12
|
+
|
|
13
|
+
## Validation Ladder
|
|
14
|
+
|
|
15
|
+
```text
|
|
16
|
+
validate:quick
|
|
17
|
+
format, lint, typecheck, unit tests
|
|
18
|
+
```
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# Harness Backlog
|
|
2
|
+
|
|
3
|
+
## Proposed
|
|
4
|
+
|
|
5
|
+
| ID | Description | Priority |
|
|
6
|
+
| --- | --- | --- |
|
|
7
|
+
| HB-001 | Add Kubernetes deploy | medium |
|
|
8
|
+
| HB-002 | Add more CI tools | low |
|
|
9
|
+
|
|
10
|
+
## Completed
|
|
11
|
+
|
|
12
|
+
| ID | Completed |
|
|
13
|
+
| --- | --- |
|
|
14
|
+
| HB-000 | 2026-05-13 |
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Test Matrix
|
|
2
|
+
|
|
3
|
+
## Matrix
|
|
4
|
+
|
|
5
|
+
| Story | Tool/Feature | Unit | Integration | Status |
|
|
6
|
+
| --- | --- | --- | --- | --- |
|
|
7
|
+
| US-001 | ci_status tool | yes | no | implemented |
|
|
8
|
+
| US-002 | deploy_strategy tool | yes | no | implemented |
|
|
9
|
+
| US-003 | release_notes tool | yes | no | implemented |
|
|
10
|
+
| US-004 | headless_mode | yes | no | implemented |
|
|
11
|
+
|
|
12
|
+
## Commands
|
|
13
|
+
|
|
14
|
+
```bash
|
|
15
|
+
npm test
|
|
16
|
+
npm run lint
|
|
17
|
+
npx tsc --noEmit
|
|
18
|
+
```
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# 0001 CI/CD Architecture
|
|
2
|
+
|
|
3
|
+
Date: 2026-05-13
|
|
4
|
+
|
|
5
|
+
## Status
|
|
6
|
+
|
|
7
|
+
Accepted
|
|
8
|
+
|
|
9
|
+
## Decision
|
|
10
|
+
|
|
11
|
+
Support multiple CI tools with unified interface.
|
|
12
|
+
Focus on GitHub Actions first.
|
|
13
|
+
|
|
14
|
+
## Consequences
|
|
15
|
+
|
|
16
|
+
Positive:
|
|
17
|
+
- Works with existing pipelines
|
|
18
|
+
- Easy to extend
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# Deployment Contracts
|
|
2
|
+
|
|
3
|
+
## Deploy Strategies
|
|
4
|
+
|
|
5
|
+
| Strategy | Purpose | Risk |
|
|
6
|
+
| --- | --- | --- |
|
|
7
|
+
| Canary | Gradual rollout | Low |
|
|
8
|
+
| Blue-Green | Instant switch | Medium |
|
|
9
|
+
| Rolling | Incremental | Low |
|
|
10
|
+
|
|
11
|
+
## CI Integration
|
|
12
|
+
|
|
13
|
+
Supports:
|
|
14
|
+
- GitHub Actions
|
|
15
|
+
- GitLab CI
|
|
16
|
+
- Jenkins (planned)
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# US-XXX Story Title
|
|
2
|
+
|
|
3
|
+
## Status
|
|
4
|
+
|
|
5
|
+
planned
|
|
6
|
+
|
|
7
|
+
## Lane
|
|
8
|
+
|
|
9
|
+
tiny | normal | high-risk
|
|
10
|
+
|
|
11
|
+
## Product Contract
|
|
12
|
+
|
|
13
|
+
Describe behavior.
|
|
14
|
+
|
|
15
|
+
## Validation
|
|
16
|
+
|
|
17
|
+
| Layer | Proof |
|
|
18
|
+
| --- | --- |
|
|
19
|
+
| Unit | |
|
|
20
|
+
|
|
21
|
+
## Evidence
|
|
22
|
+
|
|
23
|
+
Add after validation.
|