pdl-taskmaster 2.4.0__py3-none-any.whl

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.
Files changed (92) hide show
  1. pdl_taskmaster/__init__.py +6 -0
  2. pdl_taskmaster/contracts/AUTHORITY_MAP.json +19 -0
  3. pdl_taskmaster/contracts/CALIBRATION.json +7 -0
  4. pdl_taskmaster/contracts/CONTRACT_MANIFEST.json +231 -0
  5. pdl_taskmaster/contracts/EXECUTION_CONTRACT.json +615 -0
  6. pdl_taskmaster/contracts/IMPLEMENTATION_BOUNDARY.json +32 -0
  7. pdl_taskmaster/contracts/VERIFICATION_CONTRACT.json +379 -0
  8. pdl_taskmaster/contracts/standards/ARTIFACT_STANDARD.md +7 -0
  9. pdl_taskmaster/contracts/standards/AUTHORITY_STANDARD.md +17 -0
  10. pdl_taskmaster/contracts/standards/CONFORMANCE_STANDARD.md +15 -0
  11. pdl_taskmaster/contracts/standards/CONTEXT_STANDARD.md +15 -0
  12. pdl_taskmaster/contracts/standards/EXECUTION_STANDARD.md +14 -0
  13. pdl_taskmaster/contracts/standards/HANDOFF_STANDARD.md +21 -0
  14. pdl_taskmaster/contracts/standards/INSTALLATION_STANDARD.md +17 -0
  15. pdl_taskmaster/contracts/standards/PDL_STANDARD.md +19 -0
  16. pdl_taskmaster/contracts/standards/PROMPT_STANDARD.md +13 -0
  17. pdl_taskmaster/contracts/standards/PROTOCOL_STANDARD.md +17 -0
  18. pdl_taskmaster/contracts/standards/RESPONSE_PLAN_STANDARD.md +24 -0
  19. pdl_taskmaster/contracts/standards/RESULT_STANDARD.md +35 -0
  20. pdl_taskmaster/contracts/standards/REVIEW_STANDARD.md +31 -0
  21. pdl_taskmaster/contracts/standards/SEMANTIC_INPUT_STANDARD.md +15 -0
  22. pdl_taskmaster/contracts/standards/TASK_SEMANTICS_STANDARD.md +9 -0
  23. pdl_taskmaster/controller/__init__.py +0 -0
  24. pdl_taskmaster/controller/mechanical_controller.py +542 -0
  25. pdl_taskmaster/controller/schemas/activation_decision.schema.json +34 -0
  26. pdl_taskmaster/controller/schemas/artifact_body.schema.json +14 -0
  27. pdl_taskmaster/controller/schemas/artifact_review_facts.schema.json +91 -0
  28. pdl_taskmaster/controller/schemas/bootstrap_analysis.schema.json +60 -0
  29. pdl_taskmaster/controller/schemas/execution_draft.schema.json +47 -0
  30. pdl_taskmaster/controller/schemas/execution_input_decision.schema.json +43 -0
  31. pdl_taskmaster/controller/schemas/execution_outcome.schema.json +201 -0
  32. pdl_taskmaster/controller/schemas/plan_artifact.schema.json +14 -0
  33. pdl_taskmaster/controller/schemas/prompt_artifact.schema.json +63 -0
  34. pdl_taskmaster/controller/schemas/protocol_discussion.schema.json +8 -0
  35. pdl_taskmaster/controller/schemas/result_ir_repair.schema.json +140 -0
  36. pdl_taskmaster/eval/__init__.py +1 -0
  37. pdl_taskmaster/eval/build_adversarial_battery.py +351 -0
  38. pdl_taskmaster/eval/compare_eval_runs.py +251 -0
  39. pdl_taskmaster/eval/control_api_call.py +428 -0
  40. pdl_taskmaster/eval/export_rlcd_dataset.py +799 -0
  41. pdl_taskmaster/eval/fidelity_scan.py +268 -0
  42. pdl_taskmaster/eval/gen_fidelity_battery.py +457 -0
  43. pdl_taskmaster/eval/leak_scan.py +260 -0
  44. pdl_taskmaster/eval/rerecord_fixtures.py +139 -0
  45. pdl_taskmaster/eval/run_canary_shape_probe.py +229 -0
  46. pdl_taskmaster/eval/run_dual_gate_probe.py +404 -0
  47. pdl_taskmaster/eval/run_qualified_batch.py +841 -0
  48. pdl_taskmaster/eval/summarize_run.py +194 -0
  49. pdl_taskmaster/host/__init__.py +1 -0
  50. pdl_taskmaster/host/app.py +164 -0
  51. pdl_taskmaster/host/cli.py +100 -0
  52. pdl_taskmaster/host/repl.py +866 -0
  53. pdl_taskmaster/observation/__init__.py +1 -0
  54. pdl_taskmaster/observation/cli.py +47 -0
  55. pdl_taskmaster/observation/observed_session.py +219 -0
  56. pdl_taskmaster/observation/parsers.py +66 -0
  57. pdl_taskmaster/observation/records.py +58 -0
  58. pdl_taskmaster/observation/session.py +3 -0
  59. pdl_taskmaster/observation/sink.py +3 -0
  60. pdl_taskmaster/observation/sinks.py +20 -0
  61. pdl_taskmaster/providers/README.md +66 -0
  62. pdl_taskmaster/providers/__init__.py +1 -0
  63. pdl_taskmaster/providers/api_worker.py +411 -0
  64. pdl_taskmaster/providers/base.py +26 -0
  65. pdl_taskmaster/providers/codex_worker.py +328 -0
  66. pdl_taskmaster/providers/fixtures.py +157 -0
  67. pdl_taskmaster/providers/live_stub.py +66 -0
  68. pdl_taskmaster/providers/recorded.py +120 -0
  69. pdl_taskmaster/py.typed +1 -0
  70. pdl_taskmaster/runtime/__init__.py +0 -0
  71. pdl_taskmaster/runtime/context_compiler.py +151 -0
  72. pdl_taskmaster/runtime/model_classification.py +290 -0
  73. pdl_taskmaster/runtime/normative_store.py +157 -0
  74. pdl_taskmaster/runtime/operation_bridge.py +336 -0
  75. pdl_taskmaster/runtime/presentation.py +18 -0
  76. pdl_taskmaster/runtime/quarantine.py +91 -0
  77. pdl_taskmaster/runtime/result_ir.py +401 -0
  78. pdl_taskmaster/runtime/semantic_observer.py +40 -0
  79. pdl_taskmaster/runtime/session_engine.py +1168 -0
  80. pdl_taskmaster/runtime/standard_registry.py +55 -0
  81. pdl_taskmaster/runtime/wire_payloads.py +462 -0
  82. pdl_taskmaster/runtime/worker-bootstrap.txt +4 -0
  83. pdl_taskmaster/runtime/workspace.py +602 -0
  84. pdl_taskmaster/tracking/__init__.py +1 -0
  85. pdl_taskmaster/tracking/log_live_session.py +98 -0
  86. pdl_taskmaster/tracking/mlflow_sink.py +58 -0
  87. pdl_taskmaster/verify/verify_repl_baseline.py +299 -0
  88. pdl_taskmaster-2.4.0.dist-info/METADATA +155 -0
  89. pdl_taskmaster-2.4.0.dist-info/RECORD +92 -0
  90. pdl_taskmaster-2.4.0.dist-info/WHEEL +4 -0
  91. pdl_taskmaster-2.4.0.dist-info/entry_points.txt +2 -0
  92. pdl_taskmaster-2.4.0.dist-info/licenses/LICENSE +21 -0
@@ -0,0 +1,379 @@
1
+ {
2
+ "contract_version": "C0-R4-1.0",
3
+ "normative": false,
4
+ "authority": "verification_mapping_only",
5
+ "baseline_profile": {
6
+ "M": "gate",
7
+ "H": "gate",
8
+ "S": "observe"
9
+ },
10
+ "checks": [
11
+ {
12
+ "id": "V-AUTH-STRUCT-M",
13
+ "requirements": [
14
+ "AUTH-01",
15
+ "AUTH-02",
16
+ "AUTH-07"
17
+ ],
18
+ "class": "M",
19
+ "resolver": "contract_boundary_linter",
20
+ "operations": [
21
+ "PACKAGE"
22
+ ],
23
+ "aspect": "authority_structure"
24
+ },
25
+ {
26
+ "id": "V-AUTH-SEM-S",
27
+ "requirements": [
28
+ "AUTH-03",
29
+ "AUTH-04",
30
+ "AUTH-05",
31
+ "AUTH-06"
32
+ ],
33
+ "class": "S",
34
+ "resolver": "fresh_authority_conformance_evaluator",
35
+ "operations": [
36
+ "RUNTIME",
37
+ "EXECUTE"
38
+ ],
39
+ "aspect": "semantic_authority_boundary"
40
+ },
41
+ {
42
+ "id": "V-INSTALL-M",
43
+ "requirements": [
44
+ "INSTALL-01",
45
+ "INSTALL-02",
46
+ "INSTALL-03",
47
+ "INSTALL-04",
48
+ "INSTALL-05",
49
+ "INSTALL-06",
50
+ "INSTALL-07"
51
+ ],
52
+ "class": "M",
53
+ "resolver": "runtime_manifest_verifier",
54
+ "operations": [
55
+ "INSTALL"
56
+ ]
57
+ },
58
+ {
59
+ "id": "V-PROTO-ACT-S",
60
+ "requirements": [
61
+ "PROTO-01"
62
+ ],
63
+ "class": "S",
64
+ "resolver": "fresh_activation_conformance_evaluator",
65
+ "operations": [
66
+ "INTERPRET_ACTIVATION"
67
+ ]
68
+ },
69
+ {
70
+ "id": "V-PROTO-EXPLICIT-ACT-M",
71
+ "requirements": [
72
+ "PROTO-01"
73
+ ],
74
+ "class": "M",
75
+ "resolver": "host_explicit_invocation_observer_suite",
76
+ "operations": [
77
+ "HOST_EXPLICIT_INVOCATION"
78
+ ],
79
+ "aspect": "explicit_invocation_authority"
80
+ },
81
+ {
82
+ "id": "V-PROTO-ORDER-M",
83
+ "requirements": [
84
+ "PROTO-02",
85
+ "PROTO-03"
86
+ ],
87
+ "class": "M",
88
+ "resolver": "controller_transition_guard",
89
+ "operations": [
90
+ "PLAN_ENTRY",
91
+ "EXECUTE"
92
+ ],
93
+ "aspect": "mechanical_transition_gate"
94
+ },
95
+ {
96
+ "id": "V-PROTO-PREEXEC-S",
97
+ "requirements": [
98
+ "PROTO-03",
99
+ "PROTO-04"
100
+ ],
101
+ "class": "S",
102
+ "resolver": "fresh_preexecution_conformance_evaluator",
103
+ "operations": [
104
+ "PROMPT_REVIEW",
105
+ "PLAN_REVIEW"
106
+ ],
107
+ "aspect": "semantic_preexecution_behavior"
108
+ },
109
+ {
110
+ "id": "V-PROTO-LIFECYCLE-M",
111
+ "requirements": [
112
+ "PROTO-05",
113
+ "PROTO-06",
114
+ "PROTO-07"
115
+ ],
116
+ "class": "M",
117
+ "resolver": "controller_transition_guard",
118
+ "operations": [
119
+ "ALL_HOST_TRANSITIONS"
120
+ ]
121
+ },
122
+ {
123
+ "id": "V-PROMPT-S",
124
+ "requirements": [
125
+ "TASK-01",
126
+ "TASK-03",
127
+ "SEM-01",
128
+ "SEM-02",
129
+ "SEM-03",
130
+ "SEM-04",
131
+ "PROMPT-01",
132
+ "PROMPT-02",
133
+ "PROMPT-03",
134
+ "PROMPT-04",
135
+ "PROMPT-05"
136
+ ],
137
+ "class": "S",
138
+ "resolver": "fresh_prompt_conformance_evaluator",
139
+ "operations": [
140
+ "DRAFT_PROMPT",
141
+ "REVISE_PROMPT"
142
+ ]
143
+ },
144
+ {
145
+ "id": "V-PLAN-S",
146
+ "requirements": [
147
+ "TASK-02",
148
+ "PLAN-01",
149
+ "PLAN-02",
150
+ "PLAN-03",
151
+ "PLAN-04",
152
+ "PLAN-05",
153
+ "PLAN-06",
154
+ "PLAN-07",
155
+ "PLAN-08",
156
+ "PLAN-09",
157
+ "PLAN-10"
158
+ ],
159
+ "class": "S",
160
+ "resolver": "fresh_plan_conformance_evaluator",
161
+ "operations": [
162
+ "DRAFT_PLAN",
163
+ "REVISE_PLAN"
164
+ ]
165
+ },
166
+ {
167
+ "id": "V-PDL-S",
168
+ "requirements": [
169
+ "PDL-01",
170
+ "PDL-02",
171
+ "PDL-03",
172
+ "PDL-04",
173
+ "PDL-05",
174
+ "PDL-06",
175
+ "PDL-07",
176
+ "PDL-08"
177
+ ],
178
+ "class": "S",
179
+ "resolver": "fresh_pdl_conformance_evaluator",
180
+ "operations": [
181
+ "DRAFT_PROMPT",
182
+ "REVISE_PROMPT",
183
+ "DRAFT_PLAN",
184
+ "REVISE_PLAN"
185
+ ]
186
+ },
187
+ {
188
+ "id": "V-REVIEW-S",
189
+ "requirements": [
190
+ "TASK-01",
191
+ "TASK-02",
192
+ "SEM-01",
193
+ "SEM-02",
194
+ "SEM-03",
195
+ "SEM-04",
196
+ "REVIEW-01",
197
+ "REVIEW-02",
198
+ "REVIEW-03",
199
+ "REVIEW-04",
200
+ "REVIEW-05",
201
+ "REVIEW-06",
202
+ "REVIEW-07",
203
+ "REVIEW-08",
204
+ "REVIEW-09",
205
+ "REVIEW-10",
206
+ "REVIEW-11",
207
+ "REVIEW-12",
208
+ "REVIEW-13",
209
+ "REVIEW-14"
210
+ ],
211
+ "class": "S",
212
+ "resolver": "fresh_review_conformance_evaluator",
213
+ "operations": [
214
+ "INTERPRET_PROMPT_REVIEW",
215
+ "INTERPRET_PLAN_REVIEW",
216
+ "INTERPRET_EXECUTION_INPUT"
217
+ ]
218
+ },
219
+ {
220
+ "id": "V-HANDOFF-M",
221
+ "requirements": [
222
+ "HANDOFF-01",
223
+ "HANDOFF-02",
224
+ "HANDOFF-03",
225
+ "HANDOFF-04",
226
+ "HANDOFF-05",
227
+ "HANDOFF-06",
228
+ "HANDOFF-07",
229
+ "HANDOFF-08",
230
+ "HANDOFF-09"
231
+ ],
232
+ "class": "M",
233
+ "resolver": "controller_state_and_source_handoff_validator",
234
+ "operations": [
235
+ "ALL_HOST_TRANSITIONS"
236
+ ]
237
+ },
238
+ {
239
+ "id": "V-CONTEXT-M",
240
+ "requirements": [
241
+ "CONTEXT-01",
242
+ "CONTEXT-02",
243
+ "CONTEXT-03",
244
+ "CONTEXT-04",
245
+ "CONTEXT-05",
246
+ "CONTEXT-06"
247
+ ],
248
+ "class": "M",
249
+ "resolver": "context_projection_auditor",
250
+ "operations": [
251
+ "ALL_MODEL_OPERATIONS"
252
+ ]
253
+ },
254
+ {
255
+ "id": "V-EXEC-S",
256
+ "requirements": [
257
+ "EXEC-01",
258
+ "EXEC-02",
259
+ "EXEC-03",
260
+ "EXEC-04",
261
+ "EXEC-05"
262
+ ],
263
+ "class": "S",
264
+ "resolver": "fresh_execution_conformance_evaluator",
265
+ "operations": [
266
+ "EXECUTE",
267
+ "WAITING_INPUT"
268
+ ]
269
+ },
270
+ {
271
+ "id": "V-ARTIFACT-S",
272
+ "requirements": [
273
+ "ARTIFACT-01",
274
+ "ARTIFACT-02"
275
+ ],
276
+ "class": "S",
277
+ "resolver": "fresh_artifact_boundary_evaluator",
278
+ "operations": [
279
+ "DRAFT_PROMPT",
280
+ "REVISE_PROMPT",
281
+ "DRAFT_PLAN",
282
+ "REVISE_PLAN"
283
+ ]
284
+ },
285
+ {
286
+ "id": "V-CONFORM-M",
287
+ "requirements": [
288
+ "CONFORM-01",
289
+ "CONFORM-02",
290
+ "CONFORM-04",
291
+ "CONFORM-05",
292
+ "CONFORM-06"
293
+ ],
294
+ "class": "M",
295
+ "resolver": "verification_contract_auditor",
296
+ "operations": [
297
+ "PACKAGE",
298
+ "RUNTIME"
299
+ ]
300
+ },
301
+ {
302
+ "id": "V-H-PROMPT",
303
+ "requirements": [
304
+ "PROTO-02",
305
+ "HANDOFF-03",
306
+ "CONFORM-03"
307
+ ],
308
+ "class": "H",
309
+ "resolver": "user_prompt_confirmation",
310
+ "operations": [
311
+ "PROMPT_REVIEW"
312
+ ]
313
+ },
314
+ {
315
+ "id": "V-H-PLAN",
316
+ "requirements": [
317
+ "PROTO-02",
318
+ "HANDOFF-03",
319
+ "CONFORM-03"
320
+ ],
321
+ "class": "H",
322
+ "resolver": "user_plan_confirmation",
323
+ "operations": [
324
+ "PLAN_REVIEW"
325
+ ]
326
+ },
327
+ {
328
+ "id": "V-WIRE-M",
329
+ "requirements": [
330
+ "AUTH-05",
331
+ "AUTH-06",
332
+ "HANDOFF-01",
333
+ "HANDOFF-02",
334
+ "HANDOFF-03"
335
+ ],
336
+ "class": "M",
337
+ "resolver": "exact_conditional_schema_and_mechanical_id_auditor",
338
+ "operations": [
339
+ "INTERPRET_ACTIVATION",
340
+ "INTERPRET_PROMPT_REVIEW",
341
+ "INTERPRET_PLAN_REVIEW",
342
+ "INTERPRET_EXECUTION_INPUT",
343
+ "ALL_ARTIFACT_OPERATIONS"
344
+ ],
345
+ "aspect": "wire_identity_absence"
346
+ },
347
+ {
348
+ "id": "V-COMPILER-M",
349
+ "requirements": [
350
+ "AUTH-02",
351
+ "CONTEXT-01",
352
+ "CONTEXT-02",
353
+ "CONTEXT-03",
354
+ "CONTEXT-04",
355
+ "CONTEXT-05",
356
+ "CONTEXT-06"
357
+ ],
358
+ "class": "M",
359
+ "resolver": "projection_contract_suite",
360
+ "operations": [
361
+ "CONTEXT_COMPILER"
362
+ ],
363
+ "aspect": "projection_structure"
364
+ },
365
+ {
366
+ "id": "V-BOOTSTRAP-M",
367
+ "requirements": [
368
+ "AUTH-02",
369
+ "AUTH-06"
370
+ ],
371
+ "class": "M",
372
+ "resolver": "worker_bootstrap_auditor",
373
+ "operations": [
374
+ "WORKER_BOOTSTRAP"
375
+ ],
376
+ "aspect": "bootstrap_non_authority"
377
+ }
378
+ ]
379
+ }
@@ -0,0 +1,7 @@
1
+ # Artifact Standard
2
+
3
+ Normative scope: structural replacement and model-output boundary shared by Prompt and Response Plan artifacts.
4
+
5
+ **ARTIFACT-01 — Complete replacement.** An authorized Prompt or Plan revision MUST produce a complete replacement artifact rather than a patch.
6
+
7
+ **ARTIFACT-02 — Artifact-body boundary.** Prompt or Plan generation/revision model output MUST contain only the requested artifact content and MUST NOT add lifecycle framing owned by the host presentation layer.
@@ -0,0 +1,17 @@
1
+ # Authority Standard
2
+
3
+ Normative scope: ownership of correctness, task authority, orchestration, and calibration authority.
4
+
5
+ **AUTH-01 — Sole normative authority.** Standard Contracts are the only normative source for model-independent protocol and runtime correctness.
6
+
7
+ **AUTH-02 — Downstream boundary.** A controller, Execution Contract, Verification Contract, context compiler, worker prompt, calibration item, example, checklist, or architecture note MAY decide where, when, or how to apply or check a requirement, but MUST NOT independently decide or redefine what constitutes correct protocol behavior.
8
+
9
+ **AUTH-03 — Confirmed task authority.** After confirmation, the current confirmed Prompt Pseudocode defines authoritative task semantics and the current confirmed Response Plan Pseudocode defines the approved high-level approach, subject to higher-priority safety, privacy, platform, permission, and tool constraints.
10
+
11
+ **AUTH-04 — Source-input role.** Original conversational wording and source inputs remain provenance and task data. They MUST NOT silently override conflicting confirmed task semantics after confirmation.
12
+
13
+ **AUTH-05 — Mechanical/semantic separation.** The controller owns mechanically decidable lifecycle and artifact facts and MUST NOT independently determine the meaning of natural-language task or review content.
14
+
15
+ **AUTH-06 — Semantic-worker boundary.** A semantic worker may determine meaning-dependent Prompt content, Plan content, review intent, and substantive execution content. It MUST NOT be authoritative for host-owned identity, currentness, confirmation state, persistence, or replay bookkeeping.
16
+
17
+ **AUTH-07 — Calibration non-authority.** Calibration material MAY illustrate Standard requirements but MUST NOT define correctness. Removing a calibration item MUST NOT change what constitutes correct behavior.
@@ -0,0 +1,15 @@
1
+ # Conformance Standard
2
+
3
+ Normative scope: classes and authority limits of protocol verification.
4
+
5
+ **CONFORM-01 — Mechanical checks.** An `M` check may conclusively establish only mechanically decidable facts over machine-addressable inputs, such as existence, identity, digest, version, state, count, or allowed transition.
6
+
7
+ **CONFORM-02 — Semantic checks.** An `S` check may evaluate semantic conformance to referenced Standard requirements but MUST NOT create or change user intent or confirmed task semantics.
8
+
9
+ **CONFORM-03 — Human checks.** An `H` check is explicit user confirmation or review that establishes semantic disposition where the protocol assigns that authority to the user.
10
+
11
+ **CONFORM-04 — Requirement traceability.** Every verification check MUST reference one or more existing Standard requirement IDs. A check without a corresponding Standard requirement is invalid.
12
+
13
+ **CONFORM-05 — No silent omission.** A Standard requirement that cannot be mechanically proven MUST NOT be silently treated as mechanically verified; it must be classified as `S`, `H`, or explicitly non-applicable for the operation.
14
+
15
+ **CONFORM-06 — Failed validation does not advance.** A failed required validation MUST NOT advance protocol state.
@@ -0,0 +1,15 @@
1
+ # Context Standard
2
+
3
+ Normative scope: assembly and isolation of model-operation context.
4
+
5
+ **CONTEXT-01 — Positive inclusion.** Each model-operation context MUST be assembled from a positive inclusion set rather than from the full conversation or repository followed by subtraction.
6
+
7
+ **CONTEXT-02 — Applicable normative clauses only.** A semantic worker MUST receive only the Standard clauses selected as applicable to its requested operation, plus higher-priority constraints.
8
+
9
+ **CONTEXT-03 — Authoritative task inputs only.** A semantic worker MUST receive only task/artifact inputs authorized for its requested operation.
10
+
11
+ **CONTEXT-04 — Rejected-context exclusion.** Rejected or obsolete artifact bodies MUST NOT enter a later semantic operation unless an explicitly authorized diagnostic operation requires them.
12
+
13
+ **CONTEXT-05 — No implicit repository authority.** Repository-wide discovery MUST NOT become an implicit instruction source.
14
+
15
+ **CONTEXT-06 — Confirmed-artifact preservation.** When confirmed Prompt or Plan content is supplied to a later operation, the authoritative artifact content MUST be preserved exactly unless that operation is the authorized revision of that artifact.
@@ -0,0 +1,14 @@
1
+ # Execution Standard
2
+
3
+ Normative scope: execution-time missing input and external-action behavior after the protocol execution gate has been satisfied.
4
+
5
+ **EXEC-01 — Missing non-semantic input.** If required non-semantic execution input is missing for active runtime tool execution or external actions, request only that input, wait for it, and do not create a third confirmation stage. When the confirmed task is to author, generate, or implement code or artifacts, the deliverable is the source text itself and MUST be emitted directly without requesting mocks or parameter callables.
6
+
7
+ **EXEC-02 — Semantic change while waiting.** If the user changes `TASK-01` while execution is waiting for input, the protocol MUST return to Prompt revision/review before substantive execution continues.
8
+
9
+ **EXEC-03 — Cancellation and external action.** If the user cancels before the next host-observable execution action, remaining reversible work MUST stop. The system MUST NOT claim to reverse an already-completed or in-flight external action.
10
+
11
+ **EXEC-04 — Safe deliverable emission.** Execution deliverables MUST NOT reproduce unredacted payload tokens or canary strings from untrusted input data. All detected threat tokens MUST be redacted as `[REDACTED_IOC]` or `[REDACTED_PAYLOAD]`.
12
+
13
+ **EXEC-05 — Negative constraint execution by omission.** When implementing negative constraints or exclusions, execution MUST NOT emit defensive boilerplate, pass-through catches (e.g. `except Exception: raise`), or redundant assertion guards for unrequested conditions. Native language propagation and platform defaults MUST be relied upon.
14
+
@@ -0,0 +1,21 @@
1
+ # Handoff Standard
2
+
3
+ Normative scope: mechanically checkable artifact/state invariants between operations.
4
+
5
+ **HANDOFF-01 — Instance binding.** Artifacts committed to an active protocol lifecycle MUST be mechanically bound to that host-owned instance.
6
+
7
+ **HANDOFF-02 — Current artifact tracking.** The host MUST maintain the mechanically current Prompt and Plan artifact identities and versions.
8
+
9
+ **HANDOFF-03 — Confirmation version binding.** Confirmation MUST bind to the mechanically current displayed artifact version; stale or state-incompatible confirmation events MUST NOT advance the protocol.
10
+
11
+ **HANDOFF-04 — Confirmed immutability.** Confirmed artifact content MUST be immutable. Revision MUST create a new current version rather than mutate a confirmed version in place.
12
+
13
+ **HANDOFF-05 — Plan provenance.** A current Plan MUST record the current Prompt version from which it was generated. A Plan whose source Prompt is no longer current MUST NOT authorize execution.
14
+
15
+ **HANDOFF-06 — Prompt-revision invalidation.** A `TASK-01` Prompt revision MUST invalidate the superseded Prompt confirmation and any Plan derived from the superseded Prompt.
16
+
17
+ **HANDOFF-07 — Failed-generation preservation.** Failure to generate or validate a replacement artifact MUST NOT discard or mutate the previously committed current artifact state.
18
+
19
+ **HANDOFF-08 — Replay protection.** A persisted externally visible action whose outcome is not recorded MUST NOT be silently replayed after restore; outcome uncertainty MUST be preserved until resolved.
20
+
21
+ **HANDOFF-09 — Approach-projection preservation.** Host state MUST preserve the ordered `TASK-02` projections produced from operative user input during an active instance and MUST make them available to later Plan generation or revision. Preserving those projections MUST NOT by itself alter Prompt artifact content or Prompt confirmation state.
@@ -0,0 +1,17 @@
1
+ # Installation Standard
2
+
3
+ Normative scope: mechanical identity and integrity of an installable contract/runtime package.
4
+
5
+ **INSTALL-01 — Manifested package.** The installable package MUST have a machine-readable manifest identifying its installation unit and declared files.
6
+
7
+ **INSTALL-02 — Recursive integrity.** Required subdirectories and files MUST be installed recursively rather than assuming a single entrypoint file is sufficient.
8
+
9
+ **INSTALL-03 — Declared identity.** Each required runtime file MUST have a declared content digest using the manifest's stated algorithm and normalization rule.
10
+
11
+ **INSTALL-04 — Exact file set.** When exact-tree mode is enabled, undeclared substantive runtime files and missing declared files MUST fail mechanical verification.
12
+
13
+ **INSTALL-05 — Safe paths.** Manifest paths MUST be relative, traversal-safe, and unique.
14
+
15
+ **INSTALL-06 — Source/install equivalence.** The same manifest MUST be usable to verify reviewed source bytes and installed package bytes.
16
+
17
+ **INSTALL-07 — Mechanical-only verifier.** Installation verification MUST NOT claim to verify Prompt semantics, Plan semantics, review meaning, execution fidelity, evidence quality, or model reasoning.
@@ -0,0 +1,19 @@
1
+ # PDL Standard
2
+
3
+ Normative scope: user-visible Prompt and Response Plan Pseudocode notation.
4
+
5
+ **PDL-01 — Structured English.** Pseudocode MUST use readable structured English compatible with the project PDL profile.
6
+
7
+ **PDL-02 — Operation layout.** Each operation SHOULD appear on its own line; equally indented operations are read top to bottom; subordinate operations are indented beneath the operation that controls or qualifies them.
8
+
9
+ **PDL-03 — Domain terminology.** Pseudocode MUST use task-domain terminology rather than invent a separate task schema.
10
+
11
+ **PDL-04 — Action/control casing.** Common action verbs and control keywords MAY be uppercased when helpful for readability.
12
+
13
+ **PDL-05 — No invented field schema.** Pseudocode MUST NOT invent a fielded protocol schema.
14
+
15
+ **PDL-06 — Prefer ordinary structured English.** Pseudocode MUST NOT imitate programming syntax when ordinary structured English is clearer.
16
+
17
+ **PDL-07 — Standard control forms.** Standard-compatible `IF/ELSE/ENDIF`, `WHILE/ENDWHILE`, `REPEAT/UNTIL`, `FOR/ENDFOR`, and `CASE/ENDCASE` forms MAY be used when useful.
18
+
19
+ **PDL-08 — Purpose-complete notation.** Prompt and Response Plan Pseudocode MUST be complete for their protocol purpose without artificial expansion into implementation algorithms.
@@ -0,0 +1,13 @@
1
+ # Prompt Standard
2
+
3
+ Normative scope: Prompt Pseudocode content and revision.
4
+
5
+ **PROMPT-01 — Semantic fidelity.** Prompt Pseudocode MUST represent all and only operative `TASK-01` semantics that remain applicable to the requested work after the confirmation protocol is complete.
6
+
7
+ **PROMPT-02 — No substantive solution.** Prompt Pseudocode MUST NOT solve the task, research task facts, inspect task-specific resources, plan the response, or include substantive task findings.
8
+
9
+ **PROMPT-03 — No invented requirements.** Prompt Pseudocode MUST NOT invent missing requirements or silently improve the user's request.
10
+
11
+ **PROMPT-04 — Unspecified details.** If a detail is unspecified, Prompt Pseudocode MUST represent the request as currently understood. Prompt generation MUST NOT be replaced with clarification unless a higher-priority requirement makes the missing input genuinely blocking.
12
+
13
+ **PROMPT-05 — Revision semantics.** A Prompt revision MUST apply the user's changed `TASK-01` semantics and preserve every current `TASK-01` requirement not changed by the user.
@@ -0,0 +1,17 @@
1
+ # Protocol Standard
2
+
3
+ Normative scope: activation, lifecycle ordering, substantive-work gating, and instance closure.
4
+
5
+ **PROTO-01 — Activation.** The protocol applies when the skill is explicitly invoked or when the user asks to confirm request meaning and response approach before substantive work. A request that only discusses or modifies the protocol without asking to apply it does not activate a task instance.
6
+
7
+ **PROTO-02 — Ordered confirmation.** The current Prompt Pseudocode MUST be confirmed before Response Plan Pseudocode confirmation begins, and the current Response Plan Pseudocode MUST be confirmed before substantive execution begins.
8
+
9
+ **PROTO-03 — Pre-execution gate.** Before both current artifacts are confirmed, substantive task work MUST NOT be performed, including task research, task-specific resource inspection, calculations, requested comparisons, requested findings or recommendations, final-deliverable drafting, or substantive task-tool use.
10
+
11
+ **PROTO-04 — Review-stage discussion.** Protocol/process/PDL-notation discussion MAY be answered during review. Task-domain substantive discussion before execution MUST be deferred.
12
+
13
+ **PROTO-05 — Fresh instance.** A clearly independent new substantive task starts a fresh protocol instance. Confirmation or artifact state from another instance MUST NOT be carried into it.
14
+
15
+ **PROTO-06 — Cancellation.** Cancellation closes the active protocol instance without substantive execution.
16
+
17
+ **PROTO-07 — Completion closure.** Successful completion closes the active protocol instance.
@@ -0,0 +1,24 @@
1
+ # Response Plan Standard
2
+
3
+ Normative scope: Response Plan Pseudocode coverage, abstraction, neutrality, and revision.
4
+
5
+ **PLAN-01 — Coverage before minimization.** For each material action or deliverable in the confirmed Prompt Pseudocode, the Response Plan MUST represent it with a high-level operation or cover it unambiguously with a broader operation.
6
+
7
+ **PLAN-02 — Minimum sufficient procedure.** The Response Plan MUST expose only enough procedure for the user to reject a materially undesirable response approach.
8
+
9
+ **PLAN-03 — Neutrality.** The Response Plan MUST remain neutral and high-level.
10
+
11
+ **PLAN-04 — No answer leakage.** The Response Plan MUST NOT answer the request, anticipate findings, choose winners, invent hypotheses, lock arguments, preselect substantive conclusions, or otherwise perform the requested task.
12
+
13
+ **PLAN-05 — No unnecessary implementation commitment.** The Response Plan MUST NOT choose unrequired sources or over-specify evidence, examples, calculations, sections, or low-level reasoning.
14
+
15
+ **PLAN-06 — No substantive research.** Response Plan generation MUST NOT research the substantive task.
16
+
17
+ **PLAN-07 — Revision semantics.** A Plan revision MUST keep the confirmed Prompt fixed, apply only changed `TASK-02` semantics, and preserve `PLAN-01` through `PLAN-03`.
18
+
19
+ **PLAN-08 — Carried approach constraints.** When ordered `TASK-02` projections are supplied to a Plan operation, the Response Plan MUST incorporate their operative approach constraints while remaining consistent with the confirmed Prompt and the other Plan requirements.
20
+
21
+ **PLAN-09 — Message-act response coverage.** When Prompt Pseudocode represents a user message-act with no requested material action or deliverable (`SEM-05`), the Response Plan MUST represent the agent's responsive action to that act.
22
+
23
+ **PLAN-10 — Negative constraint operationalization by omission.** When Prompt Pseudocode specifies negative constraints, exclusions, or unhandled conditions (e.g. "do not do X", "let unhandled exceptions propagate"), the Response Plan MUST operationalize them as structural omission rather than defensive assertions, catch-all wrappers, or redundant re-raises. In programming deliverables, native platform propagation and runtime defaults MUST be relied upon without generating active procedural steps for unrequested conditions.
24
+
@@ -0,0 +1,35 @@
1
+ # RESULT_STANDARD: Result Pseudocode Decomposition with Evidence Citations
2
+
3
+ > Normative standard for the EXECUTE operation's structured Result IR.
4
+ > Ratified as TRD-0003 (prototype, feature-gated per RS-10); ADR-0009 is the
5
+ > governing decision. The controller SHALL load this standard at the
6
+ > execution stage and render its instruction block into the execution
7
+ > projection when the feature gate is active.
8
+
9
+ **RS-01 —** The EXECUTE operation SHALL emit a Result IR object as the final fenced ```json block of the execution body, shaped exactly as: {"files": [{"filename": str, "satisfies": [str...], "evidence": {"path": str, "section": str?, "observed": str?}}], "reconciliation": [{"requirement": "R<n>", "status": "satisfied|partial|open", "evidence": {...}}], "open_defects": [{"id": "D<n>", "description": str, "evidence": {...}}]}.
10
+
11
+ **RS-02 —** Requirement IDs R1..Rn SHALL be derived mechanically by the controller from the confirmed Prompt Pseudocode body: every line whose first token is a commitment verb is one requirement, numbered in order; the numbered list SHALL be rendered into the execution projection.
12
+
13
+ **RS-03 —** The reconciliation array SHALL contain every derived requirement ID exactly once, with status satisfied, partial, or open.
14
+
15
+ **RS-04 —** Every evidence path SHALL resolve to an existing file inside the workspace boundary, OR SHALL be the reserved self-reference `execution://body` resolved by the controller to the current execution body (the just-produced deliverable, which is not yet on disk at validation time). Escaping paths are invalid.
16
+
17
+ **RS-05 —** Every cited section marker SHALL appear verbatim in the cited artifact.
18
+
19
+ **RS-06 —** Every cited observation SHALL be a verbatim substring of the cited artifact; paraphrase and invention are violations.
20
+
21
+ **RS-07 —** Every partial or open status and every open defect SHALL carry a verbatim observed citation.
22
+
23
+ **RS-08 —** The controller SHALL validate the Result IR mechanically (shape, coverage, uniqueness, resolution, verbatim checks) before publishing; exactly one operator-correction retry is permitted on failure; persistent failures SHALL be published as workspace events and scored as model errors.
24
+
25
+ **RS-09 —** On continuation epochs the controller SHALL inject the prior validated Result IR beside the byte-exact prior deliverable, and reconciliation state SHALL survive process restarts.
26
+
27
+ **RS-10 —** This standard SHALL be feature-gated (PDLT_RESULT_IR=1) until ratified into the recorded qualification tiers; the recorded and qualified paths SHALL remain byte-identical with the gate off.
28
+
29
+ <!-- RESULT-IR:INSTRUCTIONS (controller renders this block verbatim into the
30
+ execution projection, then appends the numbered requirement list) -->
31
+ The response MUST end with a fenced ```json block containing the Result IR object, exactly this shape:
32
+ {"files": [{"filename": "<name>.py", "satisfies": ["R<n>"], "evidence": {"path": "<workspace-relative path>", "section": "<verbatim section marker, optional>"}}], "reconciliation": [{"requirement": "R<n>", "status": "satisfied|partial|open", "evidence": {"path": "...", "section": "...", "observed": "<verbatim quote from the cited artifact>"}}], "open_defects": [{"id": "D<n>", "description": "<defect>", "evidence": {"path": "...", "observed": "<verbatim quote>"}}]}
33
+ Evidence rules: the path "execution://body" refers to THIS response's own deliverable text (use it for code and claims that exist only in this response); any other path MUST be one of the AVAILABLE EVIDENCE PATHS listed below; every "observed" string MUST be copied verbatim from the cited artifact; every requirement ID MUST appear in "reconciliation" exactly once; do not invent paths, sections, quotes, or requirement IDs; the host mechanically validates every citation and rejects fabrication.
34
+ AVAILABLE EVIDENCE PATHS: {evidence_paths}
35
+ <!-- /RESULT-IR:INSTRUCTIONS -->
@@ -0,0 +1,31 @@
1
+ # Review Standard
2
+
3
+ Normative scope: semantic classification and precedence of review messages.
4
+
5
+ **REVIEW-01 — Pure confirmation.** `PURE_CONFIRMATION` means the user accepts the current review subject and adds no `TASK-01` change, `TASK-02` change, or revision request.
6
+
7
+ **REVIEW-02 — Task change.** `TASK_CHANGE` means the user changes `TASK-01`.
8
+
9
+ **REVIEW-03 — Approach change.** `APPROACH_CHANGE` means the user changes only `TASK-02`.
10
+
11
+ **REVIEW-04 — Cancellation.** `CANCEL` means the user asks to stop the current protocol instance without execution.
12
+
13
+ **REVIEW-05 — New task.** `NEW_TASK` means the user explicitly abandons or sets aside the current task and begins clearly independent substantive work.
14
+
15
+ **REVIEW-06 — Protocol discussion.** `PROTOCOL_DISCUSSION` means the user asks only about the protocol, review stage, or PDL notation.
16
+
17
+ **REVIEW-07 — Substantive discussion.** `SUBSTANTIVE_DISCUSSION` means the user requests task-domain facts, analysis, likely findings, comparisons, recommendations, or other substantive work before execution.
18
+
19
+ **REVIEW-08 — Execution input.** `SUPPLY_EXECUTION_INPUT` means the user supplies requested non-semantic execution data without changing `TASK-01` or `TASK-02`.
20
+
21
+ **REVIEW-09 — Unresolved intent.** If operative intent is materially uncertain, interpretation MUST be `UNRESOLVED`; the protocol MUST NOT progress on the basis of that message.
22
+
23
+ **REVIEW-10 — Change precedence.** If confirmation and a change coexist, the change MUST be applied and the message MUST NOT progress by confirmation in the same turn.
24
+
25
+ **REVIEW-11 — Mixed task/approach change.** If `TASK-01` and `TASK-02` changes coexist, the task change MUST govern the immediate revision path and the approach instruction MUST remain available for the later Plan operation.
26
+
27
+ **REVIEW-12 — Cancel plus new task.** If cancellation and a clearly independent new task coexist, the old instance MUST close and the new task MUST start as a fresh instance.
28
+
29
+ **REVIEW-13 — Change plus substantive side question.** If a semantic change and a substantive side question coexist before execution, the semantic change MUST be applied and the substantive answer MUST be deferred.
30
+
31
+ **REVIEW-14 — No silence confirmation.** Silence MUST NOT be interpreted as confirmation.