@rasensio/aidlc 1.20.0 → 1.22.0

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

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

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

@@ -0,0 +1,139 @@
+/**
+ * Shared types for the roadmap → GitHub Issues projection.
+ *
+ * The projection is one-way: disk is the source of truth and the tracker is a
+ * rendering of it. Two consequences show up throughout these types.
+ *
+ * First, `sync` writes nothing to disk (design DD-1). There is no `remote:`
+ * frontmatter field and no cache: the durable link is the item `id`, carried in a
+ * body marker on the issue. Creating an issue and writing a local link would be two
+ * writes to two systems, and every failure of the second produces a duplicate on the
+ * next run.
+ *
+ * Second, an outcome is a *value*, not an action. `planProjection` returns a plan of
+ * outcomes and the command layer decides what to do with it, which is what makes the
+ * whole projection testable with no network and no `gh` binary.
+ *
+ * Requirements: roadmap-issue-projection/AC-14, roadmap-issue-projection/AC-46
+ *
+ * @module
+ */
+import type { RoadmapStatus } from '../paths.js';
+/**
+ * What the projection concluded about one item, or one issue.
+ *
+ * A closed set. The design review found that an open-ended vocabulary made two
+ * criteria unachievable — "the second plan contains only X or Y" cannot be checked
+ * against a list nobody wrote down.
+ */
+export type Outcome = 'create' | 'update-title' | 'update-labels' | 'update-body' | 'close' | 'unchanged' | 'skip' | 'state-divergent' | 'ineligible-with-issue' | 'orphan-missing' | 'label-without-marker';
+/** The five outcomes that write. Everything else is a report. */
+export declare const WRITE_OUTCOMES: readonly Outcome[];
+/**
+ * Outcomes that suppress every write for their item (design DE-18).
+ *
+ * `state-divergent` means a human closed the issue while the item is still live.
+ * Reopening it would relocate the two-writer loop rather than remove it, and
+ * retitling it would write to an issue somebody deliberately closed. So a terminal
+ * report is the *only* line its item emits.
+ */
+export declare const TERMINAL_REPORTS: readonly Outcome[];
+/** Execution order within one item: edit while the issue is still open, then close. */
+export declare const WRITE_ORDER: readonly Outcome[];
+/** True when this outcome performs a `gh` write. */
+export declare function isWrite(outcome: Outcome): boolean;
+/**
+ * The frontmatter facts a reader with no checkout cannot otherwise see.
+ *
+ * Every field is nullable and `null` means *not recorded*. It is never coerced to an
+ * empty string or a guess: an item with no `author` is a normal item, and rendering
+ * `not recorded` tells a reader something true, where a blank tells them nothing and an
+ * invented value tells them something false.
+ */
+export interface ItemFacts {
+    createdAt: string | null;
+    author: string | null;
+    source: string | null;
+    promotedTo: string | null;
+    /** Item ids, in file order. Empty when the key is absent or holds no usable ids. */
+    dependsOn: readonly string[];
+}
+/** An item that can be projected: parseable, with an id. */
+export interface ProjectableItem {
+    id: string;
+    /** Falls back to the filename slug when frontmatter carries no title. */
+    title: string;
+    status: RoadmapStatus;
+    filename: string;
+    /** Repo-relative path, for the issue body. */
+    relPath: string;
+    /** Everything below the frontmatter, verbatim. Projected after sanitization. */
+    body: string;
+    facts: ItemFacts;
+}
+/**
+ * Why an item cannot be projected.
+ *
+ * The two classes are distinguished because their remedies differ and only one of
+ * them has a tool. `aidlc doctor` repairs an unquoted title; nothing reports an item
+ * that parses fine with no `id`, so pointing a user at `doctor` for that class would
+ * send them to a command that says nothing (design DE-14).
+ */
+export type UnprojectableClass = 'unparseable' | 'missing-id';
+export interface UnprojectableRef {
+    /** `<status>/<filename>` — the form doctor output uses. */
+    label: string;
+    status: RoadmapStatus;
+    cls: UnprojectableClass;
+    reason: string;
+}
+/**
+ * One issue as the projection needs it.
+ *
+ * `labels` is already flattened to names. `gh issue list --json labels` returns
+ * objects (`{id,name,description,color}`), and treating them as strings would make
+ * every status-label comparison fail — so every item would plan `update-labels` on
+ * every run, forever, and the projection would never converge (design DE-9).
+ */
+export interface RemoteIssue {
+    number: number;
+    title: string;
+    state: 'OPEN' | 'CLOSED';
+    labels: readonly string[];
+    body: string;
+}
+/** One line of a plan. */
+export interface PlanLine {
+    outcome: Outcome;
+    /** null on issue-only lines (`orphan-missing`, `label-without-marker`). */
+    item: ProjectableItem | null;
+    issueNumber: number | null;
+    /** Short reason, e.g. `not-backfilled`, or the divergence in words. */
+    detail: string | null;
+    addLabels: readonly string[];
+    removeLabels: readonly string[];
+    /**
+     * The exact bytes to send, on `create` and `update-body`; null on every other outcome.
+     *
+     * Decided in the pure planner rather than in `execute.ts` (design DD-6). The merge that
+     * produces it has four branches and has to preserve a human's additions, which is
+     * exactly the kind of logic that should not live in the one module capable of
+     * irreversible writes — and here it is testable with no `gh` at all.
+     */
+    newBody: string | null;
+}
+export interface Plan {
+    /**
+     * Printed in the plan header *and* the confirmation prompt. A projection aimed at
+     * the wrong repository is only reversible before the first write, so the resolved
+     * target is stated at both moments a human can still stop it.
+     */
+    repoLabel: string;
+    /** `owner/name`, or null when `gh` resolves the current repository. */
+    repo: string | null;
+    lines: readonly PlanLine[];
+    /** Only outcomes actually present appear as keys. */
+    counts: Readonly<Partial<Record<Outcome, number>>>;
+    writeCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/roadmap/sync/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GACf,QAAQ,GACR,cAAc,GACd,eAAe,GACf,aAAa,GACb,OAAO,GACP,WAAW,GACX,MAAM,GACN,iBAAiB,GACjB,uBAAuB,GACvB,gBAAgB,GAChB,sBAAsB,CAAC;AAE3B,iEAAiE;AACjE,eAAO,MAAM,cAAc,EAAE,SAAS,OAAO,EAM5C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,OAAO,EAAiD,CAAC;AAEjG,uFAAuF;AACvF,eAAO,MAAM,WAAW,EAAE,SAAS,OAAO,EAMzC,CAAC;AAEF,oDAAoD;AACpD,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEjD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oFAAoF;IACpF,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,YAAY,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,EAAE,kBAAkB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0BAA0B;AAC1B,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uEAAuE;IACvE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,IAAI;IACnB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,qDAAqD;IACrD,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACnD,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/roadmap/sync/types.js

@@ -0,0 +1,50 @@
+/**
+ * Shared types for the roadmap → GitHub Issues projection.
+ *
+ * The projection is one-way: disk is the source of truth and the tracker is a
+ * rendering of it. Two consequences show up throughout these types.
+ *
+ * First, `sync` writes nothing to disk (design DD-1). There is no `remote:`
+ * frontmatter field and no cache: the durable link is the item `id`, carried in a
+ * body marker on the issue. Creating an issue and writing a local link would be two
+ * writes to two systems, and every failure of the second produces a duplicate on the
+ * next run.
+ *
+ * Second, an outcome is a *value*, not an action. `planProjection` returns a plan of
+ * outcomes and the command layer decides what to do with it, which is what makes the
+ * whole projection testable with no network and no `gh` binary.
+ *
+ * Requirements: roadmap-issue-projection/AC-14, roadmap-issue-projection/AC-46
+ *
+ * @module
+ */
+/** The five outcomes that write. Everything else is a report. */
+export const WRITE_OUTCOMES = [
+    'create',
+    'update-title',
+    'update-labels',
+    'update-body',
+    'close',
+];
+/**
+ * Outcomes that suppress every write for their item (design DE-18).
+ *
+ * `state-divergent` means a human closed the issue while the item is still live.
+ * Reopening it would relocate the two-writer loop rather than remove it, and
+ * retitling it would write to an issue somebody deliberately closed. So a terminal
+ * report is the *only* line its item emits.
+ */
+export const TERMINAL_REPORTS = ['state-divergent', 'ineligible-with-issue'];
+/** Execution order within one item: edit while the issue is still open, then close. */
+export const WRITE_ORDER = [
+    'create',
+    'update-title',
+    'update-labels',
+    'update-body',
+    'close',
+];
+/** True when this outcome performs a `gh` write. */
+export function isWrite(outcome) {
+    return WRITE_OUTCOMES.includes(outcome);
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/roadmap/sync/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAwBH,iEAAiE;AACjE,MAAM,CAAC,MAAM,cAAc,GAAuB;IAChD,QAAQ;IACR,cAAc;IACd,eAAe;IACf,aAAa;IACb,OAAO;CACR,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAuB,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;AAEjG,uFAAuF;AACvF,MAAM,CAAC,MAAM,WAAW,GAAuB;IAC7C,QAAQ;IACR,cAAc;IACd,eAAe;IACf,aAAa;IACb,OAAO;CACR,CAAC;AAEF,oDAAoD;AACpD,MAAM,UAAU,OAAO,CAAC,OAAgB;IACtC,OAAO,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rasensio/aidlc",
-  "version": "1.20.0",
+  "version": "1.22.0",
   "description": "AI Development Lifecycle Framework — structured lifecycle guidance for AI coding agents across platforms",
   "type": "module",
   "main": "dist/cli.js",
@@ -24,7 +24,7 @@
     "commander": "15.0.0",
     "picomatch": "4.0.5",
     "yaml": "2.9.0",
-    "@rasensio/aidlc-content": "1.20.0"
+    "@rasensio/aidlc-content": "1.22.0"
   },
   "devDependencies": {
     "@types/node": "22.15.32",