feat(miner): wire the real runMinerAttempt call into attempt-cli.js

.gittensory-ams.yml.example

@@ -58,3 +58,12 @@ capLimits:
 convergenceThresholds:
   maxConsecutiveFailures: 3
   maxReenqueues: 3
+
+# Hard ceiling on the iterate loop's own iteration count for one attempt.
+# A non-integer is floored; 0 abandons before the first driver invocation.
+# Default: 3.
+maxIterations: 3
+
+# Per-iteration turn budget passed to the coding-agent driver.
+# A non-integer is floored. Default: 6.
+maxTurnsPerIteration: 6

packages/gittensory-engine/README.md

@@ -646,8 +646,8 @@ the existence check — so a caller reads the returned path and feeds its conten
 ## AmsPolicySpec
 
 `AmsPolicySpec` is the type surface for `.gittensory-ams.yml` — the OPERATOR's own execution-risk policy for
-their miner (`submissionMode`, `slopThreshold`, `capLimits`, `convergenceThresholds`), a deliberate structural
-sibling to `MinerGoalSpec` but answering a different question: `MinerGoalSpec` is what the target repo wants
+their miner (`submissionMode`, `slopThreshold`, `capLimits`, `convergenceThresholds`, `maxIterations`,
+`maxTurnsPerIteration`), a deliberate structural sibling to `MinerGoalSpec` but answering a different question: `MinerGoalSpec` is what the target repo wants
 from being mined; `AmsPolicySpec` is how aggressive the operator wants their own agent to be. No field on this
 type lets a target repo's own file loosen what an operator's agent is willing to do — see the type's own header
 comment for why that boundary is load-bearing. `DEFAULT_AMS_POLICY_SPEC` is deny-by-default: `"observe"`

packages/gittensory-engine/src/ams-policy-spec.ts

@@ -52,6 +52,11 @@ export type AmsPolicySpec = {
   capLimits: AmsCapLimits;
   /** Non-convergence detector thresholds. Default: {@link DEFAULT_PORTFOLIO_CONVERGENCE_THRESHOLDS}. */
   convergenceThresholds: PortfolioConvergenceThresholds;
+  /** Hard ceiling on the iterate loop's own iteration count (IterateLoopInput.maxIterations). Default: 3. */
+  maxIterations: number;
+  /** Per-iteration turn budget passed to the coding-agent driver (IterateLoopInput.maxTurnsPerIteration).
+   *  Default: 6. */
+  maxTurnsPerIteration: number;
 };
 
 /** The tolerant parser result for `.gittensory-ams.yml`. Mirrors `ParsedMinerGoalSpec`'s present/warnings shape. */
@@ -70,6 +75,8 @@ export const DEFAULT_AMS_POLICY_SPEC: Readonly<AmsPolicySpec> = Object.freeze({
   slopThreshold: "low",
   capLimits: Object.freeze({ budget: 5, turns: 20, elapsedMs: 1_800_000 }),
   convergenceThresholds: Object.freeze({ ...DEFAULT_PORTFOLIO_CONVERGENCE_THRESHOLDS }),
+  maxIterations: 3,
+  maxTurnsPerIteration: 6,
 });
 
 const MAX_AMS_POLICY_SPEC_BYTES = 8_192;
@@ -80,6 +87,8 @@ function cloneDefaultAmsPolicySpec(): AmsPolicySpec {
     slopThreshold: DEFAULT_AMS_POLICY_SPEC.slopThreshold,
     capLimits: { ...DEFAULT_AMS_POLICY_SPEC.capLimits },
     convergenceThresholds: { ...DEFAULT_AMS_POLICY_SPEC.convergenceThresholds },
+    maxIterations: DEFAULT_AMS_POLICY_SPEC.maxIterations,
+    maxTurnsPerIteration: DEFAULT_AMS_POLICY_SPEC.maxTurnsPerIteration,
   };
 }
 
@@ -110,6 +119,13 @@ function normalizePositiveNumber(value: unknown, field: string, fallback: number
   return value;
 }
 
+/** Like normalizePositiveNumber, but floors to a whole count -- for fields that are semantically integer
+ *  counts (an iteration/turn budget), matching MinerGoalSpec's own normalizePositiveInteger convention. */
+function normalizeNonNegativeInteger(value: unknown, field: string, fallback: number, warnings: string[]): number {
+  const normalized = normalizePositiveNumber(value, field, fallback, warnings);
+  return Math.floor(normalized);
+}
+
 function normalizeCapLimits(value: unknown, fallback: AmsCapLimits, warnings: string[]): AmsCapLimits {
   if (value === undefined || value === null) return fallback;
   if (typeof value !== "object" || Array.isArray(value)) {
@@ -154,7 +170,9 @@ function hasConfiguredPolicyFields(spec: AmsPolicySpec): boolean {
     spec.capLimits.turns !== DEFAULT_AMS_POLICY_SPEC.capLimits.turns ||
     spec.capLimits.elapsedMs !== DEFAULT_AMS_POLICY_SPEC.capLimits.elapsedMs ||
     spec.convergenceThresholds.maxConsecutiveFailures !== DEFAULT_AMS_POLICY_SPEC.convergenceThresholds.maxConsecutiveFailures ||
-    spec.convergenceThresholds.maxReenqueues !== DEFAULT_AMS_POLICY_SPEC.convergenceThresholds.maxReenqueues
+    spec.convergenceThresholds.maxReenqueues !== DEFAULT_AMS_POLICY_SPEC.convergenceThresholds.maxReenqueues ||
+    spec.maxIterations !== DEFAULT_AMS_POLICY_SPEC.maxIterations ||
+    spec.maxTurnsPerIteration !== DEFAULT_AMS_POLICY_SPEC.maxTurnsPerIteration
   );
 }
 
@@ -190,6 +208,13 @@ export function parseAmsPolicySpec(raw: unknown): ParsedAmsPolicySpec {
       DEFAULT_AMS_POLICY_SPEC.convergenceThresholds,
       warnings,
     ),
+    maxIterations: normalizeNonNegativeInteger(record.maxIterations, "maxIterations", DEFAULT_AMS_POLICY_SPEC.maxIterations, warnings),
+    maxTurnsPerIteration: normalizeNonNegativeInteger(
+      record.maxTurnsPerIteration,
+      "maxTurnsPerIteration",
+      DEFAULT_AMS_POLICY_SPEC.maxTurnsPerIteration,
+      warnings,
+    ),
   };
   if (!hasConfiguredPolicyFields(spec)) {
     warnings.push("AmsPolicySpec contained no recognized non-default policy fields; falling back to safe defaults.");

packages/gittensory-engine/test/ams-policy-spec-parser.test.ts

@@ -38,6 +38,8 @@ test("parseAmsPolicySpec: valid raw config normalizes every field and keeps non-
     slopThreshold: "clean",
     capLimits: { budget: 10, turns: 40, elapsedMs: 3_600_000 },
     convergenceThresholds: { maxConsecutiveFailures: 5, maxReenqueues: 2 },
+    maxIterations: 5,
+    maxTurnsPerIteration: 10,
   });
 
   assert.equal(parsed.present, true);
@@ -46,10 +48,30 @@ test("parseAmsPolicySpec: valid raw config normalizes every field and keeps non-
     slopThreshold: "clean",
     capLimits: { budget: 10, turns: 40, elapsedMs: 3_600_000 },
     convergenceThresholds: { maxConsecutiveFailures: 5, maxReenqueues: 2 },
+    maxIterations: 5,
+    maxTurnsPerIteration: 10,
   });
   assert.deepEqual(parsed.warnings, []);
 });
 
+test("parseAmsPolicySpec: maxIterations/maxTurnsPerIteration floor to whole counts and reject negative/non-numeric values", () => {
+  const floored = parseAmsPolicySpec({ maxIterations: 4.9, maxTurnsPerIteration: 8.2 });
+  assert.equal(floored.spec.maxIterations, 4);
+  assert.equal(floored.spec.maxTurnsPerIteration, 8);
+  assert.deepEqual(floored.warnings, []);
+
+  const zero = parseAmsPolicySpec({ maxIterations: 0, submissionMode: "enforce" });
+  assert.equal(zero.spec.maxIterations, 0);
+
+  const negative = parseAmsPolicySpec({ maxIterations: -1 });
+  assert.equal(negative.spec.maxIterations, DEFAULT_AMS_POLICY_SPEC.maxIterations);
+  assert.match(negative.warnings.join(" "), /maxIterations/i);
+
+  const nonNumeric = parseAmsPolicySpec({ maxTurnsPerIteration: "many" });
+  assert.equal(nonNumeric.spec.maxTurnsPerIteration, DEFAULT_AMS_POLICY_SPEC.maxTurnsPerIteration);
+  assert.match(nonNumeric.warnings.join(" "), /maxTurnsPerIteration/i);
+});
+
 test("parseAmsPolicySpec: submissionMode rejects an unrecognized value", () => {
   const parsed = parseAmsPolicySpec({ submissionMode: "yolo" });
   assert.equal(parsed.spec.submissionMode, "observe");

packages/gittensory-miner/lib/attempt-cli.d.ts

@@ -1,13 +1,16 @@
 import type { CodingAgentExecutionMode } from "@jsonbored/gittensory-engine";
-import type { AttemptDeps } from "./attempt-runner.js";
+import type { AttemptDeps, runMinerAttempt } from "./attempt-runner.js";
 import type { ClaimLedger } from "./claim-ledger.js";
 import type { EventLedger } from "./event-ledger.js";
 import type { AttemptLog } from "./attempt-log.js";
 import type { GovernorLedger } from "./governor-ledger.js";
 import type { WorktreeAllocator } from "./worktree-allocator.js";
 import type { resolveRejectionSignaled } from "./rejection-signal.js";
-import type { SelfReviewContextFetch } from "./self-review-context.js";
+import type { SelfReviewContextFetch, fetchSelfReviewContext } from "./self-review-context.js";
 import type { cleanupAttemptWorktree, prepareAttemptWorktree } from "./attempt-worktree.js";
+import type { buildCodingTaskSpec } from "./coding-task-spec.js";
+import type { resolveAmsPolicy } from "./ams-policy.js";
+import type { checkMinerKillSwitch } from "./governor-kill-switch.js";
 
 export type ParsedAttemptArgs =
   | { error: string }
@@ -35,6 +38,11 @@ export type RunAttemptOptions = {
   fetchImpl?: SelfReviewContextFetch;
   prepareAttemptWorktree?: typeof prepareAttemptWorktree;
   cleanupAttemptWorktree?: typeof cleanupAttemptWorktree;
+  fetchSelfReviewContext?: typeof fetchSelfReviewContext;
+  buildCodingTaskSpec?: typeof buildCodingTaskSpec;
+  resolveAmsPolicy?: typeof resolveAmsPolicy;
+  checkMinerKillSwitch?: typeof checkMinerKillSwitch;
+  runMinerAttempt?: typeof runMinerAttempt;
 };
 
 export function runAttempt(args: string[], options?: RunAttemptOptions): Promise<number>;