aaronrene / knowtation public
feat BREAKING flow feat/flow-projection-pilot #17 / 18
aaronrene · 3 days ago · Jun 20, 2026 · Diff

feat(flow): implement store + list/get read surface (7A-10b)

Ship file-backed Flow store with idempotent starter seed, Hub GET /flows routes, CLI flow list/get, MCP flow_list/flow_get, OpenAPI schemas, and seven-tier tests with CLI=MCP=Hub handler parity gate.

sha256:f0525edc70a9a0d7ecc0e91868aa2d4254330be61b028ac0eeeb98c754cb8c55 sha
sha256:316f778efe23e6739a042ee9f6a5fe432885aba8ce1f5ea90da73651ce124ead parent
+37 ~3 −1 symbols
sha256:a861a71f68a31c993e0ae2cd02e6004f072631fffab4ac251fc63f96cf0cc754 snapshot
+37
symbols added
~3
symbols modified
−1
symbol removed
0
dead code introduced
Semantic Changes 41 symbols
+ lib/flow/
+ test/fixtures/flow/
~ lib/flow/flow-handlers.mjs .mjs 4 symbols added
+ handleFlowGetRequest function function handleFlowGetRequest L106–153
+ handleFlowListRequest function function handleFlowListRequest L50–88
+ resolveHandlerVisibleScopes function function resolveHandlerVisibleScopes L18–32
+ serializeFlowPayload function function serializeFlowPayload L161–163
~ lib/flow/flow-scope.mjs .mjs 5 symbols added
+ highestFlowScope function function highestFlowScope L95–101
+ readFlowWorkspaceScope function function readFlowWorkspaceScope L27–39
+ resolveFlowScopeQuery function function resolveFlowScopeQuery L110–136
+ resolveFlowVisibleScopes function function resolveFlowVisibleScopes L60–87
+ visibleScopesForRole function function visibleScopesForRole L47–52
~ lib/flow/flow-store.mjs .mjs 16 symbols added
+ buildFlowStepId function function buildFlowStepId L146–148
+ compareSemver function function compareSemver L165–170
+ countStepsForFlow function function countStepsForFlow L478–480
+ ensureStarterSeed function function ensureStarterSeed L404–409
+ flowDefinitionForClient function function flowDefinitionForClient L436–471
+ flowSummaryForClient function function flowSummaryForClient L416–429
+ getFlow function function getFlow L571–630
+ getFlowStorePath function function getFlowStorePath L82–84
+ getVaultFlowStore function function getVaultFlowStore L127–139
+ isFlowScope function function isFlowScope L176–178
+ listFlows function function listFlows L497–555
+ loadFlowStore function function loadFlowStore L90–105
+ parseSemver function function parseSemver L154–158
+ saveFlowStore function function saveFlowStore L111–120
+ seedStarterFlows function function seedStarterFlows L332–395
+ validateFlowBundle function function validateFlowBundle L186–322
~ mcp/tools/flow.mjs .mjs 1 symbol added
+ registerFlowTools function function registerFlowTools L17–89
+ test/fixtures/flow/malicious-step-bundle.json .json
~ test/flow-list-get-parity-integration.test.mjs .mjs 6 symbols added
+ cliGet function function cliGet L46–51
+ cliList function function cliList L28–33
+ hubGet function function hubGet L42–44
+ hubList function function hubList L24–26
+ mcpGet function function mcpGet L53–58
+ mcpList function function mcpList L35–40
+ test/flow-store-data-integrity.test.mjs .mjs
+ test/flow-store-e2e.test.mjs .mjs
~ test/flow-store-performance.test.mjs .mjs 1 symbol added
+ percentile function function percentile L22–26
+ test/flow-store-security.test.mjs .mjs
~ test/flow-store-stress.test.mjs .mjs 2 symbols added
+ makeFlow function function makeFlow L23–37
+ makeStep function function makeStep L39–54
+ test/flow-store-unit.test.mjs .mjs
~ cli/index.mjs .mjs 1 symbol added, 1 symbol modified
+ flowExitWithError function function flowExitWithError L1281–1288
~ main
~ docs/FLOW-STORE-CONTRACT-7A-10.md .md 1 symbol added, 1 symbol removed, 1 symbol modified
− Handoff notes (for the next step, 7A-10b — Auto) section Handoff notes (for the next step, 7A-10b — Auto) L541–553
+ Handoff notes (for the next step, 7A-11 — Thinking) section Handoff notes (for the next step, 7A-11 — Thinking) L539–549
~ Flow Store + List/Get Parity — Contract (Phase 7A, Step 7A-10a)
~ docs/openapi.yaml .yaml
~ hub/server.mjs .mjs
~ mcp/create-server.mjs .mjs 1 symbol modified
~ mountKnowtationMcp
Older docs(flow): freeze 7A-10 Flow store + list/get parity contract sha256:316f778efe23e6739a042ee9f6a5fe432885aba8ce1f5ea90da73651ce124ead All commits Newer docs(flow): freeze projection generator + fidelity report contra… sha256:2b6f6f510b7146080eb519309ccf22258e86655371379879e4be094cb58250f4

0 comments

No comments yet. Be the first to start the discussion.

To add a comment, use the Muse CLI: muse hub commit comment sha256:f0525edc70a9a0d7ecc0e91868aa2d4254330be61b028ac0eeeb98c754cb8c55 --body "your comment"