create-agdf 0.20.1 → 0.30.0

package/generated/plugins/agdf/meta/contracts/ur-definition.md

@@ -1,11 +1,44 @@
 # AGDF Runtime Contract — UR Definition
 
 This contract guides `ur-definition` only after a non-authorizing, bound
-`skill_continuation` with `phase: ur_definition`. It creates no gate or persistence authority.
+`skill_continuation` with `phase: ur_definition` or `phase: planned_ur_definition`.
+The same owner defines UR content in both modes. It creates no gate or persistence authority.
 
-## Binding and ownership
+## Planning mode before a Run
 
-Use only the returned governance_target, run_id, revision_id, artifact_path and template_path.
+For explicit capture/refinement/priority intent, dispatch this same skill with the confirmed
+target and `planning: {plan_id, expected_digest}`. Use null digest for capture and an inspected
+canonical digest for replacement. Planning is mutually exclusive with Run/revision, delivery
+intake, continue_delivery and source-revision selectors. Do not enter Run assignment to save a
+planned need. The optional planning plugin orchestrates this mode; Core owns its semantics.
+
+Follow `phase: planned_ur_definition` only. Read every returned authoring-inputs page for the
+version-matched UR template, current source and `planning_capability`. Use the same need,
+clarification, preview, language and summary rules below. An incomplete draft remains saveable
+with clarification open. Planning stops at UR and minimal metadata: never author planned PRD,
+SD or TP, present a gate, collect Approval: UR or infer delivery permission.
+
+Use `agdf_record/planned_material.stage` for one UR, then `planned_ur.create` or
+`planned_ur.replace` with that exact planning scope and original mutation UUID. Choose the new
+identity as `plan-<mutation UUID>` without asking the user for an identifier. Creation material
+contains the ordinary UR template without planning scalar fields: Core adds exactly one initial
+`Planning schema: planned-ur-v1`, `Planning id: <plan_id>` and `Planning priority: high|normal|low`.
+Default normal applies only on explicit create. Replacement preserves schema/identity and
+changes priority in that same UR source under its expected digest; no saved parallel title/status.
+No Run-bound material, generic file writer, shell fallback or copied template is permitted.
+
+Return the saved readable title, source reference/digest, priority and remaining clarification.
+Completeness/priority/selection never starts delivery. Only a later explicit request to start from
+the selected current source uses `agdf_run/run.create_from_planned`; read its contract and preserve
+the original UUID after uncertainty. The handoff creates one unapproved Run for normal UR review.
+A different UUID on an already transferred identity returns that Run. Historical planning source
+is read-only afterwards; later product edits use the active Run's existing revision owner.
+Inspect the original operation before retry. Missing/incompatible Core, unsafe/stale source,
+pending recovery or ambiguous origins stop the affected action with concrete diagnosis.
+
+## Run mode binding and ownership
+
+For `phase: ur_definition`, use only the returned governance_target, run_id, revision_id, artifact_path and template_path.
 template_path is the absolute, version-matched template owned by the installed plugin runtime.
 Repository copies under `.agdf/control/templates/` are derived scaffold references and never
 override this authoring source. Read the template without rewriting it; persist only artifact_path.
@@ -42,7 +75,7 @@ Preserve the requirement and name a concrete recovery or obtain an explicit scop
 cannot be delivered. Record the responsible later UX/PRD step in Next Step; UR authoring still
 writes only its assigned UR, not a preview or product implementation. A requested before-PRD preview
 is created through UX intent clarification under the existing post-UR routing owner. Its durable
-output belongs to `.agdf/control/artefacts/<run_id>/previews/` for the bound run; the UX skill owns
+output belongs to `.agdf/control/runs/<run_id>/evidence/previews/` for the bound run; the UX skill owns
 creation, versioning, evidence and references. An inline chat rendering alone does not fulfill that
 run deliverable. In a new UR, set exactly one initial metadata line before the first section:
 `Preview requirement: before_prd_interactive` for a required interactive before-PRD preview,
@@ -79,15 +112,16 @@ For new-format URs, a missing or invalid required summary returns to this same a
 route before presentation. Correct it through the existing revision writer; no user approval
 is required merely to complete an unapproved incomplete draft.
 
-## Revision and recording
+## Run mode revision and recording
 
 A new draft is recorded through existing run-step --step ur --title <short title>, using
 --dir <governance_target> --run <run_id> --revision <revision_id>.
 For an already registered unapproved draft, require explicit user revision intent. Resume
 through gate-check with intake true, intake_mode resume, run_id, expected_revision_id and
 ur_action revise (CLI --ur-action revise). Ordinary intake of a ready draft still presents it.
-After editing a registered draft use existing run-update, not run-step: the previous seal
-must be replaced by the canonical revision writer. Never edit an approved UR or its approval.
+Stage the replacement and use ur_draft.replace with the current binding. The writer
+publishes the document and typed evidence atomically. Never edit bound bytes, reseal
+an unknown change or alter an approved UR or its approval.
 Use the returned new revision, redispatch gate-check for this target/run, prepare the fresh
 run-present when supplied, show its returned text verbatim and wait for a NEW deliberate
 `Approval: UR`. Previous presentations/replies cannot approve a changed draft.

package/generated/plugins/agdf/meta/copilot-payload-baseline.json

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
   "profile_id": "copilot-runtime-plugin",
-  "max_files": 397,
-  "max_bytes": 3493331,
-  "rationale": "Release 0.20.1 metadata only: canonical version serialization adds 834 bytes to each of two plugin-definition copies and the exact historical release record adds 257 bytes; 397 files, 3493331 bytes measured with verified source mappings and digests, zero headroom; no Copilot runtime behavior change."
+  "max_files": 453,
+  "max_bytes": 4717872,
+  "rationale": "PR #50 integration follow-up: fresh canonical initialization seeds no shared Backlog in either layout; historical v4 material recovery has an explicit legacy fixture. Exact generated Copilot closure: 453 files / 4717872 bytes (-112 from 7aff94dc), no reserve; time, schema and safety limits unchanged."
 }

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

@@ -141,6 +141,20 @@
       "profile_id": "runtime-plugin",
       "entry_digest": "ac320d0a30e2cf4cfe31c89cbf63c00350c42b50f84f62aa0ad1d366ca90e35d",
       "status": "supported"
+    },
+    "0.20.2": {
+      "contract_id": "five-profile-v1",
+      "provenance_schema_version": 1,
+      "profile_id": "runtime-plugin",
+      "entry_digest": "1b194df6abf5de884b4d69ab38cde567b5c28674f392ef853678800e05de7e65",
+      "status": "supported"
+    },
+    "0.30.0": {
+      "contract_id": "five-profile-v1",
+      "provenance_schema_version": 1,
+      "profile_id": "runtime-plugin",
+      "entry_digest": "05a4645b92ab7f33c40ae676f7e92c95f618b86e3fc031684cfbac8bf6b21ce6",
+      "status": "supported"
     }
   }
 }

package/generated/plugins/agdf/runtime/agdf-session-check.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // Generated by scripts/sync-plugin-runtime.js; do not edit.
-import { spawnSync } from "node:child_process";
+import { execFile } from "node:child_process";
 import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { isAbsolute, join } from "node:path";
@@ -107,26 +107,18 @@ if (process.argv.length !== 2) {
   let repositoryControl;
   const deadline = Date.now() + 10000;
   if (repositoryRoot) {
-    const child = spawnSync(process.execPath, [validator, "doctor", "--all-active", "--json", "--dir", repositoryRoot], {
-      cwd: repositoryRoot,
-      env: { ...process.env, AGDF_SURFACE: process.env.AGDF_SURFACE || "plugin" },
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "pipe"],
-      timeout: 10000,
-      maxBuffer: 1024 * 1024,
+    const runtimeEnv = { ...process.env, AGDF_SURFACE: process.env.AGDF_SURFACE || "plugin" };
+    // Doctor runs beside the compatibility inspection: run first, it can exhaust the shared deadline alone.
+    const doctorOutput = new Promise((resolveDoctor) => {
+      const child = execFile(process.execPath, [validator, "doctor", "--all-active", "--json", "--dir", repositoryRoot], {
+        cwd: repositoryRoot,
+        env: runtimeEnv,
+        encoding: "utf8",
+        timeout: 10000,
+        maxBuffer: 1024 * 1024,
+      }, (_error, stdout) => resolveDoctor(stdout));
+      child.stdin?.end();
     });
-    try {
-      const report = JSON.parse(child.stdout || "{}");
-      const supportedStatuses = new Set(["pass", "warn", "revise", "block"]);
-      const rawStatus = typeof report.status === "string" ? report.status : "unknown";
-      const rawFindings = report.summary?.findings ?? report.reports?.reduce((sum, item) => sum + (item.summary?.findings ?? 0), 0) ?? 0;
-      check = {
-        status: supportedStatuses.has(rawStatus) ? rawStatus : "unknown",
-        findings: Number.isSafeInteger(rawFindings) && rawFindings >= 0 ? Math.min(rawFindings, 999999) : 0,
-      };
-    } catch {
-      check = { status: "unavailable", findings: 0 };
-    }
     const configPath = join(repositoryRoot, ".agdf", "control", "config.json");
     configState = "missing";
     if (existsSync(configPath)) {
@@ -152,13 +144,25 @@ if (process.argv.length !== 2) {
       }
     }
     repositoryControl = inspectStartupCompatibility({ target: repositoryRoot, executable: process.execPath,
-      validator, env: { ...process.env, AGDF_SURFACE: process.env.AGDF_SURFACE || "plugin" }, deadline });
+      validator, env: runtimeEnv, deadline });
     const invocation = startupMaintenanceInvocation(repositoryControl, { executable: process.execPath,
       validator, language: languages?.chat || "en" });
     if (invocation) {
       repositoryControl.invocation = invocation;
       repositoryControl.notice = renderStartupControlNotice(repositoryControl, { language: languages?.chat || "en" });
     }
+    try {
+      const report = JSON.parse((await doctorOutput) || "{}");
+      const supportedStatuses = new Set(["pass", "warn", "revise", "block"]);
+      const rawStatus = typeof report.status === "string" ? report.status : "unknown";
+      const rawFindings = report.summary?.findings ?? report.reports?.reduce((sum, item) => sum + (item.summary?.findings ?? 0), 0) ?? 0;
+      check = {
+        status: supportedStatuses.has(rawStatus) ? rawStatus : "unknown",
+        findings: Number.isSafeInteger(rawFindings) && rawFindings >= 0 ? Math.min(rawFindings, 999999) : 0,
+      };
+    } catch {
+      check = { status: "unavailable", findings: 0 };
+    }
   }
   const facts = {
     context_state: hostContext.context_state,

package/generated/plugins/agdf/runtime/create-agdf/generated/plugins/agdf/meta/agdf-defaults.json

@@ -0,0 +1,9 @@
+{
+  "schema_version": 1,
+  "preferences": {
+    "chat_language": "en",
+    "artifact_language": "en",
+    "presentation_route": "markdown",
+    "gate_check_variant": null
+  }
+}

package/generated/plugins/agdf/runtime/create-agdf/generated/plugins/agdf/meta/agdf-defaults.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "preferences"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "preferences": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["chat_language", "artifact_language", "presentation_route", "gate_check_variant"],
+      "properties": {
+        "chat_language": { "type": "string", "maxLength": 64, "pattern": "^[A-Za-z]{2,8}(?:-[A-Za-z0-9]{1,8})*$" },
+        "artifact_language": { "type": "string", "maxLength": 64, "pattern": "^[A-Za-z]{2,8}(?:-[A-Za-z0-9]{1,8})*$" },
+        "presentation_route": { "enum": ["markdown", "automatic", "fallback"] },
+        "gate_check_variant": { "enum": [null, "status-card", "approval-envelope"] }
+      }
+    }
+  }
+}