si-overnight 0.1.0 → 0.1.2

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/README.md CHANGED
@@ -1,170 +1,277 @@
1
1
  # si-overnight
2
2
 
3
- Sen uyumadan gerekli kararları toplayan; sen yokken kod yazan, test eden ve
4
- sabaha rapor bırakan taşınabilir agent skill'i.
3
+ **English** · [Türkçe](https://github.com/siguelabs/si/blob/main/docs/tr/README.md)
5
4
 
6
- ## Nasıl çalışır?
5
+ Give your coding agent a clear plan before you sleep. `si-overnight` helps it
6
+ finish agreed work, test the changes, save checkpoints, and leave a morning report.
7
7
 
8
- 1. Projeyi, mevcut değişiklikleri ve test düzenini inceler.
9
- 2. Her yeni gece iki moddan hangisini istediğini sorar:
10
- - **Liste:** Ana işleri, ardından önceden belirlediğin yedek işleri bitirir ve durur.
11
- - **Keşif:** Ana işleri bitirince, belirlediğin alanlarda yararlı iyileştirmeler bulur ve uygular.
12
- 3. Öncelikleri, başarı ölçütlerini, dokunulmayacak yerleri, bitiş saatini ve gereken
13
- yetkileri sen uyumadan netleştirir. Cevapladığın şeyleri tekrar tekrar sormaz.
14
- 4. Seçilen kapsamda uygular, test eder, hataları düzeltir ve sonuçları kaydeder.
15
- Bir iş bloke olursa bağımsız işlere devam eder.
16
- 5. `.si-overnight/<run-id>/run.md` dosyasına ilerlemeyi,
17
- `report.md` dosyasına tamamlanan işleri, test sonuçlarını ve eksikleri yazar.
8
+ It is a portable [Agent Skill](https://agentskills.io/), with installers for
9
+ Codex, Claude Code, Google Antigravity, and pi. The skill supplies the workflow;
10
+ your agent host supplies the tools, permissions, and execution time.
18
11
 
19
- İş bitince, süre/kota dolunca veya ilerleyebileceği iş kalmayınca durur. Sırf token
20
- harcamak için aynı testleri döndürmez veya proje dışında işler uydurmaz.
12
+ ![Illustrated overnight workflow: agree on a plan, implement, test, review, checkpoint, and report](https://raw.githubusercontent.com/siguelabs/si/main/docs/assets/overnight-workflow.gif)
21
13
 
22
- ## Kurulum
14
+ *Illustrative workflow diagram, not a recording of an agent session. Parallel
15
+ workers are optional and require host support.*
23
16
 
24
- ### npm / npx
17
+ [Quick start](#quick-start) · [How it works](#how-it-works) ·
18
+ [Hosts and paths](#hosts-and-installation-paths) · [Resume](#resume-a-run) ·
19
+ [Development](#development-and-contributing)
25
20
 
26
- Node.js 20 veya üzeri yeterli; npm CLI'si Python gerektirmez ve ek paket bağımlılığı
27
- yoktur. Henüz registry'ye yayımlanmadı. Bu depodan doğrudan çalıştır:
21
+ ## Quick start
22
+
23
+ Install [Node.js](https://nodejs.org/en/download) **20 or newer**, then run this
24
+ one command in your terminal:
28
25
 
29
26
  ```bash
30
- node bin/si-overnight.mjs --platform all --project /projenin/tam/yolu
31
- node bin/si-overnight.mjs --platform codex --scope user --dry-run
32
- node bin/si-overnight.mjs --help
27
+ npx si-overnight
28
+ ```
29
+
30
+ The guided installer walks you through the rest:
31
+
32
+ 1. Choose **Codex**, **Claude Code**, **Antigravity**, **pi**, or **All**.
33
+ 2. Choose **All projects** (recommended) or **Current project**.
34
+ 3. Open your coding agent's chat and run the skill command printed by the installer.
35
+
36
+ No repository clone, Python, or CLI flags are required. All projects installs the
37
+ skill in your user directory so you can use it across projects. Current project
38
+ installs it in the directory where you ran the command. You can also spell the
39
+ installer command as `npx si-overnight install`.
40
+
41
+ For example, in Codex:
42
+
43
+ ```text
44
+ $si-overnight
45
+ Tonight, fix the checkout bugs in issues #12 and #18.
46
+ Ask me for the remaining decisions before I leave.
47
+ Work for at most six hours from the start of this run.
33
48
  ```
34
49
 
35
- Yerel npm paketi oluşturup registry kullanmadan çalıştırabilirsin:
50
+ Replace the tasks and deadline with your own. The agent inspects the project and
51
+ collects the missing decisions before implementation starts. A bare invocation
52
+ starts intake; it does not authorize an unspecified night of changes.
53
+
54
+ ### Scripted and source installation
55
+
56
+ For automation, choose the host and scope explicitly:
36
57
 
37
58
  ```bash
38
- npm pack --ignore-scripts
39
- npm exec --yes --package ./si-overnight-0.1.0.tgz -- si-overnight --platform all --project /projenin/tam/yolu
59
+ npx --yes si-overnight --platform all --project /absolute/path/to/project
60
+ npx --yes si-overnight --platform codex --scope user
40
61
  ```
41
62
 
42
- Paket `si-overnight` adıyla yayımlandıktan sonra aynı kurulum:
63
+ To try the current package without a registry release, run from this repository:
43
64
 
44
65
  ```bash
45
- npx si-overnight --platform all --project /projenin/tam/yolu
46
- npx si-overnight --platform codex --scope user
66
+ npm pack --ignore-scripts
67
+ npm exec --yes --package ./si-overnight-0.1.2.tgz -- si-overnight --platform codex --project /absolute/path/to/project
47
68
  ```
48
69
 
49
- `--platform` tekrarlanabilir: `--platform claude --platform pi`.
50
- `--scope project` varsayılandır; `--project` mevcut bir dizin olmalıdır.
51
- `--dry-run` yalnız hedefleri gösterir. Kurulum hedefin içindeki sembolik bağlantıları
52
- izlemez; mevcut farklı dosyaları korur. Seçtiğin proje kökünün kendisi bir dizin
53
- kısayoluysa gerçek kök kullanılır. Kurulum sırasında başka süreçler skill dizinlerini
54
- değiştirmemelidir. `npm install` kendiliğinden skill kurmaz veya agent başlatmaz.
70
+ Installing the npm package, including globally, only makes the installer command
71
+ available. It does not install skills automatically or launch an agent. Run the
72
+ installer explicitly, then invoke the skill in your host.
55
73
 
56
- ### Python alternatifi
74
+ ## How it works
57
75
 
58
- Python 3 ile, bu deponun kök dizininden çalıştır:
76
+ ### 1. Agree on tonight's work
59
77
 
60
- ```bash
61
- # Tüm desteklenen platformlar için seçtiğin projeye kur.
62
- python3 scripts/install.py --platform all --project /projenin/tam/yolu
78
+ The agent reads project instructions, existing changes, build commands, and test
79
+ setup. For **each new night**, it asks you to choose a mode unless you have already
80
+ chosen one for that run:
81
+
82
+ | Mode | After the primary tasks |
83
+ | --- | --- |
84
+ | **Queue** | Finish your agreed backup tasks, then stop. |
85
+ | **Discover** | Find and implement useful improvements inside the areas and categories you agreed on. |
63
86
 
64
- # Ya da yalnız Codex için kullanıcı genelinde kur.
65
- python3 scripts/install.py --platform codex --scope user
87
+ Last night's choice is not a permanent preference. Resuming an existing run keeps
88
+ that run's mode and scope.
66
89
 
67
- # Yazmadan önce hedefleri gör.
68
- python3 scripts/install.py --platform all --scope user --dry-run
69
- ```
90
+ Before you leave, the agent batches the consequential questions:
91
+
92
+ - What outcomes matter most, and what proves they are done?
93
+ - Which backup tasks or discovery areas are allowed? Are dependency changes or broad refactors included?
94
+ - Which paths, APIs, behavior, data, or design decisions must remain unchanged?
95
+ - When should work stop, with a date and timezone or duration? Is there a known spend or token cap?
96
+ - Which tests and services are available? Are access or permission prompts likely?
97
+ - Should delivery be local edits and a report, or are commits, a push/PR, deployment, or other external actions authorized?
98
+
99
+ It reuses answers already in the conversation and checks likely blockers while
100
+ you can still respond. Your answers authorize the agreed work; no extra start
101
+ confirmation is needed. Unanswered questions remain unanswered when you go offline.
102
+
103
+ ### 2. Implement, test, review, checkpoint
70
104
 
71
- Tek platform için `codex`, `claude`, `antigravity` veya `pi` seçebilirsin.
72
- Kurulum mevcut farklı bir skill'in üzerine yazmaz; aynı sürüm zaten kuruluysa
73
- değiştirmez. Güncellemede mevcut dizini inceleyip taşıdıktan sonra yeniden kur.
74
- Kurulum izin ayarlarını değiştirmez ve arka plan süreci başlatmaz.
75
- Seçtiğin proje veya kullanıcı kökü bir dizin bağlantısı olabilir; bu kökün altındaki
76
- kurulum dizinlerinde sembolik bağlantı varsa kurulum reddedilir.
105
+ The agent saves the run contract and repeats this loop while useful authorized
106
+ work and time remain:
77
107
 
78
- ## Çağırma
108
+ 1. Read the checkpoint; check scope, time, and any observable budget.
109
+ 2. Pick the highest-priority unblocked task and implement a bounded change.
110
+ 3. Run focused tests, fix demonstrated regressions, and run required broader checks.
111
+ 4. Review the diff for correctness, scope, and unrelated changes.
112
+ 5. Save the evidence, work in progress, and next action before continuing.
79
113
 
80
- | Platform | Komut |
114
+ Existing user edits are preserved. A blocked task is recorded while independent
115
+ work continues. Repeated attempts without new evidence are bounded. Passing tests
116
+ are not rerun merely to consume tokens, and unavailable checks are not reported
117
+ as passing.
118
+
119
+ **Optional subagents:** on hosts that support them, the main agent can coordinate
120
+ independent tasks and assign nonoverlapping file ownership. It may also delegate
121
+ tests or a review, then verify the results. These are task assignments chosen for
122
+ the run, not a built-in team of always-on agents. Every worker shares the same
123
+ scope, deadline, and permissions.
124
+
125
+ ### 3. Stop with a useful handoff
126
+
127
+ Work stops when the Queue is complete, scoped Discover work has no worthwhile
128
+ candidate left, the deadline or an observable budget/provider limit is reached,
129
+ all remaining work is blocked, you request a stop, or the host ends execution.
130
+
131
+ The agent writes these files in the target project, using your language:
132
+
133
+ | File | Contents |
81
134
  | --- | --- |
82
- | Codex | `$si-overnight` veya `/skills` içinden seç |
83
- | Claude Code | `/si-overnight` |
84
- | Google Antigravity | `/si-overnight` |
85
- | pi | `/skill:si-overnight` |
135
+ | `.si-overnight/<run-id>/run.md` | Scope, answers, baseline, task queue, latest checkpoint, and verification evidence. |
136
+ | `.si-overnight/<run-id>/report.md` | Completed outcomes, changed files, test results, unfinished work, stop reason, and a resume prompt. |
86
137
 
87
- Örnek gece başlangıcı:
138
+ Run files stay local and out of staging unless you ask to version them. Checkpoints
139
+ are saved after completed tasks, material failed attempts, and permission blockers,
140
+ and before risky operations or context handoffs. See the
141
+ [checkpoint template](skills/si-overnight/references/run-template.md).
88
142
 
89
- ```text
90
- $si-overnight
91
- Bu gece ödeme ekranındaki hata listesini bitir.
92
- Sonra ne yapacağını ve ihtiyaç duyduğun kararları uyumadan bana sor.
93
- 18 Kasım 2026 07:00 Europe/Istanbul'a kadar çalış.
143
+ ## Hosts and installation paths
144
+
145
+ `--scope project` installs below the selected project; `--scope user` installs
146
+ below your home directory. Each destination contains `SKILL.md` and its references.
147
+
148
+ | Host / `--platform` | Project path | User path | Invocation |
149
+ | --- | --- | --- | --- |
150
+ | Codex / `codex` | `.agents/skills/si-overnight/` | `~/.agents/skills/si-overnight/` | `$si-overnight` or select via `/skills` |
151
+ | Claude Code / `claude` | `.claude/skills/si-overnight/` | `~/.claude/skills/si-overnight/` | `/si-overnight` |
152
+ | Google Antigravity / `antigravity` | `.agents/skills/si-overnight/` | `~/.gemini/config/skills/si-overnight/` | `/si-overnight` |
153
+ | pi / `pi` | `.pi/skills/si-overnight/` | `~/.pi/agent/skills/si-overnight/` | `/skill:si-overnight` |
154
+
155
+ Codex and Antigravity share a project destination, so `all` installs one copy
156
+ there. For other Agent Skills-compatible hosts, copy `skills/si-overnight/` into
157
+ the host's documented skill directory and use its invocation mechanism. If a host
158
+ can read files but has no native skill support, explicitly ask it to read and
159
+ follow `SKILL.md`; that does not register a slash command.
160
+
161
+ Paths and commands depend on the installed host version. See
162
+ [compatibility notes and official sources](skills/si-overnight/references/platforms.md).
163
+
164
+ ### Installer options
165
+
166
+ ```bash
167
+ node bin/si-overnight.mjs --platform claude --platform pi --dry-run
168
+ node bin/si-overnight.mjs --platform codex --scope user
169
+ node bin/si-overnight.mjs --help
94
170
  ```
95
171
 
96
- Devam etmek için aynı skill'i çağırıp ilgili
97
- `.si-overnight/<run-id>/run.md` dosyasını belirt. Süre dolmuşsa yeni bir çalışma
98
- aralığı ver. Önce dosyalarla checkpoint'i karşılaştırır, sonra kaldığı yerden ilerler.
172
+ | Option | Behavior |
173
+ | --- | --- |
174
+ | `--platform <name>` | For scripted installation: `codex`, `claude`, `antigravity`, `pi`, or `all`; repeatable. |
175
+ | `--scope <scope>` | Explicit flags default to `project`; guided setup recommends `user` (All projects). |
176
+ | `--project <path>` | Existing project directory; defaults to the current directory. Used for project scope. |
177
+ | `--dry-run` | Validate and show destinations without writing files. |
178
+ | `--help`, `-h` | Show CLI help. |
179
+
180
+ Guided setup needs an interactive terminal. In CI or scripts, pass `--platform`
181
+ and the desired `--scope` explicitly.
182
+
183
+ The installer leaves identical installations untouched and refuses to overwrite
184
+ different content. To update, review and move the existing skill directory, then
185
+ install again. It checks all destinations before writing, rejects symbolic links
186
+ inside the source or destination tree and below the selected installation root,
187
+ and prevents source/destination overlap. The selected project or home root itself
188
+ may be a directory alias. Avoid concurrent changes to installation directories.
189
+ Installation does not change host permissions or start background processes.
190
+
191
+ A **Python 3 alternative** is available from the repository, with the same
192
+ destinations, dry-run behavior, and protection for existing content:
99
193
 
100
- Diğer Agent Skills uyumlu araçlarda `skills/si-overnight/` klasörünü aracın
101
- belgelediği skill dizinine kopyalayabilirsin. Native skill desteği olmayan ama
102
- dosya okuyabilen bir agente `SKILL.md` dosyasını okuyup uygulamasını söyleyebilirsin.
103
- Her platformda aynı slash komutunun kayıtlı olduğu varsayılmaz.
194
+ ```bash
195
+ python3 scripts/install.py --platform all --project /absolute/path/to/project
196
+ python3 scripts/install.py --platform codex --scope user --dry-run
197
+ ```
198
+
199
+ ## Execution time and budgets
104
200
 
105
- ## Çalışma süresi sınırı
201
+ The skill cannot keep a computer awake, restart a stopped agent, renew a quota,
202
+ or create new turns after the host stops. Leave the local machine, session, agent,
203
+ and required services available, or use a host that actually executes remotely.
204
+ A sudden termination may leave only the latest checkpoint; a stopped process
205
+ cannot write a new morning report.
106
206
 
107
- Skill tek başına uygulamayı açık tutmaz, bilgisayarın uyumasını engellemez,
108
- sonlanan agenti yeniden başlatmaz veya kota yenilemez. Yerel çalışmada makine,
109
- oturum ve gerekli servisler açık kalmalı; uzakta çalışmada gerçekten uzakta
110
- çalışan bir ortam kullanılmalı. Oturum aniden kesilirse en son checkpoint'ten
111
- devam edilir; kesilen süreç yeni bir sabah raporu yazamaz.
207
+ A token or spend cap can only be monitored when the host exposes reliable usage
208
+ data. Otherwise usage is recorded as unknown. The skill does not promise to
209
+ consume every available token or wait for quota resets.
112
210
 
113
- Codex'in Goal modu bulunan sürümlerinde, kararlaştırılan gece planını `/goal`
114
- ile açıkça başlatabilirsin. Bu skill'i çağırmak kendiliğinden Goal modu oluşturmaz.
115
- Başka hostlarda otomatik yeniden çağırma için ayrıca yapılandırılmış bir runner
116
- gerekir; bu paket runner içermez. Kapsam ve onay mekanizmaları her durumda geçerlidir.
211
+ On Codex versions with Goal mode, you can explicitly start `/goal` with the agreed
212
+ overnight plan. Invoking this skill does not create a goal or schedule. Other
213
+ hosts may need a separately configured runner for repeated invocations; this
214
+ package does not include one. Host approval requirements still apply.
117
215
 
118
- Platform yolları ve resmi kaynaklar:
119
- [uyumluluk notları](skills/si-overnight/references/platforms.md).
216
+ ## Resume a run
120
217
 
121
- ## Kontroller
218
+ Invoke the skill in your host and name the saved checkpoint:
219
+
220
+ ```text
221
+ Use si-overnight. Resume .si-overnight/<run-id>/run.md.
222
+ Reconcile the checkpoint with the working tree first and keep the agreed scope.
223
+ The new execution window ends at <date, time, timezone>.
224
+ ```
225
+
226
+ The agent checks current instructions, the diff, and other actors' edits before
227
+ continuing. If the old deadline has expired, provide a new window. Completed work
228
+ is retained; an interrupted command is not assumed to have succeeded.
229
+
230
+ ## Development and contributing
231
+
232
+ The workflow lives in [`skills/si-overnight/SKILL.md`](skills/si-overnight/SKILL.md).
233
+ Its `references/` directory holds host guidance and the checkpoint template.
234
+ `bin/` and `lib/` contain the dependency-free Node installer; `scripts/install.py`
235
+ is the Python alternative. Installer tests live in `tests/`.
236
+
237
+ To regenerate the workflow illustration, run `python3 scripts/render_workflow.py`.
238
+ The generator requires Pillow for development only; neither installer needs it.
239
+
240
+ Keep changes focused, update both READMEs when behavior changes, and include
241
+ verification evidence with your contribution. Run from the repository root:
122
242
 
123
243
  ```bash
124
244
  npm test
125
245
  python3 -m unittest discover -s tests -v
126
246
  ```
127
247
 
128
- ## CI ve npm yayını
129
-
130
- GitHub Actions her branch push'unda ve pull request'te Node.js 20 ve 24 ile iki
131
- test takımını çalıştırır. Node.js 24 işi ayrıca `npm pack --ignore-scripts` ile
132
- paketi oluşturur; boş bir npm cache'iyle, çevrimdışı ve geçici bir dizine kurar.
133
- Kurulan komutu ve tüm skill kaynaklarının byte eşitliğini kontrol eder.
134
- Test edilen `.tgz` ve SHA-256 özeti, 14 gün saklanan `npm-package` artifact'idir.
135
- Bağımlılık ve lockfile olmadığı için `npm ci` gerekmez.
136
-
137
- `v0.1.0` gibi bir `vMAJOR.MINOR.PATCH` etiketi push edilince `release.yml` aynı
138
- kontrolleri yeniden çalıştırır. Etiket `package.json` sürümüyle aynı olmalıdır;
139
- ön sürüm etiketleri reddedilir. Tüm işler başarılı olunca ayrı yayın işi artifact'in
140
- özetini doğrular ve aynı tarball'ı npm'e public/provenance ile yayımlar.
141
- Yalnız yayın işi OIDC izni alır; fork PR'ları yayın yapmaz. Action sürümleri
142
- [GitHub'ın önerdiği tam commit SHA'larına](https://docs.github.com/en/actions/reference/security/secure-use#using-third-party-actions)
143
- sabitlenmiştir. Paketleme, kurulum ve yayın lifecycle script'lerini çalıştırmaz.
144
-
145
- Bir defalık npm kurulumu:
146
-
147
- 1. npm hesabında `si-overnight` paketine yayın yetkisi edin. Paket henüz yoksa
148
- önce etkileşimli npm oturumu/2FA ile bir başlangıç yayını yap veya npm'in
149
- [staged publishing](https://docs.npmjs.com/staged-publishing/) akışıyla paket
150
- kaydını oluştur. Trusted Publisher ayarı mevcut bir paket gerektirir;
151
- [npm trust önkoşulları](https://docs.npmjs.com/cli/v11/commands/npm-trust/)
152
- bunu belirtir. Başlangıçta yayımlanan sürüm tekrar yayımlanamaz; otomatik akışta
153
- yeni bir sürüm kullan. Bu depodaki komutlar paket adının müsaitliğini veya
154
- hesap yetkisini doğrulamaz.
155
- 2. GitHub deposunun public, `package.json` içindeki `repository.url` değerinin
156
- `git+https://github.com/siguelabs/si.git` olduğundan emin ol;
157
- [npm provenance](https://docs.npmjs.com/generating-provenance-statements/)
158
- kaynak deposuyla eşleşme gerektirir.
159
- 3. npm → `si-overnight` → Settings → Trusted publishing altında **GitHub Actions**
160
- ekle: organization/user **siguelabs**, repository **si**, workflow filename
161
- **release.yml**; environment alanını boş bırak. **Allow npm publish** seçeneğini
162
- etkinleştir. Yeni ayarın ilk başarılı yayınını iki gün içinde tamamla; süresi
163
- geçerse ayarı yeniden oluştur. Ayrıntılar:
164
- [npm Trusted Publishers](https://docs.npmjs.com/trusted-publishers/).
165
- 4. Workflow dosyaları ve sürüm değişikliği depoya girdikten sonra eşleşen etiketi
166
- push et. Yayın runner'ı Node.js 24 kullanır ve npm ≥11.5.1 koşulunu denetler;
167
- OIDC'nin alt sınırları Node.js 22.14 ve npm 11.5.1'dir. Bu akışta `NPM_TOKEN`
168
- veya başka bir registry secret'ı gerekmez. Tag push'undan sonra yayın otomatik
169
- başlar; GitHub'da `v*` etiketlerini kimin oluşturabildiğini repository ruleset
170
- ile sınırla.
248
+ CI runs both suites on Node.js 20 and 24 for branch pushes and pull requests.
249
+ The Node.js 24 job also packs the package, installs it offline with an empty npm
250
+ cache, checks the CLI, and compares every installed skill resource byte for byte.
251
+ The tested tarball and SHA-256 digest are retained in the `npm-package` artifact
252
+ for 14 days. No dependency installation or lockfile is needed.
253
+
254
+ ### npm releases
255
+
256
+ A stable tag such as `v0.1.2` must match `package.json`. `release.yml` reruns CI,
257
+ verifies the artifact's checksum, and publishes that same tarball with public
258
+ access and provenance. Prerelease tags are rejected. Only the publish job gets
259
+ OIDC permission; it uses Node.js 24 and checks for npm 11.5.1 or newer. Actions
260
+ are pinned to full commit SHAs and lifecycle scripts are disabled.
261
+
262
+ For maintainers, configure npm Trusted Publishing for **siguelabs / si**, workflow
263
+ filename **release.yml**, with no environment, and enable **Allow npm publish**.
264
+ The package record must exist first, and the repository must be public with the
265
+ matching `repository.url`. This workflow requires no `NPM_TOKEN`. Restrict who
266
+ can create release tags through GitHub repository rulesets.
267
+
268
+ If the release is staged, a maintainer must approve it in npm **Staged Packages**
269
+ before users can install it. A successful staging step is not a public release.
270
+ See [npm staged publishing](https://docs.npmjs.com/staged-publishing/),
271
+ [Trusted Publishers](https://docs.npmjs.com/trusted-publishers/), and
272
+ [provenance requirements](https://docs.npmjs.com/generating-provenance-statements/).
273
+
274
+ ## License
275
+
276
+ `package.json` currently declares **`UNLICENSED`**. No open-source license grant
277
+ is included in this repository.
@@ -1,48 +1,5 @@
1
1
  #!/usr/bin/env node
2
2
 
3
- import { parseArgs } from 'node:util';
4
- import { installSkill } from '../lib/install.mjs';
3
+ import { runCli } from '../lib/cli.mjs';
5
4
 
6
- const help = `Usage: si-overnight --platform <name> [options]
7
-
8
- Install the si-overnight skill. No agent process or background job is started.
9
-
10
- Options:
11
- --platform <name> codex, claude, antigravity, pi, or all (repeatable)
12
- --scope <scope> project (default) or user
13
- --project <path> Existing target project directory (default: current directory)
14
- --dry-run Show destinations without writing files
15
- --help, -h Show this help
16
-
17
- Examples:
18
- si-overnight --platform all --project /path/to/project
19
- si-overnight --platform codex --scope user
20
- si-overnight --platform claude --platform pi --dry-run
21
- `;
22
-
23
- try {
24
- const { values } = parseArgs({
25
- options: {
26
- platform: { type: 'string', multiple: true },
27
- scope: { type: 'string', default: 'project' },
28
- project: { type: 'string' },
29
- 'dry-run': { type: 'boolean', default: false },
30
- help: { type: 'boolean', short: 'h' },
31
- },
32
- strict: true,
33
- allowPositionals: false,
34
- });
35
- if (values.help) {
36
- process.stdout.write(help);
37
- } else {
38
- installSkill({
39
- platforms: values.platform,
40
- scope: values.scope,
41
- project: values.project,
42
- dryRun: values['dry-run'],
43
- });
44
- }
45
- } catch (error) {
46
- console.error(`Install failed: ${error.message}`);
47
- process.exitCode = 1;
48
- }
5
+ process.exitCode = await runCli(process.argv.slice(2));
@@ -0,0 +1,269 @@
1
+ # si-overnight
2
+
3
+ [English](https://github.com/siguelabs/si/blob/main/README.md) · **Türkçe**
4
+
5
+ **Uyumadan kararları ver. Agent, belirlediğin işleri uygulasın, test etsin ve sabaha rapor bıraksın.**
6
+
7
+ `si-overnight`, mevcut coding agent'ına gece çalışma düzeni kazandıran taşınabilir
8
+ bir [Agent Skill](https://agentskills.io/). Önce projeyi inceler, sen hâlâ
9
+ çevrimiçiyken gerekli soruları toplar; ardından kararlaştırılan kapsamda çalışır.
10
+ Codex, Claude Code, Google Antigravity ve pi için kurulum aracı içerir.
11
+
12
+ ![si-overnight örnek gece akışı](https://raw.githubusercontent.com/siguelabs/si/main/docs/assets/overnight-workflow.gif)
13
+
14
+ *GIF, çalışma adımlarını gösteren bir canlandırmadır. Alt agent kullanımı çalıştırdığın platformun desteğine bağlıdır.*
15
+
16
+ ## Hızlı başlangıç
17
+
18
+ Önce [Node.js](https://nodejs.org/en/download) **20 veya üzerini** kur. Ardından
19
+ terminalde tek komut çalıştır:
20
+
21
+ ```bash
22
+ npx si-overnight
23
+ ```
24
+
25
+ Kurulum geri kalan adımlarda sana rehberlik eder:
26
+
27
+ 1. **Codex**, **Claude Code**, **Antigravity**, **pi** veya **All** seç.
28
+ 2. **All projects** (önerilen) ya da **Current project** seç.
29
+ 3. Coding agent'ının sohbetini açıp kurucunun gösterdiği skill komutunu yaz.
30
+
31
+ Repo klonlaman, Python kurman veya CLI bayraklarını bilmen gerekmez. All projects
32
+ skill'i kullanıcı dizinine kurar ve farklı projelerde kullanmanı sağlar. Current
33
+ project komutu çalıştırdığın dizine kurar. Aynı akışı `npx si-overnight install`
34
+ ile de başlatabilirsin.
35
+
36
+ ### Betiklerden veya kaynak koddan kurulum
37
+
38
+ Otomasyonda platform ve kapsamı açıkça seç. Bu deponun kök dizininde:
39
+
40
+ ```bash
41
+ # Önce kurulum hedeflerini gör.
42
+ node bin/si-overnight.mjs --platform all --project /tam/yol/projen --dry-run
43
+
44
+ # Seçtiğin projeye kur.
45
+ node bin/si-overnight.mjs --platform all --project /tam/yol/projen
46
+
47
+ # Ya da yalnız Codex için kullanıcı genelinde kur.
48
+ node bin/si-overnight.mjs --platform codex --scope user
49
+ ```
50
+
51
+ `--project` mevcut bir dizin olmalıdır. Kurulumdan sonra hedef projeyi agent'ında
52
+ aç ve aşağıdaki platform komutlarından biriyle skill'i çağır.
53
+
54
+ ### Npm üzerinden kurulum
55
+
56
+ En son yayımlanan sürümü kurmak için:
57
+
58
+ ```bash
59
+ npx --yes si-overnight --platform all --project /tam/yol/projen
60
+ ```
61
+
62
+ `npm install` tek başına skill'i agent dizinine kopyalamaz; kurulum CLI'sini
63
+ ayrıca çalıştırmalısın.
64
+
65
+ ## Hangi platformda nasıl çağırılır?
66
+
67
+ | Platform | Skill'i çağırma | Proje içindeki kurulum dizini |
68
+ | --- | --- | --- |
69
+ | Codex | `$si-overnight` veya `/skills` içinden seç | `.agents/skills/si-overnight/` |
70
+ | Claude Code | `/si-overnight` | `.claude/skills/si-overnight/` |
71
+ | Google Antigravity | `/si-overnight` | `.agents/skills/si-overnight/` |
72
+ | pi | `/skill:si-overnight` | `.pi/skills/si-overnight/` |
73
+
74
+ Kullanıcı genelinde kurulum Codex için `~/.agents/skills/`, Claude Code için
75
+ `~/.claude/skills/`, Antigravity için `~/.gemini/config/skills/`, pi için
76
+ `~/.pi/agent/skills/` altında aynı `si-overnight/` klasörünü oluşturur.
77
+
78
+ Diğer Agent Skills uyumlu araçlarda `skills/si-overnight/` klasörünü aracın
79
+ belgelediği konuma kopyala. Dosya okuyabilen başka bir agente `SKILL.md` dosyasını
80
+ okuyup uygulamasını da söyleyebilirsin. Komutların ve alt agent desteğinin bütün
81
+ platformlarda aynı olduğu varsayılmaz.
82
+
83
+ ## Bir gece nasıl ilerler?
84
+
85
+ ### 1. Sen uyumadan önce
86
+
87
+ Agent önce proje talimatlarını, mevcut değişiklikleri ve test düzenini inceler.
88
+ Ardından cevabı projeden veya konuşmadan çıkmayan önemli soruları birlikte sorar:
89
+
90
+ - Ana hedefler, öncelikleri ve işin bittiğini gösterecek ölçütler.
91
+ - Bu gece **Liste** mi, **Keşif** mi kullanılacağı.
92
+ - Yedek işler veya keşfe izin verilen alanlar.
93
+ - Dokunulmayacak dosyalar, API davranışları ve tasarım kararları.
94
+ - Çalışma süresi veya saat dilimiyle birlikte bitiş saati; varsa bilinen bütçe.
95
+ - Beklenen testler, gerekli servisler ve erişimler.
96
+ - Teslim biçimi ve commit, PR veya deployment gibi işlemlere verilen yetkiler.
97
+
98
+ Bu gece için cevapladığın soruları yeniden sormaz. Gerekli kararlar tamamlanınca
99
+ kısa planı kaydeder ve ayrıca bir başlama onayı turu üretmeden işe geçer.
100
+
101
+ ### 2. Gece modu seçilir
102
+
103
+ | Mod | Ana işler bitince | Ne zaman durur? |
104
+ | --- | --- | --- |
105
+ | **Liste / Queue** | Önceden kararlaştırılan yedek işleri yapar. | Onaylı liste bitince veya başka bir durma koşulu oluşunca. |
106
+ | **Keşif / Discover** | İzin verilen alanlarda kanıta dayalı iyileştirmeler bulur, önceliklendirir ve tek tek uygular. | Yararlı aday kalmayınca veya başka bir durma koşulu oluşunca. |
107
+
108
+ **Her yeni gece bu seçim yeniden sorulur.** Önceki gecenin modu kendiliğinden
109
+ taşınmaz. Kesilen aynı çalışmaya devam ederken mevcut gece sözleşmesi korunur.
110
+
111
+ Keşif modu için somut bir sınır örneği: “`src/cart/` ve `tests/cart/` içinde
112
+ doğrulanabilir bug fix ve regresyon testi yap; bağımlılık veya ödeme API'si
113
+ değiştirme.” Token tüketme isteği tek başına sınırsız proje kapsamı sayılmaz.
114
+
115
+ ### 3. Uygula → test et → incele → kaydet
116
+
117
+ Agent sıradaki en önemli, engellenmemiş işi seçer; değişikliği yapar, uygun
118
+ testleri çalıştırır, sonucu inceler ve ilerlemeyi kaydeder. Anlamlı bir hata
119
+ kanıtı varsa düzeltir. Önceden bozuk testleri yeni hatalardan ayırır; çalışmayan
120
+ veya çalıştırılamayan kontrolü geçti diye raporlamaz.
121
+
122
+ Bir iş yeni bir karar ya da erişim gerektiriyorsa onu engeliyle birlikte kaydeder
123
+ ve bağımsız, yetkilendirilmiş işlere devam eder. Aynı engelde yeni kanıt olmadan
124
+ üç başarısız denemeden sonra başka işe geçer. Sırf token harcamak için aynı
125
+ başarılı testleri tekrar tekrar çalıştırmaz.
126
+
127
+ ## Agent'lar nasıl birlikte çalışır?
128
+
129
+ Ana agent gece planının ve sonucun sahibidir. Platform alt agent destekliyorsa
130
+ bağımsız işler için görev dağıtabilir. Örneğin:
131
+
132
+ | Görev | Sorumluluk |
133
+ | --- | --- |
134
+ | Ana agent / koordinatör | Öncelikleri, kapsamı, süreyi ve son teslimi yönetir; sonuçları birleştirir. |
135
+ | Uygulama görevi | Kendi sorumluluğundaki dosyalarda belirli bir değişikliği yapar. |
136
+ | Test veya inceleme görevi | Bağımsız bir işi doğrular, regresyonları veya diff'teki somut sorunları inceler. |
137
+
138
+ Bu tablo sabit bir agent kadrosu tanımlamaz; görevler ihtiyaca göre seçilir.
139
+ Çakışan dosya yazımlarından kaçınılır, bütün çalışanlar aynı kapsam ve süreye
140
+ tabidir ve ana agent dönen sonuçları doğrular. Alt agent desteği yoksa aynı akış
141
+ tek agent ile yürütülür. Skill bu desteği platforma sonradan eklemez.
142
+
143
+ ## Örnek gece isteği
144
+
145
+ Codex için:
146
+
147
+ ```text
148
+ $si-overnight
149
+ Ana hedef: sepetteki doğrulanmış hataları düzelt ve regresyon testlerini ekle.
150
+ Bu gece Liste mi Keşif mi kullanacağımızı uyumadan bana sor.
151
+ Dokunma: ödeme API kontratları ve mevcut kullanıcı değişiklikleri.
152
+ En fazla 6 saat çalış. Teslim: yerel değişiklikler ve sabah raporu.
153
+ Gerekli diğer kararları ben çevrimiçiyken birlikte sor.
154
+ ```
155
+
156
+ Diğer platformlarda ilk satırı o platformun çağırma komutuyla değiştir.
157
+
158
+ ## Kayıtlar, sabah raporu ve devam etme
159
+
160
+ Her çalışma hedef projede ayrı bir klasöre yazılır:
161
+
162
+ ```text
163
+ .si-overnight/
164
+ └── <run-id>/
165
+ ├── run.md # Kapsam, kararlar, işler, son kontrol ve sıradaki adım
166
+ └── report.md # Tamamlananlar, test kanıtları, eksikler ve durma nedeni
167
+ ```
168
+
169
+ Kayıtlar varsayılan olarak yerelde tutulur; açıkça istemedikçe commit'e alınmaz.
170
+ Skill sırf bu dosyaları gizlemek için `.gitignore` veya repo ayarlarını değiştirmez.
171
+ Gizli anahtarlar ve hassas komut çıktıları kayıtlara yazılmaz.
172
+
173
+ Devam örneği:
174
+
175
+ ```text
176
+ $si-overnight
177
+ .si-overnight/<run-id>/run.md dosyasındaki çalışmaya devam et.
178
+ Önce kaydı mevcut dosyalarla karşılaştır. Aynı kapsamı koru.
179
+ Eski süre dolduysa bu andan itibaren 2 saatlik yeni pencere kullan.
180
+ ```
181
+
182
+ Agent bir komutun kesintiden önce başarıyla bittiğini varsaymaz; mevcut dosyaları,
183
+ sonuçları ve diğer kişilerin değişikliklerini kayıtla karşılaştırır.
184
+
185
+ ## Çalışma ne zaman biter?
186
+
187
+ Onaylı işler bittiğinde, kapsam içinde yararlı keşif kalmadığında, süre veya
188
+ gözlemlenebilir kota sınırı dolduğunda, bütün kalan işler engellendiğinde ya da sen
189
+ durmasını istediğinde çalışmayı sonlandırır. Ölçülemeyen kalan kotayı tahmin diye
190
+ sunmaz.
191
+
192
+ **Skill bir süreç yöneticisi değildir.** Bilgisayarı uyanık tutmaz, kapanan agent'ı
193
+ yeniden başlatmaz, yeni model turları oluşturmaz veya kota yenilemez. Yerel
194
+ makine/oturum veya gerçekten uzakta çalışan ortam kullanılabilir kalmalıdır.
195
+ Ani kesintide son kayıttan devam edilebilir; durmuş süreç sonradan rapor yazamaz.
196
+ Host'un uzun çalışma özelliği ayrıca kullanılabilir; bu skill kendiliğinden bir
197
+ Goal, zamanlanmış görev veya arka plan runner'ı oluşturmaz.
198
+
199
+ ## CLI seçenekleri ve Python alternatifi
200
+
201
+ | Seçenek | Değer / davranış |
202
+ | --- | --- |
203
+ | `--platform` | Betik kurulumunda `codex`, `claude`, `antigravity`, `pi` veya `all`; tekrarlanabilir. |
204
+ | `--scope` | Bayraklı kurulumda varsayılan `project`; rehberli kurulum `user` (All projects) önerir. |
205
+ | `--project` | Mevcut proje dizini; varsayılan geçerli dizin. Kullanıcı kapsamını değiştirmez. |
206
+ | `--dry-run` | Hedefleri gösterir, dosya yazmaz. |
207
+ | `--help` | Yardımı gösterir. |
208
+
209
+ Rehberli kurulum etkileşimli terminal gerektirir. CI veya betiklerde `--platform`
210
+ ve istediğin `--scope` değerini açıkça ver.
211
+
212
+ Npm CLI'sinde birden fazla platform için bayrağı tekrarla:
213
+
214
+ ```bash
215
+ node bin/si-overnight.mjs --platform claude --platform pi --dry-run
216
+ ```
217
+
218
+ Kurucu farklı bir mevcut skill'in üzerine yazmaz; içerik aynıysa dosyaları
219
+ değiştirmez. Seçtiğin kökün altındaki kurulum yollarında sembolik bağlantılar
220
+ reddedilir. Açıkça seçilen kökün kendisi bir dizin takma adı olabilir. Güncellemede
221
+ mevcut kurulumu inceleyip taşıdıktan sonra yeniden kur. Kurulum agent izinlerini
222
+ değiştirmez veya çalışmayı başlatmaz.
223
+
224
+ Kaynak kod deposunda Python 3 alternatifi de bulunur:
225
+
226
+ ```bash
227
+ python3 scripts/install.py --platform all --project /tam/yol/projen
228
+ ```
229
+
230
+ ## Geliştirme ve sürüm yayımlama
231
+
232
+ ```bash
233
+ npm test
234
+ python3 -m unittest discover -s tests -v
235
+ node .github/scripts/pack-smoke.mjs /tmp/si-overnight-package-check
236
+ ```
237
+
238
+ Son komutun çıktı dizini boş olmalıdır. Gerçek `.tgz` dosyasını boş npm cache'iyle
239
+ çevrimdışı kurar, CLI'yi ve skill dosyalarının byte eşitliğini kontrol eder.
240
+
241
+ README'deki canlandırmayı yeniden oluşturmak için `python3 scripts/render_workflow.py`
242
+ çalıştır. Bu geliştirme aracı Pillow gerektirir; npm kurucusunun runtime bağımlılığı
243
+ değildir.
244
+
245
+ CI her branch push'unda ve PR'da Node.js 20/24 ile testleri çalıştırır; paket ve
246
+ SHA-256 özeti `npm-package` artifact'i olarak hazırlanır. Sürümle eşleşen
247
+ `vMAJOR.MINOR.PATCH` etiketi, testler geçtikten sonra aynı paketi npm'e yayımlar.
248
+ Ön sürüm etiketleri mevcut release akışında desteklenmez.
249
+
250
+ İlk npm kaydı için hesabın yayın yetkisi gerekir. Staged bir sürüm varsa npm
251
+ profilindeki **Staged Packages** üzerinden inceleyip 2FA ile onayla. Yayımlanmış
252
+ aynı isim/sürüm yeniden kullanılamaz. [Staged publishing belgesi](https://docs.npmjs.com/staged-publishing/).
253
+
254
+ Otomatik yayın için paket **Settings → Trusted publishing → GitHub Actions**
255
+ ayarında owner `siguelabs`, repo `si`, workflow `release.yml`, environment boş ve
256
+ **Allow npm publish** açık olmalıdır. Bu OIDC akışı `NPM_TOKEN` secret'ı
257
+ gerektirmez. Yeni bağlantının ilk yayını iki gün içinde yapılmalıdır. Provenance
258
+ için kaynak repo public ve `repository.url` aynı GitHub deposuna bağlı olmalıdır.
259
+ Yayın işi Node.js 24 ve npm ≥11.5.1 kullanır/kontrol eder.
260
+ [Trusted publishing belgesi](https://docs.npmjs.com/trusted-publishers/).
261
+
262
+ Kod yapısı: `skills/si-overnight/` ortak çalışma talimatlarını, `bin/` ve `lib/`
263
+ Node kurucusunu, `scripts/install.py` Python alternatifini, `tests/` kontrolleri,
264
+ `.github/` CI ve release akışlarını içerir. Platformlara ilişkin resmi kaynaklar
265
+ [uyumluluk notlarında](../../skills/si-overnight/references/platforms.md) bulunur.
266
+
267
+ Katkı yaparken kurucu değişikliklerini ilgili testlerle doğrula; çalışma akışı
268
+ değişikliklerinde iki dildeki README'yi birlikte güncelle. Paket şu anda
269
+ **`UNLICENSED`** olarak tanımlıdır; açık kaynak kullanım lisansı verilmemiştir.
package/lib/cli.mjs ADDED
@@ -0,0 +1,145 @@
1
+ import { createInterface } from 'node:readline';
2
+ import { parseArgs } from 'node:util';
3
+ import { installationTargets, installSkill } from './install.mjs';
4
+
5
+ const HOSTS = [
6
+ { name: 'codex', label: 'Codex', command: '$si-overnight' },
7
+ { name: 'claude', label: 'Claude Code', command: '/si-overnight' },
8
+ { name: 'antigravity', label: 'Antigravity', command: '/si-overnight' },
9
+ { name: 'pi', label: 'pi', command: '/skill:si-overnight' },
10
+ ];
11
+
12
+ const help = `Usage: npx si-overnight [install] [options]
13
+
14
+ Run without options for guided setup. Choose your coding agent, then install for
15
+ all projects in your user account (default) or just the current project.
16
+ Installation does not start an agent or a background job.
17
+
18
+ Options (skip guided setup):
19
+ --platform <name> codex, claude, antigravity, pi, or all (repeatable; required)
20
+ --scope <scope> project (default with options) or user
21
+ --project <path> Existing target project directory (default: current directory)
22
+ --dry-run Show destinations without writing files
23
+ --help, -h Show this help
24
+
25
+ Examples:
26
+ npx si-overnight
27
+ npx si-overnight install
28
+ npx si-overnight --platform all --scope user
29
+ npx si-overnight --platform codex --project /path/to/project
30
+ npx si-overnight --platform claude --platform pi --dry-run
31
+ `;
32
+
33
+ function invocationGuidance(output, platforms) {
34
+ output.write('\nReady. Open or restart your coding agent in your project, then enter:\n');
35
+ for (const host of HOSTS) {
36
+ if (platforms.includes('all') || platforms.includes(host.name)) {
37
+ output.write(` ${host.label}: ${host.command}\n`);
38
+ }
39
+ }
40
+ }
41
+
42
+ function hostChoice(answer) {
43
+ const choices = new Map(HOSTS.flatMap((host, index) => [
44
+ [String(index + 1), host.name], [host.name, host.name], [host.label.toLowerCase(), host.name],
45
+ ]));
46
+ choices.set('5', 'all');
47
+ choices.set('all', 'all');
48
+ return choices.get(answer);
49
+ }
50
+
51
+ async function guidedOptions({ input, promptOutput, project, userHome }) {
52
+ // RTK and other command wrappers can pipe stdout while stdin remains a terminal.
53
+ if (!input.isTTY || input.readableEnded || input.destroyed) {
54
+ throw new Error('Guided setup needs an interactive terminal. Run npx si-overnight in your terminal, or use: npx si-overnight --platform all --scope user');
55
+ }
56
+
57
+ const lines = createInterface({
58
+ input, output: promptOutput, terminal: Boolean(promptOutput.isTTY), crlfDelay: Infinity,
59
+ });
60
+ // Attach the iterator before prompting so pasted answers cannot be lost.
61
+ const answers = lines[Symbol.asyncIterator]();
62
+ let closed = false;
63
+ lines.once('close', () => { closed = true; });
64
+ lines.once('SIGINT', () => lines.close());
65
+ const question = async (prompt) => {
66
+ promptOutput.write(prompt);
67
+ const answer = await answers.next();
68
+ if (answer.done || closed) return undefined;
69
+ const value = answer.value.trim().toLowerCase();
70
+ return ['q', 'quit', 'cancel', 'exit', '\u0003'].includes(value) ? undefined : value;
71
+ };
72
+ const cancel = () => {
73
+ promptOutput.write('\nSetup cancelled. No files were written.\n');
74
+ return undefined;
75
+ };
76
+
77
+ try {
78
+ promptOutput.write('si-overnight setup\n\nChoose your coding agent:\n');
79
+ HOSTS.forEach((host, index) => promptOutput.write(` ${index + 1}. ${host.label}\n`));
80
+ promptOutput.write(' 5. All\n');
81
+ const host = await question('Choose 1-5 (or q to cancel): ');
82
+ if (host === undefined || host === '') return cancel();
83
+ const platform = hostChoice(host);
84
+ if (!platform) throw new Error('Invalid coding agent. Choose 1-5 or a listed name. No files were written.');
85
+
86
+ promptOutput.write('\nWhere should the skill be available?\n 1. All projects (your user account; default)\n');
87
+ promptOutput.write(` 2. Current project (${project})\n`);
88
+ const scopeAnswer = await question('Choose 1-2 [1] (or q to cancel): ');
89
+ if (scopeAnswer === undefined) return cancel();
90
+ let scope;
91
+ if (['', '1', 'user', 'all', 'all projects'].includes(scopeAnswer)) scope = 'user';
92
+ if (['2', 'project', 'current', 'current project'].includes(scopeAnswer)) scope = 'project';
93
+ if (!scope) throw new Error('Invalid install location. Choose 1 or 2. No files were written.');
94
+
95
+ const options = { platforms: [platform], scope, project, userHome };
96
+ const { destinations } = installationTargets(options);
97
+ promptOutput.write('\nInstall locations:\n');
98
+ for (const destination of destinations) promptOutput.write(` ${destination}\n`);
99
+ promptOutput.write('\nInstalling...\n');
100
+ return options;
101
+ } finally {
102
+ lines.close();
103
+ }
104
+ }
105
+
106
+ export async function runCli(args, {
107
+ input = process.stdin, output = process.stdout, error = process.stderr,
108
+ project = process.cwd(), userHome,
109
+ } = {}) {
110
+ try {
111
+ const optionsArgs = args[0] === 'install' ? args.slice(1) : args;
112
+ let options;
113
+ if (optionsArgs.length === 0) {
114
+ options = await guidedOptions({ input, promptOutput: error, project, userHome });
115
+ if (!options) return 0;
116
+ } else {
117
+ const { values } = parseArgs({
118
+ args: optionsArgs,
119
+ options: {
120
+ platform: { type: 'string', multiple: true },
121
+ scope: { type: 'string', default: 'project' },
122
+ project: { type: 'string' },
123
+ 'dry-run': { type: 'boolean', default: false },
124
+ help: { type: 'boolean', short: 'h' },
125
+ },
126
+ strict: true,
127
+ allowPositionals: false,
128
+ });
129
+ if (values.help) {
130
+ output.write(help);
131
+ return 0;
132
+ }
133
+ options = {
134
+ platforms: values.platform, scope: values.scope, project: values.project ?? project,
135
+ userHome, dryRun: values['dry-run'],
136
+ };
137
+ }
138
+ installSkill({ ...options, log: (message) => output.write(`${message}\n`) });
139
+ if (!options.dryRun) invocationGuidance(output, options.platforms);
140
+ return 0;
141
+ } catch (cause) {
142
+ error.write(`Install failed: ${cause.message}\n`);
143
+ return 1;
144
+ }
145
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "si-overnight",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "Install a portable overnight coding workflow for Codex, Claude Code, Antigravity, and pi.",
5
5
  "repository": {
6
6
  "type": "git",
@@ -14,7 +14,9 @@
14
14
  "bin/",
15
15
  "lib/",
16
16
  "skills/si-overnight/",
17
- "README.md"
17
+ "README.md",
18
+ "docs/tr/README.md",
19
+ "docs/assets/overnight-workflow.gif"
18
20
  ],
19
21
  "engines": {
20
22
  "node": ">=20"