infra-kit 0.1.110 → 0.1.113

package/src/lib/package-config/.omc/state/sessions/dde22a92-a0e9-4948-905d-25c9a812ab35/last-tool-error-state.json

@@ -0,0 +1,7 @@
+{
+  "tool_name": "Bash",
+  "tool_input_preview": "{\"command\":\"rtk ls -1 infra-kit.config.ts apps/*/*/infra-kit.config.* packages/*/infra-kit.config.* vendor/packages/*/infra-kit.config.* vendor/configs/*/infra-kit.config.* 2>/dev/null\",\"description\":...",
+  "error": "Exit code 1\n(eval):1: no matches found: apps/*/*/infra-kit.config.*",
+  "timestamp": "2026-06-20T09:23:27.849Z",
+  "retry_count": 1
+}

package/src/lib/package-config/.omc/state/sessions/dde22a92-a0e9-4948-905d-25c9a812ab35/pre-tool-advisory-throttle.json

@@ -0,0 +1,10 @@
+{
+  "version": 1,
+  "entries": {
+    "79a93d4a2f8f50b95f852280616242fee1855dc99a3c75211917f55e72e95fae": {
+      "last_emitted_at_ms": 1781947394826,
+      "message": "Use parallel execution for independent tasks. Use run_in_background for long operations (npm install, builds, tests)."
+    }
+  },
+  "updated_at": "2026-06-20T09:23:14.826Z"
+}

package/src/lib/version-utils/__tests__/next-version.test.ts

@@ -6,6 +6,7 @@ import {
   NoPriorVersionsError,
   collectKnownVersions,
   computeNextVersion,
+  formatReleaseSpec,
   hasNextToken,
   parseReleaseSpec,
   resolveReleaseEntries,
@@ -132,6 +133,89 @@ describe('parseReleaseSpec', () => {
       return parseReleaseSpec('   ')
     }).toThrow(/empty/)
   })
+
+  it('parses a bare name token into a named input', () => {
+    expect(parseReleaseSpec('checkout-redesign')).toEqual({ name: 'checkout-redesign', type: 'regular' })
+  })
+
+  it('parses name:type:description into a named input', () => {
+    expect(parseReleaseSpec('checkout-redesign:regular:Q3 work')).toEqual({
+      name: 'checkout-redesign',
+      type: 'regular',
+      description: 'Q3 work',
+    })
+  })
+
+  it('parses name:hotfix into a named hotfix input', () => {
+    expect(parseReleaseSpec('checkout-redesign:hotfix')).toEqual({ name: 'checkout-redesign', type: 'hotfix' })
+  })
+
+  it('treats a v-prefixed semver as a version, not a name', () => {
+    expect(parseReleaseSpec('v1.2.5')).toEqual({ version: 'v1.2.5', type: 'regular' })
+  })
+})
+
+describe('formatReleaseSpec', () => {
+  const entry = (id: ReleaseId, type: ReleaseEntry['type'], description?: string): ReleaseEntry => {
+    return description !== undefined ? { id, type, description } : { id, type }
+  }
+
+  it('renders a regular version as the bare token', () => {
+    expect(formatReleaseSpec(entry(versionId('1.2.5'), 'regular'))).toBe('1.2.5')
+  })
+
+  it('renders a hotfix version as token:hotfix', () => {
+    expect(formatReleaseSpec(entry(versionId('1.2.5'), 'hotfix'))).toBe('1.2.5:hotfix')
+  })
+
+  it('renders a version with a description as token:type:description', () => {
+    expect(formatReleaseSpec(entry(versionId('1.2.5'), 'regular', 'Holiday backend'))).toBe(
+      '1.2.5:regular:Holiday backend',
+    )
+  })
+
+  it('renders a regular named release as the bare name', () => {
+    expect(formatReleaseSpec(entry(nameId('checkout-redesign'), 'regular'))).toBe('checkout-redesign')
+  })
+
+  it('renders a named release with a description as name:type:description', () => {
+    expect(formatReleaseSpec(entry(nameId('checkout-redesign'), 'regular', 'Q3 work'))).toBe(
+      'checkout-redesign:regular:Q3 work',
+    )
+  })
+
+  it('renders a named hotfix as name:hotfix', () => {
+    expect(formatReleaseSpec(entry(nameId('checkout-redesign'), 'hotfix'))).toBe('checkout-redesign:hotfix')
+  })
+
+  it('preserves colons inside the description', () => {
+    expect(formatReleaseSpec(entry(versionId('1.2.5'), 'hotfix', 'Fixes: A and B'))).toBe('1.2.5:hotfix:Fixes: A and B')
+  })
+
+  it('treats an empty description as absent', () => {
+    expect(formatReleaseSpec(entry(versionId('1.2.5'), 'regular', ''))).toBe('1.2.5')
+  })
+})
+
+describe('formatReleaseSpec round-trips through parseReleaseSpec + resolveReleaseEntries', () => {
+  const known = collectKnownVersions({ remoteBranches: ['release/v1.63.0'] })
+
+  const roundTrip = (entry: ReleaseEntry): ReleaseEntry => {
+    return resolveReleaseEntries([parseReleaseSpec(formatReleaseSpec(entry))], known)[0] as ReleaseEntry
+  }
+
+  const cases: ReleaseEntry[] = [
+    { id: versionId('1.2.5'), type: 'regular' },
+    { id: versionId('1.2.5'), type: 'hotfix' },
+    { id: versionId('1.2.5'), type: 'regular', description: 'Holiday: backend' },
+    { id: nameId('checkout-redesign'), type: 'regular' },
+    { id: nameId('checkout-redesign'), type: 'hotfix' },
+    { id: nameId('checkout-redesign'), type: 'regular', description: 'Q3 work' },
+  ]
+
+  it.each(cases)('reconstructs %o', (entry) => {
+    expect(roundTrip(entry)).toEqual(entry)
+  })
 })
 
 describe('resolveReleaseEntries', () => {

package/src/lib/version-utils/index.ts

@@ -3,6 +3,7 @@ export {
   collectKnownVersions,
   computeNextVersion,
   type ExistingVersionsSources,
+  formatReleaseSpec,
   hasNextToken,
   type NamedReleaseInput,
   NEXT_TOKEN,

package/src/lib/version-utils/next-version.ts

@@ -144,40 +144,81 @@ const isNamedReleaseInput = (input: ReleaseInput): input is NamedReleaseInput =>
 }
 
 /**
- * Parse a CLI release spec of the form `version[:type[:description]]`.
- * Type defaults to "regular". Description is everything after the second
- * colon, so colons inside descriptions are preserved.
+ * Parse a CLI release spec of the form `<token>[:type[:description]]` into a
+ * {@link ReleaseInput}. The token determines the kind: a semver (`"1.2.5"`) or
+ * the literal `"next"` yields a versioned {@link ReleaseSpec}; anything else is
+ * treated as a named release ({@link NamedReleaseInput}) — the name is not
+ * validated here, {@link resolveReleaseEntries} runs `validateName` later. Type
+ * defaults to "regular". Description is everything after the second colon, so
+ * colons inside descriptions are preserved.
  */
-export const parseReleaseSpec = (raw: string): ReleaseSpec => {
+export const parseReleaseSpec = (raw: string): ReleaseInput => {
   const spec = raw.trim()
 
   if (spec === '') throw new Error('Release spec is empty')
 
   const firstColon = spec.indexOf(':')
+  let token = spec
+  let type: ReleaseType = 'regular'
+  let description = ''
 
-  if (firstColon === -1) {
-    return { version: spec, type: 'regular' }
+  if (firstColon !== -1) {
+    token = spec.slice(0, firstColon).trim()
+    const rest = spec.slice(firstColon + 1)
+    const secondColon = rest.indexOf(':')
+    const typeRaw = secondColon === -1 ? rest.trim() : rest.slice(0, secondColon).trim()
+
+    description = secondColon === -1 ? '' : rest.slice(secondColon + 1).trim()
+    const typeLower = typeRaw.toLowerCase()
+
+    if (!isReleaseType(typeLower)) {
+      throw new Error(`Invalid release type "${typeRaw}". Expected "regular" or "hotfix".`)
+    }
+
+    type = typeLower
   }
 
-  const version = spec.slice(0, firstColon).trim()
-  const rest = spec.slice(firstColon + 1)
-  const secondColon = rest.indexOf(':')
+  // A semver token or the "next" token is a versioned release; everything else
+  // is a named release. parseReleaseRef applies the same precedence downstream.
+  // Note: tryParse strips a leading "release/" prefix, so "release/1.2.3" reads
+  // as the version 1.2.3 (a real name can never contain a slash anyway).
+  if (isNextToken(token) || tryParse(token) !== null) {
+    const entry: ReleaseSpec = { version: token, type }
 
-  const typeRaw = secondColon === -1 ? rest.trim() : rest.slice(0, secondColon).trim()
-  const description = secondColon === -1 ? '' : rest.slice(secondColon + 1).trim()
-  const typeLower = typeRaw.toLowerCase()
+    if (description !== '') entry.description = description
 
-  if (!isReleaseType(typeLower)) {
-    throw new Error(`Invalid release type "${typeRaw}". Expected "regular" or "hotfix".`)
+    return entry
   }
 
-  const entry: ReleaseSpec = { version, type: typeLower }
+  const entry: NamedReleaseInput = { name: token, type }
 
   if (description !== '') entry.description = description
 
   return entry
 }
 
+/**
+ * Render a resolved {@link ReleaseEntry} as the canonical `--release` spec that
+ * reproduces it — the inverse of {@link parseReleaseSpec} composed with
+ * {@link resolveReleaseEntries}. The form is minimal: the bare token when the
+ * release is `regular` with no description, `token:hotfix` for a hotfix with no
+ * description, and `token:type:description` whenever a description is present
+ * (the type segment is required to reach the description segment). The token is
+ * the resolved {@link ReleaseId.raw} — a concrete semver for versions (so a
+ * resolved `"next"` pins its computed version) or the name for named releases.
+ */
+export const formatReleaseSpec = (entry: ReleaseEntry): string => {
+  const token = entry.id.raw
+
+  if (entry.description !== undefined && entry.description !== '') {
+    return `${token}:${entry.type}:${entry.description}`
+  }
+
+  if (entry.type === 'hotfix') return `${token}:hotfix`
+
+  return token
+}
+
 const withDescription = (base: { id: ReleaseId; type: ReleaseType }, description?: string): ReleaseEntry => {
   return description !== undefined && description !== '' ? { ...base, description } : base
 }

package/src/mcp/tools/index.ts

@@ -16,6 +16,7 @@ import { versionMcpTool } from 'src/commands/version'
 import { worktreesAddMcpTool } from 'src/commands/worktrees-add'
 import { worktreesListMcpTool } from 'src/commands/worktrees-list'
 import { worktreesOpenMcpTool } from 'src/commands/worktrees-open'
+import { worktreesReloadMcpTool } from 'src/commands/worktrees-reload'
 import { worktreesRemoveMcpTool } from 'src/commands/worktrees-remove'
 import { worktreesSyncMcpTool } from 'src/commands/worktrees-sync'
 import { createToolHandler } from 'src/lib/tool-handler'
@@ -37,6 +38,7 @@ const tools = [
   worktreesAddMcpTool,
   worktreesListMcpTool,
   worktreesOpenMcpTool,
+  worktreesReloadMcpTool,
   worktreesRemoveMcpTool,
   worktreesSyncMcpTool,
 ]