dydo 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Balazs Bodnar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# dydo
+
+DynaDocs CLI - A platform-agnostic AI orchestration and context-management framework.
+
+100% local, 100% under your control.
+
+## Installation
+
+```bash
+npm install -g dydo
+```
+
+## Quick Start
+
+```bash
+# Initialize in your project (creates dydo/ folder structure)
+dydo init claude
+
+# Validate documentation
+dydo check
+
+# Auto-fix issues
+dydo fix
+```
+
+## Workflow Flags
+
+Use these flags in your prompts to set the agent workflow:
+
+| Flag | Workflow |
+|------|----------|
+| `--feature` | Interview → Plan → Code → Review |
+| `--task` | Plan → Code → Review |
+| `--quick` | Code only (simple changes) |
+| `--think` | Co-thinker mode |
+| `--review` | Reviewer mode |
+| `--docs` | Docs-writer mode |
+| `--test` | Tester mode |
+
+## Key Commands
+
+| Command | Description |
+|---------|-------------|
+| `dydo init <integration>` | Initialize project (`claude`, `none`) |
+| `dydo check` | Validate documentation |
+| `dydo fix` | Auto-fix issues |
+| `dydo agent claim auto` | Claim an agent identity |
+| `dydo agent role <role>` | Set role and permissions |
+| `dydo whoami` | Show current agent identity |
+
+## Documentation & Details
+
+For full documentation, architecture diagrams, and detailed command reference:
+
+**[github.com/bodnarbalazs/dydo](https://github.com/bodnarbalazs/dydo)**
+
+## Alternative Installation
+
+If you have .NET installed:
+
+```bash
+dotnet tool install -g DynaDocs
+```
+
+## License
+
+MIT

package/bin/dydo

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const { getPlatformInfo } = require('../lib/platform');
+const { getBinaryPath, isBinaryInstalled } = require('../lib/paths');
+
+function main() {
+  const platformInfo = getPlatformInfo();
+
+  if (!platformInfo.supported) {
+    console.error(`Error: ${platformInfo.error}`);
+    console.error('Install via .NET instead: dotnet tool install -g DynaDocs');
+    process.exit(2);
+  }
+
+  const binaryPath = getBinaryPath(platformInfo);
+
+  if (!isBinaryInstalled(platformInfo)) {
+    console.error('Error: dydo binary not found.');
+    console.error('Try reinstalling: npm install -g dydo');
+    console.error('Or install via .NET: dotnet tool install -g DynaDocs');
+    process.exit(2);
+  }
+
+  // Spawn the native binary with all arguments passed through
+  const child = spawn(binaryPath, process.argv.slice(2), {
+    stdio: 'inherit',
+    windowsHide: false
+  });
+
+  child.on('error', (err) => {
+    console.error(`Error launching dydo: ${err.message}`);
+    process.exit(2);
+  });
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.exit(1);
+    }
+    process.exit(code ?? 0);
+  });
+}
+
+main();

package/install.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+const { getPlatformInfo } = require('./lib/platform');
+const { downloadBinary } = require('./lib/download');
+const { getBinaryDir, isBinaryInstalled, getInstalledVersion, setInstalledVersion } = require('./lib/paths');
+const pkg = require('./package.json');
+
+async function install() {
+  // Check platform support
+  const platformInfo = getPlatformInfo();
+
+  if (!platformInfo.supported) {
+    console.error(`\n[dydo] ${platformInfo.error}`);
+    console.error('[dydo] You can still use dydo if you have .NET installed:');
+    console.error('       dotnet tool install -g DynaDocs');
+    process.exit(0); // Don't fail npm install, just warn
+  }
+
+  // Check if already installed with correct version
+  const installedVersion = getInstalledVersion();
+  if (installedVersion === pkg.version && isBinaryInstalled(platformInfo)) {
+    console.log(`[dydo] Binary already installed (v${pkg.version})`);
+    return;
+  }
+
+  try {
+    await downloadBinary(pkg.version, platformInfo, getBinaryDir());
+    setInstalledVersion(pkg.version);
+  } catch (error) {
+    console.error(`\n[dydo] Failed to download binary: ${error.message}`);
+    console.error('[dydo] You can manually download from:');
+    console.error(`       https://github.com/bodnarbalazs/dydo/releases/tag/v${pkg.version}`);
+    console.error('[dydo] Or install via .NET:');
+    console.error('       dotnet tool install -g DynaDocs');
+    process.exit(1);
+  }
+}
+
+// Only run during npm install, not when required as a module
+if (require.main === module) {
+  install().catch((err) => {
+    console.error('[dydo] Installation error:', err);
+    process.exit(1);
+  });
+}
+
+module.exports = { install };

package/lib/download.js

@@ -0,0 +1,88 @@
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const { execFileSync } = require('child_process');
+
+async function downloadFile(url, destPath) {
+  return new Promise((resolve, reject) => {
+    const follow = (url, redirectCount = 0) => {
+      if (redirectCount > 5) {
+        reject(new Error('Too many redirects'));
+        return;
+      }
+
+      https.get(url, (response) => {
+        // Handle redirects (GitHub releases use them)
+        if (response.statusCode === 302 || response.statusCode === 301) {
+          follow(response.headers.location, redirectCount + 1);
+          return;
+        }
+
+        if (response.statusCode !== 200) {
+          reject(new Error(`Download failed: HTTP ${response.statusCode}`));
+          return;
+        }
+
+        const file = fs.createWriteStream(destPath);
+        response.pipe(file);
+        file.on('finish', () => {
+          file.close();
+          resolve();
+        });
+        file.on('error', (err) => {
+          fs.unlink(destPath, () => {});
+          reject(err);
+        });
+      }).on('error', reject);
+    };
+
+    follow(url);
+  });
+}
+
+async function extractArchive(archivePath, destDir, platformInfo) {
+  fs.mkdirSync(destDir, { recursive: true });
+
+  if (platformInfo.archiveExt === '.zip') {
+    // Windows: use PowerShell to extract
+    if (process.platform === 'win32') {
+      execFileSync('powershell', [
+        '-Command',
+        `Expand-Archive -Path '${archivePath}' -DestinationPath '${destDir}' -Force`
+      ], { stdio: 'pipe' });
+    } else {
+      execFileSync('unzip', ['-o', archivePath, '-d', destDir], { stdio: 'pipe' });
+    }
+  } else {
+    // tar.gz: use tar command
+    execFileSync('tar', ['-xzf', archivePath, '-C', destDir], { stdio: 'pipe' });
+  }
+}
+
+async function downloadBinary(version, platformInfo, installDir) {
+  const { getDownloadUrl } = require('./platform');
+  const url = getDownloadUrl(version, platformInfo);
+
+  const archivePath = path.join(installDir, `dydo${platformInfo.archiveExt}`);
+
+  console.log(`[dydo] Downloading v${version} for ${platformInfo.rid}...`);
+
+  await downloadFile(url, archivePath);
+  console.log('[dydo] Download complete, extracting...');
+
+  await extractArchive(archivePath, installDir, platformInfo);
+
+  // Clean up archive
+  fs.unlinkSync(archivePath);
+
+  // Set executable permission on Unix systems
+  if (process.platform !== 'win32') {
+    const binaryPath = path.join(installDir, platformInfo.binaryName);
+    fs.chmodSync(binaryPath, 0o755);
+  }
+
+  console.log('[dydo] Installation complete.');
+  return path.join(installDir, platformInfo.binaryName);
+}
+
+module.exports = { downloadFile, extractArchive, downloadBinary };

package/lib/paths.js

@@ -0,0 +1,48 @@
+const path = require('path');
+const fs = require('fs');
+
+// Binary is stored within the npm package directory
+function getInstallDir() {
+  return path.dirname(__dirname);
+}
+
+function getBinaryDir() {
+  return path.join(getInstallDir(), 'native');
+}
+
+function getBinaryPath(platformInfo) {
+  return path.join(getBinaryDir(), platformInfo.binaryName);
+}
+
+function isBinaryInstalled(platformInfo) {
+  const binaryPath = getBinaryPath(platformInfo);
+  return fs.existsSync(binaryPath);
+}
+
+// Marker file to track installed version
+function getVersionMarkerPath() {
+  return path.join(getBinaryDir(), '.version');
+}
+
+function getInstalledVersion() {
+  const markerPath = getVersionMarkerPath();
+  if (fs.existsSync(markerPath)) {
+    return fs.readFileSync(markerPath, 'utf8').trim();
+  }
+  return null;
+}
+
+function setInstalledVersion(version) {
+  const dir = getBinaryDir();
+  fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(getVersionMarkerPath(), version);
+}
+
+module.exports = {
+  getInstallDir,
+  getBinaryDir,
+  getBinaryPath,
+  isBinaryInstalled,
+  getInstalledVersion,
+  setInstalledVersion
+};

package/lib/platform.js

@@ -0,0 +1,67 @@
+const os = require('os');
+
+// Map Node.js platform/arch to .NET RID (Runtime Identifier)
+const PLATFORM_MAPPING = {
+  'win32-x64': {
+    rid: 'win-x64',
+    binaryName: 'dydo.exe',
+    archiveExt: '.zip'
+  },
+  'linux-x64': {
+    rid: 'linux-x64',
+    binaryName: 'dydo',
+    archiveExt: '.tar.gz'
+  },
+  'linux-arm64': {
+    rid: 'linux-arm64',
+    binaryName: 'dydo',
+    archiveExt: '.tar.gz'
+  },
+  'darwin-x64': {
+    rid: 'osx-x64',
+    binaryName: 'dydo',
+    archiveExt: '.tar.gz'
+  },
+  'darwin-arm64': {
+    rid: 'osx-arm64',
+    binaryName: 'dydo',
+    archiveExt: '.tar.gz'
+  }
+};
+
+function getPlatformInfo() {
+  const platform = os.platform();
+  const arch = os.arch();
+  const key = `${platform}-${arch}`;
+
+  const info = PLATFORM_MAPPING[key];
+  if (!info) {
+    return {
+      supported: false,
+      platform,
+      arch,
+      error: `Unsupported platform: ${platform}-${arch}. ` +
+             `Supported: win-x64, linux-x64, linux-arm64, osx-x64, osx-arm64`
+    };
+  }
+
+  return {
+    supported: true,
+    platform,
+    arch,
+    ...info
+  };
+}
+
+function getDownloadUrl(version, platformInfo) {
+  const baseUrl = 'https://github.com/bodnarbalazs/dydo/releases/download';
+  const assetName = `dydo-${platformInfo.rid}${platformInfo.archiveExt}`;
+  return `${baseUrl}/v${version}/${assetName}`;
+}
+
+function getChecksumsUrl(version) {
+  const baseUrl = 'https://github.com/bodnarbalazs/dydo/releases/download';
+  return `${baseUrl}/v${version}/checksums.txt`;
+}
+
+module.exports = { getPlatformInfo, getDownloadUrl, getChecksumsUrl, PLATFORM_MAPPING };

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "dydo",
+  "version": "1.0.0",
+  "description": "DynaDocs CLI - Documentation validation and AI agent orchestration tool",
+  "keywords": [
+    "documentation",
+    "validation",
+    "ai-agents",
+    "cli",
+    "dynadocs",
+    "claude"
+  ],
+  "homepage": "https://github.com/bodnarbalazs/dydo#readme",
+  "bugs": {
+    "url": "https://github.com/bodnarbalazs/dydo/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bodnarbalazs/dydo.git"
+  },
+  "license": "MIT",
+  "author": "Balazs Bodnar",
+  "bin": {
+    "dydo": "bin/dydo"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "install.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
+}