@libar-dev/architect 1.0.0-pre.3 → 1.0.0-pre.5

package/dist/api/arch-queries.js

@@ -1,310 +0,0 @@
-/**
- * @architect
- * @architect-pattern ArchQueriesImpl
- * @architect-status active
- * @architect-implements DataAPIArchitectureQueries
- * @architect-uses ProcessStateAPI, MasterDataset
- * @architect-used-by ProcessAPICLIImpl
- * @architect-arch-role service
- * @architect-arch-context api
- * @architect-arch-layer domain
- *
- * ## ArchQueries — Neighborhood, Comparison, Tags, Sources
- *
- * Pure functions over MasterDataset for deep architecture exploration.
- * No I/O — all data comes from pre-computed views.
- *
- * **When to Use:** When exploring architecture structure (neighborhoods, comparisons, tags, sources) via the Data API CLI.
- */
-import { getPatternName, findPatternByName, getRelationships } from './pattern-helpers.js';
-function resolveNeighborEntry(patterns, name) {
-    const p = findPatternByName(patterns, name);
-    return {
-        name,
-        status: p?.status,
-        archRole: p?.archRole,
-        archContext: p?.archContext,
-        file: p?.source.file,
-    };
-}
-// ---------------------------------------------------------------------------
-// computeNeighborhood
-// ---------------------------------------------------------------------------
-export function computeNeighborhood(name, dataset) {
-    const pattern = findPatternByName(dataset.patterns, name);
-    if (pattern === undefined)
-        return undefined;
-    const patternName = getPatternName(pattern);
-    const rels = getRelationships(dataset, patternName);
-    // Resolve relationship fields to NeighborEntry
-    const uses = (rels?.uses ?? []).map((n) => resolveNeighborEntry(dataset.patterns, n));
-    const usedBy = (rels?.usedBy ?? []).map((n) => resolveNeighborEntry(dataset.patterns, n));
-    const dependsOn = (rels?.dependsOn ?? []).map((n) => resolveNeighborEntry(dataset.patterns, n));
-    const enables = (rels?.enables ?? []).map((n) => resolveNeighborEntry(dataset.patterns, n));
-    // Same-context siblings
-    const ctx = pattern.archContext;
-    const sameContext = [];
-    if (ctx !== undefined && dataset.archIndex !== undefined) {
-        const contextPatterns = dataset.archIndex.byContext[ctx];
-        if (contextPatterns !== undefined) {
-            for (const p of contextPatterns) {
-                if (getPatternName(p) !== patternName) {
-                    sameContext.push(resolveNeighborEntry(dataset.patterns, getPatternName(p)));
-                }
-            }
-        }
-    }
-    return {
-        pattern: patternName,
-        context: pattern.archContext,
-        role: pattern.archRole,
-        layer: pattern.archLayer,
-        uses,
-        usedBy,
-        dependsOn,
-        enables,
-        sameContext,
-        implements: rels?.implementsPatterns ?? [],
-        implementedBy: (rels?.implementedBy ?? []).map((r) => r.name),
-    };
-}
-// ---------------------------------------------------------------------------
-// compareContexts
-// ---------------------------------------------------------------------------
-function aggregateContextDeps(contextPatterns, relationshipIndex) {
-    const deps = new Set();
-    for (const p of contextPatterns) {
-        const name = getPatternName(p);
-        const rels = relationshipIndex?.[name];
-        if (rels !== undefined) {
-            for (const u of rels.uses)
-                deps.add(u);
-            for (const d of rels.dependsOn)
-                deps.add(d);
-        }
-    }
-    return deps;
-}
-function findIntegrationPoints(ctx1Patterns, ctx1Name, ctx2PatternNames, ctx2Name, relationshipIndex) {
-    const points = [];
-    for (const p of ctx1Patterns) {
-        const name = getPatternName(p);
-        const rels = relationshipIndex?.[name];
-        if (rels === undefined)
-            continue;
-        for (const target of rels.uses) {
-            if (ctx2PatternNames.has(target)) {
-                points.push({
-                    from: name,
-                    fromContext: ctx1Name,
-                    to: target,
-                    toContext: ctx2Name,
-                    relationship: 'uses',
-                });
-            }
-        }
-        for (const target of rels.dependsOn) {
-            if (ctx2PatternNames.has(target)) {
-                points.push({
-                    from: name,
-                    fromContext: ctx1Name,
-                    to: target,
-                    toContext: ctx2Name,
-                    relationship: 'dependsOn',
-                });
-            }
-        }
-    }
-    return points;
-}
-export function compareContexts(ctx1, ctx2, dataset) {
-    const archIndex = dataset.archIndex;
-    if (archIndex === undefined)
-        return undefined;
-    const ctx1Patterns = archIndex.byContext[ctx1];
-    const ctx2Patterns = archIndex.byContext[ctx2];
-    if (ctx1Patterns === undefined || ctx2Patterns === undefined)
-        return undefined;
-    const ctx1Names = ctx1Patterns.map(getPatternName);
-    const ctx2Names = ctx2Patterns.map(getPatternName);
-    const ctx2NameSet = new Set(ctx2Names);
-    const ctx1NameSet = new Set(ctx1Names);
-    const deps1 = aggregateContextDeps(ctx1Patterns, dataset.relationshipIndex);
-    const deps2 = aggregateContextDeps(ctx2Patterns, dataset.relationshipIndex);
-    const shared = [];
-    const uniqueTo1 = [];
-    for (const d of deps1) {
-        if (deps2.has(d)) {
-            shared.push(d);
-        }
-        else {
-            uniqueTo1.push(d);
-        }
-    }
-    const uniqueTo2 = [];
-    for (const d of deps2) {
-        if (!deps1.has(d)) {
-            uniqueTo2.push(d);
-        }
-    }
-    // Integration points: relationships crossing the context boundary
-    const integrationPoints = [
-        ...findIntegrationPoints(ctx1Patterns, ctx1, ctx2NameSet, ctx2, dataset.relationshipIndex),
-        ...findIntegrationPoints(ctx2Patterns, ctx2, ctx1NameSet, ctx1, dataset.relationshipIndex),
-    ];
-    return {
-        context1: {
-            name: ctx1,
-            patternCount: ctx1Patterns.length,
-            patterns: ctx1Names,
-            allDependencies: [...deps1],
-        },
-        context2: {
-            name: ctx2,
-            patternCount: ctx2Patterns.length,
-            patterns: ctx2Names,
-            allDependencies: [...deps2],
-        },
-        sharedDependencies: shared,
-        uniqueToContext1: uniqueTo1,
-        uniqueToContext2: uniqueTo2,
-        integrationPoints,
-    };
-}
-// ---------------------------------------------------------------------------
-// aggregateTagUsage
-// ---------------------------------------------------------------------------
-export function aggregateTagUsage(dataset) {
-    const tagMap = new Map();
-    function increment(tag, value) {
-        let values = tagMap.get(tag);
-        if (values === undefined) {
-            values = new Map();
-            tagMap.set(tag, values);
-        }
-        values.set(value, (values.get(value) ?? 0) + 1);
-    }
-    for (const p of dataset.patterns) {
-        // Always-present fields
-        if (p.status !== undefined)
-            increment('status', p.status);
-        increment('category', String(p.category));
-        // Optional enum fields
-        if (p.archRole !== undefined)
-            increment('arch-role', p.archRole);
-        if (p.archContext !== undefined)
-            increment('arch-context', p.archContext);
-        if (p.archLayer !== undefined)
-            increment('arch-layer', p.archLayer);
-        // Optional value fields
-        if (p.phase !== undefined)
-            increment('phase', String(p.phase));
-        if (p.priority !== undefined)
-            increment('priority', p.priority);
-        if (p.quarter !== undefined)
-            increment('quarter', p.quarter);
-        if (p.team !== undefined)
-            increment('team', p.team);
-        if (p.effort !== undefined)
-            increment('effort', p.effort);
-    }
-    // Convert to sorted entries
-    const tags = [];
-    for (const [tag, values] of tagMap) {
-        const totalCount = [...values.values()].reduce((a, b) => a + b, 0);
-        const valueCounts = [...values.entries()]
-            .map(([value, count]) => ({ value, count }))
-            .sort((a, b) => b.count - a.count);
-        tags.push({ tag, count: totalCount, values: valueCounts });
-    }
-    tags.sort((a, b) => b.count - a.count);
-    return { tags, patternCount: dataset.patterns.length };
-}
-// ---------------------------------------------------------------------------
-// buildSourceInventory
-// ---------------------------------------------------------------------------
-function categorizeFile(filePath, pattern) {
-    if (filePath.includes('/stubs/'))
-        return 'Stubs';
-    if (filePath.includes('/decisions/') || pattern.adr !== undefined)
-        return 'Decisions';
-    if (filePath.endsWith('.feature'))
-        return 'Gherkin (features)';
-    if (filePath.endsWith('.ts'))
-        return 'TypeScript (annotated)';
-    return 'Other';
-}
-function deriveLocationPattern(files) {
-    if (files.length === 0)
-        return '';
-    // Find common prefix directory
-    const parts = files[0]?.split('/') ?? [];
-    let commonDepth = 0;
-    for (let i = 0; i < parts.length - 1; i++) {
-        if (files.some((f) => f.split('/')[i] !== parts[i]))
-            break;
-        commonDepth = i + 1;
-    }
-    const prefix = parts.slice(0, commonDepth).join('/');
-    const ext = files[0]?.split('.').pop() ?? '*';
-    return prefix !== '' ? `${prefix}/**/*.${ext}` : `**/*.${ext}`;
-}
-export function buildSourceInventory(dataset) {
-    const groupSets = new Map();
-    for (const p of dataset.patterns) {
-        const filePath = p.source.file;
-        const type = categorizeFile(filePath, p);
-        let fileSet = groupSets.get(type);
-        if (fileSet === undefined) {
-            fileSet = new Set();
-            groupSets.set(type, fileSet);
-        }
-        fileSet.add(filePath);
-    }
-    const types = [];
-    for (const [type, fileSet] of groupSets) {
-        const files = [...fileSet];
-        types.push({
-            type,
-            count: files.length,
-            locationPattern: deriveLocationPattern(files),
-            files,
-        });
-    }
-    types.sort((a, b) => b.count - a.count);
-    const totalFiles = types.reduce((sum, t) => sum + t.count, 0);
-    return { types, totalFiles };
-}
-/**
- * Find patterns with no relationships at all (isolated nodes in the graph).
- *
- * A pattern is an orphan if it has no uses, usedBy, dependsOn, enables,
- * implementsPatterns, implementedBy, extendedBy, seeAlso, or extendsPattern.
- */
-export function findOrphanPatterns(dataset) {
-    const index = dataset.relationshipIndex;
-    if (index === undefined)
-        return [];
-    const orphans = [];
-    for (const [name, rels] of Object.entries(index)) {
-        const hasAny = rels.uses.length > 0 ||
-            rels.usedBy.length > 0 ||
-            rels.dependsOn.length > 0 ||
-            rels.enables.length > 0 ||
-            rels.implementsPatterns.length > 0 ||
-            rels.implementedBy.length > 0 ||
-            rels.extendedBy.length > 0 ||
-            rels.seeAlso.length > 0 ||
-            rels.extendsPattern !== undefined;
-        if (!hasAny) {
-            const p = findPatternByName(dataset.patterns, name);
-            orphans.push({
-                pattern: name,
-                status: p?.status,
-                file: p?.source.file ?? '',
-            });
-        }
-    }
-    return orphans;
-}
-//# sourceMappingURL=arch-queries.js.map

package/dist/api/arch-queries.js.map

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

package/dist/api/context-assembler.d.ts

@@ -1,124 +0,0 @@
-/**
- * @architect
- * @architect-pattern ContextAssemblerImpl
- * @architect-status active
- * @architect-implements DataAPIContextAssembly
- * @architect-uses ProcessStateAPI, MasterDataset, PatternSummarizerImpl, FuzzyMatcherImpl, StubResolverImpl
- * @architect-used-by ProcessAPICLIImpl, ContextFormatterImpl
- * @architect-arch-role service
- * @architect-arch-context api
- * @architect-arch-layer application
- *
- * ## ContextAssembler — Session-Oriented Context Bundle Builder
- *
- * Pure function composition over MasterDataset. Reads from 5 pre-computed
- * views (patterns, relationshipIndex, archIndex, deliverables, FSM) and
- * assembles them into a ContextBundle tailored to the session type.
- *
- * The assembler does NOT format output. It produces structured data that
- * the ContextFormatter renders as plain text (see ADR-008).
- *
- * **When to Use:** When building a session context bundle for a pattern — use this instead of manually querying MasterDataset views.
- */
-import type { ProcessStateAPI } from './process-state.js';
-import type { MasterDataset } from '../validation-schemas/master-dataset.js';
-import { type DeliverableStatus } from '../taxonomy/index.js';
-import type { NeighborEntry } from './types.js';
-export type SessionType = 'planning' | 'design' | 'implement';
-export declare function isValidSessionType(value: string): value is SessionType;
-export interface ContextOptions {
-    readonly patterns: readonly string[];
-    readonly sessionType: SessionType;
-    readonly baseDir: string;
-}
-export interface DepTreeOptions {
-    readonly pattern: string;
-    readonly maxDepth: number;
-    readonly includeImplementationDeps: boolean;
-}
-export interface PatternContextMeta {
-    readonly name: string;
-    readonly status: string | undefined;
-    readonly phase: number | undefined;
-    readonly category: string;
-    readonly file: string;
-    readonly summary: string;
-}
-export interface StubRef {
-    readonly stubFile: string;
-    readonly targetPath: string;
-    readonly name: string;
-}
-export interface DepEntry {
-    readonly name: string;
-    readonly status: string | undefined;
-    readonly file: string;
-    readonly kind: 'planning' | 'implementation';
-}
-export interface DeliverableEntry {
-    readonly name: string;
-    readonly status: DeliverableStatus;
-    readonly location: string;
-}
-export interface FsmContext {
-    readonly currentStatus: string;
-    readonly validTransitions: readonly string[];
-    readonly protectionLevel: 'none' | 'scope' | 'hard';
-}
-export interface ContextBundle {
-    readonly patterns: readonly string[];
-    readonly sessionType: SessionType;
-    readonly metadata: readonly PatternContextMeta[];
-    readonly specFiles: readonly string[];
-    readonly stubs: readonly StubRef[];
-    readonly dependencies: readonly DepEntry[];
-    readonly sharedDependencies: readonly string[];
-    readonly consumers: readonly DepEntry[];
-    readonly architectureNeighbors: readonly NeighborEntry[];
-    readonly deliverables: readonly DeliverableEntry[];
-    readonly fsm: FsmContext | undefined;
-    readonly testFiles: readonly string[];
-}
-export interface DepTreeNode {
-    readonly name: string;
-    readonly status: string | undefined;
-    readonly phase: number | undefined;
-    readonly isFocal: boolean;
-    readonly truncated: boolean;
-    readonly children: readonly DepTreeNode[];
-}
-export interface FileReadingList {
-    readonly pattern: string;
-    readonly primary: readonly string[];
-    readonly completedDeps: readonly string[];
-    readonly roadmapDeps: readonly string[];
-    readonly architectureNeighbors: readonly string[];
-}
-export interface ProgressSummary {
-    readonly total: number;
-    readonly completed: number;
-    readonly active: number;
-    readonly planned: number;
-    readonly percentage: number;
-}
-export interface ActivePhaseSummary {
-    readonly phase: number;
-    readonly name: string | undefined;
-    readonly patternCount: number;
-    readonly activeCount: number;
-}
-export interface BlockingEntry {
-    readonly pattern: string;
-    readonly status: string | undefined;
-    readonly blockedBy: readonly string[];
-}
-export interface OverviewSummary {
-    readonly progress: ProgressSummary;
-    readonly activePhases: readonly ActivePhaseSummary[];
-    readonly blocking: readonly BlockingEntry[];
-}
-export declare function assembleContext(dataset: MasterDataset, api: ProcessStateAPI, options: ContextOptions): ContextBundle;
-export declare function buildDepTree(dataset: MasterDataset, options: DepTreeOptions): DepTreeNode;
-export declare function buildFileReadingList(dataset: MasterDataset, patternName: string, includeRelated: boolean): FileReadingList;
-export declare function buildOverview(dataset: MasterDataset): OverviewSummary;
-//# sourceMappingURL=context-assembler.d.ts.map