@kontourai/flow-agents 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.githooks/pre-push +11 -0
- package/.github/workflows/ci.yml +210 -0
- package/.github/workflows/docs-pages.yml +52 -0
- package/.github/workflows/publish-npm.yml +104 -0
- package/AGENTS.md +26 -0
- package/CHANGELOG.md +66 -0
- package/CODE_OF_CONDUCT.md +25 -0
- package/CONTEXT.md +300 -0
- package/CONTRIBUTING.md +44 -0
- package/LICENSE +201 -0
- package/README.md +129 -0
- package/SECURITY.md +33 -0
- package/agent-cards/dev.json +19 -0
- package/agents/dev.json +127 -0
- package/agents/tool-code-reviewer.json +61 -0
- package/agents/tool-dependencies-updater.json +118 -0
- package/agents/tool-explore-config.json +92 -0
- package/agents/tool-explore-deps.json +92 -0
- package/agents/tool-explore-entry.json +92 -0
- package/agents/tool-explore-patterns.json +92 -0
- package/agents/tool-explore-structure.json +92 -0
- package/agents/tool-explore-tests.json +92 -0
- package/agents/tool-planner.json +57 -0
- package/agents/tool-playwright.json +145 -0
- package/agents/tool-security-reviewer.json +56 -0
- package/agents/tool-verifier.json +61 -0
- package/agents/tool-worker.json +58 -0
- package/build/src/cli/console-learning-projection.js +123 -0
- package/build/src/cli/docs-preview.js +39 -0
- package/build/src/cli/effective-backlog-settings.js +102 -0
- package/build/src/cli/export-bookmarks.js +38 -0
- package/build/src/cli/fixture-retirement-audit.js +140 -0
- package/build/src/cli/flow-kit.js +138 -0
- package/build/src/cli/import-bookmarks.js +50 -0
- package/build/src/cli/init.js +239 -0
- package/build/src/cli/instinct-cli.js +93 -0
- package/build/src/cli/promote-workflow-artifact.js +63 -0
- package/build/src/cli/publish-change-helper.js +154 -0
- package/build/src/cli/pull-work-provider.js +469 -0
- package/build/src/cli/runtime-adapter.js +23 -0
- package/build/src/cli/telemetry-doctor.js +221 -0
- package/build/src/cli/usage-feedback.js +443 -0
- package/build/src/cli/validate-hook-influence.js +152 -0
- package/build/src/cli/validate-source-tree.js +31 -0
- package/build/src/cli/validate-workflow-artifacts.js +486 -0
- package/build/src/cli/veritas-governance.js +262 -0
- package/build/src/cli/workflow-artifact-cleanup-audit.js +272 -0
- package/build/src/cli/workflow-sidecar.js +816 -0
- package/build/src/cli.js +89 -0
- package/build/src/flow-kit/validate.js +75 -0
- package/build/src/lib/args.js +45 -0
- package/build/src/lib/fs.js +62 -0
- package/build/src/lib/workflow-learning-projection.js +334 -0
- package/build/src/runtime-adapters.js +146 -0
- package/build/src/tools/build-universal-bundles.js +397 -0
- package/build/src/tools/common.js +56 -0
- package/build/src/tools/filter-installed-packs.js +132 -0
- package/build/src/tools/generate-context-map.js +198 -0
- package/build/src/tools/validate-package.js +64 -0
- package/build/src/tools/validate-source-tree.js +622 -0
- package/console.telemetry.json +176 -0
- package/context/base-rules.md +17 -0
- package/context/code-review-standards.md +62 -0
- package/context/coding-standards.md +42 -0
- package/context/common/orchestrators.md +12 -0
- package/context/common/subagents.md +28 -0
- package/context/contracts/artifact-contract.md +182 -0
- package/context/contracts/builder-kit-workflow-state-contract.md +319 -0
- package/context/contracts/delivery-contract.md +69 -0
- package/context/contracts/execution-contract.md +53 -0
- package/context/contracts/governance-adapter-contract.md +67 -0
- package/context/contracts/planning-contract.md +85 -0
- package/context/contracts/review-contract.md +104 -0
- package/context/contracts/sandbox-policy.md +52 -0
- package/context/contracts/verification-contract.md +134 -0
- package/context/contracts/work-item-contract.md +215 -0
- package/context/deferred/demo-mode.md +33 -0
- package/context/deferred/languages/go.md +31 -0
- package/context/deferred/languages/python.md +31 -0
- package/context/deferred/languages/typescript.md +34 -0
- package/context/deferred/parallelization.md +35 -0
- package/context/deferred/worktree-isolation.md +24 -0
- package/context/development-workflow.md +50 -0
- package/context/scripts/context-budget/budget-scan.sh +166 -0
- package/context/scripts/detect-tools.sh +3 -0
- package/context/scripts/discover-agents.sh +28 -0
- package/context/scripts/git-status.sh +49 -0
- package/context/scripts/hooks/config-protection.js +79 -0
- package/context/scripts/hooks/desktop-notify.sh +39 -0
- package/context/scripts/hooks/governance-audit.sh +135 -0
- package/context/scripts/hooks/lib/audit-transport.sh +40 -0
- package/context/scripts/hooks/lib/hook-flags.js +49 -0
- package/context/scripts/hooks/lib/patterns.sh +57 -0
- package/context/scripts/hooks/lib/resolve-formatter.js +80 -0
- package/context/scripts/hooks/post-edit-accumulator.js +66 -0
- package/context/scripts/hooks/pre-commit-quality.js +194 -0
- package/context/scripts/hooks/quality-gate.js +93 -0
- package/context/scripts/hooks/report-only-guard.js +21 -0
- package/context/scripts/hooks/run-hook.js +136 -0
- package/context/scripts/hooks/stop-format-typecheck.js +141 -0
- package/context/scripts/hooks/stop-goal-fit.js +337 -0
- package/context/scripts/hooks/workflow-steering.js +250 -0
- package/context/scripts/telemetry/console-presets.sh +14 -0
- package/context/scripts/telemetry/install-console-config.sh +214 -0
- package/context/scripts/telemetry/lib/config.sh +85 -0
- package/context/scripts/telemetry/lib/enrich.sh +115 -0
- package/context/scripts/telemetry/lib/redact.sh +22 -0
- package/context/scripts/telemetry/lib/session.sh +63 -0
- package/context/scripts/telemetry/lib/transport.sh +183 -0
- package/context/scripts/telemetry/lib/usage.sh +29 -0
- package/context/scripts/telemetry/sync-agents.sh +173 -0
- package/context/scripts/telemetry/telemetry.conf +23 -0
- package/context/scripts/telemetry/telemetry.sh +387 -0
- package/context/scripts/validate-package.sh +89 -0
- package/context/settings/backlog-provider-settings.json +54 -0
- package/context/templates/core/identity.md +26 -0
- package/context/templates/core/user.md +15 -0
- package/docs/_config.yml +15 -0
- package/docs/_layouts/default.html +87 -0
- package/docs/adr/0001-flow-agents-consumes-flow.md +77 -0
- package/docs/adr/0002-flow-kits-as-extension-unit.md +13 -0
- package/docs/adr/0003-flow-agents-coordinates-kits-and-adapters.md +13 -0
- package/docs/adr/0004-gates-expect-surface-claims.md +15 -0
- package/docs/adr/0005-kubernetes-inspired-resource-contracts.md +48 -0
- package/docs/adr/0006-typescript-first-source-policy.md +98 -0
- package/docs/agent-system-guidebook.md +391 -0
- package/docs/agent-usage-feedback-loop.md +351 -0
- package/docs/assets/favicon.svg +13 -0
- package/docs/assets/og-image.png +0 -0
- package/docs/assets/site.css +774 -0
- package/docs/assets/site.js +139 -0
- package/docs/configurable-workflow-routing.md +174 -0
- package/docs/context-map.md +145 -0
- package/docs/developer-architecture.md +145 -0
- package/docs/developer-hook-setup.md +61 -0
- package/docs/fixture-ownership.md +44 -0
- package/docs/flow-kit-repository-contract.md +180 -0
- package/docs/index.md +129 -0
- package/docs/kontour-resource-contract.md +358 -0
- package/docs/migrations.md +64 -0
- package/docs/north-star.md +322 -0
- package/docs/operating-layers.md +110 -0
- package/docs/repository-structure.md +132 -0
- package/docs/sandbox-policy.md +56 -0
- package/docs/skills-map.md +203 -0
- package/docs/standards-register.md +96 -0
- package/docs/veritas-integration.md +165 -0
- package/docs/work-item-adapters.md +72 -0
- package/docs/workflow-artifact-lifecycle.md +141 -0
- package/docs/workflow-eval-strategy.md +295 -0
- package/docs/workflow-shared-contracts.md +51 -0
- package/docs/workflow-usage-guide.md +443 -0
- package/evals/ARCHITECTURE.md +143 -0
- package/evals/CONVENTIONS.md +58 -0
- package/evals/README.md +128 -0
- package/evals/acceptance/run.sh +29 -0
- package/evals/acceptance/test_claude_harness.sh +242 -0
- package/evals/acceptance/test_codex_harness.sh +108 -0
- package/evals/acceptance/test_kiro_harness.sh +128 -0
- package/evals/cases/dev/404.html +97 -0
- package/evals/cases/dev/code-review.yaml +44 -0
- package/evals/cases/dev/dashboard.html +300 -0
- package/evals/cases/dev/deliver.yaml +66 -0
- package/evals/cases/dev/dependency-update.yaml +16 -0
- package/evals/cases/dev/explore.yaml +20 -0
- package/evals/cases/dev/index.html +370 -0
- package/evals/cases/dev/package-lock.json +28 -0
- package/evals/cases/dev/package.json +16 -0
- package/evals/cases/dev/plan-work.yaml +20 -0
- package/evals/cases/dev/promptfooconfig.yaml +666 -0
- package/evals/cases/dev/search-first.yaml +20 -0
- package/evals/cases/dev/tdd-workflow.yaml +48 -0
- package/evals/cases/dev/verify-work.yaml +44 -0
- package/evals/cases/dev/workflow.yaml +34 -0
- package/evals/ci/run-baseline.sh +283 -0
- package/evals/fixtures/backlog-provider-settings/global-default.json +44 -0
- package/evals/fixtures/backlog-provider-settings/project-override.json +53 -0
- package/evals/fixtures/builder-kit-workflow-state/baseline-freshness-resolution-hint.json +139 -0
- package/evals/fixtures/builder-kit-workflow-state/direct-primitive-stop.json +59 -0
- package/evals/fixtures/builder-kit-workflow-state/empty-board-route-shape.json +55 -0
- package/evals/fixtures/builder-kit-workflow-state/happy-path.json +71 -0
- package/evals/fixtures/builder-kit-workflow-state/mid-work-resume.json +80 -0
- package/evals/fixtures/builder-kit-workflow-state/missing-prestep-recovery.json +65 -0
- package/evals/fixtures/builder-kit-workflow-state/product-build-chaining.json +60 -0
- package/evals/fixtures/builder-kit-workflow-state/stale-continuation-requires-new-probe.json +57 -0
- package/evals/fixtures/console-learning-projection/artifacts/console-learning-correction/learning.json +50 -0
- package/evals/fixtures/console-learning-projection/artifacts/console-learning-open-route/learning.json +41 -0
- package/evals/fixtures/flow-kit-repository/invalid-absolute-path/kit.json +8 -0
- package/evals/fixtures/flow-kit-repository/invalid-asset-section/flows/review.flow.json +6 -0
- package/evals/fixtures/flow-kit-repository/invalid-asset-section/kit.json +11 -0
- package/evals/fixtures/flow-kit-repository/invalid-duplicate-flow/flows/review.flow.json +6 -0
- package/evals/fixtures/flow-kit-repository/invalid-duplicate-flow/kit.json +9 -0
- package/evals/fixtures/flow-kit-repository/invalid-id/flows/review.flow.json +6 -0
- package/evals/fixtures/flow-kit-repository/invalid-id/kit.json +8 -0
- package/evals/fixtures/flow-kit-repository/invalid-malformed-json/kit.json +8 -0
- package/evals/fixtures/flow-kit-repository/invalid-missing-flow/kit.json +8 -0
- package/evals/fixtures/flow-kit-repository/invalid-missing-id/flows/review.flow.json +6 -0
- package/evals/fixtures/flow-kit-repository/invalid-missing-id/kit.json +7 -0
- package/evals/fixtures/flow-kit-repository/invalid-missing-schema-version/flows/review.flow.json +6 -0
- package/evals/fixtures/flow-kit-repository/invalid-missing-schema-version/kit.json +7 -0
- package/evals/fixtures/flow-kit-repository/invalid-name/flows/review.flow.json +6 -0
- package/evals/fixtures/flow-kit-repository/invalid-name/kit.json +8 -0
- package/evals/fixtures/flow-kit-repository/invalid-schema-version/flows/review.flow.json +6 -0
- package/evals/fixtures/flow-kit-repository/invalid-schema-version/kit.json +8 -0
- package/evals/fixtures/flow-kit-repository/invalid-traversal/kit.json +8 -0
- package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/adapters/example.json +3 -0
- package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/assets/example.txt +1 -0
- package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/docs/README.md +3 -0
- package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/flows/runtime.flow.json +26 -0
- package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/kit-evals/example.json +3 -0
- package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/kit-skills/mixed/SKILL.md +3 -0
- package/evals/fixtures/flow-kit-repository/mixed-runtime-kit/kit.json +44 -0
- package/evals/fixtures/flow-kit-repository/valid-local-kit/docs/README.md +3 -0
- package/evals/fixtures/flow-kit-repository/valid-local-kit/flows/review.flow.json +26 -0
- package/evals/fixtures/flow-kit-repository/valid-local-kit/kit.json +20 -0
- package/evals/fixtures/hook-influence/cases.json +336 -0
- package/evals/fixtures/pull-work-provider/github-issues.json +170 -0
- package/evals/fixtures/pull-work-wip-shepherding/global-wip-informs.json +43 -0
- package/evals/fixtures/pull-work-wip-shepherding/personal-wip-blocks.json +42 -0
- package/evals/fixtures/surface-trust/accepted-claim-trust-report.json +31 -0
- package/evals/fixtures/surface-trust/artifact-absent.json +19 -0
- package/evals/fixtures/surface-trust/integrity-mismatch-trust-report.json +32 -0
- package/evals/fixtures/surface-trust/missing-authority-trust-report.json +27 -0
- package/evals/fixtures/surface-trust/provider-absent.json +19 -0
- package/evals/fixtures/surface-trust/rejected-claim-trust-report.json +30 -0
- package/evals/fixtures/surface-trust/stale-claim-trust-snapshot.json +31 -0
- package/evals/fixtures/usage-feedback/sample-full.jsonl +11 -0
- package/evals/fixtures/usage-feedback/sample-outcomes.jsonl +1 -0
- package/evals/fixtures/veritas-governance-adapter/fake-veritas-pass.sh +18 -0
- package/evals/fixtures/veritas-governance-adapter/fake-veritas-secret-fail.sh +10 -0
- package/evals/fixtures/veritas-governance-adapter/fake-veritas-unconfigured.sh +4 -0
- package/evals/integration/test_bundle_install.sh +541 -0
- package/evals/integration/test_console_learning_projection.sh +192 -0
- package/evals/integration/test_context_map.sh +65 -0
- package/evals/integration/test_effective_backlog_settings.sh +58 -0
- package/evals/integration/test_fixture_retirement_audit.sh +58 -0
- package/evals/integration/test_flow_agents_statusline.sh +93 -0
- package/evals/integration/test_flow_kit_repository.sh +90 -0
- package/evals/integration/test_goal_fit_hook.sh +482 -0
- package/evals/integration/test_hook_category_behaviors.sh +190 -0
- package/evals/integration/test_hook_influence_cases.sh +69 -0
- package/evals/integration/test_local_flow_kit_install.sh +145 -0
- package/evals/integration/test_publish_change_helper.sh +176 -0
- package/evals/integration/test_pull_work_provider.sh +140 -0
- package/evals/integration/test_runtime_adapter_activation.sh +106 -0
- package/evals/integration/test_telemetry.sh +485 -0
- package/evals/integration/test_telemetry_doctor.sh +193 -0
- package/evals/integration/test_usage_feedback_dashboard.sh +169 -0
- package/evals/integration/test_usage_feedback_global.sh +117 -0
- package/evals/integration/test_usage_feedback_import.sh +227 -0
- package/evals/integration/test_usage_feedback_outcomes.sh +165 -0
- package/evals/integration/test_usage_feedback_report.sh +263 -0
- package/evals/integration/test_veritas_governance_adapter.sh +235 -0
- package/evals/integration/test_workflow_artifact_cleanup_audit.sh +287 -0
- package/evals/integration/test_workflow_artifacts.sh +1247 -0
- package/evals/integration/test_workflow_sidecar_writer.sh +2112 -0
- package/evals/integration/test_workflow_steering_hook.sh +337 -0
- package/evals/lib/assertions/delegated-to.js +40 -0
- package/evals/lib/assertions/max-tool-calls.js +15 -0
- package/evals/lib/assertions/no-write-tools.js +27 -0
- package/evals/lib/assertions/pass-at-k.js +39 -0
- package/evals/lib/assertions/telemetry-utils.js +105 -0
- package/evals/lib/assertions/tool-called.js +39 -0
- package/evals/lib/assertions/verify-after-fix.js +61 -0
- package/evals/lib/claude-judge.sh +40 -0
- package/evals/lib/claude-provider.sh +74 -0
- package/evals/lib/codex-judge.sh +39 -0
- package/evals/lib/codex-provider.sh +81 -0
- package/evals/lib/eval-dev.sh +5 -0
- package/evals/lib/eval-judge.sh +22 -0
- package/evals/lib/eval-provider.sh +26 -0
- package/evals/lib/eval-report.sh +73 -0
- package/evals/lib/kiro-dev.sh +4 -0
- package/evals/lib/kiro-judge.sh +17 -0
- package/evals/lib/kiro-provider.sh +62 -0
- package/evals/lib/node.sh +111 -0
- package/evals/promptfooconfig.yaml +70 -0
- package/evals/run.sh +309 -0
- package/evals/static/test_evidence_refs.sh +141 -0
- package/evals/static/test_package.sh +407 -0
- package/evals/static/test_repo_hooks.sh +68 -0
- package/evals/static/test_universal_bundles.sh +274 -0
- package/evals/static/test_workflow_skills.sh +1207 -0
- package/install.sh +64 -0
- package/integrations/veritas/flow-agents.adapter.json +138 -0
- package/integrations/veritas/flow-agents.authority-settings.json +26 -0
- package/integrations/veritas/flow-agents.repo-standards.json +82 -0
- package/kits/builder/flows/build.flow.json +218 -0
- package/kits/builder/flows/shape.flow.json +127 -0
- package/kits/builder/kit.json +19 -0
- package/kits/catalog.json +11 -0
- package/package.json +130 -0
- package/packaging/README.md +60 -0
- package/packaging/manifest.json +173 -0
- package/packaging/packs.json +69 -0
- package/powers/dependency-checker/POWER.md +20 -0
- package/powers/dependency-checker/mcp.json +20 -0
- package/powers/playwright/POWER.md +25 -0
- package/powers/playwright/mcp.json +12 -0
- package/prompts/code-audit.md +123 -0
- package/prompts/kcommit.md +88 -0
- package/schemas/backlog-provider-settings.schema.json +138 -0
- package/schemas/workflow-acceptance.schema.json +216 -0
- package/schemas/workflow-critique.schema.json +113 -0
- package/schemas/workflow-evidence.schema.json +357 -0
- package/schemas/workflow-handoff.schema.json +52 -0
- package/schemas/workflow-learning.schema.json +223 -0
- package/schemas/workflow-release.schema.json +172 -0
- package/schemas/workflow-state.schema.json +80 -0
- package/scripts/README.md +111 -0
- package/scripts/build-universal-bundles.js +3 -0
- package/scripts/check-content-boundary.cjs +99 -0
- package/scripts/context-budget/budget-scan.sh +166 -0
- package/scripts/detect-tools.sh +3 -0
- package/scripts/discover-agents.sh +28 -0
- package/scripts/effective-backlog-settings.js +2 -0
- package/scripts/filter-installed-packs.js +2 -0
- package/scripts/flow-kit.js +2 -0
- package/scripts/generate-context-map.js +2 -0
- package/scripts/git-status.sh +49 -0
- package/scripts/hooks/claude-hook-adapter.js +174 -0
- package/scripts/hooks/claude-telemetry-hook.js +115 -0
- package/scripts/hooks/codex-hook-adapter.js +176 -0
- package/scripts/hooks/codex-telemetry-hook.js +95 -0
- package/scripts/hooks/config-protection.js +79 -0
- package/scripts/hooks/desktop-notify.sh +39 -0
- package/scripts/hooks/governance-audit.sh +135 -0
- package/scripts/hooks/lib/audit-transport.sh +40 -0
- package/scripts/hooks/lib/hook-flags.js +49 -0
- package/scripts/hooks/lib/patterns.sh +57 -0
- package/scripts/hooks/lib/resolve-formatter.js +80 -0
- package/scripts/hooks/post-edit-accumulator.js +66 -0
- package/scripts/hooks/pre-commit-quality.js +194 -0
- package/scripts/hooks/quality-gate.js +93 -0
- package/scripts/hooks/report-only-guard.js +21 -0
- package/scripts/hooks/run-hook.js +136 -0
- package/scripts/hooks/stop-format-typecheck.js +141 -0
- package/scripts/hooks/stop-goal-fit.js +337 -0
- package/scripts/hooks/workflow-steering.js +250 -0
- package/scripts/install-codex-home.sh +106 -0
- package/scripts/package.json +3 -0
- package/scripts/promote-workflow-artifact.js +2 -0
- package/scripts/publish-change-helper.js +2 -0
- package/scripts/pull-work-provider.js +2 -0
- package/scripts/setup-repo-hooks.sh +8 -0
- package/scripts/statusline/flow-agents-statusline.js +157 -0
- package/scripts/telemetry/console-presets.sh +14 -0
- package/scripts/telemetry/install-console-config.sh +214 -0
- package/scripts/telemetry/lib/config.sh +85 -0
- package/scripts/telemetry/lib/enrich.sh +115 -0
- package/scripts/telemetry/lib/redact.sh +22 -0
- package/scripts/telemetry/lib/session.sh +63 -0
- package/scripts/telemetry/lib/transport.sh +183 -0
- package/scripts/telemetry/lib/usage.sh +29 -0
- package/scripts/telemetry/sync-agents.sh +173 -0
- package/scripts/telemetry/telemetry.conf +23 -0
- package/scripts/telemetry/telemetry.sh +387 -0
- package/scripts/usage-feedback.js +2 -0
- package/scripts/validate-hook-influence-cases.js +2 -0
- package/scripts/validate-package.sh +89 -0
- package/scripts/validate-source-tree.js +9 -0
- package/skills/agentic-engineering/SKILL.md +62 -0
- package/skills/browser-test/SKILL.md +51 -0
- package/skills/builder-shape/SKILL.md +76 -0
- package/skills/context-budget/SKILL.md +40 -0
- package/skills/deliver/SKILL.md +241 -0
- package/skills/dependency-update/SKILL.md +68 -0
- package/skills/design-probe/SKILL.md +107 -0
- package/skills/eval-rebuild/SKILL.md +39 -0
- package/skills/evidence-gate/SKILL.md +186 -0
- package/skills/execute-plan/SKILL.md +110 -0
- package/skills/explore/SKILL.md +137 -0
- package/skills/feedback-loop/SKILL.md +87 -0
- package/skills/fix-bug/SKILL.md +133 -0
- package/skills/frontend-design/SKILL.md +80 -0
- package/skills/github-cli/SKILL.md +63 -0
- package/skills/idea-to-backlog/SKILL.md +267 -0
- package/skills/knowledge-capture/SKILL.md +55 -0
- package/skills/learning-review/SKILL.md +115 -0
- package/skills/pickup-probe/SKILL.md +114 -0
- package/skills/plan-work/SKILL.md +176 -0
- package/skills/pull-work/SKILL.md +309 -0
- package/skills/release-readiness/SKILL.md +121 -0
- package/skills/review-work/SKILL.md +161 -0
- package/skills/search-first/SKILL.md +66 -0
- package/skills/tdd-workflow/SKILL.md +140 -0
- package/skills/verify-work/SKILL.md +109 -0
- package/src/cli/console-learning-projection.ts +140 -0
- package/src/cli/effective-backlog-settings.ts +99 -0
- package/src/cli/fixture-retirement-audit.ts +154 -0
- package/src/cli/flow-kit.ts +139 -0
- package/src/cli/init.ts +248 -0
- package/src/cli/promote-workflow-artifact.ts +64 -0
- package/src/cli/publish-change-helper.ts +143 -0
- package/src/cli/pull-work-provider.ts +481 -0
- package/src/cli/runtime-adapter.ts +24 -0
- package/src/cli/telemetry-doctor.ts +243 -0
- package/src/cli/usage-feedback.ts +418 -0
- package/src/cli/validate-hook-influence.ts +119 -0
- package/src/cli/validate-source-tree.ts +30 -0
- package/src/cli/validate-workflow-artifacts.ts +411 -0
- package/src/cli/veritas-governance.ts +322 -0
- package/src/cli/workflow-artifact-cleanup-audit.ts +281 -0
- package/src/cli/workflow-sidecar.ts +676 -0
- package/src/cli.ts +95 -0
- package/src/flow-kit/validate.ts +74 -0
- package/src/lib/args.ts +43 -0
- package/src/lib/fs.ts +62 -0
- package/src/lib/workflow-learning-projection.ts +491 -0
- package/src/runtime-adapters.ts +154 -0
- package/src/tools/build-universal-bundles.ts +366 -0
- package/src/tools/common.ts +61 -0
- package/src/tools/filter-installed-packs.ts +129 -0
- package/src/tools/generate-context-map.ts +199 -0
- package/src/tools/validate-package.ts +57 -0
- package/src/tools/validate-source-tree.ts +488 -0
- package/tsconfig.json +19 -0
- package/veritas.claims.json +6 -0
|
@@ -0,0 +1,170 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"number": 22,
|
|
4
|
+
"title": "Define and validate Flow Kit repositories",
|
|
5
|
+
"state": "OPEN",
|
|
6
|
+
"body": "## Problem\nExternal kit repositories need a validated contract.\n\n## Scope\n- Add contract docs.\n- Validate local kit folders.\n\n## Acceptance criteria\n- Valid fixture passes.\n- Invalid fixtures fail.\n\n## Dependencies\nRequires kontourai/flow#2.\n\n## Source artifact\n`.flow-agents/flow-agents-kit-platform-backlog/flow-agents-kit-platform-backlog--idea-to-backlog.md`",
|
|
7
|
+
"labels": [],
|
|
8
|
+
"assignees": [],
|
|
9
|
+
"milestone": null,
|
|
10
|
+
"projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
|
|
11
|
+
"closedByPullRequestsReferences": [],
|
|
12
|
+
"url": "https://github.com/kontourai/flow-agents/issues/22",
|
|
13
|
+
"updatedAt": "2026-05-26T04:55:50Z",
|
|
14
|
+
"createdAt": "2026-05-26T04:55:50Z"
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"number": 23,
|
|
18
|
+
"title": "Install Flow Kits",
|
|
19
|
+
"state": "OPEN",
|
|
20
|
+
"body": "## Scope\nInstall kits.\n\n## Acceptance criteria\nInstaller works.\n\n## Dependencies\nBlocked by #22.",
|
|
21
|
+
"labels": [{ "name": "blocked" }],
|
|
22
|
+
"assignees": [],
|
|
23
|
+
"milestone": null,
|
|
24
|
+
"projectItems": [{ "status": { "name": "Blocked" }, "title": "Flow Agents Builder Platform" }],
|
|
25
|
+
"closedByPullRequestsReferences": [],
|
|
26
|
+
"url": "https://github.com/kontourai/flow-agents/issues/23",
|
|
27
|
+
"updatedAt": "2026-05-26T04:56:00Z",
|
|
28
|
+
"createdAt": "2026-05-26T04:56:00Z"
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
"number": 27,
|
|
32
|
+
"title": "Research Flow Kit distribution",
|
|
33
|
+
"state": "OPEN",
|
|
34
|
+
"body": "## Scope\nResearch options.\n\n## Acceptance criteria\nResearch note exists.",
|
|
35
|
+
"labels": [{ "name": "research" }],
|
|
36
|
+
"assignees": [],
|
|
37
|
+
"milestone": null,
|
|
38
|
+
"projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
|
|
39
|
+
"closedByPullRequestsReferences": [],
|
|
40
|
+
"url": "https://github.com/kontourai/flow-agents/issues/27",
|
|
41
|
+
"updatedAt": "2026-05-26T04:57:00Z",
|
|
42
|
+
"createdAt": "2026-05-26T04:57:00Z"
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
"number": 30,
|
|
46
|
+
"title": "Teach pull-work to use configured backlog providers",
|
|
47
|
+
"state": "OPEN",
|
|
48
|
+
"body": "## Scope\nNormalize providers.\n\n## Acceptance criteria\nPull-work selects #22.",
|
|
49
|
+
"labels": [],
|
|
50
|
+
"assignees": [],
|
|
51
|
+
"milestone": { "number": 1, "title": "Builder Kit Dogfood Alpha" },
|
|
52
|
+
"projectItems": [{ "status": { "name": "In Progress" }, "title": "Flow Agents Builder Platform" }],
|
|
53
|
+
"closedByPullRequestsReferences": [],
|
|
54
|
+
"url": "https://github.com/kontourai/flow-agents/issues/30",
|
|
55
|
+
"updatedAt": "2026-05-26T06:00:23Z",
|
|
56
|
+
"createdAt": "2026-05-26T05:06:54Z"
|
|
57
|
+
},
|
|
58
|
+
{
|
|
59
|
+
"number": 99,
|
|
60
|
+
"title": "Old unshaped idea",
|
|
61
|
+
"state": "OPEN",
|
|
62
|
+
"body": "Maybe improve something later.",
|
|
63
|
+
"labels": [],
|
|
64
|
+
"assignees": [],
|
|
65
|
+
"milestone": null,
|
|
66
|
+
"projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
|
|
67
|
+
"closedByPullRequestsReferences": [],
|
|
68
|
+
"url": "https://github.com/kontourai/flow-agents/issues/99",
|
|
69
|
+
"updatedAt": "2025-01-01T00:00:00Z",
|
|
70
|
+
"createdAt": "2025-01-01T00:00:00Z"
|
|
71
|
+
},
|
|
72
|
+
{
|
|
73
|
+
"number": 97,
|
|
74
|
+
"title": "Emit source revision metadata and structured blockers",
|
|
75
|
+
"state": "OPEN",
|
|
76
|
+
"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-->",
|
|
77
|
+
"labels": [],
|
|
78
|
+
"assignees": [],
|
|
79
|
+
"milestone": null,
|
|
80
|
+
"projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
|
|
81
|
+
"closedByPullRequestsReferences": [],
|
|
82
|
+
"url": "https://github.com/kontourai/flow-agents/issues/97",
|
|
83
|
+
"updatedAt": "2026-06-03T03:24:00Z",
|
|
84
|
+
"createdAt": "2026-06-03T03:24:00Z"
|
|
85
|
+
},
|
|
86
|
+
{
|
|
87
|
+
"number": 101,
|
|
88
|
+
"title": "Legacy issue with invalid metadata marker",
|
|
89
|
+
"state": "OPEN",
|
|
90
|
+
"body": "## Scope\nKeep prose fallback working when metadata is malformed.\n\n## Acceptance criteria\nFallback blocker extraction still works.\n\n## Dependencies / Blockers\nRequires #22.\n\n<!-- flow-agents:work-item-metadata\n{ invalid json\n-->",
|
|
91
|
+
"labels": [],
|
|
92
|
+
"assignees": [],
|
|
93
|
+
"milestone": null,
|
|
94
|
+
"projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
|
|
95
|
+
"closedByPullRequestsReferences": [],
|
|
96
|
+
"url": "https://github.com/kontourai/flow-agents/issues/101",
|
|
97
|
+
"updatedAt": "2026-06-03T03:25:00Z",
|
|
98
|
+
"createdAt": "2026-06-03T03:25:00Z"
|
|
99
|
+
},
|
|
100
|
+
{
|
|
101
|
+
"number": 110,
|
|
102
|
+
"title": "Fresh planned item",
|
|
103
|
+
"state": "OPEN",
|
|
104
|
+
"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-->",
|
|
105
|
+
"labels": [],
|
|
106
|
+
"assignees": [],
|
|
107
|
+
"milestone": null,
|
|
108
|
+
"projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
|
|
109
|
+
"closedByPullRequestsReferences": [],
|
|
110
|
+
"url": "https://github.com/kontourai/flow-agents/issues/110",
|
|
111
|
+
"updatedAt": "2026-06-02T00:00:00Z",
|
|
112
|
+
"createdAt": "2026-06-02T00:00:00Z"
|
|
113
|
+
},
|
|
114
|
+
{
|
|
115
|
+
"number": 111,
|
|
116
|
+
"title": "Drifted planned item",
|
|
117
|
+
"state": "OPEN",
|
|
118
|
+
"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-->",
|
|
119
|
+
"labels": [],
|
|
120
|
+
"assignees": [],
|
|
121
|
+
"milestone": null,
|
|
122
|
+
"projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
|
|
123
|
+
"closedByPullRequestsReferences": [],
|
|
124
|
+
"url": "https://github.com/kontourai/flow-agents/issues/111",
|
|
125
|
+
"updatedAt": "2026-06-01T00:00:00Z",
|
|
126
|
+
"createdAt": "2026-06-01T00:00:00Z"
|
|
127
|
+
},
|
|
128
|
+
{
|
|
129
|
+
"number": 112,
|
|
130
|
+
"title": "Stale planned item",
|
|
131
|
+
"state": "OPEN",
|
|
132
|
+
"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-->",
|
|
133
|
+
"labels": [],
|
|
134
|
+
"assignees": [],
|
|
135
|
+
"milestone": null,
|
|
136
|
+
"projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
|
|
137
|
+
"closedByPullRequestsReferences": [],
|
|
138
|
+
"url": "https://github.com/kontourai/flow-agents/issues/112",
|
|
139
|
+
"updatedAt": "2026-04-01T00:00:00Z",
|
|
140
|
+
"createdAt": "2026-04-01T00:00:00Z"
|
|
141
|
+
},
|
|
142
|
+
{
|
|
143
|
+
"number": 113,
|
|
144
|
+
"title": "Legacy item missing planned base",
|
|
145
|
+
"state": "OPEN",
|
|
146
|
+
"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-->",
|
|
147
|
+
"labels": [],
|
|
148
|
+
"assignees": [],
|
|
149
|
+
"milestone": null,
|
|
150
|
+
"projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
|
|
151
|
+
"closedByPullRequestsReferences": [],
|
|
152
|
+
"url": "https://github.com/kontourai/flow-agents/issues/113",
|
|
153
|
+
"updatedAt": "2026-06-01T00:00:00Z",
|
|
154
|
+
"createdAt": "2026-06-01T00:00:00Z"
|
|
155
|
+
},
|
|
156
|
+
{
|
|
157
|
+
"number": 114,
|
|
158
|
+
"title": "Structured-only cross-repo blocker",
|
|
159
|
+
"state": "OPEN",
|
|
160
|
+
"body": "## Scope\nUse only structured blocker metadata.\n\n## Acceptance criteria\nStructured blocker readiness is deterministic.\n\n<!-- flow-agents:work-item-metadata\n{\n \"schema_version\": \"1.0\",\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}\n-->",
|
|
161
|
+
"labels": [],
|
|
162
|
+
"assignees": [],
|
|
163
|
+
"milestone": null,
|
|
164
|
+
"projectItems": [{ "status": { "name": "Todo" }, "title": "Flow Agents Builder Platform" }],
|
|
165
|
+
"closedByPullRequestsReferences": [],
|
|
166
|
+
"url": "https://github.com/kontourai/flow-agents/issues/114",
|
|
167
|
+
"updatedAt": "2026-06-03T03:26:00Z",
|
|
168
|
+
"createdAt": "2026-06-03T03:26:00Z"
|
|
169
|
+
}
|
|
170
|
+
]
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema_version": "1.0",
|
|
3
|
+
"description": "Global WIP informs risk but does not automatically block selected work.",
|
|
4
|
+
"wip_assessment": {
|
|
5
|
+
"my_active_work": [],
|
|
6
|
+
"shepherding_candidates": [],
|
|
7
|
+
"stale_worktrees": [],
|
|
8
|
+
"open_prs_by_me": [],
|
|
9
|
+
"global_conflicts": [
|
|
10
|
+
{
|
|
11
|
+
"kind": "pull_request",
|
|
12
|
+
"owner": "other-user",
|
|
13
|
+
"ref": "kontourai/flow-agents#99",
|
|
14
|
+
"files": [
|
|
15
|
+
"docs/workflow-usage-guide.md"
|
|
16
|
+
],
|
|
17
|
+
"risk": "documentation overlap only"
|
|
18
|
+
}
|
|
19
|
+
],
|
|
20
|
+
"dependency_impacts": [
|
|
21
|
+
{
|
|
22
|
+
"ref": "kontourai/flow-agents#99",
|
|
23
|
+
"impact": "coordinate docs wording if both PRs edit the same paragraph"
|
|
24
|
+
}
|
|
25
|
+
]
|
|
26
|
+
},
|
|
27
|
+
"start_new_work_decision": {
|
|
28
|
+
"decision": "proceed",
|
|
29
|
+
"reason": "No personal WIP is blocking. Global WIP is documented as coordination risk, not a dependency or release blocker.",
|
|
30
|
+
"next_action": "Proceed with isolated worktree and record overlapping doc risk in the handoff."
|
|
31
|
+
},
|
|
32
|
+
"worktree_lifecycle": {
|
|
33
|
+
"path": "~/code/kontourai/flow-agents-example",
|
|
34
|
+
"branch": "example-branch",
|
|
35
|
+
"retain_until": "pr_merged",
|
|
36
|
+
"cleanup_owner": "orchestrator",
|
|
37
|
+
"cleanup_command": "git worktree remove ~/code/kontourai/flow-agents-example",
|
|
38
|
+
"cleanup_blocked_by": [
|
|
39
|
+
"open PR",
|
|
40
|
+
"pending CI"
|
|
41
|
+
]
|
|
42
|
+
}
|
|
43
|
+
}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema_version": "1.0",
|
|
3
|
+
"description": "Personal WIP blocks starting new implementation because an owned PR/worktree needs shepherding.",
|
|
4
|
+
"wip_assessment": {
|
|
5
|
+
"my_active_work": [
|
|
6
|
+
{
|
|
7
|
+
"kind": "worktree",
|
|
8
|
+
"path": "~/code/kontourai/flow-agents-workflow-hardening",
|
|
9
|
+
"branch": "workflow-hardening-publish-change",
|
|
10
|
+
"status": "dirty",
|
|
11
|
+
"summary": "Unpublished publish-change contract/helper work is still active."
|
|
12
|
+
}
|
|
13
|
+
],
|
|
14
|
+
"shepherding_candidates": [
|
|
15
|
+
{
|
|
16
|
+
"kind": "worktree",
|
|
17
|
+
"ref": "workflow-hardening-publish-change",
|
|
18
|
+
"next_action": "Decide whether to publish, continue, or abandon before starting another implementation."
|
|
19
|
+
}
|
|
20
|
+
],
|
|
21
|
+
"stale_worktrees": [],
|
|
22
|
+
"open_prs_by_me": [],
|
|
23
|
+
"global_conflicts": [],
|
|
24
|
+
"dependency_impacts": []
|
|
25
|
+
},
|
|
26
|
+
"start_new_work_decision": {
|
|
27
|
+
"decision": "shepherd_existing",
|
|
28
|
+
"reason": "Personal WIP is dirty and touches workflow contracts that overlap new workflow work.",
|
|
29
|
+
"next_action": "Shepherd or explicitly park the active worktree before selecting more implementation work."
|
|
30
|
+
},
|
|
31
|
+
"worktree_lifecycle": {
|
|
32
|
+
"path": "~/code/kontourai/flow-agents-workflow-hardening",
|
|
33
|
+
"branch": "workflow-hardening-publish-change",
|
|
34
|
+
"retain_until": "user_override",
|
|
35
|
+
"cleanup_owner": "user",
|
|
36
|
+
"cleanup_command": "git worktree remove ~/code/kontourai/flow-agents-workflow-hardening",
|
|
37
|
+
"cleanup_blocked_by": [
|
|
38
|
+
"dirty files",
|
|
39
|
+
"user decision"
|
|
40
|
+
]
|
|
41
|
+
}
|
|
42
|
+
}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema_version": "1.0",
|
|
3
|
+
"artifact_kind": "TrustReport",
|
|
4
|
+
"artifact_ref": "surface-trust://fixtures/accepted-claim-trust-report.json",
|
|
5
|
+
"subject": {
|
|
6
|
+
"type": "flow-step",
|
|
7
|
+
"id": "verify"
|
|
8
|
+
},
|
|
9
|
+
"gate": {
|
|
10
|
+
"id": "tests-evidence",
|
|
11
|
+
"kind": "surface.claim"
|
|
12
|
+
},
|
|
13
|
+
"claim": {
|
|
14
|
+
"type": "builder.verify.tests",
|
|
15
|
+
"subject": "flow-step",
|
|
16
|
+
"status": "accepted"
|
|
17
|
+
},
|
|
18
|
+
"authority": {
|
|
19
|
+
"producer": "fixture-trust-provider",
|
|
20
|
+
"trace_ref": "surface-trust://authority/fixture-provider"
|
|
21
|
+
},
|
|
22
|
+
"integrity": {
|
|
23
|
+
"digest": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
|
|
24
|
+
"subject_digest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
|
|
25
|
+
"verified": true
|
|
26
|
+
},
|
|
27
|
+
"freshness": {
|
|
28
|
+
"status": "fresh",
|
|
29
|
+
"checked_at": "2026-05-26T00:00:00Z"
|
|
30
|
+
}
|
|
31
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema_version": "1.0",
|
|
3
|
+
"scenario": "artifact_absent",
|
|
4
|
+
"artifact_kind": "TrustReport",
|
|
5
|
+
"artifact_ref": "surface-trust://fixtures/missing-trust-report.json",
|
|
6
|
+
"gate": {
|
|
7
|
+
"id": "implementation-plan",
|
|
8
|
+
"kind": "surface.claim"
|
|
9
|
+
},
|
|
10
|
+
"claim": {
|
|
11
|
+
"type": "builder.plan.implementation",
|
|
12
|
+
"subject": "artifact",
|
|
13
|
+
"status": "not_verified"
|
|
14
|
+
},
|
|
15
|
+
"gap": {
|
|
16
|
+
"status": "not_verified",
|
|
17
|
+
"summary": "Configured trust artifact was not readable."
|
|
18
|
+
}
|
|
19
|
+
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema_version": "1.0",
|
|
3
|
+
"artifact_kind": "TrustReport",
|
|
4
|
+
"artifact_ref": "surface-trust://fixtures/integrity-mismatch-trust-report.json",
|
|
5
|
+
"subject": {
|
|
6
|
+
"type": "artifact",
|
|
7
|
+
"id": "surface-trust-evidence--plan.md"
|
|
8
|
+
},
|
|
9
|
+
"gate": {
|
|
10
|
+
"id": "implementation-plan",
|
|
11
|
+
"kind": "surface.claim"
|
|
12
|
+
},
|
|
13
|
+
"claim": {
|
|
14
|
+
"type": "builder.plan.implementation",
|
|
15
|
+
"subject": "artifact",
|
|
16
|
+
"status": "accepted"
|
|
17
|
+
},
|
|
18
|
+
"authority": {
|
|
19
|
+
"producer": "fixture-trust-provider",
|
|
20
|
+
"trace_ref": "surface-trust://authority/fixture-provider"
|
|
21
|
+
},
|
|
22
|
+
"integrity": {
|
|
23
|
+
"digest": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
|
|
24
|
+
"expected_digest": "sha256:4444444444444444444444444444444444444444444444444444444444444444",
|
|
25
|
+
"verified": false,
|
|
26
|
+
"mismatch": "digest"
|
|
27
|
+
},
|
|
28
|
+
"freshness": {
|
|
29
|
+
"status": "fresh",
|
|
30
|
+
"checked_at": "2026-05-26T00:00:00Z"
|
|
31
|
+
}
|
|
32
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema_version": "1.0",
|
|
3
|
+
"artifact_kind": "TrustReport",
|
|
4
|
+
"artifact_ref": "surface-trust://fixtures/missing-authority-trust-report.json",
|
|
5
|
+
"subject": {
|
|
6
|
+
"type": "change",
|
|
7
|
+
"id": "surface-trust-fixtures"
|
|
8
|
+
},
|
|
9
|
+
"gate": {
|
|
10
|
+
"id": "implementation-scope",
|
|
11
|
+
"kind": "surface.claim"
|
|
12
|
+
},
|
|
13
|
+
"claim": {
|
|
14
|
+
"type": "builder.execute.scope",
|
|
15
|
+
"subject": "change",
|
|
16
|
+
"status": "accepted"
|
|
17
|
+
},
|
|
18
|
+
"authority": null,
|
|
19
|
+
"integrity": {
|
|
20
|
+
"digest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
|
|
21
|
+
"verified": true
|
|
22
|
+
},
|
|
23
|
+
"freshness": {
|
|
24
|
+
"status": "fresh",
|
|
25
|
+
"checked_at": "2026-05-26T00:00:00Z"
|
|
26
|
+
}
|
|
27
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema_version": "1.0",
|
|
3
|
+
"scenario": "provider_absent",
|
|
4
|
+
"artifact_kind": "Trust Snapshot",
|
|
5
|
+
"artifact_ref": null,
|
|
6
|
+
"gate": {
|
|
7
|
+
"id": "selected-work",
|
|
8
|
+
"kind": "surface.claim"
|
|
9
|
+
},
|
|
10
|
+
"claim": {
|
|
11
|
+
"type": "builder.pull-work.selected",
|
|
12
|
+
"subject": "work-item",
|
|
13
|
+
"status": "not_verified"
|
|
14
|
+
},
|
|
15
|
+
"gap": {
|
|
16
|
+
"status": "not_verified",
|
|
17
|
+
"summary": "No trust provider is configured; ordinary Builder Kit evidence remains usable."
|
|
18
|
+
}
|
|
19
|
+
}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema_version": "1.0",
|
|
3
|
+
"artifact_kind": "TrustReport",
|
|
4
|
+
"artifact_ref": "surface-trust://fixtures/rejected-claim-trust-report.json",
|
|
5
|
+
"subject": {
|
|
6
|
+
"type": "change",
|
|
7
|
+
"id": "surface-trust-fixtures"
|
|
8
|
+
},
|
|
9
|
+
"gate": {
|
|
10
|
+
"id": "implementation-scope",
|
|
11
|
+
"kind": "surface.claim"
|
|
12
|
+
},
|
|
13
|
+
"claim": {
|
|
14
|
+
"type": "builder.execute.scope",
|
|
15
|
+
"subject": "change",
|
|
16
|
+
"status": "rejected"
|
|
17
|
+
},
|
|
18
|
+
"authority": {
|
|
19
|
+
"producer": "fixture-trust-provider",
|
|
20
|
+
"trace_ref": "surface-trust://authority/fixture-provider"
|
|
21
|
+
},
|
|
22
|
+
"integrity": {
|
|
23
|
+
"digest": "sha256:6666666666666666666666666666666666666666666666666666666666666666",
|
|
24
|
+
"verified": true
|
|
25
|
+
},
|
|
26
|
+
"freshness": {
|
|
27
|
+
"status": "fresh",
|
|
28
|
+
"checked_at": "2026-05-26T00:00:00Z"
|
|
29
|
+
}
|
|
30
|
+
}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema_version": "1.0",
|
|
3
|
+
"artifact_kind": "Trust Snapshot",
|
|
4
|
+
"artifact_ref": "surface-trust://fixtures/stale-claim-trust-snapshot.json",
|
|
5
|
+
"subject": {
|
|
6
|
+
"type": "flow-step",
|
|
7
|
+
"id": "verify"
|
|
8
|
+
},
|
|
9
|
+
"gate": {
|
|
10
|
+
"id": "tests-evidence",
|
|
11
|
+
"kind": "surface.claim"
|
|
12
|
+
},
|
|
13
|
+
"claim": {
|
|
14
|
+
"type": "builder.verify.tests",
|
|
15
|
+
"subject": "flow-step",
|
|
16
|
+
"status": "trusted"
|
|
17
|
+
},
|
|
18
|
+
"authority": {
|
|
19
|
+
"producer": "fixture-trust-provider",
|
|
20
|
+
"trace_ref": "surface-trust://authority/fixture-provider"
|
|
21
|
+
},
|
|
22
|
+
"integrity": {
|
|
23
|
+
"digest": "sha256:7777777777777777777777777777777777777777777777777777777777777777",
|
|
24
|
+
"verified": true
|
|
25
|
+
},
|
|
26
|
+
"freshness": {
|
|
27
|
+
"status": "stale",
|
|
28
|
+
"checked_at": "2026-05-26T00:00:00Z",
|
|
29
|
+
"reason": "Artifact predates current subject digest."
|
|
30
|
+
}
|
|
31
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
{"schema_version":"1","timestamp":"2026-05-04T10:00:00Z","session_id":"codex-session-1","event_id":"evt-1","event_type":"session.start","agent":{"name":"dev","runtime":"codex"},"model":"gpt-5","repo":"flow-agents","repo_root":"/tmp/flow-agents","profile_id":"codex-default","prompt_id":"deliver-v1","prompt_variant":"baseline","skill_ids":["deliver"]}
|
|
2
|
+
{"schema_version":"1","timestamp":"2026-05-04T10:01:00Z","session_id":"codex-session-1","event_id":"evt-2","event_type":"turn.user","agent":{"name":"dev","runtime":"codex"},"turn":{"prompt_length":27}}
|
|
3
|
+
{"schema_version":"1","timestamp":"2026-05-04T10:02:00Z","session_id":"codex-session-1","event_id":"evt-3","event_type":"tool.invoke","agent":{"name":"dev","runtime":"codex"},"tool":{"name":"execute_bash","normalized_name":"execute_bash"}}
|
|
4
|
+
{"schema_version":"1","timestamp":"2026-05-04T10:03:00Z","session_id":"codex-session-1","event_id":"evt-4","event_type":"tool.invoke","agent":{"name":"dev","runtime":"codex"},"tool":{"name":"apply_patch","normalized_name":"apply_patch"}}
|
|
5
|
+
{"schema_version":"1","timestamp":"2026-05-04T10:04:00Z","session_id":"codex-session-1","event_id":"evt-5","event_type":"agent.delegate","agent":{"name":"dev","runtime":"codex"},"delegation":{"targets":["tool-worker"]}}
|
|
6
|
+
{"schema_version":"1","timestamp":"2026-05-04T10:05:00Z","session_id":"codex-session-1","event_id":"evt-6","event_type":"tool.permission_request","agent":{"name":"dev","runtime":"codex"},"permission":{"description":"Run integration command"}}
|
|
7
|
+
{"schema_version":"1","timestamp":"2026-05-04T10:06:00Z","session_id":"codex-session-1","event_id":"evt-7","event_type":"session.usage","agent":{"name":"dev","runtime":"codex"},"usage":{"duration_s":360}}
|
|
8
|
+
{"schema_version":"1","timestamp":"2026-05-04T11:00:00Z","session_id":"codex-session-2","event_id":"evt-8","event_type":"session.start","agent":{"name":"dev","runtime":"codex"},"model":"gpt-5","repo":"flow-agents-docs","repo_root":"/tmp/flow-agents-docs","profile_id":"codex-experimental","prompt_id":"deliver-v2","prompt_variant":"concise","skill_ids":["deliver","verify-work"]}
|
|
9
|
+
{"schema_version":"1","timestamp":"2026-05-04T11:01:00Z","session_id":"codex-session-2","event_id":"evt-9","event_type":"turn.user","agent":{"name":"dev","runtime":"codex"}}
|
|
10
|
+
{"schema_version":"1","timestamp":"2026-05-04T11:02:00Z","session_id":"codex-session-2","event_id":"evt-10","event_type":"tool.invoke","agent":{"name":"dev","runtime":"codex"},"tool":{"name":"execute_bash","normalized_name":"execute_bash"}}
|
|
11
|
+
{"schema_version":"1","timestamp":"2026-05-04T11:04:00Z","session_id":"codex-session-2","event_id":"evt-11","event_type":"session.end","agent":{"name":"dev","runtime":"codex"},"session":{"duration_s":240}}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"schema_version":"1","outcome_id":"outcome-1","recorded_at":"2026-05-04T10:30:00Z","session_id":"codex-session-1","runtime":"codex","repo":"flow-agents","agent":"dev","profile_id":"codex-default","prompt_id":"deliver-v1","prompt_variant":"baseline","skill_ids":["deliver"],"task_type":"deliver","task_slug":"usage-feedback-tests","result":"success","quality_score":5,"human_minutes_saved":20,"rework_required":false,"notes":"Fixture success outcome","evidence":["evals/integration/test_usage_feedback_report.sh"]}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
set -euo pipefail
|
|
3
|
+
|
|
4
|
+
if [[ "${VERITAS_ARGV_LOG:-}" != "" ]]; then
|
|
5
|
+
printf '%s\n' "$*" > "$VERITAS_ARGV_LOG"
|
|
6
|
+
fi
|
|
7
|
+
|
|
8
|
+
expected='readiness --check evidence --working-tree'
|
|
9
|
+
if [[ "${VERITAS_EXPECT_ROOT:-}" != "" ]]; then
|
|
10
|
+
expected="$expected --root $VERITAS_EXPECT_ROOT"
|
|
11
|
+
fi
|
|
12
|
+
|
|
13
|
+
if [[ "$*" != "$expected" ]]; then
|
|
14
|
+
echo "unexpected argv: $*" >&2
|
|
15
|
+
exit 70
|
|
16
|
+
fi
|
|
17
|
+
|
|
18
|
+
echo "fixture Veritas readiness passed"
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
set -euo pipefail
|
|
3
|
+
|
|
4
|
+
echo "Veritas policy failed"
|
|
5
|
+
echo "token=fixture-token-redaction-sentinel"
|
|
6
|
+
echo "api_key=fixture-api-key-redaction-sentinel"
|
|
7
|
+
for i in $(seq 1 40); do
|
|
8
|
+
echo "detail line $i: this line should be bounded in the evidence sidecar"
|
|
9
|
+
done
|
|
10
|
+
exit 17
|