@roackb2/heddle 1.0.3 → 1.2.0

package/dist/src/core/awareness/domains/coding/collectors/git.js

@@ -0,0 +1,257 @@
+import { execFile } from 'node:child_process';
+export async function collectGitWorkingEnvironment(workspaceRoot) {
+    const sources = [];
+    const limits = [];
+    const insideWorkTree = await runGit(workspaceRoot, ['rev-parse', '--is-inside-work-tree']);
+    sources.push({ kind: 'git', command: 'git rev-parse --is-inside-work-tree' });
+    if (insideWorkTree.exitCode !== 0 || insideWorkTree.stdout.trim() !== 'true') {
+        limits.push({
+            kind: 'not_applicable',
+            subject: 'git',
+            detail: 'Workspace is not inside a git work tree.',
+        });
+        return {
+            environment: createNonGitEnvironment(),
+            sources,
+            limits,
+        };
+    }
+    const [repoRootResult, branchResult, commitResult, statusResult] = await Promise.all([
+        runGit(workspaceRoot, ['rev-parse', '--show-toplevel']),
+        runGit(workspaceRoot, ['branch', '--show-current']),
+        runGit(workspaceRoot, ['rev-parse', '--short', 'HEAD']),
+        runGit(workspaceRoot, ['status', '--porcelain=v1', '-z', '--untracked-files=all']),
+    ]);
+    sources.push({ kind: 'git', command: 'git rev-parse --show-toplevel' }, { kind: 'git', command: 'git branch --show-current' }, { kind: 'git', command: 'git rev-parse --short HEAD' }, { kind: 'git', command: 'git status --porcelain=v1 -z --untracked-files=all' });
+    if (repoRootResult.exitCode !== 0) {
+        limits.push({
+            kind: 'unavailable',
+            subject: 'git repository root',
+            detail: normalizeError(repoRootResult.stderr) ?? 'Unable to resolve git repository root.',
+        });
+    }
+    if (branchResult.exitCode !== 0) {
+        limits.push({
+            kind: 'unavailable',
+            subject: 'git branch',
+            detail: normalizeError(branchResult.stderr) ?? 'Unable to resolve current git branch.',
+        });
+    }
+    if (commitResult.exitCode !== 0) {
+        limits.push({
+            kind: 'unavailable',
+            subject: 'git commit',
+            detail: normalizeError(commitResult.stderr) ?? 'Unable to resolve current git commit.',
+        });
+    }
+    if (statusResult.exitCode !== 0) {
+        limits.push({
+            kind: 'unavailable',
+            subject: 'git status',
+            detail: normalizeError(statusResult.stderr) ?? 'Unable to resolve git working tree status.',
+        });
+    }
+    const parsedStatus = statusResult.exitCode === 0 ? parsePorcelainStatus(statusResult.stdout) : [];
+    const groupedStatus = groupPaths(parsedStatus);
+    const boundedStatus = applyPathLimits(groupedStatus.paths);
+    const paths = boundedStatus.paths;
+    const hasVisibleChanges = paths.staged.length > 0 ||
+        paths.modified.length > 0 ||
+        paths.deleted.length > 0 ||
+        paths.untracked.length > 0 ||
+        paths.renamed.length > 0;
+    const hasOmittedChanges = groupedStatus.omittedCount > 0;
+    const isDirty = hasVisibleChanges || hasOmittedChanges;
+    if (groupedStatus.omittedCount > 0) {
+        limits.push({
+            kind: 'omitted',
+            subject: 'git working tree paths',
+            detail: `Omitted ${groupedStatus.omittedCount} runtime or dependency path entries such as .heddle, .git, node_modules, dist, coverage, and cache folders.`,
+        });
+    }
+    limits.push(...boundedStatus.limits);
+    return {
+        environment: {
+            gitRepositoryRoot: repoRootResult.exitCode === 0 ? repoRootResult.stdout.trim() || undefined : undefined,
+            gitBranch: branchResult.exitCode === 0 ? branchResult.stdout.trim() || undefined : undefined,
+            gitShortCommit: commitResult.exitCode === 0 ? commitResult.stdout.trim() || undefined : undefined,
+            isGitRepository: true,
+            isDirty,
+            paths,
+        },
+        sources,
+        limits,
+    };
+}
+function createNonGitEnvironment() {
+    return {
+        isGitRepository: false,
+        isDirty: false,
+        paths: {
+            staged: [],
+            modified: [],
+            deleted: [],
+            untracked: [],
+            renamed: [],
+        },
+    };
+}
+function groupPaths(entries) {
+    const staged = new Set();
+    const modified = new Set();
+    const deleted = new Set();
+    const untracked = new Set();
+    const renamed = new Map();
+    let omittedCount = 0;
+    for (const entry of entries) {
+        if (isNoisePath(entry.path) || (entry.oldPath && isNoisePath(entry.oldPath))) {
+            omittedCount += 1;
+            continue;
+        }
+        if (entry.indexStatus === '?' && entry.workingTreeStatus === '?') {
+            untracked.add(entry.path);
+            continue;
+        }
+        if (entry.indexStatus === 'R' && entry.oldPath) {
+            renamed.set(entry.oldPath, entry.path);
+        }
+        if (entry.indexStatus !== ' ' && entry.indexStatus !== '?' && entry.indexStatus !== 'D' && entry.indexStatus !== 'R') {
+            staged.add(entry.path);
+        }
+        if (entry.workingTreeStatus === 'M') {
+            modified.add(entry.path);
+        }
+        if (entry.indexStatus === 'D' || entry.workingTreeStatus === 'D') {
+            deleted.add(entry.path);
+        }
+        if (entry.indexStatus === 'M') {
+            staged.add(entry.path);
+        }
+        if (entry.indexStatus === 'A') {
+            staged.add(entry.path);
+        }
+    }
+    for (const deletedPath of deleted) {
+        staged.delete(deletedPath);
+        modified.delete(deletedPath);
+    }
+    return {
+        paths: {
+            staged: [...staged].sort(),
+            modified: [...modified].sort(),
+            deleted: [...deleted].sort(),
+            untracked: [...untracked].sort(),
+            renamed: [...renamed.entries()].sort(([left], [right]) => left.localeCompare(right)).map(([from, to]) => ({ from, to })),
+        },
+        omittedCount,
+    };
+}
+function isNoisePath(path) {
+    const segments = path.split('/').filter(Boolean);
+    return segments.some((segment) => OMITTED_PATH_SEGMENTS.has(segment));
+}
+export const OMITTED_PATH_SEGMENTS = new Set([
+    '.git',
+    '.heddle',
+    'node_modules',
+    'dist',
+    'coverage',
+    'build',
+    '.next',
+    '.turbo',
+    '.cache',
+    'test-results',
+]);
+const MAX_PATHS_PER_GROUP = 20;
+function applyPathLimits(paths) {
+    const limits = [];
+    const staged = truncatePathGroup(paths.staged, 'staged paths', limits);
+    const modified = truncatePathGroup(paths.modified, 'modified paths', limits);
+    const deleted = truncatePathGroup(paths.deleted, 'deleted paths', limits);
+    const untracked = truncatePathGroup(paths.untracked, 'untracked paths', limits);
+    const renamed = truncateRenamedGroup(paths.renamed, limits);
+    return {
+        paths: {
+            staged,
+            modified,
+            deleted,
+            untracked,
+            renamed,
+        },
+        limits,
+    };
+}
+function truncatePathGroup(paths, subject, limits) {
+    if (paths.length <= MAX_PATHS_PER_GROUP) {
+        return paths;
+    }
+    const omittedCount = paths.length - MAX_PATHS_PER_GROUP;
+    limits.push({
+        kind: 'truncated',
+        subject,
+        detail: `Showing ${MAX_PATHS_PER_GROUP} of ${paths.length} entries; ${omittedCount} more omitted from the summary.`,
+    });
+    return paths.slice(0, MAX_PATHS_PER_GROUP);
+}
+function truncateRenamedGroup(paths, limits) {
+    if (paths.length <= MAX_PATHS_PER_GROUP) {
+        return paths;
+    }
+    const omittedCount = paths.length - MAX_PATHS_PER_GROUP;
+    limits.push({
+        kind: 'truncated',
+        subject: 'renamed paths',
+        detail: `Showing ${MAX_PATHS_PER_GROUP} of ${paths.length} entries; ${omittedCount} more omitted from the summary.`,
+    });
+    return paths.slice(0, MAX_PATHS_PER_GROUP);
+}
+function parsePorcelainStatus(stdout) {
+    const parts = stdout.split('\0').filter(Boolean);
+    const entries = [];
+    for (let index = 0; index < parts.length; index += 1) {
+        const raw = parts[index] ?? '';
+        if (raw.length < 4) {
+            continue;
+        }
+        const indexStatus = raw[0] ?? ' ';
+        const workingTreeStatus = raw[1] ?? ' ';
+        const path = raw.slice(3);
+        if (!path) {
+            continue;
+        }
+        if ((indexStatus === 'R' || indexStatus === 'C') && parts[index + 1]) {
+            entries.push({
+                path,
+                oldPath: parts[index + 1],
+                indexStatus,
+                workingTreeStatus,
+            });
+            index += 1;
+            continue;
+        }
+        entries.push({ path, oldPath: undefined, indexStatus, workingTreeStatus });
+    }
+    return entries;
+}
+function normalizeError(stderr) {
+    const trimmed = stderr.trim();
+    return trimmed || undefined;
+}
+function runGit(cwd, args) {
+    return new Promise((resolveResult) => {
+        execFile('git', args, {
+            cwd,
+            maxBuffer: 10 * 1024 * 1024,
+        }, (error, stdout, stderr) => {
+            const code = typeof error?.code === 'number'
+                ? error.code
+                : error ? 1 : 0;
+            resolveResult({
+                exitCode: code,
+                stdout: stdout.toString(),
+                stderr: stderr.toString(),
+            });
+        });
+    });
+}
+//# sourceMappingURL=git.js.map

package/dist/src/core/awareness/domains/coding/collectors/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../../../../../../src/core/awareness/domains/coding/collectors/git.ts"],"names":[],"mappings":"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"}

package/dist/src/core/awareness/domains/coding/collectors/project-signals.d.ts

@@ -0,0 +1,12 @@
+import type { AwarenessLimit, AwarenessSource } from '../../../types.js';
+import type { CodingInspectionSurface, CodingProjectSignals, CodingWorkingEnvironment } from '../types.js';
+export declare function collectCodingProjectSignals(input: {
+    workspaceRoot: string;
+    environment: CodingWorkingEnvironment;
+}): Promise<{
+    projectSignals: CodingProjectSignals;
+    inspectionSurfaces: CodingInspectionSurface[];
+    sources: AwarenessSource[];
+    limits: AwarenessLimit[];
+}>;
+//# sourceMappingURL=project-signals.d.ts.map

package/dist/src/core/awareness/domains/coding/collectors/project-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-signals.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/awareness/domains/coding/collectors/project-signals.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,aAAa,CAAC;AAyBrB,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,wBAAwB,CAAC;CACvC,GAAG,OAAO,CAAC;IACV,cAAc,EAAE,oBAAoB,CAAC;IACrC,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;IAC9C,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B,CAAC,CAkFD"}

package/dist/src/core/awareness/domains/coding/collectors/project-signals.js

@@ -0,0 +1,187 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { goProjectDetector } from '../detectors/go.js';
+import { javascriptProjectDetector } from '../detectors/javascript.js';
+import { pythonProjectDetector } from '../detectors/python.js';
+import { OMITTED_PATH_SEGMENTS } from './git.js';
+const DIRECTORY_ROLES = {
+    source: ['src', 'lib', 'app', 'cmd', 'internal', 'pkg'],
+    tests: ['test', 'tests', '__tests__'],
+    docs: ['docs'],
+    examples: ['examples'],
+    scripts: ['scripts'],
+    config: ['config', '.github'],
+};
+const SUPPORTED_PROJECT_DETECTORS = [
+    javascriptProjectDetector,
+    pythonProjectDetector,
+    goProjectDetector,
+];
+export async function collectCodingProjectSignals(input) {
+    const sources = [];
+    const limits = [];
+    const observedDirectories = {
+        source: [],
+        tests: [],
+        docs: [],
+        examples: [],
+        scripts: [],
+        config: [],
+    };
+    let dirents;
+    try {
+        dirents = await readdir(input.workspaceRoot, { withFileTypes: true });
+    }
+    catch (error) {
+        limits.push({
+            kind: 'unavailable',
+            subject: 'project signals',
+            detail: `Could not read workspace root entries: ${error instanceof Error ? error.message : String(error)}`,
+        });
+        return {
+            projectSignals: {
+                detectedProjects: [],
+                observedDirectories,
+                configFiles: [],
+            },
+            inspectionSurfaces: buildInspectionSurfaces({
+                projectSignals: {
+                    detectedProjects: [],
+                    observedDirectories,
+                    configFiles: [],
+                },
+                environment: input.environment,
+            }),
+            sources,
+            limits,
+        };
+    }
+    const visibleDirents = dirents.filter((dirent) => !OMITTED_PATH_SEGMENTS.has(dirent.name));
+    const rootEntries = visibleDirents.map((dirent) => dirent.name).sort();
+    for (const dirent of visibleDirents) {
+        if (!dirent.isDirectory()) {
+            continue;
+        }
+        for (const [role, names] of Object.entries(DIRECTORY_ROLES)) {
+            if (names.includes(dirent.name)) {
+                observedDirectories[role].push(dirent.name);
+            }
+        }
+    }
+    const detectorInput = {
+        workspaceRoot: input.workspaceRoot,
+        rootEntries,
+        readText: (relativePath) => readWorkspaceText(input.workspaceRoot, relativePath),
+    };
+    const contributions = (await Promise.all(SUPPORTED_PROJECT_DETECTORS.map((detector) => detector.detect(detectorInput)))).filter((value) => value !== null);
+    const projectSignals = mergeProjectSignals(contributions, observedDirectories);
+    for (const contribution of contributions) {
+        sources.push(...contribution.sources);
+        limits.push(...contribution.limits);
+    }
+    return {
+        projectSignals,
+        inspectionSurfaces: buildInspectionSurfaces({
+            projectSignals,
+            environment: input.environment,
+        }),
+        sources: dedupeSources(sources),
+        limits,
+    };
+}
+async function readWorkspaceText(workspaceRoot, relativePath) {
+    try {
+        return await readFile(`${workspaceRoot}/${relativePath}`, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+function mergeProjectSignals(contributions, observedDirectories) {
+    const detectedProjects = new Map();
+    const configFiles = new Set();
+    for (const contribution of contributions) {
+        detectedProjects.set(contribution.project.kind, contribution.project);
+        for (const configFile of contribution.configFiles) {
+            configFiles.add(configFile);
+        }
+    }
+    const normalizedObservedDirectories = normalizeObservedDirectories(observedDirectories);
+    return {
+        detectedProjects: [...detectedProjects.values()].sort((left, right) => left.kind.localeCompare(right.kind)),
+        observedDirectories: normalizedObservedDirectories,
+        configFiles: [...configFiles].sort(),
+    };
+}
+function buildInspectionSurfaces(args) {
+    const surfaces = [];
+    const manifestPaths = args.projectSignals.detectedProjects
+        .flatMap((project) => project.manifests.map((manifest) => manifest.path));
+    if (manifestPaths.length > 0) {
+        surfaces.push({
+            kind: 'manifest',
+            paths: manifestPaths.sort(),
+        });
+    }
+    for (const [role, paths] of Object.entries(args.projectSignals.observedDirectories)) {
+        if (paths.length === 0) {
+            continue;
+        }
+        surfaces.push({
+            kind: 'directory',
+            role,
+            paths,
+        });
+    }
+    if (args.projectSignals.configFiles.length > 0) {
+        surfaces.push({
+            kind: 'config_file',
+            paths: args.projectSignals.configFiles,
+        });
+    }
+    const verificationLabels = args.projectSignals.detectedProjects
+        .flatMap((project) => project.verificationSurfaces.map((surface) => surface.label));
+    if (verificationLabels.length > 0) {
+        surfaces.push({
+            kind: 'verification_surface',
+            labels: verificationLabels.sort(),
+        });
+    }
+    const dirtyCounts = {
+        staged: args.environment.paths.staged.length,
+        modified: args.environment.paths.modified.length,
+        deleted: args.environment.paths.deleted.length,
+        untracked: args.environment.paths.untracked.length,
+        renamed: args.environment.paths.renamed.length,
+    };
+    if (Object.values(dirtyCounts).some((count) => count > 0)) {
+        surfaces.push({
+            kind: 'dirty_paths',
+            counts: dirtyCounts,
+        });
+    }
+    return surfaces;
+}
+function dedupeSources(sources) {
+    const seen = new Set();
+    const deduped = [];
+    for (const source of sources) {
+        const key = `${source.kind}|${source.command ?? ''}|${source.path ?? ''}|${source.note ?? ''}`;
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        deduped.push(source);
+    }
+    return deduped;
+}
+function normalizeObservedDirectories(observedDirectories) {
+    return {
+        source: [...observedDirectories.source].sort(),
+        tests: [...observedDirectories.tests].sort(),
+        docs: [...observedDirectories.docs].sort(),
+        examples: [...observedDirectories.examples].sort(),
+        scripts: [...observedDirectories.scripts].sort(),
+        config: [...observedDirectories.config].sort(),
+    };
+}
+//# sourceMappingURL=project-signals.js.map

package/dist/src/core/awareness/domains/coding/collectors/project-signals.js.map

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

package/dist/src/core/awareness/domains/coding/collectors/workspace-tree.d.ts

@@ -0,0 +1,12 @@
+import type { AwarenessLimit, AwarenessSource } from '../../../types.js';
+import type { CodingWorkspaceTree } from '../types.js';
+export declare function collectCodingWorkspaceTree(input: {
+    workspaceRoot: string;
+    maxDepth?: number;
+    maxEntries?: number;
+}): Promise<{
+    tree: CodingWorkspaceTree;
+    sources: AwarenessSource[];
+    limits: AwarenessLimit[];
+}>;
+//# sourceMappingURL=workspace-tree.d.ts.map

package/dist/src/core/awareness/domains/coding/collectors/workspace-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-tree.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/awareness/domains/coding/collectors/workspace-tree.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAA4B,MAAM,aAAa,CAAC;AAMjF,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC;IACV,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B,CAAC,CA4DD"}

package/dist/src/core/awareness/domains/coding/collectors/workspace-tree.js

@@ -0,0 +1,126 @@
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { OMITTED_PATH_SEGMENTS } from './git.js';
+const DEFAULT_MAX_DEPTH = 2;
+const DEFAULT_MAX_ENTRIES = 60;
+export async function collectCodingWorkspaceTree(input) {
+    const maxDepth = input.maxDepth ?? DEFAULT_MAX_DEPTH;
+    const maxEntries = input.maxEntries ?? DEFAULT_MAX_ENTRIES;
+    const sources = [{
+            kind: 'filesystem',
+            path: input.workspaceRoot,
+            note: 'workspace tree',
+        }];
+    const limits = [];
+    const state = {
+        visitedEntries: 0,
+        omittedNoise: 0,
+        omittedByDepth: 0,
+        truncatedByEntryBudget: false,
+    };
+    const entries = await readTree({
+        absoluteRoot: input.workspaceRoot,
+        relativeRoot: '',
+        depth: 1,
+        maxDepth,
+        maxEntries,
+        state,
+    });
+    if (state.omittedNoise > 0) {
+        limits.push({
+            kind: 'omitted',
+            subject: 'workspace tree',
+            detail: `Omitted ${state.omittedNoise} runtime or dependency entries such as .git, .heddle, node_modules, dist, coverage, build, and cache folders.`,
+        });
+    }
+    if (state.omittedByDepth > 0) {
+        limits.push({
+            kind: 'truncated',
+            subject: 'workspace tree depth',
+            detail: `Stopped descending into ${state.omittedByDepth} director${state.omittedByDepth === 1 ? 'y' : 'ies'} at depth ${maxDepth}.`,
+        });
+    }
+    if (state.truncatedByEntryBudget) {
+        limits.push({
+            kind: 'truncated',
+            subject: 'workspace tree entries',
+            detail: `Showing at most ${maxEntries} entries across the tree; additional entries were omitted.`,
+        });
+    }
+    return {
+        tree: {
+            root: input.workspaceRoot,
+            maxDepth,
+            maxEntries,
+            entries,
+        },
+        sources,
+        limits,
+    };
+}
+async function readTree(args) {
+    let dirents;
+    try {
+        dirents = await readdir(args.absoluteRoot, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const visibleDirents = dirents
+        .filter((dirent) => {
+        if (OMITTED_PATH_SEGMENTS.has(dirent.name)) {
+            args.state.omittedNoise += 1;
+            return false;
+        }
+        return true;
+    })
+        .sort((left, right) => {
+        if (left.isDirectory() !== right.isDirectory()) {
+            return left.isDirectory() ? -1 : 1;
+        }
+        return left.name.localeCompare(right.name);
+    });
+    const entries = [];
+    for (const dirent of visibleDirents) {
+        if (args.state.visitedEntries >= args.maxEntries) {
+            args.state.truncatedByEntryBudget = true;
+            break;
+        }
+        const path = args.relativeRoot ? `${args.relativeRoot}/${dirent.name}` : dirent.name;
+        args.state.visitedEntries += 1;
+        if (dirent.isDirectory()) {
+            const node = {
+                path,
+                kind: 'directory',
+            };
+            if (args.depth >= args.maxDepth) {
+                node.truncated = true;
+                args.state.omittedByDepth += 1;
+            }
+            else if (!args.state.truncatedByEntryBudget) {
+                const children = await readTree({
+                    absoluteRoot: join(args.absoluteRoot, dirent.name),
+                    relativeRoot: path,
+                    depth: args.depth + 1,
+                    maxDepth: args.maxDepth,
+                    maxEntries: args.maxEntries,
+                    state: args.state,
+                });
+                if (children.length > 0) {
+                    node.children = children;
+                }
+                if (args.state.truncatedByEntryBudget) {
+                    node.truncated = true;
+                }
+            }
+            entries.push(node);
+            continue;
+        }
+        entries.push({
+            path,
+            kind: 'file',
+        });
+    }
+    return entries;
+}
+//# sourceMappingURL=workspace-tree.js.map

package/dist/src/core/awareness/domains/coding/collectors/workspace-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-tree.js","sourceRoot":"","sources":["../../../../../../../src/core/awareness/domains/coding/collectors/workspace-tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,KAIhD;IAKC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,iBAAiB,CAAC;IACrD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAC3D,MAAM,OAAO,GAAsB,CAAC;YAClC,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,KAAK,CAAC,aAAa;YACzB,IAAI,EAAE,gBAAgB;SACvB,CAAC,CAAC;IACH,MAAM,MAAM,GAAqB,EAAE,CAAC;IAEpC,MAAM,KAAK,GAAG;QACZ,cAAc,EAAE,CAAC;QACjB,YAAY,EAAE,CAAC;QACf,cAAc,EAAE,CAAC;QACjB,sBAAsB,EAAE,KAAK;KAC9B,CAAC;IAEF,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC;QAC7B,YAAY,EAAE,KAAK,CAAC,aAAa;QACjC,YAAY,EAAE,EAAE;QAChB,KAAK,EAAE,CAAC;QACR,QAAQ;QACR,UAAU;QACV,KAAK;KACN,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,gBAAgB;YACzB,MAAM,EAAE,WAAW,KAAK,CAAC,YAAY,+GAA+G;SACrJ,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,sBAAsB;YAC/B,MAAM,EAAE,2BAA2B,KAAK,CAAC,cAAc,YAAY,KAAK,CAAC,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,aAAa,QAAQ,GAAG;SACpI,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,sBAAsB,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,wBAAwB;YACjC,MAAM,EAAE,mBAAmB,UAAU,4DAA4D;SAClG,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,KAAK,CAAC,aAAa;YACzB,QAAQ;YACR,UAAU;YACV,OAAO;SACR;QACD,OAAO;QACP,MAAM;KACP,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,IAYvB;IACC,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,cAAc,GAAG,OAAO;SAC3B,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;QACjB,IAAI,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEL,MAAM,OAAO,GAA+B,EAAE,CAAC;IAE/C,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACjD,IAAI,CAAC,KAAK,CAAC,sBAAsB,GAAG,IAAI,CAAC;YACzC,MAAM;QACR,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QACrF,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,CAAC;QAE/B,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;YACzB,MAAM,IAAI,GAA6B;gBACrC,IAAI;gBACJ,IAAI,EAAE,WAAW;aAClB,CAAC;YAEF,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACtB,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,CAAC;YACjC,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,sBAAsB,EAAE,CAAC;gBAC9C,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC;oBAC9B,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC;oBAClD,YAAY,EAAE,IAAI;oBAClB,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC;oBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;iBAClB,CAAC,CAAC;gBACH,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;gBAC3B,CAAC;gBACD,IAAI,IAAI,CAAC,KAAK,CAAC,sBAAsB,EAAE,CAAC;oBACtC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACxB,CAAC;YACH,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,SAAS;QACX,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,IAAI;YACJ,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/core/awareness/domains/coding/collectors/workspace.d.ts

@@ -0,0 +1,16 @@
+import type { AwarenessCollectInput, AwarenessLimit, AwarenessSource } from '../../../types.js';
+import type { CodingInspectionSurface, CodingProjectSignals, CodingWorkingEnvironment, CodingWorkspaceTree } from '../types.js';
+export declare function collectCodingWorkingEnvironment(input: AwarenessCollectInput): Promise<{
+    environment: CodingWorkingEnvironment;
+    sources: AwarenessSource[];
+    limits: AwarenessLimit[];
+}>;
+export declare function collectCodingProjectDashboard(input: AwarenessCollectInput): Promise<{
+    environment: CodingWorkingEnvironment;
+    workspaceTree: CodingWorkspaceTree;
+    projectSignals: CodingProjectSignals;
+    inspectionSurfaces: CodingInspectionSurface[];
+    sources: AwarenessSource[];
+    limits: AwarenessLimit[];
+}>;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/src/core/awareness/domains/coding/collectors/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/awareness/domains/coding/collectors/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAKrB,wBAAsB,+BAA+B,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC;IAC3F,WAAW,EAAE,wBAAwB,CAAC;IACtC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B,CAAC,CAyBD;AAED,wBAAsB,6BAA6B,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC;IACzF,WAAW,EAAE,wBAAwB,CAAC;IACtC,aAAa,EAAE,mBAAmB,CAAC;IACnC,cAAc,EAAE,oBAAoB,CAAC;IACrC,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;IAC9C,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B,CAAC,CAsBD"}