@cristiancorreau/forge 2.15.0 → 2.17.0

package/dist/lib/project-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-analysis.d.ts","sourceRoot":"","sources":["../../src/lib/project-analysis.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEtE,MAAM,WAAW,QAAQ;IACvB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,OAAO;IACtB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,IAAI,GAAG,aAAa,GAAG,QAAQ,CAAC;CAC9E;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,oEAAoE;IACpE,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChE,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,WAAW,EAAE,QAAQ,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,EAAE,OAAO,CAAC;CACd;AAkSD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAoC5D;AAED,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5C"}

package/dist/lib/project-analysis.js

@@ -0,0 +1,361 @@
+/**
+ * Static project analysis for `forge adopt` (brownfield onboarding).
+ *
+ * `analyzeProject(root)` reads an EXISTING codebase and derives, with NO LLM and
+ * NO execution, a structured `ProjectAnalysis`: name/description, the detected
+ * stack (reusing lib/detect.ts), top dependencies, scripts, a top-level
+ * directory map, the key files present, rough entrypoints, git remote/branch and
+ * the derived project type.
+ *
+ * Hard rule: this module NEVER throws on a real project tree. Every file read is
+ * guarded and degrades to a partial result. The output is FACTUAL — it only
+ * reports what was found on disk; it never invents behaviour. The semantic layer
+ * (business logic, architecture decisions) is the job of the /wiki-ingest skill.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from 'fs';
+import { join, basename } from 'path';
+import { detectStack } from './detect.js';
+import { inferProjectType } from './wizard-flow.js';
+/** Read+parse JSON, swallowing every error (missing/invalid → null). */
+function readJson(path) {
+    try {
+        if (!existsSync(path))
+            return null;
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Read a text file, swallowing every error (missing/unreadable → null). */
+function readText(path) {
+    try {
+        if (!existsSync(path) || !statSync(path).isFile())
+            return null;
+        return readFileSync(path, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/** Naive single-line value extractor for simple TOML/YAML-ish manifests. */
+function extractField(content, key) {
+    // Matches `key = "value"`, `key = 'value'`, `key: value`, `key: "value"`.
+    const re = new RegExp(`^\\s*${key}\\s*[:=]\\s*["']?([^"'\\n#]+?)["']?\\s*$`, 'm');
+    const m = content.match(re);
+    return m ? m[1].trim() : null;
+}
+/**
+ * Resolve the project name + description from the primary manifest, trying the
+ * common ecosystems in order. The first that yields a name wins.
+ */
+function resolveNameDescription(root) {
+    // npm
+    const pkg = readJson(join(root, 'package.json'));
+    if (pkg && typeof pkg.name === 'string') {
+        return {
+            name: pkg.name,
+            description: typeof pkg.description === 'string' ? pkg.description : null,
+            manifest: 'package.json',
+            ecosystem: 'npm',
+        };
+    }
+    // python (pyproject.toml — [project] or [tool.poetry])
+    const pyproject = readText(join(root, 'pyproject.toml'));
+    if (pyproject) {
+        const name = extractField(pyproject, 'name');
+        const description = extractField(pyproject, 'description');
+        if (name)
+            return { name, description, manifest: 'pyproject.toml', ecosystem: 'python' };
+    }
+    // php (composer.json)
+    const composer = readJson(join(root, 'composer.json'));
+    if (composer && typeof composer.name === 'string') {
+        return {
+            name: composer.name,
+            description: typeof composer.description === 'string' ? composer.description : null,
+            manifest: 'composer.json',
+            ecosystem: 'php',
+        };
+    }
+    // go (go.mod — `module example.com/foo`)
+    const goMod = readText(join(root, 'go.mod'));
+    if (goMod) {
+        const m = goMod.match(/^module\s+(\S+)/m);
+        if (m)
+            return { name: m[1], description: null, manifest: 'go.mod', ecosystem: 'go' };
+    }
+    // ruby (Gemfile has no name; *.gemspec might — fall back to the dir name).
+    if (existsSync(join(root, 'Gemfile'))) {
+        return { name: null, description: null, manifest: 'Gemfile', ecosystem: 'ruby' };
+    }
+    // python without name in pyproject, or requirements.txt only.
+    if (pyproject || existsSync(join(root, 'requirements.txt'))) {
+        return {
+            name: null, description: null,
+            manifest: pyproject ? 'pyproject.toml' : 'requirements.txt',
+            ecosystem: 'python',
+        };
+    }
+    return { name: null, description: null, manifest: null, ecosystem: 'unknown' };
+}
+/** Top dependencies (capped) from package.json or composer.json. */
+function resolveDependencies(root, ecosystem, limit = 12) {
+    const out = [];
+    const add = (obj, dev) => {
+        if (!obj || typeof obj !== 'object')
+            return;
+        for (const [name, version] of Object.entries(obj)) {
+            out.push({ name, version: typeof version === 'string' ? version : '*', dev });
+        }
+    };
+    if (ecosystem === 'npm') {
+        const pkg = readJson(join(root, 'package.json'));
+        if (pkg) {
+            add(pkg.dependencies, false);
+            add(pkg.devDependencies, true);
+        }
+    }
+    else if (ecosystem === 'php') {
+        const composer = readJson(join(root, 'composer.json'));
+        if (composer) {
+            add(composer.require, false);
+            add(composer['require-dev'], true);
+        }
+    }
+    // Runtime (non-dev) deps first, then dev; cap the list.
+    out.sort((a, b) => (a.dev === b.dev ? 0 : a.dev ? 1 : -1));
+    return out.slice(0, limit);
+}
+/** npm scripts (best-effort) from package.json. */
+function resolveScripts(root, ecosystem) {
+    if (ecosystem !== 'npm')
+        return {};
+    const pkg = readJson(join(root, 'package.json'));
+    const scripts = pkg?.scripts;
+    if (!scripts || typeof scripts !== 'object')
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(scripts)) {
+        if (typeof v === 'string')
+            out[k] = v;
+    }
+    return out;
+}
+/** Directory names we never descend into when counting files. */
+const SKIP_DIRS = new Set([
+    '.git', 'node_modules', '.venv', 'venv', '__pycache__', 'dist', 'build',
+    '.next', '.nuxt', '.svelte-kit', 'vendor', '.turbo', 'coverage', '.cache',
+    '.forge', '.idea', '.vscode', 'target',
+]);
+/** Recursively count files + tally extensions under `dir` (capped for speed). */
+function scanDir(dir, cap = 5000) {
+    const exts = new Map();
+    let count = 0;
+    const walk = (d) => {
+        if (count >= cap)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(d, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (count >= cap)
+                return;
+            if (e.isDirectory()) {
+                if (SKIP_DIRS.has(e.name))
+                    continue;
+                walk(join(d, e.name));
+            }
+            else if (e.isFile()) {
+                count++;
+                const dot = e.name.lastIndexOf('.');
+                const ext = dot > 0 ? e.name.slice(dot + 1).toLowerCase() : '';
+                if (ext && ext.length <= 8)
+                    exts.set(ext, (exts.get(ext) ?? 0) + 1);
+            }
+        }
+    };
+    walk(dir);
+    return { count, exts };
+}
+/** Build the top-level directory map (skips hidden + noise dirs). */
+function resolveDirectories(root) {
+    let entries;
+    try {
+        entries = readdirSync(root, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const dirs = [];
+    for (const e of entries) {
+        if (!e.isDirectory())
+            continue;
+        if (e.name.startsWith('.') || SKIP_DIRS.has(e.name))
+            continue;
+        const { count, exts } = scanDir(join(root, e.name));
+        const dominant = [...exts.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 3)
+            .map(([ext]) => ext);
+        dirs.push({ name: e.name, fileCount: count, dominantExtensions: dominant });
+    }
+    dirs.sort((a, b) => b.fileCount - a.fileCount);
+    return dirs;
+}
+/** Candidate key files, in a stable order, keyed by their classification. */
+const KEY_FILE_SPECS = [
+    { file: 'README.md', kind: 'readme' },
+    { file: 'README.rst', kind: 'readme' },
+    { file: 'README.txt', kind: 'readme' },
+    { file: 'package.json', kind: 'manifest' },
+    { file: 'pyproject.toml', kind: 'manifest' },
+    { file: 'requirements.txt', kind: 'manifest' },
+    { file: 'composer.json', kind: 'manifest' },
+    { file: 'Gemfile', kind: 'manifest' },
+    { file: 'go.mod', kind: 'manifest' },
+    { file: 'Dockerfile', kind: 'dockerfile' },
+    { file: 'docker-compose.yml', kind: 'dockerfile' },
+    { file: '.env.example', kind: 'env-example' },
+    { file: 'tsconfig.json', kind: 'config' },
+    { file: 'turbo.json', kind: 'config' },
+    { file: 'pnpm-workspace.yaml', kind: 'config' },
+];
+/** CI config files (presence only). */
+const CI_FILES = [
+    '.github/workflows',
+    '.gitlab-ci.yml',
+    '.circleci/config.yml',
+    'azure-pipelines.yml',
+];
+function resolveKeyFiles(root) {
+    const out = [];
+    let readmeSeen = false;
+    for (const { file, kind } of KEY_FILE_SPECS) {
+        // Only the first README variant is recorded as the canonical README.
+        if (kind === 'readme' && readmeSeen)
+            continue;
+        if (existsSync(join(root, file))) {
+            out.push({ path: file, kind });
+            if (kind === 'readme')
+                readmeSeen = true;
+        }
+    }
+    for (const ci of CI_FILES) {
+        if (existsSync(join(root, ci))) {
+            out.push({ path: ci, kind: 'ci' });
+            break;
+        }
+    }
+    return out;
+}
+/** Rough entrypoints: package.json main/bin + conventional source entry files. */
+function resolveEntrypoints(root, ecosystem) {
+    const found = new Set();
+    if (ecosystem === 'npm') {
+        const pkg = readJson(join(root, 'package.json'));
+        if (pkg) {
+            if (typeof pkg.main === 'string')
+                found.add(pkg.main);
+            if (typeof pkg.module === 'string')
+                found.add(pkg.module);
+            const bin = pkg.bin;
+            if (typeof bin === 'string')
+                found.add(bin);
+            else if (bin && typeof bin === 'object') {
+                for (const v of Object.values(bin)) {
+                    if (typeof v === 'string')
+                        found.add(v);
+                }
+            }
+        }
+    }
+    // Conventional source entries (presence on disk).
+    const candidates = [
+        'src/index.ts', 'src/index.js', 'src/main.ts', 'src/main.js',
+        'src/app.ts', 'src/app.js', 'index.ts', 'index.js', 'main.go',
+        'app/main.py', 'main.py', 'app.py', 'manage.py', 'src/main.py',
+        'cmd/main.go', 'config/application.rb',
+    ];
+    for (const c of candidates) {
+        if (existsSync(join(root, c)))
+            found.add(c.split('\\').join('/'));
+    }
+    return [...found].map(p => p.split('\\').join('/')).slice(0, 8);
+}
+/** Read git remote + branch from .git/ without spawning git (best-effort). */
+function resolveGit(root) {
+    const gitDir = join(root, '.git');
+    const info = { remote: null, branch: null };
+    if (!existsSync(gitDir))
+        return info;
+    const config = readText(join(gitDir, 'config'));
+    if (config) {
+        // The first remote "url = ..." entry.
+        const m = config.match(/\[remote [^\]]+\][^[]*?url\s*=\s*(\S+)/);
+        if (m)
+            info.remote = m[1];
+    }
+    const head = readText(join(gitDir, 'HEAD'));
+    if (head) {
+        const m = head.match(/ref:\s*refs\/heads\/(\S+)/);
+        if (m)
+            info.branch = m[1];
+        else if (/^[0-9a-f]{7,40}\s*$/.test(head.trim()))
+            info.branch = 'detached';
+    }
+    return info;
+}
+/**
+ * Analyze an existing project at `root`. Pure (no LLM, no process spawning) and
+ * total: it never throws — missing/unreadable files degrade to partial output.
+ */
+export function analyzeProject(root) {
+    const stack = (() => {
+        try {
+            return detectStack(root);
+        }
+        catch {
+            return {
+                language: null, backendLanguage: null, frontendLanguage: null, projectType: null,
+                backend: null, frontend: null, database: null, orm: null, packageManager: null,
+                testing: [], hasDocker: false, isMonorepo: false,
+            };
+        }
+    })();
+    const nd = resolveNameDescription(root);
+    const name = nd.name ?? basename(root) ?? 'project';
+    const description = nd.description ?? '';
+    // Project type: prefer the stack's inference; fall back to the framework-based
+    // inference so a bare repo still gets a sensible (backend) default.
+    const type = stack.projectType
+        ?? inferProjectType({ backend: stack.backend, frontend: stack.frontend });
+    return {
+        root,
+        name,
+        description,
+        manifest: nd.manifest,
+        ecosystem: nd.ecosystem,
+        stack,
+        type,
+        dependencies: resolveDependencies(root, nd.ecosystem),
+        scripts: resolveScripts(root, nd.ecosystem),
+        directories: resolveDirectories(root),
+        keyFiles: resolveKeyFiles(root),
+        entrypoints: resolveEntrypoints(root, nd.ecosystem),
+        git: resolveGit(root),
+    };
+}
+/** URL-safe slug from a project name (mirrors the wizard's toSlug). */
+export function slugify(name) {
+    return name.toLowerCase()
+        // npm scoped names: @scope/pkg → scope-pkg
+        .replace(/^@/, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'project';
+}
+//# sourceMappingURL=project-analysis.js.map

package/dist/lib/project-analysis.js.map

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

package/dist/lib/wiki-autogen.d.ts

@@ -0,0 +1,31 @@
+import type { ProjectAnalysis } from './project-analysis.js';
+interface WikiPage {
+    /** Section dir: concepts | entities | sources | synthesis. */
+    section: 'concepts' | 'entities' | 'sources' | 'synthesis';
+    /** File slug (without .md). */
+    slug: string;
+    /** Display title (for the index table). */
+    title: string;
+    /** One-line description (for the index table). */
+    description: string;
+    /** Full markdown content (frontmatter + body). */
+    content: string;
+}
+export interface WikiGenResult {
+    pages: string[];
+    rawSources: string[];
+}
+/**
+ * Build the list of wiki pages (pure — no I/O). Exposed for testing the content
+ * and link graph without touching the filesystem.
+ */
+export declare function buildWikiPages(a: ProjectAnalysis): WikiPage[];
+/**
+ * Generate the populated wiki under <root>/wiki/ from a ProjectAnalysis.
+ * Assumes the templated wiki structure already exists (scaffoldWikiStructure).
+ * Writes pages, copies raw sources, rewrites index.md and appends to log.md.
+ * Idempotent on re-run (pages are overwritten with the same factual content).
+ */
+export declare function generateWiki(a: ProjectAnalysis): WikiGenResult;
+export {};
+//# sourceMappingURL=wiki-autogen.d.ts.map

package/dist/lib/wiki-autogen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-autogen.d.ts","sourceRoot":"","sources":["../../src/lib/wiki-autogen.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,uBAAuB,CAAC;AAI7E,UAAU,QAAQ;IAChB,8DAA8D;IAC9D,OAAO,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;IAC3D,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;CACjB;AAifD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,eAAe,GAAG,QAAQ,EAAE,CAyC7D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,eAAe,GAAG,aAAa,CAqC9D"}