@grunnverk/commands-publish 1.0.0

package/dist/src/commands/development.d.ts

@@ -0,0 +1,6 @@
+import { Config } from '@grunnverk/core';
+/**
+ * Execute the development command
+ */
+export declare const execute: (runConfig: Config) => Promise<string>;
+//# sourceMappingURL=development.d.ts.map

package/dist/src/commands/development.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"development.d.ts","sourceRoot":"","sources":["../../../src/commands/development.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAmB,MAAM,EAAiH,MAAM,iBAAiB,CAAC;AAoGzK;;GAEG;AACH,eAAO,MAAM,OAAO,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,MAAM,CAgd/D,CAAC"}

package/dist/src/commands/dryRunReporter.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Dry-run reporting for publish operations
+ *
+ * Provides comprehensive preview of what would happen during publish
+ */
+export interface DryRunReport {
+    operations: Array<{
+        step: string;
+        command?: string;
+        files?: Array<{
+            path: string;
+            changes: string;
+        }>;
+        description: string;
+    }>;
+    versionChanges: {
+        current: string;
+        proposed: string;
+    };
+    tags: string[];
+    npmPublish: {
+        package: string;
+        version: string;
+        files: string[];
+    };
+    prDetails?: {
+        title: string;
+        targetBranch: string;
+        sourceBranch: string;
+    };
+}
+export interface TreeDryRunReport {
+    packages: Array<{
+        name: string;
+        order: number;
+        dependencies: string[];
+        operations: string[];
+        versionChange?: {
+            from: string;
+            to: string;
+        };
+    }>;
+    dependencyUpdates: Array<{
+        package: string;
+        dependency: string;
+        from: string;
+        to: string;
+    }>;
+    buildOrder: string[];
+}
+/**
+ * Log dry-run report for single package publish
+ */
+export declare function logDryRunReport(report: DryRunReport): void;
+/**
+ * Log dry-run report for tree operations
+ */
+export declare function logTreeDryRunReport(report: TreeDryRunReport): void;
+/**
+ * Create a dry-run report for a single package publish
+ */
+export declare function createDryRunReport(currentVersion: string, proposedVersion: string, packageName: string, operations: DryRunReport['operations'], targetBranch?: string, sourceBranch?: string): DryRunReport;
+//# sourceMappingURL=dryRunReporter.d.ts.map

package/dist/src/commands/dryRunReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dryRunReporter.d.ts","sourceRoot":"","sources":["../../../src/commands/dryRunReporter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,YAAY;IACzB,UAAU,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,KAAK,CAAC;YACV,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,CAAC;SACnB,CAAC,CAAC;QACH,WAAW,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,cAAc,EAAE;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,SAAS,CAAC,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC;CACL;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,aAAa,CAAC,EAAE;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;SACd,CAAC;KACL,CAAC,CAAC;IACH,iBAAiB,EAAE,KAAK,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAwE1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAsDlE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAC9B,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,EACtC,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,GACtB,YAAY,CAmBd"}

package/dist/src/commands/publish.d.ts

@@ -0,0 +1,3 @@
+import { Config } from '@grunnverk/core';
+export declare const execute: (runConfig: Config) => Promise<void>;
+//# sourceMappingURL=publish.d.ts.map

package/dist/src/commands/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../src/commands/publish.ts"],"names":[],"mappings":"AAMA,OAAO,EAA8B,MAAM,EAAgM,MAAM,iBAAiB,CAAC;AAolBnQ,eAAO,MAAM,OAAO,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,IAAI,CAkkC7D,CAAC"}

package/dist/src/commands/release.d.ts

@@ -0,0 +1,3 @@
+import { Config, ReleaseSummary } from '@grunnverk/core';
+export declare const execute: (runConfig: Config) => Promise<ReleaseSummary>;
+//# sourceMappingURL=release.d.ts.map

package/dist/src/commands/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../../src/commands/release.ts"],"names":[],"mappings":";AAEA,OAAO,eAAe,CAAC;AAGvB,OAAO,EACH,MAAM,EAiBN,cAAc,EAGjB,MAAM,iBAAiB,CAAC;AA+PzB,eAAO,MAAM,OAAO,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,cAAc,CAkNvE,CAAA"}

package/dist/src/commands/validation.d.ts

@@ -0,0 +1,25 @@
+import { Config } from '@grunnverk/core';
+export interface ValidationIssue {
+    check: string;
+    message: string;
+    files?: string[];
+    suggestion?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+}
+/**
+ * Run comprehensive pre-flight validation
+ */
+export declare function runPreflightValidation(runConfig: Config, targetBranch?: string): Promise<ValidationResult>;
+/**
+ * Log validation results
+ */
+export declare function logValidationResults(result: ValidationResult): void;
+/**
+ * Throw ValidationError if validation failed
+ */
+export declare function throwIfValidationFailed(result: ValidationResult): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/src/commands/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/commands/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CACxC,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAsB3B;AAuMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAoCnE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAWtE"}

package/dist/src/index.d.ts

@@ -0,0 +1,6 @@
+export { execute as development } from './commands/development';
+export { execute as publish } from './commands/publish';
+export { execute as release } from './commands/release';
+export * from './commands/validation';
+export * from './commands/dryRunReporter';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACxD,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC"}

package/guide/index.md

@@ -0,0 +1,57 @@
+# @grunnverk/commands-publish - Agentic Guide
+
+## Purpose
+
+Publishing workflow commands for kodrdriv. Provides:
+- Development version bumping
+- NPM publish workflow with PR creation
+- GitHub release creation
+
+## Quick Reference
+
+For AI agents working with this package:
+- Development command: Bumps version with -dev suffix
+- Publish command: Creates PR, publishes to npm
+- Release command: Creates GitHub release
+
+## Key Exports
+
+```typescript
+// Publishing commands
+import { development, publish, release } from '@grunnverk/commands-publish';
+
+// Execute commands
+await development(config);
+await publish(config);
+await release(config);
+```
+
+## Dependencies
+
+- @grunnverk/core - Core utilities
+- @grunnverk/commands-git - Git workflow commands
+- @grunnverk/git-tools - Git operations
+- @grunnverk/github-tools - GitHub API
+- @grunnverk/ai-service - AI content generation
+
+## Command Workflows
+
+### development
+
+1. Check current branch
+2. Bump version with -dev suffix
+3. Create development branch
+
+### publish
+
+1. Run precommit checks
+2. Bump version
+3. Create PR
+4. Publish to npm
+
+### release
+
+1. Generate changelog
+2. Create GitHub release
+3. Tag version
+

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@grunnverk/commands-publish",
+  "version": "1.0.0",
+  "description": "Publishing workflow commands for kodrdriv (development, publish, release)",
+  "main": "dist/index.js",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "guide"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grunnverk/commands-publish.git"
+  },
+  "scripts": {
+    "build": "npm run lint && tsc --noEmit && vite build",
+    "dev": "vite",
+    "watch": "vite build --watch",
+    "test": "vitest run --coverage",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "clean": "rm -rf dist",
+    "precommit": "npm run clean && npm run build && npm run lint && npm run test",
+    "prepublishOnly": "npm run clean && npm run lint && npm run build && npm run test"
+  },
+  "keywords": [
+    "kodrdriv",
+    "publish",
+    "release",
+    "development",
+    "npm",
+    "commands"
+  ],
+  "author": "Tim O'Brien <tobrien@discursive.com>",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "dependencies": {
+    "@grunnverk/ai-service": "^1.0.1",
+    "@grunnverk/commands-git": "^1.0.0",
+    "@grunnverk/commands-tree": "^1.0.0",
+    "@grunnverk/core": "^1.0.0",
+    "@grunnverk/git-tools": "^1.0.1",
+    "@grunnverk/github-tools": "^1.0.0",
+    "@grunnverk/shared": "^0.1.11",
+    "@riotprompt/riotprompt": "^0.0.21",
+    "dotenv": "^17.2.1",
+    "openai": "^6.3.0",
+    "semver": "^7.6.0"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.33.0",
+    "@swc/core": "^1.13.3",
+    "@types/node": "^25.0.3",
+    "@types/semver": "^7.5.8",
+    "@typescript-eslint/eslint-plugin": "^8.39.1",
+    "@typescript-eslint/parser": "^8.47.0",
+    "@vitest/coverage-v8": "^4.0.13",
+    "esbuild": "0.27.2",
+    "eslint": "^9.33.0",
+    "eslint-plugin-import": "^2.32.0",
+    "globals": "^16.3.0",
+    "mockdate": "^3.0.5",
+    "typescript": "^5.9.2",
+    "vite": "^7.2.4",
+    "vite-plugin-dts": "^4.3.0",
+    "vite-plugin-node": "^7.0.0",
+    "vitest": "^4.0.13"
+  }
+}