@kontourai/flow-agents 1.0.1 → 1.2.0

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
 
@@ -112,7 +112,7 @@ npm run validate:source --
 Once validation passes, install the kit into a target workspace:
 
 ```bash
-npx @kontourai/flow-agents flow-kit install-local path/to/my-kit --dest /path/to/workspace
+npx @kontourai/flow-agents kit install path/to/my-kit --dest /path/to/workspace
 ```
 
 `--dest` is the installed Flow Agents bundle root. When omitted the command uses the current directory. From a contributor checkout of this repository, the equivalent form is `npm run flow-kit -- <command>`.
@@ -120,8 +120,8 @@ npx @kontourai/flow-agents flow-kit install-local path/to/my-kit --dest /path/to
 Confirm the install:
 
 ```bash
-npx @kontourai/flow-agents flow-kit list --dest /path/to/workspace
-npx @kontourai/flow-agents flow-kit status my-kit --dest /path/to/workspace
+npx @kontourai/flow-agents kit list --dest /path/to/workspace
+npx @kontourai/flow-agents kit status my-kit --dest /path/to/workspace
 ```
 
 `list` prints one summary line per installed kit. `status` prints JSON provenance including the SHA256 content hash and `installed` or `missing` state.
@@ -129,7 +129,7 @@ npx @kontourai/flow-agents flow-kit status my-kit --dest /path/to/workspace
 To replace an existing install after you update the kit source:
 
 ```bash
-npx @kontourai/flow-agents flow-kit install-local path/to/my-kit --dest /path/to/workspace --update
+npx @kontourai/flow-agents kit install path/to/my-kit --dest /path/to/workspace --update
 ```
 
 ## Activate
@@ -137,10 +137,27 @@ npx @kontourai/flow-agents flow-kit install-local path/to/my-kit --dest /path/to
 After installing, run activate to write runtime-local files into the workspace:
 
 ```bash
-npx @kontourai/flow-agents flow-kit activate --dest /path/to/workspace --format json
+npx @kontourai/flow-agents 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:
 
@@ -177,7 +194,7 @@ The **container contract** is owned by [Kontour Flow](https://kontourai.github.i
 - Path rules: all declared paths must be relative, must not contain `..`, and must resolve inside the kit directory.
 - The **extension model**: unknown top-level fields are consumer extensions; core validation ignores-but-permits them.
 
-Container validation is surfaced in Flow's CLI as `flow validate-kit <kit-dir>`. Flow Agents delegates container validation to Flow when `FLOW_CLI_ROOT` is configured; without it, Flow Agents applies the same rules internally.
+Container validation is surfaced in Flow's CLI as `flow kit validate <kit-dir>`. Flow Agents delegates core container validation to `@kontourai/flow`'s `validateKitContainer` library function; the contract lives once, in Flow.
 
 For the authoritative container spec and JSON Schema, see [kontourai/flow#67](https://github.com/kontourai/flow/pull/67) (the spec PR) and the published `schemas/flow-kit-container.schema.json` in the `@kontourai/flow` package.
 
@@ -267,7 +284,7 @@ Layering summary:
 Use the `inspect` subcommand to derive a kit's conformance level and consumer targets:
 
 ```bash
-npm run flow-kit -- inspect path/to/my-kit
+npm run kit -- inspect path/to/my-kit
 ```
 
 Output is stable JSON:
@@ -293,3 +310,22 @@ The `inspect` command is read-only and safe to run before install.
 ## Direction
 
 Flow Kits are designed to be shareable workflow units — authored once, carried across teams and workspaces. The intended growth path is distribution from git remotes and a curated Kontour kit catalog of Kontour-authored kits covering work modes beyond software delivery. Today install is local-path only; remote fetch is explicitly a non-goal in this version.
+
+## Migration: flow-kit → flow-agents kit
+
+The standalone `flow-kit` binary was removed in this release. The `flow-agents kit` subcommand is the replacement.
+
+| Old command | New command |
+|---|---|
+| `flow-kit install-local <path>` | `flow-agents kit install <path>` |
+| `flow-kit install-git <url>` | `flow-agents kit install <url>` |
+| `flow-kit activate` | `flow-agents kit activate` |
+| `flow-kit inspect <dir>` | `flow-agents kit inspect <dir>` |
+| `flow-kit list` | `flow-agents kit list` |
+| `flow-kit status <id>` | `flow-agents kit status <id>` |
+| `npx @kontourai/flow-agents flow-kit ...` | `npx @kontourai/flow-agents kit ...` |
+| `npm run flow-kit -- ...` | `npm run kit -- ...` |
+
+`install-local` and `install-git` are unified into a single `install` command. The source argument auto-detects whether it is a local path or a git URL (http://, https://, git+, ssh://, file://).
+
+Running the old `flow-kit` command will produce a "command not found" error from your shell — there is no alias or shim. Update any scripts or CI configurations that call `flow-kit` to use `flow-agents kit`.

package/docs/knowledge-kit.md

@@ -4,7 +4,7 @@ title: Knowledge Kit
 
 # Knowledge Kit
 
-The Knowledge Kit is a Flow Kit for durable, gated knowledge storage. It packages a store contract, five pipeline flows, pluggable store adapters, and a parameterized contract test suite — all validated and installed through the standard `flow-kit` path.
+The Knowledge Kit is a Flow Kit for durable, gated knowledge storage. It packages a store contract, five pipeline flows, pluggable store adapters, and a parameterized contract test suite — all validated and installed through the `flow-agents kit` path.
 
 ## What it ships
 
@@ -44,7 +44,7 @@ The vector detector is fail-closed: infrastructure failures throw `EMBED_FAILURE
 
 ```bash
 # Install the kit into a workspace
-npx @kontourai/flow-agents flow-kit install-local kits/knowledge --dest /path/to/workspace
+npx @kontourai/flow-agents kit install kits/knowledge --dest /path/to/workspace
 
 # Run the contract suite against the default adapter
 node --test kits/knowledge/evals/contract-suite/suite.test.js

package/docs/spec/runtime-hook-surface.md

@@ -490,7 +490,7 @@ Kit flow activation for Strands workspaces is implemented as a new runtime adapt
 The CLI command is:
 
 ```bash
-flow-kit activate --adapter strands-local [--dest DIR] [--source-root DIR]
+flow-agents kit activate --adapter strands-local [--dest DIR] [--source-root DIR]
 ```
 
 This writes activated flow files to `.flow-agents/runtime/strands/flows/<kit-id>/<asset-id>.flow.json` and produces a parity-diagnostic `activation.json` (same schema as codex-local: `schema_version`, `adapter`, `supported_asset_classes`, `generated_runtime_files`, `skipped_assets`, `warnings`, `errors`).

package/docs/vision.md

@@ -20,7 +20,7 @@ One official framework adapter spike exists: `integrations/strands/` is a Python
 
 ### What ships today
 
-Kit authoring is shipped. The `kit.json` contract at schema version 1.0 is validated by the `flow-kit` CLI before any install. The [Kit Authoring Guide](kit-authoring-guide.html) walks from an empty directory to a validated, locally installed kit. Two reference kits ship in `kits/`:
+Kit authoring is shipped. The `kit.json` contract at schema version 1.0 is validated by the `flow-agents kit` CLI before any install. The [Kit Authoring Guide](kit-authoring-guide.html) walks from an empty directory to a validated, locally installed kit. Two reference kits ship in `kits/`:
 
 **Builder Kit** packages the full `idea → backlog → plan → build → review → verify → evidence → release → learning` pipeline as two flows (`builder.shape`, `builder.build`). It installs automatically.
 

package/docs/workflow-usage-guide.md

@@ -43,7 +43,7 @@ Separate these into distinct ideas, use Probe/alignment questions if the outcome
 
 Expected behavior:
 
-- delegate shaping to `skills/idea-to-backlog/SKILL.md`
+- delegate shaping to `kits/builder/skills/idea-to-backlog/SKILL.md`
 - link the artifact to the Builder Kit Flow Definition at `kits/builder/flows/shape.flow.json`
 - inventory each distinct idea separately
 - classify each idea

package/evals/ci/run-baseline.sh

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

package/evals/fixtures/builder-kit-workflow-state/happy-path.json

@@ -49,8 +49,8 @@
     "planning_readiness": "ready",
     "expected_modified_files": [
       "context/contracts/builder-kit-workflow-state-contract.md",
-      "skills/design-probe/SKILL.md",
-      "skills/pickup-probe/SKILL.md"
+      "kits/builder/skills/design-probe/SKILL.md",
+      "kits/builder/skills/pickup-probe/SKILL.md"
     ],
     "conflict_risks": [
       "workflow guidance shared with downstream Builder Kit automation"

package/evals/fixtures/builder-kit-workflow-state/mid-work-resume.json

@@ -54,8 +54,8 @@
     "planning_readiness": "completed",
     "expected_modified_files": [
       "context/contracts/builder-kit-workflow-state-contract.md",
-      "skills/design-probe/SKILL.md",
-      "skills/pickup-probe/SKILL.md",
+      "kits/builder/skills/design-probe/SKILL.md",
+      "kits/builder/skills/pickup-probe/SKILL.md",
       "evals/fixtures/builder-kit-workflow-state/happy-path.json",
       "evals/fixtures/builder-kit-workflow-state/mid-work-resume.json"
     ],

package/evals/fixtures/console-learning-projection/artifacts/console-learning-correction/learning.json

@@ -28,7 +28,7 @@
           "target": "skill",
           "action": "Update workflow learning guidance after release.",
           "status": "deferred",
-          "ref": "skills/learning-review/SKILL.md"
+          "ref": "kits/builder/skills/learning-review/SKILL.md"
         }
       ],
       "correction": {

package/evals/fixtures/pull-work-provider/github-issues.json

@@ -73,7 +73,7 @@
     "number": 97,
     "title": "Emit source revision metadata and structured blockers",
     "state": "OPEN",
-    "body": "## Problem\nDownstream pickup needs durable source revision and blocker metadata.\n\n## Scope\n- Emit provider-neutral work-item metadata.\n- Preserve human-readable blocker prose.\n\n## Acceptance criteria\n- Source revision fields normalize.\n- Structured blockers preserve provider refs and text blockers.\n\n## Dependencies / Blockers\nRequires kontourai/flow#2.\nBlocked by product decision on rollout scope.\n\n## Source artifact\n`.flow-agents/idea-to-backlog-source-revision-structured-blockers/idea-to-backlog-source-revision-structured-blockers--plan.md`\n\n<!-- flow-agents:work-item-metadata\n{\n  \"schema_version\": \"1.0\",\n  \"source_revisions\": [\n    {\n      \"repo\": \"kontourai/flow-agents\",\n      \"planned_base_ref\": \"main\",\n      \"planned_base_sha\": \"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n      \"planned_at\": \"2026-06-03T03:23:14Z\",\n      \"planning_artifact_ref\": \".flow-agents/idea-to-backlog-source-revision-structured-blockers/idea-to-backlog-source-revision-structured-blockers--plan.md\",\n      \"planning_scope_refs\": [\n        \"skills/idea-to-backlog/SKILL.md\",\n        \"context/contracts/work-item-contract.md\"\n      ]\n    },\n    {\n      \"repo\": \"kontourai/flow\",\n      \"planned_base_ref\": \"main\",\n      \"planned_base_sha\": \"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb\",\n      \"planned_at\": \"2026-06-03T03:23:14Z\",\n      \"planning_artifact_ref\": \".flow-agents/idea-to-backlog-source-revision-structured-blockers/idea-to-backlog-source-revision-structured-blockers--plan.md\",\n      \"planning_scope_refs\": [\"context/contracts/work-item-contract.md\"]\n    }\n  ],\n  \"blockers\": [\n    {\n      \"type\": \"work_item\",\n      \"ref\": \"kontourai/flow#2\",\n      \"status\": \"blocked\",\n      \"summary\": \"Requires Flow contract issue first.\"\n    },\n    {\n      \"type\": \"text\",\n      \"status\": \"blocked\",\n      \"summary\": \"Product decision on rollout scope.\"\n    }\n  ]\n}\n-->",
+    "body": "## Problem\nDownstream pickup needs durable source revision and blocker metadata.\n\n## Scope\n- Emit provider-neutral work-item metadata.\n- Preserve human-readable blocker prose.\n\n## Acceptance criteria\n- Source revision fields normalize.\n- Structured blockers preserve provider refs and text blockers.\n\n## Dependencies / Blockers\nRequires kontourai/flow#2.\nBlocked by product decision on rollout scope.\n\n## Source artifact\n`.flow-agents/idea-to-backlog-source-revision-structured-blockers/idea-to-backlog-source-revision-structured-blockers--plan.md`\n\n<!-- flow-agents:work-item-metadata\n{\n  \"schema_version\": \"1.0\",\n  \"source_revisions\": [\n    {\n      \"repo\": \"kontourai/flow-agents\",\n      \"planned_base_ref\": \"main\",\n      \"planned_base_sha\": \"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n      \"planned_at\": \"2026-06-03T03:23:14Z\",\n      \"planning_artifact_ref\": \".flow-agents/idea-to-backlog-source-revision-structured-blockers/idea-to-backlog-source-revision-structured-blockers--plan.md\",\n      \"planning_scope_refs\": [\n        \"kits/builder/skills/idea-to-backlog/SKILL.md\",\n        \"context/contracts/work-item-contract.md\"\n      ]\n    },\n    {\n      \"repo\": \"kontourai/flow\",\n      \"planned_base_ref\": \"main\",\n      \"planned_base_sha\": \"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb\",\n      \"planned_at\": \"2026-06-03T03:23:14Z\",\n      \"planning_artifact_ref\": \".flow-agents/idea-to-backlog-source-revision-structured-blockers/idea-to-backlog-source-revision-structured-blockers--plan.md\",\n      \"planning_scope_refs\": [\"context/contracts/work-item-contract.md\"]\n    }\n  ],\n  \"blockers\": [\n    {\n      \"type\": \"work_item\",\n      \"ref\": \"kontourai/flow#2\",\n      \"status\": \"blocked\",\n      \"summary\": \"Requires Flow contract issue first.\"\n    },\n    {\n      \"type\": \"text\",\n      \"status\": \"blocked\",\n      \"summary\": \"Product decision on rollout scope.\"\n    }\n  ]\n}\n-->",
     "labels": [],
     "assignees": [],
     "milestone": null,
@@ -101,7 +101,7 @@
     "number": 110,
     "title": "Fresh planned item",
     "state": "OPEN",
-    "body": "## Scope\nUse fresh source revision metadata.\n\n## Acceptance criteria\nFreshness is verified.\n\n<!-- flow-agents:work-item-metadata\n{\n  \"schema_version\": \"1.0\",\n  \"planned_base_ref\": \"main\",\n  \"planned_base_sha\": \"cccccccccccccccccccccccccccccccccccccccc\",\n  \"planned_at\": \"2026-06-02T00:00:00Z\",\n  \"planning_artifact_ref\": \".flow-agents/fresh/fresh--plan.md\",\n  \"planning_scope_refs\": [\"skills/pull-work/SKILL.md\"]\n}\n-->",
+    "body": "## Scope\nUse fresh source revision metadata.\n\n## Acceptance criteria\nFreshness is verified.\n\n<!-- flow-agents:work-item-metadata\n{\n  \"schema_version\": \"1.0\",\n  \"planned_base_ref\": \"main\",\n  \"planned_base_sha\": \"cccccccccccccccccccccccccccccccccccccccc\",\n  \"planned_at\": \"2026-06-02T00:00:00Z\",\n  \"planning_artifact_ref\": \".flow-agents/fresh/fresh--plan.md\",\n  \"planning_scope_refs\": [\"kits/builder/skills/pull-work/SKILL.md\"]\n}\n-->",
     "labels": [],
     "assignees": [],
     "milestone": null,
@@ -115,7 +115,7 @@
     "number": 111,
     "title": "Drifted planned item",
     "state": "OPEN",
-    "body": "## Scope\nUse drifted source revision metadata.\n\n## Acceptance criteria\nFreshness reports benign drift.\n\n<!-- flow-agents:work-item-metadata\n{\n  \"schema_version\": \"1.0\",\n  \"planned_base_ref\": \"main\",\n  \"planned_base_sha\": \"dddddddddddddddddddddddddddddddddddddddd\",\n  \"planned_at\": \"2026-06-01T00:00:00Z\",\n  \"planning_artifact_ref\": \".flow-agents/drifted/drifted--plan.md\",\n  \"planning_scope_refs\": [\"skills/pickup-probe/SKILL.md\"]\n}\n-->",
+    "body": "## Scope\nUse drifted source revision metadata.\n\n## Acceptance criteria\nFreshness reports benign drift.\n\n<!-- flow-agents:work-item-metadata\n{\n  \"schema_version\": \"1.0\",\n  \"planned_base_ref\": \"main\",\n  \"planned_base_sha\": \"dddddddddddddddddddddddddddddddddddddddd\",\n  \"planned_at\": \"2026-06-01T00:00:00Z\",\n  \"planning_artifact_ref\": \".flow-agents/drifted/drifted--plan.md\",\n  \"planning_scope_refs\": [\"kits/builder/skills/pickup-probe/SKILL.md\"]\n}\n-->",
     "labels": [],
     "assignees": [],
     "milestone": null,
@@ -129,7 +129,7 @@
     "number": 112,
     "title": "Stale planned item",
     "state": "OPEN",
-    "body": "## Scope\nUse stale source revision metadata.\n\n## Acceptance criteria\nFreshness routes stale work.\n\n<!-- flow-agents:work-item-metadata\n{\n  \"schema_version\": \"1.0\",\n  \"planned_base_ref\": \"main\",\n  \"planned_base_sha\": \"eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\",\n  \"planned_at\": \"2026-04-01T00:00:00Z\",\n  \"planning_artifact_ref\": \".flow-agents/stale/stale--plan.md\",\n  \"planning_scope_refs\": [\"context/contracts/work-item-contract.md\", \"skills/pull-work/SKILL.md\"]\n}\n-->",
+    "body": "## Scope\nUse stale source revision metadata.\n\n## Acceptance criteria\nFreshness routes stale work.\n\n<!-- flow-agents:work-item-metadata\n{\n  \"schema_version\": \"1.0\",\n  \"planned_base_ref\": \"main\",\n  \"planned_base_sha\": \"eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\",\n  \"planned_at\": \"2026-04-01T00:00:00Z\",\n  \"planning_artifact_ref\": \".flow-agents/stale/stale--plan.md\",\n  \"planning_scope_refs\": [\"context/contracts/work-item-contract.md\", \"kits/builder/skills/pull-work/SKILL.md\"]\n}\n-->",
     "labels": [],
     "assignees": [],
     "milestone": null,
@@ -143,7 +143,7 @@
     "number": 113,
     "title": "Legacy item missing planned base",
     "state": "OPEN",
-    "body": "## Scope\nPreserve legacy gap for missing planned_base_sha.\n\n## Acceptance criteria\nFreshness is not verified.\n\n<!-- flow-agents:work-item-metadata\n{\n  \"schema_version\": \"1.0\",\n  \"planned_base_ref\": \"main\",\n  \"planned_at\": \"2026-06-01T00:00:00Z\",\n  \"planning_artifact_ref\": \".flow-agents/legacy/legacy--plan.md\",\n  \"planning_scope_refs\": [\"skills/pull-work/SKILL.md\"]\n}\n-->",
+    "body": "## Scope\nPreserve legacy gap for missing planned_base_sha.\n\n## Acceptance criteria\nFreshness is not verified.\n\n<!-- flow-agents:work-item-metadata\n{\n  \"schema_version\": \"1.0\",\n  \"planned_base_ref\": \"main\",\n  \"planned_at\": \"2026-06-01T00:00:00Z\",\n  \"planning_artifact_ref\": \".flow-agents/legacy/legacy--plan.md\",\n  \"planning_scope_refs\": [\"kits/builder/skills/pull-work/SKILL.md\"]\n}\n-->",
     "labels": [],
     "assignees": [],
     "milestone": null,

package/evals/integration/test_activate_npx_context.sh

@@ -14,7 +14,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"
 MIXED_SRC="$ROOT/evals/fixtures/flow-kit-repository/mixed-runtime-kit"
 
 echo "=== activate npx-context Checks (Issue #57) ==="
@@ -27,7 +27,7 @@ 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
+if flow_agents_node "$CLI" install "$MIXED_SRC" --dest "$DEST" >"$install_out" 2>&1; then
   pass "mixed-runtime-kit installs into workspace"
 else
   fail "install failed (prerequisite step)"

package/evals/integration/test_bundle_install.sh

@@ -310,20 +310,20 @@ NODE
 done
 
 for dir in "$KIRO_DEST" "$BASE_DEST" "$CLAUDE_DEST" "$CODEX_DEST"; do
-  if [[ -f "$dir/scripts/flow-kit.js" ]] \
-    && node "$dir/scripts/flow-kit.js" list --dest "$dir" >/tmp/flow-kit-list.out 2>&1 \
-    && node "$dir/scripts/flow-kit.js" status --dest "$dir" >/tmp/flow-kit-status.out 2>&1 \
-    && rg -q 'No local Flow Kits installed' /tmp/flow-kit-list.out \
-    && rg -q 'No local Flow Kits installed' /tmp/flow-kit-status.out; then
+  if [[ -f "$dir/scripts/kit.js" ]] \
+    && node "$dir/scripts/kit.js" list --dest "$dir" >/tmp/kit-list.out 2>&1 \
+    && node "$dir/scripts/kit.js" status --dest "$dir" >/tmp/kit-status.out 2>&1 \
+    && rg -q 'No local Flow Kits installed' /tmp/kit-list.out \
+    && rg -q 'No local Flow Kits installed' /tmp/kit-status.out; then
     _pass "$dir includes local Flow Kit CLI and empty list/status works"
   else
     _fail "$dir local Flow Kit CLI list/status smoke failed"
   fi
 done
 
-if [[ -f "$CODEX_DEST/scripts/flow-kit.js" ]] \
+if [[ -f "$CODEX_DEST/scripts/kit.js" ]] \
   && [[ -f "$CODEX_DEST/build/src/runtime-adapters.js" ]] \
-  && node "$CODEX_DEST/scripts/flow-kit.js" activate --dest "$CODEX_DEST" --format json >/tmp/codex-runtime-activation.json 2>&1 \
+  && node "$CODEX_DEST/scripts/kit.js" activate --dest "$CODEX_DEST" --format json >/tmp/codex-runtime-activation.json 2>&1 \
   && node - "$CODEX_DEST" /tmp/codex-runtime-activation.json <<'NODE'
 const fs = require("node:fs");
 const path = require("node:path");
@@ -344,7 +344,6 @@ then
   _pass "Codex installed bundle activates Builder Kit through codex-local"
 else
   _fail "Codex installed bundle runtime activation failed"
-  sed -n '1,180p' /tmp/codex-runtime-activation.json 2>/dev/null || true
 fi
 
 if node - "$KIRO_DEST" "$BASE_DEST" "$CLAUDE_DEST" "$CODEX_DEST" <<'NODE'
@@ -714,8 +713,11 @@ else
   _fail "Codex core-pack agent filtering failed"
 fi
 
-if [[ -d "$CODEX_CORE_DEST/.codex/skills/plan-work" && ! -d "$CODEX_CORE_DEST/.codex/skills/deliver" ]]; then
-  _pass "Codex core-pack install keeps core skills and prunes optional skills"
+# Kit-owned skills (plan-work, deliver) are always present regardless of pack filter.
+# Pack filtering only prunes skills declared in packs.json (the tool-skills).
+# The development-pack tool-skill agentic-engineering should be pruned in a core-only install.
+if [[ -d "$CODEX_CORE_DEST/.codex/skills/plan-work" && -d "$CODEX_CORE_DEST/.codex/skills/deliver" && ! -d "$CODEX_CORE_DEST/.codex/skills/agentic-engineering" ]]; then
+  _pass "Codex core-pack install: kit-skills present, dev-only tool-skill pruned"
 else
   _fail "Codex core-pack skill filtering failed"
 fi
@@ -746,8 +748,11 @@ else
   _fail "opencode core-pack agent filtering failed (tool-planner.md missing)"
 fi
 
-if [[ -d "$OPENCODE_CORE_DEST/.opencode/skills/plan-work" && ! -d "$OPENCODE_CORE_DEST/.opencode/skills/deliver" ]]; then
-  _pass "opencode core-pack install keeps core skills and prunes optional skills"
+# Kit-owned skills (plan-work, deliver) are always present regardless of pack filter.
+# Pack filtering only prunes skills declared in packs.json (the tool-skills).
+# The development-pack tool-skill agentic-engineering should be pruned in a core-only install.
+if [[ -d "$OPENCODE_CORE_DEST/.opencode/skills/plan-work" && -d "$OPENCODE_CORE_DEST/.opencode/skills/deliver" && ! -d "$OPENCODE_CORE_DEST/.opencode/skills/agentic-engineering" ]]; then
+  _pass "opencode core-pack install: kit-skills present, dev-only tool-skill pruned"
 else
   _fail "opencode core-pack skill filtering failed"
 fi

package/evals/integration/test_console_learning_projection.sh

@@ -146,7 +146,7 @@ if jq -e '
   $ext.routing.deferred == 1 and
   ($ext.routing.targets | sort) == ["eval", "skill"] and
   ($ext.routing.statuses | sort) == ["deferred", "open"] and
-  ($ext.routing.refs | sort) == ["github:kontourai/flow-agents#96", "skills/learning-review/SKILL.md"] and
+  ($ext.routing.refs | sort) == ["github:kontourai/flow-agents#96", "kits/builder/skills/learning-review/SKILL.md"] and
   $ext.correction.needed == true and
   $ext.correction.type == "workflow" and
   $ext.correction.recurrence_key == "console-learning-projection.recurrence-metadata" and

package/evals/integration/test_flow_kit_install_git.sh

@@ -14,7 +14,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"
 VALID_SRC="$ROOT/evals/fixtures/flow-kit-repository/valid-local-kit"
 DEST="$TMP_DIR/install-dest"
 mkdir -p "$DEST"
@@ -33,7 +33,7 @@ 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
+if flow_agents_node "$CLI" install "$FILE_URL" --dest "$DEST" >"$install_out" 2>&1; then
   pass "install-git from file:// URL succeeds"
 else
   fail "install-git from file:// URL failed"
@@ -72,7 +72,7 @@ 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 \
+if flow_agents_node "$CLI" install "$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"
@@ -93,7 +93,7 @@ cp -R "$VALID_SRC" "$FIXTURE_WORKING2"
 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
+if flow_agents_node "$CLI" install "${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"
@@ -119,7 +119,7 @@ fi
 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
+if flow_agents_node "$CLI" install "$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"
@@ -128,7 +128,7 @@ 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
+if flow_agents_node "$CLI" install --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
@@ -137,7 +137,7 @@ 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
+if flow_agents_node "$CLI" install "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

package/evals/integration/test_flow_kit_repository.sh

@@ -55,15 +55,15 @@ echo "=== Flow Kit Repository Fixture Checks ==="
 expect_pass "valid-local-kit"
 expect_fail "invalid-schema-version" '\.schema_version must be "1\.0"'
 expect_fail "invalid-missing-schema-version" '\.schema_version must be "1\.0"'
-expect_fail "invalid-id" '\.id must be a stable kebab-case string'
-expect_fail "invalid-missing-id" '\.id must be a stable kebab-case string'
+expect_fail "invalid-id" '\.id must be a kebab-case string'
+expect_fail "invalid-missing-id" '\.id must be a kebab-case string'
 expect_fail "invalid-name" '\.name must be a non-empty string'
 expect_fail "invalid-missing-flow" 'flows\[0\]\.path points at missing Flow Definition'
 expect_fail "invalid-absolute-path" 'flows\[0\]\.path must be relative'
-expect_fail "invalid-traversal" "flows\\[0\\]\\.path must stay inside the kit directory"
+expect_fail "invalid-traversal" "flows\\[0\\]\\.path must not contain"
 expect_fail "invalid-malformed-json" 'invalid JSON'
 expect_fail "invalid-asset-section" '\.docs must be a list'
-expect_fail "invalid-duplicate-flow" "flows\\[1\\]\\.id duplicates"
+expect_fail "invalid-duplicate-flow" "flows\\[1\\]\\.path duplicates"
 
 echo ""
 echo "=== Builder Kit Shared Validation Check ==="

package/evals/integration/test_kit_conformance_levels.sh

@@ -23,7 +23,7 @@ run_inspect() {
   local output="$2"
   # Route through the main CLI to avoid import.meta.url path-resolution issues.
   flow_agents_build_ts 2>/dev/null
-  node "$FLOW_AGENTS_EVAL_ROOT/build/src/cli.js" flow-kit inspect "$kit_dir" >"$output" 2>&1
+  node "$FLOW_AGENTS_EVAL_ROOT/build/src/cli.js" kit inspect "$kit_dir" >"$output" 2>&1
 }
 
 # ===================================================================

package/evals/integration/test_local_flow_kit_install.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"
 VALID_SRC="$ROOT/evals/fixtures/flow-kit-repository/valid-local-kit"
 INVALID_SRC="$ROOT/evals/fixtures/flow-kit-repository/invalid-missing-flow"
 DEST="$TMP_DIR/install-dest"
@@ -23,7 +23,7 @@ mkdir -p "$DEST"
 echo "=== Local Flow Kit Install Checks ==="
 
 install_output="$TMP_DIR/install.out"
-if flow_agents_node "$CLI" install-local "$VALID_SRC" --dest "$DEST" >"$install_output" 2>&1; then
+if flow_agents_node "$CLI" install "$VALID_SRC" --dest "$DEST" >"$install_output" 2>&1; then
   pass "valid local kit installs into temp destination"
 else
   fail "valid local kit install failed"
@@ -52,7 +52,7 @@ fi
 
 registry_hash_before_invalid="$(shasum -a 256 "$REGISTRY" | awk '{print $1}')"
 invalid_output="$TMP_DIR/invalid.out"
-if flow_agents_node "$CLI" install-local "$INVALID_SRC" --dest "$DEST" >"$invalid_output" 2>&1; then
+if flow_agents_node "$CLI" install "$INVALID_SRC" --dest "$DEST" >"$invalid_output" 2>&1; then
   fail "invalid local kit install should fail"
   sed -n '1,160p' "$invalid_output"
 elif rg -q 'Flow Kit repository validation failed' "$invalid_output" \
@@ -65,7 +65,7 @@ fi
 
 registry_hash_before_idempotent="$(shasum -a 256 "$REGISTRY" | awk '{print $1}')"
 idempotent_output="$TMP_DIR/idempotent.out"
-if flow_agents_node "$CLI" install-local "$VALID_SRC" --dest "$DEST" >"$idempotent_output" 2>&1 \
+if flow_agents_node "$CLI" install "$VALID_SRC" --dest "$DEST" >"$idempotent_output" 2>&1 \
   && rg -q "already installed" "$idempotent_output" \
   && [[ "$registry_hash_before_idempotent" == "$(shasum -a 256 "$REGISTRY" | awk '{print $1}')" ]]; then
   pass "same-source reinstall is idempotent"
@@ -79,7 +79,7 @@ cp -R "$VALID_SRC" "$CONFLICT_SRC"
 printf '\nconflict copy\n' >> "$CONFLICT_SRC/docs/README.md"
 conflict_output="$TMP_DIR/conflict.out"
 registry_hash_before_conflict="$(shasum -a 256 "$REGISTRY" | awk '{print $1}')"
-if flow_agents_node "$CLI" install-local "$CONFLICT_SRC" --dest "$DEST" >"$conflict_output" 2>&1; then
+if flow_agents_node "$CLI" install "$CONFLICT_SRC" --dest "$DEST" >"$conflict_output" 2>&1; then
   fail "different source with existing kit id should conflict"
   sed -n '1,160p' "$conflict_output"
 elif rg -q 'conflict: kit' "$conflict_output" \
@@ -91,7 +91,7 @@ else
 fi
 
 force_conflict_output="$TMP_DIR/force-conflict.out"
-if flow_agents_node "$CLI" install-local "$CONFLICT_SRC" --dest "$DEST" --force >"$force_conflict_output" 2>&1; then
+if flow_agents_node "$CLI" install "$CONFLICT_SRC" --dest "$DEST" --force >"$force_conflict_output" 2>&1; then
   fail "--force should not replace a different-source duplicate id"
   sed -n '1,160p' "$force_conflict_output"
 elif rg -q 'conflict: kit' "$force_conflict_output" \
@@ -103,7 +103,7 @@ else
 fi
 
 update_output="$TMP_DIR/update.out"
-if flow_agents_node "$CLI" install-local "$CONFLICT_SRC" --dest "$DEST" --update >"$update_output" 2>&1 \
+if flow_agents_node "$CLI" install "$CONFLICT_SRC" --dest "$DEST" --update >"$update_output" 2>&1 \
   && rg -q "updated local kit" "$update_output" \
   && rg -q "$CONFLICT_SRC" "$REGISTRY"; then
   pass "explicit update replaces duplicate id source"

package/evals/integration/test_publish_change_helper.sh

@@ -112,7 +112,7 @@ status=$?
 
 for risk in runtime schema package hook security; do
   case "$risk" in
-    runtime) path="scripts/flow-kit.js" ;;
+    runtime) path="scripts/kit.js" ;;
     schema) path="schemas/workflow-evidence.schema.json" ;;
     package) path="package.json" ;;
     hook) path="scripts/hooks/quality-gate.js" ;;