mirror of
https://github.com/garrytan/gstack.git
synced 2026-11-10 10:40:32 +01:00
garrytanandcapy-ai[bot]
ee7b341e5d
RunState gains gstack_version, plan_input/heading, scope_flags, plan_revision, amendments and plan_reality; voices record receipt kind and reviewed hash. New pure modules: Implementation-plan review hash, scaffold and drift lines (B1c); gstack_version stamp and legacy decision-id migration (B1a); install-verdict and Bun-minimum admission with a local verdict shim until lane A's lib/install-verdict.ts lands. Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> bin/gstack-autoplan-snapshot.ts exports its section scanner and review projection, and initializes only a plan with no section headings by wrapping it. Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
60 lines
3.1 KiB
TypeScript
60 lines
3.1 KiB
TypeScript
/**
|
|
* autoplan-migrate — forward migrations a run directory gets when a newer
|
|
* gstack opens it (plan B1a amendment). Called under the run lock before
|
|
* every mutating verb: `run.json.gstack_version` older than this gstack (or
|
|
* absent, a run written before 1.91.96) prints GSTACK_VERSION_CHANGED once
|
|
* and journals `gstack_version_changed`; a run written by a newer gstack
|
|
* refuses. Decision ids minted before 1.91.95 (`<run>-<label>` at gate_rev > 1,
|
|
* which collide with gate_rev 1) are rewritten through `decisionId` once,
|
|
* journaled as `decision_ids_migrated`. Safe: such runs never validated and
|
|
* `gstack-artifact ack` refuses invalid runs, so no consumer holds the old ids.
|
|
*/
|
|
import * as fs from 'node:fs';
|
|
import * as path from 'node:path';
|
|
import { decisionId } from './gate-list';
|
|
import { RunError, journal, readDecisions, writeDecisions, type RunState } from './autoplan-state';
|
|
|
|
export const GSTACK_VERSION = fs.readFileSync(path.join(import.meta.dir, '..', 'VERSION'), 'utf8').trim();
|
|
|
|
/** Numeric compare of dotted versions (1.91.95.0); missing parts are 0. */
|
|
export function compareVersions(a: string, b: string): number {
|
|
const pa = a.split('.').map(Number), pb = b.split('.').map(Number);
|
|
for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
|
|
const d = (pa[i] ?? 0) - (pb[i] ?? 0);
|
|
if (d) return Math.sign(d);
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
/** Rewrite `<run>-<label>` ids at gate_rev > 1 to `<run>-r<rev>-<label>`; returns how many rows changed. Idempotent. */
|
|
export function migrateLegacyDecisionIds(state: RunState): number {
|
|
const rows = readDecisions(state.out);
|
|
let n = 0;
|
|
const next = rows.map(row => {
|
|
if (row.gate_rev <= 1 || !row.label || row.id !== `${state.run}-${row.label.toLowerCase()}`) return row;
|
|
n++;
|
|
return { ...row, id: decisionId(state.run, row.gate_rev, row.label.toLowerCase()) };
|
|
});
|
|
if (!n) return 0;
|
|
writeDecisions(state.out, next);
|
|
journal(state.out, { event: 'decision_ids_migrated', n });
|
|
(state.deviations ??= []).push(`legacy decision ids rewritten (${n})`);
|
|
return n;
|
|
}
|
|
|
|
/** Bring a run directory forward to this gstack; returns the notice lines and whether run.json must be written. */
|
|
export function migrateRun(state: RunState): { lines: string[]; changed: boolean } {
|
|
const from = state.gstack_version;
|
|
if (from && compareVersions(from, GSTACK_VERSION) > 0) {
|
|
throw new RunError('GSTACK_VERSION_CHANGED', `run ${state.run} was written by gstack ${from}; this is ${GSTACK_VERSION}, which cannot read newer state`, 3);
|
|
}
|
|
const lines: string[] = [];
|
|
const migrated = migrateLegacyDecisionIds(state);
|
|
if (from === GSTACK_VERSION) return { lines, changed: migrated > 0 };
|
|
const migrations = migrated ? [`decision ids rewritten (${migrated})`] : [];
|
|
journal(state.out, { event: 'gstack_version_changed', from: from ?? null, to: GSTACK_VERSION, migrations });
|
|
lines.push(`GSTACK_VERSION_CHANGED: run ${from ?? 'unknown'} -> ${GSTACK_VERSION}; forward migrations: ${migrations.length ? migrations.join(', ') : 'none needed'}`);
|
|
state.gstack_version = GSTACK_VERSION;
|
|
return { lines, changed: true };
|
|
}
|