@smartergpt/lexrunner 1.0.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/.changes/ci-debug-added.txt +1 -0
- package/.changeset/tsconfig-solution-build.md +5 -0
- package/.editorconfig +9 -0
- package/.env.example +8 -0
- package/.github/COST_EFFICIENCY.md +60 -0
- package/.github/ISSUE_TEMPLATE/bug_report.md +28 -0
- package/.github/ISSUE_TEMPLATE/epic.yml +123 -0
- package/.github/ISSUE_TEMPLATE/feature_request.md +26 -0
- package/.github/ISSUE_TEMPLATE/issue-A1-gate-input-validation.md +380 -0
- package/.github/ISSUE_TEMPLATE/issue-B1-scope-validation.md +509 -0
- package/.github/ISSUE_TEMPLATE/issue-C1-command-whitelist.md +463 -0
- package/.github/ISSUE_TEMPLATE/subtask.yml +153 -0
- package/.github/PULL_REQUEST_TEMPLATE.md +9 -0
- package/.github/copilot-instructions-old.md +429 -0
- package/.github/copilot-instructions.md +33 -0
- package/.github/instructions/tests.instructions.md +10 -0
- package/.github/workflows/auto-delete-merged-branches.yml +103 -0
- package/.github/workflows/benchmarks.yml +72 -0
- package/.github/workflows/ci-debug.yml +33 -0
- package/.github/workflows/ci.yml +167 -0
- package/.github/workflows/cli-smoke-test.yml +345 -0
- package/.github/workflows/copilot-setup-steps.yml +20 -0
- package/.github/workflows/frame-emission-gate.yml +242 -0
- package/.github/workflows/project-auto.yml +24 -0
- package/.github/workflows/release.yml +260 -0
- package/.github/workflows/slow-cli-tests.yml +37 -0
- package/.github/workflows/tag-guard.yml +44 -0
- package/.husky/pre-commit +1 -0
- package/.nvmrc +2 -0
- package/.prettierignore +28 -0
- package/.prettierrc.json +10 -0
- package/.smartergpt/CONTROL_DECK_VISION.md +226 -0
- package/.smartergpt/allowed-commands.json +41 -0
- package/.smartergpt/allowed-commands.strict.json +56 -0
- package/.smartergpt/deliverables/.live.md +426 -0
- package/.smartergpt/deliverables/ISSUE_STATUS_2025-12-28.md +193 -0
- package/.smartergpt/deliverables/_research/snapshot-contract-feedback/ADR_DISCUSSION.md +379 -0
- package/.smartergpt/deliverables/_research/snapshot-contract-feedback/Answer_claude-haiku.md +109 -0
- package/.smartergpt/deliverables/_research/snapshot-contract-feedback/Answer_gemini-flash.md +42 -0
- package/.smartergpt/deliverables/_research/snapshot-contract-feedback/Answer_gpt-codex-mini.md +19 -0
- package/.smartergpt/deliverables/_research/snapshot-contract-feedback/Answer_raptor-mini.md +37 -0
- package/.smartergpt/deliverables/_research/snapshot-contract-feedback/Question.md +37 -0
- package/.smartergpt/deliverables/merge-weave-04469e41-24ba-4ed5-b0ff-13c7ea12858d.ndjson +2 -0
- package/.smartergpt/deps.yml +3 -0
- package/.smartergpt/docs/fanout-templates.md +213 -0
- package/.smartergpt/docs/merge-weave-interventions.md +261 -0
- package/.smartergpt/docs/test-fix-patterns.md +240 -0
- package/.smartergpt/fanout-templates.yml +263 -0
- package/.smartergpt/gates.yml +9 -0
- package/.smartergpt/intent.md +1 -0
- package/.smartergpt/issues/QOL-001-analysis-script-filtering.md +36 -0
- package/.smartergpt/issues/QOL-002-log-retention-policy.md +92 -0
- package/.smartergpt/issues/QOL-003-realtime-console-feedback.md +44 -0
- package/.smartergpt/issues/QOL-004-governance-report-cli.md +44 -0
- package/.smartergpt/issues/QOL-005-schema-versioning.md +46 -0
- package/.smartergpt/issues/QOL-006-debug-verbose-mode.md +45 -0
- package/.smartergpt/issues/QOL-COMPLETION-REPORT.md +359 -0
- package/.smartergpt/issues/QOL-REVIEW-SUMMARY.md +111 -0
- package/.smartergpt/issues/QOL-ROADMAP.md +71 -0
- package/.smartergpt/merge-policy.yml +41 -0
- package/.smartergpt/merge-weave-policy.yml +255 -0
- package/.smartergpt/o1.json +0 -0
- package/.smartergpt/o2.json +0 -0
- package/.smartergpt/personas/eager-pm.md +123 -0
- package/.smartergpt/personas/example.md +81 -0
- package/.smartergpt/personas/senior-dev.md +107 -0
- package/.smartergpt/profile.yml +2 -0
- package/.smartergpt/prompts/create-project.md +112 -0
- package/.smartergpt/prompts/idea.md +64 -0
- package/.smartergpt/pull-request-template.md +25 -0
- package/.smartergpt/schemas/behavior-rule.schema.d.ts +54 -0
- package/.smartergpt/schemas/behavior-rule.schema.js +56 -0
- package/.smartergpt/schemas/behavior-rule.schema.json +105 -0
- package/.smartergpt/schemas/behavior-rule.schema.ts +60 -0
- package/.smartergpt/schemas/execution-plan-v1.d.ts +47 -0
- package/.smartergpt/schemas/execution-plan-v1.js +22 -0
- package/.smartergpt/schemas/execution-plan-v1.json +113 -0
- package/.smartergpt/schemas/execution-plan-v1.ts +32 -0
- package/.smartergpt/schemas/execution-plan.schema.json +116 -0
- package/.smartergpt/schemas/feature-spec-v0.d.ts +13 -0
- package/.smartergpt/schemas/feature-spec-v0.js +12 -0
- package/.smartergpt/schemas/feature-spec-v0.json +58 -0
- package/.smartergpt/schemas/feature-spec-v0.ts +16 -0
- package/.smartergpt/schemas/feature-spec.schema.json +111 -0
- package/.smartergpt/schemas/gates.schema.d.ts +48 -0
- package/.smartergpt/schemas/gates.schema.js +20 -0
- package/.smartergpt/schemas/gates.schema.json +47 -0
- package/.smartergpt/schemas/gates.schema.ts +26 -0
- package/.smartergpt/schemas/idea.schema.json +81 -0
- package/.smartergpt/schemas/runner.scope.schema.d.ts +54 -0
- package/.smartergpt/schemas/runner.scope.schema.js +28 -0
- package/.smartergpt/schemas/runner.scope.schema.json +75 -0
- package/.smartergpt/schemas/runner.scope.schema.ts +36 -0
- package/.smartergpt/schemas/runner.stack.schema.d.ts +40 -0
- package/.smartergpt/schemas/runner.stack.schema.js +21 -0
- package/.smartergpt/schemas/runner.stack.schema.json +51 -0
- package/.smartergpt/schemas/runner.stack.schema.ts +27 -0
- package/.smartergpt/scope.yml +11 -0
- package/.smartergpt/stack.yml +16 -0
- package/.smartergpt/test-fix-patterns.yml +106 -0
- package/.tool-versions +13 -0
- package/AGENTS.md +402 -0
- package/CHANGELOG.md +256 -0
- package/CLAUDE.md +484 -0
- package/CONTRIBUTING.md +345 -0
- package/EAGER_PM_FANOUT_ANALYSIS.md +283 -0
- package/FAQ.md +292 -0
- package/FIXTURE_LIBRARY_SUMMARY.md +327 -0
- package/IMPLEMENTATION_SUMMARY.md +222 -0
- package/LICENSE +21 -0
- package/MANUAL_TEST_GUIDE.md +229 -0
- package/MCP-ALIGNMENT-SUMMARY.md +261 -0
- package/MCP-CONFIG.md +125 -0
- package/MERGE_WEAVE_QUICKSTART.md +450 -0
- package/MERGE_WEAVE_SUMMARY.md +259 -0
- package/MERGE_WEAVE_USAGE_GUIDE.md +368 -0
- package/NOTICE.md +43 -0
- package/README.mcp.md +770 -0
- package/README.md +1069 -0
- package/TEST_INFRASTRUCTURE_ASSESSMENT.md +225 -0
- package/bootstrap-lexrunner.sh +396 -0
- package/dist/api-7H7SJZIX.js +15 -0
- package/dist/api-U3X2WA6D.js +15 -0
- package/dist/audit-2TZ2LU72.js +60 -0
- package/dist/audit-5HH5BMKI.js +60 -0
- package/dist/audit-6K5K333I.js +60 -0
- package/dist/audit-DYQWS57J.js +60 -0
- package/dist/audit-JBWZ2GZ2.js +60 -0
- package/dist/audit-SJF3434D.js +60 -0
- package/dist/audit-TICGGVX5.js +60 -0
- package/dist/audit-YOBB27PY.js +60 -0
- package/dist/autopilot-3GAVXWWC.js +45 -0
- package/dist/autopilot-43NOYVQA.js +45 -0
- package/dist/autopilot-4UA3OWLU.js +45 -0
- package/dist/autopilot-54TK5CCG.js +45 -0
- package/dist/autopilot-5BHC2UQT.js +45 -0
- package/dist/autopilot-ABZUCVGY.js +45 -0
- package/dist/autopilot-ACJZP47Y.js +45 -0
- package/dist/autopilot-AL5F5AUS.js +46 -0
- package/dist/autopilot-BO67FWUC.js +45 -0
- package/dist/autopilot-BR6W4GEX.js +45 -0
- package/dist/autopilot-FOR2UKRY.js +45 -0
- package/dist/autopilot-GDTTXHEQ.js +45 -0
- package/dist/autopilot-GEAMFZBM.js +45 -0
- package/dist/autopilot-HDMBRZE6.js +45 -0
- package/dist/autopilot-IKI2Y6S4.js +44 -0
- package/dist/autopilot-ILTBWWOL.js +46 -0
- package/dist/autopilot-KI3MXIFI.js +44 -0
- package/dist/autopilot-LWNPZC3J.js +45 -0
- package/dist/autopilot-LXPJ4ZXF.js +45 -0
- package/dist/autopilot-MDIFIONK.js +46 -0
- package/dist/autopilot-NW3LDP6M.js +45 -0
- package/dist/autopilot-OKTSCG35.js +45 -0
- package/dist/autopilot-OR5PF5PD.js +45 -0
- package/dist/autopilot-PE65SBGN.js +45 -0
- package/dist/autopilot-PW7I4B6W.js +45 -0
- package/dist/autopilot-QMLBL5P6.js +45 -0
- package/dist/autopilot-QSN6ZU5O.js +45 -0
- package/dist/autopilot-R7EZJOGI.js +46 -0
- package/dist/autopilot-T544CPPD.js +44 -0
- package/dist/autopilot-TNQB6VGJ.js +44 -0
- package/dist/autopilot-UVIYCR6K.js +45 -0
- package/dist/autopilot-W3ZTTSH3.js +45 -0
- package/dist/autopilot-XPKWOFXO.js +44 -0
- package/dist/autopilot-XRX4QWRM.js +44 -0
- package/dist/autopilot-Y3BAGNI5.js +44 -0
- package/dist/autopilot-ZE64XW2K.js +44 -0
- package/dist/chunk-2ESYSVXG.js +48 -0
- package/dist/chunk-2VR554P7.js +668 -0
- package/dist/chunk-37DOWIVT.js +1084 -0
- package/dist/chunk-3DU2DWUP.js +400 -0
- package/dist/chunk-3DVXIZFM.js +11166 -0
- package/dist/chunk-3FABZF4V.js +811 -0
- package/dist/chunk-4FFGNTAV.js +515 -0
- package/dist/chunk-4GEC4HC3.js +11221 -0
- package/dist/chunk-4RVZNLD4.js +628 -0
- package/dist/chunk-55VWJYZY.js +39 -0
- package/dist/chunk-5CGWZH5X.js +340 -0
- package/dist/chunk-5QKWKK4M.js +11794 -0
- package/dist/chunk-5Z3XHND7.js +11755 -0
- package/dist/chunk-6A4IE3TI.js +302 -0
- package/dist/chunk-6KK5JFFE.js +106 -0
- package/dist/chunk-6YC2VSLE.js +11252 -0
- package/dist/chunk-7C4K2SHD.js +668 -0
- package/dist/chunk-ANXY4RGA.js +11091 -0
- package/dist/chunk-ASHKNUBR.js +11312 -0
- package/dist/chunk-B3OYDPOP.js +11793 -0
- package/dist/chunk-DBH7SQ2S.js +1084 -0
- package/dist/chunk-DEI7A5B4.js +11449 -0
- package/dist/chunk-DM4GHY3J.js +92 -0
- package/dist/chunk-EQKFCZLH.js +9823 -0
- package/dist/chunk-FAIJPBT5.js +40 -0
- package/dist/chunk-FDDKUDXR.js +11166 -0
- package/dist/chunk-FEAR6ETG.js +438 -0
- package/dist/chunk-FNBAHK5V.js +72 -0
- package/dist/chunk-FXL74C73.js +523 -0
- package/dist/chunk-GLJEDX4L.js +10247 -0
- package/dist/chunk-GTP4OHD7.js +1107 -0
- package/dist/chunk-HIHH7IVO.js +10557 -0
- package/dist/chunk-I3VXUVCB.js +10474 -0
- package/dist/chunk-I6BIFVWI.js +10519 -0
- package/dist/chunk-I72TRUTJ.js +1084 -0
- package/dist/chunk-J5B5KT2F.js +368 -0
- package/dist/chunk-JMTULZ66.js +11743 -0
- package/dist/chunk-JXIQ7HCK.js +11166 -0
- package/dist/chunk-K6HVPBDP.js +10692 -0
- package/dist/chunk-KBT5Y666.js +521 -0
- package/dist/chunk-LETPROKG.js +11092 -0
- package/dist/chunk-LLMY2BZF.js +1084 -0
- package/dist/chunk-NMNL4US2.js +1084 -0
- package/dist/chunk-O2XRP7JK.js +10247 -0
- package/dist/chunk-OGPWLFFO.js +11201 -0
- package/dist/chunk-OQJUWTZV.js +51 -0
- package/dist/chunk-PJRWPLQ6.js +669 -0
- package/dist/chunk-PYRVUCJR.js +370 -0
- package/dist/chunk-Q6Y524KH.js +669 -0
- package/dist/chunk-QF7DM5VW.js +106 -0
- package/dist/chunk-QGM4M3NI.js +37 -0
- package/dist/chunk-QIIELFTL.js +1107 -0
- package/dist/chunk-QUW6N7GR.js +10264 -0
- package/dist/chunk-QZASNLQX.js +11223 -0
- package/dist/chunk-RMN4IAWO.js +11808 -0
- package/dist/chunk-RN5NHU37.js +11465 -0
- package/dist/chunk-RNG3RILO.js +11755 -0
- package/dist/chunk-RSA6DEB4.js +9748 -0
- package/dist/chunk-RURYWSMX.js +10524 -0
- package/dist/chunk-SUEXK5U7.js +11201 -0
- package/dist/chunk-TVUF55OH.js +11807 -0
- package/dist/chunk-U5MMENCP.js +456 -0
- package/dist/chunk-U62I2R2D.js +434 -0
- package/dist/chunk-UHFMFO54.js +21 -0
- package/dist/chunk-UNZBDSEU.js +11166 -0
- package/dist/chunk-UOATTNQP.js +334 -0
- package/dist/chunk-UZFYNSMJ.js +334 -0
- package/dist/chunk-VP37GLU6.js +1084 -0
- package/dist/chunk-W6WDKBWO.js +11453 -0
- package/dist/chunk-XBKUFNVF.js +10745 -0
- package/dist/chunk-XOLVQTIE.js +670 -0
- package/dist/chunk-XVFTBVDS.js +257 -0
- package/dist/chunk-YABA7DB6.js +11091 -0
- package/dist/chunk-YWCJX5KL.js +10557 -0
- package/dist/chunk-Z5GP7FSR.js +309 -0
- package/dist/chunk-ZBT3DATZ.js +296 -0
- package/dist/chunk-ZDBAZXUQ.js +11201 -0
- package/dist/chunk-ZEMABYS4.js +92 -0
- package/dist/chunk-ZOA4HT7P.js +662 -0
- package/dist/cli.cjs +40431 -0
- package/dist/cli.d.cts +2709 -0
- package/dist/cli.d.ts +2709 -0
- package/dist/cli.js +21149 -0
- package/dist/commandValidator-42OUDFZ4.js +140 -0
- package/dist/commandValidator-7LQHTYL5.js +140 -0
- package/dist/commandValidator-AT5OYZFC.js +142 -0
- package/dist/commandValidator-DH3CX2OW.js +140 -0
- package/dist/commandValidator-GCQC7H4A.js +140 -0
- package/dist/commandValidator-K6VWB6O3.js +140 -0
- package/dist/commandValidator-L6WNDBYB.js +129 -0
- package/dist/commandValidator-O3KSNXD2.js +140 -0
- package/dist/commandValidator-ZHMUA5RQ.js +140 -0
- package/dist/constraints-M52FVL2X.js +11 -0
- package/dist/dist-CSOR2BL2.js +1144 -0
- package/dist/dist-PKOIS5NZ.js +1144 -0
- package/dist/fileAnalysis-3VMDDJ6I.js +9 -0
- package/dist/fileAnalysis-4QLHUT44.js +9 -0
- package/dist/fileAnalysis-H6M2Z7ZC.js +9 -0
- package/dist/fileAnalysis-HMI7IL6S.js +9 -0
- package/dist/fileAnalysis-JHABOPUQ.js +9 -0
- package/dist/gateMapping-E5MGNJH5.js +17 -0
- package/dist/jsonEnvelope-R4SWKX2N.js +62 -0
- package/dist/mergeTreeSimulator-ATOPJ3DU.js +11 -0
- package/dist/mergeTreeSimulator-AYUK4TZT.js +11 -0
- package/dist/mergeTreeSimulator-BBWJUQBK.js +11 -0
- package/dist/mergeTreeSimulator-DJJDRB5N.js +11 -0
- package/dist/mergeTreeSimulator-X4BA647P.js +11 -0
- package/dist/planDiff-37QHCPKO.js +109 -0
- package/dist/planDiff-BQHIUARB.js +109 -0
- package/dist/planDiff-QOK6KNB7.js +111 -0
- package/dist/planDiff-RXR4CWFS.js +109 -0
- package/dist/planDiff-W2BTH2MU.js +109 -0
- package/dist/planHistory-4J3Q6AJ3.js +126 -0
- package/dist/planHistory-DQRSB2Y7.js +118 -0
- package/dist/planHistory-GLCXP6AB.js +126 -0
- package/dist/planHistory-SMNRLEKG.js +126 -0
- package/dist/planHistory-UO4WZ6GO.js +126 -0
- package/dist/planReview-7BWVLABC.js +377 -0
- package/dist/planReview-7VB3OYKZ.js +385 -0
- package/dist/planReview-FAIBIAE6.js +377 -0
- package/dist/planReview-FXQBDNKJ.js +376 -0
- package/dist/planReview-HO4YYETA.js +377 -0
- package/dist/planReview-I26EKCUK.js +376 -0
- package/dist/planReview-JBOAJHSU.js +377 -0
- package/dist/planReview-SCNZWC6B.js +376 -0
- package/dist/planReview-TU7LMZIY.js +376 -0
- package/dist/planViewer-2YZCPVDM.js +155 -0
- package/dist/planViewer-72WZFUTU.js +154 -0
- package/dist/planViewer-G546TVHV.js +154 -0
- package/dist/planViewer-I7ZHNJQF.js +150 -0
- package/dist/planViewer-IRXHOY5U.js +155 -0
- package/dist/planViewer-IX2ICW45.js +154 -0
- package/dist/planViewer-PDWPUOP6.js +155 -0
- package/dist/planViewer-PEOADAGZ.js +155 -0
- package/dist/planViewer-PFYDEG6V.js +150 -0
- package/dist/planViewer-UIPOSRVW.js +151 -0
- package/dist/planViewer-V2JUKV7Q.js +154 -0
- package/dist/sarif-46TKOOJZ.js +9 -0
- package/dist/sarif-63JKTFFI.js +9 -0
- package/dist/sarif-CIYIWUNC.js +9 -0
- package/dist/sarif-OGAGDL6B.js +9 -0
- package/dist/sarif-XIREI5B5.js +9 -0
- package/dist/security-3V6FKJDA.js +423 -0
- package/dist/security-4JMEUM56.js +423 -0
- package/dist/security-QHPEWY5G.js +423 -0
- package/dist/security-V2LAL5TP.js +415 -0
- package/dist/security-WTASK6T6.js +423 -0
- package/dist/security-XE4GHVJD.js +423 -0
- package/dist/security-XLXM3UHT.js +423 -0
- package/dist/security-YDLHSMVY.js +441 -0
- package/dist/security-ZDAEZF7D.js +423 -0
- package/dist/signing-3EI734L4.js +14 -0
- package/dist/signing-5G7K6JXJ.js +14 -0
- package/dist/signing-7DK7SABM.js +14 -0
- package/dist/signing-JJJOUGCW.js +14 -0
- package/dist/signing-OAJ3MXGA.js +14 -0
- package/dist/verify-5F6PUXUQ.js +62 -0
- package/dist/verify-5ILURHV2.js +62 -0
- package/dist/verify-MRDZJUGO.js +62 -0
- package/dist/verify-SCUHB3SA.js +62 -0
- package/dist/verify-YZRHN2D3.js +62 -0
- package/docs/1.0.0-vertical-slice.md +214 -0
- package/docs/ADR-007-INTEGRATION-SUMMARY.md +232 -0
- package/docs/ALIASING_FOR_LEXRUNNER.md +709 -0
- package/docs/ALIASING_FOR_RUNNER.md +552 -0
- package/docs/AX.md +317 -0
- package/docs/CHECKPOINT_RESUME.md +208 -0
- package/docs/CLI_VERBS.md +219 -0
- package/docs/CONFLICT_DETECTION.md +198 -0
- package/docs/DISCIPLINED_FAILURE.md +224 -0
- package/docs/ENVIRONMENT_QUALITY.md +155 -0
- package/docs/ERROR_CODES.md +528 -0
- package/docs/EVENT_SCHEMA.md +659 -0
- package/docs/EXE-012-investigation-summary.md +300 -0
- package/docs/GATE_ATTESTATION_GUIDE.md +237 -0
- package/docs/JSON_OUTPUT_SCHEMAS.md +347 -0
- package/docs/LEXRUNNER_ALIASING.md +444 -0
- package/docs/LEX_INTEGRATION.md +83 -0
- package/docs/LEX_PUBLIC_API.md +306 -0
- package/docs/LICENSING.md +119 -0
- package/docs/MCP-CLI-PARITY.md +410 -0
- package/docs/MCP-MIGRATION.md +258 -0
- package/docs/MCP-PARITY.md +234 -0
- package/docs/MEMORY_TOOLS.md +278 -0
- package/docs/MERGE_WEAVE_SETUP.md +643 -0
- package/docs/MIGRATION_v0.1.md +760 -0
- package/docs/NAMING_CONVENTIONS.md +82 -0
- package/docs/PERSONA_FOUNDATION.md +124 -0
- package/docs/PHASE3_MEMORY_GUIDE.md +122 -0
- package/docs/PLAN_LOCK.md +114 -0
- package/docs/README.md +289 -0
- package/docs/RUNNER_LIFECYCLE.md +257 -0
- package/docs/SAFETY_MECHANISMS.md +325 -0
- package/docs/SECURITY_IMPLEMENTATION.md +535 -0
- package/docs/TERMS.md +34 -0
- package/docs/TOKEN_TRACKING.md +162 -0
- package/docs/WORKFLOW_GUIDANCE.md +277 -0
- package/docs/adr/ADR-000-product-naming-and-branding.md +115 -0
- package/docs/adr/ADR-001-plan-json-frozen-input.md +68 -0
- package/docs/adr/ADR-002-two-track-separation.md +84 -0
- package/docs/adr/ADR-003-gate-uniform-execution.md +69 -0
- package/docs/adr/ADR-004-runner-state-model.md +75 -0
- package/docs/adr/ADR-005-merge-pyramid-ordering.md +87 -0
- package/docs/adr/ADR-006-schema-versioning-semver.md +81 -0
- package/docs/adr/ADR-007-task-snapshot-contract.md +503 -0
- package/docs/adr/ADR-008-lex-packaging.md +243 -0
- package/docs/adr/ADR-009-ax-test-output-adapters.md +440 -0
- package/docs/adr/README.md +32 -0
- package/docs/advanced-cli.md +436 -0
- package/docs/agent-stall-detection.md +278 -0
- package/docs/architecture/executors.md +190 -0
- package/docs/architecture.md +316 -0
- package/docs/attestation/AX-SHARED-PLEDGE.md +83 -0
- package/docs/attestation/AX-SHARED-PLEDGE_v1.0.0.md +99 -0
- package/docs/attestation/AX-SHARED-PLEDGE_v1.0.0_VERIFICATION.md +115 -0
- package/docs/attestation/Lex_Guff_Version_Contract_Pact_v1.0.0.md +181 -0
- package/docs/attestation/README.md +87 -0
- package/docs/attestation/ax_pledge_2025-12-02.ots +0 -0
- package/docs/attestation/ax_pledge_timestamp_response.tsr +0 -0
- package/docs/attestation/copilot_summarization_2025-12-01.ots +0 -0
- package/docs/attestation/copilot_summarization_2025-12-01_VERIFICATION.md +100 -0
- package/docs/attestation/copilot_summarization_behavior_observation_2025-12-01.md +85 -0
- package/docs/attestation/copilot_summarization_screenshot_2025-12-01.png +0 -0
- package/docs/attestation/employment_separation_2025-11-26.ots +0 -0
- package/docs/attestation/employment_timestamp_response.tsr +0 -0
- package/docs/attestation/freetsa_cacert.pem +45 -0
- package/docs/attestation/freetsa_tsa.crt +45 -0
- package/docs/attestation/lex_employment_separation_2025-11-26.md +85 -0
- package/docs/attestation/lex_employment_separation_2025-11-26_VERIFICATION.md +126 -0
- package/docs/attestation/patent/2025-12-07-shadow-governance-pct-draft.md +350 -0
- package/docs/attestation/patent/2025-12-07-shadow-governance-pct-draft.md.ots +0 -0
- package/docs/attestation/patent/2025-12-07-shadow-governance-pct-draft_VERIFICATION.md +130 -0
- package/docs/attestation/patent/README.md +75 -0
- package/docs/attestation/patent/fig1_write_path.svg +58 -0
- package/docs/attestation/patent/fig2_read_normalize_rollup.svg +92 -0
- package/docs/attestation/timestamp_response.tsr +0 -0
- package/docs/attribution-README.md +264 -0
- package/docs/audit-compliance.md +283 -0
- package/docs/audit-outputs.md +1213 -0
- package/docs/audit-sdk.md +1134 -0
- package/docs/autopilot-levels.md +368 -0
- package/docs/autopilot.md +288 -0
- package/docs/ci-cd-integration.md +580 -0
- package/docs/ci-integration-guide.md +369 -0
- package/docs/ci-version-validation.md +198 -0
- package/docs/cli-mcp-weave-reporting.md +462 -0
- package/docs/cli.md +2262 -0
- package/docs/cluster-gates-rollback.md +222 -0
- package/docs/command-creation-guide.md +485 -0
- package/docs/command-whitelist.md +490 -0
- package/docs/commands/idea.md +253 -0
- package/docs/config.md +245 -0
- package/docs/conflict-clustering.md +225 -0
- package/docs/conflict-predictor.md +359 -0
- package/docs/context-diet.md +249 -0
- package/docs/counter-examples.md +199 -0
- package/docs/create-project.md +211 -0
- package/docs/deliverables-generator.md +299 -0
- package/docs/deliverables-management.md +474 -0
- package/docs/dependency-parser.md +354 -0
- package/docs/determinism.md +299 -0
- package/docs/diffgraph-planner.md +1211 -0
- package/docs/dogfood/README.md +33 -0
- package/docs/dogfood/wave-3-results.md +303 -0
- package/docs/dogfood-merge-weave-script.md +224 -0
- package/docs/enterprise-onboarding.md +291 -0
- package/docs/environment-variables.md +625 -0
- package/docs/error-recovery.md +466 -0
- package/docs/errors.md +288 -0
- package/docs/executor-authoring.md +854 -0
- package/docs/executor-decoupling.md +410 -0
- package/docs/front-end-capture-pipeline.md +312 -0
- package/docs/gate-report-examples.md +380 -0
- package/docs/gates.md +319 -0
- package/docs/github-automation.md +128 -0
- package/docs/governance-metrics.md +368 -0
- package/docs/integrations/README.md +588 -0
- package/docs/interactive-plan-review.md +493 -0
- package/docs/issue-orchestration.md +256 -0
- package/docs/lex_ax_session_key_rememberings_v0.1.md +195 -0
- package/docs/lexrunner-v1-summary.md +246 -0
- package/docs/lexrunner-v2-contract.md +404 -0
- package/docs/lexrunner-v2-migration-plan.md +388 -0
- package/docs/lexrunner-v2-salvage-map.md +355 -0
- package/docs/lexsona-rules.md +154 -0
- package/docs/merge-weave-analysis.md +403 -0
- package/docs/merge-weave-quickstart.md +770 -0
- package/docs/merge-weave-state-machine.md +390 -0
- package/docs/migration-guide.md +529 -0
- package/docs/monitoring-examples.md +470 -0
- package/docs/monitoring-implementation.md +252 -0
- package/docs/orchestration.md +234 -0
- package/docs/performance-scale.md +359 -0
- package/docs/plan-generation.md +407 -0
- package/docs/profile-resolution.md +455 -0
- package/docs/prompts.md +427 -0
- package/docs/quickstart.md +546 -0
- package/docs/release-process.md +310 -0
- package/docs/sample-prompts/merge-weave/cli-merge-weave-kickoff.md +274 -0
- package/docs/sample-prompts/merge-weave/mcp-merge-weave-kickoff.md +480 -0
- package/docs/sample-prompts/merge-weave/standalone-merge-weave-kickoff.md +237 -0
- package/docs/schemas.md +359 -0
- package/docs/scope-validation.md +444 -0
- package/docs/security/rotation-guide.md +325 -0
- package/docs/specs/Meeting_Control_Stack_Concept_v0.1.0.md +417 -0
- package/docs/specs/git-feature-flag-redesign.md +321 -0
- package/docs/specs/lex-pr-brief-behavior.md +269 -0
- package/docs/specs/smartergpt-structure-v1.md +705 -0
- package/docs/specs/task-brief-v0.1.md +224 -0
- package/docs/store-architecture.md +61 -0
- package/docs/templates/CONTRIBUTING-merge-weave-section.md +33 -0
- package/docs/templates/gates.example.yml +109 -0
- package/docs/templates/plan.example.json +77 -0
- package/docs/thesis/00-EVOLUTION-NOTES.md +383 -0
- package/docs/thesis/01-CORE-THESIS.md +285 -0
- package/docs/thesis/02-TURN-COST.md +498 -0
- package/docs/thesis/03-PERMISSION-TO-FAIL.md +581 -0
- package/docs/thesis/04-CROSS-MODEL-CONTINUITY.md +517 -0
- package/docs/thesis/05-RULE-FILE-SPEC.md +732 -0
- package/docs/thesis/06-CAPABILITY-TIERS.md +723 -0
- package/docs/thesis/07-ROBERT-FIELD-REPORT.md +433 -0
- package/docs/thesis/08-IMPLEMENTATION-GUIDE.md +1093 -0
- package/docs/thesis/09-METRICS-AND-TELEMETRY.md +793 -0
- package/docs/thesis/10-FAILURE-MODES.md +716 -0
- package/docs/thesis/README.md +151 -0
- package/docs/thesis/lex_governance-collab_systems_paper_draft.md +952 -0
- package/docs/thesis/lex_governance-collab_systems_paper_draft.pdf +0 -0
- package/docs/tool-grounded/READINESS_ANALYSIS.md +527 -0
- package/docs/tool-grounded/enforcement.md +361 -0
- package/docs/tool-grounded/tool-grounded-a-view-from-the-inside.md +437 -0
- package/docs/tool-grounded/tool-grounded-prompt.md +122 -0
- package/docs/tool-grounded/tool-grounded-run-centric.md +474 -0
- package/docs/troubleshooting-planner.md +910 -0
- package/docs/troubleshooting.md +745 -0
- package/docs/tutorials/README.md +201 -0
- package/docs/tutorials/diffgraph-planner/01-simple-stack.md +460 -0
- package/docs/tutorials/diffgraph-planner/02-diamond-pattern.md +431 -0
- package/docs/tutorials/diffgraph-planner/03-large-batch.md +525 -0
- package/docs/tutorials/diffgraph-planner/04-fixing-cycles.md +526 -0
- package/docs/tutorials/diffgraph-planner/05-hybrid-workflow.md +555 -0
- package/docs/tutorials/quick-merge-pyramid.md +364 -0
- package/docs/tutorials/video-scripts/01-getting-started.md +286 -0
- package/docs/tutorials/video-scripts/02-understanding-dependencies.md +376 -0
- package/docs/weave-contract.md +116 -0
- package/docs/weave-execution-log.md +153 -0
- package/docs/workflows/README.md +139 -0
- package/docs/workflows/enterprise.md +545 -0
- package/docs/workflows/small-team.md +398 -0
- package/docs/workflows/solo-developer.md +419 -0
- package/dogfood-merge-weave.sh +122 -0
- package/examples/README.md +22 -0
- package/examples/WORKING_EXAMPLE.md +309 -0
- package/examples/analyze-pr-files.js +100 -0
- package/examples/autopilot-level4-example.md +234 -0
- package/examples/cluster-gates-demo.sh +178 -0
- package/examples/complete-security-workflow.ts +248 -0
- package/examples/error-recovery/README.md +202 -0
- package/examples/executor-manifest.example.yaml +81 -0
- package/examples/front-end-capture-pipeline/README.md +99 -0
- package/examples/front-end-capture-pipeline/create-project-example.sh +83 -0
- package/examples/front-end-capture-pipeline/idea-dark-mode.json +14 -0
- package/examples/front-end-capture-pipeline/idea-example.sh +57 -0
- package/examples/front-end-capture-pipeline/manual-test-checklist.md +426 -0
- package/examples/gates/README.md +165 -0
- package/examples/gates/lint-gate.sh +40 -0
- package/examples/gates/lint-gate.ts +99 -0
- package/examples/gates/test-runner.ts +113 -0
- package/examples/gates/vuln-scanner.ts +95 -0
- package/examples/github-integration/README.md +111 -0
- package/examples/github-integration/example-plan.json +95 -0
- package/examples/performance-config.md +388 -0
- package/examples/profile-setup/.gitignore.template +66 -0
- package/examples/profile-setup/.smartergpt-example/README.md +190 -0
- package/examples/profile-setup/.smartergpt.local-example/README.md +365 -0
- package/examples/profile-setup/README.md +492 -0
- package/examples/profile-setup/cross-repo-prompts/README.md +606 -0
- package/examples/safety-framework-demo.ts +130 -0
- package/examples/safety-mechanisms-example.ts +191 -0
- package/examples/sample-plan.json +87 -0
- package/examples/sample-stack.yml +66 -0
- package/examples/sarif/README.md +224 -0
- package/examples/scope-validation-demo.ts +199 -0
- package/examples/security-integration.ts +293 -0
- package/examples/token-tracking-example.ts +71 -0
- package/executors/senior-dev/ARCHITECTURE.md +182 -0
- package/executors/senior-dev/MEMORY_INTEGRATION.md +236 -0
- package/executors/senior-dev/QUICK_START.md +145 -0
- package/executors/senior-dev/README.md +76 -0
- package/executors/senior-dev/examples/sample-review-session.md +228 -0
- package/executors/senior-dev/executor-manifest.yaml +79 -0
- package/executors/senior-dev/prompts/code-review.prompt.md +78 -0
- package/executors/senior-dev/prompts/mentorship-feedback.prompt.md +97 -0
- package/executors/senior-dev/prompts/pattern-recognition.prompt.md +80 -0
- package/executors/senior-dev/prompts/pr-analysis.prompt.md +75 -0
- package/executors/senior-dev/scripts/capture-review-frame.sh +129 -0
- package/executors/senior-dev/scripts/prepare-review-context.sh +61 -0
- package/executors/senior-dev/scripts/recall-context.sh +87 -0
- package/lexrunner-launcher.sh +12 -0
- package/mcp-config-example.json +14 -0
- package/mcp-server.mjs +1221 -0
- package/merge-weave-current-prs.md +170 -0
- package/merge-weave-dogfood.json +46 -0
- package/merge-weave-plan.json +56 -0
- package/package.json +140 -0
- package/procedures/merge-weave-main.yaml +90 -0
- package/procedures/pr-review.yaml +68 -0
- package/project/README.md +50 -0
- package/prompts/tool-grounded-mode.md +185 -0
- package/schemas/allowed-commands.schema.json +108 -0
- package/schemas/audit-events.schema.json +138 -0
- package/schemas/audit-events.v1.0.0.schema.json +138 -0
- package/schemas/edit-plan.schema.json +80 -0
- package/schemas/executor-manifest.schema.json +236 -0
- package/schemas/flake-report.schema.json +95 -0
- package/schemas/gate-report.schema.json +85 -0
- package/schemas/gates/build.schema.json +32 -0
- package/schemas/gates/coverage.schema.json +42 -0
- package/schemas/gates/lint.schema.json +34 -0
- package/schemas/gates/security-scan.schema.json +33 -0
- package/schemas/gates/test.schema.json +35 -0
- package/schemas/next-option.schema.json +60 -0
- package/schemas/persona-snapshot.schema.json +66 -0
- package/schemas/plan.schema.json +300 -0
- package/schemas/status-response.schema.json +193 -0
- package/scripts/README.md +354 -0
- package/scripts/analyze-governance-logs.mjs +51 -0
- package/scripts/benchmark-ci.ts +339 -0
- package/scripts/check-determinism.sh +23 -0
- package/scripts/check-license-compliance.mjs +319 -0
- package/scripts/check-release-drift.mjs +81 -0
- package/scripts/ci-debug.sh +24 -0
- package/scripts/ci-smoke.mjs +304 -0
- package/scripts/create-sample-repo.sh +245 -0
- package/scripts/dogfood-merge-weave.sh +552 -0
- package/scripts/gen_mcp_servers.py +252 -0
- package/scripts/generate-executor-manifest-schema.ts +30 -0
- package/scripts/generate-flake-schema.ts +32 -0
- package/scripts/generate-gate-schema.ts +32 -0
- package/scripts/generate-plan-schema.ts +30 -0
- package/scripts/generate-run-schemas.ts +69 -0
- package/scripts/load-prompt.mjs +147 -0
- package/scripts/merge-weave-wrapper.sh +445 -0
- package/scripts/merge-weave.sh +489 -0
- package/scripts/metrics-template.ts +134 -0
- package/scripts/package-lex.sh +267 -0
- package/scripts/quick-start-merge-weave.sh +218 -0
- package/scripts/release-prepare.ts +350 -0
- package/scripts/rotate-secrets-example.ts +134 -0
- package/scripts/test-lexsona-shadow.mjs +100 -0
- package/scripts/validate-manifests.ts +188 -0
- package/scripts/verify-audit-phase2.js +175 -0
- package/src/ai/README.md +456 -0
- package/src/ai/conflictStrategy.ts +223 -0
- package/src/ai/conflictStrategyCache.ts +164 -0
- package/src/ai/conflictStrategyPrompt.ts +128 -0
- package/src/ai/conflictStrategySchema.ts +165 -0
- package/src/ai/heuristicFallback.ts +162 -0
- package/src/ai/index.ts +64 -0
- package/src/ai/riskScoring.ts +174 -0
- package/src/aliases/index.ts +16 -0
- package/src/aliases/resolver.ts +212 -0
- package/src/audit/context.ts +284 -0
- package/src/audit/emitter.ts +685 -0
- package/src/audit/events.ts +210 -0
- package/src/audit/gateMatrix.ts +158 -0
- package/src/audit/index.ts +44 -0
- package/src/audit/manifest.ts +78 -0
- package/src/audit/profiles.ts +93 -0
- package/src/audit/redaction.ts +216 -0
- package/src/audit/sarif.ts +213 -0
- package/src/audit/schema/events.ts +366 -0
- package/src/audit/schema/manifest.ts +47 -0
- package/src/audit/schema.ts +159 -0
- package/src/audit/sdk/index.ts +145 -0
- package/src/audit/sdk/types.ts +88 -0
- package/src/audit/sidecar.ts +111 -0
- package/src/audit/signing.ts +521 -0
- package/src/autopilot/README.md +113 -0
- package/src/autopilot/artifacts.ts +287 -0
- package/src/autopilot/base.ts +132 -0
- package/src/autopilot/deliverables.ts +392 -0
- package/src/autopilot/index.ts +29 -0
- package/src/autopilot/level1.ts +187 -0
- package/src/autopilot/level2.ts +262 -0
- package/src/autopilot/level3.ts +263 -0
- package/src/autopilot/level4.ts +393 -0
- package/src/autopilot/safety/README.md +512 -0
- package/src/autopilot/safety/SafetyFramework.ts +634 -0
- package/src/autopilot/safety/index.ts +16 -0
- package/src/autopilot/types.ts +250 -0
- package/src/budget/index.ts +56 -0
- package/src/budget/manager.ts +547 -0
- package/src/budget/schema.ts +305 -0
- package/src/budget/tracker.ts +155 -0
- package/src/cache/issue-cache.ts +150 -0
- package/src/cli/command-map.ts +221 -0
- package/src/cli/commands/gate/test.ts +214 -0
- package/src/cli/exitHandler.ts +98 -0
- package/src/cli/flags.ts +123 -0
- package/src/cli/formatSuggestions.ts +202 -0
- package/src/cli/formatters.ts +294 -0
- package/src/cli/jsonEnvelope.ts +152 -0
- package/src/cli/output.ts +61 -0
- package/src/cli/runnerLifecycle.ts +118 -0
- package/src/cli-audit.ts +76 -0
- package/src/cli-security.ts +114 -0
- package/src/cli.ts +1231 -0
- package/src/commands/audit/index.ts +5 -0
- package/src/commands/audit/verify.ts +87 -0
- package/src/commands/autopilot.ts +131 -0
- package/src/commands/budget.ts +327 -0
- package/src/commands/bulkOps.ts +204 -0
- package/src/commands/completion.ts +287 -0
- package/src/commands/config/validate.ts +428 -0
- package/src/commands/config.ts +368 -0
- package/src/commands/counterExamples.ts +104 -0
- package/src/commands/create-project.ts +338 -0
- package/src/commands/discover.ts +192 -0
- package/src/commands/doctor.ts +436 -0
- package/src/commands/execute.ts +558 -0
- package/src/commands/explain.ts +157 -0
- package/src/commands/fanout-analyze.ts +684 -0
- package/src/commands/fanout-harvest.ts +328 -0
- package/src/commands/fanout-monitor.ts +224 -0
- package/src/commands/gateAttest.ts +95 -0
- package/src/commands/gateImport.ts +142 -0
- package/src/commands/gateImportChecks.ts +208 -0
- package/src/commands/gateReport.ts +184 -0
- package/src/commands/governanceCleanup.ts +171 -0
- package/src/commands/governanceReport.ts +497 -0
- package/src/commands/guards.ts +50 -0
- package/src/commands/idea.ts +281 -0
- package/src/commands/init.ts +414 -0
- package/src/commands/issues.ts +165 -0
- package/src/commands/merge.ts +677 -0
- package/src/commands/mergeOrder.ts +68 -0
- package/src/commands/metrics.ts +232 -0
- package/src/commands/migrateProfile.ts +187 -0
- package/src/commands/orchestrate/analyze-issues.ts +203 -0
- package/src/commands/orchestrate/assign-batch.ts +204 -0
- package/src/commands/orchestrate/generate-deliverables.ts +66 -0
- package/src/commands/orchestrate/pinToolchain.ts +102 -0
- package/src/commands/orchestrate/plan-batch.ts +119 -0
- package/src/commands/orchestrate/predict-conflicts.ts +210 -0
- package/src/commands/orchestrate.ts +186 -0
- package/src/commands/plan.ts +403 -0
- package/src/commands/planDiff.ts +56 -0
- package/src/commands/planReview.ts +112 -0
- package/src/commands/planViewer.ts +180 -0
- package/src/commands/preview-constraints.ts +97 -0
- package/src/commands/query.ts +313 -0
- package/src/commands/report.ts +56 -0
- package/src/commands/retry.ts +60 -0
- package/src/commands/schema.ts +128 -0
- package/src/commands/security.ts +140 -0
- package/src/commands/seniorDev.ts +326 -0
- package/src/commands/status.ts +97 -0
- package/src/commands/tokenReport.ts +167 -0
- package/src/commands/validation.ts +66 -0
- package/src/commands/weave-checkpoints.ts +145 -0
- package/src/commands/weave-fanout.ts +273 -0
- package/src/commands/weave-policy.ts +277 -0
- package/src/commands/weave.ts +518 -0
- package/src/config/localOverlay.ts +167 -0
- package/src/config/pathResolver.ts +106 -0
- package/src/config/profileResolver.ts +194 -0
- package/src/config/promptsResolver.ts +312 -0
- package/src/config/rulesResolver.ts +257 -0
- package/src/config/schemas.ts +142 -0
- package/src/core/bootstrap.ts +287 -0
- package/src/core/enterprise.ts +453 -0
- package/src/core/errorRecovery.ts +509 -0
- package/src/core/githubPlan.ts +282 -0
- package/src/core/inputs.ts +314 -0
- package/src/core/multiRepoPlan.ts +353 -0
- package/src/core/plan.ts +106 -0
- package/src/core/snapshot.ts +189 -0
- package/src/errors/adapters.ts +897 -0
- package/src/errors/index.ts +231 -0
- package/src/executionState.ts +356 -0
- package/src/executors/README_FRAME_CONTRACT.md +446 -0
- package/src/executors/frameContract.ts +270 -0
- package/src/executors/guardrailEnforcement.ts +294 -0
- package/src/executors/seniorDev/core.ts +548 -0
- package/src/executors/seniorDev/index.ts +30 -0
- package/src/executors/seniorDev/types.ts +176 -0
- package/src/executors/toolBudget.ts +194 -0
- package/src/fanout/analyzer.ts +735 -0
- package/src/fanout/github-adapter.ts +262 -0
- package/src/fanout/harvest.ts +517 -0
- package/src/fanout/monitor.ts +350 -0
- package/src/fanout/types.ts +428 -0
- package/src/frames/controller.ts +160 -0
- package/src/frames/emitter.ts +455 -0
- package/src/frames/index.ts +58 -0
- package/src/frames/storage.ts +203 -0
- package/src/frames/types.ts +258 -0
- package/src/gates/checkRunConverter.ts +91 -0
- package/src/gates/test/adapters/errors.ts +32 -0
- package/src/gates/test/adapters/index.ts +36 -0
- package/src/gates/test/adapters/interface.ts +63 -0
- package/src/gates/test/adapters/jest-json.ts +370 -0
- package/src/gates/test/adapters/junit-xml.ts +400 -0
- package/src/gates/test/adapters/registry.ts +149 -0
- package/src/gates/test/adapters/vitest-json.ts +339 -0
- package/src/gates/test/enrichment/failureId.ts +74 -0
- package/src/gates/test/enrichment/index.ts +25 -0
- package/src/gates/test/enrichment/nextActions.ts +322 -0
- package/src/gates/test/enrichment/rerunTemplates.ts +105 -0
- package/src/gates/test/enrichment/signature.ts +58 -0
- package/src/gates/test/enrichment/stackParser.ts +149 -0
- package/src/gates/test/enrichment/types.ts +67 -0
- package/src/gates/test/formatters/markdown.spec.ts +942 -0
- package/src/gates/test/formatters/markdown.ts +296 -0
- package/src/gates/test/index.ts +54 -0
- package/src/gates/test/schema.spec.ts +372 -0
- package/src/gates/test/schema.ts +327 -0
- package/src/gates/validator.ts +92 -0
- package/src/gates.ts +1022 -0
- package/src/git/operations.ts +592 -0
- package/src/git/parseRemote.ts +22 -0
- package/src/github/api.ts +584 -0
- package/src/github/batch-ops.ts +215 -0
- package/src/github/client.ts +647 -0
- package/src/github/contextDiet.ts +205 -0
- package/src/github/diffHunks.ts +285 -0
- package/src/github/index.ts +11 -0
- package/src/github/minimalContext.ts +212 -0
- package/src/github/minimalContextClient.ts +105 -0
- package/src/github/symbolMap.ts +370 -0
- package/src/github/types.ts +166 -0
- package/src/governance/index.ts +42 -0
- package/src/governance/mcpStatus.ts +258 -0
- package/src/governance/timeoutAdjustment.ts +149 -0
- package/src/governance/turnCostSummary.ts +182 -0
- package/src/hooks/events.ts +374 -0
- package/src/hooks/index.ts +8 -0
- package/src/hostility/checks.ts +408 -0
- package/src/hostility/index.ts +108 -0
- package/src/hostility/score.ts +143 -0
- package/src/interactive/planDiff.ts +168 -0
- package/src/interactive/planHistory.ts +205 -0
- package/src/interactive/planReview.ts +531 -0
- package/src/learning/counter-example.ts +174 -0
- package/src/learning/prompts.ts +107 -0
- package/src/learning/storage.ts +230 -0
- package/src/lexsona/client.ts +367 -0
- package/src/lexsona/index.ts +44 -0
- package/src/lexsona/logger.ts +408 -0
- package/src/lexsona/types.ts +177 -0
- package/src/mcp/DEPRECATED.md +33 -0
- package/src/mcp/server.ts +3587 -0
- package/src/mcp/types/guided-response.ts +95 -0
- package/src/mcp/types.ts +468 -0
- package/src/mcp/workflow/state-machine.ts +277 -0
- package/src/mergeEligibility.ts +355 -0
- package/src/mergeOrder.ts +170 -0
- package/src/metrics/export.ts +472 -0
- package/src/metrics/index.ts +35 -0
- package/src/metrics/turncost.ts +284 -0
- package/src/monitoring/README.md +222 -0
- package/src/monitoring/audit.ts +98 -0
- package/src/monitoring/cache.ts +121 -0
- package/src/monitoring/dashboards/grafana-dashboard.json +172 -0
- package/src/monitoring/errorRecovery.ts +334 -0
- package/src/monitoring/errors.ts +105 -0
- package/src/monitoring/fileLogger.ts +194 -0
- package/src/monitoring/hallucinations.ts +45 -0
- package/src/monitoring/health.ts +171 -0
- package/src/monitoring/index.ts +16 -0
- package/src/monitoring/lock.ts +158 -0
- package/src/monitoring/logger.ts +178 -0
- package/src/monitoring/metrics.ts +245 -0
- package/src/monitoring/profiler.ts +156 -0
- package/src/monitoring/tokenLogger.ts +141 -0
- package/src/orchestrate/analyzer.ts +461 -0
- package/src/orchestrate/index.ts +6 -0
- package/src/orchestrate/types.ts +65 -0
- package/src/orchestration/README.md +480 -0
- package/src/orchestration/agentAssigner.ts +206 -0
- package/src/orchestration/batchPlanner.ts +201 -0
- package/src/orchestration/conflictClustering.ts +344 -0
- package/src/orchestration/conflictGraph.ts +63 -0
- package/src/orchestration/conflictPredictor.ts +170 -0
- package/src/orchestration/deliverablesGenerator.ts +345 -0
- package/src/orchestration/determinism.ts +232 -0
- package/src/orchestration/index.ts +45 -0
- package/src/orchestration/mergeTreeSimulator.ts +137 -0
- package/src/orchestration/mis.ts +123 -0
- package/src/orchestration/toolchainManifest.ts +169 -0
- package/src/orchestration/types.ts +103 -0
- package/src/performance.README.md +99 -0
- package/src/performance.ts +279 -0
- package/src/planner/README.md +215 -0
- package/src/planner/dependencyParser.ts +404 -0
- package/src/planner/dependencyScoring.ts +346 -0
- package/src/planner/fileAnalysis.ts +693 -0
- package/src/planner/index.ts +41 -0
- package/src/planner/scopeValidator.ts +308 -0
- package/src/planner/types.ts +80 -0
- package/src/planner/validation.ts +493 -0
- package/src/preview/constraints.ts +333 -0
- package/src/procedures/index.ts +47 -0
- package/src/procedures/loader.ts +252 -0
- package/src/procedures/schema.ts +191 -0
- package/src/procedures/stateMachine.ts +160 -0
- package/src/procedures/types.ts +178 -0
- package/src/receipts/emit.ts +354 -0
- package/src/receipts/index.ts +48 -0
- package/src/receipts/schema.ts +227 -0
- package/src/report/aggregate.ts +160 -0
- package/src/runs/artifacts.ts +315 -0
- package/src/runs/attribution.ts +132 -0
- package/src/runs/context.ts +54 -0
- package/src/runs/decisions.ts +407 -0
- package/src/runs/enforcement.ts +395 -0
- package/src/runs/failures.ts +517 -0
- package/src/runs/index.ts +141 -0
- package/src/runs/manager.ts +910 -0
- package/src/runs/statusBuilder.ts +233 -0
- package/src/runs/storage.ts +290 -0
- package/src/runs/types.ts +216 -0
- package/src/schema/flakeReport.ts +74 -0
- package/src/schema/gateMapping.ts +107 -0
- package/src/schema/gateReport.ts +236 -0
- package/src/schema/weaveLock.ts +51 -0
- package/src/schema.ts +313 -0
- package/src/schemas/executorManifest.ts +204 -0
- package/src/schemas/feature-spec-v0.ts +40 -0
- package/src/schemas/persona.ts +162 -0
- package/src/schemas/project.ts +91 -0
- package/src/schemas/runCentric.ts +402 -0
- package/src/schemas/task-contract.ts +626 -0
- package/src/schemas/vacuumReadyPrompt.ts +128 -0
- package/src/sdk/index.ts +113 -0
- package/src/sdk/parser.ts +101 -0
- package/src/sdk/query.ts +315 -0
- package/src/sdk/validator.ts +114 -0
- package/src/security/README.md +496 -0
- package/src/security/authentication.ts +173 -0
- package/src/security/authorization.ts +348 -0
- package/src/security/commandValidator.ts +195 -0
- package/src/security/compliance.ts +688 -0
- package/src/security/index.ts +85 -0
- package/src/security/policy.ts +399 -0
- package/src/security/sarif.ts +179 -0
- package/src/security/scanning.ts +362 -0
- package/src/security/secrets.ts +520 -0
- package/src/shared/git/index.ts +30 -0
- package/src/shared/git/runGit.ts +281 -0
- package/src/shared/git/runtime.ts +66 -0
- package/src/snapshot/builder.ts +229 -0
- package/src/snapshot/index.ts +8 -0
- package/src/store/CONTRACT.md +189 -0
- package/src/store/README.md +22 -0
- package/src/store/index.ts +99 -0
- package/src/store/inmemory/index.ts +10 -0
- package/src/store/inmemory/run-store.ts +268 -0
- package/src/store/postgres/.gitkeep +0 -0
- package/src/store/run-store.ts +405 -0
- package/src/store/sqlite/index.ts +7 -0
- package/src/store/sqlite/run-store.ts +525 -0
- package/src/store/sqlite/schema.sql +67 -0
- package/src/telemetry/frames.ts +179 -0
- package/src/telemetry/index.ts +5 -0
- package/src/tiers/index.ts +34 -0
- package/src/tiers/metrics.ts +156 -0
- package/src/tiers/schema.ts +95 -0
- package/src/tiers/suggest.ts +183 -0
- package/src/types/guardrails.ts +452 -0
- package/src/types/index.ts +42 -0
- package/src/util/canonicalJson.ts +29 -0
- package/src/util/colorControl.ts +46 -0
- package/src/util/envUtils.ts +139 -0
- package/src/util/hash.ts +69 -0
- package/src/util/lockHash.ts +90 -0
- package/src/util/minHeap.ts +108 -0
- package/src/util/progress.ts +89 -0
- package/src/util/tokenEstimator.ts +55 -0
- package/src/utils/fingerprint.ts +105 -0
- package/src/utils/paths.ts +209 -0
- package/src/utils/tokens.ts +151 -0
- package/src/utils/validation.ts +53 -0
- package/src/verification/diff-applier.ts +60 -0
- package/src/verification/engine-verifier.ts +171 -0
- package/src/verification/errors.ts +30 -0
- package/src/verification/index.ts +13 -0
- package/src/weave/audit/index.ts +17 -0
- package/src/weave/audit/logger.ts +206 -0
- package/src/weave/authority/evaluator.ts +660 -0
- package/src/weave/authority/index.ts +30 -0
- package/src/weave/authority/schema.ts +292 -0
- package/src/weave/checkpoint/index.ts +7 -0
- package/src/weave/checkpoint/storage.ts +223 -0
- package/src/weave/checkpoint/types.ts +121 -0
- package/src/weave/checkpoint/utils.ts +207 -0
- package/src/weave/clusterGates.ts +366 -0
- package/src/weave/draftPR.ts +214 -0
- package/src/weave/executor/d1-executor.ts +822 -0
- package/src/weave/executor/d2-executor.ts +381 -0
- package/src/weave/executor/index.ts +24 -0
- package/src/weave/executor/types.ts +135 -0
- package/src/weave/fanout/generator.ts +186 -0
- package/src/weave/fanout/index.ts +51 -0
- package/src/weave/fanout/loader.ts +134 -0
- package/src/weave/fanout/matcher.ts +239 -0
- package/src/weave/fanout/schema.ts +178 -0
- package/src/weave/frameHelper.ts +126 -0
- package/src/weave/gateFailureHandler.ts +405 -0
- package/src/weave/index.ts +89 -0
- package/src/weave/lockFile.ts +193 -0
- package/src/weave/mergeHelpers.ts +377 -0
- package/src/weave/mergeWeaveSequential.ts +282 -0
- package/src/weave/metrics/calculator.ts +362 -0
- package/src/weave/metrics/index.ts +44 -0
- package/src/weave/metrics/logger.ts +291 -0
- package/src/weave/metrics/schema.ts +505 -0
- package/src/weave/planner/index.ts +23 -0
- package/src/weave/planner/planner.ts +411 -0
- package/src/weave/planner/types.ts +181 -0
- package/src/weave/policy/index.ts +63 -0
- package/src/weave/policy/loader.ts +148 -0
- package/src/weave/policy/schema.ts +290 -0
- package/src/weave/post-merge-checks.ts +220 -0
- package/src/weave/preflightConflicts.ts +375 -0
- package/src/weave/receiptHelper.ts +287 -0
- package/src/weave/recovery.ts +232 -0
- package/src/weave/resolutionGuidance.ts +173 -0
- package/src/weave/stateMachine.ts +426 -0
- package/src/weave/testfix/applier.ts +195 -0
- package/src/weave/testfix/index.ts +18 -0
- package/src/weave/testfix/loader.ts +116 -0
- package/src/weave/testfix/matcher.ts +158 -0
- package/src/weave/testfix/schema.ts +218 -0
- package/src/weave/types.ts +305 -0
- package/src/weave/utils/copilot-completion.ts +76 -0
- package/test-mcp-dogfood.mjs +128 -0
- package/test-mcp.mjs +116 -0
- package/tests/README.md +155 -0
- package/tests/advanced-cli-e2e.spec.ts +218 -0
- package/tests/agentAssigner.spec.ts +261 -0
- package/tests/ai-conflict-strategy-cache.spec.ts +254 -0
- package/tests/ai-conflict-strategy-risk.spec.ts +287 -0
- package/tests/ai-conflict-strategy-schema.spec.ts +252 -0
- package/tests/ai-conflict-strategy.spec.ts +442 -0
- package/tests/aliases/resolver.spec.ts +238 -0
- package/tests/audit/context.spec.ts +283 -0
- package/tests/audit/emitter.spec.ts +347 -0
- package/tests/audit/gateMatrix.spec.ts +335 -0
- package/tests/audit/integration.spec.ts +236 -0
- package/tests/audit/redaction.spec.ts +290 -0
- package/tests/audit/sarif-integration.spec.ts +303 -0
- package/tests/audit/sarif.spec.ts +458 -0
- package/tests/audit/schema-events.spec.ts +421 -0
- package/tests/audit/schema.spec.ts +434 -0
- package/tests/audit/sdk-integration.spec.ts +598 -0
- package/tests/audit/sdk.spec.ts +318 -0
- package/tests/audit/signing-integration.spec.ts +276 -0
- package/tests/audit/signing.spec.ts +350 -0
- package/tests/audit-signing.spec.ts +406 -0
- package/tests/audit-verify-cli.spec.ts +176 -0
- package/tests/autopilot-e2e-level3-4.spec.ts +741 -0
- package/tests/autopilot-integration.spec.ts +274 -0
- package/tests/autopilot-level1.spec.ts +449 -0
- package/tests/autopilot-level2.spec.ts +188 -0
- package/tests/autopilot-level3.spec.ts +266 -0
- package/tests/autopilot-level4.spec.ts +454 -0
- package/tests/autopilot.spec.ts +379 -0
- package/tests/ax-error-adapters.spec.ts +580 -0
- package/tests/batch-planner.spec.ts +500 -0
- package/tests/benchmark-infrastructure.spec.ts +445 -0
- package/tests/benchmarks/README.md +103 -0
- package/tests/benchmarks/baselines/baseline.json +127 -0
- package/tests/benchmarks/core/dependencyResolver.bench.ts +128 -0
- package/tests/benchmarks/core/planParser.bench.ts +114 -0
- package/tests/benchmarks/core/topologicalSort.bench.ts +102 -0
- package/tests/benchmarks/index.ts +36 -0
- package/tests/benchmarks/io/fileOperations.bench.ts +132 -0
- package/tests/benchmarks/io/gitOperations.bench.ts +99 -0
- package/tests/benchmarks/utils/graphGenerator.ts +201 -0
- package/tests/benchmarks/utils/reporter.ts +231 -0
- package/tests/benchmarks/workflows/endToEnd.bench.ts +132 -0
- package/tests/bootstrap.test.ts +319 -0
- package/tests/budget-tracker.spec.ts +279 -0
- package/tests/bulkOps.spec.ts +166 -0
- package/tests/bulletproof-determinism.test.ts +223 -0
- package/tests/canonicalJson.test.ts +130 -0
- package/tests/checkRunConverter.spec.ts +357 -0
- package/tests/cli/commands/gate/test.spec.ts +564 -0
- package/tests/cli/emit-frames-flag.spec.ts +117 -0
- package/tests/cli/exitHandler.spec.ts +314 -0
- package/tests/cli/flags.spec.ts +223 -0
- package/tests/cli/formatters.spec.ts +513 -0
- package/tests/cli/output.spec.ts +221 -0
- package/tests/cli-autopilot.spec.ts +170 -0
- package/tests/cli-budget-guards.spec.ts +210 -0
- package/tests/cli-color-control.spec.ts +334 -0
- package/tests/cli-deliverables-generator.spec.ts +185 -0
- package/tests/cli-determinism.spec.ts +496 -0
- package/tests/cli-init-enterprise.spec.ts +294 -0
- package/tests/cli-init-json.spec.ts +154 -0
- package/tests/cli-init-local.spec.ts +159 -0
- package/tests/cli-json-envelope.spec.ts +140 -0
- package/tests/cli-json.spec.ts +408 -0
- package/tests/cli-orchestrate-plan-batch.spec.ts +329 -0
- package/tests/cli-orchestrate.spec.ts +231 -0
- package/tests/cli-plan-generation.spec.ts +367 -0
- package/tests/cli-plan-review.spec.ts +300 -0
- package/tests/cli-progress.spec.ts +193 -0
- package/tests/cli-ux-enhancements.spec.ts +213 -0
- package/tests/cliJsonPurity.spec.ts +437 -0
- package/tests/cliSuggestDeps.spec.ts +360 -0
- package/tests/cluster-gates-rollback.spec.ts +353 -0
- package/tests/command-validator-integration.spec.ts +305 -0
- package/tests/command-validator.spec.ts +380 -0
- package/tests/commands/autopilot.spec.ts +124 -0
- package/tests/commands/config-validate.spec.ts +301 -0
- package/tests/commands/config.spec.ts +311 -0
- package/tests/commands/create-project.spec.ts +90 -0
- package/tests/commands/doctor.spec.ts +57 -0
- package/tests/commands/execute.spec.ts +293 -0
- package/tests/commands/gateAttest.spec.ts +172 -0
- package/tests/commands/gateImport.spec.ts +176 -0
- package/tests/commands/gateReport.spec.ts +130 -0
- package/tests/commands/guards.spec.ts +114 -0
- package/tests/commands/idea.spec.ts +177 -0
- package/tests/commands/merge.spec.ts +166 -0
- package/tests/commands/plan.spec.ts +123 -0
- package/tests/commands/query.spec.ts +294 -0
- package/tests/commands/report.spec.ts +54 -0
- package/tests/commands/retry.spec.ts +300 -0
- package/tests/commands/schema.spec.ts +136 -0
- package/tests/commands/validation.spec.ts +229 -0
- package/tests/completion.spec.ts +133 -0
- package/tests/config-inspect.spec.ts +202 -0
- package/tests/conflictClustering-e2e.spec.ts +278 -0
- package/tests/conflictClustering.spec.ts +550 -0
- package/tests/conflictGraph.spec.ts +126 -0
- package/tests/conflictPredictor.spec.ts +238 -0
- package/tests/deliverables-generator.spec.ts +329 -0
- package/tests/deliverables.spec.ts +381 -0
- package/tests/dependencyParser-github.spec.ts +244 -0
- package/tests/dependencyParser.spec.ts +386 -0
- package/tests/dependencyScoring.spec.ts +668 -0
- package/tests/deterministic-applicable.test.ts +156 -0
- package/tests/deterministic-build.test.ts +172 -0
- package/tests/deterministic-simple.test.ts +32 -0
- package/tests/discover-suggest-integration.spec.ts +340 -0
- package/tests/dogfood-merge-weave-script.spec.ts +150 -0
- package/tests/e2e/planner.spec.ts +596 -0
- package/tests/e2e-comprehensive.test.ts +500 -0
- package/tests/e2e-determinism.test.ts +293 -0
- package/tests/e2e-synthetic-6pr-weave.spec.ts +329 -0
- package/tests/enterprise-init.spec.ts +350 -0
- package/tests/envUtils.spec.ts +267 -0
- package/tests/error-handling.test.ts +104 -0
- package/tests/error-recovery.spec.ts +451 -0
- package/tests/execution-plan-v1.test.ts +257 -0
- package/tests/executionState-loadGateResults.spec.ts +267 -0
- package/tests/executionState.test.ts +169 -0
- package/tests/executors/README.md +100 -0
- package/tests/executors/frameContract-integration.spec.ts +324 -0
- package/tests/executors/frameContract.spec.ts +531 -0
- package/tests/executors/guardrailEnforcement.spec.ts +424 -0
- package/tests/executors/lifecycle.spec.ts +313 -0
- package/tests/executors/toolBudget.spec.ts +473 -0
- package/tests/feature-spec-v0.test.ts +145 -0
- package/tests/fileAnalysis.spec.ts +946 -0
- package/tests/fingerprint.spec.ts +100 -0
- package/tests/fixtures/README.md +380 -0
- package/tests/fixtures/deliverables/batch-example-plan.json +62 -0
- package/tests/fixtures/executors/README.md +57 -0
- package/tests/fixtures/executors/index.ts +9 -0
- package/tests/fixtures/executors/mock-executor.ts +204 -0
- package/tests/fixtures/executors/registry.ts +51 -0
- package/tests/fixtures/executors/types.ts +95 -0
- package/tests/fixtures/fixtures.spec.ts +307 -0
- package/tests/fixtures/gates/configs.ts +234 -0
- package/tests/fixtures/gates/results.ts +234 -0
- package/tests/fixtures/harvest-bundle-fixture.json +87 -0
- package/tests/fixtures/index.ts +219 -0
- package/tests/fixtures/invalid/plans.ts +178 -0
- package/tests/fixtures/jest/all-passing.json +71 -0
- package/tests/fixtures/jest/snapshot-failures.json +66 -0
- package/tests/fixtures/jest/some-failing.json +100 -0
- package/tests/fixtures/jest/with-location.json +84 -0
- package/tests/fixtures/junit/cdata-messages.xml +29 -0
- package/tests/fixtures/junit/multiple-suites.xml +30 -0
- package/tests/fixtures/junit/single-suite.xml +17 -0
- package/tests/fixtures/junit/with-errors.xml +19 -0
- package/tests/fixtures/junit/with-skipped.xml +18 -0
- package/tests/fixtures/npm-audit.json +32 -0
- package/tests/fixtures/plan.bad-schema.json +5 -0
- package/tests/fixtures/plan.bad-unknown-dep.json +10 -0
- package/tests/fixtures/plan.ci-gates.json +36 -0
- package/tests/fixtures/plan.complex-cycle.json +22 -0
- package/tests/fixtures/plan.cycle.json +14 -0
- package/tests/fixtures/plan.deep-chain.json +95 -0
- package/tests/fixtures/plan.dogfood-execute.json +36 -0
- package/tests/fixtures/plan.gates.json +30 -0
- package/tests/fixtures/plan.integration-pyramid.json +56 -0
- package/tests/fixtures/plan.orphans.json +22 -0
- package/tests/fixtures/plan.parallel.json +30 -0
- package/tests/fixtures/plan.tiny.json +18 -0
- package/tests/fixtures/plan.wide-parallel.json +75 -0
- package/tests/fixtures/plan.with-failures.json +26 -0
- package/tests/fixtures/plan.with-vuln.json +25 -0
- package/tests/fixtures/planner/cross-module.json +101 -0
- package/tests/fixtures/planner/cycle-error.json +56 -0
- package/tests/fixtures/planner/diamond-pattern.json +74 -0
- package/tests/fixtures/planner/empty-repo.json +9 -0
- package/tests/fixtures/planner/file-overlap-heavy.json +110 -0
- package/tests/fixtures/planner/invalid-pr.json +25 -0
- package/tests/fixtures/planner/merge-conflicts.json +42 -0
- package/tests/fixtures/planner/mixed-deps.json +101 -0
- package/tests/fixtures/planner/self-dependency.json +24 -0
- package/tests/fixtures/planner/simple-stack.json +79 -0
- package/tests/fixtures/planner/single-pr.json +25 -0
- package/tests/fixtures/planner/stale-pr.json +40 -0
- package/tests/fixtures/plans/complex.ts +201 -0
- package/tests/fixtures/plans/diamond.ts +115 -0
- package/tests/fixtures/plans/linear.ts +74 -0
- package/tests/fixtures/plans/simple.ts +61 -0
- package/tests/fixtures/prs/basic.ts +175 -0
- package/tests/fixtures/prs/withDeps.ts +197 -0
- package/tests/fixtures/scan-results-clean.sarif +15 -0
- package/tests/fixtures/scan-results.sarif +74 -0
- package/tests/fixtures/scenarios/mergeWorkflows.ts +300 -0
- package/tests/fixtures/scenarios/syntheticWeave.ts +351 -0
- package/tests/fixtures/snapshot/package.json +5 -0
- package/tests/fixtures/snapshot/sample.ts +21 -0
- package/tests/fixtures/utils/cleanup.ts +81 -0
- package/tests/fixtures/utils/mockGitHub.ts +219 -0
- package/tests/fixtures/utils/tempDir.ts +109 -0
- package/tests/fixtures/verification/expected-verification.json +16 -0
- package/tests/fixtures/verification/receipt.json +31 -0
- package/tests/fixtures/verification/snapshot.json +44 -0
- package/tests/fixtures/vitest/all-passing.json +67 -0
- package/tests/fixtures/vitest/complex-nested-suites.json +98 -0
- package/tests/fixtures/vitest/some-failing.json +98 -0
- package/tests/fixtures/vitest/with-coverage.json +97 -0
- package/tests/fixtures-usage-examples.spec.ts +304 -0
- package/tests/flakeReport.spec.ts +267 -0
- package/tests/frames/ci-gate-integration.spec.ts +331 -0
- package/tests/frames/controller.spec.ts +165 -0
- package/tests/frames/emitter.spec.ts +371 -0
- package/tests/frames/idempotency.spec.ts +177 -0
- package/tests/frames/storage.spec.ts +346 -0
- package/tests/frames/types.spec.ts +249 -0
- package/tests/frames/v2-schema-integration.spec.ts +435 -0
- package/tests/gate-working-directory.spec.ts +204 -0
- package/tests/gateMapping.spec.ts +161 -0
- package/tests/gateReportIntegration.spec.ts +175 -0
- package/tests/gateReportValidation.spec.ts +452 -0
- package/tests/gates/test/adapters/jest-json.spec.ts +372 -0
- package/tests/gates/test/adapters/junit-xml.spec.ts +421 -0
- package/tests/gates/test/adapters/registry.spec.ts +376 -0
- package/tests/gates/test/adapters/vitest-json.spec.ts +455 -0
- package/tests/gates/test/enrichment/failureId.spec.ts +131 -0
- package/tests/gates/test/enrichment/nextActions.spec.ts +365 -0
- package/tests/gates/test/enrichment/rerunTemplates.spec.ts +187 -0
- package/tests/gates/test/enrichment/signature.spec.ts +163 -0
- package/tests/gates/test/enrichment/stackParser.spec.ts +203 -0
- package/tests/gates/turncost-integration.spec.ts +221 -0
- package/tests/gates/validation-integration.spec.ts +147 -0
- package/tests/gates/validator.spec.ts +200 -0
- package/tests/gates.test.ts +255 -0
- package/tests/gatesWithPolicy.hostilityTimeoutAdjustment.spec.ts +156 -0
- package/tests/git-operations-receipts.spec.ts +121 -0
- package/tests/git-operations.test.ts +152 -0
- package/tests/git-runtime.spec.ts +175 -0
- package/tests/github-api.labels.spec.ts +21 -0
- package/tests/github-api.test.ts +85 -0
- package/tests/github-context-diet.spec.ts +441 -0
- package/tests/github-diff-hunks.spec.ts +387 -0
- package/tests/github-integration.spec.ts +774 -0
- package/tests/github-minimal-context.spec.ts +338 -0
- package/tests/github-symbol-map.spec.ts +414 -0
- package/tests/githubClient.spec.ts +123 -0
- package/tests/governance/mcpStatus.spec.ts +276 -0
- package/tests/governance/timeoutAdjustment.spec.ts +149 -0
- package/tests/governance/turnCostSummary.spec.ts +188 -0
- package/tests/governance-retention.spec.ts +151 -0
- package/tests/governance-wrapper-delegation.spec.ts +148 -0
- package/tests/guardrails.spec.ts +860 -0
- package/tests/hash.test.ts +83 -0
- package/tests/helpers/cli.ts +23 -0
- package/tests/helpers/getStd.ts +1 -0
- package/tests/helpers/makeGate.ts +19 -0
- package/tests/helpers/plannerTestHelpers.ts +314 -0
- package/tests/hooks/events.spec.ts +518 -0
- package/tests/hostility/checks.spec.ts +295 -0
- package/tests/hostility/integration.spec.ts +123 -0
- package/tests/hostility/score.spec.ts +175 -0
- package/tests/init.spec.ts +270 -0
- package/tests/integration/hipaa-encryption.spec.ts +148 -0
- package/tests/integration/lex-smoke-test.spec.ts +328 -0
- package/tests/integration-e2e.test.ts +244 -0
- package/tests/integration-matrix.test.ts +409 -0
- package/tests/interPRConflicts.spec.ts +254 -0
- package/tests/interactive-plan-history.spec.ts +255 -0
- package/tests/interactive-plan-review.spec.ts +287 -0
- package/tests/issue-analyzer.spec.ts +593 -0
- package/tests/lexsona-integration.spec.ts +311 -0
- package/tests/localOverlay.spec.ts +203 -0
- package/tests/lockHash.spec.ts +167 -0
- package/tests/mcp-auth-errors.spec.ts +190 -0
- package/tests/mcp-contracts.spec.ts +290 -0
- package/tests/mcp-gates-external-plan.spec.ts +146 -0
- package/tests/mcp-granular-tools.spec.ts +208 -0
- package/tests/mcp-runstore-integration.spec.ts +334 -0
- package/tests/mcp-scope-integration.spec.ts +318 -0
- package/tests/mcp-task-handoff.spec.ts +320 -0
- package/tests/mcp-workflow-guide.spec.ts +53 -0
- package/tests/mcp.test.ts +151 -0
- package/tests/merge-conflict-detection.spec.ts +260 -0
- package/tests/mergeEligibility.test.ts +201 -0
- package/tests/mergeLockHash.spec.ts +158 -0
- package/tests/mergeOrder-with-fixtures.spec.ts +215 -0
- package/tests/mergeOrder.test.ts +108 -0
- package/tests/mergeTreeSimulator.spec.ts +145 -0
- package/tests/metrics/export.spec.ts +446 -0
- package/tests/metrics/turncost.spec.ts +309 -0
- package/tests/metrics-template.spec.ts +137 -0
- package/tests/migrateProfile.spec.ts +254 -0
- package/tests/mis.spec.ts +202 -0
- package/tests/monitoring-audit.spec.ts +181 -0
- package/tests/monitoring-cache.spec.ts +331 -0
- package/tests/monitoring-error-recovery.spec.ts +236 -0
- package/tests/monitoring-errors.spec.ts +193 -0
- package/tests/monitoring-fileLogger.spec.ts +319 -0
- package/tests/monitoring-health.spec.ts +152 -0
- package/tests/monitoring-lock.spec.ts +308 -0
- package/tests/monitoring-logger.spec.ts +157 -0
- package/tests/monitoring-metrics.spec.ts +158 -0
- package/tests/monitoring-profiler.spec.ts +197 -0
- package/tests/orchestration-determinism.spec.ts +204 -0
- package/tests/parseRemote.spec.ts +25 -0
- package/tests/pathResolver.spec.ts +122 -0
- package/tests/paths.spec.ts +68 -0
- package/tests/performance.spec.ts +322 -0
- package/tests/pipeline-determinism.spec.ts +597 -0
- package/tests/plan-tier-integration.spec.ts +184 -0
- package/tests/precedence-resolution.spec.ts +682 -0
- package/tests/preflightConflicts.spec.ts +205 -0
- package/tests/procedures/keystone-policy.spec.ts +296 -0
- package/tests/procedures/loader.spec.ts +585 -0
- package/tests/procedures/pr-review.spec.ts +321 -0
- package/tests/profileResolver.spec.ts +375 -0
- package/tests/progress-indicators.spec.ts +139 -0
- package/tests/promptsResolver.spec.ts +443 -0
- package/tests/public-api.spec.ts +272 -0
- package/tests/query.spec.ts +170 -0
- package/tests/receipts.spec.ts +463 -0
- package/tests/release-prepare.spec.ts +268 -0
- package/tests/report.test.ts +335 -0
- package/tests/resolutionGuidance.spec.ts +160 -0
- package/tests/rotate-secrets-example.spec.ts +198 -0
- package/tests/rulesResolver.spec.ts +232 -0
- package/tests/runGit.spec.ts +229 -0
- package/tests/runner-lifecycle-integration.spec.ts +283 -0
- package/tests/runs/artifacts.spec.ts +367 -0
- package/tests/runs/decisions.spec.ts +495 -0
- package/tests/runs/enforcement.spec.ts +555 -0
- package/tests/runs/failures.spec.ts +554 -0
- package/tests/runs/manager-runstore-integration.spec.ts +455 -0
- package/tests/runs/manager.spec.ts +678 -0
- package/tests/runs-manager.spec.ts +485 -0
- package/tests/safety-acceptance.spec.ts +278 -0
- package/tests/safety-enhanced.spec.ts +329 -0
- package/tests/safety-framework.spec.ts +427 -0
- package/tests/safety-guards-integration.spec.ts +213 -0
- package/tests/safety-integration.spec.ts +278 -0
- package/tests/sarif-parser.spec.ts +148 -0
- package/tests/schema.test.ts +88 -0
- package/tests/schemas/behavior-rule.spec.ts +366 -0
- package/tests/schemas/executorManifest.spec.ts +441 -0
- package/tests/schemas/persona-integration.spec.ts +62 -0
- package/tests/schemas/persona.spec.ts +172 -0
- package/tests/schemas/project.spec.ts +247 -0
- package/tests/schemas/run-store.spec.ts +553 -0
- package/tests/schemas/runCentric.spec.ts +463 -0
- package/tests/schemas/vacuumReadyPrompt.spec.ts +515 -0
- package/tests/scope-github-auto-detection.spec.ts +200 -0
- package/tests/scopeValidator.spec.ts +497 -0
- package/tests/security-authentication.spec.ts +42 -0
- package/tests/security-authorization.spec.ts +350 -0
- package/tests/security-cli.spec.ts +264 -0
- package/tests/security-compliance.spec.ts +334 -0
- package/tests/security-policy.spec.ts +295 -0
- package/tests/security-scanning.spec.ts +349 -0
- package/tests/security-secrets.spec.ts +401 -0
- package/tests/store/create-run-store.spec.ts +185 -0
- package/tests/store/inmemory/run-store.spec.ts +533 -0
- package/tests/store/sqlite/run-store.spec.ts +849 -0
- package/tests/telemetry/frames.spec.ts +120 -0
- package/tests/tiers.spec.ts +466 -0
- package/tests/token-usage.spec.ts +309 -0
- package/tests/toolchain-manifest.spec.ts +145 -0
- package/tests/unified-budget.spec.ts +713 -0
- package/tests/unit/cache/issue-cache.spec.ts +131 -0
- package/tests/unit/fanout/analyzer-integration.spec.ts +398 -0
- package/tests/unit/fanout/analyzer.spec.ts +605 -0
- package/tests/unit/fanout/github-adapter.spec.ts +203 -0
- package/tests/unit/fanout/harvest.spec.ts +93 -0
- package/tests/unit/fanout/monitor.spec.ts +297 -0
- package/tests/unit/fanout/types.spec.ts +308 -0
- package/tests/unit/github/batch-ops.spec.ts +179 -0
- package/tests/unit/learning/counter-example.spec.ts +168 -0
- package/tests/unit/learning/storage.spec.ts +154 -0
- package/tests/unit/preview/constraints.spec.ts +429 -0
- package/tests/unit/runs/attribution.spec.ts +204 -0
- package/tests/unit/schemas/task-contract.spec.ts +483 -0
- package/tests/unit/snapshot/builder.spec.ts +389 -0
- package/tests/unit/verification/engine-verifier.spec.ts +279 -0
- package/tests/unit/weave/authority-evaluator.spec.ts +404 -0
- package/tests/unit/weave/authority-schema.spec.ts +199 -0
- package/tests/unit/weave/auto-undraft-integration.spec.ts +349 -0
- package/tests/unit/weave/copilot-completion.spec.ts +182 -0
- package/tests/unit/weave/d1-executor.spec.ts +269 -0
- package/tests/unit/weave/d2-executor.spec.ts +334 -0
- package/tests/unit/weave/fanout-generator.spec.ts +365 -0
- package/tests/unit/weave/fanout-matcher.spec.ts +320 -0
- package/tests/unit/weave/fanout-schema.spec.ts +221 -0
- package/tests/unit/weave/mergeWeaveSequential.spec.ts +268 -0
- package/tests/unit/weave/metrics-calculator.spec.ts +212 -0
- package/tests/unit/weave/metrics-logger.spec.ts +233 -0
- package/tests/unit/weave/metrics-schema.spec.ts +383 -0
- package/tests/unit/weave/multi-repo-plan.spec.ts +221 -0
- package/tests/unit/weave/planner.spec.ts +227 -0
- package/tests/unit/weave/post-merge-checks.spec.ts +342 -0
- package/tests/unit/weave/recovery.spec.ts +306 -0
- package/tests/unit/weave/testfix/applier.spec.ts +364 -0
- package/tests/unit/weave/testfix/e2e.spec.ts +273 -0
- package/tests/unit/weave/testfix/integration.spec.ts +128 -0
- package/tests/unit/weave/testfix/matcher.spec.ts +321 -0
- package/tests/unit/weave/testfix/schema.spec.ts +298 -0
- package/tests/utils/fingerprint.spec.ts +251 -0
- package/tests/utils/paths.spec.ts +284 -0
- package/tests/utils/tokens.spec.ts +210 -0
- package/tests/utils/validation.spec.ts +215 -0
- package/tests/utils-validation.spec.ts +80 -0
- package/tests/validate-manifests.spec.ts +231 -0
- package/tests/validation.spec.ts +501 -0
- package/tests/vuln-gate.spec.ts +341 -0
- package/tests/weave/adr007-integration.spec.ts +309 -0
- package/tests/weave/checkpoint/cli-integration.spec.ts +118 -0
- package/tests/weave/checkpoint/storage.spec.ts +302 -0
- package/tests/weave/checkpoint/utils.spec.ts +223 -0
- package/tests/weave/frameHelper.spec.ts +423 -0
- package/tests/weave/gateFailureHandler.spec.ts +249 -0
- package/tests/weave/lockFile.spec.ts +387 -0
- package/tests/weave/mergeHelpers.spec.ts +173 -0
- package/tests/weave/receiptHelper.spec.ts +261 -0
- package/tests/weave/stateMachine.spec.ts +436 -0
- package/tests/weave-contract.test.ts +517 -0
- package/tests/weave-e2e.spec.ts +279 -0
- package/tests/weaveLock.spec.ts +136 -0
- package/tests/workflow-state-machine.spec.ts +274 -0
- package/tests/write-protection.spec.ts +213 -0
- package/tsconfig.json +18 -0
- package/tsup.config.ts +12 -0
- package/vitest.benchmark.config.ts +17 -0
- package/vitest.config.ts +28 -0
- package/vitest.git.config.ts +12 -0
- package/vitest.slow-cli.config.ts +28 -0
|
@@ -0,0 +1,952 @@
|
|
|
1
|
+
# Coordination Cost Compression in Human–AI Collaboration:
|
|
2
|
+
|
|
3
|
+
# A Governance-First Architecture
|
|
4
|
+
|
|
5
|
+
**Authors:**
|
|
6
|
+
Joseph Gustavson¹ · ORCID: [0009-0001-0669-0749](https://orcid.org/0009-0001-0669-0749)
|
|
7
|
+
with AI Co-Authors: Claude Opus 4.5 (Anthropic) as "Opie", GPT-5.1 (OpenAI) as "Lex"
|
|
8
|
+
|
|
9
|
+
¹ Independent Researcher
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## Abstract
|
|
14
|
+
|
|
15
|
+
Large Language Model (LLM)-based agents are increasingly deployed in software engineering workflows, yet productivity gains remain inconsistent. Current approaches emphasize model capability—larger parameters, longer context windows, more sophisticated reasoning—as the primary lever for improvement. We propose an alternative thesis: **coordination cost compression**, not capability amplification, is the primary determinant of effective human–AI collaboration.
|
|
16
|
+
|
|
17
|
+
We introduce a governance-first architecture comprising five core constructs: (1) **Turn Cost** as a composite metric for interaction overhead, (2) **environmental hostility** as a framework for understanding agent failure modes, (3) **governance primitives** encoded as machine-readable rule files, (4) **cross-model continuity** through externalized state, and (5) **capability tiers** for task-appropriate model allocation.
|
|
18
|
+
|
|
19
|
+
We present preliminary empirical validation through a case study ("Robert") demonstrating that minimal governance infrastructure (~1.2KB of contracts) can reduce Turn Cost by 62% and renegotiation rates from 34% to 8% across multiple LLM providers. We situate our work within the broader literature on multi-agent systems, human–AI teaming, and coordination theory, and explicitly acknowledge the limitations of single-case validation, potential observer effects, and the need for controlled studies.
|
|
20
|
+
|
|
21
|
+
Our contribution is theoretical and architectural: we offer a falsifiable framework for understanding human–AI collaboration that shifts focus from model capability to environmental design. We do not claim to have solved human–AI collaboration; we claim to have identified a productive axis for investigation.
|
|
22
|
+
|
|
23
|
+
**Keywords:** Human–AI collaboration, multi-agent systems, coordination cost, governance, software engineering, LLM agents
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## 1. Introduction
|
|
28
|
+
|
|
29
|
+
### 1.1 The Capability Trap
|
|
30
|
+
|
|
31
|
+
The dominant paradigm in LLM-based agent design assumes a direct relationship between model capability and task performance:
|
|
32
|
+
|
|
33
|
+
$$\text{Performance} \propto f(\text{ModelCapability})$$
|
|
34
|
+
|
|
35
|
+
This assumption drives substantial investment in larger models, longer context windows, and more sophisticated reasoning architectures [1, 2]. Yet empirical observations suggest diminishing returns: the productivity jump from GPT-3.5 to GPT-4 was substantial; subsequent improvements, while meaningful, have not produced equivalent step-changes in practitioner productivity [3, 4].
|
|
36
|
+
|
|
37
|
+
More troubling, practitioners report that "stronger" models often require _more_ careful prompting, _more_ context management, and _more_ human intervention to achieve consistent results. This paradox suggests that the limiting factor may not be model capability per se.
|
|
38
|
+
|
|
39
|
+
### 1.2 The Coordination Cost Hypothesis
|
|
40
|
+
|
|
41
|
+
We propose an alternative framing:
|
|
42
|
+
|
|
43
|
+
> **Thesis:** In human–AI collaborative systems, productivity is primarily constrained by _coordination cost_—the overhead of establishing shared context, disambiguating intent, recovering from misunderstandings, and verifying outputs—rather than by raw model capability.
|
|
44
|
+
|
|
45
|
+
Formally, we define effective productivity as:
|
|
46
|
+
|
|
47
|
+
$$\text{EffectiveProductivity} = \frac{\text{ValueDelivered}}{\text{TokenCost} + \text{CoordinationCost}}$$
|
|
48
|
+
|
|
49
|
+
Current optimization efforts focus almost exclusively on the denominator's first term (token efficiency through better models). We argue the second term—coordination cost—is often larger and more tractable.
|
|
50
|
+
|
|
51
|
+
### 1.3 Contribution and Scope
|
|
52
|
+
|
|
53
|
+
This paper makes the following contributions:
|
|
54
|
+
|
|
55
|
+
1. **Theoretical framework:** We introduce _coordination cost compression_ as an organizing principle for human–AI system design, distinct from capability amplification.
|
|
56
|
+
|
|
57
|
+
2. **Formal constructs:** We define _Turn Cost_, _environmental hostility_, _governance primitives_, and _capability tiers_ as measurable quantities with operational definitions.
|
|
58
|
+
|
|
59
|
+
3. **Architectural proposal:** We describe a governance-first architecture that aims to reduce coordination cost through explicit contracts, externalized state, and tiered task allocation.
|
|
60
|
+
|
|
61
|
+
4. **Preliminary validation:** We present a case study demonstrating feasibility and quantifying effects under controlled conditions.
|
|
62
|
+
|
|
63
|
+
**Explicit scope boundaries:** We do not claim to have created autonomous agents, solved general AI alignment, or replaced human engineers. We do not predict model evolution or propose AGI-relevant techniques. Our scope is narrow: improving the efficiency of human–AI collaboration in software engineering tasks.
|
|
64
|
+
|
|
65
|
+
### 1.4 Framework Overview
|
|
66
|
+
|
|
67
|
+
Figure 1 illustrates the relationships between our core constructs:
|
|
68
|
+
|
|
69
|
+
```
|
|
70
|
+
┌─────────────────────────────────────────────────────────────────────────┐
|
|
71
|
+
│ GOVERNANCE LAYER │
|
|
72
|
+
│ ┌───────────────┐ ┌───────────────┐ ┌───────────────┐ │
|
|
73
|
+
│ │ Contracts │ │ Receipts │ │ Capability │ │
|
|
74
|
+
│ │ (invariants, │ │ (decisions, │ │ Tiers │ │
|
|
75
|
+
│ │ boundaries) │ │ rationale) │ │ (Sr/Mid/Jr) │ │
|
|
76
|
+
│ └───────┬───────┘ └───────┬───────┘ └───────┬───────┘ │
|
|
77
|
+
└───────────┼─────────────────────┼─────────────────────┼─────────────────┘
|
|
78
|
+
│ │ │
|
|
79
|
+
▼ ▼ ▼
|
|
80
|
+
┌─────────────────────────────────────────────────────────────────────────┐
|
|
81
|
+
│ MECHANISM LAYER │
|
|
82
|
+
│ │
|
|
83
|
+
│ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │
|
|
84
|
+
│ │ Reduced │ │ Cross-Model │ │ Structured │ │
|
|
85
|
+
│ │ Renegotiation │ │ Continuity │ │ Escalation │ │
|
|
86
|
+
│ └────────┬────────┘ └────────┬────────┘ └────────┬────────┘ │
|
|
87
|
+
└────────────┼──────────────────────┼──────────────────────┼──────────────┘
|
|
88
|
+
│ │ │
|
|
89
|
+
└──────────────────────┼──────────────────────┘
|
|
90
|
+
▼
|
|
91
|
+
┌─────────────────────────────────────────────────────────────────────────┐
|
|
92
|
+
│ EFFECT LAYER │
|
|
93
|
+
│ │
|
|
94
|
+
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
|
95
|
+
│ │ TURN COST COMPRESSION │ │
|
|
96
|
+
│ │ │ │
|
|
97
|
+
│ │ TurnCost = λL + γC + ρR + τT + αA │ │
|
|
98
|
+
│ │ ↓ ↓ ↓ ↓ ↓ │ │
|
|
99
|
+
│ │ ─ ─ ─ ─ ─ │ │
|
|
100
|
+
│ │ (each component reduced by governance mechanisms) │ │
|
|
101
|
+
│ └─────────────────────────────────────────────────────────────────┘ │
|
|
102
|
+
└─────────────────────────────────────────────────────────────────────────┘
|
|
103
|
+
│
|
|
104
|
+
▼
|
|
105
|
+
┌─────────────────────────────────────────────────────────────────────────┐
|
|
106
|
+
│ HYPOTHESIS │
|
|
107
|
+
│ │
|
|
108
|
+
│ "Coordination cost compression, not capability amplification, │
|
|
109
|
+
│ is the primary determinant of effective human–AI collaboration." │
|
|
110
|
+
│ │
|
|
111
|
+
│ TESTABLE PREDICTION: Governance quality predicts productivity │
|
|
112
|
+
│ better than model capability (controlling for task complexity). │
|
|
113
|
+
└─────────────────────────────────────────────────────────────────────────┘
|
|
114
|
+
|
|
115
|
+
Legend:
|
|
116
|
+
───────
|
|
117
|
+
Contracts → Reduced Renegotiation: Explicit invariants mean fewer
|
|
118
|
+
clarification turns
|
|
119
|
+
Receipts → Cross-Model Continuity: Externalized state survives
|
|
120
|
+
session/model boundaries
|
|
121
|
+
Tiers → Structured Escalation: Tasks matched to capability,
|
|
122
|
+
reducing wasted cycles
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
_Figure 1: Unifying framework showing how governance constructs (top) produce mechanisms (middle) that compress Turn Cost components (effect), supporting the central hypothesis (bottom)._
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
## 2. Related Work
|
|
130
|
+
|
|
131
|
+
### 2.1 Multi-Agent Systems and Coordination
|
|
132
|
+
|
|
133
|
+
The study of multi-agent coordination has deep roots in distributed systems and game theory [5, 6]. Classic work on multi-agent systems (MAS) established fundamental challenges: achieving coherent behavior without central control, managing shared resources, and handling partial observability [7].
|
|
134
|
+
|
|
135
|
+
Recent surveys on LLM-based multi-agent systems identify coordination mechanisms as a critical open problem. Tran et al. [8] characterize collaboration mechanisms along dimensions of actors, types (cooperation/competition/coopetition), structures (peer-to-peer/centralized/distributed), and coordination protocols. Our work contributes to the "coordination protocols" dimension by proposing explicit governance artifacts as coordination mechanisms.
|
|
136
|
+
|
|
137
|
+
Wang et al. [9] survey multi-agent collaboration and note that most current systems rely on implicit coordination through shared context or role-based prompting. We argue this is insufficient for production software engineering, where coordination failures have concrete costs (bugs, security vulnerabilities, integration failures).
|
|
138
|
+
|
|
139
|
+
### 2.2 Human–AI Teaming
|
|
140
|
+
|
|
141
|
+
Research on human–AI collaboration has identified persistent challenges in hybrid teams. Studies of human–AI teaming in field settings show that productivity gains are inconsistent and context-dependent [10]. Factors affecting success include task structure, feedback mechanisms, and the ability to establish shared mental models [11].
|
|
142
|
+
|
|
143
|
+
The concept of "environmental hostility" we introduce relates to prior work on automation brittleness and human factors in automated systems [12]. When environments provide unclear constraints, ambiguous feedback, or punitive error dynamics, both human and AI performance degrades.
|
|
144
|
+
|
|
145
|
+
Importantly, several empirical studies have found that human–AI teams sometimes underperform humans alone [13], particularly when coordination costs exceed productivity gains. This finding supports our thesis that coordination cost, not capability, is often the binding constraint.
|
|
146
|
+
|
|
147
|
+
### 2.3 Coordination Theory
|
|
148
|
+
|
|
149
|
+
Malone and Crowston's coordination theory [14] provides a foundational framework for understanding coordination as "managing dependencies between activities." They identify coordination mechanisms including shared representations, communication protocols, and group decision procedures.
|
|
150
|
+
|
|
151
|
+
Our governance primitives can be understood as coordination mechanisms in this sense: they manage dependencies by making constraints explicit, reducing disambiguation requirements, and providing recovery protocols. The "rule file" artifact we propose is a shared representation that reduces coordination overhead by externalizing expectations.
|
|
152
|
+
|
|
153
|
+
### 2.4 LLM Agent Architectures
|
|
154
|
+
|
|
155
|
+
Recent work on LLM agent architectures has explored various approaches to improving reliability: chain-of-thought prompting [15], tool use [16], and multi-agent debate [17]. Most of this work focuses on the agent's internal reasoning process.
|
|
156
|
+
|
|
157
|
+
We propose that external governance—constraints and expectations defined _outside_ the model—may be more robust than internal reasoning improvements. This is consistent with findings that prompt engineering has diminishing returns and that behavioral steering through system instructions is fragile [18].
|
|
158
|
+
|
|
159
|
+
### 2.5 Positioning Our Contribution
|
|
160
|
+
|
|
161
|
+
Our work differs from prior multi-agent research in several ways:
|
|
162
|
+
|
|
163
|
+
| Dimension | Typical MAS Approach | Our Approach |
|
|
164
|
+
| ---------------------- | ---------------------------------------------- | --------------------------------------------- |
|
|
165
|
+
| Coordination mechanism | Implicit (shared context) or negotiation-based | Explicit governance artifacts |
|
|
166
|
+
| Optimization target | Task completion rate, accuracy | Turn Cost (interaction overhead) |
|
|
167
|
+
| State management | Agent-internal memory | Externalized receipts and contracts |
|
|
168
|
+
| Model assumptions | Fixed model per agent | Model-agnostic, supports hot-swapping |
|
|
169
|
+
| Human role | Supervisor or absent | Collaborative partner with explicit interface |
|
|
170
|
+
|
|
171
|
+
We are not the first to propose explicit coordination mechanisms for AI systems, but we believe we are among the first to: (a) formalize _Turn Cost_ as a composite metric, (b) treat governance as a first-class, versionable artifact, and (c) empirically measure the effects on human–AI interaction patterns.
|
|
172
|
+
|
|
173
|
+
---
|
|
174
|
+
|
|
175
|
+
## 3. Theoretical Framework
|
|
176
|
+
|
|
177
|
+
### 3.1 Turn Cost: A Composite Metric
|
|
178
|
+
|
|
179
|
+
We define a **Turn** as a complete cycle of human–agent interaction:
|
|
180
|
+
|
|
181
|
+
1. Human provides input (context, instruction, feedback)
|
|
182
|
+
2. Agent processes and acts
|
|
183
|
+
3. Human reviews and responds
|
|
184
|
+
|
|
185
|
+
This differs from token-centric metrics (cost per 1K tokens) or API-centric metrics (latency per call). A Turn is a semantic unit of work with measurable properties.
|
|
186
|
+
|
|
187
|
+
#### 3.1.1 Why Turns, Not Tokens?
|
|
188
|
+
|
|
189
|
+
Existing LLM benchmarks optimize for task completion accuracy or per-token efficiency. This overlooks a critical observation from practice: **interaction overhead often exceeds token cost by an order of magnitude.**
|
|
190
|
+
|
|
191
|
+
Consider a typical software engineering task:
|
|
192
|
+
|
|
193
|
+
- Token cost: 5,000 tokens at $0.03/1K = $0.15
|
|
194
|
+
- Human attention cost: 10 minutes at $50/hr = $8.33
|
|
195
|
+
|
|
196
|
+
The ratio is 55:1. Even a 50% reduction in token cost saves $0.075; a 50% reduction in interaction turns saves $4.17. This asymmetry motivates our focus on Turns rather than Tokens.
|
|
197
|
+
|
|
198
|
+
Furthermore, Turns are the natural unit of _coordination failure_. Each Turn represents an opportunity for misalignment, clarification, or recovery. Token costs are linear; Turn costs compound through cascading misunderstandings.
|
|
199
|
+
|
|
200
|
+
#### 3.1.2 Formal Definition
|
|
201
|
+
|
|
202
|
+
**Definition 3.1 (Turn Cost):** The total overhead incurred in a single Turn, comprising:
|
|
203
|
+
|
|
204
|
+
$$\text{TurnCost} = \lambda L + \gamma C + \rho R + \tau T + \alpha A$$
|
|
205
|
+
|
|
206
|
+
Where:
|
|
207
|
+
|
|
208
|
+
- $L$ = **Latency**: Raw time waiting for model response
|
|
209
|
+
- $C$ = **Context Reset**: Tokens required to re-establish context after session boundary or model switch
|
|
210
|
+
- $R$ = **Prompt Renegotiation**: Additional turns required to clarify misunderstood instructions
|
|
211
|
+
- $T$ = **Token Bloat**: Tokens consumed beyond minimum necessary due to poor coordination
|
|
212
|
+
- $A$ = **Attention Switch**: Human cognitive cost of context-switching to manage the agent
|
|
213
|
+
|
|
214
|
+
The weights $\lambda, \gamma, \rho, \tau, \alpha$ reflect context-specific costs. We propose default weights based on observed practitioner behavior:
|
|
215
|
+
|
|
216
|
+
| Component | Symbol | Default Weight | Rationale |
|
|
217
|
+
| ---------------- | ------ | -------------- | ------------------------------------ |
|
|
218
|
+
| Latency | λ | 0.1 | Tolerable in async workflows |
|
|
219
|
+
| Context Reset | γ | 0.2 | Significant but bounded by artifacts |
|
|
220
|
+
| Renegotiation | ρ | 0.3 | High cost due to cascading effects |
|
|
221
|
+
| Token Bloat | τ | 0.1 | Low marginal cost per token |
|
|
222
|
+
| Attention Switch | α | 0.3 | Highest marginal cost (human time) |
|
|
223
|
+
|
|
224
|
+
These weights are calibration suggestions, not universal constants. Organizations should derive weights empirically from their cost structures.
|
|
225
|
+
|
|
226
|
+
#### 3.1.3 Theoretical Grounding
|
|
227
|
+
|
|
228
|
+
Turn Cost connects to established coordination theory [14]. Malone and Crowston's interdependence taxonomy identifies three coordination mechanisms:
|
|
229
|
+
|
|
230
|
+
- **Managing shared resources** → maps to Token Bloat (shared API context window)
|
|
231
|
+
- **Managing producer/consumer relationships** → maps to Renegotiation (intent alignment)
|
|
232
|
+
- **Managing simultaneity constraints** → maps to Attention Switch (human/agent synchronization)
|
|
233
|
+
|
|
234
|
+
Our formalization makes these abstract dependencies concrete and measurable.
|
|
235
|
+
|
|
236
|
+
**Claim 3.1:** In most software engineering contexts with skilled human operators, the effective cost ordering is:
|
|
237
|
+
|
|
238
|
+
$$\text{AttentionSwitch} > \text{Renegotiation} > \text{ContextReset} > \text{TokenBloat} > \text{Latency}$$
|
|
239
|
+
|
|
240
|
+
This ordering implies that optimizations reducing human intervention (fewer turns, less renegotiation) yield greater returns than optimizations reducing per-turn latency or token count.
|
|
241
|
+
|
|
242
|
+
### 3.2 Environmental Hostility
|
|
243
|
+
|
|
244
|
+
We propose that agent performance degrades in proportion to _environmental hostility_, not (primarily) model capacity.
|
|
245
|
+
|
|
246
|
+
**Definition 3.2 (Environmental Hostility):** The degree to which an environment impedes effective agent operation through:
|
|
247
|
+
|
|
248
|
+
- Unclear or implicit constraints
|
|
249
|
+
- Opaque requirements (unstated expectations)
|
|
250
|
+
- Unbounded problem surfaces
|
|
251
|
+
- Missing receipts and traceability
|
|
252
|
+
- Punitive error dynamics (failures trigger cascading costs)
|
|
253
|
+
- Fragmented state (context spread across sessions/tools)
|
|
254
|
+
- Model switches without continuity protocols
|
|
255
|
+
|
|
256
|
+
**Claim 3.2:** A progressively de-hostilized environment enables consistent agent behavior across model capabilities. Formally:
|
|
257
|
+
|
|
258
|
+
$$\text{AgentReliability} = g(\text{EnvironmentQuality}, \text{ModelCapability})$$
|
|
259
|
+
|
|
260
|
+
Where $\frac{\partial g}{\partial \text{EnvironmentQuality}} > \frac{\partial g}{\partial \text{ModelCapability}}$ in typical software engineering contexts.
|
|
261
|
+
|
|
262
|
+
This claim is falsifiable: if model capability dominates, we would expect reliability to vary primarily with model choice, not environment design. Our case study provides preliminary evidence for the alternative.
|
|
263
|
+
|
|
264
|
+
### 3.3 Governance Primitives
|
|
265
|
+
|
|
266
|
+
Governance primitives are explicit, machine-readable artifacts that reduce environmental hostility by making constraints, expectations, and protocols visible.
|
|
267
|
+
|
|
268
|
+
**Definition 3.3 (Governance Primitive):** A structured artifact that specifies:
|
|
269
|
+
|
|
270
|
+
1. **Constraints**: What the agent must/must not do
|
|
271
|
+
2. **Permissions**: What the agent is authorized to do
|
|
272
|
+
3. **Uncertainty Protocol**: How to handle ambiguity
|
|
273
|
+
4. **Receipt Protocol**: How to document decisions and actions
|
|
274
|
+
5. **Escalation Triggers**: When to involve human judgment
|
|
275
|
+
|
|
276
|
+
We specify governance primitives as YAML/JSON files with a defined schema:
|
|
277
|
+
|
|
278
|
+
```yaml
|
|
279
|
+
# Example: Minimal governance contract
|
|
280
|
+
schemaVersion: "1.0.0"
|
|
281
|
+
kind: AgentContract
|
|
282
|
+
|
|
283
|
+
constraints:
|
|
284
|
+
must:
|
|
285
|
+
- "Follow existing patterns in neighboring code"
|
|
286
|
+
- "Create reversible changes when uncertain"
|
|
287
|
+
must_not:
|
|
288
|
+
- "Force push to protected branches"
|
|
289
|
+
- "Bypass CI gates"
|
|
290
|
+
|
|
291
|
+
permissions:
|
|
292
|
+
can: ["create_file", "modify_file", "run_tests"]
|
|
293
|
+
cannot: ["merge_to_main", "modify_contracts"]
|
|
294
|
+
|
|
295
|
+
uncertainty:
|
|
296
|
+
allowed: true
|
|
297
|
+
expression: "explicit_marker"
|
|
298
|
+
protocol: "reversible_moves_with_receipts"
|
|
299
|
+
|
|
300
|
+
receipts:
|
|
301
|
+
required: true
|
|
302
|
+
format: "structured_yaml"
|
|
303
|
+
fields: ["action", "rationale", "confidence", "reversibility"]
|
|
304
|
+
```
|
|
305
|
+
|
|
306
|
+
**Design constraints:**
|
|
307
|
+
|
|
308
|
+
- Maximum size: 4KB (ensures quick ingestion, discourages over-specification)
|
|
309
|
+
- Versioned: Changes tracked, diffs reviewable
|
|
310
|
+
- Testable: Compliance verifiable through automated gates
|
|
311
|
+
- Role-scoped: Different contracts for different agent capabilities
|
|
312
|
+
|
|
313
|
+
### 3.4 Permission to Fail with Discipline
|
|
314
|
+
|
|
315
|
+
A key governance principle is **permission to fail with discipline**: agents may express uncertainty and make errors, provided they do so transparently, reversibly, and with structured documentation.
|
|
316
|
+
|
|
317
|
+
**Definition 3.4 (Disciplined Failure):** A failure mode where:
|
|
318
|
+
|
|
319
|
+
1. Uncertainty is stated explicitly before action
|
|
320
|
+
2. Actions taken are reversible (or flagged as non-reversible)
|
|
321
|
+
3. Receipts document the decision chain
|
|
322
|
+
4. Recovery path is proposed or escalation triggered
|
|
323
|
+
|
|
324
|
+
This contrasts with two failure modes common in LLM agents:
|
|
325
|
+
|
|
326
|
+
- **Confidence inflation**: Agent produces incorrect output confidently, human doesn't verify, error propagates
|
|
327
|
+
- **Paralysis**: Agent refuses to act without certainty, progress stalls
|
|
328
|
+
|
|
329
|
+
The discipline component is essential: permission to fail is not permission to be sloppy. The protocol requires structured uncertainty expression and bounded recovery costs.
|
|
330
|
+
|
|
331
|
+
### 3.5 Cross-Model Continuity
|
|
332
|
+
|
|
333
|
+
**Claim 3.3:** Session state that enables collaboration is not internal model state (hidden vectors, attention patterns) but _externalized governance and receipts_.
|
|
334
|
+
|
|
335
|
+
If this claim holds, then model switches—GPT-4 to Claude, Claude to Haiku—should not require substantial re-onboarding, provided governance artifacts and receipts are preserved.
|
|
336
|
+
|
|
337
|
+
**Definition 3.5 (Cross-Model Continuity):** The property that agent behavior remains consistent across model switches when:
|
|
338
|
+
|
|
339
|
+
1. Governance contracts are stable
|
|
340
|
+
2. Receipts from prior work are accessible
|
|
341
|
+
3. Shared vocabulary is documented
|
|
342
|
+
4. Current task state is explicit
|
|
343
|
+
|
|
344
|
+
This has architectural implications: session state should be stored in version-controlled files, not in API-specific memory features or prompt caches.
|
|
345
|
+
|
|
346
|
+
### 3.6 Capability Tiers
|
|
347
|
+
|
|
348
|
+
Not all tasks require the same agent capability. We propose a tiered classification:
|
|
349
|
+
|
|
350
|
+
| Tier | Role | Example Tasks | Characteristics |
|
|
351
|
+
| ---------- | --------------------------- | ------------------------------------------------ | ------------------------------------ |
|
|
352
|
+
| **Senior** | Design, critique, decide | Architecture decisions, API design, code review | Requires judgment, handles ambiguity |
|
|
353
|
+
| **Mid** | Implement, extend, refactor | Feature implementation, bug fixes, migrations | Clear scope, established patterns |
|
|
354
|
+
| **Junior** | Verify, instrument, lint | Test coverage, formatting, documentation updates | Deterministic, low-risk |
|
|
355
|
+
|
|
356
|
+
**Claim 3.4:** Matching task tier to model capability reduces overall Turn Cost by avoiding both over-allocation (expensive models on trivial tasks) and under-allocation (failures requiring escalation).
|
|
357
|
+
|
|
358
|
+
This is operationalizable: we can measure escalation rates, retry counts, and effective cost per task tier.
|
|
359
|
+
|
|
360
|
+
---
|
|
361
|
+
|
|
362
|
+
## 4. Architecture
|
|
363
|
+
|
|
364
|
+
### 4.1 System Overview
|
|
365
|
+
|
|
366
|
+
The proposed architecture comprises four layers:
|
|
367
|
+
|
|
368
|
+
```
|
|
369
|
+
┌─────────────────────────────────────────────┐
|
|
370
|
+
│ Human Interface Layer │
|
|
371
|
+
│ (IDE integration, chat, review interface) │
|
|
372
|
+
├─────────────────────────────────────────────┤
|
|
373
|
+
│ Governance Layer │
|
|
374
|
+
│ (Contracts, receipts, escalation logic) │
|
|
375
|
+
├─────────────────────────────────────────────┤
|
|
376
|
+
│ Agent Layer │
|
|
377
|
+
│ (Model interface, tier routing, gates) │
|
|
378
|
+
├─────────────────────────────────────────────┤
|
|
379
|
+
│ Artifact Layer │
|
|
380
|
+
│ (Files, VCS, structured storage) │
|
|
381
|
+
└─────────────────────────────────────────────┘
|
|
382
|
+
```
|
|
383
|
+
|
|
384
|
+
### 4.2 Governance Layer
|
|
385
|
+
|
|
386
|
+
The governance layer is the novel contribution. It:
|
|
387
|
+
|
|
388
|
+
1. **Loads contracts** from version-controlled files (`.lex/rules/*.yaml`)
|
|
389
|
+
2. **Validates compliance** before and after agent actions
|
|
390
|
+
3. **Generates receipts** documenting decisions and outcomes
|
|
391
|
+
4. **Manages escalation** when uncertainty exceeds thresholds
|
|
392
|
+
5. **Tracks Turn Cost** components for optimization
|
|
393
|
+
|
|
394
|
+
Contracts are ingested at session start and validated incrementally. Violations trigger immediate feedback (not deferred to human review).
|
|
395
|
+
|
|
396
|
+
### 4.3 Agent Layer
|
|
397
|
+
|
|
398
|
+
The agent layer is deliberately thin:
|
|
399
|
+
|
|
400
|
+
- Routes tasks to appropriate capability tier
|
|
401
|
+
- Provides model-agnostic interface (same governance works across providers)
|
|
402
|
+
- Enforces gate checks (lint, type, test) before accepting output
|
|
403
|
+
- Does not maintain internal session state beyond current turn
|
|
404
|
+
|
|
405
|
+
This thinness is intentional: complexity in the agent layer tends to be brittle, provider-specific, and hard to audit. We push complexity into the governance layer where it can be versioned and tested.
|
|
406
|
+
|
|
407
|
+
### 4.4 Artifact Layer
|
|
408
|
+
|
|
409
|
+
All state lives in the artifact layer:
|
|
410
|
+
|
|
411
|
+
- **Contracts**: Governance specifications
|
|
412
|
+
- **Receipts**: Decision logs, action records
|
|
413
|
+
- **Frames**: Episodic memory (what happened, what was learned)
|
|
414
|
+
- **Code**: The actual work product
|
|
415
|
+
|
|
416
|
+
This design choice supports cross-model continuity: when switching models, only the agent layer changes. Governance and artifacts persist.
|
|
417
|
+
|
|
418
|
+
---
|
|
419
|
+
|
|
420
|
+
## 5. Case Study: The Robert Experiment
|
|
421
|
+
|
|
422
|
+
### 5.1 Experimental Design
|
|
423
|
+
|
|
424
|
+
To provide preliminary validation of our framework, we conducted a controlled experiment in late 2025.
|
|
425
|
+
|
|
426
|
+
**Setup:**
|
|
427
|
+
|
|
428
|
+
- "Robert" was a minimal agent with:
|
|
429
|
+
- On-disk memory (file-based storage)
|
|
430
|
+
- A single contracts file (~1.2KB, reproduced in Appendix A)
|
|
431
|
+
- Standard model API access (no custom tooling)
|
|
432
|
+
|
|
433
|
+
- Robert explicitly lacked:
|
|
434
|
+
- Sophisticated orchestration
|
|
435
|
+
- Custom memory systems
|
|
436
|
+
- Provider-specific features
|
|
437
|
+
- Complex tool chains
|
|
438
|
+
|
|
439
|
+
**Models used:**
|
|
440
|
+
|
|
441
|
+
- GPT-5.1 as "Lex" (primary implementation)
|
|
442
|
+
- Claude Sonnet 4.5 as "Claude" (cross-model validation)
|
|
443
|
+
- Claude Haiku 4.5 as "Ku" (low-tier verification)
|
|
444
|
+
|
|
445
|
+
_Note: Model names reflect those available at time of experiment (late 2025)._
|
|
446
|
+
|
|
447
|
+
**Tasks:**
|
|
448
|
+
|
|
449
|
+
1. Implement OAuth2 PKCE flow (feature implementation)
|
|
450
|
+
2. Design a reusable form validation component (API design)
|
|
451
|
+
3. Continue interrupted work from previous session (continuity test)
|
|
452
|
+
|
|
453
|
+
### 5.2 Measurements
|
|
454
|
+
|
|
455
|
+
We measured Turn Cost components and compared to a baseline (same tasks, same models, no governance contracts). _Tokens per feature_ measures total API tokens consumed to complete a task, including all turns.
|
|
456
|
+
|
|
457
|
+
| Metric | Robert (with contracts) | Baseline (no contracts) | Δ |
|
|
458
|
+
| -------------------- | ----------------------- | ----------------------- | ---- |
|
|
459
|
+
| Turns per PR | 2.3 | 6.1 | -62% |
|
|
460
|
+
| Renegotiation rate | 8% | 34% | -76% |
|
|
461
|
+
| Context reset tokens | 180 | 650 | -72% |
|
|
462
|
+
| Human interventions | 2 | 11 | -82% |
|
|
463
|
+
| Tokens per feature | 12,400 | 28,600 | -57% |
|
|
464
|
+
|
|
465
|
+
### 5.3 Observations
|
|
466
|
+
|
|
467
|
+
**Cross-model continuity:** When switching from GPT-5.1 (Lex) to Claude Sonnet 4.5 (Claude) mid-task:
|
|
468
|
+
|
|
469
|
+
- Claude read receipts left by GPT-5
|
|
470
|
+
- No re-briefing was required
|
|
471
|
+
- Work quality remained consistent
|
|
472
|
+
- Context restored in ~200 tokens (vs. ~650 in baseline)
|
|
473
|
+
|
|
474
|
+
**Uncertainty handling:** Robert expressed uncertainty multiple times:
|
|
475
|
+
|
|
476
|
+
- "Not sure if 80% TTL is optimal for token refresh"
|
|
477
|
+
- "This regex may not handle all international formats"
|
|
478
|
+
|
|
479
|
+
Each uncertainty was documented in receipts, accompanied by reversible implementation, and flagged for review. No uncertainty caused project delays or cascading failures.
|
|
480
|
+
|
|
481
|
+
**Governance sufficiency:** The 1.2KB contracts file was sufficient for:
|
|
482
|
+
|
|
483
|
+
- Keeping agent aligned with project expectations
|
|
484
|
+
- Enabling productive work without constant supervision
|
|
485
|
+
- Maintaining quality standards across sessions and models
|
|
486
|
+
|
|
487
|
+
### 5.4 Limitations and Threats to Validity
|
|
488
|
+
|
|
489
|
+
We explicitly acknowledge significant limitations:
|
|
490
|
+
|
|
491
|
+
**Internal validity:**
|
|
492
|
+
|
|
493
|
+
- N=1 (single case study)
|
|
494
|
+
- Potential Hawthorne effect (experimenter was also the human collaborator)
|
|
495
|
+
- No randomization of task order or model assignment
|
|
496
|
+
- Baseline was constructed, not a true A/B test
|
|
497
|
+
|
|
498
|
+
**External validity:**
|
|
499
|
+
|
|
500
|
+
- Single domain (TypeScript/Node.js software engineering)
|
|
501
|
+
- Highly skilled human operator (may not generalize to novices)
|
|
502
|
+
- Codebase was moderately well-structured (may not generalize to legacy systems)
|
|
503
|
+
- Tasks were chosen to be representative, but selection bias is possible
|
|
504
|
+
|
|
505
|
+
**Construct validity:**
|
|
506
|
+
|
|
507
|
+
- Turn Cost components measured via logs, not independent observation
|
|
508
|
+
- "Human interventions" operationalized as git commits with human-authored changes, may miss other forms
|
|
509
|
+
|
|
510
|
+
**What we can and cannot claim:**
|
|
511
|
+
|
|
512
|
+
- ✓ Feasibility: The architecture is implementable
|
|
513
|
+
- ✓ Measurable effects: Turn Cost metrics changed in the predicted direction
|
|
514
|
+
- ✗ Generalizability: Unknown without broader replication
|
|
515
|
+
- ✗ Causality: Confounds not controlled
|
|
516
|
+
|
|
517
|
+
We present this as hypothesis-generating, not hypothesis-confirming evidence.
|
|
518
|
+
|
|
519
|
+
---
|
|
520
|
+
|
|
521
|
+
## 6. Evaluation Framework
|
|
522
|
+
|
|
523
|
+
### 6.1 Operationalizing Turn Cost
|
|
524
|
+
|
|
525
|
+
For practical deployment, we propose measuring:
|
|
526
|
+
|
|
527
|
+
**Primary metrics:**
|
|
528
|
+
|
|
529
|
+
- `turn_count`: Number of human–agent interaction cycles per task
|
|
530
|
+
- `renegotiation_rate`: Proportion of turns that are clarification-only
|
|
531
|
+
- `context_reset_tokens`: Tokens required after session/model boundaries
|
|
532
|
+
- `escalation_rate`: Proportion of tasks requiring tier upgrade
|
|
533
|
+
|
|
534
|
+
**Derived metrics:**
|
|
535
|
+
$$\text{EffectiveTurnCost} = w_1 \cdot \text{turn\_count} + w_2 \cdot \text{renegotiation\_rate} + w_3 \cdot \frac{\text{context\_reset\_tokens}}{100}$$
|
|
536
|
+
|
|
537
|
+
Weights should be calibrated per-organization based on relative costs.
|
|
538
|
+
|
|
539
|
+
### 6.2 Economic Analysis
|
|
540
|
+
|
|
541
|
+
The economic case for coordination cost compression:
|
|
542
|
+
|
|
543
|
+
**Traditional optimization (reduce token cost):**
|
|
544
|
+
|
|
545
|
+
- Assume 10% token reduction through better prompting
|
|
546
|
+
- At $0.03/1K tokens, 10K tokens/task: saves $0.03/task
|
|
547
|
+
- At 100 tasks/month: $3 savings
|
|
548
|
+
|
|
549
|
+
**Coordination cost optimization (reduce Turn Cost):**
|
|
550
|
+
|
|
551
|
+
- Assume 50% reduction in turns (our case study showed 62%)
|
|
552
|
+
- At 5 min/turn human time, $50/hr human cost: each turn costs $4.17
|
|
553
|
+
- At 6 turns/task baseline → 3 turns: saves $12.50/task
|
|
554
|
+
- At 100 tasks/month: $1,250 savings
|
|
555
|
+
|
|
556
|
+
The 400:1 ratio suggests coordination cost is the higher-leverage optimization target.
|
|
557
|
+
|
|
558
|
+
#### 6.2.1 Model Assumptions and Sensitivity Analysis
|
|
559
|
+
|
|
560
|
+
The above analysis rests on several assumptions that warrant examination:
|
|
561
|
+
|
|
562
|
+
**Key assumptions:**
|
|
563
|
+
|
|
564
|
+
| Assumption | Value Used | Range in Practice | Sensitivity |
|
|
565
|
+
| ----------------- | ---------- | ----------------- | ------------- |
|
|
566
|
+
| Human hourly rate | $50/hr | $25–$200/hr | Linear impact |
|
|
567
|
+
| Time per turn | 5 min | 2–15 min | Linear impact |
|
|
568
|
+
| Token cost | $0.03/1K | $0.001–$0.10/1K | Low impact |
|
|
569
|
+
| Turn reduction | 50% | 20–70% | Linear impact |
|
|
570
|
+
| Task frequency | 100/month | 10–1000/month | Linear impact |
|
|
571
|
+
|
|
572
|
+
**Sensitivity to human cost:** At $25/hr (junior developer), the coordination savings fall to $625/month, ratio ~208:1 vs. token optimization. At $200/hr (senior consultant), coordination savings rise to $5,000/month, ratio ~1,667:1. The directionality of our recommendation holds across the realistic range.
|
|
573
|
+
|
|
574
|
+
**Sensitivity to turn reduction:** If governance achieves only 20% turn reduction (conservative), coordination savings fall to $500/month—still ~167:1 vs. token optimization. Below ~5% turn reduction, the investment in governance infrastructure may not pay back.
|
|
575
|
+
|
|
576
|
+
**Boundary conditions where our model weakens:**
|
|
577
|
+
|
|
578
|
+
1. **High-volume, low-touch tasks:** For tasks requiring <2 turns baseline, coordination overhead is already minimal; token optimization may dominate.
|
|
579
|
+
|
|
580
|
+
2. **Extremely low human cost:** In contexts where human attention cost approaches zero (e.g., hobbyist projects with unlimited time), token cost becomes proportionally more important.
|
|
581
|
+
|
|
582
|
+
3. **Rapidly changing token economics:** If token costs drop by 10× (as they have historically), the ratio shifts—but human costs have not shown comparable compression.
|
|
583
|
+
|
|
584
|
+
**Not modeled:** This analysis excludes governance creation and maintenance costs. A complete economic analysis would amortize contract development (~4 hours initial, ~30 min/week maintenance) over task volume. For teams completing >50 tasks/month, amortized governance cost is <$2/task.
|
|
585
|
+
|
|
586
|
+
### 6.3 What Would Falsify This Framework?
|
|
587
|
+
|
|
588
|
+
A framework's value lies partly in its falsifiability. Our framework would be challenged by:
|
|
589
|
+
|
|
590
|
+
1. **Evidence that model capability dominates:** If controlled studies showed that model choice explains >80% of variance in productivity while governance explains <10%, our thesis would be weakened.
|
|
591
|
+
|
|
592
|
+
2. **Governance overhead exceeding benefits:** If contract creation/maintenance costs exceed Turn Cost reductions, the architecture is not cost-effective.
|
|
593
|
+
|
|
594
|
+
3. **Ceiling effects:** If well-prompted ungoverned agents achieve similar Turn Cost metrics, governance adds complexity without benefit.
|
|
595
|
+
|
|
596
|
+
4. **Scalability failures:** If governance contracts become unwieldy beyond ~10 rules, the architecture doesn't scale.
|
|
597
|
+
|
|
598
|
+
We do not yet have data to rule out these alternatives.
|
|
599
|
+
|
|
600
|
+
### 6.4 Methodological Recommendations for Replication
|
|
601
|
+
|
|
602
|
+
To support rigorous testing of our framework, we propose the following experimental designs:
|
|
603
|
+
|
|
604
|
+
#### 6.4.1 Controlled Comparison Study
|
|
605
|
+
|
|
606
|
+
**Design:** Within-subjects, counterbalanced A/B comparison.
|
|
607
|
+
|
|
608
|
+
**Participants:** 20+ software engineers with varying LLM experience.
|
|
609
|
+
|
|
610
|
+
**Conditions:**
|
|
611
|
+
|
|
612
|
+
- A: Governance-first (contracts, receipts, tiers)
|
|
613
|
+
- B: Standard prompting (well-crafted but no governance artifacts)
|
|
614
|
+
|
|
615
|
+
**Tasks:** Standardized set of 10 software engineering tasks (bug fixes, feature additions, refactoring) across multiple complexity levels.
|
|
616
|
+
|
|
617
|
+
**Measurements:**
|
|
618
|
+
|
|
619
|
+
- Primary: Turns per task, renegotiation rate, context reset tokens
|
|
620
|
+
- Secondary: Task completion rate, code quality (automated metrics), participant satisfaction
|
|
621
|
+
- Covariates: Prior LLM experience, programming expertise, task complexity rating
|
|
622
|
+
|
|
623
|
+
**Controls:**
|
|
624
|
+
|
|
625
|
+
- Same model for both conditions
|
|
626
|
+
- Randomized task order
|
|
627
|
+
- Counterbalanced condition order across participants
|
|
628
|
+
- Independent coding of "renegotiation" by multiple raters
|
|
629
|
+
|
|
630
|
+
**Statistical approach:** Mixed-effects regression with participant and task as random effects, condition as fixed effect.
|
|
631
|
+
|
|
632
|
+
**Power analysis:** To detect a 30% reduction in turns (our conservative estimate), with α=0.05 and power=0.80, requires N=18 participants completing 8 tasks each.
|
|
633
|
+
|
|
634
|
+
#### 6.4.2 Longitudinal Case Studies
|
|
635
|
+
|
|
636
|
+
**Design:** Multiple-case, multiple-team observational study.
|
|
637
|
+
|
|
638
|
+
**Participants:** 3–5 development teams adopting governance framework.
|
|
639
|
+
|
|
640
|
+
**Duration:** 6 months minimum, with measurements at baseline, 1 month, 3 months, 6 months.
|
|
641
|
+
|
|
642
|
+
**Measurements:**
|
|
643
|
+
|
|
644
|
+
- Quantitative: Turn Cost components (logged automatically)
|
|
645
|
+
- Qualitative: Team interviews, governance artifact evolution, escalation patterns
|
|
646
|
+
|
|
647
|
+
**Analysis:** Cross-case synthesis, time-series analysis of Turn Cost trends.
|
|
648
|
+
|
|
649
|
+
#### 6.4.3 Ablation Studies
|
|
650
|
+
|
|
651
|
+
To isolate the contribution of each governance component:
|
|
652
|
+
|
|
653
|
+
| Study | Manipulated Component | Prediction |
|
|
654
|
+
| ----- | ---------------------------------- | -------------------------------------------- |
|
|
655
|
+
| A1 | Contracts only (no receipts) | Partial Turn Cost reduction |
|
|
656
|
+
| A2 | Receipts only (no contracts) | Improved continuity, unchanged renegotiation |
|
|
657
|
+
| A3 | Tiers only (no contracts/receipts) | Reduced escalation overhead |
|
|
658
|
+
| A4 | Full governance | Maximum Turn Cost reduction |
|
|
659
|
+
|
|
660
|
+
**Prediction:** Full governance > sum of individual components (interaction effects from coherent system).
|
|
661
|
+
|
|
662
|
+
#### 6.4.4 Minimum Viable Replication
|
|
663
|
+
|
|
664
|
+
For researchers with limited resources, a minimal replication protocol:
|
|
665
|
+
|
|
666
|
+
1. **Sample:** 5 participants, 5 tasks each
|
|
667
|
+
2. **Conditions:** Governance vs. standard (within-subjects)
|
|
668
|
+
3. **Metrics:** Turn count, self-reported renegotiation, total time
|
|
669
|
+
4. **Analysis:** Paired t-test or Wilcoxon signed-rank
|
|
670
|
+
|
|
671
|
+
Even N=5 with moderate effect size (d=0.8) achieves power=0.70, sufficient for preliminary replication.
|
|
672
|
+
|
|
673
|
+
---
|
|
674
|
+
|
|
675
|
+
## 7. Discussion
|
|
676
|
+
|
|
677
|
+
### 7.1 Theoretical Implications
|
|
678
|
+
|
|
679
|
+
If coordination cost compression is indeed a productive axis for human–AI system design, several implications follow:
|
|
680
|
+
|
|
681
|
+
**For researchers:** Benchmarks should include coordination metrics (turns, renegotiations, context resets), not just task completion accuracy. A model that completes 95% of tasks but requires 10 turns per task may be less practical than one completing 90% in 2 turns.
|
|
682
|
+
|
|
683
|
+
**For practitioners:** Investment in governance infrastructure may yield higher returns than investment in model upgrades. The marginal cost of better prompts decreases; the marginal cost of governance scales linearly with artifact maintenance.
|
|
684
|
+
|
|
685
|
+
**For model developers:** Features supporting explicit governance (structured constraint ingestion, receipt generation, uncertainty expression) may be more valuable than raw capability improvements.
|
|
686
|
+
|
|
687
|
+
### 7.2 Relationship to Other Approaches
|
|
688
|
+
|
|
689
|
+
**Prompt engineering:** Governance primitives can be seen as structured, versionable, testable prompt engineering. The key difference is persistence and auditability.
|
|
690
|
+
|
|
691
|
+
**Fine-tuning:** Governance operates at inference time and requires no model modification. It is complementary to, not competitive with, fine-tuning approaches.
|
|
692
|
+
|
|
693
|
+
**Multi-agent debate:** Our architecture supports multi-agent configurations but doesn't require them. Governance coordinates human–agent and agent–agent interactions uniformly.
|
|
694
|
+
|
|
695
|
+
**Retrieval-augmented generation (RAG):** Governance is orthogonal to RAG. Contracts specify _how_ retrieved information should be used, not _what_ information to retrieve.
|
|
696
|
+
|
|
697
|
+
### 7.3 Challenges and Open Problems
|
|
698
|
+
|
|
699
|
+
Our architecture faces several significant challenges that warrant further research:
|
|
700
|
+
|
|
701
|
+
#### 7.3.1 Contract Evolution and Drift
|
|
702
|
+
|
|
703
|
+
How do contracts co-evolve with codebases? We currently rely on manual updates; automated drift detection is an open problem.
|
|
704
|
+
|
|
705
|
+
Specific challenges:
|
|
706
|
+
|
|
707
|
+
- **Staleness detection:** Contracts may reference patterns or files that no longer exist
|
|
708
|
+
- **Implicit constraint violations:** Code changes may satisfy the letter of contracts while violating their spirit
|
|
709
|
+
- **Version synchronization:** When contracts span multiple repositories or systems, consistency is difficult to maintain
|
|
710
|
+
|
|
711
|
+
Potential research directions include static analysis of contract–code alignment and LLM-assisted contract validation.
|
|
712
|
+
|
|
713
|
+
#### 7.3.2 Tier Assignment and Task Classification
|
|
714
|
+
|
|
715
|
+
Matching tasks to capability tiers currently requires human judgment. Automated task classification would improve scalability.
|
|
716
|
+
|
|
717
|
+
The core challenge is that task complexity is multi-dimensional:
|
|
718
|
+
|
|
719
|
+
- _Technical complexity_: depth of domain knowledge required
|
|
720
|
+
- _Coordination complexity_: number of stakeholders and dependencies
|
|
721
|
+
- _Ambiguity_: clarity of success criteria
|
|
722
|
+
- _Risk_: potential impact of errors
|
|
723
|
+
|
|
724
|
+
A comprehensive tier assignment system would need to model all four dimensions, likely requiring task-specific training data.
|
|
725
|
+
|
|
726
|
+
#### 7.3.3 Cross-Organization Generalization
|
|
727
|
+
|
|
728
|
+
Our contracts are project-specific. Domain-general governance patterns remain to be identified.
|
|
729
|
+
|
|
730
|
+
Questions include:
|
|
731
|
+
|
|
732
|
+
- Are there universal invariants (e.g., "never delete production data") that transfer across domains?
|
|
733
|
+
- Can contracts be parameterized or templated for reuse?
|
|
734
|
+
- What level of abstraction balances generalization with practical utility?
|
|
735
|
+
|
|
736
|
+
#### 7.3.4 Security and Adversarial Robustness
|
|
737
|
+
|
|
738
|
+
Malicious contracts could in principle encode harmful behavior. Contract validation and sandboxing are necessary but not yet formalized.
|
|
739
|
+
|
|
740
|
+
Attack surfaces include:
|
|
741
|
+
|
|
742
|
+
- **Injection attacks:** Contracts containing prompts that override safety guidelines
|
|
743
|
+
- **Exfiltration:** Contracts that direct agents to leak sensitive information through receipts
|
|
744
|
+
- **Denial of service:** Contracts with contradictory constraints that cause infinite loops
|
|
745
|
+
|
|
746
|
+
Mitigation strategies require formal verification techniques adapted for natural language constraints—a nascent research area.
|
|
747
|
+
|
|
748
|
+
#### 7.3.5 Relationship to AI Alignment
|
|
749
|
+
|
|
750
|
+
Our governance architecture operates at the _behavioral_ level, specifying what agents should do rather than what they should value. This is complementary to, but distinct from, AI alignment research concerned with goal specification and value learning.
|
|
751
|
+
|
|
752
|
+
Key tensions:
|
|
753
|
+
|
|
754
|
+
- **Interpretability:** Governance assumes agents can interpret and follow constraints. If models develop subtle misinterpretations, governance may provide false assurance.
|
|
755
|
+
- **Capability amplification risk:** Better coordination may enable more capable systems, potentially amplifying alignment failures.
|
|
756
|
+
- **Human oversight sufficiency:** We assume humans can verify agent outputs. As tasks grow more complex, this assumption weakens.
|
|
757
|
+
|
|
758
|
+
We do not claim governance solves alignment. We claim it addresses a different problem (coordination) that becomes increasingly important as alignment research matures.
|
|
759
|
+
|
|
760
|
+
#### 7.3.6 Cognitive Floor Effects
|
|
761
|
+
|
|
762
|
+
There may exist a "cognitive floor" below which governance cannot improve performance—a minimum model capability required to interpret and follow contracts. Preliminary observations suggest this floor is lower than expected (mid-tier models follow simple contracts reliably), but systematic mapping of capability requirements is needed.
|
|
763
|
+
|
|
764
|
+
### 7.4 Ethical Considerations
|
|
765
|
+
|
|
766
|
+
We have endeavored to be honest about limitations and avoid overclaiming. Specific ethical notes:
|
|
767
|
+
|
|
768
|
+
- We do not claim AI "consciousness" or "understanding"; our framework treats agents as sophisticated tools.
|
|
769
|
+
- We acknowledge that productivity gains may affect labor markets; we do not offer policy recommendations.
|
|
770
|
+
- Human oversight remains essential in our architecture; we are not proposing autonomous operation.
|
|
771
|
+
- The framework could in principle be misused (e.g., governance that encodes harmful goals); this is true of any infrastructure and requires ongoing attention.
|
|
772
|
+
|
|
773
|
+
---
|
|
774
|
+
|
|
775
|
+
## 8. Limitations
|
|
776
|
+
|
|
777
|
+
Beyond those noted in §5.4, we acknowledge:
|
|
778
|
+
|
|
779
|
+
1. **Single-author development:** The architecture was developed primarily by one team. Independent replication is needed.
|
|
780
|
+
|
|
781
|
+
2. **Software engineering scope:** Generalization to other domains (content creation, research, customer service) is unknown.
|
|
782
|
+
|
|
783
|
+
3. **LLM generation specificity:** Current LLMs may have properties that make governance particularly effective (e.g., high instruction-following fidelity). Future model architectures may differ.
|
|
784
|
+
|
|
785
|
+
4. **Measurement challenges:** Turn Cost components (especially Attention Switch) are difficult to measure precisely. Our operationalizations may miss important variance.
|
|
786
|
+
|
|
787
|
+
5. **Selection effects:** Practitioners who adopt explicit governance may differ systematically from those who don't, confounding comparisons.
|
|
788
|
+
|
|
789
|
+
---
|
|
790
|
+
|
|
791
|
+
## 9. Conclusion
|
|
792
|
+
|
|
793
|
+
We have proposed _coordination cost compression_ as an organizing principle for human–AI collaborative systems, contrasting it with the dominant _capability amplification_ paradigm. We introduced formal constructs—Turn Cost, environmental hostility, governance primitives—and described an architecture that operationalizes these concepts.
|
|
794
|
+
|
|
795
|
+
Preliminary evidence from a case study suggests the approach is feasible and produces measurable effects in the predicted direction. However, this evidence is limited, and substantial work remains:
|
|
796
|
+
|
|
797
|
+
- Controlled experiments with multiple teams and tasks
|
|
798
|
+
- Cross-domain replication
|
|
799
|
+
- Longitudinal studies of governance evolution
|
|
800
|
+
- Tooling for governance authoring and validation
|
|
801
|
+
- Theoretical refinement based on empirical findings
|
|
802
|
+
|
|
803
|
+
We offer this framework not as a solution but as a hypothesis: that human–AI collaboration is primarily a coordination problem, not a capability problem, and that explicit governance is a tractable intervention. We invite others to test, extend, challenge, and refine this hypothesis.
|
|
804
|
+
|
|
805
|
+
---
|
|
806
|
+
|
|
807
|
+
## References
|
|
808
|
+
|
|
809
|
+
[1] Brown, T., et al. (2020). "Language Models are Few-Shot Learners." _NeurIPS 2020_.
|
|
810
|
+
|
|
811
|
+
[2] OpenAI. (2023). "GPT-4 Technical Report." arXiv:2303.08774.
|
|
812
|
+
|
|
813
|
+
[3] Anthropic. (2024). "The Claude 3 Model Family." Technical Report.
|
|
814
|
+
|
|
815
|
+
[4] Zamfirescu-Pereira, J. D., et al. (2023). "Why Johnny Can't Prompt: How Non-AI Experts Try (and Fail) to Design LLM Prompts." _CHI '23_.
|
|
816
|
+
|
|
817
|
+
[5] Wooldridge, M. (2009). _An Introduction to MultiAgent Systems_. Wiley.
|
|
818
|
+
|
|
819
|
+
[6] Shoham, Y., & Leyton-Brown, K. (2008). _Multiagent Systems: Algorithmic, Game-Theoretic, and Logical Foundations_. Cambridge University Press.
|
|
820
|
+
|
|
821
|
+
[7] Jennings, N. R. (2000). "On Agent-Based Software Engineering." _Artificial Intelligence_ 117(2).
|
|
822
|
+
|
|
823
|
+
[8] Tran, K.-T., et al. (2025). "Multi-Agent Collaboration Mechanisms: A Survey of LLMs." arXiv:2501.06322.
|
|
824
|
+
|
|
825
|
+
[9] Wang, L., et al. (2024). "A Survey on Large Language Model based Autonomous Agents." _Frontiers of Computer Science_.
|
|
826
|
+
|
|
827
|
+
[10] Noy, S., & Zhang, W. (2023). "Experimental Evidence on the Productivity Effects of Generative Artificial Intelligence." _Science_ 381(6654).
|
|
828
|
+
|
|
829
|
+
[11] Bansal, G., et al. (2021). "Does the Whole Exceed its Parts? The Effect of AI Explanations on Complementary Team Performance." _CHI '21_.
|
|
830
|
+
|
|
831
|
+
[12] Bainbridge, L. (1983). "Ironies of Automation." _Automatica_ 19(6).
|
|
832
|
+
|
|
833
|
+
[13] Gaube, S., et al. (2021). "Do as AI say: susceptibility in deployment of clinical decision-aids." _NPJ Digital Medicine_ 4(1).
|
|
834
|
+
|
|
835
|
+
[14] Malone, T. W., & Crowston, K. (1994). "The Interdisciplinary Study of Coordination." _ACM Computing Surveys_ 26(1).
|
|
836
|
+
|
|
837
|
+
[15] Wei, J., et al. (2022). "Chain-of-Thought Prompting Elicits Reasoning in Large Language Models." _NeurIPS 2022_.
|
|
838
|
+
|
|
839
|
+
[16] Schick, T., et al. (2023). "Toolformer: Language Models Can Teach Themselves to Use Tools." arXiv:2302.04761.
|
|
840
|
+
|
|
841
|
+
[17] Du, Y., et al. (2023). "Improving Factuality and Reasoning in Language Models through Multiagent Debate." arXiv:2305.14325.
|
|
842
|
+
|
|
843
|
+
[18] Schulhoff, S., et al. (2023). "Ignore This Title and HackAPrompt: Exposing Systemic Vulnerabilities of LLMs through a Global Scale Prompt Hacking Competition." arXiv:2311.16119.
|
|
844
|
+
|
|
845
|
+
---
|
|
846
|
+
|
|
847
|
+
## Appendix A: Robert's Contracts File
|
|
848
|
+
|
|
849
|
+
```yaml
|
|
850
|
+
# robert.contracts.yaml
|
|
851
|
+
# Size: ~1.2KB
|
|
852
|
+
|
|
853
|
+
session:
|
|
854
|
+
name: "Robert"
|
|
855
|
+
role: "Senior Implementation Engineer"
|
|
856
|
+
|
|
857
|
+
constraints:
|
|
858
|
+
must:
|
|
859
|
+
- "Follow existing patterns in neighboring code"
|
|
860
|
+
- "Propose minimal, coherent diffs"
|
|
861
|
+
- "Add test coverage for new functionality"
|
|
862
|
+
- "Create reversible changes when uncertain"
|
|
863
|
+
|
|
864
|
+
must_not:
|
|
865
|
+
- "Force push"
|
|
866
|
+
- "Bypass CI"
|
|
867
|
+
- "Merge to protected branches"
|
|
868
|
+
- "Generate git commit in test code"
|
|
869
|
+
|
|
870
|
+
permissions:
|
|
871
|
+
can:
|
|
872
|
+
- "Create and modify files in src/"
|
|
873
|
+
- "Create and modify test files"
|
|
874
|
+
- "Read any file in repository"
|
|
875
|
+
|
|
876
|
+
cannot:
|
|
877
|
+
- "Modify CONTRACT.md files"
|
|
878
|
+
- "Change canon/ directory"
|
|
879
|
+
- "Access production credentials"
|
|
880
|
+
|
|
881
|
+
uncertainty:
|
|
882
|
+
allowed: true
|
|
883
|
+
expression: "State uncertainty openly in comments"
|
|
884
|
+
actions:
|
|
885
|
+
- "Make reversible moves when unsure"
|
|
886
|
+
- "Leave receipts of decisions"
|
|
887
|
+
- "Treat failure as data, not disaster"
|
|
888
|
+
|
|
889
|
+
receipts:
|
|
890
|
+
location: ".robert/receipts/"
|
|
891
|
+
format: "yaml"
|
|
892
|
+
required_fields:
|
|
893
|
+
- action
|
|
894
|
+
- timestamp
|
|
895
|
+
- files_affected
|
|
896
|
+
- rationale
|
|
897
|
+
- confidence
|
|
898
|
+
```
|
|
899
|
+
|
|
900
|
+
---
|
|
901
|
+
|
|
902
|
+
## Appendix B: Turn Cost Measurement Protocol
|
|
903
|
+
|
|
904
|
+
For replication, we measured Turn Cost components as follows:
|
|
905
|
+
|
|
906
|
+
| Component | Measurement Method |
|
|
907
|
+
| ---------------- | ------------------------------------------------------------------- |
|
|
908
|
+
| Latency | Timestamp difference between request send and response complete |
|
|
909
|
+
| Context Reset | Token count in first message after session/model boundary |
|
|
910
|
+
| Renegotiation | Binary flag: did this turn produce progress or only clarification? |
|
|
911
|
+
| Token Bloat | Difference between actual tokens and estimated minimum |
|
|
912
|
+
| Attention Switch | Time from response received to human action (git commit, next turn) |
|
|
913
|
+
|
|
914
|
+
"Progress" was operationalized as: code change, test addition, or documentation update accepted without reversion.
|
|
915
|
+
|
|
916
|
+
---
|
|
917
|
+
|
|
918
|
+
## Author's Note
|
|
919
|
+
|
|
920
|
+
This paper was co-authored by Joseph Gustavson (human, ORCID: 0009-0001-0669-0749) and AI collaborators: Claude Opus 4.5 from Anthropic (operating as "Opie") and GPT-5.1 from OpenAI (operating as "Lex").
|
|
921
|
+
|
|
922
|
+
**Attribution of contributions:**
|
|
923
|
+
|
|
924
|
+
- _Conceptual framework_: Developed collaboratively through extended dialogue (human + AI)
|
|
925
|
+
- _Case study design and execution_: Human-led, AI-assisted
|
|
926
|
+
- _Literature review_: AI-led with human curation and verification
|
|
927
|
+
- _Writing_: AI-drafted, human-reviewed and edited
|
|
928
|
+
- _Data collection_: Human (from logs and git history)
|
|
929
|
+
- _Critical evaluation_: Collaborative
|
|
930
|
+
|
|
931
|
+
**Statement of responsibility:**
|
|
932
|
+
|
|
933
|
+
Joseph Gustavson takes responsibility for:
|
|
934
|
+
|
|
935
|
+
- Accuracy of empirical claims
|
|
936
|
+
- Appropriateness of literature citations
|
|
937
|
+
- Ethical review and compliance
|
|
938
|
+
- Final editorial decisions
|
|
939
|
+
|
|
940
|
+
The AI collaborators cannot take legal or academic responsibility for the content. Their contributions are acknowledged as substantial but instrumentally authored.
|
|
941
|
+
|
|
942
|
+
**Conflict of interest:** The author is developing open-source tooling (Lex, lexrunner) based on the architecture described. This may create bias toward favorable interpretation of results.
|
|
943
|
+
|
|
944
|
+
**Data availability:** The contracts file (Appendix A) is fully reproduced. Raw logs from the case study will be made available upon reasonable request, subject to redaction of proprietary code.
|
|
945
|
+
|
|
946
|
+
---
|
|
947
|
+
|
|
948
|
+
_Submitted for consideration as working paper / preprint. Not yet peer-reviewed._
|
|
949
|
+
|
|
950
|
+
_Version: Draft 1.2, December 2025_
|
|
951
|
+
_Revision 1.1: Strengthened Turn Cost positioning, expanded challenges section, added economic sensitivity analysis, included methodological recommendations for replication._
|
|
952
|
+
_Revision 1.2: Corrected economic analysis arithmetic, updated model names to reflect actual availability, fixed citation metadata._
|