refactor(cli): Consolidate 'craft' capabilities into core pillars

This major architectural refactor removes the standalone 'craft' command group and integrates its AI-assisted features directly into the 'factory' and 'product' pillars.

Key Changes:
- Removed 'cmd/craft' and its subcommands.
- Added '--ai' flag to 'commit', 'finish', and 'codemod' for AI-assisted workflows.
- Added '--strategic' flag to 'kickoff' for AI-guided project planning.
- Centralized AI prompt logic in 'internal/workflow/ai_steps.go'.
- Refactored 'version' and 'feedback' commands for improved testability and code quality.
- Moved build versioning source of truth to 'internal/build' and updated linter rules.

Author: duizendstra

.golangci.yml

@@ -6,22 +6,17 @@ run:
   modules-download-mode: readonly
 
 output:
-  # Satisfies "order the results by file"
   sort-order:
     - file
     - linter
 
 linters:
   default: all
   disable:
-    # --- Style & Idiom (Too Opinionated) ---
-    - wsl             # Too strict; conflicts with logical grouping.
-
-    # --- Style Preference ---
-    - noinlineerr     # Disabled to allow idiomatic `if err :=...`
+    - wsl
+    - noinlineerr
     - err113
     - errcheck
-    - exhaustruct
     - funlen
     - gochecknoinits
     - gocognit
@@ -32,42 +27,59 @@ linters:
     - revive
     - varnamelen
     - cyclop
-    - gochecknoglobals
+    # - gochecknoglobals
     - unparam
     - wrapcheck
     - depguard
+    # We keep exhaustruct disabled in the general list for now to avoid noise in other files,
+    # but we configure the settings below so that IF enabled (e.g. via strict mode), it behaves correctly.
 
   exclusions:
-    generated: strict
-    warn-unused: true
-    presets:
-      # - comments
-      # - std-error-handling
-      # - common-false-positives
-      # - legacy
-    rules:
-      - path: "cmd/version/version.go"
-        linters:
-          - gochecknoinits
-          - exhaustruct
-          - gochecknoglobals
-          - errcheck
+      generated: strict
+      warn-unused: true
+      presets:
+        # - comments
+        # - std-error-handling
+        # - common-false-positives
+        # - legacy
+      rules:
+        # Allow globals for build-time variables and embedded descriptions
+        - path: "cmd/(version/version|feedback/feedback)\\.go$"
+          linters:
+            - gochecknoglobals
+
+        # Allow globals for build-time injection
+        - path: "internal/build/build\\.go$"
+          linters:
+            - gochecknoglobals
+
+        # Allow globals for the "Bridge Pattern" in tests
+        # Regex explanation: Matches any file ending in "export_test.go"
+        - path: "export_test\\.go$"
+          linters:
+            - gochecknoglobals
+            - exhaustruct
+
 
   settings:
     gofumpt:
       extra-rules: true
 
+    # --- NEW CONFIGURATION ---
+    exhaustruct:
+      exclude:
+        # Exclude Cobra commands as per research findings (Fragile Structs)
+        - "^github.com/spf13/cobra.Command$"
+
     depguard:
       rules:
-        # Rule 1: Production Code (Main)
         main:
           list-mode: strict
           files:
             - "$all"
-            - "!$test" # Critical: Exclude test files from this strict rule
+            - "!$test"
           allow:
             - $gostd
-            # Allow SDKs
             - golang.org/x/oauth2
             - github.com/spf13/cobra
             - google.golang.org/grpc
@@ -78,7 +90,6 @@ linters:
             - github.com/google/go-github/v74/github
             - github.com/fatih/color
             - github.com/mattn/go-isatty
-            # Allow your project imports
             - github.com/contextvibes/cli
             - github.com/mark3labs/mcp-go/mcp
           deny:
@@ -95,14 +106,13 @@ linters:
         - error
         - empty
         - stdlib
-        # --- Architecture Exemptions (Dependency Injection) ---
         - github.com/contextvibes/cli/internal/workitem.Provider
         - github.com/contextvibes/cli/internal/exec.CommandExecutor
         - github.com/contextvibes/cli/internal/workflow.PresenterInterface
 
     gosec:
       excludes:
-        - G101 # Exclude "Hardcoded Credentials" (false positives with IaC resource names)
+        - G101
 
     errorlint:
       errorf: true

.goreleaser.yaml

@@ -20,10 +20,10 @@ builds:
     binary: contextvibes
     ldflags:
       - -s -w
-      - -X github.com/contextvibes/cli/cmd/version.Version={{.Version}}
-      - -X github.com/contextvibes/cli/cmd/version.Commit={{.Commit}}
-      - -X github.com/contextvibes/cli/cmd/version.Date={{.Date}}
-      - -X github.com/contextvibes/cli/cmd/version.BuiltBy=goreleaser
+      - -X github.com/contextvibes/cli/internal/build.Version={{.Version}}
+      - -X github.com/contextvibes/cli/internal/build.Commit={{.Commit}}
+      - -X github.com/contextvibes/cli/internal/build.Date={{.Date}}
+      - -X github.com/contextvibes/cli/internal/build.BuiltBy=goreleaser
 
 archives:
   - format: tar.gz

CHANGELOG.md

@@ -1,4 +1,3 @@
-cat <<EOF > CHANGELOG.md
 # Changelog
 
 All notable changes to the **Context Vibes CLI** project will be documented in this file.
@@ -8,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [Unreleased]
+
+### Deprecated
+- **\`craft\` Command Pillar:** The \`craft\` command group has been deprecated. Its functionality has been integrated directly into the core \`factory\` and \`product\` commands to streamline the workflow.
+
+### Added
+- **AI-Assisted Flags (`--ai`):** Added a global-style \`--ai\` flag to key commands to generate optimized prompts for external AI assistants:
+  - \`factory commit --ai\`: Replaces \`craft message\`. Generates a Conventional Commit message prompt based on staged changes.
+  - \`factory finish --ai\`: Replaces \`craft pr-description\`. Generates a Pull Request description prompt based on branch diffs.
+  - \`product quality --ai\`: Replaces \`craft review\`. Generates a Code Review prompt for the codebase.
+  - \`product codemod --ai\`: Replaces \`craft refactor\`. Generates a Refactoring Plan prompt for specific files.
+- **Strategic Kickoff Integration:**
+  - \`factory kickoff --strategic\`: Replaces \`craft kickoff\`. Generates the master protocol for an AI-guided strategic project kickoff.
+
+### Changed
+- **Workflow Architecture:** Refactored internal workflow steps to be reusable across different commands, enabling the "AI as a feature" model.
+
+---
+
 ## [0.6.0] - 2025-12-05
 
 ### Added
@@ -265,7 +283,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 <!--
 Link Definitions
 -->
-[Unreleased]: https://github.com/contextvibes/cli/compare/v0.4.1...HEAD
+[Unreleased]: https://github.com/contextvibes/cli/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/contextvibes/cli/compare/v0.4.1...v0.6.0
 [0.4.1]: https://github.com/contextvibes/cli/compare/v0.4.0...v0.4.1
 [0.4.0]: https://github.com/contextvibes/cli/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/contextvibes/cli/compare/v0.2.0...v0.3.0
@@ -276,4 +295,3 @@ Link Definitions
 [0.0.3]: https://github.com/contextvibes/cli/compare/v0.0.2...v0.0.3
 [0.0.2]: https://github.com/contextvibes/cli/compare/v0.0.1...v0.0.2
 [0.0.1]: https://github.com/contextvibes/cli/releases/tag/v0.0.1
-EOF

README.md

@@ -26,23 +26,28 @@ Context Vibes is a command-line tool designed to streamline common development t
 * **Consistency:** Provides a unified interface and terminal output style for frequent actions (`commit`, `sync`, `deploy`, etc.).
 * **Automation:** Simplifies multi-step processes and provides non-interactive options via the global `--yes` flag. Designed for use in scripts or by AI agents.
 * **AI Integration:**
-  * Generates a `contextvibes.md` context file (`describe`, `diff`) suitable for AI prompts.
-  * The `kickoff --strategic` command generates a master prompt file to guide an AI-facilitated strategic project kickoff.
-  * Produces structured terminal output suitable for human review or direct AI parsing.
-  * Generates a detailed JSON trace log (default: `contextvibes_ai_trace.log`, configurable) for deeper AI analysis or debugging.
+  * **AI-Assisted Workflows:** Use the `--ai` flag on core commands (`commit`, `finish`, `quality`, `codemod`) to generate optimized prompts for your AI assistant.
+  * **Context Generation:** Generates a `contextvibes.md` context file (`describe`, `diff`) suitable for AI prompts.
+  * **Strategic Planning:** The `kickoff --strategic` command generates a master prompt to guide an AI-facilitated strategic project kickoff.
+  * **Traceability:** Produces structured terminal output and a detailed JSON trace log (default: `contextvibes_ai_trace.log`) for deeper AI analysis.
 * **Clarity & Safety:** Uses distinct output formats and requires confirmation for state-changing operations (unless `--yes` is specified).
 * **Configurability:** Supports a `.contextvibes.yaml` file for customizing default behaviors (Git, validation rules, logging, AI interaction preferences). See the [Configuration Reference](docs/reference/configuration_reference.md) for details.
 
 ## Key Features
 
 * **AI Context Generation:** `describe`, `diff`.
 * **Enhanced Git Workflow Automation:**
-  * `kickoff`: Dual-mode for AI-assisted strategic project kickoff prompt generation OR daily development branch creation.
-  * `commit`, `sync`, `wrapup`, `status` (Configurable branch/commit rules).
+  * `kickoff`: Starts a new task. Use `--strategic` for AI-assisted project planning.
+  * `commit`: Stages and commits changes. Use `--ai` to generate a commit message prompt.
+  * `finish`: Pushes and creates a PR. Use `--ai` to generate a PR description prompt.
+  * `sync`, `status`, `tidy`.
 * **Infrastructure as Code (IaC) Wrappers:** `plan`, `deploy`, `init` (Terraform/Pulumi).
-* **Code Quality & Formatting:** `quality`, `format` (Go, Python, Terraform).
+* **Code Quality & Formatting:**
+  * `quality`: Runs static analysis. Use `--ai` to generate a code review prompt.
+  * `format`: Formats code (Go, Python, Terraform).
+* **Code Modification:**
+  * `codemod`: Applies programmatic changes. Use `--ai` to generate a refactoring prompt.
 * **Project Testing & Versioning:** `test`, `version`.
-* **Code Modification:** `codemod` (from JSON scripts).
 
 *(For detailed information on each command, see the [Command Reference](docs/reference/command_reference.md).)*
 
@@ -91,16 +96,16 @@ contextvibes [command] [flags] # Run a command
 
 ```bash
 # Initiate a strategic project kickoff (generates a master prompt for your AI)
-contextvibes kickoff --strategic
+contextvibes factory kickoff --strategic
 
-# (After AI session and creating summary) Mark strategic kickoff as complete
-contextvibes kickoff --mark-strategic-complete
+# Generate an AI prompt to write your commit message
+contextvibes factory commit --ai
 
-# Describe the project for an AI (prompts for task description)
-contextvibes describe -o my_context.md
+# Generate an AI prompt to review your code
+contextvibes product quality --ai
 
-# Run project tests (e.g., for a Go project, passing -v flag)
-contextvibes test -v
+# Describe the project for an AI (prompts for task description)
+contextvibes project describe -o my_context.md
 ```
 
 ## Documentation