@sixsevenai/ai-dlc-installer 1.4.2 → 1.4.4

package/library/commands/commit.md

@@ -68,18 +68,60 @@ Intelligently group staged changes into logical commits.
 
 ---
 
+## Branch Sync Gate (PR workflows only)
+
+<gate id="branch-sync" blocking="true" trigger="--generate-pr, --generate-merge-pr, --generate-merge-pr-tag">
+<description>Ensures the current branch includes all commits from origin/main before creating a PR. Prevents merge conflicts and "branch is behind" failures on GitHub.</description>
+
+<action>
+1. Fetch latest remote state:
+   ```bash
+   git fetch origin main
+   ```
+2. Check if origin/main is an ancestor of the current branch:
+   ```bash
+   git merge-base --is-ancestor origin/main HEAD
+   ```
+</action>
+
+<verify>
+Exit code 0 from `git merge-base --is-ancestor` means the branch already includes origin/main. Continue normally.
+</verify>
+
+<on-fail>
+Exit code 1 means origin/main has commits not in this branch.
+
+1. Report to the user: "Branch is behind origin/main. Rebasing to incorporate upstream changes."
+2. Rebase onto origin/main:
+   ```bash
+   git rebase origin/main
+   ```
+3. If rebase succeeds cleanly, continue with the PR workflow.
+</on-fail>
+
+<on-fail type="rebase-conflict">
+If rebase conflicts occur, **STOP** immediately and report:
+
+> "Rebase conflict detected. Resolve conflicts manually, then run `/commit` again."
+
+Do NOT force-push or auto-resolve conflicts. Do NOT continue with the PR workflow.
+</on-fail>
+</gate>
+
+---
+
 ## Workflow Options
 
 <execution-mode name="generate-pr" trigger="--generate-pr">
-Creates a pull request on GitHub
+Creates a pull request on GitHub (runs Branch Sync Gate first)
 </execution-mode>
 
 <execution-mode name="generate-merge-pr" trigger="--generate-merge-pr">
-Creates PR, merges to main, and pulls main locally
+Creates PR, merges to main, and pulls main locally (runs Branch Sync Gate first)
 </execution-mode>
 
 <execution-mode name="generate-merge-pr-tag" trigger="--generate-merge-pr-tag">
-Creates PR, merges, pulls main, and creates a semantic version tag (v1.0.0 → v1.0.1)
+Creates PR, merges, pulls main, and creates a semantic version tag (v1.0.0 → v1.0.1) (runs Branch Sync Gate first)
 </execution-mode>
 
 ---

package/library/commands/spec/analyze.md

@@ -1,7 +1,7 @@
 ---
 command: spec:analyze
 description: Perform a non-destructive cross-artifact consistency and quality analysis across spec.md, plan.md, and tasks.md after task generation.
-argument-hint: ""
+argument-hint: "[--offline [spec-name]]"
 phase: construction
 allowed-tools: Task, Read, Glob, Grep
 args: []
@@ -24,6 +24,10 @@ $ARGUMENTS
 
 You **MUST** consider the user input before proceeding (if not empty).
 
+## Offline Mode
+
+When `--offline` is passed, this command operates without an active AI-DLC session. Session state is stored locally in the spec's own directory (`artifacts/specs/{spec-name}/session-state.json`) instead of `.ai-dlc/session-state.json`. Provide the spec name as an argument if multiple specs exist, or omit it if only one spec is in progress.
+
 ## Goal
 
 Identify inconsistencies, duplications, ambiguities, and underspecified items across the three core artifacts (`spec.md`, `plan.md`, `tasks.md`) before implementation. This command MUST run only after `/spec:tasks` has successfully produced a complete `tasks.md`.

package/library/commands/spec/checklist.md

@@ -1,7 +1,7 @@
 ---
 command: spec:checklist
 description: Generate a custom checklist for the current feature based on user requirements.
-argument-hint: "[domain]"
+argument-hint: "[domain] [--offline [spec-name]]"
 phase: construction
 allowed-tools: Task, Read, Write, Edit, Glob, Grep, AskUserQuestion
 args:
@@ -48,6 +48,10 @@ $ARGUMENTS
 
 You **MUST** consider the user input before proceeding (if not empty).
 
+## Offline Mode
+
+When `--offline` is passed, this command operates without an active AI-DLC session. Session state is stored locally in the spec's own directory (`artifacts/specs/{spec-name}/session-state.json`) instead of `.ai-dlc/session-state.json`. Provide the spec name as an argument if multiple specs exist, or omit it if only one spec is in progress.
+
 ## Execution Steps
 
 <execution-steps>

package/library/commands/spec/clarify.md

@@ -1,7 +1,7 @@
 ---
 command: spec:clarify
 description: Identify underspecified areas in the current feature spec by asking up to 5 highly targeted clarification questions and encoding answers back into the spec.
-argument-hint: ""
+argument-hint: "[--offline [spec-name]]"
 phase: inception
 allowed-tools: Task, Read, Write, Edit, Glob, Grep, AskUserQuestion
 args: []
@@ -24,6 +24,10 @@ $ARGUMENTS
 
 You **MUST** consider the user input before proceeding (if not empty).
 
+## Offline Mode
+
+When `--offline` is passed, this command operates without an active AI-DLC session. Session state is stored locally in the spec's own directory (`artifacts/specs/{spec-name}/session-state.json`) instead of `.ai-dlc/session-state.json`. Provide the spec name as an argument if multiple specs exist, or omit it if only one spec is in progress.
+
 ## Outline
 
 Goal: Detect and reduce ambiguity or missing decision points in the active feature specification and record the clarifications directly in the spec file.

package/library/commands/spec/complete.md

@@ -1,7 +1,7 @@
 ---
 command: spec:complete
 description: Complete and archive the current spec session, marking it as finished
-argument-hint: ""
+argument-hint: "[--offline [spec-name]]"
 phase: finalization
 allowed-tools: Bash, Read
 args: []
@@ -16,6 +16,10 @@ args: []
 
 <!-- CONTEXT_ISOLATION:END -->
 
+## Offline Mode
+
+When `--offline` is passed, this command operates without an active AI-DLC session. Session state is stored locally in the spec's own directory (`artifacts/specs/{spec-name}/session-state.json`) instead of `.ai-dlc/session-state.json`. Provide the spec name as an argument if multiple specs exist, or omit it if only one spec is in progress.
+
 ## Purpose
 
 Complete the current spec workflow session:

package/library/commands/spec/constitution.md

@@ -1,7 +1,7 @@
 ---
 command: spec:constitution
 description: Create or update the project constitution from interactive or provided principle inputs, ensuring all dependent templates stay in sync.
-argument-hint: "[principles]"
+argument-hint: "[principles] [--offline [spec-name]]"
 phase: inception
 allowed-tools: Task, Read, Write, Edit, Glob, Grep, AskUserQuestion
 args:
@@ -20,6 +20,10 @@ $ARGUMENTS
 
 You **MUST** consider the user input before proceeding (if not empty).
 
+## Offline Mode
+
+When `--offline` is passed, this command operates without an active AI-DLC session. Session state is stored locally in the spec's own directory (`artifacts/specs/{spec-name}/session-state.json`) instead of `.ai-dlc/session-state.json`. Provide the spec name as an argument if multiple specs exist, or omit it if only one spec is in progress.
+
 ## Outline
 
 You are updating the project constitution at `.claude/memory/spec/constitution.md`. This file is a TEMPLATE containing placeholder tokens in square brackets (e.g. `[PROJECT_NAME]`, `[PRINCIPLE_1_NAME]`). Your job is to (a) collect/derive concrete values, (b) fill the template precisely, and (c) propagate any amendments across dependent artifacts.

package/library/commands/spec/implement.md

@@ -1,7 +1,7 @@
 ---
 command: spec:implement
 description: Execute the implementation plan by processing and executing all tasks defined in tasks.md
-argument-hint: "[phase]"
+argument-hint: "[phase] (--offline NOT supported)"
 phase: construction
 allowed-tools: Task, Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion
 args:
@@ -27,6 +27,14 @@ $ARGUMENTS
 
 You **MUST** consider the user input before proceeding (if not empty).
 
+## Offline Mode Gate
+
+**BLOCKING**: If `--offline` is passed, STOP immediately with this error:
+
+> "spec:implement requires an active AI-DLC session. Remove --offline to use session mode. Specs must be online (with an active session) before implementation can begin."
+
+Do NOT proceed with any implementation steps.
+
 ## Outline
 
 <execution-steps>

package/library/commands/spec/plan.md

@@ -1,7 +1,7 @@
 ---
 command: spec:plan
 description: Execute the implementation planning workflow using the plan template to generate design artifacts.
-argument-hint: "[--stack tech-stack]"
+argument-hint: "[--stack tech-stack] [--offline [spec-name]]"
 phase: construction
 allowed-tools: Task, Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion
 args:
@@ -27,6 +27,10 @@ $ARGUMENTS
 
 You **MUST** consider the user input before proceeding (if not empty).
 
+## Offline Mode
+
+When `--offline` is passed, this command operates without an active AI-DLC session. Session state is stored locally in the spec's own directory (`artifacts/specs/{spec-name}/session-state.json`) instead of `.ai-dlc/session-state.json`. Provide the spec name as an argument if multiple specs exist, or omit it if only one spec is in progress.
+
 ## Outline
 
 1. **Setup**: Run the CLI from repo root:

package/library/commands/spec/task-to-issue.md

@@ -1,7 +1,7 @@
 ---
 command: spec:task-to-issue
 description: Convert existing tasks into actionable, dependency-ordered GitHub issues for the feature based on available design artifacts.
-argument-hint: ""
+argument-hint: "[--offline [spec-name]]"
 phase: construction
 allowed-tools: Task, Read, Glob, Grep, Bash
 args: []
@@ -24,6 +24,10 @@ $ARGUMENTS
 
 You **MUST** consider the user input before proceeding (if not empty).
 
+## Offline Mode
+
+When `--offline` is passed, this command operates without an active AI-DLC session. Session state is stored locally in the spec's own directory (`artifacts/specs/{spec-name}/session-state.json`) instead of `.ai-dlc/session-state.json`. Provide the spec name as an argument if multiple specs exist, or omit it if only one spec is in progress.
+
 ## Outline
 
 1. Run the CLI from repo root:

package/library/commands/spec/tasks.md

@@ -1,7 +1,7 @@
 ---
 command: spec:tasks
 description: Generate an actionable, dependency-ordered tasks.md for the feature based on available design artifacts.
-argument-hint: ""
+argument-hint: "[--offline [spec-name]]"
 phase: construction
 allowed-tools: Task, Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion
 args: []
@@ -24,6 +24,10 @@ $ARGUMENTS
 
 You **MUST** consider the user input before proceeding (if not empty).
 
+## Offline Mode
+
+When `--offline` is passed, this command operates without an active AI-DLC session. Session state is stored locally in the spec's own directory (`artifacts/specs/{spec-name}/session-state.json`) instead of `.ai-dlc/session-state.json`. Provide the spec name as an argument if multiple specs exist, or omit it if only one spec is in progress.
+
 ---
 
 ## Outline

package/library/commands/spec/to-intent.md

@@ -1,7 +1,7 @@
 ---
 command: spec:to-intent
 description: Convert a SpecKit specification into an AI-DLC intent document to bridge spec-driven development with AI-DLC workflow.
-argument-hint: "[feature]"
+argument-hint: "[feature] [--offline [spec-name]]"
 phase: inception
 allowed-tools: Task, Read, Write, Edit, Glob, Grep, Bash
 args:
@@ -27,6 +27,10 @@ $ARGUMENTS
 
 You **MUST** consider the user input before proceeding (if not empty).
 
+## Offline Mode
+
+When `--offline` is passed, this command operates without an active AI-DLC session. Session state is stored locally in the spec's own directory (`artifacts/specs/{spec-name}/session-state.json`) instead of `.ai-dlc/session-state.json`. Provide the spec name as an argument if multiple specs exist, or omit it if only one spec is in progress.
+
 ## Purpose
 
 This command bridges SpecKit's spec-driven development workflow with the AI-DLC methodology. It converts a completed SpecKit specification (`spec.md`) into an AI-DLC intent document, preserving the work done during specification while enabling the full AI-DLC construction workflow.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sixsevenai/ai-dlc-installer",
-  "version": "1.4.2",
+  "version": "1.4.4",
   "description": "Interactive terminal installer for the AI-DLC framework",
   "type": "module",
   "license": "MIT",