@kontourai/flow-agents 1.0.0 → 1.1.0

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

@@ -27,5 +27,22 @@ 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).
+import * as _fsVST from "node:fs";
+import { fileURLToPath as _ftpVST } from "node:url";
+const _selfVST = (() => { try {
+    return _fsVST.realpathSync(_ftpVST(import.meta.url));
+}
+catch {
+    return _ftpVST(import.meta.url);
+} })();
+const _argv1VST = (() => { try {
+    return _fsVST.realpathSync(process.argv[1]);
+}
+catch {
+    return process.argv[1];
+} })();
+if (_selfVST === _argv1VST) {
+    process.exitCode = main();
+}

package/build/src/cli/veritas-governance.js

@@ -1,4 +1,5 @@
 import * as fs from "node:fs";
+import { fileURLToPath } from "node:url";
 import * as path from "node:path";
 import { spawnSync } from "node:child_process";
 import { flagBool, flagString, parseArgs } from "../lib/args.js";
@@ -258,5 +259,21 @@ export function main(argv = process.argv.slice(2)) {
     const options = parseEvidenceOptions(argv);
     return options ? runEvidence(options) : 2;
 }
-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/cli/workflow-artifact-cleanup-audit.js

@@ -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";
 const ACTIVE_STATUSES = new Set([
@@ -268,5 +269,21 @@ export function main(argv = process.argv.slice(2)) {
         printText(result);
     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/runtime-adapters.js

@@ -74,7 +74,7 @@ export function readKitInventory(sourceRoot, dest) {
     const assets = [];
     const catalogPath = path.join(sourceRoot, "kits", "catalog.json");
     if (!fs.existsSync(catalogPath))
-        errors.push(`${catalogPath}: missing Kit Catalog`);
+        warnings.push(`${catalogPath}: built-in Kit Catalog not found; skipping built-in kits (this is normal when running outside a flow-agents checkout)`);
     else {
         const catalog = readJson(catalogPath);
         const kits = catalog.kits;
@@ -118,31 +118,48 @@ export function readKitInventory(sourceRoot, dest) {
 function safeSegment(value) {
     return value.replace(/[^A-Za-z0-9_.-]+/g, "-").replace(/^[.-]+|[.-]+$/g, "") || "asset";
 }
+// Asset classes that are directly activated (copied to the runtime directory) by both adapters.
+// flows: gate definitions read by the adapter's flow-routing layer.
+// skills: agent guidance markdown copied to skills/<kit-id>/ for agent discovery.
+// docs: documentation markdown copied to docs/<kit-id>/ for agent reference.
+const ACTIVATED_ASSET_CLASSES = new Set(["flows", "skills", "docs"]);
 export function activateCodexLocal(sourceRoot, dest) {
     const inventory = readKitInventory(sourceRoot, dest);
     const runtimeDir = path.join(dest, ".flow-agents", "runtime", "codex");
     const generated = [];
     const skipped = [];
     for (const asset of inventory.assets) {
-        if (asset.asset_class !== "flows") {
-            skipped.push({ asset_class: asset.asset_class, path: asset.relative_path, kit_id: asset.kit_id, asset_id: asset.asset_id, reason: "asset class is diagnostic-only for codex-local" });
-            continue;
+        if (asset.asset_class === "flows") {
+            if (!asset.asset_id) {
+                skipped.push({ asset_class: asset.asset_class, path: asset.relative_path, kit_id: asset.kit_id, asset_id: null, reason: "flow asset is missing an id" });
+                continue;
+            }
+            const output = path.join(runtimeDir, "flows", safeSegment(asset.kit_id), `${safeSegment(asset.asset_id)}.flow.json`);
+            fs.mkdirSync(path.dirname(output), { recursive: true });
+            fs.copyFileSync(asset.source_path, output);
+            generated.push({ asset_class: asset.asset_class, path: relPath(dest, output), kit_id: asset.kit_id, asset_id: asset.asset_id, source_path: asset.source_path.split(path.sep).join("/") });
         }
-        if (!asset.asset_id) {
-            skipped.push({ asset_class: asset.asset_class, path: asset.relative_path, kit_id: asset.kit_id, asset_id: null, reason: "flow asset is missing an id" });
-            continue;
+        else if (asset.asset_class === "skills" || asset.asset_class === "docs") {
+            // Copy skills and docs to runtime/<adapter>/<class>/<kit-id>/<filename> so the
+            // agent's guidance index (AGENTS.md) can reference them and they are co-located
+            // with flow definitions for the same kit.
+            const filename = path.basename(asset.source_path);
+            const output = path.join(runtimeDir, asset.asset_class, safeSegment(asset.kit_id), filename);
+            fs.mkdirSync(path.dirname(output), { recursive: true });
+            fs.copyFileSync(asset.source_path, output);
+            generated.push({ asset_class: asset.asset_class, path: relPath(dest, output), kit_id: asset.kit_id, asset_id: asset.asset_id ?? "", source_path: asset.source_path.split(path.sep).join("/") });
+        }
+        else {
+            skipped.push({ asset_class: asset.asset_class, path: asset.relative_path, kit_id: asset.kit_id, asset_id: asset.asset_id, reason: "asset class is not activated by codex-local" });
         }
-        const output = path.join(runtimeDir, "flows", safeSegment(asset.kit_id), `${safeSegment(asset.asset_id)}.flow.json`);
-        fs.mkdirSync(path.dirname(output), { recursive: true });
-        fs.copyFileSync(asset.source_path, output);
-        generated.push({ asset_class: asset.asset_class, path: relPath(dest, output), kit_id: asset.kit_id, asset_id: asset.asset_id, source_path: asset.source_path.split(path.sep).join("/") });
     }
     fs.mkdirSync(runtimeDir, { recursive: true });
-    const manifest = { schema_version: "1.0", adapter: "codex-local", supported_asset_classes: ["flows"], generated_runtime_files: generated, skipped_assets: skipped, warnings: inventory.warnings, errors: inventory.errors };
+    const supportedClasses = Array.from(ACTIVATED_ASSET_CLASSES);
+    const manifest = { schema_version: "1.0", adapter: "codex-local", supported_asset_classes: supportedClasses, generated_runtime_files: generated, skipped_assets: skipped, warnings: inventory.warnings, errors: inventory.errors };
     const manifestPath = path.join(runtimeDir, "activation.json");
     writeJson(manifestPath, manifest);
     generated.push({ asset_class: "activation-manifest", path: relPath(dest, manifestPath), kit_id: "runtime", asset_id: "codex-local.activation", source_path: manifestPath.split(path.sep).join("/") });
-    return { selected_adapter: "codex-local", supported_asset_classes: ["flows"], generated_runtime_files: generated, skipped_assets: skipped, warnings: inventory.warnings, errors: inventory.errors };
+    return { selected_adapter: "codex-local", supported_asset_classes: supportedClasses, generated_runtime_files: generated, skipped_assets: skipped, warnings: inventory.warnings, errors: inventory.errors };
 }
 // Decision Q3 (Issue #32): Option (a) — new adapter id "strands-local" rather than
 // loading kit flows inside FlowAgentsHooks. Rationale: activation is a workspace-prep
@@ -154,27 +171,41 @@ export function activateStrandsLocal(sourceRoot, dest) {
     const inventory = readKitInventory(sourceRoot, dest);
     // Runtime flows land at .flow-agents/runtime/strands/flows/<kit-id>/<asset-id>.flow.json
     // so the Strands steering context can glob for *.flow.json under this path.
+    // Runtime skills land at .flow-agents/runtime/strands/skills/<kit-id>/<filename> and
+    // docs at .flow-agents/runtime/strands/docs/<kit-id>/<filename> for system-prompt injection.
     const runtimeDir = path.join(dest, ".flow-agents", "runtime", "strands");
     const generated = [];
     const skipped = [];
     for (const asset of inventory.assets) {
-        if (asset.asset_class !== "flows") {
-            skipped.push({ asset_class: asset.asset_class, path: asset.relative_path, kit_id: asset.kit_id, asset_id: asset.asset_id, reason: "asset class is diagnostic-only for strands-local" });
-            continue;
+        if (asset.asset_class === "flows") {
+            if (!asset.asset_id) {
+                skipped.push({ asset_class: asset.asset_class, path: asset.relative_path, kit_id: asset.kit_id, asset_id: null, reason: "flow asset is missing an id" });
+                continue;
+            }
+            const output = path.join(runtimeDir, "flows", safeSegment(asset.kit_id), `${safeSegment(asset.asset_id)}.flow.json`);
+            fs.mkdirSync(path.dirname(output), { recursive: true });
+            fs.copyFileSync(asset.source_path, output);
+            generated.push({ asset_class: asset.asset_class, path: relPath(dest, output), kit_id: asset.kit_id, asset_id: asset.asset_id, source_path: asset.source_path.split(path.sep).join("/") });
         }
-        if (!asset.asset_id) {
-            skipped.push({ asset_class: asset.asset_class, path: asset.relative_path, kit_id: asset.kit_id, asset_id: null, reason: "flow asset is missing an id" });
-            continue;
+        else if (asset.asset_class === "skills" || asset.asset_class === "docs") {
+            // Mirror the codex-local layout: strands/<class>/<kit-id>/<filename>.
+            // The Strands system-prompt injection layer can glob for all *.md files under
+            // .flow-agents/runtime/strands/skills/ to include agent guidance in the context.
+            const filename = path.basename(asset.source_path);
+            const output = path.join(runtimeDir, asset.asset_class, safeSegment(asset.kit_id), filename);
+            fs.mkdirSync(path.dirname(output), { recursive: true });
+            fs.copyFileSync(asset.source_path, output);
+            generated.push({ asset_class: asset.asset_class, path: relPath(dest, output), kit_id: asset.kit_id, asset_id: asset.asset_id ?? "", source_path: asset.source_path.split(path.sep).join("/") });
+        }
+        else {
+            skipped.push({ asset_class: asset.asset_class, path: asset.relative_path, kit_id: asset.kit_id, asset_id: asset.asset_id, reason: "asset class is not activated by strands-local" });
         }
-        const output = path.join(runtimeDir, "flows", safeSegment(asset.kit_id), `${safeSegment(asset.asset_id)}.flow.json`);
-        fs.mkdirSync(path.dirname(output), { recursive: true });
-        fs.copyFileSync(asset.source_path, output);
-        generated.push({ asset_class: asset.asset_class, path: relPath(dest, output), kit_id: asset.kit_id, asset_id: asset.asset_id, source_path: asset.source_path.split(path.sep).join("/") });
     }
     fs.mkdirSync(runtimeDir, { recursive: true });
-    const manifest = { schema_version: "1.0", adapter: "strands-local", supported_asset_classes: ["flows"], generated_runtime_files: generated, skipped_assets: skipped, warnings: inventory.warnings, errors: inventory.errors };
+    const supportedClasses = Array.from(ACTIVATED_ASSET_CLASSES);
+    const manifest = { schema_version: "1.0", adapter: "strands-local", supported_asset_classes: supportedClasses, generated_runtime_files: generated, skipped_assets: skipped, warnings: inventory.warnings, errors: inventory.errors };
     const manifestPath = path.join(runtimeDir, "activation.json");
     writeJson(manifestPath, manifest);
     generated.push({ asset_class: "activation-manifest", path: relPath(dest, manifestPath), kit_id: "runtime", asset_id: "strands-local.activation", source_path: manifestPath.split(path.sep).join("/") });
-    return { selected_adapter: "strands-local", supported_asset_classes: ["flows"], generated_runtime_files: generated, skipped_assets: skipped, warnings: inventory.warnings, errors: inventory.errors };
+    return { selected_adapter: "strands-local", supported_asset_classes: supportedClasses, generated_runtime_files: generated, skipped_assets: skipped, warnings: inventory.warnings, errors: inventory.errors };
 }

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";
@@ -84,7 +85,7 @@ const fixtureOwnerPolicies = new Map([
     ["evals/fixtures/backlog-provider-settings", { owners: ["evals/integration/test_effective_backlog_settings.sh"], classification: "settings precedence fixtures" }],
     ["evals/fixtures/builder-kit-workflow-state", { owners: ["evals/static/test_workflow_skills.sh"], classification: "Builder Kit workflow-state fixtures" }],
     ["evals/fixtures/console-learning-projection", { owners: ["evals/integration/test_console_learning_projection.sh"], classification: "console learning projection fixtures" }],
-    ["evals/fixtures/flow-kit-repository", { owners: ["evals/integration/test_flow_kit_repository.sh", "evals/integration/test_local_flow_kit_install.sh", "evals/integration/test_runtime_adapter_activation.sh", "evals/static/test_workflow_skills.sh"], classification: "Flow Kit repository contract fixtures" }],
+    ["evals/fixtures/flow-kit-repository", { owners: ["evals/integration/test_flow_kit_repository.sh", "evals/integration/test_local_flow_kit_install.sh", "evals/integration/test_runtime_adapter_activation.sh", "evals/integration/test_activate_npx_context.sh", "evals/integration/test_flow_kit_install_git.sh", "evals/static/test_workflow_skills.sh"], classification: "Flow Kit repository contract fixtures" }],
     ["evals/fixtures/kit-conformance-levels", { owners: ["evals/integration/test_kit_conformance_levels.sh"], classification: "K-level conformance and consumer-target derivation fixtures" }],
     ["evals/fixtures/hook-influence", { owners: ["evals/integration/test_hook_influence_cases.sh", "evals/static/test_workflow_skills.sh", "scripts/validate-hook-influence-cases.js"], classification: "hook influence behavioral cases" }],
     ["evals/fixtures/pull-work-provider", { owners: ["evals/integration/test_pull_work_provider.sh"], classification: "work item provider normalization fixtures" }],
@@ -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/fixture-ownership.md

@@ -16,7 +16,7 @@ run `npm run validate:source --` and `npm run fixture:retirement-audit --`.
 | `evals/fixtures/backlog-provider-settings` | settings precedence fixtures | `evals/integration/test_effective_backlog_settings.sh` | Keep while backlog provider settings resolution supports global defaults and project overrides. |
 | `evals/fixtures/builder-kit-workflow-state` | Builder Kit workflow-state fixtures | `evals/static/test_workflow_skills.sh` | Keep while Builder Kit state contract and resume behavior are documented in workflow skill contracts. |
 | `evals/fixtures/console-learning-projection` | console learning projection fixtures | `evals/integration/test_console_learning_projection.sh` | Keep while learning projection supports correction and open-route examples. |
-| `evals/fixtures/flow-kit-repository` | Flow Kit repository contract fixtures | `evals/integration/test_flow_kit_repository.sh`, `evals/integration/test_local_flow_kit_install.sh`, `evals/integration/test_runtime_adapter_activation.sh`, `evals/static/test_workflow_skills.sh` | Keep valid and invalid cases paired with the Flow Kit repository contract. |
+| `evals/fixtures/flow-kit-repository` | Flow Kit repository contract fixtures | `evals/integration/test_flow_kit_repository.sh`, `evals/integration/test_local_flow_kit_install.sh`, `evals/integration/test_runtime_adapter_activation.sh`, `evals/integration/test_activate_npx_context.sh`, `evals/integration/test_flow_kit_install_git.sh`, `evals/static/test_workflow_skills.sh` | Keep valid and invalid cases paired with the Flow Kit repository contract. |
 | `evals/fixtures/kit-conformance-levels` | K-level conformance and consumer-target derivation fixtures | `evals/integration/test_kit_conformance_levels.sh` | Keep while K-level derivation, degradation invariant, and consumer-target badge rules are tested. |
 | `evals/fixtures/hook-influence` | hook influence behavioral cases | `evals/integration/test_hook_influence_cases.sh`, `evals/static/test_workflow_skills.sh`, `scripts/validate-hook-influence-cases.js` | Keep while hook influence cases define agent guidance behavior. |
 | `evals/fixtures/pull-work-provider` | work item provider normalization fixtures | `evals/integration/test_pull_work_provider.sh` | Keep while provider normalization preserves blockers, artifact refs, board membership, and freshness metadata. |

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"