@fermindi/pwn-cli 0.1.1 → 0.3.0

package/src/core/state.js

@@ -1,91 +1,91 @@
-import { readFileSync, writeFileSync, existsSync } from 'fs';
-import { join } from 'path';
-import { execSync } from 'child_process';
-
-/**
- * Get the path to state.json in a workspace
- * @param {string} cwd - Working directory (defaults to process.cwd())
- * @returns {string} Path to state.json
- */
-export function getStatePath(cwd = process.cwd()) {
-  return join(cwd, '.ai', 'state.json');
-}
-
-/**
- * Check if a PWN workspace exists in the given directory
- * @param {string} cwd - Working directory
- * @returns {boolean}
- */
-export function hasWorkspace(cwd = process.cwd()) {
-  return existsSync(join(cwd, '.ai'));
-}
-
-/**
- * Get the current git username
- * @returns {string} Git username or 'unknown'
- */
-export function getGitUser() {
-  try {
-    return execSync('git config user.name', { encoding: 'utf8' }).trim();
-  } catch {
-    return 'unknown';
-  }
-}
-
-/**
- * Read the current state from state.json
- * @param {string} cwd - Working directory
- * @returns {object|null} State object or null if not found
- */
-export function getState(cwd = process.cwd()) {
-  const statePath = getStatePath(cwd);
-
-  if (!existsSync(statePath)) {
-    return null;
-  }
-
-  try {
-    const content = readFileSync(statePath, 'utf8');
-    return JSON.parse(content);
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Update the state.json file
- * @param {object} updates - Fields to update
- * @param {string} cwd - Working directory
- * @returns {object} Updated state
- */
-export function updateState(updates, cwd = process.cwd()) {
-  const statePath = getStatePath(cwd);
-  const currentState = getState(cwd) || {};
-
-  const newState = {
-    ...currentState,
-    ...updates,
-    last_updated: new Date().toISOString()
-  };
-
-  writeFileSync(statePath, JSON.stringify(newState, null, 2));
-  return newState;
-}
-
-/**
- * Initialize a new state.json file
- * @param {string} cwd - Working directory
- * @returns {object} Initial state
- */
-export function initState(cwd = process.cwd()) {
-  const state = {
-    developer: getGitUser(),
-    session_started: new Date().toISOString(),
-    current_task: null,
-    context_loaded: []
-  };
-
-  const statePath = getStatePath(cwd);
-  writeFileSync(statePath, JSON.stringify(state, null, 2));
-  return state;
-}
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { execSync } from 'child_process';
+
+/**
+ * Get the path to state.json in a workspace
+ * @param {string} cwd - Working directory (defaults to process.cwd())
+ * @returns {string} Path to state.json
+ */
+export function getStatePath(cwd = process.cwd()) {
+  return join(cwd, '.ai', 'state.json');
+}
+
+/**
+ * Check if a PWN workspace exists in the given directory
+ * @param {string} cwd - Working directory
+ * @returns {boolean}
+ */
+export function hasWorkspace(cwd = process.cwd()) {
+  return existsSync(join(cwd, '.ai'));
+}
+
+/**
+ * Get the current git username
+ * @returns {string} Git username or 'unknown'
+ */
+export function getGitUser() {
+  try {
+    return execSync('git config user.name', { encoding: 'utf8' }).trim();
+  } catch {
+    return 'unknown';
+  }
+}
+
+/**
+ * Read the current state from state.json
+ * @param {string} cwd - Working directory
+ * @returns {object|null} State object or null if not found
+ */
+export function getState(cwd = process.cwd()) {
+  const statePath = getStatePath(cwd);
+
+  if (!existsSync(statePath)) {
+    return null;
+  }
+
+  try {
+    const content = readFileSync(statePath, 'utf8');
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Update the state.json file
+ * @param {object} updates - Fields to update
+ * @param {string} cwd - Working directory
+ * @returns {object} Updated state
+ */
+export function updateState(updates, cwd = process.cwd()) {
+  const statePath = getStatePath(cwd);
+  const currentState = getState(cwd) || {};
+
+  const newState = {
+    ...currentState,
+    ...updates,
+    last_updated: new Date().toISOString()
+  };
+
+  writeFileSync(statePath, JSON.stringify(newState, null, 2));
+  return newState;
+}
+
+/**
+ * Initialize a new state.json file
+ * @param {string} cwd - Working directory
+ * @returns {object} Initial state
+ */
+export function initState(cwd = process.cwd()) {
+  const state = {
+    developer: getGitUser(),
+    session_started: new Date().toISOString(),
+    current_task: null,
+    context_loaded: []
+  };
+
+  const statePath = getStatePath(cwd);
+  writeFileSync(statePath, JSON.stringify(state, null, 2));
+  return state;
+}

package/src/core/validate.js

@@ -1,202 +1,202 @@
-import { existsSync, statSync, readFileSync } from 'fs';
-import { join } from 'path';
-
-/**
- * Expected workspace structure
- */
-const REQUIRED_STRUCTURE = {
-  files: [
-    'README.md',
-    'state.json'
-  ],
-  directories: [
-    'memory',
-    'tasks',
-    'patterns',
-    'workflows',
-    'agents',
-    'config'
-  ],
-  memoryFiles: [
-    'memory/decisions.md',
-    'memory/patterns.md',
-    'memory/deadends.md'
-  ],
-  taskFiles: [
-    'tasks/active.md',
-    'tasks/backlog.md'
-  ],
-  agentFiles: [
-    'agents/README.md',
-    'agents/claude.md'
-  ],
-  patternFiles: [
-    'patterns/index.md'
-  ]
-};
-
-/**
- * Validate a PWN workspace structure
- * @param {string} cwd - Working directory
- * @returns {object} Validation result with issues array
- */
-export function validate(cwd = process.cwd()) {
-  const aiDir = join(cwd, '.ai');
-  const issues = [];
-  const warnings = [];
-
-  // Check if .ai/ exists
-  if (!existsSync(aiDir)) {
-    return {
-      valid: false,
-      issues: ['No .ai/ directory found. Run: pwn inject'],
-      warnings: []
-    };
-  }
-
-  // Check required files
-  for (const file of REQUIRED_STRUCTURE.files) {
-    const filePath = join(aiDir, file);
-    if (!existsSync(filePath)) {
-      issues.push(`Missing file: .ai/${file}`);
-    }
-  }
-
-  // Check required directories
-  for (const dir of REQUIRED_STRUCTURE.directories) {
-    const dirPath = join(aiDir, dir);
-    if (!existsSync(dirPath)) {
-      issues.push(`Missing directory: .ai/${dir}/`);
-    } else if (!statSync(dirPath).isDirectory()) {
-      issues.push(`.ai/${dir} exists but is not a directory`);
-    }
-  }
-
-  // Check memory files
-  for (const file of REQUIRED_STRUCTURE.memoryFiles) {
-    const filePath = join(aiDir, file);
-    if (!existsSync(filePath)) {
-      warnings.push(`Missing memory file: .ai/${file}`);
-    }
-  }
-
-  // Check task files
-  for (const file of REQUIRED_STRUCTURE.taskFiles) {
-    const filePath = join(aiDir, file);
-    if (!existsSync(filePath)) {
-      warnings.push(`Missing task file: .ai/${file}`);
-    }
-  }
-
-  // Check agent files
-  for (const file of REQUIRED_STRUCTURE.agentFiles) {
-    const filePath = join(aiDir, file);
-    if (!existsSync(filePath)) {
-      warnings.push(`Missing agent file: .ai/${file}`);
-    }
-  }
-
-  // Check pattern files
-  for (const file of REQUIRED_STRUCTURE.patternFiles) {
-    const filePath = join(aiDir, file);
-    if (!existsSync(filePath)) {
-      warnings.push(`Missing pattern file: .ai/${file}`);
-    }
-  }
-
-  // Validate state.json format
-  const stateValidation = validateStateJson(aiDir);
-  if (!stateValidation.valid) {
-    issues.push(...stateValidation.issues);
-  }
-
-  return {
-    valid: issues.length === 0,
-    issues,
-    warnings
-  };
-}
-
-/**
- * Validate state.json structure and content
- * @param {string} aiDir - Path to .ai directory
- * @returns {object} Validation result
- */
-function validateStateJson(aiDir) {
-  const statePath = join(aiDir, 'state.json');
-  const issues = [];
-
-  if (!existsSync(statePath)) {
-    return { valid: false, issues: ['state.json not found'] };
-  }
-
-  try {
-    const content = readFileSync(statePath, 'utf8');
-    const state = JSON.parse(content);
-
-    // Check required fields
-    const requiredFields = ['developer', 'session_started'];
-    for (const field of requiredFields) {
-      if (!(field in state)) {
-        issues.push(`state.json missing required field: ${field}`);
-      }
-    }
-
-    // Validate date format
-    if (state.session_started && isNaN(Date.parse(state.session_started))) {
-      issues.push('state.json: session_started is not a valid date');
-    }
-
-  } catch (error) {
-    if (error instanceof SyntaxError) {
-      issues.push('state.json contains invalid JSON');
-    } else {
-      issues.push(`state.json read error: ${error.message}`);
-    }
-  }
-
-  return {
-    valid: issues.length === 0,
-    issues
-  };
-}
-
-/**
- * Get a detailed report of workspace structure
- * @param {string} cwd - Working directory
- * @returns {object} Structure report
- */
-export function getStructureReport(cwd = process.cwd()) {
-  const aiDir = join(cwd, '.ai');
-  const report = {
-    exists: existsSync(aiDir),
-    directories: {},
-    files: {}
-  };
-
-  if (!report.exists) {
-    return report;
-  }
-
-  // Check directories
-  for (const dir of REQUIRED_STRUCTURE.directories) {
-    const dirPath = join(aiDir, dir);
-    report.directories[dir] = existsSync(dirPath) && statSync(dirPath).isDirectory();
-  }
-
-  // Check all expected files
-  const allFiles = [
-    ...REQUIRED_STRUCTURE.files,
-    ...REQUIRED_STRUCTURE.memoryFiles,
-    ...REQUIRED_STRUCTURE.taskFiles,
-    ...REQUIRED_STRUCTURE.agentFiles,
-    ...REQUIRED_STRUCTURE.patternFiles
-  ];
-
-  for (const file of allFiles) {
-    const filePath = join(aiDir, file);
-    report.files[file] = existsSync(filePath);
-  }
-
-  return report;
-}
+import { existsSync, statSync, readFileSync } from 'fs';
+import { join } from 'path';
+
+/**
+ * Expected workspace structure
+ */
+const REQUIRED_STRUCTURE = {
+  files: [
+    'README.md',
+    'state.json'
+  ],
+  directories: [
+    'memory',
+    'tasks',
+    'patterns',
+    'workflows',
+    'agents',
+    'config'
+  ],
+  memoryFiles: [
+    'memory/decisions.md',
+    'memory/patterns.md',
+    'memory/deadends.md'
+  ],
+  taskFiles: [
+    'tasks/active.md',
+    'tasks/backlog.md'
+  ],
+  agentFiles: [
+    'agents/README.md',
+    'agents/claude.md'
+  ],
+  patternFiles: [
+    'patterns/index.md'
+  ]
+};
+
+/**
+ * Validate a PWN workspace structure
+ * @param {string} cwd - Working directory
+ * @returns {object} Validation result with issues array
+ */
+export function validate(cwd = process.cwd()) {
+  const aiDir = join(cwd, '.ai');
+  const issues = [];
+  const warnings = [];
+
+  // Check if .ai/ exists
+  if (!existsSync(aiDir)) {
+    return {
+      valid: false,
+      issues: ['No .ai/ directory found. Run: pwn inject'],
+      warnings: []
+    };
+  }
+
+  // Check required files
+  for (const file of REQUIRED_STRUCTURE.files) {
+    const filePath = join(aiDir, file);
+    if (!existsSync(filePath)) {
+      issues.push(`Missing file: .ai/${file}`);
+    }
+  }
+
+  // Check required directories
+  for (const dir of REQUIRED_STRUCTURE.directories) {
+    const dirPath = join(aiDir, dir);
+    if (!existsSync(dirPath)) {
+      issues.push(`Missing directory: .ai/${dir}/`);
+    } else if (!statSync(dirPath).isDirectory()) {
+      issues.push(`.ai/${dir} exists but is not a directory`);
+    }
+  }
+
+  // Check memory files
+  for (const file of REQUIRED_STRUCTURE.memoryFiles) {
+    const filePath = join(aiDir, file);
+    if (!existsSync(filePath)) {
+      warnings.push(`Missing memory file: .ai/${file}`);
+    }
+  }
+
+  // Check task files
+  for (const file of REQUIRED_STRUCTURE.taskFiles) {
+    const filePath = join(aiDir, file);
+    if (!existsSync(filePath)) {
+      warnings.push(`Missing task file: .ai/${file}`);
+    }
+  }
+
+  // Check agent files
+  for (const file of REQUIRED_STRUCTURE.agentFiles) {
+    const filePath = join(aiDir, file);
+    if (!existsSync(filePath)) {
+      warnings.push(`Missing agent file: .ai/${file}`);
+    }
+  }
+
+  // Check pattern files
+  for (const file of REQUIRED_STRUCTURE.patternFiles) {
+    const filePath = join(aiDir, file);
+    if (!existsSync(filePath)) {
+      warnings.push(`Missing pattern file: .ai/${file}`);
+    }
+  }
+
+  // Validate state.json format
+  const stateValidation = validateStateJson(aiDir);
+  if (!stateValidation.valid) {
+    issues.push(...stateValidation.issues);
+  }
+
+  return {
+    valid: issues.length === 0,
+    issues,
+    warnings
+  };
+}
+
+/**
+ * Validate state.json structure and content
+ * @param {string} aiDir - Path to .ai directory
+ * @returns {object} Validation result
+ */
+function validateStateJson(aiDir) {
+  const statePath = join(aiDir, 'state.json');
+  const issues = [];
+
+  if (!existsSync(statePath)) {
+    return { valid: false, issues: ['state.json not found'] };
+  }
+
+  try {
+    const content = readFileSync(statePath, 'utf8');
+    const state = JSON.parse(content);
+
+    // Check required fields
+    const requiredFields = ['developer', 'session_started'];
+    for (const field of requiredFields) {
+      if (!(field in state)) {
+        issues.push(`state.json missing required field: ${field}`);
+      }
+    }
+
+    // Validate date format
+    if (state.session_started && isNaN(Date.parse(state.session_started))) {
+      issues.push('state.json: session_started is not a valid date');
+    }
+
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      issues.push('state.json contains invalid JSON');
+    } else {
+      issues.push(`state.json read error: ${error.message}`);
+    }
+  }
+
+  return {
+    valid: issues.length === 0,
+    issues
+  };
+}
+
+/**
+ * Get a detailed report of workspace structure
+ * @param {string} cwd - Working directory
+ * @returns {object} Structure report
+ */
+export function getStructureReport(cwd = process.cwd()) {
+  const aiDir = join(cwd, '.ai');
+  const report = {
+    exists: existsSync(aiDir),
+    directories: {},
+    files: {}
+  };
+
+  if (!report.exists) {
+    return report;
+  }
+
+  // Check directories
+  for (const dir of REQUIRED_STRUCTURE.directories) {
+    const dirPath = join(aiDir, dir);
+    report.directories[dir] = existsSync(dirPath) && statSync(dirPath).isDirectory();
+  }
+
+  // Check all expected files
+  const allFiles = [
+    ...REQUIRED_STRUCTURE.files,
+    ...REQUIRED_STRUCTURE.memoryFiles,
+    ...REQUIRED_STRUCTURE.taskFiles,
+    ...REQUIRED_STRUCTURE.agentFiles,
+    ...REQUIRED_STRUCTURE.patternFiles
+  ];
+
+  for (const file of allFiles) {
+    const filePath = join(aiDir, file);
+    report.files[file] = existsSync(filePath);
+  }
+
+  return report;
+}