@kentwynn/kgraph 0.2.34 → 0.2.35
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.
|
@@ -2,6 +2,25 @@
|
|
|
2
2
|
* Shared KGraph workflow step strings used across all AI tool adapters.
|
|
3
3
|
* Update here once instead of in each adapter file.
|
|
4
4
|
*/
|
|
5
|
+
const DECISION_CONTEXT = `## Feature intent — choose based on the situation
|
|
6
|
+
|
|
7
|
+
**Sessions** exist to preserve the journey when exploration, evaluation, or multi-step reasoning produced knowledge that the outcome alone cannot capture. The path matters when a future agent might face the same fork.
|
|
8
|
+
|
|
9
|
+
**Inbox notes** exist for structured multi-section knowledge that cannot fit a single --capture sentence. Architecture decisions with rationale, multi-file change summaries with interconnections, or design tradeoffs with rejected alternatives.
|
|
10
|
+
|
|
11
|
+
**--capture / conclude** exists for atomic durable conclusions — one sentence, evidence-linked. Prefer this for most captures.
|
|
12
|
+
|
|
13
|
+
**--domain and --tag** exist so future queries find knowledge by area, not just by word match. Add them when the knowledge clearly belongs to an identifiable architectural boundary.
|
|
14
|
+
|
|
15
|
+
**knowledge supersede** exists to evolve knowledge without duplicating. When new understanding contradicts or refines an existing atom, supersede it.
|
|
16
|
+
|
|
17
|
+
**stale** exists to surface atoms whose evidence no longer holds. Consider it after your edits touched code that pack showed as atom-referenced.
|
|
18
|
+
|
|
19
|
+
**impact** exists to reveal blast radius. Consider it before destructive changes to public interfaces — renames, deletions, signature changes.
|
|
20
|
+
|
|
21
|
+
**compact** exists to merge redundant knowledge. Consider it when you store something that feels overlapping with what pack already showed.
|
|
22
|
+
|
|
23
|
+
**scan** exists to refresh maps after structural changes. The root workflow handles this automatically unless you created, deleted, or renamed many files outside of kgraph commands.`;
|
|
5
24
|
const DOCTOR_STEP = `Run \`kgraph doctor\` when setup, maps, inbox processing, or integrations look wrong. Run \`kgraph doctor --quality\` when context shows stale/noisy cognition references.`;
|
|
6
25
|
const IMPACT_STEP = `Run \`kgraph impact "<file-or-symbol>"\` when the user asks what a change may affect. Run \`kgraph history "<topic>"\` when prior work or decisions matter.`;
|
|
7
26
|
const REPAIR_STEP = `Run \`kgraph repair --dry-run\` before cleanup when stale/noisy atom refs need fixing. Run \`kgraph repair\` only when the user asks to apply that cleanup.`;
|
|
@@ -42,7 +61,9 @@ export function numberedWorkflow(agentName, options = {}) {
|
|
|
42
61
|
13. ${REPAIR_STEP}
|
|
43
62
|
14. ${COMPACT_STEP}
|
|
44
63
|
15. Run \`kgraph visualize\` when the user wants to inspect the dependency graph — opens an interactive graph locally with PNG export.
|
|
45
|
-
16. ${HISTORY_STEP}
|
|
64
|
+
16. ${HISTORY_STEP}
|
|
65
|
+
|
|
66
|
+
${DECISION_CONTEXT}`;
|
|
46
67
|
}
|
|
47
68
|
/**
|
|
48
69
|
* Returns the bullet-list workflow for rules files.
|
|
@@ -64,5 +85,7 @@ export function bulletWorkflow(agentName, options = {}) {
|
|
|
64
85
|
- ${REPAIR_STEP}
|
|
65
86
|
- ${COMPACT_STEP}
|
|
66
87
|
- Run \`kgraph visualize\` to open the interactive dependency graph locally with PNG export.
|
|
67
|
-
- ${HISTORY_STEP}
|
|
88
|
+
- ${HISTORY_STEP}
|
|
89
|
+
|
|
90
|
+
${DECISION_CONTEXT}`;
|
|
68
91
|
}
|