projscan 4.3.0 → 4.4.0

package/dist/core/startExecutionPlan.js

@@ -0,0 +1,185 @@
+import { isPlaceholder } from './startIntentTargets.js';
+import { argsAreReady, executionCursor, isRunnableCommand, proofCommandToolCall, uniqueStrings, } from './startResume.js';
+export function buildMissionExecutionPlan(input) {
+    const phases = [];
+    const readyStepIds = input.readyActions.map((_, index) => `ready-${index + 1}`);
+    const inputStepIdsByPlaceholder = new Map(input.unresolvedInputs.map((item, index) => [item.placeholder, `input-${index + 1}`]));
+    const nextActionStep = actionToExecutionStep('next-action-1', input.primaryAction);
+    phases.push({
+        id: 'next_action',
+        title: 'Next Action',
+        status: nextActionStep.status,
+        steps: [nextActionStep],
+    });
+    if (input.readyActions.length > 0) {
+        phases.push({
+            id: 'ready_now',
+            title: 'Ready Commands',
+            status: 'ready',
+            steps: input.readyActions.map((action, index) => {
+                const step = actionToExecutionStep(`ready-${index + 1}`, action);
+                const unlockedInputs = Array.from(inputStepIdsByPlaceholder.values());
+                if (index === 0 && unlockedInputs.length > 0)
+                    step.unlocks = unlockedInputs;
+                return step;
+            }),
+        });
+    }
+    if (input.unresolvedInputs.length > 0) {
+        phases.push({
+            id: 'resolve_inputs',
+            title: 'Resolve Inputs',
+            status: 'blocked',
+            steps: input.unresolvedInputs.map((item, index) => {
+                const id = `input-${index + 1}`;
+                const followUps = followUpIdsForPlaceholder(input.actionPlan, item.placeholder);
+                return {
+                    id,
+                    kind: 'input',
+                    status: 'blocked',
+                    label: item.name,
+                    ...(readyStepIds[0] ? { dependsOn: [readyStepIds[0]] } : {}),
+                    ...(followUps.length > 0 ? { unlocks: followUps } : {}),
+                    placeholder: item.placeholder,
+                    instruction: item.instruction,
+                };
+            }),
+        });
+    }
+    const pendingActions = input.actionPlan.filter((action) => !isReadyAction(action));
+    if (pendingActions.length > 0) {
+        phases.push({
+            id: 'follow_up',
+            title: 'Follow Up',
+            status: 'pending',
+            steps: pendingActions.map((action, index) => {
+                const step = actionToExecutionStep(`follow-up-${index + 1}`, action);
+                const blockedBy = placeholdersInAction(action)
+                    .map((placeholder) => inputStepIdsByPlaceholder.get(placeholder))
+                    .filter((id) => typeof id === 'string');
+                if (blockedBy.length > 0) {
+                    step.blockedBy = blockedBy;
+                    step.dependsOn = uniqueStrings([readyStepIds[0] ?? '', ...blockedBy].filter(Boolean));
+                }
+                return step;
+            }),
+        });
+    }
+    if (input.proofCommands.length > 0) {
+        phases.push({
+            id: 'proof',
+            title: 'Proof',
+            status: 'ready',
+            steps: input.proofCommands.map((command, index) => proofStep(command, index)),
+        });
+    }
+    phases.push({
+        id: 'done_when',
+        title: 'Done When',
+        status: 'pending',
+        steps: input.successCriteria.map((criterion, index) => ({
+            id: `criterion-${index + 1}`,
+            kind: 'criterion',
+            status: 'pending',
+            label: criterion,
+        })),
+    });
+    const cursor = executionCursor(phases);
+    return {
+        summary: executionPlanSummary(input.readyActions.length, input.unresolvedInputs.length, input.proofCommands.length),
+        currentPhase: cursor.phaseId,
+        cursor,
+        phases,
+    };
+}
+export function actionToExecutionStep(id, action) {
+    const step = {
+        id,
+        kind: 'tool',
+        status: executionStatusForAction(action),
+        label: action.label,
+    };
+    if (typeof action.command === 'string')
+        step.command = action.command;
+    if (typeof action.tool === 'string')
+        step.tool = action.tool;
+    if (action.args)
+        step.args = action.args;
+    return step;
+}
+function followUpIdsForPlaceholder(actionPlan, placeholder) {
+    return actionPlan
+        .filter((action) => !isReadyAction(action))
+        .map((action, index) => ({ action, id: `follow-up-${index + 1}` }))
+        .filter(({ action }) => placeholdersInAction(action).includes(placeholder))
+        .map(({ id }) => id);
+}
+export function placeholdersInAction(action) {
+    const placeholders = new Set();
+    if (typeof action.command === 'string') {
+        for (const match of action.command.matchAll(/<[^<>]+>/g))
+            placeholders.add(match[0]);
+    }
+    collectPlaceholdersFromValue(action.args, placeholders);
+    return Array.from(placeholders);
+}
+function collectPlaceholdersFromValue(value, placeholders) {
+    if (typeof value === 'string') {
+        if (isPlaceholder(value))
+            placeholders.add(value);
+        return;
+    }
+    if (Array.isArray(value)) {
+        for (const item of value)
+            collectPlaceholdersFromValue(item, placeholders);
+        return;
+    }
+    if (value && typeof value === 'object') {
+        for (const item of Object.values(value))
+            collectPlaceholdersFromValue(item, placeholders);
+    }
+}
+export function executionStatusForAction(action) {
+    if (isReadyAction(action))
+        return 'ready';
+    if ((typeof action.command === 'string' && !isRunnableCommand(action.command)) ||
+        !argsAreReady(action.args)) {
+        return 'blocked';
+    }
+    return 'pending';
+}
+export function isReadyAction(action) {
+    if (typeof action.command === 'string' && !isRunnableCommand(action.command))
+        return false;
+    if (!argsAreReady(action.args))
+        return false;
+    return typeof action.command === 'string' || typeof action.tool === 'string';
+}
+function proofStep(command, index) {
+    const toolCall = proofCommandToolCall(command);
+    return {
+        id: `proof-${index + 1}`,
+        kind: 'proof',
+        status: 'ready',
+        label: command,
+        command,
+        ...(toolCall
+            ? {
+                tool: toolCall.tool,
+                ...(typeof toolCall.args !== 'undefined' ? { args: toolCall.args } : {}),
+            }
+            : {}),
+    };
+}
+export function executionPlanSummary(readyCount, inputCount, proofCount) {
+    const pieces = [`Run ${readyCount} ready ${pluralize(readyCount, 'step')}`];
+    if (inputCount > 0)
+        pieces.push(`resolve ${inputCount} input(s)`);
+    if (proofCount > 0)
+        pieces.push(`then gather ${proofCount} proof command(s)`);
+    return `${pieces.join(', ')}.`;
+}
+function pluralize(count, singular) {
+    return count === 1 ? singular : `${singular}s`;
+}
+//# sourceMappingURL=startExecutionPlan.js.map

package/dist/core/startExecutionPlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startExecutionPlan.js","sourceRoot":"","sources":["../../src/core/startExecutionPlan.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAW1B,MAAM,UAAU,yBAAyB,CACvC,KAAqC;IAErC,MAAM,MAAM,GAA0B,EAAE,CAAC;IACzC,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,SAAS,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IAChF,MAAM,yBAAyB,GAAG,IAAI,GAAG,CACvC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CACtF,CAAC;IACF,MAAM,cAAc,GAAG,qBAAqB,CAAC,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IACnF,MAAM,CAAC,IAAI,CAAC;QACV,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,aAAa;QACpB,MAAM,EAAE,cAAc,CAAC,MAAM;QAC7B,KAAK,EAAE,CAAC,cAAc,CAAC;KACxB,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,WAAW;YACf,KAAK,EAAE,gBAAgB;YACvB,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;gBAC9C,MAAM,IAAI,GAAG,qBAAqB,CAAC,SAAS,KAAK,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBACjE,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,MAAM,EAAE,CAAC,CAAC;gBACtE,IAAI,KAAK,KAAK,CAAC,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC;oBAAE,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC;gBAC5E,OAAO,IAAI,CAAC;YACd,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,gBAAgB;YACpB,KAAK,EAAE,gBAAgB;YACvB,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAsB,EAAE;gBACpE,MAAM,EAAE,GAAG,SAAS,KAAK,GAAG,CAAC,EAAE,CAAC;gBAChC,MAAM,SAAS,GAAG,yBAAyB,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;gBAChF,OAAO;oBACL,EAAE;oBACF,IAAI,EAAE,OAAO;oBACb,MAAM,EAAE,SAAS;oBACjB,KAAK,EAAE,IAAI,CAAC,IAAI;oBAChB,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5D,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvD,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;iBAC9B,CAAC;YACJ,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IACnF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,WAAW;YACf,KAAK,EAAE,WAAW;YAClB,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;gBAC1C,MAAM,IAAI,GAAG,qBAAqB,CAAC,aAAa,KAAK,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBACrE,MAAM,SAAS,GAAG,oBAAoB,CAAC,MAAM,CAAC;qBAC3C,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,yBAAyB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;qBAChE,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC;gBACxD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;oBAC3B,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;gBACxF,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,OAAO;YACX,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAC5B,CAAC,OAAO,EAAE,KAAK,EAAsB,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAClE;SACF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,IAAI,CAAC;QACV,EAAE,EAAE,WAAW;QACf,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,CAC9B,CAAC,SAAS,EAAE,KAAK,EAAsB,EAAE,CAAC,CAAC;YACzC,EAAE,EAAE,aAAa,KAAK,GAAG,CAAC,EAAE;YAC5B,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,SAAS;SACjB,CAAC,CACH;KACF,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO;QACL,OAAO,EAAE,oBAAoB,CAC3B,KAAK,CAAC,YAAY,CAAC,MAAM,EACzB,KAAK,CAAC,gBAAgB,CAAC,MAAM,EAC7B,KAAK,CAAC,aAAa,CAAC,MAAM,CAC3B;QACD,YAAY,EAAE,MAAM,CAAC,OAAO;QAC5B,MAAM;QACN,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,EAAU,EACV,MAAgC;IAEhC,MAAM,IAAI,GAAuB;QAC/B,EAAE;QACF,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,wBAAwB,CAAC,MAAM,CAAC;QACxC,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;IACF,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;QAAE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IACtE,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAC7D,IAAI,MAAM,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,yBAAyB,CAChC,UAAsC,EACtC,WAAmB;IAEnB,OAAO,UAAU;SACd,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;SAC1C,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;SAClE,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;SAC1E,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAgC;IACnE,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACvC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;YAAE,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACvF,CAAC;IACD,4BAA4B,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACxD,OAAO,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,4BAA4B,CAAC,KAAc,EAAE,YAAyB;IAC7E,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,aAAa,CAAC,KAAK,CAAC;YAAE,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClD,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,4BAA4B,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC3E,OAAO;IACT,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,4BAA4B,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAgC;IACvE,IAAI,aAAa,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC;IAC1C,IACE,CAAC,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1E,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,EAC1B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAgC;IAC5D,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3F,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC/E,CAAC;AAED,SAAS,SAAS,CAAC,OAAe,EAAE,KAAa;IAC/C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC/C,OAAO;QACL,EAAE,EAAE,SAAS,KAAK,GAAG,CAAC,EAAE;QACxB,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,OAAO;QACf,KAAK,EAAE,OAAO;QACd,OAAO;QACP,GAAG,CAAC,QAAQ;YACV,CAAC,CAAC;gBACE,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,GAAG,CAAC,OAAO,QAAQ,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzE;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,UAAkB,EAClB,UAAkB,EAClB,UAAkB;IAElB,MAAM,MAAM,GAAG,CAAC,OAAO,UAAU,UAAU,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5E,IAAI,UAAU,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,WAAW,UAAU,WAAW,CAAC,CAAC;IAClE,IAAI,UAAU,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,eAAe,UAAU,mBAAmB,CAAC,CAAC;IAC9E,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACjC,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,QAAgB;IAChD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC;AACjD,CAAC"}

package/dist/core/startHarness.d.ts

@@ -0,0 +1,3 @@
+import type { SessionCoordinationHint } from '../types.js';
+export declare function detectStartHarnessHints(rootPath: string): Promise<SessionCoordinationHint[]>;
+export declare function prioritizeStartHarnessHints(coordinationHints: SessionCoordinationHint[]): SessionCoordinationHint[];

package/dist/core/startHarness.js

@@ -0,0 +1,47 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+export async function detectStartHarnessHints(rootPath) {
+    const [agentLoopFiles, agentFlightFiles] = await Promise.all([
+        existingRootFiles(rootPath, ['AGENTLOOP.md', 'agentloop.config.json']),
+        existingRootFiles(rootPath, ['.agentflight/config.json']),
+    ]);
+    const hints = [];
+    if (agentLoopFiles.length > 0) {
+        hints.push({
+            id: 'agentloop-task-contract',
+            label: 'Start with the AgentLoop task contract',
+            message: `Local AgentLoop harness detected (${agentLoopFiles.join(', ')}); inspect the active task contract before changing code.`,
+            command: 'npm exec agentloop -- status',
+        });
+    }
+    if (agentFlightFiles.length > 0) {
+        hints.push({
+            id: 'agentflight-verification',
+            label: 'Run AgentFlight verification evidence',
+            message: `Local AgentFlight harness detected (${agentFlightFiles.join(', ')}); run local verification before handoff.`,
+            command: 'npm exec agentflight -- verify',
+        });
+    }
+    return hints;
+}
+export function prioritizeStartHarnessHints(coordinationHints) {
+    const harnessHints = coordinationHints.filter(isHarnessCoordinationHint);
+    const otherHints = coordinationHints.filter((hint) => !isHarnessCoordinationHint(hint));
+    return [...harnessHints, ...otherHints].slice(0, 3);
+}
+function isHarnessCoordinationHint(hint) {
+    return hint.id === 'agentloop-task-contract' || hint.id === 'agentflight-verification';
+}
+async function existingRootFiles(rootPath, files) {
+    const checks = await Promise.all(files.map(async (file) => {
+        try {
+            await fs.access(path.join(rootPath, file));
+            return file;
+        }
+        catch {
+            return undefined;
+        }
+    }));
+    return checks.filter((file) => typeof file === 'string');
+}
+//# sourceMappingURL=startHarness.js.map

package/dist/core/startHarness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startHarness.js","sourceRoot":"","sources":["../../src/core/startHarness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAAgB;IAEhB,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC3D,iBAAiB,CAAC,QAAQ,EAAE,CAAC,cAAc,EAAE,uBAAuB,CAAC,CAAC;QACtE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,0BAA0B,CAAC,CAAC;KAC1D,CAAC,CAAC;IACH,MAAM,KAAK,GAA8B,EAAE,CAAC;IAC5C,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,yBAAyB;YAC7B,KAAK,EAAE,wCAAwC;YAC/C,OAAO,EAAE,qCAAqC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,2DAA2D;YAClI,OAAO,EAAE,8BAA8B;SACxC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,0BAA0B;YAC9B,KAAK,EAAE,uCAAuC;YAC9C,OAAO,EAAE,uCAAuC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,2CAA2C;YACtH,OAAO,EAAE,gCAAgC;SAC1C,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,iBAA4C;IAE5C,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC;IACzE,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC;IACxF,OAAO,CAAC,GAAG,YAAY,EAAE,GAAG,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,yBAAyB,CAAC,IAA6B;IAC9D,OAAO,IAAI,CAAC,EAAE,KAAK,yBAAyB,IAAI,IAAI,CAAC,EAAE,KAAK,0BAA0B,CAAC;AACzF,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,QAAgB,EAAE,KAAe;IAChE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AAC3E,CAAC"}

package/dist/core/startIntentTargets.d.ts

@@ -0,0 +1,24 @@
+import type { GraphQueryDirection } from './graphQuery.js';
+export type StartGraphQuery = {
+    direction: GraphQueryDirection;
+    file?: string;
+    symbol?: string;
+    limit?: number;
+};
+export declare function extractSearchQuery(intent: string): string;
+export declare function extractImpactTarget(intent: string): string | undefined;
+export declare function extractFileTarget(intent: string): string | undefined;
+export declare function extractClaimTarget(intent: string): string | undefined;
+export declare function extractClaimAgent(intent: string): string | undefined;
+export declare function extractIssueIdTarget(intent: string): string | undefined;
+export declare function extractPackageTarget(intent: string): string | undefined;
+export declare function extractAuditPackageTarget(intent: string): string | undefined;
+export declare function graphQueryFromIntent(intent: string): StartGraphQuery | undefined;
+export declare function graphQueryIsReady(query: StartGraphQuery): boolean;
+export declare function semanticGraphCommand(query: StartGraphQuery): string;
+export declare function isFilePathTarget(target: string): boolean;
+export declare function isExactSymbolTarget(target: string): boolean;
+export declare function isPlaceholder(value: string): boolean;
+export declare function escapeDoubleQuoted(value: string): string;
+export declare function quoteShellArg(value: string): string;
+export declare function quoteShellArgOrPlaceholder(value: string): string;