flow_session_to_flow.json json
89 lines 4.1 KB
Raw
sha256:e4c529f14a0bb908c1caaaeb3f95f3623a1a82e636e7e3722ca2cd3dc9821263 security: npm audit fix pre-bridge 2026-07-29 Human 39 days ago
1 {
2 "flow": {
3 "schema": "knowtation.flow/v0",
4 "flow_id": "flow_session_to_flow",
5 "title": "Session-to-Flow review",
6 "version": "0.1.0",
7 "scope": "personal",
8 "summary": "At the end of a substantial session, check for a recurring procedure and emit a Flow candidate proposal \u2014 never an auto-Flow.",
9 "tags": ["agent-ops", "flywheel", "capture"],
10 "steps": [
11 "flow_session_to_flow#1",
12 "flow_session_to_flow#2"
13 ],
14 "inputs": [],
15 "vault_mirror_path": "meta/flows/session-to-flow.md",
16 "updated": "2026-06-20T00:00:00Z",
17 "truncated": false
18 },
19 "steps": [
20 {
21 "schema": "knowtation.flow_step/v0",
22 "step_id": "flow_session_to_flow#1",
23 "flow_id": "flow_session_to_flow",
24 "ordinal": 1,
25 "owned_job": "Detect whether this session re-derived a recurring, non-obvious procedure worth saving.",
26 "instruction": "Review the session for a repeated ordered step/skill-ref sequence using bounded structural signals only, and decide if a candidate clears the quality bar.",
27 "trigger": "Run at the end of a substantial session with the user's opt-in extraction enabled.",
28 "when_not_to_run": "Skip if extraction is opted out, classroom/minor policy disables capture, the procedure recurred fewer than the threshold sessions, or confidence is low.",
29 "requires": [
30 { "kind": "vault_scope", "id": "personal" }
31 ],
32 "boundaries": [
33 "Content-minimized \u2014 observe ids, hashes, and counts only; never raw prompts, completions, or note bodies",
34 "Suppress low-confidence candidates and cap candidates per session",
35 "Do not widen the inferred scope"
36 ],
37 "skill_refs": [
38 { "kind": "mcp_prompt", "id": "resume-session" }
39 ],
40 "inputs": [],
41 "outputs": [
42 { "name": "signal_summary", "type": "text" }
43 ],
44 "output_shape": "A bounded signal summary (trigger_signal, observed_count, scope_hint, confidence) \u2014 or an explicit 'no candidate'.",
45 "verification": {
46 "kind": "artifact_exists",
47 "evidence_required": true,
48 "description": "A bounded signal summary exists recording the trigger_signal, observed_count, and confidence (or an explicit no-candidate result)."
49 },
50 "automatable": "agent_assisted"
51 },
52 {
53 "schema": "knowtation.flow_step/v0",
54 "step_id": "flow_session_to_flow#2",
55 "flow_id": "flow_session_to_flow",
56 "ordinal": 2,
57 "owned_job": "Emit a Flow candidate as a proposal for the user to approve, edit, or reject.",
58 "instruction": "Produce a knowtation.flow_candidate/v0 proposal with pointer-only evidence and route it to the review tray; never promote it to a Flow.",
59 "trigger": "Run only when step 1 produced a candidate at or above the confidence threshold.",
60 "when_not_to_run": "Skip when step 1 returned 'no candidate', or the candidate duplicates an existing Flow above the dedup overlap threshold (offer merge instead).",
61 "requires": [
62 { "kind": "vault_scope", "id": "personal" },
63 { "kind": "tool", "id": "knowtation_cli" }
64 ],
65 "boundaries": [
66 "Never auto-promote a candidate to a Flow \u2014 review-before-write is mandatory",
67 "Evidence refs are pointers only (run ids, hashes) \u2014 no raw content",
68 "Candidate title and draft steps are untrusted text",
69 "Scope is inferred then user-confirmed, never silently widened"
70 ],
71 "skill_refs": [
72 { "kind": "cli", "id": "knowtation propose <candidate_path> --intent flow_candidate --source agent" }
73 ],
74 "inputs": [
75 { "name": "signal_summary", "from": "flow_session_to_flow#1.outputs.signal_summary" }
76 ],
77 "outputs": [
78 { "name": "candidate_proposal_ref", "type": "string" }
79 ],
80 "output_shape": "A pending flow_candidate/v0 proposal in the review tray with status pending_review.",
81 "verification": {
82 "kind": "human_review",
83 "evidence_required": true,
84 "description": "The candidate is recorded as a proposal pending review and is never auto-promoted; the user approves, edits, or rejects it."
85 },
86 "automatable": "manual"
87 }
88 ]
89 }
File History 4 commits
sha256:e4c529f14a0bb908c1caaaeb3f95f3623a1a82e636e7e3722ca2cd3dc9821263 security: npm audit fix pre-bridge 2026-07-29 Human 39 days ago
sha256:b5f647cb9c409f563d4671fe3fc05ddea01fabfed9b41fc11cb923588e1c1baf mirror: GitHub Phase A durable MCP OAuth (#270) Human minor 55 days ago
sha256:873e30b7fafe601346295f8f4289f388f21d8f715f28584d5481899ba2b714fc Merge pull request #249 from aaronrene/muse-mirror Agent 72 days ago
sha256:d8c648b20a4d53b2673c5c082ee7edfa7b2fc9b11080832da1f38807b6bf940b fix(7C-L1b): route hosted delegation proposals through cani… Human minor 75 days ago