Framework Context

#!/usr/bin/env node

/**
 * Framework Context - Post-Execute Hook
 * Runs after the skill executes for cleanup, logging, or follow-up actions.
 *
 * This hook receives the skill execution result as JSON in process.argv[2]
 */

const fs = require('fs');
const path = require('path');
const { safeParseJSON } = require('../../../lib/utils/safe-json.cjs');

// Parse hook input
const result = safeParseJSON(process.argv[2] || '{}');

console.log('📝 [FRAMEWORK-CONTEXT] Post-execute processing...');

/**
 * Process execution result
 */
function processResult(_result) {
  // TODO: Add your post-processing logic here
  // Examples:
  // - Log execution to audit file
  // - Send notifications
  // - Update memory files
  // - Trigger follow-up actions

  return { success: true };
}

// Run post-processing
const outcome = processResult(result);

if (outcome.success) {
  console.log('✅ [FRAMEWORK-CONTEXT] Post-processing complete');
  process.exit(0);
} else {
  console.error('⚠️  [FRAMEWORK-CONTEXT] Post-processing had issues');
  process.exit(0); // Don't fail the skill for post-processing issues
}

#!/usr/bin/env node

/**
 * Framework Context - Pre-Execute Hook
 * Runs before the skill executes to validate input or prepare context.
 *
 * This hook receives the skill invocation context as JSON in process.argv[2]
 */

const fs = require('fs');
const path = require('path');
const { safeParseJSON } = require('../../../lib/utils/safe-json.cjs');

// Parse hook input
const input = safeParseJSON(process.argv[2] || '{}');

console.log('🔍 [FRAMEWORK-CONTEXT] Pre-execute validation...');

/**
 * Validate input before execution
 */
function validateInput(_input) {
  const errors = [];

  // TODO: Add your validation logic here
  // Example:
  // if (!input.requiredField) {
  //   errors.push('Missing required field: requiredField');
  // }

  return errors;
}

// Run validation
const errors = validateInput(input);

if (errors.length > 0) {
  console.error('❌ Validation failed:');
  errors.forEach(e => console.error('   - ' + e));
  process.exit(1);
}

console.log('✅ [FRAMEWORK-CONTEXT] Validation passed');
process.exit(0);

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "framework-context Input Schema",
  "description": "Input validation schema for framework-context skill",
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": true
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "framework-context Output Schema",
  "description": "Output validation schema for framework-context skill",
  "type": "object",
  "required": ["success"],
  "properties": {
    "success": {
      "type": "boolean",
      "description": "Whether the skill executed successfully"
    },
    "result": {
      "type": "object",
      "description": "The skill execution result",
      "additionalProperties": true
    },
    "error": {
      "type": "string",
      "description": "Error message if execution failed"
    }
  },
  "additionalProperties": true
}

#!/usr/bin/env node

/**
 * Framework Context - Main Script
 * Provide structured framework context for system-level reflection and planning decisions.
 *
 * Usage:
 *   node main.cjs [options]
 *
 * Options:
 *   --help     Show this help message
 */

const fs = require('fs');
const path = require('path');

// Find project root
function findProjectRoot() {
  let dir = __dirname;
  while (dir !== path.parse(dir).root) {
    if (fs.existsSync(path.join(dir, '.claude'))) {
      return dir;
    }
    if (path.basename(dir) === '.claude') {
      return path.dirname(dir);
    }
    dir = path.dirname(dir);
  }
  return process.cwd();
}

const PROJECT_ROOT = findProjectRoot();
const _CLAUDE_DIR = path.join(PROJECT_ROOT, '.claude');

// Parse command line arguments
const args = process.argv.slice(2);
const options = {};
for (let i = 0; i < args.length; i++) {
  if (args[i].startsWith('--')) {
    const key = args[i].slice(2);
    const value = args[i + 1] && !args[i + 1].startsWith('--') ? args[++i] : true;
    options[key] = value;
  }
}

/**
 * Main execution
 */
function main() {
  if (options.help) {
    console.log(`
Framework Context - Main Script

Usage:
  node main.cjs [options]

Options:
  --help     Show this help message
`);
    process.exit(0);
  }

  console.log('🔧 Framework Context executing...');

  console.warn('WARNING: This skill is currently a scaffold and has no implementation.');
  process.exit(1);
}

main();