npm - create-agdf - Versions diffs - 0.14.4 → 0.20.0 - Mend

create-agdf 0.14.4 → 0.20.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.

Files changed (1330) hide show

package/generated/plugins/copilot/agdf/meta/agdf-plugin.definition.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "id": "agdf",
-  "version": "0.14.4",
+  "version": "0.20.0",
   "displayName": "AI Governance & Delivery Framework",
   "developerName": "Arndt Gold",
   "description": "Control layer for governed AI-assisted delivery.",
@@ -41,6 +41,7 @@
   },
   "claude": {
     "skillPrefix": "",
+    "mcpServers": "./mcp/claude.mcp.json",
     "agentRouter": "meta/agdf-agent-router.md",
     "defaultPrompt": [
       "Assess whether AGDF fits this request and recommend the lightest safe path before proposing implementation.",
@@ -52,8 +53,8 @@
     "skillPrefix": "agdf-",
     "runtimeContractFileName": "agdf-runtime-contract.md",
     "pluginManifest": "plugin.json",
-    "skills": "copilot-skills/",
-    "hooks": "hooks/copilot-hooks.json"
+    "skills": "skills/",
+    "hooks": "com.github.copilot/hooks/hooks.json"
   },
   "opencode": {
     "skillPrefix": "agdf-",
@@ -89,7 +90,7 @@
     },
     "surfaces": {
       "codex": "native-hook-review",
-      "claude": "exact-command-rule",
+      "claude": "plugin-enablement",
       "copilot": "plugin-hook-review",
       "opencode": "plugin-internal",
       "portable-skills": "manual-external-required"
@@ -232,66 +233,323 @@
       "availabilityDecision": "submission/openai/availability.md"
     }
   },
+  "runtimeContract": {
+    "schemaVersion": 1,
+    "manifestPath": "meta/agdf-runtime-contract.md",
+    "modules": [
+      "meta/contracts/request-activation.md",
+      "meta/contracts/task-target-resolution.md",
+      "meta/contracts/gate-transition.md",
+      "meta/contracts/gate-artifact-preparation.md",
+      "meta/contracts/interaction.md",
+      "meta/contracts/modes.md",
+      "meta/contracts/quality.md",
+      "meta/contracts/context-graph.md",
+      "meta/contracts/control-scaffold.md",
+      "meta/contracts/closeout.md",
+      "meta/contracts/ur-definition.md",
+      "meta/contracts/prd-definition.md",
+      "meta/contracts/sd-definition.md",
+      "meta/contracts/tp-definition.md"
+    ]
+  },
+  "instructionFootprint": {
+    "schemaVersion": 1,
+    "measurement": {
+      "encoding": "utf8",
+      "lineEndings": "lf",
+      "dynamicAbsolutePathTokens": {
+        "executable": "<executable>",
+        "validator": "<validator>",
+        "workingDirectory": "<working-directory>"
+      }
+    },
+    "budgets": {
+      "activationKernel": {
+        "maxNormalizedBytes": 1100,
+        "structuralConditions": [
+          "exactly_one_semantic_kernel_source"
+        ]
+      },
+      "skillDiscoveryDescription": {
+        "maxNormalizedBytes": 420,
+        "structuralConditions": [
+          "one_skill_purpose_and_boundary_plus_compact_common_boundary"
+        ]
+      },
+      "allSkillDiscoveryDescriptions": {
+        "maxNormalizedBytes": 3000,
+        "structuralConditions": [
+          "exactly_catalog_in_definition_order",
+          "no_full_exclusion_taxonomy",
+          "no_operation_catalog"
+        ]
+      },
+      "sessionStartBase": {
+        "maxNormalizedBytes": 1912,
+        "structuralConditions": [
+          "exactly_one_kernel",
+          "exactly_one_dispatcher_binding",
+          "no_router_or_target_gate_quality_closeout_handbook"
+        ]
+      },
+      "runtimeCheckSupplement": {
+        "maxNormalizedBytes": 1200,
+        "structuralConditions": [
+          "separately_measurable_variable_facts_only",
+          "bounded_non_authorizing_repository_control_facts_and_fixed_reentry"
+        ]
+      },
+      "openCodeEagerInstructions": {
+        "maxNormalizedBytes": 4000,
+        "structuralConditions": [
+          "exactly_one_kernel",
+          "no_dispatcher_binding",
+          "no_full_router_target_mode_gate_quality_or_closeout_sections"
+        ]
+      },
+      "openCodeActiveDynamicContext": {
+        "maxNormalizedBytes": 1000,
+        "structuralConditions": [
+          "exactly_one_dispatcher_binding",
+          "active_and_version_facts_only",
+          "no_kernel_or_immutable_policy_prose"
+        ]
+      },
+      "openCodeInactiveDynamicContext": {
+        "maxNormalizedBytes": 0,
+        "structuralConditions": [
+          "no_binding_notice_policy_or_runtime_supplement"
+        ]
+      },
+      "openCodeComposedStaticAndActiveDynamic": {
+        "maxNormalizedBytes": 5000,
+        "structuralConditions": [
+          "exactly_one_kernel_and_one_dispatcher_binding_across_repository_and_global_variants"
+        ]
+      },
+      "openCodeCompactionAddition": {
+        "maxNormalizedBytes": 1100,
+        "structuralConditions": [
+          "at_most_one_kernel_only_recovery_block",
+          "no_dispatcher_binding_or_active_inactive_guidance"
+        ]
+      },
+      "selectedGateCheckSkill": {
+        "maxNormalizedBytes": 6900,
+        "structuralConditions": [
+          "exactly_one_kernel_before_unchanged_terminal_dispatch",
+          "dispatch_and_bootstrap_only",
+          "detailed_fallback_only_through_focused_contracts"
+        ]
+      }
+    }
+  },
   "skillSet": [
     {
       "slug": "delivery-path-search",
+      "runtimeContractModules": [
+        "control-scaffold",
+        "gate-transition",
+        "quality"
+      ],
       "discovery": "optional",
       "useFor": "high-impact planning decisions with several plausible next delivery steps before implementation",
-      "boundary": "read-only advisory search; never grants gate permission or replaces gate-check"
+      "boundary": "read-only advisory search; never grants gate permission or replaces gate-check",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "brownfield-analysis",
+      "runtimeContractModules": [
+        "gate-transition",
+        "modes",
+        "context-graph",
+        "quality"
+      ],
       "discovery": "automatic",
-      "useFor": "after gate-check permits Brownfield Review or implementation preparation, before non-trivial changes in existing systems",
-      "boundary": "clarifies reuse, owners, risks and Mode/Slice Decision; never bypasses gate-check; Brownfield Review is not implementation permission"
+      "useFor": "permitted Brownfield Review or preparation before non-trivial existing-system changes",
+      "boundary": "clarifies reuse, owners, risks and Mode/Slice; never bypasses control or grants implementation",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "ux-intent-definition",
+      "runtimeContractModules": [
+        "gate-transition",
+        "quality"
+      ],
       "discovery": "automatic",
-      "useFor": "after approved UR and post-UR routing for medium/high UI/UX impact or ambiguous low-impact product semantics before PRD readiness",
-      "boundary": "non-authorizing analytical PRD input; never creates product intent, gate permission, technical design or a parallel product source of truth"
+      "useFor": "approved UR with routed medium/high UX impact or ambiguous low-impact semantics before PRD",
+      "boundary": "analytical PRD input only; no intent, gate, design or parallel product authority",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "clean-implementation-review",
+      "runtimeContractModules": [
+        "quality",
+        "context-graph"
+      ],
       "discovery": "automatic",
       "useFor": "evidence dimension: inspect whether the solution is structurally clean",
-      "boundary": "supports Quality Readiness; not a TP or QA substitute"
+      "boundary": "supports Quality Readiness; not a TP or QA substitute",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "code-review",
+      "runtimeContractModules": [
+        "quality",
+        "context-graph"
+      ],
       "discovery": "automatic",
       "useFor": "evidence dimension: review the actual diff for defects, regression and security findings",
-      "boundary": "supports Quality Readiness; does not replace QA"
+      "boundary": "supports Quality Readiness; does not replace QA",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "delivery-closeout",
+      "runtimeContractModules": [
+        "closeout",
+        "context-graph",
+        "gate-transition"
+      ],
       "discovery": "automatic",
       "useFor": "commit/PR-near handoff after QA/OR/UAT",
-      "boundary": "never performs VCS actions automatically"
+      "boundary": "never performs VCS actions automatically",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
+    },
+    {
+      "slug": "ur-definition",
+      "runtimeContractModules": [
+        "ur-definition"
+      ],
+      "discovery": "automatic",
+      "useFor": "bound UR drafting, clarification or revision",
+      "boundary": "content only; preserves approved intent",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
+    },
+    {
+      "slug": "prd-definition",
+      "runtimeContractModules": [
+        "prd-definition",
+        "gate-artifact-preparation"
+      ],
+      "discovery": "automatic",
+      "useFor": "bound PRD drafting, clarification or revision",
+      "boundary": "content only; preserves approved intent",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
+    },
+    {
+      "slug": "sd-definition",
+      "runtimeContractModules": [
+        "sd-definition",
+        "gate-artifact-preparation"
+      ],
+      "discovery": "automatic",
+      "useFor": "bound SD content",
+      "boundary": "content only; preserves approved intent",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
+    },
+    {
+      "slug": "tp-definition",
+      "runtimeContractModules": [
+        "tp-definition",
+        "gate-artifact-preparation"
+      ],
+      "discovery": "automatic",
+      "useFor": "bound TP content",
+      "boundary": "content only; preserves approved sources",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "gate-check",
+      "runtimeContractModules": [
+        "gate-transition",
+        "modes",
+        "gate-artifact-preparation"
+      ],
       "discovery": "start_here",
-      "useFor": "new build/change intent, unclear approval, Structured Delivery, later-gate artefact requested",
-      "boundary": "does not create later artefacts or skip Mode/Slice Decision after Brownfield Review"
+      "useFor": "delivery control and gate readiness",
+      "boundary": "delegates drafts; never approves or skips gates",
+      "dispatch": {
+        "mode": "deterministic_control",
+        "deterministicCommand": "gate-check",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "qa-gate",
+      "runtimeContractModules": [
+        "quality",
+        "context-graph",
+        "gate-transition"
+      ],
       "discovery": "automatic",
       "useFor": "sole final Quality Readiness decision",
-      "boundary": "only instance for `pass | revise | block`"
+      "boundary": "only instance for `pass | revise | block`",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "release-or",
+      "runtimeContractModules": [
+        "closeout",
+        "quality",
+        "context-graph",
+        "control-scaffold"
+      ],
       "discovery": "automatic",
       "useFor": "auditable closeout for every relevant run",
-      "boundary": "not a QA substitute"
+      "boundary": "not a QA substitute",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "task-plan-review",
+      "runtimeContractModules": [
+        "quality",
+        "context-graph",
+        "gate-transition"
+      ],
       "discovery": "automatic",
       "useFor": "evidence dimension: verify whether the approved Task Plan was fulfilled",
-      "boundary": "supports Quality Readiness; no final QA decision"
+      "boundary": "supports Quality Readiness; no final QA decision",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     }
   ],
   "distributionProfiles": {
@@ -301,31 +559,19 @@
       "generatedRepository": "agdf-repo"
     },
     "profiles": {
-      "source-development": {
-        "runtime": "absent",
-        "installable": false,
-        "machineValidation": "unavailable"
-      },
-      "runtime-plugin": {
-        "runtime": "required",
-        "installable": true,
-        "machineValidation": "local_exact_version_digest"
-      },
-      "copilot-runtime-plugin": {
-        "runtime": "required",
-        "installable": true,
-        "machineValidation": "local_exact_version_digest_inventory"
-      },
-      "opencode-config-local": {
-        "runtime": "config_local_package",
-        "installable": true,
-        "machineValidation": "local_exact_version"
-      },
-      "portable-skills": {
-        "runtime": "absent",
-        "installable": true,
-        "machineValidation": "unavailable_or_external_required"
-      }
+      "source-development": {"runtime":"absent","installable":false,"machineValidation":"unavailable"},
+      "runtime-plugin": {"runtime":"required","installable":true,"machineValidation":"local_exact_version_digest"},
+      "copilot-runtime-plugin": {"runtime":"required","installable":true,"machineValidation":"local_exact_version_digest_inventory"},
+      "opencode-config-local": {"runtime":"config_local_package","installable":true,"machineValidation":"local_exact_version"},
+      "portable-skills": {"runtime":"absent","installable":true,"machineValidation":"unavailable_or_external_required"}
     }
+  },
+  "hostSupport": {
+    "schema_version": 3,
+    "tiers": {"codex":"qualification_target","claude":"qualification_target","copilot":"experimental","opencode":"experimental"},
+    "required_targets": [{"host":"claude","surface":"cli","os":"win32","scenarios":["dispatch","failure_case","skill_continuation","upgrade","recovery"]},{"host":"codex","surface":"cli","os":"darwin","scenarios":["dispatch","failure_case","skill_continuation","upgrade","recovery"]}],
+    "reported_desktop": [{"host":"codex","surface":"desktop-code","os":"observed","scenarios":["session","upgrade","recovery"]},{"host":"claude","surface":"desktop-code","os":"win32","scenarios":["session","upgrade","recovery"]}],
+    "optional_cli": {"codex":{"codex_version":"0.157.1","model":"gpt-6-luna","platforms":["linux","win32"]}},
+    "unqualified": [{"host":"codex","surface":"cli","os":"linux"},{"host":"codex","surface":"cli","os":"win32"}]
   }
 }

package/generated/plugins/copilot/agdf/meta/agdf-runtime-contract.md CHANGED Viewed

@@ -2,15 +2,23 @@
 This manifest indexes the thematic runtime-contract modules used by AGDF skills and runtime validation.
+<!-- AGDF-RUNTIME-CONTRACT-MODULES:START -->
 | Module | Path | Coverage |
 |---|---|---|
-| Task target resolution | `contracts/task-target-resolution.md` | Primary target authority, evidence/mutation separation, governance derivation, continuation and fail-closed target states |
-| Gate transitions | `contracts/gate-transition.md` | Source precedence, scope ambiguity, gate rules, Brownfield routing and transition model |
-| Interaction | `contracts/interaction.md` | Run Status Card, approval orientation, native interaction and locale contracts |
-| Modes | `contracts/modes.md` | Mode selection, Quick Task, Verified Change, trivial and bug boundaries |
-| Quality | `contracts/quality.md` | Quality readiness, chat discipline and quality output contracts |
-| Context Graph | `contracts/context-graph.md` | Knowledge persistence and Context Graph reconciliation |
-| Control scaffold | `contracts/control-scaffold.md` | Delivery Path Search, run state, CLI verification and Delivery Map |
-| Closeout | `contracts/closeout.md` | Support bridge, relevant-run boundary and non-duplication |
+| Request Activation | `contracts/request-activation.md` | Canonical focused module; follow the linked source for semantics. |
+| Task Target Resolution | `contracts/task-target-resolution.md` | Canonical focused module; follow the linked source for semantics. |
+| Gate Transition | `contracts/gate-transition.md` | Canonical focused module; follow the linked source for semantics. |
+| Gate Artifact Preparation | `contracts/gate-artifact-preparation.md` | Canonical focused module; follow the linked source for semantics. |
+| Interaction | `contracts/interaction.md` | Canonical focused module; follow the linked source for semantics. |
+| Modes | `contracts/modes.md` | Canonical focused module; follow the linked source for semantics. |
+| Quality | `contracts/quality.md` | Canonical focused module; follow the linked source for semantics. |
+| Context Graph | `contracts/context-graph.md` | Canonical focused module; follow the linked source for semantics. |
+| Control Scaffold | `contracts/control-scaffold.md` | Canonical focused module; follow the linked source for semantics. |
+| Closeout | `contracts/closeout.md` | Canonical focused module; follow the linked source for semantics. |
+| UR Definition | `contracts/ur-definition.md` | Canonical focused module; follow the linked source for semantics. |
+| PRD Definition | `contracts/prd-definition.md` | Canonical focused module; follow the linked source for semantics. |
+| SD Definition | `contracts/sd-definition.md` | Canonical focused module; follow the linked source for semantics. |
+| TP Definition | `contracts/tp-definition.md` | Canonical focused module; follow the linked source for semantics. |
+<!-- AGDF-RUNTIME-CONTRACT-MODULES:END -->
-The explanatory framework lives in `docs/`, the operating philosophy in `plugin/meta/agdf-constitution.md`, and the principles in `plugin/meta/agdf-tenets.md`.
+The explanatory framework lives in `docs/`, the operating philosophy in `plugins/agdf/meta/agdf-constitution.md`, and the principles in `plugins/agdf/meta/agdf-tenets.md`.

package/generated/plugins/copilot/agdf/meta/distribution-profile-history.json CHANGED Viewed

@@ -120,6 +120,20 @@
       "profile_id": "runtime-plugin",
       "entry_digest": "a441d633fe11ea402c3366cfac0cec659d32eae5eb4ae6b1d25a1e366a029813",
       "status": "supported"
+    },
+    "0.14.5": {
+      "contract_id": "five-profile-v1",
+      "provenance_schema_version": 1,
+      "profile_id": "runtime-plugin",
+      "entry_digest": "3fbe40f10a3d15e900962c59511f41193089216e1bdbabc642042f4156674477",
+      "status": "supported"
+    },
+    "0.20.0": {
+      "contract_id": "five-profile-v1",
+      "provenance_schema_version": 1,
+      "profile_id": "runtime-plugin",
+      "entry_digest": "0ed8fdc2b3d0ca51ab4ff18d2d4eb0a20a82b2751cd8a181e589f1024c4ced35",
+      "status": "supported"
     }
   }
 }

package/generated/plugins/copilot/agdf/plugin.json CHANGED Viewed

@@ -1,6 +1,7 @@
 {
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "agdf",
-  "version": "0.14.4",
+  "version": "0.20.0",
   "description": "Control layer for governed AI-assisted delivery.",
   "author": {
     "name": "Arndt Gold",
@@ -15,8 +16,5 @@
     "delivery",
     "ai-native",
     "brownfield"
-  ],
-  "category": "Productivity",
-  "skills": "copilot-skills/",
-  "hooks": "hooks/copilot-hooks.json"
+  ]
 }

package/generated/plugins/copilot/agdf/runtime/agdf-local.js CHANGED Viewed

@@ -1,18 +1,19 @@
 #!/usr/bin/env node
-// Generated by create-agdf/scripts/sync-plugin-runtime.js; do not edit.
+// Generated by scripts/sync-plugin-runtime.js; do not edit.
 import { readFileSync } from "node:fs";
 import process from "node:process";
 import { fileURLToPath } from "node:url";
-import { runLocalValidator } from "./create-agdf/lib/runtime/local-validator.js";
+import { resolvePluginHostEnvironment, runLocalValidator } from "./create-agdf/lib/runtime/local-validator.js";
 const runtimeRoot = fileURLToPath(new URL(".", import.meta.url));
 const pluginRoot = fileURLToPath(new URL("../", import.meta.url));
 const manifest = JSON.parse(readFileSync(new URL("./runtime-manifest.json", import.meta.url), "utf8"));
+const hostEnvironment = resolvePluginHostEnvironment(process.env);
 process.exitCode = runLocalValidator({
   runtimeRoot,
   pluginRoot,
-  expectedPluginRoot: process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || undefined,
+  expectedPluginRoot: hostEnvironment.expectedPluginRoot,
   expectedVersion: manifest.version,
-  surface: process.env.AGDF_SURFACE || "plugin",
+  surface: hostEnvironment.surface,
 }, process.argv.slice(2));