feat: add Work guidance and adaptive Plan experiments
Test / Tests and coverage occurred while executing withChecks step.
Intrepid/AI Engineering/pipeline/head There was a failure building this commit
build / jvm (push) Canceled after 0s
build / native (macos-15, macos-arm64) (push) Canceled after 0s
build / native (ubuntu-24.04, linux-x86_64) (push) Canceled after 0s
build / native (windows-2025, windows-x86_64) (push) Canceled after 0s

Persist explicit human discussion choices, DEC requests and approval policies. Add optional evidence-backed Plan experiments and align context, adapters and next actions under protocol contract 3.

Include WRK-000B decisions, plan history and verification evidence: 167 JVM tests, 25 focused checks, Jenkins fixtures and native smoke coverage.
This commit is contained in:
2026-11-16 17:33:24 +00:00
parent 3c75ce70f6
commit f5d5db73c2
104 changed files with 4432 additions and 106 deletions
+81 -14
View File
@@ -27,7 +27,7 @@ mkdir plain
cd plain
printf 'Existing source\n' > main.txt
aie_without_git init --name 'Simple Project' > init.yaml
aie_without_git work create 'Continue application' --goal 'Preserve local context' > work.yaml
aie_without_git work create --mode DIRECT --approval WAIVED --human-approved --choice-reason "Explicit synthetic fixture policy" 'Continue application' --goal 'Preserve local context' > work.yaml
aie_without_git work list --open --format table > works-table.txt
grep -q 'WRK-0001' works-table.txt
grep -q '0/0' works-table.txt
@@ -48,9 +48,9 @@ grep -q '^WRK-0001,CREATE_PLAN,' actions.csv
aie_without_git project compatibility --format json > compatibility.json
grep -q '"state" : "CURRENT"' compatibility.json
grep -q '"migrationRequired" : false' compatibility.json
grep -q '"protocolVersion": 2' .ai-engineering/protocol.json
grep -q '"protocolVersion": 3' .ai-engineering/protocol.json
cp .ai-engineering/protocol.json baseline-protocol.json
sed 's/"protocolVersion": 2/"protocolVersion": 99/' baseline-protocol.json > .ai-engineering/protocol.json
sed 's/"protocolVersion": 3/"protocolVersion": 99/' baseline-protocol.json > .ai-engineering/protocol.json
cp .ai-engineering/protocol.json future-protocol.json
if aie_without_git project compatibility --format json > future-compatibility.json; then
echo 'Unsupported contract unexpectedly succeeded' >&2
@@ -114,7 +114,7 @@ cd "$aie_fixture"
mkdir plan-promotion
cd plan-promotion
aie_without_git init --name 'Plan Promotion' > init.yaml
aie_without_git work create 'Promote decision' > work.yaml
aie_without_git work create --mode DIRECT --approval WAIVED --human-approved --choice-reason "Explicit synthetic fixture policy" 'Promote decision' > work.yaml
aie_without_git decision draft WRK-0001 --title 'Chosen approach' --context 'Problem' \
--approach 'Small implementation' --rationale 'Bounded scope' > draft.yaml
aie_without_git plan create WRK-0001 --title 'Delivery' --decision DEC-0001 --author requester > plan.yaml
@@ -177,7 +177,7 @@ git init -q single
cd single
"$aie_binary" init --name 'Single Repository' > init.yaml
"$aie_binary" repo add app --path . > repo.yaml
"$aie_binary" work create 'Inspect application' --repo app > work.yaml
"$aie_binary" work create --mode DIRECT --approval WAIVED --human-approved --choice-reason "Explicit synthetic fixture policy" 'Inspect application' --repo app > work.yaml
"$aie_binary" work context WRK-0001 --format json > before.json
mkdir src
cd src
@@ -195,7 +195,7 @@ mkdir hexadecimal
cd hexadecimal
aie_without_git init --name 'Hexadecimal Works' > init.yaml
for aie_number in {1..16}; do
aie_without_git work create "Work $aie_number" > "work-$aie_number.yaml"
aie_without_git work create --mode DIRECT --approval WAIVED --human-approved --choice-reason "Explicit synthetic fixture policy" "Work $aie_number" > "work-$aie_number.yaml"
done
grep -q 'id: "WRK-0009"' work-9.yaml
grep -q 'id: "WRK-000A"' work-10.yaml
@@ -220,7 +220,7 @@ mkdir legacy-counter
cd legacy-counter
aie_without_git init --name 'Legacy reservations' > init.yaml
printf 'schemaVersion: 1\nlastWork: 16\n' > .ai-engineering/works/.sequence.yaml
aie_without_git work create 'After legacy reservation' > work.yaml
aie_without_git work create --mode DIRECT --approval WAIVED --human-approved --choice-reason "Explicit synthetic fixture policy" 'After legacy reservation' > work.yaml
grep -q 'id: "WRK-0017"' work.yaml
grep -q 'schemaVersion: 2' .ai-engineering/works/.sequence.yaml
aie_without_git project validate --format json > validation.json
@@ -233,7 +233,7 @@ mkdir refinement
cd refinement
aie_without_git init --name 'Refinement fixture' --general-adapter fixture-general \
--archive-policy reversible > init.yaml
aie_without_git work create 'Compare ideas' > work.yaml
aie_without_git work create --mode DIRECT --approval WAIVED --human-approved --choice-reason "Explicit synthetic fixture policy" 'Compare ideas' > work.yaml
printf 'Rendering: measure layers\nInput: compare controls\n' > ideas.md
aie_without_git agent run WRK-0001 --task-file ideas.md --request-id ideas --requester fixture-human > refinement.md
aie_without_git topic list WRK-0001 --format json > topics.json
@@ -329,7 +329,7 @@ printf '1\ngeneral\ndefault\n5\n1\n3\nreviewer\ndefault\n5\n1\n' > setup.txt
aie_without_git init . --name 'Native CLI fixture' --interactive --input-file setup.txt > setup.yaml
aie_without_git agent doctor --format json > doctor.json
grep -q '"compatible" : true' doctor.json
aie_without_git work create 'Provider protocol' > work.yaml
aie_without_git work create --mode DIRECT --approval WAIVED --human-approved --choice-reason "Explicit synthetic fixture policy" 'Provider protocol' > work.yaml
aie_without_git discussion add WRK-0001 --text 'Synthetic source for provider protocol tests' > source.md
aie_without_git agent run WRK-0001 --task 'Summarize the synthetic note' --request-id classified --format json > codex.json
grep -q '"classification" : {' codex.json
@@ -356,7 +356,7 @@ mkdir epic-coordination
cd epic-coordination
aie_without_git init --name 'EPIC coordination fixture' > init.yaml
for aie_title in Parent Required Cancelled Optional; do
aie_without_git work create "$aie_title" --acceptance 'Reviewed fixture result' > "$aie_title.yaml"
aie_without_git work create --mode DIRECT --approval WAIVED --human-approved --choice-reason "Explicit synthetic fixture policy" "$aie_title" --acceptance 'Reviewed fixture result' > "$aie_title.yaml"
done
aie_without_git epic configure WRK-0001 --mode results --by fixture-agent --reason 'Coordinate slices' > epic.md
for aie_child in WRK-0002 WRK-0003 WRK-0004; do
@@ -407,8 +407,8 @@ aie_without_git work reopen WRK-0001 --by fixture-owner --reason 'Explicitly beg
aie_without_git epic reconcile WRK-0001 > held-open.yaml
aie_without_git work show WRK-0001 --format json > replanning.json
grep -q '"status" : "ACTIVE"' replanning.json
aie_without_git work create 'Decomposition' --acceptance 'Recorded decomposition' > decomposition.yaml
aie_without_git work create 'Future execution' --acceptance 'Future child result' > future.yaml
aie_without_git work create --mode DIRECT --approval WAIVED --human-approved --choice-reason "Explicit synthetic fixture policy" 'Decomposition' --acceptance 'Recorded decomposition' > decomposition.yaml
aie_without_git work create --mode DIRECT --approval WAIVED --human-approved --choice-reason "Explicit synthetic fixture policy" 'Future execution' --acceptance 'Future child result' > future.yaml
aie_without_git epic configure WRK-0005 --mode decomposition --by fixture-agent --reason 'Deliver only decomposition' > decomposition-policy.md
aie_without_git epic link WRK-0005 WRK-0006 --by fixture-agent --reason 'Future scope' > future-link.md
aie_without_git artifact add WRK-0005 --file evidence.txt --purpose 'Synthetic decomposition evidence' > decomposition-evidence.yaml
@@ -430,7 +430,7 @@ done
"$aie_binary" init --name 'Continuity Experiment' > init.yaml
"$aie_binary" repo add runtime --path runtime --language rust > runtime.yaml
"$aie_binary" repo add studio --path studio --language java > studio.yaml
"$aie_binary" work create 'Improve scene editor' --repo runtime --repo studio \
"$aie_binary" work create --mode DIRECT --approval WAIVED --human-approved --choice-reason "Explicit synthetic fixture policy" 'Improve scene editor' --repo runtime --repo studio \
--goal 'Continue across agents' --constraint 'No server' \
--acceptance 'Fresh process reconstructs state' > work.yaml
"$aie_binary" discussion add WRK-0001 --kind QUESTION --author agent-a \
@@ -522,7 +522,7 @@ echo 'Native operational-cycle smoke passed (discovery, approval, plan, evidence
mkdir "$aie_fixture/plan-consolidation"
cd "$aie_fixture/plan-consolidation"
aie_without_git init --name 'Plan consolidation' > init.yaml
aie_without_git work create 'Delivery' > work.yaml
aie_without_git work create --mode DIRECT --approval WAIVED --human-approved --choice-reason "Explicit synthetic fixture policy" 'Delivery' > work.yaml
printf 'Synthetic executed result\n' > result.txt
aie_without_git artifact add WRK-0001 --file result.txt --purpose 'Fixture execution' > evidence.yaml
aie_without_git next-actions WRK-0001 --format json > empty-actions.json
@@ -556,4 +556,71 @@ cmp before.json after.json
aie_without_git project validate --format json > validation.json
grep -q '"valid" : true' validation.json
echo 'Native Plan consolidation smoke passed (multiple Plans, reviewed cancellation, system completion and fresh-process replay; no model/JVM).'
# Human conduct and optional OODA across fresh native processes without Git/JVM/model.
mkdir "$aie_fixture/work-guidance"
cd "$aie_fixture/work-guidance"
aie_without_git init --name 'Human conduct and experiments' > init.yaml
aie_without_git work create 'Explicit human control' > unspecified.yaml
aie_without_git next-actions WRK-0001 --format json > unspecified-actions.json
grep -q ASK_DISCUSSION_MODE unspecified-actions.json
if grep -q CREATE_PLAN unspecified-actions.json; then exit 1; fi
if aie_without_git decision draft WRK-0001 --title 'Premature' > refused-draft.txt 2>&1; then exit 1; else test "$?" -eq 2; fi
aie_without_git work guidance WRK-0001 --mode EXPLORATORY --by fixture-human \
--reason 'Explicit exploratory fixture choice' --human-approved > exploratory.yaml
aie_without_git work guidance WRK-0001 --approval WAIVED --by fixture-human \
--reason 'Explicit Work-wide fixture waiver' --human-approved > waiver.yaml
if aie_without_git decision draft WRK-0001 --title 'Still premature' > unrequested.txt 2>&1; then exit 1; else test "$?" -eq 2; fi
aie_without_git work request-decision WRK-0001 --by fixture-human \
--reason 'Human concluded exploration and requested DEC' --human-approved > requested.yaml
aie_without_git decision draft WRK-0001 --title 'Measured approach' --context 'Fixture latency' \
--approach 'Measure batching under the agreed limits' --rationale 'Evidence guides implementation' > draft.yaml
aie_without_git plan create WRK-0001 --title 'Adaptive delivery' --decision DEC-0001 > plan.yaml
aie_without_git plan step add WRK-0001 PLN-0001 --title 'Optimize' > optimize.yaml
aie_without_git plan step add WRK-0001 PLN-0001 --title 'Independent documentation' > independent.yaml
aie_without_git plan experiment start WRK-0001 PLN-0001 --step TSK-0001 \
--hypothesis 'Batching meets target' --criterion 'Latency below 10ms' \
--invocation 'Synthetic smoke measurement' --by fixture-agent --reason 'Record criteria first' > started.yaml
printf 'Synthetic fixture observation: latency 17ms\n' > measurement.txt
aie_without_git artifact add WRK-0001 --file measurement.txt --purpose 'Synthetic measured result' > evidence.yaml
aie_without_git plan step status WRK-0001 PLN-0001 TSK-0002 COMPLETED --by fixture-agent \
--reason 'Independent fixture result' --evidence ART-0001 > independent-result.yaml
if aie_without_git plan step status WRK-0001 PLN-0001 TSK-0001 COMPLETED --by fixture-agent \
--reason 'Premature completion' --evidence ART-0001 > pending-experiment.txt 2>&1; then exit 1; else test "$?" -eq 2; fi
aie_without_git plan experiment finish WRK-0001 PLN-0001 EXP-0001 --outcome REFUTED \
--observation 'Latency measured 17ms' --interpretation 'Batching is insufficient' \
--next-action 'Investigate a revised approach' --evidence ART-0001 --questions-decision DEC-0001 \
--by fixture-agent --reason 'Evidence changes next action' > observed.yaml
aie_without_git next-actions WRK-0001 --format json > concern-actions.json
grep -q REVISIT_DECISION concern-actions.json
if aie_without_git plan step status WRK-0001 PLN-0001 TSK-0001 COMPLETED --by fixture-agent \
--reason 'Contradict DEC' --evidence ART-0001 > questioned.txt 2>&1; then exit 1; else test "$?" -eq 2; fi
aie_without_git work request-decision WRK-0001 --by fixture-human \
--reason 'Human requested revision after discussing the measurement' --human-approved > revision-request.yaml
aie_without_git decision revise WRK-0001 DEC-0001 --by fixture-agent --reason 'Measurement requires revision' > revised.yaml
aie_without_git decision update WRK-0001 DEC-0002 --approach 'Revised measured approach' \
--by fixture-agent --reason 'Recorded changed approach' > updated.yaml
aie_without_git decision accept WRK-0001 DEC-0002 --by fixture-human \
--reason 'Human reviewed the revised DEC' --human-approved > approved.yaml
aie_without_git plan update WRK-0001 PLN-0001 --decision DEC-0002 --by fixture-agent \
--reason 'Use approved DEC revision' > replanned.yaml
aie_without_git plan step status WRK-0001 PLN-0001 TSK-0001 COMPLETED --by fixture-agent \
--reason 'Verified revised fixture result' --evidence ART-0001 > completed.yaml
grep -q SYSTEM_PLANS completed.yaml
aie_without_git plan experiment list WRK-0001 PLN-0001 --format json > experiment-history.json
grep -q 'Investigate a revised approach' experiment-history.json
aie_without_git work context WRK-0001 --format json > context.json
grep -q 'EXPLORATORY' context.json
grep -q 'guidanceInstructions' context.json
aie_without_git work create 'Default review' > default-review.yaml
aie_without_git work guidance WRK-0002 --mode DIRECT --by fixture-human \
--reason 'Explicit direct fixture choice' --human-approved > direct.yaml
aie_without_git decision draft WRK-0002 --title 'Concrete DEC' --context 'Simple fixture' \
--approach 'Small change' --rationale 'Bounded' > required-draft.yaml
if aie_without_git plan create WRK-0002 --title 'Bypass review' --decision DEC-0001 > required-review.txt 2>&1; then exit 1; else test "$?" -eq 2; fi
aie_without_git decision accept WRK-0002 DEC-0001 --by fixture-human \
--reason 'Approve concrete DEC' --human-approved > required-approval.yaml
aie_without_git plan create WRK-0002 --title 'Authorized' --decision DEC-0001 > authorized.yaml
aie_without_git project validate --format json > validation.json
grep -q '"valid" : true' validation.json
echo 'Native Work guidance/OODA smoke passed (human mode/request/approval, explicit waiver, criteria, evidence, independent execution and approved DEC revision).'
if [[ "${AIE_KEEP_FIXTURE:-0}" == 1 ]]; then echo "Fixture retained: $aie_fixture"; fi