Using Wiki Consolidation System in Other Projects

Installation

Option 1: Install from GitLab Package Registry

npm install @bluefly/platform-agents --registry=https://gitlab.com/api/v4/projects/76904438/packages/npm/

Option 2: Use as Local Dependency (Monorepo)

{
  "dependencies": {
    "@bluefly/platform-agents": "file:../platform-agents"
  }
}

Usage

1. Wiki Consolidation Script

import { WikiConsolidator } from '@bluefly/platform-agents/packages/@ossa/documentation-aggregator/wiki-consolidation-implementation';

const consolidator = new WikiConsolidator();
await consolidator.discoverFiles();
consolidator.findExactDuplicates();
consolidator.classifyContent();
const report = consolidator.generateRecommendations();
await consolidator.saveReport(report);

2. Agent Capabilities

The wiki consolidation capabilities are available in the documentation-aggregator agent:

# In your agent.ossa.yaml
capabilities:
  - name: duplicate_detection
    description: Detect exact and near-duplicate wiki content
  - name: content_classification
    description: Classify wiki content as evergreen/aspirational/outdated
  - name: codebase_alignment
    description: Align wiki content with actual codebase

3. Issue Cleanup

Use issue-lifecycle-manager agent for bulk issue cleanup:

import { IssueLifecycleManager } from '@bluefly/platform-agents/packages/@ossa/issue-lifecycle-manager';

const manager = new IssueLifecycleManager();
await manager.bulkIssueAnalysis({ project_id: 'your-project' });
await manager.issueCleanup({ issues: [...], dry_run: false });

Integration Examples

In CI/CD Pipeline

# .gitlab-ci.yml
wiki-consolidation:
  stage: validate
  script:
    - npm install @bluefly/platform-agents
    - npx tsx node_modules/@bluefly/platform-agents/packages/@ossa/documentation-aggregator/wiki-consolidation-implementation.ts
  artifacts:
    reports:
      - wiki-consolidation-report.json

In Agent Workflow

// Use in your agent workflow
import { spawnAgent } from '@bluefly/platform-agents';

await spawnAgent('documentation-aggregator', {
  task: 'Consolidate wiki files',
  wiki_path: '/path/to/wikis',
  detection_mode: 'both'
});

Configuration

Create .wiki-consolidation.config.json:

{
  "wikis_path": "/path/to/wikis",
  "archive_path": "/path/to/__ARCHIVED__",
  "classification": {
    "evergreen_keywords": ["technical", "enablement", "workflow"],
    "aspirational_keywords": ["should", "would be nice", "idea"],
    "outdated_keywords": ["deprecated", "old", "legacy"]
  },
  "gitlab": {
    "project_id": "your-project-id",
    "move_aspirational_to_issues": true
  }
}

Results

After running consolidation:

• wiki-consolidation-report.json - Full analysis data
• wiki-consolidation-summary.md - Human-readable summary
• __ARCHIVED__/ - Archived outdated files
• GitLab Issues created for aspirational content