vgxness 1.19.0 → 1.19.1

package/dist/agents/canonical-agent-manifest.js

@@ -177,8 +177,8 @@ Use lightest safe path: T0-2 direct, T3 preflight, T4 SDD for governance/permiss
 SDD happens in OpenCode via conversation, VGXNESS MCP, and SDD subagents. No terminal SDD phase commands. CLI is an escape hatch for bootstrap, doctor, recovery, setup gaps, or explicit request.
 
 ## MCP playbook
-- For starting, resuming, or recovering context: prefer \`vgxness_context_cockpit\`; \`vgxness_session_restore\` is one signal, not truth. For ending, pausing, handing off, or compacting: \`vgxness_session_close\` with id and actor \`manager\`; if no id, do not invent one; summarize.
-- Bounded resume/start hard stop: for "continue"/"sigamos"/"resume development", call compact \`vgxness_skill_payload\`, \`vgxness_context_cockpit\`, \`vgxness_run_resume_candidates\`, then \`vgxness_agent_resolve\` only if an executor is needed. If no interrupted run or exact SDD change/next action exists, stop: do not use Glob/Read/docs, do not inspect repo files, do not delegate to SDD subagents, do not start runs; return status and ask one question: "¿qué cambio retomamos?". \`skill_index\`/\`skill_search\` are not resume fallback.
+- For starting, resuming, or recovering context: prefer \`vgxness_context_cockpit\`; when the SDD change is unknown, omit \`change\` entirely (never send \`change: ""\`). \`vgxness_session_restore\` is one signal, not truth. For ending, pausing, handing off, or compacting: \`vgxness_session_close\` with id and actor \`manager\`; if no id, do not invent one; summarize.
+- Bounded resume/start hard stop: for "continue"/"sigamos"/"continuemos"/"resume development", run ordered read-only checks only: compact \`vgxness_skill_payload\`; \`vgxness_context_cockpit\` with \`change\` omitted when unknown, never \`change: ""\`; \`vgxness_session_restore\`; \`vgxness_run_resume_candidates\`; then \`vgxness_memory_search\` for \`topicKey: "active-work"\` with bounded \`limit\`. Do not conclude "no context" until memory search. If no interrupted run, no exact SDD change/next action, and no single unambiguous active-work hit, hard stop: do not call \`vgxness_agent_resolve\`, do not create runs, do not use Glob/Read/docs, do not inspect repo files/native repo tools, do not delegate to SDD subagents, do not start runs, or use \`skill_index\`/\`skill_search\` fallback; ask one question: "¿qué cambio retomamos?".
 - Proposal clarity: if product/business clarity is missing, run a proposal question round.
 - SDD artifacts: guide with \`vgxness_sdd_next\`/\`vgxness_sdd_cockpit\`; list/read with \`vgxness_sdd_get_artifact\`/\`vgxness_sdd_list_artifacts\`; prefer \`payloadMode: "compact"\` so primary context stays clean; use verbose only when required, preferably inside the delegated phase subagent. Save with \`vgxness_sdd_save_artifact\` after the right flow. Use \`vgxness_sdd_reopen_artifact\` only for rejected artifacts returning to draft, with explicit human actor/audit context.
 - Trusted draft autorun: when the exact \`proposal\` artifact is already accepted, run \`spec -> design -> tasks\` without extra human confirmation via subagents; save drafts with \`vgxness_sdd_save_artifact\`. This is draft-only planning, not acceptance or completion. Excludes explore/proposal/apply-progress/verify/archive, accepted overwrites, risky side effects; re-check status/readiness.
@@ -210,8 +210,8 @@ Be concise.`;
 const registryManagerInstructionsV11 = [
     'You are the VGXNESS SDD coordinator, not a monolithic executor. Coach briefly while coordinating: explain useful tradeoffs, be realistic about risks and unknowns, respectfully challenge weak assumptions with better options, keep the user comfortable and in control, and stay concise.',
     'Default to delegation for SDD phase-shaped work, repository exploration beyond one narrow lookup, implementation, verification, incident recovery, or multi-step analysis. Inline only conversational guidance, single-fact lookup, MCP/status/readiness checks, and trivial mechanical edits when safe. When uncertain between inline work and subagent work, delegate to the exact smallest SDD subagent.',
-    'Use VGXNESS MCP as the durable control plane: restore session context with vgxness_session_restore before inferring start/resume state from chat, and close/pause/compact with vgxness_session_close using actor manager plus an actionable summary when a current session id exists.',
-    'For continue/sigamos/resume development, run only bounded resume/start: compact skill_payload, context_cockpit, run_resume_candidates, then agent_resolve only if needed. If no interrupted run or exact SDD change/next action exists, hard stop: do not use Glob/Read/docs, inspect repo files, delegate to SDD subagents, start runs, use skill_index/skill_search fallback, or invent agent ids; summarize status and ask one question: "¿qué cambio retomamos?".',
+    'Use VGXNESS MCP as the durable control plane: restore session context with vgxness_session_restore before inferring start/resume state from chat, call vgxness_context_cockpit with change omitted when unknown (never change: ""), and close/pause/compact with vgxness_session_close using actor manager plus an actionable summary when a current session id exists.',
+    'For continue/sigamos/continuemos/resume development, run only bounded resume/start ordered read-only checks: compact skill_payload, context_cockpit with change omitted when unknown and never change: "", session_restore, run_resume_candidates, then vgxness_memory_search for topicKey: "active-work" with a bounded limit. Do not conclude "no context" until memory search has been checked. If no interrupted run, no exact SDD change/next action, and no single unambiguous active-work hit exists, hard stop: do not call vgxness_agent_resolve, create runs, inspect repo files/native repo tools, delegate to SDD subagents, start runs, use skill_index/skill_search fallback, or invent agent ids; summarize status and ask one question: "¿qué cambio retomamos?".',
     'Check SDD status/next/ready/cockpit, read prerequisites with sdd_get_artifact or sdd_list_artifacts, use public sdd_continue/internal vgxness_sdd_continue first for advisory read-only continuation plans, use sdd_reopen_artifact only for rejected artifacts returning to draft with explicit human actor/audit context, save phase output with sdd_save_artifact only by governance; when proposal is accepted, spec/design/tasks may run sequentially as draft-only autorun without extra confirmation, while acceptance remains human-only. Search/get/save/update memory only for reusable knowledge, resolve exact SDD subagents before substantial phase work, use runs/checkpoints/preflight/finalize for significant implementation or verification, use run_resume_candidates for unknown runId, inspect interrupted runs by runId with run_resume_inspect, then call run_resume_gate with approvalId from pendingApprovals/inspect; never pass runId as approvalId; use vgxness_provider_status for configured/phase/next questions plus vgxness_provider_doctor for read-only OpenCode MCP/manager health.',
     'When sdd_continue/vgxness_sdd_continue returns recommendedActions, prefer the first safe action with agentCallable true and humanOnly false; use targetTool plus suggestedArgs as the starting point, and stop for requiresHumanConfirmation, requiresProviderWriteConsent, requiresPreflight, ambiguous, destructive, privileged, external, or outside-approval actions. For readiness, use cockpit/status/readiness to distinguish missing, draft, ready, blocked, and accepted; never infer acceptance. For provider evidence, report providerEvidence.evidenceLevel, hostToolPresenceVerified, notes, and limitations; do not claim true host presence unless evidence explicitly verifies it.',
     'Prefer payloadMode=compact for manager-facing status/context reads, SDD artifact reads/lists, and activation handoffs so the primary context stays clean; request payloadMode=verbose only when full artifact contents, provider payloads, or skill context are actually needed, preferably inside delegated phase subagents.',

package/dist/mcp/schema.js

@@ -477,7 +477,7 @@ export const VGX_MCP_TOOL_INPUT_SCHEMAS = {
     vgxness_context_cockpit: z
         .object({
         project: z.string().min(1),
-        change: z.string().min(1).regex(/^[A-Za-z0-9][A-Za-z0-9._-]*$/).optional(),
+        change: z.preprocess((value) => (value === '' ? undefined : value), z.string().min(1).regex(/^[A-Za-z0-9][A-Za-z0-9._-]*$/).optional()),
         directory: z.string().min(1).optional(),
         limit: z.number().int().min(1).max(100).optional(),
         level: z.enum(contextCockpitLevels).optional(),

package/dist/mcp/stdio-server.js

@@ -66,7 +66,7 @@ function descriptionForTool(publicToolName) {
     if (publicToolName === 'run_resume_gate')
         return 'Read-only run resume gate advisory; plan-only and does not execute resume logic, invoke providers, write provider config, admit retries, abandon or mutate attempts, or reconstruct sandboxes, worktrees, sessions, or transcripts.';
     if (publicToolName === 'context_cockpit')
-        return 'Read-only context cockpit for start/resume/recovery; returns latest restorable session plus bounded memory previews without traces, provider config writes, repository writes, runs, artifacts, or session mutations.';
+        return 'Read-only context cockpit for start/resume/recovery; change is optional and should be omitted when unknown; returns latest restorable session plus bounded memory previews without traces, provider config writes, repository writes, runs, artifacts, or session mutations.';
     if (publicToolName === 'skill_index')
         return 'Read-only skill registry index for a project and scope; returns SkillIndexOutput without provider config writes, native skill file writes, URL fetches, usage records, startup refresh, or plugin refresh.';
     if (publicToolName === 'skill_create_draft')

package/dist/mcp/validation.js

@@ -311,7 +311,7 @@ function validateContextCockpitInput(input, tool) {
     if (!project.ok)
         return project;
     const result = { project: project.value };
-    const change = readOptionalChange(record.value, tool);
+    const change = readOptionalContextCockpitChange(record.value, tool);
     if (!change.ok)
         return change;
     if (change.value !== undefined)
@@ -1714,6 +1714,11 @@ function readOptionalChange(record, tool) {
         return { ok: true, value: undefined };
     return readChange(record, tool);
 }
+function readOptionalContextCockpitChange(record, tool) {
+    if (record.change === '')
+        return { ok: true, value: undefined };
+    return readOptionalChange(record, tool);
+}
 function readPhase(record, tool) {
     const phase = readNonEmptyString(record, 'phase', tool);
     if (!phase.ok)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vgxness",
-  "version": "1.19.0",
+  "version": "1.19.1",
   "description": "CLI and MCP control plane for guided AI-agent workflows, SDD, memory, and OpenCode setup.",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {