@vecteur/cli 0.4.1 → 0.4.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vecteur/cli",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "type": "module",
   "bin": {
     "vecteur": "bin/vecteur.js"

package/src/contract.js

@@ -1,5 +1,5 @@
 // GENERATED by scripts/gen-contract.mjs from owner TypeScript projections.
-export const OWNER_CONTRACT_IDENTITY = "api-sha256:5fe54838e61336acc12ae1ff2409970a21fac99c7457383ca9c7a6d8c6e882cc;run-wire-sha256:c2be4d29000bba5cb6c8af58826360c61d627ef5738e89249e1f5577cde95107";
+export const OWNER_CONTRACT_IDENTITY = "api-sha256:5fe54838e61336acc12ae1ff2409970a21fac99c7457383ca9c7a6d8c6e882cc;run-wire-sha256:79ea7f059ca20d8f66533d76d90342915487199f7e59fd73c2058a0d55fb0b3a";
 export const RECOVERY_ACTIONS = Object.freeze({"delete_project":{"label":"Delete a project","href":"/projects"},"upgrade_plan":{"label":"Upgrade your plan","href":"/dashboard/billing"},"wait_for_reset":{"label":"Wait until the UTC reset","href":null}});
 export const EVENT_KINDS = Object.freeze(["source","step_started","step_finished","synthesis","artifact","cta","state_advanced","terminal","heartbeat","assistant_delta","step_label","context_frame","knowledge_binding","engineering_projection","provider_attempt","clarification"]);
 export const TERMINAL_FIELDS = Object.freeze(["answer","defect","evidence_dag","instruction_source","intent","missing_input_need","missing_inputs","provider_retry_offer","recovery","state","steps"]);
@@ -45,3 +45,248 @@ const usage=(v)=>exact(v,["coverage","provider_id","model_id","observed_at","bil
 export const validateAdmitted=(v)=>shape(v,["run_id","state_hash","result_hash","requested_route_id","profile","terminal","usage","events"],["duration_seconds"])&&[v.run_id,v.state_hash,v.result_hash,v.requested_route_id,v.profile].every(text)&&["ok","partial","blocked","refused","infeasible_physics","capability_gap"].includes(v.terminal)&&usage(v.usage)&&Array.isArray(v.events)&&(v.duration_seconds===undefined||v.duration_seconds===null||(integer(v.duration_seconds)&&v.duration_seconds>=0));
 export const validatePatCreated=(v)=>exact(v,["id","name","token","prefix","project_id","scopes","created_at","expires_at"])&&[v.id,v.name,v.token,v.prefix].every(text)&&(v.project_id===null||text(v.project_id))&&Array.isArray(v.scopes)&&v.scopes.every(s=>["project:read","project:execute"].includes(s))&&integer(v.created_at)&&integer(v.expires_at);
 export const validateDeviceAuthorization=(v)=>exact(v,["device_code","user_code","verification_uri","verification_uri_complete","expires_at","interval"])&&[v.device_code,v.user_code,v.verification_uri,v.verification_uri_complete].every(text)&&integer(v.expires_at)&&integer(v.interval)&&v.interval>=0;
+// --- frontend/src/run/tasks.ts, transpiled: the task projection the canvas and this door share ---
+export function stepVerb(step) {
+    return (step.method?.verb ?? '').replace(/^mcp__[a-z0-9]+__/i, '');
+}
+const PROGRAM_ROW = /^call_(\d+)_steps$/;
+export function programNodes(step) {
+    if (stepVerb(step) !== 'run_program')
+        return null;
+    const nodes = [];
+    for (const row of step.inputs ?? []) {
+        if (!PROGRAM_ROW.test(row.name) || !Array.isArray(row.value))
+            continue;
+        for (const entry of row.value) {
+            if (!entry || typeof entry !== 'object' || Array.isArray(entry))
+                return null;
+            const { bind, verb } = entry;
+            if (typeof bind !== 'string' || typeof verb !== 'string' || !verb)
+                return null;
+            nodes.push({ bind, verb });
+        }
+    }
+    return nodes.length ? nodes : null;
+}
+export function attemptState(step) {
+    const produced = (step.outputs ?? []).length > 0;
+    if (!produced && (step.refusals ?? []).length > 0)
+        return 'refused';
+    return produced ? 'computed' : 'open';
+}
+function attemptOf(step) {
+    const state = attemptState(step);
+    return { step, state, code: state === 'refused' ? (step.refusals?.[0]?.code ?? 'refused') : null };
+}
+export function taskGroups(steps) {
+    const tasks = [];
+    let open = null;
+    for (const step of steps) {
+        const verb = stepVerb(step);
+        if (verb === 'thinking')
+            continue;
+        const nodes = programNodes(step);
+        const verbs = nodes ? [...new Set(nodes.map((node) => node.verb))] : [];
+        if (nodes && open && verbs.some((verb) => open.verbs.includes(verb))) {
+            const attempt = attemptOf(step);
+            open.attempts.push(attempt);
+            if (attempt.state === 'refused')
+                open.refused.push(attempt);
+            for (const verb of verbs)
+                if (!open.verbs.includes(verb))
+                    open.verbs.push(verb);
+            open.state = attempt.state;
+            if (attempt.state === 'computed')
+                open = null;
+            continue;
+        }
+        const attempt = attemptOf(step);
+        const task = {
+            id: step.id, program: nodes !== null, verbs,
+            attempts: [attempt], refused: attempt.state === 'refused' ? [attempt] : [],
+            state: attempt.state,
+        };
+        tasks.push(task);
+        if (nodes)
+            open = attempt.state === 'computed' ? null : task;
+        else if (verb !== 'phys_search')
+            open = null;
+    }
+    return tasks;
+}
+const INTENT_ROW = /^call_(\d+)_intent$/;
+const MISSION_ROW = /^call_(\d+)_(intent|hoisted_requirements|unmet_wanted)$/;
+const UNMET_ROW = /^call_(\d+)_unmet_wanted$/;
+const HOISTED_ROW = /^call_(\d+)_hoisted_requirements$/;
+export function isIntentRow(name) {
+    return MISSION_ROW.test(name);
+}
+const words = (value) => (Array.isArray(value) ? value.filter((item) => typeof item === 'string' && item.trim() !== '').map((item) => item.trim()) : []);
+function asThresholds(value) {
+    if (!Array.isArray(value))
+        return [];
+    const out = [];
+    for (const row of value) {
+        if (!row || typeof row !== 'object' || Array.isArray(row))
+            continue;
+        const { quantity, comparator, limit, unit, quote } = row;
+        if (typeof quantity !== 'string' || typeof comparator !== 'string' || typeof limit !== 'number' || typeof quote !== 'string')
+            continue;
+        out.push({ quantity, comparator, limit, unit: typeof unit === 'string' ? unit : '', quote });
+    }
+    return out;
+}
+export function stepIntent(step) {
+    let found = null;
+    for (const row of step.inputs ?? []) {
+        if (!INTENT_ROW.test(row.name))
+            continue;
+        const value = row.value;
+        if (typeof value === 'string') {
+            found = { title: value.trim(), rationale: '', wanted: [], thresholds: [] };
+            continue;
+        }
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            continue;
+        const { title, rationale, wanted, thresholds } = value;
+        found = {
+            title: typeof title === 'string' ? title.trim() : '',
+            rationale: typeof rationale === 'string' ? rationale.trim() : '',
+            wanted: words(wanted),
+            thresholds: asThresholds(thresholds),
+        };
+    }
+    return found;
+}
+export function hoistedRequirements(step) {
+    const out = [];
+    for (const row of step.inputs ?? []) {
+        if (!HOISTED_ROW.test(row.name) || !Array.isArray(row.value))
+            continue;
+        for (const entry of row.value) {
+            if (!entry || typeof entry !== 'object' || Array.isArray(entry))
+                continue;
+            const { quantity, comparator, limit, unit } = entry;
+            if (typeof quantity !== 'string' || typeof comparator !== 'string' || typeof limit !== 'number')
+                continue;
+            out.push({ quantity: quantity.replace(/^\$/, ''), comparator, limit, unit: typeof unit === 'string' ? unit : '' });
+        }
+    }
+    return out;
+}
+export function hoistedQuotes(step) {
+    const quotes = new Map();
+    const thresholds = stepIntent(step)?.thresholds ?? [];
+    for (const row of hoistedRequirements(step)) {
+        const matches = thresholds.filter((threshold) => (threshold.comparator === row.comparator && threshold.limit === row.limit && threshold.unit === row.unit));
+        if (matches.length === 1)
+            quotes.set(row.quantity, matches[0].quote);
+    }
+    return quotes;
+}
+export function unmetWanted(step) {
+    let found = [];
+    for (const row of step.outputs ?? []) {
+        if (!row || typeof row !== 'object')
+            continue;
+        const { name, value } = row;
+        if (typeof name === 'string' && UNMET_ROW.test(name))
+            found = words(value);
+    }
+    return found;
+}
+const sameWords = (left, right) => {
+    const norm = (value) => value.replace(/[.!?]+$/u, '').replace(/\s+/g, ' ').trim().toLowerCase();
+    const a = norm(left);
+    return Boolean(a) && a === norm(right);
+};
+export function intentTitle(step) {
+    const recorded = (step.title ?? '').trim();
+    const intent = stepIntent(step);
+    return recorded && intent && sameWords(recorded, intent.title) ? recorded : '';
+}
+export const ENGINEERING_VERBS = {
+    analyze_acquisition_contact_latency: 'Acquisition-to-contact latency',
+    analyze_eclipse_profile: 'Eclipse profile',
+    close_link: 'Link closure',
+    resolve_payload: 'Image resolution',
+    resolve_utc_interval: 'Time window',
+    sample_projection: 'Sampled projection',
+    select_propulsion: 'Propulsion selection',
+    size_access: 'Coverage and revisit',
+    size_annual_power: 'Annual power',
+    size_burn_sequence: 'Burn sequence',
+    size_delta_v_budget: 'Delta-v budget',
+    size_drag_makeup: 'Drag make-up',
+    size_ground_contacts: 'Ground contacts',
+    size_hohmann_transfer: 'Hohmann transfer',
+    size_hybrid_transfer: 'Hybrid transfer',
+    size_in_view: 'Satellites in view',
+    size_orbit: 'Orbit geometry',
+    size_phase_duration: 'Phasing duration',
+    size_platform: 'Platform sizing',
+    size_pnt_geometry: 'Navigation geometry',
+    size_power: 'Power system',
+    size_propellant: 'Propellant',
+    size_raan_change: 'Plane change',
+    size_repeat_orbit: 'Repeat orbit',
+    size_station_keeping: 'Station keeping',
+    size_topology: 'Topology search',
+    size_transfer: 'Orbit transfer',
+};
+export function engineeringVerbLabel(verb) {
+    return ENGINEERING_VERBS[verb] ?? verb.replace(/^size_/, '').replaceAll('_', ' ')
+        .replace(/^./, (letter) => letter.toUpperCase());
+}
+export function taskTitle(task) {
+    for (let index = task.attempts.length - 1; index >= 0; index -= 1) {
+        const attempt = task.attempts[index];
+        if (attempt.state !== 'computed')
+            continue;
+        const title = intentTitle(attempt.step);
+        if (title)
+            return title;
+    }
+    return task.verbs.map(engineeringVerbLabel).join(' · ');
+}
+export function taskRationale(task) {
+    for (let index = task.attempts.length - 1; index >= 0; index -= 1) {
+        const rationale = stepIntent(task.attempts[index].step)?.rationale ?? '';
+        if (rationale)
+            return rationale;
+    }
+    return '';
+}
+export const REFUSAL_WORDS = {
+    support_mismatch: 'sources',
+    unit_error: 'units',
+    authoring_defect: 'program',
+    owner_refusal: 'bound',
+    INVALID_TOOL_OUTPUT: 'output',
+    missing_knowledge_dependency: 'knowledge',
+    capability_gap: 'capability',
+    budget: 'budget',
+    missing_input: 'input',
+};
+export function taskStateWord(task) {
+    if (task.state === 'open')
+        return 'no result';
+    if (task.state !== 'refused')
+        return task.state;
+    const word = REFUSAL_WORDS[task.attempts[task.attempts.length - 1]?.code ?? ''];
+    return word ? `refused — ${word}` : 'refused';
+}
+export function taskUnmet(task) {
+    if (task.state !== 'computed')
+        return [];
+    return unmetWanted(task.attempts[task.attempts.length - 1].step);
+}
+export function taskMeta(task) {
+    const count = task.attempts.length;
+    const unmet = taskUnmet(task).length;
+    return [
+        taskStateWord(task),
+        count > 1 ? `${count} attempts` : '',
+        unmet ? `${unmet} still to compute` : '',
+    ].filter(Boolean).join(' · ');
+}

package/src/format.js

@@ -1,6 +1,6 @@
 import {
   ORIGIN_KINDS, ORIGIN_WORD, TERMINAL_FIELDS, TERMINAL_RECOVERY_DECLARATIONS,
-  validateArtifact, validateSynthesis,
+  isIntentRow, taskGroups, taskMeta, taskTitle, validateArtifact, validateSynthesis,
 } from "./contract.js";
 import { CliError } from "./errors.js";
 
@@ -64,7 +64,8 @@ export function originWord(origin) {
 /** `name = value unit  (origin word, ref)` — one line per input, in wire order. */
 export function inputLines(inputs) {
   if (!Array.isArray(inputs)) return [];
-  return inputs.map((row) => {
+  // `call_N_intent` is the step's title and rationale (v1.9.36), not one of its inputs.
+  return inputs.filter((row) => !isIntentRow(String(row?.name ?? ""))).map((row) => {
     const unit = typeof row?.unit === "string" && row.unit ? ` ${row.unit}` : "";
     const word = originWord(row?.origin);
     // The REF is what makes the word actionable — "your file" is a category, "your file
@@ -76,6 +77,28 @@ export function inputLines(inputs) {
   });
 }
 
+/**
+ * TASK OVER STEPS, SPOKEN BY THIS DOOR TOO.
+ *
+ * The owner's hybrid run of 2026-09-11 was eleven model turns for one objective, nine of them
+ * refused `run_program` calls. `taskGroups` in `contract.js` — the same bytes the canvas
+ * renders, generated from `frontend/src/run/tasks.ts` — folds them into the tasks the reader
+ * asked for: one line per task, its verbs as the title, what it is and how many attempts it
+ * took. Binding receipts (`binding-*`) are the workspace register's rows, not work.
+ */
+export function taskLines(events) {
+  const steps = events.flatMap((event) => {
+    if (event?.kind !== "step_finished") return [];
+    const step = event.payload?.step ?? event.payload;
+    return step && typeof step === "object" && typeof step.id === "string"
+      && !step.id.startsWith("binding-") ? [step] : [];
+  });
+  return taskGroups(steps).filter((task) => task.program).map((task) => {
+    const refused = task.refused.length ? ` (${task.refused.length} refused)` : "";
+    return `  ${plainLine(`${taskTitle(task)} — ${taskMeta(task)}${refused}`)}`;
+  });
+}
+
 function shellQuote(value) {
   return `'${String(value).replaceAll("'", `'"'"'`)}'`;
 }
@@ -166,8 +189,10 @@ export function humanRun(value, { projectId, cost } = {}) {
   if (!artifacts.every(validateArtifact)) {
     throw new CliError("artifact_invalid", "Run carries malformed artifact metadata");
   }
+  const tasks = taskLines(value.events);
   const lines = [];
   if (terminal.answer !== undefined) lines.push(terminal.answer, "");
+  if (tasks.length) lines.push("Tasks:", ...tasks, "");
   if (origins.length) lines.push("Inputs and origins:", ...origins, "");
   if (artifacts.length) {
     lines.push("Artifacts:");