@fink-andreas/pi-linear-tools 0.4.1 → 0.4.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/CHANGELOG.md +37 -0
- package/README.md +139 -13
- package/extensions/pi-linear-tools.js +298 -60
- package/index.js +1 -951
- package/package.json +6 -2
- package/src/cli.js +703 -7
- package/src/handlers.js +429 -4
- package/src/linear-client.js +7 -2
- package/src/linear.js +1502 -152
- package/src/sync-doc.js +1208 -0
- package/FUNCTIONALITY.md +0 -57
- package/POST_RELEASE_CHECKLIST.md +0 -30
- package/RELEASE.md +0 -50
package/FUNCTIONALITY.md
DELETED
|
@@ -1,57 +0,0 @@
|
|
|
1
|
-
# pi-linear-tools Functionality
|
|
2
|
-
|
|
3
|
-
## Scope
|
|
4
|
-
|
|
5
|
-
`pi-linear-tools` provides Linear SDK functionality as a pi extension package.
|
|
6
|
-
|
|
7
|
-
Included:
|
|
8
|
-
- extension configuration command (`/linear-tools-config`)
|
|
9
|
-
- issue/project/milestone tools powered by `@linear/sdk`
|
|
10
|
-
- issue start flow with optional git branch creation/switch
|
|
11
|
-
- settings persistence for API key/default team/project team mapping
|
|
12
|
-
|
|
13
|
-
Excluded:
|
|
14
|
-
- daemon runtime
|
|
15
|
-
- polling loop
|
|
16
|
-
- systemd service installation/control
|
|
17
|
-
- tmux/process session management
|
|
18
|
-
- RPC process lifecycle management
|
|
19
|
-
|
|
20
|
-
## Core modules
|
|
21
|
-
|
|
22
|
-
- `src/linear-client.js`: Linear SDK client factory
|
|
23
|
-
- `src/linear.js`: issue/project/milestone operations and formatting helpers
|
|
24
|
-
- `src/settings.js`: settings defaults/validation/load/save
|
|
25
|
-
- `src/logger.js`: structured logging
|
|
26
|
-
- `extensions/pi-linear-tools.js`: command and tool registration
|
|
27
|
-
- `src/cli.js`: optional local CLI for settings operations
|
|
28
|
-
|
|
29
|
-
## Tool behavior notes
|
|
30
|
-
|
|
31
|
-
- `LINEAR_API_KEY` is resolved from env first, then settings
|
|
32
|
-
- project references may be project name or project ID
|
|
33
|
-
- issue references may be identifier (`ABC-123`) or Linear issue ID
|
|
34
|
-
- default team resolution order for issue creation:
|
|
35
|
-
1. explicit `team` parameter
|
|
36
|
-
2. project-level configured team
|
|
37
|
-
3. global `defaultTeam`
|
|
38
|
-
- `linear_issue` `start` action:
|
|
39
|
-
- uses Linear branch name if available
|
|
40
|
-
- can create/switch git branch via `pi.exec("git", ...)`
|
|
41
|
-
|
|
42
|
-
## Settings schema
|
|
43
|
-
|
|
44
|
-
```json
|
|
45
|
-
{
|
|
46
|
-
"schemaVersion": 1,
|
|
47
|
-
"linearApiKey": null,
|
|
48
|
-
"defaultTeam": null,
|
|
49
|
-
"projects": {
|
|
50
|
-
"<linear-project-id>": {
|
|
51
|
-
"scope": {
|
|
52
|
-
"team": "ENG"
|
|
53
|
-
}
|
|
54
|
-
}
|
|
55
|
-
}
|
|
56
|
-
}
|
|
57
|
-
```
|
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
# Post-release verification checklist
|
|
2
|
-
|
|
3
|
-
## Registry and install checks
|
|
4
|
-
|
|
5
|
-
```bash
|
|
6
|
-
npm view @fink-andreas/pi-linear-tools version
|
|
7
|
-
npm install -g @fink-andreas/pi-linear-tools
|
|
8
|
-
pi-linear-tools --help
|
|
9
|
-
```
|
|
10
|
-
|
|
11
|
-
## pi package route smoke test
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
pi install git:github.com/fink-andreas/pi-linear-tools
|
|
15
|
-
# then enable extension resource and run
|
|
16
|
-
/linear-tools-help
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
## Basic command smoke test
|
|
20
|
-
|
|
21
|
-
```bash
|
|
22
|
-
pi-linear-tools project list
|
|
23
|
-
pi-linear-tools team list
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## Closeout
|
|
27
|
-
|
|
28
|
-
- Capture any regressions as follow-up Linear issues
|
|
29
|
-
- Post release summary to INN-234
|
|
30
|
-
- Mark milestone complete
|
package/RELEASE.md
DELETED
|
@@ -1,50 +0,0 @@
|
|
|
1
|
-
# Release Runbook
|
|
2
|
-
|
|
3
|
-
## npm publish (`v0.1.0`)
|
|
4
|
-
|
|
5
|
-
1. Ensure clean working tree
|
|
6
|
-
```bash
|
|
7
|
-
git status
|
|
8
|
-
```
|
|
9
|
-
2. Run pre-publish checks
|
|
10
|
-
```bash
|
|
11
|
-
npm run release:check
|
|
12
|
-
```
|
|
13
|
-
3. Verify npm authentication
|
|
14
|
-
```bash
|
|
15
|
-
npm whoami
|
|
16
|
-
```
|
|
17
|
-
4. Publish package
|
|
18
|
-
```bash
|
|
19
|
-
npm publish --access public
|
|
20
|
-
```
|
|
21
|
-
5. Verify published version
|
|
22
|
-
```bash
|
|
23
|
-
npm view @fink-andreas/pi-linear-tools version
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## Post-publish quick validation
|
|
27
|
-
|
|
28
|
-
```bash
|
|
29
|
-
npm install -g @fink-andreas/pi-linear-tools
|
|
30
|
-
pi-linear-tools --help
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
## GitHub release
|
|
34
|
-
|
|
35
|
-
```bash
|
|
36
|
-
git tag v0.1.0
|
|
37
|
-
git push origin v0.1.0
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
Create release notes from `RELEASE_NOTES_v0.1.0.md`:
|
|
41
|
-
|
|
42
|
-
```bash
|
|
43
|
-
gh release create v0.1.0 --title "v0.1.0" --notes-file RELEASE_NOTES_v0.1.0.md
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
Verify release:
|
|
47
|
-
|
|
48
|
-
```bash
|
|
49
|
-
gh release view v0.1.0
|
|
50
|
-
```
|