ai-engineering-loop 1.2.1 → 1.5.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.5.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,6 +14,7 @@
14
14
  "policies/",
15
15
  "profiles/",
16
16
  "adapters/",
17
+ "recipes/",
17
18
  "schemas/",
18
19
  "evals/",
19
20
  ".agents/",
@@ -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,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,28 @@
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_COMPLETED",
17
+ "NODE_FAILED",
18
+ "NODE_RETRIED",
19
+ "NODE_APPROVED",
20
+ "GATE_PASSED"
21
+ ]
22
+ },
23
+ "runId": { "type": "string", "minLength": 1 },
24
+ "graphHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
25
+ "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
26
+ },
27
+ "additionalProperties": true
28
+ }
@@ -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
+ }