felenova-backlog 0.1.0

package/dist/init/plugin.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The `backlog-execution` payload: three skills, four commands, and where each one goes in a
+ * repo.
+ *
+ * **The layout is verified, not guessed** (Claude Code 2.1.269, `claude plugin validate` and
+ * an `init`-message probe):
+ *
+ * - `packages/plugin/` is a real plugin — `.claude-plugin/plugin.json` at its root, `skills/
+ *   <name>/SKILL.md`, flat `commands/<name>.md`. `claude plugin validate --strict` passes and
+ *   `claude --plugin-dir … plugin details backlog-execution` inventories all seven components.
+ *   That is the marketplace / `--plugin-dir` route.
+ * - A plugin directory dropped *inside a project* is **not** auto-loaded: neither
+ *   `.claude/plugins/<name>/` nor `.claude/skills/<name>/` (the user-level `~/.claude/skills`
+ *   is the only skills-dir that auto-loads). So `init` cannot install a plugin directory and
+ *   have it work.
+ * - What does work in a repo, and is what PRODUCT-SPEC §7.1 asks for, is the project surface:
+ *   `.claude/skills/<name>/SKILL.md` loads as the skill `<name>`, and
+ *   `.claude/commands/backlog/<name>.md` loads as the slash command **`/backlog:next`** — the
+ *   exact names §7.2 documents. The plugin's own prefix comes from `plugin.json`'s `name`, so
+ *   via the plugin route the same commands read `/backlog-execution:next`.
+ *
+ * So the payload's bytes are written once, under `packages/plugin/`, and installed into the two
+ * project directories below. The `.mcp.json` server entry is deliberately **not** in the
+ * payload: `init/mcp.ts` owns that file and `init/templates.ts` owns the key and the entry
+ * shape, and a second copy here would be a second thing to keep in step.
+ */
+/** The plugin's name — `plugin.json`'s `name`, and the namespace on the plugin route. */
+export declare const PLUGIN_NAME = "backlog-execution";
+/** Project-level skills: `.claude/skills/<name>/SKILL.md` loads as the skill `<name>`. */
+export declare const PLUGIN_SKILLS_TARGET_DIR: string;
+/** Project-level commands: `.claude/commands/backlog/next.md` is `/backlog:next`. */
+export declare const PLUGIN_COMMANDS_TARGET_DIR: string;
+export interface PayloadFile {
+    /** Path inside `packages/plugin/`, POSIX-separated as the plugin format writes it. */
+    source: string;
+    /** Path inside the repo, platform-separated. */
+    target: string;
+}
+/** Every file `init` installs, in write order. */
+export declare const PLUGIN_PAYLOAD: readonly PayloadFile[];
+export declare function payloadRoot(): string;
+/** One payload file's bytes, exactly as packaged. */
+export declare function readPayloadFile(source: string): string;
+export interface PluginResult {
+    installed: string[];
+    kept: string[];
+    /** Present, different, and left alone — the `--force-plugin` list. */
+    differing: string[];
+    replaced: string[];
+    lines: string[];
+}
+/**
+ * Create-if-missing, file by file, with the same manners as the conductor scaffold: a file
+ * that is already byte-identical is left alone, and a file the user has edited is **kept** and
+ * reported rather than clobbered. `--force-plugin` is the only way the packaged copy wins.
+ */
+export declare function installPlugin(opts: {
+    cwd: string;
+    force?: boolean;
+}): PluginResult;

package/dist/init/plugin.js

@@ -0,0 +1,120 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * The `backlog-execution` payload: three skills, four commands, and where each one goes in a
+ * repo.
+ *
+ * **The layout is verified, not guessed** (Claude Code 2.1.269, `claude plugin validate` and
+ * an `init`-message probe):
+ *
+ * - `packages/plugin/` is a real plugin — `.claude-plugin/plugin.json` at its root, `skills/
+ *   <name>/SKILL.md`, flat `commands/<name>.md`. `claude plugin validate --strict` passes and
+ *   `claude --plugin-dir … plugin details backlog-execution` inventories all seven components.
+ *   That is the marketplace / `--plugin-dir` route.
+ * - A plugin directory dropped *inside a project* is **not** auto-loaded: neither
+ *   `.claude/plugins/<name>/` nor `.claude/skills/<name>/` (the user-level `~/.claude/skills`
+ *   is the only skills-dir that auto-loads). So `init` cannot install a plugin directory and
+ *   have it work.
+ * - What does work in a repo, and is what PRODUCT-SPEC §7.1 asks for, is the project surface:
+ *   `.claude/skills/<name>/SKILL.md` loads as the skill `<name>`, and
+ *   `.claude/commands/backlog/<name>.md` loads as the slash command **`/backlog:next`** — the
+ *   exact names §7.2 documents. The plugin's own prefix comes from `plugin.json`'s `name`, so
+ *   via the plugin route the same commands read `/backlog-execution:next`.
+ *
+ * So the payload's bytes are written once, under `packages/plugin/`, and installed into the two
+ * project directories below. The `.mcp.json` server entry is deliberately **not** in the
+ * payload: `init/mcp.ts` owns that file and `init/templates.ts` owns the key and the entry
+ * shape, and a second copy here would be a second thing to keep in step.
+ */
+/** The plugin's name — `plugin.json`'s `name`, and the namespace on the plugin route. */
+export const PLUGIN_NAME = 'backlog-execution';
+/** Project-level skills: `.claude/skills/<name>/SKILL.md` loads as the skill `<name>`. */
+export const PLUGIN_SKILLS_TARGET_DIR = join('.claude', 'skills');
+/** Project-level commands: `.claude/commands/backlog/next.md` is `/backlog:next`. */
+export const PLUGIN_COMMANDS_TARGET_DIR = join('.claude', 'commands', 'backlog');
+const SKILLS = ['backlog-query', 'backlog-management', 'feature-kickoff'];
+const COMMANDS = ['next', 'promote', 'report', 'ship'];
+/** Every file `init` installs, in write order. */
+export const PLUGIN_PAYLOAD = [
+    ...SKILLS.map((name) => ({
+        source: `skills/${name}/SKILL.md`,
+        target: join(PLUGIN_SKILLS_TARGET_DIR, name, 'SKILL.md'),
+    })),
+    ...COMMANDS.map((name) => ({
+        source: `commands/${name}.md`,
+        target: join(PLUGIN_COMMANDS_TARGET_DIR, `${name}.md`),
+    })),
+];
+/**
+ * Where the payload sits at runtime. `dist/plugin/` in a built or packed CLI (the build copies
+ * it there so `files: ["dist"]` carries it), and `packages/plugin/` in the source tree, which
+ * is what the tests read. Both are tried; the first that has a skill in it wins.
+ */
+const PAYLOAD_CANDIDATES = ['../plugin/', '../../../plugin/'];
+const PROBE = 'skills/backlog-query/SKILL.md';
+let cachedRoot = null;
+export function payloadRoot() {
+    if (cachedRoot !== null)
+        return cachedRoot;
+    const tried = [];
+    for (const candidate of PAYLOAD_CANDIDATES) {
+        const dir = fileURLToPath(new URL(candidate, import.meta.url));
+        tried.push(dir);
+        if (existsSync(join(dir, PROBE))) {
+            cachedRoot = dir;
+            return dir;
+        }
+    }
+    throw new Error(`the ${PLUGIN_NAME} payload is missing from this install — looked in ${tried.join(', ')}`);
+}
+/** One payload file's bytes, exactly as packaged. */
+export function readPayloadFile(source) {
+    return readFileSync(join(payloadRoot(), source), 'utf8');
+}
+/**
+ * Create-if-missing, file by file, with the same manners as the conductor scaffold: a file
+ * that is already byte-identical is left alone, and a file the user has edited is **kept** and
+ * reported rather than clobbered. `--force-plugin` is the only way the packaged copy wins.
+ */
+export function installPlugin(opts) {
+    const installed = [];
+    const kept = [];
+    const differing = [];
+    const replaced = [];
+    const lines = [];
+    for (const file of PLUGIN_PAYLOAD) {
+        const body = readPayloadFile(file.source);
+        const abs = join(opts.cwd, file.target);
+        let current = null;
+        try {
+            current = readFileSync(abs, 'utf8');
+        }
+        catch {
+            current = null;
+        }
+        if (current === body) {
+            kept.push(file.target);
+            lines.push(`${file.target}: unchanged`);
+            continue;
+        }
+        if (current !== null && !opts.force) {
+            differing.push(file.target);
+            lines.push(`${file.target}: kept — differs from the packaged copy (--force-plugin to replace)`);
+            continue;
+        }
+        mkdirSync(dirname(abs), { recursive: true });
+        writeFileSync(abs, body, 'utf8');
+        if (current === null) {
+            installed.push(file.target);
+            lines.push(`${file.target}: added`);
+        }
+        else {
+            replaced.push(file.target);
+            lines.push(`${file.target}: replaced (--force-plugin)`);
+        }
+    }
+    lines.push(`plugin ${PLUGIN_NAME}: ${installed.length + replaced.length} added, ${kept.length} kept, ${differing.length} differing`);
+    return { installed, kept, differing, replaced, lines };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/init/plugin.js.map

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

package/dist/init/scaffold.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Create-if-missing, file by file. Two conductor conventions are in the wild during the
+ * migration, so a repo that already has `conductor/` is merged into and never rewritten:
+ * an existing file is left byte-identical, whatever it says.
+ */
+export interface ScaffoldResult {
+    added: string[];
+    kept: string[];
+    lines: string[];
+}
+export declare function scaffoldConductor(opts: {
+    cwd: string;
+    conductorDir: string;
+}): ScaffoldResult;
+/**
+ * Appends the entries under one `# backlog` comment. Never rewrites, reorders or removes a
+ * line, and never creates the file: a repo with no `.gitignore` has made a choice.
+ */
+export declare function updateGitignore(cwd: string): string;

package/dist/init/scaffold.js

@@ -0,0 +1,46 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { CONDUCTOR_TEMPLATES, GITIGNORE_ENTRIES, GITIGNORE_HEADER } from './templates.js';
+export function scaffoldConductor(opts) {
+    const added = [];
+    const kept = [];
+    const lines = [];
+    for (const template of CONDUCTOR_TEMPLATES) {
+        const rel = `${opts.conductorDir}/${template.path}`;
+        const abs = join(opts.cwd, opts.conductorDir, template.path);
+        if (existsSync(abs)) {
+            kept.push(rel);
+            lines.push(`${rel}: kept`);
+            continue;
+        }
+        mkdirSync(dirname(abs), { recursive: true });
+        writeFileSync(abs, template.body, 'utf8');
+        added.push(rel);
+        lines.push(`${rel}: added`);
+    }
+    lines.push(`${opts.conductorDir}/: ${added.length} added, ${kept.length} kept`);
+    return { added, kept, lines };
+}
+/**
+ * Appends the entries under one `# backlog` comment. Never rewrites, reorders or removes a
+ * line, and never creates the file: a repo with no `.gitignore` has made a choice.
+ */
+export function updateGitignore(cwd) {
+    const path = join(cwd, '.gitignore');
+    let text;
+    try {
+        text = readFileSync(path, 'utf8');
+    }
+    catch {
+        return `.gitignore: absent — skipped; add ${GITIGNORE_ENTRIES.join(', ')} if you create one`;
+    }
+    const present = new Set(text.split('\n').map((l) => l.trim()));
+    const missing = GITIGNORE_ENTRIES.filter((entry) => !present.has(entry));
+    if (missing.length === 0)
+        return '.gitignore: unchanged — every entry is already there';
+    const prefix = text === '' || text.endsWith('\n') ? text : `${text}\n`;
+    const block = `\n${GITIGNORE_HEADER}\n${missing.join('\n')}\n`;
+    writeFileSync(path, `${prefix}${block}`, 'utf8');
+    return `.gitignore: added ${missing.join(', ')}`;
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/init/scaffold.js.map

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

package/dist/init/templates.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Everything `init` can write, as data. Templates are TypeScript string constants rather
+ * than files under `templates/` so `tsc` alone produces a complete `dist` — a data
+ * directory would need a copy step in the build and would be missing from the published
+ * tarball the first time someone forgot it.
+ *
+ * Nothing here is dated or randomised: a template's bytes are a pure function of the
+ * project, so a second `init` can compare and leave the file alone.
+ */
+export declare const DEFAULT_URL = "https://felenova-backlog.fly.dev";
+export declare const DEFAULT_CONDUCTOR_DIR = "conductor";
+/** The `.mcp.json` server key (`.mcp.json.example`, and `doctor`'s `mcp_entry` check). */
+export declare const MCP_SERVER_KEY = "backlog";
+/** The literal the file carries. A token value never reaches `.mcp.json`. */
+export declare const TOKEN_PLACEHOLDER = "${BACKLOG_TOKEN}";
+export interface McpServerEntry {
+    type: 'http';
+    url: string;
+    headers: {
+        Authorization: string;
+    };
+}
+/** Exactly `.mcp.json.example`'s shape, with the service URL substituted. */
+export declare function mcpServerEntry(url: string): McpServerEntry;
+export interface ConductorTemplate {
+    /** Path relative to the conductor directory. */
+    path: string;
+    body: string;
+}
+/**
+ * The scaffold, in write order. `knowledge/errors.json` is in the set because the shipped
+ * conductor layout has it and the Evaluate-Loop appends to it; it is one empty array.
+ */
+export declare const CONDUCTOR_TEMPLATES: readonly ConductorTemplate[];
+export declare const START_MARKER = "<!-- backlog:start -->";
+export declare const END_MARKER = "<!-- backlog:end -->";
+/** An older, hand-written section. `init` recognises it and keeps its hands off. */
+export declare const LEGACY_HEADING = "## Backlog \u2192 Conductor";
+export interface ClaudeSectionContext {
+    url: string;
+    project: string;
+    conductorDir: string;
+}
+/** The marker-delimited block, markers included, ending in a newline. */
+export declare function claudeSection(ctx: ClaudeSectionContext): string;
+/** Kept out of git by `init`: the MCP file, the offline cache, and the import snapshot. */
+export declare const GITIGNORE_ENTRIES: readonly [".mcp.json", ".backlog/", "backlog-snapshot.json"];
+export declare const GITIGNORE_HEADER = "# backlog";

package/dist/init/templates.js

@@ -0,0 +1,147 @@
+/**
+ * Everything `init` can write, as data. Templates are TypeScript string constants rather
+ * than files under `templates/` so `tsc` alone produces a complete `dist` — a data
+ * directory would need a copy step in the build and would be missing from the published
+ * tarball the first time someone forgot it.
+ *
+ * Nothing here is dated or randomised: a template's bytes are a pure function of the
+ * project, so a second `init` can compare and leave the file alone.
+ */
+export const DEFAULT_URL = 'https://felenova-backlog.fly.dev';
+export const DEFAULT_CONDUCTOR_DIR = 'conductor';
+/** The `.mcp.json` server key (`.mcp.json.example`, and `doctor`'s `mcp_entry` check). */
+export const MCP_SERVER_KEY = 'backlog';
+/** The literal the file carries. A token value never reaches `.mcp.json`. */
+export const TOKEN_PLACEHOLDER = '${BACKLOG_TOKEN}';
+/** Exactly `.mcp.json.example`'s shape, with the service URL substituted. */
+export function mcpServerEntry(url) {
+    return {
+        type: 'http',
+        url: `${url.replace(/\/+$/, '')}/mcp`,
+        headers: { Authorization: `Bearer ${TOKEN_PLACEHOLDER}` },
+    };
+}
+const WORKFLOW = `# Conductor Workflow — Evaluate-Loop v3
+
+Every track goes through one loop. The register (backlog service) owns *what* and *why*;
+this directory owns *how* and *now*.
+
+## Loop steps
+
+\`\`\`
+PLAN → EVALUATE_PLAN → EXECUTE → EVALUATE_EXECUTION → COMPLETE
+  ↑         |                          |
+  |     FAIL → back              FAIL → FIX → re-evaluate
+  └─────────────────────────────────────┘
+\`\`\`
+
+Statuses: \`IN_PROGRESS\`, \`PASS\`, \`FAIL\`, \`COMPLETE\`. Report each transition with
+\`backlog report <track> <step> <status>\`; the first \`EXECUTE\` flips the track's promoted
+items to \`in-progress\`.
+
+## The four backlog touch-points
+
+| When | Command | What it does |
+|---|---|---|
+| before PLAN | \`backlog next\` | lists items whose criteria are locked and ready |
+| at PLAN | \`backlog promote <ID…>\` | writes \`tracks/<slug>/{spec.md,plan.md,metadata.json}\` |
+| during the loop | \`backlog report\`, \`backlog sync\` | records progress; re-renders \`spec.md\` when criteria move |
+| at COMPLETE | \`backlog ship <slug>\` | writes \`shipped_commit\` and \`production_date\` back |
+
+## Rules
+
+- Nothing is promoted until its criteria are **locked** in the register.
+- Locked criteria are immutable: suggest a change, never edit the copy in \`spec.md\`.
+- A track's \`spec.md\` is generated. Hand-edit \`plan.md\`, not \`spec.md\`.
+- Two human checkpoints stay human: approving a plan, and approving a ship.
+`;
+const INDEX = `# Project Status
+
+## Current Focus
+
+_Nothing yet. \`backlog next\` shows what is ready; \`backlog promote <ID…>\` starts a track._
+
+## Recent Completions
+
+| Track | Date | Notes |
+|---|---|---|
+
+## System Health
+
+- conductor scaffolded by \`backlog init\`; run \`backlog doctor\` if anything looks wrong
+`;
+const TRACKS = `# Conductor Track Registry
+
+## Active Tracks
+
+| Track ID | Name | Type | Priority | Status | Depends On |
+|---|---|---|---|---|---|
+
+## Next (promote only when the backlog items are \`locked\`)
+
+| Track ID | Backlog IDs | Name |
+|---|---|---|
+`;
+const DECISION_LOG = `# Decision Log
+
+Decisions that changed the shape of the system, newest last. Product decisions (what, why,
+on what conditions) belong in the register, not here — this file is for the *how*.
+
+<!-- One entry per decision, in this shape:
+
+### DECISION-001: <one-line title>
+- **Date**: YYYY-MM-DD · **Track**: <track_id>
+- **Decision**: what was decided, in the present tense.
+- **Alternatives**: what was rejected, and why.
+-->
+`;
+const PATTERNS = `# Patterns
+
+Durable lessons, one \`##\` section per pattern, each naming the track that produced it.
+A pattern earns a place here when it would change how the next track is built.
+`;
+const ERRORS_JSON = `[]
+`;
+/**
+ * The scaffold, in write order. `knowledge/errors.json` is in the set because the shipped
+ * conductor layout has it and the Evaluate-Loop appends to it; it is one empty array.
+ */
+export const CONDUCTOR_TEMPLATES = [
+    { path: 'index.md', body: INDEX },
+    { path: 'tracks.md', body: TRACKS },
+    { path: 'decision-log.md', body: DECISION_LOG },
+    { path: 'workflow.md', body: WORKFLOW },
+    { path: 'knowledge/patterns.md', body: PATTERNS },
+    { path: 'knowledge/errors.json', body: ERRORS_JSON },
+    { path: 'tracks/.gitkeep', body: '' },
+];
+export const START_MARKER = '<!-- backlog:start -->';
+export const END_MARKER = '<!-- backlog:end -->';
+/** An older, hand-written section. `init` recognises it and keeps its hands off. */
+export const LEGACY_HEADING = '## Backlog → Conductor';
+/** The marker-delimited block, markers included, ending in a newline. */
+export function claudeSection(ctx) {
+    return `${START_MARKER}
+${LEGACY_HEADING}
+
+The product register for this repo is the backlog service at ${ctx.url}, project
+**\`${ctx.project}\`** — it owns what / why / on what conditions. \`${ctx.conductorDir}/\` owns how / now.
+The only coupling is the MCP tool surface.
+
+- Nothing reaches a track until the item's criteria are **locked** in the register.
+- \`backlog next\` lists what is ready; \`backlog promote <ID…>\` writes
+  \`${ctx.conductorDir}/tracks/<slug>/{spec.md,plan.md,metadata.json}\` from the register's payload.
+- \`backlog report <track> <step> <status>\` records Evaluate-Loop progress; \`backlog sync <track>\`
+  re-renders \`spec.md\` when criteria move; \`backlog ship <track>\` writes \`shipped_commit\` and
+  \`production_date\` back.
+- **Locked means immutable.** Suggest a change against the item; never edit the copy in \`spec.md\`.
+- The PAT lives in \`$BACKLOG_TOKEN\` or \`~/.config/backlog/token\` (mode 600). \`.mcp.json\`
+  references \`${TOKEN_PLACEHOLDER}\` and never a token value.
+- \`backlog doctor\` is the first thing to run when any of this looks wrong.
+${END_MARKER}
+`;
+}
+/** Kept out of git by `init`: the MCP file, the offline cache, and the import snapshot. */
+export const GITIGNORE_ENTRIES = ['.mcp.json', '.backlog/', 'backlog-snapshot.json'];
+export const GITIGNORE_HEADER = '# backlog';
+//# sourceMappingURL=templates.js.map

package/dist/init/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/init/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,kCAAkC,CAAC;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC;AAEjD,0FAA0F;AAC1F,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AAExC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAQpD,6EAA6E;AAC7E,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM;QACrC,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,iBAAiB,EAAE,EAAE;KAC1D,CAAC;AACJ,CAAC;AAQD,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiChB,CAAC;AAEF,MAAM,KAAK,GAAG;;;;;;;;;;;;;;CAcb,CAAC;AAEF,MAAM,MAAM,GAAG;;;;;;;;;;;CAWd,CAAC;AAEF,MAAM,YAAY,GAAG;;;;;;;;;;;;CAYpB,CAAC;AAEF,MAAM,QAAQ,GAAG;;;;CAIhB,CAAC;AAEF,MAAM,WAAW,GAAG;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAiC;IAC/D,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;IACjC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE;IACnC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,YAAY,EAAE;IAC/C,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE;IACvC,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,QAAQ,EAAE;IACjD,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,WAAW,EAAE;IACpD,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,EAAE;CACtC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,wBAAwB,CAAC;AACrD,MAAM,CAAC,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAEjD,oFAAoF;AACpF,MAAM,CAAC,MAAM,cAAc,GAAG,wBAAwB,CAAC;AAQvD,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAAC,GAAyB;IACrD,OAAO,GAAG,YAAY;EACtB,cAAc;;+DAE+C,GAAG,CAAC,GAAG;MAChE,GAAG,CAAC,OAAO,qDAAqD,GAAG,CAAC,YAAY;;;;;MAKhF,GAAG,CAAC,YAAY;;;;;;iBAML,iBAAiB;;EAEhC,UAAU;CACX,CAAC;AACF,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,uBAAuB,CAAU,CAAC;AAC9F,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC"}

package/dist/plugin/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
+  "name": "backlog-execution",
+  "version": "0.1.0",
+  "description": "Talk to the Felenova backlog register from a repo: read what is ready, file and review drafts, and run a feature from promotion to ship without ever hand-editing docs/backlog/.",
+  "author": {
+    "name": "Felenova"
+  },
+  "homepage": "https://felenova-backlog.fly.dev",
+  "keywords": ["backlog", "product-register", "conductor", "qa-matrix"]
+}

package/dist/plugin/README.md

@@ -0,0 +1,117 @@
+# @felenova/backlog-plugin
+
+The `backlog-execution` Claude Code plugin: the repo-side agent surface of the backlog
+register (PRODUCT-SPEC §7). `npx felenova-backlog init` installs this payload into a repo;
+the same directory is a valid standalone plugin, so it also works over `--plugin-dir` or from
+a marketplace.
+
+```
+packages/plugin/
+├── .claude-plugin/plugin.json      # the manifest — name `backlog-execution`
+├── skills/
+│   ├── backlog-query/SKILL.md      # read: status, next, get_item — the natural-language door
+│   ├── backlog-management/SKILL.md # write: file, edit drafts, review, comment, suggest
+│   └── feature-kickoff/SKILL.md    # the loop: promote → plan → matrix init → report → ship
+└── commands/
+    ├── next.md      promote.md
+    └── report.md    ship.md        # thin wrappers; each shells one CLI subcommand
+```
+
+## What it is, and the two routes in
+
+The payload is **markdown only** — three skills and four commands, no code, no credential. It
+teaches an agent the register's vocabulary: which tool or CLI subcommand does what, the role each
+one needs, and the refusal codes it can hit (every role word and every code in these files is
+checked against `packages/core`'s `ROLES` and the CLI's `ERROR_CODES` by
+`packages/cli/src/init/plugin.test.ts`, so a fabricated one fails the build).
+
+1. **Via `init`** — `npx felenova-backlog init` copies these files into the repo at
+   `.claude/skills/<name>/SKILL.md` and `.claude/commands/backlog/<name>.md`, create-if-missing.
+   An existing file that differs is kept and named (`--force-plugin` replaces it).
+2. **As a standalone plugin** — `claude --plugin-dir packages/plugin`, or a marketplace install.
+   Same bytes, different command prefix (see the table below).
+
+### The skills and commands, and the role each needs
+
+| Surface | What it is for | Role required |
+|---|---|---|
+| skill **backlog-query** | the natural-language door: status, what is ready, read an item | Viewer+ |
+| skill **backlog-management** | file and co-author drafts, review criteria, comment, suggest a change to locked criteria | Engineer or QA+ to write, Product+ to lock, review or resolve |
+| skill **feature-kickoff** | the loop: promote → plan → matrix init → report → ship, with both human checkpoints | per step — promote Engineer+, matrix init QA/Engineer+, report Engineer+, ship Product+ |
+| `/backlog:next` | what is ready to work on | Viewer+ |
+| `/backlog:promote` | locked items → a conductor track | Engineer+ (QA and Viewer refused) |
+| `/backlog:report` | one Evaluate-Loop step/status | Engineer+ |
+| `/backlog:ship` | close a track, write back commit + date | Product+ |
+
+Each command shells exactly one CLI subcommand, so there is one implementation of every rule and
+the role is enforced by the service, not by the prose.
+
+### No token ever goes in a file here
+
+Nothing in this package contains, or may contain, a credential. The MCP entry references the
+literal `${BACKLOG_TOKEN}`; the PAT lives in the environment or at `~/.config/backlog/token`
+(mode 600), outside any repo. `packages/cli/src/init/plugin.test.ts` greps every payload file for
+the three token shapes, before and after installation, and `backlog doctor`'s `no_literal_token`
+check scans the git-tracked tree as the backstop.
+
+PRODUCT-SPEC §7.1 listed `/backlog:status` among the commands; this payload ships
+`/backlog:report` and `/backlog:ship` in its place, per the Task 5 brief. `backlog status` is
+still one CLI command away, and **backlog-query** is the skill that answers status questions in
+words.
+
+## The verified layout (Claude Code 2.1.269)
+
+Two routes, and they name the commands differently — both were checked, not assumed:
+
+| Route | How it loads | Command names |
+|---|---|---|
+| **plugin** (`claude --plugin-dir packages/plugin`, or a marketplace install) | `.claude-plugin/plugin.json` + `skills/` + flat `commands/` | `/backlog-execution:next`, `/backlog-execution:backlog-query`, … — the prefix is `plugin.json`'s `name` |
+| **repo install** (what `backlog init` does) | `.claude/skills/<name>/SKILL.md` and `.claude/commands/backlog/<name>.md` | `/backlog:next`, `/backlog:promote`, `/backlog:report`, `/backlog:ship`, and the three skills by name — the names §7.2 documents |
+
+`init` uses the second route because a plugin directory placed inside a project is **not**
+auto-loaded — neither `.claude/plugins/<name>/` nor a project `.claude/skills/<name>/` with a
+manifest in it. Only `~/.claude/skills/<name>/` auto-loads as a plugin, and that is the user's
+home, not a repo. Verification: `claude plugin validate packages/plugin --strict` passes, and a
+headless session's `init` message lists the slash commands each layout produces.
+
+## The MCP server entry is not here
+
+There is deliberately no `.mcp.json` in this payload. The `backlog` server key, its
+`${BACKLOG_TOKEN}` header and the entry shape live in
+`packages/cli/src/init/templates.ts` (`MCP_SERVER_KEY`, `mcpServerEntry`), and
+`packages/cli/src/init/mcp.ts` merges that one entry into the repo's own `.mcp.json` without
+touching anybody else's server. A copy here would be a second thing to keep in step — and a
+second place a token could be pasted.
+
+## Connect by hand
+
+Point any MCP client at `https://felenova-backlog.fly.dev/mcp` (Streamable HTTP, POST only).
+Copy the repo-root template and fill in a token from the environment — never commit the real
+file (`.mcp.json` is gitignored):
+
+```bash
+cp .mcp.json.example .mcp.json
+```
+
+```json
+{
+  "mcpServers": {
+    "backlog": {
+      "type": "http",
+      "url": "https://felenova-backlog.fly.dev/mcp",
+      "headers": {
+        "Authorization": "Bearer ${BACKLOG_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+Mint the `${BACKLOG_TOKEN}` yourself: sign in to the web UI, go to `/me`, and use "Mint a
+token" (which posts to `POST /v1/tokens`). The value is shown once — save it wherever your MCP
+client reads `${BACKLOG_TOKEN}` from, or at `~/.config/backlog/token` (mode 600). A session
+cookie is not accepted on `/mcp`; only a PAT works there. **No file in this package may ever
+contain a token value**; `packages/cli/src/init/plugin.test.ts` greps for that.
+
+`X-Backlog-Client` / `X-Backlog-Actor` are REST-only claims. On `/mcp` the transport stamps
+`via=mcp` / `actor_kind=agent` itself, so those two headers have no effect over MCP.

package/dist/plugin/commands/next.md

@@ -0,0 +1,28 @@
+---
+description: What is ready to work on — locked, unblocked, unpromoted items, ranked by priority.
+argument-hint: "[--json]"
+allowed-tools: Bash(backlog next:*)
+---
+
+# /backlog:next
+
+**Role required: Viewer or above.** Reading the register is allowed for every role
+(PRODUCT-SPEC §3.1); nothing here can be refused for being too small a role.
+
+Run exactly this, from the repo root, and show the output:
+
+```bash
+backlog next $ARGUMENTS
+```
+
+It calls `next_ready` for the project in `backlog.config.json`. One implementation: the CLI.
+Do not reimplement it with an MCP call, and do not fall back to reading `docs/backlog/**`.
+
+## Refusals
+
+`no_session` (no PAT reached the service — run `backlog doctor`), `token_unknown` /
+`token_revoked` / `token_expired` (mint a new PAT in the web UI `/me`, then `backlog init`),
+`no_member`, `not_found` (no role on the configured project), `rate_limited` (120/min),
+`unreachable` (the service is down — `backlog status` prints the cached view).
+
+The CLI prints one human sentence per refusal. Relay it; never print a token.

package/dist/plugin/commands/promote.md

@@ -0,0 +1,30 @@
+---
+description: Promote locked backlog items into a conductor track and write spec.md, plan.md and metadata.json.
+argument-hint: "<ID…> [--slug <slug>] [--type feature|fix|chore]"
+allowed-tools: Bash(backlog promote:*)
+---
+
+# /backlog:promote
+
+**Role required: Engineer, Product or Owner.** QA and Viewer are refused (PRODUCT-SPEC §3.1,
+"Promote locked item → track").
+
+Run exactly this, from the repo root, and show the output:
+
+```bash
+backlog promote $ARGUMENTS
+```
+
+It calls `promote_items`, then writes `conductor/tracks/<slug>/{spec.md,plan.md,metadata.json}`
+from the payload the service returned and updates `conductor/tracks.md`. `spec.md` is
+generated from the register's locked criteria — never hand-edit it.
+
+Nothing is promoted until every named item's criteria are **locked**. If they are not, stop
+and ask a Product role to lock them.
+
+## Refusals
+
+`not_locked` (an item is not locked — the whole call is refused, nothing is written),
+`forbidden` (the role is short — say so and stop), `conflict` (the slug is taken, or an item
+is already promoted), `not_found` (unknown ref, or no role on the project),
+`invalid_request` (bad arguments), `unreachable`.