@shipright/shipright 0.0.0-stage → 0.1.0-nightly.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/LICENSE +21 -0
- package/README.md +69 -2
- package/dist/THIRD_PARTY_NOTICES.txt +178 -0
- package/dist/cli.js +5721 -0
- package/dist/resources/agents/design-lead.md +13 -0
- package/dist/resources/agents/implementation-lead.md +13 -0
- package/dist/resources/coordinator.md +31 -0
- package/dist/resources/integrations/t3-code.md +31 -0
- package/dist/resources/project/architecture.md +10 -0
- package/dist/resources/project/code-style.md +9 -0
- package/dist/resources/project/delivery.md +10 -0
- package/dist/resources/project/project.md +19 -0
- package/dist/resources/project/verification.md +10 -0
- package/dist/resources/project/workflow.md +19 -0
- package/dist/resources/project-contract.template.md +33 -0
- package/dist/resources/reviews/code.md +17 -0
- package/dist/resources/reviews/common.md +29 -0
- package/dist/resources/reviews/design.md +18 -0
- package/dist/resources/workflow.md +10 -0
- package/dist/resources/workspace/architecture.md +7 -0
- package/dist/resources/workspace/project.md +9 -0
- package/dist/resources/workspace/verification.md +5 -0
- package/dist/resources/workspace/workflow.md +7 -0
- package/dist/resources/workspace-coordinator.md +15 -0
- package/package.json +21 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Shipright 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.
|
package/README.md
CHANGED
|
@@ -1,3 +1,70 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Shipright
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**Ship fast. Ship right.**
|
|
4
|
+
|
|
5
|
+
Configurable engineering workflows for coding agents: delegated design and implementation, independent review loops, project-specific standards, and observable verification.
|
|
6
|
+
|
|
7
|
+
## Experimental release
|
|
8
|
+
|
|
9
|
+
This package is an early nightly release. File installation and context resolution are tested; actual instruction loading and cross-project coordination in T3 have not yet been validated end to end. Instructions are not security boundaries or guarantees of defect-free code.
|
|
10
|
+
|
|
11
|
+
Requires **Bun 1.3.10 or newer**. Git is needed to discover and link repositories and resolve standard Git worktrees.
|
|
12
|
+
|
|
13
|
+
## Quick start
|
|
14
|
+
|
|
15
|
+
From your project or workspace:
|
|
16
|
+
|
|
17
|
+
```sh
|
|
18
|
+
bunx @shipright/shipright@nightly repo init --dry-run
|
|
19
|
+
bunx @shipright/shipright@nightly repo init
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
For a folder containing several repositories:
|
|
23
|
+
|
|
24
|
+
```sh
|
|
25
|
+
bunx @shipright/shipright@nightly workspace init --dry-run
|
|
26
|
+
bunx @shipright/shipright@nightly workspace init
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Interactive terminals offer repository/harness selection, a preview, and confirmation. Workspace initialization installs and links the selected repos by default. Use `--workspace-only` to configure just the shared root, or repeated `--repo backend=backend --repo frontend=frontend` to select repos explicitly.
|
|
30
|
+
|
|
31
|
+
## Commands
|
|
32
|
+
|
|
33
|
+
```text
|
|
34
|
+
shipright repo init [directory]
|
|
35
|
+
shipright repo update [directory]
|
|
36
|
+
shipright repo uninstall [directory]
|
|
37
|
+
shipright repo context [directory]
|
|
38
|
+
shipright workspace init [directory]
|
|
39
|
+
shipright workspace update [directory]
|
|
40
|
+
shipright workspace uninstall [directory]
|
|
41
|
+
shipright workspace context [directory]
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Run commands through `bunx @shipright/shipright@nightly`, or install the package to use its `shipright` binary. `--help` is available at each level. For reproducibility, replace `nightly` with an exact version.
|
|
45
|
+
|
|
46
|
+
- `--targets opencode,claude-code,codex`: select harness bindings; existing bindings are preserved.
|
|
47
|
+
- `--workspace <directory>`: link repo initialization/update to an initialized workspace.
|
|
48
|
+
- `--dry-run`: preview without writes or prompts.
|
|
49
|
+
- `--yes` / `-y`: apply non-interactively. No interactive selectors are shown.
|
|
50
|
+
- `context`: print resolved context as JSON only.
|
|
51
|
+
|
|
52
|
+
Workspace update/uninstall affect the shared root only, not the repo installations. The CLI does not run project scripts, create agent tasks, merge, or deploy.
|
|
53
|
+
|
|
54
|
+
## Configure your standards
|
|
55
|
+
|
|
56
|
+
The installer adds managed instructions under `.shipright/managed/` and editable Markdown templates under `.shipright/project/`, or `.shipright/workspace/` for shared rules. Fill in the templates or reference your existing documents, including review limits and verification commands. Consumer rules can use your preferred language.
|
|
57
|
+
|
|
58
|
+
OpenCode, Claude Code, and Codex receive native instruction bindings for the T3 integration. Commit each repo installation before creating isolated worktrees, and open fresh agent sessions to verify loaded instructions. Missing context or harness capabilities must be reported, not assumed.
|
|
59
|
+
|
|
60
|
+
## Safety and limitations
|
|
61
|
+
|
|
62
|
+
Updates never overwrite local project/shared rules. Modified managed files and binding blocks cause conflicts instead of forced replacement. All selected repo plans are checked before the first write, but errors during writing can still cause a partial installation across repositories; completed directories are reported. Do not run concurrent installers.
|
|
63
|
+
|
|
64
|
+
Uninstall preserves local rules, workspace manifests, and links, and may leave empty directories or shared configuration. No recursive cleanup is performed. Inspect previews and back up important configuration before experimenting.
|
|
65
|
+
|
|
66
|
+
The unscoped npm package `shipright` is a different project. Use **`@shipright/shipright`**.
|
|
67
|
+
|
|
68
|
+
## License
|
|
69
|
+
|
|
70
|
+
MIT. Bundled dependencies retain their licenses in `dist/THIRD_PARTY_NOTICES.txt`.
|
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
===== @clack/prompts@1.8.1 / LICENSE =====
|
|
2
|
+
|
|
3
|
+
MIT License
|
|
4
|
+
|
|
5
|
+
MIT License Copyright (c) 2025-Present [Bombshell contributors](https://bomb.sh/team)
|
|
6
|
+
|
|
7
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
|
8
|
+
|
|
9
|
+
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
|
10
|
+
|
|
11
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
===== @clack/core@1.5.1 / LICENSE =====
|
|
15
|
+
|
|
16
|
+
MIT License
|
|
17
|
+
|
|
18
|
+
MIT License Copyright (c) 2025-Present [Bombshell contributors](https://bomb.sh/team)
|
|
19
|
+
|
|
20
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
|
21
|
+
|
|
22
|
+
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
|
23
|
+
|
|
24
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
===== fast-wrap-ansi@0.2.2 / LICENSE =====
|
|
28
|
+
|
|
29
|
+
MIT License
|
|
30
|
+
|
|
31
|
+
Copyright (c) 2025 James Garbutt
|
|
32
|
+
|
|
33
|
+
Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
|
|
34
|
+
|
|
35
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
36
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
37
|
+
in the Software without restriction, including without limitation the rights
|
|
38
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
39
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
40
|
+
furnished to do so, subject to the following conditions:
|
|
41
|
+
|
|
42
|
+
The above copyright notice and this permission notice shall be included in all
|
|
43
|
+
copies or substantial portions of the Software.
|
|
44
|
+
|
|
45
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
46
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
47
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
48
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
49
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
50
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
51
|
+
SOFTWARE.
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
===== fast-string-width@3.0.2 / license =====
|
|
55
|
+
|
|
56
|
+
The MIT License (MIT)
|
|
57
|
+
|
|
58
|
+
Copyright (c) 2024-present Fabio Spampinato
|
|
59
|
+
|
|
60
|
+
Permission is hereby granted, free of charge, to any person obtaining a
|
|
61
|
+
copy of this software and associated documentation files (the "Software"),
|
|
62
|
+
to deal in the Software without restriction, including without limitation
|
|
63
|
+
the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
64
|
+
and/or sell copies of the Software, and to permit persons to whom the
|
|
65
|
+
Software is furnished to do so, subject to the following conditions:
|
|
66
|
+
|
|
67
|
+
The above copyright notice and this permission notice shall be included in
|
|
68
|
+
all copies or substantial portions of the Software.
|
|
69
|
+
|
|
70
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
71
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
72
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
73
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
74
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
75
|
+
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
|
76
|
+
DEALINGS IN THE SOFTWARE.
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
===== fast-string-truncated-width@3.0.3 / license =====
|
|
80
|
+
|
|
81
|
+
The MIT License (MIT)
|
|
82
|
+
|
|
83
|
+
Copyright (c) 2024-present Fabio Spampinato
|
|
84
|
+
|
|
85
|
+
Permission is hereby granted, free of charge, to any person obtaining a
|
|
86
|
+
copy of this software and associated documentation files (the "Software"),
|
|
87
|
+
to deal in the Software without restriction, including without limitation
|
|
88
|
+
the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
89
|
+
and/or sell copies of the Software, and to permit persons to whom the
|
|
90
|
+
Software is furnished to do so, subject to the following conditions:
|
|
91
|
+
|
|
92
|
+
The above copyright notice and this permission notice shall be included in
|
|
93
|
+
all copies or substantial portions of the Software.
|
|
94
|
+
|
|
95
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
96
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
97
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
98
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
99
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
100
|
+
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
|
101
|
+
DEALINGS IN THE SOFTWARE.
|
|
102
|
+
|
|
103
|
+
|
|
104
|
+
===== sisteransi@1.0.5 / license =====
|
|
105
|
+
|
|
106
|
+
MIT License
|
|
107
|
+
|
|
108
|
+
Copyright (c) 2018 Terkel Gjervig Nielsen
|
|
109
|
+
|
|
110
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
111
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
112
|
+
in the Software without restriction, including without limitation the rights
|
|
113
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
114
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
115
|
+
furnished to do so, subject to the following conditions:
|
|
116
|
+
|
|
117
|
+
The above copyright notice and this permission notice shall be included in all
|
|
118
|
+
copies or substantial portions of the Software.
|
|
119
|
+
|
|
120
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
121
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
122
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
123
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
124
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
125
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
126
|
+
SOFTWARE.
|
|
127
|
+
|
|
128
|
+
|
|
129
|
+
===== commander@15.1.0 / LICENSE =====
|
|
130
|
+
|
|
131
|
+
(The MIT License)
|
|
132
|
+
|
|
133
|
+
Copyright (c) 2011 TJ Holowaychuk <tj@vision-media.ca>
|
|
134
|
+
|
|
135
|
+
Permission is hereby granted, free of charge, to any person obtaining
|
|
136
|
+
a copy of this software and associated documentation files (the
|
|
137
|
+
'Software'), to deal in the Software without restriction, including
|
|
138
|
+
without limitation the rights to use, copy, modify, merge, publish,
|
|
139
|
+
distribute, sublicense, and/or sell copies of the Software, and to
|
|
140
|
+
permit persons to whom the Software is furnished to do so, subject to
|
|
141
|
+
the following conditions:
|
|
142
|
+
|
|
143
|
+
The above copyright notice and this permission notice shall be
|
|
144
|
+
included in all copies or substantial portions of the Software.
|
|
145
|
+
|
|
146
|
+
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
|
|
147
|
+
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
148
|
+
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
|
149
|
+
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
|
150
|
+
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
|
151
|
+
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
|
152
|
+
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
153
|
+
|
|
154
|
+
|
|
155
|
+
===== jsonc-parser@3.3.1 / LICENSE.md =====
|
|
156
|
+
|
|
157
|
+
The MIT License (MIT)
|
|
158
|
+
|
|
159
|
+
Copyright (c) Microsoft
|
|
160
|
+
|
|
161
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
162
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
163
|
+
in the Software without restriction, including without limitation the rights
|
|
164
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
165
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
166
|
+
furnished to do so, subject to the following conditions:
|
|
167
|
+
|
|
168
|
+
The above copyright notice and this permission notice shall be included in all
|
|
169
|
+
copies or substantial portions of the Software.
|
|
170
|
+
|
|
171
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
172
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
173
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
174
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
175
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
176
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
177
|
+
SOFTWARE.
|
|
178
|
+
|