nightralph 0.0.0 → 0.0.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/.github/dependabot.yml +28 -0
- package/.github/workflows/nodejs.yml +30 -0
- package/LICENSE +160 -0
- package/README.md +40 -41
- package/package.json +11 -7
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
version: 2
|
|
2
|
+
updates:
|
|
3
|
+
# Enable version updates for npm
|
|
4
|
+
- package-ecosystem: "npm"
|
|
5
|
+
# Look for `package.json` and `lock` files in the `root` directory
|
|
6
|
+
directory: "/"
|
|
7
|
+
# Check the npm registry for updates every day (weekdays)
|
|
8
|
+
schedule:
|
|
9
|
+
interval: "monthly"
|
|
10
|
+
groups:
|
|
11
|
+
# This is the name of your group. It will be used in PR titles and branch names
|
|
12
|
+
dev-dependencies:
|
|
13
|
+
patterns:
|
|
14
|
+
- "*"
|
|
15
|
+
ignore:
|
|
16
|
+
- dependency-name: "eslint"
|
|
17
|
+
update-types: ["version-update:semver-major"]
|
|
18
|
+
- dependency-name: "eslint*"
|
|
19
|
+
update-types: ["version-update:semver-major"]
|
|
20
|
+
- dependency-name: "typescript-eslint"
|
|
21
|
+
update-types: ["version-update:semver-major"]
|
|
22
|
+
- dependency-name: "neostandard"
|
|
23
|
+
update-types: ["version-update:semver-major"]
|
|
24
|
+
# Enable updates to github actions
|
|
25
|
+
- package-ecosystem: "github-actions"
|
|
26
|
+
directory: "/"
|
|
27
|
+
schedule:
|
|
28
|
+
interval: "monthly"
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
name: Node CI
|
|
2
|
+
|
|
3
|
+
on: [push]
|
|
4
|
+
|
|
5
|
+
jobs:
|
|
6
|
+
build:
|
|
7
|
+
|
|
8
|
+
runs-on: ubuntu-22.04
|
|
9
|
+
timeout-minutes: 5
|
|
10
|
+
|
|
11
|
+
strategy:
|
|
12
|
+
matrix:
|
|
13
|
+
node-version: [25.x]
|
|
14
|
+
|
|
15
|
+
steps:
|
|
16
|
+
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
|
|
17
|
+
- name: Use Node.js ${{ matrix.node-version }}
|
|
18
|
+
uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
|
|
19
|
+
with:
|
|
20
|
+
node-version: ${{ matrix.node-version }}
|
|
21
|
+
- name: npm install, build
|
|
22
|
+
run: |
|
|
23
|
+
npm install
|
|
24
|
+
npm run build --if-present
|
|
25
|
+
npm run lint
|
|
26
|
+
env:
|
|
27
|
+
CI: true
|
|
28
|
+
- name: Run tap tests
|
|
29
|
+
run: |
|
|
30
|
+
npm test
|
package/LICENSE
ADDED
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
# Big Time Public License
|
|
2
|
+
|
|
3
|
+
Version 2.0.2
|
|
4
|
+
|
|
5
|
+
## Purpose
|
|
6
|
+
|
|
7
|
+
These terms let you use and share this software for noncommercial purposes and
|
|
8
|
+
in small business for free, while also guaranteeing that paid licenses for big
|
|
9
|
+
businesses will be available on fair, reasonable, and nondiscriminatory terms.
|
|
10
|
+
|
|
11
|
+
## Acceptance
|
|
12
|
+
|
|
13
|
+
In order to get any license under these terms, you must agree to them as both
|
|
14
|
+
strict obligations and conditions to all your licenses.
|
|
15
|
+
|
|
16
|
+
## Noncommercial Purposes
|
|
17
|
+
|
|
18
|
+
You may use the software for any noncommercial purpose.
|
|
19
|
+
|
|
20
|
+
## Personal Uses
|
|
21
|
+
|
|
22
|
+
Personal use for research, experiment, and testing for the benefit of public
|
|
23
|
+
knowledge, personal study, private entertainment, hobby projects, amateur
|
|
24
|
+
pursuits, or religious observance, without any anticipated commercial
|
|
25
|
+
application, count as use for noncommercial purposes.
|
|
26
|
+
|
|
27
|
+
## Noncommercial Organizations
|
|
28
|
+
|
|
29
|
+
Use by any charitable organization, educational institution, public research
|
|
30
|
+
organization, public safety or health organization, environmental protection
|
|
31
|
+
organization, or government institution counts as use for noncommercial
|
|
32
|
+
purposes, regardless of the source of funding or obligations resulting from
|
|
33
|
+
the funding.
|
|
34
|
+
|
|
35
|
+
## Small Business
|
|
36
|
+
|
|
37
|
+
You may use the software for the benefit of your company if it meets all
|
|
38
|
+
these criteria:
|
|
39
|
+
|
|
40
|
+
1. had fewer than 20 total individuals working as employees and independent
|
|
41
|
+
contractors at all times during the last tax year
|
|
42
|
+
|
|
43
|
+
2. earned less than $100,000 total revenue in the last tax year
|
|
44
|
+
|
|
45
|
+
3. received less than $1,000,000 total debt, equity, and other investment in
|
|
46
|
+
the last five tax years, counting investment in predecessor companies that
|
|
47
|
+
reorganized into, merged with, or spun out your company
|
|
48
|
+
|
|
49
|
+
All dollar figures are United States dollars as of 2025. Adjust for them
|
|
50
|
+
inflation according to the United States Bureau of Labor Statistics' consumer
|
|
51
|
+
price index for all urban consumers, United States city average, for all items,
|
|
52
|
+
not seasonally adjusted, with 1982–1984=100 reference base.
|
|
53
|
+
|
|
54
|
+
## Big Business
|
|
55
|
+
|
|
56
|
+
You may use the software for the benefit of your company:
|
|
57
|
+
|
|
58
|
+
1. for 128 days after your company stops qualifying under
|
|
59
|
+
[Small Business](#small-business)
|
|
60
|
+
|
|
61
|
+
2. indefinitely, if the licensor or their legal successor does not offer fair,
|
|
62
|
+
reasonable, and nondiscriminatory terms for a commercial license for the
|
|
63
|
+
software within 32 days of [written request](#how-to-request) and negotiate
|
|
64
|
+
in good faith to conclude a deal
|
|
65
|
+
|
|
66
|
+
## How to Request
|
|
67
|
+
|
|
68
|
+
If this software includes an address for the licensor or an agent of the
|
|
69
|
+
licensor in a standard place, such as in documentation, software package
|
|
70
|
+
metadata, or an "about" page or screen, try to request a fair commercial
|
|
71
|
+
license at that address. If this package includes both online and offline
|
|
72
|
+
addresses, try online before offline. If you can't deliver a request that
|
|
73
|
+
way, or this software doesn't include any addressees, spend one hour online
|
|
74
|
+
researching an address, recording all your searches and inquiries as you go,
|
|
75
|
+
and try any addresses that you find. If you can't find any addresses, or if
|
|
76
|
+
those addresses also fail, that counts as failure to offer a fair commercial
|
|
77
|
+
license by the licensor under [Big Business](#big-business).
|
|
78
|
+
|
|
79
|
+
## Fair, Reasonable, and Nondiscriminatory Terms
|
|
80
|
+
|
|
81
|
+
Fair, reasonable, and nondiscriminatory terms may license the software
|
|
82
|
+
perpetually or for a term, and may or may not cover new versions of the
|
|
83
|
+
software. If the licensor advertises license terms and a pricing structure for
|
|
84
|
+
generally available commercial licenses, the licensor proposes license terms
|
|
85
|
+
and a price as advertised, and a customer not affiliated with the licensor has
|
|
86
|
+
bought a commercial license for the software on substantially equivalent terms
|
|
87
|
+
in the past year, the proposal is fair, reasonable, and nondiscriminatory.
|
|
88
|
+
|
|
89
|
+
## Copyright License
|
|
90
|
+
|
|
91
|
+
The licensor grants you a copyright license to do everything with the software
|
|
92
|
+
that would otherwise infringe the licensor's copyright in it for any purpose
|
|
93
|
+
allowed by these terms.
|
|
94
|
+
|
|
95
|
+
## Notices
|
|
96
|
+
|
|
97
|
+
You must ensure that anyone who gets a copy of any part of the software from
|
|
98
|
+
you also gets a copy of these terms or the URL for them above, as well as
|
|
99
|
+
copies of any plain-text lines beginning with `Required Notice:` that the
|
|
100
|
+
licensor provided with the software. For example:
|
|
101
|
+
|
|
102
|
+
> Required Notice: Copyright Nick Thomas (https://nichoth.com)
|
|
103
|
+
|
|
104
|
+
## Patent License
|
|
105
|
+
|
|
106
|
+
The licensor grants you a patent license for the software that covers patent
|
|
107
|
+
claims the licensor can license, or becomes able to license, that you would
|
|
108
|
+
infringe by using the software.
|
|
109
|
+
|
|
110
|
+
## Fair Use
|
|
111
|
+
|
|
112
|
+
You may have "fair use" rights for the software under the law. These terms do
|
|
113
|
+
not limit them.
|
|
114
|
+
|
|
115
|
+
## No Other Rights
|
|
116
|
+
|
|
117
|
+
These terms do not allow you to sublicense or transfer any of your licenses to
|
|
118
|
+
anyone else, or prevent the licensor from granting licenses to anyone else.
|
|
119
|
+
These terms do not imply any other licenses.
|
|
120
|
+
|
|
121
|
+
## Patent Defense
|
|
122
|
+
|
|
123
|
+
If you make any written claim that the software infringes or contributes to
|
|
124
|
+
infringement of any patent, your patent license for the software granted under
|
|
125
|
+
these terms ends immediately. If your company makes such a claim, your patent
|
|
126
|
+
license ends immediately for work on behalf of your company.
|
|
127
|
+
|
|
128
|
+
## Violations
|
|
129
|
+
|
|
130
|
+
The first time you are notified in writing that you have violated any of these
|
|
131
|
+
terms, or done anything with the software not covered by your licenses, your
|
|
132
|
+
licenses can nonetheless continue if you come into full compliance with these
|
|
133
|
+
terms, and take practical steps to correct past violations, within 32 days of
|
|
134
|
+
receiving notice. Otherwise, all your licenses end immediately.
|
|
135
|
+
|
|
136
|
+
## No Liability
|
|
137
|
+
|
|
138
|
+
***As far as the law allows, the software comes as is, without any warranty or
|
|
139
|
+
condition, and the licensor will not be liable to you for any damages arising
|
|
140
|
+
out of these terms or the use or nature of the software, under any kind of
|
|
141
|
+
legal claim.***
|
|
142
|
+
|
|
143
|
+
## Definitions
|
|
144
|
+
|
|
145
|
+
The **licensor** is the individual or entity offering these terms, and the
|
|
146
|
+
**software** is the software the licensor makes available under these terms.
|
|
147
|
+
|
|
148
|
+
**You** refers to the individual or entity agreeing to these terms.
|
|
149
|
+
|
|
150
|
+
**Your company** is any legal entity, sole proprietorship, or other kind of
|
|
151
|
+
organization that you work for, plus all organizations that have control over,
|
|
152
|
+
are under the control of, or are under common control with that organization.
|
|
153
|
+
**Control** means ownership of substantially all the assets of an entity, or
|
|
154
|
+
the power to direct its management and policies by vote, contract, or
|
|
155
|
+
otherwise. Control can be direct or indirect.
|
|
156
|
+
|
|
157
|
+
**Your licenses** are all the licenses granted to you for the software under
|
|
158
|
+
these terms.
|
|
159
|
+
|
|
160
|
+
**Use** means anything you do with the software requiring one of your licenses.
|
package/README.md
CHANGED
|
@@ -1,7 +1,12 @@
|
|
|
1
1
|
# `nightralph`
|
|
2
|
+
[](https://github.com/nichoth/nightralph/actions/workflows/nodejs.yml)
|
|
3
|
+
[](README.md)
|
|
4
|
+
[](https://semver.org/)
|
|
5
|
+
[](https://packagephobia.com/result?p=nightralph)
|
|
6
|
+
[](LICENSE)
|
|
2
7
|
|
|
3
8
|
This is a minimal Node-based AI orchestrator. It reads local markdown tickets
|
|
4
|
-
produced by
|
|
9
|
+
or remote Github issues produced by
|
|
5
10
|
[`to-tickets` skill](https://github.com/mattpocock/skills/blob/main/skills/engineering/to-tickets/SKILL.md),
|
|
6
11
|
resolves their dependency graph, and runs agents in parallel as much as possible,
|
|
7
12
|
honoring the ticket dependencies.
|
|
@@ -16,10 +21,9 @@ so they can't drift as long as you install the skills with this package.
|
|
|
16
21
|
|
|
17
22
|
- [Install](#install)
|
|
18
23
|
* [Install Dependency Skills](#install-dependency-skills)
|
|
19
|
-
* [Create Issues](#create-issues)
|
|
20
|
-
* [Execute Issues](#execute-issues)
|
|
21
24
|
- [Workflow](#workflow)
|
|
22
|
-
* [
|
|
25
|
+
* [Create Issues](#create-issues)
|
|
26
|
+
* [Execute Tasks with `nightralph`](#execute-tasks-with-nightralph)
|
|
23
27
|
|
|
24
28
|
<!-- tocstop -->
|
|
25
29
|
|
|
@@ -34,10 +38,11 @@ npm i -S nightralph
|
|
|
34
38
|
Use a subcommand in this package to add the required
|
|
35
39
|
[Pocock skills](https://github.com/mattpocock/skills) to your repo.
|
|
36
40
|
This command will copy some files in this package to a specific directory
|
|
37
|
-
in
|
|
41
|
+
in your repo. The upstream
|
|
38
42
|
[`grill-with-docs`](https://github.com/mattpocock/skills/blob/main/skills/engineering/grill-with-docs/SKILL.md)
|
|
39
|
-
skill is exposed as `/grill`, along with its sub-skills
|
|
40
|
-
|
|
43
|
+
skill is exposed as `/grill`, along with its sub-skills `grilling`
|
|
44
|
+
and `domain-modeling`.
|
|
45
|
+
|
|
41
46
|
|
|
42
47
|
```sh
|
|
43
48
|
npx nightralph setup
|
|
@@ -49,14 +54,18 @@ They are cloned with some metadata, visible in
|
|
|
49
54
|
That's how we prevent skill vs API drift.
|
|
50
55
|
|
|
51
56
|
|
|
52
|
-
|
|
57
|
+
## Workflow
|
|
53
58
|
|
|
54
59
|
First create issues.
|
|
55
60
|
|
|
56
61
|
This package bundles the skill files with the CLI, to
|
|
57
62
|
**prevent version drift**. After installing this package,
|
|
58
|
-
|
|
59
|
-
local `./claude/skills/` folder.
|
|
63
|
+
use [the `npx` command](#install-dependency-skills) to add the required
|
|
64
|
+
skills to your local `./claude/skills/` folder or `./agents.skills/` folder.
|
|
65
|
+
|
|
66
|
+
### Create Issues
|
|
67
|
+
|
|
68
|
+
Use the `to-tickets` skill to create issues in local markdown files.
|
|
60
69
|
|
|
61
70
|
**The expected flow is**
|
|
62
71
|
|
|
@@ -64,12 +73,29 @@ local `./claude/skills/` folder.
|
|
|
64
73
|
grill -> to-spec -> to-tickets -> tdd
|
|
65
74
|
```
|
|
66
75
|
|
|
67
|
-
`
|
|
76
|
+
The `nightralph` CLI does the `tdd` part.
|
|
68
77
|
|
|
69
|
-
|
|
78
|
+
>
|
|
79
|
+
> [!NOTE]
|
|
80
|
+
> The `grill -> to-spec` pipeline is recommended to be run in a
|
|
81
|
+
> single context window.
|
|
82
|
+
>
|
|
70
83
|
|
|
71
|
-
|
|
72
|
-
|
|
84
|
+
>
|
|
85
|
+
> [!TIP]
|
|
86
|
+
> The `to-tickets` skill bundled here can use any input text
|
|
87
|
+
> describing a feature, meaning `grill` & `to-spec` skills are not required.
|
|
88
|
+
> You could, for example, use
|
|
89
|
+
> [superpowers:writing-plans](https://github.com/obra/superpowers/blob/main/skills/writing-plans/SKILL.md),
|
|
90
|
+
> then follow with `to-tickets`.
|
|
91
|
+
>
|
|
92
|
+
|
|
93
|
+
|
|
94
|
+
### Execute Tasks with `nightralph`
|
|
95
|
+
|
|
96
|
+
After you have the tickets, you can use the `nightralph` loop to execute.
|
|
97
|
+
The `to-tickets` skill produces markdown files at
|
|
98
|
+
`.scratch/<feature>/issues/<NN>-<slug>.md`, with task dependency info.
|
|
73
99
|
|
|
74
100
|
```bash
|
|
75
101
|
# Auto-discover .scratch features and run with claude
|
|
@@ -109,30 +135,3 @@ Notes:
|
|
|
109
135
|
in-place. Failed tickets keep their status and block dependents.
|
|
110
136
|
* Agent logs are written to `<dir>/../logs/<ticket>.log`.
|
|
111
137
|
|
|
112
|
-
|
|
113
|
-
## Workflow
|
|
114
|
-
|
|
115
|
-
Need to use several skills, in order:
|
|
116
|
-
|
|
117
|
-
```
|
|
118
|
-
grill -> to-spec -> to-tickets
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
At that point you will have a number of tickets, which are markdown files
|
|
122
|
-
in your local repo. This tool handles the last step, implementing the tickets,
|
|
123
|
-
which normally is done with the `tdd` skill. This tool will work in a loop,
|
|
124
|
-
aiming to complete 1 task per session, then restarting (a classic Ralph loop).
|
|
125
|
-
|
|
126
|
-
### `nightralph` command
|
|
127
|
-
|
|
128
|
-
After you have the tickets, you can use the `nightralph` loop to execute.
|
|
129
|
-
|
|
130
|
-
```sh
|
|
131
|
-
npx nightralph claude -m claude-opus-4-6
|
|
132
|
-
```
|
|
133
|
-
|
|
134
|
-
Or with a different provider:
|
|
135
|
-
|
|
136
|
-
```sh
|
|
137
|
-
npx nightralph codex -m gpt-5.6-terra
|
|
138
|
-
```
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "nightralph",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.2",
|
|
4
4
|
"type": "module",
|
|
5
|
-
"description": "
|
|
5
|
+
"description": "Orchestrator that runs a single-agent session per issue.",
|
|
6
6
|
"bin": {
|
|
7
7
|
"nightralph": "dist/index.js"
|
|
8
8
|
},
|
|
@@ -17,8 +17,15 @@
|
|
|
17
17
|
"copy": "mkdir -p ./dist/skills ./dist/docs-templates && cp -r ./src/skills/* ./dist/skills && cp -r ./src/docs-templates/* ./dist/docs-templates",
|
|
18
18
|
"clone-skills": "bash scripts/clone-skills.sh",
|
|
19
19
|
"toc": "markdown-toc --maxdepth 3 -i README.md",
|
|
20
|
+
"preversion": "npm run lint",
|
|
21
|
+
"version": "npm run toc",
|
|
22
|
+
"postversion": "git push --follow-tags && npm publish",
|
|
20
23
|
"test": "esbuild test/setup.test.ts test/orchestrator.test.ts test/integration.test.ts --format=esm --bundle --packages=external --outdir=dist/test --sourcemap && node dist/test/setup.test.js && node dist/test/orchestrator.test.js && node dist/test/integration.test.js"
|
|
21
24
|
},
|
|
25
|
+
"dependencies": {
|
|
26
|
+
"@inquirer/prompts": "^8.7.0",
|
|
27
|
+
"yargs": "^18.1.0"
|
|
28
|
+
},
|
|
22
29
|
"devDependencies": {
|
|
23
30
|
"@substrate-system/tapzero": "^0.10.16",
|
|
24
31
|
"@types/node": "^26.3.0",
|
|
@@ -28,9 +35,6 @@
|
|
|
28
35
|
"newneostandard": "^0.14.3",
|
|
29
36
|
"typescript-eslint": "^8.68.0"
|
|
30
37
|
},
|
|
31
|
-
"
|
|
32
|
-
"
|
|
33
|
-
"@inquirer/prompts": "^8.7.0",
|
|
34
|
-
"yargs": "^18.1.0"
|
|
35
|
-
}
|
|
38
|
+
"license": "SEE LICENSE IN LICENSE",
|
|
39
|
+
"author": "nichoth"
|
|
36
40
|
}
|