@kontourai/flow-agents 1.0.1 → 1.1.0

package/build/src/tools/build-universal-bundles.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import fs from "node:fs";
+import { fileURLToPath } from "node:url";
 import path from "node:path";
 import { loadJson, readText, root, walkFiles, writeText } from "./common.js";
 const dist = process.env.FLOW_AGENTS_DIST_DIR ? path.resolve(process.env.FLOW_AGENTS_DIST_DIR) : path.join(root, "dist");
@@ -678,5 +679,21 @@ export function main() {
     }
     return 0;
 }
-if (import.meta.url === `file://${process.argv[1]}`)
-    process.exit(main());
+// Use process.exitCode (not process.exit) to allow stdout to be flushed before exit.
+// Resolve real paths to handle symlinks (e.g. /tmp -> /private/tmp on macOS) so the
+// entry-point guard fires correctly when the module is loaded directly as a script.
+const _selfRealPath = (() => { try {
+    return fs.realpathSync(fileURLToPath(import.meta.url));
+}
+catch {
+    return fileURLToPath(import.meta.url);
+} })();
+const _argv1RealPath = (() => { try {
+    return fs.realpathSync(process.argv[1]);
+}
+catch {
+    return process.argv[1];
+} })();
+if (_selfRealPath === _argv1RealPath) {
+    process.exitCode = main();
+}

package/build/src/tools/generate-context-map.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import fs from "node:fs";
+import { fileURLToPath } from "node:url";
 import path from "node:path";
 import { exists, loadJson, markdownTable, oneLine, readText, rel, root, writeText } from "./common.js";
 const defaultOutput = path.join(root, "docs/context-map.md");
@@ -194,5 +195,21 @@ export function main(argv = process.argv.slice(2)) {
     console.log(`Wrote ${rel(output)}`);
     return 0;
 }
-if (import.meta.url === `file://${process.argv[1]}`)
-    process.exit(main());
+// Use process.exitCode (not process.exit) to allow stdout to be flushed before exit.
+// Resolve real paths to handle symlinks (e.g. /tmp -> /private/tmp on macOS) so the
+// entry-point guard fires correctly when the module is loaded directly as a script.
+const _selfRealPath = (() => { try {
+    return fs.realpathSync(fileURLToPath(import.meta.url));
+}
+catch {
+    return fileURLToPath(import.meta.url);
+} })();
+const _argv1RealPath = (() => { try {
+    return fs.realpathSync(process.argv[1]);
+}
+catch {
+    return process.argv[1];
+} })();
+if (_selfRealPath === _argv1RealPath) {
+    process.exitCode = main();
+}

package/build/src/tools/validate-package.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import fs from "node:fs";
+import { fileURLToPath } from "node:url";
 import path from "node:path";
 export function main(argv = process.argv.slice(2)) {
     const [prefixArg, localFlag] = argv;
@@ -60,5 +61,21 @@ export function main(argv = process.argv.slice(2)) {
     console.log(errors === 0 ? "Result: PASS" : `Result: FAIL (${errors} error(s))`);
     return errors === 0 ? 0 : 1;
 }
-if (import.meta.url === `file://${process.argv[1]}`)
-    process.exit(main());
+// Use process.exitCode (not process.exit) to allow stdout to be flushed before exit.
+// Resolve real paths to handle symlinks (e.g. /tmp -> /private/tmp on macOS) so the
+// entry-point guard fires correctly when the module is loaded directly as a script.
+const _selfRealPath = (() => { try {
+    return fs.realpathSync(fileURLToPath(import.meta.url));
+}
+catch {
+    return fileURLToPath(import.meta.url);
+} })();
+const _argv1RealPath = (() => { try {
+    return fs.realpathSync(process.argv[1]);
+}
+catch {
+    return process.argv[1];
+} })();
+if (_selfRealPath === _argv1RealPath) {
+    process.exitCode = main();
+}

package/build/src/tools/validate-source-tree.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import fs from "node:fs";
+import { fileURLToPath } from "node:url";
 import path from "node:path";
 import { spawnSync } from "node:child_process";
 import { loadJson, readText, rel, root, walkFiles } from "./common.js";
@@ -624,5 +625,21 @@ export function main(argv = process.argv.slice(2)) {
     console.log("Source tree validation passed.");
     return 0;
 }
-if (import.meta.url === `file://${process.argv[1]}`)
-    process.exit(main());
+// Use process.exitCode (not process.exit) to allow stdout to be flushed before exit.
+// Resolve real paths to handle symlinks (e.g. /tmp -> /private/tmp on macOS) so the
+// entry-point guard fires correctly when the module is loaded directly as a script.
+const _selfRealPath = (() => { try {
+    return fs.realpathSync(fileURLToPath(import.meta.url));
+}
+catch {
+    return fileURLToPath(import.meta.url);
+} })();
+const _argv1RealPath = (() => { try {
+    return fs.realpathSync(process.argv[1]);
+}
+catch {
+    return process.argv[1];
+} })();
+if (_selfRealPath === _argv1RealPath) {
+    process.exitCode = main();
+}

package/context/scripts/telemetry/console-presets.sh

@@ -6,7 +6,7 @@ flow_agents_local_kontour_console_url() {
 }
 
 flow_agents_kontour_cloud_console_url() {
-  printf '%s\n' "${FLOW_AGENTS_KONTOUR_CLOUD_CONSOLE_URL:-https://console.kontourai.com}"
+  printf '%s\n' "${FLOW_AGENTS_KONTOUR_CLOUD_CONSOLE_URL:-https://console.kontourai.io}"
 }
 
 flow_agents_kontour_hosted_console_url() {

package/docs/kit-authoring-guide.md

@@ -12,7 +12,7 @@ This guide walks you from an empty directory to a validated, locally installed k
 
 - **Kit** — a directory with a root `kit.json` manifest and the assets it declares. The manifest is the contract; Flow Agents validates it before anything is copied.
 - **Flow Definition** — a `.flow.json` file that declares steps, gates, and expected evidence. Validation of the Flow Definition semantics belongs to [Kontour Flow](https://kontourai.github.io/flow/); the kit contract delegates to it.
-- **Activation** — the step that reads the installed kit and writes runtime-local files into your workspace. Today the `codex-local` adapter is the only adapter, and it activates only Flow Definition assets.
+- **Activation** — the step that reads the installed kit and writes runtime-local files into your workspace. Both `codex-local` and `strands-local` adapters activate Flow Definitions, skills, and docs. See the Activate section for the full asset-class table.
 
 ## Directory layout
 
@@ -54,7 +54,7 @@ Required fields:
 | `name` | Non-empty display name |
 | `flows` | Non-empty list; each entry must have `id` and `path` |
 
-Optional fields: `product_name`, `description`, `skills`, `docs`, `adapters`, `evals`, `assets`. Optional fields list relative asset paths or objects with `id`, `path`, and optional `description`. They are declared for provenance but only Flow Definition assets are activated today; others appear in diagnostics as `skipped_assets`.
+Optional fields: `product_name`, `description`, `skills`, `docs`, `adapters`, `evals`, `assets`. Optional fields list relative asset paths or objects with `id`, `path`, and optional `description`. `skills` and `docs` assets are activated by both adapters alongside flows. `adapters`, `evals`, and `assets` appear in diagnostics as `skipped_assets` (see the Activate section for the full per-adapter table).
 
 ## Minimal flow file
 
@@ -140,7 +140,24 @@ After installing, run activate to write runtime-local files into the workspace:
 npx @kontourai/flow-agents flow-kit activate --dest /path/to/workspace --format json
 ```
 
-The `codex-local` adapter is selected automatically. It writes Flow Definition copies under `.flow-agents/runtime/codex/flows/<kit-id>/` and an `activation.json` manifest. Declared `skills`, `docs`, `adapters`, `evals`, and `assets` are recorded as `skipped_assets` — they are not an error, just not activated yet.
+The `codex-local` adapter is selected automatically. To activate for Strands, pass `--adapter strands-local`.
+
+### What each adapter activates
+
+Each adapter copies declared assets into `.flow-agents/runtime/<adapter>/` and produces an `activation.json` manifest. The table below shows which asset classes are activated today:
+
+| Asset class | `codex-local` | `strands-local` | Notes |
+|---|---|---|---|
+| `flows` | Activated — `.flow-agents/runtime/codex/flows/<kit-id>/<asset-id>.flow.json` | Activated — `.flow-agents/runtime/strands/flows/<kit-id>/<asset-id>.flow.json` | Gate definitions read by each adapter's flow-routing layer. |
+| `skills` | Activated — `.flow-agents/runtime/codex/skills/<kit-id>/<filename>` | Activated — `.flow-agents/runtime/strands/skills/<kit-id>/<filename>` | Agent guidance markdown. For codex-local, reference these paths from AGENTS.md. For strands-local, the Strands steering layer can glob for `*.md` under `skills/` during system-prompt injection. |
+| `docs` | Activated — `.flow-agents/runtime/codex/docs/<kit-id>/<filename>` | Activated — `.flow-agents/runtime/strands/docs/<kit-id>/<filename>` | Documentation assets. Co-located with skill files for easy reference. |
+| `adapters` | `skipped_assets` | `skipped_assets` | Framework or runtime adapter code — not copied by the activation layer. |
+| `evals` | `skipped_assets` | `skipped_assets` | Evaluation suites — not run or copied during activation. |
+| `assets` | `skipped_assets` | `skipped_assets` | General supporting assets — not copied during activation. |
+
+Assets in `skipped_assets` are recorded in `activation.json` for diagnostics but are not an error. They are not activated because no activation path is defined for those classes in the current adapters.
+
+Flows with a missing `id` field in `kit.json` are also placed in `skipped_assets` with an explicit reason.
 
 When installing through `npx @kontourai/flow-agents init` with the Codex runtime, pass `--activate-kits` to run activation as part of init:
 

package/evals/ci/run-baseline.sh

@@ -26,6 +26,24 @@ CHECKS=(
   "Flow Kit repository integration|bash evals/integration/test_flow_kit_repository.sh"
   "Runtime adapter activation integration|bash evals/integration/test_runtime_adapter_activation.sh"
   "Bundle install integration|bash evals/integration/test_bundle_install.sh"
+  "Bundle lifecycle integration|bash evals/integration/test_bundle_lifecycle.sh"
+  "Activate npx context integration|bash evals/integration/test_activate_npx_context.sh"
+  "Kit conformance levels integration|bash evals/integration/test_kit_conformance_levels.sh"
+  "Local Flow Kit install integration|bash evals/integration/test_local_flow_kit_install.sh"
+  "Flow Kit install-git integration|bash evals/integration/test_flow_kit_install_git.sh"
+  "Console learning projection integration|bash evals/integration/test_console_learning_projection.sh"
+  "Context map integration|bash evals/integration/test_context_map.sh"
+  "Effective backlog settings integration|bash evals/integration/test_effective_backlog_settings.sh"
+  "Flow agents statusline integration|bash evals/integration/test_flow_agents_statusline.sh"
+  "Telemetry contract integration|bash evals/integration/test_telemetry.sh"
+  "Telemetry doctor integration|bash evals/integration/test_telemetry_doctor.sh"
+  "Utterance check integration|bash evals/integration/test_utterance_check.sh"
+  "Pull work provider integration|bash evals/integration/test_pull_work_provider.sh"
+  "Usage feedback import integration|bash evals/integration/test_usage_feedback_import.sh"
+  "Usage feedback outcomes integration|bash evals/integration/test_usage_feedback_outcomes.sh"
+  "Usage feedback report integration|bash evals/integration/test_usage_feedback_report.sh"
+  "Usage feedback dashboard integration|bash evals/integration/test_usage_feedback_dashboard.sh"
+  "Usage feedback global integration|bash evals/integration/test_usage_feedback_global.sh"
 )
 
 LANE_SOURCE_AND_STATIC=(
@@ -51,6 +69,27 @@ LANE_RUNTIME_AND_KIT=(
   "Flow Kit repository integration"
   "Runtime adapter activation integration"
   "Bundle install integration"
+  "Bundle lifecycle integration"
+  "Activate npx context integration"
+  "Kit conformance levels integration"
+  "Local Flow Kit install integration"
+  "Flow Kit install-git integration"
+  # QUARANTINED (#74): passes on macOS, fails on Linux CI — not gating until triaged
+  "Context map integration"
+  "Effective backlog settings integration"
+  "Flow agents statusline integration"
+  "Telemetry contract integration"
+  "Telemetry doctor integration"
+  "Utterance check integration"
+  "Pull work provider integration"
+)
+
+LANE_USAGE_FEEDBACK=(
+  "Usage feedback import integration"
+  "Usage feedback outcomes integration"
+  "Usage feedback report integration"
+  "Usage feedback dashboard integration"
+  "Usage feedback global integration"
 )
 
 slugify() {
@@ -78,6 +117,9 @@ lane_labels() {
     runtime-and-kit)
       printf '%s\n' "${LANE_RUNTIME_AND_KIT[@]}"
       ;;
+    usage-feedback)
+      printf '%s\n' "${LANE_USAGE_FEEDBACK[@]}"
+      ;;
     *)
       echo "Unknown CI baseline lane: $(active_lane)" >&2
       return 1
@@ -120,14 +162,19 @@ find_check() {
 }
 
 find_active_check() {
+  # Look up the check by id-or-label without streaming active_checks through a
+  # process substitution.  Streaming and returning early from the consumer loop
+  # causes a SIGPIPE on the producer printf when pipefail is set, printing a
+  # spurious "write error: Broken pipe" on Linux even though every check passed.
+  # Instead: resolve via the pure-bash find_check, then confirm the label is
+  # present in the active lane.
   local requested="$1"
-  local row id label command
-  while IFS=$'\t' read -r id label command; do
-    if [[ "$requested" == "$id" || "$requested" == "$label" ]]; then
-      printf '%s\t%s\t%s\n' "$id" "$label" "$command"
-      return 0
-    fi
-  done < <(active_checks)
+  local row id label line
+  row="$(find_check "$requested")" || return 1
+  IFS=$'\t' read -r id label _ <<<"$row"
+  while IFS= read -r line; do
+    [[ "$line" == "$label" ]] && { printf '%s\n' "$row"; return 0; }
+  done <<<"$(lane_labels)"
   return 1
 }
 
@@ -265,7 +312,7 @@ case "${1:-}" in
     ;;
   --lane)
     if [[ -z "${2:-}" ]]; then
-      echo "Usage: $0 --lane <source-and-static|workflow-contracts|runtime-and-kit>" >&2
+      echo "Usage: $0 --lane <source-and-static|workflow-contracts|runtime-and-kit|usage-feedback>" >&2
       exit 2
     fi
     FLOW_AGENTS_CI_LANE="$2"

package/evals/integration/test_runtime_adapter_activation.sh

@@ -43,31 +43,68 @@ const data = JSON.parse(fs.readFileSync(process.argv[2], "utf8"));
 const dest = process.argv[3];
 const catalog = process.argv[4];
 if (data.selected_adapter !== "codex-local") throw new Error(`unexpected selected_adapter: ${data.selected_adapter}`);
-if (JSON.stringify(data.supported_asset_classes) !== JSON.stringify(["flows"])) throw new Error(`unexpected supported_asset_classes: ${data.supported_asset_classes}`);
+
+// supported_asset_classes now includes skills and docs (Issue #58)
+const supported = data.supported_asset_classes;
+for (const expected of ["flows", "skills", "docs"]) {
+  if (!supported.includes(expected)) throw new Error(`supported_asset_classes missing ${expected}: ${JSON.stringify(supported)}`);
+}
+
+// generated_runtime_files: flows activated (builder, mixed), skill activated (mixed.skill), activation manifest
 const ids = new Set(data.generated_runtime_files.map((item) => item.asset_id));
 for (const expected of ["builder.shape", "builder.build", "mixed.runtime", "codex-local.activation"]) {
   if (!ids.has(expected)) throw new Error(`missing generated asset: ${expected}`);
 }
+// mixed kit skill should now be in generated_runtime_files, not skipped
+if (!ids.has("mixed.skill")) throw new Error("missing generated asset: mixed.skill (skills should be activated now)");
+// mixed kit doc should now be in generated_runtime_files, not skipped
+if (!ids.has("mixed.docs")) throw new Error("missing generated asset: mixed.docs (docs should be activated now)");
+
+// All generated files must exist on disk
 for (const item of data.generated_runtime_files) {
   const generatedPath = path.join(dest, item.path);
   if (!fs.existsSync(generatedPath)) throw new Error(`generated file missing: ${generatedPath}`);
   if (path.resolve(catalog) === path.resolve(generatedPath)) throw new Error("activation generated over kits/catalog.json");
 }
-const classes = new Set(data.skipped_assets.map((item) => item.asset_class));
-for (const expected of ["skills", "docs", "adapters", "evals", "assets"]) {
-  if (!classes.has(expected)) throw new Error(`missing skipped asset class: ${expected}`);
+
+// Skills must be written to .flow-agents/runtime/codex/skills/<kit-id>/
+const skillFiles = data.generated_runtime_files.filter((item) => item.asset_class === "skills");
+if (!skillFiles.length) throw new Error("no skills in generated_runtime_files");
+for (const item of skillFiles) {
+  if (!item.path.includes(".flow-agents/runtime/codex/skills/")) {
+    throw new Error(`skill not under codex skills dir: ${item.path}`);
+  }
+  if (!fs.existsSync(path.join(dest, item.path))) throw new Error(`skill file missing on disk: ${item.path}`);
+}
+
+// Docs must be written to .flow-agents/runtime/codex/docs/<kit-id>/
+const docFiles = data.generated_runtime_files.filter((item) => item.asset_class === "docs");
+if (!docFiles.length) throw new Error("no docs in generated_runtime_files");
+for (const item of docFiles) {
+  if (!item.path.includes(".flow-agents/runtime/codex/docs/")) {
+    throw new Error(`doc not under codex docs dir: ${item.path}`);
+  }
+}
+
+// skipped_assets should NOT contain skills or docs any more
+const skippedClasses = new Set(data.skipped_assets.map((item) => item.asset_class));
+if (skippedClasses.has("skills")) throw new Error("skills should not be in skipped_assets after activation fix");
+if (skippedClasses.has("docs")) throw new Error("docs should not be in skipped_assets after activation fix");
+
+// adapters, evals, assets still skipped (not activated by codex-local)
+for (const expected of ["adapters", "evals", "assets"]) {
+  if (!skippedClasses.has(expected)) throw new Error(`missing skipped asset class: ${expected}`);
 }
 for (const item of data.skipped_assets) {
   for (const key of ["asset_class", "path", "kit_id", "asset_id", "reason"]) {
     if (!(key in item)) throw new Error(`skipped asset missing ${key}: ${JSON.stringify(item)}`);
   }
-  if (!item.reason.includes("diagnostic-only")) throw new Error(`unexpected skip reason: ${item.reason}`);
 }
 if (!fs.existsSync(path.join(dest, ".flow-agents/runtime/codex/activation.json"))) throw new Error("runtime activation manifest missing");
 console.log("ok");
 NODE
 then
-  pass "diagnostics report default adapter, generated files, and skipped unsupported assets"
+  pass "diagnostics report default adapter, generated files (flows+skills+docs), and correct skipped_assets (adapters, evals, assets only)"
 else
   fail "activation diagnostics are incomplete"
   sed -n '1,220p' "$OUT"
@@ -108,6 +145,14 @@ STRANDS_DEST="$TMP_DIR/strands-dest"
 STRANDS_OUT="$TMP_DIR/strands-activation.json"
 mkdir -p "$STRANDS_DEST"
 
+# Install the mixed kit into strands dest so we can assert skills land there too
+if flow_agents_node "$CLI" install-local "$MIXED_SRC" --dest "$STRANDS_DEST" >"$TMP_DIR/strands-install.out" 2>&1; then
+  pass "mixed local kit installs into strands temp destination"
+else
+  fail "mixed local kit install failed (strands dest)"
+  sed -n '1,160p' "$TMP_DIR/strands-install.out"
+fi
+
 # Use the builder kit (stable fixture) — activate for strands-local from the repo source root
 if flow_agents_node "$CLI" activate --dest "$STRANDS_DEST" --source-root "$ROOT" --adapter strands-local --format json >"$STRANDS_OUT" 2>&1; then
   pass "strands-local activation succeeds"
@@ -125,25 +170,58 @@ const catalog = process.argv[4];
 
 // Verify selected_adapter
 if (data.selected_adapter !== "strands-local") throw new Error(`expected strands-local, got: ${data.selected_adapter}`);
-if (JSON.stringify(data.supported_asset_classes) !== JSON.stringify(["flows"])) throw new Error(`unexpected supported_asset_classes: ${JSON.stringify(data.supported_asset_classes)}`);
+
+// supported_asset_classes now includes skills and docs (Issue #58)
+const supported = data.supported_asset_classes;
+for (const expected of ["flows", "skills", "docs"]) {
+  if (!supported.includes(expected)) throw new Error(`supported_asset_classes missing ${expected}: ${JSON.stringify(supported)}`);
+}
 
 // Verify builder kit flows are generated (builder kit is in catalog.json)
 const ids = new Set(data.generated_runtime_files.map((item) => item.asset_id));
 for (const expected of ["builder.shape", "builder.build", "strands-local.activation"]) {
   if (!ids.has(expected)) throw new Error(`missing generated asset: ${expected}`);
 }
+// mixed kit skill should be in generated_runtime_files
+if (!ids.has("mixed.skill")) throw new Error("missing generated asset: mixed.skill (skills should be activated by strands-local)");
+// mixed kit doc should be in generated_runtime_files
+if (!ids.has("mixed.docs")) throw new Error("missing generated asset: mixed.docs (docs should be activated by strands-local)");
 
 // Verify generated runtime files actually exist on disk
 for (const item of data.generated_runtime_files) {
   if (item.asset_class === "activation-manifest") continue;
   const generatedPath = path.join(dest, item.path);
   if (!fs.existsSync(generatedPath)) throw new Error(`generated file missing: ${generatedPath}`);
-  // Verify runtime files are under .flow-agents/runtime/strands/flows/
-  if (!item.path.includes(".flow-agents/runtime/strands/flows/")) {
-    throw new Error(`generated path not under strands runtime dir: ${item.path}`);
+  // Verify flow files are under .flow-agents/runtime/strands/flows/
+  if (item.asset_class === "flows" && !item.path.includes(".flow-agents/runtime/strands/flows/")) {
+    throw new Error(`generated flow path not under strands runtime dir: ${item.path}`);
+  }
+}
+
+// Skills must be written to .flow-agents/runtime/strands/skills/<kit-id>/
+const skillFiles = data.generated_runtime_files.filter((item) => item.asset_class === "skills");
+if (!skillFiles.length) throw new Error("no skills in generated_runtime_files for strands-local");
+for (const item of skillFiles) {
+  if (!item.path.includes(".flow-agents/runtime/strands/skills/")) {
+    throw new Error(`skill not under strands skills dir: ${item.path}`);
+  }
+  if (!fs.existsSync(path.join(dest, item.path))) throw new Error(`skill file missing on disk: ${item.path}`);
+}
+
+// Docs must be written to .flow-agents/runtime/strands/docs/<kit-id>/
+const docFiles = data.generated_runtime_files.filter((item) => item.asset_class === "docs");
+if (!docFiles.length) throw new Error("no docs in generated_runtime_files for strands-local");
+for (const item of docFiles) {
+  if (!item.path.includes(".flow-agents/runtime/strands/docs/")) {
+    throw new Error(`doc not under strands docs dir: ${item.path}`);
   }
 }
 
+// skipped_assets should NOT contain skills or docs
+const skippedClasses = new Set(data.skipped_assets.map((item) => item.asset_class));
+if (skippedClasses.has("skills")) throw new Error("skills should not be in skipped_assets for strands-local");
+if (skippedClasses.has("docs")) throw new Error("docs should not be in skipped_assets for strands-local");
+
 // Verify activation.json written at strands runtime dir
 const manifestPath = path.join(dest, ".flow-agents/runtime/strands/activation.json");
 if (!fs.existsSync(manifestPath)) throw new Error("strands runtime activation.json missing");
@@ -156,14 +234,8 @@ for (const item of manifest.skipped_assets) {
   for (const key of ["asset_class", "path", "kit_id", "asset_id", "reason"]) {
     if (!(key in item)) throw new Error(`skipped asset missing ${key}: ${JSON.stringify(item)}`);
   }
-  if (!item.reason.includes("diagnostic-only")) throw new Error(`unexpected skip reason: ${item.reason}`);
 }
 
-// Non-flow asset classes should appear in skipped_assets
-const skippedClasses = new Set(manifest.skipped_assets.map((item) => item.asset_class));
-// builder kit has flows only; skipped_assets check requires a kit with non-flow assets,
-// which the codex-local path already validates via mixed-runtime-kit above.
-// Here we just confirm the field structure is present.
 if (!Array.isArray(data.skipped_assets)) throw new Error("result skipped_assets is not an array");
 
 // Catalog not mutated
@@ -174,7 +246,7 @@ if (path.resolve(catalog) === path.resolve(path.join(dest, ".flow-agents/runtime
 console.log("ok");
 NODE
 then
-  pass "strands-local: runtime flow files, activation.json, and skipped_assets present with correct structure"
+  pass "strands-local: runtime flow+skill+doc files, activation.json, and skipped_assets present with correct structure"
 else
   fail "strands-local: activation diagnostics incomplete or incorrect"
   sed -n '1,220p' "$STRANDS_OUT"
@@ -208,6 +280,55 @@ else
   sed -n '1,220p' "$TMP_DIR/codex-after-strands.json"
 fi
 
+# -------------------------------------------------------------------------
+# Skill activation with a kit that has NO skills (builder kit — flows only)
+# -------------------------------------------------------------------------
+
+echo ""
+echo "=== Skills: kit-with-no-skills activates cleanly ==="
+
+NO_SKILLS_DEST="$TMP_DIR/no-skills-dest"
+NO_SKILLS_OUT="$TMP_DIR/no-skills-activation.json"
+mkdir -p "$NO_SKILLS_DEST"
+
+if flow_agents_node "$CLI" activate --dest "$NO_SKILLS_DEST" --source-root "$ROOT" --format json >"$NO_SKILLS_OUT" 2>&1; then
+  pass "activation succeeds for source-root with no skills (builder kit only)"
+else
+  fail "activation failed for kit with no skills"
+  sed -n '1,220p' "$NO_SKILLS_OUT"
+fi
+
+if node - "$NO_SKILLS_OUT" "$NO_SKILLS_DEST" <<'NODE'
+const fs = require("node:fs");
+const path = require("node:path");
+// Use builder-only source root (no installed local kits, built-in kits only)
+const data = JSON.parse(fs.readFileSync(process.argv[2], "utf8"));
+const dest = process.argv[3];
+if (data.selected_adapter !== "codex-local") throw new Error(`expected codex-local, got: ${data.selected_adapter}`);
+// builder kit has no skills or docs — skills dir should not exist (or be empty)
+const skillsDir = path.join(dest, ".flow-agents/runtime/codex/skills");
+// It's fine if the dir doesn't exist; builder kit has no skills
+const docsDir = path.join(dest, ".flow-agents/runtime/codex/docs");
+// builder kit has no docs either
+// No skills or docs in skipped_assets (none declared)
+const skippedClasses = new Set(data.skipped_assets.map((item) => item.asset_class));
+// builder kit only has flows — no skills or docs — so neither should appear in skipped
+if (skippedClasses.has("skills")) throw new Error("builder kit (no skills) should not have skills in skipped_assets");
+if (skippedClasses.has("docs")) throw new Error("builder kit (no docs) should not have docs in skipped_assets");
+// Flows must still be activated
+const ids = new Set(data.generated_runtime_files.map((item) => item.asset_id));
+if (!ids.has("builder.shape")) throw new Error("missing builder.shape flow");
+if (!ids.has("builder.build")) throw new Error("missing builder.build flow");
+if (!fs.existsSync(path.join(dest, ".flow-agents/runtime/codex/activation.json"))) throw new Error("activation.json missing");
+console.log("ok");
+NODE
+then
+  pass "kit with no skills activates cleanly — flows activated, no skills or docs in skipped_assets"
+else
+  fail "kit with no skills activation check failed"
+  sed -n '1,220p' "$NO_SKILLS_OUT"
+fi
+
 echo ""
 if [[ "$errors" -eq 0 ]]; then
   echo "Runtime adapter activation checks passed."

package/evals/run.sh

@@ -135,6 +135,8 @@ run_static() {
   echo ""
   bash "$EVAL_DIR/static/test_evidence_refs.sh" || result=1
   echo ""
+  bash "$EVAL_DIR/static/test_console_presets.sh" || result=1
+  echo ""
   bash "$EVAL_DIR/static/test_repo_hooks.sh" || result=1
   return $result
 }

package/evals/static/test_console_presets.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+
+pass() {
+  echo "PASS: $1"
+}
+
+fail() {
+  echo "FAIL: $1" >&2
+  exit 1
+}
+
+assert_hosted_preset() {
+  local preset_file="$1"
+  local label="$2"
+  local default_url override_url
+
+  default_url="$(
+    unset FLOW_AGENTS_KONTOUR_CLOUD_CONSOLE_URL
+    # shellcheck source=/dev/null
+    source "$preset_file"
+    flow_agents_kontour_hosted_console_url
+  )"
+  [[ "$default_url" == "https://console.kontourai.io" ]] || fail "$label default hosted URL is $default_url"
+  pass "$label default hosted URL uses console.kontourai.io"
+
+  override_url="$(
+    export FLOW_AGENTS_KONTOUR_CLOUD_CONSOLE_URL="https://console.override.test"
+    # shellcheck source=/dev/null
+    source "$preset_file"
+    flow_agents_kontour_hosted_console_url
+  )"
+  [[ "$override_url" == "https://console.override.test" ]] || fail "$label hosted URL override is $override_url"
+  pass "$label hosted URL override is preserved"
+}
+
+echo "=== Console Preset Contract Checks ==="
+
+assert_hosted_preset "$ROOT_DIR/scripts/telemetry/console-presets.sh" "source preset"
+assert_hosted_preset "$ROOT_DIR/context/scripts/telemetry/console-presets.sh" "context preset"
+
+if rg -F -q "https://console.kontourai.com" \
+  "$ROOT_DIR/scripts/telemetry/console-presets.sh" \
+  "$ROOT_DIR/context/scripts/telemetry/console-presets.sh"; then
+  fail "preset scripts still reference console.kontourai.com"
+fi
+pass "preset scripts do not reference console.kontourai.com"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontourai/flow-agents",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Flow Agents — a Kontour product that applies Flow and Veritas discipline as a portable process layer inside the agent tools you already use: Claude Code, Codex, Kiro, opencode, pi, and GitHub Actions — with framework adapters (AWS Strands preview) on the same policy-engine contract.",
   "keywords": [
     "agents",

package/scripts/telemetry/console-presets.sh

@@ -6,7 +6,7 @@ flow_agents_local_kontour_console_url() {
 }
 
 flow_agents_kontour_cloud_console_url() {
-  printf '%s\n' "${FLOW_AGENTS_KONTOUR_CLOUD_CONSOLE_URL:-https://console.kontourai.com}"
+  printf '%s\n' "${FLOW_AGENTS_KONTOUR_CLOUD_CONSOLE_URL:-https://console.kontourai.io}"
 }
 
 flow_agents_kontour_hosted_console_url() {

package/src/cli/console-learning-projection.ts

@@ -1,4 +1,5 @@
 import * as fs from "node:fs";
+import { fileURLToPath } from "node:url";
 import * as path from "node:path";
 import { flagBool, flagString, parseArgs } from "../lib/args.js";
 import { buildWorkflowLearningProjection, readWorkflowLearningSources } from "../lib/workflow-learning-projection.js";
@@ -137,4 +138,9 @@ export function main(argv = process.argv.slice(2)): number {
   }
 }
 
-if (import.meta.url === `file://${process.argv[1]}`) process.exit(main());
+// Use process.exitCode (not process.exit) to allow stdout to be flushed before exit.
+// Resolve real paths to handle symlinks (e.g. /tmp -> /private/tmp on macOS) so the
+// entry-point guard fires correctly when the module is loaded directly as a script.
+const _selfRealPath = (() => { try { return fs.realpathSync(fileURLToPath(import.meta.url)); } catch { return fileURLToPath(import.meta.url); } })();
+const _argv1RealPath = (() => { try { return fs.realpathSync(process.argv[1]); } catch { return process.argv[1]; } })();
+if (_selfRealPath === _argv1RealPath) { process.exitCode = main(); }

package/src/cli/effective-backlog-settings.ts

@@ -96,4 +96,9 @@ export function main(argv = process.argv.slice(2)): number {
   }
 }
 
-if (import.meta.url === `file://${process.argv[1]}`) process.exit(main());
+// Use process.exitCode (not process.exit) to allow stdout to be flushed before exit.
+// Resolve real paths to handle symlinks (e.g. /tmp -> /private/tmp on macOS) so the
+// entry-point guard fires correctly when the module is loaded directly as a script.
+const _selfRealPath = (() => { try { return fs.realpathSync(fileURLToPath(import.meta.url)); } catch { return fileURLToPath(import.meta.url); } })();
+const _argv1RealPath = (() => { try { return fs.realpathSync(process.argv[1]); } catch { return process.argv[1]; } })();
+if (_selfRealPath === _argv1RealPath) { process.exitCode = main(); }

package/src/cli/fixture-retirement-audit.ts

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import * as fs from "node:fs";
+import { fileURLToPath } from "node:url";
 import * as path from "node:path";
 
 type FixtureAuditItem = {
@@ -151,4 +152,9 @@ export function main(argv = process.argv.slice(2)): number {
   }
 }
 
-if (import.meta.url === `file://${process.argv[1]}`) process.exit(main());
+// Use process.exitCode (not process.exit) to allow stdout to be flushed before exit.
+// Resolve real paths to handle symlinks (e.g. /tmp -> /private/tmp on macOS) so the
+// entry-point guard fires correctly when the module is loaded directly as a script.
+const _selfRealPath = (() => { try { return fs.realpathSync(fileURLToPath(import.meta.url)); } catch { return fileURLToPath(import.meta.url); } })();
+const _argv1RealPath = (() => { try { return fs.realpathSync(process.argv[1]); } catch { return process.argv[1]; } })();
+if (_selfRealPath === _argv1RealPath) { process.exitCode = main(); }