felenova-backlog 0.1.0

package/dist/commands/status.js

@@ -0,0 +1,141 @@
+import { ApiError } from '../api.js';
+import { gitignoreCache, readStatusCache, writeStatusCache } from '../cache.js';
+import { asArray, asRecord, jsonResult, pad, plural, renderFailure, resolveContext, text, } from './common.js';
+function roleOf(projects, slug) {
+    for (const entry of asArray(projects)) {
+        const row = asRecord(entry);
+        if (row.slug === slug)
+            return typeof row.role === 'string' ? row.role : null;
+    }
+    return null;
+}
+/** `plugin_20260912  feature  EXECUTE/IN_PROGRESS  last report <iso>  2 items  drift` */
+function trackLine(entry) {
+    const detail = asRecord(entry);
+    const track = asRecord(detail.track);
+    const loop = asRecord(detail.loop);
+    const step = text(loop.loop_step, 'no report');
+    const status = text(loop.loop_status, '-');
+    const cells = [
+        pad(text(track.slug), 24),
+        pad(text(track.type), 10),
+        pad(loop.loop_step ? `${step}/${status}` : step, 24),
+        `last report ${text(loop.last_report_at, 'never')}`,
+        plural(asArray(track.backlog_ids).length, 'item'),
+    ];
+    if (track.spec_drift === true)
+        cells.push('drift');
+    return `  ${cells.join('  ')}`;
+}
+/** `PLG-001  P1  locked  plugin_20260912  the command set` */
+function itemLine(entry) {
+    const item = asRecord(entry);
+    return `    ${pad(text(item.id), 12)}${pad(text(item.priority), 4)}${pad(text(item.criteria_status), 10)}${pad(text(item.track), 22)}${text(item.title, '(untitled)')}`;
+}
+const STATUS_ORDER = ['in-progress', 'promoted', 'scheduled', 'backlog', 'shipped', 'rejected'];
+function render(view) {
+    const lines = [];
+    lines.push(`project ${view.project} (${view.role ?? 'role unknown'}) — ${view.url}`);
+    const tracks = view.tracks;
+    if (tracks.length === 0) {
+        lines.push('active tracks: none');
+    }
+    else {
+        lines.push(`active tracks (${tracks.length}):`);
+        for (const track of tracks)
+            lines.push(trackLine(track));
+    }
+    const items = view.items;
+    if (items.length === 0) {
+        lines.push('items: none');
+    }
+    else {
+        lines.push('items by status:');
+        const groups = new Map();
+        for (const item of items) {
+            const status = text(asRecord(item).status, 'unknown');
+            const bucket = groups.get(status);
+            if (bucket)
+                bucket.push(item);
+            else
+                groups.set(status, [item]);
+        }
+        const names = [...groups.keys()].sort((a, b) => {
+            const ia = STATUS_ORDER.indexOf(a);
+            const ib = STATUS_ORDER.indexOf(b);
+            return (ia === -1 ? STATUS_ORDER.length : ia) - (ib === -1 ? STATUS_ORDER.length : ib);
+        });
+        for (const name of names) {
+            const group = groups.get(name) ?? [];
+            lines.push(`  ${name} (${group.length})`);
+            for (const item of group)
+                lines.push(itemLine(item));
+        }
+    }
+    // An item the register says is promoted, with no active track carrying it, is the drift the
+    // §12 friction list warns about: work that was handed over and then dropped.
+    const activeSlugs = new Set(view.tracks.map((entry) => text(asRecord(asRecord(entry).track).slug, '')));
+    const orphans = view.items
+        .map((entry) => asRecord(entry))
+        .filter((item) => item.status === 'promoted' &&
+        !(typeof item.track === 'string' && activeSlugs.has(item.track)))
+        .map((item) => text(item.id));
+    if (orphans.length > 0) {
+        lines.push(`orphans (promoted, no active track): ${orphans.join(', ')}`);
+    }
+    return lines;
+}
+function fromCache(cache) {
+    return {
+        project: cache.project,
+        url: cache.url,
+        role: cache.role,
+        tracks: cache.tracks,
+        items: cache.items,
+    };
+}
+export async function runStatus(io, flags) {
+    let ctx;
+    try {
+        ctx = resolveContext('status', io, flags);
+    }
+    catch (err) {
+        return { ok: false, lines: [renderFailure(err, { command: 'status' })] };
+    }
+    const slug = encodeURIComponent(ctx.project);
+    try {
+        const projects = await ctx.client.get('/v1/projects');
+        const tracks = await ctx.client.get(`/v1/projects/${slug}/tracks?active_only=true`);
+        const items = await ctx.client.get(`/v1/projects/${slug}/items`);
+        const view = {
+            project: ctx.project,
+            url: ctx.url,
+            role: roleOf(projects, ctx.project),
+            tracks: asArray(tracks),
+            items: asArray(items),
+        };
+        // The cache is warmed only once every read has answered, so a half-failed run can never
+        // leave a truncated view behind.
+        writeStatusCache(ctx.root, view);
+        gitignoreCache(ctx.root);
+        return flags.json ? jsonResult(view) : { ok: true, lines: render(view) };
+    }
+    catch (err) {
+        // Only `unreachable` is an offline condition. A refusal (forbidden, not_found) is an answer
+        // from the service and must be shown as one — printing a cached view then would be a lie.
+        if (err instanceof ApiError && err.code === 'unreachable') {
+            const cache = readStatusCache(ctx.root, { url: ctx.url, project: ctx.project });
+            if (cache) {
+                const view = fromCache(cache);
+                if (flags.json)
+                    return jsonResult({ ...view, fetched_at: cache.fetched_at, cached: true });
+                return {
+                    ok: true,
+                    lines: [`cached from ${cache.fetched_at} — the service is unreachable`, ...render(view)],
+                };
+            }
+        }
+        return { ok: false, lines: [renderFailure(err, ctx.ctx)] };
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"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"}

package/dist/commands/sync.d.ts

@@ -0,0 +1,17 @@
+import type { TargetFlags } from '../config.js';
+import { type CommandIo, type CommandResult } from './common.js';
+/**
+ * `backlog sync [<track>]` — clears the drift flag on the service and brings the repo's copy
+ * of the contract back in line (DECISION-018).
+ *
+ * **`spec.md` only.** `plan.md` and `metadata.json` carry local state — the plan a human
+ * wrote, the loop step the Evaluate-Loop is on, the shipment stamp — and none of it is in the
+ * register. Re-rendering either would throw away work the CLI does not own, so a sync writes
+ * exactly one file and the tests assert the other two are byte-identical afterwards.
+ */
+export interface SyncFlags extends TargetFlags {
+    /** Absent: every active track the register flags as drifted. */
+    track?: string | undefined;
+    json?: boolean | undefined;
+}
+export declare function runSync(io: CommandIo, flags: SyncFlags): Promise<CommandResult>;

package/dist/commands/sync.js

@@ -0,0 +1,90 @@
+import { existsSync, writeFileSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { renderTrackSpec, trackBaseName } from '../_core/index.js';
+import { asArray, asRecord, jsonResult, runCommand, text, } from './common.js';
+/** The newest criteria version the payload carries — what the re-render is taken at. */
+function criteriaVersion(detail) {
+    let best = null;
+    for (const entry of asArray(detail.spec)) {
+        const version = asRecord(entry).criteria_version;
+        if (typeof version === 'number' && (best === null || version > best))
+            best = version;
+    }
+    return best;
+}
+function trackDir(ctx, slug) {
+    return join(ctx.root, ctx.conductorDir, 'tracks', slug);
+}
+/** One track: POST, re-render, and say what moved. */
+async function syncOne(ctx, slug) {
+    const payload = await ctx.client.post(`/v1/tracks/${encodeURIComponent(ctx.project)}/${encodeURIComponent(slug)}/sync`);
+    const detail = asRecord(payload);
+    const driftFrom = detail.drift_from_version;
+    const lines = [
+        typeof driftFrom === 'number'
+            ? `drift before: spec taken at criteria v${driftFrom}`
+            : 'drift before: the register cleared the flag with this sync',
+    ];
+    const specPath = join(trackDir(ctx, slug), 'spec.md');
+    writeFileSync(specPath, renderTrackSpec(detail, {
+        name: trackBaseName(slug),
+    }), 'utf8');
+    const version = criteriaVersion(detail);
+    lines.push(`${relative(ctx.root, specPath)} re-rendered from criteria ${version === null ? 'the register' : `v${version}`}`);
+    const matrix = asRecord(detail.matrix);
+    const superseded = asArray(matrix.superseded).map((r) => text(r, '?'));
+    const added = asArray(matrix.added).map((r) => text(r, '?'));
+    for (const row of superseded)
+        lines.push(`⏭️ ${row} superseded`);
+    for (const row of added)
+        lines.push(`☐ ${row} added`);
+    if (superseded.length === 0 && added.length === 0)
+        lines.push('no matrix changes');
+    lines.push(asRecord(detail.track).spec_drift === true
+        ? `drift after: still drifted — re-read the items and run: backlog sync ${slug}`
+        : 'drift after: in line with the register');
+    return { lines, payload };
+}
+export async function runSync(io, flags) {
+    return runCommand('sync', io, flags, async (ctx) => {
+        const asked = flags.track?.trim();
+        if (asked) {
+            const dir = trackDir(ctx, asked);
+            if (!existsSync(dir)) {
+                return {
+                    ok: false,
+                    lines: [
+                        `no track directory at ${relative(ctx.root, dir)} — run: backlog promote <ID…> --track ${asked}`,
+                    ],
+                };
+            }
+            const { lines, payload } = await syncOne(ctx, asked);
+            return flags.json ? jsonResult(payload) : { ok: true, lines };
+        }
+        // No slug: every active track the register says has drifted. The list is the service's
+        // call, not a local scan — a directory on disk proves nothing about the contract.
+        const listed = asArray(await ctx.client.get(`/v1/projects/${encodeURIComponent(ctx.project)}/tracks?active_only=true`));
+        const drifted = listed
+            .map((entry) => asRecord(asRecord(entry).track))
+            .filter((track) => track.spec_drift === true)
+            .map((track) => text(track.slug, ''))
+            .filter((slug) => slug !== '');
+        if (drifted.length === 0) {
+            return { ok: true, lines: ['no active track has drifted — nothing to sync'] };
+        }
+        const lines = [];
+        const payloads = [];
+        for (const slug of drifted) {
+            const dir = trackDir(ctx, slug);
+            if (!existsSync(dir)) {
+                lines.push(`${slug}: no track directory at ${relative(ctx.root, dir)} — skipped (run: backlog promote … --track ${slug})`);
+                continue;
+            }
+            const one = await syncOne(ctx, slug);
+            payloads.push(one.payload);
+            lines.push(`track ${slug}:`, ...one.lines.map((l) => `  ${l}`));
+        }
+        return flags.json ? jsonResult(payloads) : { ok: true, lines };
+    });
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"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"}

package/dist/conductor/registry.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The two conductor registry files the plugin is allowed to edit: `tracks.md`'s tables and
+ * `index.md`'s Recent Completions (§7.3 — nothing else about conductor changes). Both are
+ * edited **line-wise, in place**: a row is appended or one cell is flipped, and every other
+ * byte of a human-maintained file survives. There is no re-render of these files anywhere.
+ */
+export interface ActiveTrackRow {
+    track_id: string;
+    name: string;
+    type: string;
+    priority: string;
+    /** Defaults to `in_progress` — the only status a freshly promoted track can have. */
+    status?: string | undefined;
+    /** Defaults to the previous last active track, then `—`. */
+    depends_on?: string | undefined;
+}
+export declare const ACTIVE_HEADING = "## Active Tracks";
+export declare const ACTIVE_COLUMNS = "| Track ID | Name | Type | Priority | Status | Depends On |";
+/** What `promote` writes when a repo has no `conductor/tracks.md` yet. */
+export declare const TRACKS_MD_SKELETON = "# Conductor Track Registry\n\n## Active Tracks\n| Track ID | Name | Type | Priority | Status | Depends On |\n|---|---|---|---|---|---|\n\n## Next (promote only when the backlog items are `locked`)\n| Track ID | Backlog IDs | Name |\n|---|---|---|\n";
+export declare class RegistryError extends Error {
+    constructor(message: string);
+}
+/** The bottom-most Active row's track id — the conventional `Depends On` for a new track. */
+export declare function lastActiveTrack(text: string | null): string | null;
+/**
+ * Appends one Active row. `text: null` means the file does not exist and the skeleton is
+ * written around it. A track that already has a row is a refusal, not a duplicate row:
+ * `promote` has already refused the directory, so this can only be a half-done earlier run.
+ */
+export declare function addActiveTrack(text: string | null, row: ActiveTrackRow): string;
+/** Flips the Status cell of one Active row. `null` when the track has no row. */
+export declare function setTrackStatus(text: string, trackId: string, status: string): string | null;
+/**
+ * Drops the Next row this promotion consumed — by slug (with or without the date stamp), or
+ * by the backlog ids it lists. A row that names ids we did not promote is left alone.
+ */
+export declare function dropNextRow(text: string, trackId: string, ids: readonly string[]): string;
+export interface CompletionRow {
+    track: string;
+    date: string;
+    notes: string;
+}
+/** §6 step 4. `null` when `index.md` has no Recent Completions table to append to. */
+export declare function addRecentCompletion(text: string, row: CompletionRow): string | null;

package/dist/conductor/registry.js

@@ -0,0 +1,164 @@
+import { trackBaseName } from '../_core/index.js';
+export const ACTIVE_HEADING = '## Active Tracks';
+export const ACTIVE_COLUMNS = '| Track ID | Name | Type | Priority | Status | Depends On |';
+const NEXT_HEADING_PREFIX = '## Next';
+const COMPLETIONS_HEADING = '## Recent Completions';
+const DASH = '—';
+/** What `promote` writes when a repo has no `conductor/tracks.md` yet. */
+export const TRACKS_MD_SKELETON = `# Conductor Track Registry
+
+${ACTIVE_HEADING}
+${ACTIVE_COLUMNS}
+|---|---|---|---|---|---|
+
+${NEXT_HEADING_PREFIX} (promote only when the backlog items are \`locked\`)
+| Track ID | Backlog IDs | Name |
+|---|---|---|
+`;
+export class RegistryError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'RegistryError';
+    }
+}
+function cells(line) {
+    return line
+        .replace(/^\|/, '')
+        .replace(/\|\s*$/, '')
+        .split('|')
+        .map((c) => c.trim());
+}
+function isRow(line) {
+    return line.trimStart().startsWith('|');
+}
+function isSeparator(line) {
+    return /^\|[\s:|-]+\|$/.test(line.trim());
+}
+/** The `[first, lastExclusive)` line range of the table under a heading, or null. */
+function tableRange(lines, matches) {
+    const heading = lines.findIndex((l) => matches(l));
+    if (heading === -1)
+        return null;
+    let i = heading + 1;
+    while (i < lines.length && !isRow(lines[i]) && !lines[i].startsWith('## '))
+        i += 1;
+    if (i >= lines.length || !isRow(lines[i]))
+        return null;
+    const start = i;
+    while (i < lines.length && isRow(lines[i]))
+        i += 1;
+    return { start, end: i };
+}
+function activeRange(lines) {
+    return tableRange(lines, (l) => l.trim() === ACTIVE_HEADING);
+}
+function nextRange(lines) {
+    return tableRange(lines, (l) => l.startsWith(NEXT_HEADING_PREFIX));
+}
+/** Data rows only — the header and the `|---|` separator are not rows of the table's content. */
+function dataRows(lines, range) {
+    const out = [];
+    for (let i = range.start; i < range.end; i += 1) {
+        if (isSeparator(lines[i]))
+            continue;
+        const first = cells(lines[i])[0] ?? '';
+        if (first === 'Track ID')
+            continue;
+        out.push(i);
+    }
+    return out;
+}
+/** The bottom-most Active row's track id — the conventional `Depends On` for a new track. */
+export function lastActiveTrack(text) {
+    if (text === null)
+        return null;
+    const lines = text.split('\n');
+    const range = activeRange(lines);
+    if (!range)
+        return null;
+    const rows = dataRows(lines, range);
+    if (rows.length === 0)
+        return null;
+    return cells(lines[rows[rows.length - 1]])[0] ?? null;
+}
+/**
+ * Appends one Active row. `text: null` means the file does not exist and the skeleton is
+ * written around it. A track that already has a row is a refusal, not a duplicate row:
+ * `promote` has already refused the directory, so this can only be a half-done earlier run.
+ */
+export function addActiveTrack(text, row) {
+    const body = text ?? TRACKS_MD_SKELETON;
+    const lines = body.split('\n');
+    const range = activeRange(lines);
+    if (!range) {
+        throw new RegistryError(`conductor/tracks.md has no "${ACTIVE_HEADING}" table — add one (or delete the file and re-run)`);
+    }
+    for (const i of dataRows(lines, range)) {
+        if (cells(lines[i])[0] === row.track_id) {
+            throw new RegistryError(`conductor/tracks.md already has a row for ${row.track_id}`);
+        }
+    }
+    const dependsOn = row.depends_on ?? lastActiveTrack(body) ?? DASH;
+    const rendered = `| ${row.track_id} | ${row.name} | ${row.type} | ${row.priority} | ${row.status ?? 'in_progress'} | ${dependsOn} |`;
+    lines.splice(range.end, 0, rendered);
+    return lines.join('\n');
+}
+/** Flips the Status cell of one Active row. `null` when the track has no row. */
+export function setTrackStatus(text, trackId, status) {
+    const lines = text.split('\n');
+    const range = activeRange(lines);
+    if (!range)
+        return null;
+    for (const i of dataRows(lines, range)) {
+        const parts = cells(lines[i]);
+        if (parts[0] !== trackId)
+            continue;
+        if (parts.length < 5)
+            return null;
+        parts[4] = status;
+        lines[i] = `| ${parts.join(' | ')} |`;
+        return lines.join('\n');
+    }
+    return null;
+}
+/**
+ * Drops the Next row this promotion consumed — by slug (with or without the date stamp), or
+ * by the backlog ids it lists. A row that names ids we did not promote is left alone.
+ */
+export function dropNextRow(text, trackId, ids) {
+    const lines = text.split('\n');
+    const range = nextRange(lines);
+    if (!range)
+        return text;
+    const promoted = new Set(ids);
+    const base = trackBaseName(trackId);
+    for (const i of dataRows(lines, range)) {
+        const parts = cells(lines[i]);
+        const slug = parts[0] ?? '';
+        const listed = (parts[1] ?? '')
+            .split(',')
+            .map((r) => r.trim())
+            .filter((r) => r !== '');
+        const bySlug = slug === trackId || slug === base || trackBaseName(slug) === base;
+        const byIds = listed.length > 0 && listed.every((r) => promoted.has(r));
+        if (bySlug || byIds) {
+            lines.splice(i, 1);
+            return lines.join('\n');
+        }
+    }
+    return text;
+}
+/** §6 step 4. `null` when `index.md` has no Recent Completions table to append to. */
+export function addRecentCompletion(text, row) {
+    const lines = text.split('\n');
+    const range = tableRange(lines, (l) => l.trim() === COMPLETIONS_HEADING);
+    if (!range)
+        return null;
+    for (let i = range.start; i < range.end; i += 1) {
+        if (cells(lines[i])[0] === row.track)
+            return null;
+    }
+    lines.splice(range.end, 0, `| ${row.track} | ${row.date} | ${row.notes} |`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=registry.js.map

package/dist/conductor/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/conductor/registry.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,47 @@
+/** The committed, token-free project file (DECISION-026). */
+export declare const CONFIG_FILENAME = "backlog.config.json";
+/**
+ * Exactly three keys — a service URL, a project slug and the conductor directory.
+ * `prefixes`/`environments` are service state: a stale copy in a committed file is a bug,
+ * so they are deliberately absent (DECISION-026).
+ */
+export interface BacklogConfig {
+    url: string;
+    project: string;
+    conductor_dir: string;
+}
+export interface LoadedConfig {
+    config: BacklogConfig;
+    path: string;
+}
+/** A refusal about the config file itself: always names the file and the offending key. */
+export declare class ConfigError extends Error {
+    readonly path: string;
+    constructor(path: string, message: string);
+}
+/** Walks up from `cwd` looking for `backlog.config.json`. Returns its path, or null. */
+export declare function findConfig(cwd: string): string | null;
+/** Reads and validates one config file. Throws `ConfigError` on anything but the exact shape. */
+export declare function readConfig(path: string): BacklogConfig;
+/** Walk-up + read. Null when no config exists above `cwd`; throws when one exists but is bad. */
+export declare function loadConfig(cwd: string): LoadedConfig | null;
+/** Writes the three keys, validated first so a bad object can never reach a tracked file. */
+export declare function writeConfig(path: string, config: BacklogConfig): void;
+export interface TargetFlags {
+    url?: string | undefined;
+    project?: string | undefined;
+}
+export interface ResolvedTarget {
+    url: string;
+    project: string;
+    conductor_dir: string;
+    /** Where the project came from — the strongest source that contributed. */
+    source: 'flag' | 'env' | 'config';
+    configPath: string | null;
+}
+/**
+ * Precedence for every command: `--url`/`--project` → `BACKLOG_URL`/`BACKLOG_PROJECT` →
+ * the config file → a refusal pointing at `backlog init`. Resolved per field, so a flag
+ * can name a project while the URL still comes from the committed file.
+ */
+export declare function resolveTarget(flags: TargetFlags, env: NodeJS.ProcessEnv, cwd: string): ResolvedTarget;