@kontourai/flow-agents 1.0.0 → 1.1.0

package/evals/integration/test_activate_npx_context.sh

@@ -0,0 +1,134 @@
+#!/usr/bin/env bash
+# test_activate_npx_context.sh — Verify that activate exits 0 in an npx-like context
+# where there is no kits/catalog.json at the source-root.
+# Implements acceptance criteria for kontourai/flow-agents#57.
+set -uo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+source "$ROOT/evals/lib/node.sh"
+
+errors=0
+TMP_DIR="$(mktemp -d)"
+trap 'rm -rf "$TMP_DIR"' EXIT
+
+pass() { echo "  ✓ $1"; }
+fail() { echo "  ✗ $1"; errors=$((errors + 1)); }
+
+CLI="$ROOT/scripts/flow-kit.js"
+MIXED_SRC="$ROOT/evals/fixtures/flow-kit-repository/mixed-runtime-kit"
+
+echo "=== activate npx-context Checks (Issue #57) ==="
+
+# Simulate the npx context: an empty source-root (no kits/catalog.json present).
+NPX_SIMULATED_ROOT="$TMP_DIR/simulated-npx-root"
+mkdir -p "$NPX_SIMULATED_ROOT"
+DEST="$TMP_DIR/dest"
+mkdir -p "$DEST"
+
+# Install a kit into the destination workspace first.
+install_out="$TMP_DIR/install.out"
+if flow_agents_node "$CLI" install-local "$MIXED_SRC" --dest "$DEST" >"$install_out" 2>&1; then
+  pass "mixed-runtime-kit installs into workspace"
+else
+  fail "install failed (prerequisite step)"
+  sed -n '1,80p' "$install_out"
+fi
+
+# --- Test 1: activate with no catalog.json at source-root exits 0 ---
+# This simulates the npx context: source-root points at an npm cache dir with no kits/catalog.json.
+activate_out="$TMP_DIR/activate-npx.out"
+if flow_agents_node "$CLI" activate --dest "$DEST" --source-root "$NPX_SIMULATED_ROOT" >"$activate_out" 2>&1; then
+  pass "activate exits 0 when source-root has no catalog.json (npx context)"
+else
+  fail "activate exits non-zero when source-root has no catalog.json — false failure in npx context"
+  sed -n '1,120p' "$activate_out"
+fi
+
+# --- Test 2: missing catalog warning appears but not as an error ---
+if node - "$activate_out" <<'NODE'
+const fs = require("node:fs");
+const raw = fs.readFileSync(process.argv[2], "utf8").trim();
+const data = JSON.parse(raw);
+// errors must be empty — missing catalog is not an error
+if (Array.isArray(data.errors) && data.errors.length > 0) {
+  throw new Error(`activate reported errors: ${JSON.stringify(data.errors)}`);
+}
+// warnings may mention catalog (but must not be errors)
+const catalogWarning = Array.isArray(data.warnings) && data.warnings.some((w) => w.includes("catalog") || w.includes("Catalog"));
+// It's fine either way — the key invariant is errors=[].
+console.log(`warnings: ${JSON.stringify(data.warnings)}`);
+console.log(`catalog mentioned in warnings: ${catalogWarning}`);
+console.log("ok");
+NODE
+then
+  pass "activate with missing catalog produces no errors (warnings only)"
+else
+  fail "activate diagnostic structure incorrect"
+  sed -n '1,120p' "$activate_out"
+fi
+
+# --- Test 3: user-installed kits ARE activated even without catalog.json ---
+if node - "$activate_out" "$DEST" <<'NODE'
+const fs = require("node:fs");
+const path = require("node:path");
+const raw = fs.readFileSync(process.argv[2], "utf8").trim();
+const data = JSON.parse(raw);
+const dest = process.argv[3];
+// mixed-runtime-kit has a flow with id "mixed.runtime" — it should be in generated_runtime_files
+const ids = new Set(data.generated_runtime_files.map((item) => item.asset_id));
+if (!ids.has("mixed.runtime")) {
+  throw new Error(`user-installed kit flow not activated; generated ids: ${[...ids].join(", ")}`);
+}
+// The generated file must 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 on disk: ${generatedPath}`);
+}
+console.log("ok");
+NODE
+then
+  pass "user-installed kits are activated correctly even without catalog.json"
+else
+  fail "user-installed kit flows missing from activation output"
+  sed -n '1,120p' "$activate_out"
+fi
+
+# --- Test 4: built-in kits also activate when catalog.json IS present (regression guard) ---
+activate_builtin_out="$TMP_DIR/activate-builtin.out"
+if flow_agents_node "$CLI" activate --dest "$DEST" --source-root "$ROOT" >"$activate_builtin_out" 2>&1; then
+  pass "activate with catalog.json present still exits 0 (regression guard)"
+else
+  fail "activate with catalog.json present failed (regression)"
+  sed -n '1,120p' "$activate_builtin_out"
+fi
+
+if node - "$activate_builtin_out" <<'NODE'
+const fs = require("node:fs");
+const raw = fs.readFileSync(process.argv[2], "utf8").trim();
+const data = JSON.parse(raw);
+if (Array.isArray(data.errors) && data.errors.length > 0) {
+  throw new Error(`regression: activate with catalog.json reported errors: ${JSON.stringify(data.errors)}`);
+}
+// Should have builder kit flows from catalog
+const ids = new Set(data.generated_runtime_files.map((item) => item.asset_id));
+if (!ids.has("builder.shape") && !ids.has("builder.build")) {
+  throw new Error(`built-in kit flows missing when catalog.json is present`);
+}
+console.log("ok");
+NODE
+then
+  pass "built-in kit flows present when catalog.json is available (regression)"
+else
+  fail "built-in kit flows missing — regression introduced"
+  sed -n '1,120p' "$activate_builtin_out"
+fi
+
+echo ""
+if [[ "$errors" -eq 0 ]]; then
+  echo "activate npx-context checks passed."
+  exit 0
+fi
+
+echo "activate npx-context checks failed: $errors issue(s)."
+exit 1

package/evals/integration/test_flow_kit_install_git.sh

@@ -0,0 +1,163 @@
+#!/usr/bin/env bash
+# test_flow_kit_install_git.sh — Exercise flow-kit install-git with a file:// git URL fixture.
+# No network required: the fixture is a bare git repo created from the existing valid-local-kit.
+# Implements acceptance criteria for kontourai/flow-agents#56.
+set -uo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+source "$ROOT/evals/lib/node.sh"
+
+errors=0
+TMP_DIR="$(mktemp -d)"
+trap 'rm -rf "$TMP_DIR"' EXIT
+
+pass() { echo "  ✓ $1"; }
+fail() { echo "  ✗ $1"; errors=$((errors + 1)); }
+
+CLI="$ROOT/scripts/flow-kit.js"
+VALID_SRC="$ROOT/evals/fixtures/flow-kit-repository/valid-local-kit"
+DEST="$TMP_DIR/install-dest"
+mkdir -p "$DEST"
+
+echo "=== install-git Checks (Issue #56) ==="
+
+# --- Fixture setup: create a bare git repo from the valid-local-kit fixture ---
+FIXTURE_REPO="$TMP_DIR/fixture-bare-repo"
+FIXTURE_WORKING="$TMP_DIR/fixture-working"
+cp -R "$VALID_SRC" "$FIXTURE_WORKING"
+(cd "$FIXTURE_WORKING" && git init -q && git config user.email "test@test.local" && git config user.name "test" && git add -A && git commit -q -m "init")
+git clone -q --bare "$FIXTURE_WORKING" "$FIXTURE_REPO"
+FILE_URL="file://$FIXTURE_REPO"
+
+echo "  (fixture repo: $FILE_URL)"
+
+# --- Test 1: basic install-git from file:// URL ---
+install_out="$TMP_DIR/install-git.out"
+if flow_agents_node "$CLI" install-git "$FILE_URL" --dest "$DEST" >"$install_out" 2>&1; then
+  pass "install-git from file:// URL succeeds"
+else
+  fail "install-git from file:// URL failed"
+  sed -n '1,80p' "$install_out"
+fi
+
+REGISTRY="$DEST/kits/local/installed-kits.json"
+if [[ -f "$REGISTRY" ]]; then
+  pass "install-git writes registry file"
+else
+  fail "install-git did not write registry file"
+fi
+
+if node - "$REGISTRY" "$FILE_URL" <<'NODE'
+const fs = require("node:fs");
+const registry = JSON.parse(fs.readFileSync(process.argv[2], "utf8"));
+const entry = registry.kits[0];
+if (!entry) throw new Error("no kits in registry");
+for (const key of ["id", "source", "hash", "installed_at", "installed_path", "state"]) {
+  if (!(key in entry)) throw new Error(`missing metadata key: ${key}`);
+}
+if (entry.id !== "example-kit") throw new Error(`unexpected id: ${entry.id}`);
+if (!entry.hash.startsWith("sha256:")) throw new Error("hash should include sha256 prefix");
+if (Number.isNaN(Date.parse(entry.installed_at))) throw new Error("installed_at should be ISO parseable");
+if (!fs.existsSync(entry.installed_path + "/kit.json")) throw new Error("installed kit copy missing kit.json");
+const expectedSource = process.argv[3];
+if (!entry.source.startsWith(expectedSource.replace(/\/$/, ""))) throw new Error(`source mismatch: ${entry.source}`);
+console.log("ok");
+NODE
+then
+  pass "install-git records correct provenance metadata"
+else
+  fail "install-git metadata is incomplete"
+fi
+
+# --- Test 2: idempotent re-install from same URL ---
+idempotent_out="$TMP_DIR/idempotent.out"
+registry_hash_before="$(shasum -a 256 "$REGISTRY" | awk '{print $1}')"
+if flow_agents_node "$CLI" install-git "$FILE_URL" --dest "$DEST" >"$idempotent_out" 2>&1 \
+  && grep -q "already installed" "$idempotent_out" \
+  && [[ "$registry_hash_before" == "$(shasum -a 256 "$REGISTRY" | awk '{print $1}')" ]]; then
+  pass "install-git same-URL reinstall is idempotent"
+else
+  fail "install-git same-URL reinstall was not idempotent"
+  sed -n '1,80p' "$idempotent_out"
+fi
+
+# --- Test 3: #ref fragment syntax ---
+ref_out="$TMP_DIR/ref.out"
+DEST2="$TMP_DIR/dest-with-ref"
+mkdir -p "$DEST2"
+# Re-create fixture repo with a tagged commit so we can test #ref
+FIXTURE_WORKING2="$TMP_DIR/fixture-working2"
+FIXTURE_REPO2="$TMP_DIR/fixture-bare-repo2"
+cp -R "$VALID_SRC" "$FIXTURE_WORKING2"
+(cd "$FIXTURE_WORKING2" && git init -q && git config user.email "test@test.local" && git config user.name "test" && git add -A && git commit -q -m "init" && git tag v1.0)
+git clone -q --bare "$FIXTURE_WORKING2" "$FIXTURE_REPO2"
+FILE_URL2="file://$FIXTURE_REPO2"
+
+if flow_agents_node "$CLI" install-git "${FILE_URL2}#v1.0" --dest "$DEST2" >"$ref_out" 2>&1; then
+  pass "install-git with #ref fragment succeeds"
+else
+  fail "install-git with #ref fragment failed"
+  sed -n '1,80p' "$ref_out"
+fi
+
+if node - "$DEST2/kits/local/installed-kits.json" "${FILE_URL2}#v1.0" <<'NODE'
+const fs = require("node:fs");
+const registry = JSON.parse(fs.readFileSync(process.argv[2], "utf8"));
+const entry = registry.kits.find((e) => e.id === "example-kit");
+if (!entry) throw new Error("kit not found in registry");
+const expectedSource = process.argv[3];
+if (entry.source !== expectedSource) throw new Error(`source mismatch: expected ${expectedSource}, got ${entry.source}`);
+console.log("ok");
+NODE
+then
+  pass "install-git #ref stored in source metadata"
+else
+  fail "install-git #ref not stored correctly in source metadata"
+fi
+
+# --- Test 4: --ref flag syntax ---
+ref_flag_out="$TMP_DIR/ref-flag.out"
+DEST3="$TMP_DIR/dest-with-ref-flag"
+mkdir -p "$DEST3"
+if flow_agents_node "$CLI" install-git "$FILE_URL2" --ref v1.0 --dest "$DEST3" >"$ref_flag_out" 2>&1; then
+  pass "install-git with --ref flag succeeds"
+else
+  fail "install-git with --ref flag failed"
+  sed -n '1,80p' "$ref_flag_out"
+fi
+
+# --- Test 5: missing git URL exits non-zero ---
+missing_url_out="$TMP_DIR/missing-url.out"
+if flow_agents_node "$CLI" install-git --dest "$DEST" >"$missing_url_out" 2>&1; then
+  fail "install-git with no URL should exit non-zero"
+  sed -n '1,40p' "$missing_url_out"
+else
+  pass "install-git with no URL exits non-zero with usage message"
+fi
+
+# --- Test 6: invalid git URL exits non-zero ---
+invalid_url_out="$TMP_DIR/invalid-url.out"
+if flow_agents_node "$CLI" install-git "file:///nonexistent-repo-that-does-not-exist" --dest "$DEST" >"$invalid_url_out" 2>&1; then
+  fail "install-git with invalid URL should exit non-zero"
+  sed -n '1,40p' "$invalid_url_out"
+else
+  pass "install-git with invalid URL exits non-zero"
+fi
+
+# --- Test 7: catalog.json not mutated ---
+CATALOG_HASH_BEFORE="$(shasum -a 256 "$ROOT/kits/catalog.json" | awk '{print $1}')"
+# (all operations above have already run)
+if [[ "$CATALOG_HASH_BEFORE" == "$(shasum -a 256 "$ROOT/kits/catalog.json" | awk '{print $1}')" ]]; then
+  pass "install-git does not mutate source kits/catalog.json"
+else
+  fail "source kits/catalog.json changed during install-git test"
+fi
+
+echo ""
+if [[ "$errors" -eq 0 ]]; then
+  echo "install-git checks passed."
+  exit 0
+fi
+
+echo "install-git checks failed: $errors issue(s)."
+exit 1

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.0",
+  "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(); }