felenova-backlog 0.1.0

package/dist/errors.js

@@ -0,0 +1,114 @@
+/** Every code with a row, in the order the table below reads. */
+export const ERROR_CODES = [
+    'unreachable',
+    'forbidden',
+    'not_found',
+    'locked',
+    'not_locked',
+    'invalid_transition',
+    'reason_required',
+    'invalid_request',
+    'conflict',
+    'superseded',
+    'internal',
+    'no_session',
+    'token_required',
+    'token_unknown',
+    'token_revoked',
+    'token_expired',
+    'no_member',
+    'rate_limited',
+    'read_only_token',
+    'session_required',
+];
+const MINT = 'mint a new one in the web UI (/me → "Mint a token") and run: backlog init';
+function service(err) {
+    return err.message.trim();
+}
+function withSuffix(err, fallback, suffix) {
+    const head = service(err) || fallback;
+    return `${head} — ${suffix}`;
+}
+function where(ctx) {
+    return ctx.url ?? 'the backlog service';
+}
+/**
+ * `not_found` is the interesting row. The service answers `not_found` for a project the
+ * caller has no role on, deliberately — a project's existence is privileged
+ * (`docs/service/access-control.md`). So when the refusal is about the *configured* project
+ * rather than an item or a track inside it, the CLI says what actually happened.
+ */
+function isProjectNotFound(err, ctx) {
+    const message = err.message.toLowerCase();
+    if (/\bno (item|track|decision|suggestion|row|evidence|token|member)\b/.test(message)) {
+        return false;
+    }
+    if (ctx.project && message.includes(ctx.project.toLowerCase()))
+        return true;
+    if (/\bproject\b/.test(message))
+        return true;
+    // No message at all: with a configured project, membership is the likeliest cause and the
+    // only one the reader can act on.
+    return message === '' && Boolean(ctx.project);
+}
+/** The code → sentence table. Exactly one line, always. */
+export function explain(err, ctx = {}) {
+    const project = ctx.project;
+    switch (err.code) {
+        case 'unreachable':
+            return `cannot reach ${service(err) || where(ctx)} — check the network, or run \`backlog status\` for the cached view`;
+        case 'forbidden':
+            return (service(err) ||
+                `your role${project ? ` on ${project}` : ''} does not allow this — ask the Owner or a Product role to do it, or to widen your role`);
+        case 'not_found':
+            if (isProjectNotFound(err, ctx) && project) {
+                return `you are not a member of ${project} — ask the Owner for a role on it`;
+            }
+            return service(err) || `no such ${ctx.ref ? `ref ${ctx.ref}` : 'item, track or project'}`;
+        case 'locked':
+            return withSuffix(err, 'that item is locked', 'criteria are locked; suggest a change instead (`suggest_change` over MCP, or the web UI)');
+        case 'not_locked':
+            return withSuffix(err, 'the criteria are not locked yet', 'lock the criteria first (web UI, or `lock_criteria` over MCP)');
+        case 'invalid_transition':
+            return service(err) || 'the state machine refused that move — read the current state first';
+        case 'reason_required':
+            return withSuffix(err, 'this call needs a written reason', 'pass a reason');
+        case 'invalid_request':
+            return service(err) || 'the request was malformed — check the arguments and try again';
+        case 'conflict':
+            return (service(err) ||
+                'a state precondition failed — re-read the item or track and act on what it says now');
+        case 'superseded':
+            return withSuffix(err, 'a newer revision exists', 're-read the item and file it again against the current version');
+        case 'internal':
+            return `the service failed on this request — try again; if it repeats, tell the Owner (${where(ctx)})`;
+        case 'no_session':
+            return `no credential reached the service — set BACKLOG_TOKEN or run: backlog init (your token lives at ~/.config/backlog/token)`;
+        case 'token_required':
+            return `this needs a personal access token, not a browser session — ${MINT}`;
+        case 'token_unknown':
+            return `the service does not recognise that token — ${MINT}`;
+        case 'token_revoked':
+            return `that token has been revoked — ${MINT}`;
+        case 'token_expired':
+            return `that token has expired — ${MINT}`;
+        case 'no_member':
+            return 'the service has no org membership for you — ask the Owner to add you, then run: backlog doctor';
+        case 'rate_limited':
+            return 'too many requests for this token (120 per minute) — wait a minute and run the command again';
+        case 'read_only_token':
+            return 'that token is read-only and this command writes — mint a writable PAT in the web UI (/me)';
+        case 'session_required':
+            return withSuffix(err, 'this can only be done from a browser session', 'sign in to the web UI and do it there');
+        default:
+            // An unknown code still renders as a sentence: the service's own message if it sent
+            // one, and otherwise something the reader can report.
+            return (service(err) ||
+                `the service refused this request (${err.code}) — run \`backlog doctor\`, and tell the Owner if it repeats`);
+    }
+}
+/** The plan's name for `explain`. */
+export function renderError(err, ctx = {}) {
+    return explain(err, ctx);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/export.d.ts

@@ -0,0 +1 @@
+export declare function exportFromSnapshotFile(snapshotPath: string, outDir: string): Promise<string[]>;

package/dist/export.js

@@ -0,0 +1,9 @@
+import { readFile } from 'node:fs/promises';
+import { exportProject } from './import.js';
+export async function exportFromSnapshotFile(snapshotPath, outDir) {
+    const snap = JSON.parse(await readFile(snapshotPath, 'utf8'));
+    if (snap.version !== 1)
+        throw new Error(`unsupported snapshot version ${String(snap.version)}`);
+    return exportProject(snap, outDir);
+}
+//# sourceMappingURL=export.js.map

package/dist/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,YAAoB,EACpB,MAAc;IAEd,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAoB,CAAC;IACjF,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChG,OAAO,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC"}

package/dist/import.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectSnapshot } from './snapshot.js';
+export declare function importProject(root: string, project: string): Promise<ProjectSnapshot>;
+export declare function exportProject(snapshot: ProjectSnapshot, outDir: string): Promise<string[]>;

package/dist/import.js

@@ -0,0 +1,89 @@
+import { existsSync } from 'node:fs';
+import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { ItemParseError, parseItem, parseMatrix, serializeItem, serializeMatrix, Track, } from './_core/index.js';
+const DOC_NAMES = ['README.md', 'decisions-owed.md', '_schema.md'];
+export async function importProject(root, project) {
+    const itemsDir = join(root, 'docs/backlog/items');
+    const warnings = [];
+    const problems = [];
+    const items = [];
+    for (const f of (await readdir(itemsDir)).filter((f) => f.endsWith('.md')).sort()) {
+        const rel = `docs/backlog/items/${f}`;
+        try {
+            items.push(parseItem(await readFile(join(root, rel), 'utf8'), rel));
+        }
+        catch (e) {
+            if (e instanceof ItemParseError)
+                problems.push(e.message);
+            else
+                throw e;
+        }
+    }
+    if (problems.length) {
+        throw new Error(`import aborted — ${problems.length} item(s) failed to parse:\n${problems.join('\n')}`);
+    }
+    const docs = {};
+    for (const name of DOC_NAMES) {
+        const rel = `docs/backlog/${name}`;
+        docs[name] = existsSync(join(root, rel))
+            ? { path: rel, raw: await readFile(join(root, rel), 'utf8') }
+            : null;
+    }
+    const tracks = [];
+    const matrices = [];
+    const tracksDir = join(root, 'conductor/tracks');
+    if (existsSync(tracksDir)) {
+        for (const slug of (await readdir(tracksDir)).sort()) {
+            const metaRel = `conductor/tracks/${slug}/metadata.json`;
+            if (!existsSync(join(root, metaRel)))
+                continue;
+            const raw = await readFile(join(root, metaRel), 'utf8');
+            const meta = JSON.parse(raw);
+            const ids = Array.isArray(meta.backlog_ids) ? meta.backlog_ids : [];
+            const qaDoc = typeof meta.qa_doc === 'string' ? meta.qa_doc : null;
+            if (ids.length === 0 && !qaDoc)
+                continue;
+            const track = Track.parse({
+                slug: String(meta.track_id ?? slug),
+                type: String(meta.type ?? 'feature'),
+                backlog_ids: ids,
+                follow_up_backlog: Array.isArray(meta.follow_up_backlog) ? meta.follow_up_backlog : [],
+                qa_doc: qaDoc,
+                qa_enforcement: meta.qa_enforcement === 'strict' ? 'strict' : 'permissive',
+            });
+            tracks.push({ track, metadataPath: metaRel, raw });
+            if (qaDoc) {
+                if (!existsSync(join(root, qaDoc))) {
+                    warnings.push(`${metaRel}: qa_doc ${qaDoc} does not exist — skipped`);
+                    continue;
+                }
+                const doc = parseMatrix(await readFile(join(root, qaDoc), 'utf8'), qaDoc);
+                warnings.push(...doc.warnings);
+                matrices.push({ doc, rows: doc.rows });
+            }
+        }
+    }
+    return { version: 1, project, root, items, tracks, matrices, docs, warnings };
+}
+export async function exportProject(snapshot, outDir) {
+    const written = [];
+    const put = async (rel, text) => {
+        await mkdir(dirname(join(outDir, rel)), { recursive: true });
+        await writeFile(join(outDir, rel), text, 'utf8');
+        written.push(rel);
+    };
+    for (const { item, source } of snapshot.items)
+        await put(source.path, serializeItem(item, source));
+    for (const name of DOC_NAMES) {
+        const d = snapshot.docs[name];
+        if (d)
+            await put(d.path, d.raw);
+    }
+    for (const { doc, rows } of snapshot.matrices)
+        await put(doc.path, serializeMatrix(doc, rows));
+    for (const t of snapshot.tracks)
+        await put(t.metadataPath, t.raw);
+    return written;
+}
+//# sourceMappingURL=import.js.map

package/dist/import.js.map

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

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,183 @@
+import { writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { CORE_VERSION } from './_core/index.js';
+import { Command } from 'commander';
+import { runExport } from './commands/export.js';
+import { runMatrixInit } from './commands/matrix.js';
+import { runNext } from './commands/next.js';
+import { runPromote } from './commands/promote.js';
+import { runReport } from './commands/report.js';
+import { runShip } from './commands/ship.js';
+import { runStatus } from './commands/status.js';
+import { runSync } from './commands/sync.js';
+import { ConfigError } from './config.js';
+import { runDoctorRemote } from './doctor.js';
+import { importProject } from './import.js';
+import { InitError, runInit } from './init/index.js';
+import { MCP_SERVER_KEY } from './init/templates.js';
+import { TokenError } from './token.js';
+const program = new Command('backlog')
+    .description('Felenova backlog — execution plugin CLI')
+    .version(CORE_VERSION);
+/** Every command is a pure function of this; `process` is read in exactly one place. */
+function io() {
+    return { cwd: process.cwd(), home: homedir(), env: process.env };
+}
+/**
+ * One printer for every command: the lines on success, the single refusal sentence on stderr,
+ * and the exit code from `ok`. No command prints JSON, a status code or a stack itself.
+ */
+function emit(result) {
+    for (const line of result.lines) {
+        if (result.ok)
+            console.log(line);
+        else
+            console.error(line);
+    }
+    process.exitCode = result.ok ? 0 : 1;
+}
+/** `--url`/`--project` are on every service-backed command (config → env → flag, Task 1). */
+function withTarget(command) {
+    return command
+        .option('--url <url>', 'backlog service URL (defaults to BACKLOG_URL, then the config)')
+        .option('--project <slug>', 'project slug (defaults to BACKLOG_PROJECT, then the config)');
+}
+program
+    .command('init')
+    .description('Authenticate, write backlog.config.json and .mcp.json, scaffold the conductor')
+    .option('--url <url>', 'backlog service URL (defaults to BACKLOG_URL, then the config)')
+    .option('--project <slug>', 'project slug — must be one this token can see')
+    .option('--token <pat>', 'PAT to use (defaults to BACKLOG_TOKEN, then ~/.config/backlog/token)')
+    .option('--save-token', 'store the PAT at ~/.config/backlog/token (mode 600)')
+    .option('--no-save-token', 'never store the PAT; print the chmod one-liner instead')
+    .option('--yes', 'never prompt; consent to storing the PAT')
+    .option('--force-mcp', `replace a differing "${MCP_SERVER_KEY}" entry in an existing .mcp.json`)
+    .option('--force-plugin', 'replace a plugin skill or command file that has been edited')
+    .action(async (opts) => {
+    try {
+        const result = await runInit({
+            cwd: process.cwd(),
+            home: homedir(),
+            env: process.env,
+            flags: opts,
+        });
+        process.exitCode = result.ok ? 0 : 1;
+    }
+    catch (err) {
+        if (err instanceof InitError || err instanceof TokenError || err instanceof ConfigError) {
+            console.error(err.message);
+            process.exitCode = 1;
+            return;
+        }
+        throw err;
+    }
+});
+program
+    .command('doctor')
+    .description('Check local setup (token, project, conductor)')
+    .option('--url <url>', 'backlog service URL (defaults to BACKLOG_URL)')
+    .option('--project <slug>', 'project slug (defaults to BACKLOG_PROJECT)')
+    .action(async (opts) => {
+    const report = await runDoctorRemote(process.env, { url: opts.url, project: opts.project });
+    for (const c of report.checks) {
+        console.log(`${c.ok ? 'ok  ' : 'FAIL'} ${c.name}${c.ok || !c.hint ? '' : ` — ${c.hint}`}`);
+    }
+    process.exitCode = report.ok ? 0 : 1;
+});
+program
+    .command('import')
+    .description('Read a docs/backlog folder (dry-run by default; --write to save a snapshot)')
+    .argument('<root>', 'repo root containing docs/backlog and conductor/')
+    .requiredOption('--project <name>', 'project name')
+    .option('--write', 'write the snapshot (otherwise dry-run)', false)
+    .option('--out <file>', 'snapshot path', 'backlog-snapshot.json')
+    .action(async (root, opts) => {
+    const snap = await importProject(root, opts.project);
+    console.log(`${snap.items.length} items, ${snap.tracks.length} tracks, ${snap.matrices.length} matrices, ${snap.warnings.length} warnings`);
+    for (const w of snap.warnings)
+        console.log(`  ⚠ ${w}`);
+    if (!opts.write) {
+        console.log('dry-run — pass --write to save the snapshot');
+        return;
+    }
+    await writeFile(opts.out, JSON.stringify(snap, null, 2), 'utf8');
+    console.log(`wrote ${opts.out}`);
+});
+withTarget(program
+    .command('status')
+    .description('What the register says about this project (cached when the service is down)')
+    .option('--json', 'print the raw payload instead of the table')).action(async (opts) => {
+    emit(await runStatus(io(), opts));
+});
+withTarget(program
+    .command('next')
+    .description('The items that are ready to pick up, in order')
+    .option('--limit <n>', 'show at most N items', (value) => Number.parseInt(value, 10))
+    .option('--json', 'print the raw payload instead of the list')).action(async (opts) => {
+    emit(await runNext(io(), opts));
+});
+withTarget(program
+    .command('report')
+    .description('Record Evaluate-Loop progress on a track')
+    .argument('<track>', 'track slug')
+    .argument('<step>', 'PLAN | EVALUATE_PLAN | EXECUTE | EVALUATE_EXECUTION | FIX | COMPLETE')
+    .argument('<status>', 'IN_PROGRESS | PASS | FAIL | COMPLETE')
+    .option('--note <text>', 'a note to record with the report')
+    .option('--json', 'print the raw payload instead of the summary')).action(async (track, step, status, opts) => {
+    emit(await runReport(io(), { ...opts, track, step, status }));
+});
+withTarget(program
+    .command('promote')
+    .description('Promote locked items into a conductor track and write its files')
+    .argument('<ids...>', 'item refs, e.g. PLG-001 UI-002')
+    .option('--track <slug>', 'track slug (default: the service builds one from the first item)')
+    .option('--type <type>', 'feature | infra | fix', 'feature')
+    .option('--name <text>', 'the track name for metadata.json')
+    .option('--priority <P0-P4>', 'skip the items read and use this priority')
+    .option('--plan <path>', 'the plan plan.md should point at')
+    .option('--json', 'print the raw payload instead of the summary')).action(async (ids, opts) => {
+    emit(await runPromote(io(), { ...opts, ids }));
+});
+withTarget(program
+    .command('sync')
+    .description("Re-render a track's spec.md from the locked criteria and clear the drift flag")
+    .argument('[track]', 'track slug (default: every active track that has drifted)')
+    .option('--json', 'print the raw payload instead of the summary')).action(async (track, opts) => {
+    emit(await runSync(io(), { ...opts, ...(track ? { track } : {}) }));
+});
+withTarget(program
+    .command('ship')
+    .description('Ship a track: the register, then the local shipment sweep')
+    .argument('<track>', 'track slug')
+    .option('--commit <sha>', 'the merge commit that shipped')
+    .option('--date <YYYY-MM-DD>', 'the production date')
+    .option('--auto', 'read the commit from HEAD and the date from today')
+    .option('--override-reason <text>', 'Owner-only: override the ship gate, with a reason')
+    .option('--criteria-done <ref=n,n>', 'the AC numbers that are done (repeatable)', (value, all = []) => [...all, value])
+    .option('--note <text>', 'the Recent Completions note')
+    .option('--json', 'print the raw payload instead of the summary')).action(async (track, opts) => {
+    emit(await runShip(io(), { ...opts, track }));
+});
+const matrix = program.command('matrix').description('The QA matrix of a track');
+withTarget(matrix
+    .command('init')
+    .description('Scaffold one QA row per locked criterion on a track')
+    .argument('<track>', 'track slug')
+    .option('--force', 'add rows for criteria that have none (never rewrites a row)')
+    .option('--json', 'print the raw payload instead of the summary')).action(async (track, opts) => {
+    emit(await runMatrixInit(io(), { ...opts, track }));
+});
+program
+    .command('export')
+    .description('Write a snapshot back to markdown (byte-exact for untouched objects)')
+    .argument('[outDir]', 'directory to write docs/… and conductor/… into (default: the repo root)')
+    .argument('[legacyOutDir]', 'the shipped two-argument form: <snapshot> <outDir>')
+    .option('--snapshot <file>', 'snapshot JSON from `backlog import --write`')
+    .action(async (outDir, legacyOutDir, opts) => {
+    emit(await runExport(io(), {
+        positionals: [outDir, legacyOutDir].filter((v) => typeof v === 'string'),
+        ...(opts.snapshot ? { snapshot: opts.snapshot } : {}),
+    }));
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/init/auth.d.ts

@@ -0,0 +1,85 @@
+/**
+ * The token and the project. Both are decided before `init` writes anything: a refusal
+ * here must leave the repo exactly as it was, including the token file.
+ *
+ * There is no device flow — the service mints PATs in the web UI and nothing else. So the
+ * only interactive path is a hidden paste.
+ */
+/** A refusal `init` renders as one line. */
+export declare class InitError extends Error {
+    constructor(message: string);
+}
+export interface Io {
+    input: NodeJS.ReadableStream;
+    output: NodeJS.WritableStream;
+    interactive: boolean;
+}
+/**
+ * Reads one line with the echo suppressed: the PAT never reaches the terminal, and so
+ * never reaches a scrollback buffer or a screen recording.
+ *
+ * The mute is a discarding output stream rather than an override of readline's internal
+ * `_writeToOutput` — that hook does not catch the per-character echo a terminal-mode
+ * interface writes, and the token would appear one character at a time.
+ */
+export declare function promptHidden(prompt: string, io: Io): Promise<string>;
+/** Reads one visible line. */
+export declare function promptLine(prompt: string, io: Io): Promise<string>;
+export type TokenSource = 'flag' | 'env' | 'file' | 'prompt';
+export interface ResolvedInitToken {
+    token: string;
+    source: TokenSource;
+}
+/**
+ * `--token` → `$BACKLOG_TOKEN` → `~/.config/backlog/token` → an interactive paste.
+ * Never logged, never echoed, never returned inside a message.
+ */
+export declare function resolveInitToken(opts: {
+    flagToken?: string | undefined;
+    env: NodeJS.ProcessEnv;
+    home: string;
+    url: string;
+    io: Io;
+}): Promise<ResolvedInitToken>;
+export interface VisibleProject {
+    slug: string;
+    name: string;
+    role: string;
+}
+/**
+ * `GET /v1/projects` — which is also the token's validation. A 401/403 renders through
+ * `explain()`: one sentence, no status code, no JSON.
+ */
+export declare function fetchVisibleProjects(opts: {
+    url: string;
+    token: string;
+    fetchImpl?: typeof fetch | undefined;
+}): Promise<VisibleProject[]>;
+/**
+ * Only what `GET /v1/projects` returned is offerable (SVC-008): a slug that is not in the
+ * list is a membership problem, and the CLI says so in the same words `doctor` uses.
+ *
+ * The order is `--project` → the project an existing `backlog.config.json` already names →
+ * the only visible project → a prompt. `configured` is what makes a re-run in a repo that
+ * is already set up non-interactive-safe: the repo has already answered "which project",
+ * and re-asking (or refusing because several are visible) would make `init` unusable in CI
+ * and annoying everywhere else. It is a *default*, not an override: `--project` still wins,
+ * and a configured project the token can no longer see is refused exactly like a typed one
+ * — silently falling back to a different project would point the repo's commands at the
+ * wrong register.
+ */
+export declare function chooseProject(opts: {
+    requested?: string | undefined;
+    configured?: string | undefined;
+    projects: VisibleProject[];
+    url: string;
+    io: Io;
+}): Promise<VisibleProject>;
+/** Whether to persist the PAT: the flag if given, else an interactive y/N, else no. */
+export declare function shouldSaveToken(opts: {
+    flag?: boolean | undefined;
+    yes?: boolean | undefined;
+    source: TokenSource;
+    home: string;
+    io: Io;
+}): Promise<boolean>;