@warpgogol/forge 0.4.0 → 0.5.0

package/dist/src/knowledge/promote.js

@@ -0,0 +1,120 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Cross-skill duplicate detection and promotion planning for shared knowledge layer (RFC-0663).</purpose>
+<non-goals>
+  <item>Do not read or write files — that is handled by parse.ts/serialize.ts and the distill skill.</item>
+  <item>Do not execute promotions — that is the operator's decision inside fo-knowledge-distill.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0663: initial cross-skill duplicate detection and promotion planning.</item>
+</CHANGE_SUMMARY>
+*/
+const STOP_WORDS = new Set(["the", "a", "an"]);
+const MIN_CONTAINMENT_LENGTH = 20;
+const MIN_CONTAINMENT_RATIO = 0.6;
+export function normalizeTitle(title) {
+    let result = title.toLowerCase();
+    result = result.replace(/[^\p{L}\p{N}\s]/gu, " ");
+    result = result.replace(/\s+/g, " ").trim();
+    const words = result.split(" ").filter((w) => w.length > 0 && !STOP_WORDS.has(w));
+    return words.join(" ");
+}
+function isExcludedEntry(meta) {
+    if (meta.status === "stale" || meta.status === "archived")
+        return true;
+    if (meta.promotedTo !== undefined && meta.promotedTo !== null)
+        return true;
+    return false;
+}
+function isLinkedPair(metaA, metaB) {
+    if (metaA.supersedes && metaB.id && metaA.supersedes.includes(metaB.id))
+        return true;
+    if (metaB.supersedes && metaA.id && metaB.supersedes.includes(metaA.id))
+        return true;
+    if (metaA.promotedTo && metaB.id && metaA.promotedTo === `shared/${metaB.id}`)
+        return true;
+    if (metaB.promotedTo && metaA.id && metaB.promotedTo === `shared/${metaA.id}`)
+        return true;
+    return false;
+}
+function collectActiveEntries(files) {
+    const active = [];
+    for (const file of files) {
+        if (file.parsed.isKnowledgeAdjacent)
+            continue;
+        if (file.parsed.parseIssues.length > 0)
+            continue;
+        for (const entry of file.parsed.entries) {
+            if (isExcludedEntry(entry.meta))
+                continue;
+            const normalized = normalizeTitle(entry.title);
+            if (normalized.length === 0)
+                continue;
+            active.push({ skill: file.skill, entry, normalizedTitle: normalized });
+        }
+    }
+    return active;
+}
+export function detectDuplicatePrinciples(files) {
+    const active = collectActiveEntries(files);
+    const pairs = [];
+    for (let i = 0; i < active.length; i++) {
+        for (let j = i + 1; j < active.length; j++) {
+            const a = active[i];
+            const b = active[j];
+            if (isLinkedPair(a.entry.meta, b.entry.meta))
+                continue;
+            if (a.normalizedTitle === b.normalizedTitle) {
+                pairs.push({
+                    a: { skill: a.skill, entryId: a.entry.meta.id, title: a.entry.title },
+                    b: { skill: b.skill, entryId: b.entry.meta.id, title: b.entry.title },
+                    normalizedTitle: a.normalizedTitle,
+                    kind: "exact",
+                });
+                continue;
+            }
+            const shorter = a.normalizedTitle.length <= b.normalizedTitle.length ? a : b;
+            const longer = a.normalizedTitle.length <= b.normalizedTitle.length ? b : a;
+            if (shorter.normalizedTitle.length < MIN_CONTAINMENT_LENGTH)
+                continue;
+            if (shorter.normalizedTitle.length < longer.normalizedTitle.length * MIN_CONTAINMENT_RATIO)
+                continue;
+            if (longer.normalizedTitle.includes(shorter.normalizedTitle)) {
+                pairs.push({
+                    a: { skill: a.skill, entryId: a.entry.meta.id, title: a.entry.title },
+                    b: { skill: b.skill, entryId: b.entry.meta.id, title: b.entry.title },
+                    normalizedTitle: shorter.normalizedTitle,
+                    kind: "containment",
+                });
+            }
+        }
+    }
+    return pairs;
+}
+export function planPromotion(sources, merged, nextSharedId, today) {
+    const totalConfirmations = sources.reduce((sum, s) => sum + (s.entry.meta.confirmations ?? 0), 0);
+    const promotedFrom = sources.map((s) => `${s.skill}/${s.entry.meta.id}`);
+    const sharedMeta = {
+        id: nextSharedId,
+        layer: "L2",
+        created: today,
+        lastConfirmedAt: today,
+        confirmations: totalConfirmations,
+        status: "active",
+        promotedFrom,
+    };
+    const sharedEntry = {
+        meta: sharedMeta,
+        title: merged.title,
+        body: merged.body,
+        lineStart: 0,
+    };
+    const localPointers = sources.map((s) => ({
+        skill: s.skill,
+        file: s.file,
+        entryId: s.entry.meta.id,
+    }));
+    return { sharedEntry, localPointers };
+}
+//# sourceMappingURL=promote.js.map

package/dist/src/knowledge/promote.js.map

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

package/dist/src/knowledge/schema.d.ts

@@ -0,0 +1,61 @@
+import { z } from "zod";
+export type KnowledgeLayer = "L0" | "L1" | "L2";
+export type KnowledgeEntryStatus = "active" | "stale" | "superseded" | "archived";
+export declare const knowledgeEntryMetaSchema: z.ZodObject<{
+    id: z.ZodString;
+    layer: z.ZodEnum<{
+        L0: "L0";
+        L1: "L1";
+        L2: "L2";
+    }>;
+    created: z.ZodString;
+    lastConfirmedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    confirmations: z.ZodOptional<z.ZodNumber>;
+    expiresAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    supersedes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    promotedTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    promotedFrom: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    status: z.ZodEnum<{
+        active: "active";
+        stale: "stale";
+        superseded: "superseded";
+        archived: "archived";
+    }>;
+}, z.core.$strip>;
+export interface KnowledgeEntryMeta {
+    id: string;
+    layer: KnowledgeLayer;
+    created: string;
+    lastConfirmedAt?: string | null;
+    confirmations?: number;
+    expiresAt?: string | null;
+    supersedes?: string[];
+    promotedTo?: string | null;
+    promotedFrom?: string[];
+    status: KnowledgeEntryStatus;
+}
+export interface KnowledgeEntry {
+    meta: KnowledgeEntryMeta;
+    title: string;
+    body: string;
+    lineStart: number;
+}
+export interface LegacySection {
+    text: string;
+    lineStart: number;
+}
+export interface ParseIssue {
+    line: number;
+    message: string;
+    entryId?: string;
+}
+export interface ParsedKnowledgeFile {
+    path: string;
+    layer: KnowledgeLayer | null;
+    preamble: string;
+    entries: KnowledgeEntry[];
+    legacySections: LegacySection[];
+    parseIssues: ParseIssue[];
+    isKnowledgeAdjacent: boolean;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/src/knowledge/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/knowledge/schema.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAChD,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,CAAC;AAmBlF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;iBAkCnC,CAAC;AAEH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,mBAAmB,EAAE,OAAO,CAAC;CAC9B"}

package/dist/src/knowledge/schema.js

@@ -0,0 +1,64 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Define the Zod metadata schema for knowledge entries with layer-specific refinements (RFC-0660).</purpose>
+<non-goals>
+  <item>Do not parse markdown — that is handled by parse.ts.</item>
+  <item>Do not serialize — that is handled by serialize.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0660: initial knowledge entry metadata schema with L0/L1/L2 layer-specific refinements.</item>
+  <item>RFC-0663: added promotedFrom field for shared-layer provenance tracking.</item>
+</CHANGE_SUMMARY>
+*/
+import { z } from "zod";
+const ENTRY_ID_PATTERN = /^K-\d{4}$/;
+const PROMOTED_TO_PATTERN = /^shared\/K-\d{4}$/;
+const PROMOTED_FROM_PATTERN = /^[a-z0-9-]+\/K-\d{4}$/;
+const baseMetaSchema = z.object({
+    id: z.string().regex(ENTRY_ID_PATTERN, "id must match ^K-\\d{4}$"),
+    layer: z.enum(["L0", "L1", "L2"]),
+    created: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "created must be YYYY-MM-DD"),
+    lastConfirmedAt: z.union([z.string().regex(/^\d{4}-\d{2}-\d{2}$/), z.null()]).optional(),
+    confirmations: z.number().int().min(0).optional(),
+    expiresAt: z.union([z.string().regex(/^\d{4}-\d{2}-\d{2}$/), z.null()]).optional(),
+    supersedes: z.array(z.string().regex(ENTRY_ID_PATTERN)).optional(),
+    promotedTo: z.union([z.string().regex(PROMOTED_TO_PATTERN), z.null()]).optional(),
+    promotedFrom: z.array(z.string().regex(PROMOTED_FROM_PATTERN)).optional(),
+    status: z.enum(["active", "stale", "superseded", "archived"]),
+});
+export const knowledgeEntryMetaSchema = baseMetaSchema.superRefine((data, ctx) => {
+    if (data.layer === "L0" || data.layer === "L1") {
+        if (data.confirmations !== undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `confirmations is forbidden on ${data.layer} entries`,
+                path: ["confirmations"],
+            });
+        }
+        if (data.lastConfirmedAt !== undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `lastConfirmedAt is forbidden on ${data.layer} entries`,
+                path: ["lastConfirmedAt"],
+            });
+        }
+    }
+    if (data.layer === "L2") {
+        if (data.confirmations === undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "confirmations is required on L2 entries",
+                path: ["confirmations"],
+            });
+        }
+        if (data.lastConfirmedAt === undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "lastConfirmedAt is required on L2 entries",
+                path: ["lastConfirmedAt"],
+            });
+        }
+    }
+});
+//# sourceMappingURL=schema.js.map

package/dist/src/knowledge/schema.js.map

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

package/dist/src/knowledge/serialize.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedKnowledgeFile } from "./schema.ts";
+export declare function serializeKnowledgeFile(parsed: ParsedKnowledgeFile): string;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/src/knowledge/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/knowledge/serialize.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAsB,MAAM,aAAa,CAAC;AAoC3E,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAsB1E"}

package/dist/src/knowledge/serialize.js

@@ -0,0 +1,67 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Round-trip serializer for knowledge files — reconstructs markdown from ParsedKnowledgeFile (RFC-0660).</purpose>
+<non-goals>
+  <item>Do not parse — that is handled by parse.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0660: initial round-trip serializer for structured knowledge entries.</item>
+  <item>RFC-0663: added promotedFrom to FIELD_ORDER for shared-layer provenance.</item>
+</CHANGE_SUMMARY>
+*/
+const FIELD_ORDER = [
+    "id",
+    "layer",
+    "created",
+    "lastConfirmedAt",
+    "confirmations",
+    "expiresAt",
+    "supersedes",
+    "promotedTo",
+    "promotedFrom",
+    "status",
+];
+function formatYamlValue(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return "[]";
+        return `[${value.join(", ")}]`;
+    }
+    if (typeof value === "string")
+        return value;
+    return String(value);
+}
+function serializeMeta(meta) {
+    const lines = ["```knowledge-entry"];
+    for (const field of FIELD_ORDER) {
+        const value = meta[field];
+        if (value === undefined)
+            continue;
+        lines.push(`${field}: ${formatYamlValue(value)}`);
+    }
+    lines.push("```");
+    return lines.join("\n");
+}
+export function serializeKnowledgeFile(parsed) {
+    const parts = [];
+    if (parsed.preamble) {
+        parts.push(parsed.preamble);
+    }
+    for (const entry of parsed.entries) {
+        parts.push(`### ${entry.meta.id}: ${entry.title}`);
+        parts.push("");
+        parts.push(serializeMeta(entry.meta));
+        if (entry.body) {
+            parts.push("");
+            parts.push(entry.body);
+        }
+    }
+    for (const legacy of parsed.legacySections) {
+        parts.push(legacy.text);
+    }
+    return parts.join("\n").replace(/\n{3,}/g, "\n\n") + "\n";
+}
+//# sourceMappingURL=serialize.js.map

package/dist/src/knowledge/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../../src/knowledge/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAIF,MAAM,WAAW,GAAiC;IAChD,IAAI;IACJ,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,eAAe;IACf,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,QAAQ;CACT,CAAC;AAEF,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IACjC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,aAAa,CAAC,IAAwB;IAC7C,MAAM,KAAK,GAAa,CAAC,oBAAoB,CAAC,CAAC;IAC/C,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAA2B;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;AAC5D,CAAC"}

package/dist/src/onboarding/agents-generate.d.ts

@@ -1,4 +1,13 @@
 import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../types.ts";
+type BehavioralRegister = "business" | "creative";
+export declare function substituteTemplate(content: string, terminology: Record<string, string>): string;
+export interface TemplateContext {
+    terminology: Record<string, string>;
+    register: BehavioralRegister;
+    domain: string | null;
+    workspaceType?: string;
+}
+export declare function selectRootTemplate(register: BehavioralRegister): string;
 interface AgentsGenerateResult {
     command: string;
     status: "pass" | "fail";
@@ -9,6 +18,12 @@ interface AgentsGenerateResult {
     renderedFiles?: {
         [relPath: string]: string;
     };
+    details?: Array<{
+        path: string;
+        domain?: string;
+        register?: string;
+        workspaceType?: string;
+    }>;
 }
 export declare function runAgentsGenerate(_input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<AgentsGenerateResult>>;
 export {};

package/dist/src/onboarding/agents-generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-generate.d.ts","sourceRoot":"","sources":["../../../src/onboarding/agents-generate.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAqQrB,UAAU,oBAAoB;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE;QAAE,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAC,CA6MnD"}
+{"version":3,"file":"agents-generate.d.ts","sourceRoot":"","sources":["../../../src/onboarding/agents-generate.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAErB,KAAK,kBAAkB,GAAG,UAAU,GAAG,UAAU,CAAC;AAGlD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,MAAM,CAKR;AAGD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAQvE;AAsRD,UAAU,oBAAoB;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE;QAAE,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC9C,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/F;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAC,CAqOnD"}

package/dist/src/onboarding/agents-generate.js

@@ -13,16 +13,52 @@
   <item>RFC-0549: replaced extended layer stub with full nine-section content from extended-behavioral-layer.ts.</item>
   <item>RFC-0551: added register-conditional commit policy to core behavioral layer.</item>
   <item>RFC-0611: added nested AGENTS.md generation for workspace directories + dryRun support.</item>
+  <item>RFC-0640: load workspaceTypes from stack profile and pass to generateNestedAgentsMd for profile-driven workspace detection.</item>
+  <item>RFC-0643: terminology substitution on final content, root template selection by register, details field in result.</item>
+  <item>RFC-0664: added project memory layer read discipline section to generated AGENTS.md.</item>
 </CHANGE_SUMMARY>
 */
 import fs from "node:fs";
 import path from "node:path";
 import { parse as parseYaml } from "yaml";
-import { loadForgeConfig, resolveBinding } from "../config/forge-config.js";
+import { loadForgeConfig, resolveBinding, resolveForgeRoot } from "../config/forge-config.js";
+import { resolveAllTerminology } from "../profiles/terminology-utils.js";
 import { FORGE_SKILLS } from "../registry.js";
 import { buildGeneratedHeader, hasGeneratedMarker, writeFileIfChanged } from "../utils/index.js";
 import { buildExtendedBehavioralLayer } from "./extended-behavioral-layer.js";
 import { generateNestedAgentsMd } from "./nested-agents-generate.js";
+import { listStackProfiles } from "../profiles/stack-profile.js";
+// RFC-0643: Template placeholder substitution for {{terminology.key}} patterns
+export function substituteTemplate(content, terminology) {
+    return content.replace(/\{\{terminology\.(\w+)\}\}/g, (_, key) => terminology[key] ?? key);
+}
+// RFC-0643: Root template paths
+const BUSINESS_ROOT_TEMPLATE = path.join(import.meta.dirname, "templates", "root-agents-business.md");
+const CREATIVE_ROOT_TEMPLATE = path.join(import.meta.dirname, "templates", "root-agents-creative.md");
+export function selectRootTemplate(register) {
+    try {
+        const templatePath = register === "creative" ? CREATIVE_ROOT_TEMPLATE : BUSINESS_ROOT_TEMPLATE;
+        return fs.readFileSync(templatePath, "utf8");
+    }
+    catch {
+        // Template file not found — fall back to empty string (dynamic sections will still be appended)
+        return "";
+    }
+}
+function replaceProjectPlaceholders(template, config, dynamicSections) {
+    let result = template;
+    result = result.replace(/\{\{projectName\}\}/g, config.project.name);
+    result = result.replace(/\{\{projectStack\}\}/g, config.project.stack.length > 0 ? config.project.stack.join(", ") : "(none)");
+    result = result.replace(/\{\{projectPm\}\}/g, config.project.packageManager);
+    result = result.replace(/\{\{rfcsDir\}\}/g, config.paths.rfcsDir);
+    result = result.replace(/\{\{adrsDir\}\}/g, config.paths.adrsDir);
+    result = result.replace(/\{\{plansDir\}\}/g, config.paths.plansDir);
+    result = result.replace(/\{\{auditsDir\}\}/g, config.paths.auditsDir);
+    result = result.replace(/\{\{specsDir\}\}/g, config.paths.specsDir);
+    result = result.replace(/\{\{skillsDir\}\}/g, config.paths.skillsDir);
+    result = result.replace(/\{\{dynamicSections\}\}/g, dynamicSections);
+    return result;
+}
 function readRegister(workspaceRoot) {
     const prefsPath = path.join(workspaceRoot, "PREFERENCES.md");
     try {
@@ -308,48 +344,27 @@ export async function runAgentsGenerate(_input, context) {
         ownerCommand: "forge.agents.generate",
         commandPrefix: "forge",
     });
-    const lines = [];
-    lines.push(header);
-    lines.push("");
-    lines.push(`# Agent Guide: ${config.project.name}`);
-    lines.push("");
-    lines.push("> This file is generated by `forge.agents.generate` from `forge.yaml`.");
-    lines.push("> Do not edit by hand — edit `forge.yaml` and regenerate.");
-    lines.push("");
-    // Project section
-    lines.push("## Project");
-    lines.push("");
-    lines.push(`- **Name:** ${config.project.name}`);
-    lines.push(`- **Stack:** ${config.project.stack.length > 0 ? config.project.stack.join(", ") : "(none)"}`);
-    lines.push(`- **Package manager:** ${config.project.packageManager}`);
-    lines.push("");
-    // Paths section
-    lines.push("## Paths");
-    lines.push("");
-    lines.push(`- RFCs: \`${config.paths.rfcsDir}\``);
-    lines.push(`- ADRs: \`${config.paths.adrsDir}\``);
-    lines.push(`- Plans: \`${config.paths.plansDir}\``);
-    lines.push(`- Audits: \`${config.paths.auditsDir}\``);
-    lines.push(`- Specs: \`${config.paths.specsDir}\``);
-    lines.push(`- Skills: \`${config.paths.skillsDir}\``);
-    lines.push("");
+    // RFC-0643: determine register from PREFERENCES.md or profile
+    const register = readRegister(workspaceRoot);
+    // Build dynamic sections (skills table, capabilities, behavioral layer)
+    const dynamicLines = [];
     // Skills table
-    lines.push("## Skills");
-    lines.push("");
-    lines.push("| Name | Category | Invocation | Concerns |");
-    lines.push("| --- | --- | --- | --- |");
+    dynamicLines.push("## Skills");
+    dynamicLines.push("");
+    dynamicLines.push("| Name | Category | Invocation | Concerns |");
+    dynamicLines.push("| --- | --- | --- | --- |");
     for (const skill of FORGE_SKILLS) {
-        lines.push(`| ${skill.name} | ${skill.category} | ${skill.invocation} | ${skill.concerns} |`);
+        dynamicLines.push(`| ${skill.name} | ${skill.category} | ${skill.invocation} | ${skill.concerns} |`);
     }
-    lines.push("");
+    dynamicLines.push("");
     // Capabilities section (RFC-0393)
     if (config.bindings) {
-        lines.push("## Capabilities");
-        lines.push("");
-        lines.push("Bindings resolved from `forge.yaml`:");
-        lines.push("");
-        lines.push("| Key | Status | Value |");
-        lines.push("| --- | --- | --- |");
+        dynamicLines.push("## Capabilities");
+        dynamicLines.push("");
+        dynamicLines.push("Bindings resolved from `forge.yaml`:");
+        dynamicLines.push("");
+        dynamicLines.push("| Key | Status | Value |");
+        dynamicLines.push("| --- | --- | --- |");
         const bindingKeys = [
             "commands.validateRfc",
             "commands.validateAdr",
@@ -367,43 +382,57 @@ export async function runAgentsGenerate(_input, context) {
             const value = resolveBinding(config, key);
             const status = value === null ? "absent" : "resolved";
             const display = value === null ? "—" : typeof value === "string" ? `\`${value}\`` : String(value);
-            lines.push(`| ${key} | ${status} | ${display} |`);
+            dynamicLines.push(`| ${key} | ${status} | ${display} |`);
         }
         // compassDocs array
         const compassDocs = resolveBinding(config, "paths.compassDocs");
         if (Array.isArray(compassDocs) && compassDocs.length > 0) {
-            lines.push(`| paths.compassDocs | resolved | ${compassDocs.map((d) => `\`${d}\``).join(", ")} |`);
+            dynamicLines.push(`| paths.compassDocs | resolved | ${compassDocs.map((d) => `\`${d}\``).join(", ")} |`);
         }
         else {
-            lines.push(`| paths.compassDocs | absent | — |`);
+            dynamicLines.push(`| paths.compassDocs | absent | — |`);
         }
         // terminology
         if (config.bindings.terminology && Object.keys(config.bindings.terminology).length > 0) {
-            lines.push("");
-            lines.push("**Terminology:**");
-            lines.push("");
+            dynamicLines.push("");
+            dynamicLines.push("**Terminology:**");
+            dynamicLines.push("");
             for (const [term, value] of Object.entries(config.bindings.terminology)) {
-                lines.push(`- ${term}: ${value}`);
+                dynamicLines.push(`- ${term}: ${value}`);
             }
         }
-        lines.push("");
+        dynamicLines.push("");
     }
     // Behavioral layer section (RFC-0548)
-    const register = readRegister(workspaceRoot);
     const behavioralLayer = generateBehavioralLayer(workspaceRoot, register);
-    lines.push(behavioralLayer);
-    lines.push("");
-    // Conventions section
-    lines.push("## Conventions");
-    lines.push("");
-    lines.push("- Use `forge.yaml` as the single source of truth for project configuration.");
-    lines.push("- Regenerate this file with `forge.agents.generate` after changing `forge.yaml`.");
-    lines.push("- Follow the closest `AGENTS.md` for workspace or directory details.");
-    lines.push("");
-    const content = lines.join("\n");
+    dynamicLines.push(behavioralLayer);
+    dynamicLines.push("");
+    // RFC-0664: Project memory layer read discipline
+    dynamicLines.push("## Project memory layer");
+    dynamicLines.push("");
+    dynamicLines.push("`.agents/memory/MEMORY.md` is the curated hot store (versioned). `.agents/memory/daily/YYYY-MM-DD.md` are append-only warm logs (git-ignored).");
+    dynamicLines.push("");
+    dynamicLines.push("**Session-start read discipline (advisory):** At session start, read `MEMORY.md` (always), then `daily/<today>.md` and `daily/<yesterday>.md` (if present). Older daily files are cold — use grep when a task references past context.");
+    dynamicLines.push("");
+    // RFC-0643: Load root template, replace project placeholders, insert dynamic sections
+    const rootTemplate = selectRootTemplate(register);
+    const dynamicSections = dynamicLines.join("\n");
+    let content = replaceProjectPlaceholders(rootTemplate, config, dynamicSections);
+    // Prepend generated header (above template content)
+    content = header + "\n\n" + content;
+    // RFC-0643: Apply terminology substitution on final assembled content
+    const profile = config.profile;
+    const resolvedTerminology = resolveAllTerminology(config, profile);
+    content = substituteTemplate(content, resolvedTerminology);
     const generated = ["AGENTS.md"];
     const skipped = [];
     const renderedFiles = {};
+    const details = [];
+    details.push({
+        path: "AGENTS.md",
+        domain: profile?.domain,
+        register,
+    });
     if (dryRun) {
         renderedFiles["AGENTS.md"] = content;
     }
@@ -414,10 +443,40 @@ export async function runAgentsGenerate(_input, context) {
         }
     }
     // Nested AGENTS.md generation (RFC-0611)
-    const nestedResult = await generateNestedAgentsMd(workspaceRoot, config, dryRun);
+    // RFC-0640: load workspaceTypes from stack profile for profile-driven detection
+    // RFC-0643: prefer config.profile (loaded by loadForgeConfig), fallback to stack-based lookup
+    let workspaceTypes;
+    if (profile?.workspaceTypes && profile.workspaceTypes.length > 0) {
+        workspaceTypes = profile.workspaceTypes;
+    }
+    else {
+        try {
+            const forgeRoot = resolveForgeRoot(workspaceRoot);
+            const profiles = listStackProfiles(forgeRoot);
+            for (const stackId of config.project.stack) {
+                const stackProfile = profiles.find((p) => p.id === stackId);
+                if (stackProfile?.workspaceTypes && stackProfile.workspaceTypes.length > 0) {
+                    workspaceTypes = stackProfile.workspaceTypes;
+                    break;
+                }
+            }
+        }
+        catch {
+            // forge root not resolvable — fallback to hardcoded detection
+        }
+    }
+    const nestedResult = await generateNestedAgentsMd(workspaceRoot, config, dryRun, workspaceTypes);
     generated.push(...nestedResult.generated);
     skipped.push(...nestedResult.skipped);
     Object.assign(renderedFiles, nestedResult.renderedFiles);
+    // RFC-0643: add details for nested files
+    for (const rel of nestedResult.generated) {
+        details.push({
+            path: rel,
+            domain: profile?.domain,
+            workspaceType: nestedResult.workspaceTypeMap?.[rel],
+        });
+    }
     if (!dryRun && outputFormat === "pretty") {
         for (const rel of nestedResult.generated) {
             logger.success(`Generated ${rel}`);
@@ -434,6 +493,7 @@ export async function runAgentsGenerate(_input, context) {
             generated,
             skipped,
             errors: [],
+            details,
             ...(dryRun ? { renderedFiles } : {}),
         },
         exitCode: 0,