si-overnight 0.1.1 → 0.1.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/README.md CHANGED
@@ -1,270 +1,61 @@
1
1
  # si-overnight
2
2
 
3
- **English** · [Türkçe](https://github.com/siguelabs/si/blob/main/README.tr.md)
3
+ **English** · [Türkçe](https://github.com/siguelabs/si/blob/main/docs/tr/README.md)
4
4
 
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.
5
+ Give your coding agent a few tasks before bed. It asks what it needs to know,
6
+ works and tests while you're away, and leaves you a report.
7
7
 
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.
8
+ ## Install
11
9
 
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)
13
-
14
- *Illustrative workflow diagram, not a recording of an agent session. Parallel
15
- workers are optional and require host support.*
16
-
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)
20
-
21
- ## Quick start
22
-
23
- Use the source checkout today. The Node.js installer requires **Node.js 20+**,
24
- has no package dependencies, and does not require Python.
25
-
26
- ```bash
27
- git clone https://github.com/siguelabs/si.git
28
- cd si
29
- node bin/si-overnight.mjs --platform codex --project /absolute/path/to/project
30
- ```
31
-
32
- If you already have this repository, run the `node bin/si-overnight.mjs ...`
33
- command from its root. Choose `claude`, `antigravity`, or `pi` for another host,
34
- or `all` for every supported host. The target project directory must already
35
- exist. Open that project in your host and invoke the skill with its command below.
36
-
37
- For example, in Codex:
38
-
39
- ```text
40
- $si-overnight
41
- Tonight, fix the checkout bugs in issues #12 and #18.
42
- Ask me for the remaining decisions before I leave.
43
- Work for at most six hours from the start of this run.
44
- ```
45
-
46
- Replace the tasks and deadline with your own. The agent inspects the project and
47
- collects the missing decisions before implementation starts. A bare invocation
48
- starts intake; it does not authorize an unspecified night of changes.
49
-
50
- ### npm installation
51
-
52
- Install the latest published release:
10
+ You'll need [Node.js 20 or newer](https://nodejs.org/en/download) and one of the
11
+ coding apps below. Run this command in your terminal.
53
12
 
54
13
  ```bash
55
- npx --yes si-overnight --platform all --project /absolute/path/to/project
56
- npx --yes si-overnight --platform codex --scope user
14
+ npx si-overnight
57
15
  ```
58
16
 
59
- To try the current package without a registry release, run from this repository:
60
-
61
- ```bash
62
- npm pack --ignore-scripts
63
- npm exec --yes --package ./si-overnight-0.1.1.tgz -- si-overnight --platform codex --project /absolute/path/to/project
64
- ```
65
-
66
- Installing the npm package, including globally, only makes the installer command
67
- available. It does not install skills automatically or launch an agent. Run the
68
- installer explicitly, then invoke the skill in your host.
69
-
70
- ## How it works
71
-
72
- ### 1. Agree on tonight's work
73
-
74
- The agent reads project instructions, existing changes, build commands, and test
75
- setup. For **each new night**, it asks you to choose a mode unless you have already
76
- chosen one for that run:
77
-
78
- | Mode | After the primary tasks |
79
- | --- | --- |
80
- | **Queue** | Finish your agreed backup tasks, then stop. |
81
- | **Discover** | Find and implement useful improvements inside the areas and categories you agreed on. |
82
-
83
- Last night's choice is not a permanent preference. Resuming an existing run keeps
84
- that run's mode and scope.
85
-
86
- Before you leave, the agent batches the consequential questions:
87
-
88
- - What outcomes matter most, and what proves they are done?
89
- - Which backup tasks or discovery areas are allowed? Are dependency changes or broad refactors included?
90
- - Which paths, APIs, behavior, data, or design decisions must remain unchanged?
91
- - When should work stop, with a date and timezone or duration? Is there a known spend or token cap?
92
- - Which tests and services are available? Are access or permission prompts likely?
93
- - Should delivery be local edits and a report, or are commits, a push/PR, deployment, or other external actions authorized?
94
-
95
- It reuses answers already in the conversation and checks likely blockers while
96
- you can still respond. Your answers authorize the agreed work; no extra start
97
- confirmation is needed. Unanswered questions remain unanswered when you go offline.
98
-
99
- ### 2. Implement, test, review, checkpoint
100
-
101
- The agent saves the run contract and repeats this loop while useful authorized
102
- work and time remain:
103
-
104
- 1. Read the checkpoint; check scope, time, and any observable budget.
105
- 2. Pick the highest-priority unblocked task and implement a bounded change.
106
- 3. Run focused tests, fix demonstrated regressions, and run required broader checks.
107
- 4. Review the diff for correctness, scope, and unrelated changes.
108
- 5. Save the evidence, work in progress, and next action before continuing.
17
+ If npm asks whether to install the package, press Enter to continue.
109
18
 
110
- Existing user edits are preserved. A blocked task is recorded while independent
111
- work continues. Repeated attempts without new evidence are bounded. Passing tests
112
- are not rerun merely to consume tokens, and unavailable checks are not reported
113
- as passing.
19
+ 1. Pick your coding app. Choose **All** if you use more than one.
20
+ 2. Pick **All projects** to use the skill across your projects, or **Current project** for the folder you're in.
21
+ 3. Open your project in your coding app. In its chat, enter the command the installer shows you.
114
22
 
115
- **Optional subagents:** on hosts that support them, the main agent can coordinate
116
- independent tasks and assign nonoverlapping file ownership. It may also delegate
117
- tests or a review, then verify the results. These are task assignments chosen for
118
- the run, not a built-in team of always-on agents. Every worker shares the same
119
- scope, deadline, and permissions.
120
-
121
- ### 3. Stop with a useful handoff
122
-
123
- Work stops when the Queue is complete, scoped Discover work has no worthwhile
124
- candidate left, the deadline or an observable budget/provider limit is reached,
125
- all remaining work is blocked, you request a stop, or the host ends execution.
126
-
127
- The agent writes these files in the target project, using your language:
128
-
129
- | File | Contents |
130
- | --- | --- |
131
- | `.si-overnight/<run-id>/run.md` | Scope, answers, baseline, task queue, latest checkpoint, and verification evidence. |
132
- | `.si-overnight/<run-id>/report.md` | Completed outcomes, changed files, test results, unfinished work, stop reason, and a resume prompt. |
133
-
134
- Run files stay local and out of staging unless you ask to version them. Checkpoints
135
- are saved after completed tasks, material failed attempts, and permission blockers,
136
- and before risky operations or context handoffs. See the
137
- [checkpoint template](skills/si-overnight/references/run-template.md).
138
-
139
- ## Hosts and installation paths
140
-
141
- `--scope project` installs below the selected project; `--scope user` installs
142
- below your home directory. Each destination contains `SKILL.md` and its references.
143
-
144
- | Host / `--platform` | Project path | User path | Invocation |
145
- | --- | --- | --- | --- |
146
- | Codex / `codex` | `.agents/skills/si-overnight/` | `~/.agents/skills/si-overnight/` | `$si-overnight` or select via `/skills` |
147
- | Claude Code / `claude` | `.claude/skills/si-overnight/` | `~/.claude/skills/si-overnight/` | `/si-overnight` |
148
- | Google Antigravity / `antigravity` | `.agents/skills/si-overnight/` | `~/.gemini/config/skills/si-overnight/` | `/si-overnight` |
149
- | pi / `pi` | `.pi/skills/si-overnight/` | `~/.pi/agent/skills/si-overnight/` | `/skill:si-overnight` |
150
-
151
- Codex and Antigravity share a project destination, so `all` installs one copy
152
- there. For other Agent Skills-compatible hosts, copy `skills/si-overnight/` into
153
- the host's documented skill directory and use its invocation mechanism. If a host
154
- can read files but has no native skill support, explicitly ask it to read and
155
- follow `SKILL.md`; that does not register a slash command.
156
-
157
- Paths and commands depend on the installed host version. See
158
- [compatibility notes and official sources](skills/si-overnight/references/platforms.md).
159
-
160
- ### Installer options
161
-
162
- ```bash
163
- node bin/si-overnight.mjs --platform claude --platform pi --dry-run
164
- node bin/si-overnight.mjs --platform codex --scope user
165
- node bin/si-overnight.mjs --help
166
- ```
167
-
168
- | Option | Behavior |
23
+ | Coding app | Command to enter in the app's chat |
169
24
  | --- | --- |
170
- | `--platform <name>` | Required. `codex`, `claude`, `antigravity`, `pi`, or `all`; repeatable. |
171
- | `--scope <scope>` | `project` by default, or `user`. |
172
- | `--project <path>` | Existing project directory; defaults to the current directory. Used for project scope. |
173
- | `--dry-run` | Validate and show destinations without writing files. |
174
- | `--help`, `-h` | Show CLI help. |
25
+ | Codex | `$si-overnight` or pick `si-overnight` from `/skills` |
26
+ | Claude Code | `/si-overnight` |
27
+ | Google Antigravity | `/si-overnight` |
28
+ | pi | `/skill:si-overnight` |
175
29
 
176
- The installer leaves identical installations untouched and refuses to overwrite
177
- different content. To update, review and move the existing skill directory, then
178
- install again. It checks all destinations before writing, rejects symbolic links
179
- inside the source or destination tree and below the selected installation root,
180
- and prevents source/destination overlap. The selected project or home root itself
181
- may be a directory alias. Avoid concurrent changes to installation directories.
182
- Installation does not change host permissions or start background processes.
30
+ ## Use it tonight
183
31
 
184
- A **Python 3 alternative** is available from the repository, with the same
185
- destinations, dry-run behavior, and protection for existing content:
186
-
187
- ```bash
188
- python3 scripts/install.py --platform all --project /absolute/path/to/project
189
- python3 scripts/install.py --platform codex --scope user --dry-run
190
- ```
191
-
192
- ## Execution time and budgets
193
-
194
- The skill cannot keep a computer awake, restart a stopped agent, renew a quota,
195
- or create new turns after the host stops. Leave the local machine, session, agent,
196
- and required services available, or use a host that actually executes remotely.
197
- A sudden termination may leave only the latest checkpoint; a stopped process
198
- cannot write a new morning report.
199
-
200
- A token or spend cap can only be monitored when the host exposes reliable usage
201
- data. Otherwise usage is recorded as unknown. The skill does not promise to
202
- consume every available token or wait for quota resets.
203
-
204
- On Codex versions with Goal mode, you can explicitly start `/goal` with the agreed
205
- overnight plan. Invoking this skill does not create a goal or schedule. Other
206
- hosts may need a separately configured runner for repeated invocations; this
207
- package does not include one. Host approval requirements still apply.
208
-
209
- ## Resume a run
210
-
211
- Invoke the skill in your host and name the saved checkpoint:
32
+ Here's an example for Codex. Use your app's command on the first line.
212
33
 
213
34
  ```text
214
- Use si-overnight. Resume .si-overnight/<run-id>/run.md.
215
- Reconcile the checkpoint with the working tree first and keep the agreed scope.
216
- The new execution window ends at <date, time, timezone>.
35
+ $si-overnight
36
+ Fix the bug where clicking Save twice creates two copies.
37
+ Ask me any questions before I leave. Work for up to two hours.
217
38
  ```
218
39
 
219
- The agent checks current instructions, the diff, and other actors' edits before
220
- continuing. If the old deadline has expired, provide a new window. Completed work
221
- is retained; an interrupted command is not assumed to have succeeded.
222
-
223
- ## Development and contributing
224
-
225
- The workflow lives in [`skills/si-overnight/SKILL.md`](skills/si-overnight/SKILL.md).
226
- Its `references/` directory holds host guidance and the checkpoint template.
227
- `bin/` and `lib/` contain the dependency-free Node installer; `scripts/install.py`
228
- is the Python alternative. Installer tests live in `tests/`.
40
+ Before you go, the agent checks your project and asks about the tasks, what to
41
+ leave alone, and when to stop. You choose what it does after the main tasks.
229
42
 
230
- To regenerate the workflow illustration, run `python3 scripts/render_workflow.py`.
231
- The generator requires Pillow for development only; neither installer needs it.
232
-
233
- Keep changes focused, update both READMEs when behavior changes, and include
234
- verification evidence with your contribution. Run from the repository root:
235
-
236
- ```bash
237
- npm test
238
- python3 -m unittest discover -s tests -v
239
- ```
43
+ - **Queue** works through the backup tasks you agreed on, then stops.
44
+ - **Discover** looks for useful fixes or improvements in the areas you allowed.
240
45
 
241
- CI runs both suites on Node.js 20 and 24 for branch pushes and pull requests.
242
- The Node.js 24 job also packs the package, installs it offline with an empty npm
243
- cache, checks the CLI, and compares every installed skill resource byte for byte.
244
- The tested tarball and SHA-256 digest are retained in the `npm-package` artifact
245
- for 14 days. No dependency installation or lockfile is needed.
46
+ It works through the tasks, runs tests, and saves its progress. If your app
47
+ supports additional agents, it can give them separate tasks and check their work.
246
48
 
247
- ### npm releases
49
+ ![Example of the overnight workflow](https://raw.githubusercontent.com/siguelabs/si/main/docs/assets/overnight-workflow.gif)
248
50
 
249
- A stable tag such as `v0.1.1` must match `package.json`. `release.yml` reruns CI,
250
- verifies the artifact's checksum, and publishes that same tarball with public
251
- access and provenance. Prerelease tags are rejected. Only the publish job gets
252
- OIDC permission; it uses Node.js 24 and checks for npm 11.5.1 or newer. Actions
253
- are pinned to full commit SHAs and lifecycle scripts are disabled.
51
+ ## Check what happened
254
52
 
255
- For maintainers, configure npm Trusted Publishing for **siguelabs / si**, workflow
256
- filename **release.yml**, with no environment, and enable **Allow npm publish**.
257
- The package record must exist first, and the repository must be public with the
258
- matching `repository.url`. This workflow requires no `NPM_TOKEN`. Restrict who
259
- can create release tags through GitHub repository rulesets.
53
+ Look in `.si-overnight/` inside your project. Each run has its own folder.
260
54
 
261
- If the release is staged, a maintainer must approve it in npm **Staged Packages**
262
- before users can install it. A successful staging step is not a public release.
263
- See [npm staged publishing](https://docs.npmjs.com/staged-publishing/),
264
- [Trusted Publishers](https://docs.npmjs.com/trusted-publishers/), and
265
- [provenance requirements](https://docs.npmjs.com/generating-provenance-statements/).
55
+ - `report.md` tells you what changed, which tests ran, and what's left.
56
+ - `run.md` saves the plan and progress. To resume, run the skill again and give it this file's path.
266
57
 
267
- ## License
58
+ Keep your coding session running. If your computer sleeps or the app stops, you
59
+ can pick up from `run.md` when you return.
268
60
 
269
- `package.json` currently declares **`UNLICENSED`**. No open-source license grant
270
- is included in this repository.
61
+ [Installation options, platform details, and development](https://github.com/siguelabs/si/blob/main/docs/development.md)
@@ -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,62 @@
1
+ # si-overnight
2
+
3
+ [English](https://github.com/siguelabs/si/blob/main/README.md) · **Türkçe**
4
+
5
+ Yatmadan önce kod yazan yapay zekâ aracınla yapılacak işleri belirle.
6
+ `si-overnight`, sen uyurken aracın proje üzerinde çalışmasına ve sabaha bir rapor bırakmasına yardımcı olur.
7
+
8
+ ## Nasıl kurulur?
9
+
10
+ Önce Node.js 20 veya üzerini kur. [Node.js’i indir](https://nodejs.org/en/download)
11
+
12
+ Terminali aç ve şu komutu çalıştır.
13
+
14
+ ```bash
15
+ npx si-overnight
16
+ ```
17
+
18
+ npm paketi kurmak için onay isterse Enter’a bas.
19
+
20
+ 1. Kullandığın aracı seç. Hepsine kurmak için **All** seçeneğini kullan.
21
+ 2. Tüm projelerinde kullanmak için **All projects**, yalnızca terminalde bulunduğun projeye kurmak için **Current project** seç.
22
+ 3. Çalışılacak projeyi yapay zekâ aracında aç ve aşağıdaki komutu aracın **sohbetine** yaz.
23
+
24
+ | Araç | Sohbette kullanacağın komut |
25
+ | --- | --- |
26
+ | Codex | `$si-overnight` veya `/skills` menüsünden `si-overnight` |
27
+ | Claude Code | `/si-overnight` |
28
+ | Google Antigravity | `/si-overnight` |
29
+ | pi | `/skill:si-overnight` |
30
+
31
+ Örneğin Codex’te şöyle başlayabilirsin.
32
+
33
+ ```text
34
+ $si-overnight
35
+ Kaydet düğmesine iki kez basınca oluşan çift kayıt hatasını düzelt.
36
+ Gitmeden önce gerekli soruları sor. En fazla iki saat çalış.
37
+ ```
38
+
39
+ ## Gece neler olur?
40
+
41
+ Araç önce projeyi inceler. Sen yatmadan eksik kararları sorar. Hangi işin önce
42
+ yapılacağını, nerelere dokunabileceğini ve ne kadar çalışacağını birlikte belirlersiniz.
43
+
44
+ Ana işler bitince ne yapacağını her yeni gece için seçersin.
45
+
46
+ - **Liste (Queue)** ile araç önceden belirlediğin yedek işleri de yapar ve liste bitince durur.
47
+ - **Keşif (Discover)** ile araç izin verdiğin alanlarda iyileştirmeler bulup uygular.
48
+
49
+ Araç değişiklikleri yapar, testleri çalıştırır ve ilerlemesini kaydeder.
50
+ Kullandığın araç destekliyorsa birbirinden bağımsız birkaç işi aynı anda yürütebilir.
51
+
52
+ ![Gece çalışma adımlarını gösteren canlandırma](https://raw.githubusercontent.com/siguelabs/si/main/docs/assets/overnight-workflow.gif)
53
+
54
+ Kendi bilgisayarında çalışıyorsan gece boyunca bilgisayarın uyanık, yapay zekâ aracın açık kalmalı.
55
+
56
+ ## Raporu nerede bulurum?
57
+
58
+ Projedeki `.si-overnight/<run-id>/report.md` dosyasında tamamlanan işleri, test
59
+ sonuçlarını ve varsa kalan işleri görebilirsin. Çalışma yarıda kalırsa araçtan
60
+ aynı klasördeki `run.md` dosyasını okuyup devam etmesini iste.
61
+
62
+ [Platformlara göre kurulum yerleri](https://github.com/siguelabs/si/blob/main/skills/si-overnight/references/platforms.md) · [Geliştirici rehberi](https://github.com/siguelabs/si/blob/main/docs/development.md)
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.1",
3
+ "version": "0.1.3",
4
4
  "description": "Install a portable overnight coding workflow for Codex, Claude Code, Antigravity, and pi.",
5
5
  "repository": {
6
6
  "type": "git",
@@ -15,7 +15,7 @@
15
15
  "lib/",
16
16
  "skills/si-overnight/",
17
17
  "README.md",
18
- "README.tr.md",
18
+ "docs/tr/README.md",
19
19
  "docs/assets/overnight-workflow.gif"
20
20
  ],
21
21
  "engines": {
package/README.tr.md DELETED
@@ -1,247 +0,0 @@
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
- Node.js **20 veya üzeri** yeterli. Npm CLI'si Python veya ek runtime bağımlılığı
19
- gerektirmez. Bu deponun kök dizininde:
20
-
21
- ```bash
22
- # Önce kurulum hedeflerini gör.
23
- node bin/si-overnight.mjs --platform all --project /tam/yol/projen --dry-run
24
-
25
- # Seçtiğin projeye kur.
26
- node bin/si-overnight.mjs --platform all --project /tam/yol/projen
27
-
28
- # Ya da yalnız Codex için kullanıcı genelinde kur.
29
- node bin/si-overnight.mjs --platform codex --scope user
30
- ```
31
-
32
- `--project` mevcut bir dizin olmalıdır. Kurulumdan sonra hedef projeyi agent'ında
33
- aç ve aşağıdaki platform komutlarından biriyle skill'i çağır.
34
-
35
- ### Npm üzerinden kurulum
36
-
37
- En son yayımlanan sürümü kurmak için:
38
-
39
- ```bash
40
- npx --yes si-overnight --platform all --project /tam/yol/projen
41
- ```
42
-
43
- `npm install` tek başına skill'i agent dizinine kopyalamaz; kurulum CLI'sini
44
- ayrıca çalıştırmalısın.
45
-
46
- ## Hangi platformda nasıl çağırılır?
47
-
48
- | Platform | Skill'i çağırma | Proje içindeki kurulum dizini |
49
- | --- | --- | --- |
50
- | Codex | `$si-overnight` veya `/skills` içinden seç | `.agents/skills/si-overnight/` |
51
- | Claude Code | `/si-overnight` | `.claude/skills/si-overnight/` |
52
- | Google Antigravity | `/si-overnight` | `.agents/skills/si-overnight/` |
53
- | pi | `/skill:si-overnight` | `.pi/skills/si-overnight/` |
54
-
55
- Kullanıcı genelinde kurulum Codex için `~/.agents/skills/`, Claude Code için
56
- `~/.claude/skills/`, Antigravity için `~/.gemini/config/skills/`, pi için
57
- `~/.pi/agent/skills/` altında aynı `si-overnight/` klasörünü oluşturur.
58
-
59
- Diğer Agent Skills uyumlu araçlarda `skills/si-overnight/` klasörünü aracın
60
- belgelediği konuma kopyala. Dosya okuyabilen başka bir agente `SKILL.md` dosyasını
61
- okuyup uygulamasını da söyleyebilirsin. Komutların ve alt agent desteğinin bütün
62
- platformlarda aynı olduğu varsayılmaz.
63
-
64
- ## Bir gece nasıl ilerler?
65
-
66
- ### 1. Sen uyumadan önce
67
-
68
- Agent önce proje talimatlarını, mevcut değişiklikleri ve test düzenini inceler.
69
- Ardından cevabı projeden veya konuşmadan çıkmayan önemli soruları birlikte sorar:
70
-
71
- - Ana hedefler, öncelikleri ve işin bittiğini gösterecek ölçütler.
72
- - Bu gece **Liste** mi, **Keşif** mi kullanılacağı.
73
- - Yedek işler veya keşfe izin verilen alanlar.
74
- - Dokunulmayacak dosyalar, API davranışları ve tasarım kararları.
75
- - Çalışma süresi veya saat dilimiyle birlikte bitiş saati; varsa bilinen bütçe.
76
- - Beklenen testler, gerekli servisler ve erişimler.
77
- - Teslim biçimi ve commit, PR veya deployment gibi işlemlere verilen yetkiler.
78
-
79
- Bu gece için cevapladığın soruları yeniden sormaz. Gerekli kararlar tamamlanınca
80
- kısa planı kaydeder ve ayrıca bir başlama onayı turu üretmeden işe geçer.
81
-
82
- ### 2. Gece modu seçilir
83
-
84
- | Mod | Ana işler bitince | Ne zaman durur? |
85
- | --- | --- | --- |
86
- | **Liste / Queue** | Önceden kararlaştırılan yedek işleri yapar. | Onaylı liste bitince veya başka bir durma koşulu oluşunca. |
87
- | **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. |
88
-
89
- **Her yeni gece bu seçim yeniden sorulur.** Önceki gecenin modu kendiliğinden
90
- taşınmaz. Kesilen aynı çalışmaya devam ederken mevcut gece sözleşmesi korunur.
91
-
92
- Keşif modu için somut bir sınır örneği: “`src/cart/` ve `tests/cart/` içinde
93
- doğrulanabilir bug fix ve regresyon testi yap; bağımlılık veya ödeme API'si
94
- değiştirme.” Token tüketme isteği tek başına sınırsız proje kapsamı sayılmaz.
95
-
96
- ### 3. Uygula → test et → incele → kaydet
97
-
98
- Agent sıradaki en önemli, engellenmemiş işi seçer; değişikliği yapar, uygun
99
- testleri çalıştırır, sonucu inceler ve ilerlemeyi kaydeder. Anlamlı bir hata
100
- kanıtı varsa düzeltir. Önceden bozuk testleri yeni hatalardan ayırır; çalışmayan
101
- veya çalıştırılamayan kontrolü geçti diye raporlamaz.
102
-
103
- Bir iş yeni bir karar ya da erişim gerektiriyorsa onu engeliyle birlikte kaydeder
104
- ve bağımsız, yetkilendirilmiş işlere devam eder. Aynı engelde yeni kanıt olmadan
105
- üç başarısız denemeden sonra başka işe geçer. Sırf token harcamak için aynı
106
- başarılı testleri tekrar tekrar çalıştırmaz.
107
-
108
- ## Agent'lar nasıl birlikte çalışır?
109
-
110
- Ana agent gece planının ve sonucun sahibidir. Platform alt agent destekliyorsa
111
- bağımsız işler için görev dağıtabilir. Örneğin:
112
-
113
- | Görev | Sorumluluk |
114
- | --- | --- |
115
- | Ana agent / koordinatör | Öncelikleri, kapsamı, süreyi ve son teslimi yönetir; sonuçları birleştirir. |
116
- | Uygulama görevi | Kendi sorumluluğundaki dosyalarda belirli bir değişikliği yapar. |
117
- | Test veya inceleme görevi | Bağımsız bir işi doğrular, regresyonları veya diff'teki somut sorunları inceler. |
118
-
119
- Bu tablo sabit bir agent kadrosu tanımlamaz; görevler ihtiyaca göre seçilir.
120
- Çakışan dosya yazımlarından kaçınılır, bütün çalışanlar aynı kapsam ve süreye
121
- tabidir ve ana agent dönen sonuçları doğrular. Alt agent desteği yoksa aynı akış
122
- tek agent ile yürütülür. Skill bu desteği platforma sonradan eklemez.
123
-
124
- ## Örnek gece isteği
125
-
126
- Codex için:
127
-
128
- ```text
129
- $si-overnight
130
- Ana hedef: sepetteki doğrulanmış hataları düzelt ve regresyon testlerini ekle.
131
- Bu gece Liste mi Keşif mi kullanacağımızı uyumadan bana sor.
132
- Dokunma: ödeme API kontratları ve mevcut kullanıcı değişiklikleri.
133
- En fazla 6 saat çalış. Teslim: yerel değişiklikler ve sabah raporu.
134
- Gerekli diğer kararları ben çevrimiçiyken birlikte sor.
135
- ```
136
-
137
- Diğer platformlarda ilk satırı o platformun çağırma komutuyla değiştir.
138
-
139
- ## Kayıtlar, sabah raporu ve devam etme
140
-
141
- Her çalışma hedef projede ayrı bir klasöre yazılır:
142
-
143
- ```text
144
- .si-overnight/
145
- └── <run-id>/
146
- ├── run.md # Kapsam, kararlar, işler, son kontrol ve sıradaki adım
147
- └── report.md # Tamamlananlar, test kanıtları, eksikler ve durma nedeni
148
- ```
149
-
150
- Kayıtlar varsayılan olarak yerelde tutulur; açıkça istemedikçe commit'e alınmaz.
151
- Skill sırf bu dosyaları gizlemek için `.gitignore` veya repo ayarlarını değiştirmez.
152
- Gizli anahtarlar ve hassas komut çıktıları kayıtlara yazılmaz.
153
-
154
- Devam örneği:
155
-
156
- ```text
157
- $si-overnight
158
- .si-overnight/<run-id>/run.md dosyasındaki çalışmaya devam et.
159
- Önce kaydı mevcut dosyalarla karşılaştır. Aynı kapsamı koru.
160
- Eski süre dolduysa bu andan itibaren 2 saatlik yeni pencere kullan.
161
- ```
162
-
163
- Agent bir komutun kesintiden önce başarıyla bittiğini varsaymaz; mevcut dosyaları,
164
- sonuçları ve diğer kişilerin değişikliklerini kayıtla karşılaştırır.
165
-
166
- ## Çalışma ne zaman biter?
167
-
168
- Onaylı işler bittiğinde, kapsam içinde yararlı keşif kalmadığında, süre veya
169
- gözlemlenebilir kota sınırı dolduğunda, bütün kalan işler engellendiğinde ya da sen
170
- durmasını istediğinde çalışmayı sonlandırır. Ölçülemeyen kalan kotayı tahmin diye
171
- sunmaz.
172
-
173
- **Skill bir süreç yöneticisi değildir.** Bilgisayarı uyanık tutmaz, kapanan agent'ı
174
- yeniden başlatmaz, yeni model turları oluşturmaz veya kota yenilemez. Yerel
175
- makine/oturum veya gerçekten uzakta çalışan ortam kullanılabilir kalmalıdır.
176
- Ani kesintide son kayıttan devam edilebilir; durmuş süreç sonradan rapor yazamaz.
177
- Host'un uzun çalışma özelliği ayrıca kullanılabilir; bu skill kendiliğinden bir
178
- Goal, zamanlanmış görev veya arka plan runner'ı oluşturmaz.
179
-
180
- ## CLI seçenekleri ve Python alternatifi
181
-
182
- | Seçenek | Değer / davranış |
183
- | --- | --- |
184
- | `--platform` | `codex`, `claude`, `antigravity`, `pi` veya `all`; zorunlu. |
185
- | `--scope` | `project` (varsayılan) veya `user`. |
186
- | `--project` | Mevcut proje dizini; varsayılan geçerli dizin. Kullanıcı kapsamını değiştirmez. |
187
- | `--dry-run` | Hedefleri gösterir, dosya yazmaz. |
188
- | `--help` | Yardımı gösterir. |
189
-
190
- Npm CLI'sinde birden fazla platform için bayrağı tekrarla:
191
-
192
- ```bash
193
- node bin/si-overnight.mjs --platform claude --platform pi --dry-run
194
- ```
195
-
196
- Kurucu farklı bir mevcut skill'in üzerine yazmaz; içerik aynıysa dosyaları
197
- değiştirmez. Seçtiğin kökün altındaki kurulum yollarında sembolik bağlantılar
198
- reddedilir. Açıkça seçilen kökün kendisi bir dizin takma adı olabilir. Güncellemede
199
- mevcut kurulumu inceleyip taşıdıktan sonra yeniden kur. Kurulum agent izinlerini
200
- değiştirmez veya çalışmayı başlatmaz.
201
-
202
- Kaynak kod deposunda Python 3 alternatifi de bulunur:
203
-
204
- ```bash
205
- python3 scripts/install.py --platform all --project /tam/yol/projen
206
- ```
207
-
208
- ## Geliştirme ve sürüm yayımlama
209
-
210
- ```bash
211
- npm test
212
- python3 -m unittest discover -s tests -v
213
- node .github/scripts/pack-smoke.mjs /tmp/si-overnight-package-check
214
- ```
215
-
216
- Son komutun çıktı dizini boş olmalıdır. Gerçek `.tgz` dosyasını boş npm cache'iyle
217
- çevrimdışı kurar, CLI'yi ve skill dosyalarının byte eşitliğini kontrol eder.
218
-
219
- README'deki canlandırmayı yeniden oluşturmak için `python3 scripts/render_workflow.py`
220
- çalıştır. Bu geliştirme aracı Pillow gerektirir; npm kurucusunun runtime bağımlılığı
221
- değildir.
222
-
223
- CI her branch push'unda ve PR'da Node.js 20/24 ile testleri çalıştırır; paket ve
224
- SHA-256 özeti `npm-package` artifact'i olarak hazırlanır. Sürümle eşleşen
225
- `vMAJOR.MINOR.PATCH` etiketi, testler geçtikten sonra aynı paketi npm'e yayımlar.
226
- Ön sürüm etiketleri mevcut release akışında desteklenmez.
227
-
228
- İlk npm kaydı için hesabın yayın yetkisi gerekir. Staged bir sürüm varsa npm
229
- profilindeki **Staged Packages** üzerinden inceleyip 2FA ile onayla. Yayımlanmış
230
- aynı isim/sürüm yeniden kullanılamaz. [Staged publishing belgesi](https://docs.npmjs.com/staged-publishing/).
231
-
232
- Otomatik yayın için paket **Settings → Trusted publishing → GitHub Actions**
233
- ayarında owner `siguelabs`, repo `si`, workflow `release.yml`, environment boş ve
234
- **Allow npm publish** açık olmalıdır. Bu OIDC akışı `NPM_TOKEN` secret'ı
235
- gerektirmez. Yeni bağlantının ilk yayını iki gün içinde yapılmalıdır. Provenance
236
- için kaynak repo public ve `repository.url` aynı GitHub deposuna bağlı olmalıdır.
237
- Yayın işi Node.js 24 ve npm ≥11.5.1 kullanır/kontrol eder.
238
- [Trusted publishing belgesi](https://docs.npmjs.com/trusted-publishers/).
239
-
240
- Kod yapısı: `skills/si-overnight/` ortak çalışma talimatlarını, `bin/` ve `lib/`
241
- Node kurucusunu, `scripts/install.py` Python alternatifini, `tests/` kontrolleri,
242
- `.github/` CI ve release akışlarını içerir. Platformlara ilişkin resmi kaynaklar
243
- [uyumluluk notlarında](skills/si-overnight/references/platforms.md) bulunur.
244
-
245
- Katkı yaparken kurucu değişikliklerini ilgili testlerle doğrula; çalışma akışı
246
- değişikliklerinde iki dildeki README'yi birlikte güncelle. Paket şu anda
247
- **`UNLICENSED`** olarak tanımlıdır; açık kaynak kullanım lisansı verilmemiştir.