ai-engineering-loop 1.2.1 → 1.6.0

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ai-engineering-loop",
3
- "version": "1.2.1",
3
+ "version": "1.6.0",
4
4
  "description": "A reusable, framework-agnostic AI Engineering Operating System for safe coding agents.",
5
5
  "main": "bin/ai-engineering-loop.js",
6
6
  "bin": {
@@ -14,7 +14,9 @@
14
14
  "policies/",
15
15
  "profiles/",
16
16
  "adapters/",
17
+ "recipes/",
17
18
  "schemas/",
19
+ "studio/",
18
20
  "evals/",
19
21
  ".agents/",
20
22
  ".grok/",
@@ -0,0 +1,32 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "id": "audit",
4
+ "version": 1,
5
+ "description": "Read-only repository analysis with a structured report and no mutation or remote side effects.",
6
+ "compatibleModes": ["REPORT_ONLY"],
7
+ "nodes": [
8
+ {
9
+ "id": "goal",
10
+ "type": "goal-contract"
11
+ },
12
+ {
13
+ "id": "repository-analysis",
14
+ "type": "agent",
15
+ "dependsOn": ["goal"],
16
+ "role": "repository-auditor",
17
+ "context": {
18
+ "maxFiles": 40,
19
+ "maxTokens": 12000
20
+ },
21
+ "output": {
22
+ "artifact": "repository-analysis",
23
+ "schema": "schemas/report.schema.json"
24
+ }
25
+ },
26
+ {
27
+ "id": "report",
28
+ "type": "report",
29
+ "dependsOn": ["repository-analysis"]
30
+ }
31
+ ]
32
+ }
@@ -0,0 +1,63 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "id": "bugfix",
4
+ "version": 1,
5
+ "description": "Root-cause-first repair workflow with the complete production safety backbone.",
6
+ "compatibleModes": ["ASSISTED", "UNATTENDED"],
7
+ "nodes": [
8
+ {
9
+ "id": "goal",
10
+ "type": "goal-contract"
11
+ },
12
+ {
13
+ "id": "root-cause",
14
+ "type": "agent",
15
+ "dependsOn": ["goal"],
16
+ "role": "root-cause-analyst",
17
+ "context": {
18
+ "maxFiles": 30,
19
+ "maxTokens": 10000
20
+ },
21
+ "output": {
22
+ "artifact": "root-cause-analysis",
23
+ "schema": "schemas/report.schema.json"
24
+ }
25
+ },
26
+ {
27
+ "id": "maker",
28
+ "type": "maker",
29
+ "dependsOn": ["root-cause"]
30
+ },
31
+ {
32
+ "id": "verification",
33
+ "type": "verification",
34
+ "dependsOn": ["maker"]
35
+ },
36
+ {
37
+ "id": "review",
38
+ "type": "devil-advocate",
39
+ "dependsOn": ["verification"]
40
+ },
41
+ {
42
+ "id": "judge",
43
+ "type": "judge",
44
+ "dependsOn": ["review"]
45
+ },
46
+ {
47
+ "id": "delivery-approval",
48
+ "type": "approval",
49
+ "dependsOn": ["judge"],
50
+ "when": {
51
+ "field": "run.mode",
52
+ "operator": "equals",
53
+ "value": "ASSISTED"
54
+ },
55
+ "message": "Approve the verified bug fix for delivery."
56
+ },
57
+ {
58
+ "id": "delivery",
59
+ "type": "delivery",
60
+ "dependsOn": ["judge", "delivery-approval"]
61
+ }
62
+ ]
63
+ }
@@ -0,0 +1,49 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "id": "default",
4
+ "version": 1,
5
+ "description": "The existing Maker, verification, Devil's Advocate, Judge, and delivery workflow.",
6
+ "compatibleModes": ["ASSISTED", "UNATTENDED"],
7
+ "nodes": [
8
+ {
9
+ "id": "goal",
10
+ "type": "goal-contract"
11
+ },
12
+ {
13
+ "id": "maker",
14
+ "type": "maker",
15
+ "dependsOn": ["goal"]
16
+ },
17
+ {
18
+ "id": "verification",
19
+ "type": "verification",
20
+ "dependsOn": ["maker"]
21
+ },
22
+ {
23
+ "id": "review",
24
+ "type": "devil-advocate",
25
+ "dependsOn": ["verification"]
26
+ },
27
+ {
28
+ "id": "judge",
29
+ "type": "judge",
30
+ "dependsOn": ["review"]
31
+ },
32
+ {
33
+ "id": "delivery-approval",
34
+ "type": "approval",
35
+ "dependsOn": ["judge"],
36
+ "when": {
37
+ "field": "run.mode",
38
+ "operator": "equals",
39
+ "value": "ASSISTED"
40
+ },
41
+ "message": "Approve the verified change for delivery."
42
+ },
43
+ {
44
+ "id": "delivery",
45
+ "type": "delivery",
46
+ "dependsOn": ["judge", "delivery-approval"]
47
+ }
48
+ ]
49
+ }
@@ -0,0 +1,63 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "id": "docs-light",
4
+ "version": 1,
5
+ "description": "Documentation-focused workflow with bounded context and the standard quality gates.",
6
+ "compatibleModes": ["ASSISTED", "UNATTENDED"],
7
+ "nodes": [
8
+ {
9
+ "id": "goal",
10
+ "type": "goal-contract"
11
+ },
12
+ {
13
+ "id": "documentation-context",
14
+ "type": "agent",
15
+ "dependsOn": ["goal"],
16
+ "role": "documentation-planner",
17
+ "context": {
18
+ "maxFiles": 20,
19
+ "maxTokens": 6000
20
+ },
21
+ "output": {
22
+ "artifact": "documentation-plan",
23
+ "schema": "schemas/report.schema.json"
24
+ }
25
+ },
26
+ {
27
+ "id": "maker",
28
+ "type": "maker",
29
+ "dependsOn": ["documentation-context"]
30
+ },
31
+ {
32
+ "id": "verification",
33
+ "type": "verification",
34
+ "dependsOn": ["maker"]
35
+ },
36
+ {
37
+ "id": "review",
38
+ "type": "devil-advocate",
39
+ "dependsOn": ["verification"]
40
+ },
41
+ {
42
+ "id": "judge",
43
+ "type": "judge",
44
+ "dependsOn": ["review"]
45
+ },
46
+ {
47
+ "id": "delivery-approval",
48
+ "type": "approval",
49
+ "dependsOn": ["judge"],
50
+ "when": {
51
+ "field": "run.mode",
52
+ "operator": "equals",
53
+ "value": "ASSISTED"
54
+ },
55
+ "message": "Approve the verified documentation change for delivery."
56
+ },
57
+ {
58
+ "id": "delivery",
59
+ "type": "delivery",
60
+ "dependsOn": ["judge", "delivery-approval"]
61
+ }
62
+ ]
63
+ }
@@ -0,0 +1,69 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "id": "high-risk",
4
+ "version": 1,
5
+ "description": "Change workflow with explicit blast-radius analysis and approval before mutation.",
6
+ "compatibleModes": ["ASSISTED", "UNATTENDED"],
7
+ "nodes": [
8
+ {
9
+ "id": "goal",
10
+ "type": "goal-contract"
11
+ },
12
+ {
13
+ "id": "risk-analysis",
14
+ "type": "agent",
15
+ "dependsOn": ["goal"],
16
+ "role": "blast-radius-analyst",
17
+ "context": {
18
+ "maxFiles": 50,
19
+ "maxTokens": 16000
20
+ },
21
+ "output": {
22
+ "artifact": "risk-analysis",
23
+ "schema": "schemas/report.schema.json"
24
+ }
25
+ },
26
+ {
27
+ "id": "plan-approval",
28
+ "type": "approval",
29
+ "dependsOn": ["risk-analysis"],
30
+ "message": "Approve the high-risk implementation plan before repository mutation."
31
+ },
32
+ {
33
+ "id": "maker",
34
+ "type": "maker",
35
+ "dependsOn": ["plan-approval"]
36
+ },
37
+ {
38
+ "id": "verification",
39
+ "type": "verification",
40
+ "dependsOn": ["maker"]
41
+ },
42
+ {
43
+ "id": "review",
44
+ "type": "devil-advocate",
45
+ "dependsOn": ["verification"]
46
+ },
47
+ {
48
+ "id": "judge",
49
+ "type": "judge",
50
+ "dependsOn": ["review"]
51
+ },
52
+ {
53
+ "id": "delivery-approval",
54
+ "type": "approval",
55
+ "dependsOn": ["judge"],
56
+ "when": {
57
+ "field": "run.mode",
58
+ "operator": "equals",
59
+ "value": "ASSISTED"
60
+ },
61
+ "message": "Approve the verified high-risk change for delivery."
62
+ },
63
+ {
64
+ "id": "delivery",
65
+ "type": "delivery",
66
+ "dependsOn": ["judge", "delivery-approval"]
67
+ }
68
+ ]
69
+ }
@@ -0,0 +1,63 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "id": "refactor",
4
+ "version": 1,
5
+ "description": "Behavior-preserving refactor workflow with explicit baseline analysis.",
6
+ "compatibleModes": ["ASSISTED", "UNATTENDED"],
7
+ "nodes": [
8
+ {
9
+ "id": "goal",
10
+ "type": "goal-contract"
11
+ },
12
+ {
13
+ "id": "behavior-baseline",
14
+ "type": "agent",
15
+ "dependsOn": ["goal"],
16
+ "role": "behavior-baseline-analyst",
17
+ "context": {
18
+ "maxFiles": 35,
19
+ "maxTokens": 10000
20
+ },
21
+ "output": {
22
+ "artifact": "behavior-baseline",
23
+ "schema": "schemas/report.schema.json"
24
+ }
25
+ },
26
+ {
27
+ "id": "maker",
28
+ "type": "maker",
29
+ "dependsOn": ["behavior-baseline"]
30
+ },
31
+ {
32
+ "id": "verification",
33
+ "type": "verification",
34
+ "dependsOn": ["maker"]
35
+ },
36
+ {
37
+ "id": "review",
38
+ "type": "devil-advocate",
39
+ "dependsOn": ["verification"]
40
+ },
41
+ {
42
+ "id": "judge",
43
+ "type": "judge",
44
+ "dependsOn": ["review"]
45
+ },
46
+ {
47
+ "id": "delivery-approval",
48
+ "type": "approval",
49
+ "dependsOn": ["judge"],
50
+ "when": {
51
+ "field": "run.mode",
52
+ "operator": "equals",
53
+ "value": "ASSISTED"
54
+ },
55
+ "message": "Approve the verified refactor for delivery."
56
+ },
57
+ {
58
+ "id": "delivery",
59
+ "type": "delivery",
60
+ "dependsOn": ["judge", "delivery-approval"]
61
+ }
62
+ ]
63
+ }
@@ -0,0 +1,19 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://github.com/egagofur/ai-engineering-loop/schemas/compiled-plan.schema.json",
4
+ "title": "AI Engineering Loop Compiled Plan",
5
+ "type": "object",
6
+ "required": ["schemaVersion", "compilerVersion", "recipe", "mode", "nodes", "graphHash"],
7
+ "properties": {
8
+ "schemaVersion": { "const": 1 },
9
+ "compilerVersion": { "const": 1 },
10
+ "recipe": {
11
+ "type": "object",
12
+ "required": ["id", "version", "sourceHash"]
13
+ },
14
+ "mode": { "enum": ["REPORT_ONLY", "ASSISTED", "UNATTENDED"] },
15
+ "nodes": { "type": "array", "minItems": 1, "maxItems": 64 },
16
+ "graphHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
17
+ },
18
+ "additionalProperties": true
19
+ }
@@ -0,0 +1,36 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://github.com/egagofur/ai-engineering-loop/schemas/handoff.schema.json",
4
+ "title": "AI Engineering Loop Redacted Handoff",
5
+ "type": "object",
6
+ "required": [
7
+ "schemaVersion",
8
+ "audience",
9
+ "runId",
10
+ "generatedAt",
11
+ "finalState",
12
+ "redacted",
13
+ "sourceIncluded",
14
+ "redactionCategories",
15
+ "content",
16
+ "bundleHash"
17
+ ],
18
+ "properties": {
19
+ "schemaVersion": { "const": 1 },
20
+ "audience": { "enum": ["developer", "agent", "auditor"] },
21
+ "runId": { "type": "string", "minLength": 1 },
22
+ "generatedAt": { "type": "string", "format": "date-time" },
23
+ "graphHash": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
24
+ "finalState": { "type": "string", "minLength": 1 },
25
+ "redacted": { "const": true },
26
+ "sourceIncluded": { "const": false },
27
+ "redactionCategories": {
28
+ "type": "array",
29
+ "items": { "type": "string" },
30
+ "uniqueItems": true
31
+ },
32
+ "content": { "type": "object" },
33
+ "bundleHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
34
+ },
35
+ "additionalProperties": false
36
+ }
@@ -0,0 +1,33 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://github.com/egagofur/ai-engineering-loop/schemas/node-definition.schema.json",
4
+ "title": "AI Engineering Loop Node Definition",
5
+ "type": "object",
6
+ "required": ["id", "type"],
7
+ "properties": {
8
+ "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,63}$" },
9
+ "type": {
10
+ "enum": [
11
+ "goal-contract",
12
+ "agent",
13
+ "command",
14
+ "condition",
15
+ "approval",
16
+ "artifact-check",
17
+ "maker",
18
+ "verification",
19
+ "devil-advocate",
20
+ "judge",
21
+ "report",
22
+ "delivery"
23
+ ]
24
+ },
25
+ "dependsOn": {
26
+ "type": "array",
27
+ "uniqueItems": true,
28
+ "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,63}$" }
29
+ },
30
+ "when": { "type": "object" }
31
+ },
32
+ "additionalProperties": true
33
+ }
@@ -0,0 +1,26 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://github.com/egagofur/ai-engineering-loop/schemas/recipe.schema.json",
4
+ "title": "AI Engineering Loop Recipe",
5
+ "type": "object",
6
+ "required": ["schemaVersion", "id", "version", "description", "compatibleModes", "nodes"],
7
+ "properties": {
8
+ "schemaVersion": { "const": 1 },
9
+ "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,63}$" },
10
+ "version": { "type": "integer", "minimum": 1 },
11
+ "description": { "type": "string", "minLength": 1 },
12
+ "compatibleModes": {
13
+ "type": "array",
14
+ "minItems": 1,
15
+ "uniqueItems": true,
16
+ "items": { "enum": ["REPORT_ONLY", "ASSISTED", "UNATTENDED"] }
17
+ },
18
+ "nodes": {
19
+ "type": "array",
20
+ "minItems": 1,
21
+ "maxItems": 64,
22
+ "items": { "$ref": "node-definition.schema.json" }
23
+ }
24
+ },
25
+ "additionalProperties": false
26
+ }
@@ -0,0 +1,29 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://github.com/egagofur/ai-engineering-loop/schemas/workflow-event.schema.json",
4
+ "title": "AI Engineering Loop Workflow Event",
5
+ "type": "object",
6
+ "required": ["schemaVersion", "sequence", "previousHash", "at", "type", "runId", "graphHash", "hash"],
7
+ "properties": {
8
+ "schemaVersion": { "const": 1 },
9
+ "sequence": { "type": "integer", "minimum": 1 },
10
+ "previousHash": { "type": ["string", "null"] },
11
+ "at": { "type": "string", "format": "date-time" },
12
+ "type": {
13
+ "enum": [
14
+ "WORKFLOW_CREATED",
15
+ "NODE_STARTED",
16
+ "NODE_ACTIVITY",
17
+ "NODE_COMPLETED",
18
+ "NODE_FAILED",
19
+ "NODE_RETRIED",
20
+ "NODE_APPROVED",
21
+ "GATE_PASSED"
22
+ ]
23
+ },
24
+ "runId": { "type": "string", "minLength": 1 },
25
+ "graphHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
26
+ "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
27
+ },
28
+ "additionalProperties": true
29
+ }
@@ -0,0 +1,29 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://github.com/egagofur/ai-engineering-loop/schemas/workflow-state.schema.json",
4
+ "title": "AI Engineering Loop Workflow Runtime State",
5
+ "type": "object",
6
+ "required": ["schemaVersion", "runId", "graphHash", "sequence", "eventHash", "nodes"],
7
+ "properties": {
8
+ "schemaVersion": { "const": 1 },
9
+ "runId": { "type": "string", "minLength": 1 },
10
+ "graphHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
11
+ "sequence": { "type": "integer", "minimum": 1 },
12
+ "eventHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
13
+ "nodes": {
14
+ "type": "object",
15
+ "additionalProperties": {
16
+ "type": "object",
17
+ "required": ["status", "attempts", "updatedAt"],
18
+ "properties": {
19
+ "status": {
20
+ "enum": ["PENDING", "READY", "RUNNING", "PASSED", "FAILED", "SKIPPED", "BLOCKED"]
21
+ },
22
+ "attempts": { "type": "integer", "minimum": 0 },
23
+ "updatedAt": { "type": "string", "format": "date-time" }
24
+ }
25
+ }
26
+ }
27
+ },
28
+ "additionalProperties": false
29
+ }