@rasensio/aidlc 1.20.0 → 1.21.0

package/dist/roadmap/sync/config.d.ts

@@ -0,0 +1,95 @@
+/**
+ * The `roadmap.sync` section of `.aidlc/config.yaml`.
+ *
+ * Follows the convention every other module's config reader in this package follows —
+ * there is no central config loader here, ten call sites each parse the file inline —
+ * with one boundary drawn explicitly, because the requirements review found revision 1
+ * contradicting itself about it:
+ *
+ * - A malformed **container** reads as *not configured*: unparseable YAML, `roadmap`
+ *   not a mapping, `roadmap.sync` not a mapping. One bad section must never break an
+ *   unrelated command.
+ * - Anything wrong **inside** a well-formed `sync` mapping is a *named refusal*,
+ *   including a wrong-typed value. `provider: 123` is a mistake somebody made on
+ *   purpose and wants told about; silently reading it as "you have not configured this"
+ *   would send them looking in the wrong place.
+ *
+ * The section is read from the **primary checkout**, the same tree the items come from.
+ * Items and eligibility are one fact; reading them from two trees would let a feature
+ * branch change what a colleague's `sync` publishes.
+ *
+ * Requirements: roadmap-issue-projection/AC-1 … roadmap-issue-projection/AC-9
+ *
+ * @module
+ */
+import { type RoadmapStatus } from '../paths.js';
+/** The `roadmap.sync` section, validated. */
+export interface SyncConfig {
+    provider: 'github';
+    /** `owner/name`, or null when `gh` resolves the current repository. */
+    repo: string | null;
+    statuses: readonly RoadmapStatus[];
+    label: string;
+}
+export type SyncConfigResult = {
+    kind: 'ok';
+    config: SyncConfig;
+} | {
+    kind: 'not-configured';
+} | {
+    kind: 'invalid';
+    error: string;
+};
+/**
+ * The default eligible statuses.
+ *
+ * The line falls between "thinking" and "work". `inbox/` means captured, not committed
+ * to — projecting it puts issues on a board for decisions nobody has made. `hold/`
+ * holds parked and declined work, which on this project means pricing thinking and a
+ * competitor teardown; a markdown file in a repo and an indexed, notification-generating
+ * issue are not the same exposure even when both are technically public.
+ */
+export declare const DEFAULT_STATUSES: readonly RoadmapStatus[];
+/**
+ * Validate a repository coordinate. Shared by the config value and `--repo`, so the two
+ * can never diverge.
+ */
+export declare function validateRepo(raw: unknown, source: string): {
+    ok: true;
+    repo: string;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Validate the discovery label.
+ *
+ * A comma is refused explicitly rather than folded into a charset message, because the
+ * failure it causes is silent and expensive: `gh`'s `--label` is a comma-split slice, so
+ * `aidlc,urgent` would AND two labels in discovery, return an empty issue map, and
+ * re-create every issue on every run. The discovery label *is* the identity of a
+ * projected issue, so a wrong one is a duplicate-issue generator, not a cosmetic error.
+ */
+export declare function validateLabel(raw: unknown): {
+    ok: true;
+    label: string;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Read and validate the `roadmap.sync` section from a checkout's config.
+ *
+ * @param primaryCheckoutRoot - The primary checkout's working tree.
+ */
+export declare function readSyncConfig(primaryCheckoutRoot: string): SyncConfigResult;
+/**
+ * Apply a `--repo` flag over a config, with identical validation.
+ *
+ * The flag wins. It is the likelier source of a wrong value — typed by hand, once —
+ * which is why it goes through the same validator rather than a looser one.
+ */
+export declare function withRepoOverride(config: SyncConfig, repo: string | undefined): SyncConfigResult;
+/** The message for a project that has not opted in. */
+export declare function notConfiguredMessage(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/roadmap/sync/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/roadmap/sync/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAGnE,6CAA6C;AAC7C,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,uEAAuE;IACvE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAAuC,CAAC;AAkC7F;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAmBpH;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA0BtG;AA+BD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,mBAAmB,EAAE,MAAM,GAAG,gBAAgB,CAiD5E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAK/F;AAED,uDAAuD;AACvD,wBAAgB,oBAAoB,IAAI,MAAM,CAW7C"}

package/dist/roadmap/sync/config.js

@@ -0,0 +1,236 @@
+/**
+ * The `roadmap.sync` section of `.aidlc/config.yaml`.
+ *
+ * Follows the convention every other module's config reader in this package follows —
+ * there is no central config loader here, ten call sites each parse the file inline —
+ * with one boundary drawn explicitly, because the requirements review found revision 1
+ * contradicting itself about it:
+ *
+ * - A malformed **container** reads as *not configured*: unparseable YAML, `roadmap`
+ *   not a mapping, `roadmap.sync` not a mapping. One bad section must never break an
+ *   unrelated command.
+ * - Anything wrong **inside** a well-formed `sync` mapping is a *named refusal*,
+ *   including a wrong-typed value. `provider: 123` is a mistake somebody made on
+ *   purpose and wants told about; silently reading it as "you have not configured this"
+ *   would send them looking in the wrong place.
+ *
+ * The section is read from the **primary checkout**, the same tree the items come from.
+ * Items and eligibility are one fact; reading them from two trees would let a feature
+ * branch change what a colleague's `sync` publishes.
+ *
+ * Requirements: roadmap-issue-projection/AC-1 … roadmap-issue-projection/AC-9
+ *
+ * @module
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { ROADMAP_STATUSES } from '../paths.js';
+import { DEFAULT_DISCOVERY_LABEL, MAX_LABEL_LENGTH } from './labels.js';
+/**
+ * The default eligible statuses.
+ *
+ * The line falls between "thinking" and "work". `inbox/` means captured, not committed
+ * to — projecting it puts issues on a board for decisions nobody has made. `hold/`
+ * holds parked and declined work, which on this project means pricing thinking and a
+ * competitor teardown; a markdown file in a repo and an indexed, notification-generating
+ * issue are not the same exposure even when both are technically public.
+ */
+export const DEFAULT_STATUSES = ['backlog', 'in-progress', 'done'];
+/** `owner/name`, each half on a conservative charset. */
+const REPO_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*\/[A-Za-z0-9][A-Za-z0-9._-]*$/;
+/** Three slash-separated parts — `gh`'s `[HOST/]OWNER/REPO`, which v1 does not support. */
+const GHE_REPO_RE = /^[^/]+\/[^/]+\/[^/]+$/;
+/** Absolute path of a checkout's config file. */
+function configPath(root) {
+    return join(root, '.aidlc', 'config.yaml');
+}
+/** The whole config document, or `{}` when absent or unusable. */
+function readDocument(root) {
+    const path = configPath(root);
+    if (!existsSync(path))
+        return {};
+    try {
+        const parsed = parseYaml(readFileSync(path, 'utf8'));
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+            return {};
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+/** Describe a value's type for an error message, without printing a whole object. */
+function describe(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'a list';
+    if (typeof value === 'object')
+        return 'a mapping';
+    return JSON.stringify(value);
+}
+/**
+ * Validate a repository coordinate. Shared by the config value and `--repo`, so the two
+ * can never diverge.
+ */
+export function validateRepo(raw, source) {
+    if (typeof raw !== 'string' || raw.length === 0) {
+        return { ok: false, error: `${source} must be a string of the form owner/name, got ${describe(raw)}` };
+    }
+    if (REPO_RE.test(raw))
+        return { ok: true, repo: raw };
+    if (GHE_REPO_RE.test(raw)) {
+        return {
+            ok: false,
+            error: `${source} ${JSON.stringify(raw)} looks like gh's HOST/OWNER/REPO form. ` +
+                'GitHub Enterprise is not supported in this version — use owner/name against github.com.',
+        };
+    }
+    return {
+        ok: false,
+        error: `${source} ${JSON.stringify(raw)} is not of the form owner/name ` +
+            '(each half must start with a letter or digit and contain only letters, digits, dot, dash, underscore)',
+    };
+}
+/**
+ * Validate the discovery label.
+ *
+ * A comma is refused explicitly rather than folded into a charset message, because the
+ * failure it causes is silent and expensive: `gh`'s `--label` is a comma-split slice, so
+ * `aidlc,urgent` would AND two labels in discovery, return an empty issue map, and
+ * re-create every issue on every run. The discovery label *is* the identity of a
+ * projected issue, so a wrong one is a duplicate-issue generator, not a cosmetic error.
+ */
+export function validateLabel(raw) {
+    if (typeof raw !== 'string') {
+        return { ok: false, error: `roadmap.sync.label must be a string, got ${describe(raw)}` };
+    }
+    if (raw.length === 0) {
+        return { ok: false, error: 'roadmap.sync.label must not be empty' };
+    }
+    if (raw.includes(',')) {
+        return {
+            ok: false,
+            error: `roadmap.sync.label ${JSON.stringify(raw)} contains a comma. gh splits --label on ` +
+                'commas, so this would search for several labels at once, find nothing, and re-create ' +
+                'every issue on every run.',
+        };
+    }
+    if (/\s/.test(raw)) {
+        return { ok: false, error: `roadmap.sync.label ${JSON.stringify(raw)} contains whitespace` };
+    }
+    if (raw.length > MAX_LABEL_LENGTH) {
+        return {
+            ok: false,
+            error: `roadmap.sync.label is ${raw.length} characters; the maximum is ${MAX_LABEL_LENGTH}`,
+        };
+    }
+    return { ok: true, label: raw };
+}
+/** Validate the eligible-status list. */
+function validateStatuses(raw) {
+    if (!Array.isArray(raw)) {
+        return {
+            ok: false,
+            error: `roadmap.sync.statuses must be a list, got ${describe(raw)} (valid names: ${ROADMAP_STATUSES.join(', ')})`,
+        };
+    }
+    const statuses = [];
+    for (const entry of raw) {
+        if (typeof entry !== 'string' || !ROADMAP_STATUSES.includes(entry)) {
+            return {
+                ok: false,
+                error: `roadmap.sync.statuses contains ${describe(entry)}; valid names are ${ROADMAP_STATUSES.join(', ')}`,
+            };
+        }
+        if (!statuses.includes(entry))
+            statuses.push(entry);
+    }
+    if (!statuses.includes('done')) {
+        return {
+            ok: false,
+            error: 'roadmap.sync.statuses must include `done`. Without it the close path never runs, so ' +
+                'issues for finished work stay open forever and the projection never converges.',
+        };
+    }
+    return { ok: true, statuses };
+}
+/**
+ * Read and validate the `roadmap.sync` section from a checkout's config.
+ *
+ * @param primaryCheckoutRoot - The primary checkout's working tree.
+ */
+export function readSyncConfig(primaryCheckoutRoot) {
+    const doc = readDocument(primaryCheckoutRoot);
+    const roadmap = doc.roadmap;
+    if (roadmap === undefined)
+        return { kind: 'not-configured' };
+    if (typeof roadmap !== 'object' || roadmap === null || Array.isArray(roadmap)) {
+        return { kind: 'not-configured' };
+    }
+    const sync = roadmap.sync;
+    if (sync === undefined)
+        return { kind: 'not-configured' };
+    if (typeof sync !== 'object' || sync === null || Array.isArray(sync)) {
+        return { kind: 'not-configured' };
+    }
+    const s = sync;
+    if (s.provider === undefined) {
+        return { kind: 'invalid', error: 'roadmap.sync.provider is required; the only supported value is `github`' };
+    }
+    if (s.provider !== 'github') {
+        return {
+            kind: 'invalid',
+            error: `roadmap.sync.provider ${describe(s.provider)} is not supported; the only supported value is \`github\``,
+        };
+    }
+    let repo = null;
+    if (s.repo !== undefined && s.repo !== null) {
+        const checked = validateRepo(s.repo, 'roadmap.sync.repo');
+        if (!checked.ok)
+            return { kind: 'invalid', error: checked.error };
+        repo = checked.repo;
+    }
+    let statuses = DEFAULT_STATUSES;
+    if (s.statuses !== undefined) {
+        const checked = validateStatuses(s.statuses);
+        if (!checked.ok)
+            return { kind: 'invalid', error: checked.error };
+        statuses = checked.statuses;
+    }
+    let label = DEFAULT_DISCOVERY_LABEL;
+    if (s.label !== undefined) {
+        const checked = validateLabel(s.label);
+        if (!checked.ok)
+            return { kind: 'invalid', error: checked.error };
+        label = checked.label;
+    }
+    return { kind: 'ok', config: { provider: 'github', repo, statuses, label } };
+}
+/**
+ * Apply a `--repo` flag over a config, with identical validation.
+ *
+ * The flag wins. It is the likelier source of a wrong value — typed by hand, once —
+ * which is why it goes through the same validator rather than a looser one.
+ */
+export function withRepoOverride(config, repo) {
+    if (repo === undefined)
+        return { kind: 'ok', config };
+    const checked = validateRepo(repo, '--repo');
+    if (!checked.ok)
+        return { kind: 'invalid', error: checked.error };
+    return { kind: 'ok', config: { ...config, repo: checked.repo } };
+}
+/** The message for a project that has not opted in. */
+export function notConfiguredMessage() {
+    return ('roadmap projection is not configured. Add a `roadmap.sync` section to ' +
+        '.aidlc/config.yaml:\n\n' +
+        '  roadmap:\n' +
+        '    sync:\n' +
+        '      provider: github\n' +
+        `      statuses: [${DEFAULT_STATUSES.join(', ')}]\n\n` +
+        `By default ${DEFAULT_STATUSES.join(', ')} are projected; inbox and hold are not, ` +
+        'because an untriaged idea and a parked one are not decisions anybody has published.');
+}
+//# sourceMappingURL=config.js.map

package/dist/roadmap/sync/config.js.map

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

package/dist/roadmap/sync/discover.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Build the id → issue map the planner reconciles against.
+ *
+ * One `gh issue list` invocation over the discovery label. Three details are load-bearing
+ * and all three were wrong in the first draft:
+ *
+ * - **`--limit` must be explicit.** `gh issue list` defaults to 30 results. A single call
+ *   without a limit therefore returns at most 30 issues on a repo that has more, and every
+ *   item missing from the map plans a `create` — producing exactly the duplicate issues the
+ *   whole design exists to prevent, on every run, undetectably.
+ * - **Truncation must be a refusal, not a shrug.** A response of N issues is otherwise
+ *   indistinguishable from "N is all there are". So the requested limit travels with the
+ *   result and `count === limit` refuses before anything can plan a create.
+ * - **`labels` are objects.** `gh issue list --json labels` returns
+ *   `{id,name,description,color}`, not strings. Treating them as strings makes every
+ *   comparison against `aidlc:<status>` fail, so every item plans `update-labels` on every
+ *   run and the projection never converges. They are flattened to names here, at the
+ *   boundary, once.
+ *
+ * Requirements: roadmap-issue-projection/AC-11, roadmap-issue-projection/AC-12,
+ * roadmap-issue-projection/AC-13
+ *
+ * @module
+ */
+import { type GhRunner } from './gh.js';
+import type { RemoteIssue } from './types.js';
+/**
+ * How many issues one map may hold.
+ *
+ * `gh` pages internally up to `--limit`, so this is one paginated sequence rather than a
+ * cap on a single page. A repo that reaches it gets a named refusal; that is a better
+ * outcome than a partial map, and better than reimplementing cursors against an interface
+ * (`gh issue list`) that exposes none.
+ */
+export declare const ISSUE_LIST_LIMIT = 1000;
+export type DiscoverResult = {
+    kind: 'ok';
+    issues: readonly RemoteIssue[];
+} | {
+    kind: 'truncated';
+    count: number;
+    limit: number;
+} | {
+    kind: 'failed';
+    error: string;
+};
+export interface DiscoverOpts {
+    repo: string | null;
+    label: string;
+    limit?: number;
+}
+/** Read every labelled issue, open and closed. */
+export declare function buildIssueMap(gh: GhRunner, opts: DiscoverOpts): DiscoverResult;
+/** The message for a truncated map. */
+export declare function truncatedMessage(count: number, limit: number): string;
+//# sourceMappingURL=discover.d.ts.map

package/dist/roadmap/sync/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../../src/roadmap/sync/discover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,cAAc,CAoD9E;AAmCD,uCAAuC;AACvC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMrE"}

package/dist/roadmap/sync/discover.js

@@ -0,0 +1,126 @@
+/**
+ * Build the id → issue map the planner reconciles against.
+ *
+ * One `gh issue list` invocation over the discovery label. Three details are load-bearing
+ * and all three were wrong in the first draft:
+ *
+ * - **`--limit` must be explicit.** `gh issue list` defaults to 30 results. A single call
+ *   without a limit therefore returns at most 30 issues on a repo that has more, and every
+ *   item missing from the map plans a `create` — producing exactly the duplicate issues the
+ *   whole design exists to prevent, on every run, undetectably.
+ * - **Truncation must be a refusal, not a shrug.** A response of N issues is otherwise
+ *   indistinguishable from "N is all there are". So the requested limit travels with the
+ *   result and `count === limit` refuses before anything can plan a create.
+ * - **`labels` are objects.** `gh issue list --json labels` returns
+ *   `{id,name,description,color}`, not strings. Treating them as strings makes every
+ *   comparison against `aidlc:<status>` fail, so every item plans `update-labels` on every
+ *   run and the projection never converges. They are flattened to names here, at the
+ *   boundary, once.
+ *
+ * Requirements: roadmap-issue-projection/AC-11, roadmap-issue-projection/AC-12,
+ * roadmap-issue-projection/AC-13
+ *
+ * @module
+ */
+import { firstLine, repoArgs } from './gh.js';
+/**
+ * How many issues one map may hold.
+ *
+ * `gh` pages internally up to `--limit`, so this is one paginated sequence rather than a
+ * cap on a single page. A repo that reaches it gets a named refusal; that is a better
+ * outcome than a partial map, and better than reimplementing cursors against an interface
+ * (`gh issue list`) that exposes none.
+ */
+export const ISSUE_LIST_LIMIT = 1000;
+/** Read every labelled issue, open and closed. */
+export function buildIssueMap(gh, opts) {
+    const limit = opts.limit ?? ISSUE_LIST_LIMIT;
+    const result = gh.run([
+        'issue',
+        'list',
+        ...repoArgs(opts.repo),
+        '--label',
+        opts.label,
+        '--state',
+        'all',
+        '--limit',
+        String(limit),
+        '--json',
+        'number,title,state,labels,body',
+    ]);
+    if (!result.ok) {
+        return { kind: 'failed', error: firstLine(result.error) };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(result.stdout);
+    }
+    catch (err) {
+        return { kind: 'failed', error: `gh returned output that is not JSON: ${err.message}` };
+    }
+    if (!Array.isArray(parsed)) {
+        return { kind: 'failed', error: `gh returned ${typeof parsed} where a list of issues was expected` };
+    }
+    const issues = [];
+    for (const raw of parsed) {
+        const issue = toRemoteIssue(raw);
+        if (issue === null) {
+            return {
+                kind: 'failed',
+                error: 'gh returned an issue this version does not understand — expected number, title, ' +
+                    `state, labels[].name and body, got keys ${describeKeys(raw)}`,
+            };
+        }
+        issues.push(issue);
+    }
+    // Deliberately after parsing, so a truncated response is still shape-checked: a limit
+    // hit alongside a shape change should report the shape change too on the next run.
+    if (issues.length === limit) {
+        return { kind: 'truncated', count: issues.length, limit };
+    }
+    return { kind: 'ok', issues };
+}
+/**
+ * Narrow one `gh` issue object, or null when the shape is not what this version expects.
+ *
+ * Refusing beats coercing. A `title` read as `undefined` would compare unequal to every
+ * item title and plan an `update-title` for the whole roadmap.
+ */
+function toRemoteIssue(raw) {
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+        return null;
+    const r = raw;
+    if (typeof r.number !== 'number')
+        return null;
+    if (typeof r.title !== 'string')
+        return null;
+    if (typeof r.body !== 'string')
+        return null;
+    if (r.state !== 'OPEN' && r.state !== 'CLOSED')
+        return null;
+    if (!Array.isArray(r.labels))
+        return null;
+    const labels = [];
+    for (const entry of r.labels) {
+        if (typeof entry !== 'object' || entry === null)
+            return null;
+        const name = entry.name;
+        if (typeof name !== 'string')
+            return null;
+        labels.push(name);
+    }
+    return { number: r.number, title: r.title, state: r.state, labels, body: r.body };
+}
+/** Key list of an unexpected payload, for the shape-failure message. */
+function describeKeys(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return typeof raw;
+    return Object.keys(raw).sort().join(', ') || '(none)';
+}
+/** The message for a truncated map. */
+export function truncatedMessage(count, limit) {
+    return (`the issue map may be incomplete: gh returned ${count} issues, which is the limit ` +
+        `requested (${limit}). Refusing rather than planning creates for issues that may already ` +
+        'exist — a partial map turns every missing issue into a duplicate.');
+}
+//# sourceMappingURL=discover.js.map

package/dist/roadmap/sync/discover.js.map

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

package/dist/roadmap/sync/execute.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Apply a plan. The only module in this feature that writes anything to GitHub.
+ *
+ * It imports no `node:fs` — deliberately, and pinned by a test. `sync` writes nothing to
+ * disk, and the cheapest way to keep that true is for the writing module to have no
+ * ability to. Snapshotting a directory around a run would be the weaker check: cost
+ * capture writes into `.aidlc/` during a session, so a whole-tree snapshot is either
+ * flaky or has to exclude so much that it stops proving anything.
+ *
+ * A `create` is **one** invocation carrying the discovery label, the status label, and the
+ * body marker. If the label were applied by a second call, a process death between the two
+ * would strand an issue invisible to discovery — which the next run would duplicate. One
+ * invocation makes the issue discoverable the instant it exists, and that atomicity is
+ * what the whole no-local-state design rests on.
+ *
+ * Execution **aborts on the first failure**. A rate limit or an authorization failure will
+ * fail everything after it too, so continuing would turn one legible error into forty.
+ *
+ * Requirements: roadmap-issue-projection/AC-23, roadmap-issue-projection/AC-41,
+ * roadmap-issue-projection/AC-42, roadmap-issue-projection/AC-43,
+ * roadmap-issue-projection/AC-46
+ *
+ * @module
+ */
+import { type GhRunner } from './gh.js';
+import { type Plan, type PlanLine } from './types.js';
+export interface ExecReport {
+    applied: readonly PlanLine[];
+    /** Set when a write failed; everything in `notAttempted` was skipped because of it. */
+    failure: {
+        line: PlanLine;
+        error: string;
+    } | null;
+    notAttempted: readonly PlanLine[];
+}
+export declare function applyPlan(gh: GhRunner, plan: Plan, discoveryLabel: string): ExecReport;
+/** The `gh` argv for one write outcome. */
+export declare function invocationFor(plan: Plan, line: PlanLine, discoveryLabel: string): string[];
+/** Render an execution report for stdout. */
+export declare function renderExecReport(report: ExecReport): string;
+//# sourceMappingURL=execute.d.ts.map

package/dist/roadmap/sync/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/roadmap/sync/execute.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE7D,OAAO,EAAW,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC7B,uFAAuF;IACvF,OAAO,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClD,YAAY,EAAE,SAAS,QAAQ,EAAE,CAAC;CACnC;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,UAAU,CAyBtF;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CA6C1F;AAyCD,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAuB3D"}