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

package/README.md

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

package/dist/index.d.ts

@@ -1 +1 @@
-export { defineBinding, defineJig, discover, type JigDefinitionInput, type PackageBindingInput, } from "./project/author.js";
+export { defineBinding, defineJig, discover, type JigDefinitionInput, type PackageBindingInput, } from './project/author.js';

package/dist/index.js

@@ -1784,10 +1784,16 @@ function defineBinding(input) {
   return normalizeBinding(input, false);
 }
 function flowRef(path) {
-  return record({ kind: "flow", path: normalizeProjectPath(path, "Flow reference") });
+  return record({
+    kind: "flow",
+    path: normalizeProjectPath(path, "Flow reference")
+  });
 }
 function bindingRef(id) {
-  return record({ kind: "binding", id: validateLocalName(id, "Binding reference") });
+  return record({
+    kind: "binding",
+    id: validateLocalName(id, "Binding reference")
+  });
 }
 function normalizeBinding(input, canonical) {
   const captured = snapshotJsonObject(input, "Binding definition");
@@ -1800,7 +1806,12 @@ function normalizeBinding(input, canonical) {
   const packagePath = normalizeProjectPath(captured.package, "package");
   const settings = Object.hasOwn(captured, "settings") ? expectJsonObject(captured.settings, "settings") : emptyRecord();
   const slots = Object.hasOwn(captured, "slots") ? normalizeFlowSlots(captured.slots) : emptyRecord();
-  return record({ kind: "package", package: packagePath, settings, slots });
+  return record({
+    kind: "package",
+    package: packagePath,
+    settings,
+    slots
+  });
 }
 function normalizeFlowSlots(value) {
   const input = snapshotJsonObject(value, "slots");

package/dist/project/author.d.ts

@@ -1,10 +1,10 @@
-import type { JsonObject } from "../json.js";
+import type { JsonObject } from '../json.js';
 export interface DiscoverySource {
-    readonly kind: "discover";
+    readonly kind: 'discover';
     readonly roots: readonly string[];
 }
 export interface MembersSource {
-    readonly kind: "members";
+    readonly kind: 'members';
     readonly paths: readonly string[];
 }
 export type ProjectSource = DiscoverySource | MembersSource;
@@ -18,16 +18,16 @@ export interface JigDefinitionInput {
     readonly bindings?: ProjectSourceInput;
 }
 export interface FlowRef {
-    readonly kind: "flow";
+    readonly kind: 'flow';
     readonly path: string;
 }
 export interface BindingRef {
-    readonly kind: "binding";
+    readonly kind: 'binding';
     readonly id: string;
 }
 export type RunTargetRef = FlowRef | BindingRef;
 export interface PackageBindingDefinition {
-    readonly kind: "package";
+    readonly kind: 'package';
     readonly package: string;
     readonly settings: JsonObject;
     readonly slots: Readonly<Record<string, string>>;