@venizia/vulcan 0.4.10-16 → 0.4.10-17

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@venizia/vulcan",
3
- "version": "0.4.10-16",
3
+ "version": "0.4.10-17",
4
4
  "description": "VULCAN - one setup, one workflow for every project: init, sync, doctor, upgrade, and `vulcan x` for the shipped tools. Bun-only.",
5
5
  "homepage": "https://github.com/VENIZIA-AI/vulcan/tree/main/packages/cli",
6
6
  "bugs": {
@@ -45,8 +45,8 @@
45
45
  },
46
46
  "dependencies": {
47
47
  "@clack/prompts": "1.8.1",
48
- "@venizia/vulcan-atlas": "0.4.10-16",
49
- "@venizia/vulcan-okf": "0.4.10-16",
48
+ "@venizia/vulcan-atlas": "0.4.10-17",
49
+ "@venizia/vulcan-okf": "0.4.10-17",
50
50
  "zod": "^4.6.7"
51
51
  },
52
52
  "devDependencies": {
@@ -1,4 +1,5 @@
1
1
  import { z } from 'zod';
2
+ import { SiteUrl } from '@venizia/vulcan-atlas';
2
3
  import { LayoutFolder } from '../common/layout-folder.ts';
3
4
  import { DOCTOR_SCHEMA } from '../doctor/schema.ts';
4
5
  import { GuardDecisions } from '../hooks/common/constants.ts';
@@ -299,6 +300,26 @@ export const VULCAN_CONFIG_SCHEMA = z.strictObject({
299
300
  .string()
300
301
  .regex(/^\d{4}-\d{2}-\d{2}$/)
301
302
  .optional(),
303
+ /**
304
+ * The address of the project's wiki (`https://wiki.example.com`): `vulcan migrate plan` prints a link to the
305
+ * upgrade guide of each step on it, `<siteUrl>/changelogs/<version>/upgrade#<id>`. An https address (http only on
306
+ * localhost) with no credentials, query, fragment or control character, kept without its trailing slash; omit it
307
+ * and the plan prints no link.
308
+ */
309
+ siteUrl: z
310
+ .string()
311
+ .transform((value, context) => {
312
+ const parsed = SiteUrl.parse({ value });
313
+
314
+ if ('problem' in parsed) {
315
+ context.addIssue({ code: 'custom', message: parsed.problem });
316
+
317
+ return z.NEVER;
318
+ }
319
+
320
+ return parsed.href;
321
+ })
322
+ .optional(),
302
323
  /** A map of code areas to concepts; no shipped skill reads it. */
303
324
  })
304
325
  .default({ bundle: ConfigConstants.DEFAULT_KNOWLEDGE_BUNDLE }),
@@ -212,7 +212,8 @@ export class ProjectManifest {
212
212
  */
213
213
  static render(opts: { root: string; config: TResolvedConfig }): string {
214
214
  const { config } = opts;
215
- const { wiki, changelogs, migrationFrom, datedUntil, codemodCommand } = config.knowledge;
215
+ const { wiki, changelogs, migrationFrom, datedUntil, siteUrl, codemodCommand } =
216
+ config.knowledge;
216
217
 
217
218
  const manifest = {
218
219
  [ManifestConstants.GENERATED_KEY]: ManifestConstants.GENERATED_NOTE,
@@ -236,6 +237,7 @@ export class ProjectManifest {
236
237
  ...(changelogs === undefined ? {} : { changelogs }),
237
238
  migrationFrom,
238
239
  ...(datedUntil === undefined ? {} : { datedUntil }),
240
+ ...(siteUrl === undefined ? {} : { siteUrl }),
239
241
  ...(codemodCommand === undefined ? {} : { codemodCommand }),
240
242
  },
241
243
  release: {