@agent-plan/core 0.2.25 → 0.2.26

package/dist/refs.js

@@ -1,5 +1,30 @@
 // P00x  or  P00x(F00x)  — accept 1+ digits so "p1" == "p001".
 const PHASE_REF_RE = /^p(\d+)(?:\(f(\d+)\))?$/;
+const IDEA_REF_RE = /^i(\d+)$/;
+/**
+ * Resolve an idea by UUID, I00x number, shortId, exact title, then title
+ * inclusion. Ideas are top-level and never require feature/phase context.
+ */
+export function findIdeaByRef(ideas, ref) {
+    const normalized = ref.trim().toLowerCase();
+    if (!normalized)
+        return undefined;
+    const byId = ideas.find((idea) => idea.id.toLowerCase() === normalized);
+    if (byId)
+        return byId;
+    const match = normalized.match(IDEA_REF_RE);
+    if (match) {
+        const number = parseInt(match[1], 10);
+        const byNumber = ideas.find((idea) => idea.number === number);
+        if (byNumber)
+            return byNumber;
+    }
+    const byShortId = ideas.find((idea) => idea.shortId.toLowerCase() === normalized);
+    if (byShortId)
+        return byShortId;
+    return ideas.find((idea) => idea.title.toLowerCase() === normalized)
+        ?? ideas.find((idea) => idea.title.toLowerCase().includes(normalized));
+}
 /**
  * Resolve a phase reference to a Phase. Returns `undefined` when not found or
  * when a composite (F00x) parent does not match the phase's featureId.

package/dist/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,OAAO,EAAE,KAAK,EAAE,aAAa,EAAqB,MAAM,aAAa,CAAC;AAmBtG,qBAAa,YAAY;IACvB,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM;IA2KvC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;IAIjC,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,gBAAgB;IA6BxB,OAAO,CAAC,eAAe;IA2GvB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM;IAmDxD,mEAAmE;IACnE,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;CAejD"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,OAAO,EAAQ,KAAK,EAAE,aAAa,EAAqB,MAAM,aAAa,CAAC;AAuB5G,qBAAa,YAAY;IACvB,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM;IAgMvC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;IAIjC,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,gBAAgB;IA6BxB,OAAO,CAAC,eAAe;IA2GvB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM;IAmDxD,mEAAmE;IACnE,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;CAejD"}

package/dist/renderer.js

@@ -11,9 +11,12 @@ function phaseLabel(phase) {
 function taskLabel(task) {
     return `T${seq(task.number)} — ${task.title}`;
 }
+function ideaLabel(idea) {
+    return `I${seq(idea.number)} — ${idea.title}`;
+}
 export class PlanRenderer {
     renderPlan(plan) {
-        const { project, manifest, features, requirements, phases } = plan;
+        const { project, manifest, features, requirements, ideas, phases } = plan;
         const lines = [];
         lines.push(`# ${project.name} — Project Plan`);
         lines.push("");
@@ -72,6 +75,13 @@ export class PlanRenderer {
             lines.push(...renderAcceptedDecisions(project.acceptedDecisions));
             lines.push("");
         }
+        // ── Project Guidelines ──────────────────────────────────────────
+        if (project.projectGuidelines.content.trim()) {
+            lines.push("## Project Guidelines");
+            lines.push("");
+            lines.push(project.projectGuidelines.content.trim());
+            lines.push("");
+        }
         // ── Global Rules ─────────────────────────────────────────────────
         if (project.globalRules.length > 0) {
             lines.push("## Global Rules");
@@ -98,6 +108,19 @@ export class PlanRenderer {
             lines.push(bullet(wr.afterPhaseComplete));
             lines.push("");
         }
+        // ── Ideas Inbox ─────────────────────────────────────────────────
+        if (ideas.ideas.length > 0) {
+            lines.push("---");
+            lines.push("## Ideas Inbox");
+            lines.push("");
+            for (const idea of ideas.ideas) {
+                const promotion = idea.promotion ? ` → ${idea.promotion.targetRef}` : "";
+                lines.push(`- **${ideaLabel(idea)}**${promotion}`);
+                if (idea.description)
+                    lines.push(`  - ${idea.description}`);
+            }
+            lines.push("");
+        }
         // ── Features ────────────────────────────────────────────────────
         if (features.features.length > 0) {
             lines.push("---");

package/dist/requirement-macro-tasks.d.ts

@@ -0,0 +1,18 @@
+import type { MacroTask, RequirementStatus } from "./schema.js";
+export interface MacroTaskMutationInput {
+    /** Existing persisted ID only. Omit it for a new macro task. */
+    id?: string;
+    title: string;
+    description?: string;
+    status: RequirementStatus;
+}
+export declare class RequirementMacroTaskError extends Error {
+    constructor(message: string);
+}
+/**
+ * Reconciles user-authored macro-task fields while retaining all system-owned
+ * identity and timestamp values. The input array order is canonical, so a
+ * successful mutation also performs an explicit reorder atomically.
+ */
+export declare function reconcileRequirementMacroTasks(existing: readonly MacroTask[], inputs: readonly MacroTaskMutationInput[], timestamp: string): MacroTask[];
+//# sourceMappingURL=requirement-macro-tasks.d.ts.map

package/dist/requirement-macro-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirement-macro-tasks.d.ts","sourceRoot":"","sources":["../src/requirement-macro-tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAMhE,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,EAAE,MAAM;CAI5B;AAUD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,SAAS,SAAS,EAAE,EAC9B,MAAM,EAAE,SAAS,sBAAsB,EAAE,EACzC,SAAS,EAAE,MAAM,GAChB,SAAS,EAAE,CA+Bb"}

package/dist/requirement-macro-tasks.js

@@ -0,0 +1,55 @@
+const REQUIREMENT_STATUSES = new Set([
+    "planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting",
+]);
+export class RequirementMacroTaskError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "RequirementMacroTaskError";
+    }
+}
+function nextMacroTaskId(used) {
+    for (let number = 1; number <= 999; number += 1) {
+        const candidate = `MT-${String(number).padStart(3, "0")}`;
+        if (!used.has(candidate))
+            return candidate;
+    }
+    throw new RequirementMacroTaskError("A requirement cannot contain more than 999 macro tasks.");
+}
+/**
+ * Reconciles user-authored macro-task fields while retaining all system-owned
+ * identity and timestamp values. The input array order is canonical, so a
+ * successful mutation also performs an explicit reorder atomically.
+ */
+export function reconcileRequirementMacroTasks(existing, inputs, timestamp) {
+    const existingById = new Map(existing.map((task) => [task.id, task]));
+    const usedIds = new Set(existingById.keys());
+    const seenIds = new Set();
+    return inputs.map((input, index) => {
+        const title = input.title.trim();
+        if (!title)
+            throw new RequirementMacroTaskError(`Macro task ${index + 1} requires a title.`);
+        if (!REQUIREMENT_STATUSES.has(input.status)) {
+            throw new RequirementMacroTaskError(`Macro task ${index + 1} has an invalid status: ${input.status}.`);
+        }
+        const requestedId = input.id?.trim();
+        if (requestedId && seenIds.has(requestedId)) {
+            throw new RequirementMacroTaskError(`Macro task ID ${requestedId} appears more than once.`);
+        }
+        if (requestedId)
+            seenIds.add(requestedId);
+        const previous = requestedId ? existingById.get(requestedId) : undefined;
+        if (requestedId && !previous) {
+            throw new RequirementMacroTaskError(`Macro task ID ${requestedId} is not owned by this requirement.`);
+        }
+        const id = previous?.id ?? nextMacroTaskId(usedIds);
+        usedIds.add(id);
+        return {
+            id,
+            title,
+            description: input.description?.trim() ?? "",
+            status: input.status,
+            createdAt: previous?.createdAt ?? timestamp,
+            updatedAt: timestamp,
+        };
+    });
+}