@jigging/jig 0.1.0-alpha.12 → 0.1.0-alpha.13

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,12 +1,13 @@
1
1
  # `@jigging/jig`
2
2
 
3
- Jig is a local, secure host for admitted FLOW packages. The direct-run alpha
4
- has one finite command surface:
3
+ Jig puts reusable Agent methods to work with powers you approve. Choose your
4
+ Agents, combine specialists, inspect their results, and stop owned work.
5
+ The developer alpha has one finite command surface:
5
6
 
6
7
  ```text
7
8
  jig init --bare <directory>
8
9
  jig review [project] [--yes]
9
- jig run <flow:path|binding:id> [--input JSON] [--timeout DURATION]
10
+ jig run <flow:path|binding:id> [--input JSON|@FILE] [--attach NAME=DIR] [--out DIR] [--timeout DURATION]
10
11
  jig --version
11
12
  ```
12
13
 
@@ -19,7 +20,7 @@ authority they need or fail closed.
19
20
  ## Install
20
21
 
21
22
  ```console
22
- npm install --global @jigging/jig@0.1.0-alpha.10
23
+ npm install --global @jigging/jig@alpha
23
24
  ```
24
25
 
25
26
  Installing Jig also installs `@oven/bun-linux-x64-baseline@1.3.3` as an exact
@@ -28,6 +29,10 @@ external runtime dependency. Bun is not embedded in or bundled with the
28
29
  that closed package-local path, authenticates its version, revision, and digest
29
30
  before evaluator or Flow bytes execute, and revalidates it before each launch.
30
31
 
32
+ For a useful application, try [an issue becoming a tested patch](https://jig.md/guide/tested-patch).
33
+ It selects local source files and returns a patch with executed checks, without
34
+ changing the original repository.
35
+
31
36
  ## Supported host
32
37
 
33
38
  The alpha has been independently tested on a provisioned Ubuntu 24.04 x86_64
@@ -52,15 +57,14 @@ On NixOS, enable
52
57
  `programs.nix-ld.enable` for the unmodified npm runtime. Jig uses the real glibc
53
58
  loader at the system-managed `share/nix-ld/lib/ld.so` link, mounting only that
54
59
  loader and its required libraries into Runs. It does not mount nix-ld or the
55
- whole Nix store. NixOS path support is included in this source candidate;
56
- independent NixOS host conformance is not yet established.
60
+ whole Nix store. Independent NixOS host conformance is not yet established.
57
61
 
58
62
  Jig commands do not use `sudo`, download runtimes, or expose host control to
59
63
  Flow code. Runtime installation is handled once by npm with the Jig package.
60
64
 
61
65
  Flow Runs default to 30 seconds. `jig run --timeout DURATION` accepts a
62
66
  positive integer followed by `ms`, `s`, `m`, or `h`, up to 24 hours. Flow
63
- execution scopes remain fixed at 256 MiB aggregate memory, 48 aggregate PIDs,
67
+ execution scopes remain fixed at 256 MiB aggregate memory, 64 aggregate PIDs,
64
68
  and 50% of one CPU. Project evaluation is fixed at 3 seconds, 256 MiB, 64
65
69
  PIDs, and 50% CPU. Locked dependency preparation is fixed at 60 seconds, 512
66
70
  MiB, 64 PIDs, and one CPU. See the repository
@@ -78,7 +82,7 @@ Place packages under `flows/<name>/`. Each package has exact-case `FLOW.md`
78
82
  and, for this alpha, one `flow.ts`. The generated `jig.ts`
79
83
  explicitly discovers `./flows` and `./bindings`.
80
84
 
81
- The paired `@jigging/flow@0.1.0-alpha.6` package provides the small Run/1
85
+ The published `@jigging/flow@0.1.0-alpha.7` package provides the small Run/1
82
86
  authoring API. Declare it exactly in the Flow's `package.json`, generate a text
83
87
  `bun.lock` with Bun 1.3.3 and `bun install --lockfile-only`, then handle one
84
88
  finite Run: