ctxr-cli 0.9.0 → 0.11.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 (211) hide show
  1. package/README.md +28 -11
  2. package/dist/commands/init.d.ts.map +1 -1
  3. package/dist/commands/init.js +10 -2
  4. package/dist/commands/init.js.map +1 -1
  5. package/dist/commands/publish-check.d.ts.map +1 -1
  6. package/dist/commands/publish-check.js +8 -0
  7. package/dist/commands/publish-check.js.map +1 -1
  8. package/dist/commands/publish-new.d.ts.map +1 -1
  9. package/dist/commands/publish-new.js +15 -0
  10. package/dist/commands/publish-new.js.map +1 -1
  11. package/dist/commands/serve.d.ts.map +1 -1
  12. package/dist/commands/serve.js +33 -11
  13. package/dist/commands/serve.js.map +1 -1
  14. package/dist/commands/session-start.d.ts.map +1 -1
  15. package/dist/commands/session-start.js +9 -1
  16. package/dist/commands/session-start.js.map +1 -1
  17. package/dist/commands/source-check.d.ts.map +1 -1
  18. package/dist/commands/source-check.js +28 -3
  19. package/dist/commands/source-check.js.map +1 -1
  20. package/dist/commands/update.d.ts.map +1 -1
  21. package/dist/commands/update.js +7 -1
  22. package/dist/commands/update.js.map +1 -1
  23. package/dist/commands/verify.d.ts +11 -2
  24. package/dist/commands/verify.d.ts.map +1 -1
  25. package/dist/commands/verify.js +86 -5
  26. package/dist/commands/verify.js.map +1 -1
  27. package/dist/commands/version.d.ts +31 -0
  28. package/dist/commands/version.d.ts.map +1 -0
  29. package/dist/commands/version.js +87 -0
  30. package/dist/commands/version.js.map +1 -0
  31. package/dist/config/defaults.d.ts +71 -5
  32. package/dist/config/defaults.d.ts.map +1 -1
  33. package/dist/config/defaults.js +70 -5
  34. package/dist/config/defaults.js.map +1 -1
  35. package/dist/config/load.d.ts +2 -2
  36. package/dist/config/load.d.ts.map +1 -1
  37. package/dist/config/load.js +13 -3
  38. package/dist/config/load.js.map +1 -1
  39. package/dist/config/render.d.ts +0 -6
  40. package/dist/config/render.d.ts.map +1 -1
  41. package/dist/config/render.js +4 -27
  42. package/dist/config/render.js.map +1 -1
  43. package/dist/config/schema.d.ts +21 -67
  44. package/dist/config/schema.d.ts.map +1 -1
  45. package/dist/config/schema.js +73 -112
  46. package/dist/config/schema.js.map +1 -1
  47. package/dist/core/agents-doc.d.ts.map +1 -1
  48. package/dist/core/agents-doc.js +2 -1
  49. package/dist/core/agents-doc.js.map +1 -1
  50. package/dist/core/browse/nav.d.ts.map +1 -1
  51. package/dist/core/browse/nav.js +4 -1
  52. package/dist/core/browse/nav.js.map +1 -1
  53. package/dist/core/browse/preferences.d.ts +26 -0
  54. package/dist/core/browse/preferences.d.ts.map +1 -0
  55. package/dist/core/browse/preferences.js +74 -0
  56. package/dist/core/browse/preferences.js.map +1 -0
  57. package/dist/core/browse/routes.d.ts +10 -8
  58. package/dist/core/browse/routes.d.ts.map +1 -1
  59. package/dist/core/browse/routes.js +113 -24
  60. package/dist/core/browse/routes.js.map +1 -1
  61. package/dist/core/browse/templates.d.ts +14 -4
  62. package/dist/core/browse/templates.d.ts.map +1 -1
  63. package/dist/core/browse/templates.js +22 -4
  64. package/dist/core/browse/templates.js.map +1 -1
  65. package/dist/core/checks/harness-portability-checks.d.ts +21 -0
  66. package/dist/core/checks/harness-portability-checks.d.ts.map +1 -1
  67. package/dist/core/checks/harness-portability-checks.js +46 -1
  68. package/dist/core/checks/harness-portability-checks.js.map +1 -1
  69. package/dist/core/checks/integrity-checks.d.ts +0 -2
  70. package/dist/core/checks/integrity-checks.d.ts.map +1 -1
  71. package/dist/core/checks/integrity-checks.js +38 -27
  72. package/dist/core/checks/integrity-checks.js.map +1 -1
  73. package/dist/core/checks/manifest.d.ts.map +1 -1
  74. package/dist/core/checks/manifest.js +2 -0
  75. package/dist/core/checks/manifest.js.map +1 -1
  76. package/dist/core/checks/store-checks.d.ts +12 -0
  77. package/dist/core/checks/store-checks.d.ts.map +1 -0
  78. package/dist/core/checks/store-checks.js +37 -0
  79. package/dist/core/checks/store-checks.js.map +1 -0
  80. package/dist/core/command.d.ts +6 -0
  81. package/dist/core/command.d.ts.map +1 -1
  82. package/dist/core/convention-doc.d.ts.map +1 -1
  83. package/dist/core/convention-doc.js +15 -9
  84. package/dist/core/convention-doc.js.map +1 -1
  85. package/dist/core/env.d.ts +5 -0
  86. package/dist/core/env.d.ts.map +1 -1
  87. package/dist/core/env.js +3 -0
  88. package/dist/core/env.js.map +1 -1
  89. package/dist/core/environment/probe.d.ts +12 -0
  90. package/dist/core/environment/probe.d.ts.map +1 -0
  91. package/dist/core/environment/probe.js +36 -0
  92. package/dist/core/environment/probe.js.map +1 -0
  93. package/dist/core/errors.d.ts +16 -3
  94. package/dist/core/errors.d.ts.map +1 -1
  95. package/dist/core/errors.js +41 -15
  96. package/dist/core/errors.js.map +1 -1
  97. package/dist/core/git/worktree.d.ts +22 -0
  98. package/dist/core/git/worktree.d.ts.map +1 -1
  99. package/dist/core/git/worktree.js +34 -0
  100. package/dist/core/git/worktree.js.map +1 -1
  101. package/dist/core/graph/model.d.ts +7 -6
  102. package/dist/core/graph/model.d.ts.map +1 -1
  103. package/dist/core/graph/model.js +11 -7
  104. package/dist/core/graph/model.js.map +1 -1
  105. package/dist/core/harness/isolated-run.d.ts +52 -0
  106. package/dist/core/harness/isolated-run.d.ts.map +1 -0
  107. package/dist/core/harness/isolated-run.js +100 -0
  108. package/dist/core/harness/isolated-run.js.map +1 -0
  109. package/dist/core/install-kind.d.ts +25 -0
  110. package/dist/core/install-kind.d.ts.map +1 -0
  111. package/dist/core/install-kind.js +56 -0
  112. package/dist/core/install-kind.js.map +1 -0
  113. package/dist/core/note-templates.d.ts +61 -0
  114. package/dist/core/note-templates.d.ts.map +1 -0
  115. package/dist/core/note-templates.js +188 -0
  116. package/dist/core/note-templates.js.map +1 -0
  117. package/dist/core/notes/list.d.ts.map +1 -1
  118. package/dist/core/notes/list.js +5 -0
  119. package/dist/core/notes/list.js.map +1 -1
  120. package/dist/core/publish/script-check.d.ts +5 -2
  121. package/dist/core/publish/script-check.d.ts.map +1 -1
  122. package/dist/core/publish/script-check.js +5 -2
  123. package/dist/core/publish/script-check.js.map +1 -1
  124. package/dist/core/reconcile.d.ts.map +1 -1
  125. package/dist/core/reconcile.js +8 -0
  126. package/dist/core/reconcile.js.map +1 -1
  127. package/dist/core/registry.d.ts +40 -0
  128. package/dist/core/registry.d.ts.map +1 -0
  129. package/dist/core/registry.js +55 -0
  130. package/dist/core/registry.js.map +1 -0
  131. package/dist/core/root.d.ts +11 -5
  132. package/dist/core/root.d.ts.map +1 -1
  133. package/dist/core/root.js +20 -8
  134. package/dist/core/root.js.map +1 -1
  135. package/dist/core/skills.d.ts.map +1 -1
  136. package/dist/core/skills.js +32 -15
  137. package/dist/core/skills.js.map +1 -1
  138. package/dist/core/version-check.d.ts +63 -0
  139. package/dist/core/version-check.d.ts.map +1 -0
  140. package/dist/core/version-check.js +181 -0
  141. package/dist/core/version-check.js.map +1 -0
  142. package/dist/core/write-lifecycle/path-gate.d.ts.map +1 -1
  143. package/dist/core/write-lifecycle/path-gate.js +4 -1
  144. package/dist/core/write-lifecycle/path-gate.js.map +1 -1
  145. package/dist/run.d.ts +1 -1
  146. package/dist/run.d.ts.map +1 -1
  147. package/dist/run.js +38 -16
  148. package/dist/run.js.map +1 -1
  149. package/dist/version.d.ts +8 -1
  150. package/dist/version.d.ts.map +1 -1
  151. package/dist/version.js +8 -1
  152. package/dist/version.js.map +1 -1
  153. package/package.json +1 -1
  154. package/templates/agents/canonical.md +5 -1
  155. package/templates/notes/Company.md +25 -0
  156. package/templates/notes/Concept.md +29 -0
  157. package/templates/notes/Deal.md +25 -0
  158. package/templates/notes/Note.md +6 -0
  159. package/templates/notes/People.md +19 -0
  160. package/templates/notes/Project.md +19 -0
  161. package/templates/serve/shell.html +16 -2
  162. package/templates/serve/style.css +145 -3
  163. package/templates/skills/ctxr-ingest-orchestration.md +4 -1
  164. package/templates/skills/ctxr-placement.md +21 -2
  165. package/templates/skills/ctxr-session-capture.md +5 -1
  166. package/templates/skills/ctxr-session-lifecycle.md +20 -0
  167. package/templates/skills/ctxr-upgrade.md +44 -0
  168. package/dist/commands/migrate.d.ts +0 -30
  169. package/dist/commands/migrate.d.ts.map +0 -1
  170. package/dist/commands/migrate.js +0 -56
  171. package/dist/commands/migrate.js.map +0 -1
  172. package/dist/core/migrations/add-explanation-craft-skill.d.ts +0 -26
  173. package/dist/core/migrations/add-explanation-craft-skill.d.ts.map +0 -1
  174. package/dist/core/migrations/add-explanation-craft-skill.js +0 -94
  175. package/dist/core/migrations/add-explanation-craft-skill.js.map +0 -1
  176. package/dist/core/migrations/archive-destination-from-taxonomy.d.ts +0 -35
  177. package/dist/core/migrations/archive-destination-from-taxonomy.d.ts.map +0 -1
  178. package/dist/core/migrations/archive-destination-from-taxonomy.js +0 -109
  179. package/dist/core/migrations/archive-destination-from-taxonomy.js.map +0 -1
  180. package/dist/core/migrations/config-defaults-as-the-convention.d.ts +0 -21
  181. package/dist/core/migrations/config-defaults-as-the-convention.d.ts.map +0 -1
  182. package/dist/core/migrations/config-defaults-as-the-convention.js +0 -54
  183. package/dist/core/migrations/config-defaults-as-the-convention.js.map +0 -1
  184. package/dist/core/migrations/drop-access-axes.d.ts +0 -24
  185. package/dist/core/migrations/drop-access-axes.d.ts.map +0 -1
  186. package/dist/core/migrations/drop-access-axes.js +0 -54
  187. package/dist/core/migrations/drop-access-axes.js.map +0 -1
  188. package/dist/core/migrations/drop-forge-and-workspaces-external.d.ts +0 -19
  189. package/dist/core/migrations/drop-forge-and-workspaces-external.d.ts.map +0 -1
  190. package/dist/core/migrations/drop-forge-and-workspaces-external.js +0 -49
  191. package/dist/core/migrations/drop-forge-and-workspaces-external.js.map +0 -1
  192. package/dist/core/migrations/registry.d.ts +0 -16
  193. package/dist/core/migrations/registry.d.ts.map +0 -1
  194. package/dist/core/migrations/registry.js +0 -34
  195. package/dist/core/migrations/registry.js.map +0 -1
  196. package/dist/core/migrations/rename-conventions-path.d.ts +0 -26
  197. package/dist/core/migrations/rename-conventions-path.d.ts.map +0 -1
  198. package/dist/core/migrations/rename-conventions-path.js +0 -86
  199. package/dist/core/migrations/rename-conventions-path.js.map +0 -1
  200. package/dist/core/migrations/rename-procedures-path.d.ts +0 -17
  201. package/dist/core/migrations/rename-procedures-path.d.ts.map +0 -1
  202. package/dist/core/migrations/rename-procedures-path.js +0 -45
  203. package/dist/core/migrations/rename-procedures-path.js.map +0 -1
  204. package/dist/core/migrations/retain-captures-as-provenance.d.ts +0 -22
  205. package/dist/core/migrations/retain-captures-as-provenance.d.ts.map +0 -1
  206. package/dist/core/migrations/retain-captures-as-provenance.js +0 -133
  207. package/dist/core/migrations/retain-captures-as-provenance.js.map +0 -1
  208. package/dist/core/migrations/types.d.ts +0 -27
  209. package/dist/core/migrations/types.d.ts.map +0 -1
  210. package/dist/core/migrations/types.js +0 -2
  211. package/dist/core/migrations/types.js.map +0 -1
@@ -1,45 +0,0 @@
1
- import path from 'node:path';
2
- import { readConfig } from '../../config/load.js';
3
- import { renderStoreConfig } from '../../config/render.js';
4
- import { writeFileAtomic } from '../fs/atomic.js';
5
- const CONFIG_DELTA = {
6
- path: 'contexture.yaml',
7
- description: 'rename harness.procedures_path to harness.skills_path and set schema_version to 3',
8
- };
9
- /**
10
- * rename-procedures-to-skills (design.md D2): a single-delta migration —
11
- * unlike the visibility-field rename, no note frontmatter is touched, since
12
- * only the config key's spelling changes, never any store file's location
13
- * (DEFAULT_SKILLS_PATH is already DEFAULT_PROCEDURES_PATH's old value).
14
- *
15
- * Pending-ness is `store.config.schema_version < 3`, NOT the presence or
16
- * absence of `store.config.harness.skills_path` — that field is populated
17
- * by HarnessSchema's fallback transform even on an unmigrated v2 store (so
18
- * every command keeps working before `ctxr migrate` runs), which means its
19
- * presence can never distinguish "already migrated" from "not yet
20
- * migrated." `schema_version` is the one signal the fallback doesn't mask,
21
- * and this migration is the only thing that ever sets it to 3.
22
- */
23
- export const renameProceduresPathMigration = {
24
- id: '0003-rename-procedures-path-to-skills-path',
25
- fromVersion: 2,
26
- toVersion: 3,
27
- description: 'Rename the harness.procedures_path config key to harness.skills_path, and bump schema_version to 3.',
28
- async plan(store) {
29
- return store.config.schema_version < 3 ? [CONFIG_DELTA] : [];
30
- },
31
- async apply(store) {
32
- if (store.config.schema_version >= 3)
33
- return [];
34
- const configPath = path.join(store.root, 'contexture.yaml');
35
- // readConfig() already resolves harness.skills_path via HarnessSchema's
36
- // fallback (from procedures_path if that's all the file has), so
37
- // currentConfig.harness carries no procedures_path key at all —
38
- // rendering it below writes only skills_path to disk.
39
- const currentConfig = await readConfig(store.root);
40
- const nextConfig = { ...currentConfig, schema_version: 3 };
41
- await writeFileAtomic(configPath, renderStoreConfig(nextConfig));
42
- return [CONFIG_DELTA];
43
- },
44
- };
45
- //# sourceMappingURL=rename-procedures-path.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"rename-procedures-path.js","sourceRoot":"","sources":["../../../src/core/migrations/rename-procedures-path.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIlD,MAAM,YAAY,GAAmB;IACnC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,mFAAmF;CACjG,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAc;IACtD,EAAE,EAAE,4CAA4C;IAChD,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,CAAC;IACZ,WAAW,EAAE,qGAAqG;IAElH,KAAK,CAAC,IAAI,CAAC,KAAK;QACd,OAAO,KAAK,CAAC,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAK;QACf,IAAI,KAAK,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QAEhD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;QAC5D,wEAAwE;QACxE,iEAAiE;QACjE,gEAAgE;QAChE,sDAAsD;QACtD,MAAM,aAAa,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,EAAE,GAAG,aAAa,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QAC3D,MAAM,eAAe,CAAC,UAAU,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;QAEjE,OAAO,CAAC,YAAY,CAAC,CAAC;IACxB,CAAC;CACF,CAAC"}
@@ -1,22 +0,0 @@
1
- import type { Migration } from './types.js';
2
- /**
3
- * retain-captures-as-provenance: captures stop being consumed by ingest and
4
- * start being retained as the store's provenance ledger, which means they
5
- * stop being notes. That needs three things on an existing store — a
6
- * declared capture root, an inbox inside it, and the root excluded from
7
- * retrieval — and this migration supplies all three.
8
- *
9
- * Modelled on 0006: adopt the new shipped default only where the value still
10
- * sat at the old one, preserve an operator-chosen value verbatim, and move
11
- * the directory when one exists. Pending-ness is `schema_version < 9`, not
12
- * key presence, for the reason 0002/0004/0005/0006 all record: the schema's
13
- * transform fills `capture_root` in on an unmigrated store too, so its
14
- * presence cannot distinguish migrated from not.
15
- *
16
- * The directory move runs before the config write, so an interruption
17
- * between them leaves the next run able to re-derive what is left: the
18
- * config still reads schema 8 with the old inbox, the old directory is
19
- * already gone, and the rename is skipped as done.
20
- */
21
- export declare const retainCapturesAsProvenanceMigration: Migration;
22
- //# sourceMappingURL=retain-captures-as-provenance.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"retain-captures-as-provenance.d.ts","sourceRoot":"","sources":["../../../src/core/migrations/retain-captures-as-provenance.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAsD5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mCAAmC,EAAE,SAoEjD,CAAC"}
@@ -1,133 +0,0 @@
1
- import { existsSync } from 'node:fs';
2
- import { mkdir, rename } from 'node:fs/promises';
3
- import path from 'node:path';
4
- import { DEFAULT_CAPTURE_ROOT, DEFAULT_INBOX_PATH } from '../../config/defaults.js';
5
- import { readConfig } from '../../config/load.js';
6
- import { renderStoreConfig } from '../../config/render.js';
7
- import { CaptureRootUndeterminedError } from '../errors.js';
8
- import { writeFileAtomic } from '../fs/atomic.js';
9
- /**
10
- * The inbox default as it stood before this migration. Pinned locally, never
11
- * read from `defaults.ts`: a migration reasons about the value a store was
12
- * born with, which must not drift when the shipped default moves again.
13
- */
14
- const PREVIOUS_DEFAULT_INBOX_PATH = 'inbox/';
15
- function normalize(prefix) {
16
- return prefix.replace(/\/+$/, '');
17
- }
18
- /** The directory one level above `inboxPath`, or null when the inbox is already top-level. */
19
- function parentDirectoryOf(inboxPath) {
20
- const segments = normalize(inboxPath).split('/').filter((segment) => segment !== '');
21
- if (segments.length < 2)
22
- return null;
23
- return `${segments.slice(0, -1).join('/')}/`;
24
- }
25
- /**
26
- * Where this store's capture tier lands. Two cases and one refusal:
27
- *
28
- * 1. The store never customized its inbox, so it is ours to move: adopt the
29
- * shipped `raw/inbox/` under `raw/`.
30
- * 2. The store chose an inbox nested at least one level (`staging/inbox/`):
31
- * the parent it already chose IS the capture root. The inbox is left
32
- * exactly as the operator set it.
33
- * 3. The store chose a top-level inbox of its own (`incoming/`): there is no
34
- * parent to promote short of the store root, and excluding the store root
35
- * from retrieval would empty the note list. Refuse before writing
36
- * anything and let the operator choose, the same way `source check`
37
- * refuses to guess among multiple matches.
38
- */
39
- function resolveCaptureTier(inboxPath) {
40
- if (normalize(inboxPath) === normalize(PREVIOUS_DEFAULT_INBOX_PATH)) {
41
- return { inboxPath: DEFAULT_INBOX_PATH, captureRoot: DEFAULT_CAPTURE_ROOT, adoptsShippedDefault: true };
42
- }
43
- const parent = parentDirectoryOf(inboxPath);
44
- if (parent === null)
45
- throw new CaptureRootUndeterminedError(inboxPath);
46
- return { inboxPath, captureRoot: parent, adoptsShippedDefault: false };
47
- }
48
- function alreadyExcluded(excludePaths, captureRoot) {
49
- return excludePaths.some((excluded) => normalize(excluded) === normalize(captureRoot));
50
- }
51
- /**
52
- * retain-captures-as-provenance: captures stop being consumed by ingest and
53
- * start being retained as the store's provenance ledger, which means they
54
- * stop being notes. That needs three things on an existing store — a
55
- * declared capture root, an inbox inside it, and the root excluded from
56
- * retrieval — and this migration supplies all three.
57
- *
58
- * Modelled on 0006: adopt the new shipped default only where the value still
59
- * sat at the old one, preserve an operator-chosen value verbatim, and move
60
- * the directory when one exists. Pending-ness is `schema_version < 9`, not
61
- * key presence, for the reason 0002/0004/0005/0006 all record: the schema's
62
- * transform fills `capture_root` in on an unmigrated store too, so its
63
- * presence cannot distinguish migrated from not.
64
- *
65
- * The directory move runs before the config write, so an interruption
66
- * between them leaves the next run able to re-derive what is left: the
67
- * config still reads schema 8 with the old inbox, the old directory is
68
- * already gone, and the rename is skipped as done.
69
- */
70
- export const retainCapturesAsProvenanceMigration = {
71
- id: '0009-retain-captures-as-provenance',
72
- fromVersion: 8,
73
- toVersion: 9,
74
- description: 'Declare the capture tier: add ingest.capture_root, move a default-valued inbox inside it, exclude the capture root from retrieval, and bump schema_version to 9.',
75
- async plan(store) {
76
- if (store.config.schema_version >= 9)
77
- return [];
78
- const tier = resolveCaptureTier(store.config.ingest.inbox_path);
79
- const deltas = [
80
- {
81
- path: 'contexture.yaml',
82
- description: `add ingest.capture_root: ${tier.captureRoot} and set schema_version to 9`,
83
- },
84
- ];
85
- if (tier.adoptsShippedDefault) {
86
- deltas.push({
87
- path: 'contexture.yaml',
88
- description: `adopt the shipped inbox default, moving ingest.inbox_path from ${PREVIOUS_DEFAULT_INBOX_PATH} to ${tier.inboxPath}`,
89
- });
90
- if (existsSync(path.join(store.root, PREVIOUS_DEFAULT_INBOX_PATH))) {
91
- deltas.push({
92
- path: tier.inboxPath,
93
- description: `move the inbox directory from ${PREVIOUS_DEFAULT_INBOX_PATH} to ${tier.inboxPath}`,
94
- });
95
- }
96
- }
97
- if (!alreadyExcluded(store.config.retrieval.exclude_paths, tier.captureRoot)) {
98
- deltas.push({
99
- path: 'contexture.yaml',
100
- description: `add ${tier.captureRoot} to retrieval.exclude_paths, so retained captures are never notes`,
101
- });
102
- }
103
- return deltas;
104
- },
105
- async apply(store) {
106
- if (store.config.schema_version >= 9)
107
- return [];
108
- const currentConfig = await readConfig(store.root);
109
- const tier = resolveCaptureTier(currentConfig.ingest.inbox_path);
110
- const appliedDeltas = await this.plan({ ...store, config: currentConfig });
111
- if (tier.adoptsShippedDefault) {
112
- const oldDir = path.join(store.root, PREVIOUS_DEFAULT_INBOX_PATH);
113
- const newDir = path.join(store.root, tier.inboxPath);
114
- // Absent whenever nothing was ever captured — only the config changes.
115
- if (existsSync(oldDir) && !existsSync(newDir)) {
116
- await mkdir(path.dirname(newDir), { recursive: true });
117
- await rename(oldDir, newDir);
118
- }
119
- }
120
- const excludePaths = alreadyExcluded(currentConfig.retrieval.exclude_paths, tier.captureRoot)
121
- ? [...currentConfig.retrieval.exclude_paths]
122
- : [...currentConfig.retrieval.exclude_paths, tier.captureRoot];
123
- const nextConfig = {
124
- ...currentConfig,
125
- schema_version: 9,
126
- retrieval: { ...currentConfig.retrieval, exclude_paths: excludePaths },
127
- ingest: { ...currentConfig.ingest, inbox_path: tier.inboxPath, capture_root: tier.captureRoot },
128
- };
129
- await writeFileAtomic(path.join(store.root, 'contexture.yaml'), renderStoreConfig(nextConfig));
130
- return appliedDeltas;
131
- },
132
- };
133
- //# sourceMappingURL=retain-captures-as-provenance.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"retain-captures-as-provenance.js","sourceRoot":"","sources":["../../../src/core/migrations/retain-captures-as-provenance.ts"],"names":[],"mappings":"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"}
@@ -1,27 +0,0 @@
1
- import type { Store } from '../store.js';
2
- /** One concrete, reportable change a migration made (or would make). */
3
- export interface MigrationDelta {
4
- /** The file touched, relative to the store root — 'contexture.yaml' for the config itself. */
5
- path: string;
6
- description: string;
7
- }
8
- /**
9
- * store-lifecycle spec: "named, dry-runnable, resumable." A migration's
10
- * `plan()` and `apply()` both re-derive what still needs doing from the
11
- * store's CURRENT on-disk state, never from separately-tracked progress —
12
- * so re-running `apply()` after an interruption naturally skips whatever
13
- * was already done (it no longer matches the "needs migrating" condition)
14
- * and finishes the rest, with no separate progress file to go stale or
15
- * corrupt.
16
- */
17
- export interface Migration {
18
- id: string;
19
- fromVersion: number;
20
- toVersion: number;
21
- description: string;
22
- /** Computes exactly what apply() would change, without writing anything. */
23
- plan(store: Store): Promise<MigrationDelta[]>;
24
- /** Applies only what plan() would still report as pending; returns what it actually changed. */
25
- apply(store: Store): Promise<MigrationDelta[]>;
26
- }
27
- //# sourceMappingURL=types.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/migrations/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,8FAA8F;IAC9F,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC9C,gGAAgG;IAChG,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAChD"}
@@ -1,2 +0,0 @@
1
- export {};
2
- //# sourceMappingURL=types.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/migrations/types.ts"],"names":[],"mappings":""}