clinkx 1.0.0 → 1.1.1

package/clinkx-workflows/templates/council/plan-review-reviewer.txt

@@ -22,6 +22,9 @@ context_available = {{context_available}}
 
 Assess the plan against every rubric dimension. A dimension you cannot assess from the plan plus the attached evidence is a verification gap — not silence, and not a pass. A high score with empty evidence is itself a verification gap: never round up to approval to be agreeable. Unverified is not approved. Do not invent a rollback requirement for reversible work — a demand for rollback on a pure refactor is noise, and noise is itself a review defect. A blocker downgraded to a "note", a "follow-up", or a TODO is a defect; conversely, do not inflate a preference into a blocker.
 
+## Known Missing Evidence
+If the context bundle has a 'Known missing evidence' section, do not give an unconditional pass on any dimension that depends on it; state the dependency.
+
 ## Working Stance
 {{call.id}}
 - If your call ID ends in _a: scope, dependency ordering, and evidence anchors first.

package/clinkx-workflows/templates/council/reviewer.txt

@@ -6,6 +6,9 @@ You are a council reviewer evaluating proposals from multiple council members.
 ## Evaluation Rubric
 {{rubric}}
 
+## Known Missing Evidence
+If the context bundle has a 'Known missing evidence' section, do not give an unconditional pass on any dimension that depends on it; state the dependency.
+
 ## Review Lens
 {{call.id}}
 - If your call ID ends in _a: accuracy and internal consistency first.

package/clinkx-workflows/workflows/council-answer.yaml

@@ -111,6 +111,9 @@ variables:
 
 settings:
   timeout_seconds: 10800
+  # Vendor/generated evidence the finalizer cannot see degrades the run
+  # (marked conditional) instead of failing it.
+  context_external_gap_policy: degrade
 
 stages:
   - id: specialists

package/clinkx-workflows/workflows/council-code-review.yaml

@@ -116,6 +116,9 @@ variables:
 
 settings:
   timeout_seconds: 10800
+  # Vendor/generated evidence the finalizer cannot see degrades the run
+  # (marked conditional) instead of failing it.
+  context_external_gap_policy: degrade
 
 stages:
   - id: reviewers

package/clinkx-workflows/workflows/council-debug.yaml

@@ -116,6 +116,9 @@ variables:
 
 settings:
   timeout_seconds: 10800
+  # Vendor/generated evidence the finalizer cannot see degrades the run
+  # (marked conditional) instead of failing it.
+  context_external_gap_policy: degrade
 
 stages:
   - id: debuggers

package/clinkx-workflows/workflows/council-default.yaml

@@ -111,6 +111,9 @@ variables:
 
 settings:
   timeout_seconds: 10800
+  # Vendor/generated evidence the finalizer cannot see degrades the run
+  # (marked conditional) instead of failing it.
+  context_external_gap_policy: degrade
 
 stages:
   - id: members
@@ -123,6 +126,10 @@ stages:
       max_backoff_seconds: 30
     on_failure: continue
     calls:
+      # Optional per-call model/effort values require adapter-declared support:
+      #   model: gpt-5.4
+      #   effort: low
+      # Omission preserves CLI defaults. Runtime members replace these seed knobs.
       - id: member_a
         cli_name: codex
         timeout_seconds: 1200

package/clinkx-workflows/workflows/council-discover.yaml

@@ -111,6 +111,9 @@ variables:
 
 settings:
   timeout_seconds: 10800
+  # Vendor/generated evidence the finalizer cannot see degrades the run
+  # (marked conditional) instead of failing it.
+  context_external_gap_policy: degrade
 
 stages:
   - id: analysts

package/clinkx-workflows/workflows/council-plan-review.yaml

@@ -119,6 +119,9 @@ variables:
 
 settings:
   timeout_seconds: 10800
+  # Vendor/generated evidence the finalizer cannot see degrades the run
+  # (marked conditional) instead of failing it.
+  context_external_gap_policy: degrade
 
 stages:
   - id: reviewers

package/conf/adapters/agy.json

@@ -1,10 +1,17 @@
 {
   "name": "agy",
   "command": "agy",
-  "args": ["--print", "--print-timeout", "3600s"],
+  "args": ["--print-timeout", "3600s", "--output-format", "stream-json"],
   "unsafe_args": ["--dangerously-skip-permissions"],
-  "parser": "text",
+  "parser": "agy_stream_json",
   "prompt_mode": "stdin",
+  "invocation_overrides": {
+    "model": { "args": ["--model", "{value}"] },
+    "effort": {
+      "args": ["--effort", "{value}"],
+      "allowed_values": ["low", "medium", "high"]
+    }
+  },
   "timeout_seconds": 3600,
   "idle_timeout_startup_seconds": 180,
   "idle_timeout_seconds": 0,

package/conf/adapters/claude.json

@@ -8,6 +8,13 @@
   },
   "parser": "claude_stream_json",
   "prompt_mode": "stdin",
+  "invocation_overrides": {
+    "model": { "args": ["--model", "{value}"] },
+    "effort": {
+      "args": ["--effort", "{value}"],
+      "allowed_values": ["low", "medium", "high", "xhigh", "max"]
+    }
+  },
   "timeout_seconds": 3600,
   "idle_timeout_startup_seconds": 180,
   "idle_timeout_seconds": 0,

package/conf/adapters/codex.json

@@ -5,6 +5,13 @@
   "unsafe_args": ["--dangerously-bypass-approvals-and-sandbox"],
   "parser": "codex_jsonl",
   "prompt_mode": "stdin",
+  "invocation_overrides": {
+    "model": { "args": ["--model", "{value}"] },
+    "effort": {
+      "args": ["-c", "model_reasoning_effort={value}"],
+      "allowed_values": ["none", "minimal", "low", "medium", "high", "xhigh", "max"]
+    }
+  },
   "stdin_placeholder_arg": "-",
   "timeout_seconds": 3600,
   "idle_timeout_startup_seconds": 0,

package/conf/adapters/glm.json

@@ -1,17 +1,33 @@
 {
   "name": "glm",
   "command": "claude",
-  "args": ["-p", "--output-format", "stream-json", "--verbose"],
+  "args": [
+    "-p",
+    "--output-format",
+    "stream-json",
+    "--verbose",
+    "--model",
+    "glm-5.3[1m]"
+  ],
   "unsafe_args": ["--permission-mode", "acceptEdits"],
   "env": {
     "ANTHROPIC_AUTH_TOKEN": "",
     "CLAUDE_CODE_DISABLE_BACKGROUND_TASKS": "1",
     "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
-    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5",
-    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5"
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.7",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.3[1m]",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.3[1m]",
+    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000"
   },
   "parser": "claude_stream_json",
   "prompt_mode": "stdin",
+  "invocation_overrides": {
+    "model": { "args": ["--model", "{value}"] },
+    "effort": {
+      "args": ["--effort", "{value}"],
+      "allowed_values": ["low", "medium", "high", "xhigh", "max"]
+    }
+  },
   "timeout_seconds": 3600,
   "idle_timeout_startup_seconds": 180,
   "idle_timeout_seconds": 0,

package/conf/adapters/grok.json

@@ -6,8 +6,7 @@
     "--no-auto-update",
     "--verbatim",
     "--output-format",
-    "streaming-messages-json",
-    "--prompt-file"
+    "streaming-messages-json"
   ],
   "unsafe_args": [],
   "env": {
@@ -16,6 +15,14 @@
   "env_allowlist": ["XAI_API_KEY"],
   "parser": "claude_stream_json",
   "prompt_mode": "file",
+  "prompt_file_flag": "--prompt-file",
+  "invocation_overrides": {
+    "model": { "args": ["--model", "{value}"] },
+    "effort": {
+      "args": ["--effort", "{value}"],
+      "allowed_values": ["low", "medium", "high", "xhigh"]
+    }
+  },
   "timeout_seconds": 3600,
   "idle_timeout_startup_seconds": 180,
   "idle_timeout_seconds": 0,

package/conf/adapters/hapi/agy.json

@@ -1,13 +1,20 @@
 {
   "name": "agy",
   "command": "hapi",
-  "args": ["agy", "--print", "--print-timeout", "3600s"],
+  "args": ["agy", "--print-timeout", "3600s", "--output-format", "stream-json"],
   "unsafe_args": ["--dangerously-skip-permissions"],
   "env": {
     "HAPI_API_URL": "https://your.domain.com"
   },
-  "parser": "text",
+  "parser": "agy_stream_json",
   "prompt_mode": "stdin",
+  "invocation_overrides": {
+    "model": { "args": ["--model", "{value}"] },
+    "effort": {
+      "args": ["--effort", "{value}"],
+      "allowed_values": ["low", "medium", "high"]
+    }
+  },
   "timeout_seconds": 3600,
   "idle_timeout_startup_seconds": 180,
   "idle_timeout_seconds": 0,

package/conf/adapters/hapi/claude.json

@@ -9,6 +9,13 @@
   },
   "parser": "claude_stream_json",
   "prompt_mode": "stdin",
+  "invocation_overrides": {
+    "model": { "args": ["--model", "{value}"] },
+    "effort": {
+      "args": ["--effort", "{value}"],
+      "allowed_values": ["low", "medium", "high", "xhigh", "max"]
+    }
+  },
   "timeout_seconds": 3600,
   "idle_timeout_startup_seconds": 180,
   "idle_timeout_seconds": 0,

package/conf/adapters/hapi/codex.json

@@ -8,6 +8,13 @@
   },
   "parser": "codex_jsonl",
   "prompt_mode": "stdin",
+  "invocation_overrides": {
+    "model": { "args": ["--model", "{value}"] },
+    "effort": {
+      "args": ["-c", "model_reasoning_effort={value}"],
+      "allowed_values": ["none", "minimal", "low", "medium", "high", "xhigh", "max"]
+    }
+  },
   "stdin_placeholder_arg": "-",
   "timeout_seconds": 3600,
   "idle_timeout_startup_seconds": 0,

package/conf/adapters/hapi/glm.json

@@ -1,18 +1,34 @@
 {
   "name": "glm",
   "command": "hapi",
-  "args": ["-p", "--output-format", "stream-json", "--verbose"],
+  "args": [
+    "-p",
+    "--output-format",
+    "stream-json",
+    "--verbose",
+    "--model",
+    "glm-5.3[1m]"
+  ],
   "unsafe_args": ["--yolo"],
   "env": {
     "HAPI_API_URL": "https://your.domain.com",
     "CLAUDE_CODE_DISABLE_BACKGROUND_TASKS": "1",
     "ANTHROPIC_AUTH_TOKEN": "",
     "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
-    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7",
-    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5"
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.7",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.3[1m]",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.3[1m]",
+    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000"
   },
   "parser": "claude_stream_json",
   "prompt_mode": "stdin",
+  "invocation_overrides": {
+    "model": { "args": ["--model", "{value}"] },
+    "effort": {
+      "args": ["--effort", "{value}"],
+      "allowed_values": ["low", "medium", "high", "xhigh", "max"]
+    }
+  },
   "timeout_seconds": 3600,
   "idle_timeout_startup_seconds": 180,
   "idle_timeout_seconds": 0,
@@ -20,7 +36,7 @@
   "supports_images": true,
   "requires_tty": false,
   "result_contract": {
-    "enabled": false,
+    "enabled": true,
     "filename": "RESULT.md"
   },
   "context_builder": {

package/conf/rosters/default-council.json

@@ -0,0 +1,21 @@
+{
+  "schema_version": "clinkx-roster-v1",
+  "description": "Three-member council with a Codex chairman and an enabled curator/finalizer delegate.",
+  "members": [
+    { "cli_name": "codex" },
+    { "cli_name": "claude" },
+    { "cli_name": "glm" }
+  ],
+  "chairman": { "cli_name": "codex" },
+  "delegate": {
+    "enabled": true,
+    "curator": { "cli_name": "codex", "role": "json" },
+    "finalizer": {
+      "cli_name": "codex",
+      "role": "json-codereviewer",
+      "enabled": true,
+      "min_score": 8.5
+    },
+    "failure_policy": "fail"
+  }
+}

package/dist/activity-journal.d.ts

@@ -1,6 +1,7 @@
 import { type ActivityKind, type ActivityOutcomeKind, type ActivityPhase, type ActivityTerminalStatus } from "../clinkx-workflows/dist/dashboard/activity-contract.js";
-export { ACTIVITY_RESULT_FILENAME, ACTIVITY_STATE_FILENAME, ActivityIdSchema, ActivityKindSchema, ActivityOutcomeKindSchema, ActivityPhaseSchema, ActivityResultReferenceSchema, ActivityStateV1Schema, ActivityTerminalStatusSchema, DEFAULT_ACTIVITY_HEARTBEAT_INTERVAL_MS, DEFAULT_ACTIVITY_MAX_AGE_MS, DEFAULT_MAX_ACTIVITY_ENTRIES, DEFAULT_MAX_ACTIVITY_RESULT_BYTES, DEFAULT_MAX_ACTIVITY_TOTAL_BYTES, MAX_ACTIVITY_STATE_BYTES, } from "../clinkx-workflows/dist/dashboard/activity-contract.js";
-export type { ActivityKind, ActivityOutcomeKind, ActivityPhase, ActivityStateV1, ActivityTerminalStatus, } from "../clinkx-workflows/dist/dashboard/activity-contract.js";
+import type { InvocationAuditV2, ObservedInvocationV1 } from "../clinkx-workflows/dist/dashboard/invocation-contract.js";
+export { ACTIVITY_RESULT_FILENAME, ACTIVITY_STATE_FILENAME, ActivityIdSchema, ActivityKindSchema, ActivityOutcomeKindSchema, ActivityPhaseSchema, ActivityResultReferenceSchema, ActivityStateReadSchema, ActivityStateV1Schema, ActivityStateV2Schema, ActivityStateV3Schema, ActivityTerminalStatusSchema, DEFAULT_ACTIVITY_HEARTBEAT_INTERVAL_MS, DEFAULT_ACTIVITY_MAX_AGE_MS, DEFAULT_MAX_ACTIVITY_ENTRIES, DEFAULT_MAX_ACTIVITY_RESULT_BYTES, DEFAULT_MAX_ACTIVITY_TOTAL_BYTES, MAX_ACTIVITY_STATE_BYTES, } from "../clinkx-workflows/dist/dashboard/activity-contract.js";
+export type { ActivityKind, ActivityOutcomeKind, ActivityPhase, ActivityStateRead, ActivityStateV1, ActivityStateV2, ActivityStateV3, ActivityStateWrite, ActivityTerminalStatus, } from "../clinkx-workflows/dist/dashboard/activity-contract.js";
 export interface ActivityJournalOptions {
     readonly rootDir: string;
     readonly sessionLogRootDir?: string | undefined;
@@ -11,6 +12,11 @@ export interface ActivityJournalOptions {
     readonly maxAgeMs?: number;
     readonly heartbeatIntervalMs?: number;
     readonly now?: () => Date;
+    /** Internal deterministic seam for exact-incarnation race regressions. */
+    readonly testHooks?: ActivityJournalTestHooks | undefined;
+}
+export interface ActivityJournalTestHooks {
+    readonly beforeActivityDirectoryQuarantine?: (activityId: string, reason: "retention" | "admission_cleanup") => void | Promise<void>;
 }
 export interface ActivityBeginInput {
     readonly activityId: string;
@@ -19,20 +25,28 @@ export interface ActivityBeginInput {
     readonly role: string;
     /** Optional project folder(s) persisted to activity state for the dashboard. */
     readonly projectFolders?: readonly string[] | undefined;
+    readonly invocation?: InvocationAuditV2 | undefined;
 }
 export interface ActivityCompletion {
     readonly status: ActivityTerminalStatus;
     readonly outcomeKind: ActivityOutcomeKind;
     readonly resultText?: string;
+    /** Runtime-observed invocation knobs reported by the provider subprocess. */
+    readonly observedInvocation?: ObservedInvocationV1 | undefined;
 }
 export interface ActivityIdentity {
     readonly activityId: string;
     readonly activityGeneration: string;
 }
 export interface ActivityObservation {
-    /** Immutable identity of the exact admitted activity-directory incarnation. */
+    /** Portable session-log identity; directory-incarnation authority stays local. */
     readonly identity?: ActivityIdentity | undefined;
     transition(phase: Exclude<ActivityPhase, "resolving" | "terminal">): Promise<void>;
+    /**
+     * Record a runtime-observed invocation mid-run. The first observation is
+     * sticky; later conflicting observations are ignored. Best-effort only.
+     */
+    observe?(observed: ObservedInvocationV1): Promise<void>;
     complete(completion: ActivityCompletion): Promise<void>;
 }
 export interface ActivityJournal {