grounder 0.3.0 → 0.5.0

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.
Files changed (146) hide show
  1. package/README.md +157 -215
  2. package/dist/agents/claude.d.ts.map +1 -1
  3. package/dist/agents/claude.js +3 -3
  4. package/dist/agents/claude.js.map +1 -1
  5. package/dist/agents/cursor.d.ts.map +1 -1
  6. package/dist/agents/cursor.js +3 -3
  7. package/dist/agents/cursor.js.map +1 -1
  8. package/dist/agents/hook-runtime.d.ts +3 -3
  9. package/dist/agents/hook-runtime.js +4 -4
  10. package/dist/agents/hook-runtime.js.map +1 -1
  11. package/dist/agents/install-command.d.ts +0 -2
  12. package/dist/agents/install-command.d.ts.map +1 -1
  13. package/dist/agents/install-command.js.map +1 -1
  14. package/dist/cli.js +15 -10
  15. package/dist/cli.js.map +1 -1
  16. package/dist/commands/apply-agent-installs.d.ts +2 -2
  17. package/dist/commands/apply-agent-installs.d.ts.map +1 -1
  18. package/dist/commands/apply-agent-installs.js +1 -1
  19. package/dist/commands/doctor.d.ts.map +1 -1
  20. package/dist/commands/doctor.js +120 -50
  21. package/dist/commands/doctor.js.map +1 -1
  22. package/dist/commands/handoff/list.d.ts +27 -9
  23. package/dist/commands/handoff/list.d.ts.map +1 -1
  24. package/dist/commands/handoff/list.js +31 -16
  25. package/dist/commands/handoff/list.js.map +1 -1
  26. package/dist/commands/handoff.d.ts +2 -0
  27. package/dist/commands/handoff.d.ts.map +1 -1
  28. package/dist/commands/handoff.js +10 -1
  29. package/dist/commands/handoff.js.map +1 -1
  30. package/dist/commands/link.d.ts +12 -0
  31. package/dist/commands/link.d.ts.map +1 -0
  32. package/dist/commands/{repo/init.js → link.js} +35 -27
  33. package/dist/commands/link.js.map +1 -0
  34. package/dist/commands/migrate.js +3 -5
  35. package/dist/commands/migrate.js.map +1 -1
  36. package/dist/commands/note/list.d.ts +36 -0
  37. package/dist/commands/note/list.d.ts.map +1 -0
  38. package/dist/commands/note/list.js +77 -0
  39. package/dist/commands/note/list.js.map +1 -0
  40. package/dist/commands/note.d.ts +2 -0
  41. package/dist/commands/note.d.ts.map +1 -1
  42. package/dist/commands/note.js +10 -1
  43. package/dist/commands/note.js.map +1 -1
  44. package/dist/commands/output.d.ts +47 -0
  45. package/dist/commands/output.d.ts.map +1 -0
  46. package/dist/commands/output.js +63 -0
  47. package/dist/commands/output.js.map +1 -0
  48. package/dist/commands/plan/list.d.ts +21 -5
  49. package/dist/commands/plan/list.d.ts.map +1 -1
  50. package/dist/commands/plan/list.js +24 -13
  51. package/dist/commands/plan/list.js.map +1 -1
  52. package/dist/commands/plan.d.ts +2 -0
  53. package/dist/commands/plan.d.ts.map +1 -1
  54. package/dist/commands/plan.js +12 -2
  55. package/dist/commands/plan.js.map +1 -1
  56. package/dist/commands/require-linked.js +2 -2
  57. package/dist/commands/require-linked.js.map +1 -1
  58. package/dist/commands/search.d.ts +23 -0
  59. package/dist/commands/search.d.ts.map +1 -0
  60. package/dist/commands/search.js +277 -0
  61. package/dist/commands/search.js.map +1 -0
  62. package/dist/commands/{vault/init.d.ts → setup.d.ts} +5 -4
  63. package/dist/commands/setup.d.ts.map +1 -0
  64. package/dist/commands/setup.js +137 -0
  65. package/dist/commands/setup.js.map +1 -0
  66. package/dist/commands/status.d.ts.map +1 -1
  67. package/dist/commands/status.js +39 -29
  68. package/dist/commands/status.js.map +1 -1
  69. package/dist/commands/upgrade-banner.d.ts +2 -2
  70. package/dist/commands/upgrade-banner.js +2 -2
  71. package/dist/connector/home.d.ts +12 -0
  72. package/dist/connector/home.d.ts.map +1 -1
  73. package/dist/connector/home.js +26 -2
  74. package/dist/connector/home.js.map +1 -1
  75. package/dist/connector/state.d.ts +4 -13
  76. package/dist/connector/state.d.ts.map +1 -1
  77. package/dist/connector/state.js +3 -21
  78. package/dist/connector/state.js.map +1 -1
  79. package/dist/connector/vault.d.ts +2 -0
  80. package/dist/connector/vault.d.ts.map +1 -1
  81. package/dist/connector/vault.js +6 -1
  82. package/dist/connector/vault.js.map +1 -1
  83. package/dist/help.d.ts +3 -3
  84. package/dist/help.d.ts.map +1 -1
  85. package/dist/help.js +80 -48
  86. package/dist/help.js.map +1 -1
  87. package/dist/util/frontmatter.d.ts +9 -7
  88. package/dist/util/frontmatter.d.ts.map +1 -1
  89. package/dist/util/frontmatter.js +29 -4
  90. package/dist/util/frontmatter.js.map +1 -1
  91. package/dist/util/parse-args.d.ts.map +1 -1
  92. package/dist/util/parse-args.js +11 -2
  93. package/dist/util/parse-args.js.map +1 -1
  94. package/dist/util/path.d.ts +23 -0
  95. package/dist/util/path.d.ts.map +1 -1
  96. package/dist/util/path.js +39 -0
  97. package/dist/util/path.js.map +1 -1
  98. package/dist/vault/list-handoffs.d.ts +3 -1
  99. package/dist/vault/list-handoffs.d.ts.map +1 -1
  100. package/dist/vault/list-handoffs.js +17 -15
  101. package/dist/vault/list-handoffs.js.map +1 -1
  102. package/dist/vault/list-markdown.d.ts +8 -0
  103. package/dist/vault/list-markdown.d.ts.map +1 -0
  104. package/dist/vault/list-markdown.js +35 -0
  105. package/dist/vault/list-markdown.js.map +1 -0
  106. package/dist/vault/list-notes.d.ts +15 -0
  107. package/dist/vault/list-notes.d.ts.map +1 -0
  108. package/dist/vault/list-notes.js +34 -0
  109. package/dist/vault/list-notes.js.map +1 -0
  110. package/dist/vault/list-plans.d.ts +2 -2
  111. package/dist/vault/list-plans.d.ts.map +1 -1
  112. package/dist/vault/list-plans.js +9 -19
  113. package/dist/vault/list-plans.js.map +1 -1
  114. package/dist/vault/search.d.ts +55 -0
  115. package/dist/vault/search.d.ts.map +1 -0
  116. package/dist/vault/search.js +328 -0
  117. package/dist/vault/search.js.map +1 -0
  118. package/dist/vault/write-handoff.d.ts +2 -0
  119. package/dist/vault/write-handoff.d.ts.map +1 -1
  120. package/dist/vault/write-handoff.js +5 -0
  121. package/dist/vault/write-handoff.js.map +1 -1
  122. package/dist/vault/write-note.d.ts +2 -0
  123. package/dist/vault/write-note.d.ts.map +1 -1
  124. package/dist/vault/write-note.js +9 -1
  125. package/dist/vault/write-note.js.map +1 -1
  126. package/dist/vault/write-plan.d.ts +4 -0
  127. package/dist/vault/write-plan.d.ts.map +1 -1
  128. package/dist/vault/write-plan.js +14 -1
  129. package/dist/vault/write-plan.js.map +1 -1
  130. package/package.json +13 -4
  131. package/templates/agents/claude/commands/grounder-note.md +30 -4
  132. package/templates/agents/claude/commands/grounder-plan.md +23 -17
  133. package/templates/agents/claude/commands/grounder-search.md +144 -0
  134. package/templates/agents/claude/commands/grounder-task-handoff.md +5 -1
  135. package/templates/agents/claude/commands/grounder-task.md +4 -2
  136. package/templates/agents/cursor/commands/grounder-note.md +31 -5
  137. package/templates/agents/cursor/commands/grounder-plan.md +24 -18
  138. package/templates/agents/cursor/commands/grounder-search.md +144 -0
  139. package/templates/agents/cursor/commands/grounder-task-handoff.md +6 -2
  140. package/templates/agents/cursor/commands/grounder-task.md +5 -3
  141. package/dist/commands/repo/init.d.ts +0 -11
  142. package/dist/commands/repo/init.d.ts.map +0 -1
  143. package/dist/commands/repo/init.js.map +0 -1
  144. package/dist/commands/vault/init.d.ts.map +0 -1
  145. package/dist/commands/vault/init.js +0 -90
  146. package/dist/commands/vault/init.js.map +0 -1
@@ -1,90 +0,0 @@
1
- import { mkdir } from "node:fs/promises";
2
- import { runtimeCliPath } from "../../agents/hook-runtime.js";
3
- import { resolveAgents } from "../../agents/index.js";
4
- import { homeConfigPath, readHomeConfig, withHomeDir, writeHomeConfig, } from "../../connector/home.js";
5
- import { helpExitCode } from "../../help.js";
6
- import { flagBool, flagStrings, parseArgs } from "../../util/parse-args.js";
7
- import { resolveUserPath } from "../../util/path.js";
8
- import { confirm } from "../../util/prompt.js";
9
- import { projectsParent } from "../../vault/layout.js";
10
- import { applyAgentInstalls } from "../apply-agent-installs.js";
11
- export async function runVaultInit(argv) {
12
- const helpCode = helpExitCode(argv, "vault init");
13
- if (helpCode !== null) {
14
- return helpCode;
15
- }
16
- const { positional, flags, repeated } = parseArgs(argv);
17
- const vaultPathArg = positional[0];
18
- const yes = flagBool(flags, "yes", "y");
19
- const force = flagBool(flags, "force", "f");
20
- const hooks = flagBool(flags, "hooks");
21
- const agents = flagStrings(repeated, "agent");
22
- if (!vaultPathArg) {
23
- process.stderr.write("Usage: grounder vault init <path>\n");
24
- return 1;
25
- }
26
- return runVaultInitWithOptions({
27
- vaultPath: vaultPathArg,
28
- yes,
29
- force,
30
- hooks,
31
- agents: agents.length > 0 ? agents : undefined,
32
- });
33
- }
34
- export async function runVaultInitWithOptions(options) {
35
- return withHomeDir(options.homeDir, async () => {
36
- const vaultRoot = resolveUserPath(options.vaultPath);
37
- const yes = options.yes ?? false;
38
- const force = options.force ?? false;
39
- const hooks = options.hooks ?? false;
40
- const homeDir = options.homeDir;
41
- const existingHome = await readHomeConfig();
42
- const projectsDir = projectsParent(vaultRoot);
43
- const agents = await resolveAgents(options.agents);
44
- if (existingHome && existingHome.vaultRoot !== vaultRoot && !force) {
45
- process.stderr.write(`Home config already exists with vault ${existingHome.vaultRoot}. Use --force to overwrite.\n`);
46
- return 1;
47
- }
48
- process.stdout.write(`Vault root: ${vaultRoot}\n`);
49
- process.stdout.write("Will write:\n");
50
- process.stdout.write(` home ${homeConfigPath(homeDir)}\n`);
51
- process.stdout.write(" vault 10-Projects/ (if missing)\n");
52
- if (agents.length > 0) {
53
- // Shared across agents (slash commands + optional hooks) — list once.
54
- process.stdout.write(` grounder runtime ${runtimeCliPath(homeDir)}\n`);
55
- }
56
- for (const agent of agents) {
57
- for (const artifactPath of agent.expectedArtifacts(homeDir)) {
58
- process.stdout.write(` ${agent.id.padEnd(8)} ${artifactPath}\n`);
59
- }
60
- if (hooks && agent.expectedHookArtifacts) {
61
- for (const hookPath of agent.expectedHookArtifacts(homeDir)) {
62
- process.stdout.write(` ${agent.id.padEnd(8)} hook ${hookPath}\n`);
63
- }
64
- }
65
- }
66
- if (agents.length === 0) {
67
- process.stdout.write(" (no supported agents detected — skipping agent artifacts)\n");
68
- }
69
- process.stdout.write("\n");
70
- if (!yes) {
71
- const proceed = await confirm("Proceed?");
72
- if (!proceed) {
73
- process.stdout.write("Aborted.\n");
74
- return 0;
75
- }
76
- }
77
- await writeHomeConfig({ vaultRoot });
78
- await mkdir(projectsDir, { recursive: true });
79
- process.stdout.write("✓ Wrote home config\n");
80
- process.stdout.write(`✓ Vault scaffold: ${projectsDir}\n`);
81
- await applyAgentInstalls({
82
- agents,
83
- force,
84
- hooks,
85
- homeDir,
86
- });
87
- return 0;
88
- });
89
- }
90
- //# sourceMappingURL=init.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/commands/vault/init.ts"],"names":[],"mappings":"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"}