mirror of
https://github.com/Start9Labs/start-os.git
synced 2026-03-26 10:21:52 +00:00
f2142f0bb3
* add documentation for ai agents * docs: consolidate CLAUDE.md and CONTRIBUTING.md, add style guidelines - Refactor CLAUDE.md to reference CONTRIBUTING.md for build/test/format info - Expand CONTRIBUTING.md with comprehensive build targets, env vars, and testing - Add code style guidelines section with conventional commits - Standardize SDK prettier config to use single quotes (matching web) - Add project-level Claude Code settings to disable co-author attribution * style(sdk): apply prettier with single quotes Run prettier across sdk/base and sdk/package to apply the standardized quote style (single quotes matching web). * docs: add USER.md for per-developer TODO filtering - Add agents/USER.md to .gitignore (contains user identifier) - Document session startup flow in CLAUDE.md: - Create USER.md if missing, prompting for identifier - Filter TODOs by @username tags - Offer relevant TODOs on session start * docs: add i18n documentation task to agent TODOs * docs: document i18n ID patterns in core/ Add agents/i18n-patterns.md covering rust-i18n setup, translation file format, t!() macro usage, key naming conventions, and locale selection. Remove completed TODO item and add reference in CLAUDE.md. * chore: clarify that all builds work on any OS with Docker
90 lines
2.8 KiB
TypeScript
90 lines
2.8 KiB
TypeScript
import { ValidateExVer } from '../../../base/lib/exver'
|
|
import * as T from '../../../base/lib/types'
|
|
|
|
export const IMPOSSIBLE: unique symbol = Symbol('IMPOSSIBLE')
|
|
|
|
export type VersionOptions<Version extends string> = {
|
|
/** The exver-compliant version number */
|
|
version: Version & ValidateExVer<Version>
|
|
/** The release notes for this version */
|
|
releaseNotes: T.LocaleString
|
|
/** Data migrations for this version */
|
|
migrations: {
|
|
/**
|
|
* A migration from the previous version. Leave empty to indicate no migration is necessary.
|
|
* Set to `IMPOSSIBLE` to indicate migrating from the previous version is not possible.
|
|
*/
|
|
up?: ((opts: { effects: T.Effects }) => Promise<void>) | typeof IMPOSSIBLE
|
|
/**
|
|
* A migration to the previous version. Leave blank to indicate no migration is necessary.
|
|
* Set to `IMPOSSIBLE` to indicate downgrades are prohibited
|
|
*/
|
|
down?: ((opts: { effects: T.Effects }) => Promise<void>) | typeof IMPOSSIBLE
|
|
/**
|
|
* Additional migrations, such as fast-forward migrations, or migrations from other flavors.
|
|
*/
|
|
other?: Record<
|
|
string,
|
|
{
|
|
up?: (opts: { effects: T.Effects }) => Promise<void>
|
|
down?: (opts: { effects: T.Effects }) => Promise<void>
|
|
}
|
|
>
|
|
}
|
|
}
|
|
|
|
export class VersionInfo<Version extends string> {
|
|
private _version: null | Version = null
|
|
private constructor(
|
|
readonly options: VersionOptions<Version> & { satisfies: string[] },
|
|
) {}
|
|
/**
|
|
* @description Use this function to define a new version of the service. By convention, each version should receive its own file.
|
|
* @property {string} version
|
|
* @property {string} releaseNotes
|
|
* @property {object} migrations
|
|
* @returns A VersionInfo class instance that is exported, then imported into versions/index.ts.
|
|
*/
|
|
static of<Version extends string>(options: VersionOptions<Version>) {
|
|
return new VersionInfo<Version>({ ...options, satisfies: [] })
|
|
}
|
|
/** Specify a version that this version is 100% backwards compatible to */
|
|
satisfies<V extends string>(
|
|
version: V & ValidateExVer<V>,
|
|
): VersionInfo<Version> {
|
|
return new VersionInfo({
|
|
...this.options,
|
|
satisfies: [...this.options.satisfies, version],
|
|
})
|
|
}
|
|
}
|
|
|
|
function __type_tests() {
|
|
const version: VersionInfo<'1.0.0:0'> = VersionInfo.of({
|
|
version: '1.0.0:0',
|
|
releaseNotes: '',
|
|
migrations: {},
|
|
})
|
|
.satisfies('#other:1.0.0:0')
|
|
.satisfies('#other:2.0.0:0')
|
|
// @ts-expect-error
|
|
.satisfies('#other:2.f.0:0')
|
|
|
|
let a: VersionInfo<'1.0.0:0'> = version
|
|
// @ts-expect-error
|
|
let b: VersionInfo<'1.0.0:3'> = version
|
|
|
|
VersionInfo.of({
|
|
// @ts-expect-error
|
|
version: 'test',
|
|
releaseNotes: '',
|
|
migrations: {},
|
|
})
|
|
VersionInfo.of({
|
|
// @ts-expect-error
|
|
version: 'test' as string,
|
|
releaseNotes: '',
|
|
migrations: {},
|
|
})
|
|
}
|