github-delivery-os 1.0.0 → 1.0.2

package/.github/workflows/release.yml

@@ -0,0 +1,27 @@
+# Create GitHub release when a version tag is pushed
+# Usage: git tag v1.0.2 && git push origin v1.0.2
+
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/README.md

@@ -2,6 +2,8 @@
 
 > A GitHub-native Delivery Governance Framework for structured sprint execution, QA review, and collaborative production release control.
 
+[![Socket Badge](https://badge.socket.dev/npm/package/github-delivery-os)](https://socket.dev/npm/package/github-delivery-os)
+
 ---
 
 ## Why This Exists
@@ -48,6 +50,13 @@ cd github-delivery-operating-system
 
 **Note:** By default, existing files are **never overwritten**. Use `--overwrite` only when updating Delivery OS. See [Consumer Setup](docs/consumer-setup.md) for the full command guide.
 
+**Other commands:**
+```bash
+npx github-delivery-os status .          # Show what's installed
+npx github-delivery-os uninstall .      # Remove workflows
+npx github-delivery-os uninstall --with-templates .  # Remove workflows + templates
+```
+
 **What gets installed:**
 
 | Workflow | Purpose |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-delivery-os",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "A GitHub-native Delivery Governance Framework for structured sprint execution, QA review, and collaborative production release control.",
   "main": "src/install.js",
   "bin": {
@@ -11,13 +11,18 @@
   },
   "keywords": [
     "github",
+    "github-actions",
     "delivery",
     "sprint",
+    "sprint-planning",
     "qa",
     "release",
+    "release-management",
     "governance",
     "workflows",
-    "automation"
+    "automation",
+    "devops",
+    "ci-cd"
   ],
   "author": "",
   "license": "MIT",

package/src/cli.js

@@ -3,7 +3,7 @@
 const { program } = require('commander');
 const path = require('path');
 const fs = require('fs');
-const { runInstall } = require('./install');
+const { runInstall, runStatus, runUninstall } = require('./install');
 
 const pkgPath = path.join(__dirname, '..', 'package.json');
 const version = fs.existsSync(pkgPath)
@@ -34,6 +34,26 @@ program
     });
   });
 
+program
+  .command('status [target]')
+  .description('Show which workflows and templates are installed')
+  .action((target) => {
+    runStatus({ targetDir: target || '.' });
+  });
+
+program
+  .command('uninstall [target]')
+  .description('Remove Delivery OS workflows (and optionally templates)')
+  .option('-t, --with-templates', 'Also remove issue templates')
+  .option('-d, --dry-run', 'Show what would be removed without deleting')
+  .action((target, options) => {
+    runUninstall({
+      targetDir: target || '.',
+      withTemplates: options.withTemplates ?? false,
+      dryRun: options.dryRun ?? false,
+    });
+  });
+
 program.parse();
 
 // Show help if no command

package/src/install.js

@@ -1,6 +1,6 @@
 const path = require('path');
 const fs = require('fs');
-const { execSync } = require('child_process');
+const { execFileSync } = require('child_process');
 
 const WORKFLOWS = [
   'sprint-child-creator',
@@ -141,7 +141,7 @@ function runInstall(options) {
       console.log('  [dry-run] Labels would be created (skipped)');
     } else {
       try {
-        execSync('gh --version', { stdio: 'ignore' });
+        execFileSync('gh', ['--version'], { stdio: 'ignore' });
       } catch {
         labelsSkipReason = 'gh CLI not installed. Install from https://cli.github.com/';
         console.log(`  Skipped labels: ${labelsSkipReason}`);
@@ -154,7 +154,7 @@ function runInstall(options) {
 
       if (!labelsSkipReason) {
         try {
-          execSync('gh auth status', { cwd: targetAbs, stdio: 'ignore' });
+          execFileSync('gh', ['auth', 'status'], { cwd: targetAbs, stdio: 'ignore' });
         } catch {
           labelsSkipReason = 'gh CLI not authenticated. Run: gh auth login';
           console.log(`  Skipped labels: ${labelsSkipReason}`);
@@ -163,7 +163,7 @@ function runInstall(options) {
 
       if (!labelsSkipReason) {
         try {
-          execSync('gh repo view', { cwd: targetAbs, stdio: 'ignore' });
+          execFileSync('gh', ['repo', 'view'], { cwd: targetAbs, stdio: 'ignore' });
         } catch {
           labelsSkipReason = 'Target repo not on GitHub or no push access.';
           console.log(`  Skipped labels: ${labelsSkipReason}`);
@@ -173,7 +173,7 @@ function runInstall(options) {
       if (!labelsSkipReason) {
         for (const [name, color] of LABELS) {
           try {
-            execSync(`gh label create "${name}" --color "${color}"`, {
+            execFileSync('gh', ['label', 'create', name, '--color', color], {
               cwd: targetAbs,
               stdio: 'pipe',
             });
@@ -229,4 +229,117 @@ function runInstall(options) {
   console.log('=== Installation complete ===');
 }
 
-module.exports = { runInstall };
+const TEMPLATES = [
+  'config.yml',
+  'sprint_planning.yml',
+  'task.yml',
+  'qa_request.yml',
+  'production_release_qa_signoff.yml',
+  'bug_report.yml',
+];
+
+function runStatus(options) {
+  const { targetDir = '.' } = options;
+  const targetAbs = path.resolve(process.cwd(), targetDir);
+  const workflowsDest = path.join(targetAbs, '.github', 'workflows');
+  const templatesDest = path.join(targetAbs, '.github', 'ISSUE_TEMPLATE');
+
+  console.log('=== GitHub Delivery Operating System — Status ===');
+  console.log(`Target: ${targetAbs}`);
+  console.log('');
+
+  const installedWorkflows = WORKFLOWS.filter((wf) =>
+    fs.existsSync(path.join(workflowsDest, `${wf}.yml`))
+  );
+  const installedTemplates = TEMPLATES.filter((t) =>
+    fs.existsSync(path.join(templatesDest, t))
+  );
+
+  if (installedWorkflows.length > 0) {
+    console.log('Workflows:');
+    installedWorkflows.forEach((wf) => console.log(`  ✓ ${wf}.yml`));
+    console.log('');
+  }
+  if (installedTemplates.length > 0) {
+    console.log('Templates:');
+    installedTemplates.forEach((t) => console.log(`  ✓ ${t}`));
+    console.log('');
+  }
+
+  const missingWorkflows = WORKFLOWS.filter((wf) => !installedWorkflows.includes(wf));
+  if (missingWorkflows.length > 0) {
+    console.log('Missing workflows:');
+    missingWorkflows.forEach((wf) => console.log(`  ○ ${wf}.yml`));
+    console.log('');
+  }
+
+  if (installedWorkflows.length === 0 && installedTemplates.length === 0) {
+    console.log('Delivery OS is not installed in this repository.');
+    console.log('Run: npx github-delivery-os install --with-templates .');
+  } else {
+    const total = installedWorkflows.length + installedTemplates.length;
+    console.log(`Summary: ${installedWorkflows.length}/${WORKFLOWS.length} workflows, ${installedTemplates.length}/${TEMPLATES.length} templates`);
+  }
+  console.log('');
+}
+
+function runUninstall(options) {
+  const { targetDir = '.', withTemplates = false, dryRun = false } = options;
+  const targetAbs = path.resolve(process.cwd(), targetDir);
+  const workflowsDest = path.join(targetAbs, '.github', 'workflows');
+  const templatesDest = path.join(targetAbs, '.github', 'ISSUE_TEMPLATE');
+
+  console.log('=== GitHub Delivery Operating System — Uninstall ===');
+  console.log(`Target: ${targetAbs}`);
+  if (dryRun) console.log('Mode: dry-run (no files will be deleted)');
+  console.log('');
+
+  let workflowsRemoved = 0;
+  let templatesRemoved = 0;
+
+  for (const wf of WORKFLOWS) {
+    const dest = path.join(workflowsDest, `${wf}.yml`);
+    if (fs.existsSync(dest)) {
+      if (dryRun) {
+        console.log(`  [dry-run] Would remove: ${wf}.yml`);
+      } else {
+        fs.unlinkSync(dest);
+        console.log(`  Removed: ${wf}.yml`);
+      }
+      workflowsRemoved++;
+    }
+  }
+
+  if (withTemplates) {
+    for (const t of TEMPLATES) {
+      const dest = path.join(templatesDest, t);
+      if (fs.existsSync(dest)) {
+        if (dryRun) {
+          console.log(`  [dry-run] Would remove template: ${t}`);
+        } else {
+          fs.unlinkSync(dest);
+          console.log(`  Removed template: ${t}`);
+        }
+        templatesRemoved++;
+      }
+    }
+  }
+
+  console.log('');
+  if (workflowsRemoved > 0 || templatesRemoved > 0) {
+    if (dryRun) {
+      console.log(`Would remove ${workflowsRemoved} workflow(s)${withTemplates ? `, ${templatesRemoved} template(s)` : ''}.`);
+    } else {
+      console.log(`Removed ${workflowsRemoved} workflow(s)${withTemplates ? `, ${templatesRemoved} template(s)` : ''}.`);
+      if (!withTemplates) {
+        console.log('Templates were kept. Re-run with --with-templates to remove them.');
+      }
+    }
+  } else {
+    console.log('No Delivery OS files found to remove.');
+  }
+  console.log('');
+  console.log('=== Uninstall complete ===');
+}
+
+module.exports = { runInstall, runStatus, runUninstall };