@voce-engine/cli 0.1.0-rc.3 → 0.1.0-rc.4

package/README.md

@@ -2,8 +2,8 @@
 
 The `voce` command is the offline-first, explicit-path CLI for VOCE v0.1. It does not load lifecycle scripts, discover global packages, inspect credentials, or call a Provider unless the command explicitly selects the built-in `mock` provider.
 
-> `0.1.0-rc.3` is a release candidate, not production-ready. CLI behavior may change before `0.1.0`.
+> `0.1.0-rc.4` is a release candidate, not production-ready. CLI behavior may change before `0.1.0`.
 
 ```bash
-npm install --global @voce-engine/cli@0.1.0-rc.3
+npm install --global @voce-engine/cli@0.1.0-rc.4
 ```

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export declare const CLI_VERSION = "0.1.0-rc.3";
+export declare const CLI_VERSION = "0.1.0-rc.4";
 export declare function runCli(argv?: string[]): Promise<number>;

package/dist/index.js

@@ -2,13 +2,13 @@ import { createHash, randomUUID } from 'node:crypto';
 import { lstat, mkdir, readdir, readFile, realpath, rename, writeFile } from 'node:fs/promises';
 import * as path from 'node:path';
 import * as process from 'node:process';
-import { MOCK_IMAGE_PROFILE, MOCK_JPEG_PROFILE, MOCK_LIMITED_REFERENCE_PROFILE, compileEvaluationReport, computeExecutionRunHash, computeCompilationContextHash, computeOntologyInstanceHash, computeSemanticReviewRequestHash, createConstraintWaiver, createHumanAcceptanceDecision, compileConstraints, compilePromptIR, createReferenceCandidate, planPipeline, planReferences, createScenarioPackRegistry, executeOffline, executeSemanticReview, FixtureReferenceInterpreter, FixtureSemanticReviewer, guardPromptCandidate, renderStaticTraceReport, sha256, traceModelFromExecution, validateStructuralImage, canonicalize, } from '@voce-engine/core';
+import { MOCK_IMAGE_PROFILE, MOCK_JPEG_PROFILE, MOCK_LIMITED_REFERENCE_PROFILE, compileEvaluationReport, computeExecutionRunHash, computeCompilationContextHash, computeOntologyInstanceHash, computeSemanticReviewRequestHash, createConstraintWaiver, createHumanAcceptanceDecision, compileConstraints, compilePromptIR, createReferenceCandidate, planPipeline, planReferences, createScenarioPackRegistry, executeOffline, executeSemanticReview, FixtureReferenceInterpreter, FixtureSemanticReviewer, guardPromptCandidate, renderStaticTraceReport, sha256, traceModelFromExecution, validateStructuralImage, canonicalize, VISUAL_COMPOSITION_CATALOG, computeVisualCompositionCatalogHash, expandVisualCompositionPreset, } from '@voce-engine/core';
 import { FIXTURE_M6_OPAQUE_PNG, fixtureChangeIntent, fixtureM4ConstraintInput, fixtureM5Candidate, fixtureM5ExecutionInput, fixtureM5GuardInput, fixtureM5PromptIR, fixtureM6Artifact, fixtureM6Authorization, fixtureScopePlan, } from '@voce-engine/testkit';
 import { BUNDLE_MANIFEST_SCHEMA_VERSION } from '@voce-engine/contracts';
-export const CLI_VERSION = '0.1.0-rc.3';
+export const CLI_VERSION = '0.1.0-rc.4';
 const TOOL_ID = '@voce-engine/cli';
-const CONTRACTS_VERSION = '0.1.0-rc.3';
-const CORE_VERSION = '0.1.0-rc.3';
+const CONTRACTS_VERSION = '0.1.0-rc.4';
+const CORE_VERSION = '0.1.0-rc.4';
 const SOURCE_SCHEMA = 'voce.scenario-pack-source/v1alpha1';
 const PACK_SCHEMA = 'voce.scenario-pack/v1alpha1';
 const HASH = /^sha256:[0-9a-f]{64}$/;
@@ -351,7 +351,10 @@ function referenceProbeCandidates(probe, ir) {
     });
 }
 function coreProbeEvidence(probe, resolution, caseSpec, profile) {
-    const ir = compileConstraints(probeInput(probe, resolution, caseSpec));
+    const baseInput = probeInput(probe, resolution, caseSpec);
+    const ir = compileConstraints(baseInput);
+    const presetInput = { ...baseInput, changeIntents: [...baseInput.changeIntents, ...expandVisualCompositionPreset('rule-of-thirds')] };
+    const presetIr = compileConstraints(presetInput);
     const evidence = {
         status: ir.status, constraintHash: ir.deterministicSignature, blockingConflictCount: ir.conflicts.filter((item) => item.blocking).length,
         conflictCodes: ir.conflicts.map((item) => item.code).sort(compare), reviewRequirementCount: ir.reviewRequirements.length,
@@ -359,18 +362,25 @@ function coreProbeEvidence(probe, resolution, caseSpec, profile) {
         degradationCount: ir.degradedPreferences.length, personIntentCount: (probe.intents ?? []).filter((item) => item.targetPath.startsWith('person.')).length,
         constraintTargetPaths: ir.constraints.flatMap((item) => item.targetPaths).sort(compare),
         constraintSourceIds: [...new Set(ir.constraints.flatMap((item) => item.sourceIds))].sort(compare),
+        presetId: 'rule-of-thirds', presetConstraintStatus: presetIr.status, presetConstraintHashBefore: ir.deterministicSignature, presetConstraintHashAfter: presetIr.deterministicSignature,
     };
-    if (!probe.references?.length)
-        return evidence;
     const candidates = referenceProbeCandidates(probe, ir);
+    const presetCandidates = referenceProbeCandidates(probe, presetIr);
     const maximumReferenceCount = probe.maximumReferenceCount ?? profile.maximumReferenceCount;
     const plan = planReferences({ schemaVersion: 'voce.reference-planning-input/v1alpha1', caseId: caseSpec.id, caseRevision: caseSpec.revision, contextHash: ir.contextHash, constraintIR: ir, candidates, dependencies: [], profile, budget: { maximumReferenceCount, usedReferenceCount: 0, byteLengthKnown: true, unknownByteLengthAssetIds: [] } });
+    const presetPlan = planReferences({ schemaVersion: 'voce.reference-planning-input/v1alpha1', caseId: caseSpec.id, caseRevision: caseSpec.revision, contextHash: presetIr.contextHash, constraintIR: presetIr, candidates: presetCandidates, dependencies: [], profile, budget: { maximumReferenceCount, usedReferenceCount: 0, byteLengthKnown: true, unknownByteLengthAssetIds: [] } });
     evidence.referenceStatus = plan.status;
     evidence.referencePlanHash = plan.planHash;
     evidence.selectedRoles = plan.ordered.map((item) => item.role).sort(compare);
     evidence.omittedRoles = plan.omitted.map((item) => candidates.find((candidate) => candidate.id === item.candidateId)?.role ?? item.candidateId).sort(compare);
     evidence.blockedRoles = plan.blockedReferences.map((item) => candidates.find((candidate) => candidate.id === item.candidateId)?.role ?? item.candidateId).sort(compare);
     evidence.selectedSourceBindingIds = [...new Set(plan.ordered.flatMap((item) => item.sourceBindingIds))].sort(compare);
+    evidence.presetReferenceCountBefore = plan.ordered.length;
+    evidence.presetReferenceCountAfter = presetPlan.ordered.length;
+    evidence.presetReferencePlanHashBefore = plan.planHash;
+    evidence.presetReferencePlanHashAfter = presetPlan.planHash;
+    if (!probe.references?.length)
+        return evidence;
     if (ir.status !== 'ok' || plan.status !== 'ok') {
         evidence.promptStatus = 'blocked';
         return evidence;
@@ -381,7 +391,7 @@ function coreProbeEvidence(probe, resolution, caseSpec, profile) {
         return evidence;
     }
     const outputContract = probeInput(probe, resolution, caseSpec).outputContract;
-    const prompt = compilePromptIR({ schemaVersion: 'voce.prompt-compilation-input/v1alpha1', caseId: caseSpec.id, caseRevision: caseSpec.revision, context: probeInput(probe, resolution, caseSpec).context, contextHash: ir.contextHash, constraintIR: ir, referencePlan: plan, pipelinePlan: pipelineResult.pipelinePlan, outputContract, targetAdapter: { id: profile.adapterId, version: profile.version, digest: profile.adapterDigest }, targetCapabilityProfile: { id: profile.id, version: profile.version, digest: profile.profileHash } });
+    const prompt = compilePromptIR({ schemaVersion: 'voce.prompt-compilation-input/v1alpha2', caseId: caseSpec.id, caseRevision: caseSpec.revision, context: probeInput(probe, resolution, caseSpec).context, contextHash: ir.contextHash, constraintIR: ir, referencePlan: plan, pipelinePlan: pipelineResult.pipelinePlan, outputContract, targetAdapter: { id: profile.adapterId, version: profile.version, digest: profile.adapterDigest }, targetCapabilityProfile: { id: profile.id, version: profile.version, digest: profile.profileHash }, effectiveScenario: resolution.effectiveScenario });
     evidence.promptStatus = 'ok';
     evidence.promptHash = prompt.deterministicSignature;
     evidence.promptTargetPaths = ir.constraints.filter((constraint) => prompt.constraintCoverage.some((coverage) => coverage.constraintId === constraint.id && (coverage.sectionIds.length > 0 || coverage.referenceMappingIds.length > 0 || coverage.parameterIds.length > 0))).flatMap((constraint) => constraint.targetPaths).sort(compare);
@@ -416,12 +426,16 @@ function scenarioEvidence(scenario) {
     const ontology = contributionArray(scenarioContributions(scenario, 'ontologyVocabulary'), 'paths');
     const scopes = scenarioContributions(scenario, 'interpretationScopes');
     const bindings = contributionArray(scopes, 'bindings');
-    const promptPaths = scenarioContributions(scenario, 'promptSections').flatMap((contribution) => Array.isArray(contribution.requiredPaths) ? contribution.requiredPaths.filter((item) => typeof item === 'string') : []);
+    const promptDefinitions = contributionArray(scenarioContributions(scenario, 'promptSections'), 'sections');
+    const promptPaths = promptDefinitions.flatMap((definition) => Array.isArray(definition.requiredPaths) ? definition.requiredPaths.filter((item) => typeof item === 'string') : []);
+    const promptSectionOrder = promptDefinitions.map((definition) => ({ id: String(definition.id ?? ''), order: typeof definition.order === 'number' ? definition.order : 0 })).filter((item) => item.id).sort((left, right) => left.order - right.order || compare(left.id, right.id)).map((item) => item.id);
     const criteria = semanticCriteriaForScenario(scenario);
     return {
         ontologyPaths: ontology.map((item) => String(item.path ?? '')).filter(Boolean).sort(compare),
         bindingPolicies: bindings.map((item) => `${String(item.assetRole ?? '')}|${String(item.relation ?? '')}|${String(item.targetPath ?? '')}|${String(item.priority ?? '')}`).sort(compare),
         promptTargetPaths: [...new Set(promptPaths)].sort(compare),
+        promptSectionOrder,
+        visualComposition: { catalogId: VISUAL_COMPOSITION_CATALOG.id, catalogHash: computeVisualCompositionCatalogHash(), pathCount: VISUAL_COMPOSITION_CATALOG.paths.length, presetCount: VISUAL_COMPOSITION_CATALOG.presets.length, fullShotChanges: expandVisualCompositionPreset('full-shot').map((item) => ({ targetPath: item.targetPath, ...(item.requestedValue === undefined ? {} : { requestedValue: item.requestedValue }) })) },
         reviewCriterionIds: criteria.map((item) => item.id).sort(compare),
         reviewTargetPaths: criteria.map((item) => item.targetPath).filter((item) => typeof item === 'string').sort(compare),
     };
@@ -733,7 +747,23 @@ async function packTestCommand(source) {
     const failed = results.some((item) => item.status === 'failed');
     return { status: failed ? 'failed' : 'passed', packId: loaded.descriptor.manifest.packId, resolutionHash: resolution.report.reportHash, lockHash: resolution.lock.lockHash, effectiveScenarioHash: resolution.effectiveScenario.effectiveScenarioHash, fixtureCount: results.length, results };
 }
-async function doctorCommand() { const major = Number(process.versions.node.split('.')[0]); return { status: major >= 20 ? 'ok' : 'blocked', node: { version: process.versions.node, supported: major >= 20 }, contracts: { schemaVersion: BUNDLE_MANIFEST_SCHEMA_VERSION, packageVersion: CONTRACTS_VERSION }, paths: { explicitOnly: true }, providers: { default: 'disabled', mock: 'offline', networkProbe: false }, authProbe: { inspected: false } }; }
+async function doctorCommand() {
+    const major = Number(process.versions.node.split('.')[0]);
+    return {
+        status: major >= 20 ? 'ok' : 'blocked',
+        node: { version: process.versions.node, supported: major >= 20 },
+        contracts: { schemaVersion: BUNDLE_MANIFEST_SCHEMA_VERSION, packageVersion: CONTRACTS_VERSION },
+        paths: { explicitOnly: true },
+        providers: { default: 'disabled', mock: 'offline', networkProbe: false },
+        authProbe: { inspected: false },
+        visualComposition: {
+            catalogId: VISUAL_COMPOSITION_CATALOG.id,
+            catalogHash: computeVisualCompositionCatalogHash(),
+            pathCount: VISUAL_COMPOSITION_CATALOG.paths.length,
+            presetCount: VISUAL_COMPOSITION_CATALOG.presets.length,
+        },
+    };
+}
 function required(args, key) { if (!args[key])
     throw new CliError('ARGUMENT_MISSING', `Missing --${key}.`, EXIT.usage); return args[key]; }
 function help() { return `voce ${CLI_VERSION}\n\nOffline-first explicit-path CLI.\n\nCommands:\n  voce pack inspect --source <path> [--json]\n  voce pack validate --source <path> [--json]\n  voce pack test --source <path> [--json]\n  voce case compile --case <file> --scenario <path> --profile <file> --out <dir> [--json]\n  voce case run --bundle <dir> --provider mock --out <dir> [--json]\n  voce trace render --bundle <dir> --out <html> [--json]\n  voce compare --before <dir> --after <dir> [--out <file>] [--json]\n  voce doctor [--json]\n\nExit codes: 0 success, 2 usage, 3 input, 4 contract/hash, 5 offline/provider, 6 output, 7 internal.`; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voce-engine/cli",
-  "version": "0.1.0-rc.3",
+  "version": "0.1.0-rc.4",
   "description": "Offline-first command line tools for the VOCE v0.1 release candidate.",
   "license": "Apache-2.0",
   "type": "module",
@@ -36,9 +36,9 @@
     "tag": "next"
   },
   "dependencies": {
-    "@voce-engine/contracts": "0.1.0-rc.3",
-    "@voce-engine/core": "0.1.0-rc.3",
-    "@voce-engine/testkit": "0.1.0-rc.3"
+    "@voce-engine/contracts": "0.1.0-rc.4",
+    "@voce-engine/core": "0.1.0-rc.4",
+    "@voce-engine/testkit": "0.1.0-rc.4"
   },
   "scripts": {
     "build": "tsc -b"