aaronrene / knowtation public
feat patch flow feat/flow-projection-pilot #8 / 18
aaronrene · 2 days ago · Jun 21, 2026 · Diff

feat(flow): 7A-L1b authoring write-back (propose facade + routes)

Ship the SD-4 typed facade over /proposals: flowStateId, one handler, POST /api/v1/flows (+/{id}/proposals,/import), MCP flow_propose/flow_import, CLI flow propose|import, OpenAPI with routes, approve→apply index reconciliation. FLOW_AUTHORING_WRITES defaults OFF; seven tiers green.

sha256:ddc893a78f664ab720f61c08635ba698634b3d7377fc0ad551bd60ae2fc69e69 sha
sha256:d7740f3a38e30e57e3b8cff816c27259bd80245cda73b001fe43841f7dda7379 parent
+33 ~3 symbols
sha256:d1459a4eb5b84ed77fece7d9c96427d1a89aef41e1a0e2f00f9584ac53d2b392 snapshot
+33
symbols added
~3
symbols modified
0
dead code introduced
Semantic Changes 36 symbols
~ lib/flow/flow-authoring.mjs .mjs 17 symbols added
+ absentFlowStateId function function absentFlowStateId L123–125
+ applyFlowProposalToIndex function function applyFlowProposalToIndex L507–509
+ buildExternalRef function function buildExternalRef L430–440
+ canonicalFlowForState function function canonicalFlowForState L55–70
+ canonicalStepForState function function canonicalStepForState L76–95
+ defaultMirrorPath function function defaultMirrorPath L201–204
+ deriveAutoApprovable function function deriveAutoApprovable L192–195
+ envTriState function function envTriState L128–132
+ flowStateId function function flowStateId L106–115
+ getFlowAuthoringForbidden function function getFlowAuthoringForbidden L178–182
+ getFlowAuthoringWritesEnabled function function getFlowAuthoringWritesEnabled L166–170
+ handleFlowProposeRequest function function handleFlowProposeRequest L278–421
+ precheckApprovedFlowProposal function function precheckApprovedFlowProposal L451–494
+ readFlowAuthoringPolicyFile function function readFlowAuthoringPolicyFile L138–156
+ refuse function function refuse L244–246
+ resolveWriteScopes function function resolveWriteScopes L223–237
+ unionScopes function function unionScopes L211–217
~ test/fixtures/flow/authoring-helpers.mjs .mjs 2 symbols added
+ emptyStarterDir function function emptyStarterDir L17–21
+ makeFlowBundle function function makeFlowBundle L34–86
~ test/flow-authoring-data-integrity.test.mjs .mjs 1 symbol added
+ approve function function approve L32–36
~ test/flow-authoring-e2e.test.mjs .mjs 1 symbol added
+ approveFlowProposal function function approveFlowProposal L32–39
~ test/flow-authoring-parity-integration.test.mjs .mjs 3 symbols added
+ freshDataDir function function freshDataDir L38–43
+ loadStarter function function loadStarter L25–27
+ stripVolatile function function stripVolatile L29–33
~ test/flow-authoring-performance.test.mjs .mjs 2 symbols added
+ bigFlow function function bigFlow L26–55
+ p95 function function p95 L57–60
~ test/flow-authoring-security.test.mjs .mjs 1 symbol added
+ approveAll function function approveAll L27–31
~ test/flow-authoring-stress.test.mjs .mjs 1 symbol added
+ bigFlow function function bigFlow L33–70
~ test/flow-authoring-unit.test.mjs .mjs 1 symbol added
+ loadStarter function function loadStarter L29–31
~ cli/index.mjs .mjs 1 symbol modified
~ main
~ docs/openapi.yaml .yaml
~ hub/proposals-store.mjs .mjs 1 symbol modified
~ createProposal
~ hub/server.mjs .mjs 1 symbol added
+ runFlowPropose function function runFlowPropose L1008–1037
~ lib/flow/flow-scope.mjs .mjs 1 symbol added
+ resolveFlowWriteAuthority function function resolveFlowWriteAuthority L119–132
~ lib/flow/flow-store.mjs .mjs 2 symbols added
+ latestStoredFlow function function latestStoredFlow L568–582
+ upsertFlowVersion function function upsertFlowVersion L603–625
~ mcp/tools/flow.mjs .mjs 1 symbol modified
~ registerFlowTools
Older docs(flow): 7A-L1a authoring write-back contract (canonical) sha256:d7740f3a38e30e57e3b8cff816c27259bd80245cda73b001fe43841f7dda7379 All commits Newer docs(flow): freeze external-agent gate contract (7A-L2a) sha256:942476bd56572cb1ff995ab405afecd751e616ee014b01f475b640a5f32bc2ca

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:ddc893a78f664ab720f61c08635ba698634b3d7377fc0ad551bd60ae2fc69e69 --body "your comment"