@kontourai/flow-agents 1.0.1 → 1.2.0

package/evals/integration/test_pull_work_provider.sh

@@ -52,7 +52,7 @@ status=$?
 [[ "$(json_query "$TMPDIR_EVAL/normalized.json" "items.5.planned_base_sha")" == "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" ]] && pass "marker normalizes planned_base_sha" || fail "marker normalizes planned_base_sha"
 [[ "$(json_query "$TMPDIR_EVAL/normalized.json" "items.5.planned_at")" == "2026-06-03T03:23:14Z" ]] && pass "marker normalizes planned_at" || fail "marker normalizes planned_at"
 [[ "$(json_query "$TMPDIR_EVAL/normalized.json" "items.5.planning_artifact_ref")" == ".flow-agents/idea-to-backlog-source-revision-structured-blockers/idea-to-backlog-source-revision-structured-blockers--plan.md" ]] && pass "marker normalizes planning_artifact_ref" || fail "marker normalizes planning_artifact_ref"
-[[ "$(json_query "$TMPDIR_EVAL/normalized.json" "items.5.planning_scope_refs.0")" == "skills/idea-to-backlog/SKILL.md" ]] && pass "marker normalizes planning_scope_refs" || fail "marker normalizes planning_scope_refs"
+[[ "$(json_query "$TMPDIR_EVAL/normalized.json" "items.5.planning_scope_refs.0")" == "kits/builder/skills/idea-to-backlog/SKILL.md" ]] && pass "marker normalizes planning_scope_refs" || fail "marker normalizes planning_scope_refs"
 [[ "$(json_query "$TMPDIR_EVAL/normalized.json" "items.5.source_revisions.1.repo")" == "kontourai/flow" ]] && pass "marker preserves repo-scoped source_revisions" || fail "marker preserves repo-scoped source_revisions"
 [[ "$(json_query "$TMPDIR_EVAL/normalized.json" "items.5.blockers.0.ref.owner")" == "kontourai" ]] && pass "structured blocker preserves provider owner" || fail "structured blocker preserves provider owner"
 [[ "$(json_query "$TMPDIR_EVAL/normalized.json" "items.5.blockers.0.ref.repo")" == "flow" ]] && pass "structured blocker preserves provider repo" || fail "structured blocker preserves provider repo"

package/evals/integration/test_runtime_adapter_activation.sh

@@ -12,7 +12,7 @@ trap 'rm -rf "$TMP_DIR"' EXIT
 pass() { echo "  ✓ $1"; }
 fail() { echo "  ✗ $1"; errors=$((errors + 1)); }
 
-CLI="$ROOT/scripts/flow-kit.js"
+CLI="$ROOT/scripts/kit.js"
 DEST="$TMP_DIR/runtime-dest"
 MIXED_SRC="$ROOT/evals/fixtures/flow-kit-repository/mixed-runtime-kit"
 OUT="$TMP_DIR/activation.json"
@@ -22,7 +22,7 @@ mkdir -p "$DEST"
 
 echo "=== Runtime Adapter Activation Checks ==="
 
-if flow_agents_node "$CLI" install-local "$MIXED_SRC" --dest "$DEST" >"$TMP_DIR/install.out" 2>&1; then
+if flow_agents_node "$CLI" install "$MIXED_SRC" --dest "$DEST" >"$TMP_DIR/install.out" 2>&1; then
   pass "mixed local kit installs into temp destination"
 else
   fail "mixed local kit install failed"
@@ -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 "$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/lib/node.sh

@@ -45,10 +45,10 @@ flow_agents_node() {
       node "$FLOW_AGENTS_EVAL_ROOT/build/src/cli/validate-source-tree.js" "$@"
       return
       ;;
-    */scripts/flow-kit.js|scripts/flow-kit.js)
+    */scripts/kit.js|scripts/kit.js)
       shift
       flow_agents_build_ts || return
-      node "$FLOW_AGENTS_EVAL_ROOT/build/src/cli/flow-kit.js" "$@"
+      node "$FLOW_AGENTS_EVAL_ROOT/build/src/cli/kit.js" "$@"
       return
       ;;
     */scripts/effective-backlog-settings.js|scripts/effective-backlog-settings.js)

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/evals/static/test_workflow_skills.sh

@@ -52,19 +52,19 @@ require_status() {
 
 echo "=== Workflow Skill Contract Checks ==="
 
-IDEA="$ROOT/skills/idea-to-backlog/SKILL.md"
-BUILDER_SHAPE="$ROOT/skills/builder-shape/SKILL.md"
-PULL="$ROOT/skills/pull-work/SKILL.md"
-DESIGN_PROBE="$ROOT/skills/design-probe/SKILL.md"
-PICKUP_PROBE="$ROOT/skills/pickup-probe/SKILL.md"
-EVIDENCE="$ROOT/skills/evidence-gate/SKILL.md"
-RELEASE="$ROOT/skills/release-readiness/SKILL.md"
-LEARNING="$ROOT/skills/learning-review/SKILL.md"
-DELIVER="$ROOT/skills/deliver/SKILL.md"
-PLAN_WORK="$ROOT/skills/plan-work/SKILL.md"
-EXECUTE_PLAN="$ROOT/skills/execute-plan/SKILL.md"
-REVIEW_WORK="$ROOT/skills/review-work/SKILL.md"
-VERIFY_WORK="$ROOT/skills/verify-work/SKILL.md"
+IDEA="$ROOT/kits/builder/skills/idea-to-backlog/SKILL.md"
+BUILDER_SHAPE="$ROOT/kits/builder/skills/builder-shape/SKILL.md"
+PULL="$ROOT/kits/builder/skills/pull-work/SKILL.md"
+DESIGN_PROBE="$ROOT/kits/builder/skills/design-probe/SKILL.md"
+PICKUP_PROBE="$ROOT/kits/builder/skills/pickup-probe/SKILL.md"
+EVIDENCE="$ROOT/kits/builder/skills/evidence-gate/SKILL.md"
+RELEASE="$ROOT/kits/builder/skills/release-readiness/SKILL.md"
+LEARNING="$ROOT/kits/builder/skills/learning-review/SKILL.md"
+DELIVER="$ROOT/kits/builder/skills/deliver/SKILL.md"
+PLAN_WORK="$ROOT/kits/builder/skills/plan-work/SKILL.md"
+EXECUTE_PLAN="$ROOT/kits/builder/skills/execute-plan/SKILL.md"
+REVIEW_WORK="$ROOT/kits/builder/skills/review-work/SKILL.md"
+VERIFY_WORK="$ROOT/kits/builder/skills/verify-work/SKILL.md"
 MAP="$ROOT/docs/skills-map.md"
 ROOT_CONTEXT="$ROOT/CONTEXT.md"
 CONTEXT_MAP="$ROOT/docs/context-map.md"
@@ -146,6 +146,7 @@ while IFS= read -r guidance_surface; do
 done < <(
   {
     find "$ROOT/skills" -type f -name '*.md'
+    find "$ROOT/kits" -path "*/skills/*/SKILL.md" -type f
     find "$ROOT/context/contracts" -maxdepth 1 -type f -name '*.md'
     find "$ROOT/agents" -maxdepth 1 -type f -name '*.json'
     printf '%s\n' "$ROOT/packaging/manifest.json"
@@ -553,7 +554,7 @@ echo ""
 echo "--- builder-shape ---"
 require_text "$BUILDER_SHAPE" '^name: "builder-shape"$' "frontmatter name"
 require_text "$BUILDER_SHAPE" 'Builder Kit `shape` flow' "defines Builder Kit shape product surface"
-require_text "$BUILDER_SHAPE" 'skills/idea-to-backlog/SKILL.md' "delegates to idea-to-backlog"
+require_text "$BUILDER_SHAPE" 'kits/builder/skills/idea-to-backlog/SKILL.md' "delegates to idea-to-backlog"
 require_text "$BUILDER_SHAPE" 'kits/builder/flows/shape.flow.json' "links Builder Kit Flow Definition"
 require_text "$BUILDER_SHAPE" 'raw idea.*current conversation context|current conversation context.*raw idea' "accepts raw idea or conversation context"
 require_text "$BUILDER_SHAPE" 'Probe/alignment' "uses Probe alignment language"
@@ -1102,7 +1103,6 @@ require_text "$PACKS_MANIFEST" '"name": "core"' "pack manifest defines core pack
 require_text "$PACKS_MANIFEST" '"default": true' "pack manifest defines default pack"
 require_text "$PACKS_MANIFEST" '"name": "development"' "pack manifest defines development pack"
 require_text "$PACKS_MANIFEST" '"eval-rebuild"' "pack manifest includes eval-rebuild"
-require_text "$PACKS_MANIFEST" '"explore"' "pack manifest includes explore"
 require_text "$ROOT/scripts/build-universal-bundles.js" 'FLOW_AGENTS_PACKS' "bundle installer supports pack filtering"
 require_text "$ROOT/evals/integration/test_bundle_install.sh" 'core-pack install keeps core agents' "bundle install test covers pack filtering"
 require_text "$CONTEXT_MAP" 'Context Loading Rules' "context map includes loading rules"

package/integrations/strands/flow_agents_strands/steering.py

@@ -211,7 +211,7 @@ class SteeringContext:
         """
         Surface activated kit flows from the strands-local runtime path.
 
-        Reads .flow-agents/runtime/strands/flows/ (written by `flow-kit activate
+        Reads .flow-agents/runtime/strands/flows/ (written by `flow-agents kit activate
         --adapter strands-local`) and emits a brief hint listing active kit flows
         by id and description so the agent is aware of available workflow guidance.
         """

package/integrations/strands-ts/src/hooks.ts

@@ -189,7 +189,7 @@ export class FlowAgentsHooks {
    *
    * Includes activated kit flows discovered from the strands-local runtime
    * path (.flow-agents/runtime/strands/flows/) written by
-   * `flow-kit activate --adapter strands-local`.
+   * `flow-agents kit activate --adapter strands-local`.
    *
    * Callers should prepend this to the Agent's system prompt:
    *

package/kits/builder/kit.json

@@ -15,5 +15,22 @@
       "path": "flows/build.flow.json",
       "description": "Pull ready work through design probing, planning, implementation, verification, pull request readiness, merge readiness, and learning."
     }
+  ],
+  "skills": [
+    { "id": "builder.builder-shape", "path": "skills/builder-shape/SKILL.md", "description": "Invoke Builder Kit shape from a raw idea or the current conversation context." },
+    { "id": "builder.deliver", "path": "skills/deliver/SKILL.md", "description": "Delivery workflow — selected work to delivered code." },
+    { "id": "builder.design-probe", "path": "skills/design-probe/SKILL.md", "description": "One-question-at-a-time design probing interview." },
+    { "id": "builder.evidence-gate", "path": "skills/evidence-gate/SKILL.md", "description": "Evaluate whether completed work is trustworthy enough for human review, merge, or release." },
+    { "id": "builder.execute-plan", "path": "skills/execute-plan/SKILL.md", "description": "Parallel execution primitive — plan artifact path to implemented code." },
+    { "id": "builder.fix-bug", "path": "skills/fix-bug/SKILL.md", "description": "Bug fix orchestrator — diagnose, plan, execute, review, verify, loop." },
+    { "id": "builder.idea-to-backlog", "path": "skills/idea-to-backlog/SKILL.md", "description": "Turn raw ideas into shaped, prioritized, executable GitHub issue backlog." },
+    { "id": "builder.learning-review", "path": "skills/learning-review/SKILL.md", "description": "Capture post-merge learnings and feed them back into backlog, skills, tests, or knowledge." },
+    { "id": "builder.pickup-probe", "path": "skills/pickup-probe/SKILL.md", "description": "Builder Kit work-item/docs/provider-grounded Probe specialization before plan-work." },
+    { "id": "builder.plan-work", "path": "skills/plan-work/SKILL.md", "description": "Code planning primitive — goal + directory to structured execution plan." },
+    { "id": "builder.pull-work", "path": "skills/pull-work/SKILL.md", "description": "Select ready GitHub issues from the executable backlog for implementation." },
+    { "id": "builder.release-readiness", "path": "skills/release-readiness/SKILL.md", "description": "Decide whether evidence-backed work is ready to merge, release, deploy, or hold." },
+    { "id": "builder.review-work", "path": "skills/review-work/SKILL.md", "description": "Review primitive — code, security, dependency, architecture critique before verification." },
+    { "id": "builder.tdd-workflow", "path": "skills/tdd-workflow/SKILL.md", "description": "Test-driven development — RED, GREEN, REFACTOR with git checkpoints." },
+    { "id": "builder.verify-work", "path": "skills/verify-work/SKILL.md", "description": "Verification primitive — session file path to structured evidence verdict." }
   ]
 }

package/{skills → kits/builder/skills}/builder-shape/SKILL.md

@@ -11,7 +11,7 @@ Invoke the Builder Kit `shape` flow for raw product ideas, vague build goals, cu
 
 - Product surface: let the user ask for "Builder Kit shape", "builder shape", or "shape this with Builder Kit" without naming `idea-to-backlog`.
 - Proactive suggestion: when a user starts planning a feature, product, PRD, roadmap item, or vague build idea without naming a workflow, briefly suggest Builder Kit shape as the structured path before implementation. Phrase it as an option, not a forced gate, unless the request is too ambiguous to plan responsibly.
-- Delegation: use `skills/idea-to-backlog/SKILL.md` as the shaping primitive. Do not duplicate or replace its workflow, artifact contract, issue shape, or gate rules.
+- Delegation: use `kits/builder/skills/idea-to-backlog/SKILL.md` as the shaping primitive. Do not duplicate or replace its workflow, artifact contract, issue shape, or gate rules.
 - Product-level auto-guidance: when the user invokes Builder Kit shape, guide them through `design-probe` alignment and then the `idea-to-backlog` workflow directly; do not require them to type `design-probe` or `idea-to-backlog` as additional skill names.
 - do not require them to type `idea-to-backlog`; Builder Kit shape owns the user-facing route into that primitive.
 - Flow reference: link every Builder Kit shape artifact to the Builder Kit Flow Definition at `kits/builder/flows/shape.flow.json`.
@@ -19,7 +19,7 @@ Invoke the Builder Kit `shape` flow for raw product ideas, vague build goals, cu
 - Probe/alignment: when the idea, user outcome, constraints, non-goals, success signal, risk, or bundle relationship is unclear, run `design-probe` style alignment before continuing.
 - Default stop: stop at the backlog gate by default. Do not create GitHub issues, sync to a project, or hand off to `pull-work` unless the user explicitly asks for that next step.
 - Boundary: do not run Builder Kit build execution, remote kit install, package extraction, downstream delivery workflows, `plan-work`, `execute-plan`, `review-work`, `verify-work`, `evidence-gate`, or release workflows from this invocation.
-- Compatibility: Direct `idea-to-backlog` usage remains valid and should behave exactly as described in `skills/idea-to-backlog/SKILL.md`.
+- Compatibility: Direct `idea-to-backlog` usage remains valid and should behave exactly as described in `kits/builder/skills/idea-to-backlog/SKILL.md`.
 - Primitive recovery: if a user invokes `idea-to-backlog` or another primitive with missing shaping context and appears to want the product flow, explain that Builder Kit shape is the entry point and offer to route there.
 
 ## Invocation
@@ -33,7 +33,7 @@ Use this skill when the user says things like:
 
 When activated:
 
-1. Read `skills/idea-to-backlog/SKILL.md`.
+1. Read `kits/builder/skills/idea-to-backlog/SKILL.md`.
 2. State that Builder Kit shape delegates to `idea-to-backlog` and uses `kits/builder/flows/shape.flow.json`.
 3. Gather the raw idea or current conversation context.
 4. If needed, use `design-probe`: ask one Probe/alignment question at a time before shaping. Prefer questions that clarify user outcome, constraints, non-goals, success criteria, risk, or whether bundled ideas truly belong together.
@@ -72,5 +72,5 @@ For Builder Kit shape invocations, also include:
 Issue sync is explicit-only.
 
 - If the user did not ask to create or sync issues, set `backlog_links` to `not_requested` or an empty recorded status and stop at the backlog gate.
-- If the user asks to create or sync issues, follow the GitHub issue rules in `skills/idea-to-backlog/SKILL.md`.
+- If the user asks to create or sync issues, follow the GitHub issue rules in `kits/builder/skills/idea-to-backlog/SKILL.md`.
 - If provider details are missing, ask for them instead of assuming a GitHub repository, project, labels, milestone, or assignee.

package/{skills → kits/builder/skills}/idea-to-backlog/SKILL.md

@@ -217,7 +217,7 @@ Provider-neutral marker example:
       "planned_at": "2026-06-03T03:23:14Z",
       "planning_artifact_ref": ".flow-agents/example/example--idea-to-backlog.md",
       "planning_scope_refs": [
-        "skills/idea-to-backlog/SKILL.md",
+        "kits/builder/skills/idea-to-backlog/SKILL.md",
         "context/contracts/work-item-contract.md"
       ]
     }

package/kits/knowledge/kit.json

@@ -3,7 +3,7 @@
   "id": "knowledge",
   "name": "Knowledge Kit",
   "product_name": "Knowledge Kit",
-  "description": "A Flow Kit for durable, gated knowledge storage. Provides a store contract with defined record types, mutation operations, and provenance rules \u2014 plus a default adapter backed by markdown files, YAML frontmatter, wikilinks, and a graph index.",
+  "description": "A Flow Kit for durable, gated knowledge storage. Provides a store contract with defined record types, mutation operations, and provenance rules — plus a default adapter backed by markdown files, YAML frontmatter, wikilinks, and a graph index.",
   "flows": [
     {
       "id": "knowledge.store-contract",
@@ -13,17 +13,17 @@
     {
       "id": "knowledge.ingest",
       "path": "flows/ingest.flow.json",
-      "description": "Ingest raw captures: capture \u2192 classify \u2192 route. Gate on classify requires category + type='raw' classification evidence per the store contract create op."
+      "description": "Ingest raw captures: capture → classify → route. Gate on classify requires category + type='raw' classification evidence per the store contract create op."
     },
     {
       "id": "knowledge.compile",
       "path": "flows/compile.flow.json",
-      "description": "Compile classified raws into durable notes: select-raws \u2192 compile \u2192 link. Gate on compile requires provenance refs to every consumed raw record."
+      "description": "Compile classified raws into durable notes: select-raws → compile → link. Gate on compile requires provenance refs to every consumed raw record."
     },
     {
       "id": "knowledge.synthesize",
       "path": "flows/synthesize.flow.json",
-      "description": "Synthesize compiled sources into concept summaries: detect-cluster \u2192 propose \u2192 evidence-gate \u2192 apply-or-reject. Mutation-gate policy: no summary mutates without an approved proposal carrying source refs; rejection leaves store untouched."
+      "description": "Synthesize compiled sources into concept summaries: detect-cluster → propose → evidence-gate → apply-or-reject. Mutation-gate policy: no summary mutates without an approved proposal carrying source refs; rejection leaves store untouched."
     },
     {
       "id": "knowledge.consolidate",
@@ -33,7 +33,7 @@
     {
       "id": "knowledge.retire",
       "path": "flows/retire.flow.json",
-      "description": "Retire implemented or obsolete records from the working set via gated lifecycle: identify \u2192 propose-retirement \u2192 evidence-gate \u2192 apply-or-reject. Evidence required: retirement rationale + implementedByRef (when targeting 'implemented' status) or supersededByRef (optional, for 'retired'). Rejection leaves record status byte-identical. Retired records remain fully queryable with provenance via includeRetired flag."
+      "description": "Retire implemented or obsolete records from the working set via gated lifecycle: identify → propose-retirement → evidence-gate → apply-or-reject. Evidence required: retirement rationale + implementedByRef (when targeting 'implemented' status) or supersededByRef (optional, for 'retired'). Rejection leaves record status byte-identical. Retired records remain fully queryable with provenance via includeRetired flag."
     }
   ],
   "docs": [
@@ -55,7 +55,7 @@
     {
       "id": "knowledge.flow-runner",
       "path": "adapters/flow-runner/index.js",
-      "description": "Executable flow logic: capture(rawText, meta) \u2192 classified raw record; compile(rawIds[]) \u2192 compiled record with provenance links; synthesize(conceptId | topicSelector, options) \u2192 concept summary proposal with mutation gate; consolidate(snapshotId | topicSelector, options) \u2192 decision snapshot consolidation with supersede-not-delete; retire(recordId, options) \u2192 gated status lifecycle transition (active\u2192implemented\u2192retired) with working-set exclusion. Emits canonical telemetry events at gate points."
+      "description": "Executable flow logic: capture(rawText, meta) → classified raw record; compile(rawIds[]) → compiled record with provenance links; synthesize(conceptId | topicSelector, options) → concept summary proposal with mutation gate; consolidate(snapshotId | topicSelector, options) → decision snapshot consolidation with supersede-not-delete; retire(recordId, options) → gated status lifecycle transition (active→implemented→retired) with working-set exclusion. Emits canonical telemetry events at gate points."
     },
     {
       "id": "knowledge.similarity-vector",
@@ -82,7 +82,7 @@
     {
       "id": "knowledge.synthesis-suite",
       "path": "evals/synthesis/suite.test.js",
-      "description": "Eval cases for synthesize: AC1 (similar source \u2192 proposal not mutation), AC2 (rejection leaves concept byte-identical), AC3 (apply updates with provenance to all contributing sources), pluggable-similarity interface test, gate telemetry."
+      "description": "Eval cases for synthesize: AC1 (similar source → proposal not mutation), AC2 (rejection leaves concept byte-identical), AC3 (apply updates with provenance to all contributing sources), pluggable-similarity interface test, gate telemetry."
     },
     {
       "id": "knowledge.consolidation-suite",
@@ -92,7 +92,7 @@
     {
       "id": "knowledge.similarity-vector-suite",
       "path": "evals/similarity-vector/suite.test.js",
-      "description": "Eval cases for the vector similarity adapter: unit tests (cosineSimilarity math, injectable embed, threshold, fail-closed), drop-in proof (runner.synthesize with injected embed produces valid proposals), and live-gated tests (real ollama nomic-embed-text round-trip \u2014 skipped when ollama unavailable)."
+      "description": "Eval cases for the vector similarity adapter: unit tests (cosineSimilarity math, injectable embed, threshold, fail-closed), drop-in proof (runner.synthesize with injected embed produces valid proposals), and live-gated tests (real ollama nomic-embed-text round-trip — skipped when ollama unavailable)."
     },
     {
       "id": "knowledge.retirement-suite",
@@ -102,7 +102,14 @@
     {
       "id": "knowledge.entity-cards-suite",
       "path": "evals/entities/suite.test.js",
-      "description": "Eval cases for person/entity cards (issue #48): AC1-AC4 \u2014 entity extraction from Attendees lines, exact-match resolution, possible-duplicate detection, merge via propose/apply/reject (union aliases+backlinks, supersede duplicate), Obsidian people/ folder rendering, and extended contract suite (person type validity) on both adapters."
+      "description": "Eval cases for person/entity cards (issue #48): AC1-AC4 — entity extraction from Attendees lines, exact-match resolution, possible-duplicate detection, merge via propose/apply/reject (union aliases+backlinks, supersede duplicate), Obsidian people/ folder rendering, and extended contract suite (person type validity) on both adapters."
+    }
+  ],
+  "skills": [
+    {
+      "id": "knowledge.knowledge-capture",
+      "path": "skills/knowledge-capture/SKILL.md",
+      "description": "Save durable knowledge, lightweight pointers, user corrections, decisions, lessons, and source references into the knowledge base."
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontourai/flow-agents",
-  "version": "1.0.1",
+  "version": "1.2.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",
@@ -36,7 +36,6 @@
     "flow-agents-context-map": "build/src/cli.js",
     "flow-agents-effective-backlog-settings": "build/src/cli.js",
     "flow-agents-filter-installed-packs": "build/src/cli.js",
-    "flow-agents-flow-kit": "build/src/cli.js",
     "flow-agents-fixture-retirement-audit": "build/src/cli.js",
     "flow-agents-promote-workflow-artifact": "build/src/cli.js",
     "flow-agents-publish-change": "build/src/cli.js",
@@ -49,7 +48,8 @@
     "flow-agents-validate-hook-influence": "build/src/cli.js",
     "flow-agents-validate-source": "build/src/cli.js",
     "flow-agents-workflow-artifact-cleanup-audit": "build/src/cli.js",
-    "flow-agents-workflow-sidecar": "build/src/cli/workflow-sidecar.js"
+    "flow-agents-workflow-sidecar": "build/src/cli/workflow-sidecar.js",
+    "flow-agents-kit": "build/src/cli.js"
   },
   "files": [
     ".github/",
@@ -100,7 +100,6 @@
     "validate:package": "npm run build --silent && node build/src/cli.js validate-package",
     "workflow:sidecar": "npm run build --silent && node build/src/cli/workflow-sidecar.js",
     "workflow:validate-artifacts": "npm run build --silent && node build/src/cli/validate-workflow-artifacts.js",
-    "flow-kit": "npm run build --silent && node build/src/cli.js flow-kit",
     "effective-backlog-settings": "npm run build --silent && node build/src/cli.js effective-backlog-settings",
     "pull-work-provider": "npm run build --silent && node build/src/cli.js pull-work-provider",
     "publish-change": "npm run build --silent && node build/src/cli.js publish-change",
@@ -125,11 +124,15 @@
     "promptfoo": "PROMPTFOO_CONFIG_DIR=.promptfoo PROMPTFOO_DISABLE_WAL_MODE=true PROMPTFOO_DISABLE_TELEMETRY=true promptfoo",
     "promptfoo:view": "PROMPTFOO_CONFIG_DIR=.promptfoo PROMPTFOO_DISABLE_WAL_MODE=true PROMPTFOO_DISABLE_TELEMETRY=true promptfoo view",
     "check:content-boundary": "node scripts/check-content-boundary.cjs",
-    "prepack": "npm run build --silent && npm run validate:source --"
+    "prepack": "npm run build --silent && npm run validate:source --",
+    "kit": "npm run build --silent && node build/src/cli.js kit"
   },
   "devDependencies": {
     "@types/node": "^22.19.19",
     "promptfoo": "^0.121.15",
     "typescript": "^6.0.3"
+  },
+  "dependencies": {
+    "@kontourai/flow": "^1.2.0"
   }
 }