create-agdf 0.31.0 → 0.32.0

package/runtime/core/lib/control-state/run-inventory.js

@@ -3,7 +3,9 @@
 // Callers pass validity findings from the full parser; this module never validates receipts.
 import { scalarFields, sectionTableRows, projectRunFacts } from "./run-state-document.js";
 import { RUN_ID_PATTERN } from "./run-identity.js";
-import { isDecisionContentPlaceholder } from "../control-evaluation/decision-content-placeholder.js";
+import { normalizedRunTitle, runIdentity } from "./run-title.js";
+
+export { normalizedRunTitle };
 
 export const RUN_INVENTORY_SCHEMA_VERSION = "1";
 export const RUN_INVENTORY_LIFECYCLES = Object.freeze(["active", "completed", "superseded", "abandoned"]);
@@ -42,29 +44,10 @@ const ISO_TIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?Z$/u;
 const plain = value => String(value ?? "").replace(/`/gu, "").trim();
 const clip = text => (text.length > TITLE_LIMIT ? `${text.slice(0, TITLE_LIMIT - 1)}…` : text);
 
-// The run-ID title every reader shows when no authored title exists.
-export function normalizedRunTitle(runId) {
-  const words = String(runId ?? "").replace(/[._-]+/g, " ").replace(/\s+/g, " ").trim();
-  return words ? words.replace(/\b\p{L}/gu, (letter) => letter.toUpperCase()) : "AGDF run";
-}
-
-// Lines of one level-two section up to the next heading; an empty section stays empty.
-function sectionLines(text, heading) {
-  const lines = text.split("\n"), start = lines.findIndex(line => line.trimEnd() === `## ${heading}`);
-  if (start < 0) return [];
-  const rest = lines.slice(start + 1), end = rest.findIndex(line => /^#{1,2} /u.test(line));
-  return end < 0 ? rest : rest.slice(0, end);
-}
-
-function objectiveTitle(text, runId) {
-  // The first paragraph, so hard-wrapped objectives stay whole.
-  const lines = sectionLines(text, "Objective").map(value => value.trim()), first = lines.findIndex(Boolean);
-  const paragraph = first < 0 ? [] : lines.slice(first), end = paragraph.indexOf("");
-  const line = (end < 0 ? paragraph : paragraph.slice(0, end)).join(" ");
-  const stripped = line.replace(/^(?:[-*>]|#+|\d+\.)\s+/u, "").replace(/\*\*|__|`/gu, "").replace(/\s+/gu, " ").trim();
-  return isDecisionContentPlaceholder(stripped)
-    ? { title: normalizedRunTitle(runId), title_source: "run_id" }
-    : { title: clip(stripped), title_source: "objective" };
+// The inventory reads no UR document, so its title source is the Objective or the Run ID.
+function titleFacts(text, runId) {
+  const { title, title_source, objective } = runIdentity({ runId, runContent: text });
+  return { title: clip(title), title_source, objective: objective === null ? null : clip(objective) };
 }
 
 // Base64url receipt cells decoded for display facts only; undecodable cells are skipped.
@@ -126,17 +109,19 @@ function entryOf(source, language) {
   const gateResult = facts?.artefacts.get(gate === 'Quick Task Execution' ? 'CR' : gate)?.status ?? null;
   const presentationDecision = source.observation?.presentation_decision === true;
   const missing = source.observation?.missing === 'none' ? '' : source.observation?.missing ?? '';
-  const attention = runAttention({ lifecycle, valid, decision, gateResult, presentationDecision, missing });
+  const situation = source.observation?.work_situation;
+  const attention = situation?.code ?? runAttention({ lifecycle, valid, decision, gateResult, presentationDecision, missing });
   const revision = /^[1-9]\d*$/u.test(meta.get("revision") ?? "") ? Number(meta.get("revision")) : null;
   const index = languageIndex(language);
   return {
     run_id: runId,
-    ...(text ? objectiveTitle(text, runId) : { title: normalizedRunTitle(runId), title_source: "run_id" }),
+    ...titleFacts(text, runId),
+    ...(source.presentation ? { presentation: source.presentation } : {}),
     valid,
     lifecycle: valid ? lifecycle : null,
     current_gate: gate,
     decision,
-    attention: { code: attention, label: LABELS[attention][index] },
+    attention: { code: attention, label: situation ? (index === 1 ? situation.de : situation.en) : LABELS[attention][index] },
     basis: revision === null ? TEXT.basisUnknown[index]() : TEXT.basis[index](revision),
     last_activity: text ? lastActivity(decoded) : { at: null, source: "none", precision: null },
     revision,

package/runtime/core/lib/control-state/run-presentation-render.js

@@ -355,6 +355,35 @@ function artifactSummary(gate, markdown, { runId, revisionId, language, sourceLa
   return { markdown: summary, digest: hash(summary) };
 }
 
+// Cockpit presentation reuses the same language and summary owner as authoring checks.
+// The structured rows are derived from that summary; no second content authority is created.
+export function projectCockpitSummary(gate, markdown, languages, context = {}) {
+  if (!['UR', 'PRD', 'SD', 'TP'].includes(gate)) return null;
+  try {
+    const readiness = evaluateApprovalSummaryReadiness(gate, markdown, languages, { path: context.artefactPath });
+    if (!readiness.ready) return null;
+    const summary = artifactSummary(gate, markdown, { ...context, language: languages.presentation_language, sourceLanguage: languages.artifact_language });
+    const priorities = {
+      UR: [/^(?:Ziel|Goal)$/iu, /^(?:Umfang|Scope)$/iu, /^(?:Abnahme|Abnahmesignal|Acceptance)$/iu],
+      PRD: [/^(?:Ziel|Nutzerziel|Goal|User intent)$/iu, /^(?:Umfang|Produktumfang|Scope|Product scope)$/iu, /^(?:AC-[A-Z0-9-]+)$/iu],
+      SD: [/^(?:Lösung|Solution)$/iu, /^(?:Verantwortung|Ownership)$/iu, /^(?:Entscheidungen|Design decisions)$/iu],
+      TP: [/^(?:Aufgaben|Tasks)$/iu, /^(?:Tests)$/iu, /^(?:Risiken|Risks)$/iu],
+    };
+    const rows = summary.markdown.split(/\r?\n/u).flatMap(line => {
+      const match = line.match(/^[-*]\s+([^:\n]{1,80}):\s*(\S.*)$/u);
+      return match && match[2].length <= 1200 ? [{ label: match[1].trim(), text: match[2].trim() }] : [];
+    });
+    const items = priorities[gate].flatMap(pattern => {
+      const matches = rows.filter(row => pattern.test(row.label));
+      return matches.length === 1 ? matches : [];
+    });
+    return { state: 'available', gate, items, markdown: summary.markdown, authorizes: false };
+  } catch (error) {
+    if (String(error.message).startsWith('approval_summary_')) return null;
+    throw error;
+  }
+}
+
 // A compact decision brief is a projection of the already validated, source-
 // authored summary. Missing authored fields stay absent; no agent/UI paraphrase.
 export function decisionBriefFromSummary(summary, language) {

package/runtime/core/lib/control-state/run-title.js

@@ -0,0 +1,43 @@
+// One owner for a Run's human title and orienting Objective. Pure: no `node:` import, so the run
+// inventory, the cockpit, the companion run view and the status card share exactly this rule.
+// Precedence: registered UR heading, then the authored Objective, then the normalized Run ID.
+import { isDecisionContentPlaceholder } from "../control-evaluation/decision-content-placeholder.js";
+
+// The run-ID title every reader shows when no authored title exists.
+export function normalizedRunTitle(runId) {
+  const words = String(runId ?? "").replace(/[._-]+/g, " ").replace(/\s+/g, " ").trim();
+  return words ? words.replace(/\b\p{L}/gu, (letter) => letter.toUpperCase()) : "AGDF run";
+}
+
+// A heading as display text: no leading hashes and no inline Markdown marks.
+export function plainHeading(value) {
+  return String(value ?? "").replace(/^#+\s*/u, "").replace(/[`*_]/gu, "").replace(/\s+/gu, " ").trim();
+}
+
+// Lines of one level-two section up to the next heading; an empty section stays empty.
+function sectionLines(text, heading) {
+  const lines = text.split("\n"), start = lines.findIndex(line => line.trimEnd() === `## ${heading}`);
+  if (start < 0) return [];
+  const rest = lines.slice(start + 1), end = rest.findIndex(line => /^#{1,2} /u.test(line));
+  return end < 0 ? rest : rest.slice(0, end);
+}
+
+// The first paragraph of the Objective, so hard-wrapped objectives stay whole. A template prompt,
+// a status word or a bare generated Run ID is no orientation and yields null.
+export function authoredObjective(runContent) {
+  const text = String(runContent ?? "").replace(/^/u, "").replace(/\r\n?/gu, "\n");
+  const lines = sectionLines(text, "Objective").map(value => value.trim()), first = lines.findIndex(Boolean);
+  if (first < 0) return null;
+  const paragraph = lines.slice(first), end = paragraph.indexOf("");
+  const value = (end < 0 ? paragraph : paragraph.slice(0, end)).join(" ")
+    .replace(/^(?:[-*>]|#+|\d+\.)\s+/u, "").replace(/\*\*|__|`/gu, "").replace(/\s+/gu, " ").trim();
+  return isDecisionContentPlaceholder(value) ? null : value;
+}
+
+// `urHeading` is the registered UR document heading without its "UR:" prefix, when the caller read it.
+export function runIdentity({ runId, runContent, urHeading } = {}) {
+  const objective = authoredObjective(runContent), ur = plainHeading(urHeading);
+  if (ur) return { title: ur, title_source: "ur", objective };
+  if (objective) return { title: objective, title_source: "objective", objective };
+  return { title: normalizedRunTitle(runId), title_source: "run_id", objective: null };
+}

package/runtime/core/lib/interaction-catalog-validation.js

@@ -20,7 +20,8 @@ export function validateInteractionCatalog(registry) {
     check(`${language}.decisionCard`, pack.decisionCard, DECISION_CARD_LABEL_KEYS);
     check(`${language}.flowEvidence`, pack.flowEvidence, FLOW_EVIDENCE_LABEL_KEYS);
     check(`${language}.companion.states`, pack.companion?.states, COMPANION_MOODS);
-    check(`${language}.companion.statusStates`, pack.companion?.statusStates, [...COMPANION_MOODS, "unreadable"]);
+    // Beside the moods the status line names a run view that cannot be read and a project without AGDF.
+    check(`${language}.companion.statusStates`, pack.companion?.statusStates, [...COMPANION_MOODS, "unreadable", "notSetUp"]);
     const unreadable = pack.companion?.unreadable;
     check(`${language}.companion.unreadable`, unreadable && Object.fromEntries(COMPANION_UNREADABLE_REASONS.map(key => [key, unreadable[key]])), COMPANION_UNREADABLE_REASONS);
   }

package/runtime/core/lib/interaction-presentation.js

@@ -1,5 +1,6 @@
 import { RUN_ID_PATTERN } from "./control-state/run-identity.js";
-import { normalizedRunTitle, runInventoryHistoryLine } from "./control-state/run-inventory.js";
+import { runInventoryHistoryLine } from "./control-state/run-inventory.js";
+import { authoredObjective, normalizedRunTitle, plainHeading, runIdentity } from "./control-state/run-title.js";
 import { DISPATCH_RECOVERY_CODES, DECISION_CARD_COPY_BUDGETS } from "./interaction-catalog.js";
 import { TASK_TARGET_SOURCES, TASK_TARGET_UNRESOLVED_REASONS } from "./task-target-resolution.js";
 
@@ -229,16 +230,11 @@ function stripMarkdown(value) {
     .trim();
 }
 
-function section(content, heading) {
-  const escaped = heading.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  return content.match(new RegExp(`(?:^|\\n)## ${escaped}\\s*\\n([\\s\\S]*?)(?=\\n## |$)`))?.[1]?.trim() ?? "";
-}
-
 export { normalizedRunTitle };
 
+// The current artefact heading names the card's document; otherwise the shared Run title rule applies.
 export function resolveHumanRunTitle({ currentArtefactHeading, urHeading, runContent, runId }) {
-  const objective = section(String(runContent ?? ""), "Objective").split(/\r?\n/).map(stripMarkdown).find(Boolean) ?? "";
-  return [currentArtefactHeading, urHeading, objective].map(stripMarkdown).find(Boolean) || normalizedRunTitle(runId);
+  return plainHeading(currentArtefactHeading) || runIdentity({ runId, runContent, urHeading }).title;
 }
 
 function displaySafeTitle(value, fallback) {
@@ -271,7 +267,7 @@ export function buildRunCandidates(runs) {
       return {
         run_id: run.run_id,
         display_title: displaySafeTitle(title, normalizedRunTitle(run.run_id)),
-        objective: displaySafeObjective(section(String(run.content ?? ""), "Objective"), normalizedRunTitle(run.run_id)),
+        objective: displaySafeObjective(authoredObjective(run.content), normalizedRunTitle(run.run_id)),
         current_gate: currentGate,
         decision: String(run.control_state?.decision || "unknown").replaceAll("`", "").trim() || "unknown",
         next_allowed_action: String(run.control_state?.next_allowed_action ?? "").trim(),