@warpgogol/forge 2.1.0 → 2.2.0

package/dist/src/onboarding/invariant-engine.js

@@ -0,0 +1,416 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Generic invariant enforcement engine — reads check declarations from profile invariants and verifies files against them. Supports filename-pattern, file-contains, file-not-contains, and attribute-pattern check kinds.</purpose>
+<non-goals>
+  <item>Do not import from @warpgogol/* — this module is portable.</item>
+  <item>Do not implement domain-specific validation logic — all rules are declared in profile YAML.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0675: initial invariant enforcement engine with three check kinds.</item>
+  <item>RFC-0691: add html-attribute-pattern check kind for HTML attribute value validation.</item>
+  <item>RFC-0694: replace html-attribute-pattern with attribute-pattern (elements array) for HTML+JSX support.</item>
+  <item>RFC-0808: add link-resolution, frontmatter-required, path-exclusion check kinds for obsidian-vault profile.</item>
+  <item>Add gitignore-entry and secret-scan check kinds for godot-csharp profile.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+function matchGlob(filePath, glob) {
+    const normalizedPath = filePath.replace(/\\/g, "/");
+    const globRegex = globToRegex(glob);
+    return globRegex.test(normalizedPath);
+}
+function globToRegex(glob) {
+    let pattern = glob.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+    // Handle **/ : matches zero or more directory segments
+    pattern = pattern.replace(/\*\*\//g, "@@GLOBSTAR@@");
+    // Handle remaining ** (not followed by /)
+    pattern = pattern.replace(/\*\*/g, "@@GLOBSTAR2@@");
+    // Handle single * (matches within a path segment, no /)
+    pattern = pattern.replace(/\*/g, "[^/]*");
+    pattern = pattern.replace(/\?/g, "[^/]");
+    // Restore globstars
+    pattern = pattern.replace(/@@GLOBSTAR@@/g, "(?:[^/]+/)*");
+    pattern = pattern.replace(/@@GLOBSTAR2@@/g, ".*");
+    // Handle brace expansion {a,b}
+    pattern = pattern.replace(/\\{([^}]+)\\}/g, (_match, content) => {
+        const options = content.split(",").map((s) => s.trim());
+        return `(${options.join("|")})`;
+    });
+    pattern = `^${pattern}$`;
+    return new RegExp(pattern);
+}
+const SKIP_DIRS = new Set(["node_modules", ".git", ".turbo", "dist", ".cache"]);
+function collectFiles(dir, baseDir, results) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory() && SKIP_DIRS.has(entry.name))
+            continue;
+        const fullPath = path.join(dir, entry.name);
+        const relPath = path.relative(baseDir, fullPath).replace(/\\/g, "/");
+        if (entry.isDirectory()) {
+            collectFiles(fullPath, baseDir, results);
+        }
+        else {
+            results.push(relPath);
+        }
+    }
+}
+function compilePattern(invariant, pattern) {
+    try {
+        return new RegExp(pattern);
+    }
+    catch (err) {
+        const e = err;
+        return {
+            error: {
+                invariantId: invariant.id,
+                severity: "warning",
+                rule: invariant.rule,
+                file: "",
+                message: `Invariant ${invariant.id} has invalid check pattern: ${e.message}`,
+            },
+        };
+    }
+}
+function filterByGlob(files, glob) {
+    return files.filter((f) => matchGlob(f, glob));
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function runCheck(invariant, allFiles, workspaceRoot, check) {
+    const glob = check.glob;
+    const pattern = check.pattern ?? check.negatedPattern;
+    if (check.kind === "gitignore-entry") {
+        const gitignorePath = path.join(workspaceRoot, ".gitignore");
+        try {
+            const content = fs.readFileSync(gitignorePath, "utf8");
+            const lines = content.split(/\r?\n/).map((l) => l.trim());
+            if (!lines.includes(pattern ?? "")) {
+                return [{
+                        invariantId: invariant.id,
+                        severity: invariant.severity,
+                        rule: invariant.rule,
+                        file: ".gitignore",
+                        message: `.gitignore does not contain entry '${pattern}'`,
+                    }];
+            }
+        }
+        catch {
+            return [{
+                    invariantId: invariant.id,
+                    severity: invariant.severity,
+                    rule: invariant.rule,
+                    file: ".gitignore",
+                    message: `.gitignore not found`,
+                }];
+        }
+        return [];
+    }
+    if (!glob)
+        return [];
+    const matchedFiles = filterByGlob(allFiles, glob);
+    const needsPattern = check.kind === "filename-pattern" ||
+        check.kind === "file-contains" ||
+        check.kind === "file-not-contains" ||
+        check.kind === "attribute-pattern";
+    if (needsPattern && !pattern)
+        return [];
+    const compiled = pattern ? compilePattern(invariant, pattern) : null;
+    if (compiled && "error" in compiled)
+        return [compiled.error];
+    const regex = compiled && !("error" in compiled) ? compiled : null;
+    const violations = [];
+    switch (check.kind) {
+        case "filename-pattern":
+            for (const file of matchedFiles) {
+                const filename = path.basename(file);
+                if (!regex.test(filename)) {
+                    violations.push({
+                        invariantId: invariant.id,
+                        severity: invariant.severity,
+                        rule: invariant.rule,
+                        file,
+                        message: `Filename '${filename}' does not match pattern '${pattern}'`,
+                    });
+                }
+            }
+            break;
+        case "file-contains":
+            for (const file of matchedFiles) {
+                const fullPath = path.join(workspaceRoot, file);
+                try {
+                    const content = fs.readFileSync(fullPath, "utf8");
+                    if (!regex.test(content)) {
+                        violations.push({
+                            invariantId: invariant.id,
+                            severity: invariant.severity,
+                            rule: invariant.rule,
+                            file,
+                            message: `File '${file}' does not contain pattern '${pattern}'`,
+                        });
+                    }
+                }
+                catch {
+                    // skip unreadable files
+                }
+            }
+            break;
+        case "file-not-contains":
+            for (const file of matchedFiles) {
+                const fullPath = path.join(workspaceRoot, file);
+                try {
+                    const content = fs.readFileSync(fullPath, "utf8");
+                    if (regex.test(content)) {
+                        violations.push({
+                            invariantId: invariant.id,
+                            severity: invariant.severity,
+                            rule: invariant.rule,
+                            file,
+                            message: `File '${file}' contains forbidden pattern '${pattern}'`,
+                        });
+                    }
+                }
+                catch {
+                    // skip unreadable files
+                }
+            }
+            break;
+        case "attribute-pattern": {
+            const elements = check.elements;
+            const attribute = check.attribute;
+            if (!elements || elements.length === 0 || !attribute) {
+                violations.push({
+                    invariantId: invariant.id,
+                    severity: "warning",
+                    rule: invariant.rule,
+                    file: "",
+                    message: `Invariant ${invariant.id} has attribute-pattern check without elements or attribute`,
+                });
+                break;
+            }
+            const elementAlternation = elements.map(escapeRegex).join("|");
+            const elementRegex = new RegExp(`<(${elementAlternation})[^>]*>`, "gi");
+            const attrRegex = new RegExp(`${attribute}="([^"]*)"|${attribute}='([^']*)'`, "i");
+            for (const file of matchedFiles) {
+                const fullPath = path.join(workspaceRoot, file);
+                try {
+                    const content = fs.readFileSync(fullPath, "utf8");
+                    elementRegex.lastIndex = 0;
+                    let match;
+                    while ((match = elementRegex.exec(content)) !== null) {
+                        const elementSnippet = match[0];
+                        const matchedElement = match[1];
+                        const attrMatch = attrRegex.exec(elementSnippet);
+                        if (!attrMatch)
+                            continue;
+                        const attrValue = attrMatch[1] ?? attrMatch[2] ?? "";
+                        if (!regex.test(attrValue)) {
+                            violations.push({
+                                invariantId: invariant.id,
+                                severity: invariant.severity,
+                                rule: invariant.rule,
+                                file,
+                                message: `Element <${matchedElement}> attribute '${attribute}' value '${attrValue}' does not match pattern '${pattern}'`,
+                            });
+                        }
+                    }
+                }
+                catch {
+                    // skip unreadable files
+                }
+            }
+            break;
+        }
+        case "link-resolution": {
+            const allMdFiles = allFiles.filter((f) => f.endsWith(".md"));
+            const noteMap = new Map();
+            for (const mdFile of allMdFiles) {
+                const basename = path.basename(mdFile, ".md");
+                noteMap.set(basename, mdFile);
+                const fullPath = path.join(workspaceRoot, mdFile);
+                try {
+                    const content = fs.readFileSync(fullPath, "utf8");
+                    const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+                    if (fmMatch) {
+                        try {
+                            const fm = parseYaml(fmMatch[1]);
+                            if (fm.aliases && Array.isArray(fm.aliases)) {
+                                for (const alias of fm.aliases) {
+                                    if (typeof alias === "string")
+                                        noteMap.set(alias, mdFile);
+                                }
+                            }
+                        }
+                        catch {
+                            // skip malformed frontmatter
+                        }
+                    }
+                }
+                catch {
+                    // skip unreadable files
+                }
+            }
+            const linkRegex = /\[\[([^\]]+?)\]\]/g;
+            for (const file of matchedFiles) {
+                const fullPath = path.join(workspaceRoot, file);
+                try {
+                    const content = fs.readFileSync(fullPath, "utf8");
+                    const lines = content.split(/\r?\n/);
+                    for (let i = 0; i < lines.length; i++) {
+                        let match;
+                        linkRegex.lastIndex = 0;
+                        while ((match = linkRegex.exec(lines[i])) !== null) {
+                            const linkTarget = match[1].split("|")[0].split("#")[0].trim();
+                            if (!linkTarget)
+                                continue;
+                            if (!noteMap.has(linkTarget)) {
+                                violations.push({
+                                    invariantId: invariant.id,
+                                    severity: invariant.severity,
+                                    rule: invariant.rule,
+                                    file,
+                                    message: `Wikilink target '${linkTarget}' not found in vault`,
+                                });
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // skip unreadable files
+                }
+            }
+            break;
+        }
+        case "frontmatter-required": {
+            const fields = check.fields;
+            if (!fields || fields.length === 0)
+                break;
+            for (const file of matchedFiles) {
+                const fullPath = path.join(workspaceRoot, file);
+                try {
+                    const content = fs.readFileSync(fullPath, "utf8");
+                    const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+                    if (!fmMatch) {
+                        violations.push({
+                            invariantId: invariant.id,
+                            severity: invariant.severity,
+                            rule: invariant.rule,
+                            file,
+                            message: `File '${file}' has no frontmatter`,
+                        });
+                        break;
+                    }
+                    let fm = {};
+                    try {
+                        fm = parseYaml(fmMatch[1]);
+                    }
+                    catch {
+                        violations.push({
+                            invariantId: invariant.id,
+                            severity: invariant.severity,
+                            rule: invariant.rule,
+                            file,
+                            message: `File '${file}' has malformed frontmatter`,
+                        });
+                        break;
+                    }
+                    for (const field of fields) {
+                        if (!(field in fm) || fm[field] == null || fm[field] === "") {
+                            const hasH1 = /^\s*#\s+\S/.test(content.slice(fmMatch[0].length));
+                            if (field === "title" && hasH1)
+                                continue;
+                            violations.push({
+                                invariantId: invariant.id,
+                                severity: invariant.severity,
+                                rule: invariant.rule,
+                                file,
+                                message: `File '${file}' missing required field '${field}'`,
+                            });
+                        }
+                    }
+                }
+                catch {
+                    // skip unreadable files
+                }
+            }
+            break;
+        }
+        case "path-exclusion": {
+            for (const file of matchedFiles) {
+                violations.push({
+                    invariantId: invariant.id,
+                    severity: invariant.severity,
+                    rule: invariant.rule,
+                    file,
+                    message: `File '${file}' matches excluded pattern`,
+                });
+            }
+            break;
+        }
+        case "secret-scan": {
+            const secretPatterns = [
+                /(?:api[_-]?key|apikey)["'\s]*[:=]["'\s]*["'`]([A-Za-z0-9_\-]{20,})["'`]/gi,
+                /(?:secret|token|password|passwd)["'\s]*[:=]["'\s]*["'`]([^"'`\s]{8,})["'`]/gi,
+                /-----BEGIN [A-Z]+ PRIVATE KEY-----/g,
+                /sk_[a-zA-Z0-9]{20,}/g,
+                /gh[pousr]_[A-Za-z0-9]{36,}/g,
+                /AKIA[0-9A-Z]{16}/g,
+            ];
+            for (const file of matchedFiles) {
+                const fullPath = path.join(workspaceRoot, file);
+                try {
+                    const content = fs.readFileSync(fullPath, "utf8");
+                    for (const secretPattern of secretPatterns) {
+                        secretPattern.lastIndex = 0;
+                        let match;
+                        while ((match = secretPattern.exec(content)) !== null) {
+                            violations.push({
+                                invariantId: invariant.id,
+                                severity: invariant.severity,
+                                rule: invariant.rule,
+                                file,
+                                message: `Potential secret detected: ${match[0].slice(0, 30)}...`,
+                            });
+                        }
+                    }
+                }
+                catch {
+                    // skip unreadable files
+                }
+            }
+            break;
+        }
+    }
+    return violations;
+}
+export function checkInvariants(profile, workspaceRoot) {
+    if (!profile.invariants || profile.invariants.length === 0) {
+        return [];
+    }
+    const allFiles = [];
+    collectFiles(workspaceRoot, workspaceRoot, allFiles);
+    return profile.invariants.map((invariant) => {
+        if (!invariant.check) {
+            return {
+                invariantId: invariant.id,
+                severity: invariant.severity,
+                rule: invariant.rule,
+                checked: false,
+                violations: [],
+            };
+        }
+        const violations = runCheck(invariant, allFiles, workspaceRoot, invariant.check);
+        return {
+            invariantId: invariant.id,
+            severity: invariant.severity,
+            rule: invariant.rule,
+            checked: true,
+            violations,
+        };
+    });
+}
+//# sourceMappingURL=invariant-engine.js.map

package/dist/src/onboarding/invariant-engine.js.map

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

package/dist/src/onboarding/memory-scaffold.d.ts

@@ -0,0 +1,18 @@
+export declare const MEMORY_GITIGNORE_START = "# forge-agent-memory";
+export declare const MEMORY_GITIGNORE_END = "# /forge-agent-memory";
+export declare const DEFAULT_MEMORY_BUDGET = 4096;
+export interface MemoryScaffoldResult {
+    created: string[];
+    gitignoreUpdated: boolean;
+    skipped: string[];
+}
+export interface MemoryLayerHealth {
+    memoryMdChars: number;
+    budget: number;
+    gitignoreCoversDaily: boolean;
+    dailyFileCount: number;
+    memoryMdExists: boolean;
+}
+export declare function scaffoldMemoryLayer(workspaceRoot: string): MemoryScaffoldResult;
+export declare function checkMemoryLayerHealth(workspaceRoot: string): MemoryLayerHealth;
+//# sourceMappingURL=memory-scaffold.d.ts.map

package/dist/src/onboarding/memory-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-scaffold.d.ts","sourceRoot":"","sources":["../../../src/onboarding/memory-scaffold.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAC7D,eAAO,MAAM,oBAAoB,0BAA0B,CAAC;AAE5D,eAAO,MAAM,qBAAqB,OAAO,CAAC;AA4B1C,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;CACzB;AAsBD,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,oBAAoB,CA+C/E;AAkBD,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,iBAAiB,CAoC/E"}

package/dist/src/onboarding/memory-scaffold.js

@@ -0,0 +1,151 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Memory layer scaffold and health check (RFC-0664). Creates .agents/memory/MEMORY.md, .agents/memory/daily/.gitkeep, and a marker-delimited .gitignore block. Reports health for forge.doctor.</purpose>
+<non-goals>
+  <item>Do not overwrite existing MEMORY.md or daily/ files — idempotent only.</item>
+  <item>Do not enforce the read discipline — that is advisory, via AGENTS.md rules.</item>
+  <item>Do not change doctor's exit code — memory-layer warnings are advisory only.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0664: initial memory layer scaffold and health check.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { loadForgeConfig } from "../config/forge-config.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const MEMORY_GITIGNORE_START = "# forge-agent-memory";
+export const MEMORY_GITIGNORE_END = "# /forge-agent-memory";
+export const DEFAULT_MEMORY_BUDGET = 4096;
+const MEMORY_DIR = ".agents/memory";
+const DAILY_DIR = "daily";
+const MEMORY_MD = "MEMORY.md";
+const GITKEEP = ".gitkeep";
+const MEMORY_MD_TEMPLATE = `# Project Memory
+
+Curated project context (RFC-0664). This file is versioned — daily logs in \`daily/\` are git-ignored.
+
+## Current focus
+
+<!-- What is being worked on right now. One to three bullets max. -->
+
+## Decisions in flight
+
+<!-- Decisions under discussion but not yet final. -->
+
+## Environment notes
+
+<!-- Tool versions, environment quirks, known issues. -->
+`;
+// ---------------------------------------------------------------------------
+// Scaffold
+// ---------------------------------------------------------------------------
+function hasGitignoreBlock(content) {
+    return content.includes(MEMORY_GITIGNORE_START) && content.includes(MEMORY_GITIGNORE_END);
+}
+function insertGitignoreBlock(existingContent) {
+    const block = `${MEMORY_GITIGNORE_START}\n${MEMORY_DIR}/${DAILY_DIR}/\n${MEMORY_GITIGNORE_END}`;
+    if (existingContent.length === 0) {
+        return block + "\n";
+    }
+    // Ensure existing content ends with a newline before appending
+    const trimmed = existingContent.endsWith("\n") ? existingContent : existingContent + "\n";
+    return trimmed + "\n" + block + "\n";
+}
+export function scaffoldMemoryLayer(workspaceRoot) {
+    const created = [];
+    const skipped = [];
+    let gitignoreUpdated = false;
+    const memoryDir = path.join(workspaceRoot, MEMORY_DIR);
+    const dailyDirPath = path.join(memoryDir, DAILY_DIR);
+    const memoryMdPath = path.join(memoryDir, MEMORY_MD);
+    const gitkeepPath = path.join(dailyDirPath, GITKEEP);
+    // Create .agents/memory/ directory
+    fs.mkdirSync(memoryDir, { recursive: true });
+    fs.mkdirSync(dailyDirPath, { recursive: true });
+    // MEMORY.md — create only if absent
+    if (fs.existsSync(memoryMdPath)) {
+        skipped.push(MEMORY_MD);
+    }
+    else {
+        fs.writeFileSync(memoryMdPath, MEMORY_MD_TEMPLATE, "utf8");
+        created.push(`${MEMORY_DIR}/${MEMORY_MD}`);
+    }
+    // daily/.gitkeep — create only if absent
+    if (fs.existsSync(gitkeepPath)) {
+        skipped.push(`${DAILY_DIR}/${GITKEEP}`);
+    }
+    else {
+        fs.writeFileSync(gitkeepPath, "", "utf8");
+        created.push(`${MEMORY_DIR}/${DAILY_DIR}/${GITKEEP}`);
+    }
+    // .gitignore — add marker block if absent
+    const gitignorePath = path.join(workspaceRoot, ".gitignore");
+    if (fs.existsSync(gitignorePath)) {
+        const existing = fs.readFileSync(gitignorePath, "utf8");
+        if (hasGitignoreBlock(existing)) {
+            // Block already present — no update needed
+        }
+        else {
+            const updated = insertGitignoreBlock(existing);
+            fs.writeFileSync(gitignorePath, updated, "utf8");
+            gitignoreUpdated = true;
+        }
+    }
+    else {
+        fs.writeFileSync(gitignorePath, `${MEMORY_GITIGNORE_START}\n${MEMORY_DIR}/${DAILY_DIR}/\n${MEMORY_GITIGNORE_END}\n`, "utf8");
+        gitignoreUpdated = true;
+    }
+    return { created, gitignoreUpdated, skipped };
+}
+// ---------------------------------------------------------------------------
+// Health check
+// ---------------------------------------------------------------------------
+function resolveMemoryBudget(workspaceRoot) {
+    try {
+        const config = loadForgeConfig(workspaceRoot);
+        if (config.bindings?.memory?.budget !== undefined && config.bindings?.memory?.budget !== null) {
+            return config.bindings.memory.budget;
+        }
+    }
+    catch {
+        // forge.yaml not loadable — use default
+    }
+    return DEFAULT_MEMORY_BUDGET;
+}
+export function checkMemoryLayerHealth(workspaceRoot) {
+    const memoryDir = path.join(workspaceRoot, MEMORY_DIR);
+    const dailyDirPath = path.join(memoryDir, DAILY_DIR);
+    const memoryMdPath = path.join(memoryDir, MEMORY_MD);
+    const gitignorePath = path.join(workspaceRoot, ".gitignore");
+    // MEMORY.md char count
+    let memoryMdChars = 0;
+    const memoryMdExists = fs.existsSync(memoryMdPath);
+    if (memoryMdExists) {
+        memoryMdChars = fs.readFileSync(memoryMdPath, "utf8").length;
+    }
+    // Daily file count (exclude .gitkeep)
+    let dailyFileCount = 0;
+    if (fs.existsSync(dailyDirPath)) {
+        const entries = fs.readdirSync(dailyDirPath);
+        dailyFileCount = entries.filter((e) => e !== GITKEEP).length;
+    }
+    // Gitignore coverage
+    let gitignoreCoversDaily = false;
+    if (fs.existsSync(gitignorePath)) {
+        const content = fs.readFileSync(gitignorePath, "utf8");
+        gitignoreCoversDaily = hasGitignoreBlock(content);
+    }
+    const budget = resolveMemoryBudget(workspaceRoot);
+    return {
+        memoryMdChars,
+        budget,
+        gitignoreCoversDaily,
+        dailyFileCount,
+        memoryMdExists,
+    };
+}
+//# sourceMappingURL=memory-scaffold.js.map

package/dist/src/onboarding/memory-scaffold.js.map

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

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

@@ -0,0 +1,18 @@
+import { type PackageInfo } from "./nested-agents-templates.ts";
+import type { ForgeConfig } from "../config/forge-config.ts";
+import type { ProfileWorkspaceType } from "../profiles/profile-schema.ts";
+export interface NestedGenerateResult {
+    generated: string[];
+    skipped: string[];
+    renderedFiles: {
+        [relPath: string]: string;
+    };
+    workspaceTypeMap?: {
+        [relPath: string]: string;
+    };
+}
+export declare function readPackageInfo(workspaceRoot: string, wsPath: string): PackageInfo | undefined;
+export declare function generateNestedAgentsMd(workspaceRoot: string, config: ForgeConfig, dryRun: boolean, workspaceTypes?: ProfileWorkspaceType[]): Promise<NestedGenerateResult>;
+export { discoverWorkspaces, type WorkspaceDir, type WorkspaceType } from "./workspace-discovery.ts";
+export { buildNestedAgentsMd, selectNestedTemplate, type PackageInfo } from "./nested-agents-templates.ts";
+//# sourceMappingURL=nested-agents-generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nested-agents-generate.d.ts","sourceRoot":"","sources":["../../../src/onboarding/nested-agents-generate.ts"],"names":[],"mappings":"AAwBA,OAAO,EAA6C,KAAK,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAI1E,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE;QAAE,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC7C,gBAAgB,CAAC,EAAE;QAAE,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CAClD;AAED,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAQ9F;AAED,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,OAAO,EACf,cAAc,CAAC,EAAE,oBAAoB,EAAE,GACtC,OAAO,CAAC,oBAAoB,CAAC,CAqC/B;AAED,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACrG,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,8BAA8B,CAAC"}