@kontourai/flow-agents 3.6.0 → 3.7.0

package/build/src/cli/builder-run.js

@@ -1,6 +1,6 @@
 import { flagString, parseArgs } from "../lib/args.js";
-import { cancelBuilderFlowSession, archiveBuilderFlowSession, pauseBuilderFlowSession, recoverBuilderFlowSession, releaseBuilderFlowAssignment, resumeBuilderFlowSession, startBuilderFlowSession, syncBuilderFlowSession, } from "../builder-flow-runtime.js";
-const USAGE = "Usage: flow-agents builder-run <start|sync|recover|pause|resume|cancel|release-assignment|archive> --session-dir <path> [--reason <text> | --authorization-file <path>]";
+import { cancelBuilderFlowSession, archiveBuilderFlowSession, pauseBuilderFlowSession, recoverBuilderFlowSession, releaseBuilderFlowAssignment, resumeBuilderFlowSession, } from "../builder-flow-runtime.js";
+const USAGE = "Usage: flow-agents builder-run <recover|pause|resume|cancel|release-assignment|archive> --session-dir <path> [--reason <text> | --authorization-file <path>]";
 export async function main(argv) {
     const parsed = parseArgs(argv);
     const action = parsed.positionals[0];
@@ -18,7 +18,7 @@ export async function main(argv) {
         console.error("builder-run requires --session-dir .kontourai/flow-agents/<slug>");
         return 64;
     }
-    if (!action || !["start", "sync", "recover", "pause", "resume", "cancel", "release-assignment", "archive"].includes(action)) {
+    if (!action || !["recover", "pause", "resume", "cancel", "release-assignment", "archive"].includes(action)) {
         console.error(USAGE);
         return 64;
     }
@@ -42,21 +42,17 @@ export async function main(argv) {
         console.error(USAGE);
         return 64;
     }
-    const result = action === "start"
-        ? await startBuilderFlowSession({ sessionDir })
-        : action === "sync"
-            ? await syncBuilderFlowSession({ sessionDir })
-            : action === "recover"
-                ? await recoverBuilderFlowSession({ sessionDir })
-                : action === "pause"
-                    ? await pauseBuilderFlowSession({ sessionDir, reason: reason })
-                    : action === "resume"
-                        ? await resumeBuilderFlowSession({ sessionDir, reason: reason })
-                        : action === "cancel"
-                            ? await cancelBuilderFlowSession({ sessionDir, authorizationFile: authorizationFile })
-                            : action === "release-assignment"
-                                ? await releaseBuilderFlowAssignment({ sessionDir, reason: reason })
-                                : await archiveBuilderFlowSession({ sessionDir, authorizationFile: authorizationFile });
+    const result = action === "recover"
+        ? await recoverBuilderFlowSession({ sessionDir })
+        : action === "pause"
+            ? await pauseBuilderFlowSession({ sessionDir, reason: reason })
+            : action === "resume"
+                ? await resumeBuilderFlowSession({ sessionDir, reason: reason })
+                : action === "cancel"
+                    ? await cancelBuilderFlowSession({ sessionDir, authorizationFile: authorizationFile })
+                    : action === "release-assignment"
+                        ? await releaseBuilderFlowAssignment({ sessionDir, reason: reason })
+                        : await archiveBuilderFlowSession({ sessionDir, authorizationFile: authorizationFile });
     console.log(JSON.stringify({
         run_id: result.run.runId,
         definition_id: result.run.definitionId,

package/build/src/cli/workflow-sidecar.d.ts

@@ -174,10 +174,13 @@ export declare function reduceCaptureLogByCommand(commandLog: AnyObj[] | undefin
  * @param timestamp  ISO-8601 timestamp for createdAt / updatedAt / observedAt
  * @param checks     Normalized check objects (from record-evidence --check-json / --surface-trust-json)
  * @param criteria   Acceptance criteria objects (from acceptance.json .criteria array)
- * @param critiques  Critique objects (from critique.json .critiques array)
+ * @param critiques  Critique objects reconstructed from trust.bundle claims
  * @param commandLog Optional parsed command-log.jsonl entries (capture-authoritative fold)
  */
-export declare function buildTrustBundle(slug: string, timestamp: string, checks: AnyObj[], criteria: AnyObj[], critiques: AnyObj[], commandLog?: AnyObj[], flowAgentsDir?: string, actorKey?: string): Promise<AnyObj | null>;
+export declare function buildTrustBundle(slug: string, timestamp: string, checks: AnyObj[], criteria: AnyObj[], critiques: AnyObj[], commandLog?: AnyObj[], flowAgentsDir?: string, actorKey?: string, exactFlowContext?: {
+    flowId: string;
+    stepId: string;
+}): Promise<AnyObj | null>;
 /**
  * Fail-open wrapper: builds (via Surface), validates, and writes a trust.bundle.
  * Accepts raw check/criterion/critique inputs directly (ADR 0010 Phase 4a).
@@ -191,7 +194,10 @@ export declare function buildTrustBundle(slug: string, timestamp: string, checks
  * @param criteria   Acceptance criteria objects (same as buildTrustBundle)
  * @param critiques  Critique objects (same as buildTrustBundle)
  */
-export declare function writeTrustBundle(dir: string, slug: string, timestamp: string, checks: AnyObj[], criteria: AnyObj[], critiques: AnyObj[], actorKey?: string): Promise<{
+export declare function writeTrustBundle(dir: string, slug: string, timestamp: string, checks: AnyObj[], criteria: AnyObj[], critiques: AnyObj[], actorKey?: string, exactFlowContext?: {
+    flowId: string;
+    stepId: string;
+}): Promise<{
     written: boolean;
     errors: string[];
 }>;
@@ -199,6 +205,23 @@ export declare function sidecarBase(slug: string): AnyObj;
 export declare function currentWorkflowSessionDir(root: string): string | null;
 export declare function validateEvidenceRef(ref: AnyObj, label: string): AnyObj;
 export declare function normalizeEvidenceRefs(raw: unknown, label: string): AnyObj[];
+/** Validate test-evidence command shape without executing it. */
+type TestExecutionProof = {
+    kind: "local-process-exit";
+    runner: string;
+    static_test_units: number;
+};
+/**
+ * Produce evidence from the locally executed command and statically reviewable
+ * test units. Runner stdout is deliberately excluded: any executable can print
+ * a Vitest/Jest-looking success summary, but it cannot turn a non-test script
+ * into a supported test workflow or supply this locally-created proof.
+ */
+export declare function testExecutionProof(command: string, projectRoot: string, seenScripts?: Set<string>, packageScriptBody?: boolean): TestExecutionProof | null;
+/** Validate test-evidence command shape without executing it. */
+export declare function isMeaningfulTestCommand(command: string, projectRoot: string, seenScripts?: Set<string>, packageScriptBody?: boolean): boolean;
+export declare function observedExecutedTestCount(output: string): number;
+export declare function inferExecutedTestCount(command: string, projectRoot: string, output: string, seenScripts?: Set<string>): number;
 export declare function normalizeCheck(raw: AnyObj, allowGateClaimPrefix?: boolean, existingCheckStampById?: ReadonlyMap<string, boolean>): AnyObj;
 /**
  * Derive kit identity from a parsed trust.bundle by structurally reading the
@@ -624,4 +647,5 @@ export declare function buildGateInquiryRecords(bundle: BundleFile, blockSignal:
 export declare const LIVENESS_TERMINAL: Set<string>;
 export { buildClaimExplanation } from "./sidecar-claim-explain.js";
 export type { ClaimEvidenceItem, ClaimExplanation } from "./sidecar-claim-explain.js";
-export declare function main(argv?: string[]): Promise<number>;
+export declare function mainFromPublicWorkflow(argv: string[]): Promise<number>;
+export declare function main(argv?: string[], authority?: symbol): Promise<number>;