@pixelfactoryio/theway 0.17.0 → 0.19.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/README.md +4 -2
- package/dist/licenses/inter-OFL.txt +93 -0
- package/dist/licenses/jetbrains-mono-OFL.txt +93 -0
- package/dist/theway.js +5986 -1507
- package/package.json +42 -4
- package/plugin/.claude-plugin/plugin.json +2 -2
- package/plugin/commands/archive.md +5 -5
- package/plugin/commands/document.md +2 -2
- package/plugin/commands/engineering.md +3 -1
- package/plugin/commands/list.md +2 -2
- package/plugin/commands/workflow.md +50 -117
- package/plugin/home/config.yaml +0 -9
- package/plugin/home/prompts/branch.md +20 -0
- package/plugin/home/prompts/change-template.md +48 -0
- package/plugin/home/prompts/change.md +32 -0
- package/plugin/home/prompts/ci.md +10 -0
- package/plugin/home/prompts/fix-ci.md +18 -0
- package/plugin/home/prompts/fix-review.md +20 -0
- package/plugin/home/prompts/fix-spec-template.md +2 -2
- package/plugin/home/prompts/fix-spec.md +16 -0
- package/plugin/home/prompts/grounding.md +1 -1
- package/plugin/home/prompts/implement.md +24 -4
- package/plugin/home/prompts/open-pr.md +15 -2
- package/plugin/home/prompts/review.md +23 -0
- package/plugin/home/prompts/scaffold-light.md +27 -14
- package/plugin/home/prompts/scaffold-rules.md +4 -3
- package/plugin/home/prompts/scaffold.md +27 -15
- package/plugin/home/prompts/spec-review.md +29 -0
- package/plugin/home/prompts/spec-template.md +1 -1
- package/plugin/home/prompts/spec-triage.md +25 -2
- package/plugin/home/prompts/triage.md +28 -1
- package/plugin/home/standards/authority.md +6 -0
- package/plugin/home/standards/develop.md +5 -5
- package/plugin/home/standards/interaction.md +0 -7
- package/plugin/home/workflows/agents.yaml +34 -7
- package/plugin/home/workflows/develop.yaml +12 -5
- package/plugin/home/workflows/engineering-light.yaml +19 -6
- package/plugin/home/workflows/engineering.yaml +18 -6
- package/plugin/workflows/run-pipeline.js +126 -510
- package/plugin/home/prompts/ci-diagnose.md +0 -15
- package/plugin/home/prompts/ci-fix.md +0 -7
- package/plugin/home/prompts/ci-wait.md +0 -5
- package/plugin/home/prompts/fix-check.md +0 -7
- package/plugin/home/prompts/fix.md +0 -9
- package/plugin/home/prompts/reviewer.md +0 -7
- package/plugin/home/prompts/spec-fix.md +0 -5
- package/plugin/home/prompts/spec-reviewer.md +0 -16
- package/plugin/home/prompts/tasks-template.md +0 -56
- package/plugin/home/prompts/verdicts.md +0 -11
- package/plugin/home/schemas/step.v1.json +0 -449
- package/plugin/home/schemas/workflow.v1.json +0 -115
- package/plugin/home/steps/implement.yaml +0 -7
- package/plugin/home/steps/pr.yaml +0 -21
- package/plugin/home/steps/review.yaml +0 -25
- package/plugin/home/steps/scaffold-light.yaml +0 -7
- package/plugin/home/steps/scaffold.yaml +0 -7
- package/plugin/home/steps/spec-review.yaml +0 -26
|
@@ -1,115 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
-
"$id": "https://pixelfactoryio.github.io/theway/schemas/workflow.v1.json",
|
|
4
|
-
"title": "theway workflow",
|
|
5
|
-
"description": "A theway workflow: the ordered steps /theway:workflow runs, for change IDs (input: changes) or for a free-text request (input: request). theway workflow is the authority for the rules this schema cannot express.",
|
|
6
|
-
"type": "object",
|
|
7
|
-
"additionalProperties": false,
|
|
8
|
-
"required": [
|
|
9
|
-
"version",
|
|
10
|
-
"steps"
|
|
11
|
-
],
|
|
12
|
-
"properties": {
|
|
13
|
-
"version": {
|
|
14
|
-
"const": "theway.workflow/v1",
|
|
15
|
-
"description": "The format of this file: theway.workflow/v1."
|
|
16
|
-
},
|
|
17
|
-
"description": {
|
|
18
|
-
"type": "string",
|
|
19
|
-
"minLength": 1,
|
|
20
|
-
"description": "One line on what the workflow does; theway workflow prints it."
|
|
21
|
-
},
|
|
22
|
-
"input": {
|
|
23
|
-
"type": "string",
|
|
24
|
-
"enum": [
|
|
25
|
-
"changes",
|
|
26
|
-
"request"
|
|
27
|
-
],
|
|
28
|
-
"description": "What the workflow takes: changes (the default), change IDs, written on each change's feature branch; or request, a free-text request, writing only the change folders it creates. A request workflow starts with a step whose first agent returns scaffold, has exactly one scaffold agent and no agent with access commit or push; a changes workflow has no agent that returns scaffold or edits or takes access spec."
|
|
29
|
-
},
|
|
30
|
-
"default": {
|
|
31
|
-
"type": "boolean",
|
|
32
|
-
"description": "Whether /theway:workflow runs this workflow when no --workflow is given; only for an input: changes workflow."
|
|
33
|
-
},
|
|
34
|
-
"agents": {
|
|
35
|
-
"type": "boolean",
|
|
36
|
-
"description": "Whether the steps run through agents (true, the default) or inline in the session (false), unless an entry sets its own."
|
|
37
|
-
},
|
|
38
|
-
"steps": {
|
|
39
|
-
"type": "array",
|
|
40
|
-
"minItems": 1,
|
|
41
|
-
"description": "The entries, in run order: each a step name or gate.",
|
|
42
|
-
"items": {
|
|
43
|
-
"$ref": "#/$defs/entry"
|
|
44
|
-
}
|
|
45
|
-
}
|
|
46
|
-
},
|
|
47
|
-
"$defs": {
|
|
48
|
-
"entry": {
|
|
49
|
-
"type": "object",
|
|
50
|
-
"minProperties": 1,
|
|
51
|
-
"maxProperties": 1,
|
|
52
|
-
"description": "One entry: a map with exactly one key, a step name or gate.",
|
|
53
|
-
"propertyNames": {
|
|
54
|
-
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
|
|
55
|
-
},
|
|
56
|
-
"properties": {
|
|
57
|
-
"gate": {
|
|
58
|
-
"type": "string",
|
|
59
|
-
"minLength": 1,
|
|
60
|
-
"description": "A question /theway:workflow asks the user before the next entry; any answer but Continue stops the change."
|
|
61
|
-
}
|
|
62
|
-
},
|
|
63
|
-
"additionalProperties": {
|
|
64
|
-
"description": "A step, resolved by name from the project's steps folder, else the global one; its value is nothing or a map of agents and the step's params.",
|
|
65
|
-
"anyOf": [
|
|
66
|
-
{
|
|
67
|
-
"type": "null",
|
|
68
|
-
"description": "No param set: every param takes its effective default."
|
|
69
|
-
},
|
|
70
|
-
{
|
|
71
|
-
"type": "object",
|
|
72
|
-
"description": "agents and the step's params, as literal values.",
|
|
73
|
-
"propertyNames": {
|
|
74
|
-
"pattern": "^[a-z][a-z0-9_]*$"
|
|
75
|
-
},
|
|
76
|
-
"properties": {
|
|
77
|
-
"agents": {
|
|
78
|
-
"type": "boolean",
|
|
79
|
-
"description": "Whether this step runs through agents (true) or inline in the session (false)."
|
|
80
|
-
}
|
|
81
|
-
},
|
|
82
|
-
"additionalProperties": {
|
|
83
|
-
"anyOf": [
|
|
84
|
-
{
|
|
85
|
-
"type": "string",
|
|
86
|
-
"description": "A string."
|
|
87
|
-
},
|
|
88
|
-
{
|
|
89
|
-
"type": "integer",
|
|
90
|
-
"description": "An integer."
|
|
91
|
-
},
|
|
92
|
-
{
|
|
93
|
-
"type": "boolean",
|
|
94
|
-
"description": "A boolean."
|
|
95
|
-
},
|
|
96
|
-
{
|
|
97
|
-
"type": "array",
|
|
98
|
-
"minItems": 1,
|
|
99
|
-
"uniqueItems": true,
|
|
100
|
-
"items": {
|
|
101
|
-
"type": "string",
|
|
102
|
-
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
|
|
103
|
-
"description": "A name: lowercase letters and digits in words separated by single hyphens."
|
|
104
|
-
},
|
|
105
|
-
"description": "A non-empty list of names without duplicates."
|
|
106
|
-
}
|
|
107
|
-
],
|
|
108
|
-
"description": "A param of the step: a string, an integer, a boolean or a non-empty list of names without duplicates, of the kind of its default."
|
|
109
|
-
}
|
|
110
|
-
}
|
|
111
|
-
]
|
|
112
|
-
}
|
|
113
|
-
}
|
|
114
|
-
}
|
|
115
|
-
}
|
|
@@ -1,7 +0,0 @@
|
|
|
1
|
-
# yaml-language-server: $schema=https://pixelfactoryio.github.io/theway/schemas/step.v1.json
|
|
2
|
-
version: theway.step/v1
|
|
3
|
-
description: Implement the change's tasks as its spec says
|
|
4
|
-
params:
|
|
5
|
-
model: {default: opus, description: The implementer}
|
|
6
|
-
do:
|
|
7
|
-
- agent: {returns: work}
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
# yaml-language-server: $schema=https://pixelfactoryio.github.io/theway/schemas/step.v1.json
|
|
2
|
-
version: theway.step/v1
|
|
3
|
-
description: Push the branch, open the PR and drive CI to green
|
|
4
|
-
params:
|
|
5
|
-
ci_attempts: {default: 2, description: "CI attempts to reach green, re-runs included"}
|
|
6
|
-
model: {default: sonnet, description: "The push and PR agent, CI polling and log fetching"}
|
|
7
|
-
fix_model: {default: opus, description: The CI fix agent}
|
|
8
|
-
do:
|
|
9
|
-
- agent: {prompt: open-pr, returns: pr}
|
|
10
|
-
- loop:
|
|
11
|
-
max: "${ci_attempts}"
|
|
12
|
-
until: green
|
|
13
|
-
exhausted: fail
|
|
14
|
-
do:
|
|
15
|
-
- agent: {prompt: ci-wait, returns: ci}
|
|
16
|
-
- when: red
|
|
17
|
-
do:
|
|
18
|
-
- agent: {prompt: ci-diagnose, returns: diagnosis}
|
|
19
|
-
- when: [fixable, more]
|
|
20
|
-
do:
|
|
21
|
-
- agent: {prompt: ci-fix, returns: work, access: push, model: "${fix_model}"}
|
|
@@ -1,25 +0,0 @@
|
|
|
1
|
-
# yaml-language-server: $schema=https://pixelfactoryio.github.io/theway/schemas/step.v1.json
|
|
2
|
-
version: theway.step/v1
|
|
3
|
-
description: Review the diff through each lens, triage the findings, fix the confirmed ones and check the fixes
|
|
4
|
-
params:
|
|
5
|
-
rounds: {default: 1, description: Maximum review rounds}
|
|
6
|
-
lenses: {default: [conformance, correctness], description: "One reviewer per lens, by prompt name"}
|
|
7
|
-
model: {default: opus, description: "The reviewers, the triage and the fix check"}
|
|
8
|
-
fix_model: {default: opus, description: The fix agent of each round}
|
|
9
|
-
do:
|
|
10
|
-
- loop:
|
|
11
|
-
max: "${rounds}"
|
|
12
|
-
until: no-confirmed
|
|
13
|
-
exhausted: continue
|
|
14
|
-
do:
|
|
15
|
-
- foreach: "${lenses}"
|
|
16
|
-
parallel: true
|
|
17
|
-
do:
|
|
18
|
-
- agent: {prompt: [reviewer, "${item}"], returns: findings}
|
|
19
|
-
- when: findings
|
|
20
|
-
do:
|
|
21
|
-
- agent: {prompt: [verdicts, triage], returns: verdicts}
|
|
22
|
-
- when: confirmed
|
|
23
|
-
do:
|
|
24
|
-
- agent: {prompt: fix, returns: work, model: "${fix_model}"}
|
|
25
|
-
- agent: {prompt: fix-check, returns: resolutions}
|
|
@@ -1,7 +0,0 @@
|
|
|
1
|
-
# yaml-language-server: $schema=https://pixelfactoryio.github.io/theway/schemas/step.v1.json
|
|
2
|
-
version: theway.step/v1
|
|
3
|
-
description: Investigate a small request and write its light spec and tasks, or escalate
|
|
4
|
-
params:
|
|
5
|
-
model: {default: opus, description: The scaffolder when the step runs through agents}
|
|
6
|
-
do:
|
|
7
|
-
- agent: {prompt: [tamm-framework, spec-investigation, scaffold-rules, light-spec-template, tasks-template, scaffold-light], returns: scaffold}
|
|
@@ -1,7 +0,0 @@
|
|
|
1
|
-
# yaml-language-server: $schema=https://pixelfactoryio.github.io/theway/schemas/step.v1.json
|
|
2
|
-
version: theway.step/v1
|
|
3
|
-
description: Investigate the request and write the change's spec, tasks and design
|
|
4
|
-
params:
|
|
5
|
-
model: {default: opus, description: The scaffolder when the step runs through agents}
|
|
6
|
-
do:
|
|
7
|
-
- agent: {prompt: [tamm-framework, spec-investigation, scaffold-rules, spec-template, fix-spec-template, tasks-template, scaffold], returns: scaffold}
|
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
# yaml-language-server: $schema=https://pixelfactoryio.github.io/theway/schemas/step.v1.json
|
|
2
|
-
version: theway.step/v1
|
|
3
|
-
description: Review the change's spec through each lens, triage, fix the confirmed findings and stop on a decision
|
|
4
|
-
params:
|
|
5
|
-
rounds: {default: 1, description: Maximum review rounds}
|
|
6
|
-
lenses: {default: [grounding, implementability], description: "One critic per lens, by prompt name"}
|
|
7
|
-
model: {default: opus, description: "The critics, the triage and the fix agent"}
|
|
8
|
-
on_decision: {default: open question, description: The message a confirmed decision stops the run with}
|
|
9
|
-
do:
|
|
10
|
-
- loop:
|
|
11
|
-
max: "${rounds}"
|
|
12
|
-
until: no-confirmed
|
|
13
|
-
exhausted: continue
|
|
14
|
-
do:
|
|
15
|
-
- foreach: "${lenses}"
|
|
16
|
-
parallel: true
|
|
17
|
-
do:
|
|
18
|
-
- agent: {prompt: [spec-reviewer, "${item}"], returns: findings}
|
|
19
|
-
- when: findings
|
|
20
|
-
do:
|
|
21
|
-
- agent: {prompt: [verdicts, spec-triage], returns: verdicts}
|
|
22
|
-
- when: confirmed
|
|
23
|
-
do:
|
|
24
|
-
- agent: {prompt: spec-fix, returns: edits}
|
|
25
|
-
- when: decision
|
|
26
|
-
block: "${on_decision}"
|