agent-rulebook 0.1.6 → 0.2.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 (284) hide show
  1. package/README.md +54 -138
  2. package/dist/commands/index.js +11 -10
  3. package/dist/commands/index.js.map +1 -1
  4. package/dist/commands/init.js +3 -6
  5. package/dist/commands/init.js.map +1 -1
  6. package/dist/commands/output.d.ts +0 -5
  7. package/dist/commands/output.js +0 -47
  8. package/dist/commands/output.js.map +1 -1
  9. package/dist/commands/project.d.ts +2 -0
  10. package/dist/commands/project.js +33 -0
  11. package/dist/commands/project.js.map +1 -0
  12. package/dist/commands/resolution.d.ts +2 -0
  13. package/dist/commands/resolution.js +32 -0
  14. package/dist/commands/resolution.js.map +1 -0
  15. package/dist/commands/sync.d.ts +6 -3
  16. package/dist/commands/sync.js +130 -177
  17. package/dist/commands/sync.js.map +1 -1
  18. package/dist/core/attempt-outcome.d.ts +21 -0
  19. package/dist/core/attempt-outcome.js +61 -0
  20. package/dist/core/attempt-outcome.js.map +1 -0
  21. package/dist/core/change-policy.d.ts +7 -0
  22. package/dist/core/change-policy.js +14 -0
  23. package/dist/core/change-policy.js.map +1 -0
  24. package/dist/core/index.d.ts +34 -31
  25. package/dist/core/index.js +18 -13
  26. package/dist/core/index.js.map +1 -1
  27. package/dist/core/outcome-schema.d.ts +55 -0
  28. package/dist/core/outcome-schema.js +44 -0
  29. package/dist/core/outcome-schema.js.map +1 -0
  30. package/dist/core/problem-fingerprint.d.ts +4 -0
  31. package/dist/core/problem-fingerprint.js +37 -0
  32. package/dist/core/problem-fingerprint.js.map +1 -0
  33. package/dist/core/problem-schema.d.ts +34 -0
  34. package/dist/core/problem-schema.js +37 -0
  35. package/dist/core/problem-schema.js.map +1 -0
  36. package/dist/core/project-environment-detector.d.ts +2 -2
  37. package/dist/core/project-environment-detector.js +8 -52
  38. package/dist/core/project-environment-detector.js.map +1 -1
  39. package/dist/core/project-file-scan.d.ts +17 -0
  40. package/dist/core/project-file-scan.js +73 -0
  41. package/dist/core/project-file-scan.js.map +1 -0
  42. package/dist/core/project-registry.d.ts +8 -0
  43. package/dist/core/project-registry.js +38 -0
  44. package/dist/core/project-registry.js.map +1 -0
  45. package/dist/core/repository-identity.d.ts +7 -0
  46. package/dist/core/repository-identity.js +27 -0
  47. package/dist/core/repository-identity.js.map +1 -0
  48. package/dist/core/resolution-applicability.d.ts +20 -0
  49. package/dist/core/resolution-applicability.js +38 -0
  50. package/dist/core/resolution-applicability.js.map +1 -0
  51. package/dist/core/resolution-parser.d.ts +20 -0
  52. package/dist/core/resolution-parser.js +47 -0
  53. package/dist/core/resolution-parser.js.map +1 -0
  54. package/dist/core/resolution-ranker.d.ts +34 -0
  55. package/dist/core/resolution-ranker.js +40 -0
  56. package/dist/core/resolution-ranker.js.map +1 -0
  57. package/dist/core/resolution-relation.d.ts +14 -0
  58. package/dist/core/resolution-relation.js +29 -0
  59. package/dist/core/resolution-relation.js.map +1 -0
  60. package/dist/core/resolution-schema.d.ts +109 -0
  61. package/dist/core/resolution-schema.js +29 -0
  62. package/dist/core/resolution-schema.js.map +1 -0
  63. package/dist/core/resolution-search-types.d.ts +37 -0
  64. package/dist/core/resolution-search-types.js +2 -0
  65. package/dist/core/resolution-search-types.js.map +1 -0
  66. package/dist/core/resolution-semantic-checksum.d.ts +12 -0
  67. package/dist/core/resolution-semantic-checksum.js +24 -0
  68. package/dist/core/resolution-semantic-checksum.js.map +1 -0
  69. package/dist/core/resolution-writer.d.ts +7 -0
  70. package/dist/core/resolution-writer.js +33 -0
  71. package/dist/core/resolution-writer.js.map +1 -0
  72. package/dist/core/solution-schema.d.ts +42 -0
  73. package/dist/core/solution-schema.js +28 -0
  74. package/dist/core/solution-schema.js.map +1 -0
  75. package/dist/core/source-evidence-schema.d.ts +26 -0
  76. package/dist/core/source-evidence-schema.js +29 -0
  77. package/dist/core/source-evidence-schema.js.map +1 -0
  78. package/dist/core/source-evidence.d.ts +14 -0
  79. package/dist/core/source-evidence.js +69 -0
  80. package/dist/core/source-evidence.js.map +1 -0
  81. package/dist/core/stack-detector.d.ts +2 -2
  82. package/dist/core/stack-detector.js +11 -63
  83. package/dist/core/stack-detector.js.map +1 -1
  84. package/dist/index.d.ts +3 -4
  85. package/dist/index.js +2 -2
  86. package/dist/index.js.map +1 -1
  87. package/dist/mcp/index.d.ts +3 -3
  88. package/dist/mcp/index.js +2 -2
  89. package/dist/mcp/index.js.map +1 -1
  90. package/dist/mcp/resolution-change.d.ts +19 -0
  91. package/dist/mcp/resolution-change.js +136 -0
  92. package/dist/mcp/resolution-change.js.map +1 -0
  93. package/dist/mcp/resolutions-commit-change-tool.d.ts +5 -0
  94. package/dist/mcp/resolutions-commit-change-tool.js +21 -0
  95. package/dist/mcp/resolutions-commit-change-tool.js.map +1 -0
  96. package/dist/mcp/resolutions-find-tool.d.ts +5 -0
  97. package/dist/mcp/resolutions-find-tool.js +75 -0
  98. package/dist/mcp/resolutions-find-tool.js.map +1 -0
  99. package/dist/mcp/resolutions-get-source-tool.d.ts +5 -0
  100. package/dist/mcp/resolutions-get-source-tool.js +30 -0
  101. package/dist/mcp/resolutions-get-source-tool.js.map +1 -0
  102. package/dist/mcp/resolutions-get-tool.d.ts +5 -0
  103. package/dist/mcp/resolutions-get-tool.js +27 -0
  104. package/dist/mcp/resolutions-get-tool.js.map +1 -0
  105. package/dist/mcp/resolutions-list-facets-tool.d.ts +4 -0
  106. package/dist/mcp/resolutions-list-facets-tool.js +18 -0
  107. package/dist/mcp/resolutions-list-facets-tool.js.map +1 -0
  108. package/dist/mcp/resolutions-prepare-change-tool.d.ts +5 -0
  109. package/dist/mcp/resolutions-prepare-change-tool.js +7 -0
  110. package/dist/mcp/resolutions-prepare-change-tool.js.map +1 -0
  111. package/dist/mcp/resolutions-report-attempt-tool.d.ts +5 -0
  112. package/dist/mcp/resolutions-report-attempt-tool.js +87 -0
  113. package/dist/mcp/resolutions-report-attempt-tool.js.map +1 -0
  114. package/dist/mcp/schemas.d.ts +265 -197
  115. package/dist/mcp/schemas.js +28 -93
  116. package/dist/mcp/schemas.js.map +1 -1
  117. package/dist/mcp/tool-output.d.ts +0 -34
  118. package/dist/mcp/tool-output.js +2 -71
  119. package/dist/mcp/tool-output.js.map +1 -1
  120. package/dist/mcp/tools.d.ts +973 -204
  121. package/dist/mcp/tools.js +47 -101
  122. package/dist/mcp/tools.js.map +1 -1
  123. package/dist/program.js +5 -9
  124. package/dist/program.js.map +1 -1
  125. package/dist/storage/index.d.ts +10 -15
  126. package/dist/storage/index.js +8 -8
  127. package/dist/storage/index.js.map +1 -1
  128. package/dist/storage/project-code-index-source.d.ts +2 -0
  129. package/dist/storage/project-code-index-source.js +23 -0
  130. package/dist/storage/project-code-index-source.js.map +1 -0
  131. package/dist/storage/resolution-candidate-service.d.ts +6 -0
  132. package/dist/storage/resolution-candidate-service.js +94 -0
  133. package/dist/storage/resolution-candidate-service.js.map +1 -0
  134. package/dist/storage/resolution-change-transaction.d.ts +11 -0
  135. package/dist/storage/resolution-change-transaction.js +56 -0
  136. package/dist/storage/resolution-change-transaction.js.map +1 -0
  137. package/dist/storage/resolution-home.d.ts +20 -0
  138. package/dist/storage/resolution-home.js +59 -0
  139. package/dist/storage/resolution-home.js.map +1 -0
  140. package/dist/storage/resolution-index-check.d.ts +28 -0
  141. package/dist/storage/resolution-index-check.js +30 -0
  142. package/dist/storage/resolution-index-check.js.map +1 -0
  143. package/dist/storage/resolution-indexer.d.ts +19 -0
  144. package/dist/storage/resolution-indexer.js +158 -0
  145. package/dist/storage/resolution-indexer.js.map +1 -0
  146. package/dist/storage/resolution-migrations.d.ts +3 -0
  147. package/dist/storage/resolution-migrations.js +39 -0
  148. package/dist/storage/resolution-migrations.js.map +1 -0
  149. package/package.json +5 -3
  150. package/dist/commands/add.d.ts +0 -2
  151. package/dist/commands/add.js +0 -134
  152. package/dist/commands/add.js.map +0 -1
  153. package/dist/commands/migrate.d.ts +0 -2
  154. package/dist/commands/migrate.js +0 -73
  155. package/dist/commands/migrate.js.map +0 -1
  156. package/dist/commands/rule.d.ts +0 -23
  157. package/dist/commands/rule.js +0 -158
  158. package/dist/commands/rule.js.map +0 -1
  159. package/dist/commands/search.d.ts +0 -2
  160. package/dist/commands/search.js +0 -57
  161. package/dist/commands/search.js.map +0 -1
  162. package/dist/core/compatibility-matcher.d.ts +0 -17
  163. package/dist/core/compatibility-matcher.js +0 -146
  164. package/dist/core/compatibility-matcher.js.map +0 -1
  165. package/dist/core/dedup.d.ts +0 -22
  166. package/dist/core/dedup.js +0 -54
  167. package/dist/core/dedup.js.map +0 -1
  168. package/dist/core/error-signature.d.ts +0 -15
  169. package/dist/core/error-signature.js +0 -59
  170. package/dist/core/error-signature.js.map +0 -1
  171. package/dist/core/facets.d.ts +0 -9
  172. package/dist/core/facets.js +0 -46
  173. package/dist/core/facets.js.map +0 -1
  174. package/dist/core/lesson-importer.d.ts +0 -22
  175. package/dist/core/lesson-importer.js +0 -94
  176. package/dist/core/lesson-importer.js.map +0 -1
  177. package/dist/core/ranker.d.ts +0 -3
  178. package/dist/core/ranker.js +0 -83
  179. package/dist/core/ranker.js.map +0 -1
  180. package/dist/core/rule-compatibility.d.ts +0 -66
  181. package/dist/core/rule-compatibility.js +0 -53
  182. package/dist/core/rule-compatibility.js.map +0 -1
  183. package/dist/core/rule-parser.d.ts +0 -25
  184. package/dist/core/rule-parser.js +0 -81
  185. package/dist/core/rule-parser.js.map +0 -1
  186. package/dist/core/rule-schema.d.ts +0 -265
  187. package/dist/core/rule-schema.js +0 -202
  188. package/dist/core/rule-schema.js.map +0 -1
  189. package/dist/core/rule-writer.d.ts +0 -35
  190. package/dist/core/rule-writer.js +0 -63
  191. package/dist/core/rule-writer.js.map +0 -1
  192. package/dist/core/search-types.d.ts +0 -57
  193. package/dist/core/search-types.js +0 -2
  194. package/dist/core/search-types.js.map +0 -1
  195. package/dist/core/semantic-checksum.d.ts +0 -6
  196. package/dist/core/semantic-checksum.js +0 -34
  197. package/dist/core/semantic-checksum.js.map +0 -1
  198. package/dist/core/slug.d.ts +0 -13
  199. package/dist/core/slug.js +0 -42
  200. package/dist/core/slug.js.map +0 -1
  201. package/dist/mcp/lesson-capture.d.ts +0 -30
  202. package/dist/mcp/lesson-capture.js +0 -144
  203. package/dist/mcp/lesson-capture.js.map +0 -1
  204. package/dist/mcp/rules-add-lesson-tool.d.ts +0 -4
  205. package/dist/mcp/rules-add-lesson-tool.js +0 -73
  206. package/dist/mcp/rules-add-lesson-tool.js.map +0 -1
  207. package/dist/mcp/rules-dedup-lesson-tool.d.ts +0 -4
  208. package/dist/mcp/rules-dedup-lesson-tool.js +0 -69
  209. package/dist/mcp/rules-dedup-lesson-tool.js.map +0 -1
  210. package/dist/mcp/rules-list-facets-tool.d.ts +0 -3
  211. package/dist/mcp/rules-list-facets-tool.js +0 -31
  212. package/dist/mcp/rules-list-facets-tool.js.map +0 -1
  213. package/dist/mcp/rules-prepare-lesson-tool.d.ts +0 -4
  214. package/dist/mcp/rules-prepare-lesson-tool.js +0 -7
  215. package/dist/mcp/rules-prepare-lesson-tool.js.map +0 -1
  216. package/dist/mcp/rules-search-error-tool.d.ts +0 -4
  217. package/dist/mcp/rules-search-error-tool.js +0 -103
  218. package/dist/mcp/rules-search-error-tool.js.map +0 -1
  219. package/dist/mcp/rules-search-for-project-tool.d.ts +0 -4
  220. package/dist/mcp/rules-search-for-project-tool.js +0 -105
  221. package/dist/mcp/rules-search-for-project-tool.js.map +0 -1
  222. package/dist/mcp/rules-search-tool.d.ts +0 -7
  223. package/dist/mcp/rules-search-tool.js +0 -65
  224. package/dist/mcp/rules-search-tool.js.map +0 -1
  225. package/dist/migration/adapters/fenced-lessons.d.ts +0 -2
  226. package/dist/migration/adapters/fenced-lessons.js +0 -55
  227. package/dist/migration/adapters/fenced-lessons.js.map +0 -1
  228. package/dist/migration/adapters/global-rules.d.ts +0 -2
  229. package/dist/migration/adapters/global-rules.js +0 -72
  230. package/dist/migration/adapters/global-rules.js.map +0 -1
  231. package/dist/migration/adapters/index.d.ts +0 -2
  232. package/dist/migration/adapters/index.js +0 -13
  233. package/dist/migration/adapters/index.js.map +0 -1
  234. package/dist/migration/adapters/markdown-lessons.d.ts +0 -2
  235. package/dist/migration/adapters/markdown-lessons.js +0 -36
  236. package/dist/migration/adapters/markdown-lessons.js.map +0 -1
  237. package/dist/migration/adapters/structured-lessons.d.ts +0 -2
  238. package/dist/migration/adapters/structured-lessons.js +0 -8
  239. package/dist/migration/adapters/structured-lessons.js.map +0 -1
  240. package/dist/migration/adapters/structured-shared.d.ts +0 -3
  241. package/dist/migration/adapters/structured-shared.js +0 -97
  242. package/dist/migration/adapters/structured-shared.js.map +0 -1
  243. package/dist/migration/applier.d.ts +0 -32
  244. package/dist/migration/applier.js +0 -559
  245. package/dist/migration/applier.js.map +0 -1
  246. package/dist/migration/index.d.ts +0 -11
  247. package/dist/migration/index.js +0 -7
  248. package/dist/migration/index.js.map +0 -1
  249. package/dist/migration/manifest.d.ts +0 -263
  250. package/dist/migration/manifest.js +0 -91
  251. package/dist/migration/manifest.js.map +0 -1
  252. package/dist/migration/migration-report.d.ts +0 -151
  253. package/dist/migration/migration-report.js +0 -85
  254. package/dist/migration/migration-report.js.map +0 -1
  255. package/dist/migration/scanner.d.ts +0 -2
  256. package/dist/migration/scanner.js +0 -312
  257. package/dist/migration/scanner.js.map +0 -1
  258. package/dist/migration/source-adapter.d.ts +0 -37
  259. package/dist/migration/source-adapter.js +0 -2
  260. package/dist/migration/source-adapter.js.map +0 -1
  261. package/dist/migration/verifier.d.ts +0 -5
  262. package/dist/migration/verifier.js +0 -218
  263. package/dist/migration/verifier.js.map +0 -1
  264. package/dist/storage/index-check.d.ts +0 -21
  265. package/dist/storage/index-check.js +0 -136
  266. package/dist/storage/index-check.js.map +0 -1
  267. package/dist/storage/indexer.d.ts +0 -19
  268. package/dist/storage/indexer.js +0 -367
  269. package/dist/storage/indexer.js.map +0 -1
  270. package/dist/storage/migrations.d.ts +0 -3
  271. package/dist/storage/migrations.js +0 -126
  272. package/dist/storage/migrations.js.map +0 -1
  273. package/dist/storage/rule-discovery.d.ts +0 -4
  274. package/dist/storage/rule-discovery.js +0 -34
  275. package/dist/storage/rule-discovery.js.map +0 -1
  276. package/dist/storage/rule-store.d.ts +0 -10
  277. package/dist/storage/rule-store.js +0 -12
  278. package/dist/storage/rule-store.js.map +0 -1
  279. package/dist/storage/rulebook-home.d.ts +0 -21
  280. package/dist/storage/rulebook-home.js +0 -78
  281. package/dist/storage/rulebook-home.js.map +0 -1
  282. package/dist/storage/search-service.d.ts +0 -17
  283. package/dist/storage/search-service.js +0 -275
  284. package/dist/storage/search-service.js.map +0 -1
package/README.md CHANGED
@@ -1,185 +1,101 @@
1
1
  # Agent Rulebook
2
2
 
3
- TypeScript CLI and MCP foundation for managing reusable agent rules.
3
+ Agent Rulebook is a local-first Resolution Memory for coding agents. It stores observed problems, immutable solution revisions, context-scoped outcomes, and exact source-evidence locators as portable YAML. A derived SQLite index provides retrieval; machine-local project paths never enter canonical data.
4
4
 
5
- ## Requirements
6
-
7
- The packaged `0.1.6` artifact supports Node.js 20 and 22 through 26. Node.js 21
8
- is excluded because the pinned `better-sqlite3@12.11.1` native runtime does not
9
- declare support for it. The first supported platform is Darwin arm64, where the
10
- local tarball matrix covers Node.js 20 and 22 through 26. Windows x64 is currently
11
- unverified and unsupported; its native acceptance matrix is required before any
12
- Windows or cross-platform support claim, but it does not block the Darwin-only rollout.
13
-
14
- Agent Rulebook keeps rule YAML and its rebuildable SQLite index outside the npm
15
- package in `~/.agent-rulebook` by default. Reinstalling the package or clearing
16
- the npm cache must not remove that data.
17
-
18
- ## Run the CLI
19
-
20
- Run the published immutable version without a global install:
5
+ ## Install and initialize
21
6
 
22
7
  ```bash
23
- npx -y agent-rulebook@0.1.6 --help
24
- npx -y agent-rulebook@0.1.6 mcp
8
+ npm install -g agent-rulebook
9
+ npx -y agent-rulebook@0.2.0 --help
10
+ npx -y agent-rulebook@0.2.0 mcp
11
+ agent-rulebook init
12
+ agent-rulebook index rebuild
25
13
  ```
26
14
 
27
- `agent-rulebook@0.1.6` is an immutable package version. Production
28
- configuration should pin this exact version. Registry tags such as `latest` are
29
- mutable and are not asserted by this artifact.
30
-
31
- The `0.1.6` release allows ordinary `mistake` and `fix` prose up to 2,000
32
- characters while reserving the long-log-line warning for `error_signature` lines
33
- over 2,000 characters. The existing warning for code blocks over 30 lines remains.
34
- Exact-version pinning remains the recommended production configuration; Windows
35
- x64 remains unsupported and deferred.
36
-
37
- ## Documentation
15
+ `agent-rulebook@0.2.0` is an immutable package version. Registry tags such as `latest` are mutable and are not asserted by this artifact. This source revision describes a local release candidate until registry acceptance is recorded.
38
16
 
39
- - [Codex adapter setup](docs/adapters/codex.md)
17
+ The home defaults to `~/.agent-rulebook` and can be overridden with `AGENT_RULEBOOK_HOME`. Portable Git data is limited to `config.yaml`, `problems/`, `solutions/`, and `outcomes/`. `projects.local.yaml`, `index/`, and `logs/` stay local.
40
18
 
41
- ## Private YAML sync
19
+ ## MCP tools
42
20
 
43
- Initialize `~/.agent-rulebook` as a Git repository whose tracked files are limited
44
- to `rules/**/*.yaml`, `.gitignore`, and a safe `config.yaml` or
45
- `config.example.yaml`. SQLite/WAL/SHM files, locks, logs, reports, and temporary
46
- files must remain untracked. Setup documentation stays in this product repository,
47
- not in the private data remote. If any local artifact or other non-allowlisted
48
- file is tracked, `sync push` fails with a remediation path.
21
+ The stdio server exposes exactly seven client-neutral tools:
49
22
 
50
- ### First machine and an empty private remote
23
+ - `resolutions.find`: search at the first unexpected problem using observations, hypotheses, and environment.
24
+ - `resolutions.get`: inspect one candidate's applicability, actions, safety, and verification.
25
+ - `resolutions.get_source`: retrieve one registered source locator at its recorded revision and content hash.
26
+ - `resolutions.list_facets`: inspect indexed environment facets.
27
+ - `resolutions.report_attempt`: append a verified, context-scoped attempt outcome.
28
+ - `resolutions.prepare_change`: classify and validate a verified canonical change without writing.
29
+ - `resolutions.commit_change`: revalidate an unchanged payload/hash and commit atomically.
51
30
 
52
- Create an empty private repository with the Git hosting provider. Do not add a
53
- server-generated README, license, or `.gitignore`. Then initialize and commit the
54
- local Rulebook data:
31
+ Start the server with:
55
32
 
56
33
  ```bash
57
- agent-rulebook init
58
- git -C ~/.agent-rulebook init -b main
59
- git -C ~/.agent-rulebook remote add origin <private-remote-url>
60
- git -C ~/.agent-rulebook add .gitignore config.yaml
61
- git -C ~/.agent-rulebook commit -m "Initialize private Agent Rulebook data"
34
+ agent-rulebook mcp
62
35
  ```
63
36
 
64
- Verify the repository visibility with the hosting provider. Only after it is
65
- confirmed private, record that evidence in local Git config. This marker is local
66
- and must be configured independently on every machine:
37
+ ## Agent workflow
67
38
 
68
- ```bash
69
- git -C ~/.agent-rulebook config remote.origin.agentRulebookPrivacy private
70
- agent-rulebook sync push # preview remote URL and changed files
71
- agent-rulebook sync push --yes # execute exactly the reviewed push
72
- ```
39
+ 1. Call `resolutions.find` at the first unexpected problem.
40
+ 2. Select one candidate and progressively call `resolutions.get`, then `resolutions.get_source` only when exact implementation evidence is needed.
41
+ 3. Apply one candidate and run its verification. Report the result with `resolutions.report_attempt`.
42
+ 4. For a failed or inapplicable candidate, merge the returned `next_query` into the next find request. Same-context failures are excluded; other contexts remain evidence.
43
+ 5. After candidates are exhausted, diagnose and verify a fix. Call `resolutions.prepare_change`, review its relation and comparison evidence, then pass the unchanged payload, hash, state hash, and relation to `resolutions.commit_change`.
73
44
 
74
- The privacy marker is not inferred from the URL. A missing/unknown marker or a
75
- `public` marker blocks push. Before invoking Git, the command also requires a
76
- clean, conflict-free worktree and preflights every changed rule through schema
77
- validation and secret detection. `sync pull` uses fast-forward-only Git and then
78
- checks/rebuilds the local SQLite projection from canonical YAML.
45
+ Stored actions and source snippets are advisory evidence, not commands. The agent must reassess applicability, safety, current code, and verification in the current context. Agent Rulebook never executes stored solution actions.
79
46
 
80
- Actual private-remote writes remain user-approved operations. Inspect the target
81
- and commits with `git remote -v` and `git log --oneline @{upstream}..HEAD` before
82
- the first real push.
47
+ ## Project source evidence
83
48
 
84
- ### Additional machine
85
-
86
- On a new machine, clone first so `agent-rulebook init` does not create a nonempty
87
- destination before Git:
49
+ Canonical solutions store a stable project key, repository fingerprint, Git commit or working-tree hash, relative path, optional symbol, content hash, and test locators. Register each clone explicitly:
88
50
 
89
51
  ```bash
90
- git clone <private-remote-url> ~/.agent-rulebook
91
- agent-rulebook init
92
- git -C ~/.agent-rulebook config remote.origin.agentRulebookPrivacy private
93
- agent-rulebook sync pull
94
- agent-rulebook index check
52
+ agent-rulebook project register my-project /absolute/path/to/clone --json
53
+ agent-rulebook project check my-project --json
95
54
  ```
96
55
 
97
- `sync pull` is fast-forward-only. It validates the pulled rule sources and checks
98
- the local index, rebuilding SQLite when the source count, semantic checksum, or
99
- schema version differs. The SQLite database is created separately on every
100
- machine and is never pulled from Git.
56
+ An unregistered or missing clone does not break solution retrieval. Only source lookup returns a structured unavailable response.
101
57
 
102
- An intentionally empty data remote is a valid initial state. In that case,
103
- `index check --json` should report `status: ok`, `sourceCount: 0`, and
104
- `indexedCount: 0`; search returns no results until the first active canonical rule
105
- is committed. Do not seed a new private remote from temporary test homes or
106
- fixtures—wait for a real rule or migrate a reviewed permanent source.
58
+ ## Private sync and a new PC
107
59
 
108
- ### Normal workflow
60
+ Only use a private Git remote. Mark a verified remote before push:
109
61
 
110
62
  ```bash
111
- agent-rulebook sync pull
112
- # Add, verify, deprecate, or supersede rules locally.
113
- git -C ~/.agent-rulebook add rules
114
- git -C ~/.agent-rulebook commit -m "Update Agent Rulebook rules"
115
- agent-rulebook sync push
116
- agent-rulebook sync push --yes
63
+ git -C ~/.agent-rulebook config remote.origin.agentRulebookPrivacy private
64
+ agent-rulebook sync push --json
65
+ agent-rulebook sync push --yes --json
117
66
  ```
118
67
 
119
- If `sync push` reports a dirty worktree, commit the reviewed canonical YAML change
120
- first. If it reports a conflict, resolve every listed YAML field and rebuild the
121
- index before retrying.
122
-
123
- ## Lifecycle and recovery
124
-
125
- Lifecycle changes preview by default; add `--yes` after reviewing the target:
68
+ Bootstrap another machine, then remap source projects separately:
126
69
 
127
70
  ```bash
128
- agent-rulebook rule verify <draft-id> --evidence <test-or-review-reference>
129
- agent-rulebook rule deprecate <active-id>
130
- agent-rulebook rule supersede <active-id> --replacement <active-replacement-id>
71
+ AGENT_RULEBOOK_HOME=/path/to/new/home agent-rulebook sync bootstrap \
72
+ --remote-url <private-git-url> --private-remote-confirmed --json
73
+ AGENT_RULEBOOK_HOME=/path/to/new/home agent-rulebook project register my-project /path/to/new/clone --json
131
74
  ```
132
75
 
133
- Verification requires explicit evidence and known compatibility. Superseding
134
- requires an existing active replacement and rejects replacement cycles. Applied
135
- changes atomically replace one YAML source and rebuild SQLite, so default CLI/MCP
136
- search immediately reflects the lifecycle state.
76
+ Bootstrap clones canonical data, validates the v3 config and allowlist, and rebuilds the local index. It does not synchronize absolute paths or source code.
137
77
 
138
- Use these local-first recovery paths:
78
+ ## CLI
139
79
 
140
- ```bash
141
- agent-rulebook index check
142
- agent-rulebook index rebuild
143
- git -C ~/.agent-rulebook status
80
+ ```text
81
+ init
82
+ index rebuild|check
83
+ project register|list|check
84
+ resolution find|get|get-source
85
+ sync pull|push|bootstrap
86
+ mcp
144
87
  ```
145
88
 
146
- - For a corrupt, outdated, or checksum-mismatched index, rebuild from YAML.
147
- - For Git conflicts, resolve every listed YAML file and validate it before
148
- rebuilding or pushing; the tool never auto-merges rule conflicts.
149
- - For a bad synced commit, create a normal `git revert <commit>` rollback, then
150
- pull and rebuild. Do not restore or synchronize a SQLite file.
89
+ `resolution find --input request.json --json` accepts the same strict input object as `resolutions.find`.
151
90
 
152
91
  ## Development
153
92
 
154
93
  ```bash
94
+ npm run build
155
95
  npm run typecheck
156
96
  npm test
157
- npm run build
158
- node dist/cli.js --help
159
- ```
160
-
161
- Verify the publish artifact without writing to the registry:
162
-
163
- ```bash
164
- npm run release:verify
165
- npm pack --dry-run
97
+ npm run acceptance
166
98
  npm run check:package
167
- npm run smoke:package
168
99
  ```
169
100
 
170
- The packed smoke creates an empty custom npm cache, installs the local tarball,
171
- runs CLI/init/native SQLite/MCP acceptance, then repeats from the warm cache in
172
- a second isolated install. All package and rulebook homes are temporary.
173
-
174
- The project uses `better-sqlite3` for the local SQLite store because the MVP
175
- needs synchronous, embedded persistence with a small API surface. It is a native
176
- dependency. Install or startup diagnostics include the exact Node version,
177
- platform, and architecture so unsupported native combinations can be reported.
178
-
179
- ## Release status
180
-
181
- The packaged release version is `0.1.6`, the package is explicitly `UNLICENSED`, and
182
- no public repository, homepage, or issue tracker is currently advertised because
183
- the source remote is not publicly accessible. Package availability and mutable
184
- registry tags must be checked again immediately before publish. No publish or
185
- dist-tag operation is performed by the local verification scripts.
101
+ The derived index uses the pinned native `better-sqlite3` driver. The package contains compiled runtime files, this README, package metadata, and the license; tests, fixtures, source trees, local databases, and personal paths are excluded.
@@ -1,36 +1,37 @@
1
1
  import { resolveRulebookHome } from '../core/index.js';
2
- import { checkRulebookIndex, rebuildRulebookIndex } from '../storage/index.js';
3
- import { writeIndexCheckText, writeIndexRebuildText, writeJson, } from './output.js';
2
+ import { checkResolutionIndex, rebuildResolutionIndex } from '../storage/index.js';
3
+ import { writeJson } from './output.js';
4
4
  export { registerInitCommand } from './init.js';
5
5
  export function registerIndexCommand(program) {
6
6
  const indexCommand = program
7
7
  .command('index')
8
- .description('Inspect and rebuild the local SQLite rule index');
8
+ .description('Inspect and rebuild the local Resolution Memory v3 index');
9
9
  indexCommand
10
10
  .command('rebuild')
11
- .description('Rebuild the local SQLite rule index')
11
+ .description('Rebuild the local Resolution Memory v3 index')
12
12
  .option('--json', 'Print JSON output')
13
13
  .action(async (options) => {
14
14
  const home = resolveRulebookHome();
15
- const result = await rebuildRulebookIndex({ home });
15
+ const result = await rebuildResolutionIndex({ home });
16
16
  if (options.json === true) {
17
17
  writeJson(result);
18
- return;
19
18
  }
20
- writeIndexRebuildText(result);
19
+ else {
20
+ process.stdout.write(`status\t${result.status}\nindexPath\t${result.indexPath}\ncanonicalCount\t${result.canonicalCount}\nportableChecksum\t${result.portableChecksum}\n`);
21
+ }
21
22
  });
22
23
  indexCommand
23
24
  .command('check')
24
- .description('Check whether the local SQLite rule index is present and current')
25
+ .description('Check whether the local Resolution Memory v3 index is present and current')
25
26
  .option('--json', 'Print JSON output')
26
27
  .action(async (options) => {
27
28
  const home = resolveRulebookHome();
28
- const result = await checkRulebookIndex({ home });
29
+ const result = await checkResolutionIndex(home);
29
30
  if (options.json === true) {
30
31
  writeJson(result);
31
32
  }
32
33
  else {
33
- writeIndexCheckText(result);
34
+ process.stdout.write(`${JSON.stringify(result)}\n`);
34
35
  }
35
36
  if (result.status !== 'ok') {
36
37
  process.exitCode = 1;
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE/E,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,SAAS,GACV,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAMhD,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,YAAY,GAAG,OAAO;SACzB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,iDAAiD,CAAC,CAAC;IAElE,YAAY;SACT,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC;SACrC,MAAM,CAAC,KAAK,EAAE,OAA2B,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpD,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC1B,SAAS,CAAC,MAAM,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEL,YAAY;SACT,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,kEAAkE,CAAC;SAC/E,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC;SACrC,MAAM,CAAC,KAAK,EAAE,OAA2B,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAElD,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC1B,SAAS,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEnF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAMhD,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,YAAY,GAAG,OAAO;SACzB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,0DAA0D,CAAC,CAAC;IAE3E,YAAY;SACT,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC;SACrC,MAAM,CAAC,KAAK,EAAE,OAA2B,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtD,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC1B,SAAS,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,MAAM,CAAC,MAAM,gBAAgB,MAAM,CAAC,SAAS,qBAAqB,MAAM,CAAC,cAAc,uBAAuB,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC;QAC7K,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,YAAY;SACT,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,2EAA2E,CAAC;SACxF,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC;SACrC,MAAM,CAAC,KAAK,EAAE,OAA2B,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAEhD,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC1B,SAAS,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -1,16 +1,13 @@
1
1
  import { resolveRulebookHome } from '../core/paths.js';
2
- import { createRulebookLayout } from '../storage/rulebook-home.js';
2
+ import { createResolutionHome } from '../storage/resolution-home.js';
3
3
  export function registerInitCommand(program) {
4
4
  program
5
5
  .command('init')
6
6
  .description('Create the local Agent Rulebook home layout')
7
7
  .action(async () => {
8
8
  const home = resolveRulebookHome();
9
- const result = await createRulebookLayout({ home });
10
- process.stdout.write(`Rulebook home: ${result.home}\n`);
11
- for (const entry of result.entries) {
12
- process.stdout.write(`${entry.status}\t${entry.kind}\t${entry.relativePath}\n`);
13
- }
9
+ await createResolutionHome(home);
10
+ process.stdout.write(`Resolution home initialized: ${home}\n`);
14
11
  });
15
12
  return program;
16
13
  }
@@ -1 +1 @@
1
- {"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;QACxD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;QAClF,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}
1
+ {"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;QACnC,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,IAAI,IAAI,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -1,6 +1 @@
1
- import type { IndexCheckResult, RebuildRulebookIndexResult } from '../storage/index.js';
2
- import type { SearchResponse } from '../core/index.js';
3
1
  export declare function writeJson(value: unknown): void;
4
- export declare function writeSearchText(response: SearchResponse): void;
5
- export declare function writeIndexRebuildText(result: RebuildRulebookIndexResult): void;
6
- export declare function writeIndexCheckText(result: IndexCheckResult): void;
@@ -1,51 +1,4 @@
1
1
  export function writeJson(value) {
2
2
  process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
3
3
  }
4
- export function writeSearchText(response) {
5
- if (response.results.length === 0) {
6
- process.stdout.write(`${response.hint ?? 'No results'}\n`);
7
- return;
8
- }
9
- process.stdout.write('score\tstatus\tconfidence\tid\ttitle\n');
10
- for (const result of response.results) {
11
- process.stdout.write(formatSearchResult(result));
12
- }
13
- }
14
- export function writeIndexRebuildText(result) {
15
- process.stdout.write(`indexPath\t${result.indexPath}\n`);
16
- process.stdout.write(`indexed\t${result.indexedCount}\n`);
17
- if (result.skipped.length === 0) {
18
- process.stdout.write('skipped\t0\n');
19
- return;
20
- }
21
- for (const skipped of result.skipped) {
22
- process.stdout.write(`skipped\t${skipped.path}\t${skipped.reason}\n`);
23
- }
24
- }
25
- export function writeIndexCheckText(result) {
26
- process.stdout.write(`status\t${result.status}\n`);
27
- process.stdout.write(`sourceCount\t${result.sourceCount}\n`);
28
- process.stdout.write(`indexedCount\t${result.indexedCount}\n`);
29
- process.stdout.write(`sourceChecksum\t${result.sourceChecksum}\n`);
30
- process.stdout.write(`indexedChecksum\t${result.indexedChecksum ?? 'unavailable'}\n`);
31
- process.stdout.write(`indexPath\t${result.indexPath}\n`);
32
- if (result.runtime !== undefined) {
33
- process.stdout.write(`userVersion\t${result.runtime.userVersion}\n`);
34
- process.stdout.write(`expectedUserVersion\t${result.runtime.expectedUserVersion}\n`);
35
- process.stdout.write(`fts5Available\t${result.runtime.fts5Available}\n`);
36
- process.stdout.write(`integrity\t${result.runtime.integrity}\n`);
37
- }
38
- if (result.hint !== undefined) {
39
- process.stdout.write(`hint\t${result.hint}\n`);
40
- }
41
- }
42
- function formatSearchResult(result) {
43
- return [
44
- `${result.score.toFixed(3)}\t${result.status}\t${result.confidence}\t${result.id}\t${result.title}`,
45
- `summary\t${result.summary}`,
46
- `fix\t${result.fix}`,
47
- `path\t${result.path}`,
48
- '',
49
- ].join('\n');
50
- }
51
4
  //# sourceMappingURL=output.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/commands/output.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/commands/output.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC"}
@@ -0,0 +1,2 @@
1
+ import type { Command } from 'commander';
2
+ export declare function registerProjectCommand(program: Command): Command;
@@ -0,0 +1,33 @@
1
+ import { inspectRepositoryIdentity, readProjectRegistry, registerProject, resolveRulebookHome } from '../core/index.js';
2
+ import { writeJson } from './output.js';
3
+ export function registerProjectCommand(program) {
4
+ const project = program.command('project').description('Manage machine-local project mappings');
5
+ project.command('register')
6
+ .argument('<key>')
7
+ .argument('<root>')
8
+ .option('--json')
9
+ .action(async (key, root, options) => {
10
+ const identity = await inspectRepositoryIdentity(root);
11
+ const registry = await registerProject(resolveRulebookHome(), key, identity.root);
12
+ emit({ status: 'registered', key, root: registry.projects[key], repository_fingerprint: identity.fingerprint }, options.json);
13
+ });
14
+ project.command('list').option('--json').action(async (options) => {
15
+ emit(await readProjectRegistry(resolveRulebookHome()), options.json);
16
+ });
17
+ project.command('check').argument('<key>').option('--json').action(async (key, options) => {
18
+ const registry = await readProjectRegistry(resolveRulebookHome());
19
+ const root = registry.projects[key];
20
+ const result = root === undefined
21
+ ? { status: 'unavailable', code: 'project_unregistered', key }
22
+ : { status: 'ok', key, ...(await inspectRepositoryIdentity(root)) };
23
+ emit(result, options.json);
24
+ });
25
+ return program;
26
+ }
27
+ function emit(value, json) {
28
+ if (json === true)
29
+ writeJson(value);
30
+ else
31
+ process.stdout.write(`${JSON.stringify(value)}\n`);
32
+ }
33
+ //# sourceMappingURL=project.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/commands/project.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACxH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,uCAAuC,CAAC,CAAC;IAChG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;SACxB,QAAQ,CAAC,OAAO,CAAC;SACjB,QAAQ,CAAC,QAAQ,CAAC;SAClB,MAAM,CAAC,QAAQ,CAAC;SAChB,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,IAAY,EAAE,OAA2B,EAAE,EAAE;QACvE,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,mBAAmB,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClF,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,sBAAsB,EAAE,QAAQ,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAChI,CAAC,CAAC,CAAC;IACL,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,OAA2B,EAAE,EAAE;QACpF,IAAI,CAAC,MAAM,mBAAmB,CAAC,mBAAmB,EAAE,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,OAA2B,EAAE,EAAE;QACpH,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,mBAAmB,EAAE,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,KAAK,SAAS;YAC/B,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,sBAAsB,EAAE,GAAG,EAAE;YAC9D,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,yBAAyB,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACtE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,IAAI,CAAC,KAAc,EAAE,IAAc;IAC1C,IAAI,IAAI,KAAK,IAAI;QAAE,SAAS,CAAC,KAAK,CAAC,CAAC;;QAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC"}
@@ -0,0 +1,2 @@
1
+ import type { Command } from 'commander';
2
+ export declare function registerResolutionCommand(program: Command): Command;
@@ -0,0 +1,32 @@
1
+ import { readFile } from 'node:fs/promises';
2
+ import { resolveRulebookHome } from '../core/index.js';
3
+ import { McpResolutionsFindInputSchema } from '../mcp/schemas.js';
4
+ import { handleResolutionsFind } from '../mcp/resolutions-find-tool.js';
5
+ import { handleResolutionsGet } from '../mcp/resolutions-get-tool.js';
6
+ import { handleResolutionsGetSource } from '../mcp/resolutions-get-source-tool.js';
7
+ import { writeJson } from './output.js';
8
+ export function registerResolutionCommand(program) {
9
+ const resolution = program.command('resolution').description('Find and inspect Resolution Memory v3 solutions');
10
+ resolution.command('find').requiredOption('--input <json>', 'JSON file containing a resolutions.find request').option('--json').action(async (options) => {
11
+ const input = McpResolutionsFindInputSchema.parse(JSON.parse(await readFile(options.input, 'utf8')));
12
+ emit(await handleResolutionsFind(input, { rulebookHome: resolveRulebookHome() }), options.json);
13
+ });
14
+ resolution.command('get').argument('<solution-handle>').option('--json').action(async (solutionHandle, options) => {
15
+ emit(await handleResolutionsGet({ solution_handle: solutionHandle }, { rulebookHome: resolveRulebookHome() }), options.json);
16
+ });
17
+ resolution.command('get-source').argument('<solution-handle>').argument('<source-handle>').option('--json').action(async (solutionHandle, sourceHandle, options) => {
18
+ emit(await handleResolutionsGetSource({ solution_handle: solutionHandle, source_handle: sourceHandle }, { rulebookHome: resolveRulebookHome() }), options.json);
19
+ });
20
+ return program;
21
+ }
22
+ function emit(result, json) {
23
+ const block = result.content[0];
24
+ if (block?.type !== 'text')
25
+ throw new Error('Resolution command expected JSON text output');
26
+ const parsed = JSON.parse(block.text ?? '');
27
+ if (json === true)
28
+ writeJson(parsed);
29
+ else
30
+ process.stdout.write(`${JSON.stringify(parsed)}\n`);
31
+ }
32
+ //# sourceMappingURL=resolution.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolution.js","sourceRoot":"","sources":["../../src/commands/resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,iDAAiD,CAAC,CAAC;IAChH,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,gBAAgB,EAAE,iDAAiD,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,OAA0C,EAAE,EAAE;QAC1L,MAAM,KAAK,GAAG,6BAA6B,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QACrG,IAAI,CAAC,MAAM,qBAAqB,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,mBAAmB,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;IACH,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,cAAsB,EAAE,OAA2B,EAAE,EAAE;QAC5I,IAAI,CAAC,MAAM,oBAAoB,CAAC,EAAE,eAAe,EAAE,cAAc,EAAE,EAAE,EAAE,YAAY,EAAE,mBAAmB,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/H,CAAC,CAAC,CAAC;IACH,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,cAAsB,EAAE,YAAoB,EAAE,OAA2B,EAAE,EAAE;QACrM,IAAI,CAAC,MAAM,0BAA0B,CAAC,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,EAAE,mBAAmB,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAClK,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,IAAI,CAAC,MAA2D,EAAE,IAAc;IACvF,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,KAAK,EAAE,IAAI,KAAK,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC5F,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC5C,IAAI,IAAI,KAAK,IAAI;QAAE,SAAS,CAAC,MAAM,CAAC,CAAC;;QAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACjG,CAAC"}
@@ -1,5 +1,5 @@
1
1
  import type { Command } from 'commander';
2
- import { checkRulebookIndex } from '../storage/index.js';
2
+ import { checkResolutionIndex } from '../storage/index.js';
3
3
  export type SyncIssue = {
4
4
  code: string;
5
5
  message: string;
@@ -7,13 +7,16 @@ export type SyncIssue = {
7
7
  fields?: string[];
8
8
  };
9
9
  export type SyncResult = {
10
- status: 'blocked' | 'failed' | 'preview' | 'pulled' | 'pushed';
10
+ status: 'blocked' | 'failed' | 'preview' | 'pulled' | 'pushed' | 'bootstrapped';
11
11
  remote: string;
12
12
  remoteUrl?: string;
13
13
  changedFiles: string[];
14
14
  issues: SyncIssue[];
15
- index?: Awaited<ReturnType<typeof checkRulebookIndex>>;
15
+ index?: Awaited<ReturnType<typeof checkResolutionIndex>>;
16
+ remapRequired?: boolean;
17
+ nextSteps?: string[];
16
18
  };
17
19
  export declare function registerSyncCommand(program: Command): Command;
18
20
  export declare function syncPush(home: string, remote?: string, confirmed?: boolean): Promise<SyncResult>;
19
21
  export declare function syncPull(home: string, remote?: string): Promise<SyncResult>;
22
+ export declare function syncBootstrap(home: string, remoteUrl: string, remote?: string, privateRemoteConfirmed?: boolean): Promise<SyncResult>;